@caupulican/pi-adaptative 0.93.18 → 0.93.19

package/dist/core/foreground-lifecycle-adapter.js

@@ -0,0 +1,61 @@
+import { ForegroundLifecycleController } from "./foreground-lifecycle-controller.js";
+/**
+ * Host-side adapter for the foreground lifecycle boundary.
+ *
+ * The lifecycle controller owns request/tool repair semantics. This adapter owns the coding-agent
+ * persistence wiring around it: atomic router batches, canonical message ids, and warnings emitted
+ * before the first session subscriber exists.
+ */
+export class ForegroundLifecycleAdapter {
+    constructor(agent, sessionManager, modelRouter) {
+        this.pendingWarnings = [];
+        this.sessionManager = sessionManager;
+        this.lifecycle = new ForegroundLifecycleController({
+            agent,
+            sessionManager,
+            modelRouter,
+            emitWarning: (message) => this.pendingWarnings.push(message),
+        });
+    }
+    install() {
+        this.lifecycle.install();
+    }
+    start() {
+        this.install();
+        this.repair();
+    }
+    reload() {
+        this.resetForSessionReload();
+        this.repair();
+    }
+    repair() {
+        this.lifecycle.repair();
+    }
+    resetForSessionReload() {
+        this.lifecycle.resetForSessionReload();
+    }
+    appendMessage(message) {
+        const entryId = this.sessionManager.appendMessage(message);
+        this.lifecycle.onMessagePersisted(message, entryId);
+        return entryId;
+    }
+    appendMessageBatch(batch) {
+        const entryIds = this.sessionManager.appendMessageBatch(batch);
+        for (let index = 0; index < batch.length; index += 1) {
+            const item = batch[index];
+            if (item.kind === "message")
+                this.lifecycle.onMessagePersisted(item.message, entryIds[index]);
+        }
+        return entryIds;
+    }
+    drainWarnings() {
+        const warnings = this.pendingWarnings;
+        this.pendingWarnings = [];
+        return warnings;
+    }
+    emitPendingWarnings(emit) {
+        for (const warning of this.drainWarnings())
+            emit(warning);
+    }
+}
+//# sourceMappingURL=foreground-lifecycle-adapter.js.map

package/dist/core/foreground-lifecycle-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreground-lifecycle-adapter.js","sourceRoot":"","sources":["../../src/core/foreground-lifecycle-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAGrF;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IAKtC,YAAY,KAAY,EAAE,cAA8B,EAAE,WAAkC;QAFpF,oBAAe,GAAa,EAAE,CAAC;QAGtC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,KAAK;YACL,cAAc;YACd,WAAW;YACX,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;SAC5D,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,MAAM;QACL,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,MAAM;QACL,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAED,qBAAqB;QACpB,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,OAAgB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,kBAAkB,CAAC,KAA0C;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC/D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,aAAa;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,mBAAmB,CAAC,IAA+B;QAClD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE;YAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CACD","sourcesContent":["import type { Agent } from \"@caupulican/pi-agent-core\";\nimport type { SessionManager, SessionMessageBatchEntry } from \"@caupulican/pi-agent-core/session\";\nimport type { Message } from \"@caupulican/pi-ai\";\nimport { ForegroundLifecycleController } from \"./foreground-lifecycle-controller.ts\";\nimport type { ModelRouterController } from \"./model-router-controller.ts\";\n\n/**\n * Host-side adapter for the foreground lifecycle boundary.\n *\n * The lifecycle controller owns request/tool repair semantics. This adapter owns the coding-agent\n * persistence wiring around it: atomic router batches, canonical message ids, and warnings emitted\n * before the first session subscriber exists.\n */\nexport class ForegroundLifecycleAdapter {\n\tprivate readonly lifecycle: ForegroundLifecycleController;\n\tprivate readonly sessionManager: SessionManager;\n\tprivate pendingWarnings: string[] = [];\n\n\tconstructor(agent: Agent, sessionManager: SessionManager, modelRouter: ModelRouterController) {\n\t\tthis.sessionManager = sessionManager;\n\t\tthis.lifecycle = new ForegroundLifecycleController({\n\t\t\tagent,\n\t\t\tsessionManager,\n\t\t\tmodelRouter,\n\t\t\temitWarning: (message) => this.pendingWarnings.push(message),\n\t\t});\n\t}\n\n\tinstall(): void {\n\t\tthis.lifecycle.install();\n\t}\n\n\tstart(): void {\n\t\tthis.install();\n\t\tthis.repair();\n\t}\n\n\treload(): void {\n\t\tthis.resetForSessionReload();\n\t\tthis.repair();\n\t}\n\n\trepair(): void {\n\t\tthis.lifecycle.repair();\n\t}\n\n\tresetForSessionReload(): void {\n\t\tthis.lifecycle.resetForSessionReload();\n\t}\n\n\tappendMessage(message: Message): string {\n\t\tconst entryId = this.sessionManager.appendMessage(message);\n\t\tthis.lifecycle.onMessagePersisted(message, entryId);\n\t\treturn entryId;\n\t}\n\n\tappendMessageBatch(batch: readonly SessionMessageBatchEntry[]): string[] {\n\t\tconst entryIds = this.sessionManager.appendMessageBatch(batch);\n\t\tfor (let index = 0; index < batch.length; index += 1) {\n\t\t\tconst item = batch[index]!;\n\t\t\tif (item.kind === \"message\") this.lifecycle.onMessagePersisted(item.message, entryIds[index]!);\n\t\t}\n\t\treturn entryIds;\n\t}\n\n\tdrainWarnings(): string[] {\n\t\tconst warnings = this.pendingWarnings;\n\t\tthis.pendingWarnings = [];\n\t\treturn warnings;\n\t}\n\n\temitPendingWarnings(emit: (message: string) => void): void {\n\t\tfor (const warning of this.drainWarnings()) emit(warning);\n\t}\n}\n"]}

package/dist/core/foreground-lifecycle-controller.d.ts

@@ -0,0 +1,48 @@
+import type { Agent, AgentMessage } from "@caupulican/pi-agent-core";
+import type { SessionManager } from "@caupulican/pi-agent-core/session";
+import type { ModelRouterController } from "./model-router-controller.ts";
+interface ForegroundLifecycleControllerDeps {
+    agent: Agent;
+    sessionManager: SessionManager;
+    modelRouter: ModelRouterController;
+    emitWarning(message: string): void;
+}
+/**
+ * Foreground persistence boundary for provider requests and tool execution.
+ *
+ * Agent-core deliberately owns provider/tool ordering while coding-agent owns the session log. This
+ * controller is the adapter between those lifecycles: request snapshots are written before transport,
+ * cheap routed messages are committed before a prepared tool body starts, and canonical result message
+ * ids are linked to one bounded terminal record. It never persists request content, tool arguments, or
+ * tool results in lifecycle metadata.
+ */
+export declare class ForegroundLifecycleController {
+    private readonly deps;
+    private readonly persistedMessages;
+    private readonly startedTools;
+    private readonly pendingToolsByCall;
+    private readonly completedResultMessages;
+    constructor(deps: ForegroundLifecycleControllerDeps);
+    /** Install the two agent-core callbacks at the host-owned durability boundary. */
+    install(): void;
+    notePersistedMessage(message: AgentMessage, entryId: string): void;
+    /** Drop in-flight associations when the host swaps/reloads the active session branch. */
+    resetForSessionReload(): void;
+    private findPersistedMessageEntryId;
+    private requestReason;
+    private onProviderRequestSnapshot;
+    private appendMessage;
+    private onToolCallStart;
+    private toolKey;
+    private callKey;
+    /** Called after the canonical message entry has been appended by AgentSession. */
+    onMessagePersisted(message: AgentMessage, entryId: string): void;
+    /**
+     * Repair incomplete lifecycle records on construction/reload. The active branch is inspected first;
+     * duplicate, mismatched, or out-of-order records are left untouched and reported rather than guessed.
+     */
+    repair(): string[];
+    private appendRepairResult;
+}
+export {};
+//# sourceMappingURL=foreground-lifecycle-controller.d.ts.map

package/dist/core/foreground-lifecycle-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreground-lifecycle-controller.d.ts","sourceRoot":"","sources":["../../src/core/foreground-lifecycle-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAGX,cAAc,EACd,MAAM,mCAAmC,CAAC;AAI3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAa1E,UAAU,iCAAiC;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,qBAAqB,CAAC;IACnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAuLD;;;;;;;;GAQG;AACH,qBAAa,6BAA6B;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IACrE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAyB;IAEjE,YAAY,IAAI,EAAE,iCAAiC,EAElD;IAED,kFAAkF;IAClF,OAAO,IAAI,IAAI,CAGd;IAED,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjE;IAED,yFAAyF;IACzF,qBAAqB,IAAI,IAAI,CAG5B;IAED,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,aAAa;YAQP,yBAAyB;IA8BvC,OAAO,CAAC,aAAa,CAInB;YAEY,eAAe;IA+C7B,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,OAAO;IAIf,kFAAkF;IAClF,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAwB/D;IAED;;;OAGG;IACH,MAAM,IAAI,MAAM,EAAE,CAkEjB;IAED,OAAO,CAAC,kBAAkB;CAoB1B"}

package/dist/core/foreground-lifecycle-controller.js

@@ -0,0 +1,404 @@
+import { createHash } from "node:crypto";
+import { sessionLifecycleToolIdentityKey } from "@caupulican/pi-agent-core/session";
+const MAX_MESSAGE_ENTRY_IDS = 256;
+const MAX_WARNING_LENGTH = 500;
+const MAX_EXACT_FINGERPRINT_CHARS = 32 * 1024;
+const MAX_FINGERPRINT_DEPTH = 16;
+const MAX_FINGERPRINT_ITEMS = 256;
+const MAX_FINGERPRINT_STRING_CHARS = 16 * 1024;
+const MAX_PROVIDER_HISTORY_MESSAGES = 256;
+const MAX_LIFECYCLE_ANCESTRY_STEPS = 4096;
+function boundedWarning(message) {
+    const normalized = message
+        .replace(/[\u0000-\u001F\u007F]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    return normalized.length > MAX_WARNING_LENGTH ? `${normalized.slice(0, MAX_WARNING_LENGTH)}…` : normalized;
+}
+function boundedObjectKeys(record) {
+    const keys = [];
+    let truncated = false;
+    for (const key in record) {
+        if (!Object.hasOwn(record, key))
+            continue;
+        if (keys.length >= MAX_FINGERPRINT_ITEMS) {
+            truncated = true;
+            break;
+        }
+        keys.push(key);
+    }
+    keys.sort();
+    return { keys, truncated };
+}
+/**
+ * Canonicalize only bounded provider metadata. The system/tool envelope is allowed to retain exact
+ * values within the explicit cap; history is represented by descriptors below so a disk-backed or
+ * very long context is never copied into a second full object graph just to fingerprint it.
+ */
+function canonicalizeBounded(value, budget, depth = 0) {
+    if (budget.remaining <= 0)
+        return "[truncated]";
+    if (value === null || typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const limit = Math.min(MAX_FINGERPRINT_STRING_CHARS, budget.remaining);
+        budget.remaining -= Math.min(value.length, limit);
+        return value.length <= limit ? value : `${value.slice(0, limit)}…<${value.length}>`;
+    }
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : String(value);
+    if (typeof value === "bigint")
+        return value.toString();
+    if (typeof value === "undefined")
+        return "[undefined]";
+    if (typeof value === "function" || typeof value === "symbol")
+        return `[${typeof value}]`;
+    if (typeof value !== "object")
+        return String(value);
+    if (depth >= MAX_FINGERPRINT_DEPTH)
+        return `[depth:${depth}]`;
+    if (budget.seen.has(value))
+        return "[circular]";
+    budget.seen.add(value);
+    if (Array.isArray(value)) {
+        const result = [];
+        for (let index = 0; index < Math.min(value.length, MAX_FINGERPRINT_ITEMS); index += 1) {
+            result.push(canonicalizeBounded(value[index], budget, depth + 1));
+            if (budget.remaining <= 0)
+                break;
+        }
+        if (value.length > result.length)
+            result.push(`[items:${value.length}]`);
+        return result;
+    }
+    const record = value;
+    const { keys, truncated } = boundedObjectKeys(record);
+    const result = {};
+    for (const key of keys) {
+        const keyLimit = Math.min(key.length, budget.remaining, MAX_FINGERPRINT_STRING_CHARS);
+        const boundedKey = key.length <= keyLimit ? key : `${key.slice(0, keyLimit)}…<${key.length}>`;
+        budget.remaining -= Math.min(key.length, keyLimit);
+        result[boundedKey] = canonicalizeBounded(record[key], budget, depth + 1);
+        if (budget.remaining <= 0)
+            break;
+    }
+    if (truncated)
+        result["[keys]"] = `>${MAX_FINGERPRINT_ITEMS}`;
+    return result;
+}
+function fingerprint(value, maxChars = MAX_EXACT_FINGERPRINT_CHARS) {
+    const serialized = JSON.stringify(canonicalizeBounded(value, { remaining: maxChars, seen: new WeakSet() }));
+    return createHash("sha256").update(serialized.slice(0, maxChars)).digest("hex");
+}
+function contentDescriptor(content) {
+    if (typeof content === "string") {
+        return { kind: "text", length: content.length, fingerprint: fingerprint(content) };
+    }
+    if (!Array.isArray(content))
+        return { kind: typeof content };
+    return content.slice(0, MAX_FINGERPRINT_ITEMS).map((block) => {
+        if (!block || typeof block !== "object")
+            return { kind: typeof block };
+        const candidate = block;
+        const descriptor = { type: candidate.type ?? "unknown" };
+        for (const key of ["id", "name", "toolCallId", "toolName"]) {
+            if (typeof candidate[key] === "string")
+                descriptor[key] = candidate[key];
+        }
+        for (const key of ["text", "thinking", "arguments", "data"]) {
+            const field = candidate[key];
+            if (typeof field === "string") {
+                descriptor[`${key}Length`] = field.length;
+                descriptor[`${key}Fingerprint`] = fingerprint(field);
+            }
+            else if (field !== undefined) {
+                descriptor[`${key}Type`] = typeof field;
+                descriptor[`${key}Fingerprint`] = fingerprint(field);
+            }
+        }
+        return descriptor;
+    });
+}
+function providerHistoryMetadata(messages) {
+    const metadata = [];
+    const firstCount = Math.min(messages.length, Math.floor(MAX_PROVIDER_HISTORY_MESSAGES / 4));
+    const indexes = messages.length <= MAX_PROVIDER_HISTORY_MESSAGES
+        ? Array.from({ length: messages.length }, (_, index) => index)
+        : [
+            ...Array.from({ length: firstCount }, (_, index) => index),
+            ...Array.from({ length: MAX_PROVIDER_HISTORY_MESSAGES - firstCount }, (_, index) => messages.length - (MAX_PROVIDER_HISTORY_MESSAGES - firstCount) + index),
+        ];
+    for (const index of indexes) {
+        const message = messages[index];
+        if (!message || typeof message !== "object") {
+            metadata.push({ type: typeof message });
+            continue;
+        }
+        const candidate = message;
+        const entry = {
+            role: candidate.role,
+            content: contentDescriptor(candidate.content),
+        };
+        for (const key of ["id", "callId", "toolCallId", "toolName", "provider", "model"]) {
+            if (typeof candidate[key] === "string")
+                entry[key] = candidate[key];
+        }
+        metadata.push(entry);
+    }
+    return {
+        messageCount: messages.length,
+        omittedMessageCount: Math.max(0, messages.length - metadata.length),
+        messages: metadata,
+    };
+}
+function messageEntryIds(sessionManager) {
+    const ids = [];
+    let entry = sessionManager.getLeafEntry();
+    let steps = 0;
+    while (entry && ids.length < MAX_MESSAGE_ENTRY_IDS && steps < MAX_LIFECYCLE_ANCESTRY_STEPS) {
+        if (entry.type === "message")
+            ids.push(entry.id);
+        entry = entry.parentId === null ? undefined : sessionManager.getEntry(entry.parentId);
+        steps += 1;
+    }
+    return ids.reverse();
+}
+function latestRequestSnapshot(sessionManager) {
+    let entry = sessionManager.getLeafEntry();
+    let steps = 0;
+    while (entry && steps < MAX_LIFECYCLE_ANCESTRY_STEPS) {
+        if (entry.type === "request_snapshot")
+            return entry;
+        entry = entry.parentId === null ? undefined : sessionManager.getEntry(entry.parentId);
+        steps += 1;
+    }
+    return undefined;
+}
+function modelRef(model) {
+    return { api: model.api, provider: model.provider, modelId: model.id };
+}
+function outcomeForToolResult(result) {
+    return result.isError ? "error" : "success";
+}
+function isAmbiguousInspection(inspection) {
+    return inspection.refusalReasons.length > 0;
+}
+/**
+ * Foreground persistence boundary for provider requests and tool execution.
+ *
+ * Agent-core deliberately owns provider/tool ordering while coding-agent owns the session log. This
+ * controller is the adapter between those lifecycles: request snapshots are written before transport,
+ * cheap routed messages are committed before a prepared tool body starts, and canonical result message
+ * ids are linked to one bounded terminal record. It never persists request content, tool arguments, or
+ * tool results in lifecycle metadata.
+ */
+export class ForegroundLifecycleController {
+    constructor(deps) {
+        this.persistedMessages = new WeakMap();
+        this.startedTools = new Map();
+        this.pendingToolsByCall = new Map();
+        this.completedResultMessages = new WeakSet();
+        this.appendMessage = (message) => {
+            const entryId = this.deps.sessionManager.appendMessage(message);
+            this.notePersistedMessage(message, entryId);
+            return entryId;
+        };
+        this.deps = deps;
+    }
+    /** Install the two agent-core callbacks at the host-owned durability boundary. */
+    install() {
+        this.deps.agent.onProviderRequestSnapshot = (context, signal) => this.onProviderRequestSnapshot(context, signal);
+        this.deps.agent.onToolCallStart = (calls, signal) => this.onToolCallStart(calls, signal);
+    }
+    notePersistedMessage(message, entryId) {
+        this.persistedMessages.set(message, entryId);
+    }
+    /** Drop in-flight associations when the host swaps/reloads the active session branch. */
+    resetForSessionReload() {
+        this.startedTools.clear();
+        this.pendingToolsByCall.clear();
+    }
+    findPersistedMessageEntryId(message) {
+        return this.persistedMessages.get(message);
+    }
+    requestReason(model) {
+        const latest = latestRequestSnapshot(this.deps.sessionManager);
+        if (!latest)
+            return "initial";
+        return latest.api !== model.api || latest.provider !== model.provider || latest.modelId !== model.id
+            ? "change"
+            : "resume";
+    }
+    async onProviderRequestSnapshot(context, signal) {
+        signal?.throwIfAborted();
+        const flushed = this.deps.modelRouter.commitSessionBufferPrefix();
+        for (const [message, entryId] of flushed)
+            this.notePersistedMessage(message, entryId);
+        const model = context.model;
+        const ref = modelRef(model);
+        const requestId = context.requestId;
+        this.deps.sessionManager.appendRequestSnapshot({
+            requestId,
+            reason: this.requestReason(model),
+            api: ref.api,
+            provider: ref.provider,
+            modelId: ref.modelId,
+            effectiveConfigFingerprint: fingerprint({
+                model: ref,
+                reasoning: context.reasoning,
+                maxTokens: context.maxTokens,
+                attempt: context.attempt,
+            }),
+            systemFingerprint: fingerprint(context.context.systemPrompt),
+            toolsFingerprint: fingerprint(context.context.tools ?? []),
+            historyFingerprint: fingerprint(providerHistoryMetadata(context.context.messages)),
+            messageEntryIds: messageEntryIds(this.deps.sessionManager),
+        });
+        signal?.throwIfAborted();
+    }
+    async onToolCallStart(calls, signal) {
+        if (calls.length === 0)
+            return;
+        signal?.throwIfAborted();
+        const requestId = calls[0].requestId;
+        if (calls.some((call) => call.requestId !== requestId)) {
+            throw new Error("Tool reservation wave contains multiple provider request identities");
+        }
+        const flushed = this.deps.modelRouter.commitSessionBuffer();
+        for (const [message, entryId] of flushed)
+            this.notePersistedMessage(message, entryId);
+        const assistantMessage = calls[0].assistantMessage;
+        const assistantMessageEntryId = this.findPersistedMessageEntryId(assistantMessage);
+        if (!assistantMessageEntryId) {
+            throw new Error("Foreground tool reservation rejected: assistant message is not canonically persisted.");
+        }
+        const identities = [];
+        for (const call of calls) {
+            const identity = {
+                requestId,
+                assistantMessageEntryId,
+                callId: call.callId,
+                toolName: call.toolName,
+            };
+            const key = this.toolKey(identity);
+            if (this.startedTools.has(key))
+                throw new Error(`Duplicate foreground tool reservation: ${call.callId}.`);
+            identities.push(identity);
+        }
+        this.deps.sessionManager.appendForegroundToolStarts(identities.map(({ requestId: identityRequestId, assistantMessageEntryId: messageEntryId, callId, toolName }) => ({
+            requestId: identityRequestId,
+            assistantMessageEntryId: messageEntryId,
+            callId,
+            toolName,
+        })));
+        for (const identity of identities)
+            this.startedTools.set(this.toolKey(identity), identity);
+        for (const identity of identities) {
+            const callKey = this.callKey(identity.callId, identity.toolName);
+            const pending = this.pendingToolsByCall.get(callKey) ?? new Set();
+            pending.add(this.toolKey(identity));
+            this.pendingToolsByCall.set(callKey, pending);
+        }
+        signal?.throwIfAborted();
+    }
+    toolKey(identity) {
+        return [identity.requestId, identity.assistantMessageEntryId, identity.callId, identity.toolName].join("\u0000");
+    }
+    callKey(callId, toolName) {
+        return `${callId}\u0000${toolName}`;
+    }
+    /** Called after the canonical message entry has been appended by AgentSession. */
+    onMessagePersisted(message, entryId) {
+        this.notePersistedMessage(message, entryId);
+        if (message.role !== "toolResult")
+            return;
+        if (this.completedResultMessages.has(message))
+            return;
+        const result = message;
+        const pending = this.pendingToolsByCall.get(this.callKey(result.toolCallId, result.toolName));
+        if (!pending || pending.size !== 1)
+            return;
+        const key = pending.values().next().value;
+        const identity = this.startedTools.get(key);
+        if (!identity)
+            return;
+        const metadata = result.isError
+            ? { resultMessageEntryId: entryId, errorKind: result.errorKind ?? "tool_failure" }
+            : { resultMessageEntryId: entryId };
+        this.deps.sessionManager.appendForegroundToolTerminal(identity.requestId, identity.assistantMessageEntryId, identity.callId, identity.toolName, outcomeForToolResult(result), metadata);
+        this.completedResultMessages.add(message);
+        this.startedTools.delete(key);
+        this.pendingToolsByCall.delete(this.callKey(result.toolCallId, result.toolName));
+    }
+    /**
+     * Repair incomplete lifecycle records on construction/reload. The active branch is inspected first;
+     * duplicate, mismatched, or out-of-order records are left untouched and reported rather than guessed.
+     */
+    repair() {
+        const inspection = this.deps.sessionManager.inspectSessionLifecycle();
+        if (isAmbiguousInspection(inspection)) {
+            const warning = boundedWarning("Session lifecycle repair refused: duplicate, mismatched, or out-of-order records require manual review.");
+            this.deps.emitWarning(warning);
+            return [warning];
+        }
+        const plan = this.deps.sessionManager.planSessionLifecycleRepair();
+        const index = this.deps.sessionManager.getSessionLifecycleIndex();
+        const warnings = [];
+        for (const closer of plan.toolClosers) {
+            const call = index.assistantToolCalls.find((candidate) => candidate.assistantMessageEntryId === closer.assistantMessageEntryId &&
+                candidate.callId === closer.callId &&
+                candidate.requestId === closer.requestId);
+            if (!call) {
+                warnings.push(boundedWarning(`Session lifecycle repair skipped tool ${closer.callId}: assistant call is missing.`));
+                continue;
+            }
+            const synthetic = this.appendRepairResult(closer.toolName, closer.callId, closer.code);
+            if (closer.sourceEntryId && closer.requestId !== undefined) {
+                this.deps.sessionManager.appendForegroundToolTerminal(closer.requestId, closer.assistantMessageEntryId, closer.callId, closer.toolName, "error", { resultMessageEntryId: synthetic, errorKind: "tool_failure" });
+            }
+        }
+        for (const promotion of plan.terminalPromotions) {
+            const record = index.toolsByIdentity.get(sessionLifecycleToolIdentityKey(promotion.requestId, promotion.assistantMessageEntryId, promotion.callId));
+            // A canonical immediate result has no foreground start and must remain terminal-free.
+            if (!record?.start)
+                continue;
+            if (promotion.requestId === undefined)
+                continue;
+            this.deps.sessionManager.appendForegroundToolTerminal(promotion.requestId, promotion.assistantMessageEntryId, promotion.callId, promotion.toolName, promotion.outcome, {
+                resultMessageEntryId: promotion.resultMessageEntryId,
+                ...(promotion.errorKind === undefined ? {} : { errorKind: promotion.errorKind }),
+            });
+        }
+        for (const closer of plan.compactionClosers) {
+            this.deps.sessionManager.appendCompactionEnd(closer.compactionId, "interrupted", {
+                error: "Compaction was interrupted before its terminal outcome was recorded.",
+            });
+        }
+        if (plan.toolClosers.length > 0 || plan.terminalPromotions.length > 0 || plan.compactionClosers.length > 0) {
+            this.deps.agent.state.messages = this.deps.sessionManager.buildSessionContext().messages;
+        }
+        for (const warning of warnings)
+            this.deps.emitWarning(warning);
+        return warnings;
+    }
+    appendRepairResult(toolName, callId, code) {
+        const message = {
+            role: "toolResult",
+            toolCallId: callId,
+            toolName,
+            content: [
+                {
+                    type: "text",
+                    text: code === "TOOL_NOT_STARTED"
+                        ? "The harness recorded that this tool call was never started. Treat it as not run and decide whether to retry."
+                        : "The harness recorded that the tool outcome is unknown after interruption. Inspect the workspace before retrying or claiming completion.",
+                },
+            ],
+            isError: true,
+            errorKind: "tool_failure",
+            timestamp: Date.now(),
+        };
+        return this.appendMessage(message);
+    }
+}
+//# sourceMappingURL=foreground-lifecycle-controller.js.map

package/dist/core/foreground-lifecycle-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreground-lifecycle-controller.js","sourceRoot":"","sources":["../../src/core/foreground-lifecycle-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAKpF,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AAC9C,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/C,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAkB1C,SAAS,cAAc,CAAC,OAAe;IACtC,MAAM,UAAU,GAAG,OAAO;SACxB,OAAO,CAAC,wBAAwB,EAAE,GAAG,CAAC;SACtC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACT,OAAO,UAAU,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5G,CAAC;AAOD,SAAS,iBAAiB,CAAC,MAA+B;IACzD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;YAAE,SAAS;QAC1C,IAAI,IAAI,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC;YAC1C,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACP,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;IACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,KAAc,EAAE,MAAyB,EAAE,KAAK,GAAG,CAAC;IAChF,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACvE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,WAAW;QAAE,OAAO,aAAa,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,OAAO,KAAK,GAAG,CAAC;IACzF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,IAAI,qBAAqB;QAAE,OAAO,UAAU,KAAK,GAAG,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC;gBAAE,MAAM;QAClC,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;QACtF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC;QAC9F,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC;YAAE,MAAM;IAClC,CAAC;IACD,IAAI,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC9D,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,QAAQ,GAAG,2BAA2B;IAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5G,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,OAAO,EAAE,CAAC;IAC7D,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,EAAE,CAAC;QACvE,MAAM,SAAS,GAAG,KAAgC,CAAC;QACnD,MAAM,UAAU,GAA4B,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;QAClF,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAU,EAAE,CAAC;YACrE,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,CAAU,EAAE,CAAC;YACtE,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,UAAU,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC1C,UAAU,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;gBACxC,UAAU,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;QACD,OAAO,UAAU,CAAC;IACnB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,QAA4B;IAC5D,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,6BAA6B,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GACZ,QAAQ,CAAC,MAAM,IAAI,6BAA6B;QAC/C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;QAC9D,CAAC,CAAC;YACA,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;YAC1D,GAAG,KAAK,CAAC,IAAI,CACZ,EAAE,MAAM,EAAE,6BAA6B,GAAG,UAAU,EAAE,EACtD,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,6BAA6B,GAAG,UAAU,CAAC,GAAG,KAAK,CACpF;SACD,CAAC;IACL,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,OAAO,EAAE,CAAC,CAAC;YACxC,SAAS;QACV,CAAC;QACD,MAAM,SAAS,GAAG,OAAkC,CAAC;QACrD,MAAM,KAAK,GAA4B;YACtC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC;SAC7C,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAU,EAAE,CAAC;YAC5F,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO;QACN,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACnE,QAAQ,EAAE,QAAQ;KAClB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,cAA8B;IACtD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,IAAI,GAAG,CAAC,MAAM,GAAG,qBAAqB,IAAI,KAAK,GAAG,4BAA4B,EAAE,CAAC;QAC5F,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjD,KAAK,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtF,KAAK,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,qBAAqB,CAAC,cAA8B;IAC5D,IAAI,KAAK,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,IAAI,KAAK,GAAG,4BAA4B,EAAE,CAAC;QACtD,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACpD,KAAK,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtF,KAAK,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB;IAClC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAyB;IACtD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAsC;IACpE,OAAO,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA6B;IAOzC,YAAY,IAAuC;QALlC,sBAAiB,GAAG,IAAI,OAAO,EAAkB,CAAC;QAClD,iBAAY,GAAG,IAAI,GAAG,EAA+B,CAAC;QACtD,uBAAkB,GAAG,IAAI,GAAG,EAAuB,CAAC;QACpD,4BAAuB,GAAG,IAAI,OAAO,EAAU,CAAC;QAgEzD,kBAAa,GAAkB,CAAC,OAAO,EAAE,EAAE;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,OAAO,CAAC;QAChB,CAAC,CAAC;QAjED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,kFAAkF;IAClF,OAAO;QACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1F,CAAC;IAED,oBAAoB,CAAC,OAAqB,EAAE,OAAe;QAC1D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,yFAAyF;IACzF,qBAAqB;QACpB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAEO,2BAA2B,CAAC,OAAqB;QACxD,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEO,aAAa,CAAC,KAAiB;QACtC,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;YACnG,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,yBAAyB,CACtC,OAAuC,EACvC,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,yBAAyB,EAAE,CAAC;QAClE,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAmB,CAAC;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC;YAC9C,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YACjC,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,0BAA0B,EAAE,WAAW,CAAC;gBACvC,KAAK,EAAE,GAAG;gBACV,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;aACxB,CAAC;YACF,iBAAiB,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;YAC5D,gBAAgB,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1D,kBAAkB,EAAE,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClF,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;SAC1D,CAAC,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,CAAC;IAC1B,CAAC;IAQO,KAAK,CAAC,eAAe,CAAC,KAAsC,EAAE,MAAoB;QACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC;QAC5D,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtF,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,gBAAgB,CAAC;QACpD,MAAM,uBAAuB,GAAG,IAAI,CAAC,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;QACnF,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;QAC1G,CAAC;QACD,MAAM,UAAU,GAA0B,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAwB;gBACrC,SAAS;gBACT,uBAAuB;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACvB,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1G,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,0BAA0B,CAClD,UAAU,CAAC,GAAG,CACb,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACjG,SAAS,EAAE,iBAAiB;YAC5B,uBAAuB,EAAE,cAAc;YACvC,MAAM;YACN,QAAQ;SACR,CAAC,CACF,CACD,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,UAAU;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3F,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YACpC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,CAAC;IAC1B,CAAC;IAEO,OAAO,CACd,QAAoG;QAEpG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClH,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,QAAgB;QAC/C,OAAO,GAAG,MAAM,SAAS,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED,kFAAkF;IAClF,kBAAkB,CAAC,OAAqB,EAAE,OAAe;QACxD,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QAC1C,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QACtD,MAAM,MAAM,GAAG,OAA4B,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9F,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO;YAC9B,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,cAAc,EAAE;YAClF,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,4BAA4B,CACpD,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,uBAAuB,EAChC,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,QAAQ,EACjB,oBAAoB,CAAC,MAAM,CAAC,EAC5B,QAAQ,CACR,CAAC;QACF,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClF,CAAC;IAED;;;OAGG;IACH,MAAM;QACL,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,uBAAuB,EAAE,CAAC;QACtE,IAAI,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,cAAc,CAC7B,yGAAyG,CACzG,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,0BAA0B,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,wBAAwB,EAAE,CAAC;QAClE,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,IAAI,CACzC,CAAC,SAAS,EAAE,EAAE,CACb,SAAS,CAAC,uBAAuB,KAAK,MAAM,CAAC,uBAAuB;gBACpE,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBAClC,SAAS,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CACzC,CAAC;YACF,IAAI,CAAC,IAAI,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CACZ,cAAc,CAAC,yCAAyC,MAAM,CAAC,MAAM,8BAA8B,CAAC,CACpG,CAAC;gBACF,SAAS;YACV,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACvF,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,4BAA4B,CACpD,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,uBAAuB,EAC9B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,EACf,OAAO,EACP,EAAE,oBAAoB,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,CAC9D,CAAC;YACH,CAAC;QACF,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,GAAG,CACvC,+BAA+B,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,uBAAuB,EAAE,SAAS,CAAC,MAAM,CAAC,CACzG,CAAC;YACF,sFAAsF;YACtF,IAAI,CAAC,MAAM,EAAE,KAAK;gBAAE,SAAS;YAC7B,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;gBAAE,SAAS;YAChD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,4BAA4B,CACpD,SAAS,CAAC,SAAS,EACnB,SAAS,CAAC,uBAAuB,EACjC,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,QAAQ,EAClB,SAAS,CAAC,OAAO,EACjB;gBACC,oBAAoB,EAAE,SAAS,CAAC,oBAAoB;gBACpD,GAAG,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;aAChF,CACD,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE;gBAChF,KAAK,EAAE,sEAAsE;aAC7E,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5G,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC,QAAQ,CAAC;QAC1F,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,QAAQ,CAAC;IACjB,CAAC;IAEO,kBAAkB,CAAC,QAAgB,EAAE,MAAc,EAAE,IAAY;QACxE,MAAM,OAAO,GAAsB;YAClC,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,MAAM;YAClB,QAAQ;YACR,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EACH,IAAI,KAAK,kBAAkB;wBAC1B,CAAC,CAAC,8GAA8G;wBAChH,CAAC,CAAC,yIAAyI;iBAC7I;aACD;YACD,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,cAAc;YACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC;QACF,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACD","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { Agent, AgentMessage } from \"@caupulican/pi-agent-core\";\nimport type {\n\tRequestSnapshotEntry,\n\tSessionLifecycleInspection,\n\tSessionManager,\n} from \"@caupulican/pi-agent-core/session\";\nimport { sessionLifecycleToolIdentityKey } from \"@caupulican/pi-agent-core/session\";\nimport type { ProviderRequestSnapshotContext, ToolCallStartContext } from \"@caupulican/pi-agent-core/types\";\nimport type { Api, Message, Model, ToolResultMessage } from \"@caupulican/pi-ai\";\nimport type { ModelRouterController } from \"./model-router-controller.ts\";\n\nconst MAX_MESSAGE_ENTRY_IDS = 256;\nconst MAX_WARNING_LENGTH = 500;\nconst MAX_EXACT_FINGERPRINT_CHARS = 32 * 1024;\nconst MAX_FINGERPRINT_DEPTH = 16;\nconst MAX_FINGERPRINT_ITEMS = 256;\nconst MAX_FINGERPRINT_STRING_CHARS = 16 * 1024;\nconst MAX_PROVIDER_HISTORY_MESSAGES = 256;\nconst MAX_LIFECYCLE_ANCESTRY_STEPS = 4096;\n\ntype AppendMessage = (message: Message) => string;\n\ninterface ForegroundLifecycleControllerDeps {\n\tagent: Agent;\n\tsessionManager: SessionManager;\n\tmodelRouter: ModelRouterController;\n\temitWarning(message: string): void;\n}\n\ninterface StartedToolIdentity {\n\trequestId: string;\n\tassistantMessageEntryId: string;\n\tcallId: string;\n\ttoolName: string;\n}\n\nfunction boundedWarning(message: string): string {\n\tconst normalized = message\n\t\t.replace(/[\\u0000-\\u001F\\u007F]/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\treturn normalized.length > MAX_WARNING_LENGTH ? `${normalized.slice(0, MAX_WARNING_LENGTH)}…` : normalized;\n}\n\ninterface FingerprintBudget {\n\tremaining: number;\n\tseen: WeakSet<object>;\n}\n\nfunction boundedObjectKeys(record: Record<string, unknown>): { keys: string[]; truncated: boolean } {\n\tconst keys: string[] = [];\n\tlet truncated = false;\n\tfor (const key in record) {\n\t\tif (!Object.hasOwn(record, key)) continue;\n\t\tif (keys.length >= MAX_FINGERPRINT_ITEMS) {\n\t\t\ttruncated = true;\n\t\t\tbreak;\n\t\t}\n\t\tkeys.push(key);\n\t}\n\tkeys.sort();\n\treturn { keys, truncated };\n}\n\n/**\n * Canonicalize only bounded provider metadata. The system/tool envelope is allowed to retain exact\n * values within the explicit cap; history is represented by descriptors below so a disk-backed or\n * very long context is never copied into a second full object graph just to fingerprint it.\n */\nfunction canonicalizeBounded(value: unknown, budget: FingerprintBudget, depth = 0): unknown {\n\tif (budget.remaining <= 0) return \"[truncated]\";\n\tif (value === null || typeof value === \"boolean\") return value;\n\tif (typeof value === \"string\") {\n\t\tconst limit = Math.min(MAX_FINGERPRINT_STRING_CHARS, budget.remaining);\n\t\tbudget.remaining -= Math.min(value.length, limit);\n\t\treturn value.length <= limit ? value : `${value.slice(0, limit)}…<${value.length}>`;\n\t}\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return value.toString();\n\tif (typeof value === \"undefined\") return \"[undefined]\";\n\tif (typeof value === \"function\" || typeof value === \"symbol\") return `[${typeof value}]`;\n\tif (typeof value !== \"object\") return String(value);\n\tif (depth >= MAX_FINGERPRINT_DEPTH) return `[depth:${depth}]`;\n\tif (budget.seen.has(value)) return \"[circular]\";\n\tbudget.seen.add(value);\n\tif (Array.isArray(value)) {\n\t\tconst result: unknown[] = [];\n\t\tfor (let index = 0; index < Math.min(value.length, MAX_FINGERPRINT_ITEMS); index += 1) {\n\t\t\tresult.push(canonicalizeBounded(value[index], budget, depth + 1));\n\t\t\tif (budget.remaining <= 0) break;\n\t\t}\n\t\tif (value.length > result.length) result.push(`[items:${value.length}]`);\n\t\treturn result;\n\t}\n\tconst record = value as Record<string, unknown>;\n\tconst { keys, truncated } = boundedObjectKeys(record);\n\tconst result: Record<string, unknown> = {};\n\tfor (const key of keys) {\n\t\tconst keyLimit = Math.min(key.length, budget.remaining, MAX_FINGERPRINT_STRING_CHARS);\n\t\tconst boundedKey = key.length <= keyLimit ? key : `${key.slice(0, keyLimit)}…<${key.length}>`;\n\t\tbudget.remaining -= Math.min(key.length, keyLimit);\n\t\tresult[boundedKey] = canonicalizeBounded(record[key], budget, depth + 1);\n\t\tif (budget.remaining <= 0) break;\n\t}\n\tif (truncated) result[\"[keys]\"] = `>${MAX_FINGERPRINT_ITEMS}`;\n\treturn result;\n}\n\nfunction fingerprint(value: unknown, maxChars = MAX_EXACT_FINGERPRINT_CHARS): string {\n\tconst serialized = JSON.stringify(canonicalizeBounded(value, { remaining: maxChars, seen: new WeakSet() }));\n\treturn createHash(\"sha256\").update(serialized.slice(0, maxChars)).digest(\"hex\");\n}\n\nfunction contentDescriptor(content: unknown): unknown {\n\tif (typeof content === \"string\") {\n\t\treturn { kind: \"text\", length: content.length, fingerprint: fingerprint(content) };\n\t}\n\tif (!Array.isArray(content)) return { kind: typeof content };\n\treturn content.slice(0, MAX_FINGERPRINT_ITEMS).map((block) => {\n\t\tif (!block || typeof block !== \"object\") return { kind: typeof block };\n\t\tconst candidate = block as Record<string, unknown>;\n\t\tconst descriptor: Record<string, unknown> = { type: candidate.type ?? \"unknown\" };\n\t\tfor (const key of [\"id\", \"name\", \"toolCallId\", \"toolName\"] as const) {\n\t\t\tif (typeof candidate[key] === \"string\") descriptor[key] = candidate[key];\n\t\t}\n\t\tfor (const key of [\"text\", \"thinking\", \"arguments\", \"data\"] as const) {\n\t\t\tconst field = candidate[key];\n\t\t\tif (typeof field === \"string\") {\n\t\t\t\tdescriptor[`${key}Length`] = field.length;\n\t\t\t\tdescriptor[`${key}Fingerprint`] = fingerprint(field);\n\t\t\t} else if (field !== undefined) {\n\t\t\t\tdescriptor[`${key}Type`] = typeof field;\n\t\t\t\tdescriptor[`${key}Fingerprint`] = fingerprint(field);\n\t\t\t}\n\t\t}\n\t\treturn descriptor;\n\t});\n}\n\nfunction providerHistoryMetadata(messages: readonly unknown[]): unknown {\n\tconst metadata: unknown[] = [];\n\tconst firstCount = Math.min(messages.length, Math.floor(MAX_PROVIDER_HISTORY_MESSAGES / 4));\n\tconst indexes =\n\t\tmessages.length <= MAX_PROVIDER_HISTORY_MESSAGES\n\t\t\t? Array.from({ length: messages.length }, (_, index) => index)\n\t\t\t: [\n\t\t\t\t\t...Array.from({ length: firstCount }, (_, index) => index),\n\t\t\t\t\t...Array.from(\n\t\t\t\t\t\t{ length: MAX_PROVIDER_HISTORY_MESSAGES - firstCount },\n\t\t\t\t\t\t(_, index) => messages.length - (MAX_PROVIDER_HISTORY_MESSAGES - firstCount) + index,\n\t\t\t\t\t),\n\t\t\t\t];\n\tfor (const index of indexes) {\n\t\tconst message = messages[index];\n\t\tif (!message || typeof message !== \"object\") {\n\t\t\tmetadata.push({ type: typeof message });\n\t\t\tcontinue;\n\t\t}\n\t\tconst candidate = message as Record<string, unknown>;\n\t\tconst entry: Record<string, unknown> = {\n\t\t\trole: candidate.role,\n\t\t\tcontent: contentDescriptor(candidate.content),\n\t\t};\n\t\tfor (const key of [\"id\", \"callId\", \"toolCallId\", \"toolName\", \"provider\", \"model\"] as const) {\n\t\t\tif (typeof candidate[key] === \"string\") entry[key] = candidate[key];\n\t\t}\n\t\tmetadata.push(entry);\n\t}\n\treturn {\n\t\tmessageCount: messages.length,\n\t\tomittedMessageCount: Math.max(0, messages.length - metadata.length),\n\t\tmessages: metadata,\n\t};\n}\n\nfunction messageEntryIds(sessionManager: SessionManager): string[] {\n\tconst ids: string[] = [];\n\tlet entry = sessionManager.getLeafEntry();\n\tlet steps = 0;\n\twhile (entry && ids.length < MAX_MESSAGE_ENTRY_IDS && steps < MAX_LIFECYCLE_ANCESTRY_STEPS) {\n\t\tif (entry.type === \"message\") ids.push(entry.id);\n\t\tentry = entry.parentId === null ? undefined : sessionManager.getEntry(entry.parentId);\n\t\tsteps += 1;\n\t}\n\treturn ids.reverse();\n}\n\nfunction latestRequestSnapshot(sessionManager: SessionManager): RequestSnapshotEntry | undefined {\n\tlet entry = sessionManager.getLeafEntry();\n\tlet steps = 0;\n\twhile (entry && steps < MAX_LIFECYCLE_ANCESTRY_STEPS) {\n\t\tif (entry.type === \"request_snapshot\") return entry;\n\t\tentry = entry.parentId === null ? undefined : sessionManager.getEntry(entry.parentId);\n\t\tsteps += 1;\n\t}\n\treturn undefined;\n}\n\nfunction modelRef(model: Model<Api>): { api: string; provider: string; modelId: string } {\n\treturn { api: model.api, provider: model.provider, modelId: model.id };\n}\n\nfunction outcomeForToolResult(result: ToolResultMessage): \"success\" | \"error\" {\n\treturn result.isError ? \"error\" : \"success\";\n}\n\nfunction isAmbiguousInspection(inspection: SessionLifecycleInspection): boolean {\n\treturn inspection.refusalReasons.length > 0;\n}\n\n/**\n * Foreground persistence boundary for provider requests and tool execution.\n *\n * Agent-core deliberately owns provider/tool ordering while coding-agent owns the session log. This\n * controller is the adapter between those lifecycles: request snapshots are written before transport,\n * cheap routed messages are committed before a prepared tool body starts, and canonical result message\n * ids are linked to one bounded terminal record. It never persists request content, tool arguments, or\n * tool results in lifecycle metadata.\n */\nexport class ForegroundLifecycleController {\n\tprivate readonly deps: ForegroundLifecycleControllerDeps;\n\tprivate readonly persistedMessages = new WeakMap<object, string>();\n\tprivate readonly startedTools = new Map<string, StartedToolIdentity>();\n\tprivate readonly pendingToolsByCall = new Map<string, Set<string>>();\n\tprivate readonly completedResultMessages = new WeakSet<object>();\n\n\tconstructor(deps: ForegroundLifecycleControllerDeps) {\n\t\tthis.deps = deps;\n\t}\n\n\t/** Install the two agent-core callbacks at the host-owned durability boundary. */\n\tinstall(): void {\n\t\tthis.deps.agent.onProviderRequestSnapshot = (context, signal) => this.onProviderRequestSnapshot(context, signal);\n\t\tthis.deps.agent.onToolCallStart = (calls, signal) => this.onToolCallStart(calls, signal);\n\t}\n\n\tnotePersistedMessage(message: AgentMessage, entryId: string): void {\n\t\tthis.persistedMessages.set(message, entryId);\n\t}\n\n\t/** Drop in-flight associations when the host swaps/reloads the active session branch. */\n\tresetForSessionReload(): void {\n\t\tthis.startedTools.clear();\n\t\tthis.pendingToolsByCall.clear();\n\t}\n\n\tprivate findPersistedMessageEntryId(message: AgentMessage): string | undefined {\n\t\treturn this.persistedMessages.get(message);\n\t}\n\n\tprivate requestReason(model: Model<Api>): \"initial\" | \"resume\" | \"change\" {\n\t\tconst latest = latestRequestSnapshot(this.deps.sessionManager);\n\t\tif (!latest) return \"initial\";\n\t\treturn latest.api !== model.api || latest.provider !== model.provider || latest.modelId !== model.id\n\t\t\t? \"change\"\n\t\t\t: \"resume\";\n\t}\n\n\tprivate async onProviderRequestSnapshot(\n\t\tcontext: ProviderRequestSnapshotContext,\n\t\tsignal?: AbortSignal,\n\t): Promise<void> {\n\t\tsignal?.throwIfAborted();\n\t\tconst flushed = this.deps.modelRouter.commitSessionBufferPrefix();\n\t\tfor (const [message, entryId] of flushed) this.notePersistedMessage(message, entryId);\n\t\tconst model = context.model as Model<Api>;\n\t\tconst ref = modelRef(model);\n\t\tconst requestId = context.requestId;\n\t\tthis.deps.sessionManager.appendRequestSnapshot({\n\t\t\trequestId,\n\t\t\treason: this.requestReason(model),\n\t\t\tapi: ref.api,\n\t\t\tprovider: ref.provider,\n\t\t\tmodelId: ref.modelId,\n\t\t\teffectiveConfigFingerprint: fingerprint({\n\t\t\t\tmodel: ref,\n\t\t\t\treasoning: context.reasoning,\n\t\t\t\tmaxTokens: context.maxTokens,\n\t\t\t\tattempt: context.attempt,\n\t\t\t}),\n\t\t\tsystemFingerprint: fingerprint(context.context.systemPrompt),\n\t\t\ttoolsFingerprint: fingerprint(context.context.tools ?? []),\n\t\t\thistoryFingerprint: fingerprint(providerHistoryMetadata(context.context.messages)),\n\t\t\tmessageEntryIds: messageEntryIds(this.deps.sessionManager),\n\t\t});\n\t\tsignal?.throwIfAborted();\n\t}\n\n\tprivate appendMessage: AppendMessage = (message) => {\n\t\tconst entryId = this.deps.sessionManager.appendMessage(message);\n\t\tthis.notePersistedMessage(message, entryId);\n\t\treturn entryId;\n\t};\n\n\tprivate async onToolCallStart(calls: readonly ToolCallStartContext[], signal?: AbortSignal): Promise<void> {\n\t\tif (calls.length === 0) return;\n\t\tsignal?.throwIfAborted();\n\t\tconst requestId = calls[0]!.requestId;\n\t\tif (calls.some((call) => call.requestId !== requestId)) {\n\t\t\tthrow new Error(\"Tool reservation wave contains multiple provider request identities\");\n\t\t}\n\n\t\tconst flushed = this.deps.modelRouter.commitSessionBuffer();\n\t\tfor (const [message, entryId] of flushed) this.notePersistedMessage(message, entryId);\n\t\tconst assistantMessage = calls[0]!.assistantMessage;\n\t\tconst assistantMessageEntryId = this.findPersistedMessageEntryId(assistantMessage);\n\t\tif (!assistantMessageEntryId) {\n\t\t\tthrow new Error(\"Foreground tool reservation rejected: assistant message is not canonically persisted.\");\n\t\t}\n\t\tconst identities: StartedToolIdentity[] = [];\n\t\tfor (const call of calls) {\n\t\t\tconst identity: StartedToolIdentity = {\n\t\t\t\trequestId,\n\t\t\t\tassistantMessageEntryId,\n\t\t\t\tcallId: call.callId,\n\t\t\t\ttoolName: call.toolName,\n\t\t\t};\n\t\t\tconst key = this.toolKey(identity);\n\t\t\tif (this.startedTools.has(key)) throw new Error(`Duplicate foreground tool reservation: ${call.callId}.`);\n\t\t\tidentities.push(identity);\n\t\t}\n\t\tthis.deps.sessionManager.appendForegroundToolStarts(\n\t\t\tidentities.map(\n\t\t\t\t({ requestId: identityRequestId, assistantMessageEntryId: messageEntryId, callId, toolName }) => ({\n\t\t\t\t\trequestId: identityRequestId,\n\t\t\t\t\tassistantMessageEntryId: messageEntryId,\n\t\t\t\t\tcallId,\n\t\t\t\t\ttoolName,\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\tfor (const identity of identities) this.startedTools.set(this.toolKey(identity), identity);\n\t\tfor (const identity of identities) {\n\t\t\tconst callKey = this.callKey(identity.callId, identity.toolName);\n\t\t\tconst pending = this.pendingToolsByCall.get(callKey) ?? new Set<string>();\n\t\t\tpending.add(this.toolKey(identity));\n\t\t\tthis.pendingToolsByCall.set(callKey, pending);\n\t\t}\n\t\tsignal?.throwIfAborted();\n\t}\n\n\tprivate toolKey(\n\t\tidentity: Pick<StartedToolIdentity, \"requestId\" | \"assistantMessageEntryId\" | \"callId\" | \"toolName\">,\n\t): string {\n\t\treturn [identity.requestId, identity.assistantMessageEntryId, identity.callId, identity.toolName].join(\"\\u0000\");\n\t}\n\n\tprivate callKey(callId: string, toolName: string): string {\n\t\treturn `${callId}\\u0000${toolName}`;\n\t}\n\n\t/** Called after the canonical message entry has been appended by AgentSession. */\n\tonMessagePersisted(message: AgentMessage, entryId: string): void {\n\t\tthis.notePersistedMessage(message, entryId);\n\t\tif (message.role !== \"toolResult\") return;\n\t\tif (this.completedResultMessages.has(message)) return;\n\t\tconst result = message as ToolResultMessage;\n\t\tconst pending = this.pendingToolsByCall.get(this.callKey(result.toolCallId, result.toolName));\n\t\tif (!pending || pending.size !== 1) return;\n\t\tconst key = pending.values().next().value as string;\n\t\tconst identity = this.startedTools.get(key);\n\t\tif (!identity) return;\n\t\tconst metadata = result.isError\n\t\t\t? { resultMessageEntryId: entryId, errorKind: result.errorKind ?? \"tool_failure\" }\n\t\t\t: { resultMessageEntryId: entryId };\n\t\tthis.deps.sessionManager.appendForegroundToolTerminal(\n\t\t\tidentity.requestId,\n\t\t\tidentity.assistantMessageEntryId,\n\t\t\tidentity.callId,\n\t\t\tidentity.toolName,\n\t\t\toutcomeForToolResult(result),\n\t\t\tmetadata,\n\t\t);\n\t\tthis.completedResultMessages.add(message);\n\t\tthis.startedTools.delete(key);\n\t\tthis.pendingToolsByCall.delete(this.callKey(result.toolCallId, result.toolName));\n\t}\n\n\t/**\n\t * Repair incomplete lifecycle records on construction/reload. The active branch is inspected first;\n\t * duplicate, mismatched, or out-of-order records are left untouched and reported rather than guessed.\n\t */\n\trepair(): string[] {\n\t\tconst inspection = this.deps.sessionManager.inspectSessionLifecycle();\n\t\tif (isAmbiguousInspection(inspection)) {\n\t\t\tconst warning = boundedWarning(\n\t\t\t\t\"Session lifecycle repair refused: duplicate, mismatched, or out-of-order records require manual review.\",\n\t\t\t);\n\t\t\tthis.deps.emitWarning(warning);\n\t\t\treturn [warning];\n\t\t}\n\t\tconst plan = this.deps.sessionManager.planSessionLifecycleRepair();\n\t\tconst index = this.deps.sessionManager.getSessionLifecycleIndex();\n\t\tconst warnings: string[] = [];\n\t\tfor (const closer of plan.toolClosers) {\n\t\t\tconst call = index.assistantToolCalls.find(\n\t\t\t\t(candidate) =>\n\t\t\t\t\tcandidate.assistantMessageEntryId === closer.assistantMessageEntryId &&\n\t\t\t\t\tcandidate.callId === closer.callId &&\n\t\t\t\t\tcandidate.requestId === closer.requestId,\n\t\t\t);\n\t\t\tif (!call) {\n\t\t\t\twarnings.push(\n\t\t\t\t\tboundedWarning(`Session lifecycle repair skipped tool ${closer.callId}: assistant call is missing.`),\n\t\t\t\t);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst synthetic = this.appendRepairResult(closer.toolName, closer.callId, closer.code);\n\t\t\tif (closer.sourceEntryId && closer.requestId !== undefined) {\n\t\t\t\tthis.deps.sessionManager.appendForegroundToolTerminal(\n\t\t\t\t\tcloser.requestId,\n\t\t\t\t\tcloser.assistantMessageEntryId,\n\t\t\t\t\tcloser.callId,\n\t\t\t\t\tcloser.toolName,\n\t\t\t\t\t\"error\",\n\t\t\t\t\t{ resultMessageEntryId: synthetic, errorKind: \"tool_failure\" },\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tfor (const promotion of plan.terminalPromotions) {\n\t\t\tconst record = index.toolsByIdentity.get(\n\t\t\t\tsessionLifecycleToolIdentityKey(promotion.requestId, promotion.assistantMessageEntryId, promotion.callId),\n\t\t\t);\n\t\t\t// A canonical immediate result has no foreground start and must remain terminal-free.\n\t\t\tif (!record?.start) continue;\n\t\t\tif (promotion.requestId === undefined) continue;\n\t\t\tthis.deps.sessionManager.appendForegroundToolTerminal(\n\t\t\t\tpromotion.requestId,\n\t\t\t\tpromotion.assistantMessageEntryId,\n\t\t\t\tpromotion.callId,\n\t\t\t\tpromotion.toolName,\n\t\t\t\tpromotion.outcome,\n\t\t\t\t{\n\t\t\t\t\tresultMessageEntryId: promotion.resultMessageEntryId,\n\t\t\t\t\t...(promotion.errorKind === undefined ? {} : { errorKind: promotion.errorKind }),\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tfor (const closer of plan.compactionClosers) {\n\t\t\tthis.deps.sessionManager.appendCompactionEnd(closer.compactionId, \"interrupted\", {\n\t\t\t\terror: \"Compaction was interrupted before its terminal outcome was recorded.\",\n\t\t\t});\n\t\t}\n\t\tif (plan.toolClosers.length > 0 || plan.terminalPromotions.length > 0 || plan.compactionClosers.length > 0) {\n\t\t\tthis.deps.agent.state.messages = this.deps.sessionManager.buildSessionContext().messages;\n\t\t}\n\t\tfor (const warning of warnings) this.deps.emitWarning(warning);\n\t\treturn warnings;\n\t}\n\n\tprivate appendRepairResult(toolName: string, callId: string, code: string): string {\n\t\tconst message: ToolResultMessage = {\n\t\t\trole: \"toolResult\",\n\t\t\ttoolCallId: callId,\n\t\t\ttoolName,\n\t\t\tcontent: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext:\n\t\t\t\t\t\tcode === \"TOOL_NOT_STARTED\"\n\t\t\t\t\t\t\t? \"The harness recorded that this tool call was never started. Treat it as not run and decide whether to retry.\"\n\t\t\t\t\t\t\t: \"The harness recorded that the tool outcome is unknown after interruption. Inspect the workspace before retrying or claiming completion.\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tisError: true,\n\t\t\terrorKind: \"tool_failure\",\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t\treturn this.appendMessage(message);\n\t}\n}\n"]}

package/dist/core/foreground-recovery-controller.d.ts

@@ -61,6 +61,9 @@ export declare class ForegroundRecoveryController {
     ownsSubmission(lease: ForegroundSubmissionLease | undefined): boolean;
     releaseSubmission(lease: ForegroundSubmissionLease): void;
     runAgentPrompt(messages: AgentMessage | AgentMessage[], submissionLease?: ForegroundSubmissionLease): Promise<void>;
+    /** Continue from the already canonical agent history without replaying the original user message. */
+    runAgentContinuation(submissionLease?: ForegroundSubmissionLease): Promise<void>;
+    private runAgentExecution;
     wakeIdleWaiters(): void;
     waitForIdle(): Promise<void>;
     shutdown(): void;

package/dist/core/foreground-recovery-controller.d.ts.map

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