switchroom 0.20.6 → 0.20.8

package/telegram-plugin/dist/gateway/gateway.js

@@ -21997,7 +21997,7 @@ var init_schema = __esm(() => {
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent \u2192 uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent \u2192 global.")
     }).optional().describe("LLM knob for the hindsight container. The flat `provider`/`model` set " + "the global default (backward-compatible); optional `retain`/`reflect`/" + "`consolidation` blocks override individual ops. All fields optional; " + "unset fields fall back to the hard-coded defaults."),
-    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_RESERVED_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, GRAPH_SEED_MIN_SIMILARITY, " + "LLM_SUPPORTS_MAX_ITEMS, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS \u2014 switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY \u2014 a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP \u2014 the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS \u2014 only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS \u2014 the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_RESERVED_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS \u2014 the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool; and " + "the pre-0.8.6 name HINDSIGHT_API_WORKER_<TYPE>_MAX_SLOTS is still " + "accepted for every operation type and normalised to " + "..._RESERVED_SLOTS on the way in, because setting both names for " + "one type is a hard boot failure in the engine and switchroom " + "therefore emits only the canonical name; and " + "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY \u2014 the cosine-similarity floor a " + "candidate must reach to be returned by the semantic retrieval arm at " + "all (0..1); unset means upstream's own 0.3, and where it should sit " + "depends on the bank's embedding model and phrasing diversity, so " + "switchroom ships no opinion; and " + "HINDSIGHT_MCP_RECALL_BUDGET_MODE \u2014 the rollback knob for switchroom's " + "mcp-recall-token-budget image patch; `legacy` restores upstream's " + "exact pre-patch recall returns, anything else or unset is the " + "honest-envelope mode; and " + "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT \u2014 upstream's own per-op reflect " + "temperature knob, made live by switchroom's reflect-temperature image " + "patch; a float, or `none` to omit the kwarg (provider default, " + "upstream's accidental pre-patch behaviour); unset means the image's " + "baked default 0.1; and " + "HINDSIGHT_API_CONSOLIDATION_RECALL_MAX_CONCURRENT \u2014 the background " + "half of switchroom's recall-admission split (#3660): of the " + "RECALL_MAX_CONCURRENT admission slots, at most this many may be held " + "by background consolidation recalls at once, so foreground per-turn " + "recall always keeps the remainder; must be >= 1 and strictly less " + "than RECALL_MAX_CONCURRENT or the engine refuses to boot; unset " + "means the image's derived default min(2, RECALL_MAX_CONCURRENT - 1); " + "1 biases hard toward the interactive lane while a consolidation " + "backlog drains; and " + "HINDSIGHT_MM_REFRESH_MIN_INTERVAL_S \u2014 the rollback/tuning knob for " + "switchroom's MM-refresh-debounce image patch: the minimum seconds " + "between consolidation-triggered refreshes of one mental model; unset " + "means the image's baked 3600, 0 restores upstream's " + "refresh-every-round behaviour; explicit and cron-scheduled refreshes " + "are never debounced; and " + "HINDSIGHT_API_TEMPORAL_LANGUAGES \u2014 the language set dateparser is " + "restricted to during temporal query analysis, made live by switchroom's " + "temporal-language image patch (which ended a 200+-locale auto-detection " + "pass that blocked the shared asyncio loop on every recall); " + "comma-separated, unset means the image's baked `en`, set e.g. `en,es` to " + "restore i18n parsing), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS \u2014 a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED \u2014 a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
+    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_RESERVED_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, GRAPH_SEED_MIN_SIMILARITY, " + "LLM_SUPPORTS_MAX_ITEMS, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS \u2014 switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY \u2014 a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP \u2014 the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS \u2014 only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS \u2014 the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_RESERVED_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS \u2014 the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool; and " + "the pre-0.8.6 name HINDSIGHT_API_WORKER_<TYPE>_MAX_SLOTS is still " + "accepted for every operation type and normalised to " + "..._RESERVED_SLOTS on the way in, because setting both names for " + "one type is a hard boot failure in the engine and switchroom " + "therefore emits only the canonical name; and " + "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY \u2014 the cosine-similarity floor a " + "candidate must reach to be returned by the semantic retrieval arm at " + "all (0..1); unset means upstream's own 0.3, and where it should sit " + "depends on the bank's embedding model and phrasing diversity, so " + "switchroom ships no opinion; and " + "HINDSIGHT_MCP_RECALL_BUDGET_MODE \u2014 the rollback knob for switchroom's " + "mcp-recall-token-budget image patch; `legacy` restores upstream's " + "exact pre-patch recall returns, anything else or unset is the " + "honest-envelope mode; and " + "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT \u2014 upstream's own per-op reflect " + "temperature knob, made live by switchroom's reflect-temperature image " + "patch; a float, or `none` to omit the kwarg (provider default, " + "upstream's accidental pre-patch behaviour); unset means the image's " + "baked default 0.1; and " + "HINDSIGHT_API_CONSOLIDATION_RECALL_MAX_CONCURRENT \u2014 the background " + "half of switchroom's recall-admission split (#3660): of the " + "RECALL_MAX_CONCURRENT admission slots, at most this many may be held " + "by background consolidation recalls at once, so foreground per-turn " + "recall always keeps the remainder; must be >= 1 and strictly less " + "than RECALL_MAX_CONCURRENT or the engine refuses to boot; unset " + "means the image's derived default min(2, RECALL_MAX_CONCURRENT - 1); " + "1 biases hard toward the interactive lane while a consolidation " + "backlog drains; and " + "HINDSIGHT_MM_REFRESH_MIN_INTERVAL_S \u2014 the rollback/tuning knob for " + "switchroom's MM-refresh-debounce image patch: the minimum seconds " + "between consolidation-triggered refreshes of one mental model; unset " + "means the image's baked 3600, 0 restores upstream's " + "refresh-every-round behaviour; explicit and cron-scheduled refreshes " + "are never debounced; and " + "HINDSIGHT_API_TEMPORAL_LANGUAGES \u2014 the language set dateparser is " + "restricted to during temporal query analysis, made live by switchroom's " + "temporal-language image patch (which ended a 200+-locale auto-detection " + "pass that blocked the shared asyncio loop on every recall); " + "comma-separated, unset means the image's baked `en`, set e.g. `en,es` to " + "restore i18n parsing; and " + "HINDSIGHT_API_TEMPORAL_MAX_QUERY_CHARS \u2014 the max chars of query text " + "dateparser.search_dates() is handed during temporal analysis (0 = " + "unlimited), made live by switchroom's temporal-offload image patch " + "(which moved the synchronous extraction off the shared asyncio loop onto " + "a single-worker thread and bounds its input, ending multi-second loop " + "stalls on multi-KB consolidation queries); unset means the image's baked " + "2000, set 0 to restore an unbounded full scan), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS \u2014 a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED \u2014 a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
   });
   MicrosoftWorkspaceConfigSchema = exports_external.object({
     microsoft_client_id: exports_external.string().min(1).optional().describe("Microsoft OAuth application (client) ID from Entra portal " + "(literal string or vault reference e.g. " + "'vault:microsoft-oauth-client-id'). OPTIONAL \u2014 omit it to use " + "switchroom's shipped default Microsoft app (zero-config). " + "Set it only to bring your own Entra app (BYO)."),
@@ -22593,6 +22593,20 @@ var init_overlay_schema = __esm(() => {
 // ../src/config/overlay-loader.ts
 import { existsSync as existsSync5, readFileSync as readFileSync5, readdirSync as readdirSync3, statSync as statSync5 } from "node:fs";
 import { basename as basename4, resolve as resolve4 } from "node:path";
+function recordReadFailure(agentCfg, failure) {
+  const node = agentCfg;
+  const existing = node[OVERLAY_READ_FAILURES];
+  if (Array.isArray(existing)) {
+    existing.push(failure);
+    return;
+  }
+  Object.defineProperty(agentCfg, OVERLAY_READ_FAILURES, {
+    value: [failure],
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+}
 function deriveOverlayTitle(raw, fileName) {
   const titleFromComment = raw.match(/^#[^\S\n]*name:[^\S\n]*(\S.*?)[^\S\n]*$/m)?.[1];
   if (titleFromComment)
@@ -22602,17 +22616,39 @@ function deriveOverlayTitle(raw, fileName) {
     return;
   return base.length > 0 ? base : undefined;
 }
+function readOverlayFile(agentName, file, agentCfg, warnings) {
+  try {
+    return readFileSync5(file, "utf-8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT")
+      return;
+    const w = {
+      agent: agentName,
+      file,
+      reason: `read error: ${err.message}`,
+      code: code ?? "EUNKNOWN"
+    };
+    recordReadFailure(agentCfg, { file, code: w.code });
+    warnings.push(w);
+    console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${file}': ${w.reason}`);
+    return;
+  }
+}
 function overlayDirFor(agentName, subdir) {
   const base = resolveDualPath(`~/.switchroom/agents/${agentName}/${subdir}`);
   return resolve4(base);
 }
-function listYamlFiles(dir) {
+function listYamlFiles(dir, onUnreadableDir) {
   if (!existsSync5(dir))
     return [];
   let entries;
   try {
     entries = readdirSync3(dir);
-  } catch {
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT")
+      onUnreadableDir?.(code ?? "EUNKNOWN");
     return [];
   }
   const out = [];
@@ -22650,12 +22686,24 @@ function applyAgentOverlays(config) {
   for (const [agentName, agentCfg] of Object.entries(agents)) {
     try {
       const scheduleDir = overlayDirFor(agentName, "schedule.d");
-      const files = listYamlFiles(scheduleDir);
+      const files = listYamlFiles(scheduleDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: scheduleDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: scheduleDir, code });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${scheduleDir}': ${w.reason}`);
+      });
       if (files.length > 0) {
         const merged = [...agentCfg.schedule ?? []];
         for (const file of files) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings);
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync5(file, "utf-8");
             const parsed = import_yaml.parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             const title = deriveOverlayTitle(raw, basename4(file));
@@ -22690,13 +22738,25 @@ function applyAgentOverlays(config) {
     }
     try {
       const skillsDir = overlayDirFor(agentName, "skills.d");
-      const skillFiles = listYamlFiles(skillsDir);
+      const skillFiles = listYamlFiles(skillsDir, (code) => {
+        const w = {
+          agent: agentName,
+          file: skillsDir,
+          reason: `read error: cannot list overlay directory (${code})`,
+          code
+        };
+        recordReadFailure(agentCfg, { file: skillsDir, code });
+        warnings.push(w);
+        console.warn(`[switchroom] overlay-loader: agent='${agentName}' file='${skillsDir}': ${w.reason}`);
+      });
       if (skillFiles.length === 0) {} else {
         const merged = [...agentCfg.skills ?? []];
         const seen = new Set(merged);
         for (const file of skillFiles) {
+          const raw = readOverlayFile(agentName, file, agentCfg, warnings);
+          if (raw === undefined)
+            continue;
           try {
-            const raw = readFileSync5(file, "utf-8");
             const parsed = import_yaml.parse(raw);
             const doc = OverlayDocSchema.parse(parsed);
             for (const skillName of doc.skills ?? []) {
@@ -22724,7 +22784,7 @@ function applyAgentOverlays(config) {
   }
   return { config, warnings };
 }
-var import_yaml, OVERLAY_SOURCE, OVERLAY_TITLE;
+var import_yaml, OVERLAY_SOURCE, OVERLAY_TITLE, OVERLAY_READ_FAILURES;
 var init_overlay_loader = __esm(() => {
   init_zod();
   init_overlay_schema();
@@ -22732,6 +22792,7 @@ var init_overlay_loader = __esm(() => {
   import_yaml = __toESM(require_dist(), 1);
   OVERLAY_SOURCE = Symbol.for("switchroom.config.overlay-source");
   OVERLAY_TITLE = Symbol.for("switchroom.config.overlay-title");
+  OVERLAY_READ_FAILURES = Symbol.for("switchroom.config.overlay-read-failures");
 });
 
 // ../src/config/merge.ts
@@ -80949,6 +81010,22 @@ function endsWithSilentMarker(text4) {
     return false;
   return isSilentFlushMarker(lines[lines.length - 1]);
 }
+function isSilentSentinelCardOutcome(input) {
+  if (input.finalAnswerEverDelivered)
+    return false;
+  if (isSilentFlushMarker(input.lastReplyText) || isCompositeSilentNoise(input.lastReplyText)) {
+    return true;
+  }
+  if (!input.replyCalled) {
+    const joined = input.capturedText.join(`
+
+`).trim();
+    if (joined.length > 0 && (isSilentFlushMarker(joined) || isCompositeSilentNoise(joined) || endsWithSilentMarker(joined))) {
+      return true;
+    }
+  }
+  return false;
+}
 function decideTurnFlush(input) {
   const flushEnabled = input.flushEnabled !== false;
   if (!flushEnabled)
@@ -82242,6 +82319,9 @@ function closeFlushCompletionWindows(registry, now) {
   registry?.completeAll?.(now);
   return closed;
 }
+function parkedTurnStartCount() {
+  return parkedTurnStarts.length;
+}
 function drainParkedTurnStartsForChat(deps, chatId, threadId) {
   const wantThread = envThreadIdNum(threadId);
   const drained = [];
@@ -82611,8 +82691,7 @@ function handleSessionEvent(deps, ev) {
       }
       if (QUEUED_CARD_ENABLED && !handbackOwnsSurface) {
         const cardChatId = ev.chatId;
-        const replyToRaw = ev.messageId != null ? Number(ev.messageId) : null;
-        const replyTo = replyToRaw != null && Number.isFinite(replyToRaw) ? replyToRaw : null;
+        const replyTo = parseSourceMessageId(ev.messageId);
         openQueuedCard(deps, cardChatId, enqThreadIdNum ?? null, replyTo).then((cardId) => {
           if (cardId == null)
             return;
@@ -83896,7 +83975,13 @@ function createNarrativeLane(deps) {
         clearActivityCardRecord(ACTIVITY_CARD_STORE_PATH, activityCardStoreFs, statusKey(chat, thread), id);
       }
       await reconcileStatusPin(`fg:${statusKey(chat, thread)}`, chat, { pinned: false });
-      if (CLEAR_STATUS_ON_COMPLETION) {
+      const silentSentinelTurn = isSilentSentinelCardOutcome({
+        replyCalled: turn.replyCalled,
+        lastReplyText: turn.lastReplyText,
+        capturedText: turn.capturedText,
+        finalAnswerEverDelivered: turn.finalAnswerEverDelivered
+      });
+      if (CLEAR_STATUS_ON_COMPLETION || silentSentinelTurn) {
         try {
           await robustApiCall(() => bot.api.deleteMessage(chat, id), { chat_id: chat, ...thread != null ? { threadId: thread } : {}, verb: "activity-summary.delete" });
         } catch (err) {
@@ -87376,7 +87461,8 @@ var HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS = new Set([
   "HINDSIGHT_API_RETAIN_WALL_TIMEOUT",
   "HINDSIGHT_API_CONSOLIDATION_RECALL_MAX_CONCURRENT",
   "HINDSIGHT_MM_REFRESH_MIN_INTERVAL_S",
-  "HINDSIGHT_API_TEMPORAL_LANGUAGES"
+  "HINDSIGHT_API_TEMPORAL_LANGUAGES",
+  "HINDSIGHT_API_TEMPORAL_MAX_QUERY_CHARS"
 ]);
 var HINDSIGHT_WORKER_SLOT_TYPES = [
   "consolidation",
@@ -92780,7 +92866,24 @@ function redeliverBufferedInbound(buffer, agent, send, spool, onDelivered) {
   const pending = buffer.drain(agent);
   let redelivered = 0;
   let rebuffered = 0;
+  let retracted = 0;
   for (const { merged, originals } of planBufferedRedelivery(pending)) {
+    let proceed = true;
+    if (buffer.beforeRedeliver != null) {
+      try {
+        proceed = buffer.beforeRedeliver(merged);
+      } catch (e) {
+        proceed = true;
+        process.stderr.write(`redeliver beforeRedeliver threw \u2014 failing open (deliver): ${String(e)}
+`);
+      }
+    }
+    if (!proceed) {
+      for (const o of originals)
+        spool?.ack(o);
+      retracted += originals.length;
+      continue;
+    }
     let delivered = false;
     try {
       delivered = send(merged);
@@ -92798,7 +92901,7 @@ function redeliverBufferedInbound(buffer, agent, send, spool, onDelivered) {
       rebuffered += originals.length;
     }
   }
-  return { drained: pending.length, redelivered, rebuffered };
+  return { drained: pending.length, redelivered, rebuffered, retracted };
 }
 function isMergeableUserInbound(msg) {
   return msg.type === "inbound" && (msg.meta == null || msg.meta.source == null && msg.meta.button_callback == null);
@@ -92915,10 +93018,167 @@ function createPendingInboundBuffer(opts = {}) {
       for (const q of queues.values())
         n += q.length;
       return n;
+    },
+    beforeRedeliver: opts.beforeRedeliver
+  };
+}
+
+// gateway/represent-guard.ts
+function shouldSuppressRepresent(o, deps) {
+  if (!deps.historyEnabled)
+    return false;
+  if (o.lastRepresentedAt == null) {
+    if (o.openedAt == null)
+      return false;
+    return deps.hasOutboundDeliveredSince(o.chatId, o.openedAt, o.threadId);
+  }
+  return deps.hasOutboundDeliveredSince(o.chatId, o.lastRepresentedAt, o.threadId);
+}
+
+// gateway/represent-delivery-guard.ts
+function makeRepresentRedeliveryGuard(deps) {
+  return (msg) => {
+    if (!deps.enabled)
+      return true;
+    if (msg.meta?.source !== "obligation_represent")
+      return true;
+    const originTurnId = msg.meta?.origin_turn_id;
+    if (originTurnId == null)
+      return true;
+    const o = deps.ledger.get(originTurnId);
+    if (o == null) {
+      deps.log(`telegram gateway: represent retracted at delivery \u2014 obligation already ` + `closed since decision (no re-fire) origin=${originTurnId}
+`);
+      return false;
+    }
+    const suppress = shouldSuppressRepresent(o, {
+      historyEnabled: deps.historyEnabled,
+      hasOutboundDeliveredSince: (chatId, sinceMs, threadId) => deps.hasOutboundDeliveredSince(chatId, sinceMs, threadId, deps.minReplyChars)
+    });
+    if (suppress) {
+      deps.ledger.close(originTurnId);
+      deps.log(`telegram gateway: represent retracted at delivery \u2014 reply landed since ` + `decision (no re-fire) origin=${originTurnId}
+`);
+      return false;
     }
+    return true;
+  };
+}
+var DEFAULT_DRAIN_DEFER_STALE_GAP_MS = 15000;
+function makeSessionBusyDrainDeferral(boundMs, staleGapMs = DEFAULT_DRAIN_DEFER_STALE_GAP_MS) {
+  let deferringSince = null;
+  let lastCallAt = null;
+  return (busy, now) => {
+    const gapSinceLastCall = lastCallAt == null ? null : now - lastCallAt;
+    lastCallAt = now;
+    if (!busy || boundMs <= 0) {
+      deferringSince = null;
+      return false;
+    }
+    if (deferringSince == null || staleGapMs > 0 && gapSinceLastCall != null && gapSinceLastCall > staleGapMs) {
+      deferringSince = now;
+    }
+    return now - deferringSince < boundMs;
   };
 }
 
+// gateway/pending-inbound-buffer.ts
+function redeliverBufferedInbound2(buffer, agent, send, spool, onDelivered) {
+  const pending = buffer.drain(agent);
+  let redelivered = 0;
+  let rebuffered = 0;
+  let retracted = 0;
+  for (const { merged, originals } of planBufferedRedelivery2(pending)) {
+    let proceed = true;
+    if (buffer.beforeRedeliver != null) {
+      try {
+        proceed = buffer.beforeRedeliver(merged);
+      } catch (e) {
+        proceed = true;
+        process.stderr.write(`redeliver beforeRedeliver threw \u2014 failing open (deliver): ${String(e)}
+`);
+      }
+    }
+    if (!proceed) {
+      for (const o of originals)
+        spool?.ack(o);
+      retracted += originals.length;
+      continue;
+    }
+    let delivered = false;
+    try {
+      delivered = send(merged);
+    } catch {
+      delivered = false;
+    }
+    if (delivered) {
+      for (const o of originals)
+        spool?.ack(o);
+      redelivered += originals.length;
+      onDelivered?.(merged, originals);
+    } else {
+      for (const o of originals)
+        buffer.push(agent, o);
+      rebuffered += originals.length;
+    }
+  }
+  return { drained: pending.length, redelivered, rebuffered, retracted };
+}
+function isMergeableUserInbound2(msg) {
+  return msg.type === "inbound" && (msg.meta == null || msg.meta.source == null && msg.meta.button_callback == null);
+}
+function inboundHasMedia2(msg) {
+  return msg.imagePath != null || msg.attachment != null;
+}
+function planBufferedRedelivery2(pending) {
+  const out = [];
+  let run3 = [];
+  let runHasMedia = false;
+  const sameTarget = (a, b) => a.chatId === b.chatId && (a.threadId ?? null) === (b.threadId ?? null) && a.userId === b.userId;
+  const flush = () => {
+    if (run3.length === 0)
+      return;
+    out.push({ merged: run3.length === 1 ? run3[0] : mergeRun2(run3), originals: run3 });
+    run3 = [];
+    runHasMedia = false;
+  };
+  for (const msg of pending) {
+    const msgHasMedia = inboundHasMedia2(msg);
+    const canJoin = run3.length > 0 && isMergeableUserInbound2(msg) && isMergeableUserInbound2(run3[run3.length - 1]) && sameTarget(run3[run3.length - 1], msg) && !(runHasMedia && msgHasMedia);
+    if (!canJoin)
+      flush();
+    run3.push(msg);
+    runHasMedia = runHasMedia || msgHasMedia;
+  }
+  flush();
+  return out;
+}
+var ATTACHMENT_META_RE2 = /^(image_path|attachment_)/;
+function mergeRun2(run3) {
+  const last = run3[run3.length - 1];
+  const mediaEntry = run3.find(inboundHasMedia2);
+  const merged = {
+    ...last,
+    text: run3.map((m) => m.text).join(`
+`)
+  };
+  delete merged.imagePath;
+  delete merged.attachment;
+  if (mediaEntry != null && mediaEntry !== last) {
+    const splicedMeta = { ...merged.meta };
+    for (const [k, v] of Object.entries(mediaEntry.meta)) {
+      if (ATTACHMENT_META_RE2.test(k))
+        splicedMeta[k] = v;
+    }
+    merged.meta = splicedMeta;
+  }
+  if (mediaEntry?.imagePath != null)
+    merged.imagePath = mediaEntry.imagePath;
+  if (mediaEntry?.attachment != null)
+    merged.attachment = mediaEntry.attachment;
+  return merged;
+}
+
 // gateway/cron-session.ts
 var CRON_IDENTITY_SUFFIX = "-cron";
 function cronIdentity(agent) {
@@ -92948,6 +93208,23 @@ function deliverInjectWithFallback(agentName3, meta, send) {
   }
   return { target, delivered: false, fellBackToMain: false };
 }
+function drainCronBridgeOnRegister(client3, buffer, spool, log) {
+  client3.send({ type: "status", status: "agent_connected" });
+  const send = (msg) => {
+    try {
+      client3.send(msg);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const result = redeliverBufferedInbound2(buffer, client3.agentName ?? "", send, spool);
+  if (result.drained > 0 && log != null) {
+    log(`telegram gateway: cron-bridge drain agent=${client3.agentName} ` + `drained=${result.drained} redelivered=${result.redelivered} ` + `rebuffered=${result.rebuffered}
+`);
+  }
+  return result;
+}
 
 // gateway/obligation-ledger.ts
 class ObligationLedger {
@@ -92987,6 +93264,9 @@ class ObligationLedger {
   isOpen(originTurnId) {
     return this.open.has(originTurnId);
   }
+  get(originTurnId) {
+    return this.open.get(originTurnId);
+  }
   hasOpen() {
     return this.open.size > 0;
   }
@@ -94507,86 +94787,6 @@ function formatEventDetail2(event) {
   }
 }
 
-// gateway/pending-inbound-buffer.ts
-function redeliverBufferedInbound2(buffer, agent, send, spool, onDelivered) {
-  const pending = buffer.drain(agent);
-  let redelivered = 0;
-  let rebuffered = 0;
-  for (const { merged, originals } of planBufferedRedelivery2(pending)) {
-    let delivered = false;
-    try {
-      delivered = send(merged);
-    } catch {
-      delivered = false;
-    }
-    if (delivered) {
-      for (const o of originals)
-        spool?.ack(o);
-      redelivered += originals.length;
-      onDelivered?.(merged, originals);
-    } else {
-      for (const o of originals)
-        buffer.push(agent, o);
-      rebuffered += originals.length;
-    }
-  }
-  return { drained: pending.length, redelivered, rebuffered };
-}
-function isMergeableUserInbound2(msg) {
-  return msg.type === "inbound" && (msg.meta == null || msg.meta.source == null && msg.meta.button_callback == null);
-}
-function inboundHasMedia2(msg) {
-  return msg.imagePath != null || msg.attachment != null;
-}
-function planBufferedRedelivery2(pending) {
-  const out = [];
-  let run3 = [];
-  let runHasMedia = false;
-  const sameTarget = (a, b) => a.chatId === b.chatId && (a.threadId ?? null) === (b.threadId ?? null) && a.userId === b.userId;
-  const flush = () => {
-    if (run3.length === 0)
-      return;
-    out.push({ merged: run3.length === 1 ? run3[0] : mergeRun2(run3), originals: run3 });
-    run3 = [];
-    runHasMedia = false;
-  };
-  for (const msg of pending) {
-    const msgHasMedia = inboundHasMedia2(msg);
-    const canJoin = run3.length > 0 && isMergeableUserInbound2(msg) && isMergeableUserInbound2(run3[run3.length - 1]) && sameTarget(run3[run3.length - 1], msg) && !(runHasMedia && msgHasMedia);
-    if (!canJoin)
-      flush();
-    run3.push(msg);
-    runHasMedia = runHasMedia || msgHasMedia;
-  }
-  flush();
-  return out;
-}
-var ATTACHMENT_META_RE2 = /^(image_path|attachment_)/;
-function mergeRun2(run3) {
-  const last = run3[run3.length - 1];
-  const mediaEntry = run3.find(inboundHasMedia2);
-  const merged = {
-    ...last,
-    text: run3.map((m) => m.text).join(`
-`)
-  };
-  delete merged.imagePath;
-  delete merged.attachment;
-  if (mediaEntry != null && mediaEntry !== last) {
-    const splicedMeta = { ...merged.meta };
-    for (const [k, v] of Object.entries(mediaEntry.meta)) {
-      if (ATTACHMENT_META_RE2.test(k))
-        splicedMeta[k] = v;
-    }
-    merged.meta = splicedMeta;
-  }
-  if (mediaEntry?.imagePath != null)
-    merged.imagePath = mediaEntry.imagePath;
-  if (mediaEntry?.attachment != null)
-    merged.attachment = mediaEntry.attachment;
-  return merged;
-}
-
 // gateway/obligation-turn-end.ts
 function decideObligationTurnEnd(finalAnswerDelivered, replyCalled) {
   return finalAnswerDelivered || replyCalled ? "close" : "note-ended";
@@ -95425,6 +95625,9 @@ class ObligationLedger2 {
   isOpen(originTurnId) {
     return this.open.has(originTurnId);
   }
+  get(originTurnId) {
+    return this.open.get(originTurnId);
+  }
   hasOpen() {
     return this.open.size > 0;
   }
@@ -95587,23 +95790,24 @@ function driveEscalation(args) {
   });
 }
 
-// gateway/represent-guard.ts
-function shouldSuppressRepresent(o, deps) {
-  if (!deps.historyEnabled)
-    return false;
-  if (o.lastRepresentedAt == null) {
-    if (o.openedAt == null)
-      return false;
-    return deps.hasOutboundDeliveredSince(o.chatId, o.openedAt, o.threadId);
-  }
-  return deps.hasOutboundDeliveredSince(o.chatId, o.lastRepresentedAt, o.threadId);
-}
-
 // gateway/escalation-bridge-gate.ts
 function shouldDeferEscalationForBridge(deps) {
   return !deps.bridgeAlive;
 }
 
+// gateway/stream-render.ts
+init_history();
+init_rich_send();
+var PARKED_TURN_START_TTL_MS2 = 30 * 60000;
+var QUEUED_CARD_ENABLED2 = process.env.SWITCHROOM_QUEUED_CARD !== "0";
+var BUZZ_ENABLED2 = process.env.BUZZ_ENABLED === "1" || process.env.BUZZ_ENABLED === "true";
+var BUZZ_ORIGIN_STAMP_ACTIVE2 = BUZZ_ENABLED2 && isBuzzTurnRoutingEnabled();
+var parkedTurnStarts2 = [];
+var flushCompletionTracker2 = new FlushCompletionTracker;
+function parkedTurnStartCount2() {
+  return parkedTurnStarts2.length;
+}
+
 // gateway/obligation-wiring.ts
 function createObligationWiring(deps) {
   const {
@@ -95682,7 +95886,9 @@ function createObligationWiring(deps) {
       return;
     const agent = process.env.SWITCHROOM_AGENT_NAME ?? "";
     const now = Date.now();
-    const backgroundWorkActive = OBLIGATION_BACKGROUND_WORK_GRACE_MS > 0 && agentHasInFlightBackgroundWork(now);
+    const liveTurn = getCurrentTurn();
+    const sessionBusy = liveTurn != null && liveTurn.endedAt == null || parkedTurnStartCount2() > 0;
+    const backgroundWorkActive = OBLIGATION_BACKGROUND_WORK_GRACE_MS > 0 && (agentHasInFlightBackgroundWork(now) || sessionBusy);
     const decision = obligationLedger.decideAtIdle(OBLIGATION_ESCALATE_GRACE_MS > 0 || backgroundWorkActive || OBLIGATION_REPRESENT_GRACE_MS > 0 ? {
       now,
       graceMs: OBLIGATION_ESCALATE_GRACE_MS,
@@ -95694,7 +95900,7 @@ function createObligationWiring(deps) {
     if (decision.action === "none" || o == null) {
       if (backgroundWorkActive && obligationLedger.hasOpen() && now - lastBgWorkDeferLogMs > 60000) {
         lastBgWorkDeferLogMs = now;
-        process.stderr.write(`telegram gateway: obligation sweep deferred \u2014 in-flight autonomous sub-agent work ` + `(${obligationLedger.size()} open, bounded ${Math.round(OBLIGATION_BACKGROUND_WORK_GRACE_MS / 60000)}m from receipt)
+        process.stderr.write(`telegram gateway: obligation sweep deferred \u2014 in-flight autonomous sub-agent work ` + `or busy CLI session behind a poke-cleared turn ` + `(${obligationLedger.size()} open, bounded ${Math.round(OBLIGATION_BACKGROUND_WORK_GRACE_MS / 60000)}m from receipt)
 `);
       }
       return;
@@ -99630,6 +99836,14 @@ function determineRestartReason(opts) {
     return "crash";
   return "fresh";
 }
+var BOOT_REASON_REUSE_WINDOW_MS = 5 * 60000;
+function determineBridgeReconnectReason(opts) {
+  const { gatewayStartedAtMs, bootReason, bootReasonReuseWindowMs = BOOT_REASON_REUSE_WINDOW_MS } = opts;
+  if (opts.marker == null && opts.cleanMarker == null && bootReason != null && opts.now - gatewayStartedAtMs < bootReasonReuseWindowMs) {
+    return bootReason;
+  }
+  return determineRestartReason(opts);
+}
 
 // gateway/update-announce.ts
 import { existsSync as existsSync50, mkdirSync as mkdirSync44, openSync as openSync12, closeSync as closeSync12, readFileSync as readFileSync53 } from "node:fs";
@@ -102479,10 +102693,10 @@ function startOutboxSweep(deps) {
 }
 
 // ../src/build-info.ts
-var VERSION2 = "0.20.6";
-var COMMIT_SHA = "4b1ad9b1";
-var COMMIT_DATE = "2026-08-04T07:34:19Z";
-var LATEST_PR = 4340;
+var VERSION2 = "0.20.8";
+var COMMIT_SHA = "a6efc10f";
+var COMMIT_DATE = "2026-08-04T21:38:16Z";
+var LATEST_PR = 4374;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts
@@ -108240,6 +108454,7 @@ var GATEWAY_STARTED_AT_MS = Date.now();
 var BOOT_CARD_ENABLED = process.env.SWITCHROOM_BOOT_CARD !== "false";
 var activeBootCard = null;
 var bootCardPending = false;
+var bootReasonAtStartup = null;
 var ISSUES_CARD_ENABLED = process.env.SWITCHROOM_ISSUES_CARD !== "false";
 var activeIssuesCard = null;
 var activeIssuesWatcher = null;
@@ -108501,7 +108716,8 @@ var pendingInboundBuffer = createPendingInboundBuffer({
     const threadOpts = evThread != null ? { message_thread_id: evThread } : {};
     swallowingApiCall(() => bot.api.sendMessage(chat, "\u23F3 Messages are arriving faster than I can process them. Your messages are saved and will be handled once I finish the current turn \u2014 if any can't be picked up, I'll ask you to resend it.", { ...threadOpts }), { chat_id: chat, verb: "inbound-buffer-eviction" });
   },
-  onHandbackEnqueue: (chatId, threadId, ts) => subagentHandbackMarker.record(chatId, threadId, ts)
+  onHandbackEnqueue: (chatId, threadId, ts) => subagentHandbackMarker.record(chatId, threadId, ts),
+  beforeRedeliver: makeRepresentRedeliveryGuard({ enabled: OBLIGATION_LEDGER_ENABLED, historyEnabled: HISTORY_ENABLED, ledger: obligationLedger, hasOutboundDeliveredSince, minReplyChars: OBLIGATION_REPRESENT_GUARD_MIN_REPLY_CHARS, log: (l) => process.stderr.write(l) })
 });
 function agentHasInFlightBackgroundWork(now) {
   if (countRunningWorkers() > 0)
@@ -108732,13 +108948,7 @@ if (isGatewayMain)
       process.stderr.write(`telegram gateway: bridge registered \u2014 agent=${client3.agentName}
 `);
       if (isCronIdentity(client3.agentName)) {
-        client3.send({ type: "status", status: "agent_connected" });
-        const pending2 = pendingInboundBuffer.drain(client3.agentName ?? "");
-        for (const m of pending2) {
-          try {
-            client3.send(m);
-          } catch {}
-        }
+        drainCronBridgeOnRegister(client3, pendingInboundBuffer, inboundSpool ?? undefined, (l) => process.stderr.write(l));
         return;
       }
       const bridgeUpEffects = client3.agentName != null ? shadowEmit2({ kind: "bridgeUp", at: Date.now() }) : [];
@@ -108785,7 +108995,14 @@ if (isGatewayMain)
 `);
           clearRestartMarker();
         }
-        const reason = determineRestartReason({ marker, cleanMarker, sessionMarker: storedSession, now: nowMs3 });
+        const reason = determineBridgeReconnectReason({
+          marker,
+          cleanMarker,
+          sessionMarker: storedSession,
+          now: nowMs3,
+          gatewayStartedAtMs: GATEWAY_STARTED_AT_MS,
+          bootReason: bootReasonAtStartup
+        });
         const target = resolveBootChatId(marker, markerAgeMs);
         if (target) {
           const { chatId, threadId, ackMsgId } = target;
@@ -109532,12 +109749,16 @@ if (isGatewayMain)
     }
   })();
 var IDLE_DRAIN_INTERVAL_MS = 5000;
+var idleDrainBusyDefer = makeSessionBusyDrainDeferral(OBLIGATION_BACKGROUND_WORK_GRACE_MS, IDLE_DRAIN_INTERVAL_MS * 3);
 if (isGatewayMain && !STATIC) {
   setInterval(() => {
     const selfAgent = process.env.SWITCHROOM_AGENT_NAME ?? "";
     const r = idleDrainTick(pendingInboundBuffer, selfAgent, () => {
       if (turnInFlightForGate())
         return false;
+      const sessionBusy = currentTurn != null && currentTurn.endedAt == null || parkedTurnStartCount() > 0;
+      if (idleDrainBusyDefer(sessionBusy, Date.now()))
+        return false;
       const c = ipcServer.getClient(selfAgent);
       return c != null && c.isAlive();
     }, (m) => ipcServer.sendToAgent(selfAgent, m), inboundSpool, trackRedeliveredInbound);
@@ -116047,6 +116268,7 @@ async function startGateway() {
           } else {
             const markerAgeMs = marker ? nowMs3 - marker.ts : undefined;
             const reason = determineRestartReason({ marker, cleanMarker, sessionMarker: storedSession, now: nowMs3 });
+            bootReasonAtStartup = reason;
             const target = resolveBootChatId(marker, markerAgeMs);
             if (reason === "crash") {
               const cleanMarkerStale = cleanMarker ? !shouldSuppressRecoveryBanner(cleanMarker, nowMs3, DEFAULT_MAX_AGE_MS) : false;