@caupulican/pi-adaptative 0.86.2 → 0.86.5

package/dist/core/delegation/sanitized-context-fork.js

@@ -0,0 +1,299 @@
+import { MAX_WORKER_CONTEXT_FORK_BYTES, MAX_WORKER_CONTEXT_FORK_MESSAGES, MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS, } from "../orchestration/worker-context-fork-reference.js";
+export const SANITIZED_CONTEXT_FORK_COMPACTION_PREFIX = "The parent conversation history before this point was compacted into the following checkpoint:\n\n<summary>\n";
+export const SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX = "\n</summary>\n\n";
+const WORKER_CONTROL_PREFIX = /^\[Worker control worker-message-[^\]\s]+(?: [^\]]+)?\]\r?\n/;
+const MAX_WORKER_CONTROL_PREFIX_CHARS = 2048;
+function invalidMode() {
+    return new TypeError("Context fork mode must be none, all, or a positive safe-integer string.");
+}
+/** Parse the eventual tool-facing `fork_turns` wire value without choosing a default policy. */
+export function parseSanitizedContextForkMode(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "none")
+        return { kind: "none" };
+    if (normalized === "all")
+        return { kind: "all" };
+    if (!/^\d+$/.test(normalized))
+        throw invalidMode();
+    const count = Number(normalized);
+    if (!Number.isSafeInteger(count) || count <= 0)
+        throw invalidMode();
+    return { kind: "last_user_turns", count };
+}
+function hasCommentaryPhase(textSignature) {
+    if (!textSignature?.startsWith("{"))
+        return false;
+    try {
+        const parsed = JSON.parse(textSignature);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return false;
+        const phase = Object.getOwnPropertyDescriptor(parsed, "phase");
+        return phase !== undefined && "value" in phase && phase.value === "commentary";
+    }
+    catch {
+        return false;
+    }
+}
+function sanitizedTextBlocks(content, dropCommentary) {
+    if (content.length > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS)
+        return { kind: "oversized" };
+    const blocks = [];
+    let textBytes = 0;
+    for (const block of content) {
+        if (block.type !== "text" || !block.text.trim())
+            continue;
+        if (dropCommentary && hasCommentaryPhase(block.textSignature))
+            continue;
+        textBytes += Buffer.byteLength(block.text, "utf-8");
+        if (textBytes > MAX_WORKER_CONTEXT_FORK_BYTES)
+            return { kind: "oversized" };
+        blocks.push({ type: "text", text: block.text });
+    }
+    return { kind: "ok", blocks };
+}
+function isWorkerControlUserMessage(message) {
+    if (typeof message.content === "string") {
+        const newline = message.content.indexOf("\n", 0);
+        const prefixEnd = newline >= 0 ? newline + 1 : MAX_WORKER_CONTROL_PREFIX_CHARS;
+        return WORKER_CONTROL_PREFIX.test(message.content.slice(0, Math.min(prefixEnd, MAX_WORKER_CONTROL_PREFIX_CHARS)));
+    }
+    let prefix = "";
+    for (const block of message.content) {
+        if (block.type !== "text")
+            continue;
+        const remaining = MAX_WORKER_CONTROL_PREFIX_CHARS - prefix.length;
+        if (remaining <= 0)
+            return false;
+        const newline = block.text.indexOf("\n");
+        const blockPrefixEnd = newline >= 0 ? newline + 1 : block.text.length;
+        prefix += block.text.slice(0, Math.min(blockPrefixEnd, remaining));
+        if (newline >= 0)
+            break;
+    }
+    return WORKER_CONTROL_PREFIX.test(prefix);
+}
+function userBoundaryKind(message) {
+    if (isWorkerControlUserMessage(message))
+        return "worker_control";
+    if (typeof message.content === "string") {
+        if (!message.content.trim())
+            return "unsupported";
+        return Buffer.byteLength(message.content, "utf-8") > MAX_WORKER_CONTEXT_FORK_BYTES ? "oversized" : "eligible";
+    }
+    if (message.content.length > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS)
+        return "oversized";
+    let hasText = false;
+    let textBytes = 0;
+    for (const block of message.content) {
+        if (block.type !== "text" || !block.text.trim())
+            continue;
+        hasText = true;
+        textBytes += Buffer.byteLength(block.text, "utf-8");
+        if (textBytes > MAX_WORKER_CONTEXT_FORK_BYTES)
+            return "oversized";
+    }
+    return hasText ? "eligible" : "unsupported";
+}
+function sanitizeUserMessage(message) {
+    const boundary = userBoundaryKind(message);
+    if (boundary === "worker_control" || boundary === "unsupported")
+        return { kind: "drop" };
+    if (boundary === "oversized")
+        return { kind: "oversized" };
+    if (typeof message.content === "string") {
+        return { kind: "ok", message: { role: "user", content: message.content, timestamp: message.timestamp } };
+    }
+    const sanitized = sanitizedTextBlocks(message.content, false);
+    if (sanitized.kind === "oversized")
+        return sanitized;
+    if (sanitized.blocks.length === 0)
+        return { kind: "drop" };
+    return { kind: "ok", message: { role: "user", content: sanitized.blocks, timestamp: message.timestamp } };
+}
+function sanitizeCompactionCheckpoint(message) {
+    if (typeof message.summary !== "string" || !message.summary.trim())
+        return { kind: "invalid" };
+    const wrapperBytes = Buffer.byteLength(SANITIZED_CONTEXT_FORK_COMPACTION_PREFIX + SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX, "utf-8");
+    if (Buffer.byteLength(message.summary, "utf-8") > MAX_WORKER_CONTEXT_FORK_BYTES - wrapperBytes) {
+        return { kind: "invalid" };
+    }
+    return {
+        kind: "valid",
+        text: SANITIZED_CONTEXT_FORK_COMPACTION_PREFIX + message.summary + SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX,
+    };
+}
+function attachCompactionCheckpoint(message, checkpoint) {
+    const checkpointBlock = { type: "text", text: checkpoint.text };
+    return {
+        role: "user",
+        content: typeof message.content === "string"
+            ? [checkpointBlock, { type: "text", text: message.content }]
+            : [checkpointBlock, ...message.content],
+        timestamp: message.timestamp,
+    };
+}
+/**
+ * Resolve each durable compaction replacement onto its following real user turn. The map is capped
+ * at the maximum output size: an older association cannot be selected once that many newer mapped
+ * user messages exist, even when every selected turn contains only its user message.
+ */
+function compactionCheckpointsByUserIndex(messages) {
+    const checkpoints = new Map();
+    let pending;
+    for (let index = 0; index < messages.length; index++) {
+        const message = messages[index];
+        if (message.role === "compactionSummary") {
+            pending = sanitizeCompactionCheckpoint(message);
+            continue;
+        }
+        if (message.role !== "user" || !pending)
+            continue;
+        const boundary = userBoundaryKind(message);
+        if (boundary === "worker_control")
+            continue;
+        if (boundary === "eligible")
+            checkpoints.set(index, pending);
+        pending = undefined;
+        if (checkpoints.size > MAX_WORKER_CONTEXT_FORK_MESSAGES) {
+            const oldest = checkpoints.keys().next().value;
+            if (oldest !== undefined)
+                checkpoints.delete(oldest);
+        }
+    }
+    return checkpoints;
+}
+function sanitizeAssistantMessage(message) {
+    // A length stop, tool request, failure, or abort is not a complete assistant answer.
+    if (message.stopReason !== "stop")
+        return { kind: "drop" };
+    const sanitized = sanitizedTextBlocks(message.content, true);
+    if (sanitized.kind === "oversized")
+        return sanitized;
+    if (sanitized.blocks.length === 0)
+        return { kind: "drop" };
+    return {
+        kind: "ok",
+        message: {
+            role: "assistant",
+            content: sanitized.blocks,
+            api: message.api,
+            provider: message.provider,
+            model: message.model,
+            usage: {
+                input: message.usage.input,
+                output: message.usage.output,
+                cacheRead: message.usage.cacheRead,
+                cacheWrite: message.usage.cacheWrite,
+                totalTokens: message.usage.totalTokens,
+                cost: {
+                    input: message.usage.cost.input,
+                    output: message.usage.cost.output,
+                    cacheRead: message.usage.cost.cacheRead,
+                    cacheWrite: message.usage.cost.cacheWrite,
+                    total: message.usage.cost.total,
+                },
+            },
+            stopReason: "stop",
+            timestamp: message.timestamp,
+        },
+    };
+}
+function serializedBytes(messages) {
+    return Buffer.byteLength(JSON.stringify(messages), "utf-8");
+}
+function textBlockCount(message) {
+    return typeof message.content === "string" ? 1 : message.content.length;
+}
+function requestedTurnCount(mode) {
+    if (mode.kind === "none")
+        return 0;
+    if (mode.kind === "all")
+        return Number.POSITIVE_INFINITY;
+    if (!Number.isSafeInteger(mode.count) || mode.count <= 0) {
+        throw new TypeError("Last-N context fork count must be a positive safe integer.");
+    }
+    return mode.count;
+}
+/**
+ * Select a bounded suffix of complete, sanitized user turns.
+ *
+ * Selection walks backward so an arbitrarily long source transcript never creates an unbounded
+ * second projection. Bounds drop whole oldest turns; no message text is truncated. The result is a
+ * detached chronological copy containing no tool protocol, tool results, reasoning, provider
+ * signatures, custom/system/developer messages, mailbox controls, or incomplete assistant output.
+ */
+export function selectSanitizedContextFork(messages, mode) {
+    const maxTurns = requestedTurnCount(mode);
+    if (maxTurns === 0)
+        return [];
+    const compactionCheckpoints = compactionCheckpointsByUserIndex(messages);
+    let selected = [];
+    let selectedTurns = 0;
+    let selectedTextBlocks = 0;
+    let reversedAssistantSuffix = [];
+    let reversedAssistantTextBlocks = 0;
+    let currentTurnOversized = false;
+    for (let index = messages.length - 1; index >= 0; index--) {
+        const source = messages[index];
+        if (source.role === "assistant") {
+            const sanitized = sanitizeAssistantMessage(source);
+            if (sanitized.kind === "oversized") {
+                currentTurnOversized = true;
+                reversedAssistantSuffix = [];
+                reversedAssistantTextBlocks = 0;
+                continue;
+            }
+            if (sanitized.kind === "drop")
+                continue;
+            if (currentTurnOversized)
+                continue;
+            const candidate = [sanitized.message, ...reversedAssistantSuffix];
+            const candidateTextBlocks = textBlockCount(sanitized.message) + reversedAssistantTextBlocks;
+            if (candidate.length >= MAX_WORKER_CONTEXT_FORK_MESSAGES ||
+                serializedBytes(candidate) >= MAX_WORKER_CONTEXT_FORK_BYTES ||
+                candidateTextBlocks >= MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS) {
+                currentTurnOversized = true;
+                reversedAssistantSuffix = [];
+                reversedAssistantTextBlocks = 0;
+                continue;
+            }
+            reversedAssistantSuffix = candidate;
+            reversedAssistantTextBlocks = candidateTextBlocks;
+            continue;
+        }
+        if (source.role !== "user")
+            continue;
+        const sanitized = sanitizeUserMessage(source);
+        if (sanitized.kind === "drop") {
+            reversedAssistantSuffix = [];
+            reversedAssistantTextBlocks = 0;
+            currentTurnOversized = false;
+            continue;
+        }
+        if (sanitized.kind === "oversized")
+            break;
+        const checkpoint = compactionCheckpoints.get(index);
+        if (checkpoint?.kind === "invalid")
+            break;
+        const userMessage = checkpoint ? attachCompactionCheckpoint(sanitized.message, checkpoint) : sanitized.message;
+        if (currentTurnOversized)
+            break;
+        const turn = [userMessage, ...reversedAssistantSuffix];
+        const turnTextBlocks = textBlockCount(userMessage) + reversedAssistantTextBlocks;
+        const candidate = [...turn, ...selected];
+        if (candidate.length > MAX_WORKER_CONTEXT_FORK_MESSAGES ||
+            serializedBytes(candidate) > MAX_WORKER_CONTEXT_FORK_BYTES ||
+            turnTextBlocks + selectedTextBlocks > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS) {
+            break;
+        }
+        selected = candidate;
+        selectedTurns += 1;
+        selectedTextBlocks += turnTextBlocks;
+        if (selectedTurns >= maxTurns)
+            break;
+        reversedAssistantSuffix = [];
+        reversedAssistantTextBlocks = 0;
+    }
+    return selected;
+}
+//# sourceMappingURL=sanitized-context-fork.js.map

package/dist/core/delegation/sanitized-context-fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitized-context-fork.js","sourceRoot":"","sources":["../../../src/core/delegation/sanitized-context-fork.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@caupulican/pi-agent-core\";\nimport type { AssistantMessage, TextContent, UserMessage } from \"@caupulican/pi-ai\";\nimport {\n\tMAX_WORKER_CONTEXT_FORK_BYTES,\n\tMAX_WORKER_CONTEXT_FORK_MESSAGES,\n\tMAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS,\n} from \"../orchestration/worker-context-fork-reference.ts\";\n\nexport const SANITIZED_CONTEXT_FORK_COMPACTION_PREFIX =\n\t\"The parent conversation history before this point was compacted into the following checkpoint:\\n\\n<summary>\\n\";\nexport const SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX = \"\\n</summary>\\n\\n\";\n\nexport type SanitizedContextForkMode = { kind: \"none\" } | { kind: \"all\" } | { kind: \"last_user_turns\"; count: number };\n\nexport type SanitizedContextForkMessage = UserMessage | AssistantMessage;\n\ntype ContextTextCandidate = AssistantMessage[\"content\"][number] | Exclude<UserMessage[\"content\"], string>[number];\n\ntype SanitizedCompactionCheckpoint = { kind: \"valid\"; text: string } | { kind: \"invalid\" };\ntype SanitizedMessageResult<T> = { kind: \"ok\"; message: T } | { kind: \"drop\" } | { kind: \"oversized\" };\ntype UserBoundaryKind = \"eligible\" | \"worker_control\" | \"unsupported\" | \"oversized\";\n\nconst WORKER_CONTROL_PREFIX = /^\\[Worker control worker-message-[^\\]\\s]+(?: [^\\]]+)?\\]\\r?\\n/;\nconst MAX_WORKER_CONTROL_PREFIX_CHARS = 2048;\n\nfunction invalidMode(): TypeError {\n\treturn new TypeError(\"Context fork mode must be none, all, or a positive safe-integer string.\");\n}\n\n/** Parse the eventual tool-facing `fork_turns` wire value without choosing a default policy. */\nexport function parseSanitizedContextForkMode(value: string): SanitizedContextForkMode {\n\tconst normalized = value.trim().toLowerCase();\n\tif (normalized === \"none\") return { kind: \"none\" };\n\tif (normalized === \"all\") return { kind: \"all\" };\n\tif (!/^\\d+$/.test(normalized)) throw invalidMode();\n\tconst count = Number(normalized);\n\tif (!Number.isSafeInteger(count) || count <= 0) throw invalidMode();\n\treturn { kind: \"last_user_turns\", count };\n}\n\nfunction hasCommentaryPhase(textSignature: string | undefined): boolean {\n\tif (!textSignature?.startsWith(\"{\")) return false;\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(textSignature);\n\t\tif (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return false;\n\t\tconst phase = Object.getOwnPropertyDescriptor(parsed, \"phase\");\n\t\treturn phase !== undefined && \"value\" in phase && phase.value === \"commentary\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction sanitizedTextBlocks(\n\tcontent: readonly ContextTextCandidate[],\n\tdropCommentary: boolean,\n): { kind: \"ok\"; blocks: TextContent[] } | { kind: \"oversized\" } {\n\tif (content.length > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS) return { kind: \"oversized\" };\n\tconst blocks: TextContent[] = [];\n\tlet textBytes = 0;\n\tfor (const block of content) {\n\t\tif (block.type !== \"text\" || !block.text.trim()) continue;\n\t\tif (dropCommentary && hasCommentaryPhase(block.textSignature)) continue;\n\t\ttextBytes += Buffer.byteLength(block.text, \"utf-8\");\n\t\tif (textBytes > MAX_WORKER_CONTEXT_FORK_BYTES) return { kind: \"oversized\" };\n\t\tblocks.push({ type: \"text\", text: block.text });\n\t}\n\treturn { kind: \"ok\", blocks };\n}\n\nfunction isWorkerControlUserMessage(message: UserMessage): boolean {\n\tif (typeof message.content === \"string\") {\n\t\tconst newline = message.content.indexOf(\"\\n\", 0);\n\t\tconst prefixEnd = newline >= 0 ? newline + 1 : MAX_WORKER_CONTROL_PREFIX_CHARS;\n\t\treturn WORKER_CONTROL_PREFIX.test(message.content.slice(0, Math.min(prefixEnd, MAX_WORKER_CONTROL_PREFIX_CHARS)));\n\t}\n\tlet prefix = \"\";\n\tfor (const block of message.content) {\n\t\tif (block.type !== \"text\") continue;\n\t\tconst remaining = MAX_WORKER_CONTROL_PREFIX_CHARS - prefix.length;\n\t\tif (remaining <= 0) return false;\n\t\tconst newline = block.text.indexOf(\"\\n\");\n\t\tconst blockPrefixEnd = newline >= 0 ? newline + 1 : block.text.length;\n\t\tprefix += block.text.slice(0, Math.min(blockPrefixEnd, remaining));\n\t\tif (newline >= 0) break;\n\t}\n\treturn WORKER_CONTROL_PREFIX.test(prefix);\n}\n\nfunction userBoundaryKind(message: UserMessage): UserBoundaryKind {\n\tif (isWorkerControlUserMessage(message)) return \"worker_control\";\n\tif (typeof message.content === \"string\") {\n\t\tif (!message.content.trim()) return \"unsupported\";\n\t\treturn Buffer.byteLength(message.content, \"utf-8\") > MAX_WORKER_CONTEXT_FORK_BYTES ? \"oversized\" : \"eligible\";\n\t}\n\tif (message.content.length > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS) return \"oversized\";\n\tlet hasText = false;\n\tlet textBytes = 0;\n\tfor (const block of message.content) {\n\t\tif (block.type !== \"text\" || !block.text.trim()) continue;\n\t\thasText = true;\n\t\ttextBytes += Buffer.byteLength(block.text, \"utf-8\");\n\t\tif (textBytes > MAX_WORKER_CONTEXT_FORK_BYTES) return \"oversized\";\n\t}\n\treturn hasText ? \"eligible\" : \"unsupported\";\n}\n\nfunction sanitizeUserMessage(message: UserMessage): SanitizedMessageResult<UserMessage> {\n\tconst boundary = userBoundaryKind(message);\n\tif (boundary === \"worker_control\" || boundary === \"unsupported\") return { kind: \"drop\" };\n\tif (boundary === \"oversized\") return { kind: \"oversized\" };\n\tif (typeof message.content === \"string\") {\n\t\treturn { kind: \"ok\", message: { role: \"user\", content: message.content, timestamp: message.timestamp } };\n\t}\n\tconst sanitized = sanitizedTextBlocks(message.content, false);\n\tif (sanitized.kind === \"oversized\") return sanitized;\n\tif (sanitized.blocks.length === 0) return { kind: \"drop\" };\n\treturn { kind: \"ok\", message: { role: \"user\", content: sanitized.blocks, timestamp: message.timestamp } };\n}\n\nfunction sanitizeCompactionCheckpoint(\n\tmessage: Extract<AgentMessage, { role: \"compactionSummary\" }>,\n): SanitizedCompactionCheckpoint {\n\tif (typeof message.summary !== \"string\" || !message.summary.trim()) return { kind: \"invalid\" };\n\tconst wrapperBytes = Buffer.byteLength(\n\t\tSANITIZED_CONTEXT_FORK_COMPACTION_PREFIX + SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX,\n\t\t\"utf-8\",\n\t);\n\tif (Buffer.byteLength(message.summary, \"utf-8\") > MAX_WORKER_CONTEXT_FORK_BYTES - wrapperBytes) {\n\t\treturn { kind: \"invalid\" };\n\t}\n\treturn {\n\t\tkind: \"valid\",\n\t\ttext: SANITIZED_CONTEXT_FORK_COMPACTION_PREFIX + message.summary + SANITIZED_CONTEXT_FORK_COMPACTION_SUFFIX,\n\t};\n}\n\nfunction attachCompactionCheckpoint(\n\tmessage: UserMessage,\n\tcheckpoint: Extract<SanitizedCompactionCheckpoint, { kind: \"valid\" }>,\n): UserMessage {\n\tconst checkpointBlock: TextContent = { type: \"text\", text: checkpoint.text };\n\treturn {\n\t\trole: \"user\",\n\t\tcontent:\n\t\t\ttypeof message.content === \"string\"\n\t\t\t\t? [checkpointBlock, { type: \"text\", text: message.content }]\n\t\t\t\t: [checkpointBlock, ...message.content],\n\t\ttimestamp: message.timestamp,\n\t};\n}\n\n/**\n * Resolve each durable compaction replacement onto its following real user turn. The map is capped\n * at the maximum output size: an older association cannot be selected once that many newer mapped\n * user messages exist, even when every selected turn contains only its user message.\n */\nfunction compactionCheckpointsByUserIndex(\n\tmessages: readonly AgentMessage[],\n): ReadonlyMap<number, SanitizedCompactionCheckpoint> {\n\tconst checkpoints = new Map<number, SanitizedCompactionCheckpoint>();\n\tlet pending: SanitizedCompactionCheckpoint | undefined;\n\tfor (let index = 0; index < messages.length; index++) {\n\t\tconst message = messages[index]!;\n\t\tif (message.role === \"compactionSummary\") {\n\t\t\tpending = sanitizeCompactionCheckpoint(message);\n\t\t\tcontinue;\n\t\t}\n\t\tif (message.role !== \"user\" || !pending) continue;\n\t\tconst boundary = userBoundaryKind(message);\n\t\tif (boundary === \"worker_control\") continue;\n\t\tif (boundary === \"eligible\") checkpoints.set(index, pending);\n\t\tpending = undefined;\n\t\tif (checkpoints.size > MAX_WORKER_CONTEXT_FORK_MESSAGES) {\n\t\t\tconst oldest = checkpoints.keys().next().value;\n\t\t\tif (oldest !== undefined) checkpoints.delete(oldest);\n\t\t}\n\t}\n\treturn checkpoints;\n}\n\nfunction sanitizeAssistantMessage(message: AssistantMessage): SanitizedMessageResult<AssistantMessage> {\n\t// A length stop, tool request, failure, or abort is not a complete assistant answer.\n\tif (message.stopReason !== \"stop\") return { kind: \"drop\" };\n\tconst sanitized = sanitizedTextBlocks(message.content, true);\n\tif (sanitized.kind === \"oversized\") return sanitized;\n\tif (sanitized.blocks.length === 0) return { kind: \"drop\" };\n\treturn {\n\t\tkind: \"ok\",\n\t\tmessage: {\n\t\t\trole: \"assistant\",\n\t\t\tcontent: sanitized.blocks,\n\t\t\tapi: message.api,\n\t\t\tprovider: message.provider,\n\t\t\tmodel: message.model,\n\t\t\tusage: {\n\t\t\t\tinput: message.usage.input,\n\t\t\t\toutput: message.usage.output,\n\t\t\t\tcacheRead: message.usage.cacheRead,\n\t\t\t\tcacheWrite: message.usage.cacheWrite,\n\t\t\t\ttotalTokens: message.usage.totalTokens,\n\t\t\t\tcost: {\n\t\t\t\t\tinput: message.usage.cost.input,\n\t\t\t\t\toutput: message.usage.cost.output,\n\t\t\t\t\tcacheRead: message.usage.cost.cacheRead,\n\t\t\t\t\tcacheWrite: message.usage.cost.cacheWrite,\n\t\t\t\t\ttotal: message.usage.cost.total,\n\t\t\t\t},\n\t\t\t},\n\t\t\tstopReason: \"stop\",\n\t\t\ttimestamp: message.timestamp,\n\t\t},\n\t};\n}\n\nfunction serializedBytes(messages: readonly SanitizedContextForkMessage[]): number {\n\treturn Buffer.byteLength(JSON.stringify(messages), \"utf-8\");\n}\n\nfunction textBlockCount(message: SanitizedContextForkMessage): number {\n\treturn typeof message.content === \"string\" ? 1 : message.content.length;\n}\n\nfunction requestedTurnCount(mode: SanitizedContextForkMode): number {\n\tif (mode.kind === \"none\") return 0;\n\tif (mode.kind === \"all\") return Number.POSITIVE_INFINITY;\n\tif (!Number.isSafeInteger(mode.count) || mode.count <= 0) {\n\t\tthrow new TypeError(\"Last-N context fork count must be a positive safe integer.\");\n\t}\n\treturn mode.count;\n}\n\n/**\n * Select a bounded suffix of complete, sanitized user turns.\n *\n * Selection walks backward so an arbitrarily long source transcript never creates an unbounded\n * second projection. Bounds drop whole oldest turns; no message text is truncated. The result is a\n * detached chronological copy containing no tool protocol, tool results, reasoning, provider\n * signatures, custom/system/developer messages, mailbox controls, or incomplete assistant output.\n */\nexport function selectSanitizedContextFork(\n\tmessages: readonly AgentMessage[],\n\tmode: SanitizedContextForkMode,\n): SanitizedContextForkMessage[] {\n\tconst maxTurns = requestedTurnCount(mode);\n\tif (maxTurns === 0) return [];\n\tconst compactionCheckpoints = compactionCheckpointsByUserIndex(messages);\n\n\tlet selected: SanitizedContextForkMessage[] = [];\n\tlet selectedTurns = 0;\n\tlet selectedTextBlocks = 0;\n\tlet reversedAssistantSuffix: AssistantMessage[] = [];\n\tlet reversedAssistantTextBlocks = 0;\n\tlet currentTurnOversized = false;\n\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst source = messages[index]!;\n\t\tif (source.role === \"assistant\") {\n\t\t\tconst sanitized = sanitizeAssistantMessage(source);\n\t\t\tif (sanitized.kind === \"oversized\") {\n\t\t\t\tcurrentTurnOversized = true;\n\t\t\t\treversedAssistantSuffix = [];\n\t\t\t\treversedAssistantTextBlocks = 0;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (sanitized.kind === \"drop\") continue;\n\t\t\tif (currentTurnOversized) continue;\n\t\t\tconst candidate = [sanitized.message, ...reversedAssistantSuffix];\n\t\t\tconst candidateTextBlocks = textBlockCount(sanitized.message) + reversedAssistantTextBlocks;\n\t\t\tif (\n\t\t\t\tcandidate.length >= MAX_WORKER_CONTEXT_FORK_MESSAGES ||\n\t\t\t\tserializedBytes(candidate) >= MAX_WORKER_CONTEXT_FORK_BYTES ||\n\t\t\t\tcandidateTextBlocks >= MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS\n\t\t\t) {\n\t\t\t\tcurrentTurnOversized = true;\n\t\t\t\treversedAssistantSuffix = [];\n\t\t\t\treversedAssistantTextBlocks = 0;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\treversedAssistantSuffix = candidate;\n\t\t\treversedAssistantTextBlocks = candidateTextBlocks;\n\t\t\tcontinue;\n\t\t}\n\t\tif (source.role !== \"user\") continue;\n\t\tconst sanitized = sanitizeUserMessage(source);\n\t\tif (sanitized.kind === \"drop\") {\n\t\t\treversedAssistantSuffix = [];\n\t\t\treversedAssistantTextBlocks = 0;\n\t\t\tcurrentTurnOversized = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (sanitized.kind === \"oversized\") break;\n\n\t\tconst checkpoint = compactionCheckpoints.get(index);\n\t\tif (checkpoint?.kind === \"invalid\") break;\n\t\tconst userMessage = checkpoint ? attachCompactionCheckpoint(sanitized.message, checkpoint) : sanitized.message;\n\t\tif (currentTurnOversized) break;\n\t\tconst turn: SanitizedContextForkMessage[] = [userMessage, ...reversedAssistantSuffix];\n\t\tconst turnTextBlocks = textBlockCount(userMessage) + reversedAssistantTextBlocks;\n\t\tconst candidate = [...turn, ...selected];\n\t\tif (\n\t\t\tcandidate.length > MAX_WORKER_CONTEXT_FORK_MESSAGES ||\n\t\t\tserializedBytes(candidate) > MAX_WORKER_CONTEXT_FORK_BYTES ||\n\t\t\tturnTextBlocks + selectedTextBlocks > MAX_WORKER_CONTEXT_FORK_TEXT_BLOCKS\n\t\t) {\n\t\t\tbreak;\n\t\t}\n\t\tselected = candidate;\n\t\tselectedTurns += 1;\n\t\tselectedTextBlocks += turnTextBlocks;\n\t\tif (selectedTurns >= maxTurns) break;\n\t\treversedAssistantSuffix = [];\n\t\treversedAssistantTextBlocks = 0;\n\t}\n\n\treturn selected;\n}\n"]}

package/dist/core/delegation/session-root-mailbox.d.ts

@@ -0,0 +1,75 @@
+export interface SessionRootReply {
+    messageId: string;
+    sourceAgentId: string;
+    requestMessageId: string;
+    threadId?: string;
+    content: string;
+    createdAt: string;
+    ackToken: string;
+    sourceReconciledAt?: string;
+    acknowledgedAt?: string;
+}
+export type SessionRootReplyAcceptance = {
+    status: "retained";
+    messageId: string;
+    reply: SessionRootReply;
+    created: boolean;
+} | {
+    status: "completed_replay";
+    messageId: string;
+    created: false;
+};
+export interface SessionRootMailboxOptions {
+    agentDir: string;
+    parentSessionId: string;
+}
+export interface SessionRootReplyInput {
+    sourceAgentId: string;
+    requestMessageId: string;
+    threadId?: string;
+    content: string;
+}
+export interface SessionRootReplyQuery {
+    sourceAgentId?: string;
+    requestMessageId?: string;
+    maxMessages?: number;
+}
+export interface SessionRootReplyWaitOptions extends SessionRootReplyQuery {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface SessionRootReplyWaitResult {
+    replies: SessionRootReply[];
+    timedOut: boolean;
+}
+/** Opaque host-owned sender address for root-originated reply-expected worker messages. */
+export declare function sessionRootAddress(parentSessionId: string): string;
+export declare function sessionRootReplyMessageId(parentSessionId: string, sourceAgentId: string, requestMessageId: string): string;
+/** Bounded durable inbox for accepted worker replies addressed to one foreground session root. */
+export declare class SessionRootMailbox {
+    private readonly parentSessionId;
+    private readonly file;
+    constructor(options: SessionRootMailboxOptions);
+    /** Validate and size one canonical reply without mutating durable inbox state. */
+    assertReplyInput(input: SessionRootReplyInput): void;
+    enqueueReply(input: SessionRootReplyInput): SessionRootReplyAcceptance;
+    /** Enqueue a reply whose permanent replay authority is the source worker's durable receipt. */
+    enqueueSourceOwnedReply(input: SessionRootReplyInput): SessionRootReplyAcceptance;
+    private enqueueReplyWithAuthority;
+    pendingReplies(query?: SessionRootReplyQuery): SessionRootReply[];
+    retainedReplies(): SessionRootReply[];
+    getReply(messageId: string): SessionRootReply | undefined;
+    markSourceReconciled(messageId: string): boolean;
+    releaseSourceReplayReceipt(messageId: string): boolean;
+    acknowledge(messageId: string, ackToken: string): boolean;
+    waitForReplies(options?: SessionRootReplyWaitOptions): Promise<SessionRootReplyWaitResult>;
+    /**
+     * Subscribes to process-local mutations for every mailbox instance backed by this file.
+     * Callers must unsubscribe; durable cross-process delivery remains the control owner's responsibility.
+     */
+    subscribe(listener: () => void): () => void;
+    private notify;
+    private read;
+    private update;
+}
+//# sourceMappingURL=session-root-mailbox.d.ts.map

package/dist/core/delegation/session-root-mailbox.d.ts.map

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