@code-yeongyu/senpi 2026.5.14 → 2026.5.15-3

package/dist/core/dynamic-prompt/verification.d.ts

@@ -1,2 +1,33 @@
+export type TestDisciplineRule = {
+    id: "deterministic-tests" | "fixed-wait-ban" | "event-timeout-pattern" | "mock-contract-integrity" | "prompt-behavior-coverage" | "single-pass-runner";
+    concern: "test-determinism" | "async-test-orchestration" | "mock-contracts" | "prompt-tests" | "test-runner";
+    directive: string;
+};
+export declare const TEST_DISCIPLINE_RULES: readonly [{
+    readonly id: "deterministic-tests";
+    readonly concern: "test-determinism";
+    readonly directive: "When you read or edit test code, treat nondeterminism as a bug; tests must not pass by timing luck.";
+}, {
+    readonly id: "fixed-wait-ban";
+    readonly concern: "async-test-orchestration";
+    readonly directive: "Unless time itself is the behavior under test, fixed sleeps, polling delays, and wait-for-time patterns are forbidden.";
+}, {
+    readonly id: "event-timeout-pattern";
+    readonly concern: "async-test-orchestration";
+    readonly directive: "For async behavior, subscribe to the exact event or state change before triggering the action, then await that signal with a bounded timeout.";
+}, {
+    readonly id: "mock-contract-integrity";
+    readonly concern: "mock-contracts";
+    readonly directive: "Mocks must preserve the contract being asserted; do not isolate so heavily that the integration under test cannot fail.";
+}, {
+    readonly id: "prompt-behavior-coverage";
+    readonly concern: "prompt-tests";
+    readonly directive: "Prompt tests must assert behavior, decisions, structure, or parsed rule data rather than merely pinning an exact prompt sentence.";
+}, {
+    readonly id: "single-pass-runner";
+    readonly concern: "test-runner";
+    readonly 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 declare function buildTestDisciplineSection(): string;
 export declare function buildVerificationSection(): string;
 //# sourceMappingURL=verification.d.ts.map

package/dist/core/dynamic-prompt/verification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../src/core/dynamic-prompt/verification.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD","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.d.ts","sourceRoot":"","sources":["../../../src/core/dynamic-prompt/verification.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EACC,qBAAqB,GACrB,gBAAgB,GAChB,uBAAuB,GACvB,yBAAyB,GACzB,0BAA0B,GAC1B,oBAAoB,CAAC;IACxB,OAAO,EAAE,kBAAkB,GAAG,0BAA0B,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAC;IAC7G,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAoCgB,CAAC;AAEnD,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAYjD","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/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"]}