@wjarka/cezarion 0.14.8 → 0.14.9-dev.1004

package/dist/delegation/transport.d.ts

@@ -1,5 +1,41 @@
 import type { DelegationRoutes } from './routes.ts';
 export declare function createDelegationApp(routes: DelegationRoutes): import("hono/hono-base").HonoBase<import("hono/types").BlankEnv, import("hono/types").BlankSchema | import("hono/types").MergeSchemaPath<{
+    "/discover": {
+        $post: {
+            output: {
+                runner: "claude" | "codex" | "cursor" | "opencode" | "pi";
+                models: {
+                    id: string;
+                    label: string;
+                    description: string;
+                    effortLevels?: ("high" | "low" | "max" | "medium" | "xhigh")[] | undefined;
+                }[];
+                source: "cache" | "live" | "unavailable";
+                stale: boolean;
+                reason?: string | undefined;
+            } | {
+                scope: "host-default-account";
+                runners: {
+                    status: "connected" | "disconnected" | "not-installed" | "unknown";
+                    enabled?: boolean | undefined;
+                    hint?: string | undefined;
+                    authFailureId?: string | undefined;
+                    runner: "claude" | "codex" | "cursor" | "opencode" | "pi";
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    kind: "runners";
+                } | {
+                    kind: "models";
+                    runner: "claude" | "codex" | "cursor" | "opencode" | "pi";
+                };
+            };
+        };
+    };
+} & {
     "/spawn": {
         $post: {
             output: {
@@ -41,7 +77,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     requestIds?: string[] | undefined;
                     requestOutcomes?: {
                         requestId: string;
-                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                         observedAt: string;
                         replyId?: string | undefined;
                     }[] | undefined;
@@ -68,13 +104,13 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             status: 200;
             input: {
                 json: {
-                    workerIds: string[];
-                    timeoutSeconds?: number | undefined;
-                    mode?: "all" | "any" | "one" | undefined;
-                } | {
                     requestIds: string[];
                     mode?: "all" | "any" | "one" | undefined;
                     timeoutSeconds?: number | undefined;
+                } | {
+                    workerIds: string[];
+                    timeoutSeconds?: number | undefined;
+                    mode?: "all" | "any" | "one" | undefined;
                 };
             };
         };
@@ -89,7 +125,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     requestIds?: string[] | undefined;
                     requestOutcomes?: {
                         requestId: string;
-                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                         observedAt: string;
                         replyId?: string | undefined;
                     }[] | undefined;
@@ -137,11 +173,23 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     state: "accepted" | "continuation-required" | "destroyed" | "late";
                     resumed?: true | undefined;
                     instruction?: string | undefined;
+                    question?: {
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options: {
+                                label: string;
+                                description?: string | undefined;
+                            }[];
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
                 };
-                delivery: "delivered" | "not-delivered" | "queued";
+                delivery: "consumed" | "delivered" | "not-delivered" | "queued";
                 outcome?: {
                     requestId: string;
-                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                     observedAt: string;
                     replyId?: string | undefined;
                 } | undefined;
@@ -178,11 +226,23 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     state: "accepted" | "continuation-required" | "destroyed" | "late";
                     resumed?: true | undefined;
                     instruction?: string | undefined;
+                    question?: {
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options: {
+                                label: string;
+                                description?: string | undefined;
+                            }[];
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
                 };
-                delivery: "delivered" | "not-delivered" | "queued";
+                delivery: "consumed" | "delivered" | "not-delivered" | "queued";
                 outcome?: {
                     requestId: string;
-                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                     observedAt: string;
                     replyId?: string | undefined;
                 } | undefined;
@@ -219,11 +279,23 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     state: "accepted" | "continuation-required" | "destroyed" | "late";
                     resumed?: true | undefined;
                     instruction?: string | undefined;
+                    question?: {
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options: {
+                                label: string;
+                                description?: string | undefined;
+                            }[];
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
                 };
-                delivery: "delivered" | "not-delivered" | "queued";
+                delivery: "consumed" | "delivered" | "not-delivered" | "queued";
                 outcome?: {
                     requestId: string;
-                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                     observedAt: string;
                     replyId?: string | undefined;
                 } | undefined;
@@ -260,13 +332,26 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     state: "accepted" | "continuation-required" | "destroyed" | "late";
                     resumed?: true | undefined;
                     instruction?: string | undefined;
+                    question?: {
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options: {
+                                label: string;
+                                description?: string | undefined;
+                            }[];
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
                 }[];
                 outcomes: {
                     requestId: string;
-                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                     observedAt: string;
                     replyId?: string | undefined;
                 }[];
+                hint?: string | undefined;
             };
             outputFormat: "json";
             status: 200;
@@ -277,12 +362,90 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             };
         };
     };
+} & {
+    "/inbox": {
+        $post: {
+            output: {
+                messages: {
+                    senderRunId: string;
+                    recipientRunId: string;
+                    kind: "follow-up" | "progress" | "reply" | "request";
+                    requestId?: string | undefined;
+                    id: string;
+                    text: string;
+                    createdAt: string;
+                    deadline?: string | undefined;
+                    requestHash: string;
+                    state: "accepted" | "continuation-required" | "destroyed" | "late";
+                    resumed?: true | undefined;
+                    instruction?: string | undefined;
+                    question?: {
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options: {
+                                label: string;
+                                description?: string | undefined;
+                            }[];
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
+                }[];
+                outcomes: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[];
+                receiptId?: string | undefined;
+                expiresAt?: string | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: Record<string, never>;
+            };
+        };
+    };
+} & {
+    "/inbox/ack": {
+        $post: {
+            output: {
+                receiptId: string;
+                status: "acknowledged" | "already-acknowledged" | "released";
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    receiptId: string;
+                };
+            };
+        };
+    };
+} & {
+    "/inbox/release": {
+        $post: {
+            output: {
+                receiptId: string;
+                status: "acknowledged" | "already-acknowledged" | "released";
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                json: {
+                    receiptId: string;
+                };
+            };
+        };
+    };
 } & {
     "/cancel-request": {
         $post: {
             output: {
                 requestId: string;
-                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                 observedAt: string;
                 replyId?: string | undefined;
             };
@@ -298,18 +461,6 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
 } & {
     "/:workerId": {
         $get: {
-            output: {
-                error: string;
-                code?: "invalid_input" | undefined;
-            };
-            outputFormat: "json";
-            status: 400;
-            input: {
-                param: {
-                    workerId: string;
-                };
-            };
-        } | {
             output: {
                 workerId: string;
                 parentRunId: string;
@@ -344,7 +495,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     requestIds?: string[] | undefined;
                     requestOutcomes?: {
                         requestId: string;
-                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "replied" | "sender-closed" | "timed-out";
+                        status: "cancelled" | "completed-without-reply" | "destroyed" | "failed" | "human-fallback" | "replied" | "sender-closed" | "timed-out";
                         observedAt: string;
                         replyId?: string | undefined;
                     }[] | undefined;
@@ -386,11 +537,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     workerId: string;
                 };
             };
-        };
-    };
-} & {
-    "/:workerId/collect": {
-        $post: {
+        } | {
             output: {
                 error: string;
                 code?: "invalid_input" | undefined;
@@ -401,10 +548,12 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                 param: {
                     workerId: string;
                 };
-            } & {
-                json: Record<string, never>;
             };
-        } | {
+        };
+    };
+} & {
+    "/:workerId/collect": {
+        $post: {
             output: {
                 workerId: string;
                 parentRunId: string;
@@ -506,11 +655,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             } & {
                 json: Record<string, never>;
             };
-        };
-    };
-} & {
-    "/:workerId/steer": {
-        $post: {
+        } | {
             output: {
                 error: string;
                 code?: "invalid_input" | undefined;
@@ -522,11 +667,13 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     workerId: string;
                 };
             } & {
-                json: {
-                    text: string;
-                };
+                json: Record<string, never>;
             };
-        } | {
+        };
+    };
+} & {
+    "/:workerId/steer": {
+        $post: {
             output: {
                 workerId: string;
                 state: "delivered" | "queued";
@@ -542,11 +689,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     text: string;
                 };
             };
-        };
-    };
-} & {
-    "/:workerId/stop": {
-        $post: {
+        } | {
             output: {
                 error: string;
                 code?: "invalid_input" | undefined;
@@ -558,9 +701,15 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
                     workerId: string;
                 };
             } & {
-                json: Record<string, never>;
+                json: {
+                    text: string;
+                };
             };
-        } | {
+        };
+    };
+} & {
+    "/:workerId/stop": {
+        $post: {
             output: {
                 workerId: string;
                 state: "stopping" | "terminated";
@@ -574,11 +723,7 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             } & {
                 json: Record<string, never>;
             };
-        };
-    };
-} & {
-    "/:workerId/destroy": {
-        $post: {
+        } | {
             output: {
                 error: string;
                 code?: "invalid_input" | undefined;
@@ -592,7 +737,11 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             } & {
                 json: Record<string, never>;
             };
-        } | {
+        };
+    };
+} & {
+    "/:workerId/destroy": {
+        $post: {
             output: {
                 workerId: string;
                 state: "complete" | "incomplete";
@@ -615,6 +764,20 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             } & {
                 json: Record<string, never>;
             };
+        } | {
+            output: {
+                error: string;
+                code?: "invalid_input" | undefined;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    workerId: string;
+                };
+            } & {
+                json: Record<string, never>;
+            };
         } | {
             output: {
                 workerId: string;
@@ -644,11 +807,13 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
     "/:workerId/diff": {
         $get: {
             output: {
-                error: string;
-                code?: "invalid_input" | undefined;
+                workerId: string;
+                baselineSha: string;
+                diff: string;
+                truncated: boolean;
             };
             outputFormat: "json";
-            status: 400;
+            status: 200;
             input: {
                 param: {
                     workerId: string;
@@ -656,13 +821,11 @@ export declare function createDelegationApp(routes: DelegationRoutes): import("h
             };
         } | {
             output: {
-                workerId: string;
-                baselineSha: string;
-                diff: string;
-                truncated: boolean;
+                error: string;
+                code?: "invalid_input" | undefined;
             };
             outputFormat: "json";
-            status: 200;
+            status: 400;
             input: {
                 param: {
                     workerId: string;

package/dist/discovery/catalog.d.ts

@@ -0,0 +1,14 @@
+import { type ProviderAuthService } from '../core/provider-auth.ts';
+import { type ModelDiscoveryRunner, type ModelChoices, type DiscoveredRunners, type ProviderStatusResponse } from '../contract/index.js';
+import { RunnerModelCatalog } from '../core/runner-model-catalog.ts';
+export interface HostDiscovery {
+    models: Pick<RunnerModelCatalog, 'get'>;
+    providers(): Promise<ProviderStatusResponse>;
+}
+/** Initialize before recovery or headless execution; the cockpit reuses this same model cache. */
+export declare function createHostDiscovery(root: string, auth: ProviderAuthService): HostDiscovery & {
+    models: RunnerModelCatalog;
+};
+export declare function discoveredRunners(status: ProviderStatusResponse): DiscoveredRunners;
+/** A fresh nonempty host catalog can disprove an explicit selection; unavailable data cannot. */
+export declare function missingModelChoices(source: HostDiscovery, runner: ModelDiscoveryRunner, model: string, effectiveModel?: string, modelIdentity?: string): Promise<ModelChoices | undefined>;

package/dist/discovery/catalog.js

@@ -0,0 +1,31 @@
+import { hostModelCatalogAdapters } from '../core/host-model-catalog.js';
+import { providerAuthChecksDisabled } from '../core/provider-auth.js';
+import { applyProviderEnablement } from '../core/provider-availability.js';
+import { loadWorkspaceConfig } from '../workspace/config.js';
+import { MODEL_DISCOVERY_RUNNERS } from '../contract/index.js';
+import { RunnerModelCatalog } from '../core/runner-model-catalog.js';
+/** Initialize before recovery or headless execution; the cockpit reuses this same model cache. */
+export function createHostDiscovery(root, auth) {
+    return {
+        models: new RunnerModelCatalog({ adapters: hostModelCatalogAdapters(root) }),
+        providers: async () => applyProviderEnablement(await auth.status(), providerAuthChecksDisabled() ? [] : (await loadWorkspaceConfig()).disabledProviders),
+    };
+}
+export function discoveredRunners(status) {
+    return { scope: 'host-default-account', runners: status.providers.map(({ provider, profileId: _profileId, ...row }) => ({ runner: provider, ...row })) };
+}
+/** A fresh nonempty host catalog can disprove an explicit selection; unavailable data cannot. */
+export async function missingModelChoices(source, runner, model, effectiveModel, modelIdentity) {
+    // Reuse account-aware normalization from execution selection, including custom providers.
+    // Compare complete IDs only: never strip another runner's provider prefix speculatively.
+    const ids = new Set([model, effectiveModel, modelIdentity].filter((id) => id !== undefined));
+    const catalog = await source.models.get(runner);
+    if (catalog.source === 'unavailable' || catalog.stale || !catalog.models.length || catalog.models.some(row => ids.has(row.id)))
+        return;
+    const alternatives = await Promise.all(MODEL_DISCOVERY_RUNNERS.filter(id => id !== runner).map(async (id) => {
+        const other = await source.models.get(id);
+        return other.source !== 'unavailable' && !other.stale && other.models.some(row => ids.has(row.id)) ? id : undefined;
+    }));
+    return { runner, requestedModel: model, availableModels: catalog.models, otherRunners: alternatives.filter((id) => id !== undefined) };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/discovery/catalog.js.map

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

package/dist/discovery/cli.d.ts

@@ -0,0 +1,8 @@
+import { type DiscoverOptions } from '../task-cli/discovery.ts';
+import { type Cockpit } from '../task-cli/http.ts';
+interface DiscoveryIo {
+    stdout(line: string): void;
+    discover?: (options: DiscoverOptions) => Promise<Cockpit>;
+}
+export declare function runDiscoverCommand(argv: string[], env?: NodeJS.ProcessEnv, io?: DiscoveryIo): Promise<number>;
+export {};

package/dist/discovery/cli.js

@@ -0,0 +1,104 @@
+import { parseArgs } from 'node:util';
+import { z } from 'zod';
+import { delegationErrorResponseSchema, discoveredRunnersSchema, discoveryRequestSchema, providerStatusResponseSchema, runnerModelCatalogResponseSchema, } from '../contract/index.js';
+import { boundedJson, delegationEndpoint } from '../delegation/cli.js';
+import { discoverCockpit } from '../task-cli/discovery.js';
+import { fetchJson, invalidResponse, refuse, TaskCliError } from '../task-cli/http.js';
+import { discoveredRunners } from './catalog.js';
+const HELP = `cez discover — inspect the host's default-account catalog
+
+Usage:
+  cez discover runners
+  cez discover models --runner <claude|codex|opencode|pi|cursor>
+
+Options:
+  --url <origin>  Cockpit to use (also CEZ_URL); operators only.
+  --repo <dir>    Checkout whose cockpit to find (default cwd); operators only.
+  -h, --help     Show help without contacting a controller.
+
+Commands return JSON. Runners include connection status and enablement.
+Model rows include effortLevels when advertised; absent means unknown, [] means
+no advertised levels. Omit an effort pin to use the runner's default.
+Catalog source/stale/reason describe discovery availability and freshness.
+Inside a parent session, discovery uses its authenticated controller, including
+headless runs. It never falls back to another cockpit on authentication failure.
+Outside a session, it finds an existing cockpit; it never starts one.
+Catalogs describe host default accounts, not every named account or spawn policy.`;
+export async function runDiscoverCommand(argv, env = process.env, io = { stdout: line => console.log(line) }) {
+    const print = (value) => {
+        let line = JSON.stringify(value);
+        if (env.CEZ_DELEGATION_TOKEN)
+            line = line.replaceAll(env.CEZ_DELEGATION_TOKEN, '[REDACTED]');
+        io.stdout(line);
+    };
+    try {
+        let parsed;
+        try {
+            parsed = parseDiscoveryArgs(argv);
+        }
+        catch {
+            throw new TaskCliError(64, { code: 'invalid_input', error: 'Use cez discover runners or cez discover models --runner=<runner>. See cez discover --help.' });
+        }
+        const { values, positionals } = parsed;
+        if (values.help) {
+            io.stdout(HELP);
+            return 0;
+        }
+        const selected = discoveryRequestSchema.safeParse({ kind: positionals[0], ...(values.runner === undefined ? {} : { runner: values.runner }) });
+        if (positionals.length !== 1 || !selected.success)
+            throw new TaskCliError(64, { code: 'invalid_input', error: 'Use cez discover runners or cez discover models --runner=<runner>.' });
+        const request = selected.data;
+        const schema = request.kind === 'runners' ? discoveredRunnersSchema : runnerModelCatalogResponseSchema;
+        // Even a partial/expired session must not silently escape its controller or scope.
+        if (env.CEZ_DELEGATION_URL !== undefined || env.CEZ_DELEGATION_TOKEN !== undefined) {
+            if (values.url !== undefined || values.repo !== undefined)
+                throw new TaskCliError(64, { code: 'invalid_input', error: 'A delegation session uses its own controller; --url and --repo are unavailable.' });
+            try {
+                const endpoint = delegationEndpoint(env.CEZ_DELEGATION_URL);
+                const token = z.string().regex(/^[A-Za-z0-9_-]{43}$/).parse(env.CEZ_DELEGATION_TOKEN);
+                const response = await fetch(`${endpoint.href}/discover`, { method: 'POST', redirect: 'error', headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' }, body: JSON.stringify(request), signal: AbortSignal.timeout(45_000) });
+                const data = await boundedJson(response);
+                if (!response.ok) {
+                    print(delegationErrorResponseSchema.parse(data));
+                    return 2;
+                }
+                print(schema.parse(data));
+                return 0;
+            }
+            catch {
+                throw new TaskCliError(2, { code: 'unavailable_transport', error: 'Discovery session is unavailable or returned an invalid response.' });
+            }
+        }
+        const cockpit = await (io.discover ?? discoverCockpit)({ repoDir: values.repo ?? process.cwd(), ...(values.url ?? env.CEZ_URL ? { url: values.url ?? env.CEZ_URL } : {}) });
+        const response = await fetchJson(`${cockpit.origin}/api/v1/${request.kind === 'runners' ? 'providers/status' : `models?runner=${encodeURIComponent(request.runner)}`}`);
+        if (response.status !== 200)
+            refuse(response);
+        if (request.kind === 'runners') {
+            const parsed = providerStatusResponseSchema.safeParse(response.data);
+            if (!parsed.success)
+                invalidResponse('runners');
+            print(discoveredRunners(parsed.data));
+        }
+        else {
+            const parsed = runnerModelCatalogResponseSchema.safeParse(response.data);
+            if (!parsed.success)
+                invalidResponse('models');
+            print(parsed.data);
+        }
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof TaskCliError) {
+            print(error.body);
+            return error.exitCode;
+        }
+        print({ code: 'unavailable', error: 'Discovery is unavailable.' });
+        return 2;
+    }
+}
+function parseDiscoveryArgs(args) {
+    return parseArgs({ args, allowPositionals: true, strict: true, options: {
+            runner: { type: 'string' }, url: { type: 'string' }, repo: { type: 'string' }, help: { type: 'boolean', short: 'h' },
+        } });
+}
+//# sourceMappingURL=cli.js.map

package/dist/discovery/cli.js.map

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

package/dist/git-worktree.d.ts

@@ -56,7 +56,9 @@ export declare function createWorktree(repoRoot: string, runId: string, baseBran
  * size only blanks the panel's size column, it does not affect reclamation.
  */
 export declare function worktreeSizeBytes(path: string): Promise<number | null>;
-export declare function removeWorktree(repoRoot: string, worktreePath: string, branch?: string): Promise<void>;
+export declare function removeWorktree(repoRoot: string, worktreePath: string, branch?: string, opts?: {
+    reclaimOwnedDirectory?: boolean;
+}): Promise<void>;
 /**
  * Why an autosave commit happened. Only `periodic` is gated (behind
  * `CEZ_AUTOSAVE=1`, #471) — the three flushes always run so the branch ends