switchroom 0.15.40 → 0.15.42

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

@@ -23922,6 +23922,8 @@ var init_schema = __esm(() => {
       max_memories: exports_external.number().int().min(0).optional().describe("Cap on the number of memories injected into the prompt by " + "auto-recall, regardless of token budget. Plugin default is 12. " + "0 disables the cap (all memories Hindsight returns are injected)."),
       cache_ttl_secs: exports_external.number().int().min(0).optional().describe("Per-session recall cache TTL in seconds. When > 0, identical " + "(prompt, bank) within the same session reuse the cached recall " + "result instead of round-tripping to Hindsight. 0 disables. " + "Default is 600 (10 min) for switchroom-managed agents."),
       min_overlap: exports_external.number().min(0).max(1).optional().describe("Minimum Jaccard token overlap [0.0\u20131.0] between the user " + "prompt and a memory's text for the memory to be injected. " + "Drops low-relevance matches before the count cap so weak hits " + "don't fill the slot on real queries. 0.0 disables (default \u2014 " + "current behaviour). Try 0.10\u20130.20 to start; observe the " + "`overlap_dropped` field via `switchroom memory recall-log`."),
+      types: exports_external.array(exports_external.string()).optional().describe("Hindsight fact types to recall. Switchroom default is " + '["world", "experience", "observation"] \u2014 the synthesized ' + "`observation` tier is on by default. Set to " + '["world", "experience"] to opt out of observation-backed ' + "recall for this agent (or fleet-wide under defaults)."),
+      skip_trivial: exports_external.boolean().optional().describe("Skip recall on plausibly-stateless trivial turns (time/date/" + "greeting). Switchroom default true \u2014 saves the recall arm + " + "injected tokens on turns that never need memory, guarded so it " + "never skips a turn that references user/project/session state. " + "Set false to always run recall."),
       topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional().describe("Supergroup-mode cross-topic memory behaviour. Default " + "(unset) \u2192 soft-preamble: recall returns memories from all " + "topics, and a 'Current topic: \u2026' preamble tells the model " + "to self-scope. hard-filter: drop any recalled memory whose " + "metadata.thread_id differs from the active inbound's topic. " + "Flip to hard-filter when the recall_log shows binding " + "failures (model surfacing the right memory but applying " + "it to the wrong topic).")
     }).optional().describe("Auto-recall tuning knobs")
   }).optional();
@@ -23958,7 +23960,8 @@ var init_schema = __esm(() => {
   SessionSchema = exports_external.object({
     max_idle: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '2h', '30m')").optional().describe("Start a fresh session if the previous one has been idle " + "longer than this duration. Examples: '2h', '30m', '7200s'."),
     max_turns: exports_external.number().int().positive().optional().describe("Start a fresh session if the previous one has more user " + "turns than this. Useful for preventing context bloat on " + "long-running agents."),
-    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context.")
+    max_context_tokens: exports_external.number().int().positive().optional().describe("Proactively run /compact when the live context window " + "occupancy (latest assistant turn input + cache-read + " + "cache-creation tokens) reaches this many tokens. Opt-in: " + "unset means rely on Claude Code's native auto-compaction. " + "Useful on large-window models (e.g. 1M Opus) to hold a " + "deliberately lean working context."),
+    idle_clear_after: exports_external.string().regex(/^\d+[smh]$/, "Duration must be a number followed by s, m, or h (e.g. '3h', '90m')").optional().describe("Auto-run /clear (wipe the working context) after the live " + "session has been idle this long. Defaults to '3h' when unset " + "(on by default); set '0s' to disable. Long-term memory lives " + "in Hindsight, so a clear loses only the in-session thread.")
   }).optional();
   SessionContinuitySchema = exports_external.object({
     enabled: exports_external.boolean().optional().describe("Master switch for the session-handoff briefing (default true)."),
@@ -28926,10 +28929,10 @@ function renderAuthLine(state4, agentName3, now = Date.now()) {
 }
 
 // gateway/quota-cache.ts
-import { existsSync as existsSync26, readFileSync as readFileSync24, writeFileSync as writeFileSync15, mkdirSync as mkdirSync16 } from "fs";
-import { join as join23, dirname as dirname8 } from "path";
+import { existsSync as existsSync26, readFileSync as readFileSync24, writeFileSync as writeFileSync16, mkdirSync as mkdirSync17 } from "fs";
+import { join as join24, dirname as dirname8 } from "path";
 function defaultCachePath() {
-  return process.env.SWITCHROOM_QUOTA_CACHE_PATH ?? join23(process.env.HOME ?? "/tmp", ".switchroom", "quota-cache.json");
+  return process.env.SWITCHROOM_QUOTA_CACHE_PATH ?? join24(process.env.HOME ?? "/tmp", ".switchroom", "quota-cache.json");
 }
 function readQuotaCache(opts = {}) {
   const path = opts.path ?? defaultCachePath();
@@ -28964,8 +28967,8 @@ function writeQuotaCache(result, opts = {}) {
     result
   };
   try {
-    mkdirSync16(dirname8(path), { recursive: true });
-    writeFileSync15(path, JSON.stringify(entry, null, 2), { mode: 384 });
+    mkdirSync17(dirname8(path), { recursive: true });
+    writeFileSync16(path, JSON.stringify(entry, null, 2), { mode: 384 });
   } catch {}
 }
 var DEFAULT_TTL_MS4, RATE_LIMIT_TTL_MS;
@@ -28976,7 +28979,7 @@ var init_quota_cache = __esm(() => {
 
 // gateway/boot-probes.ts
 import { readFileSync as readFileSync25, readdirSync as readdirSync4, existsSync as existsSync27 } from "fs";
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 import { execFile as execFileCb } from "child_process";
 import { promisify as promisify3 } from "util";
 async function withTimeout(label, p, timeoutMs = PROBE_TIMEOUT_MS) {
@@ -29018,8 +29021,8 @@ function mapPlan(billingType, hasExtra) {
 }
 async function probeAccount(agentDir) {
   return withTimeout("Account", (async () => {
-    const claudeDir = join24(agentDir, ".claude");
-    const claudeJsonPath = join24(claudeDir, ".claude.json");
+    const claudeDir = join25(agentDir, ".claude");
+    const claudeJsonPath = join25(claudeDir, ".claude.json");
     let cfg = {};
     try {
       const raw = readFileSync25(claudeJsonPath, "utf8");
@@ -29040,8 +29043,8 @@ async function probeAccount(agentDir) {
     let tokenStr = "";
     let status = "ok";
     for (const candidate of [
-      join24(claudeDir, ".oauth-token.meta.json"),
-      join24(claudeDir, "accounts", "default", ".oauth-token.meta.json")
+      join25(claudeDir, ".oauth-token.meta.json"),
+      join25(claudeDir, "accounts", "default", ".oauth-token.meta.json")
     ]) {
       if (existsSync27(candidate)) {
         try {
@@ -29427,9 +29430,9 @@ async function probeQuota(claudeConfigDir, _agentDir, fetchImpl = fetch, opts =
       let claudeDirForProbe = null;
       for (const candidate of [
         claudeConfigDir,
-        join24(claudeConfigDir, "accounts", "default")
+        join25(claudeConfigDir, "accounts", "default")
       ]) {
-        if (existsSync27(join24(candidate, ".oauth-token"))) {
+        if (existsSync27(join25(candidate, ".oauth-token"))) {
           claudeDirForProbe = candidate;
           break;
         }
@@ -29664,7 +29667,7 @@ async function probeSkills(agentDir, opts = {}) {
   return withTimeout("Skills", (async () => {
     const fs2 = opts.fs ?? realSkillsFs;
     const max = opts.maxNamesShown ?? 3;
-    const skillsDir = join24(agentDir, ".claude", "skills");
+    const skillsDir = join25(agentDir, ".claude", "skills");
     if (!fs2.exists(skillsDir)) {
       return { status: "ok", label: "Skills", detail: "no skills dir" };
     }
@@ -29679,17 +29682,17 @@ async function probeSkills(agentDir, opts = {}) {
     }
     const dangling = [];
     for (const name of entries) {
-      const skillPath = join24(skillsDir, name);
+      const skillPath = join25(skillsDir, name);
       if (!fs2.exists(skillPath)) {
         dangling.push(name);
         continue;
       }
-      const skillMd = join24(skillPath, "SKILL.md");
+      const skillMd = join25(skillPath, "SKILL.md");
       if (!fs2.exists(skillMd) && !fs2.exists(skillPath + ".md")) {
         continue;
       }
     }
-    const overlayDir = opts.overlaySkillsDir ?? join24(agentDir, "skills.d");
+    const overlayDir = opts.overlaySkillsDir ?? join25(agentDir, "skills.d");
     const overlaySlugs = new Set;
     if (fs2.exists(overlayDir)) {
       let overlayEntries = [];
@@ -29731,7 +29734,7 @@ function renderBucketedSkills(switchroom, agent) {
 }
 async function probeConnections(agentDir, opts = {}) {
   return withTimeout("Connections", (async () => {
-    const path = join24(agentDir, ".claude", "connection-health.json");
+    const path = join25(agentDir, ".claude", "connection-health.json");
     const read = opts.readFileImpl ?? ((p) => readFileSync25(p, "utf8"));
     let issues = [];
     try {
@@ -29780,7 +29783,7 @@ var init_boot_probes = __esm(() => {
 });
 
 // gateway/boot-issue-cache.ts
-import { existsSync as existsSync28, readFileSync as readFileSync26, writeFileSync as writeFileSync16, mkdirSync as mkdirSync17, renameSync as renameSync9 } from "fs";
+import { existsSync as existsSync28, readFileSync as readFileSync26, writeFileSync as writeFileSync17, mkdirSync as mkdirSync18, renameSync as renameSync9 } from "fs";
 import { dirname as dirname9 } from "path";
 function fingerprintProbe(key, r) {
   if (r.status === "ok")
@@ -29907,9 +29910,9 @@ function applyAndSave(path, cache, diff) {
     }
   }
   try {
-    mkdirSync17(dirname9(path), { recursive: true });
+    mkdirSync18(dirname9(path), { recursive: true });
     const tmp = `${path}.tmp`;
-    writeFileSync16(tmp, JSON.stringify(next), { mode: 384 });
+    writeFileSync17(tmp, JSON.stringify(next), { mode: 384 });
     renameSync9(tmp, path);
   } catch {}
   return next;
@@ -29923,7 +29926,7 @@ var init_boot_issue_cache = __esm(() => {
 
 // gateway/config-snapshot.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync29, readFileSync as readFileSync27, writeFileSync as writeFileSync17, mkdirSync as mkdirSync18, renameSync as renameSync10 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync27, writeFileSync as writeFileSync18, mkdirSync as mkdirSync19, renameSync as renameSync10 } from "fs";
 import { dirname as dirname10 } from "path";
 function hashStringArray(items) {
   if (!items || items.length === 0)
@@ -30022,16 +30025,16 @@ function loadSnapshot(path, now = Date.now) {
 }
 function persistSnapshot(path, snapshot) {
   try {
-    mkdirSync18(dirname10(path), { recursive: true });
+    mkdirSync19(dirname10(path), { recursive: true });
     const tmp = `${path}.tmp`;
-    writeFileSync17(tmp, JSON.stringify(snapshot), { mode: 384 });
+    writeFileSync18(tmp, JSON.stringify(snapshot), { mode: 384 });
     renameSync10(tmp, path);
   } catch {}
 }
 var init_config_snapshot = () => {};
 
 // gateway/boot-card-msgid.ts
-import { readFileSync as readFileSync28, writeFileSync as writeFileSync18 } from "node:fs";
+import { readFileSync as readFileSync28, writeFileSync as writeFileSync19 } from "node:fs";
 function bootCardChatKey(chatId, threadId) {
   return `${chatId}:${threadId ?? ""}`;
 }
@@ -30056,7 +30059,7 @@ function saveBootCardMsgId(path, chatKey3, messageId) {
     if (store2[chatKey3] === messageId)
       return;
     store2[chatKey3] = messageId;
-    writeFileSync18(path, JSON.stringify(store2), "utf8");
+    writeFileSync19(path, JSON.stringify(store2), "utf8");
   } catch {}
 }
 var init_boot_card_msgid = () => {};
@@ -30071,7 +30074,7 @@ __export(exports_boot_card, {
   renderBootCard: () => renderBootCard,
   renderAccountRows: () => renderAuthLine
 });
-import { join as join25 } from "path";
+import { join as join26 } from "path";
 function resolvePersonaName(slug, loadConfig3) {
   try {
     const config = loadConfig3 ? loadConfig3() : loadConfig();
@@ -30161,7 +30164,7 @@ function renderBootCard(opts) {
 `);
 }
 async function runAllProbes(opts) {
-  const claudeDir = join25(opts.agentDir, ".claude");
+  const claudeDir = join26(opts.agentDir, ".claude");
   const probes = {};
   const slug = opts.agentSlug ?? opts.agentName;
   await Promise.allSettled([
@@ -30917,7 +30920,7 @@ __export(exports_tmux, {
   captureAgentPane: () => captureAgentPane
 });
 import { execFileSync as execFileSync4 } from "node:child_process";
-import { mkdirSync as mkdirSync25, readdirSync as readdirSync6, statSync as statSync12, unlinkSync as unlinkSync13, writeFileSync as writeFileSync24 } from "node:fs";
+import { mkdirSync as mkdirSync26, readdirSync as readdirSync6, statSync as statSync12, unlinkSync as unlinkSync13, writeFileSync as writeFileSync25 } from "node:fs";
 import { resolve as resolve7 } from "node:path";
 function captureAgentPane(opts) {
   const { agentName: agentName3, agentDir, reason } = opts;
@@ -30929,7 +30932,7 @@ function captureAgentPane(opts) {
   const reasonSlug = sanitizeReason(reason);
   const outPath = resolve7(outDir, `${ts}-${reasonSlug}.txt`);
   try {
-    mkdirSync25(outDir, { recursive: true, mode: 493 });
+    mkdirSync26(outDir, { recursive: true, mode: 493 });
   } catch (err) {
     const msg = `mkdir crash-reports failed: ${err.message}`;
     console.error(`[tmux-capture] ${agentName3}: ${msg}`);
@@ -30963,7 +30966,7 @@ function captureAgentPane(opts) {
 ` + `
 `;
   try {
-    writeFileSync24(outPath, Buffer.concat([Buffer.from(header, "utf8"), body]), {
+    writeFileSync25(outPath, Buffer.concat([Buffer.from(header, "utf8"), body]), {
       mode: 420
     });
   } catch (err) {
@@ -31558,8 +31561,8 @@ import { randomBytes as randomBytes6 } from "crypto";
 import { execFileSync as execFileSync5, execSync as execSync2, spawn as spawn2 } from "child_process";
 import {
   readFileSync as readFileSync36,
-  writeFileSync as writeFileSync25,
-  mkdirSync as mkdirSync26,
+  writeFileSync as writeFileSync26,
+  mkdirSync as mkdirSync27,
   readdirSync as readdirSync7,
   rmSync as rmSync4,
   statSync as statSync13,
@@ -31573,7 +31576,7 @@ import {
   appendFileSync as appendFileSync5
 } from "fs";
 import { homedir as homedir14 } from "os";
-import { join as join35, extname, sep as sep3, basename as basename10 } from "path";
+import { join as join36, extname, sep as sep3, basename as basename10 } from "path";
 
 // plugin-logger.ts
 import { appendFileSync, mkdirSync, renameSync, statSync, existsSync } from "fs";
@@ -43161,7 +43164,7 @@ function helpText(agentName3) {
     ``,
     `This bot is the <b>${escapeHtml6(agentName3)}</b> agent. Text and photos route through to it; replies, reactions and progress cards come back.`,
     ``,
-    `Tool approvals surface as inline buttons (\u2705 / \u274c) or via <code>/approve</code>, <code>/deny</code>, <code>/pending</code>. Start a fresh session with <code>/new</code> or <code>/reset</code>.`,
+    `Tool approvals surface as inline buttons (\u2705 / \u274c) or via <code>/approve</code>, <code>/deny</code>, <code>/pending</code>. Start a fresh session with <code>/new</code>, or trim/clear context with <code>/compact</code> / <code>/clear</code>.`,
     ``,
     `<code>/start</code> \u2014 pairing instructions`,
     `<code>/status</code> \u2014 agent, model, auth`,
@@ -43229,7 +43232,8 @@ var TELEGRAM_MENU_COMMANDS = [
   { command: "help", description: "What this bot can do" },
   { command: "status", description: "Agent, model, auth" },
   { command: "new", description: "Fresh session (flush handoff, restart)" },
-  { command: "reset", description: "Alias of /new" },
+  { command: "compact", description: "Compact context (summarize, keep the thread)" },
+  { command: "clear", description: "Clear context (fresh slate; memory in Hindsight)" },
   { command: "approve", description: "Approve pending tool permission" },
   { command: "deny", description: "Deny pending tool permission" },
   { command: "pending", description: "List pending permission prompts" },
@@ -43237,7 +43241,6 @@ var TELEGRAM_MENU_COMMANDS = [
   { command: "restart", description: "Restart the agent (drain by default)" },
   { command: "version", description: "Show versions + running agent health" },
   { command: "logs", description: "Show recent agent logs" },
-  { command: "inject", description: "Inject a Claude Code slash command (e.g. /cost)" },
   { command: "model", description: "Show or switch the Claude model" },
   { command: "effort", description: "Show or switch the reasoning effort" },
   { command: "doctor", description: "Health check (deps, services, MCP)" },
@@ -43254,7 +43257,8 @@ function switchroomHelpText(agentName3) {
     ``,
     `<b>Session &amp; approvals</b>`,
     `<code>/new</code> \u2014 fresh session (flush handoff, restart)`,
-    `<code>/reset</code> \u2014 alias of /new`,
+    `<code>/compact</code> \u2014 compact context (summarize, keep the thread)`,
+    `<code>/clear</code> \u2014 clear context (fresh slate; memory in Hindsight)`,
     `<code>/approve [id]</code> \u2014 approve pending tool permission`,
     `<code>/deny [id]</code> \u2014 deny pending tool permission`,
     `<code>/pending</code> \u2014 list pending permission prompts`,
@@ -43308,10 +43312,6 @@ function newSessionAckText(agentName3, flushedHandoff) {
   const tail = flushedHandoff ? " \u00b7 flushed handoff" : "";
   return `\uD83C\uDD95 Started fresh session for <b>${escapeHtml6(agentName3)}</b>${tail} \u00b7 restarting\u2026`;
 }
-function resetSessionAckText(agentName3, flushedHandoff) {
-  const tail = flushedHandoff ? " \u00b7 flushed handoff" : "";
-  return `\uD83D\uDD04 Reset session for <b>${escapeHtml6(agentName3)}</b>${tail} \u00b7 restarting\u2026`;
-}
 
 // gateway/auth-status-adapter.ts
 function formatExpiresInRelative(expiresAt, now = Date.now()) {
@@ -46381,6 +46381,38 @@ function numField(obj, key) {
   return 0;
 }
 
+// gateway/context-occupancy.ts
+import { mkdirSync as mkdirSync12, writeFileSync as writeFileSync9 } from "node:fs";
+import { join as join18 } from "node:path";
+var CONTEXT_OCCUPANCY_FILENAME = "context-occupancy.json";
+var TIGHT_FRACTION = 0.8;
+function buildContextOccupancy(occupancy, cap, now) {
+  if (!Number.isFinite(occupancy) || occupancy < 0) {
+    return { occupancy: 0, cap: cap ?? null, headroom: null, pct: null, state: "unknown", computedAt: now };
+  }
+  const c = cap != null && cap > 0 ? cap : null;
+  if (c == null) {
+    return { occupancy, cap: null, headroom: null, pct: null, state: "ok", computedAt: now };
+  }
+  const pct = occupancy / c;
+  return {
+    occupancy,
+    cap: c,
+    headroom: c - occupancy,
+    pct,
+    state: pct >= TIGHT_FRACTION ? "tight" : "ok",
+    computedAt: now
+  };
+}
+function writeContextOccupancySnapshot(stateDir, snapshot, deps) {
+  try {
+    const path = join18(stateDir, CONTEXT_OCCUPANCY_FILENAME);
+    (deps?.mkdir ?? ((p, o) => mkdirSync12(p, o)))(stateDir, { recursive: true });
+    (deps?.writeFile ?? ((p, d) => writeFileSync9(p, d)))(path, JSON.stringify(snapshot, null, 2) + `
+`);
+  } catch {}
+}
+
 // gateway/proactive-compact.ts
 var COMPACT_REARM_FRACTION = 0.6;
 var COMPACT_COOLDOWN_TURNS = 3;
@@ -46407,6 +46439,36 @@ function decideProactiveCompact(state3, occupancy, cap) {
   };
 }
 
+// gateway/idle-clear.ts
+var DEFAULT_IDLE_CLEAR_MS = 3 * 60 * 60 * 1000;
+function decideIdleClear(state3, now) {
+  if (state3.idleClearMs <= 0)
+    return { clear: false };
+  if (state3.turnInFlight)
+    return { clear: false };
+  if (state3.alreadyCleared)
+    return { clear: false };
+  if (now - state3.lastActivityAt < state3.idleClearMs)
+    return { clear: false };
+  return { clear: true };
+}
+function idleDurationToMs(raw) {
+  const m = /^(\d+)([smh])$/.exec(raw.trim());
+  if (!m)
+    return null;
+  const n = Number(m[1]);
+  switch (m[2]) {
+    case "s":
+      return n * 1000;
+    case "m":
+      return n * 60000;
+    case "h":
+      return n * 3600000;
+    default:
+      return null;
+  }
+}
+
 // gateway/compact-notify.ts
 function idleCompactNotifyState() {
   return { phase: "idle", fileAtStart: null };
@@ -46980,13 +47042,13 @@ function startWebhookIngestServer(opts) {
 }
 
 // ../src/web/webhook-gateway-record.ts
-import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync14 } from "fs";
-import { join as join20 } from "path";
+import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync15 } from "fs";
+import { join as join21 } from "path";
 import { homedir as homedir10 } from "os";
 
 // ../src/web/webhook-handler.ts
-import { appendFileSync as appendFileSync3, existsSync as existsSync22, mkdirSync as mkdirSync12, readFileSync as readFileSync16, writeFileSync as writeFileSync9 } from "fs";
-import { join as join18 } from "path";
+import { appendFileSync as appendFileSync3, existsSync as existsSync22, mkdirSync as mkdirSync13, readFileSync as readFileSync16, writeFileSync as writeFileSync10 } from "fs";
+import { join as join19 } from "path";
 var DEDUP_MAX = 1000;
 var DEDUP_TTL_MS = 24 * 60 * 60 * 1000;
 function loadDedupFile(path) {
@@ -47007,7 +47069,7 @@ function saveDedupFile(path, deliveries, now) {
   }
   const sorted = Object.entries(pruned).sort((a, b) => b[1] - a[1]).slice(0, DEDUP_MAX);
   const final = Object.fromEntries(sorted);
-  writeFileSync9(path, JSON.stringify({ deliveries: final }), {
+  writeFileSync10(path, JSON.stringify({ deliveries: final }), {
     mode: 384
   });
 }
@@ -47015,8 +47077,8 @@ var agentDedupCache = new Map;
 function createFileDedupStore(resolveAgentDir) {
   return {
     check(agent, deliveryId, now) {
-      const telegramDir = join18(resolveAgentDir(agent), "telegram");
-      const filePath = join18(telegramDir, "webhook-dedup.json");
+      const telegramDir = join19(resolveAgentDir(agent), "telegram");
+      const filePath = join19(telegramDir, "webhook-dedup.json");
       if (!agentDedupCache.has(agent)) {
         agentDedupCache.set(agent, loadDedupFile(filePath));
       }
@@ -47026,7 +47088,7 @@ function createFileDedupStore(resolveAgentDir) {
       }
       deliveries[deliveryId] = now;
       try {
-        mkdirSync12(telegramDir, { recursive: true });
+        mkdirSync13(telegramDir, { recursive: true });
         saveDedupFile(filePath, deliveries, now);
       } catch {}
       return;
@@ -47037,8 +47099,8 @@ var tokenBuckets = new Map;
 var throttleIssueWindow = new Map;
 
 // ../src/web/webhook-dispatch.ts
-import { existsSync as existsSync23, mkdirSync as mkdirSync13, readFileSync as readFileSync17, writeFileSync as writeFileSync10 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync23, mkdirSync as mkdirSync14, readFileSync as readFileSync17, writeFileSync as writeFileSync11 } from "fs";
+import { join as join20 } from "path";
 import { homedir as homedir9 } from "os";
 
 // ../src/agent-scheduler/ipc-client.ts
@@ -47347,7 +47409,7 @@ function loadCooldownFile(path) {
 }
 function saveCooldownFile(path, dispatches) {
   try {
-    writeFileSync10(path, JSON.stringify({ dispatches }), {
+    writeFileSync11(path, JSON.stringify({ dispatches }), {
       mode: 384
     });
   } catch {}
@@ -47358,8 +47420,8 @@ function createFileCooldownStore(resolveAgentDir) {
     isCoolingDown(agent, key, cooldownMs, now) {
       if (cooldownMs <= 0)
         return false;
-      const telegramDir = join19(resolveAgentDir(agent), "telegram");
-      const filePath = join19(telegramDir, "webhook-cooldown.json");
+      const telegramDir = join20(resolveAgentDir(agent), "telegram");
+      const filePath = join20(telegramDir, "webhook-cooldown.json");
       if (!cache.has(agent)) {
         cache.set(agent, loadCooldownFile(filePath));
       }
@@ -47370,7 +47432,7 @@ function createFileCooldownStore(resolveAgentDir) {
       }
       dispatches[key] = now;
       try {
-        mkdirSync13(telegramDir, { recursive: true });
+        mkdirSync14(telegramDir, { recursive: true });
         saveCooldownFile(filePath, dispatches);
       } catch {}
       return false;
@@ -47416,9 +47478,9 @@ async function defaultInject(socketPath, agentName3, inbound) {
 }
 function injectWebhookInbound(agent, prompt, ctx, deps = {}) {
   const log = deps.log ?? ((s) => process.stderr.write(s));
-  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join19(homedir9(), ".switchroom", "agents", a));
+  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join20(homedir9(), ".switchroom", "agents", a));
   const now = (deps.now ?? Date.now)();
-  const socketPath = join19(resolveAgentDir(agent), "telegram", "gateway.sock");
+  const socketPath = join20(resolveAgentDir(agent), "telegram", "gateway.sock");
   const inbound = {
     type: "inbound",
     chatId: ctx.chatId,
@@ -47490,7 +47552,7 @@ function evaluateDispatch(args, deps = {}) {
   const log = deps.log ?? ((s) => process.stderr.write(s));
   const now = (deps.now ?? Date.now)();
   const nowDate = deps.nowDate ?? (() => new Date(now));
-  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join19(homedir9(), ".switchroom", "agents", a));
+  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join20(homedir9(), ".switchroom", "agents", a));
   const cooldownStore = deps.cooldownStore ?? createFileCooldownStore(resolveAgentDir);
   if (!DISPATCH_SOURCES.includes(args.source))
     return 0;
@@ -47566,10 +47628,10 @@ function resolveChannelTarget(config, agentName3) {
 function recordWebhookEvent(rec, deps = {}) {
   const log = deps.log ?? ((s) => process.stderr.write(s));
   const now = rec.ts || (deps.now ?? Date.now)();
-  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join20(homedir10(), ".switchroom", "agents", a));
+  const resolveAgentDir = deps.resolveAgentDir ?? ((a) => join21(homedir10(), ".switchroom", "agents", a));
   const dedupStore = deps.dedupStore ?? createFileDedupStore(resolveAgentDir);
   const agent = rec.agent;
-  const telegramDir = join20(resolveAgentDir(agent), "telegram");
+  const telegramDir = join21(resolveAgentDir(agent), "telegram");
   if (rec.source === "github" && rec.delivery_id) {
     const originalTs = dedupStore.check(agent, rec.delivery_id, now);
     if (originalTs !== undefined) {
@@ -47578,9 +47640,9 @@ function recordWebhookEvent(rec, deps = {}) {
       return { status: "deduped", ts: originalTs };
     }
   }
-  const logPath = join20(telegramDir, "webhook-events.jsonl");
+  const logPath = join21(telegramDir, "webhook-events.jsonl");
   try {
-    mkdirSync14(telegramDir, { recursive: true });
+    mkdirSync15(telegramDir, { recursive: true });
     const record = {
       ts: now,
       source: rec.source,
@@ -50255,6 +50317,20 @@ function createPollHealthCheck(options) {
   };
 }
 
+// gateway/poll-stall-recovery.ts
+var POLL_STALL_EXIT_CODE = 1;
+function recoverFromPollStall(deps = {}) {
+  const exit = deps.exit ?? ((code) => process.exit(code));
+  const log = deps.log ?? ((msg) => {
+    process.stderr.write(msg.endsWith(`
+`) ? msg : msg + `
+`);
+  });
+  const agentName3 = deps.agentName ?? "-";
+  log(`telegram gateway: poll.health_check.stall_recovery exiting code=${POLL_STALL_EXIT_CODE} ` + `pid=${process.pid} agent=${agentName3} \u2014 supervisor will restart the gateway with a fresh runner ` + `(not awaiting runnerHandle.stop(): grammy stop() blocks on a non-abortable getUpdates retry backoff during an outage)`);
+  exit(POLL_STALL_EXIT_CODE);
+}
+
 // gateway/reaction-trigger.ts
 var REACTIONS_DEFAULTS = Object.freeze({
   enabled: true,
@@ -50479,10 +50555,10 @@ function escapeBody2(s) {
 }
 
 // gateway/pid-file.ts
-import { writeFileSync as writeFileSync11, readFileSync as readFileSync18, unlinkSync as unlinkSync7, renameSync as renameSync6 } from "node:fs";
+import { writeFileSync as writeFileSync12, readFileSync as readFileSync18, unlinkSync as unlinkSync7, renameSync as renameSync6 } from "node:fs";
 function writePidFile(path, record) {
   const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
-  writeFileSync11(tmp, JSON.stringify(record), "utf-8");
+  writeFileSync12(tmp, JSON.stringify(record), "utf-8");
   renameSync6(tmp, path);
 }
 function clearPidFile(path) {
@@ -50704,10 +50780,10 @@ function safeCount(fn) {
 }
 
 // gateway/session-marker.ts
-import { writeFileSync as writeFileSync12, readFileSync as readFileSync20, renameSync as renameSync7, unlinkSync as unlinkSync8 } from "node:fs";
+import { writeFileSync as writeFileSync13, readFileSync as readFileSync20, renameSync as renameSync7, unlinkSync as unlinkSync8 } from "node:fs";
 function writeSessionMarker(path, marker) {
   const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
-  writeFileSync12(tmp, JSON.stringify(marker), "utf-8");
+  writeFileSync13(tmp, JSON.stringify(marker), "utf-8");
   renameSync7(tmp, path);
 }
 function readSessionMarker(path) {
@@ -50734,11 +50810,11 @@ function shouldFireRestartBanner(input) {
 }
 
 // gateway/clean-shutdown-marker.ts
-import { writeFileSync as writeFileSync13, readFileSync as readFileSync21, renameSync as renameSync8, unlinkSync as unlinkSync9 } from "node:fs";
+import { writeFileSync as writeFileSync14, readFileSync as readFileSync21, renameSync as renameSync8, unlinkSync as unlinkSync9 } from "node:fs";
 var DEFAULT_MAX_AGE_MS = 60000;
 function writeCleanShutdownMarker(path, marker) {
   const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
-  writeFileSync13(tmp, JSON.stringify(marker), "utf-8");
+  writeFileSync14(tmp, JSON.stringify(marker), "utf-8");
   renameSync8(tmp, path);
 }
 function readCleanShutdownMarker(path) {
@@ -51331,7 +51407,7 @@ import {
   readdirSync as readdirSync3,
   readFileSync as readFileSync23
 } from "fs";
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 
 // operator-events.ts
 function classifyClaudeError(raw) {
@@ -51817,18 +51893,18 @@ function bumpSubagentActivity(db2, args) {
 import {
   closeSync as closeSync3,
   existsSync as existsSync24,
-  mkdirSync as mkdirSync15,
+  mkdirSync as mkdirSync16,
   openSync as openSync3,
   readFileSync as readFileSync22,
   statSync as statSync6,
   unlinkSync as unlinkSync10,
   utimesSync,
-  writeFileSync as writeFileSync14
+  writeFileSync as writeFileSync15
 } from "node:fs";
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 var TURN_ACTIVE_MARKER_FILE = "turn-active.json";
 function touchTurnActiveMarker(stateDir) {
-  const path = join21(stateDir, TURN_ACTIVE_MARKER_FILE);
+  const path = join22(stateDir, TURN_ACTIVE_MARKER_FILE);
   if (!existsSync24(path))
     return;
   const now = new Date;
@@ -52355,8 +52431,8 @@ function startSubagentWatcher(config) {
   function rescanSubagentDirs() {
     if (stopped)
       return;
-    const claudeHome = join22(agentDir, ".claude");
-    const projectsRoot = join22(claudeHome, "projects");
+    const claudeHome = join23(agentDir, ".claude");
+    const projectsRoot = join23(claudeHome, "projects");
     if (!fs2.existsSync(projectsRoot))
       return;
     let projectDirs;
@@ -52373,7 +52449,7 @@ function startSubagentWatcher(config) {
         }
         continue;
       }
-      const projectPath = join22(projectsRoot, pDir);
+      const projectPath = join23(projectsRoot, pDir);
       let sessionDirs;
       try {
         sessionDirs = fs2.readdirSync(projectPath);
@@ -52383,7 +52459,7 @@ function startSubagentWatcher(config) {
       for (const sDir of sessionDirs) {
         if (sDir.endsWith(".jsonl"))
           continue;
-        const subagentsPath = join22(projectPath, sDir, "subagents");
+        const subagentsPath = join23(projectPath, sDir, "subagents");
         if (!fs2.existsSync(subagentsPath))
           continue;
         if (!dirWatchers.has(subagentsPath)) {
@@ -52391,7 +52467,7 @@ function startSubagentWatcher(config) {
             const w = fs2.watch(subagentsPath, (_event, filename) => {
               if (!filename || !filename.toString().startsWith("agent-") || !filename.toString().endsWith(".jsonl"))
                 return;
-              const filePath = join22(subagentsPath, filename.toString());
+              const filePath = join23(subagentsPath, filename.toString());
               if (!knownFiles.has(filePath)) {
                 scanSubagentsDir(subagentsPath);
               }
@@ -52416,7 +52492,7 @@ function startSubagentWatcher(config) {
     for (const e of entries) {
       if (!e.startsWith("agent-") || !e.endsWith(".jsonl"))
         continue;
-      const filePath = join22(subagentsPath, e);
+      const filePath = join23(subagentsPath, e);
       if (knownFiles.has(filePath))
         continue;
       const agentId = e.slice("agent-".length, -".jsonl".length);
@@ -52542,15 +52618,15 @@ function determineRestartReason(opts) {
 init_boot_card();
 
 // gateway/update-announce.ts
-import { existsSync as existsSync30, mkdirSync as mkdirSync19, openSync as openSync5, closeSync as closeSync5, readFileSync as readFileSync29 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync30, mkdirSync as mkdirSync20, openSync as openSync5, closeSync as closeSync5, readFileSync as readFileSync29 } from "node:fs";
+import { join as join28 } from "node:path";
 import { homedir as homedir12 } from "node:os";
 
 // ../src/host-control/audit-reader.ts
 import { homedir as homedir11 } from "node:os";
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 function defaultAuditLogPath(home2 = homedir11()) {
-  return join26(home2, ".switchroom", "host-control-audit.log");
+  return join27(home2, ".switchroom", "host-control-audit.log");
 }
 function parseAuditLine(line) {
   const trimmed = line.trim();
@@ -52718,15 +52794,15 @@ function renderUpdateOutcomeLine(entry) {
 `);
 }
 function claimUpdateAnnouncement(requestId, opts = {}) {
-  const stateDir = opts.stateDir ?? process.env.TELEGRAM_STATE_DIR ?? join27(homedir12(), ".switchroom");
-  const dir = join27(stateDir, "update-announced");
+  const stateDir = opts.stateDir ?? process.env.TELEGRAM_STATE_DIR ?? join28(homedir12(), ".switchroom");
+  const dir = join28(stateDir, "update-announced");
   try {
-    mkdirSync19(dir, { recursive: true });
+    mkdirSync20(dir, { recursive: true });
   } catch {
     return false;
   }
   const safeId = requestId.replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 200);
-  const path = join27(dir, safeId);
+  const path = join28(dir, safeId);
   try {
     const fd = openSync5(path, "wx");
     closeSync5(fd);
@@ -52745,7 +52821,7 @@ function maybeRenderUpdateAnnouncement(opts = {}) {
 }
 
 // issues-card.ts
-import { readFileSync as readFileSync30, writeFileSync as writeFileSync19 } from "node:fs";
+import { readFileSync as readFileSync30, writeFileSync as writeFileSync20 } from "node:fs";
 var SEVERITY_EMOJI = {
   info: "\u2139\ufe0f",
   warn: "\u26a0\ufe0f",
@@ -52853,7 +52929,7 @@ function readPersistedMessageId(path, log) {
 }
 function writePersistedMessageId(path, messageId, log) {
   try {
-    writeFileSync19(path, JSON.stringify({ messageId }) + `
+    writeFileSync20(path, JSON.stringify({ messageId }) + `
 `, { mode: 384 });
   } catch (err) {
     log(`issues-card: persist write failed (${err.message})`);
@@ -52947,23 +53023,23 @@ function createIssuesCardHandle(opts) {
 
 // issues-watcher.ts
 import { existsSync as existsSync32, statSync as statSync9 } from "node:fs";
-import { join as join29 } from "node:path";
+import { join as join30 } from "node:path";
 
 // ../src/issues/store.ts
 import {
   closeSync as closeSync6,
   existsSync as existsSync31,
-  mkdirSync as mkdirSync20,
+  mkdirSync as mkdirSync21,
   openSync as openSync6,
   readdirSync as readdirSync5,
   readFileSync as readFileSync31,
   renameSync as renameSync11,
   statSync as statSync8,
   unlinkSync as unlinkSync11,
-  writeFileSync as writeFileSync20,
+  writeFileSync as writeFileSync21,
   writeSync as writeSync2
 } from "node:fs";
-import { join as join28 } from "node:path";
+import { join as join29 } from "node:path";
 import { randomBytes as randomBytes5 } from "node:crypto";
 import { execSync } from "node:child_process";
 
@@ -52982,7 +53058,7 @@ init_redact();
 var ISSUES_FILE = "issues.jsonl";
 var ISSUES_LOCK = "issues.lock";
 function readAll(stateDir) {
-  const path = join28(stateDir, ISSUES_FILE);
+  const path = join29(stateDir, ISSUES_FILE);
   if (!existsSync31(path))
     return [];
   let raw;
@@ -53019,7 +53095,7 @@ function list(stateDir, opts = {}) {
   });
 }
 function resolve6(stateDir, fingerprint, nowFn = Date.now) {
-  if (!existsSync31(join28(stateDir, ISSUES_FILE)))
+  if (!existsSync31(join29(stateDir, ISSUES_FILE)))
     return 0;
   return withLock(stateDir, () => {
     const all = readAll(stateDir);
@@ -53037,13 +53113,13 @@ function resolve6(stateDir, fingerprint, nowFn = Date.now) {
   });
 }
 function writeAll(stateDir, events) {
-  const path = join28(stateDir, ISSUES_FILE);
+  const path = join29(stateDir, ISSUES_FILE);
   sweepOrphanTmpFiles(stateDir);
   const tmp = `${path}.tmp-${process.pid}-${randomBytes5(4).toString("hex")}`;
   const body = events.length === 0 ? "" : events.map((e) => JSON.stringify(e)).join(`
 `) + `
 `;
-  writeFileSync20(tmp, body, "utf-8");
+  writeFileSync21(tmp, body, "utf-8");
   renameSync11(tmp, path);
 }
 var ORPHAN_TMP_TTL_MS = 60000;
@@ -53059,7 +53135,7 @@ function sweepOrphanTmpFiles(stateDir) {
   for (const entry of entries) {
     if (!entry.startsWith(TMP_PREFIX))
       continue;
-    const tmpPath2 = join28(stateDir, entry);
+    const tmpPath2 = join29(stateDir, entry);
     try {
       const stat = statSync8(tmpPath2);
       if (stat.mtimeMs < cutoff) {
@@ -53071,7 +53147,7 @@ function sweepOrphanTmpFiles(stateDir) {
 var LOCK_RETRY_MS = 25;
 var LOCK_TIMEOUT_MS = 1e4;
 function withLock(stateDir, fn) {
-  const lockPath = join28(stateDir, ISSUES_LOCK);
+  const lockPath = join29(stateDir, ISSUES_LOCK);
   const startedAt = Date.now();
   let fd = null;
   while (fd === null) {
@@ -53156,7 +53232,7 @@ function isIssueEvent(v) {
 // issues-watcher.ts
 var DEFAULT_POLL_INTERVAL_MS2 = 2000;
 function startIssuesWatcher(opts) {
-  const path = join29(opts.stateDir, ISSUES_FILE);
+  const path = join30(opts.stateDir, ISSUES_FILE);
   const log = opts.log ?? (() => {});
   const intervalMs = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS2;
   const setIntervalFn = opts.setInterval ?? setInterval;
@@ -54090,8 +54166,8 @@ function extractFlowItems(line) {
 }
 
 // credits-watch.ts
-import { readFileSync as readFileSync32, writeFileSync as writeFileSync21, existsSync as existsSync33, mkdirSync as mkdirSync21 } from "fs";
-import { join as join30 } from "path";
+import { readFileSync as readFileSync32, writeFileSync as writeFileSync22, existsSync as existsSync33, mkdirSync as mkdirSync22 } from "fs";
+import { join as join31 } from "path";
 var STATE_FILE = "credits-watch.json";
 var DEFAULT_CREDIT_FATAL_REASONS = new Set;
 var KNOWN_CREDIT_REASONS = [
@@ -54113,7 +54189,7 @@ function emptyCreditState() {
   return { lastNotifiedReason: null, lastNotifiedAt: 0 };
 }
 function readClaudeJsonOverage(claudeConfigDir) {
-  const path = join30(claudeConfigDir, ".claude.json");
+  const path = join31(claudeConfigDir, ".claude.json");
   if (!existsSync33(path))
     return null;
   let raw;
@@ -54199,7 +54275,7 @@ function escapeHtml9(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
 function loadCreditState(stateDir) {
-  const path = join30(stateDir, STATE_FILE);
+  const path = join31(stateDir, STATE_FILE);
   if (!existsSync33(path))
     return emptyCreditState();
   try {
@@ -54215,15 +54291,15 @@ function loadCreditState(stateDir) {
   return emptyCreditState();
 }
 function saveCreditState(stateDir, state4) {
-  mkdirSync21(stateDir, { recursive: true });
-  const path = join30(stateDir, STATE_FILE);
-  writeFileSync21(path, JSON.stringify(state4, null, 2) + `
+  mkdirSync22(stateDir, { recursive: true });
+  const path = join31(stateDir, STATE_FILE);
+  writeFileSync22(path, JSON.stringify(state4, null, 2) + `
 `, { mode: 384 });
 }
 
 // quota-watch.ts
-import { readFileSync as readFileSync33, writeFileSync as writeFileSync22, existsSync as existsSync34, mkdirSync as mkdirSync22 } from "fs";
-import { join as join31 } from "path";
+import { readFileSync as readFileSync33, writeFileSync as writeFileSync23, existsSync as existsSync34, mkdirSync as mkdirSync23 } from "fs";
+import { join as join32 } from "path";
 var STATE_FILE2 = "quota-watch.json";
 function emptyQuotaWatchState() {
   return {};
@@ -54404,7 +54480,7 @@ function escapeHtml10(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
 function loadQuotaWatchState(stateDir) {
-  const path = join31(stateDir, STATE_FILE2);
+  const path = join32(stateDir, STATE_FILE2);
   if (!existsSync34(path))
     return emptyQuotaWatchState();
   try {
@@ -54425,9 +54501,9 @@ function loadQuotaWatchState(stateDir) {
   }
 }
 function saveQuotaWatchState(stateDir, state4) {
-  mkdirSync22(stateDir, { recursive: true });
-  const path = join31(stateDir, STATE_FILE2);
-  writeFileSync22(path, JSON.stringify(state4, null, 2) + `
+  mkdirSync23(stateDir, { recursive: true });
+  const path = join32(stateDir, STATE_FILE2);
+  writeFileSync23(path, JSON.stringify(state4, null, 2) + `
 `, { mode: 384 });
 }
 function patchQuotaWatchState(current, accountLabel, accountState) {
@@ -54441,25 +54517,25 @@ init_auth_snapshot_format();
 import {
   closeSync as closeSync7,
   existsSync as existsSync35,
-  mkdirSync as mkdirSync23,
+  mkdirSync as mkdirSync24,
   openSync as openSync7,
   readFileSync as readFileSync34,
   statSync as statSync10,
   unlinkSync as unlinkSync12,
   utimesSync as utimesSync2,
-  writeFileSync as writeFileSync23
+  writeFileSync as writeFileSync24
 } from "node:fs";
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 var TURN_ACTIVE_MARKER_FILE2 = "turn-active.json";
 function writeTurnActiveMarker(stateDir, marker) {
   try {
-    mkdirSync23(stateDir, { recursive: true });
-    writeFileSync23(join32(stateDir, TURN_ACTIVE_MARKER_FILE2), JSON.stringify(marker, null, 2) + `
+    mkdirSync24(stateDir, { recursive: true });
+    writeFileSync24(join33(stateDir, TURN_ACTIVE_MARKER_FILE2), JSON.stringify(marker, null, 2) + `
 `, { mode: 384 });
   } catch {}
 }
 function touchTurnActiveMarker2(stateDir) {
-  const path = join32(stateDir, TURN_ACTIVE_MARKER_FILE2);
+  const path = join33(stateDir, TURN_ACTIVE_MARKER_FILE2);
   if (!existsSync35(path))
     return;
   const now = new Date;
@@ -54474,11 +54550,11 @@ function touchTurnActiveMarker2(stateDir) {
 }
 function removeTurnActiveMarker(stateDir) {
   try {
-    unlinkSync12(join32(stateDir, TURN_ACTIVE_MARKER_FILE2));
+    unlinkSync12(join33(stateDir, TURN_ACTIVE_MARKER_FILE2));
   } catch {}
 }
 function sweepStaleTurnActiveMarker(stateDir, opts) {
-  const path = join32(stateDir, TURN_ACTIVE_MARKER_FILE2);
+  const path = join33(stateDir, TURN_ACTIVE_MARKER_FILE2);
   if (!existsSync35(path))
     return false;
   const now = opts.now ?? Date.now();
@@ -54509,7 +54585,7 @@ function sweepStaleTurnActiveMarker(stateDir, opts) {
   }
 }
 function readTurnActiveMarkerAgeMs(stateDir, now) {
-  const path = join32(stateDir, TURN_ACTIVE_MARKER_FILE2);
+  const path = join33(stateDir, TURN_ACTIVE_MARKER_FILE2);
   try {
     const st = statSync10(path);
     return (now ?? Date.now()) - st.mtimeMs;
@@ -54519,11 +54595,11 @@ function readTurnActiveMarkerAgeMs(stateDir, now) {
 }
 
 // ../src/build-info.ts
-var VERSION = "0.15.40";
-var COMMIT_SHA = "fd53cf02";
-var COMMIT_DATE = "2026-06-18T13:00:59+10:00";
-var LATEST_PR = null;
-var COMMITS_AHEAD_OF_TAG = 4;
+var VERSION = "0.15.42";
+var COMMIT_SHA = "2c7e12da";
+var COMMIT_DATE = "2026-06-19T09:09:26+10:00";
+var LATEST_PR = 2434;
+var COMMITS_AHEAD_OF_TAG = 5;
 
 // gateway/boot-version.ts
 function formatRelativeAgo(iso) {
@@ -54596,11 +54672,11 @@ init_peercred();
 import * as net5 from "node:net";
 import * as fs2 from "node:fs";
 import { homedir as homedir13 } from "node:os";
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 var DEFAULT_TIMEOUT_MS4 = 2000;
 var UNLOCK_TIMEOUT_MS = 30000;
-var LEGACY_SOCKET_PATH2 = join33(homedir13(), ".switchroom", "vault-broker.sock");
-var OPERATOR_SOCKET_PATH2 = join33(homedir13(), ".switchroom", "broker-operator", "sock");
+var LEGACY_SOCKET_PATH2 = join34(homedir13(), ".switchroom", "vault-broker.sock");
+var OPERATOR_SOCKET_PATH2 = join34(homedir13(), ".switchroom", "broker-operator", "sock");
 function defaultBrokerSocketPath2() {
   if (fs2.existsSync(OPERATOR_SOCKET_PATH2))
     return OPERATOR_SOCKET_PATH2;
@@ -55533,8 +55609,8 @@ function matchesAdminOnlyKey(key, patterns) {
 }
 
 // registry/turns-schema.ts
-import { chmodSync as chmodSync5, mkdirSync as mkdirSync24 } from "fs";
-import { join as join34 } from "path";
+import { chmodSync as chmodSync5, mkdirSync as mkdirSync25 } from "fs";
+import { join as join35 } from "path";
 var DatabaseClass2 = null;
 function loadDatabaseClass2() {
   if (DatabaseClass2 != null)
@@ -55597,9 +55673,9 @@ function applySchema(db2) {
 }
 function openTurnsDb(agentDir) {
   const Database = loadDatabaseClass2();
-  const dir = join34(agentDir, "telegram");
-  mkdirSync24(dir, { recursive: true, mode: 448 });
-  const path = join34(dir, "registry.db");
+  const dir = join35(agentDir, "telegram");
+  mkdirSync25(dir, { recursive: true, mode: 448 });
+  const path = join35(dir, "registry.db");
   const db2 = new Database(path, { create: true });
   applySchema(db2);
   try {
@@ -55915,11 +55991,11 @@ installGlobalErrorHandlers();
 process.on("beforeExit", () => {
   shutdownAnalytics();
 });
-var STATE_DIR = process.env.TELEGRAM_STATE_DIR ?? join35(homedir14(), ".claude", "channels", "telegram");
-var ACCESS_FILE = join35(STATE_DIR, "access.json");
-var APPROVED_DIR = join35(STATE_DIR, "approved");
-var ENV_FILE = join35(STATE_DIR, ".env");
-var INBOX_DIR = join35(STATE_DIR, "inbox");
+var STATE_DIR = process.env.TELEGRAM_STATE_DIR ?? join36(homedir14(), ".claude", "channels", "telegram");
+var ACCESS_FILE = join36(STATE_DIR, "access.json");
+var APPROVED_DIR = join36(STATE_DIR, "approved");
+var ENV_FILE = join36(STATE_DIR, ".env");
+var INBOX_DIR = join36(STATE_DIR, "inbox");
 function triggerSelfRestart(targetAgent, reason, delayMs = 300) {
   const isDocker = process.env.SWITCHROOM_RUNTIME === "docker";
   const selfAgent = process.env.SWITCHROOM_AGENT_NAME;
@@ -56111,7 +56187,7 @@ function assertSendable(f) {
   } catch {
     throw new Error(`refusing to send file \u2014 cannot resolve real path: ${f}`);
   }
-  const inbox = join35(stateReal, "inbox");
+  const inbox = join36(stateReal, "inbox");
   if (real.startsWith(stateReal + sep3) && !real.startsWith(inbox + sep3)) {
     throw new Error(`refusing to send channel state: ${f}`);
   }
@@ -56198,9 +56274,9 @@ function assertAllowedChat(chat_id) {
 function saveAccess(a) {
   if (STATIC)
     return;
-  mkdirSync26(STATE_DIR, { recursive: true, mode: 448 });
+  mkdirSync27(STATE_DIR, { recursive: true, mode: 448 });
   const tmp = ACCESS_FILE + ".tmp";
-  writeFileSync25(tmp, JSON.stringify(a, null, 2) + `
+  writeFileSync26(tmp, JSON.stringify(a, null, 2) + `
 `, { mode: 384 });
   renameSync12(tmp, ACCESS_FILE);
 }
@@ -56220,7 +56296,7 @@ var HISTORY_ENABLED = HISTORY_ACCESS.historyEnabled !== false;
 if (HISTORY_ENABLED) {
   try {
     initHistory(STATE_DIR, HISTORY_ACCESS.historyRetentionDays ?? 30);
-    process.stderr.write(`telegram gateway: history capture enabled at ${join35(STATE_DIR, "history.db")}
+    process.stderr.write(`telegram gateway: history capture enabled at ${join36(STATE_DIR, "history.db")}
 `);
   } catch (err) {
     process.stderr.write(`telegram gateway: history init failed (${err.message}) \u2014 capture disabled
@@ -56236,7 +56312,7 @@ try {
   let markerTurnKey = null;
   let markerAgeMs = null;
   try {
-    const markerPath = join35(STATE_DIR, TURN_ACTIVE_MARKER_FILE2);
+    const markerPath = join36(STATE_DIR, TURN_ACTIVE_MARKER_FILE2);
     if (existsSync38(markerPath)) {
       const st = statSync13(markerPath);
       markerAgeMs = Date.now() - st.mtimeMs;
@@ -56261,7 +56337,7 @@ try {
     process.stderr.write(`telegram gateway: turn-registry boot-reaper stamped ${reaped} orphaned turn(s)${timeoutTurnKey ? ` (turnKey=${timeoutTurnKey} as 'timeout', markerAgeMs=${markerAgeMs})` : " as 'restart'"}
 `);
   } else {
-    process.stderr.write(`telegram gateway: turn-registry initialized at ${join35(agentDir, "telegram", "registry.db")}
+    process.stderr.write(`telegram gateway: turn-registry initialized at ${join36(agentDir, "telegram", "registry.db")}
 `);
   }
   const pending2 = findLatestTurnIfInterrupted(turnsDb);
@@ -56298,7 +56374,7 @@ try {
 `);
     }
   }
-  const pendingEnvPath = join35(agentDir, ".pending-turn.env");
+  const pendingEnvPath = join36(agentDir, ".pending-turn.env");
   try {
     if (pending2 != null) {
       const lines = [
@@ -56312,7 +56388,7 @@ try {
         pending2.interrupt_reason != null ? `SWITCHROOM_PENDING_INTERRUPT_REASON=${pending2.interrupt_reason}` : `SWITCHROOM_PENDING_INTERRUPT_REASON=`
       ];
       const pendingEnvTmp = `${pendingEnvPath}.tmp-${process.pid}`;
-      writeFileSync25(pendingEnvTmp, lines.join(`
+      writeFileSync26(pendingEnvTmp, lines.join(`
 `) + `
 `, { mode: 384 });
       renameSync12(pendingEnvTmp, pendingEnvPath);
@@ -56391,7 +56467,7 @@ function checkApprovals() {
     return;
   }
   for (const senderId of files) {
-    const file = join35(APPROVED_DIR, senderId);
+    const file = join36(APPROVED_DIR, senderId);
     bot.api.sendMessage(senderId, "Paired! Say hi to Claude.").then(() => rmSync4(file, { force: true }), (err) => {
       process.stderr.write(`telegram gateway: failed to send approval confirm: ${err}
 `);
@@ -56401,6 +56477,9 @@ function checkApprovals() {
 }
 if (!STATIC)
   setInterval(checkApprovals, 5000).unref();
+var IDLE_CLEAR_CHECK_MS = Number(process.env.SWITCHROOM_IDLE_CLEAR_CHECK_MS ?? 60000);
+if (!STATIC && IDLE_CLEAR_CHECK_MS > 0)
+  setInterval(maybeIdleClear, IDLE_CLEAR_CHECK_MS).unref();
 var chatThreadMap = new Map;
 var activeStatusReactions = new Map;
 var activeReactionMsgIds = new Map;
@@ -56471,10 +56550,10 @@ function noteAgentOutputAt(key, ts) {
       lastAgentOutputAt.delete(oldest);
   }
 }
-var OBLIGATION_STORE_PATH = join35(STATE_DIR, "obligations.json");
+var OBLIGATION_STORE_PATH = join36(STATE_DIR, "obligations.json");
 var obligationStoreFs = {
   readFileSync: (p) => readFileSync36(p, "utf8"),
-  writeFileSync: (p, d) => writeFileSync25(p, d),
+  writeFileSync: (p, d) => writeFileSync26(p, d),
   renameSync: (a, b) => renameSync12(a, b),
   existsSync: (p) => existsSync38(p)
 };
@@ -56862,8 +56941,33 @@ function purgeReactionTracking(key, endingTurn) {
     } else {
       maybeProactiveCompact();
     }
+    snapshotContextOccupancy();
   }
 }
+function snapshotContextOccupancy() {
+  try {
+    const agentName3 = process.env.SWITCHROOM_AGENT_NAME;
+    const file = lastSessionActiveFile;
+    if (!agentName3 || !file)
+      return;
+    const turns = readTurnUsages(file, 1);
+    if (turns.length === 0)
+      return;
+    const t = turns[0];
+    const occupancy = t.input + t.cacheRead + t.cacheCreate;
+    let cap = null;
+    try {
+      const cfg = loadConfig2();
+      const rawAgent = cfg.agents?.[agentName3] ?? {};
+      const resolved = resolveAgentConfig2(cfg.defaults, cfg.profiles, rawAgent);
+      cap = resolved.session?.max_context_tokens ?? null;
+    } catch {
+      cap = null;
+    }
+    const stateDir = process.env.SWITCHROOM_AGENT_STATE_DIR ?? "/state/agent";
+    writeContextOccupancySnapshot(stateDir, buildContextOccupancy(occupancy, cap, Date.now()));
+  } catch {}
+}
 function releaseTurnBufferGate(key, endingTurn) {
   if (!activeTurnStartedAt.has(key))
     return;
@@ -56955,6 +57059,81 @@ function maybeProactiveCompact() {
     compactDispatching = false;
   });
 }
+var lastIdleActivityAt = Date.now();
+var idleAutoCleared = false;
+var idleClearDispatching = false;
+function markIdleActivity() {
+  lastIdleActivityAt = Date.now();
+  idleAutoCleared = false;
+}
+function resolveIdleClearMs() {
+  const env = process.env.SWITCHROOM_IDLE_CLEAR_MS;
+  if (env != null && env !== "") {
+    const n = Number(env);
+    return Number.isFinite(n) && n >= 0 ? n : DEFAULT_IDLE_CLEAR_MS;
+  }
+  try {
+    const agentName3 = process.env.SWITCHROOM_AGENT_NAME;
+    if (!agentName3)
+      return DEFAULT_IDLE_CLEAR_MS;
+    const cfg = loadConfig2();
+    const rawAgent = cfg.agents?.[agentName3] ?? {};
+    const resolved = resolveAgentConfig2(cfg.defaults, cfg.profiles, rawAgent);
+    const raw = resolved.session?.idle_clear_after;
+    if (raw == null)
+      return DEFAULT_IDLE_CLEAR_MS;
+    const ms = idleDurationToMs(raw);
+    return ms == null ? DEFAULT_IDLE_CLEAR_MS : ms;
+  } catch {
+    return DEFAULT_IDLE_CLEAR_MS;
+  }
+}
+function maybeIdleClear() {
+  if (idleClearDispatching)
+    return;
+  const agentName3 = process.env.SWITCHROOM_AGENT_NAME;
+  if (!agentName3)
+    return;
+  const idleClearMs = resolveIdleClearMs();
+  const decision = decideIdleClear({
+    lastActivityAt: lastIdleActivityAt,
+    idleClearMs,
+    alreadyCleared: idleAutoCleared,
+    turnInFlight: turnInFlightForGate()
+  }, Date.now());
+  if (!decision.clear)
+    return;
+  idleAutoCleared = true;
+  idleClearDispatching = true;
+  process.stderr.write(`telegram gateway: idle auto-/clear for ${agentName3} (idle >= ${Math.round(idleClearMs / 60000)}m)
+`);
+  injectSlashCommand(agentName3, "/clear").then(() => {
+    postIdleClearNotice(idleClearMs);
+  }).catch((err) => {
+    process.stderr.write(`telegram gateway: idle /clear inject failed for ${agentName3}: ${err instanceof Error ? err.message : String(err)}
+`);
+  }).finally(() => {
+    idleClearDispatching = false;
+  });
+}
+async function postIdleClearNotice(idleClearMs) {
+  try {
+    const chatId = loadAccess().allowFrom[0];
+    if (!chatId)
+      return;
+    const threadId = topicForRecipient({
+      recipientChatId: chatId,
+      resolvedTopic: resolveAgentOutboundTopic({ kind: "compact-watchdog" }) ?? chatThreadMap.get(chatId),
+      supergroupChatId: resolveAgentSupergroupChatId()
+    });
+    const hrs = Math.round(idleClearMs / 3600000 * 10) / 10;
+    const text2 = `\uD83E\uDDF9 <b>Cleared after ${hrs}h idle</b> \u2014 fresh slate next message; ` + `long-term memory is in Hindsight.`;
+    await swallowingApiCall(() => bot.api.sendMessage(chatId, text2, {
+      parse_mode: "HTML",
+      ...threadId != null ? { message_thread_id: threadId } : {}
+    }), { chat_id: chatId, verb: "idleAutoClear.notice" });
+  } catch {}
+}
 async function postCompactCard(occ, cap) {
   try {
     const chatId = loadAccess().allowFrom[0];
@@ -57758,11 +57937,11 @@ var unpinProgressCardForChat = null;
 var getPinnedProgressCardMessageId = null;
 var completeProgressCardTurn = null;
 var subagentWatcher = null;
-var SOCKET_PATH = process.env.SWITCHROOM_GATEWAY_SOCKET ?? join35(STATE_DIR, "gateway.sock");
-mkdirSync26(STATE_DIR, { recursive: true, mode: 448 });
-var GATEWAY_PID_PATH = process.env.SWITCHROOM_GATEWAY_PID_FILE ?? join35(STATE_DIR, "gateway.pid.json");
-var GATEWAY_SESSION_MARKER_PATH = process.env.SWITCHROOM_GATEWAY_SESSION_MARKER ?? join35(STATE_DIR, "gateway-session.json");
-var GATEWAY_CLEAN_SHUTDOWN_MARKER_PATH = process.env.SWITCHROOM_GATEWAY_CLEAN_SHUTDOWN_MARKER ?? join35(STATE_DIR, "clean-shutdown.json");
+var SOCKET_PATH = process.env.SWITCHROOM_GATEWAY_SOCKET ?? join36(STATE_DIR, "gateway.sock");
+mkdirSync27(STATE_DIR, { recursive: true, mode: 448 });
+var GATEWAY_PID_PATH = process.env.SWITCHROOM_GATEWAY_PID_FILE ?? join36(STATE_DIR, "gateway.pid.json");
+var GATEWAY_SESSION_MARKER_PATH = process.env.SWITCHROOM_GATEWAY_SESSION_MARKER ?? join36(STATE_DIR, "gateway-session.json");
+var GATEWAY_CLEAN_SHUTDOWN_MARKER_PATH = process.env.SWITCHROOM_GATEWAY_CLEAN_SHUTDOWN_MARKER ?? join36(STATE_DIR, "clean-shutdown.json");
 var GATEWAY_STARTED_AT_MS = Date.now();
 var BOOT_CARD_ENABLED = process.env.SWITCHROOM_BOOT_CARD !== "false";
 var activeBootCard = null;
@@ -57791,7 +57970,7 @@ function ensureIssuesCard(chatId, threadId) {
     bot: botApi,
     log: (msg) => process.stderr.write(`telegram gateway: ${msg}
 `),
-    persistPath: join35(stateDir, "issues-card.json")
+    persistPath: join36(stateDir, "issues-card.json")
   });
   activeIssuesWatcher = startIssuesWatcher({
     stateDir,
@@ -58020,11 +58199,11 @@ startTimer2({
   }
 });
 var inboundSpool = STATIC ? undefined : createInboundSpool({
-  path: join35(STATE_DIR, "inbound-spool.jsonl"),
+  path: join36(STATE_DIR, "inbound-spool.jsonl"),
   fs: {
     appendFileSync: (p, d) => appendFileSync5(p, d),
     readFileSync: (p) => readFileSync36(p, "utf8"),
-    writeFileSync: (p, d) => writeFileSync25(p, d),
+    writeFileSync: (p, d) => writeFileSync26(p, d),
     renameSync: (a, b) => renameSync12(a, b),
     existsSync: (p) => existsSync38(p),
     statSizeSync: (p) => statSync13(p).size
@@ -58240,8 +58419,8 @@ var ipcServer = createIpcServer({
             probeQuotaViaBroker: (t) => probeQuotaForBootCard(agentSlug, t),
             tmuxSupervisor: process.env.SWITCHROOM_TMUX_SUPERVISOR === "1",
             dockerMode: process.env.SWITCHROOM_RUNTIME === "docker",
-            configSnapshotPath: join35(resolvedAgentDirForCard, ".config-snapshot.json"),
-            bootCardStatePath: join35(resolvedAgentDirForCard, ".boot-card-msgid.json"),
+            configSnapshotPath: join36(resolvedAgentDirForCard, ".config-snapshot.json"),
+            bootCardStatePath: join36(resolvedAgentDirForCard, ".boot-card-msgid.json"),
             ...updateOutcomeLine ? { updateOutcomeLine } : {}
           }, ackMsgId).then((handle) => {
             activeBootCard = handle;
@@ -58665,6 +58844,7 @@ var ipcServer = createIpcServer({
     });
   },
   onInjectInbound(_client, msg) {
+    markIdleActivity();
     const promptKey = typeof msg.inbound.meta?.prompt_key === "string" ? msg.inbound.meta.prompt_key : "unknown";
     const source = typeof msg.inbound.meta?.source === "string" ? msg.inbound.meta.source : "unknown";
     const { target, delivered, fellBackToMain } = deliverInjectWithFallback(msg.agentName, msg.inbound.meta, (t) => ipcServer.sendToAgent(t, msg.inbound));
@@ -58737,7 +58917,7 @@ var ipcServer = createIpcServer({
     const receiverUid = receiverUidRaw ? Number(receiverUidRaw) : NaN;
     if (Number.isInteger(receiverUid))
       allowedUids.push(receiverUid);
-    const socketPath = join35(STATE_DIR, "webhook.sock");
+    const socketPath = join36(STATE_DIR, "webhook.sock");
     const webhookInject = (agentName3, inbound) => {
       const msg = inbound;
       const delivered = ipcServer.sendToAgent(agentName3, msg);
@@ -59848,7 +60028,7 @@ async function executeSendGif(rawArgs) {
   };
 }
 async function publishToTelegraph(text2, shortName, authorName) {
-  const accountPath = join35(STATE_DIR, "telegraph-account.json");
+  const accountPath = join36(STATE_DIR, "telegraph-account.json");
   let account = null;
   try {
     if (existsSync38(accountPath)) {
@@ -59871,8 +60051,8 @@ async function publishToTelegraph(text2, shortName, authorName) {
     }
     account = created.value;
     try {
-      mkdirSync26(STATE_DIR, { recursive: true, mode: 448 });
-      writeFileSync25(accountPath, JSON.stringify(account, null, 2), { mode: 384 });
+      mkdirSync27(STATE_DIR, { recursive: true, mode: 448 });
+      writeFileSync26(accountPath, JSON.stringify(account, null, 2), { mode: 384 });
     } catch (err) {
       process.stderr.write(`telegram gateway: telegraph cache write failed: ${err.message}
 `);
@@ -60332,9 +60512,9 @@ async function executeDownloadAttachment(args) {
     fileUniqueId: file.file_unique_id,
     now: Date.now()
   });
-  mkdirSync26(INBOX_DIR, { recursive: true, mode: 448 });
+  mkdirSync27(INBOX_DIR, { recursive: true, mode: 448 });
   assertInsideInbox(INBOX_DIR, dlPath);
-  writeFileSync25(dlPath, buf, { mode: 384 });
+  writeFileSync26(dlPath, buf, { mode: 384 });
   return { content: [{ type: "text", text: dlPath }] };
 }
 async function executeEditMessage(args) {
@@ -60709,6 +60889,7 @@ function handleSessionEvent(ev) {
           isDm: isDmChatId(ev.chatId)
         };
         currentTurn = next;
+        markIdleActivity();
         process.stderr.write(`telegram gateway: ${formatTurnLifecycle("set", "enqueue", next, startedAt)}
 `);
         rememberRecentTurn(next);
@@ -61495,6 +61676,7 @@ function maybeEarlyAckReaction(ctx, from) {
   bot.api.sendChatAction(chatId, "typing").catch(() => {});
 }
 async function handleInbound(ctx, text2, downloadImage, attachment, extraAttachments) {
+  markIdleActivity();
   const isTopicMessage = ctx.message?.is_topic_message ?? false;
   const messageThreadId = ctx.message?.message_thread_id;
   if (TOPIC_ID != null) {
@@ -62319,14 +62501,14 @@ function restartMarkerPath() {
   const agentDir = resolveAgentDirFromEnv();
   if (!agentDir)
     return null;
-  return join35(agentDir, "restart-pending.json");
+  return join36(agentDir, "restart-pending.json");
 }
 function writeRestartMarker(marker) {
   const p = restartMarkerPath();
   if (!p)
     return;
   try {
-    writeFileSync25(p, JSON.stringify(marker));
+    writeFileSync26(p, JSON.stringify(marker));
     lastPlannedRestartAt = Date.now();
     process.stderr.write(`telegram gateway: restart-marker: write chat_id=${marker.chat_id} thread_id=${marker.thread_id ?? "-"} ack=${marker.ack_message_id ?? "-"} path=${p}
 `);
@@ -62511,12 +62693,12 @@ function _resetDockerReachableCache() {
 }
 function spawnSwitchroomDetached(args, onFailure) {
   const fullArgs = SWITCHROOM_CONFIG ? ["--config", SWITCHROOM_CONFIG, ...args] : args;
-  const logPath = join35(STATE_DIR, "detached-spawn.log");
+  const logPath = join36(STATE_DIR, "detached-spawn.log");
   let outFd = null;
   try {
-    mkdirSync26(STATE_DIR, { recursive: true });
+    mkdirSync27(STATE_DIR, { recursive: true });
     outFd = openSync8(logPath, "a");
-    writeFileSync25(logPath, `
+    writeFileSync26(logPath, `
 [${new Date().toISOString()}] spawn ${SWITCHROOM_CLI} ${fullArgs.join(" ")}
 `, { flag: "a" });
   } catch {}
@@ -62904,7 +63086,7 @@ bot.use(async (ctx, next) => {
 });
 function readRecentDenialsForAgent(agentName3, windowMs, limit) {
   try {
-    const auditPath = join35(homedir14(), ".switchroom", "vault-audit.log");
+    const auditPath = join36(homedir14(), ".switchroom", "vault-audit.log");
     if (!existsSync38(auditPath))
       return [];
     const raw = readFileSync36(auditPath, "utf8");
@@ -62959,7 +63141,7 @@ async function buildAgentMetadata(agentName3) {
   try {
     const agentDir = resolveAgentDirFromEnv();
     if (agentDir) {
-      const raw = readFileSync36(join35(agentDir, ".claude", ".claude.json"), "utf8");
+      const raw = readFileSync36(join36(agentDir, ".claude", ".claude.json"), "utf8");
       claudeJson = JSON.parse(raw);
     }
   } catch {}
@@ -63074,17 +63256,26 @@ bot.command("agents", async (ctx) => {
 `);
   });
 });
-bot.command("inject", async (ctx) => {
-  await handleInjectCommand(ctx, {
-    isAuthorized: isAuthorizedSender,
+function buildInjectDeps(opts) {
+  return {
+    isAuthorized: opts?.open ? () => true : isAuthorizedSender,
     inject: injectSlashCommand,
-    reply: async (ctx2, text2, opts) => switchroomReply(ctx2, text2, { html: opts?.html }),
+    reply: async (ctx, text2, replyOpts) => switchroomReply(ctx, text2, { html: replyOpts?.html }),
     getAgentName: getMyAgentName,
-    getArgs: getCommandArgs,
+    getArgs: opts?.fixedVerb != null ? () => opts.fixedVerb : getCommandArgs,
     escapeHtml: escapeHtmlForTg,
     preBlock,
     formatOutput: formatSwitchroomOutput
-  });
+  };
+}
+bot.command("inject", async (ctx) => {
+  await handleInjectCommand(ctx, buildInjectDeps());
+});
+bot.command("compact", async (ctx) => {
+  await handleInjectCommand(ctx, buildInjectDeps({ open: true, fixedVerb: "/compact" }));
+});
+bot.command("clear", async (ctx) => {
+  await handleInjectCommand(ctx, buildInjectDeps({ open: true, fixedVerb: "/clear" }));
 });
 function buildModelDeps() {
   return {
@@ -63101,7 +63292,7 @@ function buildModelDeps() {
       try {
         const agentDir = resolveAgentDirFromEnv();
         if (agentDir) {
-          const local = await fetchQuota2({ claudeConfigDir: join35(agentDir, ".claude") });
+          const local = await fetchQuota2({ claudeConfigDir: join36(agentDir, ".claude") });
           if (local.ok)
             return formatQuotaLine2(local.data);
         }
@@ -63267,7 +63458,7 @@ bot.command("restart", async (ctx) => {
 function flushAgentHandoff(agentDir) {
   let removed = 0;
   for (const fname of [".handoff.md", ".handoff-topic"]) {
-    const p = join35(agentDir, fname);
+    const p = join36(agentDir, fname);
     try {
       if (existsSync38(p)) {
         unlinkSync14(p);
@@ -63280,7 +63471,8 @@ function flushAgentHandoff(agentDir) {
   }
   return removed;
 }
-async function handleNewOrResetCommand(ctx, kind) {
+async function handleNewCommand(ctx) {
+  const kind = "new";
   if (!isAuthorizedSender(ctx))
     return;
   const name = (typeof ctx.match === "string" ? ctx.match : "").trim() || getMyAgentName();
@@ -63307,7 +63499,7 @@ async function handleNewOrResetCommand(ctx, kind) {
   const flushed = agentDir != null ? flushAgentHandoff(agentDir) : 0;
   const chatId = String(ctx.chat.id);
   const threadId = resolveThreadId(chatId, ctx.message?.message_thread_id);
-  const ackText = kind === "new" ? newSessionAckText(name, flushed > 0) : resetSessionAckText(name, flushed > 0);
+  const ackText = newSessionAckText(name, flushed > 0);
   let ackId = null;
   try {
     const sent = await retryWithThreadFallback(robustApiCall, (tid) => lockedBot.api.sendMessage(chatId, ackText, {
@@ -63325,7 +63517,7 @@ async function handleNewOrResetCommand(ctx, kind) {
   writeRestartMarker({ chat_id: chatId, thread_id: threadId ?? null, ack_message_id: ackId, ts: Date.now() });
   if (agentDir != null) {
     try {
-      writeFileSync25(join35(agentDir, ".force-fresh-session"), `${kind} at ${new Date().toISOString()}
+      writeFileSync26(join36(agentDir, ".force-fresh-session"), `${kind} at ${new Date().toISOString()}
 `, "utf8");
     } catch (err) {
       process.stderr.write(`telegram gateway: failed to write force-fresh marker: ${err}
@@ -63352,8 +63544,7 @@ async function handleNewOrResetCommand(ctx, kind) {
   await switchroomReply(ctx, `\u274C <b>${escapeHtmlForTg(kind)} ${escapeHtmlForTg(name)} failed via hostd</b> (result=${escapeHtmlForTg(hostdResp.result)}):
 ` + preBlock(hostdResp.error ?? "(no error message)"), { html: true });
 }
-bot.command("new", async (ctx) => handleNewOrResetCommand(ctx, "new"));
-bot.command("reset", async (ctx) => handleNewOrResetCommand(ctx, "reset"));
+bot.command("new", async (ctx) => handleNewCommand(ctx));
 bot.command("update", async (ctx) => {
   if (!isAuthorizedSender(ctx))
     return;
@@ -63691,10 +63882,10 @@ bot.command("interrupt", async (ctx) => {
 });
 var lockoutOps = {
   readFileSync: (p, enc) => readFileSync36(p, enc),
-  writeFileSync: (p, data, opts) => writeFileSync25(p, data, opts),
+  writeFileSync: (p, data, opts) => writeFileSync26(p, data, opts),
   existsSync: (p) => existsSync38(p),
-  mkdirSync: (p, opts) => mkdirSync26(p, opts),
-  joinPath: (...parts) => join35(...parts)
+  mkdirSync: (p, opts) => mkdirSync27(p, opts),
+  joinPath: (...parts) => join36(...parts)
 };
 var FLEET_FALLBACK_DEDUP_MS = 30000;
 function isAuthBrokerSocketReachable() {
@@ -63784,7 +63975,7 @@ async function runCreditWatch() {
   if (!agentDir)
     return;
   const agentName3 = getMyAgentName();
-  const claudeConfigDir = join35(agentDir, ".claude");
+  const claudeConfigDir = join36(agentDir, ".claude");
   const stateDir = STATE_DIR;
   const reason = readClaudeJsonOverage(claudeConfigDir);
   const prev = loadCreditState(stateDir);
@@ -64310,10 +64501,10 @@ async function handleVaultRecentDenialCallback(ctx, data) {
     return;
   }
   const { token, id } = result;
-  const tokenPath = join35(homedir14(), ".switchroom", "agents", agentName3, ".vault-token");
+  const tokenPath = join36(homedir14(), ".switchroom", "agents", agentName3, ".vault-token");
   try {
-    mkdirSync26(join35(homedir14(), ".switchroom", "agents", agentName3), { recursive: true });
-    writeFileSync25(tokenPath, token, { mode: 384 });
+    mkdirSync27(join36(homedir14(), ".switchroom", "agents", agentName3), { recursive: true });
+    writeFileSync26(tokenPath, token, { mode: 384 });
   } catch (err) {
     await switchroomReply(ctx, `<b>Grant created (${escapeHtmlForTg(id)}) but token write failed:</b> ${escapeHtmlForTg(String(err))}
 <i>Recover with: <code>switchroom vault grant ${escapeHtmlForTg(agentName3)} --keys ${escapeHtmlForTg(keyName)} --duration 30d</code> on the host.</i>`, { html: true });
@@ -64389,10 +64580,10 @@ async function performVaultAccessApproval(ctx, pending2, stageId, senderId, atte
     return;
   }
   const { token, id } = result;
-  const tokenPath = join35(homedir14(), ".switchroom", "agents", pending2.agent, ".vault-token");
+  const tokenPath = join36(homedir14(), ".switchroom", "agents", pending2.agent, ".vault-token");
   try {
-    mkdirSync26(join35(homedir14(), ".switchroom", "agents", pending2.agent), { recursive: true });
-    writeFileSync25(tokenPath, token, { mode: 384 });
+    mkdirSync27(join36(homedir14(), ".switchroom", "agents", pending2.agent), { recursive: true });
+    writeFileSync26(tokenPath, token, { mode: 384 });
   } catch (err) {
     await switchroomReply(ctx, `<b>Grant created (${escapeHtmlForTg(id)}) but token write failed:</b> ${escapeHtmlForTg(String(err))}
 <i>Recover with: <code>switchroom vault grant ${escapeHtmlForTg(pending2.agent)} --keys ${escapeHtmlForTg(pending2.key)} --duration ${Math.round(pending2.ttl_seconds / 86400)}d</code> on the host.</i>`, { html: true });
@@ -64871,10 +65062,10 @@ async function executeGrantWizard(ctx, chatId, state4) {
     return;
   }
   const { token, id } = result;
-  const tokenPath = join35(homedir14(), ".switchroom", "agents", state4.agent, ".vault-token");
+  const tokenPath = join36(homedir14(), ".switchroom", "agents", state4.agent, ".vault-token");
   try {
-    mkdirSync26(join35(homedir14(), ".switchroom", "agents", state4.agent), { recursive: true });
-    writeFileSync25(tokenPath, token, { mode: 384 });
+    mkdirSync27(join36(homedir14(), ".switchroom", "agents", state4.agent), { recursive: true });
+    writeFileSync26(tokenPath, token, { mode: 384 });
   } catch (err) {
     await switchroomReply(ctx, `<b>Grant created but token write failed:</b> ${escapeHtmlForTg(String(err))}`, { html: true });
     return;
@@ -65722,7 +65913,7 @@ bot.command("usage", async (ctx) => {
     await switchroomReply(ctx, "<b>/usage:</b> cannot resolve agent dir.", { html: true });
     return;
   }
-  const result = await fetchQuota2({ claudeConfigDir: join35(agentDir, ".claude") });
+  const result = await fetchQuota2({ claudeConfigDir: join36(agentDir, ".claude") });
   if (!result.ok) {
     await switchroomReply(ctx, `<b>/usage:</b> ${escapeHtmlForTg(result.reason)}`, { html: true });
     return;
@@ -66462,9 +66653,9 @@ bot.on("message:photo", async (ctx) => {
         fileUniqueId: best.file_unique_id,
         now: Date.now()
       });
-      mkdirSync26(INBOX_DIR, { recursive: true, mode: 448 });
+      mkdirSync27(INBOX_DIR, { recursive: true, mode: 448 });
       assertInsideInbox(INBOX_DIR, dlPath);
-      writeFileSync25(dlPath, buf, { mode: 384 });
+      writeFileSync26(dlPath, buf, { mode: 384 });
       return dlPath;
     } catch (err) {
       const msg = err instanceof Error ? err.message : "unknown error";
@@ -67243,25 +67434,14 @@ process.on("uncaughtException", (err) => {
   shutdown("uncaughtException");
 });
 var runnerHandle = null;
-var POLL_HEALTH_INTERVAL_MS = Number(process.env.SWITCHROOM_POLL_HEALTH_INTERVAL_MS ?? 300000);
+var POLL_HEALTH_INTERVAL_MS = Number(process.env.SWITCHROOM_POLL_HEALTH_INTERVAL_MS ?? 60000);
 var POLL_HEALTH_THRESHOLD = Number(process.env.SWITCHROOM_POLL_HEALTH_THRESHOLD ?? 3);
 var pollHealthCheck = null;
 if (POLL_HEALTH_INTERVAL_MS > 0) {
   pollHealthCheck = createPollHealthCheck({
     ping: () => bot.api.getMe(),
     onStall: async () => {
-      const agentName3 = process.env.SWITCHROOM_AGENT_NAME ?? "-";
-      process.stderr.write(`telegram gateway: poll.health_check.stall_recovery stopping runner agent=${agentName3}
-`);
-      if (runnerHandle != null && runnerHandle.isRunning()) {
-        try {
-          await runnerHandle.stop();
-        } catch (err) {
-          process.stderr.write(`telegram gateway: poll.health_check.stall_recovery runner.stop error: ${err.message}
-`);
-        }
-      }
-      runnerHandle = null;
+      recoverFromPollStall({ agentName: process.env.SWITCHROOM_AGENT_NAME ?? "-" });
     },
     intervalMs: POLL_HEALTH_INTERVAL_MS,
     failureThreshold: POLL_HEALTH_THRESHOLD,
@@ -67449,7 +67629,7 @@ var didOneTimeSetup = false;
                         return;
                       }
                     })();
-                    const resolvedAgentDirForBootCard = agentDir ?? join35(homedir14(), ".switchroom", "agents", agentSlug);
+                    const resolvedAgentDirForBootCard = agentDir ?? join36(homedir14(), ".switchroom", "agents", agentSlug);
                     const handle = await startBootCard(chatId, threadId, botApiForCard, {
                       agentName: agentDisplayName,
                       agentSlug,
@@ -67463,8 +67643,8 @@ var didOneTimeSetup = false;
                       probeQuotaViaBroker: (t) => probeQuotaForBootCard(agentSlug, t),
                       tmuxSupervisor: process.env.SWITCHROOM_TMUX_SUPERVISOR === "1",
                       dockerMode: process.env.SWITCHROOM_RUNTIME === "docker",
-                      configSnapshotPath: join35(resolvedAgentDirForBootCard, ".config-snapshot.json"),
-                      bootCardStatePath: join35(resolvedAgentDirForBootCard, ".boot-card-msgid.json"),
+                      configSnapshotPath: join36(resolvedAgentDirForBootCard, ".config-snapshot.json"),
+                      bootCardStatePath: join36(resolvedAgentDirForBootCard, ".boot-card-msgid.json"),
                       ...updateOutcomeLine ? { updateOutcomeLine } : {}
                     }, ackMsgId);
                     activeBootCard = handle;
@@ -67851,13 +68031,6 @@ var didOneTimeSetup = false;
       pollHealthCheck?.stop();
       pollHealthCheck?.start();
       await runnerHandle.task();
-      if (runnerHandle === null) {
-        const agentName3 = process.env.SWITCHROOM_AGENT_NAME ?? "-";
-        process.stderr.write(`telegram gateway: poll.health_check.stall_recovery restarting runner agent=${agentName3}
-`);
-        await new Promise((r) => setTimeout(r, 2000));
-        continue;
-      }
       return;
     } catch (err) {
       if (err instanceof import_grammy9.GrammyError && err.error_code === 409) {