@cerbur/clutch-dsh-worktree 0.1.16 → 0.1.17

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

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

package/lib/tool/native-session.js

@@ -0,0 +1,248 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+/** Native reads stay cold; model routing is installed only on a newly created Agent. */
+export function createWorktreeToolSessionPort(ctx) {
+    const native = ctx;
+    const controller = ctx.get('sessionController');
+    const errors = new Map();
+    const hooks = new Map();
+    const questions = new Map();
+    const listeners = new Set();
+    const notify = (id) => {
+        for (const listener of listeners)
+            if (listener.ids.has(id))
+                listener.changed();
+    };
+    const disposeQuestions = native.on('user-questions/request', (async (request, next) => {
+        const id = request.agent?.session.id;
+        if (id === undefined)
+            return next();
+        questions.set(id, (questions.get(id) ?? 0) + 1);
+        notify(id);
+        try {
+            return await next();
+        }
+        finally {
+            const remaining = (questions.get(id) ?? 1) - 1;
+            if (remaining === 0)
+                questions.delete(id);
+            else
+                questions.set(id, remaining);
+            notify(id);
+        }
+    }), { global: true });
+    const disposeError = native.on('api-session/error', ((id, message) => {
+        if (errors.size >= 128)
+            errors.delete(errors.keys().next().value);
+        errors.set(id, message);
+    }), { global: true });
+    const disposeStart = native.on('session/event', ((session, event) => {
+        if (event.type === 'turn/start')
+            errors.delete(session.id);
+    }), { global: true });
+    ctx.effect(() => () => {
+        disposeError();
+        disposeStart();
+        disposeQuestions();
+        for (const dispose of hooks.values())
+            dispose();
+        hooks.clear();
+        errors.clear();
+        questions.clear();
+        listeners.clear();
+    }, 'clutch-dsh-worktree: Session tool routing cleanup');
+    const snapshot = async (sessionId, signal) => {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            signal.throwIfAborted();
+            const observed = __addDisposableResource(env_1, await native.sessionQuery.observeSession(sessionId, { signal }), false);
+            signal.throwIfAborted();
+            return {
+                events: observed.events,
+                values: {
+                    ...observed.projections?.values,
+                    worktreeToolWaitingForUser: questions.has(sessionId),
+                },
+                running: native.agents.get(sessionId)?.status === 'running',
+                ...(errors.has(sessionId) ? { error: errors.get(sessionId) } : {}),
+            };
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            __disposeResources(env_1);
+        }
+    };
+    return {
+        resolveAgent: async (sessionId, signal) => {
+            signal.throwIfAborted();
+            const result = await controller.resolveAgent(sessionId);
+            if ('error' in result)
+                throw result.error;
+            signal.throwIfAborted();
+            return result.agent;
+        },
+        create: (input) => controller.create(input),
+        prompt: (input, signal) => controller.prompt(input, signal),
+        rename: (input) => controller.rename(input),
+        modelCatalog: () => controller.modelCatalog(),
+        snapshot,
+        currentModel: async (sessionId, signal) => {
+            const value = await snapshot(sessionId, signal);
+            const selection = value.values.modelSelection;
+            if (selection?.next)
+                return { ...selection.next };
+            const header = native.agents.get(sessionId)?.session.requestHeader();
+            if (header) {
+                const { reasoningEffort, ...route } = header.config;
+                return {
+                    provider: route.provider,
+                    model: route.model,
+                    ...(reasoningEffort === undefined || header.adapterDefaults?.reasoningEffort
+                        ? {}
+                        : { reasoningEffort }),
+                };
+            }
+            return { ...(await controller.modelCatalog()).default };
+        },
+        validateModel: async (model, signal) => {
+            signal.throwIfAborted();
+            const catalog = await controller.modelCatalog();
+            const entry = catalog.groups
+                .find((group) => group.id === model.provider)
+                ?.models.find((item) => item.id === model.model);
+            if (!entry ||
+                (model.reasoningEffort !== undefined &&
+                    !entry.reasoning?.efforts.some((effort) => effort.id === model.reasoningEffort))) {
+                throw new Error('Requested model or reasoning effort is unavailable; use clutch_list_models');
+            }
+            const resolved = await native.llm.resolveCallConfig(model, signal);
+            signal.throwIfAborted();
+            return {
+                provider: resolved.provider,
+                model: resolved.model,
+                ...(resolved.reasoningEffort === undefined
+                    ? {}
+                    : { reasoningEffort: resolved.reasoningEffort }),
+            };
+        },
+        configureModel: async (sessionId, model, signal) => {
+            signal.throwIfAborted();
+            const result = await controller.resolveAgent(sessionId);
+            if ('error' in result)
+                throw result.error;
+            signal.throwIfAborted();
+            const { agent } = result;
+            hooks.get(sessionId)?.();
+            // Prepend makes these outer waterfalls: the native model listeners run
+            // first, then this creation-only route wins consistently on both surfaces.
+            // DSH records the resulting request/header and restores it on cold resume.
+            const scoped = agent.ctx;
+            const assembly = scoped.on('system-prompt/assemble', (async (_assembly, _context, next) => {
+                const assembled = await next();
+                return {
+                    ...assembled,
+                    variables: { ...assembled.variables, provider: model.provider, model: model.model },
+                };
+            }), { prepend: true });
+            const request = scoped.on('agent/request', (async (_payload, next) => {
+                const { reasoningEffort: _effort, ...config } = await next();
+                void _effort;
+                return { ...config, ...model };
+            }), { prepend: true });
+            const dispose = () => {
+                assembly();
+                request();
+                event();
+                disposed();
+                hooks.delete(sessionId);
+            };
+            const event = native.on('session/event', ((session, value) => {
+                if (session.id === sessionId &&
+                    (value.type === 'request/header' || value.type === 'model/selection'))
+                    dispose();
+            }), { global: true });
+            const disposed = native.on('agent/disposed', ((value) => {
+                if (value.agent === agent || value.agent.session.id === sessionId)
+                    dispose();
+            }), { global: true });
+            hooks.set(sessionId, dispose);
+        },
+        subscribe: (sessionIds, changed) => {
+            const ids = new Set(sessionIds);
+            const listener = { ids, changed };
+            listeners.add(listener);
+            const event = native.on('session/event', ((session) => {
+                if (ids.has(session.id))
+                    changed();
+            }), { global: true });
+            const status = native.on('agent/status', ((value) => {
+                if (ids.has(value.agent.session.id))
+                    changed();
+            }), { global: true });
+            const error = native.on('api-session/error', ((id) => {
+                if (ids.has(id))
+                    changed();
+            }), { global: true });
+            return () => {
+                event();
+                status();
+                error();
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=native-session.js.map

package/lib/tool/native-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-session.js","sourceRoot":"","sources":["../../src/tool/native-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8FA,wFAAwF;AACxF,MAAM,UAAU,6BAA6B,CAAC,GAAY;IACxD,MAAM,MAAM,GAAG,GAA+B,CAAC;IAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAA4B,CAAC;IAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiD,CAAC;IAC3E,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE;QAC5B,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjF,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAChC,wBAAwB,EACxB,CAAC,KAAK,EAAE,OAAgC,EAAE,IAA4B,EAAE,EAAE;QACxE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACrC,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,IAAI,EAAE,CAAC;QACpC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,SAAS,KAAK,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;;gBACrC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAClC,MAAM,CAAC,EAAE,CAAC,CAAC;QACb,CAAC;IACH,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAC5B,mBAAmB,EACnB,CAAC,CAAC,EAAU,EAAE,OAAe,EAAE,EAAE;QAC/B,IAAI,MAAM,CAAC,IAAI,IAAI,GAAG;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAC5B,eAAe,EACf,CAAC,CAAC,OAAuB,EAAE,KAAuB,EAAE,EAAE;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACF,GAAG,CAAC,MAAM,CACR,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;QACf,gBAAgB,EAAE,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,OAAO,EAAE,CAAC;QAChD,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC,EACD,mDAAmD,CACpD,CAAC;IAEF,MAAM,QAAQ,GAAwC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;;;YAChF,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,kCAAG,MAAM,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,QAAA,CAAC;YACjF,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE;oBACN,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM;oBAC/B,0BAA0B,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;iBACrD;gBACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,SAAS;gBAC3D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;;;;;;;;;KACH,CAAC;IAEF,OAAO;QACL,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM,MAAM,CAAC,KAAK,CAAC;YAC1C,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3D,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE;QAC7C,QAAQ;QACR,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,cAAyD,CAAC;YACzF,IAAI,SAAS,EAAE,IAAI;gBAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;YACrE,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;gBACpD,OAAO;oBACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,EAAE,eAAe;wBAC1E,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;iBACzB,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,GAAG,CAAC,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1D,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM;iBACzB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC;gBAC7C,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,IACE,CAAC,KAAK;gBACN,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS;oBAClC,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,eAAe,CAAC,CAAC,EAClF,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnE,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;gBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,GAAG,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;oBACxC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC;aACnD,CAAC;QACJ,CAAC;QACD,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACjD,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM,MAAM,CAAC,KAAK,CAAC;YAC1C,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;YACzB,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YACzB,uEAAuE;YACvE,2EAA2E;YAC3E,2EAA2E;YAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,GAMpB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CACxB,wBAAwB,EACxB,CAAC,KAAK,EACJ,SAAkB,EAClB,QAAiB,EACjB,IAA2D,EAC3D,EAAE;gBACF,MAAM,SAAS,GAAG,MAAM,IAAI,EAAE,CAAC;gBAC/B,OAAO;oBACL,GAAG,SAAS;oBACZ,SAAS,EAAE,EAAE,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;iBACpF,CAAC;YACJ,CAAC,CAA2C,EAC5C,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CACvB,eAAe,EACf,CAAC,KAAK,EAAE,QAAiB,EAAE,IAA4C,EAAE,EAAE;gBACzE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;gBAC7D,KAAK,OAAO,CAAC;gBACb,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACjC,CAAC,CAA2C,EAC5C,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,CAAC;gBACX,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CACrB,eAAe,EACf,CAAC,CAAC,OAAuB,EAAE,KAAuB,EAAE,EAAE;gBACpD,IACE,OAAO,CAAC,EAAE,KAAK,SAAS;oBACxB,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;oBAErE,OAAO,EAAE,CAAC;YACd,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CACxB,gBAAgB,EAChB,CAAC,CAAC,KAA6B,EAAE,EAAE;gBACjC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS;oBAAE,OAAO,EAAE,CAAC;YAC/E,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;YACF,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;YACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAClC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CACrB,eAAe,EACf,CAAC,CAAC,OAAuB,EAAE,EAAE;gBAC3B,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO,EAAE,CAAC;YACrC,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CACtB,cAAc,EACd,CAAC,CAAC,KAA6B,EAAE,EAAE;gBACjC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO,EAAE,CAAC;YACjD,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CACrB,mBAAmB,EACnB,CAAC,CAAC,EAAU,EAAE,EAAE;gBACd,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,EAAE,CAAC;YAC7B,CAAC,CAA+B,EAChC,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;YACF,OAAO,GAAG,EAAE;gBACV,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,CAAC;gBACR,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/tool/new-worktree.d.ts

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

package/lib/tool/new-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-worktree.d.ts","sourceRoot":"","sources":["../../src/tool/new-worktree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAuBhD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAyE9D"}

package/lib/tool/new-worktree.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { text } from './inputs.js';
+import * as output from './outputs.js';
+import { defaultBase, errorText } from './context.js';
+const newArgs = z
+    .object({
+    name: text.describe('Required NEW Git branch name, for example feature/demo; not a path or existing Worktree id.'),
+    baseBranch: text
+        .optional()
+        .describe('Existing local branch override. Omit to inherit the caller checkout’s committed HEAD; do not assume main.'),
+    instructions: z
+        .string()
+        .max(32000)
+        .optional()
+        .describe('Optional shared instructions saved for this Worktree; max 32000 characters.'),
+})
+    .strict();
+export function registerNewWorktree(context) {
+    const { add, agent, options, check, scope } = context;
+    add('clutch_new_worktree', 'Create a managed Worktree with a new branch. By default captures the calling Session’s healthy Worktree HEAD, or its Workspace root HEAD (including detached HEAD). An explicit local baseBranch overrides this. Uncommitted files are not copied. Returns acquisition baseCommit and baseBranch when branch-attached. Does not create a Session or start the requested work. When the user asks to create a Worktree and implement/fix something, follow with clutch_span_worktree using the returned worktreeId if delegation is enabled; let that Session implement and verify the task.', newArgs, output.object({
+        workspaceId: output.string,
+        worktreeId: output.string,
+        name: output.string,
+        absolutePath: output.string,
+        baseBranch: output.string,
+        baseCommit: output.string,
+        instructionsSaved: output.boolean,
+        error: output.string,
+        correction: output.string,
+    }, ['workspaceId', 'worktreeId', 'name', 'absolutePath', 'instructionsSaved']), async ({ name, baseBranch, instructions = '' }, exec) => {
+        const workspaceId = await scope();
+        const base = baseBranch === undefined
+            ? await defaultBase(agent.session.id, workspaceId, options)
+            : undefined;
+        check(exec);
+        const record = base === undefined
+            ? await options.manager.createWorktree({
+                workspaceId,
+                branch: baseBranch,
+                newBranch: name,
+            })
+            : await options.manager.createWorktreeAtCommit({
+                workspaceId,
+                baseBranch: base.branch,
+                baseCommit: base.commit,
+                newBranch: name,
+            });
+        let error;
+        try {
+            check(exec);
+            if (instructions)
+                await options.manager.updateWorktreeInstructions({
+                    workspaceId,
+                    worktreeId: record.worktreeId,
+                    instructions,
+                    expectedInstructions: '',
+                });
+        }
+        catch (cause) {
+            exec.signal.throwIfAborted();
+            error = errorText(cause).slice(0, 700);
+        }
+        options.changed(workspaceId, record.worktreeId);
+        return {
+            workspaceId,
+            worktreeId: record.worktreeId,
+            name: record.branch,
+            absolutePath: record.absolutePath,
+            baseBranch: record.baseBranch,
+            baseCommit: record.baseCommit,
+            instructionsSaved: error === undefined,
+            ...(error === undefined
+                ? {}
+                : {
+                    error,
+                    correction: 'The Worktree already exists. Save its instructions through Worktree management using this worktreeId; do not create the branch again.',
+                }),
+        };
+    });
+}
+//# sourceMappingURL=new-worktree.js.map

package/lib/tool/new-worktree.js.map

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

package/lib/tool/outputs.d.ts

@@ -0,0 +1,50 @@
+export declare const string: {
+    type: string;
+};
+export declare const boolean: {
+    type: string;
+};
+export declare const integer: {
+    type: string;
+};
+export declare const array: (items: unknown) => {
+    type: string;
+    items: unknown;
+};
+export declare const object: (properties: Record<string, unknown>, required?: string[]) => {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const model: {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const worktree: {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const entry: {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const read: {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const catalogModel: {
+    type: string;
+    properties: Record<string, unknown>;
+    required: string[];
+    additionalProperties: boolean;
+};
+//# sourceMappingURL=outputs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../src/tool/outputs.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;CAAqB,CAAC;AACzC,eAAO,MAAM,OAAO;;CAAsB,CAAC;AAC3C,eAAO,MAAM,OAAO;;CAAsB,CAAC;AAC3C,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO;;;CAA+B,CAAC;AACpE,eAAO,MAAM,MAAM,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAU,MAAM,EAAO;;;;;CAKjF,CAAC;AACH,eAAO,MAAM,KAAK;;;;;CAGhB,CAAC;AACH,eAAO,MAAM,QAAQ;;;;;CAYpB,CAAC;AACF,eAAO,MAAM,KAAK;;;;;CAWjB,CAAC;AACF,eAAO,MAAM,IAAI;;;;;CAwBhB,CAAC;AACF,eAAO,MAAM,YAAY;;;;;CAcxB,CAAC"}

package/lib/tool/outputs.js

@@ -0,0 +1,65 @@
+export const string = { type: 'string' };
+export const boolean = { type: 'boolean' };
+export const integer = { type: 'integer' };
+export const array = (items) => ({ type: 'array', items });
+export const object = (properties, required = []) => ({
+    type: 'object',
+    properties,
+    required,
+    additionalProperties: false,
+});
+export const model = object({ provider: string, model: string, reasoningEffort: string }, [
+    'provider',
+    'model',
+]);
+export const worktree = object({
+    worktreeId: string,
+    branch: string,
+    absolutePath: string,
+    status: string,
+    health: string,
+    diskCleanup: string,
+    baseBranch: string,
+    baseCommit: string,
+}, ['worktreeId', 'branch', 'absolutePath', 'status']);
+export const entry = object({
+    seq: integer,
+    time: integer,
+    type: string,
+    text: string,
+    textOffset: integer,
+    continued: boolean,
+    reason: string,
+}, ['seq', 'time', 'type']);
+export const read = object({
+    workspaceId: string,
+    sessionId: string,
+    status: string,
+    running: boolean,
+    entries: array(entry),
+    cursor: string,
+    hasMore: boolean,
+    historyOmitted: boolean,
+    statusChanged: boolean,
+    error: string,
+}, [
+    'workspaceId',
+    'sessionId',
+    'status',
+    'running',
+    'entries',
+    'cursor',
+    'hasMore',
+    'historyOmitted',
+    'statusChanged',
+]);
+export const catalogModel = object({
+    id: string,
+    name: string,
+    description: string,
+    reasoning: object({
+        efforts: array(object({ id: string, name: string, description: string }, ['id', 'name'])),
+        defaultEffort: string,
+    }, ['efforts']),
+}, ['id', 'name']);
+//# sourceMappingURL=outputs.js.map

package/lib/tool/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../../src/tool/outputs.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAmC,EAAE,WAAqB,EAAE,EAAE,EAAE,CAAC,CAAC;IACvF,IAAI,EAAE,QAAQ;IACd,UAAU;IACV,QAAQ;IACR,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE;IACxF,UAAU;IACV,OAAO;CACR,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAC5B;IACE,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,MAAM;IAClB,UAAU,EAAE,MAAM;CACnB,EACD,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CACnD,CAAC;AACF,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CACzB;IACE,GAAG,EAAE,OAAO;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,OAAO;IACnB,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,MAAM;CACf,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CACxB,CAAC;AACF,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CACxB;IACE,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,MAAM;IACjB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE,OAAO;IACvB,aAAa,EAAE,OAAO;IACtB,KAAK,EAAE,MAAM;CACd,EACD;IACE,aAAa;IACb,WAAW;IACX,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,gBAAgB;IAChB,eAAe;CAChB,CACF,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAChC;IACE,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,MAAM,CACf;QACE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,aAAa,EAAE,MAAM;KACtB,EACD,CAAC,SAAS,CAAC,CACZ;CACF,EACD,CAAC,IAAI,EAAE,MAAM,CAAC,CACf,CAAC"}

package/lib/tool/report-result.d.ts

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

package/lib/tool/report-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-result.d.ts","sourceRoot":"","sources":["../../src/tool/report-result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgC9C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,IAAI,CAqErE"}

package/lib/tool/report-result.js

@@ -0,0 +1,83 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { text } from './inputs.js';
+import { authorize, errorText } from './context.js';
+import * as output from './outputs.js';
+const reportArgs = z
+    .object({
+    status: z
+        .enum(['completed', 'blocked', 'failed'])
+        .describe('Your task outcome. completed requires finished work and verification; blocked requires help; failed means the task could not be fulfilled.'),
+    summary: text
+        .max(2000)
+        .describe('Concise outcome, changed files or the specific blocker. Do not include conversation history or intermediate steps.'),
+    evidence: text
+        .max(2000)
+        .optional()
+        .describe('Verification commands and results, artifact paths, remaining risks, or what help is required.'),
+    requestId: text
+        .max(200)
+        .optional()
+        .describe('Omit for a new report. Reuse the returned id only to retry the identical report after uncertain admission.'),
+})
+    .strict();
+export function registerReportResult(context) {
+    const { add, agent, options, check, scope, delegation } = context;
+    return add('clutch_report_result', 'Push one concise result or blocker only when the Host holds an active in-memory report token for this delegated task. Successful completed, blocked or failed admission consumes the token. The tool stays available but calls without a token are rejected; later user work must not report to the former parent. Only an explicit new parent dispatch grants another token. Required fields: status and summary; optional evidence and retry requestId. On uncertain admission retry only the identical report with its returned requestId. The Host fixes the destination. Include verification evidence. This is your claim, not automatic proof of success. Returns message admission, not a reply.', reportArgs, output.object({
+        workspaceId: output.string,
+        sessionId: output.string,
+        parentSessionId: output.string,
+        requestId: output.string,
+        status: { type: 'string', enum: ['admitted', 'prompt-failed'] },
+        error: output.string,
+        correction: output.string,
+    }, ['workspaceId', 'sessionId', 'parentSessionId', 'requestId', 'status']), async (args, exec) => {
+        const reportTask = delegation.assertReport(agent);
+        const { parentSessionId } = reportTask;
+        const workspaceId = await scope();
+        await authorize(agent.session.id, workspaceId, options, true);
+        await authorize(parentSessionId, workspaceId, options, true);
+        check(exec);
+        const requestId = args.requestId ?? `clutch-worktree-report:${randomUUID()}`;
+        if (args.requestId !== undefined && !reportTask.attempt)
+            throw Object.assign(new Error('A report requestId must come from this token’s previous uncertain admission.'), { code: 'REPORT_RETRY_REQUIRED' });
+        const identity = { workspaceId, sessionId: agent.session.id, parentSessionId, requestId };
+        const message = JSON.stringify({
+            kind: 'worktree-task-report',
+            fromSessionId: agent.session.id,
+            status: args.status,
+            summary: args.summary,
+            ...(args.evidence === undefined ? {} : { evidence: args.evidence }),
+        });
+        delegation.claimReport(agent, reportTask, requestId, message);
+        const attempt = reportTask.attempt;
+        try {
+            await options.sessions.prompt({
+                sessionId: parentSessionId,
+                requestId,
+                mode: 'queue',
+                content: [
+                    {
+                        type: 'text',
+                        text: `Delegated Session report (claims require verification; no automatic reply needed):\n${message}`,
+                    },
+                ],
+            }, exec.signal);
+            delegation.close(reportTask);
+            return { ...identity, status: 'admitted' };
+        }
+        catch (cause) {
+            exec.signal.throwIfAborted();
+            return {
+                ...identity,
+                status: 'prompt-failed',
+                error: errorText(cause).slice(0, 700),
+                correction: 'Admission may have succeeded. Retry this identical report using the returned requestId; do not send a new report id for the same attempt.',
+            };
+        }
+        finally {
+            attempt.pending = false;
+        }
+    });
+}
+//# sourceMappingURL=report-result.js.map

package/lib/tool/report-result.js.map

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

package/lib/tool/schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+/** DSH's native/PTC catalog uses a smaller schema vocabulary than Zod emits.
+ * Length constraints remain enforced by the original Zod parser at execution.
+ * Unsupported future constructs fail registration instead of hiding fields as unknown.
+ */
+export declare function toolParameters(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/tool/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4FxB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}