@namzu/sdk 2.0.0 → 3.1.0

package/dist/store/__tests__/checkpoint-integrity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-integrity.test.js","sourceRoot":"","sources":["../../../src/store/__tests__/checkpoint-integrity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAIpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,GAAG,QAAiB,CAAA;AAEhC,IAAI,OAAe,CAAA;AACnB,IAAI,KAAmB,CAAA;AACvB,IAAI,KAAa,CAAA;AAEjB,UAAU,CAAC,KAAK,IAAI,EAAE;IACrB,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;IAClD,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1C,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACnC,wEAAwE;IACxE,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACd,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA;AAEF,SAAS,UAAU,CAAC,EAAU,EAAE,SAAiB;IAChD,OAAO;QACN,EAAE,EAAE,EAAkB;QACtB,KAAK,EAAE,MAAM;QACb,SAAS;QACT,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE;YACX,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;YACnB,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;SACnB;QACD,QAAQ,EAAE;YACT,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,aAAa,EAAE,CAAC;SAChB;QACD,UAAU,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE;QACvD,SAAS,EAAE,KAAK,GAAG,SAAS;KACL,CAAA;AACzB,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QAE9D,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClD,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAErD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;QAC7D,oEAAoE;QACpE,2CAA2C;QAC3C,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QACjD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QAC9D,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IAC7E,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC3D,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACpD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC1D,kEAAkE;QAClE,iEAAiE;QACjE,+CAA+C;QAC/C,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QACnF,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,YAA4B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC/E,kBAAkB,CAClB,CAAA;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClD,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAElD,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,gEAAgE;QAChE,MAAM,CAAC,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,YAA4B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,CAAC,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/store/__tests__/checkpoint-versioning.test.d.ts

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

package/dist/store/__tests__/checkpoint-versioning.test.d.ts.map

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

package/dist/store/__tests__/checkpoint-versioning.test.js

@@ -0,0 +1,151 @@
+import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { RunDiskStore } from '../run/disk.js';
+/**
+ * A checkpoint was written bare and read with a cast. Two consequences,
+ * one latent and one live.
+ *
+ * Latent: an unstamped record is read as version 1 by definition, which is
+ * correct only while version 1 is the only version there has ever been.
+ * The moment a second exists, a file written by the newer build is read by
+ * the older one as if it were the older shape, and the refusal that exists
+ * to prevent exactly that never fires. There was no chain to hang a
+ * migration on.
+ *
+ * Live: the read validated `id`, `iteration`, `createdAt` and `messages`
+ * and skipped the budget fields — which a resume dereferences before its
+ * first iteration. A run recalled at $4.80 of a $5 cap whose `costInfo`
+ * came back malformed continues with `NaN`, which compares false against
+ * every limit, so the guard that exists to stop it never stops it.
+ */
+const RID = 'run_1';
+function checkpoint(overrides = {}) {
+    return {
+        id: 'cp_1',
+        runId: RID,
+        iteration: 2,
+        messages: [],
+        tokenUsage: {
+            promptTokens: 100,
+            completionTokens: 50,
+            totalTokens: 150,
+            cachedTokens: 0,
+            cacheWriteTokens: 0,
+        },
+        costInfo: { totalCost: 4.8 },
+        guardState: { iterationCount: 2, elapsedMs: 1_000 },
+        createdAt: Date.now(),
+        ...overrides,
+    };
+}
+describe('a checkpoint on disk', () => {
+    let dir;
+    let store;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), 'namzu-cpver-'));
+        store = new RunDiskStore({ baseDir: dir });
+        await store.initRun(RID);
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    const writeRaw = async (name, record) => {
+        const cpDir = join(dir, RID, 'checkpoints');
+        await mkdir(cpDir, { recursive: true });
+        await writeFile(join(cpDir, `${name}.json`), JSON.stringify(record), 'utf-8');
+    };
+    it('is stamped ON DISK with the schema version it was written at', async () => {
+        await store.writeCheckpoint(checkpoint());
+        // Read the file, not the store: the reader re-stamps whatever it
+        // parses, so asking the store back cannot tell a stamped file from
+        // an unstamped one. The stamp only does its job if it is in the
+        // bytes another build will read.
+        const raw = JSON.parse(await readFile(join(dir, RID, 'checkpoints', 'cp_1.json'), 'utf-8'));
+        expect(raw.schemaVersion).toBe(1);
+    });
+    it('round-trips through the stamp without losing anything', async () => {
+        const original = checkpoint({ iteration: 7 });
+        await store.writeCheckpoint(original);
+        const read = await store.readCheckpoint(original.id);
+        expect(read?.iteration).toBe(7);
+        expect(read?.tokenUsage.totalTokens).toBe(150);
+    });
+    it('reads an unstamped record written before this existed', async () => {
+        // Optional-additive is the established practice here; an older file
+        // must keep working.
+        const { ...bare } = checkpoint({ id: 'cp_old' });
+        await writeRaw('cp_old', bare);
+        expect((await store.readCheckpoint('cp_old'))?.iteration).toBe(2);
+    });
+    it('refuses a record from a future version rather than reading it partially', async () => {
+        await writeRaw('cp_future', {
+            ...checkpoint({ id: 'cp_future' }),
+            schemaVersion: 99,
+        });
+        // Reading it with today's parser silently drops the fields this
+        // build does not know about, and writing it back loses them.
+        await expect(store.readCheckpoint('cp_future')).rejects.toThrow(/schema version 99/);
+    });
+});
+describe('budget state a resume dereferences', () => {
+    let dir;
+    let store;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), 'namzu-cpbudget-'));
+        store = new RunDiskStore({ baseDir: dir });
+        await store.initRun(RID);
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    const writeRaw = async (name, record) => {
+        const cpDir = join(dir, RID, 'checkpoints');
+        await mkdir(cpDir, { recursive: true });
+        await writeFile(join(cpDir, `${name}.json`), JSON.stringify(record), 'utf-8');
+    };
+    it('refuses a checkpoint with no cost information', async () => {
+        const { costInfo: _dropped, ...rest } = checkpoint({ id: 'cp_nocost' });
+        await writeRaw('cp_nocost', rest);
+        // A run that resumes with an undefined cap is worse than one that
+        // refuses to resume: it looks healthy and never stops.
+        await expect(store.readCheckpoint('cp_nocost')).rejects.toThrow(/malformed budget state/);
+    });
+    it('refuses a NaN budget, which compares false against every limit', async () => {
+        await writeRaw('cp_nan', {
+            ...checkpoint({ id: 'cp_nan' }),
+            // JSON has no NaN; this is what a serialized one becomes.
+            costInfo: { totalCost: null },
+        });
+        await expect(store.readCheckpoint('cp_nan')).rejects.toThrow(/malformed budget state/);
+    });
+    it('refuses a missing guard state', async () => {
+        const { guardState: _dropped, ...rest } = checkpoint({ id: 'cp_noguard' });
+        await writeRaw('cp_noguard', rest);
+        await expect(store.readCheckpoint('cp_noguard')).rejects.toThrow(/malformed budget state/);
+    });
+    it('applies the same refusal to the listing path', async () => {
+        // Two read paths disagreeing about whether damage matters is how the
+        // lenient one gets trusted.
+        const { costInfo: _dropped, ...rest } = checkpoint({ id: 'cp_listed' });
+        await writeRaw('cp_listed', rest);
+        await expect(store.listCheckpoints()).rejects.toThrow(/malformed budget state/);
+    });
+    it('accepts a zero budget, which is a real value', async () => {
+        await store.writeCheckpoint(checkpoint({
+            id: 'cp_zero',
+            tokenUsage: {
+                promptTokens: 0,
+                completionTokens: 0,
+                totalTokens: 0,
+                cachedTokens: 0,
+                cacheWriteTokens: 0,
+            },
+            costInfo: { totalCost: 0 },
+            guardState: { iterationCount: 0, elapsedMs: 0 },
+        }));
+        expect(await store.readCheckpoint('cp_zero')).not.toBeNull();
+    });
+});
+//# sourceMappingURL=checkpoint-versioning.test.js.map

package/dist/store/__tests__/checkpoint-versioning.test.js.map

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

package/dist/store/__tests__/schema-adoption.test.d.ts

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

package/dist/store/__tests__/schema-adoption.test.d.ts.map

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

package/dist/store/__tests__/schema-adoption.test.js

@@ -0,0 +1,90 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createUserMessage } from '../../types/message/index.js';
+import { DiskSessionStore } from '../session/disk.js';
+/**
+ * The primitive is unit-tested next door. What matters here is that a store
+ * actually goes through it — a version that is stamped but never checked,
+ * or checked but never stamped, is the same silent read it replaces.
+ */
+const TENANT = 'tnt_schema';
+const THREAD = 'thd_schema';
+const actor = () => ({ kind: 'user', userId: 'usr_a', tenantId: TENANT });
+let rootDir;
+let store;
+beforeEach(() => {
+    rootDir = mkdtempSync(join(tmpdir(), 'namzu-schema-'));
+    store = new DiskSessionStore({ rootDir });
+});
+afterEach(() => {
+    rmSync(rootDir, { recursive: true, force: true });
+});
+async function seed() {
+    const project = await store.createProject({ tenantId: TENANT, name: 'p' }, TENANT);
+    const session = await store.createSession({ threadId: THREAD, projectId: project.id, currentActor: actor() }, TENANT);
+    return { projectId: project.id, sessionId: session.id };
+}
+const sessionPath = (projectId, sessionId) => join(rootDir, 'projects', projectId, 'sessions', sessionId, 'session.json');
+describe('what lands on disk', () => {
+    it('stamps a session record', async () => {
+        const { projectId, sessionId } = await seed();
+        const raw = JSON.parse(await readFile(sessionPath(projectId, sessionId), 'utf-8'));
+        expect(raw.schemaVersion).toBe(1);
+    });
+    it('stamps every line of the append-only message log', async () => {
+        const { projectId, sessionId } = await seed();
+        await store.appendMessage(sessionId, createUserMessage('one'), TENANT);
+        await store.appendMessage(sessionId, createUserMessage('two'), TENANT);
+        const log = await readFile(join(rootDir, 'projects', projectId, 'sessions', sessionId, 'messages.jsonl'), 'utf-8');
+        const lines = log.split('\n').filter((l) => l.length > 0);
+        expect(lines).toHaveLength(2);
+        // An append-only log is written by many builds over its lifetime, so
+        // its lines can legitimately differ in version — each carries its own.
+        for (const line of lines)
+            expect(JSON.parse(line).schemaVersion).toBe(1);
+    });
+});
+describe('what comes back off disk', () => {
+    it('reads a legacy record that predates the stamp', async () => {
+        const { projectId, sessionId } = await seed();
+        const path = sessionPath(projectId, sessionId);
+        const record = JSON.parse(await readFile(path, 'utf-8'));
+        record.schemaVersion = undefined;
+        await writeFile(path, JSON.stringify(record), 'utf-8');
+        // Every file written before this mechanism existed looks exactly
+        // like this, and has to keep opening.
+        expect(await store.getSession(sessionId, TENANT)).not.toBeNull();
+    });
+    it('refuses a record from a build that knew more than this one', async () => {
+        const { projectId, sessionId } = await seed();
+        const path = sessionPath(projectId, sessionId);
+        const record = JSON.parse(await readFile(path, 'utf-8'));
+        record.schemaVersion = 99;
+        record.somethingThisBuildDoesNotKnow = { important: true };
+        await writeFile(path, JSON.stringify(record), 'utf-8');
+        // Reading it would drop the unknown field, and the next write would
+        // destroy it. A refusal is recoverable by upgrading.
+        await expect(store.getSession(sessionId, TENANT)).rejects.toThrow(/schema version 99/);
+    });
+    it('refuses a message line from the future rather than skipping it', async () => {
+        const { projectId, sessionId } = await seed();
+        await store.appendMessage(sessionId, createUserMessage('fine'), TENANT);
+        const path = join(rootDir, 'projects', projectId, 'sessions', sessionId, 'messages.jsonl');
+        const line = JSON.parse((await readFile(path, 'utf-8')).trim());
+        await writeFile(path, `${JSON.stringify({ ...line, schemaVersion: 42 })}\n`, 'utf-8');
+        // Silently dropping a message the build cannot read would hand the
+        // model a conversation with a hole in it.
+        await expect(store.loadMessages(sessionId, TENANT)).rejects.toThrow(/schema version 42/);
+    });
+    it('still round-trips a normal write and read', async () => {
+        const { sessionId } = await seed();
+        await store.appendMessage(sessionId, createUserMessage('hello'), TENANT);
+        await store.appendMessage(sessionId, createUserMessage('world'), TENANT);
+        const loaded = await store.loadMessages(sessionId, TENANT);
+        expect(loaded.map((m) => m.content)).toEqual(['hello', 'world']);
+    });
+});
+//# sourceMappingURL=schema-adoption.test.js.map

package/dist/store/__tests__/schema-adoption.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-adoption.test.js","sourceRoot":"","sources":["../../../src/store/__tests__/schema-adoption.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;GAIG;AAEH,MAAM,MAAM,GAAG,YAAwB,CAAA;AACvC,MAAM,MAAM,GAAG,YAAwB,CAAA;AAEvC,MAAM,KAAK,GAAG,GAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;AAE7F,IAAI,OAAe,CAAA;AACnB,IAAI,KAAuB,CAAA;AAE3B,UAAU,CAAC,GAAG,EAAE;IACf,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAA;IACtD,KAAK,GAAG,IAAI,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;AAC1C,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACd,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA;AAEF,KAAK,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;IAClF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CACxC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAClE,MAAM,CACN,CAAA;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;AACxD,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,SAAoB,EAAE,SAAoB,EAAE,EAAE,CAClE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;AAE5E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QAClF,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7C,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;QACtE,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;QAEtE,MAAM,GAAG,GAAG,MAAM,QAAQ,CACzB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAC7E,OAAO,CACP,CAAA;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACzD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,qEAAqE;QACrE,uEAAuE;QACvE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,aAAa,GAAG,SAAS,CAAA;QAChC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;QAEtD,iEAAiE;QACjE,sCAAsC;QACtC,MAAM,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,aAAa,GAAG,EAAE,CAAA;QACzB,MAAM,CAAC,6BAA6B,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;QAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;QAEtD,oEAAoE;QACpE,qDAAqD;QACrD,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7C,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;QAEvE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAA;QAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/D,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAErF,mEAAmE;QACnE,0CAA0C;QAC1C,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAClC,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;QAExE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAC1D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/store/__tests__/schema.test.d.ts

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

package/dist/store/__tests__/schema.test.d.ts.map

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

package/dist/store/__tests__/schema.test.js

@@ -0,0 +1,93 @@
+import { describe, expect, it } from 'vitest';
+import { INITIAL_SCHEMA_VERSION, SchemaVersionError, defineSchema, migrate, stamp, } from '../schema.js';
+/**
+ * Every persisted read was `JSON.parse(raw) as T`. A record from an older
+ * build arrived with fields missing and nothing said so; a record from a
+ * NEWER build was read partially and, once written back, permanently lost
+ * whatever this build did not understand.
+ */
+const V1 = defineSchema({ kind: 'thing', current: 1, migrations: {} });
+const V3 = defineSchema({
+    kind: 'thing',
+    current: 3,
+    migrations: {
+        1: (r) => ({ ...r, addedInV2: true }),
+        2: (r) => ({ ...r, addedInV3: true }),
+    },
+});
+describe('reading an older record', () => {
+    it('treats an unstamped record as the first version', () => {
+        // Every file written before this mechanism existed IS version 1 —
+        // by definition, not by assumption.
+        const migrated = migrate(V3, { name: 'legacy' });
+        expect(migrated.addedInV2).toBe(true);
+        expect(migrated.addedInV3).toBe(true);
+        expect(migrated.schemaVersion).toBe(3);
+    });
+    it('runs only the steps that are missing', () => {
+        const migrated = migrate(V3, { schemaVersion: 2, name: 'x' });
+        expect(migrated.addedInV2).toBeUndefined();
+        expect(migrated.addedInV3).toBe(true);
+    });
+    it('leaves a current record alone apart from the stamp', () => {
+        const migrated = migrate(V3, { schemaVersion: 3, name: 'x' });
+        expect(migrated).toEqual({ schemaVersion: 3, name: 'x' });
+    });
+});
+describe('reading a newer record', () => {
+    it('refuses rather than reading it partially', () => {
+        expect(() => migrate(V1, { schemaVersion: 2, name: 'from the future' })).toThrow(SchemaVersionError);
+    });
+    it('says what it found and what it understands', () => {
+        try {
+            migrate(V1, { schemaVersion: 7 });
+            expect.unreachable();
+        }
+        catch (err) {
+            const e = err;
+            expect(e.found).toBe(7);
+            expect(e.supported).toBe(1);
+            // A refusal is recoverable by upgrading. A partial read that
+            // gets written back is not.
+            expect(e.message).toContain('Upgrade');
+        }
+    });
+});
+describe('declaring a schema', () => {
+    it('rejects a gap in the migration chain at declaration time', () => {
+        // Discovered here, not in production by a user whose session will
+        // not open.
+        expect(() => defineSchema({ kind: 'gappy', current: 3, migrations: { 1: (r) => r } })).toThrow(/no migration from version 2 to 3/);
+    });
+    it('rejects a version below the first one', () => {
+        expect(() => defineSchema({ kind: 'x', current: 0, migrations: {} })).toThrow(/integer >= 1/);
+    });
+    it('accepts a schema that has never migrated', () => {
+        expect(() => defineSchema({ kind: 'x', current: INITIAL_SCHEMA_VERSION, migrations: {} })).not.toThrow();
+    });
+});
+describe('stamping', () => {
+    it('marks a record with the version this build writes', () => {
+        expect(stamp(V3, { a: 1 })).toEqual({ a: 1, schemaVersion: 3 });
+    });
+    it('leaves an array untouched', () => {
+        // There is nowhere on an array to put a field that survives
+        // `JSON.stringify`, and wrapping it would change every file already
+        // written.
+        const list = [{ a: 1 }, { a: 2 }];
+        expect(stamp(V3, list)).toEqual(list);
+    });
+    it('round-trips through JSON', () => {
+        const written = JSON.stringify(stamp(V1, { name: 'x' }));
+        expect(migrate(V1, JSON.parse(written))).toEqual({
+            name: 'x',
+            schemaVersion: 1,
+        });
+    });
+    it('passes a non-object through both ways', () => {
+        expect(stamp(V3, null)).toBeNull();
+        expect(migrate(V3, null)).toBeNull();
+        expect(migrate(V3, [1, 2])).toEqual([1, 2]);
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/store/__tests__/schema.test.js.map

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

package/dist/store/memory/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/memory/disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAgB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,WAAW,CAAQ;gBAEf,MAAM,EAAE,qBAAqB;IAKzC,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,UAAU,GAErB;IAED,OAAO,CAAC,WAAW;YAIL,UAAU;IAuBlB,MAAM,CACX,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAgCzD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAcrD,MAAM,CACX,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IA8ClC,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAatC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKpE,QAAQ,IAAI,mBAAmB;YAIjB,YAAY;CAI1B"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/memory/disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,6BAA6B,CAAA;AAGpC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,uBAAuB,CAAA;AAElE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAYhD,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,eAAgB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,WAAW,CAAQ;gBAEf,MAAM,EAAE,qBAAqB;IAKzC,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,UAAU,GAErB;IAED,OAAO,CAAC,WAAW;YAIL,UAAU;IAuBlB,MAAM,CACX,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAgCzD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAcrD,MAAM,CACX,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAClC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IA8ClC,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAatC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKpE,QAAQ,IAAI,mBAAmB;YAIjB,YAAY;CAI1B"}

package/dist/store/memory/disk.js

@@ -1,8 +1,19 @@
-import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, unlink } from 'node:fs/promises';
 import { join } from 'node:path';
+import { atomicWriteFile } from '../../utils/atomic-write.js';
 import { generateMemoryId } from '../../utils/id.js';
 import { getRootLogger } from '../../utils/logger.js';
+import { defineSchema, migrate, stamp } from '../schema.js';
 import { InMemoryMemoryIndex } from './index.js';
+/**
+ * This store's on-disk format, versioned as a unit — which is how a
+ * migration would actually be written and shipped, and it keeps every call
+ * site free of schema plumbing.
+ *
+ * Bump `current` and add the migration for the step you are leaving when
+ * the shape changes.
+ */
+const SCHEMA = defineSchema({ kind: 'memory-store', current: 1, migrations: {} });
 export class DiskMemoryStore {
     baseDir;
     log;
@@ -27,7 +38,7 @@ export class DiskMemoryStore {
         await mkdir(this.contentDir, { recursive: true });
         try {
             const raw = await readFile(this.indexPath, 'utf-8');
-            const entries = JSON.parse(raw);
+            const entries = migrate(SCHEMA, JSON.parse(raw));
             this.index.rebuild(entries);
             this.log.info('Memory index loaded', { count: entries.length });
         }
@@ -72,7 +83,7 @@ export class DiskMemoryStore {
             return undefined;
         try {
             const raw = await readFile(this.contentPath(id), 'utf-8');
-            return JSON.parse(raw);
+            return migrate(SCHEMA, JSON.parse(raw));
         }
         catch {
             this.log.warn('Failed to read memory content', { memoryId: id });
@@ -99,7 +110,7 @@ export class DiskMemoryStore {
             updates.metadata !== undefined) {
             try {
                 const raw = await readFile(this.contentPath(id), 'utf-8');
-                const existingContent = JSON.parse(raw);
+                const existingContent = migrate(SCHEMA, JSON.parse(raw));
                 const updatedContent = {
                     ...existingContent,
                     content: updates.content ?? existingContent.content,
@@ -137,18 +148,7 @@ export class DiskMemoryStore {
         await atomicWriteJson(this.indexPath, entries);
     }
 }
-async function atomicWriteFile(filePath, content) {
-    const tempPath = `${filePath}.tmp`;
-    try {
-        await writeFile(tempPath, content, 'utf-8');
-        await rename(tempPath, filePath);
-    }
-    catch (err) {
-        await unlink(tempPath).catch(() => undefined);
-        throw err;
-    }
-}
 async function atomicWriteJson(filePath, value) {
-    await atomicWriteFile(filePath, JSON.stringify(value, null, 2));
+    await atomicWriteFile(filePath, JSON.stringify(stamp(SCHEMA, value), null, 2));
 }
 //# sourceMappingURL=disk.js.map

package/dist/store/memory/disk.js.map

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

package/dist/store/run/disk.d.ts

@@ -1,5 +1,12 @@
 import type { CheckpointId, IterationCheckpoint } from '../../types/hitl/index.js';
 import type { Run, RunEvent, RunStoreConfig } from '../../types/run/index.js';
+/** One finished tool call, recovered from the transcript. */
+export interface CompletedToolRecord {
+    readonly toolUseId: string;
+    readonly toolName: string;
+    readonly result: string;
+    readonly isError: boolean;
+}
 export declare class RunDiskStore {
     private baseDir;
     private runDir;
@@ -9,6 +16,22 @@ export declare class RunDiskStore {
     private requireInit;
     initRun(runId: string, parentRunId?: string): Promise<string>;
     appendEvent(event: RunEvent): Promise<void>;
+    /**
+     * Every tool call this run has already finished, keyed by `toolUseId`.
+     *
+     * A batch's results are pushed onto the history only once the WHOLE
+     * batch settles, so a hard kill part-way through loses every result
+     * that had already come back — and the resumed run re-executes those
+     * calls. For a `write_file` that is waste; for a payment or an email it
+     * is a second one.
+     *
+     * Nothing new has to be written to make that recoverable: the executor
+     * already awaits a `tool_completed` event per tool, inline, carrying the
+     * id, the name, the result and the error flag, and the transcript
+     * already persists it. The record was durable all along and simply
+     * never read back.
+     */
+    readCompletedTools(): Promise<Map<string, CompletedToolRecord>>;
     writeRunMeta(run: Run): Promise<void>;
     writeMessages(run: Run): Promise<void>;
     writeReport(content: string): Promise<string>;

package/dist/store/run/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/run/disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG7E,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,SAAS,CAAmC;gBAExC,MAAM,EAAE,cAAc;IAKlC,OAAO,CAAC,WAAW;IAOb,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrC,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnD,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAW/E,eAAe,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAsBjD,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;WASpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAC9C,KAAK,CAAC;QACL,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CACF;IAWK,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CA8CzC"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/run/disk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAe7E,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CACzB;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,SAAS,CAAmC;gBAExC,MAAM,EAAE,cAAc;IAKlC,OAAO,CAAC,WAAW;IAOb,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7D,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;;;;;;;;;;;;;OAcG;IACG,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IA0C/D,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrC,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnD,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/D,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAW/E,eAAe,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA8BjD,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;WASpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAC9C,KAAK,CAAC;QACL,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CACF;IAWK,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CA8CzC"}