@namzu/sdk 6.0.0 → 6.2.0

package/dist/tools/coordinator/__tests__/completion-delivery.test.js

@@ -0,0 +1,255 @@
+import { describe, expect, it } from 'vitest';
+import { CompletionInbox } from '../../../gateway/completion-inbox.js';
+import { DELEGATION_TIMEOUT_MS, buildCoordinatorTools } from '../index.js';
+function harness(opts = {}) {
+    const listeners = new Set();
+    const waiters = new Map();
+    const handles = new Map();
+    let seq = 0;
+    const makeHandle = (taskId, result) => ({
+        taskId: taskId,
+        agentId: 'reviewer',
+        state: 'completed',
+        createdAt: 1_000,
+        completedAt: 2_000,
+        ...(result !== undefined
+            ? { result: { status: 'completed', result } }
+            : {}),
+    });
+    const gateway = {
+        createTask: async () => {
+            seq += 1;
+            const taskId = `tsk_${seq}`;
+            const handle = { ...makeHandle(taskId), state: 'running' };
+            handles.set(taskId, handle);
+            return handle;
+        },
+        waitForTask: (taskId) => new Promise((resolve) => {
+            if (opts.autoFinish) {
+                resolve(makeHandle(taskId, 'the worker output'));
+                return;
+            }
+            waiters.set(taskId, resolve);
+        }),
+        getTask: (taskId) => handles.get(taskId),
+        listTasks: () => [...handles.values()],
+        cancelTask: () => undefined,
+        continueTask: async () => undefined,
+        onTaskCompleted: (cb) => {
+            listeners.add(cb);
+            return () => listeners.delete(cb);
+        },
+    };
+    const inbox = new CompletionInbox();
+    inbox.attach(gateway);
+    return {
+        inbox,
+        tools: buildCoordinatorTools({
+            gateway,
+            completionInbox: inbox,
+            workingDirectory: '/tmp/test',
+            allowedAgentIds: ['reviewer'],
+        }),
+        settle: (handle) => {
+            handles.set(handle.taskId, handle);
+            for (const cb of listeners)
+                cb(handle);
+        },
+        finish: (taskId, result) => {
+            const handle = makeHandle(taskId, result);
+            handles.set(taskId, handle);
+            waiters.get(taskId)?.(handle);
+        },
+    };
+}
+function toolNamed(tools, name) {
+    const tool = tools.find((t) => t.name === name);
+    if (!tool)
+        throw new Error(`${name} is not registered`);
+    return tool;
+}
+describe('the supervisor has a tool for every move it needs', () => {
+    it('registers a way to wait, so polling is no longer the only option', () => {
+        // Before this, waiting meant `continue_task` — which blocks only as a
+        // side effect of sending a message, so a supervisor that just wanted
+        // to wait had to invent something to say.
+        const names = harness().tools.map((t) => t.name);
+        expect(names).toContain('wait_for_task');
+    });
+    it('registers a way to cancel, which background launching makes necessary', () => {
+        // `cancel_task` was defined in this file and never returned from it.
+        // It matters now: a background launch can leave a worker running with
+        // nothing waiting on it, and without this the supervisor could start
+        // one it had no way to stop.
+        expect(harness().tools.map((t) => t.name)).toContain('cancel_task');
+    });
+    it('gives the launching tool a deadline a real worker can meet', () => {
+        // The run default is two minutes; a delegated worker doing real work
+        // takes longer, and every expiry past that point produced the state
+        // this whole change exists to repair. Not firing at all beats
+        // recovering well.
+        expect(toolNamed(harness().tools, 'create_task').timeoutMs).toBe(DELEGATION_TIMEOUT_MS);
+    });
+    it('gives the waiting tool a deadline longer than the executor default', () => {
+        // A tool whose entire job is to wait must not be killed for waiting.
+        // `ToolExecutor` reads `timeoutMs` before falling back to the run
+        // default, so declaring one here is the supported way to say so.
+        expect(toolNamed(harness().tools, 'wait_for_task').timeoutMs).toBe(DELEGATION_TIMEOUT_MS);
+    });
+    it('mounts none of them when there is no roster to delegate to', () => {
+        const tools = buildCoordinatorTools({
+            gateway: { onTaskCompleted: () => () => { } },
+            workingDirectory: '/tmp/test',
+            allowedAgentIds: [],
+        });
+        expect(tools.map((t) => t.name)).toEqual(['agent_task_list']);
+    });
+});
+describe('a blocking launch claims its own completion', () => {
+    it('delivers the output inline and leaves nothing to announce', () => {
+        // The `dc16d58` case: this result reached the model as a tool_result,
+        // so an envelope carrying it again would be the duplicate delivery
+        // that removal fixed.
+        const h = harness({ autoFinish: true });
+        return toolNamed(h.tools, 'create_task')
+            .execute({ agent_id: 'reviewer', prompt: 'go', description: 'review' }, {})
+            .then((result) => {
+            expect(result.success).toBe(true);
+            expect(result.output).toContain('the worker output');
+            expect(h.inbox.drain()).toEqual([]);
+        });
+    });
+});
+describe('an abandoned launch leaves its completion to be announced', () => {
+    it('does not claim when the executor already gave up on the call', async () => {
+        // This is the whole fix. The executor's deadline passed, the model was
+        // told the tool timed out, and whatever this call returns now is
+        // discarded — so claiming here would delete the worker's output for
+        // good.
+        const h = harness({ autoFinish: true });
+        const aborted = AbortSignal.abort();
+        const result = await toolNamed(h.tools, 'create_task').execute({ agent_id: 'reviewer', prompt: 'go', description: 'review' }, { abortSignal: aborted });
+        expect(result.success).toBe(false);
+        // It also says where the result WILL turn up, rather than leaving the
+        // model to conclude the work was lost.
+        expect(result.output).toContain('task notification');
+        h.settle({
+            taskId: 'tsk_1',
+            agentId: 'reviewer',
+            state: 'completed',
+            createdAt: 1_000,
+            completedAt: 2_000,
+            result: {
+                status: 'completed',
+                result: 'the worker output',
+            },
+        });
+        expect(h.inbox.drain().map((x) => x.taskId)).toEqual(['tsk_1']);
+    });
+});
+describe('a background launch returns a handle instead of a result', () => {
+    it('hands back the task id straight away and does not wait', async () => {
+        // `autoFinish` is off, so `waitForTask` never resolves here. If the
+        // background path awaited it, this test would hang — which is the
+        // point: returning is what lets the supervisor keep working.
+        const h = harness();
+        const result = await toolNamed(h.tools, 'create_task').execute({
+            agent_id: 'reviewer',
+            prompt: 'go',
+            description: 'review',
+            background: true,
+        }, {});
+        expect(result.success).toBe(true);
+        expect(result.data?.task_id).toBe('tsk_1');
+        // In `output` too, not only in `data` — the executor builds the
+        // tool_result from `output` alone, so an id that lives only in `data`
+        // is an id the model never receives.
+        expect(result.output).toContain('tsk_1');
+        // And it tells the model what happens next, so "launched" does not
+        // read as "finished".
+        expect(result.output).toContain('task notification');
+    });
+    it('leaves the completion for the transcript', async () => {
+        const h = harness();
+        await toolNamed(h.tools, 'create_task').execute({
+            agent_id: 'reviewer',
+            prompt: 'go',
+            description: 'review',
+            background: true,
+        }, {});
+        h.settle({
+            taskId: 'tsk_1',
+            agentId: 'reviewer',
+            state: 'completed',
+            createdAt: 1_000,
+            completedAt: 2_000,
+            result: { status: 'completed', result: 'done' },
+        });
+        expect(h.inbox.drain()).toHaveLength(1);
+    });
+});
+describe('waiting explicitly beats listing in a loop', () => {
+    it('returns the output and claims it', async () => {
+        const h = harness({ autoFinish: true });
+        await toolNamed(h.tools, 'create_task').execute({
+            agent_id: 'reviewer',
+            prompt: 'go',
+            description: 'review',
+            background: true,
+        }, {});
+        const result = await toolNamed(h.tools, 'wait_for_task').execute({ task_id: 'tsk_1' }, {});
+        expect(result.success).toBe(true);
+        expect(result.output).toContain('the worker output');
+        // Claimed, so it is not also announced.
+        expect(h.inbox.drain()).toEqual([]);
+    });
+    it('says so plainly rather than hanging on an id that does not exist', async () => {
+        const h = harness();
+        const result = await toolNamed(h.tools, 'wait_for_task').execute({ task_id: 'tsk_nope' }, {});
+        expect(result.success).toBe(false);
+        expect(result.output).toContain('No task');
+    });
+});
+describe('the task listing carries the output it always had', () => {
+    async function listWith(result) {
+        const h = harness();
+        h.settle({
+            taskId: 'tsk_1',
+            agentId: 'reviewer',
+            state: 'completed',
+            createdAt: 1_000,
+            completedAt: 2_000,
+            result: { status: 'completed', result },
+        });
+        const listed = await toolNamed(h.tools, 'agent_task_list').execute({}, {});
+        return listed.output;
+    }
+    it('puts the worker result where the model can actually read it', async () => {
+        // Two failures stacked here. The projection read `h.result` for the
+        // status and the error and stopped one property short of the thing the
+        // task was launched to produce — and the obvious repair, adding it to
+        // `data`, would have been invisible: the executor builds the
+        // tool_result from `output` alone and never reads `data`. So the fix
+        // has to land in the RENDERED text, and this asserts on `output` for
+        // that reason.
+        expect(await listWith('the findings')).toContain('the findings');
+    });
+    it('names the tool that fetches the rest when it truncates', async () => {
+        const output = await listWith('x'.repeat(6_000));
+        expect(output).toContain('truncated');
+        expect(output).toContain('wait_for_task with "tsk_1"');
+    });
+    it('still lists a task that has produced nothing yet', async () => {
+        const h = harness();
+        await toolNamed(h.tools, 'create_task').execute({
+            agent_id: 'reviewer',
+            prompt: 'go',
+            description: 'review',
+            background: true,
+        }, {});
+        const listed = await toolNamed(h.tools, 'agent_task_list').execute({}, {});
+        expect(listed.output).toContain('tsk_1');
+        expect(listed.output).toContain('running');
+    });
+});
+//# sourceMappingURL=completion-delivery.test.js.map

package/dist/tools/coordinator/__tests__/completion-delivery.test.js.map

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

package/dist/tools/coordinator/__tests__/task-list.test.js

@@ -158,19 +158,25 @@ describe('coordinator agent_task_list tool', () => {
         expect(names).toContain('agent_task_list');
         expect(names).not.toContain('task_list');
     });
-    it('does not advertise per-task cancellation on the blocking coordinator surface', () => {
+    it('advertises per-task cancellation now that a task can outlive its launch', () => {
         const coordinatorTools = buildCoordinatorTools({
             gateway: gatewayWith([]),
             workingDirectory: '/tmp/test',
             allowedAgentIds: ['solution-architecture'],
         });
         const names = coordinatorTools.map((tool) => tool.name);
-        // create_task returns only after the worker is terminal, so the
-        // supervisor cannot know a live task id in a later model turn.
-        // Keeping cancel_task here only manufactured success for missing
-        // or terminal ids because every gateway cancellation is a void
-        // no-op in those states.
-        expect(names).not.toContain('cancel_task');
+        // This assertion used to be its own inverse, and the reasoning was
+        // correct at the time: create_task returned only after the worker was
+        // terminal, so the supervisor could never hold a LIVE task id in a
+        // later turn, and cancel_task could only manufacture success for
+        // something already finished.
+        //
+        // `background: true` reinstates the precondition that argument rested
+        // on. A background launch hands back an id while the worker is still
+        // running, and a supervisor able to start one it cannot stop is a
+        // hole — so the tool comes back with the capability that makes it
+        // mean something.
+        expect(names).toContain('cancel_task');
     });
 });
 //# sourceMappingURL=task-list.test.js.map

package/dist/tools/coordinator/__tests__/task-list.test.js.map

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

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

@@ -1,3 +1,4 @@
+import type { CompletionInbox } from '../../gateway/completion-inbox.js';
 import type { PlanManager } from '../../manager/plan/lifecycle.js';
 import type { PendingAnswers, QuestionParkRecorder } from '../../runtime/query/question-park.js';
 import type { AgentRuntimeContext } from '../../types/agent/base.js';
@@ -23,10 +24,29 @@ 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;
     onTaskLaunched?: TaskLaunchedCallback;
+    /**
+     * Where a completion goes when no call is left waiting for it.
+     *
+     * These tools claim a completion the moment they hand it to the model as a
+     * `tool_result`; anything unclaimed is delivered to the transcript as a
+     * notification instead. Without an inbox the tools still work and the
+     * blocking path is unchanged — only the abandoned and background
+     * completions go unheard, which is the behaviour before this existed.
+     */
+    completionInbox?: CompletionInbox;
     /**
      * HITL park channel for `ask_user_question`. The tool is registered
      * only when BOTH `resumeHandler` and `runId` are present — without a
@@ -54,5 +74,29 @@ export interface CoordinatorToolsOptions {
      */
     pendingAnswers?: PendingAnswers;
 }
+/**
+ * How long a coordinator tool may wait on a delegated agent.
+ *
+ * The executor's own default is two minutes, sized for a file read or a
+ * test run, and its docstring says outright that a tool which legitimately
+ * runs longer declares its own. This one runs an entire agent, and did not.
+ *
+ * Measured on real traffic: three delegated children took 4m21s, 5m58s and
+ * 8m04s; all three parents timed out at 120s. The children were never
+ * killed — only the parent's wait was — so the blocking path was not
+ * occasionally missed, it was structurally unreachable, and the model was
+ * left polling a listing because that was the only move left to it.
+ *
+ * An hour rather than "a bit more than eight minutes" because a generic
+ * stopwatch is the wrong instrument for a child that is making progress:
+ * a failure should come from what the child is doing, not from the clock
+ * the parent happens to be holding. Peer runtimes agree — the ones that
+ * bound a delegated child at all land on an hour, and several impose no
+ * wall-clock bound whatsoever, bounding turns or depth instead.
+ *
+ * A wedged child is still caught, an hour later, and the run budget and
+ * iteration ceiling both still apply above this.
+ */
+export declare const DELEGATION_TIMEOUT_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,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;;;;;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;AAsID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,EAAE,CA0jBrF"}
+{"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;;;;;;;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,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,EAAE,CAmwBrF"}