@namzu/sdk 0.1.7 → 0.2.0

package/dist/session/events/types.d.ts

@@ -0,0 +1,64 @@
+import type { MessageId, RunId, SessionId } from '../../types/ids/index.js';
+import type { SubSessionId } from '../../types/session/ids.js';
+import type { ActorRef } from '../hierarchy/actor.js';
+import type { Lineage } from '../hierarchy/lineage.js';
+import type { RunEventSchemaVersion } from './schema-version.js';
+/**
+ * Sub-session lifecycle events that splice into {@link RunEvent}.
+ *
+ * See session-hierarchy.md §10.4 (Parent-Child Linkage). These cover the
+ * in-flight visibility gap that the terminal-only `SessionSummaryRef` does
+ * not address. Every sub-session emission carries the full {@link Lineage}
+ * chain — consumers can reconstruct the delegation tree without walking the
+ * store (§10.4 invariant).
+ *
+ * Note: these events are spliced into the `RunEvent` union in
+ * `types/run/events.ts` rather than kept as a separate top-level union.
+ * A dedicated `SessionHierarchyEvent` top-level type lands in Phase 3+.
+ */
+/**
+ * Emitted when the kernel creates a new sub-session. Precedes the child
+ * session's `run_started`. See §10.4 / §10.5 example stream.
+ */
+export interface SubsessionSpawnedEvent {
+    type: 'subsession_spawned';
+    runId: RunId;
+    subSessionId: SubSessionId;
+    parentSessionId: SessionId;
+    spawnedBy: ActorRef;
+    lineage: Lineage;
+    schemaVersion: RunEventSchemaVersion;
+    at: Date;
+}
+/**
+ * Emitted each time the child session's Run appends a message. Gives parents
+ * and platform consumers in-flight visibility without requiring a drill into
+ * the child transcript. See §10.4.
+ */
+export interface SubsessionMessagedEvent {
+    type: 'subsession_messaged';
+    runId: RunId;
+    subSessionId: SubSessionId;
+    parentSessionId: SessionId;
+    messageId: MessageId;
+    lineage: Lineage;
+    schemaVersion: RunEventSchemaVersion;
+    at: Date;
+}
+/**
+ * Emitted when the child session transitions to `idle` (terminal persistent
+ * state per §5.3 — sub-sessions never close). A separate
+ * `sub_session.summarized` event carries the `SessionSummaryRef` (§8); this
+ * event only reports the lifecycle transition.
+ */
+export interface SubsessionIdledEvent {
+    type: 'subsession_idled';
+    runId: RunId;
+    subSessionId: SubSessionId;
+    parentSessionId: SessionId;
+    lineage: Lineage;
+    schemaVersion: RunEventSchemaVersion;
+    at: Date;
+}
+export type SubsessionLifecycleEvent = SubsessionSpawnedEvent | SubsessionMessagedEvent | SubsessionIdledEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/session/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/session/events/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhE;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,SAAS,CAAA;IAC1B,SAAS,EAAE,QAAQ,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,qBAAqB,CAAA;IACpC,EAAE,EAAE,IAAI,CAAA;CACR;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,qBAAqB,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,SAAS,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,qBAAqB,CAAA;IACpC,EAAE,EAAE,IAAI,CAAA;CACR;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,SAAS,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,qBAAqB,CAAA;IACpC,EAAE,EAAE,IAAI,CAAA;CACR;AAED,MAAM,MAAM,wBAAwB,GACjC,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,CAAA"}

package/dist/session/events/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/session/events/types.ts"],"names":[],"mappings":""}

package/dist/session/handoff/__tests__/broadcast.test.d.ts

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

package/dist/session/handoff/__tests__/broadcast.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.test.d.ts","sourceRoot":"","sources":["../../../../src/session/handoff/__tests__/broadcast.test.ts"],"names":[],"mappings":""}

package/dist/session/handoff/__tests__/broadcast.test.js

@@ -0,0 +1,243 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { GitWorktreeDriver, } from '../../../session/workspace/git-worktree.js';
+import { WorkspaceBackendRegistry } from '../../../session/workspace/registry.js';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { generateHandoffId } from '../../../utils/id.js';
+import { executeBroadcastHandoff } from '../broadcast.js';
+import { DefaultCapacityValidator } from '../capacity.js';
+import { HandoffVersionConflict } from '../version.js';
+const tenant = 'tnt_alpha';
+function stubLogger() {
+    return {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        child() {
+            return stubLogger();
+        },
+    };
+}
+function okExec(stdout = '', stderr = '') {
+    return { stdout, stderr };
+}
+function user(userId) {
+    return { kind: 'user', userId: userId, tenantId: tenant };
+}
+function buildDeps(store, execOverride) {
+    const exec = execOverride ? execOverride : async (_file, _args) => okExec();
+    const driver = new GitWorktreeDriver({
+        repoRoot: '/repo',
+        logger: stubLogger(),
+        execFile: exec,
+    });
+    const registry = new WorkspaceBackendRegistry();
+    registry.register(driver);
+    const events = {
+        onLocked: vi.fn(),
+        onUnlocked: vi.fn(),
+        onCommitted: vi.fn(),
+        onBroadcastRollback: vi.fn(),
+    };
+    return {
+        deps: {
+            store,
+            workspaceRegistry: registry,
+            capacity: new DefaultCapacityValidator(store),
+            events,
+        },
+        events,
+    };
+}
+async function seedIdle(store) {
+    const project = await store.createProject({ tenantId: tenant, name: 'p' }, tenant);
+    const session = await store.createSession({ projectId: project.id, currentActor: user('usr_source') }, tenant);
+    return { project, session };
+}
+function buildAssignments(sourceSessionId, projectId, expectedOwnerVersion, recipients, broadcastId = 'bc_1') {
+    return recipients.map((recipientActor) => ({
+        id: generateHandoffId(),
+        mode: 'broadcast',
+        sourceSessionId,
+        tenantId: tenant,
+        projectId,
+        sourceActor: user('usr_source'),
+        recipientActor,
+        expectedOwnerVersion,
+        broadcastId,
+        createdAt: new Date('2026-02-01'),
+    }));
+}
+describe('executeBroadcastHandoff', () => {
+    let store;
+    beforeEach(() => {
+        store = new InMemorySessionStore();
+    });
+    it('happy path: 3 recipients → source ends in awaiting_merge with 3 new children', async () => {
+        const { project, session } = await seedIdle(store);
+        const { deps, events } = buildDeps(store);
+        const assignments = buildAssignments(session.id, project.id, 0, [
+            user('usr_bob'),
+            user('usr_carol'),
+            user('usr_dan'),
+        ]);
+        const outcomes = await executeBroadcastHandoff(deps, assignments, tenant);
+        expect(outcomes).toHaveLength(3);
+        expect(new Set(outcomes.map((o) => o.newSessionId)).size).toBe(3);
+        expect(outcomes.every((o) => o.committedOwnerVersion === 1)).toBe(true);
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('awaiting_merge');
+        expect(reloaded?.ownerVersion).toBe(1);
+        const children = await store.getChildren(session.id, tenant);
+        expect(children).toHaveLength(3);
+        expect(events.onLocked).toHaveBeenCalledTimes(1);
+        expect(events.onCommitted).toHaveBeenCalledTimes(1);
+        expect(events.onBroadcastRollback).not.toHaveBeenCalled();
+    });
+    it('rollback on mid-fan-out failure (2nd recipient worktree add fails): source reverts, rollback emits accurate partialState', async () => {
+        const { project, session } = await seedIdle(store);
+        let addCount = 0;
+        const exec = async (_file, args) => {
+            if (args.includes('add')) {
+                addCount += 1;
+                if (addCount === 2)
+                    throw new Error('simulated mid-fanout failure');
+            }
+            return okExec();
+        };
+        const { deps, events } = buildDeps(store, exec);
+        const assignments = buildAssignments(session.id, project.id, 0, [
+            user('usr_b'),
+            user('usr_c'),
+            user('usr_d'),
+        ]);
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow(/Workspace backend git-worktree failed on create/);
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('idle');
+        expect(reloaded?.ownerVersion).toBe(0);
+        // The first recipient got through all three sub-ops; the second failed
+        // during worktree provisioning. partialState reports:
+        //   worktreesProvisioned: 1 (the first recipient's)
+        //   subsessionsCreated: 1 (the first recipient's)
+        //   assignmentsWritten: 1 (the first recipient's)
+        expect(events.onBroadcastRollback).toHaveBeenCalledTimes(1);
+        const rollbackCall = events.onBroadcastRollback.mock.calls[0]?.[0];
+        expect(rollbackCall).toBeDefined();
+        expect(rollbackCall?.partialState.worktreesProvisioned).toBe(1);
+        expect(rollbackCall?.partialState.subsessionsCreated).toBe(1);
+        expect(rollbackCall?.partialState.assignmentsWritten).toBe(1);
+        expect(rollbackCall?.broadcastId).toBe('bc_1');
+        // Phase 8: rollback now fully deletes partial records rather than
+        // flipping them to 'archived'. The source session has no children and
+        // no orphan child sessions remain under the project.
+        const children = await store.getChildren(session.id, tenant);
+        expect(children).toHaveLength(0);
+    });
+    it('rollback performs full cleanup via deleteSubSession/deleteSession (no status-flip stopgap)', async () => {
+        const { project, session } = await seedIdle(store);
+        let addCount = 0;
+        const exec = async (_file, args) => {
+            if (args.includes('add')) {
+                addCount += 1;
+                if (addCount === 2)
+                    throw new Error('simulated failure');
+            }
+            return okExec();
+        };
+        const { deps } = buildDeps(store, exec);
+        const assignments = buildAssignments(session.id, project.id, 0, [user('usr_b'), user('usr_c')]);
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow();
+        // No sub-session record remains.
+        const children = await store.getChildren(session.id, tenant);
+        expect(children).toHaveLength(0);
+        // Source is back to idle with its original ownerVersion (unchanged because
+        // the CAS commit never landed).
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('idle');
+        expect(reloaded?.ownerVersion).toBe(0);
+    });
+    it('rollback idempotency: worktree dispose throwing during rollback does not bubble a secondary failure', async () => {
+        const { project, session } = await seedIdle(store);
+        let addCount = 0;
+        let removeCount = 0;
+        const exec = async (_file, args) => {
+            if (args.includes('add')) {
+                addCount += 1;
+                if (addCount === 2)
+                    throw new Error('primary: mid-fanout add failure');
+            }
+            if (args.includes('remove')) {
+                removeCount += 1;
+                // Throw an unclassified error so the regex in dispose does NOT treat
+                // it as idempotent success — exercises the outer try/catch in the
+                // rollback loop.
+                throw new Error('secondary rollback dispose failure (unexpected)');
+            }
+            return okExec();
+        };
+        const { deps, events } = buildDeps(store, exec);
+        const assignments = buildAssignments(session.id, project.id, 0, [user('usr_b'), user('usr_c')]);
+        // Outer failure is the PRIMARY one — the secondary dispose failure is
+        // swallowed. Primary wraps in WorkspaceBackendError (create op).
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow(/Workspace backend git-worktree failed on create/);
+        expect(removeCount).toBeGreaterThanOrEqual(1);
+        expect(events.onBroadcastRollback).toHaveBeenCalledTimes(1);
+        // Source is idle (rollback succeeded at the store layer even if dispose
+        // partially failed).
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('idle');
+    });
+    it('dedupe: two assignments targeting same recipient → rejected pre-lock (no side effects)', async () => {
+        const { project, session } = await seedIdle(store);
+        const { deps, events } = buildDeps(store);
+        const bob = user('usr_bob');
+        const assignments = buildAssignments(session.id, project.id, 0, [bob, bob, user('usr_dan')]);
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow(/duplicate recipient/);
+        // Source never locked — no events fired.
+        expect(events.onLocked).not.toHaveBeenCalled();
+        expect(events.onCommitted).not.toHaveBeenCalled();
+        expect(events.onBroadcastRollback).not.toHaveBeenCalled();
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('idle');
+    });
+    it('width cap: 9 recipients exceeds default maxWidth=8 → rejected before source lock', async () => {
+        const { project, session } = await seedIdle(store);
+        const { deps, events } = buildDeps(store);
+        const recipients = Array.from({ length: 9 }, (_, i) => user(`usr_${i}`));
+        const assignments = buildAssignments(session.id, project.id, 0, recipients);
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow(/Delegation capacity exceeded/);
+        expect(events.onLocked).not.toHaveBeenCalled();
+        expect(events.onBroadcastRollback).not.toHaveBeenCalled();
+        const reloaded = await store.getSession(session.id, tenant);
+        expect(reloaded?.status).toBe('idle');
+    });
+    it('concurrent broadcast on same source: second attempt rejected with HandoffVersionConflict', async () => {
+        const { project, session } = await seedIdle(store);
+        const { deps } = buildDeps(store);
+        const firstAssignments = buildAssignments(session.id, project.id, 0, [user('usr_b'), user('usr_c')], 'bc_1');
+        await executeBroadcastHandoff(deps, firstAssignments, tenant);
+        // Second broadcast still has expectedOwnerVersion = 0 but source is now 1.
+        // It should also observe source.status === 'awaiting_merge' (non-idle) —
+        // that rejects with HandoffLockRejected BEFORE the CAS check fires. To
+        // exercise the CAS path, reset source to `idle` (simulating all recipients
+        // completing) and THEN attempt the second handoff with stale expected=0.
+        const reloaded = await store.getSession(session.id, tenant);
+        if (!reloaded)
+            throw new Error('source missing');
+        await store.updateSession({ ...reloaded, status: 'idle' }, tenant);
+        const second = buildAssignments(session.id, project.id, 0, // stale — actual is 1
+        [user('usr_d'), user('usr_e')], 'bc_2');
+        await expect(executeBroadcastHandoff(deps, second, tenant)).rejects.toBeInstanceOf(HandoffVersionConflict);
+    });
+    it('empty assignments → throws a descriptive error', async () => {
+        const { deps } = buildDeps(store);
+        await expect(executeBroadcastHandoff(deps, [], tenant)).rejects.toThrow(/assignments must not be empty/);
+    });
+    it('single-row broadcast → rejected (caller must use executeSingleHandoff)', async () => {
+        const { project, session } = await seedIdle(store);
+        const { deps } = buildDeps(store);
+        const assignments = buildAssignments(session.id, project.id, 0, [user('usr_b')]);
+        await expect(executeBroadcastHandoff(deps, assignments, tenant)).rejects.toThrow(/single-recipient handoffs must use executeSingleHandoff/);
+    });
+});
+//# sourceMappingURL=broadcast.test.js.map

package/dist/session/handoff/__tests__/broadcast.test.js.map

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

package/dist/session/handoff/__tests__/capacity.test.d.ts

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

package/dist/session/handoff/__tests__/capacity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.test.d.ts","sourceRoot":"","sources":["../../../../src/session/handoff/__tests__/capacity.test.ts"],"names":[],"mappings":""}

package/dist/session/handoff/__tests__/capacity.test.js

@@ -0,0 +1,100 @@
+import { describe, expect, it } from 'vitest';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { DefaultCapacityValidator, DelegationCapacityExceeded } from '../capacity.js';
+const tenant = 'tnt_alpha';
+function user() {
+    return { kind: 'user', userId: 'usr_a', tenantId: tenant };
+}
+function agent() {
+    return { kind: 'agent', agentId: 'agt_a', tenantId: tenant };
+}
+async function seedProject(store) {
+    const project = await store.createProject({ tenantId: tenant, name: 'p' }, tenant);
+    const root = await store.createSession({ projectId: project.id, currentActor: user() }, tenant);
+    return { project, root };
+}
+async function spawnChild(store, parentId, projectId) {
+    const child = await store.createSession({ projectId, currentActor: user() }, tenant);
+    await store.createSubSession({
+        parentSessionId: parentId,
+        childSessionId: child.id,
+        kind: 'agent_spawn',
+        spawnedBy: agent(),
+    }, tenant);
+    return { childId: child.id };
+}
+describe('DefaultCapacityValidator', () => {
+    it('depth: root session validates against limit 4 (new child would be depth 1) — passes', async () => {
+        const store = new InMemorySessionStore();
+        const { root } = await seedProject(store);
+        const validator = new DefaultCapacityValidator(store);
+        await expect(validator.validateDepth(root.id, 4, tenant)).resolves.toBeUndefined();
+    });
+    it('depth: chain of 4 (root→c1→c2→c3→c4) allows a 5th (depth 5) to pass when limit = 5', async () => {
+        const store = new InMemorySessionStore();
+        const { project, root } = await seedProject(store);
+        const c1 = await spawnChild(store, root.id, project.id);
+        const c2 = await spawnChild(store, c1.childId, project.id);
+        const c3 = await spawnChild(store, c2.childId, project.id);
+        const c4 = await spawnChild(store, c3.childId, project.id);
+        const validator = new DefaultCapacityValidator(store);
+        // Ancestry of c4: root→c1→c2→c3→c4 = length 5. Spawning under c4 = depth 5.
+        await expect(validator.validateDepth(c4.childId, 5, tenant)).resolves.toBeUndefined();
+    });
+    it('depth: over-limit throws DelegationCapacityExceeded with dimension=depth', async () => {
+        const store = new InMemorySessionStore();
+        const { project, root } = await seedProject(store);
+        const c1 = await spawnChild(store, root.id, project.id);
+        const c2 = await spawnChild(store, c1.childId, project.id);
+        const c3 = await spawnChild(store, c2.childId, project.id);
+        const c4 = await spawnChild(store, c3.childId, project.id);
+        const validator = new DefaultCapacityValidator(store);
+        try {
+            // Ancestry of c4 has length 5; limit=4 means depth 5 > 4 → reject.
+            await validator.validateDepth(c4.childId, 4, tenant);
+            expect.fail('expected DelegationCapacityExceeded');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(DelegationCapacityExceeded);
+            const e = err;
+            expect(e.details.dimension).toBe('depth');
+            expect(e.details.limit).toBe(4);
+            expect(e.details.current).toBe(5);
+        }
+    });
+    it('width: empty parent with 4 pending children passes limit=8', async () => {
+        const store = new InMemorySessionStore();
+        const { root } = await seedProject(store);
+        const validator = new DefaultCapacityValidator(store);
+        await expect(validator.validateWidth(root.id, 4, 8, tenant)).resolves.toBeUndefined();
+    });
+    it('width: existing 5 + pending 3 = 8 passes exactly at the limit', async () => {
+        const store = new InMemorySessionStore();
+        const { project, root } = await seedProject(store);
+        for (let i = 0; i < 5; i++) {
+            await spawnChild(store, root.id, project.id);
+        }
+        const validator = new DefaultCapacityValidator(store);
+        await expect(validator.validateWidth(root.id, 3, 8, tenant)).resolves.toBeUndefined();
+    });
+    it('width: existing 6 + pending 3 = 9 exceeds 8, throws dimension=width', async () => {
+        const store = new InMemorySessionStore();
+        const { project, root } = await seedProject(store);
+        for (let i = 0; i < 6; i++) {
+            await spawnChild(store, root.id, project.id);
+        }
+        const validator = new DefaultCapacityValidator(store);
+        try {
+            await validator.validateWidth(root.id, 3, 8, tenant);
+            expect.fail('expected DelegationCapacityExceeded');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(DelegationCapacityExceeded);
+            const e = err;
+            expect(e.details.dimension).toBe('width');
+            expect(e.details.current).toBe(9);
+            expect(e.details.limit).toBe(8);
+        }
+    });
+});
+//# sourceMappingURL=capacity.test.js.map

package/dist/session/handoff/__tests__/capacity.test.js.map

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

package/dist/session/handoff/__tests__/single.test.d.ts

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

package/dist/session/handoff/__tests__/single.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single.test.d.ts","sourceRoot":"","sources":["../../../../src/session/handoff/__tests__/single.test.ts"],"names":[],"mappings":""}