@namzu/sdk 6.1.0 → 7.0.0

package/dist/tools/builtins/__tests__/bash.test.js

@@ -0,0 +1,65 @@
+import { describe, expect, it } from 'vitest';
+import { BashTool } from '../bash.js';
+/**
+ * What `bash` promises before it runs anything.
+ *
+ * These need no shell, so they stay in the unit suite. The ones that actually
+ * execute a command live in `bash.proc-test.ts` — spawning real processes
+ * beside 2594 unit tests flaked four unrelated timing-sensitive ones, so the
+ * process suite is separate and has its own CI step.
+ */
+describe('the two clocks agree', () => {
+    it('declares a deadline of its own', () => {
+        // The executor reads a tool's `timeoutMs` before falling back to its
+        // generic default. With none declared, `bash` inherited that default —
+        // the same two minutes as its OWN default — so the two agreed by
+        // coincidence and diverged the moment a model asked for longer because
+        // it knew a build was slow. It got two minutes, from a clock it had not
+        // been told about, reported as an abandoned tool rather than as a
+        // command that ran out of time.
+        expect(BashTool.timeoutMs).toBeDefined();
+    });
+    it('puts that deadline above the longest the model may request', () => {
+        // So this tool's own clock is the one that fires, and the executor's is
+        // a backstop rather than a second clock racing it.
+        const accepted = BashTool.inputSchema.safeParse({ command: 'true', timeout: 10 * 60 * 1000 });
+        expect(accepted.success).toBe(true);
+        expect(BashTool.timeoutMs).toBeGreaterThan(10 * 60 * 1000);
+    });
+    it('refuses an over-long request rather than silently shortening it', () => {
+        // Refuse, do not degrade. A number the model was not told had changed
+        // is how it learns to distrust its own arguments.
+        const overCeiling = BashTool.inputSchema.safeParse({
+            command: 'true',
+            timeout: 60 * 60 * 1000,
+        });
+        expect(overCeiling.success, 'the ceiling is not enforced').toBe(false);
+    });
+    it('refuses a nonsensical deadline', () => {
+        expect(BashTool.inputSchema.safeParse({ command: 'true', timeout: 0 }).success).toBe(false);
+        expect(BashTool.inputSchema.safeParse({ command: 'true', timeout: -1 }).success).toBe(false);
+    });
+    it('applies its default when none is given', () => {
+        const parsed = BashTool.inputSchema.parse({ command: 'true' });
+        expect(parsed.timeout).toBeGreaterThan(0);
+    });
+});
+describe('the input is closed before a shell ever sees it', () => {
+    it('refuses an empty command', () => {
+        expect(BashTool.inputSchema.safeParse({ command: '' }).success).toBe(false);
+    });
+    it('accepts a numeric timeout sent as a string', () => {
+        // Providers do this, and the coercion is deliberate.
+        const parsed = BashTool.inputSchema.parse({ command: 'true', timeout: '5000' });
+        expect(parsed.timeout).toBe(5000);
+    });
+});
+describe('the danger flag reads the command', () => {
+    it('marks a destructive command destructive', () => {
+        expect(BashTool.isDestructive?.({ command: 'rm -rf /', timeout: 1000 })).toBe(true);
+    });
+    it('leaves an ordinary command alone', () => {
+        expect(BashTool.isDestructive?.({ command: 'ls -la', timeout: 1000 })).toBe(false);
+    });
+});
+//# sourceMappingURL=bash.test.js.map

package/dist/tools/builtins/__tests__/bash.test.js.map

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

package/dist/tools/builtins/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,QAAQ;;;EA4GnB,CAAA"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AAkEA,eAAO,MAAM,QAAQ;;;EA6JnB,CAAA"}

package/dist/tools/builtins/bash.js

@@ -17,14 +17,32 @@ const execAsync = promisify(exec);
 // slow; the point is that the DEFAULT is survivable.
 const DEFAULT_BASH_TIMEOUT_MS = readPositiveIntEnv('NAMZU_BASH_TIMEOUT_MS', 2 * 60 * 1000);
 const DEFAULT_BASH_MAX_BUFFER_BYTES = readPositiveIntEnv('NAMZU_BASH_MAX_BUFFER_BYTES', 100 * 1024 * 1024);
+/**
+ * The longest deadline this tool will accept from the model.
+ *
+ * There are two clocks on a bash call and until now only one of them was
+ * declared. This tool enforces `input.timeout` itself; the EXECUTOR enforces
+ * a separate per-tool deadline, and with none declared here it fell back to
+ * its own generic default — also two minutes. The two agreed by coincidence,
+ * so a model that asked for five minutes because it knew the build was slow
+ * got two, from a clock it had not been told about, reported as an abandoned
+ * tool rather than as a command that ran out of time.
+ *
+ * So the tool declares a ceiling and the executor is given a deadline above
+ * it (see `timeoutMs` on the definition), which makes this the only clock
+ * that can fire in practice. A request past the ceiling is REFUSED rather
+ * than quietly clamped: the model asked for something specific, and silently
+ * giving it a different number is how it learns to distrust the answer.
+ */
+const MAX_BASH_TIMEOUT_MS = readPositiveIntEnv('NAMZU_BASH_MAX_TIMEOUT_MS', 10 * 60 * 1000);
 const inputSchema = z.object({
     command: z
         .string()
         .min(1)
         .describe('The bash command to execute. Required, non-empty. Single command per call (use `&&` / `;` chaining for compound commands). Avoid heredocs that span more than a few hundred bytes — large content should be created with `write`, then extended with `edit` insertLine: "end", not piped into bash.'),
     timeout: z
-        .preprocess((v) => (typeof v === 'string' ? Number(v) : v), z.number().default(DEFAULT_BASH_TIMEOUT_MS))
-        .describe(`Command timeout in milliseconds. Default: ${DEFAULT_BASH_TIMEOUT_MS}`),
+        .preprocess((v) => (typeof v === 'string' ? Number(v) : v), z.number().positive().max(MAX_BASH_TIMEOUT_MS).default(DEFAULT_BASH_TIMEOUT_MS))
+        .describe(`Command timeout in milliseconds. Default: ${DEFAULT_BASH_TIMEOUT_MS}, maximum: ${MAX_BASH_TIMEOUT_MS}. For work that legitimately runs longer than the maximum, start it in the background and poll, rather than holding the turn open.`),
 });
 function isDangerousCommand(command) {
     return DANGEROUS_PATTERNS.some((pattern) => pattern.test(command));
@@ -38,6 +56,12 @@ export const BashTool = defineTool({
     readOnly: false,
     destructive: (input) => isDangerousCommand(input.command),
     concurrencySafe: false,
+    // Above the ceiling the input schema accepts, so the executor's deadline
+    // is a backstop rather than a second clock racing this tool's own. It used
+    // to be undefined, which meant the executor's generic default applied —
+    // the same two minutes as this tool's DEFAULT, so they agreed by accident
+    // and diverged the moment a model asked for longer.
+    timeoutMs: MAX_BASH_TIMEOUT_MS + 30_000,
     async execute(input, context) {
         if (isDangerousCommand(input.command)) {
             return {
@@ -111,23 +135,71 @@ export const BashTool = defineTool({
         // a Stop tore down the model stream and left the command running,
         // and the executor's deadline could only ever DETACH from the tool
         // rather than end the work it started.
-        const { stdout, stderr } = await execAsync(input.command, {
-            cwd: context.workingDirectory,
-            timeout: input.timeout,
-            env: { ...process.env, ...context.env },
-            maxBuffer: DEFAULT_BASH_MAX_BUFFER_BYTES,
-            signal: context.abortSignal,
-        });
-        const output = [stdout ? `STDOUT:\n${stdout}` : '', stderr ? `STDERR:\n${stderr}` : '']
-            .filter(Boolean)
-            .join('\n\n');
-        return {
-            success: true,
-            output: output || '(no output)',
-            data: { exitCode: 0 },
-        };
+        // `exec` REJECTS on a non-zero exit, on its own timeout, and on a
+        // kill — and the rejection carries `stdout`, `stderr`, `code` and
+        // `killed`. Letting it propagate threw all of that away: the registry
+        // turned the throw into a structured failure, so the model was told a
+        // command failed and not one word about how.
+        //
+        // That is the common case, not an edge one. A failing test run and a
+        // failing build are the two things an agent runs bash for most, and
+        // both exit non-zero WITH the output that explains why. The sandbox
+        // branch above already reports all of it; this branch did not, so the
+        // same command told the model two different amounts depending on where
+        // it happened to run.
+        try {
+            const { stdout, stderr } = await execAsync(input.command, {
+                cwd: context.workingDirectory,
+                timeout: input.timeout,
+                env: { ...process.env, ...context.env },
+                maxBuffer: DEFAULT_BASH_MAX_BUFFER_BYTES,
+                signal: context.abortSignal,
+            });
+            return {
+                success: true,
+                output: formatShellOutput(stdout, stderr) || '(no output)',
+                data: { exitCode: 0 },
+            };
+        }
+        catch (err) {
+            const failure = err;
+            // A caller-owned Stop is the caller's, not a command failure.
+            if (context.abortSignal?.aborted)
+                throw err;
+            // `exec` reports its own timeout as a kill, and the distinction
+            // matters to the model: "ran out of time" is a different next move
+            // from "exited 1".
+            const timedOut = failure.killed === true && failure.signal === 'SIGTERM';
+            const exitCode = typeof failure.code === 'number' ? failure.code : undefined;
+            const output = formatShellOutput(failure.stdout, failure.stderr);
+            return {
+                success: false,
+                output: output || '(no output)',
+                data: {
+                    ...(exitCode !== undefined ? { exitCode } : {}),
+                    timedOut,
+                    ...(failure.signal ? { signal: failure.signal } : {}),
+                },
+                error: timedOut
+                    ? `Command timed out after ${input.timeout}ms. Any output it produced before the deadline is above.`
+                    : exitCode !== undefined
+                        ? `Command exited with code ${exitCode}`
+                        : `Command failed: ${failure.message}`,
+            };
+        }
     },
 });
+/**
+ * The two streams, labelled, with empty ones left out.
+ *
+ * Shared by the success and failure paths so a command tells the model the
+ * same shape either way — the failure path used to tell it nothing at all.
+ */
+function formatShellOutput(stdout, stderr) {
+    return [stdout ? `STDOUT:\n${stdout}` : '', stderr ? `STDERR:\n${stderr}` : '']
+        .filter(Boolean)
+        .join('\n\n');
+}
 function readPositiveIntEnv(key, fallback) {
     const value = process.env[key]?.trim();
     if (!value)

package/dist/tools/builtins/bash.js.map

@@ -1 +1 @@
-{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AACjC,kEAAkE;AAClE,kEAAkE;AAClE,mEAAmE;AACnE,gEAAgE;AAChE,iEAAiE;AACjE,oCAAoC;AACpC,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,qDAAqD;AACrD,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,uBAAuB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;AAC1F,MAAM,6BAA6B,GAAG,kBAAkB,CACvD,6BAA6B,EAC7B,GAAG,GAAG,IAAI,GAAG,IAAI,CACjB,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,qSAAqS,CACrS;IACF,OAAO,EAAE,CAAC;SACR,UAAU,CACV,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAC3C;SACA,QAAQ,CAAC,6CAA6C,uBAAuB,EAAE,CAAC;CAClF,CAAC,CAAA;AAIF,SAAS,kBAAkB,CAAC,OAAe;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,MAAM;IACZ,WAAW,EACV,0XAA0X;IAC3X,WAAW;IACX,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,CAAC,eAAe,CAAC;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,CAAC,KAAgB,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC;IACpE,eAAe,EAAE,KAAK;IAEtB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;QAC3B,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,+BAA+B,KAAK,CAAC,OAAO,GAAG;aACtD,CAAA;QACF,CAAC;QAED,8DAA8D;QAC9D,EAAE;QACF,iEAAiE;QACjE,8EAA8E;QAC9E,gEAAgE;QAChE,6DAA6D;QAC7D,4DAA4D;QAC5D,gEAAgE;QAChE,6DAA6D;QAC7D,4DAA4D;QAC5D,2DAA2D;QAC3D,6DAA6D;QAC7D,4DAA4D;QAC5D,2DAA2D;QAC3D,4CAA4C;QAC5C,4DAA4D;QAC5D,+CAA+C;QAC/C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;gBAC3E,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,4DAA4D;gBAC5D,+CAA+C;gBAC/C,MAAM,EAAE,OAAO,CAAC,WAAW;aAC3B,CAAC,CAAA;YAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,2BAA2B,KAAK,CAAC,OAAO,IAAI;iBACnD,CAAA;YACF,CAAC;YAED,+DAA+D;YAC/D,+DAA+D;YAC/D,8DAA8D;YAC9D,sCAAsC;YACtC,MAAM,OAAO,GAAG;gBACf,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;aACtC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAEjB,MAAM,MAAM,GAAG;gBACd,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;gBAChD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;gBAChD,OAAO,CAAC,MAAM,GAAG,CAAC;oBACjB,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,mGAAmG;oBAC9H,CAAC,CAAC,EAAE;aACL;iBACC,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,MAAM,CAAC,CAAA;YAEd,OAAO;gBACN,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;gBAC9B,MAAM,EAAE,MAAM,IAAI,aAAa;gBAC/B,IAAI,EAAE;oBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,SAAS,EAAE,IAAI;oBACf,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;oBAChD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;iBAChD;gBACD,KAAK,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,4BAA4B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;aACxF,CAAA;QACF,CAAC;QAED,oEAAoE;QACpE,kEAAkE;QAClE,mEAAmE;QACnE,uCAAuC;QACvC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE;YACzD,GAAG,EAAE,OAAO,CAAC,gBAAgB;YAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;YACvC,SAAS,EAAE,6BAA6B;YACxC,MAAM,EAAE,OAAO,CAAC,WAAW;SAC3B,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrF,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAA;QAEd,OAAO;YACN,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM,IAAI,aAAa;YAC/B,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;SACrB,CAAA;IACF,CAAC;CACD,CAAC,CAAA;AAEF,SAAS,kBAAkB,CAAC,GAAW,EAAE,QAAgB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAA;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;AACtE,CAAC"}
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"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"}

package/dist/tools/coordinator/__tests__/allow-delegation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=allow-delegation.test.d.ts.map

package/dist/tools/coordinator/__tests__/allow-delegation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allow-delegation.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/coordinator/__tests__/allow-delegation.test.ts"],"names":[],"mappings":""}

package/dist/tools/coordinator/__tests__/allow-delegation.test.js

@@ -0,0 +1,94 @@
+import { describe, expect, it } from 'vitest';
+import { buildCoordinatorTools } from '../index.js';
+/**
+ * Whether a run may delegate is not the same question as who it may delegate
+ * to, and only the caller can answer the first.
+ *
+ * The roster answers WHO. It cannot answer WHETHER, because two runs are
+ * indistinguishable in it: a supervisor whose roster happens to hold one
+ * specialist, where delegating is the point; and a run whose own persona IS
+ * that specialist, where delegating is delegating to itself. A host builds the
+ * second by putting a specialist's persona into the supervisor shell and its
+ * id into the roster — so a predicate comparing the roster against the
+ * executing agent sees two different ids and cheerfully says "can delegate".
+ *
+ * Measured before this existed: such a run carried `create_task`,
+ * `wait_for_task`, `cancel_task` and `agent_task_list`, byte-identical to a
+ * run that could actually delegate, and the model could only discover the
+ * refusal by spending a turn on it.
+ */
+const gateway = {
+    listTasks: () => [],
+    onTaskCompleted: () => () => { },
+};
+function namesFor(opts) {
+    return buildCoordinatorTools({
+        gateway,
+        workingDirectory: '/tmp/test',
+        allowedAgentIds: opts.agentIds,
+        ...(opts.allowDelegation !== undefined ? { allowDelegation: opts.allowDelegation } : {}),
+        ...(opts.withHitl
+            ? { resumeHandler: (async () => ({ action: 'continue' })), runId: 'run_1' }
+            : {}),
+    }).map((t) => t.name);
+}
+describe('a run can decline to delegate while still naming who it would have called', () => {
+    it('withholds the delegation tools when delegation is off', () => {
+        const names = namesFor({ agentIds: ['specialist'], allowDelegation: false });
+        expect(names).not.toContain('create_task');
+        expect(names).not.toContain('wait_for_task');
+        expect(names).not.toContain('cancel_task');
+    });
+    it('produces exactly the empty-roster surface', () => {
+        // The two reasons differ but the outcome is the same one tool, so a
+        // reader does not have to hold two shapes in their head.
+        expect(namesFor({ agentIds: ['specialist'], allowDelegation: false })).toEqual(namesFor({ agentIds: [] }));
+    });
+    it('keeps the listing, because a run may still want to see what is running', () => {
+        expect(namesFor({ agentIds: ['specialist'], allowDelegation: false })).toContain('agent_task_list');
+    });
+    it('leaves the human channel alone — that is not delegation', () => {
+        // `approve_plan` and `ask_user_question` are the HITL park surface. A
+        // run that must not delegate needs them as much as any other.
+        const names = namesFor({ agentIds: ['specialist'], allowDelegation: false, withHitl: true });
+        expect(names).toContain('ask_user_question');
+    });
+});
+describe('an absent flag changes nothing', () => {
+    it('mounts the full surface, as it always did', () => {
+        const names = namesFor({ agentIds: ['specialist'] });
+        expect(names).toContain('create_task');
+        expect(names).toContain('wait_for_task');
+        expect(names).toContain('cancel_task');
+        expect(names).toContain('agent_task_list');
+    });
+    it('is identical to opting in explicitly', () => {
+        // So adopting the flag cannot change a caller that says yes out loud.
+        expect(namesFor({ agentIds: ['a', 'b'], allowDelegation: true })).toEqual(namesFor({ agentIds: ['a', 'b'] }));
+    });
+    it('still withholds everything on an empty roster, flag or no flag', () => {
+        expect(namesFor({ agentIds: [], allowDelegation: true })).toEqual(['agent_task_list']);
+    });
+});
+describe('the flag is absolute', () => {
+    it('cannot be overridden back on', () => {
+        // Worth a test precisely because the opposite is the intuitive guess:
+        // "explicit beats implicit" would say a runtime override should win.
+        // It cannot, mechanically — the override pass in SupervisorAgent runs
+        // over the array this builder returns, and there is no entry for it to
+        // act on. And it should not: both values come from the same caller in
+        // the same call, so "this run must not delegate" plus "give it
+        // create_task" is a caller contradicting itself, not one who knows
+        // something extra.
+        //
+        // Same rule the empty roster has always had.
+        const tools = buildCoordinatorTools({
+            gateway,
+            workingDirectory: '/tmp/test',
+            allowedAgentIds: ['specialist'],
+            allowDelegation: false,
+        });
+        expect(tools.find((t) => t.name === 'create_task')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=allow-delegation.test.js.map

package/dist/tools/coordinator/__tests__/allow-delegation.test.js.map

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

package/dist/tools/coordinator/__tests__/wait-with-idle-bound.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wait-with-idle-bound.test.d.ts.map

package/dist/tools/coordinator/__tests__/wait-with-idle-bound.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-with-idle-bound.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/coordinator/__tests__/wait-with-idle-bound.test.ts"],"names":[],"mappings":""}

package/dist/tools/coordinator/__tests__/wait-with-idle-bound.test.js

@@ -0,0 +1,193 @@
+import { describe, expect, it, vi } from 'vitest';
+import { describeWaitTimeout, waitForTaskWithBounds } from '../wait-with-idle-bound.js';
+/**
+ * A wall clock cannot tell a slow worker from a stuck one.
+ *
+ * The bound before this was an hour of elapsed time, and an hour has to do
+ * two incompatible jobs: be long enough for a child doing real work, and
+ * short enough to notice one that wedged. It cannot be both, so a worker
+ * stuck in minute two held the supervisor for another fifty-eight, and one
+ * making steady progress at minute fifty-nine was killed for being slow.
+ *
+ * These tests drive both clocks with a fake one, because the real bounds are
+ * measured in minutes and a test that actually waits them out is a test
+ * nobody runs.
+ */
+function gatewayFor(opts) {
+    let resolveWait;
+    const listeners = new Set();
+    const handle = {
+        taskId: 'tsk_1',
+        agentId: 'worker',
+        state: 'completed',
+        createdAt: 0,
+        completedAt: 1,
+    };
+    const gateway = {
+        waitForTask: () => new Promise((resolve) => {
+            resolveWait = resolve;
+            opts.settle?.(resolve);
+        }),
+        ...(opts.withProgress === false
+            ? {}
+            : {
+                onTaskProgress: (cb) => {
+                    listeners.add(cb);
+                    return () => listeners.delete(cb);
+                },
+            }),
+    };
+    return {
+        gateway,
+        progress: () => {
+            for (const cb of listeners)
+                cb('tsk_1');
+        },
+        finish: () => resolveWait?.(handle),
+    };
+}
+/** A clock the test moves by hand. */
+function fakeClock() {
+    let t = 1_000_000;
+    return {
+        now: () => t,
+        advance: (ms) => {
+            t += ms;
+        },
+    };
+}
+describe('a worker that is still working is not killed for being slow', () => {
+    it('keeps waiting past the idle bound while progress keeps arriving', async () => {
+        vi.useFakeTimers();
+        try {
+            const clock = fakeClock();
+            const { gateway, progress, finish } = gatewayFor({});
+            const waiting = waitForTaskWithBounds(gateway, 'tsk_1', { runMs: 60_000, idleMs: 5_000 }, clock.now);
+            // Four times the idle bound in elapsed time, but never quiet for
+            // more than half of it.
+            for (let i = 0; i < 8; i += 1) {
+                clock.advance(2_500);
+                progress();
+                await vi.advanceTimersByTimeAsync(1_000);
+            }
+            finish();
+            await vi.advanceTimersByTimeAsync(1_000);
+            expect((await waiting).kind, 'a working worker was cut off').toBe('completed');
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+});
+describe('a worker that has gone quiet is reported as quiet', () => {
+    it('fires the idle bound and says which clock it was', async () => {
+        vi.useFakeTimers();
+        try {
+            const clock = fakeClock();
+            const { gateway } = gatewayFor({});
+            const waiting = waitForTaskWithBounds(gateway, 'tsk_1', { runMs: 600_000, idleMs: 5_000 }, clock.now);
+            clock.advance(6_000);
+            await vi.advanceTimersByTimeAsync(1_100);
+            const outcome = await waiting;
+            expect(outcome.kind).toBe('timeout');
+            if (outcome.kind !== 'timeout')
+                return;
+            // The distinction is the point: "went quiet" and "ran too long"
+            // are different diagnoses and the caller acts on the message.
+            expect(outcome.cause).toBe('idle');
+            expect(outcome.idleBoundArmed).toBe(true);
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('says it went quiet, and that the worker was not cancelled', () => {
+        const text = describeWaitTimeout({
+            kind: 'timeout',
+            cause: 'idle',
+            elapsedMs: 30_000,
+            idleBoundArmed: true,
+        });
+        expect(text).toContain('went quiet');
+        // A wait that ran out is a statement about the WAITER. Losing an
+        // eight-minute worker's output because a short clock expired is the
+        // bug this whole area has been unpicking.
+        expect(text).toContain('not been cancelled');
+    });
+});
+describe('the run bound still catches a worker that never stops', () => {
+    it('fires on elapsed time even while progress keeps arriving', async () => {
+        vi.useFakeTimers();
+        try {
+            const clock = fakeClock();
+            const { gateway, progress } = gatewayFor({});
+            const waiting = waitForTaskWithBounds(gateway, 'tsk_1', { runMs: 10_000, idleMs: 5_000 }, clock.now);
+            for (let i = 0; i < 6; i += 1) {
+                clock.advance(2_000);
+                progress();
+                await vi.advanceTimersByTimeAsync(1_000);
+            }
+            const outcome = await waiting;
+            expect(outcome.kind).toBe('timeout');
+            if (outcome.kind !== 'timeout')
+                return;
+            expect(outcome.cause).toBe('run');
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+});
+describe('a gateway that cannot see its children', () => {
+    it('is bounded by the wall clock alone, as it was before', async () => {
+        vi.useFakeTimers();
+        try {
+            const clock = fakeClock();
+            const { gateway } = gatewayFor({ withProgress: false });
+            const waiting = waitForTaskWithBounds(gateway, 'tsk_1', { runMs: 10_000, idleMs: 1_000 }, clock.now);
+            // Far past the idle bound, and it must NOT fire — there is no
+            // signal, so silence carries no information.
+            clock.advance(5_000);
+            await vi.advanceTimersByTimeAsync(1_100);
+            clock.advance(6_000);
+            await vi.advanceTimersByTimeAsync(1_100);
+            const outcome = await waiting;
+            expect(outcome.kind).toBe('timeout');
+            if (outcome.kind !== 'timeout')
+                return;
+            expect(outcome.cause).toBe('run');
+            // And the degradation is visible rather than silent.
+            expect(outcome.idleBoundArmed).toBe(false);
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('says so, instead of implying the worker was stuck', () => {
+        const text = describeWaitTimeout({
+            kind: 'timeout',
+            cause: 'run',
+            elapsedMs: 3_600_000,
+            idleBoundArmed: false,
+        });
+        expect(text).toContain('cannot report progress');
+    });
+});
+describe('a completion always wins', () => {
+    it('returns the handle rather than a timeout when the task finishes first', async () => {
+        vi.useFakeTimers();
+        try {
+            const clock = fakeClock();
+            const { gateway, finish } = gatewayFor({});
+            const waiting = waitForTaskWithBounds(gateway, 'tsk_1', { runMs: 10_000, idleMs: 5_000 }, clock.now);
+            finish();
+            await vi.advanceTimersByTimeAsync(10);
+            const outcome = await waiting;
+            expect(outcome.kind).toBe('completed');
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+});
+//# sourceMappingURL=wait-with-idle-bound.test.js.map

package/dist/tools/coordinator/__tests__/wait-with-idle-bound.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-with-idle-bound.test.js","sourceRoot":"","sources":["../../../../src/tools/coordinator/__tests__/wait-with-idle-bound.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/coordinator/index.d.ts

@@ -24,6 +24,15 @@ export interface CoordinatorToolsOptions {
     workingDirectory: string;
     runtimeContext?: AgentRuntimeContext;
     allowedAgentIds: string[];
+    /**
+     * May this run delegate at all? Defaults to true.
+     *
+     * Same field, same name, as SupervisorAgentConfig.allowDelegation — the
+     * name is kept identical deliberately. This options bag already renames
+     * agentIds to allowedAgentIds, and a second rename on the road between
+     * the config and the decision would make the road untraceable.
+     */
+    allowDelegation?: boolean;
     taskStore?: TaskStore;
     runId?: RunId;
     getPlanManager?: () => PlanManager | undefined;
@@ -89,5 +98,24 @@ export interface CoordinatorToolsOptions {
  * iteration ceiling both still apply above this.
  */
 export declare const DELEGATION_TIMEOUT_MS: number;
+/**
+ * How long a delegated worker may say nothing before the wait gives up.
+ *
+ * The hour above answers "how long is too long". It cannot also answer
+ * "how quiet is too quiet", because it has to be generous enough for a
+ * child doing real work — which makes it useless as a stall detector. A
+ * worker wedged in its second minute held the supervisor for another
+ * fifty-eight under that number alone.
+ *
+ * Five minutes of silence, because a worker between tool calls can be
+ * quiet for a while legitimately — a long model turn emits nothing until
+ * it starts streaming — and the cost of guessing low is killing a wait on
+ * a worker that was fine. Guessing high only delays a diagnosis. Set
+ * `NAMZU_DELEGATION_IDLE_MS` to change it.
+ *
+ * Only armed when the gateway can report progress at all; see
+ * `TaskGateway.onTaskProgress`.
+ */
+export declare const DELEGATION_IDLE_MS: number;
 export declare function buildCoordinatorTools(opts: CoordinatorToolsOptions): ToolDefinition[];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/coordinator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/coordinator/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D,MAAM,MAAM,oBAAoB,GAAG,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACL,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B,KACG,IAAI,CAAA;AAET,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,WAAW,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,eAAe,EAAE,MAAM,EAAE,CAAA;IAEzB,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IAE9C,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAEpC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAC/B;AA+ID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AAEnD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,EAAE,CAkvBrF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/coordinator/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAM/D,MAAM,MAAM,oBAAoB,GAAG,CAClC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACL,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B,KACG,IAAI,CAAA;AAET,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,WAAW,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,eAAe,EAAE,MAAM,EAAE,CAAA;IAEzB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IAE9C,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAEpC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAC/B;AA+ID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,QAAgE,CAAA;AAS/F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,EAAE,CA2vBrF"}