@namzu/sdk 2.0.0 → 3.0.0

package/dist/execution/local.test.js

@@ -0,0 +1,37 @@
+import { existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { LocalExecutionContext } from './local.js';
+// `command`/`args` on executeCommand() come from whatever tool call invokes it, so they
+// must be treated as untrusted. A single arg that smuggles a shell separator + a second
+// command proves whether the child process was actually handed a shell.
+function injectionArg(canaryPath) {
+    return process.platform === 'win32'
+        ? `& echo x> ${canaryPath} & rem`
+        : `; echo x > ${canaryPath} #`;
+}
+describe('LocalExecutionContext.executeCommand', () => {
+    let dir;
+    let canary;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'namzu-local-exec-'));
+        canary = join(dir, 'canary.txt');
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('does not let a shell-metacharacter arg run a second command by default', async () => {
+        const ctx = new LocalExecutionContext({ id: 'test', cwd: dir });
+        await ctx.initialize();
+        await ctx.executeCommand('node', ['--version', injectionArg(canary)]);
+        expect(existsSync(canary)).toBe(false);
+    });
+    it('still runs through a shell when explicitly requested', async () => {
+        const ctx = new LocalExecutionContext({ id: 'test', cwd: dir });
+        await ctx.initialize();
+        await ctx.executeCommand('node', ['--version', injectionArg(canary)], { shell: true });
+        expect(existsSync(canary)).toBe(true);
+    });
+});
+//# sourceMappingURL=local.test.js.map

package/dist/execution/local.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.test.js","sourceRoot":"","sources":["../../src/execution/local.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,wFAAwF;AACxF,wFAAwF;AACxF,wEAAwE;AACxE,SAAS,YAAY,CAAC,UAAkB;IACvC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QAClC,CAAC,CAAC,aAAa,UAAU,QAAQ;QACjC,CAAC,CAAC,cAAc,UAAU,IAAI,CAAA;AAChC,CAAC;AAED,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACrD,IAAI,GAAW,CAAA;IACf,IAAI,MAAc,CAAA;IAElB,UAAU,CAAC,GAAG,EAAE;QACf,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;QACtD,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QAC/D,MAAM,GAAG,CAAC,UAAU,EAAE,CAAA;QAEtB,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAErE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;QAC/D,MAAM,GAAG,CAAC,UAAU,EAAE,CAAA;QAEtB,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAEtF,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/gateway/__tests__/list-survives-eviction.test.d.ts

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

package/dist/gateway/__tests__/list-survives-eviction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-survives-eviction.test.d.ts","sourceRoot":"","sources":["../../../src/gateway/__tests__/list-survives-eviction.test.ts"],"names":[],"mappings":""}

package/dist/gateway/__tests__/list-survives-eviction.test.js

@@ -0,0 +1,102 @@
+import { describe, expect, it, vi } from 'vitest';
+import { LocalTaskGateway } from '../local.js';
+/**
+ * `listTasks` skipped every task the manager had evicted.
+ *
+ * Terminal tasks are dropped from the manager 30 seconds after they settle,
+ * and the gateway's list is built by looking each tracked id back up. A
+ * task that finished 31 seconds ago therefore vanished — from the exact
+ * tool whose description says to call it before declaring multi-worker work
+ * done, to "confirm every launched task reached completed".
+ *
+ * A supervisor that fanned out five workers and checked at the end saw
+ * three, and could not tell a task that was evicted from one that never
+ * launched. Both look like absence.
+ *
+ * Eviction exists to release the heavy per-task state — messages, abort
+ * controllers, spawn records — not to forget that a task existed. The
+ * gateway keeps the settled summary, which is a few fields.
+ */
+function terminalTask(taskId, state) {
+    return {
+        taskId: taskId,
+        agentId: 'worker',
+        state,
+        createdAt: 1_000,
+        completedAt: 2_000,
+        pendingMessages: [],
+        childAbortController: new AbortController(),
+        context: {},
+        result: { status: state === 'failed' ? 'failed' : 'completed' },
+    };
+}
+/** A manager that forgets a task, exactly as eviction does. */
+function managerWith(tasks) {
+    return {
+        getInstance: (id) => tasks.get(id),
+        waitForCompletion: vi.fn(async () => { }),
+        cancel: vi.fn(),
+        spawn: vi.fn(),
+    };
+}
+function gatewayOver(manager, trackedIds) {
+    const gateway = Object.create(LocalTaskGateway.prototype);
+    Object.assign(gateway, {
+        agentManager: manager,
+        trackedTaskIds: new Set(trackedIds),
+        completionListeners: new Set(),
+        settledHandles: new Map(),
+        siblingFailurePolicy: 'continue',
+    });
+    return gateway;
+}
+describe('a finished task stays listed after it is evicted', () => {
+    it('lists a task the manager still holds', () => {
+        const tasks = new Map([['task_a', terminalTask('task_a', 'completed')]]);
+        const gateway = gatewayOver(managerWith(tasks), ['task_a']);
+        gateway.rememberSettled('task_a');
+        tasks.delete('task_a');
+        const listed = gateway.listTasks();
+        expect(listed).toHaveLength(1);
+        expect(listed[0]?.taskId).toBe('task_a');
+        expect(listed[0]?.state).toBe('completed');
+    });
+    it('keeps a failure visible, which is the one that matters most', () => {
+        const tasks = new Map([['task_b', terminalTask('task_b', 'failed')]]);
+        const gateway = gatewayOver(managerWith(tasks), ['task_b']);
+        gateway.rememberSettled('task_b');
+        tasks.delete('task_b');
+        expect(gateway.listTasks()[0]?.state).toBe('failed');
+    });
+    it('prefers the live task over the remembered one while both exist', () => {
+        const live = terminalTask('task_c', 'completed');
+        const tasks = new Map([['task_c', live]]);
+        const gateway = gatewayOver(managerWith(tasks), ['task_c']);
+        gateway.rememberSettled('task_c');
+        live.completedAt = 9_999;
+        live.state = 'running';
+        expect(gateway.listTasks()[0]?.completedAt).toBe(9_999);
+        expect(gateway.listTasks()[0]?.state).toBe('running');
+    });
+    it('reports nothing for a tracked id that never settled and is already gone', () => {
+        const gateway = gatewayOver(managerWith(new Map()), ['task_d']);
+        // Nothing to report is still correct here — the point is that a task
+        // which DID settle is not silently indistinguishable from this.
+        expect(gateway.listTasks()).toHaveLength(0);
+    });
+    it('lists every worker after all of them are evicted', () => {
+        const tasks = new Map([
+            ['task_1', terminalTask('task_1', 'completed')],
+            ['task_2', terminalTask('task_2', 'failed')],
+            ['task_3', terminalTask('task_3', 'completed')],
+        ]);
+        const gateway = gatewayOver(managerWith(tasks), ['task_1', 'task_2', 'task_3']);
+        for (const id of tasks.keys())
+            gateway.rememberSettled(id);
+        tasks.clear();
+        const listed = gateway.listTasks();
+        expect(listed).toHaveLength(3);
+        expect(listed.filter((h) => h.state === 'failed')).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=list-survives-eviction.test.js.map

package/dist/gateway/__tests__/list-survives-eviction.test.js.map

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

package/dist/gateway/local.d.ts

@@ -1,5 +1,5 @@
 import type { AgentInput } from '../types/agent/base.js';
-import type { CreateTaskOptions, TaskGateway, TaskHandle } from '../types/agent/gateway.js';
+import type { CreateTaskOptions, SiblingFailurePolicy, TaskGateway, TaskHandle } from '../types/agent/gateway.js';
 import type { AgentManagerContract } from '../types/agent/manager.js';
 import type { AgentTaskContext } from '../types/agent/task.js';
 import type { TaskId } from '../types/ids/index.js';
@@ -11,12 +11,52 @@ export declare class LocalTaskGateway implements TaskGateway {
     private trackedTaskIds;
     private parentInput?;
     private completionListeners;
-    constructor(agentManager: AgentManagerContract, taskContext: AgentTaskContext, listener?: RunEventListener, parentInput?: Pick<AgentInput, 'taskStore' | 'runtimeToolOverrides' | 'runtimeContext'>);
+    /**
+     * The settled summary of each task, kept past the manager's eviction.
+     *
+     * Terminal tasks leave the manager 30 seconds after they finish, and
+     * `listTasks` rebuilt itself by looking every tracked id back up — so a
+     * task that finished a minute ago simply vanished from the tool whose
+     * whole job is the end-of-run check. A supervisor could not tell an
+     * evicted task from one that never launched; both read as absence.
+     *
+     * Eviction is there to release the heavy state — messages, controllers,
+     * spawn records — not the fact that the task ran. This is a handful of
+     * fields per task, bounded by the number the gateway itself launched.
+     */
+    private settledHandles;
+    private siblingFailurePolicy;
+    constructor(agentManager: AgentManagerContract, taskContext: AgentTaskContext, listener?: RunEventListener, parentInput?: Pick<AgentInput, 'taskStore' | 'runtimeToolOverrides' | 'runtimeContext'>, options?: {
+        siblingFailurePolicy?: SiblingFailurePolicy;
+    });
     createTask(options: CreateTaskOptions): Promise<TaskHandle>;
+    /**
+     * Decide what a failed child means for the ones still running.
+     *
+     * The primitive to stop them already existed — every child holds an
+     * abort controller chained to the parent's, and `AgentManager.cancel`
+     * uses it — but nothing connected a failure to it. So a supervisor that
+     * fanned out five tasks and watched one die had no way to say the other
+     * four were now pointless: they ran to completion spending budget on
+     * work whose premise had gone.
+     *
+     * `'continue'` stays the default, and deliberately. Partial results are
+     * usually worth having, and a policy that tore down healthy siblings on
+     * any failure would make one flaky child able to waste four good ones.
+     * The point is that the choice is now expressible, not that the answer
+     * changed.
+     */
+    private applySiblingPolicy;
     waitForTask(taskId: TaskId): Promise<TaskHandle>;
     continueTask(taskId: TaskId, message: string): Promise<void>;
     cancelTask(taskId: TaskId): void;
     getTask(taskId: TaskId): TaskHandle | undefined;
+    /**
+     * Snapshots a task's terminal state so it survives eviction.
+     *
+     * Called when the task settles, while the manager still holds it.
+     */
+    rememberSettled(taskId: TaskId): void;
     listTasks(): TaskHandle[];
     onTaskCompleted(callback: (handle: TaskHandle) => void): () => void;
 }

package/dist/gateway/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/gateway/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D,qBAAa,gBAAiB,YAAW,WAAW;IACnD,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,cAAc,CAAyB;IAE/C,OAAO,CAAC,WAAW,CAAC,CAA2E;IAE/F,OAAO,CAAC,mBAAmB,CAA+C;gBAGzE,YAAY,EAAE,oBAAoB,EAClC,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,sBAAsB,GAAG,gBAAgB,CAAC;IAQlF,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+C3D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAShD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAK/C,SAAS,IAAI,UAAU,EAAE;IASzB,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAMnE"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/gateway/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EACX,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D,qBAAa,gBAAiB,YAAW,WAAW;IACnD,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,cAAc,CAAyB;IAE/C,OAAO,CAAC,WAAW,CAAC,CAA2E;IAE/F,OAAO,CAAC,mBAAmB,CAA+C;IAE1E;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAc,CAAqC;IAE3D,OAAO,CAAC,oBAAoB,CAAmC;gBAG9D,YAAY,EAAE,oBAAoB,EAClC,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,sBAAsB,GAAG,gBAAgB,CAAC,EACvF,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;KAAE;IAWpD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8DjE;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,kBAAkB;IA0BpB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAShD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAK/C;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC,SAAS,IAAI,UAAU,EAAE;IAgBzB,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAMnE"}

package/dist/gateway/local.js

@@ -8,11 +8,29 @@ export class LocalTaskGateway {
     trackedTaskIds = new Set();
     parentInput;
     completionListeners = new Set();
-    constructor(agentManager, taskContext, listener, parentInput) {
+    /**
+     * The settled summary of each task, kept past the manager's eviction.
+     *
+     * Terminal tasks leave the manager 30 seconds after they finish, and
+     * `listTasks` rebuilt itself by looking every tracked id back up — so a
+     * task that finished a minute ago simply vanished from the tool whose
+     * whole job is the end-of-run check. A supervisor could not tell an
+     * evicted task from one that never launched; both read as absence.
+     *
+     * Eviction is there to release the heavy state — messages, controllers,
+     * spawn records — not the fact that the task ran. This is a handful of
+     * fields per task, bounded by the number the gateway itself launched.
+     */
+    settledHandles = new Map();
+    siblingFailurePolicy = 'continue';
+    constructor(agentManager, taskContext, listener, parentInput, options) {
         this.agentManager = agentManager;
         this.taskContext = taskContext;
         this.listener = listener;
         this.parentInput = parentInput;
+        if (options?.siblingFailurePolicy) {
+            this.siblingFailurePolicy = options.siblingFailurePolicy;
+        }
     }
     async createTask(options) {
         const task = await this.agentManager.sendMessage({
@@ -30,7 +48,19 @@ export class LocalTaskGateway {
             tenantId: this.taskContext.tenantId,
             projectId: this.taskContext.projectId,
             parentActor: this.taskContext.parentActor,
-        }, { ...this.taskContext, budgetTracker: { ...this.taskContext.budgetTracker } }, this.listener);
+            // Hang the child run off the span the caller supplied, so a
+            // delegated run joins the trace it belongs to instead of
+            // starting its own root.
+            ...(options.parentSpan ? { configOverrides: { parentSpan: options.parentSpan } } : {}),
+        }, 
+        // The budget tracker is SHARED on purpose and must not be cloned.
+        // `AgentManager.spawn` debits it (`remaining -= allocatedTokens`)
+        // so siblings divide one pool; handing each spawn a fresh copy
+        // made the debit land on a throwaway object, so every child saw
+        // the parent's untouched `remaining` and N children were each
+        // allocated `maxBudgetFraction` of the SAME number — N x 50% of a
+        // budget that only had 100% in it.
+        this.taskContext, this.listener);
         this.trackedTaskIds.add(task.taskId);
         this.agentManager
             .waitForCompletion(task.taskId)
@@ -38,6 +68,10 @@ export class LocalTaskGateway {
             const completed = this.agentManager.getInstance(task.taskId);
             if (completed) {
                 const handle = toHandle(completed);
+                // Snapshot now, while the manager still holds it — in 30
+                // seconds eviction takes the record away.
+                this.settledHandles.set(task.taskId, handle);
+                this.applySiblingPolicy(handle);
                 for (const cb of this.completionListeners) {
                     cb(handle);
                 }
@@ -53,6 +87,49 @@ export class LocalTaskGateway {
         });
         return toHandle(task);
     }
+    /**
+     * Decide what a failed child means for the ones still running.
+     *
+     * The primitive to stop them already existed — every child holds an
+     * abort controller chained to the parent's, and `AgentManager.cancel`
+     * uses it — but nothing connected a failure to it. So a supervisor that
+     * fanned out five tasks and watched one die had no way to say the other
+     * four were now pointless: they ran to completion spending budget on
+     * work whose premise had gone.
+     *
+     * `'continue'` stays the default, and deliberately. Partial results are
+     * usually worth having, and a policy that tore down healthy siblings on
+     * any failure would make one flaky child able to waste four good ones.
+     * The point is that the choice is now expressible, not that the answer
+     * changed.
+     */
+    applySiblingPolicy(finished) {
+        if (this.siblingFailurePolicy !== 'cancel-siblings')
+            return;
+        if (!hasFailed(finished))
+            return;
+        const cancelled = [];
+        for (const taskId of this.trackedTaskIds) {
+            if (taskId === finished.taskId)
+                continue;
+            const sibling = this.agentManager.getInstance(taskId);
+            // `cancel` is already a no-op on a terminal task, but checking
+            // here keeps the log honest about what was actually stopped.
+            if (!sibling || sibling.state === 'completed' || sibling.state === 'failed')
+                continue;
+            this.agentManager.cancel(taskId);
+            cancelled.push(taskId);
+        }
+        if (cancelled.length > 0) {
+            getRootLogger()
+                .child({ component: 'LocalTaskGateway' })
+                .info('Cancelled siblings after a child failed', {
+                failed: finished.taskId,
+                agentId: finished.agentId,
+                cancelled,
+            });
+        }
+    }
     async waitForTask(taskId) {
         await this.agentManager.waitForCompletion(taskId);
         const task = this.agentManager.getInstance(taskId);
@@ -71,12 +148,29 @@ export class LocalTaskGateway {
         const task = this.agentManager.getInstance(taskId);
         return task ? toHandle(task) : undefined;
     }
+    /**
+     * Snapshots a task's terminal state so it survives eviction.
+     *
+     * Called when the task settles, while the manager still holds it.
+     */
+    rememberSettled(taskId) {
+        const task = this.agentManager.getInstance(taskId);
+        if (task)
+            this.settledHandles.set(taskId, toHandle(task));
+    }
     listTasks() {
         const handles = [];
         for (const taskId of this.trackedTaskIds) {
+            // The live task wins: a remembered snapshot must never shadow
+            // state that is still being updated.
             const task = this.agentManager.getInstance(taskId);
-            if (task)
+            if (task) {
                 handles.push(toHandle(task));
+                continue;
+            }
+            const settled = this.settledHandles.get(taskId);
+            if (settled)
+                handles.push(settled);
         }
         return handles;
     }
@@ -87,6 +181,19 @@ export class LocalTaskGateway {
         };
     }
 }
+/**
+ * Did this child fail?
+ *
+ * Two answers have to agree. `state` is `'failed'` only when the spawn
+ * machinery itself threw; a child whose agent RAN and returned
+ * `status: 'failed'` lands in `markCompleted` regardless, carrying the
+ * failure in its result rather than its state. Reading only the state
+ * would therefore miss the ordinary case — an agent that tried and could
+ * not — and catch only the exceptional one.
+ */
+function hasFailed(handle) {
+    return handle.state === 'failed' || handle.result?.status === 'failed';
+}
 function toHandle(task) {
     return {
         taskId: task.taskId,

package/dist/gateway/local.js.map

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

package/dist/manager/agent/__tests__/dispose-cancels.test.d.ts

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

package/dist/manager/agent/__tests__/dispose-cancels.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose-cancels.test.d.ts","sourceRoot":"","sources":["../../../../src/manager/agent/__tests__/dispose-cancels.test.ts"],"names":[],"mappings":""}

package/dist/manager/agent/__tests__/dispose-cancels.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+import { AgentRegistry } from '../../../registry/agent/definitions.js';
+import { DefaultCapacityValidator } from '../../../session/handoff/capacity.js';
+import { SessionSummaryMaterializer } from '../../../session/summary/materialize.js';
+import { WorkspaceBackendRegistry } from '../../../session/workspace/registry.js';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { InMemoryThreadStore } from '../../../store/thread/memory.js';
+import { ThreadManager } from '../../thread/lifecycle.js';
+import { AgentManager } from '../lifecycle.js';
+/**
+ * `dispose()` cancelled nothing.
+ *
+ * It called `cancelAll('' as RunId)`, and `cancelAll` filters by
+ * `context.parentRunId`. No task has an empty parent, so the filter matched
+ * nothing — and the next lines cleared the instance map. Every live child
+ * was released without its abort controller firing: the work kept running,
+ * the budget kept draining, and nothing was left holding a reference to
+ * stop it.
+ *
+ * The `'' as RunId` cast is the tell. A value invented to satisfy a
+ * parameter usually means the parameter is the wrong one to pass.
+ */
+function makeManager() {
+    const store = new InMemorySessionStore();
+    return new AgentManager(new AgentRegistry(), undefined, {
+        sessionStore: store,
+        summaryMaterializer: new SessionSummaryMaterializer({
+            store,
+            generateSummaryId: () => 'sum_dispose',
+        }),
+        workspaceRegistry: new WorkspaceBackendRegistry(),
+        capacity: new DefaultCapacityValidator(store),
+        threadManager: new ThreadManager({
+            threadStore: new InMemoryThreadStore(),
+            sessionStore: store,
+        }),
+    });
+}
+/**
+ * Registers a live task directly. Going through `sendMessage` would run the
+ * agent to completion, and a terminal task is exactly the one `dispose` was
+ * never broken for.
+ */
+function addLiveTask(manager, taskId, parentRunId) {
+    const controller = new AbortController();
+    const instances = manager.instances;
+    instances.set(taskId, {
+        taskId: taskId,
+        state: 'running',
+        childAbortController: controller,
+        pendingMessages: [],
+        context: { parentRunId: parentRunId },
+    });
+    return controller;
+}
+describe('disposing the manager stops the work it was holding', () => {
+    it('aborts a live child spawned under any run', () => {
+        const manager = makeManager();
+        // Two parents: the shape the old code could not see, because it
+        // looked for one specific parent and invented the value it looked for.
+        const a = addLiveTask(manager, 'task_a', 'run_1');
+        const b = addLiveTask(manager, 'task_b', 'run_2');
+        manager.dispose();
+        expect(a.signal.aborted).toBe(true);
+        expect(b.signal.aborted).toBe(true);
+    });
+    it('empties its maps afterwards', () => {
+        const manager = makeManager();
+        addLiveTask(manager, 'task_a', 'run_1');
+        manager.dispose();
+        expect(manager.instances.size).toBe(0);
+    });
+    it('is safe to call twice', () => {
+        const manager = makeManager();
+        addLiveTask(manager, 'task_a', 'run_1');
+        manager.dispose();
+        expect(() => manager.dispose()).not.toThrow();
+    });
+    it('leaves cancelAll scoped to one parent, which is its whole job', () => {
+        const manager = makeManager();
+        const mine = addLiveTask(manager, 'task_a', 'run_1');
+        const theirs = addLiveTask(manager, 'task_b', 'run_2');
+        manager.cancelAll('run_1');
+        expect(mine.signal.aborted).toBe(true);
+        expect(theirs.signal.aborted).toBe(false);
+    });
+});
+//# sourceMappingURL=dispose-cancels.test.js.map

package/dist/manager/agent/__tests__/dispose-cancels.test.js.map

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