@sema-agent/core 1.279.0

package/dist/core/checkpoint-store.js

@@ -0,0 +1,292 @@
+import { randomBytes } from "node:crypto";
+import { inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
+import { ASK_USER_QUESTION_TOOL_NAME } from "./ask-question.js";
+export function mintCheckpointToken() {
+    return randomBytes(16).toString("hex");
+}
+export function riskSeverity(axes) {
+    const egress = axes.egress === true;
+    const irreversible = axes.irreversible === true;
+    if (irreversible && egress)
+        return 5;
+    if (irreversible)
+        return 4;
+    if (egress)
+        return 3;
+    if (axes.shell === true)
+        return 3;
+    return 2;
+}
+const SUMMARY_CMD_MAX = 200;
+const SUMMARY_VALUE_MAX = 120;
+const SUMMARY_TOTAL_MAX = 200;
+const PATH_MAX = 200;
+const MAX_TOUCHED_PATHS = 8;
+const MAX_DIGEST_KEYS = 16;
+const MAX_DIGEST_SCAN_KEYS = 256;
+export const MAX_TOOL_INPUT_PREVIEW_CHARS = 512;
+function isPlainRecord(x) {
+    try {
+        if (x === null || typeof x !== "object" || Array.isArray(x))
+            return false;
+        const p = Object.getPrototypeOf(x);
+        return p === Object.prototype || p === null;
+    }
+    catch {
+        return false;
+    }
+}
+function safeDataValue(obj, key) {
+    try {
+        const d = Object.getOwnPropertyDescriptor(obj, key);
+        return d && "value" in d ? d.value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeKeys(obj) {
+    try {
+        return Object.keys(obj);
+    }
+    catch {
+        return [];
+    }
+}
+function fsPathArg(args) {
+    if (!isPlainRecord(args))
+        return undefined;
+    const fp = safeDataValue(args, "file_path");
+    if (typeof fp === "string" && fp.length > 0)
+        return fp;
+    const p = safeDataValue(args, "path");
+    return typeof p === "string" && p.length > 0 ? p : undefined;
+}
+export function buildRiskDescriptor(input) {
+    const { toolName } = input;
+    try {
+        const { args, safety, shellGated } = input;
+        const egress = safety?.egress === true;
+        const shell = shellGated === true;
+        const irreversible = !shell && safety?.irreversible === true;
+        const axes = {};
+        if (egress)
+            axes.egress = true;
+        if (irreversible)
+            axes.irreversible = true;
+        if (shell)
+            axes.shell = true;
+        let summary;
+        if (shell || toolName === "Bash") {
+            const cmd = isPlainRecord(args) ? safeDataValue(args, "command") : undefined;
+            if (typeof cmd === "string" && cmd.length > 0)
+                summary = inlineUntrusted(cmd, SUMMARY_CMD_MAX);
+            const bg = isPlainRecord(args) ? safeDataValue(args, "run_in_background") : undefined;
+            if (bg === true)
+                summary = `[background persistent process — no per-step recheck] ${summary ?? ""}`.trimEnd();
+        }
+        else if (isPlainRecord(args)) {
+            {
+                const parts = [];
+                for (const key of safeKeys(args).slice(0, MAX_DIGEST_SCAN_KEYS).sort().slice(0, MAX_DIGEST_KEYS)) {
+                    if (key === "__proto__" || key === "constructor" || key === "prototype")
+                        continue;
+                    const v = safeDataValue(args, key);
+                    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+                        const encDigest = (s) => s.replace(/%/g, "%25").replace(/=/g, "%3D").replace(/ /g, "%20");
+                        const k = encDigest(inlineUntrusted(key, 40));
+                        const val = encDigest(inlineUntrusted(String(v), SUMMARY_VALUE_MAX));
+                        parts.push(`${k}=${val}`);
+                    }
+                }
+                if (parts.length > 0)
+                    summary = inlineUntrusted(parts.join(" "), SUMMARY_TOTAL_MAX);
+            }
+        }
+        const touched = [];
+        if (!shell && toolName !== "Bash") {
+            const p = fsPathArg(args);
+            if (p !== undefined)
+                touched.push(inlineUntrusted(p, PATH_MAX));
+        }
+        const touchedPaths = touched.length > 0 ? touched.slice(0, MAX_TOUCHED_PATHS) : undefined;
+        return {
+            severity: riskSeverity(axes),
+            axes,
+            toolName,
+            ...(summary !== undefined ? { summary } : {}),
+            ...(touchedPaths !== undefined ? { touchedPaths } : {}),
+        };
+    }
+    catch {
+        return { severity: 2, axes: {}, toolName: typeof toolName === "string" ? toolName : "" };
+    }
+}
+export const CURRENT_CHECKPOINT_VERSION = 1;
+export const RESOURCE_CHECKPOINT_VERSION = 2;
+export const BINDING_CHECKPOINT_VERSION = 3;
+export const MAX_SUPPORTED_CHECKPOINT_VERSION = 3;
+export function checkpointVersionOf(cp) {
+    return cp.version ?? 0;
+}
+export function debitLedger(prior, slice, total, opts) {
+    return {
+        totalBudgetMicroUsd: prior?.totalBudgetMicroUsd ?? total?.totalBudgetMicroUsd,
+        totalWalltimeSec: prior?.totalWalltimeSec ?? total?.totalWalltimeSec,
+        spentMicroUsd: (prior?.spentMicroUsd ?? 0) + Math.max(0, slice.costMicroUsd),
+        spentTokens: (prior?.spentTokens ?? 0) + Math.max(0, slice.tokens),
+        spentTurns: (prior?.spentTurns ?? 0) + Math.max(0, slice.turns),
+        sliceCount: (prior?.sliceCount ?? 0) + (opts?.countSlice === false ? 0 : 1),
+    };
+}
+export function remainingBudgetMicroUsd(ledger) {
+    if (ledger?.totalBudgetMicroUsd === undefined)
+        return undefined;
+    return Math.max(0, ledger.totalBudgetMicroUsd - ledger.spentMicroUsd);
+}
+export function summarizeCheckpoint(cp) {
+    const riskDescriptor = cp.gate.kind === "human" || cp.gate.kind === "irreversible_ask" ? cp.gate.riskDescriptor : undefined;
+    const severity = riskDescriptor !== undefined ? riskSeverity(riskDescriptor.axes) : undefined;
+    const tool = cp.pendingAction.kind === "tool_approval" ? cp.pendingAction : undefined;
+    let toolInput;
+    if (tool !== undefined) {
+        try {
+            const raw = JSON.stringify(tool.args);
+            if (typeof raw === "string") {
+                toolInput = raw.length > MAX_TOOL_INPUT_PREVIEW_CHARS ? `${raw.slice(0, MAX_TOOL_INPUT_PREVIEW_CHARS)}…` : raw;
+            }
+        }
+        catch {
+            toolInput = undefined;
+        }
+    }
+    return {
+        token: cp.token,
+        sessionId: cp.sessionId,
+        scope: cp.scope,
+        gateKind: cp.gate.kind,
+        ...(severity !== undefined ? { severity } : {}),
+        ...(cp.resourceLedger !== undefined ? { spentMicroUsd: cp.resourceLedger.spentMicroUsd } : {}),
+        ...(cp.deadline !== undefined ? { deadline: cp.deadline } : {}),
+        createdAt: cp.createdAt,
+        ...(cp.sourceTaskId !== undefined ? { sourceTaskId: cp.sourceTaskId } : {}),
+        ...(cp.principal !== undefined ? { principal: cp.principal } : {}),
+        ...(tool !== undefined ? { toolCallId: tool.toolCallId, toolName: tool.toolName } : {}),
+        ...(tool?.toolName === ASK_USER_QUESTION_TOOL_NAME ? { contentKind: "content_ask" } : {}),
+        ...(toolInput !== undefined ? { toolInput } : {}),
+    };
+}
+export class CheckpointError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "CheckpointError";
+    }
+}
+export function winnerFromOutcome(outcome) {
+    if (outcome.gate !== "policy_ask")
+        return undefined;
+    return outcome.updatedInput === undefined
+        ? { boundCallId: outcome.boundCallId, decision: outcome.decision }
+        : { boundCallId: outcome.boundCallId, decision: outcome.decision, updatedInput: outcome.updatedInput };
+}
+export function validatePendingSteer(steer) {
+    if (sanitizeUntrustedText(steer.text) !== steer.text) {
+        throw new CheckpointError("steering.invalid_content", "steering text must not contain a system-reminder break-out tag");
+    }
+    if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/.test(steer.text)) {
+        throw new CheckpointError("steering.invalid_content", "steering text must not contain control characters");
+    }
+    return { text: steer.text, trusted: steer.trusted };
+}
+export class InMemoryCheckpointStore {
+    cps = new Map();
+    fault = null;
+    async put(token, cp) {
+        if (this.cps.has(token)) {
+            throw new CheckpointError("checkpoint.already_exists", `checkpoint token already exists`);
+        }
+        this.cps.set(token, structuredClone(cp));
+    }
+    async get(token) {
+        const cp = this.cps.get(token);
+        return cp ? structuredClone(cp) : null;
+    }
+    async resolve(token, scope, outcome, expect) {
+        if (this.fault === "resolve-before-commit") {
+            this.fault = null;
+            throw new Error("injected fault: resolve before commit");
+        }
+        const cp = this.cps.get(token);
+        if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            return false;
+        }
+        if (expect !== undefined && (cp.rev ?? 0) !== expect.rev) {
+            return false;
+        }
+        cp.status = "resolved";
+        cp.rev = (cp.rev ?? 0) + 1;
+        const winner = winnerFromOutcome(outcome);
+        if (winner)
+            cp.resolvedOutcome = structuredClone(winner);
+        cp.reopenReason = undefined;
+        if (this.fault === "resolve-after-commit") {
+            this.fault = null;
+            throw new Error("injected fault: resolve after commit");
+        }
+        return true;
+    }
+    async reopen(token, scope, reason) {
+        const cp = this.cps.get(token);
+        if (!cp || cp.scope !== scope || cp.status !== "resolved") {
+            return false;
+        }
+        cp.status = "pending";
+        cp.rev = (cp.rev ?? 0) + 1;
+        cp.reopenReason = reason;
+        return true;
+    }
+    async setPendingSteer(token, scope, steer) {
+        const clean = validatePendingSteer(steer);
+        const cp = this.cps.get(token);
+        if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            return false;
+        }
+        cp.state.pendingSteer = clean;
+        return true;
+    }
+    async expire(token, scope) {
+        const cp = this.cps.get(token);
+        if (!cp || cp.scope !== scope || cp.status !== "pending") {
+            return false;
+        }
+        cp.status = "expired";
+        return true;
+    }
+    async reap(scope, cutoff) {
+        let n = 0;
+        for (const cp of this.cps.values()) {
+            if (cp.scope === scope && cp.status === "pending" && cp.deadline !== undefined && cp.deadline <= cutoff) {
+                cp.status = "expired";
+                n++;
+            }
+        }
+        return n;
+    }
+    async listByScope(scope) {
+        const out = [];
+        for (const cp of this.cps.values()) {
+            if (cp.scope === scope && cp.status === "pending")
+                out.push(summarizeCheckpoint(cp));
+        }
+        return out;
+    }
+    testInjectFault(mode) {
+        this.fault = mode;
+    }
+    get size() {
+        return this.cps.size;
+    }
+}
+//# sourceMappingURL=checkpoint-store.js.map

package/dist/core/checkpoint-store.js.map

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

package/dist/core/consolidate-scope.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryStore } from "./memory.js";
+import { type ConsolidationLLM, type ConsolidationStats } from "./runner/memory-consolidation.js";
+export interface ConsolidateScopeDeps {
+    store: MemoryStore;
+    llm: ConsolidationLLM;
+    onWarn?: (err: unknown) => void;
+    acquire?: (scope: string) => Promise<(() => void) | undefined> | (() => void) | undefined;
+}
+export interface ConsolidateScopeOptions {
+    band?: {
+        lo: number;
+        hi: number;
+    };
+    searchLimit?: number;
+    maxNotes?: number;
+}
+export declare function consolidateScope(scope: string, deps: ConsolidateScopeDeps, opts?: ConsolidateScopeOptions): Promise<ConsolidationStats | undefined>;
+export declare function advanceCursorAfterInline(store: MemoryStore, scope: string, seenNoteIds: ReadonlyArray<string | undefined>, addedIds: ReadonlyArray<string>, failedIds?: ReadonlyArray<string>, onWarn?: (err: unknown) => void): Promise<void>;
+//# sourceMappingURL=consolidate-scope.d.ts.map

package/dist/core/consolidate-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate-scope.d.ts","sourceRoot":"","sources":["../../src/core/consolidate-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AAEjE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EAIxB,MAAM,kCAAkC,CAAC;AAwC1C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;IAGtB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAQhC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3F;AAGD,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA2FzC;AAmBD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,EAC9C,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,SAAS,GAAE,aAAa,CAAC,MAAM,CAAM,EACrC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/core/consolidate-scope.js

@@ -0,0 +1,96 @@
+import { supportsConsolidation, supportsPeriodicConsolidation } from "./memory.js";
+import { runMemoryConsolidation, DEFAULT_CONSOLIDATION_BAND, DEFAULT_CONSOLIDATION_SEARCH_LIMIT, DEFAULT_CONSOLIDATION_MAX_NOTES, } from "./runner/memory-consolidation.js";
+function maxMarker(a, b) {
+    return a === undefined || b > a ? b : a;
+}
+function cappedHighWater(seen, failed) {
+    let floor;
+    for (const id of failed)
+        if (floor === undefined || id < floor)
+            floor = id;
+    let hw;
+    for (const id of seen) {
+        if (floor !== undefined && id >= floor)
+            continue;
+        hw = maxMarker(hw, id);
+    }
+    return hw;
+}
+export async function consolidateScope(scope, deps, opts = {}) {
+    const { store, onWarn } = deps;
+    if (!supportsPeriodicConsolidation(store)) {
+        onWarn?.(new Error("consolidateScope: store does not implement the consolidation cursor pair " +
+            "(getConsolidationCursor/setConsolidationCursor) — skipped (no-op), NOT degraded to a full re-consolidation"));
+        return undefined;
+    }
+    if (!supportsConsolidation(store) || typeof store.listStructuredNotes !== "function") {
+        onWarn?.(new Error("consolidateScope: store is not id-addressable / has no manifest — skipped (no-op)"));
+        return undefined;
+    }
+    const release = deps.acquire ? await deps.acquire(scope) : () => { };
+    if (release === undefined) {
+        onWarn?.(new Error(`consolidateScope: scope "${scope}" is locked by another consolidation — skipped (no-op)`));
+        return undefined;
+    }
+    try {
+        const cursor = await store.getConsolidationCursor(scope);
+        const headers = await store.listStructuredNotes(scope);
+        const pending = headers
+            .filter((h) => !h.consolidationGenerated && (cursor === undefined || h.id > cursor))
+            .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        if (pending.length === 0) {
+            return undefined;
+        }
+        const maxNotes = opts.maxNotes ?? DEFAULT_CONSOLIDATION_MAX_NOTES;
+        const batch = pending.slice(0, maxNotes);
+        const batchIds = batch.map((h) => h.id);
+        const records = await store.getByIds(scope, batchIds);
+        const byId = new Map(records.map((r) => [r.id, r]));
+        const notes = batchIds
+            .map((id) => byId.get(id))
+            .filter((r) => r !== undefined)
+            .map((r) => ({ id: r.id, text: r.text }));
+        let stats;
+        if (notes.length > 0) {
+            stats = await runMemoryConsolidation({
+                store,
+                scope,
+                notes,
+                band: opts.band ?? { lo: DEFAULT_CONSOLIDATION_BAND.lo, hi: DEFAULT_CONSOLIDATION_BAND.hi },
+                searchLimit: opts.searchLimit ?? DEFAULT_CONSOLIDATION_SEARCH_LIMIT,
+                maxNotes,
+                llm: deps.llm,
+                onWarn,
+            });
+        }
+        const seen = [...batchIds, ...(stats?.addedIds ?? [])];
+        const highWater = cappedHighWater(seen, stats?.failedIds ?? []);
+        if (highWater !== undefined && highWater !== cursor && (cursor === undefined || highWater > cursor)) {
+            await store.setConsolidationCursor(scope, highWater);
+        }
+        return stats ?? { tokens: 0, costMicroUsd: 0, applied: 0, addedIds: [], consolidatedIds: [], failedIds: [] };
+    }
+    finally {
+        release();
+    }
+}
+export async function advanceCursorAfterInline(store, scope, seenNoteIds, addedIds, failedIds = [], onWarn) {
+    if (!supportsPeriodicConsolidation(store))
+        return;
+    try {
+        const cursor = await store.getConsolidationCursor(scope);
+        const seen = [
+            ...seenNoteIds.filter((id) => typeof id === "string" && Boolean(id)),
+            ...addedIds,
+        ];
+        const capped = cappedHighWater(seen, failedIds);
+        const highWater = cursor === undefined ? capped : maxMarker(cursor, capped ?? cursor);
+        if (highWater !== undefined && highWater !== cursor) {
+            await store.setConsolidationCursor(scope, highWater);
+        }
+    }
+    catch (err) {
+        onWarn?.(err);
+    }
+}
+//# sourceMappingURL=consolidate-scope.js.map

package/dist/core/consolidate-scope.js.map

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

package/dist/core/context-edit.d.ts

@@ -0,0 +1,18 @@
+import type { AgentMessage } from "../internal/harness.js";
+import type { Model } from "../internal/llm.js";
+export declare const EDIT_FRACTION = 0.7;
+export declare const COMPACTABLE_TOOLS: ReadonlySet<string>;
+export interface ContextEditOptions {
+    budgetTokens: number;
+    keepRecentToolResults?: number;
+    offload?: {
+        persist: (toolCallId: string, fullText: string) => string;
+    };
+    anchoredTotalTokens?: number;
+    charsPerToken?: number;
+    compactableTools?: ReadonlySet<string>;
+}
+export declare function dropEmptyFailureAssistants(messages: AgentMessage[]): AgentMessage[];
+export declare function clearStaleToolResults(messages: AgentMessage[], opts: ContextEditOptions): AgentMessage[];
+export declare function editBudget(model: Model): number;
+//# sourceMappingURL=context-edit.d.ts.map

package/dist/core/context-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-edit.d.ts","sourceRoot":"","sources":["../../src/core/context-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAgBhD,eAAO,MAAM,aAAa,MAAM,CAAC;AAYjC,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAUhD,CAAC;AAEH,MAAM,WAAW,kBAAkB;IAEjC,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAQ/B,OAAO,CAAC,EAAE;QAER,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;KAC3D,CAAC;IAaF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAOvB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AA4BD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAUnF;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,EAAE,kBAAkB,GACvB,YAAY,EAAE,CAwEhB;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG/C"}

package/dist/core/context-edit.js

@@ -0,0 +1,98 @@
+import { DEFAULT_CHARS_PER_TOKEN, estimateContextTokens, estimateTokens } from "../internal/harness.js";
+import { isToolResult } from "./message-utils.js";
+const CLEARED_MARKER = "[tool result cleared to save context]";
+const clearedWithRef = (ref) => `[tool result cleared to save context — full content persisted; call ReadToolResult with ref "${ref}" to read it back]`;
+export const EDIT_FRACTION = 0.7;
+export const COMPACTABLE_TOOLS = new Set([
+    "Read",
+    "Bash",
+    "PowerShell",
+    "Grep",
+    "Glob",
+    "WebSearch",
+    "WebFetch",
+    "Edit",
+    "Write",
+]);
+function isCleared(m) {
+    const content = m.content;
+    if (!Array.isArray(content) || content.length !== 1)
+        return false;
+    const text = content[0].text;
+    return text === CLEARED_MARKER || (typeof text === "string" && text.startsWith("[tool result cleared to save context —"));
+}
+export function dropEmptyFailureAssistants(messages) {
+    const isJunk = (m) => {
+        if (m.role !== "assistant")
+            return false;
+        const a = m;
+        if (a.stopReason !== "aborted" && a.stopReason !== "error")
+            return false;
+        return a.content.every((c) => c.type === "text" ? (c.text ?? "").trim() === "" : c.type === "thinking" ? (c.thinking ?? "").trim() === "" : false);
+    };
+    return messages.some(isJunk) ? messages.filter((m) => !isJunk(m)) : messages;
+}
+export function clearStaleToolResults(messages, opts) {
+    const cpt = opts.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
+    const anchored = opts.anchoredTotalTokens !== undefined;
+    let total;
+    let anchorIdx = -1;
+    if (anchored) {
+        total = opts.anchoredTotalTokens;
+        anchorIdx = estimateContextTokens(messages, cpt).lastUsageIndex ?? -1;
+    }
+    else {
+        total = 0;
+        for (const m of messages) {
+            total += estimateTokens(m, cpt);
+        }
+    }
+    if (total <= opts.budgetTokens) {
+        return messages;
+    }
+    const keep = opts.keepRecentToolResults ?? 3;
+    const compactable = opts.compactableTools ?? COMPACTABLE_TOOLS;
+    const toolResultIdx = messages.flatMap((m, i) => isToolResult(m) && !isCleared(m) && compactable.has(m.toolName ?? "") ? [i] : []);
+    const clearable = toolResultIdx.slice(0, Math.max(0, toolResultIdx.length - keep));
+    if (clearable.length === 0) {
+        return messages;
+    }
+    const out = messages.slice();
+    let current = total;
+    for (const idx of clearable) {
+        if (current <= opts.budgetTokens) {
+            break;
+        }
+        const before = estimateTokens(out[idx], cpt);
+        let marker = CLEARED_MARKER;
+        if (opts.offload) {
+            const msg = out[idx];
+            const fullText = Array.isArray(msg.content)
+                ? msg.content
+                    .filter((c) => c?.type === "text" && typeof c.text === "string")
+                    .map((c) => c.text)
+                    .join("\n")
+                : "";
+            if (msg.toolCallId && fullText.trim().length > 0) {
+                try {
+                    marker = clearedWithRef(opts.offload.persist(msg.toolCallId, fullText));
+                }
+                catch {
+                    marker = CLEARED_MARKER;
+                }
+            }
+        }
+        const cleared = {
+            ...out[idx],
+            content: [{ type: "text", text: marker }],
+        };
+        out[idx] = cleared;
+        current -= idx > anchorIdx ? before - estimateTokens(cleared, cpt) : 0;
+    }
+    return out;
+}
+export function editBudget(model) {
+    const window = model.contextTokens ?? model.contextWindow;
+    return Math.floor(window * EDIT_FRACTION);
+}
+//# sourceMappingURL=context-edit.js.map

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

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

package/dist/core/context-guard.d.ts

@@ -0,0 +1,14 @@
+import type { AgentMessage } from "../internal/harness.js";
+import type { Model } from "../internal/llm.js";
+export declare function trimToBudget(messages: AgentMessage[], budgetTokens: number, anchoredTotalTokens?: number, charsPerToken?: number): AgentMessage[];
+export declare function dropOrphanToolResults(messages: AgentMessage[]): {
+    messages: AgentMessage[];
+    dropped: Array<{
+        toolCallId: string;
+        index: number;
+        prevRole: string;
+        nextRole: string;
+    }>;
+};
+export declare function guardBudget(model: Model): number;
+//# sourceMappingURL=context-guard.d.ts.map

package/dist/core/context-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-guard.d.ts","sourceRoot":"","sources":["../../src/core/context-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AA8BhD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,EAAE,CA4FhB;AAYD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG;IAC/D,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F,CAkCA;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGhD"}