@sema-agent/core 1.279.0

package/dist/core/context-guard.js

@@ -0,0 +1,110 @@
+import { DEFAULT_CHARS_PER_TOKEN, estimateContextTokens, estimateTokens } from "../internal/harness.js";
+import { isToolResult, messageRole } from "./message-utils.js";
+const GUARD_FRACTION = 0.85;
+function isSummary(m) {
+    return messageRole(m) === "compactionSummary";
+}
+export function trimToBudget(messages, budgetTokens, anchoredTotalTokens, charsPerToken) {
+    const cpt = charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
+    const anchored = anchoredTotalTokens !== undefined;
+    let structuralTotal = 0;
+    for (const m of messages) {
+        structuralTotal += estimateTokens(m, cpt);
+    }
+    const total = anchored ? anchoredTotalTokens : structuralTotal;
+    if (total <= budgetTokens || messages.length <= 1) {
+        return messages;
+    }
+    const anchorIdx = anchored ? (estimateContextTokens(messages, cpt).lastUsageIndex ?? -1) : -1;
+    const summaries = messages.filter(isSummary);
+    let summaryTokens = 0;
+    for (const s of summaries) {
+        summaryTokens += estimateTokens(s, cpt);
+    }
+    const nonSummary = [];
+    const reductions = [];
+    let reductionSum = 0;
+    for (let i = 0; i < messages.length; i++) {
+        if (isSummary(messages[i]))
+            continue;
+        nonSummary.push(messages[i]);
+        const r = i > anchorIdx ? estimateTokens(messages[i], cpt) : 0;
+        reductions.push(r);
+        reductionSum += r;
+    }
+    const requiredReduction = total - budgetTokens;
+    let start;
+    if (anchored && reductionSum <= requiredReduction) {
+        start = nonSummary.length - 1;
+    }
+    else {
+        const tailBudget = Math.max(0, reductionSum - requiredReduction);
+        let acc = 0;
+        start = nonSummary.length;
+        for (let i = nonSummary.length - 1; i >= 0; i--) {
+            acc += reductions[i];
+            if (acc > tailBudget && i + 1 < nonSummary.length) {
+                start = i + 1;
+                break;
+            }
+            start = i;
+        }
+    }
+    while (start < nonSummary.length && isToolResult(nonSummary[start])) {
+        start++;
+    }
+    if (start >= nonSummary.length) {
+        start = nonSummary.length - 1;
+        while (start > 0 && isToolResult(nonSummary[start])) {
+            start--;
+        }
+        if (isToolResult(nonSummary[start])) {
+            start = nonSummary.length - 1;
+        }
+    }
+    const keptTail = new Set(nonSummary.slice(start));
+    return messages.filter((m) => isSummary(m) || keptTail.has(m));
+}
+export function dropOrphanToolResults(messages) {
+    const seenCallIds = new Set();
+    let orphanAt = -1;
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role === "assistant" && Array.isArray(m.content)) {
+            for (const c of m.content) {
+                if (c?.type === "toolCall" && typeof c.id === "string")
+                    seenCallIds.add(c.id);
+            }
+        }
+        else if (m.role === "toolResult" && !seenCallIds.has(m.toolCallId ?? "")) {
+            orphanAt = i;
+            break;
+        }
+    }
+    if (orphanAt === -1) {
+        return { messages, dropped: [] };
+    }
+    const dropped = [];
+    const out = messages.slice(0, orphanAt);
+    const roleOf = (i) => i < 0 || i >= messages.length ? "(none)" : (messages[i].role ?? "(unknown)");
+    for (let i = orphanAt; i < messages.length; i++) {
+        const m = messages[i];
+        if (m.role === "assistant" && Array.isArray(m.content)) {
+            for (const c of m.content) {
+                if (c?.type === "toolCall" && typeof c.id === "string")
+                    seenCallIds.add(c.id);
+            }
+        }
+        else if (m.role === "toolResult" && !seenCallIds.has(m.toolCallId ?? "")) {
+            dropped.push({ toolCallId: m.toolCallId ?? "(missing)", index: i, prevRole: roleOf(i - 1), nextRole: roleOf(i + 1) });
+            continue;
+        }
+        out.push(messages[i]);
+    }
+    return { messages: out, dropped };
+}
+export function guardBudget(model) {
+    const window = model.contextTokens ?? model.contextWindow;
+    return Math.floor(window * GUARD_FRACTION);
+}
+//# sourceMappingURL=context-guard.js.map

package/dist/core/context-guard.js.map

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

package/dist/core/dynamic-recall.d.ts

@@ -0,0 +1,33 @@
+import type { AgentMessage } from "../internal/harness.js";
+import { type MemorySelector, encodeSurfacedKey } from "./memory-recall.js";
+import type { MemoryStore } from "./memory.js";
+export interface DynamicRecallConfig {
+    enabled?: boolean;
+    recentMessageWindow?: number;
+    maxQueryChars?: number;
+}
+export declare const DEFAULT_RECENT_MESSAGE_WINDOW = 6;
+export declare const DEFAULT_MAX_QUERY_CHARS = 4000;
+export declare function buildRecallQuery(messages: readonly AgentMessage[], window?: number, maxChars?: number): string;
+export interface DynamicRecallOutcome {
+    block: string | undefined;
+    surfacedIds: readonly string[];
+    surfacedKeys: readonly string[];
+}
+export interface DynamicRecallInput {
+    store: MemoryStore;
+    scopes: readonly string[];
+    selector: MemorySelector;
+    query: string;
+    recentTools?: string[];
+    maxSelected?: number;
+    maxLinked?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    nowMs?: number;
+    priorSurfacedIds?: ReadonlySet<string>;
+    priorSurfacedKeys?: ReadonlySet<string>;
+}
+export declare function runDynamicRecall(input: DynamicRecallInput): Promise<DynamicRecallOutcome>;
+export { encodeSurfacedKey };
+//# sourceMappingURL=dynamic-recall.d.ts.map

package/dist/core/dynamic-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-recall.d.ts","sourceRoot":"","sources":["../../src/core/dynamic-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAEL,KAAK,cAAc,EAEnB,iBAAiB,EAGlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgC/C,MAAM,WAAW,mBAAmB;IAElC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAQ7C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,GAAE,MAAsC,EAC9C,QAAQ,GAAE,MAAgC,GACzC,MAAM,CAYR;AAmBD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAMD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IAEnB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;IAEzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEvC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC;AAmBD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2C/F;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/core/dynamic-recall.js

@@ -0,0 +1,77 @@
+import { encodeSurfacedKey, selectAndComposeLayeredMemory, selectAndComposeMemory, } from "./memory-recall.js";
+export const DEFAULT_RECENT_MESSAGE_WINDOW = 6;
+export const DEFAULT_MAX_QUERY_CHARS = 4_000;
+export function buildRecallQuery(messages, window = DEFAULT_RECENT_MESSAGE_WINDOW, maxChars = DEFAULT_MAX_QUERY_CHARS) {
+    if (window <= 0 || maxChars <= 0)
+        return "";
+    const recent = messages.slice(-window);
+    const parts = [];
+    for (const m of recent) {
+        const text = messageText(m);
+        if (text)
+            parts.push(text);
+    }
+    const joined = parts.join("\n").trim();
+    if (joined.length <= maxChars)
+        return joined;
+    return joined.slice(joined.length - maxChars);
+}
+function messageText(m) {
+    const content = m.content;
+    if (typeof content === "string")
+        return content.trim();
+    if (Array.isArray(content)) {
+        const out = [];
+        for (const c of content) {
+            if (typeof c.text === "string" && c.text.length > 0)
+                out.push(c.text);
+        }
+        return out.join(" ").trim();
+    }
+    return "";
+}
+const EMPTY_OUTCOME = { block: undefined, surfacedIds: [], surfacedKeys: [] };
+export async function runDynamicRecall(input) {
+    if (input.scopes.length === 0 || input.query.trim().length === 0)
+        return EMPTY_OUTCOME;
+    if (input.scopes.length === 1) {
+        const res = await selectAndComposeMemory({
+            store: input.store,
+            scope: input.scopes[0],
+            objective: input.query,
+            selector: input.selector,
+            recentTools: input.recentTools,
+            maxSelected: input.maxSelected,
+            maxLinked: input.maxLinked,
+            timeoutMs: input.timeoutMs,
+            signal: input.signal,
+            nowMs: input.nowMs,
+            priorSurfacedIds: input.priorSurfacedIds,
+        });
+        if ("degrade" in res)
+            return EMPTY_OUTCOME;
+        if (res.block === undefined || res.surfacedIds.length === 0)
+            return EMPTY_OUTCOME;
+        return { block: res.block, surfacedIds: res.surfacedIds, surfacedKeys: [] };
+    }
+    const res = await selectAndComposeLayeredMemory({
+        store: input.store,
+        scopes: [...input.scopes],
+        objective: input.query,
+        selector: input.selector,
+        recentTools: input.recentTools,
+        maxSelected: input.maxSelected,
+        maxLinked: input.maxLinked,
+        timeoutMs: input.timeoutMs,
+        signal: input.signal,
+        nowMs: input.nowMs,
+        priorSurfacedKeys: input.priorSurfacedKeys,
+    });
+    if ("degrade" in res)
+        return EMPTY_OUTCOME;
+    if (res.block === undefined || res.surfacedKeys.length === 0)
+        return EMPTY_OUTCOME;
+    return { block: res.block, surfacedIds: [], surfacedKeys: res.surfacedKeys };
+}
+export { encodeSurfacedKey };
+//# sourceMappingURL=dynamic-recall.js.map

package/dist/core/dynamic-recall.js.map

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

package/dist/core/exec-gate.d.ts

@@ -0,0 +1,30 @@
+import type { ExecutionEnv } from "../internal/harness.js";
+export interface ExecStep {
+    command: string;
+    label?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutSec?: number;
+}
+export interface ExecStepResult {
+    label: string;
+    command: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    ok: boolean;
+    errorCode?: string;
+    truncated?: boolean;
+}
+export interface ExecGateResult {
+    passed: boolean;
+    steps: ExecStepResult[];
+}
+export interface ExecGateOptions {
+    stopOnFailure?: boolean;
+    maxOutputBytes?: number;
+    readTimeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare function runExecGate(env: ExecutionEnv, steps: ExecStep[], options?: ExecGateOptions): Promise<ExecGateResult>;
+//# sourceMappingURL=exec-gate.d.ts.map

package/dist/core/exec-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-gate.d.ts","sourceRoot":"","sources":["../../src/core/exec-gate.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,MAAM,WAAW,QAAQ;IAEvB,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAEf,EAAE,EAAE,OAAO,CAAC;IAEZ,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,WAAW,cAAc;IAE7B,MAAM,EAAE,OAAO,CAAC;IAEhB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,eAAe;IAE9B,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA+GD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAiBzB"}

package/dist/core/exec-gate.js

@@ -0,0 +1,106 @@
+import { isRemoteExecutionEnv, RemoteExecutionError } from "./remote-env.js";
+const DEFAULT_MAX_OUTPUT_BYTES = 64 * 1024;
+function clampBytes(s, maxBytes) {
+    const total = Buffer.byteLength(s, "utf8");
+    if (total <= maxBytes)
+        return { text: s, bytes: total, truncated: false };
+    const buf = Buffer.from(s, "utf8");
+    let end = maxBytes;
+    while (end > 0 && (buf[end] & 0xc0) === 0x80)
+        end--;
+    return { text: buf.toString("utf8", 0, end), bytes: end, truncated: true };
+}
+async function runStreamStep(env, step, options, maxOutputBytes) {
+    const label = step.label ?? step.command;
+    const out = [];
+    const errOut = [];
+    let outBytes = 0;
+    let errBytes = 0;
+    let truncated = false;
+    let exitCode = null;
+    const append = (bucket, used, chunk) => {
+        if (used >= maxOutputBytes) {
+            truncated = true;
+            return used;
+        }
+        const { text, bytes, truncated: cut } = clampBytes(chunk, maxOutputBytes - used);
+        if (cut)
+            truncated = true;
+        bucket.push(text);
+        return used + bytes;
+    };
+    try {
+        for await (const chunk of env.execStream(step.command, {
+            cwd: step.cwd,
+            env: step.env,
+            timeout: step.timeoutSec,
+            signal: options.signal,
+            readTimeoutMs: options.readTimeoutMs,
+            maxOutputBytes,
+        })) {
+            if (chunk.type === "stdout")
+                outBytes = append(out, outBytes, chunk.data);
+            else if (chunk.type === "stderr")
+                errBytes = append(errOut, errBytes, chunk.data);
+            else
+                exitCode = chunk.exitCode;
+        }
+    }
+    catch (e) {
+        const code = e instanceof RemoteExecutionError
+            ? e.code
+            : e?.name === "AbortError"
+                ? "aborted"
+                : "unknown";
+        return { label, command: step.command, exitCode: null, stdout: out.join(""), stderr: errOut.join(""), ok: false, errorCode: code, truncated };
+    }
+    return { label, command: step.command, exitCode, stdout: out.join(""), stderr: errOut.join(""), ok: exitCode === 0, truncated };
+}
+async function runBufferedStep(env, step, options, maxOutputBytes) {
+    const label = step.label ?? step.command;
+    const res = await env.exec(step.command, {
+        cwd: step.cwd,
+        env: step.env,
+        timeout: step.timeoutSec,
+        abortSignal: options.signal,
+    });
+    if (!res.ok) {
+        return { label, command: step.command, exitCode: null, stdout: "", stderr: "", ok: false, errorCode: res.error.code };
+    }
+    const so = clampBytes(res.value.stdout, maxOutputBytes);
+    const se = clampBytes(res.value.stderr, maxOutputBytes);
+    return {
+        label,
+        command: step.command,
+        exitCode: res.value.exitCode,
+        stdout: so.text,
+        stderr: se.text,
+        ok: res.value.exitCode === 0,
+        truncated: so.truncated || se.truncated,
+    };
+}
+function assertRemote(env) {
+    if (!isRemoteExecutionEnv(env))
+        throw new Error("not a remote env");
+    return env;
+}
+export async function runExecGate(env, steps, options = {}) {
+    const stopOnFailure = options.stopOnFailure ?? true;
+    const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const remote = isRemoteExecutionEnv(env);
+    const results = [];
+    for (const step of steps) {
+        if (options.signal?.aborted) {
+            results.push({ label: step.label ?? step.command, command: step.command, exitCode: null, stdout: "", stderr: "", ok: false, errorCode: "aborted" });
+            break;
+        }
+        const r = remote
+            ? await runStreamStep(assertRemote(env), step, options, maxOutputBytes)
+            : await runBufferedStep(env, step, options, maxOutputBytes);
+        results.push(r);
+        if (!r.ok && stopOnFailure)
+            break;
+    }
+    return { passed: results.length > 0 && results.every((s) => s.ok), steps: results };
+}
+//# sourceMappingURL=exec-gate.js.map

package/dist/core/exec-gate.js.map

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

package/dist/core/exec-output-tail.d.ts

@@ -0,0 +1,15 @@
+export declare const MAX_EXEC_OUTPUT_BYTES: number;
+export declare class RollingTailBuffer {
+    private readonly maxBytes;
+    private readonly chunks;
+    private size;
+    private dropped;
+    constructor(maxBytes?: number);
+    push(chunk: Buffer): void;
+    result(): {
+        text: string;
+        droppedBytes: number;
+    };
+}
+export declare function markTruncated(text: string, droppedBytes: number): string;
+//# sourceMappingURL=exec-output-tail.d.ts.map

package/dist/core/exec-output-tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-output-tail.d.ts","sourceRoot":"","sources":["../../src/core/exec-output-tail.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAMrD,qBAAa,iBAAiB;IAKhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAK;gBAES,QAAQ,GAAE,MAA8B;IAGrE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAsBzB,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAGjD;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAIxE"}

package/dist/core/exec-output-tail.js

@@ -0,0 +1,39 @@
+export const MAX_EXEC_OUTPUT_BYTES = 8 * 1024 * 1024;
+export class RollingTailBuffer {
+    maxBytes;
+    chunks = [];
+    size = 0;
+    dropped = 0;
+    constructor(maxBytes = MAX_EXEC_OUTPUT_BYTES) {
+        this.maxBytes = maxBytes;
+    }
+    push(chunk) {
+        if (chunk.length === 0)
+            return;
+        this.chunks.push(chunk);
+        this.size += chunk.length;
+        while (this.size > this.maxBytes) {
+            const over = this.size - this.maxBytes;
+            const head = this.chunks[0];
+            if (over >= head.length) {
+                this.chunks.shift();
+                this.size -= head.length;
+                this.dropped += head.length;
+            }
+            else {
+                this.chunks[0] = head.subarray(over);
+                this.size -= over;
+                this.dropped += over;
+            }
+        }
+    }
+    result() {
+        return { text: Buffer.concat(this.chunks).toString("utf8"), droppedBytes: this.dropped };
+    }
+}
+export function markTruncated(text, droppedBytes) {
+    return droppedBytes > 0
+        ? `[... ${droppedBytes} earlier byte(s) truncated; showing last ${MAX_EXEC_OUTPUT_BYTES} ...]\n${text}`
+        : text;
+}
+//# sourceMappingURL=exec-output-tail.js.map

package/dist/core/exec-output-tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-output-tail.js","sourceRoot":"","sources":["../../src/core/exec-output-tail.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAMrD,MAAM,OAAO,iBAAiB;IAKC;IAJZ,MAAM,GAAa,EAAE,CAAC;IAC/B,IAAI,GAAG,CAAC,CAAC;IACT,OAAO,GAAG,CAAC,CAAC;IAEpB,YAA6B,WAAmB,qBAAqB;QAAxC,aAAQ,GAAR,QAAQ,CAAgC;IAAG,CAAC;IAGzE,IAAI,CAAC,KAAa;QAChB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YAC7B,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;gBACzB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBAGN,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;gBAClB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAGD,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC3F,CAAC;CACF;AAMD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,YAAoB;IAC9D,OAAO,YAAY,GAAG,CAAC;QACrB,CAAC,CAAC,QAAQ,YAAY,4CAA4C,qBAAqB,UAAU,IAAI,EAAE;QACvG,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/core/file-snapshot-store.d.ts

@@ -0,0 +1,53 @@
+import type { ExecutionEnv } from "../internal/harness.js";
+export interface FileSnapshotError {
+    code: "too_large" | "enumerate_failed" | "read_failed" | "restore_failed" | "not_found" | "aborted";
+    message: string;
+}
+export type FileSnapshotResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: FileSnapshotError;
+};
+export interface FileSnapshotStore {
+    snapshot(scope: string, key: string, env: ExecutionEnv, root: string, signal?: AbortSignal): Promise<FileSnapshotResult>;
+    restore(scope: string, key: string, env: ExecutionEnv, root: string, signal?: AbortSignal): Promise<FileSnapshotResult>;
+    has(scope: string, key: string): Promise<boolean>;
+    reap(scope: string, keepKeys: string[]): Promise<number>;
+    listKeys(scope: string): Promise<string[]>;
+    exportManifest?(scope: string, key: string): Promise<Map<string, string> | null>;
+    getBlob?(hash: string): Promise<Uint8Array | undefined>;
+    importManifest?(scope: string, key: string, manifest: Map<string, string>, srcGetBlob: (hash: string) => Promise<Uint8Array | undefined>): Promise<FileSnapshotResult>;
+    putBlob?(hash: string, bytes: Uint8Array): Promise<FileSnapshotResult>;
+}
+export interface FileSnapshotBounds {
+    maxFiles: number;
+    maxBytes: number;
+    ignoreDirs: Set<string>;
+}
+export declare const DEFAULT_SNAPSHOT_BOUNDS: FileSnapshotBounds;
+export declare function captureManifest(env: ExecutionEnv, root: string, bounds: FileSnapshotBounds, signal: AbortSignal | undefined, putBlob: (hash: string, bytes: Uint8Array) => void | Promise<void>): Promise<{
+    ok: true;
+    value: Map<string, string>;
+} | {
+    ok: false;
+    error: FileSnapshotError;
+}>;
+export declare function applyManifest(env: ExecutionEnv, root: string, bounds: FileSnapshotBounds, signal: AbortSignal | undefined, manifest: Map<string, string>, getBlob: (hash: string) => Uint8Array | undefined | Promise<Uint8Array | undefined>): Promise<FileSnapshotResult>;
+export declare class InMemoryFileSnapshotStore implements FileSnapshotStore {
+    private readonly blobs;
+    private readonly manifests;
+    private readonly inFlight;
+    private readonly bounds;
+    constructor(bounds?: Partial<FileSnapshotBounds>);
+    snapshot(scope: string, key: string, env: ExecutionEnv, root: string, signal?: AbortSignal): Promise<FileSnapshotResult>;
+    restore(scope: string, key: string, env: ExecutionEnv, root: string, signal?: AbortSignal): Promise<FileSnapshotResult>;
+    has(scope: string, key: string): Promise<boolean>;
+    listKeys(scope: string): Promise<string[]>;
+    exportManifest(scope: string, key: string): Promise<Map<string, string> | null>;
+    getBlob(hash: string): Promise<Uint8Array | undefined>;
+    putBlob(hash: string, bytes: Uint8Array): Promise<FileSnapshotResult>;
+    importManifest(scope: string, key: string, manifest: Map<string, string>, srcGetBlob: (hash: string) => Promise<Uint8Array | undefined>): Promise<FileSnapshotResult>;
+    reap(scope: string, keepKeys: string[]): Promise<number>;
+}
+//# sourceMappingURL=file-snapshot-store.d.ts.map

package/dist/core/file-snapshot-store.d.ts.map

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