@namzu/sdk 0.1.8 → 0.3.0

package/dist/manager/agent/__tests__/lifecycle.test.js

@@ -0,0 +1,316 @@
+import { describe, expect, it } from 'vitest';
+import { EMPTY_TOKEN_USAGE } from '../../../constants/limits.js';
+import { AgentRegistry } from '../../../registry/agent/definitions.js';
+import { DefaultCapacityValidator, DelegationCapacityExceeded, } 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 { createAssistantMessage } from '../../../types/message/index.js';
+import { ZERO_COST } from '../../../utils/cost.js';
+import { ThreadManager } from '../../thread/lifecycle.js';
+import { AgentManager } from '../lifecycle.js';
+const tenant = 'tnt_alpha';
+const otherTenant = 'tnt_beta';
+const capabilities = {
+    supportsTools: false,
+    supportsStreaming: false,
+    supportsConcurrency: false,
+    supportsSubAgents: false,
+};
+function makeAgent(id, run) {
+    const metadata = {
+        type: 'reactive',
+        id,
+        name: id,
+        version: '1.0.0',
+        category: 'test',
+        description: `test agent ${id}`,
+        capabilities,
+    };
+    return {
+        type: 'reactive',
+        metadata,
+        run: async (input, config) => run(input, config),
+        cancel: async () => undefined,
+        getCapabilities: () => capabilities,
+    };
+}
+function makeDefinition(agent) {
+    return {
+        info: {
+            id: agent.metadata.id,
+            name: agent.metadata.name,
+            version: agent.metadata.version,
+            category: agent.metadata.category,
+            description: agent.metadata.description,
+            tools: [],
+            defaults: {
+                model: 'test',
+                tokenBudget: 1_000,
+            },
+        },
+        typedAgent: agent,
+    };
+}
+function successResult() {
+    return {
+        runId: 'run_test',
+        status: 'completed',
+        usage: { ...EMPTY_TOKEN_USAGE },
+        cost: { ...ZERO_COST },
+        iterations: 1,
+        durationMs: 1,
+        messages: [createAssistantMessage('child finished successfully')],
+        result: 'child finished successfully',
+    };
+}
+function failureResult(error) {
+    return {
+        runId: 'run_test',
+        status: 'failed',
+        usage: { ...EMPTY_TOKEN_USAGE },
+        cost: { ...ZERO_COST },
+        iterations: 1,
+        durationMs: 1,
+        messages: [],
+        lastError: error,
+    };
+}
+function user(tid = tenant) {
+    return { kind: 'user', userId: 'usr_root', tenantId: tid };
+}
+function agentActor(id, tid = tenant) {
+    return { kind: 'agent', agentId: id, tenantId: tid };
+}
+async function buildHarness(childAgent, tenantId = tenant) {
+    const store = new InMemorySessionStore();
+    const threadStore = new InMemoryThreadStore();
+    const threadManager = new ThreadManager({ threadStore, sessionStore: store });
+    const project = await store.createProject({ tenantId, name: 'p1' }, tenantId);
+    const thread = await threadStore.createThread({ projectId: project.id, title: 'lifecycle-test' }, tenantId);
+    const parentSession = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: user(tenantId) }, tenantId);
+    // Parent runs kick the session into 'active' so the materializer can
+    // flip it back to 'idle' once the child completes.
+    await store.updateSession({ ...parentSession, status: 'active' }, tenantId);
+    let summaryCounter = 0;
+    const materializer = new SessionSummaryMaterializer({
+        store,
+        generateSummaryId: () => `sum_test_${++summaryCounter}`,
+    });
+    const registry = new AgentRegistry();
+    registry.register(makeDefinition(childAgent));
+    const manager = new AgentManager(registry, undefined, {
+        sessionStore: store,
+        summaryMaterializer: materializer,
+        workspaceRegistry: new WorkspaceBackendRegistry(),
+        capacity: new DefaultCapacityValidator(store),
+        threadManager,
+    });
+    return {
+        store,
+        threadStore,
+        threadManager,
+        materializer,
+        manager,
+        parentSession: { ...parentSession, status: 'active' },
+        projectId: project.id,
+        threadId: thread.id,
+        registry,
+    };
+}
+function buildContext(parentSessionId, projectId, threadId, tenantId = tenant, depth = 0) {
+    return {
+        parentRunId: 'run_parent',
+        parentAgentId: 'parent-agent',
+        parentAbortController: new AbortController(),
+        depth,
+        budgetTracker: { total: 100_000, remaining: 100_000 },
+        tenantId,
+        threadId,
+        sessionId: parentSessionId,
+        projectId,
+        parentActor: user(tenantId),
+    };
+}
+function buildOptions(agentId, parentSessionId, projectId, tenantId = tenant) {
+    return {
+        agentId,
+        input: { messages: [], workingDirectory: '/tmp' },
+        parentSessionId,
+        tenantId,
+        projectId,
+        parentActor: user(tenantId),
+    };
+}
+async function waitForTask(manager, taskId) {
+    await manager.waitForCompletion(taskId);
+}
+describe('AgentManager.sendMessage — Phase 6 SubSession spawn', () => {
+    it('happy path: SubSession + Session + Summary, lineage stamped, status idle', async () => {
+        const childAgent = makeAgent('child-1', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        const events = [];
+        const listener = (e) => {
+            events.push(e);
+        };
+        const task = await harness.manager.sendMessage(buildOptions('child-1', harness.parentSession.id, harness.projectId), buildContext(harness.parentSession.id, harness.projectId, harness.threadId), listener);
+        await waitForTask(harness.manager, task.taskId);
+        const spawnRecord = harness.manager.getSpawnRecord(task.taskId);
+        expect(spawnRecord).toBeDefined();
+        const childSession = await harness.store.getSession(spawnRecord.childSessionId, tenant);
+        expect(childSession?.status).toBe('idle');
+        const subSession = await harness.store.getSubSession(spawnRecord.subSessionId, tenant);
+        expect(subSession?.status).toBe('idle');
+        expect(subSession?.summaryRef).toBeDefined();
+        const summary = await harness.store.getSummary(spawnRecord.childSessionId, tenant);
+        expect(summary).toBeDefined();
+        expect(summary?.materializedBy).toBe('kernel');
+        expect(summary?.agentSummary).toBe('child finished successfully');
+        // Events — spawn + idled both present with lineage.
+        const spawned = events.find((e) => e.type === 'subsession_spawned');
+        expect(spawned).toBeDefined();
+        if (spawned && 'lineage' in spawned) {
+            expect(spawned.lineage.parentSessionId).toBe(harness.parentSession.id);
+            expect(spawned.lineage.rootSessionId).toBe(harness.parentSession.id);
+            expect(spawned.lineage.depth).toBe(1);
+            expect(spawned.schemaVersion).toBe(2);
+        }
+        const idled = events.find((e) => e.type === 'subsession_idled');
+        expect(idled).toBeDefined();
+        if (idled && 'lineage' in idled) {
+            expect(idled.lineage.depth).toBe(1);
+            expect(idled.schemaVersion).toBe(2);
+        }
+    });
+    it('width: exceeding maxDelegationWidth (8) rejects with DelegationCapacityExceeded', async () => {
+        const childAgent = makeAgent('child-1', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        // Pre-fill 8 direct sub-sessions under the parent, up to the default width cap.
+        for (let i = 0; i < 8; i++) {
+            const sibling = await harness.store.createSession({
+                threadId: harness.threadId,
+                projectId: harness.projectId,
+                currentActor: agentActor('sibling'),
+            }, tenant);
+            await harness.store.createSubSession({
+                parentSessionId: harness.parentSession.id,
+                childSessionId: sibling.id,
+                kind: 'agent_spawn',
+                spawnedBy: user(),
+            }, tenant);
+        }
+        await expect(harness.manager.sendMessage(buildOptions('child-1', harness.parentSession.id, harness.projectId), buildContext(harness.parentSession.id, harness.projectId, harness.threadId))).rejects.toBeInstanceOf(DelegationCapacityExceeded);
+    });
+    it('depth: ancestry chain exceeding maxDelegationDepth (4) rejects with DelegationCapacityExceeded', async () => {
+        const childAgent = makeAgent('child-1', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        // Build a chain root→c1→c2→c3→c4 and then try to spawn under c4 — the
+        // 5th delegation level exceeds the default depth cap of 4.
+        let parentId = harness.parentSession.id;
+        for (let i = 0; i < 4; i++) {
+            const child = await harness.store.createSession({ threadId: harness.threadId, projectId: harness.projectId, currentActor: agentActor('c') }, tenant);
+            await harness.store.createSubSession({
+                parentSessionId: parentId,
+                childSessionId: child.id,
+                kind: 'agent_spawn',
+                spawnedBy: user(),
+            }, tenant);
+            parentId = child.id;
+        }
+        await expect(harness.manager.sendMessage(buildOptions('child-1', parentId, harness.projectId), buildContext(parentId, harness.projectId, harness.threadId, tenant, 0))).rejects.toBeInstanceOf(DelegationCapacityExceeded);
+    });
+    it('failure: SubSession marked failed; no summary materialized', async () => {
+        const childAgent = makeAgent('child-fail', async () => failureResult('boom'));
+        const harness = await buildHarness(childAgent);
+        const task = await harness.manager.sendMessage(buildOptions('child-fail', harness.parentSession.id, harness.projectId), buildContext(harness.parentSession.id, harness.projectId, harness.threadId));
+        await waitForTask(harness.manager, task.taskId);
+        const spawnRecord = harness.manager.getSpawnRecord(task.taskId);
+        expect(spawnRecord).toBeDefined();
+        const subSession = await harness.store.getSubSession(spawnRecord.subSessionId, tenant);
+        expect(subSession?.status).toBe('failed');
+        const summary = await harness.store.getSummary(spawnRecord.childSessionId, tenant);
+        expect(summary).toBeNull();
+    });
+    it('child messages retrievable: sessionStore.drill returns the child transcript', async () => {
+        const childAgent = makeAgent('child-msgs', async () => {
+            const result = successResult();
+            return result;
+        });
+        const harness = await buildHarness(childAgent);
+        const task = await harness.manager.sendMessage(buildOptions('child-msgs', harness.parentSession.id, harness.projectId), buildContext(harness.parentSession.id, harness.projectId, harness.threadId));
+        await waitForTask(harness.manager, task.taskId);
+        const spawnRecord = harness.manager.getSpawnRecord(task.taskId);
+        expect(spawnRecord).toBeDefined();
+        // drill on the child session surfaces the session metadata — the child
+        // transcript would be persisted on the runtime path (RunPersistence) in
+        // a full run; here we assert the drill primitive resolves cleanly.
+        const drill = await harness.store.drill(spawnRecord.childSessionId, tenant);
+        expect(drill).not.toBeNull();
+        expect(drill?.session.id).toBe(spawnRecord.childSessionId);
+        expect(drill?.ancestry).toEqual([harness.parentSession.id, spawnRecord.childSessionId]);
+    });
+    it('lineage chain: 3-deep delegation carries correct rootSessionId + depth', async () => {
+        const childAgent = makeAgent('grandchild', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        // Seed c1 under parentSession, c2 under c1.
+        const c1 = await harness.store.createSession({ threadId: harness.threadId, projectId: harness.projectId, currentActor: agentActor('c1') }, tenant);
+        await harness.store.createSubSession({
+            parentSessionId: harness.parentSession.id,
+            childSessionId: c1.id,
+            kind: 'agent_spawn',
+            spawnedBy: user(),
+        }, tenant);
+        const c2 = await harness.store.createSession({ threadId: harness.threadId, projectId: harness.projectId, currentActor: agentActor('c2') }, tenant);
+        await harness.store.createSubSession({
+            parentSessionId: c1.id,
+            childSessionId: c2.id,
+            kind: 'agent_spawn',
+            spawnedBy: user(),
+        }, tenant);
+        const events = [];
+        const task = await harness.manager.sendMessage(buildOptions('grandchild', c2.id, harness.projectId), buildContext(c2.id, harness.projectId, harness.threadId), (e) => {
+            events.push(e);
+        });
+        await waitForTask(harness.manager, task.taskId);
+        const spawned = events.find((e) => e.type === 'subsession_spawned');
+        expect(spawned).toBeDefined();
+        if (spawned && 'lineage' in spawned) {
+            // Ancestry is root→c1→c2; newly spawned child is depth 3.
+            expect(spawned.lineage.depth).toBe(3);
+            expect(spawned.lineage.rootSessionId).toBe(harness.parentSession.id);
+            expect(spawned.lineage.parentSessionId).toBe(c2.id);
+        }
+    });
+    it('kernel-only summary: type system rejects agent-constructed SessionSummaryRef at recordSummary', async () => {
+        const childAgent = makeAgent('child-1', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        // This compile-time assertion is enforced by `materializedBy: 'kernel'`
+        // being a literal on the SummaryRef type; an agent-constructed literal
+        // with `materializedBy: 'agent'` would be rejected by the type system.
+        // Runtime assertion that the type check is still in place:
+        const summary = await harness.materializer.materialize({
+            sessionId: harness.parentSession.id,
+            tenantId: tenant,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: 'kernel-only',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        expect(summary.materializedBy).toBe('kernel');
+    });
+    it('cross-tenant spawn rejected at SendMessageOptions.tenantId mismatch', async () => {
+        const childAgent = makeAgent('child-1', async () => successResult());
+        const harness = await buildHarness(childAgent);
+        const mismatchedOptions = {
+            ...buildOptions('child-1', harness.parentSession.id, harness.projectId),
+            tenantId: otherTenant,
+        };
+        await expect(harness.manager.sendMessage(mismatchedOptions, buildContext(harness.parentSession.id, harness.projectId, harness.threadId, tenant))).rejects.toThrow(/Tenant mismatch/);
+    });
+});
+// Phase 9 Known Delta #5: legacy compat mode removed — AgentManagerDeps is
+// unconditional required. Prior `describe('AgentManager.sendMessage — legacy
+// mode (no session deps)')` block deleted; every spawn now produces a
+// SubSession + Session + WorkspaceRef triple (Convention #0).
+//# sourceMappingURL=lifecycle.test.js.map

package/dist/manager/agent/__tests__/lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.js","sourceRoot":"","sources":["../../../../src/manager/agent/__tests__/lifecycle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AACtE,OAAO,EACN,wBAAwB,EACxB,0BAA0B,GAC1B,MAAM,sCAAsC,CAAA;AAG7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAYrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AAGxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,MAAM,GAAG,WAAuB,CAAA;AACtC,MAAM,WAAW,GAAG,UAAsB,CAAA;AAE1C,MAAM,YAAY,GAAsB;IACvC,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,iBAAiB,EAAE,KAAK;CACxB,CAAA;AAED,SAAS,SAAS,CACjB,EAAU,EACV,GAA6E;IAE7E,MAAM,QAAQ,GAAkB;QAC/B,IAAI,EAAE,UAAU;QAChB,EAAE;QACF,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,cAAc,EAAE,EAAE;QAC/B,YAAY;KACZ,CAAA;IACD,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;QAChD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC7B,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY;KACnC,CAAA;AACF,CAAC;AAED,SAAS,cAAc,CAAC,KAA8C;IACrE,OAAO;QACN,IAAI,EAAE;YACL,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;YACrB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;YACzB,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;YAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;YACjC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;YACvC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE;gBACT,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,KAAK;aAClB;SACD;QACD,UAAU,EAAE,KAAK;KACjB,CAAA;AACF,CAAC;AAED,SAAS,aAAa;IACrB,OAAO;QACN,KAAK,EAAE,UAAyD;QAChE,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE;QAC/B,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;QACtB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,CAAC;QACjE,MAAM,EAAE,6BAA6B;KACrC,CAAA;AACF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IACnC,OAAO;QACN,KAAK,EAAE,UAAyD;QAChE,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,EAAE,GAAG,iBAAiB,EAAE;QAC/B,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE;QACtB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,KAAK;KAChB,CAAA;AACF,CAAC;AAED,SAAS,IAAI,CAAC,MAAgB,MAAM;IACnC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAoB,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;AACrE,CAAC;AAED,SAAS,UAAU,CAAC,EAAU,EAAE,MAAgB,MAAM;IACrD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;AAChE,CAAC;AAcD,KAAK,UAAU,YAAY,CAC1B,UAAmD,EACnD,WAAqB,MAAM;IAE3B,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;IACxC,MAAM,WAAW,GAAG,IAAI,mBAAmB,EAAE,CAAA;IAC7C,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAC5C,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAClD,QAAQ,CACR,CAAA;IACD,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,aAAa,CAC9C,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAC5E,QAAQ,CACR,CAAA;IACD,qEAAqE;IACrE,mDAAmD;IACnD,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE3E,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,MAAM,YAAY,GAAG,IAAI,0BAA0B,CAAC;QACnD,KAAK;QACL,iBAAiB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,cAAc,EAAe;KACpE,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAA;IAE7C,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE;QACrD,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,YAAY;QACjC,iBAAiB,EAAE,IAAI,wBAAwB,EAAE;QACjD,QAAQ,EAAE,IAAI,wBAAwB,CAAC,KAAK,CAAC;QAC7C,aAAa;KACb,CAAC,CAAA;IAEF,OAAO;QACN,KAAK;QACL,WAAW;QACX,aAAa;QACb,YAAY;QACZ,OAAO;QACP,aAAa,EAAE,EAAE,GAAG,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;QACrD,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,QAAQ;KACR,CAAA;AACF,CAAC;AAED,SAAS,YAAY,CACpB,eAA0B,EAC1B,SAA4D,EAC5D,QAAkB,EAClB,WAAqB,MAAM,EAC3B,KAAK,GAAG,CAAC;IAET,OAAO;QACN,WAAW,EAAE,YAA2D;QACxE,aAAa,EAAE,cAAc;QAC7B,qBAAqB,EAAE,IAAI,eAAe,EAAE;QAC5C,KAAK;QACL,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE;QACrD,QAAQ;QACR,QAAQ;QACR,SAAS,EAAE,eAAe;QAC1B,SAAS;QACT,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;KAC3B,CAAA;AACF,CAAC;AAED,SAAS,YAAY,CACpB,OAAe,EACf,eAA0B,EAC1B,SAA4D,EAC5D,WAAqB,MAAM;IAE3B,OAAO;QACN,OAAO;QACP,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE;QACjD,eAAe;QACf,QAAQ;QACR,SAAS;QACT,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;KAC3B,CAAA;AACF,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,OAAqB,EACrB,MAAoD;IAEpD,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC;AAED,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACpE,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAe,EAAE,CAAA;QAE7B,MAAM,QAAQ,GAAG,CAAC,CAAW,EAAQ,EAAE;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACf,CAAC,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAC7C,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,EACpE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3E,QAAQ,CACR,CAAA;QACD,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/D,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAA;QAEjC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,WAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACxF,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAEzC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,WAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QACvF,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QAE5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,WAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACnF,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;QAC7B,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;QAEjE,oDAAoD;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAA;QACnE,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;QAC7B,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACrC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;YACtE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;YACpE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACrC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAA;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3B,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACnC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpC,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAChG,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,gFAAgF;QAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAChD;gBACC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,UAAU,CAAC,SAAS,CAAC;aACnC,EACD,MAAM,CACN,CAAA;YACD,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CACnC;gBACC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE;gBACzC,cAAc,EAAE,OAAO,CAAC,EAAE;gBAC1B,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,IAAI,EAAE;aACjB,EACD,MAAM,CACN,CAAA;QACF,CAAC;QAED,MAAM,MAAM,CACX,OAAO,CAAC,OAAO,CAAC,WAAW,CAC1B,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,EACpE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAC3E,CACD,CAAC,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gGAAgG,EAAE,KAAK,IAAI,EAAE;QAC/G,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,sEAAsE;QACtE,2DAA2D;QAC3D,IAAI,QAAQ,GAAc,OAAO,CAAC,aAAa,CAAC,EAAE,CAAA;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAC9C,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,EAC3F,MAAM,CACN,CAAA;YACD,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CACnC;gBACC,eAAe,EAAE,QAAQ;gBACzB,cAAc,EAAE,KAAK,CAAC,EAAE;gBACxB,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,IAAI,EAAE;aACjB,EACD,MAAM,CACN,CAAA;YACD,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAA;QACpB,CAAC;QAED,MAAM,MAAM,CACX,OAAO,CAAC,OAAO,CAAC,WAAW,CAC1B,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,EACpD,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CACtE,CACD,CAAC,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7E,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAC7C,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,EACvE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAC3E,CAAA;QACD,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/D,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAA;QAEjC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,WAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QACvF,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,WAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACnF,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;YAC9B,OAAO,MAAM,CAAA;QACd,CAAC,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAC7C,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,EACvE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAC3E,CAAA;QACD,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/D,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAA;QAEjC,uEAAuE;QACvE,wEAAwE;QACxE,mEAAmE;QACnE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,WAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QAC5E,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC5B,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAY,CAAC,cAAc,CAAC,CAAA;QAC3D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,WAAY,CAAC,cAAc,CAAC,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACvE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,4CAA4C;QAC5C,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAC3C,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAC5F,MAAM,CACN,CAAA;QACD,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CACnC;YACC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE;YACzC,cAAc,EAAE,EAAE,CAAC,EAAE;YACrB,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,IAAI,EAAE;SACjB,EACD,MAAM,CACN,CAAA;QACD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAC3C,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAC5F,MAAM,CACN,CAAA;QACD,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CACnC;YACC,eAAe,EAAE,EAAE,CAAC,EAAE;YACtB,cAAc,EAAE,EAAE,CAAC,EAAE;YACrB,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,IAAI,EAAE;SACjB,EACD,MAAM,CACN,CAAA;QAED,MAAM,MAAM,GAAe,EAAE,CAAA;QAC7B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAC7C,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,EACpD,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,EACxD,CAAC,CAAC,EAAE,EAAE;YACL,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACf,CAAC,CACD,CAAA;QACD,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAA;QACnE,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;QAC7B,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACrC,0DAA0D;YAC1D,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACrC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;YACpE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QACpD,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+FAA+F,EAAE,KAAK,IAAI,EAAE;QAC9G,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,wEAAwE;QACxE,uEAAuE;QACvE,uEAAuE;QACvE,2DAA2D;QAC3D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC;YACtD,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE;YACnC,QAAQ,EAAE,MAAM;YAChB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,aAAa;YAC3B,oBAAoB,EAAE,EAAsB;YAC5C,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QACF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;QAE9C,MAAM,iBAAiB,GAAuB;YAC7C,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC;YACvE,QAAQ,EAAE,WAAW;SACrB,CAAA;QACD,MAAM,MAAM,CACX,OAAO,CAAC,OAAO,CAAC,WAAW,CAC1B,iBAAiB,EACjB,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CACnF,CACD,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,2EAA2E;AAC3E,6EAA6E;AAC7E,sEAAsE;AACtE,8DAA8D"}

package/dist/manager/agent/lifecycle.d.ts

@@ -1,18 +1,70 @@
 import type { AgentRegistry } from '../../registry/agent/definitions.js';
+import { type CapacityValidator, DelegationCapacityExceeded } from '../../session/handoff/capacity.js';
+import type { SessionSummaryMaterializer } from '../../session/summary/materialize.js';
+import type { WorkspaceRef } from '../../session/workspace/ref.js';
+import type { WorkspaceBackendRegistry } from '../../session/workspace/registry.js';
 import type { AgentLifecycleListener } from '../../types/agent/lifecycle-event.js';
 import type { AgentManagerConfig, AgentTask, AgentTaskContext, AgentTaskState, SendMessageOptions } from '../../types/agent/task.js';
-import type { RunId, TaskId } from '../../types/ids/index.js';
+import type { RunId, SessionId, TaskId, TenantId } from '../../types/ids/index.js';
 import type { Message } from '../../types/message/index.js';
+import type { RunEventListener } from '../../types/run/events.js';
+import type { SubSessionId } from '../../types/session/ids.js';
+import type { SessionStore } from '../../types/session/store.js';
+import type { ThreadManager } from '../thread/lifecycle.js';
+/**
+ * Dependencies threaded into {@link AgentManager}. Phase 6 promoted the
+ * SubSession + Session + WorkspaceRef triple to mandatory spawn primitives —
+ * these collaborators replace the old `Object.assign({sourceAgentId,
+ * parentTaskId})` loose-cast cadence with a typed {@link Lineage} +
+ * {@link SessionSummaryMaterializer} closure of the parent→child message gap.
+ *
+ * Phase 9 Known Delta #5: fields are now unconditional required. The legacy
+ * "run without deps" compat branch was removed; every `AgentManager` consumer
+ * (SDK internals, `@namzu/agents`, `@namzu/api`, `@namzu/cli`) MUST wire the
+ * full set before instantiating. Convention #0 (no workarounds): the
+ * partially-wired mode was a migration-window bridge; 0.2.0 closes it.
+ *
+ * `workspaceRegistry` is required but may be empty — spawns without a
+ * registered workspace backend still succeed with `workspaceRef: undefined`
+ * (the runtime uses `.has(backend)` to gate provisioning). This keeps the
+ * registry deny-by-default while matching pattern doc §7.1 (lazy workspace
+ * provisioning).
+ */
+export interface AgentManagerDeps {
+    readonly sessionStore: SessionStore;
+    readonly workspaceRegistry: WorkspaceBackendRegistry;
+    readonly summaryMaterializer: SessionSummaryMaterializer;
+    readonly capacity: CapacityValidator;
+    /**
+     * Gate session creation on the parent Thread being `'open'` via
+     * {@link ThreadManager.requireOpen}. Added in Phase 2.6 to close the
+     * archive-gate gap flagged by the Phase 2.5 commit: without this,
+     * `ThreadManager.archive` was best-effort because spawn could still
+     * attach a live session under an archived Thread.
+     */
+    readonly threadManager: ThreadManager;
+}
+interface ChildSpawnRecord {
+    subSessionId: SubSessionId;
+    childSessionId: SessionId;
+    tenantId: TenantId;
+    parentSessionId: SessionId;
+    rootSessionId: SessionId;
+    childDepth: number;
+    workspaceRef?: WorkspaceRef;
+}
 export declare class AgentManager {
     private registry;
     private instances;
+    private spawnRecords;
     private completionCallbacks;
     private listeners;
     private log;
     private config;
     private evictionTimers;
-    constructor(registry: AgentRegistry, config?: Partial<AgentManagerConfig>);
-    sendMessage(options: SendMessageOptions, context: AgentTaskContext, listener?: import('../../types/run/events.js').RunEventListener): Promise<AgentTask>;
+    private deps;
+    constructor(registry: AgentRegistry, config: Partial<AgentManagerConfig> | undefined, deps: AgentManagerDeps);
+    sendMessage(options: SendMessageOptions, context: AgentTaskContext, listener?: RunEventListener): Promise<AgentTask>;
     cancel(taskId: TaskId): void;
     cancelAll(parentRunId: RunId): void;
     continueTask(taskId: TaskId, message: string): Promise<void>;
@@ -20,6 +72,7 @@ export declare class AgentManager {
     drainMessages(taskId: TaskId): Message[];
     waitForCompletion(taskId: TaskId): Promise<void>;
     getInstance(taskId: TaskId): AgentTask | undefined;
+    getSpawnRecord(taskId: TaskId): ChildSpawnRecord | undefined;
     listByParent(parentRunId: RunId): AgentTask[];
     listActive(): AgentTask[];
     getState(taskId: TaskId): AgentTaskState | undefined;
@@ -28,9 +81,19 @@ export declare class AgentManager {
     off(listener: AgentLifecycleListener): void;
     cleanup(): void;
     dispose(): void;
+    private provisionSpawn;
     private runChild;
+    /**
+     * Wraps the parent listener so every event emitted from the child's run
+     * carries the session-hierarchy `lineage` + `schemaVersion: 2` stamp.
+     * Replaces the old `Object.assign({sourceAgentId, parentTaskId}, event)`
+     * loose-cast pattern entirely — the types now encode the linkage.
+     */
+    private wrapChildListener;
+    private finalizeChild;
     private markCompleted;
     private markFailed;
+    private failSubSession;
     private markCanceled;
     private updateState;
     private requireInstance;
@@ -40,4 +103,5 @@ export declare class AgentManager {
     private emit;
     private emitRunEvent;
 }
+export { DelegationCapacityExceeded };
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/manager/agent/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/manager/agent/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAExE,OAAO,KAAK,EAEX,sBAAsB,EACtB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EACX,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAO3D,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,mBAAmB,CAA4C;IACvE,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,cAAc,CAAwD;gBAElE,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAMnE,WAAW,CAChB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,OAAO,2BAA2B,EAAE,gBAAgB,GAC7D,OAAO,CAAC,SAAS,CAAC;IA+FrB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI;IAM7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKpD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAOxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIlD,YAAY,CAAC,WAAW,EAAE,KAAK,GAAG,SAAS,EAAE;IAI7C,UAAU,IAAI,SAAS,EAAE;IAIzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD,WAAW,IAAI,aAAa;IAI5B,EAAE,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI1C,GAAG,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAK3C,OAAO,IAAI,IAAI;IASf,OAAO,IAAI,IAAI;YASD,QAAQ;IA4BtB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,YAAY;CAepB"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/manager/agent/lifecycle.ts"],"names":[],"mappings":"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"}