@namzu/sdk 0.1.8 → 0.3.0

package/dist/session/__tests__/integration/retention-archive.test.js

@@ -0,0 +1,187 @@
+/**
+ * Integration — retention archive / restore round-trip wired through the
+ * real stack: `InMemorySessionStore` + `DiskArchiveBackend` (pointed at
+ * `tmpdir()`) + `ArchivalManager` + `GitWorktreeDriver`.
+ *
+ * Covers roadmap §5 invariants: §12.3 retention deny-by-default, §12.3
+ * archive produces tombstone (in-slot), tombstone navigable via `drill`,
+ * restore full fidelity round-trip (Phase 9 closed synthetic-id loss),
+ * idempotent workspace dispose.
+ */
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { createUserMessage } from '../../../types/message/index.js';
+import { ArchivalManager, ArchiveNotConfiguredError } from '../../retention/archive.js';
+import { DiskArchiveBackend } from '../../retention/disk-backend.js';
+import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
+import { DEFAULT_TENANT, agentActor, userActor } from './_fixtures.js';
+const TEST_THREAD_ID = 'thd_test';
+async function seedIdleSubSession(store) {
+    const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'archive' }, DEFAULT_TENANT);
+    const parent = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: userActor('usr_a') }, DEFAULT_TENANT);
+    const child = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor('agt_w') }, DEFAULT_TENANT);
+    const sub = await store.createSubSession({
+        parentSessionId: parent.id,
+        childSessionId: child.id,
+        kind: 'agent_spawn',
+        spawnedBy: userActor('usr_a'),
+    }, DEFAULT_TENANT);
+    await store.updateSubSession({ ...sub, status: 'idle' }, DEFAULT_TENANT);
+    return { project, parent, child, sub };
+}
+describe('Integration — retention archive / restore', () => {
+    let rootDir;
+    let store;
+    let backend;
+    beforeEach(() => {
+        rootDir = mkdtempSync(join(tmpdir(), 'namzu-integration-retention-'));
+        store = new InMemorySessionStore();
+        backend = new DiskArchiveBackend({ rootDir });
+    });
+    afterEach(() => {
+        rmSync(rootDir, { recursive: true, force: true });
+    });
+    it('archive idle sub-session → tombstone attached (status=archived + archiveRef + archivedAt)', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
+        expect(tombstone.archiveRef.startsWith('arc_')).toBe(true);
+        const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
+        expect(after?.status).toBe('archived');
+        expect(after?.archiveRef).toBe(tombstone.archiveRef);
+        expect(after?.archivedAt).toBeInstanceOf(Date);
+    });
+    it('drill(parent) post-archive: archived SubSession still navigable with tombstone fields', async () => {
+        const { parent, sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
+        const view = await store.drill(parent.id, DEFAULT_TENANT);
+        expect(view?.children).toHaveLength(1);
+        const child = view?.children[0];
+        expect(child?.id).toBe(sub.id);
+        expect(child?.status).toBe('archived');
+        expect(child?.archiveRef).toBe(tombstone.archiveRef);
+    });
+    it('restore recovers the archive bundle with original MessageId fidelity (not synthetic msg_restored_N)', async () => {
+        const { sub, child } = await seedIdleSubSession(store);
+        const msg1Id = await store.appendMessage(child.id, createUserMessage('first'), DEFAULT_TENANT);
+        const msg2Id = await store.appendMessage(child.id, createUserMessage('second'), DEFAULT_TENANT);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
+        // Restore via backend directly to verify round-trip fidelity
+        // (ArchivalManager.restore does NOT return the bundle — it only flips
+        // status back to idle).
+        const bundle = await backend.restore(tombstone.archiveRef);
+        expect(bundle.messages).toHaveLength(2);
+        expect(bundle.messages[0]?.id).toBe(msg1Id);
+        expect(bundle.messages[1]?.id).toBe(msg2Id);
+        expect(bundle.messages[0]?.id.startsWith('msg_restored_')).toBe(false);
+        await manager.restore(sub.id, DEFAULT_TENANT);
+        const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
+        expect(after?.status).toBe('idle');
+        expect(after?.archiveRef).toBeUndefined();
+        expect(after?.archivedAt).toBeUndefined();
+    });
+    it('deny-by-default: project without archiveBackend → ArchiveNotConfiguredError on archive()', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            // archiveBackend omitted — archival fully disabled.
+        });
+        await expect(manager.archive(sub.id, DEFAULT_TENANT)).rejects.toBeInstanceOf(ArchiveNotConfiguredError);
+        // Sub-session untouched.
+        const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
+        expect(after?.status).toBe('idle');
+    });
+    it('idempotent dispose: workspace already disposed → archive completes without error', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        // Registry with a driver whose `dispose` throws a generic error.
+        const registry = new WorkspaceBackendRegistry();
+        registry.register({
+            kind: 'git-worktree',
+            async create() {
+                return {
+                    id: 'wsp_x',
+                    meta: {
+                        backend: 'git-worktree',
+                        repoRoot: '/r',
+                        branch: 'main',
+                        worktreePath: '/r/x',
+                    },
+                    createdAt: new Date(),
+                };
+            },
+            async branch(ref) {
+                return ref;
+            },
+            async dispose() {
+                throw new Error('simulated already-disposed race');
+            },
+            async inspect() {
+                return { exists: false, currentRef: 'HEAD', isDirty: false };
+            },
+        });
+        const workspaceRef = {
+            id: 'wsp_live',
+            meta: { backend: 'git-worktree', repoRoot: '/r', branch: 'main', worktreePath: '/r/y' },
+            createdAt: new Date(),
+        };
+        await store.updateSubSession({ ...sub, status: 'idle', workspaceId: workspaceRef.id }, DEFAULT_TENANT);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: registry,
+            archiveBackend: backend,
+            workspaceResolver: async () => workspaceRef,
+        });
+        const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
+        expect(tombstone.archiveRef.startsWith('arc_')).toBe(true);
+        // Committed record persists despite dispose failure.
+        const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
+        expect(after?.status).toBe('archived');
+    });
+    it('archive full round-trip: archive → restore → archive again succeeds', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone1 = await manager.archive(sub.id, DEFAULT_TENANT);
+        await manager.restore(sub.id, DEFAULT_TENANT);
+        const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
+        expect(after?.status).toBe('idle');
+        // Re-archive produces a fresh tombstone.
+        const tombstone2 = await manager.archive(sub.id, DEFAULT_TENANT);
+        expect(tombstone2.archiveRef).not.toBe(tombstone1.archiveRef);
+    });
+    it('onArchived callback receives the tombstone exactly once', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const onArchived = vi.fn();
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: new WorkspaceBackendRegistry(),
+            archiveBackend: backend,
+            onArchived,
+        });
+        const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
+        expect(onArchived).toHaveBeenCalledTimes(1);
+        expect(onArchived).toHaveBeenCalledWith(tombstone);
+    });
+});
+//# sourceMappingURL=retention-archive.test.js.map

package/dist/session/__tests__/integration/retention-archive.test.js.map

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

package/dist/session/__tests__/integration/spawn-rollback.test.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Integration — AgentManager.provisionSpawn compensating rollback.
+ *
+ * Covers Codex SPAWN-ROLLBACK critique (ses_001-hierarchy-redesign Phase 2
+ * adversarial review, 2026-04-18). Without the try/catch wrapper around the
+ * createSession → updateSession → createSubSession → workspace.create
+ * mutation block, a failure after createSession leaves an `active` child
+ * session with no subsession edge — invisible to the parent, but counted
+ * against `maxDelegationWidth` and visible to SessionStore.listSessions
+ * consumers (archive/delete flows in ThreadManager).
+ *
+ * Failure modes exercised:
+ *   A. Workspace driver throws on create. Subsession exists; must flip to
+ *      'failed' for audit. Child session must be hard-deleted.
+ *   B. Subsession insert fails (store injection). No subsession recorded.
+ *      Child session must be hard-deleted.
+ *
+ * Assertions in both cases:
+ *   - sendMessage rejects with the underlying error.
+ *   - SessionStore.listSessions(threadId) returns no row with the child id.
+ *   - Parent session remains untouched (status, currentActor).
+ *   - Fan-out cap reclaims the slot (next spawn succeeds up to the same
+ *     width).
+ */
+export {};
+//# sourceMappingURL=spawn-rollback.test.d.ts.map

package/dist/session/__tests__/integration/spawn-rollback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-rollback.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/spawn-rollback.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/session/__tests__/integration/spawn-rollback.test.js

@@ -0,0 +1,236 @@
+/**
+ * Integration — AgentManager.provisionSpawn compensating rollback.
+ *
+ * Covers Codex SPAWN-ROLLBACK critique (ses_001-hierarchy-redesign Phase 2
+ * adversarial review, 2026-04-18). Without the try/catch wrapper around the
+ * createSession → updateSession → createSubSession → workspace.create
+ * mutation block, a failure after createSession leaves an `active` child
+ * session with no subsession edge — invisible to the parent, but counted
+ * against `maxDelegationWidth` and visible to SessionStore.listSessions
+ * consumers (archive/delete flows in ThreadManager).
+ *
+ * Failure modes exercised:
+ *   A. Workspace driver throws on create. Subsession exists; must flip to
+ *      'failed' for audit. Child session must be hard-deleted.
+ *   B. Subsession insert fails (store injection). No subsession recorded.
+ *      Child session must be hard-deleted.
+ *
+ * Assertions in both cases:
+ *   - sendMessage rejects with the underlying error.
+ *   - SessionStore.listSessions(threadId) returns no row with the child id.
+ *   - Parent session remains untouched (status, currentActor).
+ *   - Fan-out cap reclaims the slot (next spawn succeeds up to the same
+ *     width).
+ */
+import { describe, expect, it } from 'vitest';
+import { EMPTY_TOKEN_USAGE } from '../../../constants/limits.js';
+import { AgentManager } from '../../../manager/agent/lifecycle.js';
+import { ThreadManager } from '../../../manager/thread/lifecycle.js';
+import { AgentRegistry } from '../../../registry/agent/definitions.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 { DefaultCapacityValidator } from '../../handoff/capacity.js';
+import { SessionSummaryMaterializer } from '../../summary/materialize.js';
+import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
+const tenant = 'tnt_alpha';
+const capabilities = {
+    supportsTools: false,
+    supportsStreaming: false,
+    supportsConcurrency: false,
+    supportsSubAgents: false,
+};
+function buildAgent(id) {
+    return {
+        type: 'reactive',
+        metadata: {
+            type: 'reactive',
+            id,
+            name: id,
+            version: '1.0.0',
+            category: 'test',
+            description: id,
+            capabilities,
+        },
+        run: async (_input, _config) => ({
+            runId: 'run_child',
+            status: 'completed',
+            usage: { ...EMPTY_TOKEN_USAGE },
+            cost: { ...ZERO_COST },
+            iterations: 1,
+            durationMs: 1,
+            messages: [createAssistantMessage('child did the work')],
+            result: 'child did the work',
+        }),
+        cancel: async () => undefined,
+        getCapabilities: () => capabilities,
+    };
+}
+function buildDefinition(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,
+    };
+}
+class FailingWorkspaceDriver {
+    kind = 'git-worktree';
+    createCalls = 0;
+    async create(_params) {
+        this.createCalls += 1;
+        throw new Error('synthetic workspace backend failure');
+    }
+    async branch(_source, _params) {
+        throw new Error('unused in this test');
+    }
+    async dispose(_ref) {
+        /* no-op */
+    }
+    async inspect(_ref) {
+        throw new Error('unused in this test');
+    }
+}
+describe('provisionSpawn compensating rollback', () => {
+    it('workspace driver failure — deletes child session, marks subsession failed, leaves no orphan', async () => {
+        const store = new InMemorySessionStore();
+        const threadStore = new InMemoryThreadStore();
+        const project = await store.createProject({ tenantId: tenant, name: 'rollback-project' }, tenant);
+        const thread = await threadStore.createThread({ projectId: project.id, title: 'rollback-topic' }, tenant);
+        const userActor = {
+            kind: 'user',
+            userId: 'usr_root',
+            tenantId: tenant,
+        };
+        const parentSession = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: userActor }, tenant);
+        await store.updateSession({ ...parentSession, status: 'active' }, tenant);
+        let summaryCounter = 0;
+        const materializer = new SessionSummaryMaterializer({
+            store,
+            generateSummaryId: () => `sum_test_${++summaryCounter}`,
+        });
+        const registry = new AgentRegistry();
+        registry.register(buildDefinition(buildAgent('worker')));
+        const workspaceRegistry = new WorkspaceBackendRegistry();
+        const failingDriver = new FailingWorkspaceDriver();
+        workspaceRegistry.register(failingDriver);
+        const threadManager = new ThreadManager({ threadStore, sessionStore: store });
+        const manager = new AgentManager(registry, undefined, {
+            sessionStore: store,
+            summaryMaterializer: materializer,
+            workspaceRegistry,
+            capacity: new DefaultCapacityValidator(store),
+            threadManager,
+        });
+        const taskContext = {
+            parentRunId: 'run_parent',
+            parentAgentId: 'supervisor',
+            parentAbortController: new AbortController(),
+            depth: 0,
+            budgetTracker: { total: 100_000, remaining: 100_000 },
+            tenantId: tenant,
+            threadId: thread.id,
+            sessionId: parentSession.id,
+            projectId: project.id,
+            parentActor: userActor,
+        };
+        const options = {
+            agentId: 'worker',
+            input: { messages: [], workingDirectory: '/tmp' },
+            parentSessionId: parentSession.id,
+            tenantId: tenant,
+            projectId: project.id,
+            parentActor: userActor,
+            workspaceBackend: 'git-worktree',
+        };
+        await expect(manager.sendMessage(options, taskContext)).rejects.toThrow('synthetic workspace backend failure');
+        expect(failingDriver.createCalls).toBe(1);
+        // Child session is gone — archive/delete flows and fan-out caps see
+        // zero child attached to the thread beyond the parent.
+        const sessionsOnThread = await store.listSessions(thread.id, tenant);
+        expect(sessionsOnThread.map((s) => s.id)).toEqual([parentSession.id]);
+        // Parent session is untouched.
+        const refetchedParent = await store.getSession(parentSession.id, tenant);
+        expect(refetchedParent?.status).toBe('active');
+        expect(refetchedParent?.currentActor).toEqual(userActor);
+        // No subsession breadcrumb — `subsession_spawned` never fired
+        // (provisionSpawn aborted before buildSpawnRecord), so nothing is
+        // expecting an audit row. Leaving a `status: 'failed'` record would
+        // dangle with no corresponding emission.
+        const subsessions = await store.getChildren(parentSession.id, tenant);
+        expect(subsessions).toHaveLength(0);
+    });
+    it('repeated rollback does not accumulate orphan sessions or subsessions', async () => {
+        const store = new InMemorySessionStore();
+        const threadStore = new InMemoryThreadStore();
+        const project = await store.createProject({
+            tenantId: tenant,
+            name: 'rollback-repeat-project',
+        }, tenant);
+        const thread = await threadStore.createThread({ projectId: project.id, title: 'rollback-width-topic' }, tenant);
+        const userActor = {
+            kind: 'user',
+            userId: 'usr_root',
+            tenantId: tenant,
+        };
+        const parentSession = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: userActor }, tenant);
+        await store.updateSession({ ...parentSession, status: 'active' }, tenant);
+        let summaryCounter = 0;
+        const materializer = new SessionSummaryMaterializer({
+            store,
+            generateSummaryId: () => `sum_test_${++summaryCounter}`,
+        });
+        const registry = new AgentRegistry();
+        registry.register(buildDefinition(buildAgent('worker')));
+        const workspaceRegistry = new WorkspaceBackendRegistry();
+        workspaceRegistry.register(new FailingWorkspaceDriver());
+        const threadManager = new ThreadManager({ threadStore, sessionStore: store });
+        const manager = new AgentManager(registry, undefined, {
+            sessionStore: store,
+            summaryMaterializer: materializer,
+            workspaceRegistry,
+            capacity: new DefaultCapacityValidator(store),
+            threadManager,
+        });
+        const taskContext = {
+            parentRunId: 'run_parent',
+            parentAgentId: 'supervisor',
+            parentAbortController: new AbortController(),
+            depth: 0,
+            budgetTracker: { total: 100_000, remaining: 100_000 },
+            tenantId: tenant,
+            threadId: thread.id,
+            sessionId: parentSession.id,
+            projectId: project.id,
+            parentActor: userActor,
+        };
+        const options = {
+            agentId: 'worker',
+            input: { messages: [], workingDirectory: '/tmp' },
+            parentSessionId: parentSession.id,
+            tenantId: tenant,
+            projectId: project.id,
+            parentActor: userActor,
+            workspaceBackend: 'git-worktree',
+        };
+        // Two consecutive failing spawns. Without rollback, two orphan
+        // `active` child sessions would accumulate; with rollback, each
+        // attempt cleans up after itself and the store stays at { parent }.
+        await expect(manager.sendMessage(options, taskContext)).rejects.toThrow('synthetic workspace backend failure');
+        await expect(manager.sendMessage(options, taskContext)).rejects.toThrow('synthetic workspace backend failure');
+        // Still no child session under the thread.
+        const sessionsOnThread = await store.listSessions(thread.id, tenant);
+        expect(sessionsOnThread.map((s) => s.id)).toEqual([parentSession.id]);
+        // No lingering subsession rows — both attempts rolled back cleanly.
+        const subsessions = await store.getChildren(parentSession.id, tenant);
+        expect(subsessions).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=spawn-rollback.test.js.map

package/dist/session/__tests__/integration/spawn-rollback.test.js.map

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

package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Integration — SessionSummaryMaterializer + SessionStore atomic transition,
+ * plus the crash-recovery path.
+ *
+ * Covers roadmap §5 invariants: §8.1 (summary kernel-owned, no agent-callable
+ * emission surface), §8.1 atomic with terminal transition, recovery path
+ * when the status-flip lost to a mid-flight crash. `SessionAlreadySummarizedError`
+ * on concurrent re-materialize.
+ *
+ * The kernel-ownership assertion is expressed both structurally (the
+ * `materializedBy: 'kernel'` brand on the persisted record) and by routing
+ * every successful materialize through the Materializer — no test below calls
+ * `store.recordSummary` directly, and the compile-time type narrows the
+ * argument to `& { materializedBy: 'kernel' }` so an agent-constructed payload
+ * would fail typecheck (not just runtime validation).
+ */
+export {};
+//# sourceMappingURL=summary-materialization-e2e.test.d.ts.map

package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-materialization-e2e.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/summary-materialization-e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}