@cerbur/clutch-dsh-worktree 0.1.16 → 0.1.17

package/lib/tool/index.js

@@ -0,0 +1,296 @@
+import { CommandDefinitionId } from '@deepseek-ai/dsh-commands/brand';
+import { WORKTREE_TOOL_IDS } from '../contract/tool-settings.js';
+import { authorize, available } from './context.js';
+import { toolWorkspace, createToolContext } from './context.js';
+import { registerNewWorktree } from './new-worktree.js';
+import { registerListWorktrees } from './list-worktrees.js';
+import { registerSpanWorktree } from './span-worktree.js';
+import { registerListModels } from './list-models.js';
+import { registerListSessions } from './list-sessions.js';
+import { registerSendMessage } from './send-message.js';
+import { registerReportResult } from './report-result.js';
+import { registerToolGuidance } from './guidance.js';
+import { actionableError } from './errors.js';
+import { toolParameters } from './schema.js';
+import { DelegationControl } from './delegation.js';
+const jsonProjection = (value) => JSON.parse(JSON.stringify(value));
+export { createWorktreeToolSessionPort } from './native-session.js';
+export { readToolSession } from './history.js';
+/** Registrations and reporting destinations are runtime-only and Agent-scoped. */
+export async function registerWorktreeTools(ctx, options) {
+    const enabled = new Map();
+    const delegation = new DelegationControl();
+    const lifetime = new AbortController();
+    ctx.effect(() => async () => {
+        lifetime.abort(new Error('Worktree plugin is disposed'));
+        delegation.clear();
+        await Promise.all([...enabled.values()].map(({ fiber }) => fiber.dispose()));
+        enabled.clear();
+    }, 'clutch-dsh-worktree: scoped tool cleanup');
+    ctx.on('agent/disposed', async ({ agent }) => {
+        const state = enabled.get(agent);
+        delegation.dispose(agent);
+        enabled.delete(agent);
+        await state?.fiber.dispose();
+    }, { global: true });
+    ctx.on('session/event', (session, event) => delegation.event(session.id, event), { global: true });
+    const enable = async (agent, signal, names, parentSessionId) => {
+        signal.throwIfAborted();
+        delegation.assertAlive(agent);
+        if (lifetime.signal.aborted || options.isDisposed())
+            throw new Error('Worktree plugin is disposed');
+        await toolWorkspace(agent.session.id, options);
+        signal.throwIfAborted();
+        delegation.assertAlive(agent);
+        const existing = enabled.get(agent);
+        if (existing) {
+            await existing.fiber;
+            signal.throwIfAborted();
+            lifetime.signal.throwIfAborted();
+            delegation.assertAlive(agent);
+            return existing.add(names, parentSessionId);
+        }
+        const state = { names: new Set(), parentSessionId };
+        const fiber = agent.ctx.inject(['tools', 'systemPrompt'], (scoped) => {
+            const scopeLifetime = new AbortController();
+            scoped.effect(() => () => scopeLifetime.abort(new Error('Calling Agent is disposed')), 'clutch-dsh-worktree: scoped cancellation');
+            const registry = scoped.get('tools');
+            const check = (exec) => {
+                exec.signal.throwIfAborted();
+                if (lifetime.signal.aborted || scopeLifetime.signal.aborted || options.isDisposed())
+                    throw new Error('Worktree plugin or calling Agent is disposed');
+                if (exec.agent !== agent)
+                    throw new Error('Use /cluworktree in the calling Session first');
+            };
+            let transaction = [];
+            const add = (name, description, schema, outputSchema, execute) => {
+                const dispose = registry.register({
+                    name,
+                    description,
+                    parameters: jsonProjection(toolParameters(schema)),
+                    output: {
+                        schema: outputSchema,
+                        render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+                    },
+                    execute: async (args, exec) => {
+                        const execution = {
+                            ...exec,
+                            signal: AbortSignal.any([exec.signal, lifetime.signal, scopeLifetime.signal]),
+                        };
+                        try {
+                            check(execution);
+                            return jsonProjection(await execute(schema.parse(args), execution));
+                        }
+                        catch (cause) {
+                            execution.signal.throwIfAborted();
+                            throw actionableError(name, cause);
+                        }
+                    },
+                });
+                transaction.push(dispose);
+                return dispose;
+            };
+            const context = createToolContext(agent, options, check, add, delegation);
+            delegation.register(agent);
+            scoped.effect(() => () => {
+                delegation.release(agent);
+                if (enabled.get(agent) === state)
+                    enabled.delete(agent);
+            }, 'clutch-dsh-worktree: token cleanup');
+            context.enableChild = async (sessionId, requestId, prompt, mode, exec) => {
+                check(exec);
+                const child = await options.sessions.resolveAgent(sessionId, exec.signal);
+                // Initialize the scope before installing a task-bound reporting handler.
+                await enable(child, exec.signal, []);
+                delegation.prepareTask(agent, child, requestId, prompt, mode);
+                await enable(child, exec.signal, ['clutch_report_result'], agent.session.id);
+                await autoEnable(child, exec.signal);
+                check(exec);
+            };
+            context.prepareMessage = async (sessionId, requestId, prompt, mode, exec, retry) => {
+                delegation.assertDispatch(agent, sessionId);
+                if (retry)
+                    delegation.assertRetry(requestId);
+                if (delegation.child(agent, sessionId))
+                    await context.enableChild(sessionId, requestId, prompt, mode, exec);
+                else {
+                    const target = await options.sessions.resolveAgent(sessionId, exec.signal);
+                    await enable(target, exec.signal, []);
+                    delegation.trackMessage(agent, sessionId, requestId, prompt, mode);
+                }
+            };
+            const registrations = {
+                clutch_new_worktree: registerNewWorktree,
+                clutch_list_worktrees: registerListWorktrees,
+                clutch_span_worktree: registerSpanWorktree,
+                clutch_list_models: registerListModels,
+                clutch_list_sessions: registerListSessions,
+                clutch_send_message: registerSendMessage,
+            };
+            registerToolGuidance(scoped, () => state.names, () => state.parentSessionId);
+            state.add = (requested, parent) => {
+                const missing = requested.filter((name) => !state.names.has(name));
+                if (!missing.length)
+                    return 0;
+                transaction = [];
+                const previousParent = state.parentSessionId;
+                try {
+                    if (parent !== undefined)
+                        state.parentSessionId = parent;
+                    for (const name of missing) {
+                        if (name === 'clutch_report_result')
+                            registerReportResult(context);
+                        else
+                            registrations[name](context);
+                    }
+                    for (const name of missing)
+                        state.names.add(name);
+                    return missing.length;
+                }
+                catch (error) {
+                    for (const dispose of transaction.reverse())
+                        dispose();
+                    state.parentSessionId = previousParent;
+                    throw error;
+                }
+            };
+        });
+        state.fiber = fiber;
+        enabled.set(agent, state);
+        try {
+            await fiber;
+            signal.throwIfAborted();
+            if (lifetime.signal.aborted || options.isDisposed())
+                throw new Error('Worktree plugin is disposed');
+            delegation.assertAlive(agent);
+            return state.add(names, parentSessionId);
+        }
+        catch (error) {
+            enabled.delete(agent);
+            delegation.release(agent);
+            await fiber.dispose();
+            throw error;
+        }
+    };
+    /** Bindings may follow agent creation; resolve preferences at prompt assembly. */
+    const autoEnable = async (agent, signal) => {
+        if (!options.settings)
+            return 0;
+        const workspaceId = await toolWorkspace(agent.session.id, options);
+        const bindings = (await options.manager.listBindings({ workspaceId })).filter((binding) => binding.sessionId === agent.session.id);
+        if (bindings.length > 1)
+            return 0;
+        const binding = bindings[0];
+        let scope;
+        if (binding) {
+            if (binding.status !== 'active')
+                return 0;
+            const record = (await options.manager.listWorktrees({ workspaceId })).find((item) => item.worktreeId === binding.worktreeId);
+            if (!record || !available(record))
+                return 0;
+            scope = { kind: 'worktree', workspaceId, worktreeId: record.worktreeId };
+        }
+        else {
+            scope = { kind: 'local', workspaceId };
+        }
+        let selection;
+        try {
+            selection = await options.settings.read(scope);
+        }
+        catch {
+            // Damaged preferences must not block ordinary native Session execution.
+            return 0;
+        }
+        if (!selection.enabled)
+            return 0;
+        await authorize(agent.session.id, workspaceId, options, true);
+        return enable(agent, signal, selection.tools);
+    };
+    const freshAssembly = Symbol('clutch-worktree: fresh prompt assembly');
+    ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
+        if (context[freshAssembly] || !options.settings ||
+            lifetime.signal.aborted || options.isDisposed())
+            return next();
+        const candidate = context.agent ?? context.scope;
+        if (candidate === null || typeof candidate !== 'object' ||
+            !('session' in candidate) || !('ctx' in candidate) ||
+            context.scope !== candidate)
+            return next();
+        const agent = candidate;
+        const before = enabled.get(agent)?.names.size ?? 0;
+        let workspaceId;
+        try {
+            workspaceId = await toolWorkspace(agent.session.id, options);
+        }
+        catch {
+            /* Global and unowned Agent assemblies retain their native catalog. */
+        }
+        if (workspaceId === undefined)
+            return next();
+        const added = await autoEnable(agent, context.signal ?? lifetime.signal);
+        if (!added && (enabled.get(agent)?.names.size ?? 0) === before)
+            return next();
+        // DSH collects registered providers before this waterfall, and pre-step runs
+        // after assemble(). Rebuild once so both the SDK and guidance reach request 1.
+        // The marker belongs to this invocation; concurrent assemblies are independent.
+        const prompt = ctx.get('systemPrompt');
+        return prompt.assemble({ ...context, [freshAssembly]: true });
+    }, { prepend: true });
+    const commands = ctx.get('commands');
+    let unregister;
+    const syncCommand = (active) => {
+        if (lifetime.signal.aborted || options.isDisposed())
+            return;
+        if (!active) {
+            unregister?.();
+            unregister = undefined;
+            return;
+        }
+        if (unregister)
+            return;
+        unregister = commands.register({
+            definitionId: CommandDefinitionId('@cerbur/clutch-dsh-worktree:cluworktree'),
+            name: 'cluworktree',
+            description: 'Enable the Worktree capabilities selected in Settings for this conversation',
+            handler: async ({ agent, rawInput, signal }) => {
+                if (rawInput.trim())
+                    return { kind: 'error', text: 'Usage: /cluworktree' };
+                const selection = options.settings
+                    ? await options.settings.read({ kind: 'general' })
+                    : { enabled: true, tools: WORKTREE_TOOL_IDS };
+                if (!selection.enabled || !selection.tools.length)
+                    return {
+                        kind: 'error',
+                        text: 'Enable Worktree tools in Settings → Worktree → General first.',
+                    };
+                await autoEnable(agent, signal);
+                const added = await enable(agent, signal, selection.tools);
+                const count = [...enabled.get(agent).names].filter((name) => name !== 'clutch_report_result').length;
+                return {
+                    kind: 'success',
+                    text: added
+                        ? `Worktree tools enabled for this conversation: ${added} added, ${count} available. Describe the task you want to delegate or isolate.`
+                        : `Worktree tools are already enabled for this conversation: ${count} available.`,
+                };
+            },
+        });
+    };
+    ctx.effect(() => () => unregister?.(), 'clutch-dsh-worktree: command cleanup');
+    if (options.settings) {
+        ctx.effect(() => options.settings.subscribe((scope, selection) => {
+            if (scope.kind === 'general')
+                syncCommand(selection.enabled);
+        }), 'clutch-dsh-worktree: preferences subscription');
+    }
+    let active = !options.settings;
+    if (options.settings) {
+        try {
+            active = (await options.settings.read({ kind: 'general' })).enabled;
+        }
+        catch {
+            /* Keep command unavailable; native Sessions and result reporting stay usable. */
+        }
+    }
+    syncCommand(active);
+}
+//# sourceMappingURL=index.js.map

package/lib/tool/index.js.map

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

package/lib/tool/inputs.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const text: z.ZodString;
+export declare const prompt: z.ZodString;
+export declare const model: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    reasoningEffort: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const workspace: z.ZodObject<{
+    workspaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+//# sourceMappingURL=inputs.d.ts.map

package/lib/tool/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/tool/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,eAAO,MAAM,IAAI,aAA2B,CAAC;AAC7C,eAAO,MAAM,MAAM,aAKhB,CAAC;AACJ,eAAO,MAAM,KAAK;;;;kBAaf,CAAC;AACJ,eAAO,MAAM,SAAS;;kBAQX,CAAC"}

package/lib/tool/inputs.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const text = z.string().trim().min(1);
+export const prompt = z
+    .string()
+    .refine((value) => value.trim().length > 0, 'prompt must not be empty')
+    .describe('Required nonempty task/message text, preserved exactly. For delegation include goal, scope, acceptance criteria and checks.');
+export const model = z
+    .object({
+    provider: text.describe('Exact provider group id returned by clutch_list_models, not its display name.'),
+    model: text.describe('Exact model id within that provider, returned by clutch_list_models.'),
+    reasoningEffort: text
+        .optional()
+        .describe('Exact supported reasoning effort id for that model; omit to use its default.'),
+})
+    .strict()
+    .describe('Optional model override as an object {provider, model, reasoningEffort?}, never a string. Omit to inherit the calling Session model and effort.');
+export const workspace = z
+    .object({
+    workspaceId: text
+        .optional()
+        .describe('Omit to use the calling Session Workspace. If supplied it must be that same Workspace id, not a directory path.'),
+})
+    .strict();
+//# sourceMappingURL=inputs.js.map

package/lib/tool/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../src/tool/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,0BAA0B,CAAC;KACtE,QAAQ,CACP,6HAA6H,CAC9H,CAAC;AACJ,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,+EAA+E,CAChF;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC5F,eAAe,EAAE,IAAI;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CACP,iJAAiJ,CAClJ,CAAC;AACJ,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,WAAW,EAAE,IAAI;SACd,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;CACJ,CAAC;KACD,MAAM,EAAE,CAAC"}

package/lib/tool/list-models.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from './context.js';
+export declare function registerListModels(context: ToolContext): void;
+//# sourceMappingURL=list-models.d.ts.map

package/lib/tool/list-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../src/tool/list-models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAchD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgD7D"}

package/lib/tool/list-models.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { text } from './inputs.js';
+import * as output from './outputs.js';
+const listModelsArgs = z
+    .object({
+    provider: text
+        .optional()
+        .describe('Optional exact provider group id. Omit to discover available providers; not a model id or display name.'),
+})
+    .strict();
+export function registerListModels(context) {
+    const { add, agent, options, check, scope } = context;
+    add('clutch_list_models', 'Discover native models grouped by provider, with reasoning efforts and provider failures. Optional provider filters the catalog. Returns the current Session model separately from the deployment default.', listModelsArgs, output.object({
+        current: output.model,
+        default: output.model,
+        groups: output.array(output.object({ id: output.string, name: output.string, models: output.array(output.catalogModel) }, ['id', 'name', 'models'])),
+        failures: output.array(output.object({ id: output.string, name: output.string, message: output.string }, [
+            'id',
+            'message',
+        ])),
+    }, ['current', 'default', 'groups', 'failures']), async (args, exec) => {
+        await scope();
+        const catalog = await options.sessions.modelCatalog();
+        const current = await options.sessions.currentModel(agent.session.id, exec.signal);
+        check(exec);
+        if (args.provider &&
+            !catalog.groups.some((group) => group.id === args.provider) &&
+            !catalog.failures.some((failure) => failure.id === args.provider))
+            throw new Error('Unknown model provider');
+        return {
+            current,
+            default: catalog.default,
+            groups: catalog.groups.filter((group) => args.provider === undefined || group.id === args.provider),
+            failures: catalog.failures.filter((failure) => args.provider === undefined || failure.id === args.provider),
+        };
+    });
+}
+//# sourceMappingURL=list-models.js.map

package/lib/tool/list-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../src/tool/list-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AAEvC,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,QAAQ,EAAE,IAAI;SACX,QAAQ,EAAE;SACV,QAAQ,CACP,yGAAyG,CAC1G;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACtD,GAAG,CACD,oBAAoB,EACpB,4MAA4M,EAC5M,cAAc,EACd,MAAM,CAAC,MAAM,CACX;QACE,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,MAAM,EAAE,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,MAAM,CACX,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EACrF,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CACzB,CACF;QACD,QAAQ,EAAE,MAAM,CAAC,KAAK,CACpB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE;YAChF,IAAI;YACJ,SAAS;SACV,CAAC,CACH;KACF,EACD,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAC7C,EACD,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACnB,MAAM,KAAK,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IACE,IAAI,CAAC,QAAQ;YACb,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC;YAC3D,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC;YAEjE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAC3B,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CACrE;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAC/B,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CACzE;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/lib/tool/list-sessions.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from './context.js';
+export declare function registerListSessions(context: ToolContext): void;
+//# sourceMappingURL=list-sessions.d.ts.map

package/lib/tool/list-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sessions.d.ts","sourceRoot":"","sources":["../../src/tool/list-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBhD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgF/D"}

package/lib/tool/list-sessions.js

@@ -0,0 +1,70 @@
+import { text, workspace } from './inputs.js';
+import * as output from './outputs.js';
+import { authorize, errorText } from './context.js';
+import { latestToolSessionCursor, readToolSession } from './history.js';
+const listSessionsArgs = workspace
+    .extend({
+    worktreeId: text
+        .optional()
+        .describe('Optional stable Worktree id from new/list. Prefer this filter when locating a task’s Sessions.'),
+})
+    .strict();
+export function registerListSessions(context) {
+    const { add, options, check, scope } = context;
+    add('clutch_list_sessions', 'Discover existing Sessions in the calling Workspace, optionally filtered by worktreeId. Returns stable ids, binding state, status and title. These are ordinary Sessions, not a parent/subagent task catalog.', listSessionsArgs, output.object({
+        workspaceId: output.string,
+        sessions: output.array(output.object({
+            sessionId: output.string,
+            worktreeId: output.string,
+            bindingStatus: output.string,
+            cwd: output.string,
+            status: output.string,
+            title: output.string,
+            diagnostic: output.string,
+        }, ['sessionId', 'bindingStatus', 'status'])),
+    }, ['workspaceId', 'sessions']), async (args, exec) => {
+        const workspaceId = await scope(args.workspaceId);
+        const bindings = await options.manager.listBindings({ workspaceId });
+        if (args.worktreeId !== undefined &&
+            !(await options.manager.listWorktrees({ workspaceId })).some((item) => item.worktreeId === args.worktreeId))
+            throw new Error('Worktree not found in the calling Workspace');
+        const candidates = (await options.dsh.listSessions()).filter((session) => {
+            const binding = bindings.find((item) => item.sessionId === session.sessionId);
+            return ((session.workspaceId === workspaceId || binding !== undefined) &&
+                (session.workspaceId === undefined || session.workspaceId === workspaceId) &&
+                (args.worktreeId === undefined || binding?.worktreeId === args.worktreeId));
+        });
+        const items = [];
+        for (const session of candidates) {
+            check(exec);
+            const binding = bindings.find((item) => item.sessionId === session.sessionId);
+            try {
+                await authorize(session.sessionId, workspaceId, options);
+                const snapshot = await options.sessions.snapshot(session.sessionId, exec.signal);
+                check(exec);
+                const value = readToolSession(session.sessionId, snapshot, latestToolSessionCursor(session.sessionId, snapshot));
+                items.push({
+                    sessionId: session.sessionId,
+                    worktreeId: binding?.worktreeId,
+                    bindingStatus: binding?.status ?? 'main',
+                    cwd: session.cwd,
+                    status: value.status,
+                    title: typeof snapshot.values.title === 'string' ? snapshot.values.title : undefined,
+                });
+            }
+            catch (error) {
+                check(exec);
+                items.push({
+                    sessionId: session.sessionId,
+                    worktreeId: binding?.worktreeId,
+                    bindingStatus: binding?.status ?? 'main',
+                    status: 'unavailable',
+                    diagnostic: `Cannot inspect this Session: ${errorText(error).slice(0, 500)}. Other Sessions remain available. Repair this Session in DSH; do not repeatedly query the whole list to retry its history migration.`,
+                });
+                continue;
+            }
+        }
+        return { workspaceId, sessions: items };
+    });
+}
+//# sourceMappingURL=list-sessions.js.map

package/lib/tool/list-sessions.js.map

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

package/lib/tool/list-worktrees.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from './context.js';
+export declare function registerListWorktrees(context: ToolContext): void;
+//# sourceMappingURL=list-worktrees.d.ts.map

package/lib/tool/list-worktrees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-worktrees.d.ts","sourceRoot":"","sources":["../../src/tool/list-worktrees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CA+ChE"}

package/lib/tool/list-worktrees.js

@@ -0,0 +1,39 @@
+import { workspace } from './inputs.js';
+import * as output from './outputs.js';
+import { errorText } from './context.js';
+export function registerListWorktrees(context) {
+    const { add, options, check, scope } = context;
+    add('clutch_list_worktrees', 'List managed Worktrees and local base branches in workspaceId, defaulting to the calling Workspace. Returns stable ids, branch, path, lifecycle and health. Another Workspace is rejected.', workspace, output.object({
+        workspaceId: output.string,
+        worktrees: output.array(output.worktree),
+        branches: output.array(output.object({ name: output.string, isCurrent: output.boolean, checkedOut: output.boolean }, ['name', 'isCurrent', 'checkedOut'])),
+        branchesUnavailable: output.string,
+    }, ['workspaceId', 'worktrees']), async (args, exec) => {
+        const workspaceId = await scope(args.workspaceId);
+        const records = await options.manager.listWorktrees({ workspaceId });
+        let branchFacts;
+        try {
+            branchFacts = { branches: await options.manager.listBranches({ workspaceId }) };
+        }
+        catch (error) {
+            check(exec);
+            branchFacts = { branchesUnavailable: errorText(error) };
+        }
+        check(exec);
+        return {
+            workspaceId,
+            ...branchFacts,
+            worktrees: records.map((record) => ({
+                worktreeId: record.worktreeId,
+                branch: record.branch,
+                absolutePath: record.absolutePath,
+                status: record.status,
+                health: record.health,
+                diskCleanup: record.diskCleanup,
+                baseBranch: record.baseBranch,
+                baseCommit: record.baseCommit,
+            })),
+        };
+    });
+}
+//# sourceMappingURL=list-worktrees.js.map

package/lib/tool/list-worktrees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-worktrees.js","sourceRoot":"","sources":["../../src/tool/list-worktrees.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,qBAAqB,CAAC,OAAoB;IACxD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC/C,GAAG,CACD,uBAAuB,EACvB,4LAA4L,EAC5L,SAAS,EACT,MAAM,CAAC,MAAM,CACX;QACE,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC,KAAK,CACpB,MAAM,CAAC,MAAM,CACX,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,EAC9E,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CACpC,CACF;QACD,mBAAmB,EAAE,MAAM,CAAC,MAAM;KACnC,EACD,CAAC,aAAa,EAAE,WAAW,CAAC,CAC7B,EACD,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACnB,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QACrE,IAAI,WAAW,CAAC;QAChB,IAAI,CAAC;YACH,WAAW,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,WAAW,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,OAAO;YACL,WAAW;YACX,GAAG,WAAW;YACd,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAClC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/lib/tool/native-session.d.ts

@@ -0,0 +1,74 @@
+import type { CallingAgent } from './types.js';
+import type { Context } from '@deepseek-ai/cordis';
+export interface ToolModel {
+    readonly provider: string;
+    readonly model: string;
+    readonly reasoningEffort?: string;
+}
+export interface ToolModelCatalog {
+    readonly default: ToolModel;
+    readonly groups: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly models: readonly {
+            readonly id: string;
+            readonly name: string;
+            readonly reasoning?: {
+                readonly efforts: readonly {
+                    readonly id: string;
+                    readonly name: string;
+                }[];
+                readonly defaultEffort?: string;
+            };
+        }[];
+    }[];
+    readonly failures: readonly {
+        readonly id: string;
+        readonly message: string;
+    }[];
+}
+export interface ToolSessionEvent {
+    readonly seq: number;
+    readonly time: number;
+    readonly type: string;
+    readonly data: unknown;
+}
+export interface ToolSessionSnapshot {
+    readonly events: readonly ToolSessionEvent[];
+    readonly running: boolean;
+    readonly values: Readonly<Record<string, unknown>>;
+    readonly error?: string;
+}
+/** Host-only native capabilities; never added to the Provider's read adapter. */
+export interface WorktreeToolSessionPort {
+    resolveAgent(sessionId: string, signal: AbortSignal): Promise<CallingAgent>;
+    create(input: {
+        cwd: string;
+    }): Promise<{
+        sessionId: string;
+    }>;
+    prompt(input: {
+        sessionId: string;
+        requestId: string;
+        mode: 'queue' | 'steer';
+        content: readonly {
+            type: 'text';
+            text: string;
+        }[];
+    }, signal: AbortSignal): Promise<{
+        accepted: true;
+    }>;
+    rename(input: {
+        sessionId: string;
+        title: string;
+    }): Promise<unknown>;
+    modelCatalog(): Promise<ToolModelCatalog>;
+    currentModel(sessionId: string, signal: AbortSignal): Promise<ToolModel>;
+    validateModel(model: ToolModel, signal: AbortSignal): Promise<ToolModel>;
+    configureModel(sessionId: string, model: ToolModel, signal: AbortSignal): Promise<void>;
+    snapshot(sessionId: string, signal: AbortSignal): Promise<ToolSessionSnapshot>;
+    subscribe(sessionIds: readonly string[], changed: () => void): () => void;
+}
+/** Native reads stay cold; model routing is installed only on a newly created Agent. */
+export declare function createWorktreeToolSessionPort(ctx: Context): WorktreeToolSessionPort;
+//# sourceMappingURL=native-session.d.ts.map