@mcuste/pi-herdr-worktree 0.1.0

package/dist/process.js

@@ -0,0 +1,91 @@
+import { execFile } from "node:child_process";
+const DEFAULT_MAX_OUTPUT_BYTES = 2 * 1024 * 1024;
+class CommandExecutionError extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.name = "CommandExecutionError";
+        this.result = result;
+    }
+}
+export class CommandInvocationError extends Error {
+    command;
+    code;
+    constructor(command, message, code, options) {
+        super(message, options);
+        this.name = "CommandInvocationError";
+        this.command = command;
+        this.code = code;
+    }
+}
+export class CommandCancelledError extends Error {
+    constructor(command) {
+        super(`${command} was cancelled.`);
+        this.name = "CommandCancelledError";
+    }
+}
+/**
+ * Node kills the child once its output passes `maxBuffer`. That is a size limit, not a
+ * broken executable, so it gets its own type instead of looking like a failed spawn.
+ */
+export class CommandOutputLimitError extends Error {
+    command;
+    maxOutputBytes;
+    constructor(command, maxOutputBytes, options) {
+        super(`${command} produced more than ${maxOutputBytes} bytes of output and was stopped.`, {
+            ...options,
+        });
+        this.name = "CommandOutputLimitError";
+        this.command = command;
+        this.maxOutputBytes = maxOutputBytes;
+    }
+}
+export const runCommand = (command, args, options) => {
+    if (options.signal?.aborted) {
+        return Promise.reject(new CommandCancelledError(command));
+    }
+    const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const { promise, resolve, reject } = Promise.withResolvers();
+    execFile(command, [...args], {
+        cwd: options.cwd,
+        encoding: "utf8",
+        maxBuffer: maxOutputBytes,
+        signal: options.signal,
+        windowsHide: true,
+    }, (error, stdout, stderr) => {
+        if (options.signal?.aborted || error?.name === "AbortError") {
+            reject(new CommandCancelledError(command));
+            return;
+        }
+        if (error?.code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER") {
+            reject(new CommandOutputLimitError(command, maxOutputBytes, { cause: error }));
+            return;
+        }
+        if (error && typeof error.code !== "number") {
+            const detail = error.message.trim();
+            reject(new CommandInvocationError(command, `Unable to execute ${command}: ${detail}`, typeof error.code === "string" ? error.code : undefined, { cause: error }));
+            return;
+        }
+        resolve({
+            command,
+            args: [...args],
+            exitCode: typeof error?.code === "number" ? error.code : 0,
+            stdout,
+            stderr,
+        });
+    });
+    return promise;
+};
+export async function runChecked(runner, command, args, options, failureContext) {
+    const result = await runner(command, args, options);
+    if (result.exitCode === 0) {
+        return result;
+    }
+    throw new CommandExecutionError(formatFailure(failureContext, result), result);
+}
+function formatFailure(context, result) {
+    const output = [result.stderr.trim(), result.stdout.trim()].filter(Boolean).join("\n");
+    const suffix = output ? `\n${output}` : "";
+    return `${context} (exit ${result.exitCode}).${suffix}`;
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAsBjD,MAAM,qBAAsB,SAAQ,KAAK;IAC9B,MAAM,CAAgB;IAE/B,YAAY,OAAe,EAAE,MAAqB;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,OAAO,CAAS;IAChB,IAAI,CAAqB;IAElC,YAAY,OAAe,EAAE,OAAe,EAAE,IAAwB,EAAE,OAAsB;QAC5F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,OAAO,iBAAiB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,OAAO,CAAS;IAChB,cAAc,CAAS;IAEhC,YAAY,OAAe,EAAE,cAAsB,EAAE,OAAsB;QACzE,KAAK,CAAC,GAAG,OAAO,uBAAuB,cAAc,mCAAmC,EAAE;YACxF,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAClE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC1E,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAiB,CAAC;IAC5E,QAAQ,CACN,OAAO,EACP,CAAC,GAAG,IAAI,CAAC,EACT;QACE,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,cAAc;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,IAAI;KAClB,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACxB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,KAAK,EAAE,IAAI,KAAK,mCAAmC,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,CACJ,IAAI,sBAAsB,CACxB,OAAO,EACP,qBAAqB,OAAO,KAAK,MAAM,EAAE,EACzC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EACvD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC;YACN,OAAO;YACP,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,QAAQ,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM;YACN,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,OAAe,EACf,IAAuB,EACvB,OAA0B,EAC1B,cAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,qBAAqB,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,MAAqB;IAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,OAAO,GAAG,OAAO,UAAU,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;AAC1D,CAAC"}

package/dist/response.d.ts

@@ -0,0 +1,52 @@
+import type { CommandResult } from "./process.js";
+export interface WorktreeInfo {
+    readonly path: string;
+    readonly label: string;
+    readonly branch: string | null;
+    readonly openWorkspaceId: string | null;
+    readonly isBare: boolean;
+    readonly isDetached: boolean;
+    readonly isPrunable: boolean;
+    readonly isLinkedWorktree: boolean;
+}
+interface WorktreeSource {
+    readonly repoName: string;
+    readonly repoRoot: string;
+    readonly sourceCheckoutPath: string;
+    readonly sourceWorkspaceId: string | null;
+}
+export interface WorktreeListResult {
+    readonly type: "worktree_list";
+    readonly source: WorktreeSource;
+    readonly worktrees: readonly WorktreeInfo[];
+}
+export interface WorktreeOpenedResult {
+    readonly type: "worktree_created" | "worktree_opened";
+    readonly workspaceId: string;
+    readonly tabId: string;
+    readonly rootPaneId: string;
+    readonly worktree: WorktreeInfo;
+    readonly alreadyOpen: boolean;
+}
+export interface WorktreeRemovedResult {
+    readonly type: "worktree_removed";
+    readonly workspaceId: string;
+    readonly path: string;
+    readonly forced: boolean;
+}
+/** A Herdr socket API error, reported as JSON on stderr with a stable machine-readable code. */
+export declare class HerdrApiError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Herdr prints one JSON document per command: a success envelope carrying `result`, or an
+ * error envelope carrying `error`. A non-zero exit with an error envelope is a rejected
+ * request, not a broken CLI, so it keeps its own error type.
+ */
+export declare function parseEnvelope(result: CommandResult): Record<string, unknown>;
+export declare function parseWorktreeList(payload: Record<string, unknown>): WorktreeListResult;
+export declare function parseWorktreeOpened(payload: Record<string, unknown>): WorktreeOpenedResult;
+export declare function parseWorktreeRemoved(payload: Record<string, unknown>): WorktreeRemovedResult;
+export {};
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,gGAAgG;AAChG,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAkCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0B5E;AAwBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAsBtF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAc1F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAQ5F"}

package/dist/response.js

@@ -0,0 +1,129 @@
+/** A Herdr socket API error, reported as JSON on stderr with a stable machine-readable code. */
+export class HerdrApiError extends Error {
+    code;
+    constructor(code, message) {
+        super(`Herdr rejected the request (${code}): ${message}`);
+        this.name = "HerdrApiError";
+        this.code = code;
+    }
+}
+function fail(detail) {
+    throw new Error(`Herdr returned an unreadable response: ${detail}.`);
+}
+function record(value, field) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        fail(`${field} is not an object`);
+    }
+    return value;
+}
+function text(value, field) {
+    if (typeof value !== "string" || !value) {
+        fail(`${field} is not a non-empty string`);
+    }
+    return value;
+}
+function optionalText(value, field) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    return text(value, field);
+}
+function flag(value, field) {
+    if (typeof value !== "boolean") {
+        fail(`${field} is not a boolean`);
+    }
+    return value;
+}
+/**
+ * Herdr prints one JSON document per command: a success envelope carrying `result`, or an
+ * error envelope carrying `error`. A non-zero exit with an error envelope is a rejected
+ * request, not a broken CLI, so it keeps its own error type.
+ */
+export function parseEnvelope(result) {
+    const raw = (result.stdout.trim() || result.stderr.trim()).trim();
+    if (!raw) {
+        fail(`empty output (exit ${result.exitCode})`);
+    }
+    let document;
+    try {
+        document = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Herdr returned output that is not JSON: ${raw.slice(0, 500)}`, {
+            cause: error,
+        });
+    }
+    const envelope = record(document, "the response");
+    const failure = envelope.error;
+    if (failure !== undefined) {
+        const detail = record(failure, "error");
+        throw new HerdrApiError(text(detail.code, "error.code"), text(detail.message, "error.message"));
+    }
+    // A failed command must say why, so a result with no error field is not read as a success.
+    if (result.exitCode !== 0) {
+        fail(`a result with no error field and exit ${result.exitCode}`);
+    }
+    return record(envelope.result, "result");
+}
+function parseWorktreeInfo(value, field) {
+    const info = record(value, field);
+    return {
+        path: text(info.path, `${field}.path`),
+        label: text(info.label, `${field}.label`),
+        branch: optionalText(info.branch, `${field}.branch`),
+        openWorkspaceId: optionalText(info.open_workspace_id, `${field}.open_workspace_id`),
+        isBare: flag(info.is_bare, `${field}.is_bare`),
+        isDetached: flag(info.is_detached, `${field}.is_detached`),
+        isPrunable: flag(info.is_prunable, `${field}.is_prunable`),
+        isLinkedWorktree: flag(info.is_linked_worktree, `${field}.is_linked_worktree`),
+    };
+}
+function assertType(payload, expected) {
+    const type = text(payload.type, "result.type");
+    if (!expected.includes(type)) {
+        fail(`result.type is ${JSON.stringify(type)} instead of ${expected.join(" or ")}`);
+    }
+    return type;
+}
+export function parseWorktreeList(payload) {
+    assertType(payload, ["worktree_list"]);
+    const source = record(payload.source, "result.source");
+    const worktrees = payload.worktrees;
+    if (!Array.isArray(worktrees)) {
+        fail("result.worktrees is not an array");
+    }
+    return {
+        type: "worktree_list",
+        source: {
+            repoName: text(source.repo_name, "result.source.repo_name"),
+            repoRoot: text(source.repo_root, "result.source.repo_root"),
+            sourceCheckoutPath: text(source.source_checkout_path, "result.source.source_checkout_path"),
+            sourceWorkspaceId: optionalText(source.source_workspace_id, "result.source.source_workspace_id"),
+        },
+        worktrees: worktrees.map((entry, index) => parseWorktreeInfo(entry, `result.worktrees[${index}]`)),
+    };
+}
+export function parseWorktreeOpened(payload) {
+    const type = assertType(payload, ["worktree_created", "worktree_opened"]);
+    const workspace = record(payload.workspace, "result.workspace");
+    const tab = record(payload.tab, "result.tab");
+    const rootPane = record(payload.root_pane, "result.root_pane");
+    return {
+        type: type,
+        workspaceId: text(workspace.workspace_id, "result.workspace.workspace_id"),
+        tabId: text(tab.tab_id, "result.tab.tab_id"),
+        rootPaneId: text(rootPane.pane_id, "result.root_pane.pane_id"),
+        worktree: parseWorktreeInfo(payload.worktree, "result.worktree"),
+        alreadyOpen: type === "worktree_opened" ? flag(payload.already_open, "result.already_open") : false,
+    };
+}
+export function parseWorktreeRemoved(payload) {
+    assertType(payload, ["worktree_removed"]);
+    return {
+        type: "worktree_removed",
+        workspaceId: text(payload.workspace_id, "result.workspace_id"),
+        path: text(payload.path, "result.path"),
+        forced: flag(payload.forced, "result.forced"),
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,79 @@
+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

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}