@namzu/sdk 0.1.8 → 0.3.0

package/dist/run/reporter.js

@@ -166,6 +166,31 @@ export function createRunReporter(parentLogger) {
                     sandboxId: event.sandboxId,
                 });
                 break;
+            case 'subsession_spawned':
+                log.debug('Sub-session spawned', {
+                    runId: event.runId,
+                    subSessionId: event.subSessionId,
+                    parentSessionId: event.parentSessionId,
+                    depth: event.lineage.depth,
+                });
+                break;
+            case 'subsession_messaged':
+                log.debug('Sub-session message', {
+                    runId: event.runId,
+                    subSessionId: event.subSessionId,
+                    parentSessionId: event.parentSessionId,
+                    messageId: event.messageId,
+                    depth: event.lineage.depth,
+                });
+                break;
+            case 'subsession_idled':
+                log.debug('Sub-session idled', {
+                    runId: event.runId,
+                    subSessionId: event.subSessionId,
+                    parentSessionId: event.parentSessionId,
+                    depth: event.lineage.depth,
+                });
+                break;
             default: {
                 const _exhaustive = event;
                 throw new Error(`Unhandled run event type: ${_exhaustive.type}`);

package/dist/run/reporter.js.map

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

package/dist/runtime/query/__tests__/context.test.d.ts

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

package/dist/runtime/query/__tests__/context.test.d.ts.map

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

package/dist/runtime/query/__tests__/context.test.js

@@ -0,0 +1,85 @@
+import { describe, expect, it, vi } from 'vitest';
+import { DefaultPathBuilder } from '../../../session/workspace/path-builder.js';
+import { RunContextFactory } from '../context.js';
+function mockProvider() {
+    return {
+        id: 'mock',
+        supports: () => true,
+        chat: async () => ({ message: { role: 'assistant', content: '' } }),
+    };
+}
+function buildConfig(overrides = {}) {
+    const sessionId = 'ses_test';
+    const threadId = 'thd_test';
+    const projectId = 'prj_test';
+    const tenantId = 'tnt_test';
+    const runConfig = {
+        model: 'test',
+        tokenBudget: 1_000,
+        timeoutMs: 5_000,
+    };
+    return {
+        agentId: 'agent-1',
+        agentName: 'agent-1',
+        runConfig,
+        provider: mockProvider(),
+        messages: [],
+        sessionId,
+        threadId,
+        projectId,
+        tenantId,
+        workingDirectory: '/tmp/run-context-test',
+        ...overrides,
+    };
+}
+describe('RunContextFactory.build', () => {
+    it('requires sessionId, threadId, projectId, tenantId and returns them on the context', () => {
+        const cfg = buildConfig();
+        const ctx = RunContextFactory.build(cfg);
+        expect(ctx.sessionId).toBe(cfg.sessionId);
+        expect(ctx.threadId).toBe(cfg.threadId);
+        expect(ctx.projectId).toBe(cfg.projectId);
+        expect(ctx.tenantId).toBe(cfg.tenantId);
+    });
+    it('uses the injected PathBuilder to resolve the output dir (no hardcoded .namzu/threads)', () => {
+        const pathBuilderMock = {
+            rootDir: vi.fn(() => '/mock/root'),
+            projectDir: vi.fn((pid) => `/mock/root/projects/${pid}`),
+            sessionDir: vi.fn((pid, sid) => `/mock/root/projects/${pid}/sessions/${sid}`),
+            subSessionDir: vi.fn(),
+            runDir: vi.fn(),
+        };
+        const cfg = buildConfig({ pathBuilder: pathBuilderMock });
+        const ctx = RunContextFactory.build(cfg);
+        expect(pathBuilderMock.sessionDir).toHaveBeenCalledWith(cfg.projectId, cfg.sessionId);
+        expect(ctx.outputDir).toBe(`/mock/root/projects/${cfg.projectId}/sessions/${cfg.sessionId}`);
+        // Legacy hardcoded path must not leak.
+        expect(ctx.outputDir).not.toContain('.namzu/threads');
+    });
+    it('falls back to DefaultPathBuilder rooted at {cwd}/.namzu when no pathBuilder is provided', () => {
+        const cfg = buildConfig();
+        const ctx = RunContextFactory.build(cfg);
+        // Layout lives under projects/{pid}/sessions/{sid} — no `.namzu/threads/`.
+        expect(ctx.outputDir).toContain('/.namzu/projects/prj_test/sessions/ses_test');
+        expect(ctx.outputDir).not.toContain('threads');
+    });
+    it('seeds RunPersistence with propagated sessionId/threadId/tenantId/projectId', () => {
+        const cfg = buildConfig();
+        const ctx = RunContextFactory.build(cfg);
+        expect(ctx.runMgr.sessionId).toBe(cfg.sessionId);
+        expect(ctx.runMgr.threadId).toBe(cfg.threadId);
+        expect(ctx.runMgr.tenantId).toBe(cfg.tenantId);
+        expect(ctx.runMgr.projectId).toBe(cfg.projectId);
+    });
+    it('reuses the runId supplied by the caller', () => {
+        const runId = 'run_fixed';
+        const ctx = RunContextFactory.build(buildConfig({ runId }));
+        expect(ctx.runId).toBe(runId);
+    });
+    it('DefaultPathBuilder lays out runs under sessions/{sessionId}/runs', () => {
+        const builder = new DefaultPathBuilder('/base/.namzu');
+        const runDir = builder.runDir('prj_x', 'ses_y', 'run_z');
+        expect(runDir).toBe('/base/.namzu/projects/prj_x/sessions/ses_y/runs/run_z');
+    });
+});
+//# sourceMappingURL=context.test.js.map

package/dist/runtime/query/__tests__/context.test.js.map

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

package/dist/runtime/query/context-cache.d.ts

@@ -1,12 +1,12 @@
 import type { AgentContextLevel } from '../../types/agent/factory.js';
-import type { ThreadId } from '../../types/ids/index.js';
 import type { AgentPersona } from '../../types/persona/index.js';
+import type { ProjectId } from '../../types/session/ids.js';
 import type { Skill } from '../../types/skills/index.js';
 import type { ToolRegistryContract } from '../../types/tool/index.js';
 import { type PromptSegments } from './prompt.js';
 export interface ContextCacheConfig {
     agentId: string;
-    threadId: ThreadId;
+    projectId: ProjectId;
 }
 export interface PromptCacheInput {
     systemPrompt?: string;
@@ -17,7 +17,7 @@ export interface PromptCacheInput {
     allowedTools?: string[];
 }
 export declare class ContextCache {
-    readonly threadId: ThreadId;
+    readonly projectId: ProjectId;
     readonly agentId: string;
     private cachedPrompt;
     private cachedConfigHash;

package/dist/runtime/query/context-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-cache.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/context-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,qBAAa,YAAY;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,gBAAgB,CAAoB;gBAEhC,MAAM,EAAE,kBAAkB;IAKtC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAqBhD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAK9C,wBAAwB,CACvB,KAAK,EAAE,gBAAgB,EACvB,YAAY,GAAE,iBAA0B,EACxC,gBAAgB,CAAC,EAAE,MAAM,GACvB,cAAc;IA2BjB,UAAU,IAAI,IAAI;IAOlB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,iBAAiB;CAazB"}
+{"version":3,"file":"context-cache.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/context-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,qBAAa,YAAY;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,gBAAgB,CAAoB;gBAEhC,MAAM,EAAE,kBAAkB;IAKtC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAqBhD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAK9C,wBAAwB,CACvB,KAAK,EAAE,gBAAgB,EACvB,YAAY,GAAE,iBAA0B,EACxC,gBAAgB,CAAC,EAAE,MAAM,GACvB,cAAc;IA2BjB,UAAU,IAAI,IAAI;IAOlB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,iBAAiB;CAazB"}

package/dist/runtime/query/context-cache.js

@@ -1,14 +1,14 @@
 import { createHash } from 'node:crypto';
 import { PromptBuilder } from './prompt.js';
 export class ContextCache {
-    threadId;
+    projectId;
     agentId;
     cachedPrompt;
     cachedConfigHash;
     cachedStaticSegment;
     cachedStaticHash;
     constructor(config) {
-        this.threadId = config.threadId;
+        this.projectId = config.projectId;
         this.agentId = config.agentId;
     }
     getSystemPrompt(input) {

package/dist/runtime/query/context-cache.js.map

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

package/dist/runtime/query/context.d.ts

@@ -1,14 +1,33 @@
 import { PlanManager } from '../../manager/plan/lifecycle.js';
 import { RunPersistence } from '../../manager/run/persistence.js';
+import { type FilesystemMigrationResult, type FilesystemMigrationSink, type FilesystemMigrator } from '../../session/migration/index.js';
+import { type PathBuilder } from '../../session/workspace/path-builder.js';
 import { ActivityStore } from '../../store/activity/memory.js';
 import { type ActivityTrackingConfig } from '../../types/activity/index.js';
-import type { RunId, ThreadId } from '../../types/ids/index.js';
+import type { RunId, SessionId, TenantId } from '../../types/ids/index.js';
 import type { Message } from '../../types/message/index.js';
 import type { PermissionMode } from '../../types/permission/index.js';
 import type { LLMProvider } from '../../types/provider/index.js';
 import type { AgentRunConfig } from '../../types/run/index.js';
+import type { ProjectId, ThreadId } from '../../types/session/ids.js';
 import type { ModelPricing } from '../../utils/cost.js';
 import { type Logger } from '../../utils/logger.js';
+/**
+ * Config accepted by {@link RunContextFactory.build}. `sessionId`,
+ * `threadId`, `projectId`, and `tenantId` are required — runs carry the full
+ * five-layer scope (Tenant → Project → Thread → Session → Run) per
+ * Convention #17.
+ *
+ * `pathBuilder` is optional; when absent a {@link DefaultPathBuilder} is
+ * constructed against `{workingDirectory}/.namzu`.
+ *
+ * `filesystemMigrator` + `migrationSink` are optional; when absent a
+ * {@link DefaultFilesystemMigrator} wired to the
+ * {@link NOOP_FILESYSTEM_MIGRATION_SINK} is used. Migration runs once per
+ * process via {@link RunContextFactory.ensureMigrated}; the static `build`
+ * method stays synchronous so existing call sites are not broken — async
+ * callers (e.g. `query()`) invoke `ensureMigrated` themselves before build.
+ */
 export interface RunContextConfig {
     agentId: string;
     agentName: string;
@@ -19,14 +38,30 @@ export interface RunContextConfig {
     enableActivityTracking?: boolean;
     messages: Message[];
     signal?: AbortSignal;
+    sessionId: SessionId;
     threadId: ThreadId;
+    projectId: ProjectId;
+    tenantId: TenantId;
+    pathBuilder?: PathBuilder;
+    /**
+     * Optional injected migrator — tests pass a stub; production code relies
+     * on the {@link DefaultFilesystemMigrator}. See session-hierarchy.md
+     * §13.4.1.
+     */
+    filesystemMigrator?: FilesystemMigrator;
+    /** Optional sink for `filesystem.migrated` events. Defaults to no-op. */
+    migrationSink?: FilesystemMigrationSink;
     runId?: RunId;
     parentRunId?: RunId;
     depth?: number;
 }
+/** Result of {@link RunContextFactory.build}. */
 export interface RunContext {
     runId: RunId;
+    sessionId: SessionId;
     threadId: ThreadId;
+    projectId: ProjectId;
+    tenantId: TenantId;
     runMgr: RunPersistence;
     activityStore: ActivityStore;
     planManager: PlanManager;
@@ -37,7 +72,16 @@ export interface RunContext {
     log: Logger;
     trackingConfig: ActivityTrackingConfig;
 }
+/** Testing hook — clears the first-call guard cache. */
+export declare function __resetMigrationGuardForTests(): void;
 export declare class RunContextFactory {
+    /**
+     * Run the boot-time filesystem migration for `rootDir` at most once per
+     * process. Safe to `await` from any async entry point; concurrent callers
+     * for the same root share a single migration promise (no duplicate work,
+     * no race with the on-disk `.tmp` lock).
+     */
+    static ensureMigrated(rootDir: string, migrator?: FilesystemMigrator): Promise<FilesystemMigrationResult>;
     static build(config: RunContextConfig): RunContext;
 }
 //# sourceMappingURL=context.d.ts.map

package/dist/runtime/query/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,KAAK,sBAAsB,EAA2B,MAAM,+BAA+B,CAAA;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,cAAc,CAAA;IACzB,QAAQ,EAAE,WAAW,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB,QAAQ,EAAE,QAAQ,CAAA;IAElB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,eAAe,EAAE,eAAe,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,cAAc,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,sBAAsB,CAAA;CACtC;AAED,qBAAa,iBAAiB;IAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;CAsDlD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAEN,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EAEvB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,yCAAyC,CAAA;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,KAAK,sBAAsB,EAA2B,MAAM,+BAA+B,CAAA;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAElE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,cAAc,CAAA;IACzB,QAAQ,EAAE,WAAW,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAElB,WAAW,CAAC,EAAE,WAAW,CAAA;IAEzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IAEvC,yEAAyE;IACzE,aAAa,CAAC,EAAE,uBAAuB,CAAA;IAEvC,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,eAAe,EAAE,eAAe,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,cAAc,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,sBAAsB,CAAA;CACtC;AAWD,wDAAwD;AACxD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,qBAAa,iBAAiB;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,kBAAkF,GAC1F,OAAO,CAAC,yBAAyB,CAAC;IAcrC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;CA8DlD"}

package/dist/runtime/query/context.js

@@ -1,11 +1,45 @@
 import { join } from 'node:path';
 import { PlanManager } from '../../manager/plan/lifecycle.js';
 import { RunPersistence } from '../../manager/run/persistence.js';
+import { DefaultFilesystemMigrator, NOOP_FILESYSTEM_MIGRATION_SINK, } from '../../session/migration/index.js';
+import { DefaultPathBuilder } from '../../session/workspace/path-builder.js';
 import { ActivityStore } from '../../store/activity/memory.js';
 import { resolveActivityTracking } from '../../types/activity/index.js';
 import { generateRunId } from '../../utils/id.js';
 import { getRootLogger } from '../../utils/logger.js';
+/**
+ * Module-level first-call guard for the boot-time filesystem migration
+ * (session-hierarchy.md §13.4.1). Keyed on the root directory so a single
+ * process that spans multiple `.namzu` roots (unusual but legal) migrates
+ * each one once. Subsequent calls short-circuit via the cached promise —
+ * never re-reading the on-disk marker per call.
+ */
+const migrationPromises = new Map();
+/** Testing hook — clears the first-call guard cache. */
+export function __resetMigrationGuardForTests() {
+    migrationPromises.clear();
+}
 export class RunContextFactory {
+    /**
+     * Run the boot-time filesystem migration for `rootDir` at most once per
+     * process. Safe to `await` from any async entry point; concurrent callers
+     * for the same root share a single migration promise (no duplicate work,
+     * no race with the on-disk `.tmp` lock).
+     */
+    static ensureMigrated(rootDir, migrator = new DefaultFilesystemMigrator(NOOP_FILESYSTEM_MIGRATION_SINK)) {
+        const cached = migrationPromises.get(rootDir);
+        if (cached)
+            return cached;
+        const promise = migrator.migrate(rootDir);
+        migrationPromises.set(rootDir, promise);
+        // Crash-safety: if the migration rejects, drop the cached promise so
+        // the next caller gets a fresh attempt. Successful results stay cached
+        // (idempotency — further calls short-circuit without re-running).
+        promise.catch(() => {
+            migrationPromises.delete(rootDir);
+        });
+        return promise;
+    }
     static build(config) {
         const abortController = new AbortController();
         if (config.signal) {
@@ -14,16 +48,17 @@ export class RunContextFactory {
         const cwd = config.workingDirectory ?? process.cwd();
         const permissionMode = config.runConfig.permissionMode ?? 'auto';
         const runId = config.runId ?? generateRunId();
-        if (!config.threadId) {
-            throw new Error('threadId is required for run persistence — all runs must belong to a thread');
-        }
-        const threadId = config.threadId;
-        const outputDir = join(cwd, '.namzu', 'threads', threadId, 'runs');
+        const pathBuilder = config.pathBuilder ?? new DefaultPathBuilder(join(cwd, '.namzu'));
+        const outputDir = pathBuilder.sessionDir(config.projectId, config.sessionId);
+        const runsDir = join(outputDir, 'runs');
         const log = getRootLogger().child({
             component: 'query',
             agent: config.agentName,
             runId,
-            threadId,
+            sessionId: config.sessionId,
+            threadId: config.threadId,
+            projectId: config.projectId,
+            tenantId: config.tenantId,
         });
         const runMgr = new RunPersistence({
             runId,
@@ -31,9 +66,13 @@ export class RunContextFactory {
             agentName: config.agentName,
             runConfig: config.runConfig,
             providerId: config.provider.id,
-            outputDir,
+            outputDir: runsDir,
             pricing: config.pricing,
             log,
+            sessionId: config.sessionId,
+            threadId: config.threadId,
+            tenantId: config.tenantId,
+            projectId: config.projectId,
             parentRunId: config.parentRunId,
             depth: config.depth,
         });
@@ -42,7 +81,10 @@ export class RunContextFactory {
         const planManager = new PlanManager(runId);
         return {
             runId,
-            threadId,
+            sessionId: config.sessionId,
+            threadId: config.threadId,
+            projectId: config.projectId,
+            tenantId: config.tenantId,
             runMgr,
             activityStore,
             planManager,

package/dist/runtime/query/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/runtime/query/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAA+B,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAOpG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAe,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAoClE,MAAM,OAAO,iBAAiB;IAC7B,MAAM,CAAC,KAAK,CAAC,MAAwB;QACpC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACvF,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;QACpD,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,IAAI,MAAM,CAAA;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,EAAE,CAAA;QAE7C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;QAC/F,CAAC;QACD,MAAM,QAAQ,GAAa,MAAM,CAAC,QAAQ,CAAA;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAElE,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC,KAAK,CAAC;YACjC,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,MAAM,CAAC,SAAS;YACvB,KAAK;YACL,QAAQ;SACR,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YACjC,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC9B,SAAS;YACT,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG;YACH,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;SACnB,CAAC,CAAA;QAEF,MAAM,cAAc,GAAG,uBAAuB,CAAC,cAAc,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAA;QAC7F,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;QAC9D,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;QAE1C,OAAO;YACN,KAAK;YACL,QAAQ;YACR,MAAM;YACN,aAAa;YACb,WAAW;YACX,eAAe;YACf,GAAG;YACH,SAAS;YACT,cAAc;YACd,GAAG;YACH,cAAc;SACd,CAAA;IACF,CAAC;CACD"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/runtime/query/context.ts"],"names":[],"mappings":"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"}

package/dist/runtime/query/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1D,qBAAa,eAAe;IAC3B,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAIlC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAG3B;IAED,YAAY,IAAI,SAAS,CAAC,QAAQ,CAAC;IAQpC,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAwBnE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,IAAI;IAoC7D,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;CAoD7D"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErE,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE1D,qBAAa,eAAe;IAC3B,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAIlC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAG3B;IAED,YAAY,IAAI,SAAS,CAAC,QAAQ,CAAC;IAQpC,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAwBnE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,IAAI;IAwC7D,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;CAwD7D"}

package/dist/runtime/query/events.js

@@ -67,6 +67,10 @@ export class EventTranslator {
                     });
                     break;
                 default: {
+                    // `TaskEvent.type` is scoped to task-store events; sub-session
+                    // lifecycle events (subsession_spawned / _messaged / _idled) and
+                    // run-scoped `RunEvent` variants never reach this wrapper. The
+                    // exhaustiveness guard below enforces that at compile time.
                     const _exhaustive = event.type;
                     throw new Error(`Unhandled task event type: ${_exhaustive}`);
                 }
@@ -120,6 +124,10 @@ export class EventTranslator {
                 case 'plan.failed':
                     break;
                 default: {
+                    // `PlanEvent.type` is scoped to plan-manager events; sub-session
+                    // lifecycle events and other `RunEvent` variants never reach this
+                    // wrapper. The exhaustiveness guard below enforces that at compile
+                    // time.
                     const _exhaustive = event.type;
                     throw new Error(`Unhandled plan event type: ${_exhaustive}`);
                 }

package/dist/runtime/query/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/runtime/query/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/runtime/query/events.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,eAAe;IACnB,aAAa,GAAe,EAAE,CAAA;IAC9B,MAAM,CAAgB;IAE9B,YAAY,MAAsB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;IAEQ,SAAS,GAAc,KAAK,EAAE,KAAe,EAAiB,EAAE;QACxE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACnD,CAAC,CAAC;IAEF,CAAC,YAAY;QACZ,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;QACtC,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAA;YACX,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;QACnC,CAAC;IACF,CAAC;IAED,iBAAiB,CAAC,aAA4B,EAAE,KAAY;QAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAoB,EAAE,EAAE;YAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACvC,MAAM,IAAI,CAAC,SAAS,CAAC;oBACpB,IAAI,EAAE,kBAAkB;oBACxB,KAAK;oBACL,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,YAAY,EAAE,QAAQ,CAAC,IAAI;oBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;iBACjC,CAAC,CAAA;YACH,CAAC;iBAAM,CAAC;gBACP,MAAM,IAAI,CAAC,SAAS,CAAC;oBACpB,IAAI,EAAE,kBAAkB;oBACxB,KAAK;oBACL,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACrB,CAAC,CAAA;YACH,CAAC;QACF,CAAC,CAAC,CAAA;IACH,CAAC;IAED,aAAa,CAAC,SAAoB,EAAE,KAAY;QAC/C,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAgB,EAAE,EAAE;YAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;YAEvB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAM;YAChC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,cAAc;oBAClB,MAAM,IAAI,CAAC,SAAS,CAAC;wBACpB,IAAI,EAAE,cAAc;wBACpB,KAAK;wBACL,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;qBACnB,CAAC,CAAA;oBACF,MAAK;gBACN,KAAK,cAAc,CAAC;gBACpB,KAAK,cAAc,CAAC;gBACpB,KAAK,cAAc;oBAClB,MAAM,IAAI,CAAC,SAAS,CAAC;wBACpB,IAAI,EAAE,cAAc;wBACpB,KAAK;wBACL,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;qBACjB,CAAC,CAAA;oBACF,MAAK;gBACN,OAAO,CAAC,CAAC,CAAC;oBACT,+DAA+D;oBAC/D,iEAAiE;oBACjE,+DAA+D;oBAC/D,4DAA4D;oBAC5D,MAAM,WAAW,GAAU,KAAK,CAAC,IAAI,CAAA;oBACrC,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAA;gBAC7D,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAA;QACF,OAAO,WAAW,CAAA;IACnB,CAAC;IAED,eAAe,CAAC,WAAwB,EAAE,KAAY;QACrD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAgB,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;YACvB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,YAAY;oBAChB,MAAM,IAAI,CAAC,SAAS,CAAC;wBACpB,IAAI,EAAE,YAAY;wBAClB,KAAK;wBACL,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;qBACrB,CAAC,CAAA;oBACF,MAAK;gBACN,KAAK,eAAe;oBACnB,MAAM,IAAI,CAAC,SAAS,CAAC;wBACpB,IAAI,EAAE,eAAe;wBACrB,KAAK;wBACL,MAAM,EAAE,IAAI,CAAC,EAAE;qBACf,CAAC,CAAA;oBACF,MAAK;gBACN,KAAK,eAAe;oBACnB,MAAM,IAAI,CAAC,SAAS,CAAC;wBACpB,IAAI,EAAE,eAAe;wBACrB,KAAK;wBACL,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,MAAM,EAAE,IAAI,CAAC,eAAe;qBAC5B,CAAC,CAAA;oBACF,MAAK;gBACN,KAAK,mBAAmB;oBACvB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBAChB,MAAM,IAAI,CAAC,SAAS,CAAC;4BACpB,IAAI,EAAE,mBAAmB;4BACzB,KAAK;4BACL,MAAM,EAAE,IAAI,CAAC,EAAE;4BACf,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;4BACrB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;yBACzB,CAAC,CAAA;oBACH,CAAC;oBACD,MAAK;gBACN,KAAK,iBAAiB,CAAC;gBACvB,KAAK,gBAAgB,CAAC;gBACtB,KAAK,gBAAgB,CAAC;gBACtB,KAAK,aAAa;oBACjB,MAAK;gBACN,OAAO,CAAC,CAAC,CAAC;oBACT,iEAAiE;oBACjE,kEAAkE;oBAClE,mEAAmE;oBACnE,QAAQ;oBACR,MAAM,WAAW,GAAU,KAAK,CAAC,IAAI,CAAA;oBACrC,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAA;gBAC7D,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAA;IACH,CAAC;CACD"}

package/dist/runtime/query/index.d.ts

@@ -1,9 +1,10 @@
 import type { CompactionConfig } from '../../config/runtime.js';
+import type { PathBuilder } from '../../session/workspace/path-builder.js';
 import type { AdvisoryConfig } from '../../types/advisory/index.js';
 import type { RuntimeToolOverrides } from '../../types/agent/base.js';
 import type { AgentContextLevel } from '../../types/agent/factory.js';
 import { type CheckpointId, type ResumeHandler } from '../../types/hitl/index.js';
-import type { RunId, ThreadId } from '../../types/ids/index.js';
+import type { RunId, SessionId, TenantId } from '../../types/ids/index.js';
 import type { InvocationState } from '../../types/invocation/index.js';
 import { type Message } from '../../types/message/index.js';
 import type { AgentPersona } from '../../types/persona/index.js';
@@ -11,6 +12,7 @@ import type { LLMProvider } from '../../types/provider/index.js';
 import type { TaskRouterConfig } from '../../types/router/index.js';
 import type { AgentRun, AgentRunConfig, RunEvent, RunEventListener } from '../../types/run/index.js';
 import type { SandboxProvider } from '../../types/sandbox/index.js';
+import type { ProjectId, ThreadId } from '../../types/session/ids.js';
 import type { Skill } from '../../types/skills/index.js';
 import type { TaskStore } from '../../types/task/index.js';
 import type { ToolRegistryContract } from '../../types/tool/index.js';
@@ -35,7 +37,26 @@ export interface QueryParams {
     signal?: AbortSignal;
     resumeHandler: ResumeHandler;
     resumeFromCheckpoint?: CheckpointId;
+    /** Session scope for the run. Required — every run is attributed to a Session. */
+    sessionId: SessionId;
+    /**
+     * Topic the Session lives under. Required in 0.3.0 — every run carries
+     * the full five-layer scope (Tenant → Project → Thread → Session →
+     * Run). Denormalized from `session.threadId`; callers build this
+     * alongside `sessionId` so the query pipeline never needs a second
+     * SessionStore round-trip to recover it.
+     */
     threadId: ThreadId;
+    /** Long-lived goal scope for the run. Required. */
+    projectId: ProjectId;
+    /** Isolation boundary (Convention #17). Required. */
+    tenantId: TenantId;
+    /**
+     * Optional path layout override. Defaults to a {@link DefaultPathBuilder}
+     * rooted at `{workingDirectory}/.namzu`. First-call filesystem migration
+     * runs on this same entry point.
+     */
+    pathBuilder?: PathBuilder;
     runId?: RunId;
     parentRunId?: RunId;
     depth?: number;

package/dist/runtime/query/index.d.ts.map

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

package/dist/runtime/query/index.js

@@ -19,6 +19,13 @@ import { PromptBuilder } from './prompt.js';
 import { ResultAssembler } from './result.js';
 import { ToolingBootstrap } from './tooling.js';
 export async function* query(params) {
+    // Boot-time filesystem migration (session-hierarchy.md §13.4.1). First
+    // call per process per root actually runs; subsequent calls short-circuit
+    // via the in-memory guard in `context.ts`. Kept here rather than inside
+    // the synchronous `RunContextFactory.build` so the factory signature stays
+    // sync for tests / non-async call sites.
+    const cwdForMigration = params.workingDirectory ?? process.cwd();
+    await RunContextFactory.ensureMigrated(`${cwdForMigration}/.namzu`);
     const ctx = RunContextFactory.build({
         agentId: params.agentId,
         agentName: params.agentName,
@@ -29,7 +36,11 @@ export async function* query(params) {
         enableActivityTracking: params.enableActivityTracking,
         messages: params.messages,
         signal: params.signal,
+        sessionId: params.sessionId,
         threadId: params.threadId,
+        projectId: params.projectId,
+        tenantId: params.tenantId,
+        pathBuilder: params.pathBuilder,
         runId: params.runId,
         parentRunId: params.parentRunId,
         depth: params.depth,