@kenkaiiii/ggcoder 5.82.0 → 5.83.0

package/dist/core/compaction/policy.js

@@ -1,63 +1,106 @@
 export const DEFAULT_COMPACTION_THRESHOLD = 0.85;
 /**
- * Latency caps on the context window used for compaction TRIGGERING.
+ * Caps on the context window used for compaction TRIGGERING, per provider.
  *
- * Some providers advertise huge windows (GLM: 1M, MiniMax/MiMo/Gemini: 1M+)
- * whose pricing model tolerates but whose transports may not: on the public
- * API every turn re-prefills the whole active context, and observed GLM
- * prefill was ~3-5K tok/s uncached (2026-09-22 sidecar log: 44-68s
- * time-to-first-token at 213K tokens). A session sitting at 21% of a 1M
- * window therefore paid a 45-70s tax on EVERY model call without ever
- * approaching the 85% compaction trigger.
+ * The trigger is `threshold × min(contextWindow, cap)`. A cap moves only when
+ * compaction summarizes; the model's true window still governs hard limits
+ * (request size, output budgets), and min() keeps a smaller advertised window
+ * authoritative — a cap never raises a trigger.
  *
- * Three tiers, ALL evidence-driven — this is deliberately not GLM-only:
+ * Every entry below needs evidence of ONE of these, cited inline:
  *
- *   1. MEASURED SLOW — explicit cap (glm: 176K → trigger ~150K, from the
- *      incident log).
- *   2. MEASURED HEALTHY — no cap: the transport's prompt caching demonstrably
- *      keeps large contexts fast (anthropic: we send explicit cache_control
- *      breakpoints; openai: sidecar audit shows flat 5-6s TTFT p95 at 237K
- *      tokens, zero stalls in 2,000+ turns). Capping these would throw away
- *      working context for nothing.
- *   3. UNKNOWN — the conservative default cap below. Any provider we have
- *      not measured gets it, so a user on ANY model is protected from the
- *      mega-window + cold-prefill pattern. The `cache_health` /
- *      `prompt_cache_miss` diag lines (agent-loop) turn tier 3 into tier 1 or
- *      2 with one line here as evidence arrives — remove a provider's cap
- *      once its logs show healthy cache reads at large sizes, lower it when
- *      they show misses.
+ *   - a hard input limit below the advertised window;
+ *   - measured slow turns (re-prefill without prompt caching);
+ *   - a price tier that reprices the WHOLE request once the prompt crosses a
+ *     size, so every turn past it costs more;
+ *   - the vendor's own agent compacting this model earlier on the same route.
  *
- * The model's true context window still governs hard limits (request size,
- * output budgets); a cap only moves when compaction summarizes. min() keeps a
- * smaller advertised window authoritative — the default never raises a
- * trigger that the provider's real window already keeps lower.
+ * "uncapped" needs evidence too: automatic prompt caching with cheap cache
+ * hits and no long-context tier, or measured fast turns at large sizes.
+ * Providers with no evidence either way keep {@link DEFAULT_LATENCY_WINDOW_CAP}.
+ * Verified 2026-10-16 against the vendors' agents in source (deepseek-harness,
+ * gemini-cli, qwen-code, codex, CodeWhale's model/pricing tables) and docs.
  */
-const PROVIDER_LATENCY_WINDOW_CAPS = {
+const PROVIDER_WINDOW_CAPS = {
+    // Measured: TTFT 1.1s <50K → 3.6s at 700K–1M, ~100% cache reads over
+    // 26,000+ turns (session logs, 2026-10). No long-context price tier. Claude
+    anthropic: "uncapped",
+    // Price line: once input passes 272K, OpenAI bills the WHOLE request at 2×
+    // input/cache and 1.5× output (OpenAI model pages, via CodeWhale pricing.rs
+    // OPENAI_LONG_CONTEXT_SURCHARGE_THRESHOLD). Codex itself stays under it,
+    // compacting at 90% of a 272K window (codex-rs/protocol/src/openai_models.rs
+    // auto_compact_token_limit). Trigger 231K on both routes: the API key's
+    // 1.05M window is capped here, the Codex OAuth route already passes 272K.
+    openai: 272_000,
+    // Measured slow: every turn re-prefilled the whole context on the Coding
+    // Plan endpoint at ~3–5K tok/s (2026-09-22 sidecar log: 44–68s TTFT at 213K).
     glm: 176_000,
+    // DeepSeek's own agent compacts at 80% of a 1M window with no cap
+    // (deepseek-harness packages/compaction: ratio 0.8, DEFAULT_CONTEXT_WINDOW
+    // 1_000_000). Automatic prefix caching, hits ~1/50 of a miss (pi models:
+    // cacheRead 0.006 vs input 0.30), no long-context surcharge.
+    deepseek: "uncapped",
+    // Kimi K3: automatic caching, hit $0.30 vs miss $3.00, no long-context tier
+    // (platform.kimi.ai pricing, via CodeWhale pricing.rs). Kimi For Coding
+    // (K2.8 Preview) serves up to 1M (kimi.com/code/docs).
+    moonshot: "uncapped",
+    // Measured: mimo-v2.6-pro ~1,600 turns, TTFT 4–7s, 95–100% of input read
+    // from cache up to 250K (session logs). Cache hit $0.0036 vs miss $0.435
+    // (~1/120), and V2.6 has a single price tier (Xiaomi rate card).
+    xiaomi: "uncapped",
+    // MiniMax-M3 doubles its price once input passes 512K (0.30 → 0.60 in, cache
+    // 0.06 → 0.12: CodeWhale pricing.rs MINIMAX_M3_LONG_CONTEXT_THRESHOLD, from
+    // MiniMax's pay-as-you-go page), and 512K is the guaranteed window; "1M" is
+    // up to. Trigger 435K stays under the line.
+    minimax: 512_000,
+    // Google's own Gemini CLI compresses at 50% of the window on this same
+    // Code Assist route (packages/cli/src/ui/constants.ts
+    // DEFAULT_COMPRESSION_THRESHOLD = 0.5; tokenLimit 1_048_576 for every
+    // Gemini model), and implicit caching on Code Assist is unverified. 616K ×
+    // 0.85 = 524K ≈ 50% of 1,048,576. Flash and Flash Lite are flat-priced at any
+    // prompt size; 3.1 Pro has its own price-line cap in MODEL_WINDOW_CAPS.
+    gemini: 616_000,
+    // Price line: xAI bills the WHOLE request at 2× ($4 / $1 cached / $12) once a
+    // grok-4.7 prompt reaches 200K tokens (docs.x.ai/developers/pricing;
+    // CodeWhale pricing.rs GROK_4_6_LONG_CONTEXT_THRESHOLD = 200_000). Trigger
+    // 170K stays under the line.
+    xai: 200_000,
+    // Qwen's own agent (qwen-code) runs qwen3.8-max at a 1M window and compacts
+    // at 85% (chatCompressionService DEFAULT_PCT). OpenRouter lists cache reads
+    // at $0.25 vs $2.00 input and no long-context tier.
+    openrouter: "uncapped",
 };
-/** Providers with MEASURED healthy prompt caching — exempt from the default cap. */
-const PROVIDERS_WITH_HEALTHY_CACHING = new Set([
-    "anthropic", // explicit cache_control breakpoints in our transport
-    "openai", // sidecar audit 2026-09-22: flat TTFT p95 at 237K tokens, 0 stalls / 2000+ turns
-]);
-/** Conservative ceiling for providers whose cache behaviour is UNMEASURED.
- *  Only bites mega-windows (≥ ~470K): typical 200-272K windows are unaffected. */
+/**
+ * Per-model caps, checked before the provider's rule: a model whose pricing
+ * differs from the rest of its provider.
+ */
+const MODEL_WINDOW_CAPS = {
+    // Price line: Gemini 3.1 Pro bills the WHOLE request at $4 / $18 instead of
+    // $2 / $12 once the prompt passes 200K tokens (Gemini API pricing); the
+    // Flash models stay flat. On a Code Assist licence this compacts earlier than
+    // Gemini CLI's 50%, which keeps API-key users off the higher rate.
+    "gemini-3.1-pro-preview": 200_000,
+};
+/** Conservative ceiling for providers with NO evidence either way (Sakana, the
+ *  Hugging Face router — whose served window and caching vary by backend).
+ *  Only bites windows above ~470K; 200–272K windows are unaffected. */
 const DEFAULT_LATENCY_WINDOW_CAP = 400_000;
-/** The latency-capped effective context window for a provider, if one applies. */
-export function resolveLatencyWindowCap(provider) {
-    const explicit = PROVIDER_LATENCY_WINDOW_CAPS[provider];
-    if (explicit != null)
-        return explicit;
-    if (PROVIDERS_WITH_HEALTHY_CACHING.has(provider))
+/** The effective trigger window cap for a provider (and model), if one applies. */
+export function resolveLatencyWindowCap(provider, model) {
+    const modelCap = model === undefined ? undefined : MODEL_WINDOW_CAPS[model];
+    if (modelCap !== undefined)
+        return modelCap;
+    const rule = PROVIDER_WINDOW_CAPS[provider];
+    if (rule === "uncapped")
         return undefined;
-    return DEFAULT_LATENCY_WINDOW_CAP;
+    return rule ?? DEFAULT_LATENCY_WINDOW_CAP;
 }
 /** One trigger policy shared by app sessions and CLI compaction. */
 export function resolveCompactionPolicy(options) {
     const threshold = Number.isFinite(options.threshold) && options.threshold > 0 && options.threshold < 1
         ? options.threshold
         : DEFAULT_COMPACTION_THRESHOLD;
-    const latencyCap = resolveLatencyWindowCap(options.provider);
+    const latencyCap = resolveLatencyWindowCap(options.provider, options.model);
     // The trigger fires against the latency-capped window when one applies —
     // min() keeps a provider-declared window smaller than the cap authoritative.
     const effectiveWindow = latencyCap

package/dist/core/compaction/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/core/compaction/policy.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,4BAA4B,GAAsC;IACtE,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,oFAAoF;AACpF,MAAM,8BAA8B,GAA0B,IAAI,GAAG,CAAC;IACpE,WAAW,EAAE,sDAAsD;IACnE,QAAQ,EAAE,iFAAiF;CAC9E,CAAC,CAAC;AAEjB;kFACkF;AAClF,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAE3C,kFAAkF;AAClF,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,MAAM,QAAQ,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,8BAA8B,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAQD,oEAAoE;AACpE,MAAM,UAAU,uBAAuB,CAAC,OAOvC;IACC,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAU,GAAG,CAAC,IAAI,OAAO,CAAC,SAAU,GAAG,CAAC;QACpF,CAAC,CAAC,OAAO,CAAC,SAAU;QACpB,CAAC,CAAC,4BAA4B,CAAC;IACnC,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,eAAe,GAAG,UAAU;QAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC;QAC7C,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GACb,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;IACpF,OAAO;QACL,SAAS;QACT,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS;YACT,aAAa,EAAE,eAAe;YAC9B,SAAS;YACT,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;SACnD,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/core/compaction/policy.ts"],"names":[],"mappings":"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"}

package/dist/core/compaction/token-estimator.d.ts

@@ -27,7 +27,10 @@ export declare function measureConversationChars(messages: Message[]): {
  * its authoritative total input tokens (uncached + cache read/write). Skips
  * histories containing image/video parts.
  */
-export declare function calibrateEstimatorFromUsage(history: Message[], usage: Usage): void;
+export declare function calibrateEstimatorFromUsage(history: Message[], usage: Usage, 
+/** Characters the provider also counted but `history` lacks — the tool
+ *  definitions sent with the request. Omitting them biases the ratio low. */
+extraChars?: number): void;
 export declare function estimateTokens(text: string): number;
 export declare function estimateMessageTokens(message: Message): number;
 export declare function estimateConversationTokens(messages: Message[]): number;

package/dist/core/compaction/token-estimator.js

@@ -108,12 +108,15 @@ export function measureConversationChars(messages) {
  * its authoritative total input tokens (uncached + cache read/write). Skips
  * histories containing image/video parts.
  */
-export function calibrateEstimatorFromUsage(history, usage) {
+export function calibrateEstimatorFromUsage(history, usage, 
+/** Characters the provider also counted but `history` lacks — the tool
+ *  definitions sent with the request. Omitting them biases the ratio low. */
+extraChars = 0) {
     const { chars, hasMedia } = measureConversationChars(history);
     if (hasMedia)
         return;
     const totalInputTokens = usage.inputTokens + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0);
-    calibrateEstimator(chars, totalInputTokens);
+    calibrateEstimator(chars + Math.max(0, extraChars), totalInputTokens);
 }
 function getModelCharsPerToken() {
     if (!activeModel)

package/dist/core/compaction/token-estimator.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../../src/core/compaction/token-estimator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,mBAAmB,GAA2B;IAClD,4EAA4E;IAC5E,MAAM,EAAE,GAAG;IACX,6DAA6D;IAC7D,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,6DAA6D;IAC7D,GAAG,EAAE,GAAG;IACR,2DAA2D;IAC3D,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,GAAG;IACb,6DAA6D;IAC7D,OAAO,EAAE,GAAG;IACZ,8DAA8D;IAC9D,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,iDAAiD;AACjD,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,oBAAoB,GAAG,CAAC,CAAC,CAAC,SAAS;AAEzC,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,mFAAmF;AACnF,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,sFAAsF;AACtF,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,mFAAmF;AACnF,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,KAAK,KAAK,WAAW;QAAE,eAAe,GAAG,IAAI,CAAC;IAClD,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAc;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO;IAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,eAAe,IAAI,qBAAqB,EAAE,CAAC;IAChE,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC;AACjF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAmB;IAI1D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAuC,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnD,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACrC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjD,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,IAAkB,CAAC;gBAC9B,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACnC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;4BAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;;4BACjD,QAAQ,GAAG,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3D,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAkB,EAAE,KAAY;IAC1E,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,QAAQ;QAAE,OAAO;IACrB,MAAM,gBAAgB,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAC9F,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC,WAAW;QAAE,OAAO,uBAAuB,CAAC;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClE,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,eAAe,IAAI,qBAAqB,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,IAAI,MAAM,GAAG,oBAAoB,CAAC;IAElC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACvD,MAAM,EAAE,GAAG,IAA2C,CAAC;gBACvD,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzD,MAAM,EAAE,GAAG,IAA6B,CAAC;gBACzC,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BAC1B,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBACvC,CAAC;6BAAM,CAAC;4BACN,gEAAgE;4BAChE,MAAM,IAAI,IAAI,CAAC;wBACjB,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAmB;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../../src/core/compaction/token-estimator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,mBAAmB,GAA2B;IAClD,4EAA4E;IAC5E,MAAM,EAAE,GAAG;IACX,6DAA6D;IAC7D,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,6DAA6D;IAC7D,GAAG,EAAE,GAAG;IACR,2DAA2D;IAC3D,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,GAAG;IACb,6DAA6D;IAC7D,OAAO,EAAE,GAAG;IACZ,8DAA8D;IAC9D,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,iDAAiD;AACjD,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,oBAAoB,GAAG,CAAC,CAAC,CAAC,SAAS;AAEzC,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,mFAAmF;AACnF,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,sFAAsF;AACtF,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,mFAAmF;AACnF,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,KAAK,KAAK,WAAW;QAAE,eAAe,GAAG,IAAI,CAAC;IAClD,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAc;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO;IAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,eAAe,IAAI,qBAAqB,EAAE,CAAC;IAChE,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC;AACjF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAmB;IAI1D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAuC,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnD,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACrC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjD,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,IAAkB,CAAC;gBAC9B,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACnC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;4BAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;;4BACjD,QAAQ,GAAG,IAAI,CAAC;oBACvB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3D,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAkB,EAClB,KAAY;AACZ;6EAC6E;AAC7E,UAAU,GAAG,CAAC;IAEd,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,QAAQ;QAAE,OAAO;IACrB,MAAM,gBAAgB,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAC9F,kBAAkB,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC,WAAW;QAAE,OAAO,uBAAuB,CAAC;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClE,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,eAAe,IAAI,qBAAqB,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,IAAI,MAAM,GAAG,oBAAoB,CAAC;IAElC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACvD,MAAM,EAAE,GAAG,IAA2C,CAAC;gBACvD,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzD,MAAM,EAAE,GAAG,IAA6B,CAAC;gBACzC,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BAC1B,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBACvC,CAAC;6BAAM,CAAC;4BACN,gEAAgE;4BAChE,MAAM,IAAI,IAAI,CAAC;wBACjB,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAmB;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/idle-wake.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Wake an idle session when its own background work needs attention.
+ *
+ * Background alerts — a build or CI watcher that failed, a task that exited
+ * non-zero, a child agent that finished — ride the steering path, which only
+ * exists while a run is live. Once the agent has ended its turn, an alert sat
+ * in the queue until the user happened to send another message (measured: 8 of
+ * 483 runs began with a status update that had been waiting for exactly that).
+ *
+ * This starts a run for the alert instead, inside hard limits:
+ *
+ * - Never while anything else could deliver it: a live run, a run being
+ *   claimed, an autopilot cycle. The alert waits for that run's next steering
+ *   boundary instead, and is retried here if the run ends without draining it.
+ * - Never while the user is deciding something (a plan awaiting review).
+ * - Never after the user pressed Stop, until they send another message. Stop
+ *   means "stop acting on your own", and a background exit is not a reason to
+ *   override it.
+ * - At most {@link DEFAULT_MAX_WAKES_PER_PROMPT} wakes per user message, so a
+ *   flapping task cannot keep the agent (and the bill) running unattended.
+ *
+ * Pure policy over injected callbacks; the host owns the run itself.
+ */
+/** Batch alerts that land together (a failure line, then the exit) into one run. */
+export declare const DEFAULT_IDLE_WAKE_DEBOUNCE_MS = 2000;
+/** Unattended wakes allowed per human prompt. */
+export declare const DEFAULT_MAX_WAKES_PER_PROMPT = 2;
+export type IdleWakeSkip = "stopped" | "budget" | "blocked" | "nothing-pending";
+export interface IdleWakeDeps {
+    /** A run, a run claim, or an autopilot cycle is live and will deliver it. */
+    isBusy: () => boolean;
+    /** The user is deciding something (a plan awaiting review). */
+    isBlocked: () => boolean;
+    /** An urgent alert is still waiting to be delivered. */
+    hasPendingAlert: () => boolean;
+    /** Monotonic count of human prompts; budgets and Stop reset when it moves. */
+    humanPromptSeq: () => number;
+    /** Start the wake run; resolves when it has settled. */
+    start: () => Promise<void>;
+    /** Observability hook for skipped wakes. */
+    onSkip?: (reason: IdleWakeSkip) => void;
+    debounceMs?: number;
+    maxWakesPerPrompt?: number;
+}
+export declare class IdleWakeController {
+    private readonly deps;
+    private timer;
+    private budgetSeq;
+    private wakesUsed;
+    private stoppedAtSeq;
+    private starting;
+    private disposed;
+    constructor(deps: IdleWakeDeps);
+    /** An urgent alert was queued. Debounced; safe to call often. */
+    trigger(): void;
+    /** The user pressed Stop: no unattended wakes until their next message. */
+    noteStop(): void;
+    dispose(): void;
+    private cancelTimer;
+    private fire;
+    private skip;
+}

package/dist/core/idle-wake.js

@@ -0,0 +1,103 @@
+/**
+ * Wake an idle session when its own background work needs attention.
+ *
+ * Background alerts — a build or CI watcher that failed, a task that exited
+ * non-zero, a child agent that finished — ride the steering path, which only
+ * exists while a run is live. Once the agent has ended its turn, an alert sat
+ * in the queue until the user happened to send another message (measured: 8 of
+ * 483 runs began with a status update that had been waiting for exactly that).
+ *
+ * This starts a run for the alert instead, inside hard limits:
+ *
+ * - Never while anything else could deliver it: a live run, a run being
+ *   claimed, an autopilot cycle. The alert waits for that run's next steering
+ *   boundary instead, and is retried here if the run ends without draining it.
+ * - Never while the user is deciding something (a plan awaiting review).
+ * - Never after the user pressed Stop, until they send another message. Stop
+ *   means "stop acting on your own", and a background exit is not a reason to
+ *   override it.
+ * - At most {@link DEFAULT_MAX_WAKES_PER_PROMPT} wakes per user message, so a
+ *   flapping task cannot keep the agent (and the bill) running unattended.
+ *
+ * Pure policy over injected callbacks; the host owns the run itself.
+ */
+/** Batch alerts that land together (a failure line, then the exit) into one run. */
+export const DEFAULT_IDLE_WAKE_DEBOUNCE_MS = 2_000;
+/** Unattended wakes allowed per human prompt. */
+export const DEFAULT_MAX_WAKES_PER_PROMPT = 2;
+export class IdleWakeController {
+    deps;
+    timer = null;
+    budgetSeq = -1;
+    wakesUsed = 0;
+    stoppedAtSeq = null;
+    starting = false;
+    disposed = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** An urgent alert was queued. Debounced; safe to call often. */
+    trigger() {
+        if (this.disposed || this.timer !== null)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.fire();
+        }, this.deps.debounceMs ?? DEFAULT_IDLE_WAKE_DEBOUNCE_MS);
+        this.timer.unref?.();
+    }
+    /** The user pressed Stop: no unattended wakes until their next message. */
+    noteStop() {
+        this.stoppedAtSeq = this.deps.humanPromptSeq();
+        this.cancelTimer();
+    }
+    dispose() {
+        this.disposed = true;
+        this.cancelTimer();
+    }
+    cancelTimer() {
+        if (this.timer !== null)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    async fire() {
+        if (this.disposed || this.starting)
+            return;
+        if (!this.deps.hasPendingAlert())
+            return this.skip("nothing-pending");
+        const seq = this.deps.humanPromptSeq();
+        if (this.stoppedAtSeq === seq)
+            return this.skip("stopped");
+        if (seq !== this.budgetSeq) {
+            this.budgetSeq = seq;
+            this.wakesUsed = 0;
+        }
+        if (this.wakesUsed >= (this.deps.maxWakesPerPrompt ?? DEFAULT_MAX_WAKES_PER_PROMPT)) {
+            return this.skip("budget");
+        }
+        if (this.deps.isBusy()) {
+            // The live run should drain it at its next steering boundary. If that
+            // run is already past its last boundary, the alert would strand — so
+            // look again shortly rather than trusting the run to have taken it.
+            this.trigger();
+            return;
+        }
+        if (this.deps.isBlocked())
+            return this.skip("blocked");
+        this.wakesUsed += 1;
+        this.starting = true;
+        try {
+            await this.deps.start();
+        }
+        finally {
+            this.starting = false;
+        }
+        // An alert that landed after the wake run's last steering boundary.
+        if (this.deps.hasPendingAlert())
+            this.trigger();
+    }
+    skip(reason) {
+        this.deps.onSkip?.(reason);
+    }
+}
+//# sourceMappingURL=idle-wake.js.map

package/dist/core/idle-wake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-wake.js","sourceRoot":"","sources":["../../src/core/idle-wake.ts"],"names":[],"mappings":"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"}

package/dist/core/process-manager.d.ts

@@ -10,8 +10,11 @@ export interface BackgroundProcess {
     startedAt: number;
     exitCode: number | null;
     lastReadOffset: number;
-    /** Unread one-shot wake, retained even if it fired before task_output waited. */
-    wakeReason?: "pattern" | "silence";
+    /** Unread wake, retained even if it fired before task_output waited. */
+    wakeReason?: WakeReason;
+    /** Log offset the wake is about. A read that reaches it consumes the wake;
+     *  one that started earlier does not (the wake fired mid-read). */
+    wakeOffset?: number;
     /**
      * Last known size of `logFile` in bytes. Kept current by the progress
      * watcher, the exit handler and every `readOutput`, so consumers (notably
@@ -37,6 +40,17 @@ export interface ReadOutputResult {
 /** Ceiling on a single blocking `waitForExitOrWake`, so one wedged process cannot
  *  hold the agent loop indefinitely; callers re-wait if they still want to. */
 export declare const MAX_PROCESS_WAIT_MS = 600000;
+/**
+ * Remove terminal colour and cursor codes. Test runners and CLIs colour their
+ * output, and a code can sit inside the very word a wake looks for:
+ * `\e[31mFAIL\e[0mED` never matches /FAILED/ until it is stripped.
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * The first line in `text` that looks like a tool reporting a failure, ANSI
+ * codes stripped, or undefined. Exported for tests.
+ */
+export declare function findFailureLine(text: string): string | undefined;
 /**
  * Model-declared wake conditions for a background task. The agent states up
  * front what output it cares about (or what silence means), and the watcher
@@ -45,12 +59,22 @@ export declare const MAX_PROCESS_WAIT_MS = 600000;
  * or re-reading generic progress checkpoints hoping to spot the signal.
  */
 export interface WakeRules {
-    /** Wake the moment new log output matches this regex. One-shot. */
+    /** Wake whenever new log output matches this regex — every new match, not
+     *  just the first, so a dev server that breaks again after a fix is seen. */
     pattern?: RegExp;
     /** Wake when the process is still running but has logged nothing for this
      *  many milliseconds (a stalled build/hang detector). One-shot. */
     silenceMs?: number;
 }
+/** Why a wake fired. `failure` is the built-in detector, armed on every task. */
+export type WakeReason = "pattern" | "silence" | "failure";
+/** How a blocking wait on one background task ended. */
+export type WaitOutcome = "exited" | "timeout" | "unknown" | WakeReason | "other";
+export interface WaitResult {
+    reason: WaitOutcome;
+    /** For `other`: the notification about a different task that ended the wait. */
+    detail?: string;
+}
 export interface ProcessManagerOps {
     platform?: NodeJS.Platform;
     kill?: typeof process.kill;
@@ -94,6 +118,9 @@ export declare class ProcessManager {
     private wakeStates;
     /** Log size at the last emitted checkpoint, so a quiet process stays quiet. */
     private watchedSizes;
+    /** Processes the agent or host is deliberately stopping: their non-zero exit
+     *  is the stop working, not news, so it must not raise an urgent alert. */
+    private stopping;
     /** Timestamp of the last retention sweep; 0 means "never swept". */
     private lastPruneAt;
     constructor(ops?: ProcessManagerOps);
@@ -149,16 +176,22 @@ export declare class ProcessManager {
     /** Read the trailing bytes of a log without loading the whole file. */
     private readTail;
     /** Read the bytes of a log in `[start, end)` without loading the file. */
-    private readRange;
+    private readBytes;
     /**
-     * Wake-rule watcher: evaluates the model's `pattern`/`silenceMs` conditions
-     * every {@link WAKE_INTERVAL_MS} and pushes a steering-path notification the
-     * moment one holds. Each rule is one-shot; once every declared rule has fired
-     * (or the process exits) the watcher retires. Unlike the progress watcher it
-     * never backs off — the agent asked for exactly this signal, however long it
-     * takes, and a late match on a quiet dev server is precisely the point.
+     * Wake watcher, evaluated every {@link WAKE_INTERVAL_MS}. Always runs the
+     * built-in failure detector (one-shot), plus the model's declared rules when
+     * a notification queue can deliver them: `pattern` fires on every new match,
+     * `silenceMs` once. It retires on exit, or once nothing is left that could
+     * still fire. Unlike the progress watcher it never backs off — a late match
+     * on a quiet dev server is precisely the point.
+     *
+     * Returns whether the model's declared rules were armed. Without a queue they
+     * are not (nothing could deliver them), but failure detection still releases
+     * a blocking `task_output` wait directly.
      */
     private armWakeWatcher;
+    /** Record a wake on the process and release anyone blocked waiting on it. */
+    private fireWake;
     private evaluateWakeRules;
     /** Stop and forget a process's wake watcher. */
     private disposeWakeWatcher;
@@ -182,7 +215,14 @@ export declare class ProcessManager {
      * loop step to be delivered, which is exactly what an agent with nothing
      * else to do does not have.
      */
-    waitForExitOrWake(id: string, timeoutMs: number, signal?: AbortSignal): Promise<"exited" | "timeout" | "unknown" | "pattern" | "silence">;
+    waitForExitOrWake(id: string, timeoutMs: number, signal?: AbortSignal): Promise<WaitOutcome>;
+    /**
+     * {@link waitForExitOrWake}, plus what ended it. Besides this task exiting or
+     * waking, the wait also ends when ANOTHER task raises an urgent notification
+     * (a different build failed, a child agent finished): the agent blocked here
+     * has no other way to learn that before its wait runs out.
+     */
+    waitForActivity(id: string, timeoutMs: number, signal?: AbortSignal): Promise<WaitResult>;
     readOutput(id: string, fromStart?: boolean): Promise<ReadOutputResult>;
     /**
      * Write input to a running background process's stdin, enabling interactive