@sema-agent/core 5.8.0 → 5.10.0

package/dist/brain/openai.js

@@ -481,9 +481,17 @@ export function createOpenAIBrain(config = {}) {
                             finalContent.push({ type: "text", text: textFace });
                         const toolCalls = [];
                         const malformed = [];
+                        const unnamed = [];
+                        let emptyPlaceholders = 0;
                         for (const acc of [...toolAccum.entries()].sort((a, b) => a[0] - b[0]).map((e) => e[1])) {
-                            if (!acc.name)
+                            if (!acc.name) {
+                                if (!acc.id && acc.args === "") {
+                                    emptyPlaceholders++;
+                                    continue;
+                                }
+                                unnamed.push(`id="${acc.id || "?"}"(${acc.args.slice(0, 200)})`);
                                 continue;
+                            }
                             const tc = closeToolCallAccum(acc);
                             if (tc) {
                                 toolCalls.push(tc);
@@ -508,16 +516,35 @@ export function createOpenAIBrain(config = {}) {
                                 }
                             }
                         }
-                        const toolError = malformed.length > 0
-                            ? `tool call argument(s) not valid JSON (likely truncated, finish_reason="${finishReason ?? "?"}"): ${malformed.join("; ")}`
-                            : undefined;
+                        const emptySlots = `<empty slot>${emptyPlaceholders > 1 ? ` ×${emptyPlaceholders}` : ""}`;
+                        const sawRealAction = toolCalls.length > 0 || malformed.length > 0 || unnamed.length > 0;
+                        if (emptyPlaceholders > 0 && sawRealAction) {
+                            unnamed.push(emptySlots);
+                        }
+                        else if (!sawRealAction && finishReason === "tool_calls") {
+                            unnamed.push(emptyPlaceholders > 0 ? emptySlots : "<no tool_call delta arrived on the stream>");
+                        }
+                        const toolErrorParts = [];
+                        if (malformed.length > 0) {
+                            toolErrorParts.push(`tool call argument(s) not valid JSON (likely truncated, finish_reason="${finishReason ?? "?"}"): ${malformed.join("; ")}`);
+                        }
+                        if (unnamed.length > 0) {
+                            toolErrorParts.push(`tool call(s) arrived with no tool name and cannot be executed (finish_reason="${finishReason ?? "?"}"): ${unnamed.join("; ")}`);
+                        }
+                        const toolError = toolErrorParts.length > 0 ? toolErrorParts.join(" | ") : undefined;
                         const noUsableContent = toolCalls.length === 0 && !accumText.trim();
-                        if (toolError !== undefined) {
+                        if (malformed.length > 0) {
                             finalContent.push({
                                 type: "text",
                                 text: `\n[note: ${malformed.length} tool call(s) were truncated (finish_reason="${finishReason ?? "?"}") and dropped — re-issue them next turn: ${malformed.join("; ")}]`,
                             });
                         }
+                        if (unnamed.length > 0) {
+                            finalContent.push({
+                                type: "text",
+                                text: `\n[note: ${unnamed.length} tool call(s) arrived with no tool name and were dropped — re-issue them next turn with an explicit tool name: ${unnamed.join("; ")}]`,
+                            });
+                        }
                         if (malformedFrames > 0) {
                             finalContent.push({
                                 type: "text",

package/dist/brain/request-params.d.ts

@@ -1,5 +1,6 @@
 export declare const OPENAI_RESERVED: ReadonlySet<string>;
 export declare const ANTHROPIC_RESERVED: ReadonlySet<string>;
+export declare const RESPONSES_RESERVED: ReadonlySet<string>;
 export declare function reservedFor(api: string): ReadonlySet<string>;
 export declare function applyExtraBody(body: Record<string, unknown>, extraBody: Record<string, unknown> | undefined, reserved: ReadonlySet<string>): Record<string, unknown>;
 export declare function stripAuthHeaders(headers: Record<string, string>): void;

package/dist/brain/request-params.js

@@ -25,7 +25,23 @@ export const ANTHROPIC_RESERVED = new Set([
     "output_config",
     "context_management",
 ]);
+export const RESPONSES_RESERVED = new Set([
+    "model",
+    "input",
+    "stream",
+    "instructions",
+    "tools",
+    "temperature",
+    "max_output_tokens",
+    "reasoning",
+    "store",
+    "previous_response_id",
+    "conversation",
+]);
+const RESPONSES_APIS = new Set(["openai-responses", "azure-openai-responses", "openai-chatgpt-responses"]);
 export function reservedFor(api) {
+    if (RESPONSES_APIS.has(api))
+        return RESPONSES_RESERVED;
     return api === "anthropic-messages" ? ANTHROPIC_RESERVED : OPENAI_RESERVED;
 }
 export function applyExtraBody(body, extraBody, reserved) {

package/dist/core/a2a.js

@@ -23,7 +23,7 @@ const A2A_CARD_DESCRIPTION_MAX_CHARS = 240;
 const A2A_ID_MAX_CHARS = 160;
 const A2A_RESULT_BODY_MAX_CHARS = 100_000;
 const A2A_ERROR_TEXT_MAX_CHARS = 240;
-const A2A_RESULT_FENCE_REASON = "the peer is an autonomous agent, so its output is worker text, not tool data";
+const A2A_RESULT_FENCE_REASON = "the peer is an agent acting on its own, so its output is worker text, not tool data";
 const A2A_CARD_PATHS = ["/.well-known/agent-card.json", "/.well-known/agent.json"];
 const A2A_PROTOCOL_VERSION = "1.0";
 const A2A_JSONRPC_TRANSPORT = "JSONRPC";

package/dist/core/fs-write-gate-policy.js

@@ -1,9 +1,9 @@
 import { canonicalizeTarget, writeTargetPath } from "../tools/fs/safety.js";
-import { PATH_WRITE_TOOLS, isWithin } from "./runner/session-rule-policy.js";
+import { PATH_CONFINABLE_WRITE_TOOLS, isWithin } from "./runner/session-rule-policy.js";
 const ask = (message) => ({ action: "ask", message, decisionReason: "rule" });
 export function createFsWriteGatePolicy(opts) {
     const { env, rootPath, defaultWrite } = opts;
-    const gated = new Set([...PATH_WRITE_TOOLS, "NotebookEdit"]);
+    const gated = PATH_CONFINABLE_WRITE_TOOLS;
     const acceptDirs = opts.acceptDirs && opts.acceptDirs.length > 0 ? opts.acceptDirs : undefined;
     const exemptDirs = opts.exemptDirs && opts.exemptDirs.length > 0 ? opts.exemptDirs : undefined;
     return {

package/dist/core/lsp-diagnostics.d.ts

@@ -22,9 +22,10 @@ export declare class LspDiagnosticsRegistry {
     private readonly pending;
     private readonly delivered;
     publish(uri: string, diagnostics: LspDiagnostic[]): void;
-    fileEdited(uri: string): void;
+    fileEdited(runIdent: string, uri: string): void;
+    releaseRun(runIdent: string): void;
     isEmpty(): boolean;
-    drain(): LspFileDiagnostics[];
+    drain(runIdent: string): LspFileDiagnostics[];
 }
 export declare function formatDiagnosticsSummary(files: LspFileDiagnostics[]): string;
 export declare function formatDiagnosticsBlock(files: LspFileDiagnostics[]): string;

package/dist/core/lsp-diagnostics.js

@@ -16,30 +16,39 @@ function diagnosticKey(uri, d) {
 }
 export class LspDiagnosticsRegistry {
     pending = new Map();
-    delivered = new Set();
+    delivered = new Map();
     publish(uri, diagnostics) {
         if (diagnostics.length === 0)
             this.pending.delete(uri);
         else
             this.pending.set(uri, diagnostics);
     }
-    fileEdited(uri) {
+    fileEdited(runIdent, uri) {
+        const forRun = this.delivered.get(runIdent);
+        if (forRun === undefined)
+            return;
         const prefix = `${uri}|`;
-        for (const key of this.delivered) {
+        for (const key of forRun) {
             if (key.startsWith(prefix))
-                this.delivered.delete(key);
+                forRun.delete(key);
         }
+        if (forRun.size === 0)
+            this.delivered.delete(runIdent);
+    }
+    releaseRun(runIdent) {
+        this.delivered.delete(runIdent);
     }
     isEmpty() {
         return this.pending.size === 0;
     }
-    drain() {
+    drain(runIdent) {
         const out = [];
         const requeued = new Map();
+        let delivered = this.delivered.get(runIdent);
         let total = 0;
         for (const [uri, all] of this.pending) {
             const fresh = all
-                .filter((d) => !this.delivered.has(diagnosticKey(uri, d)))
+                .filter((d) => delivered?.has(diagnosticKey(uri, d)) !== true)
                 .sort((a, b) => (a.severity ?? 99) - (b.severity ?? 99));
             if (fresh.length === 0)
                 continue;
@@ -49,8 +58,12 @@ export class LspDiagnosticsRegistry {
                 requeued.set(uri, fresh.slice(take.length));
             if (take.length === 0)
                 continue;
+            if (delivered === undefined) {
+                delivered = new Set();
+                this.delivered.set(runIdent, delivered);
+            }
             for (const d of take)
-                this.delivered.add(diagnosticKey(uri, d));
+                delivered.add(diagnosticKey(uri, d));
             total += take.length;
             out.push({ uri, diagnostics: take });
         }

package/dist/core/memory-recall.js

@@ -30,6 +30,11 @@ export const RECALL_CAVEAT = "These notes were recalled as relevant, but they ar
     "- If the user is about to act on your recommendation (not just asking about history), verify first.\n" +
     "- If a note names a file, check the file exists; if it names a function or symbol, grep for it; if it names a flag or value, read the current source.\n" +
     "- Memory is a snapshot from when it was written, not a live view — prefer `git log` or reading the code over recalling the snapshot.";
+function isNewerNote(candidate, incumbent) {
+    if (candidate.timestampMissing || incumbent.timestampMissing)
+        return false;
+    return candidate.mtimeMs > incumbent.mtimeMs;
+}
 export function resolveLinkedIds(headers, selected, max) {
     if (max <= 0 || selected.length === 0)
         return [];
@@ -38,7 +43,7 @@ export function resolveLinkedIds(headers, selected, max) {
         if (!h.name)
             continue;
         const prev = byName.get(h.name);
-        if (!prev || h.mtimeMs > prev.mtimeMs)
+        if (!prev || isNewerNote(h, prev))
             byName.set(h.name, h);
     }
     const selectedIds = new Set(selected.map((r) => r.id));
@@ -100,8 +105,8 @@ export function validateSelectedIds(headers, ids, max) {
 export function composeSelectiveBody(manifestText, selected, nowMs, linked = [], recallable = true) {
     const renderNote = (r, label) => {
         const ageMs = nowMs - r.mtimeMs;
-        const verify = ageMs > ONE_DAY_MS ? " — verify it's still current" : "";
-        const stale = ` (written ${formatMemoryAge(ageMs)}${verify})`;
+        const verify = r.timestampMissing || ageMs > ONE_DAY_MS ? " — verify it's still current" : "";
+        const stale = r.timestampMissing ? ` (write time unknown${verify})` : ` (written ${formatMemoryAge(ageMs)}${verify})`;
         const prefix = label ? `${sanitizeUntrustedText(label, ["user_memory"])} ` : "";
         return `- ${prefix}${sanitizeUntrustedText(r.text, ["user_memory"])}${stale}`;
     };

package/dist/core/memory.d.ts

@@ -40,6 +40,7 @@ export interface MemoryNoteHeader {
     id: string;
     description: string;
     mtimeMs: number;
+    timestampMissing?: true;
     name?: string;
     type?: string;
     consolidationGenerated?: boolean;
@@ -84,6 +85,10 @@ export declare class InMemoryMemoryStore implements MemoryStore {
 export declare function expandLexicalTerms(term: string): string[];
 export declare function lexicalSearchMatch(query: string, text: string): boolean;
 export declare function firstSentence(text: string): string;
+export declare function parseNoteTimestamp(ts: unknown): {
+    mtimeMs: number;
+    timestampMissing?: true;
+};
 export interface NormalizedMemorySpec {
     scopes: string[];
     writeScope: string | null;

package/dist/core/memory.js

@@ -268,7 +268,7 @@ export class InMemoryMemoryStore {
         return entries.map((e) => ({
             id: e.id,
             description: e.description ?? firstSentence(e.text),
-            mtimeMs: mtimeMsOf(e.ts),
+            ...parseNoteTimestamp(e.ts),
             ...(e.name ? { name: e.name } : {}),
             ...(e.type ? { type: e.type } : {}),
             ...(e.consolidationGenerated ? { consolidationGenerated: true } : {}),
@@ -291,7 +291,7 @@ export class InMemoryMemoryStore {
             id: e.id,
             text: e.text,
             description: e.description ?? firstSentence(e.text),
-            mtimeMs: mtimeMsOf(e.ts),
+            ...parseNoteTimestamp(e.ts),
             ...(e.name ? { name: e.name } : {}),
             ...(e.type ? { type: e.type } : {}),
             ...(e.consolidationGenerated ? { consolidationGenerated: true } : {}),
@@ -347,9 +347,11 @@ export function firstSentence(text) {
     const cut = dot >= 0 && dot < 160 ? dot + 1 : Math.min(t.length, 120);
     return t.slice(0, cut).trim();
 }
-function mtimeMsOf(ts) {
+export function parseNoteTimestamp(ts) {
+    if (typeof ts !== "string" || ts.trim() === "")
+        return { mtimeMs: 0, timestampMissing: true };
     const ms = Date.parse(`${ts.replace(" ", "T")}:00Z`);
-    return Number.isFinite(ms) ? ms : 0;
+    return Number.isFinite(ms) ? { mtimeMs: ms } : { mtimeMs: 0, timestampMissing: true };
 }
 export function normalizeMemorySpec(input) {
     if (!input)

package/dist/core/runner/assemble-result.d.ts

@@ -59,6 +59,7 @@ export interface ResultFlags {
     unpricedSpend?: boolean;
     rewindNotes?: TaskResult["rewindNotes"];
     remoteEnvFailures?: TaskResult["remoteEnvFailures"];
+    retryAfterMs?: number;
     abortedForTimeout: boolean;
     abortedForTurns: boolean;
     abortedLive?: boolean;

package/dist/core/runner/assemble-result.js

@@ -1,5 +1,14 @@
 import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
 import { extractErrorCode, stripErrorCodePrefix } from "../../brain/errors.js";
+const SALVAGE_ELIGIBLE_TERMINALS = new Set([
+    "output.degenerate",
+    "limits.max_tokens_exceeded",
+    "limits.max_cost_exceeded",
+    "limits.max_turns_exceeded",
+    "limits.max_walltime_exceeded",
+    "env.lifetime_expired",
+    "usage.window_exhausted",
+]);
 export function errorCodeOf(err) {
     let cur = err;
     let fallback;
@@ -63,7 +72,6 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
         status = "failed";
         errorCode = "output.degenerate";
         errorMessage = final?.errorMessage;
-        salvagedOutput = text.trim() || undefined;
     }
     else if (flags.budgetHit) {
         status = "failed";
@@ -73,7 +81,6 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
             flags.budgetHit === "precall"
                 ? `the estimated cost of the first call already exceeds ${axisName}; the task was not started`
                 : `cumulative usage exceeded ${axisName}`;
-        salvagedOutput = text.trim() || undefined;
     }
     else if (flags.suspendLoop) {
         status = "failed";
@@ -90,8 +97,6 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
                 : flags.conflict
                     ? "conflict"
                     : errorCodeOf(flags.threw);
-        if (flags.abortedForTimeout || flags.abortedForTurns)
-            salvagedOutput = text.trim() || undefined;
     }
     else if (flags.blockedReason) {
         status = "blocked";
@@ -114,8 +119,6 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
         status = "failed";
         errorCode = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : undefined;
         errorMessage = final?.errorMessage ?? (flags.abortedForTurns ? "max turns exceeded" : "run aborted");
-        if (flags.abortedForTimeout || flags.abortedForTurns)
-            salvagedOutput = text.trim() || undefined;
     }
     else if (!final) {
         status = "failed";
@@ -139,9 +142,13 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
     else {
         status = "completed";
     }
+    if (errorCode !== undefined && SALVAGE_ELIGIBLE_TERMINALS.has(errorCode)) {
+        salvagedOutput = text.trim() || undefined;
+    }
+    const retryAfterMs = errorCode === "usage.window_exhausted" ? flags.retryAfterMs : undefined;
     const { compactionMicroUsd: _internalCompaction, ...publicStats } = stats;
     void _internalCompaction;
     if (flags.unpricedSpend)
         delete publicStats.costMicroUsd;
-    return { taskId, sessionId, status, ...(flags.model !== undefined ? { model: flags.model } : {}), result: result.trim(), salvagedOutput, blockedReason, errorMessage, errorCode, checkpointToken, checkpointGate, ...(workspaceRestoreMode !== undefined ? { workspaceRestoreMode } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: flags.remoteEnvFailures } : {}), stats: publicStats };
+    return { taskId, sessionId, status, ...(flags.model !== undefined ? { model: flags.model } : {}), result: result.trim(), salvagedOutput, blockedReason, errorMessage, errorCode, ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), checkpointToken, checkpointGate, ...(workspaceRestoreMode !== undefined ? { workspaceRestoreMode } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: flags.remoteEnvFailures } : {}), stats: publicStats };
 }

package/dist/core/runner/prepare-task.d.ts

@@ -9,6 +9,7 @@ import { SubagentRetainLedger } from "../../agents/retain-ledger.js";
 import type { OnAsk, ToolPolicy } from "../tool-policy.js";
 import { type ActiveSkillFrame } from "./active-skill-scope.js";
 import type { SessionPermissionRules } from "../session-policy-store.js";
+import { type RecoveredOrphan } from "../session-reconcile.js";
 import { CacheBreakDetector, type ToolFingerprintInput } from "../cache-break-detector.js";
 import { type BrainCallGuardrailRef } from "../../brain/timeout.js";
 import { type OutputRef, type BlockedRef, type SkillListingEntry } from "./synthetic-tools.js";
@@ -18,7 +19,7 @@ import type { TaskNotificationPayload } from "../task-notification.js";
 import { type CwdRef } from "../../tools/fs/index.js";
 import { type WorkflowSizeGuideline } from "../../orchestration/workflow-size-guideline.js";
 import type { Runner } from "./runtask.js";
-import { type CheckpointGate, type CheckpointState, type CheckpointToken, type ResourceLedger, type PlatformLimitReason, type ResourceLimitReason } from "../checkpoint-store.js";
+import { type CheckpointGate, type CheckpointState, type CheckpointStore, type CheckpointToken, type ResourceLedger, type PlatformLimitReason, type ResourceLimitReason } from "../checkpoint-store.js";
 import type { ActiveWorktreeSession, AgentMessage, AgentTool, ExecutionEnv } from "../../internal/harness.js";
 import type { NestedUsageAccum, RunnerDeps, TaskEvent, TaskLimits, TaskResult, TaskSpec, ToolActivity, ToolEffect } from "../types.js";
 import type { RepairBundle } from "../../agents/repair-loop.js";
@@ -42,6 +43,11 @@ export declare function checkpointScopeOf(spec: {
     };
     principal?: string;
 }): string;
+export declare function resolveCheckpointStore(spec: {
+    checkpointStore?: CheckpointStore | null;
+}, deps: {
+    checkpointStore?: CheckpointStore;
+}): CheckpointStore | undefined;
 export interface Prepared {
     harness: AgentHarness;
     session: StoredSession;
@@ -187,6 +193,7 @@ export interface Prepared {
     now: () => number;
     tools: AgentTool[];
     toolEffects: Map<string, ToolEffect>;
+    wakeRecovered: RecoveredOrphan[];
     promptOverheadTokens: number;
     readTaskFile?: (path: string) => Promise<string | null>;
     recentlyReadFiles?: () => string[];
@@ -199,6 +206,7 @@ export interface Prepared {
     lspDiagnostics?: {
         registry: import("../lsp-diagnostics.js").LspDiagnosticsRegistry;
         nudge: (rawPath: string) => void;
+        runIdent: string;
     };
     planModeRef: {
         active: boolean;

package/dist/core/runner/prepare-task.js

@@ -17,7 +17,7 @@ import { createSubagentWorktreeHelper, forkGovernanceDenial } from "../../agents
 import { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME } from "../../agents/agent-transcript-tool.js";
 import { createSendMessageTool, SEND_MESSAGE_TOOL_NAME } from "../../agents/send-message-tool.js";
 import { SubagentRetainLedger } from "../../agents/retain-ledger.js";
-import { combinePolicies, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, refuseOutOfContractDecision, resolveAsk, toolPolicyNameSets } from "../tool-policy.js";
+import { askApproverIdentity, combinePolicies, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, refuseOutOfContractDecision, resolveAsk, toolPolicyNameSets } from "../tool-policy.js";
 import { ActiveSkillScope, createActiveSkillScopePolicy } from "./active-skill-scope.js";
 import { CHANGED_FILES_MTIME_EPS_MS, fenceMcpServerInstructions, renderAgentListingDelta } from "./turn-attachments.js";
 import { inlineUntrusted } from "../untrusted-text.js";
@@ -57,7 +57,7 @@ import { hasBackgroundShell, sweepBackgroundShells } from "../background-shell.j
 import { createTaskOutputTool, createTaskStopTool, defaultTaskRegistry } from "../task-registry.js";
 import { createMonitorTool } from "../../tools/monitor.js";
 import { createWorktreeTools } from "../../tools/worktree.js";
-import { applyCompactionToReadFileState, bashReversibilityProbe, createHandsToolkit, isReadDedupStubResult, seedReadFileStateFromContext, HAND_TOOL_EFFECTS, pdfModelCapabilitiesOf } from "../../tools/fs/index.js";
+import { applyCompactionToReadFileState, bashReversibilityProbe, createHandsToolkit, isReadDedupStubResult, seedReadFileStateFromContext, seedReadFileStateFromTranscript, HAND_TOOL_EFFECTS, pdfModelCapabilitiesOf } from "../../tools/fs/index.js";
 import { decodeTextBytes } from "../../tools/fs/encoding.js";
 import { ASK_USER_QUESTION_TOOL_NAME, createAskUserQuestionTool } from "../ask-question.js";
 import { createSchedulerTools } from "../../tools/scheduler-tools.js";
@@ -67,6 +67,7 @@ import { createRunWorkflowTool, RUN_WORKFLOW_TOOL_NAME } from "../../orchestrati
 import { resolveWorkflowSizeGuideline } from "../../orchestration/workflow-size-guideline.js";
 import { createLspTool, gitCheckIgnoreFilter, resolveLspPath } from "../lsp.js";
 import { resolveKey } from "../../tools/fs/safety.js";
+import { wholeFileRecordsFromTranscript } from "./session-file-state-replay.js";
 import { BINDING_CHECKPOINT_VERSION, mintCheckpointToken, RESOURCE_CHECKPOINT_VERSION, TOKEN_CHECKPOINT_VERSION, buildRiskDescriptor, debitLedger, remainingBudgetMicroUsd, } from "../checkpoint-store.js";
 import { boundInputHashOf } from "../canonical-json.js";
 import { GLOBAL_USAGE_KEY, resolveUsageWindows, usageRetryAfterMs } from "../usage-window-store.js";
@@ -171,6 +172,11 @@ export const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
 export function checkpointScopeOf(spec) {
     return spec.durableApproval?.scope || spec.principal || DEFAULT_IRREVERSIBLE_SCOPE;
 }
+export function resolveCheckpointStore(spec, deps) {
+    if (spec.checkpointStore === null)
+        return undefined;
+    return spec.checkpointStore ?? deps.checkpointStore;
+}
 export function isFableFamilyModelId(id) {
     const tail = id.toLowerCase().split("/").pop() ?? "";
     return /^claude-fable-\d/.test(tail) || /^claude-mythos-5(?!\d)/.test(tail);
@@ -319,6 +325,20 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         throw e;
     }
     resolveTaskLimits(spec.limits);
+    if (spec.resourceSuspend !== undefined) {
+        const rsus = spec.resourceSuspend;
+        if (typeof rsus.scope !== "string" || rsus.scope === "") {
+            throw limitConfigError("config.limit_invalid", `TaskSpec.resourceSuspend.scope must be a non-empty string (got ${String(rsus.scope)}) — it is the multi-tenant isolation key every resource checkpoint is filed under.`);
+        }
+        for (const key of ["totalBudgetUsd", "totalTokens", "maxSlices", "ttlMs"]) {
+            const value = rsus[key];
+            if (value === undefined)
+                continue;
+            if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+                throw limitConfigError("config.limit_invalid", `TaskSpec.resourceSuspend.${key} must be a finite, non-negative number (got ${String(value)}) — an unevaluable allocation is not an allocation, and a NaN here blinds even the validated per-slice window.`);
+            }
+        }
+    }
     const usageWindows = resolveUsageWindows(deps.usageWindows);
     const brainCallGuardrailRef = {};
     const brainCallGuardrailMs = resolveBrainCallGuardrailMs(spec.limits?.brainCallGuardrailMs ?? deps.brainCallGuardrailMs);
@@ -411,6 +431,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
     let acquired;
     let session;
     let conflictRef;
+    let wakeRecovered = [];
     let resumeAtBeforeParentId = null;
     for (let attempt = 0;; attempt++) {
         try {
@@ -487,7 +508,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                 }
                 await session.getStorage().setLeafId(spec.resumeAtMode === "before" ? entry.parentId : spec.resumeAt);
             }
-            await reconcileInterruptedSession(session, toolEffects, resume?.suspendedBatch);
+            wakeRecovered = (await reconcileInterruptedSession(session, toolEffects, resume?.suspendedBatch)).recovered;
             break;
         }
         catch (err) {
@@ -910,6 +931,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         const effectiveShellGate = inheritedShellGate !== undefined && shellGateRank[inheritedShellGate] > shellGateRank[specShellGate] ? inheritedShellGate : specShellGate;
         const ownSessionRulesRef = {};
         const frozenOnAsk = spec.onAsk ?? deps.onAsk;
+        const frozenOnQuestion = spec.onQuestion ?? deps.onQuestion;
         const inheritedGateForChildren = () => {
             const ancestorRules = [
                 ...(inheritedAncestorRules ?? []),
@@ -944,6 +966,10 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             model: harnessRef.current?.getModel(),
             thinkingLevel: harnessRef.current?.getThinkingLevel(),
             principal: spec.principal,
+            ...(frozenOnAsk !== undefined ? { onAsk: frozenOnAsk } : {}),
+            ...(frozenOnQuestion !== undefined ? { onQuestion: frozenOnQuestion } : {}),
+            ...(spec.handsReadOnly === true ? { handsReadOnly: true } : {}),
+            ...(spec.interactiveTools === false ? { interactiveTools: false } : {}),
             oneShot: spec.oneShot,
             clientContext: spec.clientContext,
             excludeTools: toolFaceSnapshot.exclude,
@@ -960,6 +986,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             inheritedGateForChildren,
             ...(autoModeDecider ? { autoModeReview: { decider: autoModeDecider } } : {}),
             ...(spec.durableApproval !== undefined ? { durableApprovalForChildren: { ...spec.durableApproval } } : {}),
+            ...(spec.checkpointStore === null ? { checkpointStoreDisabledForChildren: true } : {}),
             taskId: hostTaskId,
             ...(internals?.parentTaskId !== undefined ? { parentTaskId: internals.parentTaskId } : {}),
             ...(internals?.parentSessionId !== undefined ? { parentSessionId: internals.parentSessionId } : {}),
@@ -1013,7 +1040,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             tools.push(createReportFindingsTool());
         }
         if (spec.enablePlanMode === true && spec.interactiveTools !== false) {
-            const planReviewFace = (spec.checkpointStore ?? deps.checkpointStore) !== undefined;
+            const planReviewFace = resolveCheckpointStore(spec, deps) !== undefined;
             if (spec.interactiveTools === true || planReviewFace) {
                 tools.push(defineTool(createPresentPlanTool(requestReview)));
                 if (planReviewFace) {
@@ -1351,6 +1378,14 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             }
             const readFileState = new Map((resume?.seed.readFileState ?? []).map(([k, v]) => [rebaseRestoredPath(k), v]));
             readFileStateForCheckpoint = readFileState;
+            if (resume === undefined && spec.sessionId !== undefined) {
+                const prior = await session.buildContext().catch(() => undefined);
+                for (const rec of wholeFileRecordsFromTranscript(prior?.messages ?? [])) {
+                    const rk = await resolveKey(executionEnv, rootCanonical, rec.path, undefined, undefined, additionalRootsCanonical);
+                    if (rk.ok)
+                        seedReadFileStateFromTranscript(readFileState, rk.key, rec.content, rec.at);
+                }
+            }
             seedContextFiles = async (files) => {
                 for (const f of files) {
                     const rk = await resolveKey(executionEnv, rootCanonical, f.path, undefined, undefined, additionalRootsCanonical);
@@ -1532,8 +1567,8 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         }
         if (offloadStore)
             tools.push(createReadToolResultTool(offloadStore));
-        const onQuestion = spec.onQuestion ?? deps.onQuestion;
-        const durableQuestionFace = (spec.checkpointStore ?? deps.checkpointStore) !== undefined &&
+        const onQuestion = frozenOnQuestion;
+        const durableQuestionFace = resolveCheckpointStore(spec, deps) !== undefined &&
             (spec.durableApproval !== undefined || runtimeCaps?.forceDurableGate === true);
         if (spec.interactiveTools === true || (spec.interactiveTools !== false && (onQuestion !== undefined || durableQuestionFace)))
             tools.push(createAskUserQuestionTool(onQuestion, { principal: spec.principal, sourceTaskId: sessionId }));
@@ -1562,11 +1597,12 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         const lspDiagnostics = spec.lspDiagnostics !== false && lspManager?.diagnostics !== undefined && handsEnabled && spec.handsReadOnly !== true
             ? lspManager.diagnostics
             : undefined;
+        const lspRunIdent = sessionId;
         const nudgeLspOnEdit = lspDiagnostics
             ? (rawPath) => {
                 const baseDir = handsCwdRef?.current ?? taskRootPath;
                 const filePath = resolveLspPath(rawPath, baseDir);
-                lspDiagnostics.fileEdited(pathToUri(filePath));
+                lspDiagnostics.fileEdited(lspRunIdent, pathToUri(filePath));
                 void lspManager
                     .sessionFor(filePath, undefined, executionEnv)
                     .then((session) => session?.notifyFileChanged?.(filePath))
@@ -2203,6 +2239,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             ? { legDate: envFacts.date, today: () => formatLocalDate(new Date(), tzValid ? userTz : undefined) }
             : undefined;
         const harness = new AgentHarness({
+            abortResultDetails: () => suspendRef.token !== undefined || reviewRef.token !== undefined ? { code: "gate.parked" } : undefined,
             ...(spec.limits?.maxOutputTokens !== undefined && spec.limits.maxOutputTokens > 0
                 ? { maxOutputTokens: spec.limits.maxOutputTokens }
                 : {}),
@@ -2459,7 +2496,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                     if (creq.toolName === ASK_USER_QUESTION_TOOL_NAME)
                         return first;
                     if (pc.durableMandate === true) {
-                        if ((spec.checkpointStore ?? deps.checkpointStore) !== undefined &&
+                        if (resolveCheckpointStore(spec, deps) !== undefined &&
                             (spec.durableApproval !== undefined || runtimeCaps?.forceDurableGate === true) &&
                             markInheritedUnavailable(creq.toolCallId)) {
                             return first;
@@ -2515,7 +2552,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                     if (creq.toolName === ASK_USER_QUESTION_TOOL_NAME)
                         return decision;
                     if (pc.durableMandate === true) {
-                        if ((spec.checkpointStore ?? deps.checkpointStore) !== undefined &&
+                        if (resolveCheckpointStore(spec, deps) !== undefined &&
                             (spec.durableApproval !== undefined || runtimeCaps?.forceDurableGate === true) &&
                             markInheritedUnavailable(creq.toolCallId)) {
                             return decision;
@@ -2675,13 +2712,13 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         const blockedTracked = Boolean(hooks?.postToolUse || hooks?.preToolUse || hooks?.postToolUseFailure || hooks?.postToolBatch);
         const restoreSurfaceGap = ownedEnv !== undefined && isRemoteExecutionEnv(ownedEnv) && ownedEnv.capabilities.suspendable ? missingRestoreSurface(ownedEnv) : [];
         const incompleteSuspendAdapter = restoreSurfaceGap.length > 0 ? restoreSurfaceGap : undefined;
-        const durableSuspendInfraReady = (spec.checkpointStore ?? deps.checkpointStore) !== undefined &&
+        const durableSuspendInfraReady = resolveCheckpointStore(spec, deps) !== undefined &&
             !(offloadStore !== undefined && isVolatileOffloadStore(offloadStore)) &&
             (ownedEnv === undefined || isRemoteExecutionEnv(ownedEnv)) &&
             incompleteSuspendAdapter === undefined;
         const resourceSuspendEligible = spec.resourceSuspend !== undefined && durableSuspendInfraReady;
         if (spec.resourceSuspend !== undefined && !resourceSuspendEligible) {
-            const why = (spec.checkpointStore ?? deps.checkpointStore) === undefined
+            const why = resolveCheckpointStore(spec, deps) === undefined
                 ? "no CheckpointStore is wired"
                 : offloadStore !== undefined && isVolatileOffloadStore(offloadStore)
                     ? "tool-result offload uses the in-memory store (a resume needs durable results)"
@@ -2774,7 +2811,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                 }
                 if (decision.decisionReason === undefined || decision.decisionReason === "rule") {
                     const grant = inheritedAskGrants.get(req.toolCallId);
-                    if (grant !== undefined && grant.approver === onAsk && grant.argsJson === askGrantShapeOf(req.args)) {
+                    if (grant !== undefined && askApproverIdentity(grant.approver) === askApproverIdentity(onAsk) && grant.argsJson === askGrantShapeOf(req.args)) {
                         inheritedAskGrants.delete(req.toolCallId);
                         humanReviewRef.count += 1;
                         humanReviewRef.totalWaitMs += grant.waitMs;
@@ -2839,7 +2876,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                 catch {
                 }
             };
-            const checkpointStore = spec.checkpointStore ?? deps.checkpointStore;
+            const checkpointStore = resolveCheckpointStore(spec, deps);
             const durableApproval = spec.durableApproval ??
                 (runtimeCaps?.forceDurableGate ? { scope: spec.principal || DEFAULT_IRREVERSIBLE_SCOPE } : undefined);
             const inFlightSpendMicroUsd = () => {
@@ -3599,7 +3636,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
             : undefined;
         overheadState.promptChars = systemPrompt.length;
         const preparedHolder = {};
-        const buildPrepared = () => ({ harness, session, sessionId, taskRootPath, model, thinking, compModel, mcp: mcp, ...(a2a !== undefined && a2a.tools.length > 0 ? { a2a } : {}), blockedRef, outputRef, abortController, conflictRef, blockedToolCalls, nestedStats, ...(rewindNotes.length > 0 ? { rewindNotes } : {}), cwdRef: handsCwdRef, ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), ...(workspaceStateSettle !== undefined ? { workspaceStateSettle } : {}), denyNarrowingPolicy, ...(basePolicyForResumeEdit !== undefined ? { basePolicyForResumeEdit } : {}), releaseSignal, cacheBreakDetector, cacheFingerprint, promptManifest, epochDeclaredSections, activeTools, ...(deferred.size > 0 ? { deferredToolNames: deferred } : {}), ownedEnv, suspendRef, reviewRef, remoteEnvFailures, reviewRequestRef, suspendLoopRef, suspendForResource, ...(suspendForPlatformLimit !== undefined ? { suspendForPlatformLimit } : {}), ...(envLifetimeSuspendAt !== undefined ? { envLifetimeSuspendAt } : {}), ...(usageGovernance !== undefined ? { usageGovernance } : {}), callIssuedAtRef, brainCallGuardrailRef, suspendForReview, resourceLedger: priorLedger, liveSpendRef, humanReviewRef, now, tools, toolEffects, promptOverheadTokens, readTaskFile, recentlyReadFiles, normalizeAttachmentPath, isDedupStubResult, ...(onCompactionApplied ? { onCompactionApplied } : {}), compactionReuseRef, trimPressureRef, ...(memoryEngineSession ? { memoryEngineSession } : {}), ...(subagentRetain ? { subagentRetain } : {}), ...(lspDiagnostics && nudgeLspOnEdit ? { lspDiagnostics: { registry: lspDiagnostics, nudge: nudgeLspOnEdit } } : {}), planModeRef, ...(dateChange ? { dateChange } : {}), ...(instructionSources ? { instructionSources } : {}), ...(workflowSizeGuideline ? { workflowSizeGuideline } : {}), ...(detectExternalChanges ? { detectExternalChanges } : {}), ...(toolsDeltaRef ? { toolsDeltaRef } : {}), ...(agentListing ? { agentListing } : {}), ...(skillsListing ? { skillsListing } : {}), announcedListingsRef, listBackgroundTasks, ...(turnSnapshotRef.current !== undefined ? { turnSnapshot: turnSnapshotRef.current } : {}), ...(centerCompactionCandidate !== undefined ? { centerCompactionCandidate } : {}) });
+        const buildPrepared = () => ({ harness, session, sessionId, taskRootPath, model, thinking, compModel, mcp: mcp, ...(a2a !== undefined && a2a.tools.length > 0 ? { a2a } : {}), blockedRef, outputRef, abortController, conflictRef, blockedToolCalls, nestedStats, ...(rewindNotes.length > 0 ? { rewindNotes } : {}), cwdRef: handsCwdRef, ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), ...(workspaceStateSettle !== undefined ? { workspaceStateSettle } : {}), denyNarrowingPolicy, ...(basePolicyForResumeEdit !== undefined ? { basePolicyForResumeEdit } : {}), releaseSignal, cacheBreakDetector, cacheFingerprint, promptManifest, epochDeclaredSections, activeTools, ...(deferred.size > 0 ? { deferredToolNames: deferred } : {}), ownedEnv, suspendRef, reviewRef, remoteEnvFailures, reviewRequestRef, suspendLoopRef, suspendForResource, ...(suspendForPlatformLimit !== undefined ? { suspendForPlatformLimit } : {}), ...(envLifetimeSuspendAt !== undefined ? { envLifetimeSuspendAt } : {}), ...(usageGovernance !== undefined ? { usageGovernance } : {}), callIssuedAtRef, brainCallGuardrailRef, suspendForReview, resourceLedger: priorLedger, liveSpendRef, humanReviewRef, now, tools, toolEffects, wakeRecovered, promptOverheadTokens, readTaskFile, recentlyReadFiles, normalizeAttachmentPath, isDedupStubResult, ...(onCompactionApplied ? { onCompactionApplied } : {}), compactionReuseRef, trimPressureRef, ...(memoryEngineSession ? { memoryEngineSession } : {}), ...(subagentRetain ? { subagentRetain } : {}), ...(lspDiagnostics && nudgeLspOnEdit ? { lspDiagnostics: { registry: lspDiagnostics, nudge: nudgeLspOnEdit, runIdent: lspRunIdent } } : {}), planModeRef, ...(dateChange ? { dateChange } : {}), ...(instructionSources ? { instructionSources } : {}), ...(workflowSizeGuideline ? { workflowSizeGuideline } : {}), ...(detectExternalChanges ? { detectExternalChanges } : {}), ...(toolsDeltaRef ? { toolsDeltaRef } : {}), ...(agentListing ? { agentListing } : {}), ...(skillsListing ? { skillsListing } : {}), announcedListingsRef, listBackgroundTasks, ...(turnSnapshotRef.current !== undefined ? { turnSnapshot: turnSnapshotRef.current } : {}), ...(centerCompactionCandidate !== undefined ? { centerCompactionCandidate } : {}) });
         const prepared = buildPrepared();
         preparedHolder.current = prepared;
         return prepared;