@deepthonk/core 0.1.4 → 0.2.0

package/dist/budgetTracker.js

@@ -4,6 +4,7 @@ export class BudgetTracker {
     config;
     usage = emptyUsage();
     prices;
+    callReservations = new Set();
     constructor(config) {
         this.config = config;
         this.prices = config.budget?.prices ?? [];
@@ -28,8 +29,38 @@ export class BudgetTracker {
             }
         }
     }
-    record(result, fallback = { model: "unknown" }) {
+    reserveCall(phase) {
+        const maxCalls = this.config.budget?.maxCalls;
+        if (maxCalls !== undefined && this.usage.calls + this.callReservations.size >= maxCalls) {
+            throw new BudgetExceededError(`Cannot dispatch ${phase}: calls ${this.usage.calls} plus ${this.callReservations.size} active reservations reached maxCalls ${maxCalls}.`, {
+                code: "budget.calls_exhausted",
+                fix: "Raise maxCalls or use a smaller profile."
+            });
+        }
+        const reservation = Symbol(phase);
+        this.callReservations.add(reservation);
+        return reservation;
+    }
+    releaseCall(reservation) {
+        this.callReservations.delete(reservation);
+    }
+    failCall(reservation) {
+        if (!this.callReservations.delete(reservation)) {
+            throw new ConfigError("Model call reservation was already settled.", { code: "budget.reservation_invalid" });
+        }
+        this.usage.calls += 1;
+        return { calls: 1, inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    }
+    record(result, fallback = { model: "unknown" }, reservation) {
         const calls = fallback.calls ?? 1;
+        if (reservation !== undefined) {
+            if (!this.callReservations.delete(reservation)) {
+                throw new ConfigError("Model call reservation was already settled.", { code: "budget.reservation_invalid" });
+            }
+            if (calls !== 1) {
+                throw new ConfigError("A reserved model call must settle exactly one logical invocation.", { code: "budget.reservation_invalid" });
+            }
+        }
         this.usage.calls += calls;
         const inputCacheHitTokens = result.usage?.inputCacheHitTokens ?? 0;
         const inputCacheMissTokens = result.usage?.inputCacheMissTokens ?? 0;

package/dist/budgetTracker.js.map

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

package/dist/checkpointStore.d.ts

@@ -0,0 +1,56 @@
+export declare const traceSchemaVersion: 2;
+export interface CheckpointJob<T> {
+    id: string;
+    input: unknown;
+    run(signal: AbortSignal): Promise<T>;
+    receiptUsage?: () => unknown;
+}
+export interface PhaseManifest {
+    schema_version: 2;
+    phase_key: string;
+    manifest_hash: string;
+    work: Array<{
+        work_id: string;
+        input_hash: string;
+    }>;
+    created_at: string;
+}
+export interface WorkCheckpoint<T = unknown> {
+    schema_version: 2;
+    phase_key: string;
+    work_id: string;
+    input_hash: string;
+    output_hash: string;
+    output: T;
+    usage?: unknown;
+    usage_hash: string;
+    attempt_id: string;
+    completed_at: string;
+}
+export interface PhaseCommit {
+    schema_version: 2;
+    phase_key: string;
+    manifest_hash: string;
+    checkpoint_hashes: Record<string, string>;
+    artifact_hashes: Record<string, string>;
+    committed_at: string;
+}
+export declare function runCheckpointedPhase<T>(options: {
+    runDir: string;
+    phaseKey: string;
+    jobs: readonly CheckpointJob<T>[];
+    concurrency: number;
+    signal?: AbortSignal;
+    validateOutput?: (output: unknown) => output is T;
+    onResult?: (output: T, context: {
+        workId: string;
+        reused: boolean;
+        receiptUsage: unknown;
+    }) => Promise<void>;
+}): Promise<T[]>;
+export declare function writePhaseCommit(runDir: string, phaseKey: string, artifacts: Record<string, unknown>): Promise<PhaseCommit>;
+export declare function validatePhaseCommit(runDir: string, phaseKey: string, artifacts?: Record<string, unknown>): Promise<PhaseCommit>;
+export declare function validatePhaseCommitIfPresent(runDir: string, phaseKey: string, artifacts: Record<string, unknown>): Promise<PhaseCommit | undefined>;
+export declare function readValidatedPhaseReceiptUsage(runDir: string, phaseKey: string): Promise<unknown[]>;
+export declare function hashValue(value: unknown): string;
+export declare function stableJson(value: unknown): string;

package/dist/checkpointStore.js

@@ -0,0 +1,351 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { ConfigError } from "./errors.js";
+import { runLimitedPhase } from "./phaseRunner.js";
+export const traceSchemaVersion = 2;
+export async function runCheckpointedPhase(options) {
+    assertUniqueWorkIds(options.jobs);
+    const manifest = await ensurePhaseManifest(options.runDir, options.phaseKey, options.jobs);
+    const results = new Array(options.jobs.length);
+    const missing = [];
+    const reused = [];
+    for (let index = 0; index < options.jobs.length; index += 1) {
+        const job = options.jobs[index];
+        const inputHash = manifest.work[index].input_hash;
+        const checkpoint = await readValidCheckpoint(options.runDir, options.phaseKey, job.id, inputHash, options.validateOutput);
+        if (!checkpoint) {
+            missing.push({ index, job, inputHash });
+            continue;
+        }
+        results[index] = checkpoint.output;
+        reused.push({ job, checkpoint });
+    }
+    if (options.onResult && reused.length > 0) {
+        function* reusedCallbacks() {
+            for (const item of reused) {
+                yield async () => {
+                    await options.onResult(item.checkpoint.output, {
+                        workId: item.job.id,
+                        reused: true,
+                        receiptUsage: item.checkpoint.usage
+                    });
+                };
+            }
+        }
+        // Receipt replay is local I/O, not provider work. Give it a separate bounded
+        // fan-out so TraceStore can coalesce append-ready rows even when model
+        // concurrency is deliberately one.
+        await runLimitedPhase(reusedCallbacks(), Math.min(32, reused.length), { signal: options.signal });
+    }
+    function* pendingJobs() {
+        for (const pending of missing) {
+            yield async (signal) => {
+                const output = await pending.job.run(signal);
+                if (options.validateOutput && !options.validateOutput(output)) {
+                    throw new ConfigError(`Checkpoint job ${pending.job.id} produced an invalid output.`, {
+                        code: "trace.checkpoint_output_invalid",
+                        retryable: false
+                    });
+                }
+                const usage = pending.job.receiptUsage?.();
+                await writeCheckpoint(options.runDir, options.phaseKey, pending.job.id, pending.inputHash, output, usage);
+                await options.onResult?.(output, { workId: pending.job.id, reused: false, receiptUsage: usage });
+                return { index: pending.index, output };
+            };
+        }
+    }
+    const completed = await runLimitedPhase(pendingJobs(), options.concurrency, { signal: options.signal });
+    for (const item of completed)
+        results[item.index] = item.output;
+    if (results.some((value) => value === undefined)) {
+        throw new ConfigError(`Phase ${options.phaseKey} did not produce every checkpointed result.`, {
+            code: "trace.checkpoint_incomplete",
+            retryable: true
+        });
+    }
+    return results;
+}
+export async function writePhaseCommit(runDir, phaseKey, artifacts) {
+    await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        throw traceIntegrityError(`Missing manifest for phase ${phaseKey}.`);
+    validateManifest(manifest, phaseKey);
+    const checkpointHashes = {};
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            throw traceIntegrityError(`Missing or invalid checkpoint ${work.work_id} for phase ${phaseKey}.`);
+        checkpointHashes[work.work_id] = checkpointBindingHash(checkpoint);
+    }
+    const commit = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        manifest_hash: manifest.manifest_hash,
+        checkpoint_hashes: checkpointHashes,
+        artifact_hashes: Object.fromEntries(Object.entries(artifacts).map(([name, value]) => [name, hashValue(value)])),
+        committed_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(commitPath(runDir, phaseKey), commit);
+    return commit;
+}
+export async function validatePhaseCommit(runDir, phaseKey, artifacts) {
+    const commit = await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    if (!commit || commit.schema_version !== 2 || commit.phase_key !== phaseKey) {
+        throw traceIntegrityError(`Missing or invalid phase commit for ${phaseKey}.`);
+    }
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        throw traceIntegrityError(`Missing manifest for committed phase ${phaseKey}.`);
+    validateManifest(manifest, phaseKey);
+    if (commit.manifest_hash !== manifest.manifest_hash) {
+        throw traceIntegrityError(`Manifest hash changed for committed phase ${phaseKey}.`);
+    }
+    const expectedCheckpointHashes = {};
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            throw traceIntegrityError(`Checkpoint ${work.work_id} is invalid for committed phase ${phaseKey}.`);
+        expectedCheckpointHashes[work.work_id] = checkpointBindingHash(checkpoint);
+    }
+    if (stableJson(commit.checkpoint_hashes) !== stableJson(expectedCheckpointHashes)) {
+        throw traceIntegrityError(`Checkpoint bindings changed for committed phase ${phaseKey}.`);
+    }
+    if (artifacts) {
+        const expectedArtifacts = Object.fromEntries(Object.entries(artifacts).map(([name, value]) => [name, hashValue(value)]));
+        if (stableJson(commit.artifact_hashes) !== stableJson(expectedArtifacts)) {
+            throw traceIntegrityError(`Artifact bindings changed for committed phase ${phaseKey}.`);
+        }
+    }
+    return commit;
+}
+export async function validatePhaseCommitIfPresent(runDir, phaseKey, artifacts) {
+    const commit = await readJsonStrictOptional(commitPath(runDir, phaseKey));
+    if (!commit)
+        return undefined;
+    return validatePhaseCommit(runDir, phaseKey, artifacts);
+}
+export async function readValidatedPhaseReceiptUsage(runDir, phaseKey) {
+    const manifest = await readPhaseManifest(runDir, phaseKey);
+    if (!manifest)
+        return [];
+    validateManifest(manifest, phaseKey);
+    const usage = [];
+    for (const work of manifest.work) {
+        const checkpoint = await readValidCheckpoint(runDir, phaseKey, work.work_id, work.input_hash);
+        if (!checkpoint)
+            continue;
+        if (Array.isArray(checkpoint.usage))
+            usage.push(...checkpoint.usage);
+    }
+    return usage;
+}
+export function hashValue(value) {
+    return `sha256:${createHash("sha256").update(stableJson(value)).digest("hex")}`;
+}
+export function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .filter(([, inner]) => inner !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, inner]) => `${JSON.stringify(key)}:${stableJson(inner)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+async function ensurePhaseManifest(runDir, phaseKey, jobs) {
+    const work = jobs.map((job) => ({ work_id: job.id, input_hash: hashValue(job.input) }));
+    const manifestHash = hashValue({ schema_version: 2, phase_key: phaseKey, work });
+    const existing = await readPhaseManifest(runDir, phaseKey);
+    if (existing) {
+        validateManifest(existing, phaseKey);
+        if (existing.manifest_hash !== manifestHash || stableJson(existing.work) !== stableJson(work)) {
+            throw traceIntegrityError(`Manifest inputs changed for phase ${phaseKey}.`);
+        }
+        return existing;
+    }
+    const manifest = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        manifest_hash: manifestHash,
+        work,
+        created_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(manifestPath(runDir, phaseKey), manifest);
+    return manifest;
+}
+async function readPhaseManifest(runDir, phaseKey) {
+    return readJsonStrictOptional(manifestPath(runDir, phaseKey));
+}
+function validateManifest(manifest, phaseKey) {
+    const workValid = Array.isArray(manifest.work) &&
+        new Set(manifest.work.map((item) => item.work_id)).size === manifest.work.length &&
+        manifest.work.every((item) => item &&
+            typeof item.work_id === "string" &&
+            item.work_id.length > 0 &&
+            typeof item.input_hash === "string" &&
+            /^sha256:[0-9a-f]{64}$/.test(item.input_hash));
+    const expectedHash = hashValue({ schema_version: 2, phase_key: phaseKey, work: manifest.work });
+    if (manifest.schema_version !== 2 ||
+        manifest.phase_key !== phaseKey ||
+        manifest.manifest_hash !== expectedHash ||
+        !workValid) {
+        throw traceIntegrityError(`Manifest is invalid for phase ${phaseKey}.`);
+    }
+}
+async function readValidCheckpoint(runDir, phaseKey, workId, inputHash, validateOutput) {
+    const checkpoint = await readJson(checkpointPath(runDir, phaseKey, workId));
+    if (!checkpoint)
+        return undefined;
+    if (checkpoint.schema_version !== 2 ||
+        checkpoint.phase_key !== phaseKey ||
+        checkpoint.work_id !== workId ||
+        checkpoint.input_hash !== inputHash ||
+        checkpoint.output_hash !== hashValue(checkpoint.output) ||
+        checkpoint.usage_hash !== hashValue(checkpoint.usage ?? null) ||
+        !/^sha256:[0-9a-f]{64}$/.test(checkpoint.output_hash) ||
+        !/^sha256:[0-9a-f]{64}$/.test(checkpoint.usage_hash) ||
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(checkpoint.attempt_id) ||
+        typeof checkpoint.completed_at !== "string" ||
+        !Number.isFinite(Date.parse(checkpoint.completed_at)) ||
+        new Date(checkpoint.completed_at).toISOString() !== checkpoint.completed_at ||
+        (validateOutput && !validateOutput(checkpoint.output))) {
+        return undefined;
+    }
+    if (!(await promptReferencesValid(runDir, checkpoint.output)))
+        return undefined;
+    return checkpoint;
+}
+async function promptReferencesValid(runDir, value) {
+    const references = [];
+    collectPromptReferences(value, references);
+    for (const reference of references) {
+        if (!/^sha256:[0-9a-f]{64}$/.test(reference.sha256))
+            return false;
+        const path = `artifacts/prompts/${reference.sha256.slice("sha256:".length)}.json`;
+        if (reference.path !== path)
+            return false;
+        try {
+            const raw = await readFile(join(runDir, path), "utf8");
+            const digest = `sha256:${createHash("sha256").update(raw).digest("hex")}`;
+            if (digest !== reference.sha256)
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+function collectPromptReferences(value, out) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectPromptReferences(item, out);
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    const record = value;
+    const promptRef = record.promptRef;
+    if (promptRef && typeof promptRef === "object" && !Array.isArray(promptRef)) {
+        const reference = promptRef;
+        if (typeof reference.sha256 === "string" && typeof reference.path === "string") {
+            out.push({ sha256: reference.sha256, path: reference.path });
+        }
+        else {
+            out.push({ sha256: "invalid", path: "invalid" });
+        }
+    }
+    for (const [key, inner] of Object.entries(record)) {
+        if (key !== "promptRef")
+            collectPromptReferences(inner, out);
+    }
+}
+async function writeCheckpoint(runDir, phaseKey, workId, inputHash, output, usage) {
+    const checkpoint = {
+        schema_version: 2,
+        phase_key: phaseKey,
+        work_id: workId,
+        input_hash: inputHash,
+        output_hash: hashValue(output),
+        output,
+        usage,
+        usage_hash: hashValue(usage ?? null),
+        attempt_id: randomUUID(),
+        completed_at: new Date().toISOString()
+    };
+    await writeJsonAtomic(checkpointPath(runDir, phaseKey, workId), checkpoint);
+}
+function checkpointBindingHash(checkpoint) {
+    return hashValue({
+        schema_version: checkpoint.schema_version,
+        phase_key: checkpoint.phase_key,
+        work_id: checkpoint.work_id,
+        input_hash: checkpoint.input_hash,
+        output_hash: checkpoint.output_hash,
+        usage_hash: checkpoint.usage_hash,
+        attempt_id: checkpoint.attempt_id,
+        completed_at: checkpoint.completed_at
+    });
+}
+function assertUniqueWorkIds(jobs) {
+    const ids = new Set();
+    for (const job of jobs) {
+        if (!job.id || ids.has(job.id)) {
+            throw new ConfigError(`Checkpoint work IDs must be non-empty and unique; received ${job.id || "empty ID"}.`, {
+                code: "trace.work_id_invalid",
+                retryable: false
+            });
+        }
+        ids.add(job.id);
+    }
+}
+function manifestPath(runDir, phaseKey) {
+    return join(runDir, "manifests", `${phaseFileKey(phaseKey)}.json`);
+}
+function commitPath(runDir, phaseKey) {
+    return join(runDir, "commits", `${phaseFileKey(phaseKey)}.json`);
+}
+function checkpointPath(runDir, phaseKey, workId) {
+    return join(runDir, "checkpoints", phaseFileKey(phaseKey), `${hashValue(workId).slice("sha256:".length)}.json`);
+}
+function phaseFileKey(phaseKey) {
+    return encodeURIComponent(phaseKey).replaceAll("%", "_");
+}
+async function readJson(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        return undefined;
+    }
+}
+async function readJsonStrictOptional(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw traceIntegrityError(`Could not parse ${path}: ${error.message}`);
+    }
+}
+async function writeJsonAtomic(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await rename(temporary, path);
+}
+function traceIntegrityError(message) {
+    return new ConfigError(message, {
+        code: "resume.trace_v2_integrity",
+        retryable: false,
+        fix: "Restore the matching manifest/checkpoint/commit files, or start a fresh run."
+    });
+}
+//# sourceMappingURL=checkpointStore.js.map

package/dist/checkpointStore.js.map

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

package/dist/critique.d.ts

@@ -1,2 +1,4 @@
 import type { Candidate, Comparison } from "./schemas.js";
-export declare function aggregateCritiques(candidates: Candidate[], comparisons: Comparison[]): Map<string, string>;
+export declare function aggregateCritiques(candidates: Candidate[], comparisons: Comparison[], options?: {
+    aggregateChars?: number;
+}): Map<string, string>;

package/dist/critique.js

@@ -1,21 +1,22 @@
-export function aggregateCritiques(candidates, comparisons) {
+export function aggregateCritiques(candidates, comparisons, options = {}) {
+    const aggregateChars = options.aggregateChars ?? 16_000;
     const chunks = new Map(candidates.map((candidate) => [
         candidate.id,
         {
             wins: [],
             ties: [],
-            losses: []
+            losses: [],
+            seen: new Set()
         }
     ]));
     for (const comparison of comparisons) {
         const aBucket = bucketFor("A", comparison.winner);
         const bBucket = bucketFor("B", comparison.winner);
-        chunks.get(comparison.presentedAOriginalId)?.[aBucket].push(selfRelative(comparison.critiqueForA, "A"));
-        chunks.get(comparison.presentedBOriginalId)?.[bBucket].push(selfRelative(comparison.critiqueForB, "B"));
+        addCritique(chunks.get(comparison.presentedAOriginalId), aBucket, selfRelative(comparison.critiqueForA, "A"));
+        addCritique(chunks.get(comparison.presentedBOriginalId), bBucket, selfRelative(comparison.critiqueForB, "B"));
     }
-    return new Map([...chunks.entries()].map(([id, critiques]) => [
-        id,
-        [...critiques.wins, ...critiques.ties, ...critiques.losses].filter(Boolean).length > 0
+    return new Map([...chunks.entries()].map(([id, critiques]) => {
+        const value = [...critiques.wins, ...critiques.ties, ...critiques.losses].filter(Boolean).length > 0
             ? [
                 formatSection("Feedback from comparisons this solution won", critiques.wins),
                 formatSection("Feedback from comparisons this solution tied", critiques.ties),
@@ -23,8 +24,22 @@ export function aggregateCritiques(candidates, comparisons) {
             ]
                 .filter(Boolean)
                 .join("\n\n")
-            : "No specific critique was produced. Improve correctness, completeness, and clarity."
-    ]));
+            : "No specific critique was produced. Improve correctness, completeness, and clarity.";
+        return [id, truncateCritique(value, aggregateChars)];
+    }));
+}
+function addCritique(chunks, bucket, critique) {
+    const normalized = critique.trim();
+    if (!chunks || !normalized || chunks.seen.has(normalized))
+        return;
+    chunks.seen.add(normalized);
+    chunks[bucket].push(normalized);
+}
+function truncateCritique(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    const marker = "\n\n[Critique truncated.]";
+    return `${value.slice(0, Math.max(0, maxChars - marker.length))}${marker}`.slice(0, maxChars);
 }
 function bucketFor(side, winner) {
     if (winner === "tie")

package/dist/critique.js.map

@@ -1 +1 @@
-{"version":3,"file":"critique.js","sourceRoot":"","sources":["../src/critique.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"critique.js","sourceRoot":"","sources":["../src/critique.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,UAAuB,EACvB,WAAyB,EACzB,UAAuC,EAAE;IAEzC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;QAC5B,SAAS,CAAC,EAAE;QACZ;YACE,IAAI,EAAE,EAAc;YACpB,IAAI,EAAE,EAAc;YACpB,MAAM,EAAE,EAAc;YACtB,IAAI,EAAE,IAAI,GAAG,EAAU;SACxB;KACF,CAAC,CACH,CAAC;IACF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAClD,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9G,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,IAAI,GAAG,CACZ,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,EAAoB,EAAE;QAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;YAClG,CAAC,CAAC;gBACE,aAAa,CAAC,6CAA6C,EAAE,SAAS,CAAC,IAAI,CAAC;gBAC5E,aAAa,CAAC,8CAA8C,EAAE,SAAS,CAAC,IAAI,CAAC;gBAC7E,aAAa,CAAC,8CAA8C,EAAE,SAAS,CAAC,MAAM,CAAC;aAChF;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,MAAM,CAAC;YACjB,CAAC,CAAC,oFAAoF,CAAC;QACzF,OAAO,CAAC,EAAE,EAAE,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,MAA2F,EAC3F,MAAkC,EAClC,QAAgB;IAEhB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO;IAClE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,QAAgB;IACvD,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,2BAA2B,CAAC;IAC3C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,SAAS,CAAC,IAAe,EAAE,MAAyB;IAC3D,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7C,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,SAAmB;IACvD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,GAAG,KAAK,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,IAAe;IACjD,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,OAAO,IAAI;SACR,UAAU,CAAC,YAAY,IAAI,EAAE,EAAE,eAAe,CAAC;SAC/C,UAAU,CAAC,YAAY,IAAI,EAAE,EAAE,eAAe,CAAC;SAC/C,UAAU,CAAC,aAAa,IAAI,EAAE,EAAE,eAAe,CAAC;SAChD,UAAU,CAAC,aAAa,IAAI,EAAE,EAAE,eAAe,CAAC;SAChD,UAAU,CAAC,YAAY,KAAK,EAAE,EAAE,oBAAoB,CAAC;SACrD,UAAU,CAAC,YAAY,KAAK,EAAE,EAAE,oBAAoB,CAAC;SACrD,UAAU,CAAC,aAAa,KAAK,EAAE,EAAE,oBAAoB,CAAC;SACtD,UAAU,CAAC,aAAa,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./bradleyTerry.js";
 export * from "./artifacts.js";
 export * from "./budget.js";
 export * from "./budgetTracker.js";
+export * from "./checkpointStore.js";
 export * from "./critique.js";
 export * from "./errors.js";
 export * from "./json.js";
@@ -10,6 +11,7 @@ export * from "./pairScheduler.js";
 export * from "./phaseRunner.js";
 export * from "./prompts.js";
 export * from "./rng.js";
+export { assertNoLegacyRedactedBudget, repairLegacyBudgetConfig } from "./resume.js";
 export * from "./runner.js";
 export * from "./schemas.js";
 export * from "./services.js";

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./bradleyTerry.js";
 export * from "./artifacts.js";
 export * from "./budget.js";
 export * from "./budgetTracker.js";
+export * from "./checkpointStore.js";
 export * from "./critique.js";
 export * from "./errors.js";
 export * from "./json.js";
@@ -10,6 +11,7 @@ export * from "./pairScheduler.js";
 export * from "./phaseRunner.js";
 export * from "./prompts.js";
 export * from "./rng.js";
+export { assertNoLegacyRedactedBudget, repairLegacyBudgetConfig } from "./resume.js";
 export * from "./runner.js";
 export * from "./schemas.js";
 export * from "./services.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}