import { type Static, type TSchema, Type } from "typebox";
import { HerdrCapabilityResolver } from "./capability.js";
import { type HerdrPromptApi } from "./guidance.js";
import { type CommandRunner } from "./process.js";
declare const HerdrWorktreeParameters: Type.TUnion<[Type.TObject<{
    operation: Type.TLiteral<"list">;
}>, Type.TObject<{
    operation: Type.TLiteral<"create">;
    branch: Type.TString;
    base: Type.TOptional<Type.TString>;
    path: Type.TOptional<Type.TString>;
    label: Type.TOptional<Type.TString>;
    focus: Type.TOptional<Type.TBoolean>;
}>, Type.TObject<{
    operation: Type.TLiteral<"open">;
    path: Type.TOptional<Type.TString>;
    branch: Type.TOptional<Type.TString>;
    label: Type.TOptional<Type.TString>;
    focus: Type.TOptional<Type.TBoolean>;
}>, Type.TObject<{
    operation: Type.TLiteral<"remove">;
    workspace_id: Type.TString;
    force: Type.TOptional<Type.TBoolean>;
}>]>;
type HerdrWorktreeParameters = Static<typeof HerdrWorktreeParameters>;
type HerdrWorktreeOperation = HerdrWorktreeParameters["operation"];
/** The fields one operation accepts, typed against the schema so the two cannot drift. */
type FieldsOf<TOperation extends HerdrWorktreeOperation> = keyof Extract<HerdrWorktreeParameters, {
    operation: TOperation;
}> & string;
interface RequestSchema<TOperation extends HerdrWorktreeOperation> {
    readonly required: readonly FieldsOf<TOperation>[];
    readonly optional: readonly FieldsOf<TOperation>[];
}
export declare const OPERATION_FIELDS: {
    readonly [K in HerdrWorktreeOperation]: RequestSchema<K>;
};
interface TextContent {
    readonly type: "text";
    readonly text: string;
}
interface ToolResult<TDetails> {
    readonly content: readonly TextContent[];
    readonly details: TDetails;
}
interface ToolContext {
    readonly cwd: string;
    readonly ui?: {
        confirm(title: string, message: string): Promise<boolean>;
    };
}
type ToolTier = "read" | "write" | "exec";
type ToolApprovalDecision = ToolTier | {
    readonly tier: ToolTier;
    readonly reason?: string;
    readonly policy?: "allow" | "deny" | "prompt";
};
interface ToolDefinition<TParameters extends TSchema, TDetails> {
    readonly name: string;
    readonly label: string;
    readonly description: string;
    readonly parameters: TParameters;
    readonly approval: ToolApprovalDecision | ((args: unknown) => ToolApprovalDecision);
    readonly loadMode: "essential" | "discoverable";
    readonly concurrency?: "shared" | "exclusive" | ((args: Partial<Static<TParameters>>) => "shared" | "exclusive");
    readonly executionMode?: "sequential" | "parallel";
    readonly formatApprovalDetails?: (args: unknown) => string | readonly string[] | undefined;
    execute(toolCallId: string, parameters: Static<TParameters>, signal: AbortSignal | undefined, onUpdate: unknown, context: ToolContext): Promise<ToolResult<TDetails>>;
}
export interface HerdrExtensionApi extends HerdrPromptApi {
    registerTool<TParameters extends TSchema, TDetails>(definition: ToolDefinition<TParameters, TDetails>): void;
}
export interface HerdrExtensionDependencies {
    readonly runner?: CommandRunner;
    readonly capabilities?: HerdrCapabilityResolver;
}
export declare function registerHerdrWorktreeTools(pi: HerdrExtensionApi, dependencies?: HerdrExtensionDependencies): void;
export {};
//# sourceMappingURL=tools.d.ts.map