@code-yeongyu/senpi 2026.8.30 → 2026.9.2

package/dist/core/extensions/builtin/compaction/extension-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-wiring.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/extension-wiring.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ContextUsage, ExtensionContext, MessageEndEvent, SessionBeforeCompactEvent } from \"../../types.ts\";\nimport * as checkpointState from \"./checkpoint-state.ts\";\nimport type { SpeculativeCompactionResult, SpeculativeCompactionSnapshot } from \"./speculative.ts\";\n\nconst IMAGE_PROMPT_TOKEN_ESTIMATE = 1_200;\nconst MAX_OUTPUT_RESERVE_RATIO = 0.5;\n\nfunction approxTokens(text: string): number {\n\treturn Math.ceil(text.length / 4);\n}\n\nexport function estimatePendingPromptTokens(event: { prompt?: string; images?: readonly unknown[] }): number {\n\treturn approxTokens(event.prompt ?? \"\") + (event.images?.length ?? 0) * IMAGE_PROMPT_TOKEN_ESTIMATE;\n}\n\nexport function getPromptContextWindow(contextWindow: number, maxTokens: number | undefined): number {\n\tif (typeof maxTokens !== \"number\" || !Number.isFinite(maxTokens) || maxTokens <= 0 || contextWindow <= 0) {\n\t\treturn contextWindow;\n\t}\n\tconst outputReserve = Math.min(maxTokens, Math.floor(contextWindow * MAX_OUTPUT_RESERVE_RATIO));\n\treturn contextWindow - outputReserve;\n}\n\nexport function withAdditionalTokens(usage: ContextUsage, additionalTokens: number): ContextUsage {\n\tif (usage.tokens === null || additionalTokens <= 0) return usage;\n\tconst tokens = usage.tokens + additionalTokens;\n\treturn {\n\t\t...usage,\n\t\ttokens,\n\t\tpercent: usage.contextWindow > 0 ? (tokens / usage.contextWindow) * 100 : usage.percent,\n\t};\n}\n\nexport function isMonitorableMessageEvent(event: MessageEndEvent): event is MessageEndEvent & {\n\tmessage: AgentMessage & { content: Array<{ type: string; text?: string }> };\n} {\n\treturn \"content\" in event.message && Array.isArray(event.message.content);\n}\n\nexport function isAbortedAssistantMessage(event: { message: AgentMessage }): boolean {\n\treturn event.message.role === \"assistant\" && \"stopReason\" in event.message && event.message.stopReason === \"aborted\";\n}\n\nexport function isRequiredCompactionFallbackReason(reason: SessionBeforeCompactEvent[\"reason\"]): boolean {\n\treturn reason === \"threshold\" || reason === \"overflow\";\n}\n\nexport function recentCheckpoint(ctx: ExtensionContext): checkpointState.AgentCheckpoint | null {\n\tconst checkpoint = checkpointState.getLatestCheckpoint(ctx);\n\tif (!checkpoint?.timestamp) return null;\n\treturn Date.now() - checkpoint.timestamp <= 60_000 ? checkpoint : null;\n}\n\nfunction shouldEndFeedback(result: SpeculativeCompactionResult): boolean {\n\treturn !result.applied && result.reason !== \"rejected\";\n}\n\nexport function endCompactionFeedback(\n\tctx: ExtensionContext,\n\tsignal: AbortSignal | undefined,\n\tresult: SpeculativeCompactionResult,\n\tremoteFallbackReason?: string,\n): void {\n\tif (shouldEndFeedback(result)) {\n\t\t// Surface the concrete failure instead of the generic \"Compaction did not\n\t\t// apply\": the remote stage's reason (e.g. remote-compaction-timeout) and the\n\t\t// terminal local reason (unavailable / stale), so the decision log and TUI\n\t\t// show what actually happened. An aborted compaction renders \"Compaction\n\t\t// cancelled\" downstream and must not carry a failure message.\n\t\tconst localReason = result.applied ? undefined : result.reason;\n\t\tconst parts = [remoteFallbackReason, localReason].filter((part): part is string => Boolean(part));\n\t\tconst errorMessage =\n\t\t\tsignal?.aborted || parts.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: `Compaction did not apply: ${parts.join(\"; local fallback \")}`;\n\t\tctx.endCompaction?.({ reason: \"extension\", signal, aborted: signal?.aborted, errorMessage });\n\t}\n}\n\nexport function linkAbortSignal(source: AbortSignal | undefined, target: AbortController): () => void {\n\tif (!source) return () => {};\n\tif (source.aborted) {\n\t\ttarget.abort();\n\t\treturn () => {};\n\t}\n\tconst abort = () => target.abort();\n\tsource.addEventListener(\"abort\", abort, { once: true });\n\treturn () => source.removeEventListener(\"abort\", abort);\n}\n\nexport function createBlockingRemoteCompactionEvent(\n\tctx: ExtensionContext,\n\tsnapshot: SpeculativeCompactionSnapshot,\n\tcustomInstructions: string,\n\tsignal: AbortSignal,\n): SessionBeforeCompactEvent {\n\treturn {\n\t\ttype: \"session_before_compact\",\n\t\treason: \"extension\",\n\t\twillRetry: false,\n\t\trequestId: randomUUID(),\n\t\tpreparation: snapshot.preparation,\n\t\tbranchEntries: ctx.sessionManager.getBranch(),\n\t\tcustomInstructions,\n\t\tsignal,\n\t};\n}\n"]}

package/dist/core/extensions/builtin/compaction/idle-retry.d.ts

@@ -15,7 +15,7 @@ export interface IdleWarmupRetryDecision {
     readonly transient: boolean;
     readonly isIdle: boolean;
     readonly breakerTripped: boolean;
-    readonly stillOverThreshold: boolean;
+    readonly stillWarmEligible: boolean;
 }
 export declare function shouldRetryIdleWarmup(decision: IdleWarmupRetryDecision): boolean;
 //# sourceMappingURL=idle-retry.d.ts.map

package/dist/core/extensions/builtin/compaction/idle-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idle-retry.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAMhF"}
+{"version":3,"file":"idle-retry.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAMhF"}

package/dist/core/extensions/builtin/compaction/idle-retry.js

@@ -17,7 +17,7 @@ export function shouldRetryIdleWarmup(decision) {
         return false;
     if (decision.breakerTripped)
         return false;
-    if (!decision.stillOverThreshold)
+    if (!decision.stillWarmEligible)
         return false;
     return decision.attempt < MAX_IDLE_WARMUP_RETRIES;
 }

package/dist/core/extensions/builtin/compaction/idle-retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"idle-retry.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAUjD,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACtE,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,QAAQ,CAAC,OAAO,GAAG,uBAAuB,CAAC;AACnD,CAAC","sourcesContent":["/**\n * Retry policy for the idle compaction warm-up.\n *\n * The `agent_end` idle trigger only warms a speculative summary (#561 forbids\n * committing a durable boundary at idle). A transient summarization failure\n * used to leave a dead warm job for the whole idle period, forcing a fresh\n * blocking summarization onto the user's critical path at the next prompt.\n * While the session stays idle, a transient failure is retried a bounded\n * number of times with a fresh snapshot instead.\n */\n\nexport const MAX_IDLE_WARMUP_RETRIES = 2;\nexport const IDLE_WARMUP_RETRY_DELAY_MS = 15_000;\n\nexport interface IdleWarmupRetryDecision {\n\treadonly attempt: number;\n\treadonly transient: boolean;\n\treadonly isIdle: boolean;\n\treadonly breakerTripped: boolean;\n\treadonly stillOverThreshold: boolean;\n}\n\nexport function shouldRetryIdleWarmup(decision: IdleWarmupRetryDecision): boolean {\n\tif (!decision.transient) return false;\n\tif (!decision.isIdle) return false;\n\tif (decision.breakerTripped) return false;\n\tif (!decision.stillOverThreshold) return false;\n\treturn decision.attempt < MAX_IDLE_WARMUP_RETRIES;\n}\n"]}
+{"version":3,"file":"idle-retry.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAUjD,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACtE,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,QAAQ,CAAC,OAAO,GAAG,uBAAuB,CAAC;AACnD,CAAC","sourcesContent":["/**\n * Retry policy for the idle compaction warm-up.\n *\n * The `agent_end` idle trigger only warms a speculative summary (#561 forbids\n * committing a durable boundary at idle). A transient summarization failure\n * used to leave a dead warm job for the whole idle period, forcing a fresh\n * blocking summarization onto the user's critical path at the next prompt.\n * While the session stays idle, a transient failure is retried a bounded\n * number of times with a fresh snapshot instead.\n */\n\nexport const MAX_IDLE_WARMUP_RETRIES = 2;\nexport const IDLE_WARMUP_RETRY_DELAY_MS = 15_000;\n\nexport interface IdleWarmupRetryDecision {\n\treadonly attempt: number;\n\treadonly transient: boolean;\n\treadonly isIdle: boolean;\n\treadonly breakerTripped: boolean;\n\treadonly stillWarmEligible: boolean;\n}\n\nexport function shouldRetryIdleWarmup(decision: IdleWarmupRetryDecision): boolean {\n\tif (!decision.transient) return false;\n\tif (!decision.isIdle) return false;\n\tif (decision.breakerTripped) return false;\n\tif (!decision.stillWarmEligible) return false;\n\treturn decision.attempt < MAX_IDLE_WARMUP_RETRIES;\n}\n"]}

package/dist/core/extensions/builtin/compaction/idle.d.ts

@@ -13,4 +13,5 @@ export interface IdleCompactionDecision {
     mode: ExtensionMode;
 }
 export declare function shouldRunIdleCompaction(decision: IdleCompactionDecision): boolean;
+export declare function shouldWarmAtIdle(decision: IdleCompactionDecision): boolean;
 //# sourceMappingURL=idle.d.ts.map

package/dist/core/extensions/builtin/compaction/idle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,aAAa,CAAC;AAE5E,eAAO,MAAM,4BAA4B,2FACgD,CAAC;AAI1F,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CASjF"}
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,aAAa,CAAC;AAG5E,eAAO,MAAM,4BAA4B,2FACgD,CAAC;AAI1F,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;CACpB;AAaD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAGjF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAG1E"}

package/dist/core/extensions/builtin/compaction/idle.js

@@ -1,21 +1,32 @@
 import { shouldTriggerCompaction } from "./policy.js";
+import { WARM_GENERATION_FLOOR_RATIO } from "./speculation-lead.js";
 export const IDLE_COMPACTION_INSTRUCTIONS = "Proactively compact at idle before the next agent turn, while the user is not waiting.";
 const PERSISTENT_MODES = new Set(["tui", "rpc", "app-server"]);
-export function shouldRunIdleCompaction(decision) {
+function isIdleEligible(decision) {
     if (decision.willRetry)
         return false;
     if (decision.aborted)
         return false;
     if (!PERSISTENT_MODES.has(decision.mode))
         return false;
+    if (!decision.settings.enabled)
+        return false;
     if (decision.settings.idleCompactionEnabled === false)
         return false;
     if (decision.breakerTripped)
         return false;
     if (!decision.usage)
         return false;
-    if (decision.usage.tokens === null)
+    return decision.usage.tokens !== null;
+}
+export function shouldRunIdleCompaction(decision) {
+    if (!isIdleEligible(decision) || !decision.usage)
         return false;
     return shouldTriggerCompaction(decision.usage, decision.contextWindow, decision.settings, decision.lastYield);
 }
+export function shouldWarmAtIdle(decision) {
+    if (!isIdleEligible(decision) || !decision.usage || decision.usage.tokens === null)
+        return false;
+    return decision.usage.tokens >= decision.contextWindow * WARM_GENERATION_FLOOR_RATIO;
+}
 //# sourceMappingURL=idle.js.map

package/dist/core/extensions/builtin/compaction/idle.js.map

@@ -1 +1 @@
-{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,CAAC,MAAM,4BAA4B,GACxC,wFAAwF,CAAC;AAE1F,MAAM,gBAAgB,GAA+B,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;AAa3F,MAAM,UAAU,uBAAuB,CAAC,QAAgC;IACvE,IAAI,QAAQ,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,QAAQ,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC/G,CAAC","sourcesContent":["import type { CompactionSettings } from \"../../../compaction/index.ts\";\nimport type { ContextUsage, ExtensionMode } from \"../../types.ts\";\nimport { type CompactionYield, shouldTriggerCompaction } from \"./policy.ts\";\n\nexport const IDLE_COMPACTION_INSTRUCTIONS =\n\t\"Proactively compact at idle before the next agent turn, while the user is not waiting.\";\n\nconst PERSISTENT_MODES: ReadonlySet<ExtensionMode> = new Set([\"tui\", \"rpc\", \"app-server\"]);\n\nexport interface IdleCompactionDecision {\n\twillRetry: boolean;\n\taborted: boolean;\n\tsettings: CompactionSettings;\n\tusage: ContextUsage | undefined;\n\tcontextWindow: number;\n\tbreakerTripped: boolean;\n\tlastYield?: CompactionYield;\n\tmode: ExtensionMode;\n}\n\nexport function shouldRunIdleCompaction(decision: IdleCompactionDecision): boolean {\n\tif (decision.willRetry) return false;\n\tif (decision.aborted) return false;\n\tif (!PERSISTENT_MODES.has(decision.mode)) return false;\n\tif (decision.settings.idleCompactionEnabled === false) return false;\n\tif (decision.breakerTripped) return false;\n\tif (!decision.usage) return false;\n\tif (decision.usage.tokens === null) return false;\n\treturn shouldTriggerCompaction(decision.usage, decision.contextWindow, decision.settings, decision.lastYield);\n}\n"]}
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,4BAA4B,GACxC,wFAAwF,CAAC;AAE1F,MAAM,gBAAgB,GAA+B,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;AAa3F,SAAS,cAAc,CAAC,QAAgC;IACvD,IAAI,QAAQ,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,QAAQ,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgC;IACvE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgC;IAChE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjG,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,aAAa,GAAG,2BAA2B,CAAC;AACtF,CAAC","sourcesContent":["import type { CompactionSettings } from \"../../../compaction/index.ts\";\nimport type { ContextUsage, ExtensionMode } from \"../../types.ts\";\nimport { type CompactionYield, shouldTriggerCompaction } from \"./policy.ts\";\nimport { WARM_GENERATION_FLOOR_RATIO } from \"./speculation-lead.ts\";\n\nexport const IDLE_COMPACTION_INSTRUCTIONS =\n\t\"Proactively compact at idle before the next agent turn, while the user is not waiting.\";\n\nconst PERSISTENT_MODES: ReadonlySet<ExtensionMode> = new Set([\"tui\", \"rpc\", \"app-server\"]);\n\nexport interface IdleCompactionDecision {\n\twillRetry: boolean;\n\taborted: boolean;\n\tsettings: CompactionSettings;\n\tusage: ContextUsage | undefined;\n\tcontextWindow: number;\n\tbreakerTripped: boolean;\n\tlastYield?: CompactionYield;\n\tmode: ExtensionMode;\n}\n\nfunction isIdleEligible(decision: IdleCompactionDecision): boolean {\n\tif (decision.willRetry) return false;\n\tif (decision.aborted) return false;\n\tif (!PERSISTENT_MODES.has(decision.mode)) return false;\n\tif (!decision.settings.enabled) return false;\n\tif (decision.settings.idleCompactionEnabled === false) return false;\n\tif (decision.breakerTripped) return false;\n\tif (!decision.usage) return false;\n\treturn decision.usage.tokens !== null;\n}\n\nexport function shouldRunIdleCompaction(decision: IdleCompactionDecision): boolean {\n\tif (!isIdleEligible(decision) || !decision.usage) return false;\n\treturn shouldTriggerCompaction(decision.usage, decision.contextWindow, decision.settings, decision.lastYield);\n}\n\nexport function shouldWarmAtIdle(decision: IdleCompactionDecision): boolean {\n\tif (!isIdleEligible(decision) || !decision.usage || decision.usage.tokens === null) return false;\n\treturn decision.usage.tokens >= decision.contextWindow * WARM_GENERATION_FLOOR_RATIO;\n}\n"]}

package/dist/core/extensions/builtin/compaction/index.d.ts

@@ -1,5 +1,5 @@
 import type { ExtensionAPI } from "../../types.ts";
 import { type OpenAiRemoteCompactionDependencies } from "./openai-remote.ts";
-export declare function getPromptContextWindow(contextWindow: number, maxTokens: number | undefined): number;
+export { getPromptContextWindow } from "./extension-wiring.ts";
 export default function compactionExtension(pi: ExtensionAPI, remoteCompactionDependencies?: OpenAiRemoteCompactionDependencies): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/compaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEX,YAAY,EAIZ,MAAM,gBAAgB,CAAC;AA4BxB,OAAO,EAEN,KAAK,kCAAkC,EAIvC,MAAM,oBAAoB,CAAC;AAgD5B,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMnG;AAuFD,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAC1C,EAAE,EAAE,YAAY,EAChB,4BAA4B,GAAE,kCAAuC,GACnE,IAAI,CA+1BN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAoE,MAAM,gBAAgB,CAAC;AAyBrH,OAAO,EACN,KAAK,kCAAkC,EAIvC,MAAM,oBAAoB,CAAC;AAqC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AA2B/D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAC1C,EAAE,EAAE,YAAY,EAChB,4BAA4B,GAAE,kCAAuC,GACnE,IAAI,CAo6BN"}

package/dist/core/extensions/builtin/compaction/index.js

@@ -1,112 +1,34 @@
-import { randomUUID } from "node:crypto";
 import { createWarmAnchorSnapshot, isWarmSummaryAnchorValid } from "../../../compaction/warm-anchor.js";
-import { convertToLlm } from "../../../messages.js";
 import * as checkpointState from "./checkpoint-state.js";
 import * as breaker from "./circuit-breaker.js";
-import { BUILTIN_CONTEXT_REDUCTION_OPTIONS, reduceContextMessages, shouldApplyContextReduction, } from "./context-reduction.js";
+import { buildCompactionContext } from "./context-pipeline.js";
 import { createDegradationMonitorState, handleMessageEnd, handleTurnEnd, RECOVERY_INSTRUCTIONS, resetOnSessionCompact, } from "./degradation-monitor.js";
 import { classifyRequiredCompactionFallbackFailure, createRequiredCompactionFallback, } from "./deterministic-fallback.js";
 import * as idle from "./idle.js";
 import * as idleRetry from "./idle-retry.js";
 import { CLAUDE_SDK_OAUTH_COMPACT_ENTRY_TYPE, collectCompactBoundaryEntries, createCompactionLanePolicy, SDK_NATIVE_LANE_REJECTION_REASON, } from "./lane-policy.js";
 import { createCompactionLogger } from "./log.js";
-import { markOpenAiRemoteReplayBoundary, rewriteOpenAiPayloadWithRemoteCompaction, runOpenAiRemoteCompaction, SENPI_COMPACTION_EVENT, } from "./openai-remote.js";
+import { handleCompactionModelSelect } from "./model-selection.js";
+import { rewriteOpenAiPayloadWithRemoteCompaction, runOpenAiRemoteCompaction, SENPI_COMPACTION_EVENT, } from "./openai-remote.js";
 import { createOpenAiRemoteCompactionHeaders, isOpenAiRemoteCompactionModel, openAiRemoteCompactionOrigin, } from "./openai-remote-model.js";
+import { resolveBeforeAgentStartMessage, resolveCompactionGeometry, resolveIdleWarmAction, resolveReminderSystemPrompt, shouldDeferGraceBand, } from "./orchestration.js";
 import * as cap from "./per-turn-cap.js";
 import * as policy from "./policy.js";
-import { repairOrphanedToolResults } from "./repair-tool-pairs.js";
 import * as restoration from "./restoration-tracker.js";
-import { applyGeneratedCompaction, createEmergencyPruneLatch, createSpeculativeCompactionSnapshot, getPromptVariant, hardLimitEmergencyPrune, runExtensionCompaction, SummaryGenerationError, } from "./speculative.js";
+import { applyGeneratedCompaction, createEmergencyPruneLatch, createSpeculativeCompactionSnapshot, getPromptVariant, runExtensionCompaction, SummaryGenerationError, } from "./speculative.js";
+import { trackSpeculativeJob } from "./speculative-job.js";
 import { createInitialState, resetTurnCounter } from "./state.js";
 import { resolveInheritedTaskIntent } from "./task-intent.js";
 import * as todoBridge from "./todo-bridge.js";
+import { computeTokenBudgetReminder, createInitialReminderState, } from "./token-budget-reminder.js";
 import { isTransientSummarizationFailure } from "./transient-failure.js";
+export { getPromptContextWindow } from "./extension-wiring.js";
+import { createBlockingRemoteCompactionEvent, endCompactionFeedback, estimatePendingPromptTokens, getPromptContextWindow, isAbortedAssistantMessage, isMonitorableMessageEvent, isRequiredCompactionFallbackReason, linkAbortSignal, recentCheckpoint, withAdditionalTokens, } from "./extension-wiring.js";
 import { isIneffectiveCompaction } from "./yield.js";
 const DEFAULT_CONTEXT_WINDOW = 200_000;
 const EMERGENCY_COMPACTION_INSTRUCTIONS = "EMERGENCY: hard context limit reached. Produce an aggressive recovery summary that preserves current goal, constraints, files touched, tool outcomes, and exact next steps. Prefer concise factual state over transcript detail.";
 const PROACTIVE_COMPACTION_INSTRUCTIONS = "Proactively compact before the next agent turn.";
 const MAX_PENDING_METADATA = 8;
-const IMAGE_PROMPT_TOKEN_ESTIMATE = 1_200;
-const MAX_OUTPUT_RESERVE_RATIO = 0.5;
-function approxTokens(text) {
-    return Math.ceil(text.length / 4);
-}
-function estimatePendingPromptTokens(event) {
-    return approxTokens(event.prompt ?? "") + (event.images?.length ?? 0) * IMAGE_PROMPT_TOKEN_ESTIMATE;
-}
-export function getPromptContextWindow(contextWindow, maxTokens) {
-    if (typeof maxTokens !== "number" || !Number.isFinite(maxTokens) || maxTokens <= 0 || contextWindow <= 0) {
-        return contextWindow;
-    }
-    const outputReserve = Math.min(maxTokens, Math.floor(contextWindow * MAX_OUTPUT_RESERVE_RATIO));
-    return contextWindow - outputReserve;
-}
-function withAdditionalTokens(usage, additionalTokens) {
-    if (usage.tokens === null || additionalTokens <= 0)
-        return usage;
-    const tokens = usage.tokens + additionalTokens;
-    return {
-        ...usage,
-        tokens,
-        percent: usage.contextWindow > 0 ? (tokens / usage.contextWindow) * 100 : usage.percent,
-    };
-}
-function isMonitorableMessageEvent(event) {
-    return "content" in event.message && Array.isArray(event.message.content);
-}
-function isAbortedAssistantMessage(event) {
-    return event.message.role === "assistant" && "stopReason" in event.message && event.message.stopReason === "aborted";
-}
-function isRequiredCompactionFallbackReason(reason) {
-    return reason === "threshold" || reason === "overflow";
-}
-function recentCheckpoint(ctx) {
-    const checkpoint = checkpointState.getLatestCheckpoint(ctx);
-    if (!checkpoint?.timestamp)
-        return null;
-    return Date.now() - checkpoint.timestamp <= 60_000 ? checkpoint : null;
-}
-function shouldEndFeedback(result) {
-    return !result.applied && result.reason !== "rejected";
-}
-function endCompactionFeedback(ctx, signal, result, remoteFallbackReason) {
-    if (shouldEndFeedback(result)) {
-        // Surface the concrete failure instead of the generic "Compaction did not
-        // apply": the remote stage's reason (e.g. remote-compaction-timeout) and the
-        // terminal local reason (unavailable / stale), so the decision log and TUI
-        // show what actually happened. An aborted compaction renders "Compaction
-        // cancelled" downstream and must not carry a failure message.
-        const localReason = result.applied ? undefined : result.reason;
-        const parts = [remoteFallbackReason, localReason].filter((part) => Boolean(part));
-        const errorMessage = signal?.aborted || parts.length === 0
-            ? undefined
-            : `Compaction did not apply: ${parts.join("; local fallback ")}`;
-        ctx.endCompaction?.({ reason: "extension", signal, aborted: signal?.aborted, errorMessage });
-    }
-}
-function linkAbortSignal(source, target) {
-    if (!source)
-        return () => { };
-    if (source.aborted) {
-        target.abort();
-        return () => { };
-    }
-    const abort = () => target.abort();
-    source.addEventListener("abort", abort, { once: true });
-    return () => source.removeEventListener("abort", abort);
-}
-function createBlockingRemoteCompactionEvent(ctx, snapshot, customInstructions, signal) {
-    return {
-        type: "session_before_compact",
-        reason: "extension",
-        willRetry: false,
-        requestId: randomUUID(),
-        preparation: snapshot.preparation,
-        branchEntries: ctx.sessionManager.getBranch(),
-        customInstructions,
-        signal,
-    };
-}
 export default function compactionExtension(pi, remoteCompactionDependencies = {}) {
     let state = createInitialState();
     const lanePolicy = createCompactionLanePolicy();
@@ -116,6 +38,7 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
     const restorationState = state.restoration ?? restoration.createRestorationTrackerState();
     state = { ...state, restoration: restorationState };
     let speculativeGeneration = 0;
+    let reminderState = createInitialReminderState();
     let speculativeJob;
     const pendingMetadata = new Map();
     let logger;
@@ -188,13 +111,23 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
             }
             const usage = ctx.getContextUsage();
             const contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
+            const settings = ctx.getCompactionSettings();
+            const breakerTripped = breaker.isTripped(state, Date.now());
             const retryDecision = {
                 attempt: idleWarmupAttempt,
                 transient: isTransientSummarizationFailure(failure, failure.message),
                 isIdle: ctx.isIdle(),
-                breakerTripped: breaker.isTripped(state, Date.now()),
-                stillOverThreshold: usage !== undefined &&
-                    policy.shouldTriggerCompaction(usage, contextWindow, ctx.getCompactionSettings(), state.lastYield ?? undefined),
+                breakerTripped,
+                stillWarmEligible: idle.shouldWarmAtIdle({
+                    willRetry: false,
+                    aborted: false,
+                    settings,
+                    usage,
+                    contextWindow,
+                    breakerTripped,
+                    lastYield: state.lastYield ?? undefined,
+                    mode: ctx.mode,
+                }),
             };
             if (!idleRetry.shouldRetryIdleWarmup(retryDecision))
                 return;
@@ -333,9 +266,14 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
         getLogger(ctx).debug("speculative_started", { generation, origin: "speculative" });
         const controller = new AbortController();
         const settled = runExtensionCompaction(ctx, snapshot, controller.signal).then((result) => ({ result, error: undefined }), (error) => ({ result: undefined, error: error instanceof Error ? error : new Error(String(error)) }));
-        const promise = settled.then(({ result }) => result);
-        const failure = settled.then(({ error }) => error);
-        speculativeJob = { generation, snapshot, controller, promise, failure };
+        speculativeJob = trackSpeculativeJob({
+            generation,
+            snapshot,
+            controller,
+            settled,
+            armedAtTokens: ctx.getContextUsage()?.tokens ?? 0,
+        });
+        void settled.then(() => remoteCompactionDependencies.onSpeculativeJobSettled?.());
     }
     function capturePendingMetadata(requestId, ctx) {
         pendingMetadata.set(requestId, {
@@ -638,37 +576,16 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
                 claimedWarmJob?.controller.abort();
         }
     });
-    pi.on("model_select", (event, ctx) => {
-        if (lanePolicy.disablesSenpiCompaction(ctx)) {
-            invalidateSpeculativeCompaction(ctx);
-            return;
-        }
-        const jobModel = speculativeJob?.snapshot.model;
-        const selectedModel = ctx.model;
-        const alreadySpeculatingForSelectedModel = jobModel !== undefined &&
-            selectedModel !== undefined &&
-            jobModel.api === selectedModel.api &&
-            jobModel.provider === selectedModel.provider &&
-            jobModel.id === selectedModel.id &&
-            jobModel.baseUrl === selectedModel.baseUrl &&
-            jobModel.contextWindow === selectedModel.contextWindow;
-        if (!alreadySpeculatingForSelectedModel) {
-            invalidateSpeculativeCompaction(ctx);
-        }
-        const previousWindow = event.previousModel?.contextWindow ?? 0;
-        const contextWindow = ctx.model?.contextWindow ?? 0;
-        if (previousWindow <= contextWindow)
-            return;
-        const usage = ctx.getContextUsage();
-        if (!usage)
-            return;
-        if (breaker.isTripped(state, Date.now()))
-            return;
-        const settings = ctx.getCompactionSettings();
-        if (policy.shouldStartSpeculativeCompaction(usage, contextWindow, settings, state.lastYield ?? undefined)) {
-            startSpeculativeCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);
-        }
-    });
+    pi.on("model_select", (event, ctx) => handleCompactionModelSelect({
+        event,
+        ctx,
+        state,
+        speculativeSnapshot: speculativeJob?.snapshot,
+        laneOwnsCompaction: lanePolicy.disablesSenpiCompaction(ctx),
+        breakerTripped: breaker.isTripped(state, Date.now()),
+        invalidate: () => invalidateSpeculativeCompaction(ctx),
+        start: () => startSpeculativeCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS),
+    }));
     pi.on("session_compact", async (event, ctx) => {
         const compactEvent = event;
         invalidateSpeculativeCompaction(ctx);
@@ -679,6 +596,7 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
             const keptEntries = firstKeptIndex === -1 ? [] : branchEntries.slice(firstKeptIndex);
             state = cap.incrementAccepted(state);
             state = breaker.recordSuccess(state);
+            reminderState = createInitialReminderState();
             const details = compactEvent.compactionEntry.details;
             const sy = details?.structuralYield;
             if (sy && typeof sy.savedTokens === "number" && typeof sy.savingsRatio === "number") {
@@ -710,7 +628,7 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
                     compactionEntryId: compactEvent.compactionEntry.id,
                     contextWindow: usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW,
                     usageTokens: usage?.tokens ?? null,
-                    reserveTokens: settings.reserveTokens,
+                    reserveTokens: policy.resolveEffectiveReserveTokens(usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW, settings),
                     settings,
                     keptMessages: keptEntries.flatMap((entry) => {
                         if (entry.type !== "message")
@@ -721,7 +639,11 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
             }
             return;
         }
-        state = breaker.recordFailure(state, Date.now(), { route: compactEvent.reason });
+        if (compactEvent.rejectionCause === "external-owner")
+            return;
+        if (!lanePolicy.disablesSenpiCompaction(ctx)) {
+            state = breaker.recordFailure(state, Date.now(), { route: compactEvent.reason });
+        }
     });
     pi.on("before_agent_start", async (event, ctx) => {
         sessionIdleSinceAgentEnd = false;
@@ -736,9 +658,14 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
         // the circuit breaker never blocks that valve for senpi-owned lanes.
         const laneOwnsCompaction = lanePolicy.disablesSenpiCompaction(ctx);
         const breakerCoolingDown = breaker.isTripped(state, Date.now()) || laneOwnsCompaction;
+        const { reserveTokens, thresholdTokens, leadTokens } = resolveCompactionGeometry({
+            contextWindow,
+            settings,
+            lastYield: state.lastYield ?? undefined,
+        });
         if (!laneOwnsCompaction &&
             usage &&
-            policy.isAtHardLimit(usage, contextWindow, settings.reserveTokens, pendingPromptTokens)) {
+            policy.isAtHardLimit(usage, contextWindow, reserveTokens, pendingPromptTokens)) {
             getLogger(ctx).debug("hard_limit_trigger", {
                 contextWindow,
                 tokens: usage.tokens ?? 0,
@@ -754,42 +681,84 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
                 tokens: usageWithPendingPrompt.tokens ?? 0,
                 threshold: settings.reserveTokens,
             });
-            await applyBlockingCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);
+            if (!shouldDeferGraceBand({
+                tokens: usageWithPendingPrompt.tokens ?? 0,
+                thresholdTokens,
+                leadTokens,
+                contextWindow,
+                reserveTokens,
+                compactionInFlight: speculativeJob !== undefined && !speculativeJob.completed,
+                graceBandEnabled: settings.graceBandEnabled,
+            })) {
+                await applyBlockingCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);
+            }
+            else {
+                getLogger(ctx).debug("grace_deferred", {
+                    tokens: usageWithPendingPrompt.tokens ?? 0,
+                    threshold: thresholdTokens,
+                });
+            }
         }
         else if (!breakerCoolingDown &&
+            !isOpenAiRemoteCompactionModel(ctx.model) &&
             usageWithPendingPrompt &&
-            policy.shouldStartSpeculativeCompaction(usageWithPendingPrompt, contextWindow, settings, state.lastYield ?? undefined)) {
-            getLogger(ctx).debug("emergency_prune", {
-                route: "context-event",
-                tokens: usageWithPendingPrompt.tokens ?? 0,
-            });
+            policy.shouldStartSpeculativeCompaction(usageWithPendingPrompt, contextWindow, settings, state.lastYield ?? undefined, leadTokens)) {
+            // The speculative start below logs "speculative_started" itself; logging
+            // "emergency_prune" here mislabeled proactive speculation as pruning and
+            // corrupted the counter the incident analysis relies on.
             startSpeculativeCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);
         }
-        return message ? { message } : undefined;
+        const reminder = computeTokenBudgetReminder({
+            contextTokens: usageWithPendingPrompt?.tokens ?? 0,
+            contextWindow,
+            thresholdTokens,
+            leadTokens,
+            compactionEpoch: speculativeGeneration,
+            state: reminderState,
+        });
+        reminderState = reminder.nextState;
+        const deliveredMessage = resolveBeforeAgentStartMessage({
+            message,
+            reminder: reminder.message,
+            reminderEnabled: settings.reminderEnabled,
+        });
+        const reminderSystemPrompt = resolveReminderSystemPrompt({
+            systemPrompt: event.systemPrompt,
+            reminder: !message ? reminder.message : undefined,
+            reminderEnabled: settings.reminderEnabled,
+        });
+        if (!deliveredMessage && !reminderSystemPrompt)
+            return undefined;
+        return {
+            ...(deliveredMessage ? { message: deliveredMessage } : {}),
+            ...(reminderSystemPrompt ? { systemPrompt: reminderSystemPrompt } : {}),
+        };
     });
     pi.on("context", (event, ctx) => {
         const usage = ctx.getContextUsage();
+        const settings = ctx.getCompactionSettings();
         const contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
-        const promptContextWindow = getPromptContextWindow(contextWindow, ctx.model?.maxTokens);
-        const sourceMessages = shouldApplyContextReduction({
-            usageTokens: usage?.tokens ?? null,
-            contextWindow,
-            isProviderNativeCompactionPath: isOpenAiRemoteCompactionModel(ctx.model) || lanePolicy.disablesSenpiCompaction(ctx),
-        })
-            ? reduceContextMessages(event.messages, BUILTIN_CONTEXT_REDUCTION_OPTIONS).messages
-            : event.messages;
-        // The claude-sdk-oauth lane stands down from senpi compaction entirely:
-        // destructively pruning the provider context near the hard limit would
-        // break the resident SDK session's continuity the same way the gated
-        // reduction lane would.
-        const emergency = lanePolicy.disablesSenpiCompaction(ctx)
-            ? { messages: sourceMessages, needsAggressiveCompaction: false }
-            : hardLimitEmergencyPrune(sourceMessages, promptContextWindow, emergencyPruneLatch);
-        const marked = markOpenAiRemoteReplayBoundary(emergency.messages, {
-            model: ctx.model,
-            branchEntries: ctx.sessionManager.getBranch(),
-        });
-        return { messages: repairOrphanedToolResults(convertToLlm(marked)) };
+        const laneOwnsCompaction = lanePolicy.disablesSenpiCompaction(ctx);
+        const breakerFallback = !laneOwnsCompaction &&
+            breaker.isTripped(state, Date.now()) &&
+            usage?.tokens !== null &&
+            usage !== undefined &&
+            usage.tokens >= contextWindow * policy.computeEffectiveThreshold(contextWindow, state.lastYield ?? undefined);
+        if (breakerFallback)
+            getLogger(ctx).debug("breaker_deterministic_fallback", { route: "context-event", tokens: usage.tokens ?? 0 });
+        return {
+            messages: buildCompactionContext({
+                event,
+                ctx,
+                contextWindow,
+                promptContextWindow: getPromptContextWindow(contextWindow, ctx.model?.maxTokens),
+                toolAdmissionEnabled: settings.toolAdmissionEnabled !== false,
+                breakerFallback,
+                laneOwnsCompaction,
+                emergencyPruneLatch,
+                logEmergencyPrune: (fields) => getLogger(ctx).debug("emergency_prune", fields),
+            }),
+        };
     });
     pi.on("before_provider_request", async (event, ctx) => {
         const model = event.model ?? ctx.model;
@@ -850,6 +819,35 @@ export default function compactionExtension(pi, remoteCompactionDependencies = {
             armIdleWarmupRetry(ctx);
             armIdleApply(ctx);
         }
+        else {
+            // A sub-threshold OpenAI warm-up cannot be consumed by the remote
+            // compaction route. Once threshold admission succeeds remotely, it would
+            // only abort and discard this paid local summary. Above threshold we keep
+            // the existing local idle apply, which can finish before the next prompt;
+            // if remote compaction later falls back, blocking local generation remains
+            // unchanged.
+            if (isOpenAiRemoteCompactionModel(ctx.model))
+                return;
+            const warmAction = resolveIdleWarmAction({
+                willRetry: event.willRetry ?? false,
+                aborted: event.aborted === true,
+                settings,
+                usage,
+                contextWindow,
+                breakerTripped: breaker.isTripped(state, Date.now()),
+                lastYield: state.lastYield ?? undefined,
+                mode: ctx.mode,
+            }, speculativeJob);
+            if (warmAction === "replace")
+                invalidateSpeculativeCompaction(ctx);
+            if (warmAction !== "none") {
+                idleWarmupAttempt = 0;
+                sessionIdleSinceAgentEnd = true;
+                startSpeculativeCompaction(ctx, idle.IDLE_COMPACTION_INSTRUCTIONS);
+                armIdleWarmupRetry(ctx);
+                armIdleApply(ctx);
+            }
+        }
     });
     pi.on("message_end", async (event, ctx) => {
         for (const entry of collectCompactBoundaryEntries(event.message)) {