switchroom 0.20.7 → 0.20.9

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

@@ -11329,7 +11329,8 @@ var init_protocol = __esm(() => {
     v: exports_external.literal(PROTOCOL_VERSION),
     op: exports_external.literal("mark-throttled"),
     id: exports_external.string().min(1),
-    until: exports_external.number().int().positive()
+    until: exports_external.number().int().positive(),
+    probeOnly: exports_external.boolean().optional()
   });
   RefreshAccountRequestSchema = exports_external.object({
     v: exports_external.literal(PROTOCOL_VERSION),
@@ -11725,12 +11726,13 @@ class AuthBrokerClient {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID2(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }
@@ -13480,12 +13482,27 @@ var init_dollar_math_guard = __esm(() => {
 });
 
 // render/emphasis-guard.ts
+function isLineLeadingBullet(text, starIndex) {
+  const next = text[starIndex + 1];
+  if (next !== " " && next !== "\t")
+    return false;
+  let i = starIndex - 1;
+  let indent = 0;
+  while (i >= 0 && (text[i] === " " || text[i] === "\t")) {
+    if (++indent > 3)
+      return false;
+    i--;
+  }
+  return i < 0 || text[i] === `
+`;
+}
 function guardAccidentalEmphasis(text) {
   if (!text.includes("_") && !text.includes("*"))
     return text;
   const segments = splitProtectedSegments(text);
   let hasIntraUnderscore = false;
   let hasIntraAsterisk = false;
+  let hasBoundaryAsterisk = false;
   let underscoreCount = 0;
   let asteriskCount = 0;
   for (const seg of segments) {
@@ -13495,14 +13512,24 @@ function guardAccidentalEmphasis(text) {
       hasIntraUnderscore = true;
     if (INTRA_WORD_ASTERISK.test(seg.text))
       hasIntraAsterisk = true;
+    if (!hasBoundaryAsterisk) {
+      for (const m of seg.text.matchAll(BOUNDARY_FLANKED_ASTERISK)) {
+        if (!isLineLeadingBullet(seg.text, m.index ?? 0)) {
+          hasBoundaryAsterisk = true;
+          break;
+        }
+      }
+    }
     underscoreCount += seg.text.match(ANY_UNDERSCORE)?.length ?? 0;
     asteriskCount += seg.text.match(ANY_ASTERISK)?.length ?? 0;
   }
   INTRA_WORD_UNDERSCORE.lastIndex = 0;
   INTRA_WORD_ASTERISK.lastIndex = 0;
+  BOUNDARY_FLANKED_ASTERISK.lastIndex = 0;
   const armUnderscore = hasIntraUnderscore && underscoreCount >= 2;
   const armAsterisk = hasIntraAsterisk && asteriskCount >= 2;
-  if (!armUnderscore && !armAsterisk)
+  const armBoundaryAsterisk = hasBoundaryAsterisk;
+  if (!armUnderscore && !armAsterisk && !armBoundaryAsterisk)
     return text;
   return segments.map((seg) => {
     if (seg.code)
@@ -13512,13 +13539,17 @@ function guardAccidentalEmphasis(text) {
       out = out.replace(INTRA_WORD_UNDERSCORE, "\\_");
     if (armAsterisk)
       out = out.replace(INTRA_WORD_ASTERISK, "\\*");
+    if (armBoundaryAsterisk) {
+      out = out.replace(BOUNDARY_FLANKED_ASTERISK, (m, offset, str) => isLineLeadingBullet(str, offset) ? m : "\\*");
+    }
     return out;
   }).join("");
 }
-var INTRA_WORD_UNDERSCORE, INTRA_WORD_ASTERISK, ANY_UNDERSCORE, ANY_ASTERISK;
+var INTRA_WORD_UNDERSCORE, INTRA_WORD_ASTERISK, BOUNDARY_FLANKED_ASTERISK, ANY_UNDERSCORE, ANY_ASTERISK;
 var init_emphasis_guard = __esm(() => {
   INTRA_WORD_UNDERSCORE = /(?<=[A-Za-z0-9])_(?=[A-Za-z0-9])/g;
   INTRA_WORD_ASTERISK = /(?<=[A-Za-z0-9])\*(?=[A-Za-z0-9])/g;
+  BOUNDARY_FLANKED_ASTERISK = /(?<=^|\s)\*(?=\s|$)/g;
   ANY_UNDERSCORE = /(?<!\\)_/g;
   ANY_ASTERISK = /(?<!\\)\*/g;
 });
@@ -13569,7 +13600,7 @@ function guardAccidentalBlockConstructs(text) {
   return out;
 }
 function escapeAccidentalHeadingLine(line) {
-  return line.replace(ACCIDENTAL_HEADING, "$1\\$2");
+  return line.replace(ACCIDENTAL_HEADING, "$1\\$2").replace(ACCIDENTAL_HEADING_AFTER_MARKER, "$1\\$2");
 }
 function guardAccidentalHeading(text) {
   if (!text.includes("#"))
@@ -13599,11 +13630,12 @@ function guardAccidentalHeading(text) {
   }
   return out;
 }
-var ACCIDENTAL_BLOCKQUOTE, ACCIDENTAL_ORDERED_LIST, ACCIDENTAL_HEADING;
+var ACCIDENTAL_BLOCKQUOTE, ACCIDENTAL_ORDERED_LIST, ACCIDENTAL_HEADING, ACCIDENTAL_HEADING_AFTER_MARKER;
 var init_line_start_guard = __esm(() => {
   ACCIDENTAL_BLOCKQUOTE = /^>[0-9=]/;
   ACCIDENTAL_ORDERED_LIST = /^(\d{4,})([.)])(\s|$)/;
   ACCIDENTAL_HEADING = /^([ \t]{0,3})(#{1,6})(?=[^\s#])/;
+  ACCIDENTAL_HEADING_AFTER_MARKER = /^([ \t]{0,3}(?:(?:[-*+]|\d{1,3}[.)])[ \t]+|>[ \t]*)+)(#{1,6})(?=[^\s#])/;
 });
 
 // render/inline-pairs-guard.ts
@@ -22593,6 +22625,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 +22648,39 @@ function deriveOverlayTitle(raw, fileName) {
     return;
   return base.length > 0 ? base : undefined;
 }
+function readOverlayFile(agentName, file, agentCfg, warnings, source) {
+  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, source });
+    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 +22718,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, source: "schedule" });
+        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, "schedule");
+          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 +22770,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, source: "skills" });
+        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, "skills");
+          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 +22816,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 +22824,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
@@ -39556,6 +39649,22 @@ function redactAuthCodeMessage(api, chatId, messageId, log) {
 
 // ask-user.ts
 import { randomBytes as randomBytes2 } from "crypto";
+
+// gateway/source-message-id.ts
+var MAX_TELEGRAM_MESSAGE_ID = 2 ** 31;
+function parseSourceMessageId(raw) {
+  if (raw == null)
+    return null;
+  const s = String(raw);
+  if (!/^\d+$/.test(s))
+    return null;
+  const n = Number(s);
+  if (!Number.isSafeInteger(n) || n <= 0 || n >= MAX_TELEGRAM_MESSAGE_ID)
+    return null;
+  return n;
+}
+
+// ask-user.ts
 var ASK_USER_DEFAULT_TIMEOUT_MS = 300000;
 var ASK_USER_MAX_TIMEOUT_MS = 1800000;
 var ASK_USER_MIN_TIMEOUT_MS = 5000;
@@ -39592,13 +39701,7 @@ function validateAskUserArgs(args) {
       throw new Error("ask_user: message_thread_id must be a positive integer string");
     }
   }
-  let replyTo;
-  if (args.reply_to != null) {
-    replyTo = Number(args.reply_to);
-    if (!Number.isFinite(replyTo) || replyTo <= 0) {
-      throw new Error("ask_user: reply_to must be a positive integer string");
-    }
-  }
+  const replyTo = parseSourceMessageId(args.reply_to) ?? undefined;
   let timeoutMs = args.timeout_ms ?? ASK_USER_DEFAULT_TIMEOUT_MS;
   if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs)) {
     throw new Error("ask_user: timeout_ms must be a number");
@@ -39678,6 +39781,7 @@ function applyChecklistPatch(cl, patch) {
   return { title: patch.title ?? cl.title, tasks };
 }
 function buildNativeChecklistPayload(p) {
+  const replyAnchor = parseSourceMessageId(p.replyToMessageId);
   return {
     business_connection_id: p.businessConnectionId,
     chat_id: p.chatId,
@@ -39685,7 +39789,7 @@ function buildNativeChecklistPayload(p) {
       title: p.title,
       tasks: p.tasks.map((t) => ({ id: t.id, text: t.text }))
     },
-    ...p.replyToMessageId != null ? { reply_parameters: { message_id: p.replyToMessageId } } : {},
+    ...replyAnchor != null ? { reply_parameters: { message_id: replyAnchor } } : {},
     ...p.protectContent === true ? { protect_content: true } : {}
   };
 }
@@ -39969,13 +40073,7 @@ function resolveStickerSendArgs(raw, aliasMap) {
       throw new Error("send_sticker: message_thread_id must be a positive integer string");
     }
   }
-  let replyTo;
-  if (raw.reply_to != null) {
-    replyTo = Number(raw.reply_to);
-    if (!Number.isFinite(replyTo) || replyTo <= 0) {
-      throw new Error("send_sticker: reply_to must be a positive integer string");
-    }
-  }
+  const replyTo = parseSourceMessageId(raw.reply_to) ?? undefined;
   return {
     chatId: raw.chat_id,
     fileId,
@@ -40027,13 +40125,7 @@ function resolveGifSendArgs(raw) {
       throw new Error("send_gif: message_thread_id must be a positive integer string");
     }
   }
-  let replyTo;
-  if (raw.reply_to != null) {
-    replyTo = Number(raw.reply_to);
-    if (!Number.isFinite(replyTo) || replyTo <= 0) {
-      throw new Error("send_gif: reply_to must be a positive integer string");
-    }
-  }
+  const replyTo = parseSourceMessageId(raw.reply_to) ?? undefined;
   return {
     chatId: raw.chat_id,
     animationRef,
@@ -50147,6 +50239,20 @@ class PinRightsCache2 {
   }
 }
 
+// gateway/source-message-id.ts
+var MAX_TELEGRAM_MESSAGE_ID2 = 2 ** 31;
+function parseSourceMessageId2(raw) {
+  if (raw == null)
+    return null;
+  const s = String(raw);
+  if (!/^\d+$/.test(s))
+    return null;
+  const n = Number(s);
+  if (!Number.isSafeInteger(n) || n <= 0 || n >= MAX_TELEGRAM_MESSAGE_ID2)
+    return null;
+  return n;
+}
+
 // gateway/permission-timeout.ts
 var SIGNATURE_SEP = String.fromCharCode(0);
 function permissionSignature(toolName, inputPreview) {
@@ -51160,7 +51266,7 @@ function createAuthBrokerClient() {
     listState: () => broker.listState(),
     setActive: (label) => broker.setActive(label),
     markExhausted: (until) => broker.markExhausted(until),
-    markThrottled: (until) => broker.markThrottled(until),
+    markThrottled: (until, probeOnly) => broker.markThrottled(until, probeOnly),
     rmAccount: (label) => broker.rmAccount(label),
     refreshAccount: (label) => broker.refreshAccount(label),
     setOverride: (agent, account) => broker.setOverride(agent, account),
@@ -73918,7 +74024,7 @@ function createAuthBrokerClient2() {
     listState: () => broker.listState(),
     setActive: (label) => broker.setActive(label),
     markExhausted: (until) => broker.markExhausted(until),
-    markThrottled: (until) => broker.markThrottled(until),
+    markThrottled: (until, probeOnly) => broker.markThrottled(until, probeOnly),
     rmAccount: (label) => broker.rmAccount(label),
     refreshAccount: (label) => broker.refreshAccount(label),
     setOverride: (agent, account) => broker.setOverride(agent, account),
@@ -74337,12 +74443,13 @@ class AuthBrokerClient2 {
     const data = await this.send(req);
     return data;
   }
-  async markThrottled(until) {
+  async markThrottled(until, probeOnly = false) {
     const data = await this.send({
       v: PROTOCOL_VERSION,
       id: randomUUID5(),
       op: "mark-throttled",
-      until
+      until,
+      ...probeOnly ? { probeOnly: true } : {}
     });
     return data;
   }
@@ -77042,6 +77149,15 @@ function classify429Detail2(text4) {
     return "litellm-local";
   return "generic-transient";
 }
+function classification429WarrantsCorroboration(classification) {
+  return classification === "generic-transient";
+}
+function routeRateLimit429(classification, runner, agent) {
+  if (!classification429WarrantsCorroboration(classification))
+    return false;
+  runner.fireProbeOnly(agent);
+  return true;
+}
 function build429ClassifiedMetric(opts) {
   const detail = typeof opts.detail === "string" ? opts.detail : "";
   const litellm = parseLitellmLimitDetail(detail, new Date(opts.now));
@@ -77138,6 +77254,12 @@ function createThrottleTierRunner(deps) {
       deps.log(`[throttle-tier] resume suppressed (${verdict}) reason=${reason}`);
     }
   }
+  async function announceEscalation(client3, account, rolledTo, triggerAgent, armedAtMs) {
+    deps.log(`[throttle-tier] escalated to wall account=${account ?? "?"} ` + `rolledTo=${rolledTo ?? "none (all blocked)"}`);
+    await broadcastDeduped(client3, "throttle-escalation", account, renderThrottleEscalationNotice({ account, agent: triggerAgent, rolledTo }));
+    if (rolledTo)
+      nudgeResume("throttle-escalation-resume", armedAtMs);
+  }
   async function fire(triggerAgent, throttledUntilMs, resetParsed) {
     const armedAtMs = now();
     let client3 = null;
@@ -77158,10 +77280,7 @@ function createThrottleTierRunner(deps) {
       deps.log(`[throttle-tier] markThrottled failed agent=${triggerAgent}: ${err?.message ?? err}`);
     }
     if (escalated) {
-      deps.log(`[throttle-tier] escalated to wall account=${account ?? "?"} ` + `rolledTo=${rolledTo ?? "none (all blocked)"}`);
-      await broadcastDeduped(client3, "throttle-escalation", account, renderThrottleEscalationNotice({ account, agent: triggerAgent, rolledTo }));
-      if (rolledTo)
-        nudgeResume("throttle-escalation-resume", armedAtMs);
+      await announceEscalation(client3, account, rolledTo, triggerAgent, armedAtMs);
       return;
     }
     const cooldownKey = account ?? `agent:${triggerAgent}`;
@@ -77186,8 +77305,34 @@ function createThrottleTierRunner(deps) {
       nudgeResume("throttle-retry-resume", armedAtMs);
     }, delayMs);
   }
+  async function fireProbeOnly(triggerAgent) {
+    const armedAtMs = now();
+    let client3 = null;
+    let account = null;
+    let escalated = false;
+    let rolledTo = null;
+    try {
+      client3 = await deps.getBrokerClient();
+      if (client3) {
+        const r = await client3.markThrottled(now() + 1, true);
+        account = r.account;
+        escalated = r.escalated;
+        rolledTo = r.rolledTo ?? null;
+      } else {
+        deps.log(`[throttle-tier] broker unreachable \u2014 probe-only skipped agent=${triggerAgent}`);
+      }
+    } catch (err) {
+      deps.log(`[throttle-tier] probe-only markThrottled failed agent=${triggerAgent}: ${err?.message ?? err}`);
+    }
+    if (escalated) {
+      await announceEscalation(client3, account, rolledTo, triggerAgent, armedAtMs);
+      return;
+    }
+    deps.log(`[throttle-tier] generic-transient probe-only inert (no wall) agent=${triggerAgent}`);
+  }
   return {
     fire,
+    fireProbeOnly,
     inspect: () => ({ noticeState, nudgePending: pendingNudge != null })
   };
 }
@@ -79396,6 +79541,26 @@ function stampsHandbackMarker(source) {
   return known.decoupledCompletion;
 }
 var HANDBACK_RECENCY_WINDOW_MS = 60000;
+var TASK_NOTIFICATION_DEDUP_TTL_MS = 30000;
+var NOTIF_TERMINAL_STATUSES = new Set(["completed", "failed", "killed"]);
+
+class CliTaskNotificationLedger {
+  seen = new Map;
+  record(taskId, status, now) {
+    if (taskId.length === 0 || !NOTIF_TERMINAL_STATUSES.has(status))
+      return;
+    this.seen.set(taskId, now);
+    for (const [id, ts] of this.seen) {
+      if (now - ts > TASK_NOTIFICATION_DEDUP_TTL_MS)
+        this.seen.delete(id);
+    }
+  }
+  seenRecently(taskId, now) {
+    const ts = this.seen.get(taskId);
+    return ts != null && now - ts <= TASK_NOTIFICATION_DEDUP_TTL_MS;
+  }
+}
+var cliTaskNotifLedger = new CliTaskNotificationLedger;
 var MAIN_THREAD_KEY = "<main>";
 
 class SubagentHandbackMarker {
@@ -80144,7 +80309,7 @@ async function sendReply(deps, req) {
   }
   const files = args.files ?? [];
   const quoteOptIn = args.quote !== false;
-  let reply_to = args.reply_to != null ? Number(args.reply_to) : undefined;
+  let reply_to = parseSourceMessageId(args.reply_to) ?? undefined;
   const protectContent = args.protect_content === true;
   const quoteText = args.quote_text;
   const access = loadAccess();
@@ -80949,6 +81114,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)
@@ -81934,20 +82115,6 @@ function formatEventDetail(event) {
   }
 }
 
-// gateway/source-message-id.ts
-var MAX_TELEGRAM_MESSAGE_ID = 2 ** 31;
-function parseSourceMessageId(raw) {
-  if (raw == null)
-    return null;
-  const s = String(raw);
-  if (!/^\d+$/.test(s))
-    return null;
-  const n = Number(s);
-  if (!Number.isSafeInteger(n) || n <= 0 || n >= MAX_TELEGRAM_MESSAGE_ID)
-    return null;
-  return n;
-}
-
 // gateway/status-surface-log.ts
 function formatTurnLifecycle(action, reason, t, now) {
   const ageMs = action === "clear" ? Math.max(0, now - t.startedAt) : 0;
@@ -82614,8 +82781,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;
@@ -83899,7 +84065,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) {
@@ -84148,6 +84320,26 @@ function isTurnFlushSafetyEnabled(env = process.env) {
 }
 
 // gateway/subagent-handback-marker.ts
+var TASK_NOTIFICATION_DEDUP_TTL_MS2 = 30000;
+var NOTIF_TERMINAL_STATUSES2 = new Set(["completed", "failed", "killed"]);
+
+class CliTaskNotificationLedger2 {
+  seen = new Map;
+  record(taskId, status, now) {
+    if (taskId.length === 0 || !NOTIF_TERMINAL_STATUSES2.has(status))
+      return;
+    this.seen.set(taskId, now);
+    for (const [id, ts] of this.seen) {
+      if (now - ts > TASK_NOTIFICATION_DEDUP_TTL_MS2)
+        this.seen.delete(id);
+    }
+  }
+  seenRecently(taskId, now) {
+    const ts = this.seen.get(taskId);
+    return ts != null && now - ts <= TASK_NOTIFICATION_DEDUP_TTL_MS2;
+  }
+}
+var cliTaskNotifLedger2 = new CliTaskNotificationLedger2;
 var MAIN_THREAD_KEY2 = "<main>";
 
 class SubagentHandbackMarker2 {
@@ -92982,19 +93174,121 @@ function makeRepresentRedeliveryGuard(deps) {
     return true;
   };
 }
-function makeSessionBusyDrainDeferral(boundMs) {
+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)
+    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) {
@@ -93024,6 +93318,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 {
@@ -94586,103 +94897,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;
-  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/obligation-turn-end.ts
 function decideObligationTurnEnd(finalAnswerDelivered, replyCalled) {
   return finalAnswerDelivered || replyCalled ? "close" : "note-ended";
@@ -96907,6 +97121,9 @@ function decideSubagentHandback(input) {
   if (!input.isBackground) {
     return { deliver: false, reason: "foreground" };
   }
+  if (input.cliTaskNotificationSeen === true) {
+    return { deliver: false, reason: "cli-task-notification" };
+  }
   const chatId = input.fleetChatId || input.ownerChatId;
   if (!chatId) {
     return { deliver: false, reason: "no-chat" };
@@ -99732,6 +99949,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";
@@ -102581,10 +102806,10 @@ function startOutboxSweep(deps) {
 }
 
 // ../src/build-info.ts
-var VERSION2 = "0.20.7";
-var COMMIT_SHA = "bc107185";
-var COMMIT_DATE = "2026-08-04T10:20:28Z";
-var LATEST_PR = 4343;
+var VERSION2 = "0.20.9";
+var COMMIT_SHA = "63c4c44b";
+var COMMIT_DATE = "2026-08-05T03:51:28Z";
+var LATEST_PR = 4388;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts
@@ -107761,6 +107986,7 @@ function emitGatewayOperatorEvent(event) {
       agent,
       shouldEmitCard: (a) => shouldEmitOperatorEvent(a, "rate-limited")
     });
+    routeRateLimit429(rateLimit429Classification, throttleTierRunner, agent);
     if (surface === "litellm-local-notice") {
       process.stderr.write(`telegram gateway: 429 classified litellm-proxy-local agent=${agent} \u2014 ` + `calm path, no account attribution, no failover
 `);
@@ -108342,6 +108568,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;
@@ -108835,13 +109062,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() }) : [];
@@ -108888,7 +109109,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;
@@ -109036,6 +109264,8 @@ if (isGatewayMain)
         }
       }
       const ev = msg.event;
+      if (ev.kind === "task_notification")
+        cliTaskNotifLedger2.record(ev.taskId, ev.status, Date.now());
       handleSessionEvent2(ev);
       toolFlightTracker.onEvent(ev);
       if (pendingDeferredInterrupt != null && !toolFlightTracker.isMidToolCall()) {
@@ -109635,7 +109865,7 @@ if (isGatewayMain)
     }
   })();
 var IDLE_DRAIN_INTERVAL_MS = 5000;
-var idleDrainBusyDefer = makeSessionBusyDrainDeferral(OBLIGATION_BACKGROUND_WORK_GRACE_MS);
+var idleDrainBusyDefer = makeSessionBusyDrainDeferral(OBLIGATION_BACKGROUND_WORK_GRACE_MS, IDLE_DRAIN_INTERVAL_MS * 3);
 if (isGatewayMain && !STATIC) {
   setInterval(() => {
     const selfAgent = process.env.SWITCHROOM_AGENT_NAME ?? "";
@@ -109753,7 +109983,7 @@ async function executeSendChecklist(args) {
   if (!Array.isArray(tasks) || tasks.length === 0)
     throw new Error("send_checklist: tasks must be a non-empty array");
   const threadId = args.message_thread_id != null ? Number(args.message_thread_id) : undefined;
-  const replyTo = args.reply_to != null ? Number(args.reply_to) : undefined;
+  const replyTo = parseSourceMessageId2(args.reply_to) ?? undefined;
   const protectContent = args.protect_content === true;
   assertAllowedChat(chat_id);
   const { title: redactedTitle, tasks: redactedTasks } = redactChecklistFields(title, tasks, (t) => redactOutboundText(t, "send_checklist"));
@@ -116154,6 +116384,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;
@@ -116600,11 +116831,12 @@ async function startGateway() {
                   ownerChatId: hbOwnerDm,
                   taskDescription: description2,
                   resultText,
-                  jsonlAgentId: agentId
+                  jsonlAgentId: agentId,
+                  cliTaskNotificationSeen: cliTaskNotifLedger2.seenRecently(agentId, Date.now())
                 });
                 if (!decision.deliver) {
-                  if (decision.reason === "no-chat") {
-                    process.stderr.write(`telegram gateway: subagent-handback ${agentId} \u2014 no chat to deliver to; skipped
+                  if (decision.reason === "no-chat" || decision.reason === "cli-task-notification") {
+                    process.stderr.write(`telegram gateway: subagent-handback ${agentId} skipped \u2014 ${decision.reason === "no-chat" ? "no chat to deliver to" : "CLI task-notification already woke the parent for this completion (double-wake dedup)"}
 `);
                   }
                   return;