@namzu/sdk 43.0.0 → 44.0.0

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

@@ -1,56 +0,0 @@
-import type { Span } from '@opentelemetry/api';
-import type { WorkingStateManager } from '../../compaction/manager.js';
-import type { EmergencySaveManager } from '../../manager/run/emergency.js';
-import type { RunEvent } from '../../types/run/index.js';
-import { type PromoteMemory } from '../../types/run/memory-promotion.js';
-import type { Sandbox } from '../../types/sandbox/index.js';
-import type { AwaitedJobs } from '../jobs/awaited-jobs.js';
-import type { BackgroundJobRegistry } from '../jobs/registry.js';
-import type { RunContext } from './context.js';
-import type { EventTranslator } from './events.js';
-import type { QuestionParkBinding } from './question-park.js';
-/**
- * Everything a run borrows, handed back when it ends.
- *
- * A run attaches to process-wide things it does not own — crash handlers, a
- * shared background-job registry, a question channel a tool outlived, a task
- * store's listener, a sandbox — and every one of them has to be released on
- * the way out, including the exits a `try` never reaches. So this is the body
- * of `query()`'s `finally`: the keyword stays where it is, which is what makes
- * abandonment run this just as settlement does.
- *
- * The order is the contract, and the awaits are in it: detach the emergency
- * handlers, unsubscribe from job exits, close the wait-intent recorder, kill
- * only this run's jobs, unbind the question channel, promote what the run
- * learned, tear the sandbox down, unsubscribe from the task store, record the
- * duration under the status the run actually settled with, and end the root
- * span last.
- */
-export interface RunResources {
-    readonly ctx: RunContext;
-    readonly eventTranslator: EventTranslator;
-    readonly emergencyManager: EmergencySaveManager | undefined;
-    readonly unsubscribeJobExits: (() => void) | undefined;
-    readonly unsubscribeTaskStore: (() => void) | undefined;
-    readonly awaitedJobs: AwaitedJobs | undefined;
-    /** Jobs a host bound to its session are the host's to stop, not this run's. */
-    readonly backgroundJobs: BackgroundJobRegistry | undefined;
-    readonly backgroundJobOwner: string | undefined;
-    readonly questionParks: QuestionParkBinding;
-    readonly workingStateManager: WorkingStateManager | undefined;
-    readonly promoteMemory: PromoteMemory | undefined;
-    readonly sandbox: Sandbox | undefined;
-    readonly sandboxTeardownTimeoutMs: number;
-    readonly runStartedAt: number;
-    readonly rootSpan: Span;
-}
-/**
- * Release them, in that order.
- *
- * A generator rather than a plain async function because the sandbox teardown
- * reports `sandbox_destroyed`, and that event has to reach the host at the
- * position it always did — `yield*` from the caller's `finally` keeps it
- * exactly there.
- */
-export declare function releaseRunResources(resources: RunResources): AsyncGenerator<RunEvent, void>;
-//# sourceMappingURL=release-run.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"release-run.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/release-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAE1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,qCAAqC,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAG7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IACzC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAA;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAA;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAA;IAC7D,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAA;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,wBAAuB,mBAAmB,CACzC,SAAS,EAAE,YAAY,GACrB,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAyGhC"}

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

@@ -1,101 +0,0 @@
-import { NAMZU } from '../../constants/telemetry/index.js';
-import { recordRunDuration } from '../../telemetry/metrics.js';
-import { memoryCandidateFor } from '../../types/run/memory-promotion.js';
-import { errorAttributes } from '../../utils/log/exception.js';
-import { teardownSandbox } from './sandbox-lifecycle.js';
-/**
- * Release them, in that order.
- *
- * A generator rather than a plain async function because the sandbox teardown
- * reports `sandbox_destroyed`, and that event has to reach the host at the
- * position it always did — `yield*` from the caller's `finally` keeps it
- * exactly there.
- */
-export async function* releaseRunResources(resources) {
-    const { ctx, eventTranslator, emergencyManager, unsubscribeJobExits, unsubscribeTaskStore, awaitedJobs, backgroundJobs, backgroundJobOwner, questionParks, workingStateManager, promoteMemory, sandbox, sandboxTeardownTimeoutMs, runStartedAt, rootSpan, } = resources;
-    // Release the process's termination path as soon as this run is
-    // done with it. Leaving the handlers installed would keep a
-    // WeakRef'd, settled run as the crash target for the rest of the
-    // process's life.
-    emergencyManager?.detach();
-    // A background job outlives the tool call that started it — that
-    // is what it is for — so nothing but this stops it outliving the
-    // RUN. Scoped to this run's id: a shared registry serving several
-    // runs must not have one of them tear down another's work.
-    //
-    // Awaited, and its failure swallowed. A job that would not die is
-    // worth a log line, and is not worth retracting a run's answer.
-    unsubscribeJobExits?.();
-    // The wait-intent recorder listens on the same shared registry and
-    // leaks the same way if it is left attached.
-    awaitedJobs?.close();
-    // Only jobs bound to this run. Jobs a host bound to its session are
-    // the host's to stop, when the session ends.
-    if (backgroundJobs && (backgroundJobOwner ?? ctx.runId) === ctx.runId) {
-        try {
-            const stopped = await backgroundJobs.killOwner(ctx.runId);
-            if (stopped.length > 0) {
-                ctx.log.info('Background jobs stopped with the run', {
-                    [NAMZU.RUN_ID]: ctx.runId,
-                    'namzu.jobs.stopped': stopped.length,
-                });
-            }
-        }
-        catch (jobErr) {
-            ctx.log.error('A background job did not stop cleanly', {
-                [NAMZU.RUN_ID]: ctx.runId,
-                ...errorAttributes(jobErr),
-            });
-        }
-    }
-    // Same reasoning for the question channel: the tools outlive the
-    // run that bound them, so leaving it attached would have a later
-    // run's question written into this run's checkpoint store.
-    questionParks.unbind();
-    // Offer what the run learned to whoever decides what is worth
-    // keeping. In `finally` and awaited: a run that failed still
-    // discovered things, and a fire-and-forget write would race the
-    // process exiting on a one-shot CLI run. A throw here is
-    // swallowed — a memory that failed to form must not retract an
-    // answer that was already produced.
-    const candidate = memoryCandidateFor(ctx.runId, workingStateManager);
-    if (promoteMemory && candidate) {
-        try {
-            await promoteMemory(candidate);
-        }
-        catch (promoteErr) {
-            ctx.log.error('Memory promotion threw — the run is unaffected', {
-                [NAMZU.RUN_ID]: ctx.runId,
-                'exception.message': promoteErr instanceof Error ? promoteErr.message : String(promoteErr),
-            });
-        }
-    }
-    // --- Sandbox lifecycle: destroy after run ---
-    if (sandbox) {
-        const sandboxId = sandbox.id;
-        const teardown = await teardownSandbox(sandbox, sandboxTeardownTimeoutMs);
-        if (teardown.kind === 'destroyed') {
-            await eventTranslator.emitEvent({
-                type: 'sandbox_destroyed',
-                runId: ctx.runId,
-                sandboxId,
-            });
-            yield* eventTranslator.drainPending();
-            ctx.log.info('Sandbox destroyed', { 'namzu.sandbox.id': sandboxId });
-        }
-        else {
-            ctx.log.error('Sandbox destroy failed', {
-                'namzu.sandbox.id': sandboxId,
-                ...errorAttributes(teardown.error),
-            });
-        }
-    }
-    unsubscribeTaskStore?.();
-    // Keyed by HOW it settled, not just that it did: a run that was
-    // cancelled and a run that hit its budget have very different
-    // duration distributions, and averaging them together describes
-    // neither.
-    recordRunDuration(ctx.runMgr.getRun().status ?? 'unknown', Date.now() - runStartedAt);
-    rootSpan.end();
-}
-//# sourceMappingURL=release-run.js.map

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

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

package/dist/runtime/query/replay/list.d.ts

@@ -1,40 +0,0 @@
-import type { RunId } from '../../../types/ids/index.js';
-import type { CheckpointRunScope, CheckpointStore } from '../../../types/run/checkpoint-store.js';
-import type { CheckpointListEntry } from '../../../types/run/replay.js';
-import type { Logger } from '../../../utils/logger.js';
-export interface ListCheckpointsInput {
-    /** Directory that contains `<runId>/` for the target run. */
-    baseDir: string;
-    /** Run whose checkpoints should be listed. */
-    runId: RunId;
-    logger?: Logger;
-    /**
-     * Optional store override (host-injected, e.g. Postgres). When set,
-     * `scope` is required — a scope-keyed backend cannot be addressed by
-     * `baseDir` — and `baseDir` is ignored. Absent ⇒ the disk layout under
-     * `baseDir` is read, exactly as before.
-     */
-    checkpointStore?: CheckpointStore;
-    /** Run scope for `checkpointStore`. Required when it is set. */
-    scope?: CheckpointRunScope;
-}
-/**
- * Read-only listing of a run's checkpoints for use with {@link
- * import('./prepare.js').prepareReplayState}. Returns the public
- * {@link CheckpointListEntry} projection — just enough for a caller to
- * pick a fork point — not the full `IterationCheckpoint` payload.
- *
- * Entries are returned in the order the underlying store returns them
- * (stores sort by `createdAt` ascending). Callers that want a
- * specific order should sort client-side.
- *
- * See ses_005-deterministic-replay/design.md §3.1.
- */
-export declare function listCheckpoints(input: ListCheckpointsInput): Promise<CheckpointListEntry[]>;
-/**
- * Guard shared by the replay entry points: an injected {@link
- * CheckpointStore} is scope-keyed, so the caller must say which run —
- * across the full five-layer attribution — it is asking about.
- */
-export declare function requireScope(scope: CheckpointRunScope | undefined, caller: string): CheckpointRunScope;
-//# sourceMappingURL=list.d.ts.map

package/dist/runtime/query/replay/list.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/runtime/query/replay/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AACjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAGtD,MAAM,WAAW,oBAAoB;IACpC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,gEAAgE;IAChE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGjG;AAWD;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,MAAM,EAAE,MAAM,GACZ,kBAAkB,CAOpB"}

package/dist/runtime/query/replay/list.js

@@ -1,38 +0,0 @@
-import { RunDiskStore } from '../../../store/run/disk.js';
-import { toCheckpointListEntry } from '../checkpoint.js';
-/**
- * Read-only listing of a run's checkpoints for use with {@link
- * import('./prepare.js').prepareReplayState}. Returns the public
- * {@link CheckpointListEntry} projection — just enough for a caller to
- * pick a fork point — not the full `IterationCheckpoint` payload.
- *
- * Entries are returned in the order the underlying store returns them
- * (stores sort by `createdAt` ascending). Callers that want a
- * specific order should sort client-side.
- *
- * See ses_005-deterministic-replay/design.md §3.1.
- */
-export async function listCheckpoints(input) {
-    const checkpoints = await listRawCheckpoints(input);
-    return checkpoints.map(toCheckpointListEntry);
-}
-async function listRawCheckpoints(input) {
-    if (input.checkpointStore) {
-        return input.checkpointStore.listCheckpoints(requireScope(input.scope, 'listCheckpoints'));
-    }
-    const store = new RunDiskStore({ baseDir: input.baseDir, logger: input.logger });
-    await store.initRun(input.runId);
-    return store.listCheckpoints();
-}
-/**
- * Guard shared by the replay entry points: an injected {@link
- * CheckpointStore} is scope-keyed, so the caller must say which run —
- * across the full five-layer attribution — it is asking about.
- */
-export function requireScope(scope, caller) {
-    if (!scope) {
-        throw new Error(`${caller}: \`checkpointStore\` was provided without \`scope\` — an injected store is keyed by tenantId/projectId/sessionId/runId, not by baseDir.`);
-    }
-    return scope;
-}
-//# sourceMappingURL=list.js.map

package/dist/runtime/query/replay/list.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/runtime/query/replay/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAKzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAmBxD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAChE,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACnD,OAAO,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;AAC9C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAC3F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAChF,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,KAAK,CAAC,eAAe,EAAE,CAAA;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAqC,EACrC,MAAc;IAEd,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACd,GAAG,MAAM,0IAA0I,CACnJ,CAAA;IACF,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/runtime/query/replay/mutate.d.ts

@@ -1,17 +0,0 @@
-import { type Message } from '../../../types/message/index.js';
-import { type Mutation } from '../../../types/run/replay.js';
-/**
- * Apply an ordered list of {@link Mutation} to a checkpoint's message
- * history at the fork point, producing a new message array that the
- * resumed iteration loop consumes. Pure function; does not touch the run
- * store, does not emit events.
- *
- * Throws {@link MutationNotApplicableError} when an `injectToolResponse`
- * mutation targets a tool call id that is not pending at the fork point —
- * the error payload carries the list of ids that *are* pending so the
- * caller can recover without guessing.
- *
- * See ses_005-deterministic-replay design §3.3.
- */
-export declare function applyMutations(messages: readonly Message[], mutations: readonly Mutation[]): Message[];
-//# sourceMappingURL=mutate.d.ts.map

package/dist/runtime/query/replay/mutate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../../../../src/runtime/query/replay/mutate.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,OAAO,EAGZ,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,KAAK,QAAQ,EAA8B,MAAM,8BAA8B,CAAA;AA8BxF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC5B,OAAO,EAAE,CAMX"}

package/dist/runtime/query/replay/mutate.js

@@ -1,69 +0,0 @@
-import { createToolMessage, } from '../../../types/message/index.js';
-import { MutationNotApplicableError } from '../../../types/run/replay.js';
-/**
- * Returns the tool calls on the most recent assistant message that do not
- * yet have a matching {@link import('../../../types/message/index.js').ToolMessage}
- * response further down the message list. These are the fork-point "pending"
- * tool calls that mutations may target.
- */
-function findPendingToolCalls(messages) {
-    let lastAssistantIdx = -1;
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const msg = messages[i];
-        if (msg && msg.role === 'assistant' && (msg.toolCalls?.length ?? 0) > 0) {
-            lastAssistantIdx = i;
-            break;
-        }
-    }
-    if (lastAssistantIdx === -1)
-        return [];
-    const assistant = messages[lastAssistantIdx];
-    const satisfied = new Set();
-    for (let i = lastAssistantIdx + 1; i < messages.length; i++) {
-        const msg = messages[i];
-        if (msg && msg.role === 'tool') {
-            satisfied.add(msg.toolCallId);
-        }
-    }
-    return (assistant.toolCalls ?? []).filter((tc) => !satisfied.has(tc.id));
-}
-/**
- * Apply an ordered list of {@link Mutation} to a checkpoint's message
- * history at the fork point, producing a new message array that the
- * resumed iteration loop consumes. Pure function; does not touch the run
- * store, does not emit events.
- *
- * Throws {@link MutationNotApplicableError} when an `injectToolResponse`
- * mutation targets a tool call id that is not pending at the fork point —
- * the error payload carries the list of ids that *are* pending so the
- * caller can recover without guessing.
- *
- * See ses_005-deterministic-replay design §3.3.
- */
-export function applyMutations(messages, mutations) {
-    let current = [...messages];
-    for (const m of mutations) {
-        current = applyOne(current, m);
-    }
-    return current;
-}
-function applyOne(messages, mutation) {
-    switch (mutation.type) {
-        case 'injectToolResponse': {
-            const pending = findPendingToolCalls(messages);
-            const match = pending.find((tc) => tc.id === mutation.toolCallId);
-            if (!match) {
-                throw new MutationNotApplicableError(`No pending tool call ${mutation.toolCallId} at fork point`, 
-                // `ToolCall.id` is a bare `string` — a provider chooses its own
-                // shape, which is what `ToolUseId` exists to say. This assertion
-                // satisfies `MutationNotApplicableError`'s parameter and is only
-                // ever read back as text in that message; it never becomes a
-                // key. Left as a cast because the honest fix is that parameter
-                // type, not this line.
-                pending.map((tc) => tc.id));
-            }
-            return [...messages, createToolMessage(mutation.response.output, mutation.toolCallId)];
-        }
-    }
-}
-//# sourceMappingURL=mutate.js.map

package/dist/runtime/query/replay/mutate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mutate.js","sourceRoot":"","sources":["../../../../src/runtime/query/replay/mutate.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,iBAAiB,GACjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAiB,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAExF;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,QAA4B;IACzD,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACzE,gBAAgB,GAAG,CAAC,CAAA;YACpB,MAAK;QACN,CAAC;IACF,CAAC;IACD,IAAI,gBAAgB,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,CAAqB,CAAA;IAChE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,IAAI,CAAC,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC7B,QAA4B,EAC5B,SAA8B;IAE9B,IAAI,OAAO,GAAc,CAAC,GAAG,QAAQ,CAAC,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAmB,EAAE,QAAkB;IACxD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAA;YACjE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,IAAI,0BAA0B,CACnC,wBAAwB,QAAQ,CAAC,UAAU,gBAAgB;gBAC3D,gEAAgE;gBAChE,iEAAiE;gBACjE,iEAAiE;gBACjE,6DAA6D;gBAC7D,+DAA+D;gBAC/D,uBAAuB;gBACvB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAgB,CAAC,CACxC,CAAA;YACF,CAAC;YACD,OAAO,CAAC,GAAG,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACvF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/runtime/query/replay/prepare.d.ts

@@ -1,66 +0,0 @@
-import type { CheckpointId, IterationCheckpoint } from '../../../types/hitl/index.js';
-import type { RunId } from '../../../types/ids/index.js';
-import type { Message } from '../../../types/message/index.js';
-import type { CheckpointRunScope, CheckpointStore } from '../../../types/run/checkpoint-store.js';
-import type { Mutation, ReplayAttribution } from '../../../types/run/replay.js';
-import type { Logger } from '../../../utils/logger.js';
-export type CheckpointSelector = CheckpointId | 'latest' | 'emergency';
-export interface PrepareReplayInput {
-    /** Directory that contains `<runId>/` for the source run. */
-    baseDir: string;
-    /** Source run to fork from. */
-    runId: RunId;
-    /** Which checkpoint to fork at. */
-    fromCheckpoint: CheckpointSelector;
-    /** Optional mutations applied at the fork point before the caller hands state to `query()`. */
-    mutate?: Mutation[];
-    /**
-     * Directory that holds emergency dumps. Required only when `fromCheckpoint`
-     * is `'emergency'`; conventionally sibling of `baseDir` (the `.namzu/emergency`
-     * folder), but left explicit so callers with non-default layouts can redirect.
-     */
-    emergencyDir?: string;
-    logger?: Logger;
-    /**
-     * Optional store override (host-injected, e.g. Postgres). When set,
-     * `scope` is required and `baseDir` is ignored for checkpoint reads.
-     * The `'emergency'` selector still reads the on-disk dump under
-     * `emergencyDir` — emergency saves are process-local by nature.
-     */
-    checkpointStore?: CheckpointStore;
-    /** Run scope for `checkpointStore`. Required when it is set. */
-    scope?: CheckpointRunScope;
-}
-export interface PreparedReplayState {
-    /**
-     * Message history at the fork point, with mutations applied. Seed this
-     * as the new run's initial messages and pass `sourceCheckpoint.id` as
-     * `resumeFromCheckpoint` when you call `query()`.
-     */
-    messages: Message[];
-    /** The checkpoint the replay forks from (already projected if emergency). */
-    sourceCheckpoint: IterationCheckpoint;
-    /**
-     * Attribution to stamp on the replay run once it is created. The caller
-     * sets `Run.replayOf = buildAttribution(prepared, replayedAt)` on the
-     * new `RunPersistence` before persisting the first time.
-     */
-    attribution: ReplayAttribution;
-}
-/**
- * Produce the state materials needed to execute a replay run — the mutated
- * message history, the resolved source checkpoint, and the replay
- * attribution record. Pure read; does not touch the run store beyond
- * reading the source run's checkpoint files.
- *
- * This is the state-preparation half of the replay primitive. The
- * caller is expected to thread the returned `messages` +
- * `sourceCheckpoint.id` into `query({ resumeFromCheckpoint, messages,
- * ... })` and stamp `Run.replayOf = prepared.attribution` on the resulting
- * run. The end-to-end `replay()` entry that does all of this in one call
- * is a follow-up session (`ReplayEnvironment` shape).
- *
- * See `ses_005-deterministic-replay/design.md` §3.1.
- */
-export declare function prepareReplayState(input: PrepareReplayInput): Promise<PreparedReplayState>;
-//# sourceMappingURL=prepare.d.ts.map

package/dist/runtime/query/replay/prepare.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../../src/runtime/query/replay/prepare.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AACrF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AACjG,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAKtD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEtE,MAAM,WAAW,kBAAkB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,KAAK,EAAE,KAAK,CAAA;IACZ,mCAAmC;IACnC,cAAc,EAAE,kBAAkB,CAAA;IAClC,+FAA+F;IAC/F,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,gEAAgE;IAChE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,6EAA6E;IAC7E,gBAAgB,EAAE,mBAAmB,CAAA;IACrC;;;;OAIG;IACH,WAAW,EAAE,iBAAiB,CAAA;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAahG"}

package/dist/runtime/query/replay/prepare.js

@@ -1,81 +0,0 @@
-import { join } from 'node:path';
-import { EmergencySaveManager } from '../../../manager/run/emergency.js';
-import { RunDiskStore } from '../../../store/run/disk.js';
-import { projectEmergencyToCheckpoint } from '../checkpoint.js';
-import { requireScope } from './list.js';
-import { applyMutations } from './mutate.js';
-/**
- * Produce the state materials needed to execute a replay run — the mutated
- * message history, the resolved source checkpoint, and the replay
- * attribution record. Pure read; does not touch the run store beyond
- * reading the source run's checkpoint files.
- *
- * This is the state-preparation half of the replay primitive. The
- * caller is expected to thread the returned `messages` +
- * `sourceCheckpoint.id` into `query({ resumeFromCheckpoint, messages,
- * ... })` and stamp `Run.replayOf = prepared.attribution` on the resulting
- * run. The end-to-end `replay()` entry that does all of this in one call
- * is a follow-up session (`ReplayEnvironment` shape).
- *
- * See `ses_005-deterministic-replay/design.md` §3.1.
- */
-export async function prepareReplayState(input) {
-    const sourceCheckpoint = await resolveCheckpoint(input);
-    const mutations = input.mutate ?? [];
-    const messages = applyMutations(sourceCheckpoint.messages, mutations);
-    const attribution = {
-        sourceRunId: input.runId,
-        fromCheckpointId: sourceCheckpoint.id,
-        mutations,
-        replayedAt: Date.now(),
-    };
-    return { messages, sourceCheckpoint, attribution };
-}
-async function resolveCheckpoint(input) {
-    if (input.fromCheckpoint === 'emergency') {
-        return resolveEmergency(input);
-    }
-    const reader = await bindCheckpointReader(input);
-    if (input.fromCheckpoint === 'latest') {
-        const all = await reader.list();
-        if (all.length === 0) {
-            throw new Error(`No checkpoints found for run ${input.runId} in ${input.baseDir}`);
-        }
-        return [...all].sort((a, b) => b.iteration - a.iteration)[0];
-    }
-    const checkpoint = await reader.read(input.fromCheckpoint);
-    if (!checkpoint) {
-        throw new Error(`Checkpoint ${input.fromCheckpoint} not found for run ${input.runId}`);
-    }
-    return checkpoint;
-}
-async function bindCheckpointReader(input) {
-    if (input.checkpointStore) {
-        const store = input.checkpointStore;
-        const scope = requireScope(input.scope, 'prepareReplayState');
-        return {
-            list: () => store.listCheckpoints(scope),
-            read: (id) => store.readCheckpoint(scope, id),
-        };
-    }
-    const store = new RunDiskStore({ baseDir: input.baseDir, logger: input.logger });
-    await store.initRun(input.runId);
-    return {
-        list: () => store.listCheckpoints(),
-        read: (id) => store.readCheckpoint(id),
-    };
-}
-async function resolveEmergency(input) {
-    if (!input.emergencyDir) {
-        throw new Error("fromCheckpoint: 'emergency' requires an `emergencyDir` — conventionally sibling of baseDir");
-    }
-    const path = join(input.emergencyDir, `${input.runId}.json`);
-    try {
-        const dump = EmergencySaveManager.loadSave(path);
-        return projectEmergencyToCheckpoint(dump);
-    }
-    catch (err) {
-        throw new Error(`No emergency dump found for run ${input.runId} at ${path}`, { cause: err });
-    }
-}
-//# sourceMappingURL=prepare.js.map

package/dist/runtime/query/replay/prepare.js.map

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

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

@@ -1,103 +0,0 @@
-import type { PendingDecision } from '../../types/hitl/index.js';
-import type { CheckpointStore, FencingToken } from '../../types/run/checkpoint-store.js';
-import type { Run } from '../../types/run/entity.js';
-import type { RunEventReplay } from '../../types/run/event-cursor.js';
-import type { RunEventListener } from '../../types/run/events.js';
-import type { RunState } from '../../types/run/state.js';
-import { type QueryParams } from './index.js';
-import { type RunStateScope } from './run-state.js';
-/**
- * What a resume attempt found.
- *
- * Three outcomes rather than a nullable `Run`, because the two failures
- * mean opposite things to a caller. "No checkpoint" is a dead end — there
- * is nothing to continue and starting fresh would be a different run
- * wearing the same id. "Awaiting decision" is the run working as designed:
- * it parked on a question, and continuing means answering it first.
- */
-export type ResumeOutcome = {
-    readonly resumed: false;
-    readonly reason: 'no-checkpoint';
-} | {
-    readonly resumed: false;
-    readonly reason: 'awaiting-decision';
-    /** What to put in front of a human. */
-    readonly pending: PendingDecision;
-    readonly state: RunState;
-} | {
-    readonly resumed: true;
-    readonly run: Run;
-    readonly state: RunState;
-    /**
-     * What became of {@link ResumeRunParams.eventCursor}. Absent when no
-     * cursor was supplied.
-     *
-     * Reported rather than thrown: a stale cursor is the client's
-     * problem and the run still had to be resumed. A caller that sees
-     * `unavailable` re-derives its view from the run's transcript
-     * instead of folding a hole into it.
-     */
-    readonly replay?: RunEventReplay;
-};
-/**
- * The half of a run that cannot be serialized, plus where to look.
- *
- * `messages` is deliberately absent. On resume the history comes from the
- * checkpoint and any passed messages would be discarded, so accepting them
- * would invite a caller to hand over a transcript that is silently ignored.
- */
-export interface ResumeRunParams extends Omit<QueryParams, 'messages' | 'runId' | 'resumeFromCheckpoint'> {
-    /** Identifies the run inside the checkpoint store. */
-    readonly scope: RunStateScope;
-    /** Required to find the checkpoint; also threaded into the resumed run. */
-    readonly checkpointStore: CheckpointStore;
-    /**
-     * The fence of the claim this worker took on the run before resuming.
-     *
-     * A resume is the one moment two workers are most likely to collide — it
-     * is what a queue reader does with a parked run — so this is the call that
-     * most needs to carry one.
-     */
-    readonly claimFence?: FencingToken;
-    /**
-     * Resume a specific checkpoint instead of the one the store would pick.
-     * Absent means the parked checkpoint if there is one, else the newest.
-     */
-    readonly checkpointId?: RunState['checkpointId'];
-    /**
-     * Where to send the resumed run's events.
-     *
-     * This call had none, and the consequence was total: it drains the run to
-     * completion and every event the run emits — every tool call, every park,
-     * every token update — was discarded, because `drainQuery` forwards to a
-     * listener and none was ever passed. So the one API for continuing a run
-     * another process started could not show anybody what the run was doing.
-     *
-     * It is also what makes {@link ResumeRunParams.eventCursor} mean anything:
-     * a catch-up delivered into a stream nobody receives is not a catch-up.
-     */
-    readonly listener?: RunEventListener;
-}
-/**
- * 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 declare function resumeRun(params: ResumeRunParams): Promise<ResumeOutcome>;
-//# sourceMappingURL=resume-run.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resume-run.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/resume-run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACxF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,YAAY,CAAA;AAChF,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,gBAAgB,CAAA;AAEzE;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC7D;IACA,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IACpC,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CACvB,GACD;IACA,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAC/B,CAAA;AAEJ;;;;;;GAMG;AACH,MAAM,WAAW,eAChB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,sBAAsB,CAAC;IACxE,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;IAEzC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;IAEhD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAyE/E"}