@bastani/atomic 0.8.31-alpha.5 → 0.9.0-alpha.1

package/dist/core/compaction/context-compaction.js

@@ -1,1944 +1,8 @@
-import { Agent } from "@earendil-works/pi-agent-core";
-import { createAssistantMessageEventStream, isContextOverflow, streamSimple, StringEnum } from "@earendil-works/pi-ai";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { Type } from "typebox";
-import { formatCopilotProviderError } from "../copilot-errors.js";
-import { createBranchSummaryMessage, createCustomMessage } from "../messages.js";
-import { isAssistantThinkingBlockType, messageHasAssistantThinkingContentBlock, } from "../thinking-blocks.js";
-import { buildContextDeletionFilteredPath, buildEffectiveContextDeletionFilters, } from "../session-manager.js";
-import { estimateTokens } from "./compaction.js";
-export const CONTEXT_COMPACTION_PROMPT_VERSION = 1;
-const CONTEXT_DELETE_TOOL_NAME = "context_delete";
-const CONTEXT_GREP_DELETE_TOOL_NAME = "context_grep_delete";
-const CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME = "context_search_transcript";
-const CONTEXT_READ_ENTRY_TOOL_NAME = "context_read_entry";
-const CONTEXT_COMPACTION_BUDGET_TOOL_NAME = "context_compaction_budget";
-export const CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO = 0.5;
-export const CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT = 50;
-export const CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT = 2;
-export const CONTEXT_COMPACTION_AUTO_QUERY = "auto-detected";
-const CONTEXT_GREP_DELETE_DEFAULT_MAX_MATCHES = 50;
-const CONTEXT_GREP_DELETE_MAX_REGEX_PATTERN_CHARS = 512;
-const CONTEXT_GREP_DELETE_MAX_REGEX_SCAN_CHARS = 250_000;
-const CONTEXT_MANIFEST_MAX_ENTRIES = 80;
-const CONTEXT_MANIFEST_PREVIEW_CHARS = 240;
-const CONTEXT_READ_ENTRY_DEFAULT_MAX_CHARS = 4000;
-const CONTEXT_READ_ENTRY_MAX_CHARS = 12_000;
-const CONTEXT_SEARCH_DEFAULT_MAX_MATCHES = 20;
-const CONTEXT_SEARCH_MAX_MATCHES = 100;
-const CONTEXT_SEARCH_DEFAULT_CONTEXT_CHARS = 160;
-const CONTEXT_SEARCH_MAX_CONTEXT_CHARS = 500;
-const ContextDeleteToolParameters = Type.Object({
-    deletions: Type.Array(Type.Object({
-        kind: StringEnum(["entry", "content_block"], {
-            description: "Delete an entire transcript entry or a single content block within one entry.",
-        }),
-        entryId: Type.String({ minLength: 1, description: "Stable transcript entry id to delete from." }),
-        blockIndex: Type.Optional(Type.Integer({
-            minimum: 0,
-            description: "Required when kind is content_block; omit when kind is entry.",
-        })),
-    }, { additionalProperties: false }), {
-        description: "ID-only deletion targets. Include only kind, entryId, and blockIndex when needed; do not include transcript text, block contents, summaries, or replacement content. Invalid targets are rejected by the tool with correction guidance.",
-    }),
-}, { additionalProperties: false });
-const ContextGrepDeleteToolParameters = Type.Object({
-    pattern: Type.String({ minLength: 1, description: "Literal text or regular expression to match in transcript text." }),
-    regex: Type.Optional(Type.Boolean({ description: "Treat pattern as a JavaScript regular expression. Defaults to false." })),
-    caseSensitive: Type.Optional(Type.Boolean({ description: "Use case-sensitive matching. Defaults to false." })),
-    target: Type.Optional(StringEnum(["entry", "content_block"], {
-        description: "Delete whole matching entries or matching content blocks. Defaults to entry.",
-    })),
-    maxMatches: Type.Optional(Type.Integer({
-        minimum: 1,
-        maximum: 200,
-        description: "Per-call safety cap. If more not-yet-deleted candidate targets are found in this tool call, no deletions are applied. Defaults to 50. This is not a cumulative compaction cap; call the tool again for additional batches.",
-    })),
-    expectedMatchCount: Type.Optional(Type.Integer({
-        minimum: 0,
-        description: "Optional safety check. If the match count differs, no deletions are applied.",
-    })),
-}, { additionalProperties: false });
-const ContextSearchTranscriptToolParameters = Type.Object({
-    pattern: Type.String({ minLength: 1, description: "Literal text or regular expression to search for." }),
-    regex: Type.Optional(Type.Boolean({ description: "Treat pattern as a JavaScript regular expression. Defaults to false." })),
-    caseSensitive: Type.Optional(Type.Boolean({ description: "Use case-sensitive matching. Defaults to false." })),
-    target: Type.Optional(StringEnum(["entry", "content_block"], {
-        description: "Search whole entry text or individual content-block text. Defaults to entry.",
-    })),
-    maxMatches: Type.Optional(Type.Integer({ minimum: 1, maximum: CONTEXT_SEARCH_MAX_MATCHES, description: "Maximum matches to return. Defaults to 20." })),
-    contextChars: Type.Optional(Type.Integer({
-        minimum: 0,
-        maximum: CONTEXT_SEARCH_MAX_CONTEXT_CHARS,
-        description: "Characters of context to include before and after each match. Defaults to 160.",
-    })),
-}, { additionalProperties: false });
-const ContextReadEntryToolParameters = Type.Object({
-    entryId: Type.String({ minLength: 1, description: "Stable transcript entry id to read." }),
-    blockIndex: Type.Optional(Type.Integer({ minimum: 0, description: "Optional content block index to read instead of the whole entry text." })),
-    offset: Type.Optional(Type.Integer({ minimum: 0, description: "Character offset to begin reading. Defaults to 0." })),
-    maxChars: Type.Optional(Type.Integer({
-        minimum: 1,
-        maximum: CONTEXT_READ_ENTRY_MAX_CHARS,
-        description: "Maximum characters to return. Defaults to 4000; keep reads small to avoid overflowing context.",
-    })),
-}, { additionalProperties: false });
-const ContextCompactionBudgetToolParameters = Type.Object({}, { additionalProperties: false });
-const CONTEXT_DELETE_TOOL = {
-    name: CONTEXT_DELETE_TOOL_NAME,
-    description: "Record context compaction deletion targets directly against the transcript.",
-    parameters: ContextDeleteToolParameters,
-};
-const CONTEXT_GREP_DELETE_TOOL = {
-    name: CONTEXT_GREP_DELETE_TOOL_NAME,
-    description: "Bulk-delete transcript entries or content blocks matching a guarded grep/regex query.",
-    parameters: ContextGrepDeleteToolParameters,
-};
-const CONTEXT_SEARCH_TRANSCRIPT_TOOL = {
-    name: CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME,
-    description: "Search the full transcript working copy and return small snippets without mutating deletion state.",
-    parameters: ContextSearchTranscriptToolParameters,
-};
-const CONTEXT_READ_ENTRY_TOOL = {
-    name: CONTEXT_READ_ENTRY_TOOL_NAME,
-    description: "Read a small slice of one transcript entry or content block from the full transcript working copy.",
-    parameters: ContextReadEntryToolParameters,
-};
-const CONTEXT_COMPACTION_BUDGET_TOOL = {
-    name: CONTEXT_COMPACTION_BUDGET_TOOL_NAME,
-    description: "Report current context-window fullness and reduction progress for the selected deletion targets without mutating deletion state.",
-    parameters: ContextCompactionBudgetToolParameters,
-};
-const CONTEXT_COMPACTION_SYSTEM_PROMPT = `You are a context compaction assistant.
-
-Your task is to read relevant parts of a conversation between a user and an AI assistant provided via a transcript file, then run a series of tools to apply deletion-only verbatim compaction using the exact context_delete or context_grep_delete format specified.`;
-function contextCompactionFixedPrompt(parameters) {
-    const targetLabel = contextCompactionTargetLabel(parameters);
-    return `Reference the provided transcript file transcript and use your search/read tools for small inspections, then use context_delete or context_grep_delete for deletions.
-
-Compaction records deletion targets, not replacement content.
-For context_delete, use id-only targets: stable entryId values and optional blockIndex values only.
-For context_grep_delete, use a concise literal or regex pattern to select matching entries or blocks; do not paste full transcript entries or content-block bodies.
-Do not summarize, paraphrase, or generate replacement context; those are not accepted compaction outputs.
-Do not mutate retained transcript objects or content.
-Deletion tool calls are the compaction action.
-
-Strategy:
-- Start by calling context_compaction_budget to see how much of the context window is full and how much reduction is needed.
-- Spend a few turns exploring with search/read tools to gain high confidence of candidate blocks to remove.
-- Prefer high-confidence exploit actions after that: delete obvious low-value entries via context_grep_delete or context_delete.
-- Use grep deletion for repeated low-value patterns.
-- Use exact id deletion for inspected one-off stale entries.
-- Check context_compaction_budget after deletion batches to track progress.
-- Strict requirement: reduce current context by at least ${targetLabel} before finishing. This is a hard completion gate, not a loose goal.
-- Do not send a final plain-text completion message until context_compaction_budget reports at least ${targetLabel} currentReductionPercent.
-- If the strict ${targetLabel} reduction is not met yet, continue removing low-value message entries or content blocks with context_delete/context_grep_delete.
-- Use the focus query to preserve relevant context: ${JSON.stringify(parameters.query)}.
-
-What Gets Deleted:
-- Redundant tool outputs: file reads already acted on, grep/search results already processed, passing test output no longer needed.
-- Exploratory dead ends: irrelevant files read, unhelpful or empty searches.
-- Verbose boilerplate: license headers, import blocks the agent isn't modifying, configuration files read for reference.
-- Superseded information: earlier versions of files that have since been edited, old error messages from bugs already fixed.
-
-What Survives:
-- Active file paths and line numbers: Any reference the agent might need to navigate.
-- Current error messages: Unresolved bugs and their exact text.
-- Reasoning decisions: Why the agent chose approach A over B. An agent's chain of thought (why it chose this file, what pattern it noticed, what fix it decided on) carries more information-per-token than the raw grep output or file content that informed those decisions.
-- Recent tool calls and their results: The last 3-5 operations.
-- User instructions: The original task and any clarifications.
-
-Conditionally Deleted:
-- Old Reasoning decisions: If there is nothing else to remove and the target reduction is not met, you can remove entire stale assistant entries, EXCEPT do not delete individual content blocks from any retained assistant message that contains thinking or redacted_thinking blocks. Thinking-bearing assistant messages are all-or-nothing for replay safety.
-
-<output_format>
-Call the context_delete tool one or more times with deletion targets in this shape:
-{ "deletions": [{ "kind": "entry", "entryId": "..." }] }
-
-For content-block deletions, use:
-{ "kind": "content_block", "entryId": "...", "blockIndex": 0 }
-
-The tool applies and validates deletion targets immediately. You can continue calling it for additional deletions if useful.
-
-For guarded bulk deletion by text match, call context_grep_delete with a literal pattern or regex. It removes valid matching context, silently ignores candidates that validation does not allow so they are not counted as removals, enforces a per-call maxMatches safety cap and optional expectedMatchCount, and validates through the same tool-call/tool-result safety rules. maxMatches only limits one tool call; there is no cumulative cap across corrected or repeated deletion calls.
-
-The full transcript is available as a JSONL file path in the prompt, but do NOT try to load the whole file into context. Use context_search_transcript to find candidate entry IDs and context_read_entry to read only small slices (for example maxChars 1000-4000) before deleting.
-
-When the strict ${targetLabel} reduction requirement is met, reply with a brief plain-text completion message. Do not include deletion target IDs outside tool calls.
-</output_format>`;
-}
-function getMessageFromEntry(entry) {
-    if (entry.type === "message") {
-        return entry.message;
-    }
-    if (entry.type === "custom_message") {
-        return createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp, entry.excludeFromContext);
-    }
-    if (entry.type === "branch_summary") {
-        return createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp);
-    }
-    return undefined;
-}
-function isExcludedFromLlmContext(message) {
-    switch (message.role) {
-        case "bashExecution":
-            return Boolean(message.excludeFromContext);
-        case "custom":
-            return message.excludeFromContext === true;
-        default:
-            return false;
-    }
-}
-function getContextEligibleMessageFromEntry(entry) {
-    const message = getMessageFromEntry(entry);
-    if (!message || isExcludedFromLlmContext(message))
-        return undefined;
-    return message;
-}
-function textFromUnknownContent(content) {
-    if (typeof content === "string")
-        return content;
-    if (!Array.isArray(content))
-        return JSON.stringify(content);
-    return content.map((block) => textFromContentBlock(block)).join("\n");
-}
-function textFromContentBlock(block) {
-    if (!block || typeof block !== "object")
-        return String(block);
-    const record = block;
-    if (record.type === "text" && typeof record.text === "string")
-        return record.text;
-    if (record.type === "thinking" && typeof record.thinking === "string")
-        return record.thinking;
-    if (record.type === "toolCall") {
-        const name = typeof record.name === "string" ? record.name : "tool";
-        const id = typeof record.id === "string" ? record.id : "unknown";
-        const args = "arguments" in record ? JSON.stringify(record.arguments) : "";
-        return `toolCall ${id} ${name} ${args}`.trim();
-    }
-    if (record.type === "image")
-        return "[image]";
-    return JSON.stringify(record);
-}
-function assistantEntryHasThinkingContentBlock(entry) {
-    return (entry.role === "assistant" &&
-        (entry.contentBlocks.some((block) => isAssistantThinkingBlockType(block.type)) ||
-            messageHasAssistantThinkingContentBlock(entry.message)));
-}
-const IMAGE_BLOCK_CHAR_ESTIMATE = 4800;
-const IMAGE_BLOCK_TOKEN_ESTIMATE = Math.ceil(IMAGE_BLOCK_CHAR_ESTIMATE / 4);
-function estimateTextTokens(text) {
-    return Math.max(1, Math.ceil(text.length / 4));
-}
-function estimateContentBlockTokens(block, text) {
-    if (block && typeof block === "object" && block.type === "image") {
-        return IMAGE_BLOCK_TOKEN_ESTIMATE;
-    }
-    return estimateTextTokens(text);
-}
-function getToolCallIdFromBlock(block) {
-    if (!block || typeof block !== "object")
-        return undefined;
-    const record = block;
-    if (record.type !== "toolCall")
-        return undefined;
-    return typeof record.id === "string" ? record.id : undefined;
-}
-function getToolResultCallId(message) {
-    if (message.role !== "toolResult")
-        return undefined;
-    const callId = message.toolCallId;
-    return typeof callId === "string" ? callId : undefined;
-}
-function contentBlocksForEntry(entryId, message, protectedEntry, existingDeletedBlocks) {
-    const content = message.content;
-    if (!Array.isArray(content))
-        return [];
-    return content
-        .map((block, blockIndex) => {
-        if (existingDeletedBlocks?.has(blockIndex)) {
-            return undefined;
-        }
-        const type = block && typeof block === "object" && typeof block.type === "string"
-            ? (block.type)
-            : "unknown";
-        const text = textFromContentBlock(block);
-        return {
-            entryId,
-            blockIndex,
-            type,
-            text,
-            tokenEstimate: estimateContentBlockTokens(block, text),
-            protected: protectedEntry,
-            toolCallId: getToolCallIdFromBlock(block),
-        };
-    })
-        .filter((block) => block !== undefined);
-}
-function messageText(message) {
-    switch (message.role) {
-        case "bashExecution":
-            return `Ran ${message.command}\n${message.output}`;
-        case "branchSummary":
-            return message.summary;
-        case "custom":
-        case "toolResult":
-        case "user":
-            return textFromUnknownContent(message.content);
-        case "assistant":
-            return textFromUnknownContent(message.content);
-        case "compactionSummary":
-            // Legacy summary-compaction message type retained in the upstream AgentMessage union
-            // after summary compaction was removed; surface its archival summary text.
-            return message.summary;
-        default: {
-            // Exhaustiveness guard: adding a new AgentMessage role must fail the build here instead
-            // of silently degrading to an empty string.
-            const _exhaustiveCheck = message;
-            void _exhaustiveCheck;
-            return "";
-        }
-    }
-}
-function hasAssistantError(message) {
-    return message.role === "assistant" && message.stopReason === "error";
-}
-function hasToolResultError(message) {
-    return message.role === "toolResult" && message.isError === true;
-}
-function hasFailedBashExecution(message) {
-    return message.role === "bashExecution" && typeof message.exitCode === "number" && message.exitCode !== 0;
-}
-const CONTEXT_COMPACTION_QUERY_MAX_CHARS = 1000;
-function normalizeCompressionRatio(value) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0 && value < 1
-        ? value
-        : CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO;
-}
-function normalizePreserveRecent(value) {
-    return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT;
-}
-function normalizeQuery(value, fallbackQuery) {
-    const query = value?.trim() || fallbackQuery.trim() || CONTEXT_COMPACTION_AUTO_QUERY;
-    return query.length > CONTEXT_COMPACTION_QUERY_MAX_CHARS
-        ? `${query.slice(0, CONTEXT_COMPACTION_QUERY_MAX_CHARS)}\n[... ${query.length - CONTEXT_COMPACTION_QUERY_MAX_CHARS} more characters omitted from compaction query]`
-        : query;
-}
-export function autoDetectContextCompactionQuery(pathEntries) {
-    for (let index = pathEntries.length - 1; index >= 0; index--) {
-        const entry = pathEntries[index];
-        if (entry.type === "context_compaction")
-            continue;
-        const message = getContextEligibleMessageFromEntry(entry);
-        if (!message || message.role !== "user")
-            continue;
-        const text = messageText(message).trim();
-        if (text.length > 0)
-            return normalizeQuery(text, CONTEXT_COMPACTION_AUTO_QUERY);
-    }
-    return CONTEXT_COMPACTION_AUTO_QUERY;
-}
-export function normalizeContextCompactionParameters(input = {}, fallbackQuery = CONTEXT_COMPACTION_AUTO_QUERY) {
-    return {
-        compression_ratio: normalizeCompressionRatio(input.compression_ratio),
-        preserve_recent: normalizePreserveRecent(input.preserve_recent),
-        query: normalizeQuery(input.query, fallbackQuery),
-    };
-}
-function getTranscriptCompactionParameters(transcript) {
-    return normalizeContextCompactionParameters(transcript.parameters ?? transcript.settings, transcript.parameters?.query ?? transcript.settings.query ?? CONTEXT_COMPACTION_AUTO_QUERY);
-}
-function contextCompactionTargetReductionPercent(parameters) {
-    return roundPercent((1 - parameters.compression_ratio) * 100);
-}
-function contextCompactionTargetLabel(parameters) {
-    return `${contextCompactionTargetReductionPercent(parameters)}%`;
-}
-function isProtectedEntry(entry, message, recentEntryIds) {
-    if (recentEntryIds.has(entry.id))
-        return true;
-    if (message.role === "user")
-        return true;
-    if (message.role === "custom")
-        return true;
-    if (message.role === "branchSummary")
-        return true;
-    if (hasAssistantError(message) || hasToolResultError(message))
-        return true;
-    if (hasFailedBashExecution(message))
-        return true;
-    if (entry.type === "branch_summary")
-        return true;
-    return false;
-}
-export function prepareContextCompaction(pathEntries, settings, options = {}) {
-    if (pathEntries.length === 0)
-        return undefined;
-    const effectiveDeletionFilters = buildEffectiveContextDeletionFilters(pathEntries);
-    const filteredPathEntries = buildContextDeletionFilteredPath(pathEntries, effectiveDeletionFilters);
-    const parameters = normalizeContextCompactionParameters({ ...settings, ...options }, autoDetectContextCompactionQuery(filteredPathEntries));
-    const rawEntryById = new Map(pathEntries.map((entry) => [entry.id, entry]));
-    const messageEntryIds = filteredPathEntries
-        .filter((entry) => entry.type !== "context_compaction" && getContextEligibleMessageFromEntry(entry) !== undefined)
-        .map((entry) => entry.id);
-    const recentEntryIds = new Set(parameters.preserve_recent > 0 ? messageEntryIds.slice(-parameters.preserve_recent) : []);
-    const protectedEntryIds = new Set();
-    const entries = [];
-    for (const entry of filteredPathEntries) {
-        if (entry.type === "context_compaction")
-            continue;
-        const message = getContextEligibleMessageFromEntry(entry);
-        if (!message)
-            continue;
-        const rawEntry = rawEntryById.get(entry.id) ?? entry;
-        const protectedEntry = isProtectedEntry(entry, message, recentEntryIds);
-        if (protectedEntry)
-            protectedEntryIds.add(entry.id);
-        const rawMessage = getContextEligibleMessageFromEntry(rawEntry) ?? message;
-        const contentBlocks = contentBlocksForEntry(entry.id, rawMessage, protectedEntry, effectiveDeletionFilters.deletedContentBlocks.get(entry.id));
-        const toolCallIds = contentBlocks.map((block) => block.toolCallId).filter((id) => id !== undefined);
-        const text = contentBlocks.length > 0 ? contentBlocks.map((block) => block.text).join("\n") : messageText(message);
-        entries.push({
-            entryId: entry.id,
-            entryType: entry.type,
-            role: message.role,
-            text,
-            tokenEstimate: estimateTokens(message),
-            protected: protectedEntry,
-            contentBlocks,
-            message,
-            toolCallIds,
-            toolResultFor: getToolResultCallId(message),
-        });
-    }
-    if (entries.length < 2)
-        return undefined;
-    return {
-        branchEntries: pathEntries,
-        parameters,
-        transcript: {
-            entries,
-            protectedEntryIds: [...protectedEntryIds],
-            tokensBefore: entries.reduce((total, entry) => total + entry.tokenEstimate, 0),
-            settings,
-            parameters,
-        },
-    };
-}
-function targetKey(target) {
-    return target.kind === "entry" ? `entry:${target.entryId}` : `content_block:${target.entryId}:${target.blockIndex}`;
-}
-function rawTargetKey(target) {
-    return target.kind === "entry" ? `entry:${target.entryId}` : `content_block:${target.entryId}:${target.blockIndex}`;
-}
-function normalizeRawTarget(target) {
-    if (target.kind === "entry")
-        return { kind: "entry", entryId: target.entryId };
-    return { kind: "content_block", entryId: target.entryId, blockIndex: target.blockIndex };
-}
-function assertIdOnlyDeletionTarget(target) {
-    const allowedKeys = target.kind === "content_block" ? new Set(["kind", "entryId", "blockIndex"]) : new Set(["kind", "entryId"]);
-    for (const key of Object.keys(target)) {
-        if (!allowedKeys.has(key)) {
-            throw new Error(`Deletion target includes unsupported property ${JSON.stringify(key)}; context deletion targets are id-only and must contain only kind, entryId${target.kind === "content_block" ? ", and blockIndex" : ""}`);
-        }
-    }
-}
-function rawDeletionFromTarget(target) {
-    if (target.kind === "entry")
-        return { kind: "entry", entryId: target.entryId };
-    return { kind: "content_block", entryId: target.entryId, blockIndex: target.blockIndex };
-}
-function deletionRequestFromTargets(targets) {
-    return { deletions: targets.map(rawDeletionFromTarget) };
-}
-function getDeletedEntryIds(targets) {
-    return new Set(targets.filter((target) => target.kind === "entry").map((target) => target.entryId));
-}
-function getDeletedContentBlocks(targets) {
-    const blocksByEntry = new Map();
-    for (const target of targets) {
-        if (target.kind !== "content_block")
-            continue;
-        const blocks = blocksByEntry.get(target.entryId) ?? new Set();
-        blocks.add(target.blockIndex);
-        blocksByEntry.set(target.entryId, blocks);
-    }
-    return blocksByEntry;
-}
-function recentContextEntryBoundary(transcript) {
-    const { preserve_recent } = getTranscriptCompactionParameters(transcript);
-    return preserve_recent > 0 ? Math.max(0, transcript.entries.length - preserve_recent) : transcript.entries.length;
-}
-function getRecentContextEntryIds(transcript) {
-    const { preserve_recent } = getTranscriptCompactionParameters(transcript);
-    if (preserve_recent <= 0)
-        return new Set();
-    return new Set(transcript.entries.slice(recentContextEntryBoundary(transcript)).map((entry) => entry.entryId));
-}
-function isRecentContextEntry(entry, transcript) {
-    const { preserve_recent } = getTranscriptCompactionParameters(transcript);
-    if (preserve_recent <= 0)
-        return false;
-    const entryIndex = transcript.entries.findIndex((candidate) => candidate.entryId === entry.entryId);
-    return entryIndex >= 0 && entryIndex >= recentContextEntryBoundary(transcript);
-}
-function formatRecentContextDeletionError(transcript, target) {
-    const { preserve_recent } = getTranscriptCompactionParameters(transcript);
-    const recentWindow = `last ${preserve_recent} context ${preserve_recent === 1 ? "entry" : "entries"}`;
-    if (target.kind === "entry") {
-        return `Cannot delete recent context entry ${target.entryId} because the ${recentWindow} must remain available for active continuity. Choose an older entry.`;
-    }
-    return `Cannot delete content block ${target.entryId}:${target.blockIndex} because entry ${target.entryId} is one of the ${recentWindow} that must remain available for active continuity. Choose an older entry or content block.`;
-}
-function deletionGuidance() {
-    return "Choose another deletion candidate.";
-}
-function findTranscriptEntry(transcript, entryId) {
-    return transcript.entries.find((entry) => entry.entryId === entryId);
-}
-function findTranscriptContentBlock(transcript, target) {
-    if (target.kind !== "content_block")
-        return undefined;
-    return findTranscriptEntry(transcript, target.entryId)?.contentBlocks.find((block) => block.blockIndex === target.blockIndex);
-}
-function firstToolCallBlockTarget(entry, callId) {
-    const blockIndex = toolCallBlockIndexes(entry, callId)[0];
-    return blockIndex === undefined ? undefined : { kind: "content_block", entryId: entry.entryId, blockIndex };
-}
-function formatProtectedDeletionError(transcript, target) {
-    const entry = findTranscriptEntry(transcript, target.entryId);
-    if (target.kind === "entry") {
-        const toolResultSuffix = entry?.toolResultFor ? ` for tool call ${entry.toolResultFor}` : "";
-        const toolCallSuffix = entry && entry.toolCallIds.length > 0 ? ` containing tool call ${entry.toolCallIds.join(", ")}` : "";
-        return `Deletion target ${target.entryId}${toolResultSuffix}${toolCallSuffix} is protected. ${deletionGuidance()}`;
-    }
-    const block = findTranscriptContentBlock(transcript, target);
-    const toolBlockSuffix = block?.toolCallId ? ` It is a protected tool block for tool call ${block.toolCallId}.` : "";
-    return `Content block ${target.entryId}:${target.blockIndex} is protected.${toolBlockSuffix} ${deletionGuidance()}`;
-}
-function formatProtectedToolDependencyError(transcript, blockedTarget, context) {
-    const protectedMessage = formatProtectedDeletionError(transcript, blockedTarget);
-    return `${context} ${protectedMessage}`;
-}
-function isProtectedContextDeletionErrorMessage(message) {
-    return (/\bprotected\b/i.test(message) ||
-        /Cannot delete (?:recent context entry|content block .* because entry .* is one of the last)/u.test(message) ||
-        /latest assistant message|thinking\/redacted_thinking block in (?:the latest|a retained) assistant message/u.test(message));
-}
-function assertNoRecentContextDeletionTargets(transcript, targets) {
-    const recentEntryIds = getRecentContextEntryIds(transcript);
-    for (const target of targets) {
-        if (recentEntryIds.has(target.entryId)) {
-            throw new Error(formatRecentContextDeletionError(transcript, target));
-        }
-    }
-}
-function latestAssistantEntry(transcript, deletedEntryIds = new Set()) {
-    for (let index = transcript.entries.length - 1; index >= 0; index--) {
-        const entry = transcript.entries[index];
-        if (entry.role === "assistant" && !deletedEntryIds.has(entry.entryId))
-            return entry;
-    }
-    return undefined;
-}
-function findAssistantThinkingContentBlockDeletionViolation(transcript, targets) {
-    const deletedEntryIds = getDeletedEntryIds(targets);
-    for (const target of targets) {
-        if (target.kind !== "content_block")
-            continue;
-        if (deletedEntryIds.has(target.entryId))
-            continue;
-        const entry = findTranscriptEntry(transcript, target.entryId);
-        if (entry && assistantEntryHasThinkingContentBlock(entry))
-            return target;
-    }
-    return undefined;
-}
-function findLatestAssistantThinkingDeletionViolation(transcript, targets) {
-    const deletedEntryIds = getDeletedEntryIds(targets);
-    const latestRetainedAssistant = latestAssistantEntry(transcript, deletedEntryIds);
-    for (const target of targets) {
-        if (target.kind === "entry") {
-            const entry = findTranscriptEntry(transcript, target.entryId);
-            if (!entry || !assistantEntryHasThinkingContentBlock(entry))
-                continue;
-            const deletedEntryIdsIfTargetWereKept = new Set(deletedEntryIds);
-            deletedEntryIdsIfTargetWereKept.delete(target.entryId);
-            if (latestAssistantEntry(transcript, deletedEntryIdsIfTargetWereKept)?.entryId === target.entryId) {
-                return target;
-            }
-            continue;
-        }
-        if (latestRetainedAssistant?.entryId === target.entryId &&
-            assistantEntryHasThinkingContentBlock(latestRetainedAssistant)) {
-            return target;
-        }
-    }
-    return undefined;
-}
-function assertNoAssistantThinkingContentBlockDeletionTargets(transcript, targets) {
-    const violation = findAssistantThinkingContentBlockDeletionViolation(transcript, targets);
-    if (!violation)
-        return;
-    throw new Error(`Cannot delete content block ${violation.entryId}:${violation.blockIndex} because a thinking/redacted_thinking block in a retained assistant message must remain unmodified; retained assistant messages containing thinking/redacted_thinking content blocks are all-or-nothing`);
-}
-function assertNoLatestAssistantThinkingDeletionTargets(transcript, targets) {
-    const violation = findLatestAssistantThinkingDeletionViolation(transcript, targets);
-    if (!violation)
-        return;
-    if (violation.kind === "entry") {
-        throw new Error(`Cannot delete assistant entry ${violation.entryId} because it is the latest assistant message retained after other deletions and contains thinking/redacted_thinking content blocks`);
-    }
-    throw new Error(`Cannot delete content block ${violation.entryId}:${violation.blockIndex} because a thinking/redacted_thinking block in the latest assistant message must remain unmodified; the latest retained assistant message contains thinking/redacted_thinking content blocks`);
-}
-function isToolCallBlockDeleted(entry, callId, deletedEntryIds, deletedContentBlocks) {
-    if (deletedEntryIds.has(entry.entryId))
-        return true;
-    const deletedBlocks = deletedContentBlocks.get(entry.entryId);
-    if (!deletedBlocks)
-        return false;
-    return entry.contentBlocks.some((block) => block.toolCallId === callId && deletedBlocks.has(block.blockIndex));
-}
-function toolCallBlockIndexes(entry, callId) {
-    return entry.contentBlocks
-        .filter((block) => block.toolCallId === callId)
-        .map((block) => block.blockIndex);
-}
-function addTarget(targets, target) {
-    if (targets.some((existing) => targetKey(existing) === targetKey(target)))
-        return false;
-    targets.push(target);
-    return true;
-}
-function deleteEntryTarget(targets, entryId) {
-    let changed = false;
-    for (let index = targets.length - 1; index >= 0; index--) {
-        const target = targets[index];
-        if (target.kind === "content_block" && target.entryId === entryId) {
-            targets.splice(index, 1);
-            changed = true;
-        }
-    }
-    return addTarget(targets, { kind: "entry", entryId }) || changed;
-}
-function mergeContextDeletionTargets(baseTargets, additionalTargets) {
-    const targets = [...baseTargets];
-    for (const target of additionalTargets) {
-        if (target.kind === "entry") {
-            deleteEntryTarget(targets, target.entryId);
-            continue;
-        }
-        if (!getDeletedEntryIds(targets).has(target.entryId)) {
-            addTarget(targets, target);
-        }
-    }
-    return targets;
-}
-function canonicalizeEntryTargets(transcript, targets, entry) {
-    if (!canDeleteTarget(transcript, { kind: "entry", entryId: entry.entryId }))
-        return false;
-    if (getDeletedEntryIds(targets).has(entry.entryId))
-        return false;
-    const deletedBlocks = getDeletedContentBlocks(targets).get(entry.entryId);
-    if (!deletedBlocks || !entry.contentBlocks.every((block) => deletedBlocks.has(block.blockIndex)))
-        return false;
-    // Only repair/promote when dependency reconciliation reaches this entry. Non-tool entries that
-    // request every block individually stay invalid so the assistant must choose explicit entry deletion.
-    return deleteEntryTarget(targets, entry.entryId);
-}
-function addToolCallDeletion(transcript, targets, entry, callId) {
-    if (assistantEntryHasThinkingContentBlock(entry)) {
-        if (!canDeleteTarget(transcript, { kind: "entry", entryId: entry.entryId }))
-            return false;
-        return deleteEntryTarget(targets, entry.entryId);
-    }
-    let changed = false;
-    for (const blockIndex of toolCallBlockIndexes(entry, callId)) {
-        const target = { kind: "content_block", entryId: entry.entryId, blockIndex };
-        if (!canDeleteTarget(transcript, target))
-            continue;
-        if (!getDeletedEntryIds(targets).has(entry.entryId)) {
-            changed = addTarget(targets, target) || changed;
-        }
-    }
-    return canonicalizeEntryTargets(transcript, targets, entry) || changed;
-}
-let warnedReconciliationNonConvergence = false;
-function reconcileToolDependencies(transcript, initialTargets) {
-    const targets = [...initialTargets];
-    const callEntries = new Map();
-    const entriesWithToolCalls = new Set();
-    const resultEntries = new Map();
-    for (const entry of transcript.entries) {
-        for (const callId of entry.toolCallIds) {
-            callEntries.set(callId, entry);
-            entriesWithToolCalls.add(entry);
-        }
-        if (entry.toolResultFor) {
-            const results = resultEntries.get(entry.toolResultFor) ?? [];
-            results.push(entry);
-            resultEntries.set(entry.toolResultFor, results);
-        }
-    }
-    // Bounded fixpoint repair: each pass can add/remove paired call/result targets. In practice this
-    // converges within one or two passes; the cap protects against accidental oscillation.
-    let changed = true;
-    let remainingPasses = Math.max(1, transcript.entries.length * 2);
-    while (changed && remainingPasses > 0) {
-        changed = false;
-        remainingPasses -= 1;
-        let deletedEntryIds = getDeletedEntryIds(targets);
-        let deletedContentBlocks = getDeletedContentBlocks(targets);
-        const recordChange = (nextChanged) => {
-            if (!nextChanged)
-                return;
-            changed = true;
-            deletedEntryIds = getDeletedEntryIds(targets);
-            deletedContentBlocks = getDeletedContentBlocks(targets);
-        };
-        for (const [callId, callEntry] of callEntries) {
-            const callDeleted = isToolCallBlockDeleted(callEntry, callId, deletedEntryIds, deletedContentBlocks);
-            const results = resultEntries.get(callId) ?? [];
-            if (callDeleted) {
-                const retainedProtectedResult = results.find((entry) => !deletedEntryIds.has(entry.entryId) &&
-                    !canDeleteTarget(transcript, { kind: "entry", entryId: entry.entryId }));
-                if (retainedProtectedResult) {
-                    const retainedResultTarget = { kind: "entry", entryId: retainedProtectedResult.entryId };
-                    if (isRecentTarget(transcript, retainedResultTarget)) {
-                        throw new Error(formatRecentContextDeletionError(transcript, retainedResultTarget));
-                    }
-                    throw new Error(formatProtectedToolDependencyError(transcript, retainedResultTarget, `Cannot delete tool call ${callId} because its paired tool result entry ${retainedProtectedResult.entryId} is protected.`));
-                }
-                else {
-                    for (const result of results) {
-                        recordChange(deleteEntryTarget(targets, result.entryId));
-                    }
-                }
-            }
-            if (isToolCallBlockDeleted(callEntry, callId, deletedEntryIds, deletedContentBlocks))
-                continue;
-            for (const result of results) {
-                if (!deletedEntryIds.has(result.entryId))
-                    continue;
-                recordChange(deleteEntryTarget(targets, result.entryId));
-                const callEntryTarget = { kind: "entry", entryId: callEntry.entryId };
-                const callBlockTarget = assistantEntryHasThinkingContentBlock(callEntry)
-                    ? callEntryTarget
-                    : firstToolCallBlockTarget(callEntry, callId) ?? callEntryTarget;
-                if (!canDeleteTarget(transcript, callBlockTarget)) {
-                    if (isRecentTarget(transcript, callBlockTarget)) {
-                        throw new Error(formatRecentContextDeletionError(transcript, callBlockTarget));
-                    }
-                    throw new Error(formatProtectedToolDependencyError(transcript, callBlockTarget, `Cannot delete tool result entry ${result.entryId} because that would require deleting protected tool block for tool call ${callId}.`));
-                }
-                recordChange(addToolCallDeletion(transcript, targets, callEntry, callId));
-            }
-        }
-        for (const entry of entriesWithToolCalls) {
-            recordChange(canonicalizeEntryTargets(transcript, targets, entry));
-        }
-    }
-    if (changed && !warnedReconciliationNonConvergence) {
-        warnedReconciliationNonConvergence = true;
-        console.warn(`Context compaction tool dependency reconciliation did not converge within the bounded pass limit; validation will continue with the last reconciled target set. entries=${transcript.entries.length} callEntries=${callEntries.size} targets=${targets.length}`);
-    }
-    return targets;
-}
-function validateToolDependencies(transcript, targets) {
-    const deletedEntryIds = getDeletedEntryIds(targets);
-    const deletedContentBlocks = getDeletedContentBlocks(targets);
-    const callEntries = new Map();
-    const resultEntries = new Map();
-    for (const entry of transcript.entries) {
-        for (const callId of entry.toolCallIds) {
-            callEntries.set(callId, entry);
-        }
-        if (entry.toolResultFor) {
-            const results = resultEntries.get(entry.toolResultFor) ?? [];
-            results.push(entry);
-            resultEntries.set(entry.toolResultFor, results);
-        }
-    }
-    for (const [callId, callEntry] of callEntries) {
-        const callDeleted = isToolCallBlockDeleted(callEntry, callId, deletedEntryIds, deletedContentBlocks);
-        const results = resultEntries.get(callId) ?? [];
-        if (callDeleted) {
-            const danglingResult = results.find((entry) => !deletedEntryIds.has(entry.entryId));
-            if (danglingResult) {
-                throw new Error(`Deleting tool call ${callId} would leave tool result entry ${danglingResult.entryId} orphaned`);
-            }
-            continue;
-        }
-        const deletedResult = results.find((entry) => deletedEntryIds.has(entry.entryId));
-        if (deletedResult) {
-            throw new Error(`Deleting tool result entry ${deletedResult.entryId} would leave tool call ${callId} dangling`);
-        }
-    }
-}
-function computeContextCompactionStats(transcript, targets) {
-    const entryById = new Map(transcript.entries.map((entry) => [entry.entryId, entry]));
-    const deletedEntryIds = getDeletedEntryIds(targets);
-    let deletedTokens = 0;
-    let objectsDeleted = 0;
-    for (const entryId of deletedEntryIds) {
-        const entry = entryById.get(entryId);
-        if (!entry)
-            continue;
-        deletedTokens += entry.tokenEstimate;
-        objectsDeleted += 1 + entry.contentBlocks.length;
-    }
-    for (const target of targets) {
-        if (target.kind !== "content_block" || deletedEntryIds.has(target.entryId))
-            continue;
-        const entry = entryById.get(target.entryId);
-        if (!entry)
-            continue;
-        const block = entry.contentBlocks.find((item) => item.blockIndex === target.blockIndex);
-        if (!block)
-            continue;
-        deletedTokens += block.tokenEstimate;
-        objectsDeleted += 1;
-    }
-    const objectsBefore = transcript.entries.length + transcript.entries.reduce((total, entry) => total + entry.contentBlocks.length, 0);
-    const tokensBefore = transcript.tokensBefore;
-    const tokensAfter = Math.max(0, tokensBefore - deletedTokens);
-    const percentReduction = tokensBefore > 0 ? Math.round(((tokensBefore - tokensAfter) / tokensBefore) * 1000) / 10 : 0;
-    return {
-        objectsBefore,
-        objectsAfter: Math.max(0, objectsBefore - objectsDeleted),
-        objectsDeleted,
-        tokensBefore,
-        tokensAfter,
-        percentReduction,
-    };
-}
-/**
- * An entry "bears task context" when it carries the user's intent for the session: a real `user`
- * message, an extension-injected `custom` message, or a branch summary (`branchSummary` role /
- * `branch_summary` entry type) that recaps an earlier branch's task.
- *
- * Verbatim compaction must always leave at least one task-bearing entry in context.
- */
-function isTaskBearingEntry(entry) {
-    return (entry.role === "user" ||
-        entry.role === "custom" ||
-        entry.role === "branchSummary" ||
-        entry.entryType === "branch_summary");
-}
-function isRecentTarget(transcript, target) {
-    const entry = transcript.entries.find((candidate) => candidate.entryId === target.entryId);
-    return entry !== undefined && isRecentContextEntry(entry, transcript);
-}
-function canDeleteTarget(transcript, target) {
-    const entry = transcript.entries.find((candidate) => candidate.entryId === target.entryId);
-    if (!entry)
-        return false;
-    if (isRecentTarget(transcript, target))
-        return false;
-    if (entry.protected)
-        return false;
-    if (target.kind === "entry")
-        return true;
-    const block = entry.contentBlocks.find((candidate) => candidate.blockIndex === target.blockIndex);
-    if (!block)
-        return false;
-    return !block.protected;
-}
-export function validateContextDeletionRequest(request, transcript) {
-    if (!request || typeof request !== "object" || !Array.isArray(request.deletions)) {
-        throw new Error("Context deletion request must be an object with a deletions array");
-    }
-    const entryById = new Map(transcript.entries.map((entry) => [entry.entryId, entry]));
-    const recentEntryIds = getRecentContextEntryIds(transcript);
-    const seen = new Set();
-    const deletedTargets = [];
-    for (const deletion of request.deletions) {
-        if (!deletion || typeof deletion !== "object") {
-            throw new Error("Deletion target must be an object");
-        }
-        if (deletion.kind !== "entry" && deletion.kind !== "content_block") {
-            throw new Error(`Unsupported deletion target kind: ${String(deletion.kind)}`);
-        }
-        assertIdOnlyDeletionTarget(deletion);
-        if (typeof deletion.entryId !== "string" || deletion.entryId.length === 0) {
-            throw new Error("Deletion target entryId must be a non-empty string");
-        }
-        const entry = entryById.get(deletion.entryId);
-        if (!entry) {
-            throw new Error(`Unknown deletion target entryId: ${deletion.entryId}`);
-        }
-        const normalized = normalizeRawTarget(deletion);
-        if (deletion.kind === "entry") {
-            if (recentEntryIds.has(deletion.entryId)) {
-                throw new Error(formatRecentContextDeletionError(transcript, normalized));
-            }
-            if (entry.protected) {
-                throw new Error(formatProtectedDeletionError(transcript, normalized));
-            }
-        }
-        if (deletion.kind === "content_block") {
-            if (typeof deletion.blockIndex !== "number" || !Number.isInteger(deletion.blockIndex) || deletion.blockIndex < 0) {
-                throw new Error(`Invalid content block index for entry ${deletion.entryId}`);
-            }
-            if (recentEntryIds.has(deletion.entryId)) {
-                throw new Error(formatRecentContextDeletionError(transcript, normalized));
-            }
-            if (entry.protected) {
-                throw new Error(formatProtectedDeletionError(transcript, normalized));
-            }
-            const block = entry.contentBlocks.find((item) => item.blockIndex === deletion.blockIndex);
-            if (!block) {
-                throw new Error(`Unknown content block ${deletion.blockIndex} for entry ${deletion.entryId}`);
-            }
-            if (block.protected) {
-                throw new Error(formatProtectedDeletionError(transcript, normalized));
-            }
-            if (entry.contentBlocks.length <= 1) {
-                throw new Error(`Deleting the only content block of ${deletion.entryId} must be an entry deletion`);
-            }
-        }
-        const key = rawTargetKey(deletion);
-        if (seen.has(key)) {
-            throw new Error(`Duplicate deletion target: ${key}`);
-        }
-        seen.add(key);
-        deletedTargets.push(normalized);
-    }
-    const reconciledTargets = reconcileToolDependencies(transcript, deletedTargets);
-    // Tool reconciliation can add targets after the per-request checks above, so
-    // these post-reconcile assertions remain authoritative.
-    assertNoRecentContextDeletionTargets(transcript, reconciledTargets);
-    assertNoAssistantThinkingContentBlockDeletionTargets(transcript, reconciledTargets);
-    assertNoLatestAssistantThinkingDeletionTargets(transcript, reconciledTargets);
-    const reconciledDeletedEntryIds = getDeletedEntryIds(reconciledTargets);
-    for (const target of reconciledTargets) {
-        if (target.kind === "content_block" && reconciledDeletedEntryIds.has(target.entryId)) {
-            throw new Error(`Deletion target ${targetKey(target)} overlaps with entry deletion`);
-        }
-    }
-    const deletedContentBlocks = getDeletedContentBlocks(reconciledTargets);
-    for (const [entryId, blockIndexes] of deletedContentBlocks) {
-        const entry = entryById.get(entryId);
-        if (entry?.contentBlocks.every((block) => blockIndexes.has(block.blockIndex))) {
-            throw new Error(`Content-block deletions for ${entryId} would remove every content block`);
-        }
-    }
-    validateToolDependencies(transcript, reconciledTargets);
-    const remainingEntries = transcript.entries.filter((entry) => !reconciledDeletedEntryIds.has(entry.entryId));
-    if (remainingEntries.length === 0) {
-        throw new Error("Deletion request would remove all context entries");
-    }
-    const hasTaskBearingContext = remainingEntries.some(isTaskBearingEntry);
-    if (!hasTaskBearingContext) {
-        throw new Error("Deletion request would leave no user task in context");
-    }
-    return {
-        deletedTargets: reconciledTargets,
-        protectedEntryIds: [...transcript.protectedEntryIds],
-        stats: computeContextCompactionStats(transcript, reconciledTargets),
-    };
-}
-function contextDeletionRequestFromObject(value, source) {
-    if (!value || typeof value !== "object" || !Array.isArray(value.deletions)) {
-        throw new Error(`${source} must contain a deletions array`);
-    }
-    return value;
-}
-function escapeRegExpLiteral(text) {
-    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function formatErrorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function createContextDeletionToolResult(text, details) {
-    return { content: [{ type: "text", text }], details, terminate: false };
-}
-function roundPercent(value) {
-    return Math.round(value * 10) / 10;
-}
-function percentOf(part, total) {
-    return total > 0 ? roundPercent((part / total) * 100) : 0;
-}
-function finitePositiveNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : undefined;
-}
-function createContextCompactionBudgetDetails(stats, callCount, contextWindow, parameters) {
-    const targetTokensAfter = Math.max(0, Math.floor(stats.tokensBefore * parameters.compression_ratio));
-    const targetReductionPercent = contextCompactionTargetReductionPercent(parameters);
-    const details = {
-        ...(contextWindow !== undefined ? { contextWindow } : {}),
-        compression_ratio: parameters.compression_ratio,
-        tokensBefore: stats.tokensBefore,
-        currentTokensAfter: stats.tokensAfter,
-        deletedTokens: Math.max(0, stats.tokensBefore - stats.tokensAfter),
-        currentReductionPercent: stats.percentReduction,
-        targetReductionPercent,
-        targetTokensAfter,
-        tokensToDeleteForTarget: Math.max(0, stats.tokensAfter - targetTokensAfter),
-        ...(contextWindow !== undefined
-            ? {
-                contextWindowBeforePercent: percentOf(stats.tokensBefore, contextWindow),
-                contextWindowAfterPercent: percentOf(stats.tokensAfter, contextWindow),
-            }
-            : {}),
-        callCount,
-    };
-    return details;
-}
-function contextCompactionTargetMet(result, parameters) {
-    return (result !== undefined &&
-        result.deletedTargets.length > 0 &&
-        result.stats.percentReduction >= contextCompactionTargetReductionPercent(parameters));
-}
-function contextCompactionProgressKey(result) {
-    if (!result)
-        return "none:0";
-    return `${result.deletedTargets.length}:${result.stats.percentReduction}:${result.stats.tokensAfter}`;
-}
-function contextCompactionProgressPercent(result) {
-    return result?.stats.percentReduction ?? 0;
-}
-function createContextCompactionTargetNudgeMessage(result, parameters) {
-    const currentReductionPercent = contextCompactionProgressPercent(result);
-    const targetLabel = contextCompactionTargetLabel(parameters);
-    const tokensToDelete = result
-        ? createContextCompactionBudgetDetails(result.stats, 0, undefined, parameters).tokensToDeleteForTarget
-        : undefined;
-    const remainingText = tokensToDelete !== undefined ? ` Delete about ${tokensToDelete} more token(s) if safe candidates exist.` : "";
-    return {
-        role: "user",
-        content: [
-            {
-                type: "text",
-                text: `The strict ${targetLabel} context-reduction requirement is not met yet; current validated reduction is ${currentReductionPercent}%.${remainingText} Continue removing low-value message entries or message content blocks using ${CONTEXT_DELETE_TOOL_NAME} or ${CONTEXT_GREP_DELETE_TOOL_NAME}. Use the focus query ${JSON.stringify(parameters.query)} to preserve relevant context. Call ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME} to verify progress, and do not provide a final answer until the validated reduction is at least ${targetLabel}.`,
-            },
-        ],
-        timestamp: Date.now(),
-    };
-}
-function assertSafeRegexPattern(pattern) {
-    if (pattern.length > CONTEXT_GREP_DELETE_MAX_REGEX_PATTERN_CHARS) {
-        throw new Error(`Regex pattern is too long (${pattern.length} characters); maximum is ${CONTEXT_GREP_DELETE_MAX_REGEX_PATTERN_CHARS}`);
-    }
-    // Heuristic ReDoS guard for common catastrophic-backtracking shapes. JavaScript's RegExp engine
-    // does not expose a timeout, so reject nested quantified groups and backreferences instead of
-    // relying only on transcript scan-size caps.
-    const hasNestedQuantifiedGroup = /\((?:[^()\\]|\\.)*[+*](?:[^()\\]|\\.)*\)\s*(?:[+*]|\{\d)/u.test(pattern);
-    const hasQuantifiedAlternation = /\((?:[^()\\]|\\.)*\|(?:[^()\\]|\\.)*\)\s*(?:[+*]|\{\d)/u.test(pattern);
-    const hasBackreference = /\\[1-9]/u.test(pattern);
-    if (hasNestedQuantifiedGroup || hasQuantifiedAlternation || hasBackreference) {
-        throw new Error("Regex pattern is not allowed because it may cause excessive backtracking; use a literal pattern or exact deletion targets instead.");
-    }
-}
-function createGrepMatcher(pattern, regex, caseSensitive) {
-    if (regex) {
-        assertSafeRegexPattern(pattern);
-    }
-    try {
-        return new RegExp(regex ? pattern : escapeRegExpLiteral(pattern), caseSensitive ? "u" : "iu");
-    }
-    catch (error) {
-        throw new Error(`Invalid grep ${regex ? "regex" : "pattern"}: ${formatErrorMessage(error)}`);
-    }
-}
-function assertSafeRegexScan(scanChars) {
-    if (scanChars <= CONTEXT_GREP_DELETE_MAX_REGEX_SCAN_CHARS)
-        return;
-    throw new Error(`Regex grep would scan ${scanChars} characters; maximum is ${CONTEXT_GREP_DELETE_MAX_REGEX_SCAN_CHARS}. Use a literal pattern or exact deletion targets instead.`);
-}
-function clampInteger(value, defaultValue, minimum, maximum) {
-    if (value === undefined)
-        return defaultValue;
-    return Math.max(minimum, Math.min(maximum, value));
-}
-function textSlice(text, offset, maxChars) {
-    return text.slice(offset, Math.min(text.length, offset + maxChars));
-}
-function findMatchIndex(matcher, text) {
-    const match = matcher.exec(text);
-    matcher.lastIndex = 0;
-    return match?.index ?? -1;
-}
-function snippetForMatch(text, matchIndex, contextChars) {
-    const start = Math.max(0, matchIndex - contextChars);
-    const end = Math.min(text.length, matchIndex + contextChars);
-    const prefix = start > 0 ? "…" : "";
-    const suffix = end < text.length ? "…" : "";
-    return `${prefix}${text.slice(start, end)}${suffix}`;
-}
-function currentTargetDeleted(targets, target) {
-    const deletedEntryIds = getDeletedEntryIds(targets);
-    if (deletedEntryIds.has(target.entryId))
-        return true;
-    if (target.kind === "entry")
-        return false;
-    return getDeletedContentBlocks(targets).get(target.entryId)?.has(target.blockIndex) === true;
-}
-function addGrepCandidate(candidates, matches, seenTargets, candidate, match) {
-    const key = targetKey(candidate);
-    if (seenTargets.has(key))
-        return;
-    seenTargets.add(key);
-    candidates.push(candidate);
-    matches.push(match);
-}
-function pushProtectedGrepSkip(skipped, match) {
-    skipped.push({
-        entryId: match.entryId,
-        target: match.target,
-        ...(match.blockIndex === undefined ? {} : { blockIndex: match.blockIndex }),
-        reason: match.target === "content_block" ? "protected_block" : "protected_entry",
-        text: match.text,
-    });
-}
-function filterProtectedGrepCandidates(candidates, matches, currentTargets, transcript, skipped) {
-    const eligibleCandidates = [];
-    const eligibleMatches = [];
-    for (let index = 0; index < candidates.length; index++) {
-        const candidate = candidates[index];
-        const match = matches[index];
-        if (!candidate || !match)
-            continue;
-        try {
-            const mergedTargets = mergeContextDeletionTargets(currentTargets, [candidate]);
-            validateContextDeletionRequest(deletionRequestFromTargets(mergedTargets), transcript);
-            eligibleCandidates.push(candidate);
-            eligibleMatches.push(match);
-        }
-        catch (error) {
-            const message = formatErrorMessage(error);
-            if (isProtectedContextDeletionErrorMessage(message)) {
-                pushProtectedGrepSkip(skipped, match);
-                continue;
-            }
-            eligibleCandidates.push(candidate);
-            eligibleMatches.push(match);
-        }
-    }
-    // Some latest-assistant thinking violations only become visible after a grep batch also
-    // deletes newer assistant entries. Classify the newly-unsafe grep candidates as
-    // protected/skipped before maxMatches, expectedMatchCount, stats, or removals are computed.
-    let changed = true;
-    while (changed) {
-        changed = false;
-        const mergedTargets = mergeContextDeletionTargets(currentTargets, eligibleCandidates);
-        const violation = findLatestAssistantThinkingDeletionViolation(transcript, mergedTargets);
-        if (!violation)
-            continue;
-        const violationKey = targetKey(violation);
-        let violationIndex = eligibleCandidates.findIndex((candidate) => targetKey(candidate) === violationKey);
-        if (violationIndex < 0) {
-            violationIndex = eligibleCandidates.findIndex((_candidate, candidateIndex) => {
-                const remainingCandidates = eligibleCandidates.filter((_candidateToKeep, index) => index !== candidateIndex);
-                const remainingTargets = mergeContextDeletionTargets(currentTargets, remainingCandidates);
-                const remainingViolation = findLatestAssistantThinkingDeletionViolation(transcript, remainingTargets);
-                return !remainingViolation || targetKey(remainingViolation) !== violationKey;
-            });
-        }
-        if (violationIndex < 0)
-            continue;
-        const [skippedMatch] = eligibleMatches.splice(violationIndex, 1);
-        eligibleCandidates.splice(violationIndex, 1);
-        if (skippedMatch)
-            pushProtectedGrepSkip(skipped, skippedMatch);
-        changed = true;
-    }
-    return { candidates: eligibleCandidates, matches: eligibleMatches };
-}
-function copyDeletionTarget(target) {
-    return target.kind === "entry"
-        ? { kind: "entry", entryId: target.entryId }
-        : { kind: "content_block", entryId: target.entryId, blockIndex: target.blockIndex };
-}
-class ContextDeletionMemoryStore {
-    constructor(transcript) {
-        this.deletionTargets = [];
-        this.callCount = 0;
-        const entryIds = new Set();
-        const blockKeys = new Set();
-        this.entries = transcript.entries.map((entry) => {
-            if (entryIds.has(entry.entryId)) {
-                throw new Error(`Duplicate transcript entry id: ${entry.entryId}`);
-            }
-            entryIds.add(entry.entryId);
-            return {
-                entryId: entry.entryId,
-                role: entry.role,
-                protected: entry.protected,
-                hasAssistantThinkingBlocks: assistantEntryHasThinkingContentBlock(entry),
-                tokenEstimate: entry.tokenEstimate,
-                text: entry.text,
-            };
-        });
-        this.entriesById = new Map(this.entries.map((entry) => [entry.entryId, entry]));
-        this.contentBlocks = transcript.entries.flatMap((entry, entryPosition) => {
-            const hasAssistantThinkingBlocks = assistantEntryHasThinkingContentBlock(entry);
-            return entry.contentBlocks.map((block) => {
-                if (block.entryId !== entry.entryId) {
-                    throw new Error(`Transcript content block ${block.entryId}:${block.blockIndex} does not belong to entry ${entry.entryId}`);
-                }
-                const blockKey = `${block.entryId}:${block.blockIndex}`;
-                if (blockKeys.has(blockKey)) {
-                    throw new Error(`Duplicate transcript content block: ${blockKey}`);
-                }
-                blockKeys.add(blockKey);
-                return {
-                    entryPosition,
-                    entryId: block.entryId,
-                    blockIndex: block.blockIndex,
-                    role: entry.role,
-                    type: block.type,
-                    protected: block.protected,
-                    hasAssistantThinkingBlocks,
-                    tokenEstimate: block.tokenEstimate,
-                    text: block.text,
-                };
-            });
-        });
-        this.contentBlockCountByEntryId = new Map();
-        for (const block of this.contentBlocks) {
-            this.contentBlockCountByEntryId.set(block.entryId, (this.contentBlockCountByEntryId.get(block.entryId) ?? 0) + 1);
-        }
-    }
-    transaction(operation) {
-        const snapshot = this.snapshot();
-        try {
-            return operation();
-        }
-        catch (error) {
-            this.restore(snapshot);
-            throw error;
-        }
-    }
-    readTargets() {
-        return this.deletionTargets.map(copyDeletionTarget);
-    }
-    replaceTargets(targets) {
-        this.deletionTargets = targets.map(copyDeletionTarget);
-    }
-    listEntriesForGrep() {
-        return this.entries.map((entry) => ({
-            entry_id: entry.entryId,
-            text: entry.text,
-            is_protected: entry.protected ? 1 : 0,
-            has_assistant_thinking_blocks: entry.hasAssistantThinkingBlocks ? 1 : 0,
-        }));
-    }
-    listContentBlocksForGrep() {
-        return [...this.contentBlocks]
-            .sort((a, b) => a.entryPosition - b.entryPosition || a.blockIndex - b.blockIndex)
-            .map((block) => ({
-            entry_id: block.entryId,
-            block_index: block.blockIndex,
-            role: block.role,
-            type: block.type,
-            text: block.text,
-            entry_protected: this.entriesById.get(block.entryId)?.protected ? 1 : 0,
-            block_protected: block.protected ? 1 : 0,
-            block_count: this.contentBlockCountByEntryId.get(block.entryId) ?? 0,
-            has_assistant_thinking_blocks: block.hasAssistantThinkingBlocks ? 1 : 0,
-        }));
-    }
-    getEntryForRead(entryId) {
-        const entry = this.entriesById.get(entryId);
-        if (!entry)
-            return undefined;
-        return {
-            entry_id: entry.entryId,
-            role: entry.role,
-            is_protected: entry.protected ? 1 : 0,
-            has_assistant_thinking_blocks: entry.hasAssistantThinkingBlocks ? 1 : 0,
-            token_estimate: entry.tokenEstimate,
-            text: entry.text,
-        };
-    }
-    getContentBlockForRead(entryId, blockIndex) {
-        const block = this.contentBlocks.find((candidate) => candidate.entryId === entryId && candidate.blockIndex === blockIndex);
-        if (!block)
-            return undefined;
-        return {
-            entry_id: block.entryId,
-            block_index: block.blockIndex,
-            role: block.role,
-            type: block.type,
-            token_estimate: block.tokenEstimate,
-            text: block.text,
-            entry_protected: this.entriesById.get(block.entryId)?.protected ? 1 : 0,
-            block_protected: block.protected ? 1 : 0,
-            block_count: this.contentBlockCountByEntryId.get(block.entryId) ?? 0,
-            has_assistant_thinking_blocks: block.hasAssistantThinkingBlocks ? 1 : 0,
-        };
-    }
-    getGrepScanTextLength(target) {
-        const texts = target === "entry" ? this.entries : this.contentBlocks;
-        return texts.reduce((sum, item) => sum + item.text.length, 0);
-    }
-    incrementCallCount() {
-        this.callCount += 1;
-        return this.callCount;
-    }
-    getCallCount() {
-        return this.callCount;
-    }
-    setLastError(message) {
-        this.lastError = message;
-    }
-    clearLastError() {
-        this.lastError = undefined;
-    }
-    getLastError() {
-        return this.lastError;
-    }
-    snapshot() {
-        return {
-            deletionTargets: this.readTargets(),
-            callCount: this.callCount,
-            ...(this.lastError === undefined ? {} : { lastError: this.lastError }),
-        };
-    }
-    restore(snapshot) {
-        this.deletionTargets = snapshot.deletionTargets.map(copyDeletionTarget);
-        this.callCount = snapshot.callCount;
-        this.lastError = snapshot.lastError;
-    }
-}
-function createContextDeletionStore(transcript) {
-    return new ContextDeletionMemoryStore(transcript);
-}
-export function createContextDeletionTool(inputTranscript, options = {}) {
-    const contextWindow = finitePositiveNumber(options.contextWindow);
-    const parameters = normalizeContextCompactionParameters({ ...getTranscriptCompactionParameters(inputTranscript), ...options }, inputTranscript.parameters?.query ?? CONTEXT_COMPACTION_AUTO_QUERY);
-    const transcript = { ...inputTranscript, parameters };
-    const store = createContextDeletionStore(transcript);
-    let validatedResult;
-    function readTargets() {
-        return store.readTargets();
-    }
-    function applyValidatedTargets(additionalTargets) {
-        const mergedTargets = mergeContextDeletionTargets(readTargets(), additionalTargets);
-        validatedResult = validateContextDeletionRequest(deletionRequestFromTargets(mergedTargets), transcript);
-        store.replaceTargets(validatedResult.deletedTargets);
-        return validatedResult;
-    }
-    function currentStats() {
-        return validatedResult?.stats ?? computeContextCompactionStats(transcript, readTargets());
-    }
-    function canDeleteProtectedTarget(target) {
-        return canDeleteTarget(transcript, target);
-    }
-    const tool = {
-        ...CONTEXT_DELETE_TOOL,
-        label: "context deletion request",
-        executionMode: "parallel",
-        async execute(_toolCallId, params) {
-            return store.transaction(() => {
-                const callCount = store.incrementCallCount();
-                try {
-                    const incomingRequest = contextDeletionRequestFromObject(params, `${CONTEXT_DELETE_TOOL_NAME} arguments`);
-                    const incomingValidated = validateContextDeletionRequest(incomingRequest, transcript);
-                    const applied = applyValidatedTargets(incomingValidated.deletedTargets);
-                    store.clearLastError();
-                    const deletedTargets = readTargets();
-                    const details = {
-                        deletions: deletionRequestFromTargets(deletedTargets).deletions,
-                        deletedTargets,
-                        stats: applied.stats,
-                        callCount,
-                    };
-                    const text = `Recorded ${incomingValidated.deletedTargets.length} deletion target(s); ${deletedTargets.length} total validated deletion target(s) are selected. Continue calling ${CONTEXT_DELETE_TOOL_NAME} or ${CONTEXT_GREP_DELETE_TOOL_NAME} for additional deletions, or respond done when finished.`;
-                    return createContextDeletionToolResult(text, details);
-                }
-                catch (error) {
-                    const message = formatErrorMessage(error);
-                    store.setLastError(message);
-                    const deletedTargets = readTargets();
-                    const details = {
-                        deletions: deletionRequestFromTargets(deletedTargets).deletions,
-                        deletedTargets,
-                        stats: currentStats(),
-                        callCount,
-                        error: message,
-                    };
-                    return createContextDeletionToolResult(`Error recording context deletion targets: ${message}. No new deletion targets were applied; continue with a corrected tool call.`, details);
-                }
-            });
-        },
-    };
-    const grepTool = {
-        ...CONTEXT_GREP_DELETE_TOOL,
-        label: "context grep delete",
-        executionMode: "parallel",
-        async execute(_toolCallId, params) {
-            return store.transaction(() => {
-                const callCount = store.incrementCallCount();
-                const pattern = params.pattern;
-                const regex = params.regex === true;
-                const caseSensitive = params.caseSensitive === true;
-                const target = params.target ?? "entry";
-                const maxMatches = params.maxMatches ?? CONTEXT_GREP_DELETE_DEFAULT_MAX_MATCHES;
-                const candidates = [];
-                const matches = [];
-                let reportedMatches = matches;
-                const skipped = [];
-                const seenTargets = new Set();
-                try {
-                    if (regex) {
-                        assertSafeRegexScan(store.getGrepScanTextLength(target));
-                    }
-                    const matcher = createGrepMatcher(pattern, regex, caseSensitive);
-                    const currentTargets = readTargets();
-                    const recentEntryIds = getRecentContextEntryIds(transcript);
-                    if (target === "entry") {
-                        for (const entry of store.listEntriesForGrep()) {
-                            if (!matcher.test(entry.text))
-                                continue;
-                            const candidate = { kind: "entry", entryId: entry.entry_id };
-                            if (recentEntryIds.has(candidate.entryId)) {
-                                skipped.push({ entryId: entry.entry_id, target, reason: "protected_entry", text: entry.text });
-                                continue;
-                            }
-                            if (entry.is_protected === 1 && !canDeleteProtectedTarget(candidate)) {
-                                skipped.push({ entryId: entry.entry_id, target, reason: "protected_entry", text: entry.text });
-                                continue;
-                            }
-                            if (currentTargetDeleted(currentTargets, candidate)) {
-                                skipped.push({ entryId: entry.entry_id, target, reason: "already_deleted", text: entry.text });
-                                continue;
-                            }
-                            addGrepCandidate(candidates, matches, seenTargets, candidate, {
-                                entryId: entry.entry_id,
-                                target,
-                                text: entry.text,
-                            });
-                        }
-                    }
-                    else {
-                        for (const block of store.listContentBlocksForGrep()) {
-                            if (!matcher.test(block.text))
-                                continue;
-                            const candidate = block.block_count <= 1
-                                ? { kind: "entry", entryId: block.entry_id }
-                                : { kind: "content_block", entryId: block.entry_id, blockIndex: block.block_index };
-                            if (recentEntryIds.has(candidate.entryId)) {
-                                skipped.push({
-                                    entryId: block.entry_id,
-                                    target: candidate.kind,
-                                    ...(candidate.kind === "content_block" ? { blockIndex: candidate.blockIndex } : {}),
-                                    reason: "protected_entry",
-                                    text: block.text,
-                                });
-                                continue;
-                            }
-                            if (block.entry_protected === 1 && !canDeleteProtectedTarget(candidate)) {
-                                skipped.push({
-                                    entryId: block.entry_id,
-                                    target,
-                                    blockIndex: block.block_index,
-                                    reason: "protected_entry",
-                                    text: block.text,
-                                });
-                                continue;
-                            }
-                            if (block.block_protected === 1 && !canDeleteProtectedTarget(candidate)) {
-                                skipped.push({
-                                    entryId: block.entry_id,
-                                    target,
-                                    blockIndex: block.block_index,
-                                    reason: "protected_block",
-                                    text: block.text,
-                                });
-                                continue;
-                            }
-                            if (currentTargetDeleted(currentTargets, candidate)) {
-                                skipped.push({
-                                    entryId: block.entry_id,
-                                    target: candidate.kind,
-                                    ...(candidate.kind === "content_block" ? { blockIndex: candidate.blockIndex } : {}),
-                                    reason: "already_deleted",
-                                    text: block.text,
-                                });
-                                continue;
-                            }
-                            addGrepCandidate(candidates, matches, seenTargets, candidate, {
-                                entryId: block.entry_id,
-                                target: candidate.kind,
-                                ...(candidate.kind === "content_block" ? { blockIndex: candidate.blockIndex } : {}),
-                                text: block.text,
-                            });
-                        }
-                    }
-                    const eligible = filterProtectedGrepCandidates(candidates, matches, currentTargets, transcript, skipped);
-                    reportedMatches = eligible.matches;
-                    let applied;
-                    if (params.expectedMatchCount !== undefined && eligible.candidates.length !== params.expectedMatchCount) {
-                        skipped.push({ reason: "expected_match_count_mismatch" });
-                    }
-                    else if (eligible.candidates.length > maxMatches) {
-                        skipped.push({ reason: "max_matches_exceeded" });
-                    }
-                    else if (eligible.candidates.length > 0) {
-                        applied = applyValidatedTargets(eligible.candidates);
-                    }
-                    store.clearLastError();
-                    const deletedTargets = readTargets();
-                    const details = {
-                        pattern,
-                        regex,
-                        caseSensitive,
-                        target,
-                        matches: eligible.matches,
-                        skipped,
-                        deletedTargets,
-                        stats: applied?.stats ?? currentStats(),
-                        callCount,
-                    };
-                    const text = `Matched ${eligible.matches.length} deletion target(s), skipped ${skipped.length}, and ${applied ? "applied" : "did not apply"} grep deletion for pattern ${JSON.stringify(pattern)}. Total validated deletion target(s): ${deletedTargets.length}.`;
-                    return createContextDeletionToolResult(text, details);
-                }
-                catch (error) {
-                    const message = formatErrorMessage(error);
-                    store.setLastError(message);
-                    const deletedTargets = readTargets();
-                    const details = {
-                        pattern,
-                        regex,
-                        caseSensitive,
-                        target,
-                        matches: reportedMatches,
-                        skipped,
-                        deletedTargets,
-                        stats: currentStats(),
-                        callCount,
-                        error: message,
-                    };
-                    return createContextDeletionToolResult(`Error applying grep deletion for pattern ${JSON.stringify(pattern)}: ${message}. No new deletion targets were applied; continue with a corrected tool call.`, details);
-                }
-            });
-        },
-    };
-    const searchTool = {
-        ...CONTEXT_SEARCH_TRANSCRIPT_TOOL,
-        label: "context transcript search",
-        executionMode: "parallel",
-        async execute(_toolCallId, params) {
-            return store.transaction(() => {
-                const callCount = store.incrementCallCount();
-                const pattern = params.pattern;
-                const regex = params.regex === true;
-                const caseSensitive = params.caseSensitive === true;
-                const target = params.target ?? "entry";
-                const maxMatches = clampInteger(params.maxMatches, CONTEXT_SEARCH_DEFAULT_MAX_MATCHES, 1, CONTEXT_SEARCH_MAX_MATCHES);
-                const contextChars = clampInteger(params.contextChars, CONTEXT_SEARCH_DEFAULT_CONTEXT_CHARS, 0, CONTEXT_SEARCH_MAX_CONTEXT_CHARS);
-                const matches = [];
-                let truncated = false;
-                try {
-                    if (regex) {
-                        assertSafeRegexScan(store.getGrepScanTextLength(target));
-                    }
-                    const matcher = createGrepMatcher(pattern, regex, caseSensitive);
-                    if (target === "entry") {
-                        for (const entry of store.listEntriesForGrep()) {
-                            const matchIndex = findMatchIndex(matcher, entry.text);
-                            if (matchIndex < 0)
-                                continue;
-                            if (matches.length >= maxMatches) {
-                                truncated = true;
-                                break;
-                            }
-                            matches.push({
-                                entryId: entry.entry_id,
-                                target,
-                                matchIndex,
-                                snippet: snippetForMatch(entry.text, matchIndex, contextChars),
-                                protected: entry.is_protected === 1,
-                            });
-                        }
-                    }
-                    else {
-                        for (const block of store.listContentBlocksForGrep()) {
-                            const matchIndex = findMatchIndex(matcher, block.text);
-                            if (matchIndex < 0)
-                                continue;
-                            if (matches.length >= maxMatches) {
-                                truncated = true;
-                                break;
-                            }
-                            matches.push({
-                                entryId: block.entry_id,
-                                target,
-                                blockIndex: block.block_index,
-                                matchIndex,
-                                snippet: snippetForMatch(block.text, matchIndex, contextChars),
-                                protected: block.entry_protected === 1 || block.block_protected === 1,
-                            });
-                        }
-                    }
-                    store.clearLastError();
-                    const details = {
-                        pattern,
-                        regex,
-                        caseSensitive,
-                        target,
-                        matches,
-                        truncated,
-                        callCount,
-                    };
-                    const text = `Found ${matches.length}${truncated ? "+" : ""} ${target} match(es) for ${JSON.stringify(pattern)}. Use ${CONTEXT_READ_ENTRY_TOOL_NAME} with small maxChars to inspect exact content before deleting.`;
-                    return createContextDeletionToolResult(text, details);
-                }
-                catch (error) {
-                    const message = formatErrorMessage(error);
-                    store.setLastError(message);
-                    const details = {
-                        pattern,
-                        regex,
-                        caseSensitive,
-                        target,
-                        matches,
-                        truncated,
-                        callCount,
-                        error: message,
-                    };
-                    return createContextDeletionToolResult(`Error searching transcript for ${JSON.stringify(pattern)}: ${message}. Try a literal pattern or narrower query.`, details);
-                }
-            });
-        },
-    };
-    const readEntryTool = {
-        ...CONTEXT_READ_ENTRY_TOOL,
-        label: "context read entry",
-        executionMode: "parallel",
-        async execute(_toolCallId, params) {
-            return store.transaction(() => {
-                const callCount = store.incrementCallCount();
-                const offset = clampInteger(params.offset, 0, 0, Number.MAX_SAFE_INTEGER);
-                const maxChars = clampInteger(params.maxChars, CONTEXT_READ_ENTRY_DEFAULT_MAX_CHARS, 1, CONTEXT_READ_ENTRY_MAX_CHARS);
-                try {
-                    const row = params.blockIndex === undefined
-                        ? store.getEntryForRead(params.entryId)
-                        : store.getContentBlockForRead(params.entryId, params.blockIndex);
-                    if (!row) {
-                        throw new Error(params.blockIndex === undefined
-                            ? `Unknown transcript entry: ${params.entryId}`
-                            : `Unknown transcript content block: ${params.entryId}:${params.blockIndex}`);
-                    }
-                    const text = row.text;
-                    const slice = textSlice(text, offset, maxChars);
-                    store.clearLastError();
-                    const details = {
-                        entryId: params.entryId,
-                        ...(params.blockIndex === undefined ? {} : { blockIndex: params.blockIndex }),
-                        offset,
-                        maxChars,
-                        totalChars: text.length,
-                        text: slice,
-                        truncatedBefore: offset > 0,
-                        truncatedAfter: offset + maxChars < text.length,
-                        callCount,
-                    };
-                    const textResult = `Read ${slice.length} of ${text.length} characters from ${params.blockIndex === undefined ? params.entryId : `${params.entryId}:${params.blockIndex}`}. Keep reads small; increase offset for the next slice if needed.`;
-                    return createContextDeletionToolResult(textResult, details);
-                }
-                catch (error) {
-                    const message = formatErrorMessage(error);
-                    store.setLastError(message);
-                    const details = {
-                        entryId: params.entryId,
-                        ...(params.blockIndex === undefined ? {} : { blockIndex: params.blockIndex }),
-                        offset,
-                        maxChars,
-                        totalChars: 0,
-                        text: "",
-                        truncatedBefore: false,
-                        truncatedAfter: false,
-                        callCount,
-                        error: message,
-                    };
-                    return createContextDeletionToolResult(`Error reading transcript entry: ${message}`, details);
-                }
-            });
-        },
-    };
-    const budgetTool = {
-        ...CONTEXT_COMPACTION_BUDGET_TOOL,
-        label: "context compaction budget",
-        executionMode: "parallel",
-        async execute(_toolCallId) {
-            return store.transaction(() => {
-                const callCount = store.incrementCallCount();
-                store.clearLastError();
-                const details = createContextCompactionBudgetDetails(currentStats(), callCount, contextWindow, parameters);
-                const windowText = details.contextWindowBeforePercent !== undefined
-                    ? ` Context window fullness: ${details.contextWindowBeforePercent}% before selected deletions, ${details.contextWindowAfterPercent}% after selected deletions.`
-                    : " Context window size is unknown for this model, so fullness percentages are unavailable.";
-                const targetText = details.tokensToDeleteForTarget > 0
-                    ? ` Delete about ${details.tokensToDeleteForTarget} more token(s) to reach the ${details.targetReductionPercent}% reduction target.`
-                    : ` The selected deletions meet or exceed the ${details.targetReductionPercent}% reduction target.`;
-                return createContextDeletionToolResult(`Current selected deletions reduce context by ${details.currentReductionPercent}% (${details.deletedTokens} token(s)); tokens after selected deletions: ${details.currentTokensAfter}/${details.tokensBefore}.${windowText}${targetText} Keep maximizing useful retained context while aggressively removing low-value blocks.`, details);
-            });
-        },
-    };
-    return {
-        tool,
-        grepTool,
-        searchTool,
-        readEntryTool,
-        budgetTool,
-        tools: [tool, grepTool, searchTool, readEntryTool, budgetTool],
-        getDeletionRequest: () => deletionRequestFromTargets(readTargets()),
-        getValidatedResult: () => validatedResult,
-        getLastError: () => store.getLastError(),
-        getCallCount: () => store.getCallCount(),
-    };
-}
-function truncateForPrompt(text, maxChars) {
-    if (text.length <= maxChars)
-        return text;
-    return `${text.slice(0, maxChars)}\n[... ${text.length - maxChars} more characters omitted from context compaction prompt]`;
-}
-function transcriptEntryFilePayload(entry) {
-    return {
-        entryId: entry.entryId,
-        entryType: entry.entryType,
-        role: entry.role,
-        protected: entry.protected,
-        tokenEstimate: entry.tokenEstimate,
-        toolCallIds: entry.toolCallIds,
-        toolResultFor: entry.toolResultFor,
-        text: entry.text,
-        contentBlocks: entry.contentBlocks.map((block) => ({
-            blockIndex: block.blockIndex,
-            type: block.type,
-            protected: block.protected,
-            toolCallId: block.toolCallId,
-            tokenEstimate: block.tokenEstimate,
-            text: block.text,
-        })),
-    };
-}
-function writeContextCompactionTranscriptFile(transcript) {
-    const directory = mkdtempSync(join(tmpdir(), "atomic-context-transcript-"));
-    const path = join(directory, "transcript.jsonl");
-    const lines = transcript.entries
-        .filter((entry) => !isExcludedFromLlmContext(entry.message))
-        .map((entry) => JSON.stringify(transcriptEntryFilePayload(entry)));
-    writeFileSync(path, `${lines.join("\n")}\n`, "utf8");
-    return {
-        path,
-        cleanup: () => rmSync(directory, { recursive: true, force: true }),
-    };
-}
-function contextCompactionTranscriptManifest(transcript, transcriptFilePath) {
-    const eligibleEntries = transcript.entries.filter((entry) => !isExcludedFromLlmContext(entry.message));
-    const selectedEntryIds = new Set();
-    const selectedEntries = [];
-    const addEntry = (entry) => {
-        if (selectedEntryIds.has(entry.entryId) || selectedEntries.length >= CONTEXT_MANIFEST_MAX_ENTRIES)
-            return;
-        selectedEntryIds.add(entry.entryId);
-        selectedEntries.push(entry);
-    };
-    for (const entry of eligibleEntries.filter((entry) => entry.protected)) {
-        addEntry(entry);
-    }
-    for (const entry of [...eligibleEntries]
-        .filter((entry) => !entry.protected)
-        .sort((left, right) => right.tokenEstimate - left.tokenEstimate)) {
-        addEntry(entry);
-    }
-    selectedEntries.sort((left, right) => eligibleEntries.indexOf(left) - eligibleEntries.indexOf(right));
-    return {
-        transcriptFilePath,
-        transcriptFileFormat: "jsonl: one compactable transcript entry per line with full text and contentBlocks text",
-        totalEntries: eligibleEntries.length,
-        manifestEntries: selectedEntries.length,
-        omittedEntries: Math.max(0, eligibleEntries.length - selectedEntries.length),
-        tokensBefore: transcript.tokensBefore,
-        protectedEntryIds: transcript.protectedEntryIds,
-        entries: selectedEntries.map((entry) => ({
-            entryId: entry.entryId,
-            role: entry.role,
-            protected: entry.protected,
-            tokenEstimate: entry.tokenEstimate,
-            toolCallIds: entry.toolCallIds,
-            toolResultFor: entry.toolResultFor,
-            contentBlockCount: entry.contentBlocks.length,
-            contentBlocks: entry.contentBlocks.map((block) => ({
-                blockIndex: block.blockIndex,
-                type: block.type,
-                protected: block.protected,
-                toolCallId: block.toolCallId,
-                tokenEstimate: block.tokenEstimate,
-            })),
-            preview: truncateForPrompt(entry.text, CONTEXT_MANIFEST_PREVIEW_CHARS),
-        })),
-    };
-}
-function contextCompactionParametersPrompt(parameters) {
-    return `\n<compaction-parameters>\n${JSON.stringify({
-        compression_ratio: parameters.compression_ratio,
-        preserve_recent: parameters.preserve_recent,
-        query: parameters.query,
-        target_reduction_percent: contextCompactionTargetReductionPercent(parameters),
-    }, null, 2)}\n</compaction-parameters>`;
-}
-export function buildContextCompactionPrompt(transcript, transcriptFilePath = "<transcript file will be written during context compaction>", parameters = getTranscriptCompactionParameters(transcript)) {
-    return `${contextCompactionFixedPrompt(parameters)}${contextCompactionParametersPrompt(parameters)}\n\n<transcript-file>\n${transcriptFilePath}\n</transcript-file>\n\n<context-manifest>\n${JSON.stringify(contextCompactionTranscriptManifest(transcript, transcriptFilePath), null, 2)}\n</context-manifest>`;
-}
-function createContextCompactionAssistantMessage(model, content, stopReason, errorMessage) {
-    return {
-        role: "assistant",
-        content,
-        api: model.api,
-        provider: model.provider,
-        model: model.id,
-        usage: {
-            input: 0,
-            output: 0,
-            cacheRead: 0,
-            cacheWrite: 0,
-            totalTokens: 0,
-            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-        },
-        stopReason,
-        ...(errorMessage !== undefined ? { errorMessage } : {}),
-        timestamp: Date.now(),
-    };
-}
-function createContextCompactionStopStream(model, text) {
-    const stream = createAssistantMessageEventStream();
-    queueMicrotask(() => {
-        const message = createContextCompactionAssistantMessage(model, [{ type: "text", text }], "stop");
-        stream.push({ type: "done", reason: "stop", message });
-        stream.end(message);
-    });
-    return stream;
-}
-function isContextCompactionOverflowError(model, errorMessage) {
-    return isContextOverflow(createContextCompactionAssistantMessage(model, [], "error", errorMessage), model.contextWindow);
-}
-async function runContextDeletionAssistant(inputTranscript, model, apiKey, headers, signal, thinkingLevel = "off", parameters = getTranscriptCompactionParameters(inputTranscript)) {
-    const transcript = { ...inputTranscript, parameters };
-    const maxTokens = model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY;
-    if (signal?.aborted) {
-        throw new Error("Context compaction failed: Request was aborted");
-    }
-    const transcriptFile = writeContextCompactionTranscriptFile(transcript);
-    const promptMessage = {
-        role: "user",
-        content: [{ type: "text", text: buildContextCompactionPrompt(transcript, transcriptFile.path, parameters) }],
-        timestamp: Date.now(),
-    };
-    const deletionTool = createContextDeletionTool(transcript, { contextWindow: model.contextWindow, ...parameters });
-    const agent = new Agent({
-        initialState: {
-            systemPrompt: CONTEXT_COMPACTION_SYSTEM_PROMPT,
-            model,
-            thinkingLevel,
-            tools: deletionTool.tools,
-        },
-        toolExecution: "parallel",
-        streamFn: async (requestModel, context, streamOptions) => {
-            const currentResult = deletionTool.getValidatedResult();
-            if (contextCompactionTargetMet(currentResult, parameters)) {
-                return createContextCompactionStopStream(requestModel, `Reached the strict ${contextCompactionTargetLabel(parameters)} context-reduction requirement (${currentResult.stats.percentReduction}%); using the validated deletions recorded so far.`);
-            }
-            return streamSimple(requestModel, context, {
-                ...streamOptions,
-                maxTokens,
-                apiKey,
-                headers: headers ?? streamOptions?.headers,
-            });
-        },
-    });
-    let lastNudgedProgressKey;
-    const unsubscribeNudge = agent.subscribe((event, eventSignal) => {
-        if (event.type !== "turn_end" || signal?.aborted || eventSignal.aborted)
-            return;
-        if (event.message.role !== "assistant")
-            return;
-        if (event.message.stopReason === "error" || event.message.stopReason === "aborted")
-            return;
-        if (event.message.content.some((content) => content.type === "toolCall"))
-            return;
-        const currentResult = deletionTool.getValidatedResult();
-        if (contextCompactionTargetMet(currentResult, parameters))
-            return;
-        const progressKey = contextCompactionProgressKey(currentResult);
-        if (progressKey === lastNudgedProgressKey)
-            return;
-        lastNudgedProgressKey = progressKey;
-        agent.followUp(createContextCompactionTargetNudgeMessage(currentResult, parameters));
-    });
-    const abortOnSignal = () => agent.abort();
-    signal?.addEventListener("abort", abortOnSignal, { once: true });
-    try {
-        await agent.prompt(promptMessage);
-    }
-    catch (error) {
-        if (signal?.aborted) {
-            throw new Error("Context compaction failed: Request was aborted");
-        }
-        throw new Error(`Context compaction failed: ${formatCopilotProviderError(model.provider, formatErrorMessage(error))}`);
-    }
-    finally {
-        signal?.removeEventListener("abort", abortOnSignal);
-        unsubscribeNudge();
-        transcriptFile.cleanup();
-    }
-    if (signal?.aborted) {
-        throw new Error("Context compaction failed: Request was aborted");
-    }
-    if (agent.state.errorMessage) {
-        const formattedErrorMessage = formatCopilotProviderError(model.provider, agent.state.errorMessage);
-        if (isContextCompactionOverflowError(model, agent.state.errorMessage)) {
-            return {
-                validatedResult: deletionTool.getValidatedResult(),
-                lastToolError: deletionTool.getLastError(),
-                providerError: formattedErrorMessage === agent.state.errorMessage ? undefined : formattedErrorMessage,
-            };
-        }
-        throw new Error(`Context compaction failed: ${formattedErrorMessage}`);
-    }
-    if (deletionTool.getCallCount() === 0) {
-        throw new Error(`Context compaction did not call any transcript inspection, budget, or deletion tools (${CONTEXT_SEARCH_TRANSCRIPT_TOOL_NAME}, ${CONTEXT_READ_ENTRY_TOOL_NAME}, ${CONTEXT_COMPACTION_BUDGET_TOOL_NAME}, ${CONTEXT_DELETE_TOOL_NAME}, or ${CONTEXT_GREP_DELETE_TOOL_NAME})`);
-    }
-    return {
-        validatedResult: deletionTool.getValidatedResult(),
-        lastToolError: deletionTool.getLastError(),
-        providerError: undefined,
-    };
-}
-function hasMetContextCompactionTarget(run, parameters) {
-    return contextCompactionTargetMet(run.validatedResult, parameters);
-}
-function formatContextCompactionTargetFailureMessage(attempts, parameters) {
-    const targetLabel = contextCompactionTargetLabel(parameters);
-    if (attempts.length === 0) {
-        return `Context compaction did not meet the strict ${targetLabel} reduction requirement`;
-    }
-    const attemptDetails = attempts
-        .map((attempt) => {
-        const reduction = contextCompactionProgressPercent(attempt.validatedResult);
-        const deletionCount = attempt.validatedResult?.deletedTargets.length ?? 0;
-        const toolErrorText = attempt.lastToolError ? `; last deletion tool error: ${attempt.lastToolError}` : "";
-        const providerErrorText = attempt.providerError ? `; provider error: ${attempt.providerError}` : "";
-        return `attempt reached ${reduction}% with ${deletionCount} validated deletion target(s)${toolErrorText}${providerErrorText}`;
-    })
-        .join("; ");
-    return `Context compaction did not meet the strict ${targetLabel} reduction requirement; ${attemptDetails}`;
-}
-export async function contextCompact(preparation, model, apiKey, headers, signal, thinkingLevel = "off") {
-    const parameters = normalizeContextCompactionParameters(preparation.parameters ?? preparation.transcript.parameters, preparation.parameters?.query ?? preparation.transcript.parameters?.query ?? CONTEXT_COMPACTION_AUTO_QUERY);
-    const transcript = { ...preparation.transcript, parameters };
-    const attempts = [];
-    const standardRun = await runContextDeletionAssistant(transcript, model, apiKey, headers, signal, thinkingLevel, parameters);
-    if (hasMetContextCompactionTarget(standardRun, parameters))
-        return standardRun.validatedResult;
-    attempts.push({ ...standardRun });
-    throw new Error(formatContextCompactionTargetFailureMessage(attempts, parameters));
-}
+export { CONTEXT_COMPACTION_AUTO_QUERY, CONTEXT_COMPACTION_DEFAULT_COMPRESSION_RATIO, CONTEXT_COMPACTION_DEFAULT_PRESERVE_RECENT, CONTEXT_COMPACTION_PROMPT_VERSION, CONTEXT_COMPACTION_TARGET_REDUCTION_PERCENT, } from "./context-compaction-types.js";
+export { normalizeContextCompactionParameters } from "./context-compaction-strategy.js";
+export { autoDetectContextCompactionQuery, prepareContextCompaction, } from "./context-transcript-analysis.js";
+export { validateContextDeletionRequest } from "./context-deletion-application.js";
+export { createContextDeletionTool } from "./context-deletion-tools.js";
+export { buildContextCompactionPrompt } from "./context-compaction-prompt.js";
+export { contextCompact } from "./context-compaction-runner.js";
 //# sourceMappingURL=context-compaction.js.map