@namzu/sdk 0.4.1 → 0.4.2

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

@@ -0,0 +1,150 @@
+import { describe, expect, it } from 'vitest';
+import { CheckpointManager, projectEmergencyToCheckpoint } from '../checkpoint.js';
+function makeCheckpoint(overrides = {}) {
+    return {
+        id: 'cp_test_a',
+        runId: 'run_test',
+        iteration: 1,
+        messages: [{ role: 'user', content: 'hello' }],
+        tokenUsage: {
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        },
+        costInfo: {
+            inputCostPer1M: 0,
+            outputCostPer1M: 0,
+            totalCost: 0,
+            cacheDiscount: 0,
+        },
+        guardState: { iterationCount: 1, elapsedMs: 100 },
+        createdAt: Date.now(),
+        ...overrides,
+    };
+}
+function makeStoreStub(checkpoints) {
+    return {
+        listCheckpoints: async () => checkpoints,
+    };
+}
+describe('CheckpointManager.listEntries', () => {
+    it('projects stored checkpoints to CheckpointListEntry', async () => {
+        const store = makeStoreStub([
+            makeCheckpoint({
+                id: 'cp_a',
+                iteration: 1,
+                createdAt: 1000,
+                messages: [
+                    { role: 'user', content: 'hi' },
+                    { role: 'assistant', content: 'hello' },
+                ],
+            }),
+            makeCheckpoint({
+                id: 'cp_b',
+                iteration: 2,
+                createdAt: 2000,
+                messages: [
+                    { role: 'user', content: 'hi' },
+                    { role: 'assistant', content: 'hello' },
+                    { role: 'user', content: 'more' },
+                ],
+            }),
+        ]);
+        const mgr = new CheckpointManager(store);
+        const entries = await mgr.listEntries();
+        expect(entries).toHaveLength(2);
+        expect(entries[0]).toEqual({
+            id: 'cp_a',
+            runId: 'run_test',
+            iteration: 1,
+            createdAt: 1000,
+            messageCount: 2,
+        });
+        expect(entries[1]).toEqual({
+            id: 'cp_b',
+            runId: 'run_test',
+            iteration: 2,
+            createdAt: 2000,
+            messageCount: 3,
+        });
+    });
+    it('returns empty array when no checkpoints exist', async () => {
+        const mgr = new CheckpointManager(makeStoreStub([]));
+        expect(await mgr.listEntries()).toEqual([]);
+    });
+    it('does not include full checkpoint payload fields', async () => {
+        const mgr = new CheckpointManager(makeStoreStub([
+            makeCheckpoint({
+                toolResultHashes: { call_x: 'hash' },
+                branchStack: [{ agentId: 'a', decision: 'd', confidence: 1, timestamp: 0 }],
+            }),
+        ]));
+        const [entry] = await mgr.listEntries();
+        expect(entry).not.toHaveProperty('tokenUsage');
+        expect(entry).not.toHaveProperty('costInfo');
+        expect(entry).not.toHaveProperty('toolResultHashes');
+        expect(entry).not.toHaveProperty('branchStack');
+        expect(entry).not.toHaveProperty('guardState');
+        expect(entry).not.toHaveProperty('messages');
+    });
+});
+function makeEmergencyDump(overrides = {}) {
+    return {
+        id: 'esave_dump_a',
+        runId: 'run_victim',
+        messages: [
+            { role: 'user', content: 'before the crash' },
+            { role: 'assistant', content: 'working' },
+        ],
+        tokenUsage: {
+            promptTokens: 10,
+            completionTokens: 5,
+            totalTokens: 15,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        },
+        currentIteration: 7,
+        startedAt: 1_000,
+        savedAt: 2_500,
+        processSignal: 'SIGTERM',
+        ...overrides,
+    };
+}
+describe('projectEmergencyToCheckpoint', () => {
+    it('produces an IterationCheckpoint with all required fields', () => {
+        const dump = makeEmergencyDump();
+        const cp = projectEmergencyToCheckpoint(dump);
+        expect(cp.runId).toBe('run_victim');
+        expect(cp.iteration).toBe(7);
+        expect(cp.messages).toBe(dump.messages);
+        expect(cp.tokenUsage).toBe(dump.tokenUsage);
+        expect(cp.createdAt).toBe(2_500);
+        expect(cp.guardState).toEqual({ iterationCount: 7, elapsedMs: 1_500 });
+        expect(cp.costInfo).toEqual({
+            inputCostPer1M: 0,
+            outputCostPer1M: 0,
+            totalCost: 0,
+            cacheDiscount: 0,
+        });
+    });
+    it('derives a deterministic CheckpointId from the emergency save id', () => {
+        const dump = makeEmergencyDump({ id: 'esave_xyz123' });
+        const cp1 = projectEmergencyToCheckpoint(dump);
+        const cp2 = projectEmergencyToCheckpoint(dump);
+        expect(cp1.id).toBe('cp_emergency_xyz123');
+        expect(cp1.id).toBe(cp2.id);
+    });
+    it('clamps guardState.elapsedMs to 0 when savedAt precedes startedAt', () => {
+        const cp = projectEmergencyToCheckpoint(makeEmergencyDump({ startedAt: 2_000, savedAt: 1_000 }));
+        expect(cp.guardState.elapsedMs).toBe(0);
+    });
+    it('leaves optional fields (toolResultHashes, branchStack, activeNode) unset', () => {
+        const cp = projectEmergencyToCheckpoint(makeEmergencyDump());
+        expect(cp.toolResultHashes).toBeUndefined();
+        expect(cp.branchStack).toBeUndefined();
+        expect(cp.activeNode).toBeUndefined();
+    });
+});
+//# sourceMappingURL=checkpoint.test.js.map

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

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

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

@@ -1,6 +1,22 @@
 import type { RunPersistence } from '../../manager/run/persistence.js';
 import type { RunDiskStore } from '../../store/run/disk.js';
 import type { ActiveNodeInfo, BranchStackEntry, CheckpointId, CheckpointSummary, IterationCheckpoint } from '../../types/hitl/index.js';
+import type { EmergencySaveData } from '../../types/run/emergency.js';
+import type { CheckpointListEntry } from '../../types/run/replay.js';
+/**
+ * Project an {@link EmergencySaveData} dump to an {@link IterationCheckpoint}
+ * shape so `replay({ fromCheckpoint: 'emergency' })` can consume it through
+ * the same restore path as any other checkpoint.
+ *
+ * The projection is lossy: `costInfo`, `guardState.elapsedMs`,
+ * `toolResultHashes`, `branchStack`, and `activeNode` are not captured at
+ * emergency-save time and default to zero/empty values. The synthetic
+ * checkpoint id is derived deterministically from the emergency save id so
+ * re-projecting the same dump yields the same {@link CheckpointId}.
+ *
+ * See ses_005-deterministic-replay design §2 + §5.2.
+ */
+export declare function projectEmergencyToCheckpoint(dump: EmergencySaveData): IterationCheckpoint;
 export declare class CheckpointManager {
     private store;
     constructor(store: RunDiskStore);
@@ -16,6 +32,13 @@ export declare class CheckpointManager {
     }): Promise<IterationCheckpoint>;
     restore(checkpointId: CheckpointId): Promise<IterationCheckpoint>;
     list(): Promise<IterationCheckpoint[]>;
+    /**
+     * Listing projection used by the public `listCheckpoints` API. Returns
+     * only the fields a consumer needs to pick a fork point for
+     * {@link import('./replay/prepare.js').prepareReplayState} — not the
+     * full checkpoint payload. See ses_005-deterministic-replay design §3.1.
+     */
+    listEntries(): Promise<CheckpointListEntry[]>;
     prune(keepLast: number): Promise<void>;
     static buildSummary(runMgr: RunPersistence, iteration: number): CheckpointSummary;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,2BAA2B,CAAA;AAKlC,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,KAAK,CAAc;gBAEf,KAAK,EAAE,YAAY;IAIzB,MAAM,CACX,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC7F,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;QAChC,UAAU,CAAC,EAAE,cAAc,CAAA;KAC3B,GACC,OAAO,CAAC,mBAAmB,CAAC;IAsBzB,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQjE,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;CAajF"}
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/runtime/query/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAepE;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAezF;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,KAAK,CAAc;gBAEf,KAAK,EAAE,YAAY;IAIzB,MAAM,CACX,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC7F,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;QAChC,UAAU,CAAC,EAAE,cAAc,CAAA;KAC3B,GACC,OAAO,CAAC,mBAAmB,CAAC;IAsBzB,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQjE,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAI5C;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAK7C,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;CAajF"}

package/dist/runtime/query/checkpoint.js

@@ -1,5 +1,44 @@
+import { ZERO_COST } from '../../utils/cost.js';
 import { buildToolResultHashes } from '../../utils/hash.js';
 import { generateCheckpointId } from '../../utils/id.js';
+function toCheckpointListEntry(cp) {
+    return {
+        id: cp.id,
+        runId: cp.runId,
+        iteration: cp.iteration,
+        createdAt: cp.createdAt,
+        messageCount: cp.messages.length,
+    };
+}
+/**
+ * Project an {@link EmergencySaveData} dump to an {@link IterationCheckpoint}
+ * shape so `replay({ fromCheckpoint: 'emergency' })` can consume it through
+ * the same restore path as any other checkpoint.
+ *
+ * The projection is lossy: `costInfo`, `guardState.elapsedMs`,
+ * `toolResultHashes`, `branchStack`, and `activeNode` are not captured at
+ * emergency-save time and default to zero/empty values. The synthetic
+ * checkpoint id is derived deterministically from the emergency save id so
+ * re-projecting the same dump yields the same {@link CheckpointId}.
+ *
+ * See ses_005-deterministic-replay design §2 + §5.2.
+ */
+export function projectEmergencyToCheckpoint(dump) {
+    const emergencySuffix = dump.id.replace(/^esave_/, '');
+    return {
+        id: `cp_emergency_${emergencySuffix}`,
+        runId: dump.runId,
+        iteration: dump.currentIteration,
+        messages: dump.messages,
+        tokenUsage: dump.tokenUsage,
+        costInfo: { ...ZERO_COST },
+        guardState: {
+            iterationCount: dump.currentIteration,
+            elapsedMs: Math.max(0, dump.savedAt - dump.startedAt),
+        },
+        createdAt: dump.savedAt,
+    };
+}
 export class CheckpointManager {
     store;
     constructor(store) {
@@ -35,6 +74,16 @@ export class CheckpointManager {
     async list() {
         return this.store.listCheckpoints();
     }
+    /**
+     * Listing projection used by the public `listCheckpoints` API. Returns
+     * only the fields a consumer needs to pick a fork point for
+     * {@link import('./replay/prepare.js').prepareReplayState} — not the
+     * full checkpoint payload. See ses_005-deterministic-replay design §3.1.
+     */
+    async listEntries() {
+        const checkpoints = await this.store.listCheckpoints();
+        return checkpoints.map(toCheckpointListEntry);
+    }
     async prune(keepLast) {
         const all = await this.list();
         if (all.length <= keepLast)

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

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

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

@@ -72,8 +72,6 @@ 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

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,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"}
+{"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,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

@@ -15,10 +15,6 @@ import { getRootLogger } from '../../utils/logger.js';
  * 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

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

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

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

@@ -10,7 +10,7 @@ import { type Message } from '../../types/message/index.js';
 import type { AgentPersona } from '../../types/persona/index.js';
 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 { AgentRunConfig, Run, 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';
@@ -79,8 +79,8 @@ export interface QueryParams {
     sandboxProvider?: SandboxProvider;
     invocationState?: InvocationState;
 }
-export declare function query(params: QueryParams): AsyncGenerator<RunEvent, AgentRun>;
+export declare function query(params: QueryParams): AsyncGenerator<RunEvent, Run>;
 export declare function drainQuery(params: Omit<QueryParams, 'resumeHandler'> & {
     resumeHandler?: ResumeHandler;
-}, listener?: RunEventListener): Promise<AgentRun>;
+}, listener?: RunEventListener): Promise<Run>;
 //# sourceMappingURL=index.d.ts.map

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/replay/__tests__/mutate.test.d.ts

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

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

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

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

@@ -0,0 +1,123 @@
+import { describe, expect, it } from 'vitest';
+import { MutationNotApplicableError } from '../../../../types/run/replay.js';
+import { applyMutations } from '../mutate.js';
+function assistantWithCalls(toolCallIds) {
+    return {
+        role: 'assistant',
+        content: null,
+        toolCalls: toolCallIds.map((id) => ({
+            id,
+            type: 'function',
+            function: { name: 'noop', arguments: '{}' },
+        })),
+    };
+}
+describe('applyMutations / injectToolResponse', () => {
+    it('appends a ToolMessage when the toolCallId is pending', () => {
+        const messages = [
+            { role: 'user', content: 'do stuff' },
+            assistantWithCalls(['call_a', 'call_b']),
+            { role: 'tool', content: 'a done', toolCallId: 'call_a' },
+        ];
+        const mutations = [
+            {
+                type: 'injectToolResponse',
+                toolCallId: 'call_b',
+                response: { success: true, output: 'mocked-b', data: { x: 1 } },
+            },
+        ];
+        const result = applyMutations(messages, mutations);
+        expect(result).toHaveLength(4);
+        const last = result[3];
+        expect(last.role).toBe('tool');
+        expect(last.toolCallId).toBe('call_b');
+        expect(last.content).toBe('mocked-b');
+    });
+    it('throws MutationNotApplicableError when no pending tool calls exist', () => {
+        const messages = [
+            { role: 'user', content: 'hi' },
+            { role: 'assistant', content: 'hello' },
+        ];
+        expect(() => applyMutations(messages, [
+            {
+                type: 'injectToolResponse',
+                toolCallId: 'call_missing',
+                response: { success: true, output: 'x' },
+            },
+        ])).toThrow(MutationNotApplicableError);
+    });
+    it('throws with availableToolCallIds populated when toolCallId is not pending', () => {
+        const messages = [
+            { role: 'user', content: 'do stuff' },
+            assistantWithCalls(['call_a', 'call_b']),
+        ];
+        try {
+            applyMutations(messages, [
+                {
+                    type: 'injectToolResponse',
+                    toolCallId: 'call_z',
+                    response: { success: true, output: 'x' },
+                },
+            ]);
+            expect.fail('expected MutationNotApplicableError');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(MutationNotApplicableError);
+            const e = err;
+            expect(e.availableToolCallIds).toEqual(['call_a', 'call_b']);
+        }
+    });
+    it('considers a tool call satisfied only when a subsequent ToolMessage responds to it', () => {
+        const messages = [
+            { role: 'user', content: 'do stuff' },
+            assistantWithCalls(['call_a', 'call_b', 'call_c']),
+            { role: 'tool', content: 'a done', toolCallId: 'call_a' },
+            { role: 'tool', content: 'c done', toolCallId: 'call_c' },
+        ];
+        try {
+            applyMutations(messages, [
+                {
+                    type: 'injectToolResponse',
+                    toolCallId: 'call_a',
+                    response: { success: true, output: 're-answered' },
+                },
+            ]);
+            expect.fail('expected MutationNotApplicableError — call_a already satisfied');
+        }
+        catch (err) {
+            const e = err;
+            expect(e.availableToolCallIds).toEqual(['call_b']);
+        }
+    });
+    it('applies mutations in order so a later mutation sees earlier ones', () => {
+        const messages = [
+            { role: 'user', content: 'two calls pending' },
+            assistantWithCalls(['call_x', 'call_y']),
+        ];
+        const result = applyMutations(messages, [
+            {
+                type: 'injectToolResponse',
+                toolCallId: 'call_x',
+                response: { success: true, output: 'x-result' },
+            },
+            {
+                type: 'injectToolResponse',
+                toolCallId: 'call_y',
+                response: { success: true, output: 'y-result' },
+            },
+        ]);
+        expect(result).toHaveLength(4);
+        expect(result[2].toolCallId).toBe('call_x');
+        expect(result[3].toolCallId).toBe('call_y');
+    });
+    it('returns the original messages unchanged when the mutation list is empty', () => {
+        const messages = [
+            { role: 'user', content: 'no-op' },
+            { role: 'assistant', content: 'ok' },
+        ];
+        const result = applyMutations(messages, []);
+        expect(result).toEqual(messages);
+        expect(result).not.toBe(messages);
+    });
+});
+//# sourceMappingURL=mutate.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.test.js","sourceRoot":"","sources":["../../../../../src/runtime/query/replay/__tests__/mutate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAG7C,OAAO,EAAiB,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,SAAS,kBAAkB,CAAC,WAAqB;IAChD,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACnC,EAAE;YACF,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3C,CAAC,CAAC;KACH,CAAA;AACF,CAAC;AAED,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC/D,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;YACrC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACxC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;SACzD,CAAA;QACD,MAAM,SAAS,GAAe;YAC7B;gBACC,IAAI,EAAE,oBAAoB;gBAC1B,UAAU,EAAE,QAAsB;gBAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;aAC/D;SACD,CAAA;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAgB,CAAA;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC7E,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;YAC/B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;SACvC,CAAA;QACD,MAAM,CAAC,GAAG,EAAE,CACX,cAAc,CAAC,QAAQ,EAAE;YACxB;gBACC,IAAI,EAAE,oBAAoB;gBAC1B,UAAU,EAAE,cAA4B;gBACxC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;aACxC;SACD,CAAC,CACF,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACpF,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;YACrC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACxC,CAAA;QACD,IAAI,CAAC;YACJ,cAAc,CAAC,QAAQ,EAAE;gBACxB;oBACC,IAAI,EAAE,oBAAoB;oBAC1B,UAAU,EAAE,QAAsB;oBAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;iBACxC;aACD,CAAC,CAAA;YACF,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAA;YACtD,MAAM,CAAC,GAAG,GAAiC,CAAA;YAC3C,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC7D,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC5F,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;YACrC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAClD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;YACzD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;SACzD,CAAA;QACD,IAAI,CAAC;YACJ,cAAc,CAAC,QAAQ,EAAE;gBACxB;oBACC,IAAI,EAAE,oBAAoB;oBAC1B,UAAU,EAAE,QAAsB;oBAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE;iBAClD;aACD,CAAC,CAAA;YACF,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,GAAiC,CAAA;YAC3C,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnD,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC3E,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE;YAC9C,kBAAkB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACxC,CAAA;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE;YACvC;gBACC,IAAI,EAAE,oBAAoB;gBAC1B,UAAU,EAAE,QAAsB;gBAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE;aAC/C;YACD;gBACC,IAAI,EAAE,oBAAoB;gBAC1B,UAAU,EAAE,QAAsB;gBAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE;aAC/C;SACD,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAE,MAAM,CAAC,CAAC,CAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5D,MAAM,CAAE,MAAM,CAAC,CAAC,CAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAClF,MAAM,QAAQ,GAAc;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;SACpC,CAAA;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

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

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

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

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