@namzu/sdk 0.1.8 → 0.2.0

package/dist/session/__tests__/integration/_fixtures.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Shared test fixtures for the Task 10 integration coverage matrix.
+ *
+ * Factors out the `AgentManager` + `SessionStore` + `WorkspaceBackendRegistry`
+ * + `SessionSummaryMaterializer` + `DefaultCapacityValidator` wiring that
+ * every integration test rebuilds. Keeping this in an underscore-prefixed
+ * internal module (Convention #4: `_fixtures.ts` does not bleed into any
+ * barrel) lets the 11 integration files focus on invariant assertions rather
+ * than boilerplate.
+ *
+ * DO NOT export from `src/session/index.ts` or any other public barrel.
+ * This module is test-only and has no runtime consumers.
+ */
+import { AgentManager } from '../../../manager/agent/lifecycle.js';
+import { AgentRegistry } from '../../../registry/agent/definitions.js';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import type { BaseAgentConfig, BaseAgentResult } from '../../../types/agent/base.js';
+import type { Agent } from '../../../types/agent/core.js';
+import type { AgentDefinition } from '../../../types/agent/factory.js';
+import type { AgentTaskContext, SendMessageOptions } from '../../../types/agent/task.js';
+import type { RunId, SessionId, TenantId } from '../../../types/ids/index.js';
+import type { ProjectId, SummaryId } from '../../../types/session/ids.js';
+import { DefaultCapacityValidator } from '../../handoff/capacity.js';
+import type { ActorRef } from '../../hierarchy/actor.js';
+import type { Session } from '../../hierarchy/session.js';
+import { SessionSummaryMaterializer } from '../../summary/materialize.js';
+import type { ExecFile, ExecFileResult } from '../../workspace/git-worktree.js';
+import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
+export declare const DEFAULT_TENANT: TenantId;
+export declare const OTHER_TENANT: TenantId;
+export declare function stubLogger(): {
+    debug: import("vitest").Mock<(...args: any[]) => any>;
+    info: import("vitest").Mock<(...args: any[]) => any>;
+    warn: import("vitest").Mock<(...args: any[]) => any>;
+    error: import("vitest").Mock<(...args: any[]) => any>;
+    child(): /*elided*/ any;
+};
+export declare function okExec(stdout?: string, stderr?: string): ExecFileResult;
+export declare function userActor(userId: string, tenantId?: TenantId): ActorRef;
+export declare function agentActor(agentId: string, tenantId?: TenantId): ActorRef;
+/**
+ * Builds a minimal {@link Agent} whose `run` produces a deterministic
+ * assistant message. Tests that need custom output shape override via
+ * {@link buildAgentCustom}.
+ */
+export declare function buildAgent(id: string, result?: string): Agent<BaseAgentConfig, BaseAgentResult>;
+/**
+ * Builds an agent with a caller-supplied `run`. Useful for tests that need
+ * to simulate failures or spawn cascading agents.
+ */
+export declare function buildAgentCustom(id: string, run: Agent<BaseAgentConfig, BaseAgentResult>['run']): Agent<BaseAgentConfig, BaseAgentResult>;
+export declare function buildDefinition(agent: Agent<BaseAgentConfig, BaseAgentResult>): AgentDefinition;
+export interface IntegrationHarness {
+    readonly store: InMemorySessionStore;
+    readonly registry: AgentRegistry;
+    readonly manager: AgentManager;
+    readonly materializer: SessionSummaryMaterializer;
+    readonly workspaceRegistry: WorkspaceBackendRegistry;
+    readonly capacity: DefaultCapacityValidator;
+    readonly tenantId: TenantId;
+}
+export interface IntegrationHarnessOptions {
+    readonly tenantId?: TenantId;
+    /** Pass `true` to register a no-op stubbed git-worktree driver. */
+    readonly withWorktreeDriver?: boolean;
+    readonly execFile?: ExecFile;
+    /**
+     * Deterministic summary ID generator — defaults to `sum_test_<n>`. Tests
+     * asserting on the exact id should override.
+     */
+    readonly summaryIdGenerator?: () => SummaryId;
+}
+/**
+ * Builds a full AgentManager + SessionStore + Materializer harness wired with
+ * real components (not mocks). The `GitWorktreeDriver` uses a stubbed
+ * `execFile` that returns empty stdout by default — tests exercising failure
+ * modes inject a real {@link ExecFile}.
+ */
+export declare function buildHarness(options?: IntegrationHarnessOptions): IntegrationHarness;
+/**
+ * Seeds a Tenant → Project → Session triple and flips the session into
+ * `active` so it is a legal spawn parent. Returns the project + active
+ * session for the caller to drive spawns against.
+ */
+export declare function seedActiveParent(harness: IntegrationHarness, options?: {
+    actor?: ActorRef;
+    projectName?: string;
+    tenantId?: TenantId;
+}): Promise<{
+    project: import("../../index.js").Project;
+    session: Session;
+    actor: ActorRef;
+}>;
+/**
+ * Constructs a fully populated {@link AgentTaskContext} bound to the supplied
+ * parent session + actor. Tests override individual fields (depth, budget)
+ * by merging.
+ */
+export declare function buildTaskContext(params: {
+    sessionId: SessionId;
+    projectId: ProjectId;
+    tenantId: TenantId;
+    parentActor: ActorRef;
+    depth?: number;
+    budget?: number;
+    parentRunId?: RunId;
+}): AgentTaskContext;
+export declare function buildSendMessageOptions(params: {
+    agentId: string;
+    parentSessionId: SessionId;
+    projectId: ProjectId;
+    tenantId: TenantId;
+    parentActor: ActorRef;
+}): SendMessageOptions;
+//# sourceMappingURL=_fixtures.d.ts.map

package/dist/session/__tests__/integration/_fixtures.d.ts.map

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

package/dist/session/__tests__/integration/_fixtures.js

@@ -0,0 +1,198 @@
+/**
+ * Shared test fixtures for the Task 10 integration coverage matrix.
+ *
+ * Factors out the `AgentManager` + `SessionStore` + `WorkspaceBackendRegistry`
+ * + `SessionSummaryMaterializer` + `DefaultCapacityValidator` wiring that
+ * every integration test rebuilds. Keeping this in an underscore-prefixed
+ * internal module (Convention #4: `_fixtures.ts` does not bleed into any
+ * barrel) lets the 11 integration files focus on invariant assertions rather
+ * than boilerplate.
+ *
+ * DO NOT export from `src/session/index.ts` or any other public barrel.
+ * This module is test-only and has no runtime consumers.
+ */
+import { vi } from 'vitest';
+import { EMPTY_TOKEN_USAGE } from '../../../constants/limits.js';
+import { AgentManager } from '../../../manager/agent/lifecycle.js';
+import { AgentRegistry } from '../../../registry/agent/definitions.js';
+import { InMemorySessionStore } from '../../../store/session/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 { GitWorktreeDriver } from '../../workspace/git-worktree.js';
+import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
+export const DEFAULT_TENANT = 'tnt_alpha';
+export const OTHER_TENANT = 'tnt_beta';
+export function stubLogger() {
+    return {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        child() {
+            return stubLogger();
+        },
+    };
+}
+export function okExec(stdout = '', stderr = '') {
+    return { stdout, stderr };
+}
+export function userActor(userId, tenantId = DEFAULT_TENANT) {
+    return { kind: 'user', userId: userId, tenantId };
+}
+export function agentActor(agentId, tenantId = DEFAULT_TENANT) {
+    return { kind: 'agent', agentId: agentId, tenantId };
+}
+const BASE_CAPABILITIES = {
+    supportsTools: false,
+    supportsStreaming: false,
+    supportsConcurrency: false,
+    supportsSubAgents: false,
+};
+/**
+ * Builds a minimal {@link Agent} whose `run` produces a deterministic
+ * assistant message. Tests that need custom output shape override via
+ * {@link buildAgentCustom}.
+ */
+export function buildAgent(id, result = 'child did the work') {
+    return {
+        type: 'reactive',
+        metadata: {
+            type: 'reactive',
+            id,
+            name: id,
+            version: '1.0.0',
+            category: 'test',
+            description: id,
+            capabilities: BASE_CAPABILITIES,
+        },
+        run: async (_input, _config) => ({
+            runId: `run_${id}_result`,
+            status: 'completed',
+            usage: { ...EMPTY_TOKEN_USAGE },
+            cost: { ...ZERO_COST },
+            iterations: 1,
+            durationMs: 1,
+            messages: [createAssistantMessage(result)],
+            result,
+        }),
+        cancel: async () => undefined,
+        getCapabilities: () => BASE_CAPABILITIES,
+    };
+}
+/**
+ * Builds an agent with a caller-supplied `run`. Useful for tests that need
+ * to simulate failures or spawn cascading agents.
+ */
+export function buildAgentCustom(id, run) {
+    return {
+        type: 'reactive',
+        metadata: {
+            type: 'reactive',
+            id,
+            name: id,
+            version: '1.0.0',
+            category: 'test',
+            description: id,
+            capabilities: BASE_CAPABILITIES,
+        },
+        run,
+        cancel: async () => undefined,
+        getCapabilities: () => BASE_CAPABILITIES,
+    };
+}
+export 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,
+    };
+}
+/**
+ * Builds a full AgentManager + SessionStore + Materializer harness wired with
+ * real components (not mocks). The `GitWorktreeDriver` uses a stubbed
+ * `execFile` that returns empty stdout by default — tests exercising failure
+ * modes inject a real {@link ExecFile}.
+ */
+export function buildHarness(options = {}) {
+    const tenantId = options.tenantId ?? DEFAULT_TENANT;
+    const store = new InMemorySessionStore();
+    const workspaceRegistry = new WorkspaceBackendRegistry();
+    if (options.withWorktreeDriver !== false) {
+        const exec = options.execFile ?? (async () => okExec());
+        const driver = new GitWorktreeDriver({
+            repoRoot: '/repo',
+            logger: stubLogger(),
+            execFile: exec,
+        });
+        workspaceRegistry.register(driver);
+    }
+    let counter = 0;
+    const generateSummaryId = options.summaryIdGenerator ?? (() => `sum_test_${++counter}`);
+    const materializer = new SessionSummaryMaterializer({
+        store,
+        generateSummaryId,
+    });
+    const capacity = new DefaultCapacityValidator(store);
+    const registry = new AgentRegistry();
+    const manager = new AgentManager(registry, undefined, {
+        sessionStore: store,
+        summaryMaterializer: materializer,
+        workspaceRegistry,
+        capacity,
+    });
+    return { store, registry, manager, materializer, workspaceRegistry, capacity, tenantId };
+}
+/**
+ * Seeds a Tenant → Project → Session triple and flips the session into
+ * `active` so it is a legal spawn parent. Returns the project + active
+ * session for the caller to drive spawns against.
+ */
+export async function seedActiveParent(harness, options) {
+    const tenantId = options?.tenantId ?? harness.tenantId;
+    const actor = options?.actor ?? userActor('usr_root', tenantId);
+    const project = await harness.store.createProject({ tenantId, name: options?.projectName ?? 'integration-project' }, tenantId);
+    const session = await harness.store.createSession({ projectId: project.id, currentActor: actor }, tenantId);
+    await harness.store.updateSession({ ...session, status: 'active' }, tenantId);
+    return { project, session, actor };
+}
+/**
+ * Constructs a fully populated {@link AgentTaskContext} bound to the supplied
+ * parent session + actor. Tests override individual fields (depth, budget)
+ * by merging.
+ */
+export function buildTaskContext(params) {
+    return {
+        parentRunId: params.parentRunId ?? 'run_parent',
+        parentAgentId: 'supervisor',
+        parentAbortController: new AbortController(),
+        depth: params.depth ?? 0,
+        budgetTracker: {
+            total: params.budget ?? 100_000,
+            remaining: params.budget ?? 100_000,
+        },
+        tenantId: params.tenantId,
+        sessionId: params.sessionId,
+        projectId: params.projectId,
+        parentActor: params.parentActor,
+    };
+}
+export function buildSendMessageOptions(params) {
+    return {
+        agentId: params.agentId,
+        input: { messages: [], workingDirectory: '/tmp' },
+        parentSessionId: params.parentSessionId,
+        tenantId: params.tenantId,
+        projectId: params.projectId,
+        parentActor: params.parentActor,
+    };
+}
+//# sourceMappingURL=_fixtures.js.map

package/dist/session/__tests__/integration/_fixtures.js.map

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

package/dist/session/__tests__/integration/capacity-caps.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Integration — delegation capacity (depth + width) caps enforced at real
+ * spawn sites. See session-hierarchy.md §6.5.
+ *
+ * Covers roadmap §5 invariants: §6.5 capacity enforcement at both
+ * `spawnSubSession` (AgentManager.sendMessage) and `broadcastHandoff` call
+ * sites. Orthogonal to `session/handoff/__tests__/capacity.test.ts` which
+ * exercises `DefaultCapacityValidator` directly — this file routes through
+ * the real manager so the wired capacity check fires before any observable
+ * state change.
+ */
+export {};
+//# sourceMappingURL=capacity-caps.test.d.ts.map

package/dist/session/__tests__/integration/capacity-caps.test.d.ts.map

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

package/dist/session/__tests__/integration/capacity-caps.test.js

@@ -0,0 +1,116 @@
+/**
+ * Integration — delegation capacity (depth + width) caps enforced at real
+ * spawn sites. See session-hierarchy.md §6.5.
+ *
+ * Covers roadmap §5 invariants: §6.5 capacity enforcement at both
+ * `spawnSubSession` (AgentManager.sendMessage) and `broadcastHandoff` call
+ * sites. Orthogonal to `session/handoff/__tests__/capacity.test.ts` which
+ * exercises `DefaultCapacityValidator` directly — this file routes through
+ * the real manager so the wired capacity check fires before any observable
+ * state change.
+ */
+import { describe, expect, it } from 'vitest';
+import { DelegationCapacityExceeded } from '../../handoff/capacity.js';
+import { DEFAULT_TENANT, agentActor, buildAgent, buildDefinition, buildHarness, buildSendMessageOptions, buildTaskContext, seedActiveParent, userActor, } from './_fixtures.js';
+describe('Integration — capacity caps at spawn sites', () => {
+    it('spawn at depth 4 accepted; depth 5 rejected (default maxDelegationDepth=4)', async () => {
+        const harness = buildHarness();
+        const { project } = await seedActiveParent(harness);
+        // Build a depth-4 ancestry chain under the project. Each layer flips to
+        // `active` so it is a legal spawn parent via the real AgentManager.
+        const chainActors = [userActor('usr_root')];
+        let parentSessionId = (await harness.store.createSession({ projectId: project.id, currentActor: chainActors[0] ?? userActor('usr_root') }, DEFAULT_TENANT)).id;
+        // depth 0 root session.
+        const sessions = [parentSessionId];
+        for (let i = 0; i < 4; i++) {
+            const child = await harness.store.createSession({ projectId: project.id, currentActor: agentActor(`agt_${i}`) }, DEFAULT_TENANT);
+            await harness.store.createSubSession({
+                parentSessionId,
+                childSessionId: child.id,
+                kind: 'agent_spawn',
+                spawnedBy: agentActor(`agt_${i}`),
+            }, DEFAULT_TENANT);
+            parentSessionId = child.id;
+            sessions.push(child.id);
+        }
+        // Ancestry of the tail is root→c1→c2→c3→c4 = length 5; spawning under
+        // it would land a child at depth 5 which exceeds the default cap of 4.
+        harness.registry.register(buildDefinition(buildAgent('worker')));
+        const tail = parentSessionId;
+        const context = buildTaskContext({
+            sessionId: tail,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: userActor('usr_root'),
+        });
+        const options = buildSendMessageOptions({
+            agentId: 'worker',
+            parentSessionId: tail,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: userActor('usr_root'),
+        });
+        await expect(harness.manager.sendMessage(options, context)).rejects.toBeInstanceOf(DelegationCapacityExceeded);
+    });
+    it('spawn at width 8 accepted; 9th sibling rejected (default maxDelegationWidth=8)', async () => {
+        const harness = buildHarness();
+        const { project, session, actor } = await seedActiveParent(harness);
+        // Seed 8 existing children directly through the store.
+        for (let i = 0; i < 8; i++) {
+            const child = await harness.store.createSession({ projectId: project.id, currentActor: agentActor(`agt_${i}`) }, DEFAULT_TENANT);
+            await harness.store.createSubSession({
+                parentSessionId: session.id,
+                childSessionId: child.id,
+                kind: 'agent_spawn',
+                spawnedBy: actor,
+            }, DEFAULT_TENANT);
+        }
+        harness.registry.register(buildDefinition(buildAgent('worker')));
+        const context = buildTaskContext({
+            sessionId: session.id,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: actor,
+        });
+        const options = buildSendMessageOptions({
+            agentId: 'worker',
+            parentSessionId: session.id,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: actor,
+        });
+        // Ninth direct child via sendMessage should reject on width.
+        await expect(harness.manager.sendMessage(options, context)).rejects.toBeInstanceOf(DelegationCapacityExceeded);
+    });
+    it('wired path: capacity validator reads from the real store (ancestry + children) via AgentManager', async () => {
+        // Exercises the manager.sendMessage → capacity.validateDepth +
+        // capacity.validateWidth seam. The real validator is
+        // DefaultCapacityValidator(store) so it walks the actual persisted
+        // parent chain — confirms the wiring rather than a direct unit call.
+        const harness = buildHarness();
+        const { project, session, actor } = await seedActiveParent(harness);
+        harness.registry.register(buildDefinition(buildAgent('worker')));
+        // Only 1 existing child — well below caps. Spawn should succeed
+        // through the wired path.
+        const context = buildTaskContext({
+            sessionId: session.id,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: actor,
+        });
+        const options = buildSendMessageOptions({
+            agentId: 'worker',
+            parentSessionId: session.id,
+            projectId: project.id,
+            tenantId: DEFAULT_TENANT,
+            parentActor: actor,
+        });
+        const task = await harness.manager.sendMessage(options, context);
+        await harness.manager.waitForCompletion(task.taskId);
+        const spawn = harness.manager.getSpawnRecord(task.taskId);
+        expect(spawn).toBeDefined();
+        const children = await harness.store.getChildren(session.id, DEFAULT_TENANT);
+        expect(children.length).toBeGreaterThanOrEqual(1);
+    });
+});
+//# sourceMappingURL=capacity-caps.test.js.map

package/dist/session/__tests__/integration/capacity-caps.test.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * End-to-end SubSession spawn flow.
+ *
+ * Builds Tenant → Project → Session → simulated Run → spawnSubAgent →
+ * SubSession → child Run → child completion → SessionSummaryRef materialized
+ * → parent reads the child summary via `sessionStore.drill`. Asserts the
+ * event sequence matches §10.5 of session-hierarchy.md (spawn, child run,
+ * idled).
+ *
+ * Covers Phase 6 invariants #1–5 in the pattern doc checklist:
+ *  - Sub-session spawn triple (SubSession + Session + workspace meta)
+ *  - Kernel-materialized Summary on completion
+ *  - Lineage on every sub-session event (depth, rootSessionId)
+ *  - Atomic `recordSummary` flip active→idle
+ *  - `sessionStore.drill` surfaces the child's structure after completion
+ */
+export {};
+//# sourceMappingURL=e2e-spawn.test.d.ts.map

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

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