@namzu/sdk 43.0.0 → 44.1.0

package/dist/runtime/query/resume-run.js

@@ -1,105 +0,0 @@
-import { NamzuError } from '../../types/errors/index.js';
-import { drainQueryWithSelectedResumeState } from './index.js';
-import { loadSelectedRunState } from './run-state.js';
-/**
- * Continue a run that a different process started.
- *
- * Everything this needs already existed — `CheckpointManager` writes the
- * history, budgets, working state, trace context and any park;
- * `loadRunState` reads them back; `query` accepts `runId` +
- * `resumeFromCheckpoint` and restores all of it. What was missing was the
- * few lines that join them, so every host wrote their own — and in this
- * repo nothing outside the SDK ever did, which means the whole path shipped
- * untravelled.
- *
- * The division of labour is the one the mechanism already implies: the
- * CALLER brings what cannot be serialized — the provider client, the tool
- * registry, the sandbox, the working directory — and the STORE brings the
- * state. A snapshot deliberately holds no socket, no client and no open
- * file, so it could never have carried the first half.
- *
- * Refusing beats guessing at both failure points. A missing checkpoint does
- * not silently become a fresh run under a recycled id, and a park is not
- * resumed past without the answer it is waiting for.
- */
-export async function resumeRun(params) {
-    const { scope, checkpointStore, checkpointId, pendingDecision, claimFence, listener, onEventReplay, ...rest } = params;
-    const selected = await loadSelectedRunState(checkpointStore, scope, checkpointId);
-    const state = selected?.state;
-    if (!state?.checkpointId || !selected)
-        return { resumed: false, reason: 'no-checkpoint' };
-    assertResumeRequestAttribution(params, state);
-    // A park is outstanding until it is answered. `resolvedAt` is what marks
-    // an answered one, so a checkpoint that carries a resolved decision is an
-    // ordinary resume, not a question waiting on anybody.
-    const outstanding = state.pending && !state.pending.resolvedAt ? state.pending : undefined;
-    if (outstanding && !pendingDecision) {
-        return {
-            resumed: false,
-            reason: 'awaiting-decision',
-            pending: outstanding,
-            state,
-        };
-    }
-    let replay;
-    const run = await drainQueryWithSelectedResumeState({
-        ...rest,
-        messages: [],
-        runId: state.runId,
-        sessionId: state.sessionId,
-        topicId: state.topicId,
-        projectId: state.projectId,
-        tenantId: state.tenantId,
-        // Forwarded, and it is not cosmetic: the run store nests a sub-run's
-        // evidence under `<parent>/children/<run>`, so resuming a sub-run
-        // without this binds `<base>/<run>` instead — a second, empty
-        // transcript under a run id that already has one, a sequence that
-        // restarts at 1, and a catch-up that reports a live run as having
-        // produced nothing.
-        ...(state.parentRunId !== undefined ? { parentRunId: state.parentRunId } : {}),
-        resumeFromCheckpoint: state.checkpointId,
-        checkpointStore,
-        ...(claimFence !== undefined ? { claimFence } : {}),
-        ...(pendingDecision ? { pendingDecision } : {}),
-        onEventReplay: (verdict) => {
-            replay = verdict;
-            return onEventReplay?.(verdict);
-        },
-    }, {
-        ...state,
-        checkpointId: state.checkpointId,
-        ...(selected.checkpoint.traceContext
-            ? { traceContext: selected.checkpoint.traceContext }
-            : {}),
-    }, listener);
-    return {
-        resumed: true,
-        run,
-        state,
-        ...(replay !== undefined ? { replay } : {}),
-    };
-}
-function assertResumeRequestAttribution(params, state) {
-    const mismatchedFields = [];
-    if (params.scope.runId !== state.runId)
-        mismatchedFields.push('runId');
-    if (params.sessionId !== state.sessionId)
-        mismatchedFields.push('sessionId');
-    if (params.topicId !== state.topicId)
-        mismatchedFields.push('topicId');
-    if (params.projectId !== state.projectId)
-        mismatchedFields.push('projectId');
-    if (params.tenantId !== state.tenantId)
-        mismatchedFields.push('tenantId');
-    if (params.parentRunId !== undefined && params.parentRunId !== state.parentRunId) {
-        mismatchedFields.push('parentRunId');
-    }
-    if (mismatchedFields.length === 0)
-        return;
-    throw new NamzuError({
-        code: 'invalid_config',
-        message: 'The resume request attribution does not match the checkpoint scope selected for this run.',
-        details: { fields: mismatchedFields },
-    });
-}
-//# sourceMappingURL=resume-run.js.map

package/dist/runtime/query/resume-run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume-run.js","sourceRoot":"","sources":["../../../src/runtime/query/resume-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAOxD,OAAO,EAAoB,iCAAiC,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,EAAsB,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AA+EzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAuB;IACtD,MAAM,EACL,KAAK,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,EACV,QAAQ,EACR,aAAa,EACb,GAAG,IAAI,EACP,GAAG,MAAM,CAAA;IAEV,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,eAAe,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;IACjF,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAA;IAC7B,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;IACzF,8BAA8B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAE7C,yEAAyE;IACzE,0EAA0E;IAC1E,sDAAsD;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1F,IAAI,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;QACrC,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EAAE,WAAW;YACpB,KAAK;SACL,CAAA;IACF,CAAC;IAED,IAAI,MAAkC,CAAA;IAEtC,MAAM,GAAG,GAAG,MAAM,iCAAiC,CAClD;QACC,GAAG,IAAI;QACP,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,qEAAqE;QACrE,kEAAkE;QAClE,8DAA8D;QAC9D,kEAAkE;QAClE,kEAAkE;QAClE,oBAAoB;QACpB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,oBAAoB,EAAE,KAAK,CAAC,YAAY;QACxC,eAAe;QACf,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,aAAa,EAAE,CAAC,OAAuB,EAAE,EAAE;YAC1C,MAAM,GAAG,OAAO,CAAA;YAChB,OAAO,aAAa,EAAE,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;KACc,EAChB;QACC,GAAG,KAAK;QACR,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY;YACnC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;KACN,EACD,QAAQ,CACR,CAAA;IAED,OAAO;QACN,OAAO,EAAE,IAAI;QACb,GAAG;QACH,KAAK;QACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAA;AACF,CAAC;AAED,SAAS,8BAA8B,CAAC,MAAuB,EAAE,KAAe;IAC/E,MAAM,gBAAgB,GAAa,EAAE,CAAA;IACrC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAAE,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAAE,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC5E,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAAE,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC5E,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAAE,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzE,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;QAClF,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACrC,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEzC,MAAM,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EACN,2FAA2F;QAC5F,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE;KACrC,CAAC,CAAA;AACH,CAAC"}

package/dist/runtime/query/run-state.d.ts

@@ -1,57 +0,0 @@
-import type { RunPersistence } from '../../manager/run/persistence.js';
-import type { CheckpointId, IterationCheckpoint } from '../../types/hitl/index.js';
-import type { CheckpointRunScope, CheckpointStore } from '../../types/run/checkpoint-store.js';
-import { type RunState } from '../../types/run/state.js';
-import type { TopicId } from '../../types/session/ids.js';
-/**
- * A {@link CheckpointRunScope} plus the one attribution field checkpoints
- * do not record.
- *
- * `topicId` is denormalized onto a run at `query()` time and never written
- * into a checkpoint, so a snapshot rebuilt from the store alone cannot
- * derive it. Requiring the caller to supply it is better than inventing one
- * or widening `RunState` to make it optional: the field is required by
- * `query()` on the way back in, so an absent value would only fail later
- * and less clearly.
- */
-export interface RunStateScope extends CheckpointRunScope {
-    topicId: TopicId;
-}
-/**
- * Build a JSON-safe snapshot of a live run.
- *
- * Every field is copied, not referenced: the caller is about to serialize
- * this, and a snapshot that aliased the run's own message array would keep
- * mutating after it was taken.
- */
-export declare function captureRunState(runMgr: RunPersistence, scope: RunStateScope, extra?: {
-    elapsedMs?: number;
-    checkpoint?: IterationCheckpoint | null;
-}): RunState;
-/**
- * Rebuild a run's snapshot from durable state alone, with no live run
- * object — the read a DIFFERENT process performs.
- *
- * With no `checkpointId` this prefers the run's outstanding park over its
- * newest checkpoint, because "what is this run waiting on" is the question
- * a resuming process is actually asking; it falls back to the newest
- * checkpoint when nothing is parked.
- *
- * Returns `null` when the run has no checkpoints. That is the honest
- * answer: a run that never checkpointed left nothing to resume from, and
- * synthesizing a snapshot from an empty store would produce a run that
- * restarts from zero while claiming to be a continuation.
- *
- * `status`/`stopReason` are absent from a checkpoint by construction — a
- * checkpoint is written mid-flight — so a rebuilt snapshot always reports
- * `running`, and the host's own record remains the authority on a run that
- * already finished. Read `pending` to tell a parked run from a live one:
- * it is outstanding when set with no `resolvedAt`.
- */
-export declare function loadRunState(store: CheckpointStore, scope: RunStateScope, checkpointId?: CheckpointId): Promise<RunState | null>;
-/** @internal The exact checkpoint selected together with its public run-state projection. */
-export declare function loadSelectedRunState(store: CheckpointStore, scope: RunStateScope, checkpointId?: CheckpointId): Promise<{
-    readonly state: RunState;
-    readonly checkpoint: IterationCheckpoint;
-} | null>;
-//# sourceMappingURL=run-state.d.ts.map

package/dist/runtime/query/run-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/run-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC9F,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGzD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACxD,OAAO,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;CACvC,GACC,QAAQ,CA6BV;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,aAAa,EACpB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAE1B;AAED,6FAA6F;AAC7F,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,aAAa,EACpB,YAAY,CAAC,EAAE,YAAY,GACzB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAAC,CA6BxF"}

package/dist/runtime/query/run-state.js

@@ -1,96 +0,0 @@
-import { RUN_STATE_VERSION } from '../../types/run/state.js';
-import { findPendingCheckpoint } from './checkpoint.js';
-/**
- * Build a JSON-safe snapshot of a live run.
- *
- * Every field is copied, not referenced: the caller is about to serialize
- * this, and a snapshot that aliased the run's own message array would keep
- * mutating after it was taken.
- */
-export function captureRunState(runMgr, scope, extra) {
-    const session = runMgr.getSession();
-    const startedAt = session.startedAt;
-    return {
-        version: RUN_STATE_VERSION,
-        runId: runMgr.id,
-        sessionId: scope.sessionId,
-        topicId: scope.topicId,
-        projectId: scope.projectId,
-        tenantId: scope.tenantId,
-        ...(scope.parentRunId ? { parentRunId: scope.parentRunId } : {}),
-        ...(session.metadata?.agentId ? { agentId: session.metadata.agentId } : {}),
-        ...(session.metadata?.agentName ? { agentName: session.metadata.agentName } : {}),
-        status: runMgr.status,
-        ...(runMgr.stopReason ? { stopReason: runMgr.stopReason } : {}),
-        ...(session.lastError ? { lastError: session.lastError } : {}),
-        messages: structuredClone(runMgr.messages),
-        tokenUsage: { ...runMgr.tokenUsage },
-        budgetBinding: runMgr.budget?.binding,
-        budgetAccountId: runMgr.budget?.accountId,
-        costInfo: { ...runMgr.costInfo },
-        currentIteration: runMgr.currentIteration,
-        startedAt,
-        elapsedMs: extra?.elapsedMs ?? Date.now() - startedAt,
-        ...(extra?.checkpoint ? { checkpointId: extra.checkpoint.id } : {}),
-        ...(extra?.checkpoint?.pending ? { pending: extra.checkpoint.pending } : {}),
-        capturedAt: Date.now(),
-    };
-}
-/**
- * Rebuild a run's snapshot from durable state alone, with no live run
- * object — the read a DIFFERENT process performs.
- *
- * With no `checkpointId` this prefers the run's outstanding park over its
- * newest checkpoint, because "what is this run waiting on" is the question
- * a resuming process is actually asking; it falls back to the newest
- * checkpoint when nothing is parked.
- *
- * Returns `null` when the run has no checkpoints. That is the honest
- * answer: a run that never checkpointed left nothing to resume from, and
- * synthesizing a snapshot from an empty store would produce a run that
- * restarts from zero while claiming to be a continuation.
- *
- * `status`/`stopReason` are absent from a checkpoint by construction — a
- * checkpoint is written mid-flight — so a rebuilt snapshot always reports
- * `running`, and the host's own record remains the authority on a run that
- * already finished. Read `pending` to tell a parked run from a live one:
- * it is outstanding when set with no `resolvedAt`.
- */
-export async function loadRunState(store, scope, checkpointId) {
-    return (await loadSelectedRunState(store, scope, checkpointId))?.state ?? null;
-}
-/** @internal The exact checkpoint selected together with its public run-state projection. */
-export async function loadSelectedRunState(store, scope, checkpointId) {
-    const checkpoint = checkpointId
-        ? await store.readCheckpoint(scope, checkpointId)
-        : ((await findPendingCheckpoint(store, scope)) ?? (await newest(store, scope)));
-    if (!checkpoint)
-        return null;
-    const state = {
-        version: RUN_STATE_VERSION,
-        runId: checkpoint.runId,
-        sessionId: scope.sessionId,
-        topicId: scope.topicId,
-        projectId: scope.projectId,
-        tenantId: scope.tenantId,
-        ...(scope.parentRunId ? { parentRunId: scope.parentRunId } : {}),
-        status: 'running',
-        messages: checkpoint.messages,
-        tokenUsage: checkpoint.tokenUsage,
-        budgetBinding: checkpoint.budgetBinding,
-        budgetAccountId: checkpoint.budgetAccountId,
-        costInfo: checkpoint.costInfo,
-        currentIteration: checkpoint.guardState.iterationCount,
-        startedAt: checkpoint.createdAt - checkpoint.guardState.elapsedMs,
-        elapsedMs: checkpoint.guardState.elapsedMs,
-        checkpointId: checkpoint.id,
-        ...(checkpoint.pending ? { pending: checkpoint.pending } : {}),
-        capturedAt: Date.now(),
-    };
-    return { state, checkpoint };
-}
-async function newest(store, scope) {
-    const all = await store.listCheckpoints(scope);
-    return all.length > 0 ? (all[all.length - 1] ?? null) : null;
-}
-//# sourceMappingURL=run-state.js.map

package/dist/runtime/query/run-state.js.map

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

package/dist/session/workspace/path-builder.d.ts

@@ -1,50 +0,0 @@
-/**
- * PathBuilder — canonical filesystem layout generator for the session
- * hierarchy.
- *
- * Replaces the hardcoded `.namzu/threads/{threadId}/runs` path at
- * `runtime/query/context.ts:60-64`. Phase 3 ships the abstraction; wiring
- * into the factory happens in Phase 6 (sub-session spawn refactor) so the
- * cutover is atomic with the new `projectId` / `sessionId` requirements
- * (Convention #0: no dual paths).
- *
- * Layout matches session-hierarchy.md §13.4 (on-disk layout after migration):
- *
- *   {rootDir}/projects/{projectId}/
- *     project.json
- *     sessions/{sessionId}/
- *       session.json
- *       messages.jsonl
- *       subsessions/{subSessionId}/
- *         subsession.json
- *       runs/{runId}/
- *         ...  (Run-pattern owned; unchanged internally)
- */
-import type { ProjectId, RunId, SessionId } from '../../types/ids/index.js';
-import type { SubSessionId } from '../../types/session/ids.js';
-/**
- * Canonical filesystem layout contract. All paths returned are absolute
- * when `root` is absolute (recommended); consumers treat them as opaque.
- */
-export interface PathBuilder {
-    rootDir(): string;
-    projectDir(projectId: ProjectId): string;
-    sessionDir(projectId: ProjectId, sessionId: SessionId): string;
-    subSessionDir(projectId: ProjectId, sessionId: SessionId, subSessionId: SubSessionId): string;
-    runDir(projectId: ProjectId, sessionId: SessionId, runId: RunId): string;
-}
-/**
- * Default implementation over `node:path.join`. The `root` constructor
- * argument is injected by the consumer (e.g. `join(cwd, '.namzu')`); no
- * process-global fallback — the kernel refuses to guess paths.
- */
-export declare class DefaultPathBuilder implements PathBuilder {
-    private readonly root;
-    constructor(root: string);
-    rootDir(): string;
-    projectDir(projectId: ProjectId): string;
-    sessionDir(projectId: ProjectId, sessionId: SessionId): string;
-    subSessionDir(projectId: ProjectId, sessionId: SessionId, subSessionId: SubSessionId): string;
-    runDir(projectId: ProjectId, sessionId: SessionId, runId: RunId): string;
-}
-//# sourceMappingURL=path-builder.d.ts.map

package/dist/session/workspace/path-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-builder.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/path-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,OAAO,IAAI,MAAM,CAAA;IACjB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAA;IACxC,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAAA;IAC9D,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAAA;IAC7F,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CACxE;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;gBAEjB,IAAI,EAAE,MAAM;IAIxB,OAAO,IAAI,MAAM;IAIjB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIxC,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM;IAI9D,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM;IAI7F,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM;CAGxE"}

package/dist/session/workspace/path-builder.js

@@ -1,51 +0,0 @@
-/**
- * PathBuilder — canonical filesystem layout generator for the session
- * hierarchy.
- *
- * Replaces the hardcoded `.namzu/threads/{threadId}/runs` path at
- * `runtime/query/context.ts:60-64`. Phase 3 ships the abstraction; wiring
- * into the factory happens in Phase 6 (sub-session spawn refactor) so the
- * cutover is atomic with the new `projectId` / `sessionId` requirements
- * (Convention #0: no dual paths).
- *
- * Layout matches session-hierarchy.md §13.4 (on-disk layout after migration):
- *
- *   {rootDir}/projects/{projectId}/
- *     project.json
- *     sessions/{sessionId}/
- *       session.json
- *       messages.jsonl
- *       subsessions/{subSessionId}/
- *         subsession.json
- *       runs/{runId}/
- *         ...  (Run-pattern owned; unchanged internally)
- */
-import { join } from 'node:path';
-import { asProjectId, asRunId, asSessionId, asSubSessionId } from '../../utils/id.js';
-/**
- * Default implementation over `node:path.join`. The `root` constructor
- * argument is injected by the consumer (e.g. `join(cwd, '.namzu')`); no
- * process-global fallback — the kernel refuses to guess paths.
- */
-export class DefaultPathBuilder {
-    root;
-    constructor(root) {
-        this.root = root;
-    }
-    rootDir() {
-        return this.root;
-    }
-    projectDir(projectId) {
-        return join(this.root, 'projects', asProjectId(projectId));
-    }
-    sessionDir(projectId, sessionId) {
-        return join(this.projectDir(projectId), 'sessions', asSessionId(sessionId));
-    }
-    subSessionDir(projectId, sessionId, subSessionId) {
-        return join(this.sessionDir(projectId, sessionId), 'subsessions', asSubSessionId(subSessionId));
-    }
-    runDir(projectId, sessionId, runId) {
-        return join(this.sessionDir(projectId, sessionId), 'runs', asRunId(runId));
-    }
-}
-//# sourceMappingURL=path-builder.js.map

package/dist/session/workspace/path-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-builder.js","sourceRoot":"","sources":["../../../src/session/workspace/path-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAcrF;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACb,IAAI,CAAQ;IAE7B,YAAY,IAAY;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;IAED,OAAO;QACN,OAAO,IAAI,CAAC,IAAI,CAAA;IACjB,CAAC;IAED,UAAU,CAAC,SAAoB;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,UAAU,CAAC,SAAoB,EAAE,SAAoB;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5E,CAAC;IAED,aAAa,CAAC,SAAoB,EAAE,SAAoB,EAAE,YAA0B;QACnF,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,aAAa,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAA;IAChG,CAAC;IAED,MAAM,CAAC,SAAoB,EAAE,SAAoB,EAAE,KAAY;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3E,CAAC;CACD"}

package/dist/session/workspace/shared-run.d.ts

@@ -1,112 +0,0 @@
-import type { SharedRunWorkspaceAgentRecord, SharedRunWorkspaceManifest, SharedRunWorkspacePlan, SharedRunWorkspaceRefs, SharedRunWorkspaceSource } from '../../types/workspace/shared-run.js';
-export interface SharedRunWorkspaceConfig {
-    /**
-     * Host-visible `_work` directory. The runtime creates and mutates files
-     * here before/while agents execute.
-     */
-    hostRoot: string;
-    /**
-     * Agent-visible `_work` directory. In container sandboxes this is usually
-     * `/mnt/user-data/outputs/_work`; in local mode it can be the same
-     * relative path agents receive in their runtime notes.
-     */
-    runtimeRoot?: string;
-    label?: string;
-    now?: Date;
-}
-export interface RegisterSharedRunPlanInput {
-    id?: string;
-    briefText: string;
-    status?: SharedRunWorkspacePlan['status'];
-}
-/**
- * A `_work` directory a run's agents share — files, a manifest, a plan and
- * per-agent records — offered to hosts and applied by none of them.
- *
- * **Nothing in this SDK calls it, and that is the design, not an omission.**
- * It was flagged as a primitive exported without a driver, which is a real
- * defect class and the reason most of this module's siblings were wired up.
- * This one is the exception, and the distinguishing question is whose decision
- * the thing encodes.
- *
- * Look at what {@link SharedRunWorkspaceConfig} asks for: `hostRoot`, where
- * the directory lives on the machine running the kernel, and `runtimeRoot`,
- * the path an agent will see — `/mnt/user-data/outputs/_work` under one
- * container layout, the same directory as `hostRoot` in a local run, a bind
- * target somewhere else entirely under a third. Those two roots are a
- * deployment shape. A kernel that picked them would be choosing a filesystem
- * layout for a host that has already chosen one, and would then have to be
- * argued back out of it — the same reason `ToolCatalogSurface` was removed
- * rather than made to work: a host's deployment surfaces are the host's to
- * name.
- *
- * So the contract here is `runtimeRoot` and the paths {@link refs} derives
- * from it. Those strings are what a host puts in a prompt and what an agent's
- * `read` and `write` calls resolve against, which makes them an interface
- * between three parties — and stable for that reason, not incidentally.
- *
- * A host wires it by calling {@link create} with both roots, passing
- * `refs()` into its agents' runtime notes, and reading the manifest back when
- * the run ends. If a future default gateway grows an opinion about where
- * `_work` belongs, this is the thing it should call rather than reimplement.
- */
-export declare class SharedRunWorkspace {
-    private readonly config;
-    readonly hostRoot: string;
-    readonly runtimeRoot: string;
-    private manifestWriteQueue;
-    private constructor();
-    static create(config: SharedRunWorkspaceConfig): Promise<SharedRunWorkspace>;
-    refs(): SharedRunWorkspaceRefs;
-    hostPath(...segments: string[]): string;
-    runtimePath(...segments: string[]): string;
-    ensure(): Promise<void>;
-    readManifest(): Promise<SharedRunWorkspaceManifest>;
-    writeManifest(update: (manifest: SharedRunWorkspaceManifest) => SharedRunWorkspaceManifest): Promise<SharedRunWorkspaceManifest>;
-    writeSourceInventory(sources: readonly SharedRunWorkspaceSource[]): Promise<string>;
-    /**
-     * Write the canonical task-context file (`_work/01_task_context.md`).
-     * This is the single place the original user request lives in full; child
-     * workers read this path instead of receiving the request inline in their
-     * prompts.
-     */
-    writeTaskContext(text: string): Promise<string>;
-    /**
-     * Write the shared coordination packet (`_work/02_shared_context.md`).
-     * This is intentionally smaller and more operational than the task context:
-     * workers read it first, then open the full task context or source inventory
-     * only when their assignment needs raw wording or source-file details.
-     */
-    writeSharedContext(text: string): Promise<string>;
-    /**
-     * Write a per-worker brief at `agents/<agentId>/<taskId>/00_brief.md`.
-     * Returns the runtime-visible path. Pair with `registerAgentWork` so the
-     * agent record and the brief sit under the same scratch directory.
-     */
-    writeAgentBrief(input: {
-        agentId: string;
-        taskId?: string;
-        briefText: string;
-    }): Promise<string>;
-    /**
-     * Append a section to an existing per-worker brief, creating the file if
-     * it doesn't yet exist. Use for follow-up turns / continue flows so the
-     * brief stays authoritative across resumes — workers re-reading the brief
-     * on every entry will see the latest assignment delta, not just the seed
-     * text from initial dispatch.
-     */
-    appendAgentBrief(input: {
-        agentId: string;
-        taskId?: string;
-        sectionText: string;
-    }): Promise<string>;
-    seedSupervisorBrief(input: RegisterSharedRunPlanInput): Promise<string>;
-    registerAgentWork(input: {
-        agentId: string;
-        taskId?: string;
-        status?: SharedRunWorkspaceAgentRecord['status'];
-    }): Promise<string>;
-    private initialManifest;
-    private nowIso;
-}
-//# sourceMappingURL=shared-run.d.ts.map

package/dist/session/workspace/shared-run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-run.d.ts","sourceRoot":"","sources":["../../../src/session/workspace/shared-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,qCAAqC,CAAA;AAE5C,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,IAAI,CAAA;CACV;AAED,MAAM,WAAW,0BAA0B;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,kBAAkB;IAKV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,OAAO,CAAC,kBAAkB,CAAmC;IAE7D,OAAO;WAKM,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWlF,IAAI,IAAI,sBAAsB;IAY9B,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAIvC,WAAW,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAKpC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IASvB,YAAY,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAMnD,aAAa,CAClB,MAAM,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,0BAA0B,GAC1E,OAAO,CAAC,0BAA0B,CAAC;IAmBhC,oBAAoB,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BzF;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrD;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOvD;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE;QAC5B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnB;;;;;;OAMG;IACG,gBAAgB,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcb,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBvE,iBAAiB,CAAC,KAAK,EAAE;QAC9B,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,6BAA6B,CAAC,QAAQ,CAAC,CAAA;KAChD,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,MAAM;CAGd"}