@code-yeongyu/senpi 2026.5.15 → 2026.5.18-2

package/dist/core/dynamic-prompt/verification.js

@@ -1,3 +1,42 @@
+export const TEST_DISCIPLINE_RULES = [
+    {
+        id: "deterministic-tests",
+        concern: "test-determinism",
+        directive: "When you read or edit test code, treat nondeterminism as a bug; tests must not pass by timing luck.",
+    },
+    {
+        id: "fixed-wait-ban",
+        concern: "async-test-orchestration",
+        directive: "Unless time itself is the behavior under test, fixed sleeps, polling delays, and wait-for-time patterns are forbidden.",
+    },
+    {
+        id: "event-timeout-pattern",
+        concern: "async-test-orchestration",
+        directive: "For async behavior, subscribe to the exact event or state change before triggering the action, then await that signal with a bounded timeout.",
+    },
+    {
+        id: "mock-contract-integrity",
+        concern: "mock-contracts",
+        directive: "Mocks must preserve the contract being asserted; do not isolate so heavily that the integration under test cannot fail.",
+    },
+    {
+        id: "prompt-behavior-coverage",
+        concern: "prompt-tests",
+        directive: "Prompt tests must assert behavior, decisions, structure, or parsed rule data rather than merely pinning an exact prompt sentence.",
+    },
+    {
+        id: "single-pass-runner",
+        concern: "test-runner",
+        directive: "Run the relevant test command once and make that pass reliable; for Bun test targets, bun test must pass in a single run.",
+    },
+];
+export function buildTestDisciplineSection() {
+    const lines = ["### Test Discipline"];
+    for (const rule of TEST_DISCIPLINE_RULES) {
+        lines.push(`- ${rule.directive}`);
+    }
+    return lines.join("\n");
+}
 export function buildVerificationSection() {
     return `## Verification
 
@@ -7,6 +46,8 @@ Tier the scope, never the rigor.
 - V2 — single-domain behavioral edits: diagnostics on changed files in parallel, related tests, one execution of the affected runnable entry point when one exists.
 - V3 — multi-file or cross-cutting work: diagnostics on every changed file, related tests, build, manual exercise of user-visible behavior through its real surface.
 
+${buildTestDisciplineSection()}
+
 "Should pass" is not verification. Reporting clean output without running the validator is a violation. Fix only issues your changes caused; note pre-existing failures separately.`;
 }
 //# sourceMappingURL=verification.js.map

package/dist/core/dynamic-prompt/verification.js.map

@@ -1 +1 @@
-{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../src/core/dynamic-prompt/verification.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,GAAW;IAClD,OAAO;;;;;;;;oLAQ4K,CAAC;AAAA,CACpL","sourcesContent":["export function buildVerificationSection(): string {\n\treturn `## Verification\n\nTier the scope, never the rigor.\n\n- V1 — single-file non-behavioral edits: diagnostics on that file. Done.\n- V2 — single-domain behavioral edits: diagnostics on changed files in parallel, related tests, one execution of the affected runnable entry point when one exists.\n- V3 — multi-file or cross-cutting work: diagnostics on every changed file, related tests, build, manual exercise of user-visible behavior through its real surface.\n\n\"Should pass\" is not verification. Reporting clean output without running the validator is a violation. Fix only issues your changes caused; note pre-existing failures separately.`;\n}\n"]}
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../src/core/dynamic-prompt/verification.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC;QACC,EAAE,EAAE,qBAAqB;QACzB,OAAO,EAAE,kBAAkB;QAC3B,SAAS,EAAE,qGAAqG;KAChH;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,OAAO,EAAE,0BAA0B;QACnC,SAAS,EACR,wHAAwH;KACzH;IACD;QACC,EAAE,EAAE,uBAAuB;QAC3B,OAAO,EAAE,0BAA0B;QACnC,SAAS,EACR,+IAA+I;KAChJ;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,OAAO,EAAE,gBAAgB;QACzB,SAAS,EACR,yHAAyH;KAC1H;IACD;QACC,EAAE,EAAE,0BAA0B;QAC9B,OAAO,EAAE,cAAc;QACvB,SAAS,EACR,mIAAmI;KACpI;IACD;QACC,EAAE,EAAE,oBAAoB;QACxB,OAAO,EAAE,aAAa;QACtB,SAAS,EACR,2HAA2H;KAC5H;CACgD,CAAC;AAEnD,MAAM,UAAU,0BAA0B,GAAW;IACpD,MAAM,KAAK,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACxB;AAED,MAAM,UAAU,wBAAwB,GAAW;IAClD,OAAO;;;;;;;;EAQN,0BAA0B,EAAE;;oLAEsJ,CAAC;AAAA,CACpL","sourcesContent":["export type TestDisciplineRule = {\n\tid:\n\t\t| \"deterministic-tests\"\n\t\t| \"fixed-wait-ban\"\n\t\t| \"event-timeout-pattern\"\n\t\t| \"mock-contract-integrity\"\n\t\t| \"prompt-behavior-coverage\"\n\t\t| \"single-pass-runner\";\n\tconcern: \"test-determinism\" | \"async-test-orchestration\" | \"mock-contracts\" | \"prompt-tests\" | \"test-runner\";\n\tdirective: string;\n};\n\nexport const TEST_DISCIPLINE_RULES = [\n\t{\n\t\tid: \"deterministic-tests\",\n\t\tconcern: \"test-determinism\",\n\t\tdirective: \"When you read or edit test code, treat nondeterminism as a bug; tests must not pass by timing luck.\",\n\t},\n\t{\n\t\tid: \"fixed-wait-ban\",\n\t\tconcern: \"async-test-orchestration\",\n\t\tdirective:\n\t\t\t\"Unless time itself is the behavior under test, fixed sleeps, polling delays, and wait-for-time patterns are forbidden.\",\n\t},\n\t{\n\t\tid: \"event-timeout-pattern\",\n\t\tconcern: \"async-test-orchestration\",\n\t\tdirective:\n\t\t\t\"For async behavior, subscribe to the exact event or state change before triggering the action, then await that signal with a bounded timeout.\",\n\t},\n\t{\n\t\tid: \"mock-contract-integrity\",\n\t\tconcern: \"mock-contracts\",\n\t\tdirective:\n\t\t\t\"Mocks must preserve the contract being asserted; do not isolate so heavily that the integration under test cannot fail.\",\n\t},\n\t{\n\t\tid: \"prompt-behavior-coverage\",\n\t\tconcern: \"prompt-tests\",\n\t\tdirective:\n\t\t\t\"Prompt tests must assert behavior, decisions, structure, or parsed rule data rather than merely pinning an exact prompt sentence.\",\n\t},\n\t{\n\t\tid: \"single-pass-runner\",\n\t\tconcern: \"test-runner\",\n\t\tdirective:\n\t\t\t\"Run the relevant test command once and make that pass reliable; for Bun test targets, bun test must pass in a single run.\",\n\t},\n] as const satisfies readonly TestDisciplineRule[];\n\nexport function buildTestDisciplineSection(): string {\n\tconst lines = [\"### Test Discipline\"];\n\tfor (const rule of TEST_DISCIPLINE_RULES) {\n\t\tlines.push(`- ${rule.directive}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function buildVerificationSection(): string {\n\treturn `## Verification\n\nTier the scope, never the rigor.\n\n- V1 — single-file non-behavioral edits: diagnostics on that file. Done.\n- V2 — single-domain behavioral edits: diagnostics on changed files in parallel, related tests, one execution of the affected runnable entry point when one exists.\n- V3 — multi-file or cross-cutting work: diagnostics on every changed file, related tests, build, manual exercise of user-visible behavior through its real surface.\n\n${buildTestDisciplineSection()}\n\n\"Should pass\" is not verification. Reporting clean output without running the validator is a violation. Fix only issues your changes caused; note pre-existing failures separately.`;\n}\n"]}

package/dist/core/extensions/builtin/compaction/context-reduction.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Deterministic, no-LLM context reductions applied before compaction summarization.
+ *
+ * Ported from plugsuits' `context-collapse` and `micro-compact` patterns and
+ * adapted to the senpi `AgentMessage` shape. Three independent transforms:
+ *
+ *  1. {@link collapseConsecutiveToolResults} — runs of same-kind read/grep/shell
+ *     tool result payloads are replaced with a single one-line label so the
+ *     summarizer pays for the shape, not for the bytes.
+ *  2. {@link microCompactAssistantText} — older long assistant text answers are
+ *     truncated and tagged with a `[response shrunk]` marker.
+ *  3. {@link clearOldToolResults} — keep the last N tool results in full, replace
+ *     older clearable tool result content with `[tool result cleared]`.
+ *
+ * Each transform is pure (`messages` in → new array out, no in-place mutation
+ * beyond freshly cloned messages) and returns aggregated token-savings stats.
+ *
+ * {@link reduceContextMessages} composes the three transforms in order.
+ */
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+export type CollapsedGroupKind = "read" | "search" | "shell";
+export interface CollapsedGroup {
+    type: CollapsedGroupKind;
+    count: number;
+    label: string;
+    originalTokens: number;
+    collapsedTokens: number;
+}
+export interface CollapseConsecutiveOptions {
+    minGroupSize?: number;
+    protectRecentMessages?: number;
+    readToolNames?: string[];
+    searchToolNames?: string[];
+    shellToolNames?: string[];
+}
+export interface CollapseConsecutiveResult {
+    messages: AgentMessage[];
+    groups: CollapsedGroup[];
+    tokensSaved: number;
+}
+export interface MicroCompactAssistantOptions {
+    protectRecentTokens?: number;
+    maxAssistantTextTokens?: number;
+    minSavingsTokens?: number;
+    replacementTemplate?: string;
+}
+export interface MicroCompactAssistantResult {
+    messages: AgentMessage[];
+    tokensSaved: number;
+    messagesModified: number;
+}
+export interface ClearOldToolResultsOptions {
+    keepRecent?: number;
+    clearableToolNames?: string[];
+    replacementText?: string;
+}
+export interface ClearOldToolResultsResult {
+    messages: AgentMessage[];
+    tokensSaved: number;
+    toolResultsCleared: number;
+}
+export interface ReduceContextOptions {
+    collapse?: false | CollapseConsecutiveOptions;
+    shrinkAssistant?: false | MicroCompactAssistantOptions;
+    clearToolResults?: false | ClearOldToolResultsOptions;
+}
+export interface ReduceContextResult {
+    messages: AgentMessage[];
+    tokensSaved: number;
+    groupsCollapsed: number;
+    messagesShrunk: number;
+    toolResultsCleared: number;
+}
+/**
+ * Default options passed to {@link reduceContextMessages} when the builtin
+ * compaction extension's `context` hook decides to run a reduction pass.
+ *
+ * Each value is chosen to be strictly more conservative than the corresponding
+ * plugsuits default — protect more of the recent tail, raise the per-message
+ * shrink threshold, and keep more recent tool results intact — so a single
+ * shared default is safe to apply across normal coding sessions without making
+ * targeted reductions less effective.
+ */
+export declare const BUILTIN_CONTEXT_REDUCTION_OPTIONS: ReduceContextOptions;
+export declare const BUILTIN_CONTEXT_REDUCTION_GATE_RATIO = 0.5;
+export interface ShouldApplyContextReductionInput {
+    usageTokens: number | null;
+    contextWindow: number;
+    gateRatio?: number;
+    isProviderNativeCompactionPath?: boolean;
+}
+export declare function shouldApplyContextReduction(input: ShouldApplyContextReductionInput): boolean;
+export declare function collapseConsecutiveToolResults(messages: AgentMessage[], options?: CollapseConsecutiveOptions): CollapseConsecutiveResult;
+export declare function microCompactAssistantText(messages: AgentMessage[], options?: MicroCompactAssistantOptions): MicroCompactAssistantResult;
+export declare function clearOldToolResults(messages: AgentMessage[], options?: ClearOldToolResultsOptions): ClearOldToolResultsResult;
+export declare function reduceContextMessages(messages: AgentMessage[], options?: ReduceContextOptions): ReduceContextResult;
+//# sourceMappingURL=context-reduction.d.ts.map

package/dist/core/extensions/builtin/compaction/context-reduction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-reduction.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/context-reduction.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Deterministic, no-LLM context reductions applied before compaction summarization.\n *\n * Ported from plugsuits' `context-collapse` and `micro-compact` patterns and\n * adapted to the senpi `AgentMessage` shape. Three independent transforms:\n *\n *  1. {@link collapseConsecutiveToolResults} — runs of same-kind read/grep/shell\n *     tool result payloads are replaced with a single one-line label so the\n *     summarizer pays for the shape, not for the bytes.\n *  2. {@link microCompactAssistantText} — older long assistant text answers are\n *     truncated and tagged with a `[response shrunk]` marker.\n *  3. {@link clearOldToolResults} — keep the last N tool results in full, replace\n *     older clearable tool result content with `[tool result cleared]`.\n *\n * Each transform is pure (`messages` in → new array out, no in-place mutation\n * beyond freshly cloned messages) and returns aggregated token-savings stats.\n *\n * {@link reduceContextMessages} composes the three transforms in order.\n */\n\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { AssistantMessage, ImageContent, TextContent, ToolResultMessage } from \"@earendil-works/pi-ai\";\n\nconst DEFAULT_READ_TOOL_NAMES = [\"read\", \"Read\", \"read_file\"];\nconst DEFAULT_SEARCH_TOOL_NAMES = [\"grep\", \"Grep\", \"glob\", \"Glob\"];\nconst DEFAULT_SHELL_TOOL_NAMES = [\"bash\", \"Bash\", \"shell\", \"shell_execute\"];\nconst DEFAULT_CLEARABLE_TOOL_NAMES = [\n\t\"read\",\n\t\"Read\",\n\t\"read_file\",\n\t\"write\",\n\t\"Write\",\n\t\"edit\",\n\t\"Edit\",\n\t\"grep\",\n\t\"Grep\",\n\t\"glob\",\n\t\"Glob\",\n\t\"bash\",\n\t\"Bash\",\n\t\"shell\",\n];\n\nconst DEFAULT_MIN_GROUP_SIZE = 2;\nconst DEFAULT_PROTECT_RECENT_MESSAGES = 5;\nconst DEFAULT_PROTECT_RECENT_TOKENS = 2000;\nconst DEFAULT_MAX_ASSISTANT_TEXT_TOKENS = 500;\nconst DEFAULT_MIN_SAVINGS_TOKENS = 100;\nconst DEFAULT_KEEP_RECENT_TOOL_RESULTS = 3;\nconst DEFAULT_CLEARED_PLACEHOLDER = \"[tool result cleared]\";\nconst DEFAULT_REPLACEMENT_TEMPLATE = \"[response shrunk — {original_tokens} → {shrunk_tokens} tokens]\";\n\nconst MAX_HINTS_IN_LABEL = 5;\nconst MAX_HINT_LENGTH = 80;\nconst SHRUNK_RESPONSE_RATIO = 0.3;\n\nexport type CollapsedGroupKind = \"read\" | \"search\" | \"shell\";\n\nexport interface CollapsedGroup {\n\ttype: CollapsedGroupKind;\n\tcount: number;\n\tlabel: string;\n\toriginalTokens: number;\n\tcollapsedTokens: number;\n}\n\nexport interface CollapseConsecutiveOptions {\n\tminGroupSize?: number;\n\tprotectRecentMessages?: number;\n\treadToolNames?: string[];\n\tsearchToolNames?: string[];\n\tshellToolNames?: string[];\n}\n\nexport interface CollapseConsecutiveResult {\n\tmessages: AgentMessage[];\n\tgroups: CollapsedGroup[];\n\ttokensSaved: number;\n}\n\nexport interface MicroCompactAssistantOptions {\n\tprotectRecentTokens?: number;\n\tmaxAssistantTextTokens?: number;\n\tminSavingsTokens?: number;\n\treplacementTemplate?: string;\n}\n\nexport interface MicroCompactAssistantResult {\n\tmessages: AgentMessage[];\n\ttokensSaved: number;\n\tmessagesModified: number;\n}\n\nexport interface ClearOldToolResultsOptions {\n\tkeepRecent?: number;\n\tclearableToolNames?: string[];\n\treplacementText?: string;\n}\n\nexport interface ClearOldToolResultsResult {\n\tmessages: AgentMessage[];\n\ttokensSaved: number;\n\ttoolResultsCleared: number;\n}\n\nexport interface ReduceContextOptions {\n\tcollapse?: false | CollapseConsecutiveOptions;\n\tshrinkAssistant?: false | MicroCompactAssistantOptions;\n\tclearToolResults?: false | ClearOldToolResultsOptions;\n}\n\nexport interface ReduceContextResult {\n\tmessages: AgentMessage[];\n\ttokensSaved: number;\n\tgroupsCollapsed: number;\n\tmessagesShrunk: number;\n\ttoolResultsCleared: number;\n}\n\n/**\n * Default options passed to {@link reduceContextMessages} when the builtin\n * compaction extension's `context` hook decides to run a reduction pass.\n *\n * Each value is chosen to be strictly more conservative than the corresponding\n * plugsuits default — protect more of the recent tail, raise the per-message\n * shrink threshold, and keep more recent tool results intact — so a single\n * shared default is safe to apply across normal coding sessions without making\n * targeted reductions less effective.\n */\nexport const BUILTIN_CONTEXT_REDUCTION_OPTIONS: ReduceContextOptions = {\n\tcollapse: {\n\t\tminGroupSize: DEFAULT_MIN_GROUP_SIZE,\n\t\tprotectRecentMessages: DEFAULT_PROTECT_RECENT_MESSAGES,\n\t},\n\tshrinkAssistant: {\n\t\tprotectRecentTokens: 3000,\n\t\tmaxAssistantTextTokens: 800,\n\t\tminSavingsTokens: DEFAULT_MIN_SAVINGS_TOKENS,\n\t},\n\tclearToolResults: {\n\t\tkeepRecent: 6,\n\t},\n};\n\nexport const BUILTIN_CONTEXT_REDUCTION_GATE_RATIO = 0.5;\n\nexport interface ShouldApplyContextReductionInput {\n\tusageTokens: number | null;\n\tcontextWindow: number;\n\tgateRatio?: number;\n\tisProviderNativeCompactionPath?: boolean;\n}\n\nexport function shouldApplyContextReduction(input: ShouldApplyContextReductionInput): boolean {\n\tconst gate = input.gateRatio ?? BUILTIN_CONTEXT_REDUCTION_GATE_RATIO;\n\tif (input.isProviderNativeCompactionPath === true) return false;\n\tif (input.usageTokens === null) return false;\n\tif (input.contextWindow <= 0) return false;\n\treturn input.usageTokens >= input.contextWindow * gate;\n}\n\nfunction approxTextTokens(text: string): number {\n\tif (!text) return 0;\n\treturn Math.ceil(text.length / 4);\n}\n\nfunction extractContentText(content: (TextContent | ImageContent)[] | undefined): string {\n\tif (!Array.isArray(content)) return \"\";\n\tlet out = \"\";\n\tfor (const part of content) {\n\t\tif (part.type === \"text\") out += part.text;\n\t}\n\treturn out;\n}\n\nfunction extractMessageText(message: AgentMessage): string {\n\tif (message.role === \"user\") {\n\t\tif (typeof message.content === \"string\") return message.content;\n\t\treturn extractContentText(message.content as (TextContent | ImageContent)[]);\n\t}\n\tif (message.role === \"assistant\") {\n\t\tlet out = \"\";\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type === \"text\") out += block.text;\n\t\t\telse if (block.type === \"toolCall\") out += `${block.name} ${JSON.stringify(block.arguments)}`;\n\t\t}\n\t\treturn out;\n\t}\n\tif (message.role === \"toolResult\") {\n\t\treturn extractContentText(message.content);\n\t}\n\treturn \"\";\n}\n\ninterface ToolNameSets {\n\tread: Set<string>;\n\tsearch: Set<string>;\n\tshell: Set<string>;\n}\n\nfunction classifyTool(name: string, sets: ToolNameSets): CollapsedGroupKind | null {\n\tif (sets.read.has(name)) return \"read\";\n\tif (sets.search.has(name)) return \"search\";\n\tif (sets.shell.has(name)) return \"shell\";\n\treturn null;\n}\n\ninterface FirstToolCall {\n\tid: string;\n\tname: string;\n\targs: Record<string, unknown>;\n}\n\nfunction getFirstToolCallFromAssistant(message: AgentMessage): FirstToolCall | null {\n\tif (message.role !== \"assistant\") return null;\n\tfor (const block of message.content) {\n\t\tif (block.type === \"toolCall\") {\n\t\t\treturn { id: block.id, name: block.name, args: block.arguments as Record<string, unknown> };\n\t\t}\n\t}\n\treturn null;\n}\n\ninterface CollapsibleOperation {\n\ttype: CollapsedGroupKind;\n\ttoolName: string;\n\tassistantIndex: number;\n\tresultIndex: number;\n\thint?: string;\n\tresultText: string;\n}\n\nfunction truncateHint(value: string): string {\n\tif (value.length <= MAX_HINT_LENGTH) return value;\n\treturn `${value.slice(0, MAX_HINT_LENGTH - 1)}…`;\n}\n\nfunction extractHint(type: CollapsedGroupKind, args: Record<string, unknown>): string | undefined {\n\tif (type === \"read\") {\n\t\tconst path = args.path ?? args.file_path ?? args.filePath;\n\t\tif (typeof path === \"string\" && path.length > 0) return truncateHint(path);\n\t\treturn undefined;\n\t}\n\tif (type === \"search\") {\n\t\tconst path = typeof args.path === \"string\" ? args.path : undefined;\n\t\tconst pattern =\n\t\t\t(typeof args.pattern === \"string\" && args.pattern) ||\n\t\t\t(typeof args.glob === \"string\" && args.glob) ||\n\t\t\t(typeof args.query === \"string\" && args.query) ||\n\t\t\tundefined;\n\t\tif (path && pattern) return truncateHint(`${path}:${pattern}`);\n\t\tif (path) return truncateHint(path);\n\t\tif (pattern) return truncateHint(pattern as string);\n\t\treturn undefined;\n\t}\n\tconst command = args.command ?? args.cmd;\n\tif (typeof command === \"string\" && command.length > 0) return truncateHint(command);\n\treturn undefined;\n}\n\nfunction buildGroupLabel(type: CollapsedGroupKind, operations: CollapsibleOperation[]): string {\n\tconst hints: string[] = [];\n\tfor (const op of operations) {\n\t\tif (op.hint && hints.length < MAX_HINTS_IN_LABEL) hints.push(op.hint);\n\t}\n\tconst noun = type === \"read\" ? \"read results\" : type === \"search\" ? \"search results\" : \"shell results\";\n\tif (hints.length === 0) return `[${operations.length} ${noun}]`;\n\tconst more = operations.length - hints.length;\n\tconst moreSuffix = more > 0 ? `, and ${more} more` : \"\";\n\treturn `[${operations.length} ${noun}: ${hints.join(\", \")}${moreSuffix}]`;\n}\n\nfunction collectCollapsibleOperations(\n\tmessages: AgentMessage[],\n\tcollapseLimit: number,\n\tsets: ToolNameSets,\n): CollapsibleOperation[] {\n\tconst operations: CollapsibleOperation[] = [];\n\tlet i = 0;\n\twhile (i < collapseLimit) {\n\t\tconst assistant = messages[i];\n\t\tconst call = getFirstToolCallFromAssistant(assistant);\n\t\tif (!call) {\n\t\t\ti += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst next = messages[i + 1];\n\t\tconst resultInWindow = i + 1 < collapseLimit;\n\t\tif (!next || next.role !== \"toolResult\" || next.toolCallId !== call.id || !resultInWindow) {\n\t\t\ti += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst type = classifyTool(call.name, sets);\n\t\tif (!type) {\n\t\t\ti += 1;\n\t\t\tcontinue;\n\t\t}\n\t\toperations.push({\n\t\t\ttype,\n\t\t\ttoolName: call.name,\n\t\t\tassistantIndex: i,\n\t\t\tresultIndex: i + 1,\n\t\t\thint: extractHint(type, call.args),\n\t\t\tresultText: extractContentText((next as ToolResultMessage).content),\n\t\t});\n\t\ti += 2;\n\t}\n\treturn operations;\n}\n\nfunction groupConsecutiveOperations(operations: CollapsibleOperation[]): CollapsibleOperation[][] {\n\tconst groups: CollapsibleOperation[][] = [];\n\tlet current: CollapsibleOperation[] = [];\n\tfor (const op of operations) {\n\t\tif (current.length === 0) {\n\t\t\tcurrent.push(op);\n\t\t\tcontinue;\n\t\t}\n\t\tconst prev = current[current.length - 1];\n\t\tif (op.type === prev.type && op.assistantIndex === prev.resultIndex + 1) {\n\t\t\tcurrent.push(op);\n\t\t\tcontinue;\n\t\t}\n\t\tgroups.push(current);\n\t\tcurrent = [op];\n\t}\n\tif (current.length > 0) groups.push(current);\n\treturn groups;\n}\n\nexport function collapseConsecutiveToolResults(\n\tmessages: AgentMessage[],\n\toptions: CollapseConsecutiveOptions = {},\n): CollapseConsecutiveResult {\n\tconst minGroupSize = Math.max(1, options.minGroupSize ?? DEFAULT_MIN_GROUP_SIZE);\n\tconst protectRecentMessages = Math.max(0, options.protectRecentMessages ?? DEFAULT_PROTECT_RECENT_MESSAGES);\n\tconst sets: ToolNameSets = {\n\t\tread: new Set(options.readToolNames ?? DEFAULT_READ_TOOL_NAMES),\n\t\tsearch: new Set(options.searchToolNames ?? DEFAULT_SEARCH_TOOL_NAMES),\n\t\tshell: new Set(options.shellToolNames ?? DEFAULT_SHELL_TOOL_NAMES),\n\t};\n\n\tconst collapseLimit = Math.max(0, messages.length - protectRecentMessages);\n\tconst operations = collectCollapsibleOperations(messages, collapseLimit, sets);\n\tconst operationGroups = groupConsecutiveOperations(operations);\n\n\tconst collapsedGroups: CollapsedGroup[] = [];\n\tconst nextMessages = messages.slice();\n\tlet tokensSaved = 0;\n\n\tfor (const group of operationGroups) {\n\t\tif (group.length < minGroupSize) continue;\n\t\tconst label = buildGroupLabel(group[0].type, group);\n\t\tlet originalTokens = 0;\n\t\tlet collapsedTokens = 0;\n\t\tfor (const op of group) {\n\t\t\tconst original = approxTextTokens(op.resultText);\n\t\t\tconst collapsed = approxTextTokens(label);\n\t\t\toriginalTokens += original;\n\t\t\tcollapsedTokens += collapsed;\n\t\t\tconst result = nextMessages[op.resultIndex];\n\t\t\tif (result.role !== \"toolResult\") continue;\n\t\t\tconst images = result.content.filter((c): c is ImageContent => c.type === \"image\");\n\t\t\tnextMessages[op.resultIndex] = {\n\t\t\t\t...result,\n\t\t\t\tcontent: [{ type: \"text\", text: label } as TextContent, ...images],\n\t\t\t};\n\t\t}\n\t\ttokensSaved += Math.max(0, originalTokens - collapsedTokens);\n\t\tcollapsedGroups.push({\n\t\t\ttype: group[0].type,\n\t\t\tcount: group.length,\n\t\t\tlabel,\n\t\t\toriginalTokens,\n\t\t\tcollapsedTokens,\n\t\t});\n\t}\n\n\treturn { messages: nextMessages, groups: collapsedGroups, tokensSaved };\n}\n\nfunction resolveProtectedFromIndex(messages: AgentMessage[], protectRecentTokens: number): number {\n\tif (messages.length === 0) return 0;\n\tlet recentTokens = 0;\n\tfor (let i = messages.length - 1; i >= 0; i--) {\n\t\tconst tokens = approxTextTokens(extractMessageText(messages[i]));\n\t\tif (recentTokens + tokens > protectRecentTokens) return i + 1;\n\t\trecentTokens += tokens;\n\t\tif (i === 0) return 0;\n\t}\n\treturn messages.length;\n}\n\nfunction renderReplacementText(template: string, originalTokens: number, shrunkTokens: number): string {\n\treturn template\n\t\t.split(\"{original_tokens}\")\n\t\t.join(String(originalTokens))\n\t\t.split(\"{shrunk_tokens}\")\n\t\t.join(String(shrunkTokens));\n}\n\nfunction buildShrunkText(\n\toriginalText: string,\n\toriginalTokens: number,\n\tmaxAssistantTextTokens: number,\n\ttemplate: string,\n): { text: string; tokens: number } {\n\tconst targetTextTokens = Math.max(1, Math.floor(maxAssistantTextTokens * SHRUNK_RESPONSE_RATIO));\n\tconst ratio = originalTokens > 0 ? targetTextTokens / originalTokens : 0;\n\tconst targetChars = Math.max(0, Math.floor(originalText.length * ratio));\n\tconst truncatedText = originalText.slice(0, targetChars);\n\tlet shrunkTokens = 0;\n\tlet shrunkText = \"\";\n\tfor (let iteration = 0; iteration < 5; iteration += 1) {\n\t\tconst replacement = renderReplacementText(template, originalTokens, shrunkTokens);\n\t\tconst candidate = truncatedText.length > 0 ? `${truncatedText}\\n\\n${replacement}` : replacement;\n\t\tconst tokens = approxTextTokens(candidate);\n\t\tshrunkText = candidate;\n\t\tif (tokens === shrunkTokens) return { text: candidate, tokens };\n\t\tshrunkTokens = tokens;\n\t}\n\treturn { text: shrunkText, tokens: approxTextTokens(shrunkText) };\n}\n\nexport function microCompactAssistantText(\n\tmessages: AgentMessage[],\n\toptions: MicroCompactAssistantOptions = {},\n): MicroCompactAssistantResult {\n\tconst protectRecentTokens = Math.max(0, options.protectRecentTokens ?? DEFAULT_PROTECT_RECENT_TOKENS);\n\tconst maxAssistantTextTokens = Math.max(0, options.maxAssistantTextTokens ?? DEFAULT_MAX_ASSISTANT_TEXT_TOKENS);\n\tconst minSavingsTokens = Math.max(0, options.minSavingsTokens ?? DEFAULT_MIN_SAVINGS_TOKENS);\n\tconst template = options.replacementTemplate ?? DEFAULT_REPLACEMENT_TEMPLATE;\n\n\tconst protectedFromIndex = resolveProtectedFromIndex(messages, protectRecentTokens);\n\tconst result = messages.slice();\n\tlet messagesModified = 0;\n\tlet tokensSaved = 0;\n\n\tfor (let i = 0; i < protectedFromIndex; i += 1) {\n\t\tconst msg = result[i];\n\t\tif (msg.role !== \"assistant\") continue;\n\t\tconst assistant = msg as AssistantMessage;\n\t\tconst allText = assistant.content.length > 0 && assistant.content.every((c) => c.type === \"text\");\n\t\tif (!allText) continue;\n\t\tconst originalText = assistant.content.map((c) => (c.type === \"text\" ? c.text : \"\")).join(\"\\n\");\n\t\tconst originalTokens = approxTextTokens(originalText);\n\t\tif (originalTokens <= maxAssistantTextTokens) continue;\n\t\tconst shrunk = buildShrunkText(originalText, originalTokens, maxAssistantTextTokens, template);\n\t\tconst saved = originalTokens - shrunk.tokens;\n\t\tif (saved < minSavingsTokens) continue;\n\t\tresult[i] = {\n\t\t\t...assistant,\n\t\t\tcontent: [{ type: \"text\", text: shrunk.text } as TextContent],\n\t\t};\n\t\ttokensSaved += saved;\n\t\tmessagesModified += 1;\n\t}\n\n\treturn { messages: result, tokensSaved, messagesModified };\n}\n\nexport function clearOldToolResults(\n\tmessages: AgentMessage[],\n\toptions: ClearOldToolResultsOptions = {},\n): ClearOldToolResultsResult {\n\tconst keepRecent = Math.max(0, options.keepRecent ?? DEFAULT_KEEP_RECENT_TOOL_RESULTS);\n\tconst clearable = new Set(options.clearableToolNames ?? DEFAULT_CLEARABLE_TOOL_NAMES);\n\tconst replacementText = options.replacementText ?? DEFAULT_CLEARED_PLACEHOLDER;\n\n\tconst clearableIndices: number[] = [];\n\tfor (let i = 0; i < messages.length; i += 1) {\n\t\tconst msg = messages[i];\n\t\tif (msg.role === \"toolResult\" && clearable.has(msg.toolName)) {\n\t\t\tclearableIndices.push(i);\n\t\t}\n\t}\n\n\tconst clearUntil = Math.max(0, clearableIndices.length - keepRecent);\n\tif (clearUntil === 0) {\n\t\treturn { messages: messages.slice(), tokensSaved: 0, toolResultsCleared: 0 };\n\t}\n\n\tconst result = messages.slice();\n\tlet tokensSaved = 0;\n\tlet toolResultsCleared = 0;\n\tconst replacementTokens = approxTextTokens(replacementText);\n\n\tfor (let k = 0; k < clearUntil; k += 1) {\n\t\tconst idx = clearableIndices[k];\n\t\tconst msg = result[idx];\n\t\tif (msg.role !== \"toolResult\") continue;\n\t\tconst original = msg as ToolResultMessage;\n\t\tconst originalText = extractContentText(original.content);\n\t\tconst originalTokens = approxTextTokens(originalText);\n\t\tconst images = original.content.filter((c): c is ImageContent => c.type === \"image\");\n\t\tresult[idx] = {\n\t\t\t...original,\n\t\t\tcontent: [{ type: \"text\", text: replacementText } as TextContent, ...images],\n\t\t};\n\t\tconst savings = originalTokens - replacementTokens;\n\t\tif (savings > 0) tokensSaved += savings;\n\t\ttoolResultsCleared += 1;\n\t}\n\n\treturn { messages: result, tokensSaved, toolResultsCleared };\n}\n\nexport function reduceContextMessages(\n\tmessages: AgentMessage[],\n\toptions: ReduceContextOptions = {},\n): ReduceContextResult {\n\tlet current = messages;\n\tlet tokensSaved = 0;\n\tlet groupsCollapsed = 0;\n\tlet messagesShrunk = 0;\n\tlet toolResultsCleared = 0;\n\n\tif (options.collapse !== false) {\n\t\tconst collapsed = collapseConsecutiveToolResults(current, options.collapse ?? undefined);\n\t\tcurrent = collapsed.messages;\n\t\ttokensSaved += collapsed.tokensSaved;\n\t\tgroupsCollapsed += collapsed.groups.length;\n\t}\n\tif (options.shrinkAssistant !== false) {\n\t\tconst shrunk = microCompactAssistantText(current, options.shrinkAssistant ?? undefined);\n\t\tcurrent = shrunk.messages;\n\t\ttokensSaved += shrunk.tokensSaved;\n\t\tmessagesShrunk += shrunk.messagesModified;\n\t}\n\tif (options.clearToolResults !== false) {\n\t\tconst cleared = clearOldToolResults(current, options.clearToolResults ?? undefined);\n\t\tcurrent = cleared.messages;\n\t\ttokensSaved += cleared.tokensSaved;\n\t\ttoolResultsCleared += cleared.toolResultsCleared;\n\t}\n\n\treturn { messages: current, tokensSaved, groupsCollapsed, messagesShrunk, toolResultsCleared };\n}\n"]}

package/dist/core/extensions/builtin/compaction/context-reduction.js

@@ -0,0 +1,420 @@
+/**
+ * Deterministic, no-LLM context reductions applied before compaction summarization.
+ *
+ * Ported from plugsuits' `context-collapse` and `micro-compact` patterns and
+ * adapted to the senpi `AgentMessage` shape. Three independent transforms:
+ *
+ *  1. {@link collapseConsecutiveToolResults} — runs of same-kind read/grep/shell
+ *     tool result payloads are replaced with a single one-line label so the
+ *     summarizer pays for the shape, not for the bytes.
+ *  2. {@link microCompactAssistantText} — older long assistant text answers are
+ *     truncated and tagged with a `[response shrunk]` marker.
+ *  3. {@link clearOldToolResults} — keep the last N tool results in full, replace
+ *     older clearable tool result content with `[tool result cleared]`.
+ *
+ * Each transform is pure (`messages` in → new array out, no in-place mutation
+ * beyond freshly cloned messages) and returns aggregated token-savings stats.
+ *
+ * {@link reduceContextMessages} composes the three transforms in order.
+ */
+const DEFAULT_READ_TOOL_NAMES = ["read", "Read", "read_file"];
+const DEFAULT_SEARCH_TOOL_NAMES = ["grep", "Grep", "glob", "Glob"];
+const DEFAULT_SHELL_TOOL_NAMES = ["bash", "Bash", "shell", "shell_execute"];
+const DEFAULT_CLEARABLE_TOOL_NAMES = [
+    "read",
+    "Read",
+    "read_file",
+    "write",
+    "Write",
+    "edit",
+    "Edit",
+    "grep",
+    "Grep",
+    "glob",
+    "Glob",
+    "bash",
+    "Bash",
+    "shell",
+];
+const DEFAULT_MIN_GROUP_SIZE = 2;
+const DEFAULT_PROTECT_RECENT_MESSAGES = 5;
+const DEFAULT_PROTECT_RECENT_TOKENS = 2000;
+const DEFAULT_MAX_ASSISTANT_TEXT_TOKENS = 500;
+const DEFAULT_MIN_SAVINGS_TOKENS = 100;
+const DEFAULT_KEEP_RECENT_TOOL_RESULTS = 3;
+const DEFAULT_CLEARED_PLACEHOLDER = "[tool result cleared]";
+const DEFAULT_REPLACEMENT_TEMPLATE = "[response shrunk — {original_tokens} → {shrunk_tokens} tokens]";
+const MAX_HINTS_IN_LABEL = 5;
+const MAX_HINT_LENGTH = 80;
+const SHRUNK_RESPONSE_RATIO = 0.3;
+/**
+ * Default options passed to {@link reduceContextMessages} when the builtin
+ * compaction extension's `context` hook decides to run a reduction pass.
+ *
+ * Each value is chosen to be strictly more conservative than the corresponding
+ * plugsuits default — protect more of the recent tail, raise the per-message
+ * shrink threshold, and keep more recent tool results intact — so a single
+ * shared default is safe to apply across normal coding sessions without making
+ * targeted reductions less effective.
+ */
+export const BUILTIN_CONTEXT_REDUCTION_OPTIONS = {
+    collapse: {
+        minGroupSize: DEFAULT_MIN_GROUP_SIZE,
+        protectRecentMessages: DEFAULT_PROTECT_RECENT_MESSAGES,
+    },
+    shrinkAssistant: {
+        protectRecentTokens: 3000,
+        maxAssistantTextTokens: 800,
+        minSavingsTokens: DEFAULT_MIN_SAVINGS_TOKENS,
+    },
+    clearToolResults: {
+        keepRecent: 6,
+    },
+};
+export const BUILTIN_CONTEXT_REDUCTION_GATE_RATIO = 0.5;
+export function shouldApplyContextReduction(input) {
+    const gate = input.gateRatio ?? BUILTIN_CONTEXT_REDUCTION_GATE_RATIO;
+    if (input.isProviderNativeCompactionPath === true)
+        return false;
+    if (input.usageTokens === null)
+        return false;
+    if (input.contextWindow <= 0)
+        return false;
+    return input.usageTokens >= input.contextWindow * gate;
+}
+function approxTextTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+function extractContentText(content) {
+    if (!Array.isArray(content))
+        return "";
+    let out = "";
+    for (const part of content) {
+        if (part.type === "text")
+            out += part.text;
+    }
+    return out;
+}
+function extractMessageText(message) {
+    if (message.role === "user") {
+        if (typeof message.content === "string")
+            return message.content;
+        return extractContentText(message.content);
+    }
+    if (message.role === "assistant") {
+        let out = "";
+        for (const block of message.content) {
+            if (block.type === "text")
+                out += block.text;
+            else if (block.type === "toolCall")
+                out += `${block.name} ${JSON.stringify(block.arguments)}`;
+        }
+        return out;
+    }
+    if (message.role === "toolResult") {
+        return extractContentText(message.content);
+    }
+    return "";
+}
+function classifyTool(name, sets) {
+    if (sets.read.has(name))
+        return "read";
+    if (sets.search.has(name))
+        return "search";
+    if (sets.shell.has(name))
+        return "shell";
+    return null;
+}
+function getFirstToolCallFromAssistant(message) {
+    if (message.role !== "assistant")
+        return null;
+    for (const block of message.content) {
+        if (block.type === "toolCall") {
+            return { id: block.id, name: block.name, args: block.arguments };
+        }
+    }
+    return null;
+}
+function truncateHint(value) {
+    if (value.length <= MAX_HINT_LENGTH)
+        return value;
+    return `${value.slice(0, MAX_HINT_LENGTH - 1)}…`;
+}
+function extractHint(type, args) {
+    if (type === "read") {
+        const path = args.path ?? args.file_path ?? args.filePath;
+        if (typeof path === "string" && path.length > 0)
+            return truncateHint(path);
+        return undefined;
+    }
+    if (type === "search") {
+        const path = typeof args.path === "string" ? args.path : undefined;
+        const pattern = (typeof args.pattern === "string" && args.pattern) ||
+            (typeof args.glob === "string" && args.glob) ||
+            (typeof args.query === "string" && args.query) ||
+            undefined;
+        if (path && pattern)
+            return truncateHint(`${path}:${pattern}`);
+        if (path)
+            return truncateHint(path);
+        if (pattern)
+            return truncateHint(pattern);
+        return undefined;
+    }
+    const command = args.command ?? args.cmd;
+    if (typeof command === "string" && command.length > 0)
+        return truncateHint(command);
+    return undefined;
+}
+function buildGroupLabel(type, operations) {
+    const hints = [];
+    for (const op of operations) {
+        if (op.hint && hints.length < MAX_HINTS_IN_LABEL)
+            hints.push(op.hint);
+    }
+    const noun = type === "read" ? "read results" : type === "search" ? "search results" : "shell results";
+    if (hints.length === 0)
+        return `[${operations.length} ${noun}]`;
+    const more = operations.length - hints.length;
+    const moreSuffix = more > 0 ? `, and ${more} more` : "";
+    return `[${operations.length} ${noun}: ${hints.join(", ")}${moreSuffix}]`;
+}
+function collectCollapsibleOperations(messages, collapseLimit, sets) {
+    const operations = [];
+    let i = 0;
+    while (i < collapseLimit) {
+        const assistant = messages[i];
+        const call = getFirstToolCallFromAssistant(assistant);
+        if (!call) {
+            i += 1;
+            continue;
+        }
+        const next = messages[i + 1];
+        const resultInWindow = i + 1 < collapseLimit;
+        if (!next || next.role !== "toolResult" || next.toolCallId !== call.id || !resultInWindow) {
+            i += 1;
+            continue;
+        }
+        const type = classifyTool(call.name, sets);
+        if (!type) {
+            i += 1;
+            continue;
+        }
+        operations.push({
+            type,
+            toolName: call.name,
+            assistantIndex: i,
+            resultIndex: i + 1,
+            hint: extractHint(type, call.args),
+            resultText: extractContentText(next.content),
+        });
+        i += 2;
+    }
+    return operations;
+}
+function groupConsecutiveOperations(operations) {
+    const groups = [];
+    let current = [];
+    for (const op of operations) {
+        if (current.length === 0) {
+            current.push(op);
+            continue;
+        }
+        const prev = current[current.length - 1];
+        if (op.type === prev.type && op.assistantIndex === prev.resultIndex + 1) {
+            current.push(op);
+            continue;
+        }
+        groups.push(current);
+        current = [op];
+    }
+    if (current.length > 0)
+        groups.push(current);
+    return groups;
+}
+export function collapseConsecutiveToolResults(messages, options = {}) {
+    const minGroupSize = Math.max(1, options.minGroupSize ?? DEFAULT_MIN_GROUP_SIZE);
+    const protectRecentMessages = Math.max(0, options.protectRecentMessages ?? DEFAULT_PROTECT_RECENT_MESSAGES);
+    const sets = {
+        read: new Set(options.readToolNames ?? DEFAULT_READ_TOOL_NAMES),
+        search: new Set(options.searchToolNames ?? DEFAULT_SEARCH_TOOL_NAMES),
+        shell: new Set(options.shellToolNames ?? DEFAULT_SHELL_TOOL_NAMES),
+    };
+    const collapseLimit = Math.max(0, messages.length - protectRecentMessages);
+    const operations = collectCollapsibleOperations(messages, collapseLimit, sets);
+    const operationGroups = groupConsecutiveOperations(operations);
+    const collapsedGroups = [];
+    const nextMessages = messages.slice();
+    let tokensSaved = 0;
+    for (const group of operationGroups) {
+        if (group.length < minGroupSize)
+            continue;
+        const label = buildGroupLabel(group[0].type, group);
+        let originalTokens = 0;
+        let collapsedTokens = 0;
+        for (const op of group) {
+            const original = approxTextTokens(op.resultText);
+            const collapsed = approxTextTokens(label);
+            originalTokens += original;
+            collapsedTokens += collapsed;
+            const result = nextMessages[op.resultIndex];
+            if (result.role !== "toolResult")
+                continue;
+            const images = result.content.filter((c) => c.type === "image");
+            nextMessages[op.resultIndex] = {
+                ...result,
+                content: [{ type: "text", text: label }, ...images],
+            };
+        }
+        tokensSaved += Math.max(0, originalTokens - collapsedTokens);
+        collapsedGroups.push({
+            type: group[0].type,
+            count: group.length,
+            label,
+            originalTokens,
+            collapsedTokens,
+        });
+    }
+    return { messages: nextMessages, groups: collapsedGroups, tokensSaved };
+}
+function resolveProtectedFromIndex(messages, protectRecentTokens) {
+    if (messages.length === 0)
+        return 0;
+    let recentTokens = 0;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const tokens = approxTextTokens(extractMessageText(messages[i]));
+        if (recentTokens + tokens > protectRecentTokens)
+            return i + 1;
+        recentTokens += tokens;
+        if (i === 0)
+            return 0;
+    }
+    return messages.length;
+}
+function renderReplacementText(template, originalTokens, shrunkTokens) {
+    return template
+        .split("{original_tokens}")
+        .join(String(originalTokens))
+        .split("{shrunk_tokens}")
+        .join(String(shrunkTokens));
+}
+function buildShrunkText(originalText, originalTokens, maxAssistantTextTokens, template) {
+    const targetTextTokens = Math.max(1, Math.floor(maxAssistantTextTokens * SHRUNK_RESPONSE_RATIO));
+    const ratio = originalTokens > 0 ? targetTextTokens / originalTokens : 0;
+    const targetChars = Math.max(0, Math.floor(originalText.length * ratio));
+    const truncatedText = originalText.slice(0, targetChars);
+    let shrunkTokens = 0;
+    let shrunkText = "";
+    for (let iteration = 0; iteration < 5; iteration += 1) {
+        const replacement = renderReplacementText(template, originalTokens, shrunkTokens);
+        const candidate = truncatedText.length > 0 ? `${truncatedText}\n\n${replacement}` : replacement;
+        const tokens = approxTextTokens(candidate);
+        shrunkText = candidate;
+        if (tokens === shrunkTokens)
+            return { text: candidate, tokens };
+        shrunkTokens = tokens;
+    }
+    return { text: shrunkText, tokens: approxTextTokens(shrunkText) };
+}
+export function microCompactAssistantText(messages, options = {}) {
+    const protectRecentTokens = Math.max(0, options.protectRecentTokens ?? DEFAULT_PROTECT_RECENT_TOKENS);
+    const maxAssistantTextTokens = Math.max(0, options.maxAssistantTextTokens ?? DEFAULT_MAX_ASSISTANT_TEXT_TOKENS);
+    const minSavingsTokens = Math.max(0, options.minSavingsTokens ?? DEFAULT_MIN_SAVINGS_TOKENS);
+    const template = options.replacementTemplate ?? DEFAULT_REPLACEMENT_TEMPLATE;
+    const protectedFromIndex = resolveProtectedFromIndex(messages, protectRecentTokens);
+    const result = messages.slice();
+    let messagesModified = 0;
+    let tokensSaved = 0;
+    for (let i = 0; i < protectedFromIndex; i += 1) {
+        const msg = result[i];
+        if (msg.role !== "assistant")
+            continue;
+        const assistant = msg;
+        const allText = assistant.content.length > 0 && assistant.content.every((c) => c.type === "text");
+        if (!allText)
+            continue;
+        const originalText = assistant.content.map((c) => (c.type === "text" ? c.text : "")).join("\n");
+        const originalTokens = approxTextTokens(originalText);
+        if (originalTokens <= maxAssistantTextTokens)
+            continue;
+        const shrunk = buildShrunkText(originalText, originalTokens, maxAssistantTextTokens, template);
+        const saved = originalTokens - shrunk.tokens;
+        if (saved < minSavingsTokens)
+            continue;
+        result[i] = {
+            ...assistant,
+            content: [{ type: "text", text: shrunk.text }],
+        };
+        tokensSaved += saved;
+        messagesModified += 1;
+    }
+    return { messages: result, tokensSaved, messagesModified };
+}
+export function clearOldToolResults(messages, options = {}) {
+    const keepRecent = Math.max(0, options.keepRecent ?? DEFAULT_KEEP_RECENT_TOOL_RESULTS);
+    const clearable = new Set(options.clearableToolNames ?? DEFAULT_CLEARABLE_TOOL_NAMES);
+    const replacementText = options.replacementText ?? DEFAULT_CLEARED_PLACEHOLDER;
+    const clearableIndices = [];
+    for (let i = 0; i < messages.length; i += 1) {
+        const msg = messages[i];
+        if (msg.role === "toolResult" && clearable.has(msg.toolName)) {
+            clearableIndices.push(i);
+        }
+    }
+    const clearUntil = Math.max(0, clearableIndices.length - keepRecent);
+    if (clearUntil === 0) {
+        return { messages: messages.slice(), tokensSaved: 0, toolResultsCleared: 0 };
+    }
+    const result = messages.slice();
+    let tokensSaved = 0;
+    let toolResultsCleared = 0;
+    const replacementTokens = approxTextTokens(replacementText);
+    for (let k = 0; k < clearUntil; k += 1) {
+        const idx = clearableIndices[k];
+        const msg = result[idx];
+        if (msg.role !== "toolResult")
+            continue;
+        const original = msg;
+        const originalText = extractContentText(original.content);
+        const originalTokens = approxTextTokens(originalText);
+        const images = original.content.filter((c) => c.type === "image");
+        result[idx] = {
+            ...original,
+            content: [{ type: "text", text: replacementText }, ...images],
+        };
+        const savings = originalTokens - replacementTokens;
+        if (savings > 0)
+            tokensSaved += savings;
+        toolResultsCleared += 1;
+    }
+    return { messages: result, tokensSaved, toolResultsCleared };
+}
+export function reduceContextMessages(messages, options = {}) {
+    let current = messages;
+    let tokensSaved = 0;
+    let groupsCollapsed = 0;
+    let messagesShrunk = 0;
+    let toolResultsCleared = 0;
+    if (options.collapse !== false) {
+        const collapsed = collapseConsecutiveToolResults(current, options.collapse ?? undefined);
+        current = collapsed.messages;
+        tokensSaved += collapsed.tokensSaved;
+        groupsCollapsed += collapsed.groups.length;
+    }
+    if (options.shrinkAssistant !== false) {
+        const shrunk = microCompactAssistantText(current, options.shrinkAssistant ?? undefined);
+        current = shrunk.messages;
+        tokensSaved += shrunk.tokensSaved;
+        messagesShrunk += shrunk.messagesModified;
+    }
+    if (options.clearToolResults !== false) {
+        const cleared = clearOldToolResults(current, options.clearToolResults ?? undefined);
+        current = cleared.messages;
+        tokensSaved += cleared.tokensSaved;
+        toolResultsCleared += cleared.toolResultsCleared;
+    }
+    return { messages: current, tokensSaved, groupsCollapsed, messagesShrunk, toolResultsCleared };
+}
+//# sourceMappingURL=context-reduction.js.map