@mrciphersmith/keryx 0.3.110 → 0.3.111

package/README.md

@@ -1060,13 +1060,25 @@ runs. At most 500 lines wait per topic, and turning it off tells the topic which
 queued lines will not run. From the topic you can also run a fixed list of slash
 commands (`/status`, `/model` and `/connect` as buttons, `/new`, `/clear`, `/resume`
 in the same topic); `/mode trust`, `/plan off`, `/delegate` and `/external*` run only
-after a Yes press, and commands such as `/mcp`, `/guard`, `/route`, `/provider`,
-`/schedule`, `/rewind`, `/conform` and `/ci` stay local. A topic is deleted when the
-shell exits, so `/history [N]` (1 to 20, 10 by default) posts the session's last messages
+after a Yes press (so do `/route on` and `/route off`; bare `/route` shows at once),
+and commands such as `/mcp`, `/guard`, `/provider`, `/schedule`, `/rewind`,
+`/conform` and `/ci` stay local. When main is busy, `/route`, `/external`,
+`/external-agents` and `/model` are queued with a notice in the topic and run when
+it goes idle; `/mode` takes effect at once. A topic is archived when the shell
+exits (a closing note, the topic and its history stay readable), but a resumed
+session gets a new one, so `/history [N]` (1 to 20, 10 by default) posts the session's last messages
 back into the topic, yours and the agent's final answers, one message each; a resumed
 session whose topic was just created gets the last 10 by itself, once (the first time remote control is turned on in that shell); a turn that looks like it holds a secret is replaced by a placeholder. Each message shows its state as a reaction and the topic shows typing
 while a turn runs; see
 [commands from the topic](docs/docs/guides/drive-keryx-remotely.md#commands-from-the-topic).
+Every approval, `ask_user` question and queue dialog the shell raises is posted to
+the topic with buttons, whoever started the turn; the first answer wins, from the
+terminal or the topic, and an unanswered one gets a reminder every 2 minutes (at most 3).
+While a turn runs, the topic gets at most one progress note a minute (at wave
+boundaries and after tool-heavy stretches: counts and tool names, never tool output),
+and a short status question such as "how is it going?" is answered from session state
+without waiting for the turn; see
+[What the topic hears](docs/docs/guides/drive-keryx-remotely.md#what-the-topic-hears).
 Without a connection `serve` starts as before, with remote control off, and only
 offers the local `/channels` routes. Replies are rendered in one of four modes,
 `remote.rendering` = `auto` (the default), `rich`, `html` or `plain`, set from the

package/dist/cli.js

@@ -21147,7 +21147,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@mrciphersmith/keryx",
-    version: "0.3.110",
+    version: "0.3.111",
     description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
     private: false,
     publishConfig: {
@@ -123364,7 +123364,7 @@ class SseParser {
     return frames;
   }
 }
-var REMOTE_API_PREFIX = "/v1/remote", REMOTE_SCHEMA_VERSION = "1.0.0", REMOTE_ROUTE_METHODS, CHANNELS_ROUTE_METHODS, MAX_REMOTE_BODY_BYTES, MAX_PROJECT_CHARS = 256, MAX_APPROVAL_PROMPT_CHARS = 3000, MAX_KEYBOARD_ROWS = 8, MAX_KEYBOARD_BUTTONS_PER_ROW = 8, MAX_BUTTON_TEXT_CHARS = 64, MAX_CALLBACK_DATA_BYTES = 64, DEFAULT_APPROVAL_TIMEOUT_MS, MAX_APPROVAL_TIMEOUT_MS, MIN_APPROVAL_TIMEOUT_MS = 100, DEFAULT_APPROVAL_ACK_MS = 5000, DEFAULT_KEEPALIVE_MS = 15000, DEFAULT_ACK_TIMEOUT_MS = 30000, SESSION_ID_PATTERN, APPROVAL_ID_PATTERN, APPROVAL_CALLBACK_PATTERN, RESERVED_CALLBACK_PREFIX = "ap:", PROMPT_ID_PATTERN, CHOICE_CALLBACK_PATTERN, OWN_ANSWER_BUTTON_LABEL = "\u270D \u0421\u0432\u043E\u0439 \u043E\u0442\u0432\u0435\u0442", OWN_ANSWER_WINDOW_MS, OWN_REPLY_PROMPT = "Reply to this message with your own answer. It is open for 5 minutes.", MAX_OWN_ANSWER_CHARS = 4096, OWN_CALLBACK_PATTERN, RESERVED_CHOICE_PREFIX = "pk:", MAX_PROMPT_BUTTONS = 24, INTAKE_SERVICE_TOPIC = "Intake", RESERVED_INTAKE_PREFIX = "in:", MAX_REMEMBER_PATTERN_CHARS = 300, APPROVAL_INPUT_PREVIEW_CHARS = 1500, MESSAGE_STATES, SSE_KEEPALIVE_FRAME = `: keepalive
+var REMOTE_API_PREFIX = "/v1/remote", REMOTE_SCHEMA_VERSION = "1.0.0", REMOTE_ROUTE_METHODS, CHANNELS_ROUTE_METHODS, MAX_REMOTE_BODY_BYTES, MAX_PROJECT_CHARS = 256, MAX_APPROVAL_PROMPT_CHARS = 3000, MAX_KEYBOARD_ROWS = 8, MAX_KEYBOARD_BUTTONS_PER_ROW = 8, MAX_BUTTON_TEXT_CHARS = 64, MAX_CALLBACK_DATA_BYTES = 64, DEFAULT_APPROVAL_TIMEOUT_MS, MAX_APPROVAL_TIMEOUT_MS, MIN_APPROVAL_TIMEOUT_MS = 100, DEFAULT_PROMPT_REMINDER_MS, MAX_PROMPT_REMINDERS = 3, DEFAULT_APPROVAL_ACK_MS = 5000, DEFAULT_KEEPALIVE_MS = 15000, DEFAULT_ACK_TIMEOUT_MS = 30000, SESSION_ID_PATTERN, APPROVAL_ID_PATTERN, APPROVAL_CALLBACK_PATTERN, RESERVED_CALLBACK_PREFIX = "ap:", PROMPT_ID_PATTERN, CHOICE_CALLBACK_PATTERN, OWN_ANSWER_BUTTON_LABEL = "\u270D \u0421\u0432\u043E\u0439 \u043E\u0442\u0432\u0435\u0442", OWN_ANSWER_WINDOW_MS, OWN_REPLY_PROMPT = "Reply to this message with your own answer. It is open for 5 minutes.", MAX_OWN_ANSWER_CHARS = 4096, OWN_CALLBACK_PATTERN, RESERVED_CHOICE_PREFIX = "pk:", MAX_PROMPT_BUTTONS = 24, INTAKE_SERVICE_TOPIC = "Intake", RESERVED_INTAKE_PREFIX = "in:", MAX_REMEMBER_PATTERN_CHARS = 300, APPROVAL_INPUT_PREVIEW_CHARS = 1500, MESSAGE_STATES, SSE_KEEPALIVE_FRAME = `: keepalive
 
 `;
 var init_protocol2 = __esm(() => {
@@ -123394,6 +123394,7 @@ var init_protocol2 = __esm(() => {
   MAX_REMOTE_BODY_BYTES = 64 * 1024;
   DEFAULT_APPROVAL_TIMEOUT_MS = 5 * 60000;
   MAX_APPROVAL_TIMEOUT_MS = 60 * 60000;
+  DEFAULT_PROMPT_REMINDER_MS = 2 * 60000;
   SESSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
   APPROVAL_ID_PATTERN = /^ap[0-9a-f]{12}$/;
   APPROVAL_CALLBACK_PATTERN = /^ap:(ap[0-9a-f]{12}):(allow|deny|always)$/;
@@ -123707,6 +123708,9 @@ var init_shell_token = __esm(() => {
 });
 
 // src/remote/client.ts
+function isAborted(signal) {
+  return signal?.aborted === true;
+}
 function closeByFor(signal) {
   return signal?.reason === "cancelled" ? "cancelled" : "shell";
 }
@@ -123931,6 +123935,10 @@ class RemoteClient {
     if (!this.connected) {
       return { decision: "deny" };
     }
+    if (isAborted(options.signal)) {
+      await this.closePrompt(approvalId, closeByFor(options.signal));
+      return { decision: "deny", approvalId };
+    }
     return new Promise((resolve) => {
       const signal = options.signal;
       const onAbort = () => {
@@ -123939,6 +123947,7 @@ class RemoteClient {
           clearTimeout(waiter.timer);
         this.waiters.delete(approvalId);
         resolve({ decision: "deny", approvalId });
+        this.closePrompt(approvalId, closeByFor(signal));
       };
       const timer = setTimeout(() => {
         signal?.removeEventListener("abort", onAbort);
@@ -124520,7 +124529,7 @@ function classifyRemoteCommand(line) {
   const spec = BY_NAME.get(canonical) ?? BY_MENU.get(token);
   if (canonical === "remote-control") {
     const sub = args.split(/\s+/)[0]?.toLowerCase() ?? "";
-    return refuse3(canonical, sub === "off" ? "it would delete this topic; turn it off in the shell" : refusedReason ?? "its panel is local", true);
+    return refuse3(canonical, sub === "off" ? "it would archive this topic; turn it off in the shell" : refusedReason ?? "its panel is local", true);
   }
   if (spec === undefined) {
     if (refusedReason !== undefined) {
@@ -124565,6 +124574,16 @@ function classifyRemoteCommand(line) {
         };
       }
       return first === "" ? { kind: "run", command: name, line: "/external" } : refuse3(name, "use /external, /external on or /external off", true);
+    case "route":
+      if (first === "on" || first === "off") {
+        return {
+          kind: "confirm",
+          command: name,
+          line: `/route ${first}`,
+          summary: `Switch model routing ${first}? This changes which model answers each turn.`
+        };
+      }
+      return first === "" ? { kind: "run", command: name, line: "/route" } : refuse3(name, "use /route, /route on or /route off", true);
     case "external-agents":
       if (first === "on" || first === "off") {
         return {
@@ -124619,7 +124638,10 @@ function remoteHelpText() {
 function isBusyDeferred(name) {
   return BUSY_DEFERRED_COMMANDS.includes(name);
 }
-var REMOTE_COMMANDS, REMOTE_REFUSED, BUSY_DEFERRED_COMMANDS, BUSY_REASON = "main is busy: command deferred", BY_NAME, BY_MENU;
+function isQueuedWhenBusy(name) {
+  return QUEUED_WHEN_BUSY_COMMANDS.includes(name);
+}
+var REMOTE_COMMANDS, REMOTE_REFUSED, BUSY_DEFERRED_COMMANDS, QUEUED_WHEN_BUSY_COMMANDS, BUSY_REASON = "main is busy: command deferred", BY_NAME, BY_MENU;
 var init_command_gateway = __esm(() => {
   REMOTE_COMMANDS = [
     { name: "help", kind: "builtin", description: "List the commands you can use from this topic" },
@@ -124650,7 +124672,8 @@ var init_command_gateway = __esm(() => {
     { name: "scenarios", kind: "text", description: "User scenarios the working diff likely changes" },
     { name: "delegate", kind: "confirm", description: "Hand a paid task to an external agent: /delegate <agent> <task>; asks first" },
     { name: "external", kind: "confirm", description: "Show or switch sending work to external providers; on and off ask first" },
-    { name: "external-agents", kind: "confirm", description: "Show or switch the external agent runtime; on and off ask first" }
+    { name: "external-agents", kind: "confirm", description: "Show or switch the external agent runtime; on and off ask first" },
+    { name: "route", kind: "confirm", description: "Show or switch model routing: /route [on|off]; on and off ask first" }
   ];
   REMOTE_REFUSED = {
     exit: "it would close the shell",
@@ -124659,14 +124682,13 @@ var init_command_gateway = __esm(() => {
     provider: "it asks for provider keys and addresses, which are never typed into a chat",
     "search-provider": "it asks for provider keys, which are never typed into a chat",
     "search-connect": "it changes where searches are sent",
-    "remote-control": "turning remote control off would delete this topic, and its panel is local",
+    "remote-control": "turning remote control off would archive this topic, and its panel is local",
     integrate: "it edits other tools' configuration on this machine",
     copy: "it uses this machine's clipboard",
     game: "it needs the shell's screen",
     setup: "it asks for keys and changes the configuration",
     mcp: "it can trust tools and change server connections; use the shell",
     guard: "it changes a safety guard; use the shell",
-    route: "it changes where work is routed; use the shell",
     editguard: "it changes a safety guard; use the shell",
     settings: "it edits settings, some of them secret; use the shell",
     bus: "it talks to other agents on this machine",
@@ -124695,7 +124717,8 @@ var init_command_gateway = __esm(() => {
     ci: "it opens a panel in the shell",
     jevprofile: "it opens a panel with toggles in the shell"
   };
-  BUSY_DEFERRED_COMMANDS = ["new", "clear", "resume", "sessions", "compact", "model", "connect"];
+  BUSY_DEFERRED_COMMANDS = ["new", "clear", "resume", "sessions", "compact", "model", "connect", "route", "external", "external-agents"];
+  QUEUED_WHEN_BUSY_COMMANDS = ["model", "route", "external", "external-agents"];
   BY_NAME = new Map(REMOTE_COMMANDS.map((spec) => [spec.name, spec]));
   BY_MENU = new Map(REMOTE_COMMANDS.map((spec) => [menuName(spec.name), spec]));
 });
@@ -124873,10 +124896,42 @@ class RemoteCommandRouter {
     this.ctx.reply(refusalText(decision.command, decision.reason)).catch(() => false);
   }
   enqueue(line, command, end) {
+    if (isQueuedWhenBusy(command) && this.busyReason(line, command) !== undefined) {
+      this.detach(async () => {
+        if (await this.awaitIdle(line, command)) {
+          this.enqueueNow(line, command, end);
+        } else {
+          ended(end, "failed");
+        }
+      });
+      return;
+    }
+    this.enqueueNow(line, command, end);
+  }
+  enqueueNow(line, command, end) {
     this.chain = this.chain.then(() => this.execute(command, line, async () => this.ctx.host.runCommand === undefined ? undefined : this.ctx.host.runCommand(line), end)).catch(() => {
       return;
     });
   }
+  async awaitIdle(line, command) {
+    this.ctx.record(`/${command} queued: main is busy`);
+    await this.ctx.reply(this.ctx.compose(`${line} is queued: main is busy. It runs when main is idle.`)).catch(() => false);
+    const { idlePollMs = 250, queuedCommandLimitMs = 30 * 60000 } = this.ctx.limits;
+    const until = Date.now() + queuedCommandLimitMs;
+    while (this.ctx.host.isBusy()) {
+      if (this.ctx.live?.() === false) {
+        this.ctx.record(`${line} dropped: remote control went off while it waited`);
+        return false;
+      }
+      if (Date.now() >= until) {
+        this.ctx.record(`${line} dropped: main stayed busy`);
+        await this.ctx.reply(`${line} was not run: main stayed busy for ${Math.max(1, Math.round(queuedCommandLimitMs / 60000))} minutes. Send it again when the run ends.`).catch(() => false);
+        return false;
+      }
+      await new Promise((resolve) => setTimeout(resolve, idlePollMs));
+    }
+    return true;
+  }
   serial(work) {
     const run = this.chain.then(work);
     this.chain = run.then(() => {
@@ -125037,7 +125092,7 @@ Page ${page + 1} of ${pages}` : title;
   async picker(command, fromId, end) {
     const line = `/${command}`;
     const busy = this.busyReason(line, command);
-    if (busy !== undefined) {
+    if (busy !== undefined && !isQueuedWhenBusy(command)) {
       this.ctx.record(`${line} not run: ${busy}`);
       await this.ctx.reply(`${line} was not run: ${busy}.`).catch(() => false);
       return "failed";
@@ -125079,6 +125134,9 @@ Now: ${current.label}` : ""}`;
       return "failed";
     }
     const switchModel = host.switchModel.bind(host);
+    if (this.busyReason("/model", "model") !== undefined && !await this.awaitIdle(`/model ${chosen.label.replace(/^\* /, "")}`, "model")) {
+      return "failed";
+    }
     const switched = await this.serial(async () => {
       const busy = this.busyReason("/model", "model");
       return busy !== undefined ? { busy } : await switchModel(chosen.id, providerId);
@@ -125167,10 +125225,240 @@ var DEFAULT_ROUTER_LIMITS, PICKER_PAGE_SIZE = 7, LABEL_CHARS = 56, SESSION_COMMA
 var init_command_router = __esm(() => {
   init_command_gateway();
   init_history2();
-  DEFAULT_ROUTER_LIMITS = { runningNoticeMs: 4000, commandLimitMs: 120000, choiceTimeoutMs: 120000 };
+  DEFAULT_ROUTER_LIMITS = {
+    runningNoticeMs: 4000,
+    commandLimitMs: 120000,
+    choiceTimeoutMs: 120000,
+    idlePollMs: 250,
+    queuedCommandLimitMs: 30 * 60000
+  };
   SESSION_COMMANDS = ["new", "clear", "resume"];
 });
 
+// src/remote/progress-notes.ts
+function formatElapsed(ms) {
+  const total = Math.max(0, Math.round(ms / 1000));
+  if (total < 60)
+    return `${total}s`;
+  const minutes = Math.floor(total / 60);
+  const seconds = total % 60;
+  if (minutes < 60)
+    return seconds === 0 ? `${minutes}m` : `${minutes}m ${seconds}s`;
+  const hours = Math.floor(minutes / 60);
+  return `${hours}h ${minutes % 60}m`;
+}
+
+class ProgressNotes {
+  intervalMs;
+  threshold;
+  now;
+  send;
+  setTimer;
+  clearTimer;
+  startedAt;
+  toolCalls = 0;
+  lastTool;
+  sinceNote = 0;
+  namesSinceNote = new Set;
+  lastNoteAt;
+  lastNoteWindowStart;
+  pending;
+  timer;
+  wave = new Map;
+  waveOpen = false;
+  constructor(options) {
+    this.intervalMs = options.intervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS;
+    this.threshold = Math.max(1, options.toolThreshold ?? DEFAULT_PROGRESS_TOOL_THRESHOLD);
+    this.now = options.now ?? Date.now;
+    this.send = options.send;
+    this.setTimer = options.setTimer ?? ((run, ms) => setTimeout(run, ms));
+    this.clearTimer = options.clearTimer ?? ((handle) => clearTimeout(handle));
+  }
+  get enabled() {
+    return this.intervalMs > 0;
+  }
+  begin() {
+    this.dropPending();
+    this.startedAt = this.now();
+    this.toolCalls = 0;
+    this.lastTool = undefined;
+    this.sinceNote = 0;
+    this.namesSinceNote.clear();
+    this.wave.clear();
+    this.waveOpen = false;
+    this.lastNoteWindowStart = this.startedAt;
+  }
+  end() {
+    this.dropPending();
+    this.startedAt = undefined;
+    this.wave.clear();
+    this.waveOpen = false;
+  }
+  reset() {
+    this.end();
+    this.lastNoteAt = undefined;
+  }
+  tool(name) {
+    if (this.startedAt === undefined)
+      return;
+    this.toolCalls += 1;
+    this.sinceNote += 1;
+    if (name !== undefined && name.length > 0) {
+      this.lastTool = name;
+      this.namesSinceNote.add(name);
+    }
+    if (this.sinceNote >= this.threshold)
+      this.post({ priority: 1, build: () => this.toolNote() });
+  }
+  subagent(event) {
+    if (this.startedAt === undefined)
+      return;
+    if (event.kind === "upsert") {
+      this.wave.set(event.id, { status: event.status, label: event.label ?? event.id });
+      if (!this.waveOpen && ACTIVE.has(event.status)) {
+        this.waveOpen = true;
+        this.post({ priority: 2, build: () => this.waveStartNote() });
+        return;
+      }
+    } else if (event.kind === "remove") {
+      this.wave.delete(event.id);
+    } else {
+      return;
+    }
+    if (this.waveOpen && this.activeCount() === 0) {
+      const done = [...this.wave.values()].filter((one) => one.status === "done").length;
+      const failed = [...this.wave.values()].filter((one) => one.status === "failed").length;
+      this.waveOpen = false;
+      this.wave.clear();
+      this.post({ priority: 3, build: () => this.waveEndNote(done, failed) });
+    }
+  }
+  snapshot() {
+    const running = this.startedAt !== undefined;
+    return {
+      running,
+      elapsedMs: running ? this.now() - this.startedAt : 0,
+      toolCalls: this.toolCalls,
+      ...this.lastTool === undefined ? {} : { lastTool: this.lastTool },
+      waveRunning: this.activeCount()
+    };
+  }
+  activeCount() {
+    let count = 0;
+    for (const one of this.wave.values())
+      if (ACTIVE.has(one.status))
+        count += 1;
+    return count;
+  }
+  elapsed() {
+    return formatElapsed(this.startedAt === undefined ? 0 : this.now() - this.startedAt);
+  }
+  toolNote() {
+    const names = [...this.namesSinceNote];
+    const shown = names.slice(0, TOOL_NAMES_SHOWN).join(", ");
+    const more = names.length > TOOL_NAMES_SHOWN ? ` and ${names.length - TOOL_NAMES_SHOWN} more` : "";
+    const window = this.lastNoteWindowStart === undefined ? "" : ` in the last ${formatElapsed(this.now() - this.lastNoteWindowStart)}`;
+    const used = shown.length > 0 ? ` (${shown}${more})` : "";
+    return `Still working: ${this.sinceNote} tool calls${window}${used}. ${this.elapsed()} into this turn.`;
+  }
+  waveStartNote() {
+    const labels = [...this.wave.values()].map((one) => one.label).slice(0, WAVE_LABELS_SHOWN);
+    const total = this.activeCount();
+    const more = total > labels.length ? ` and ${total - labels.length} more` : "";
+    return `A subagent wave started: ${total} running${labels.length > 0 ? ` (${labels.join(", ")}${more})` : ""}. ${this.elapsed()} into this turn.`;
+  }
+  waveEndNote(done, failed) {
+    const failedPart = failed > 0 ? `, ${failed} failed` : "";
+    return `The wave finished: ${done} done${failedPart}. ${this.elapsed()} into this turn.`;
+  }
+  post(next) {
+    if (!this.enabled)
+      return;
+    const at = this.now();
+    if (this.lastNoteAt === undefined || at - this.lastNoteAt >= this.intervalMs) {
+      this.emit(next);
+      return;
+    }
+    if (this.pending === undefined || next.priority >= this.pending.priority)
+      this.pending = next;
+    if (this.timer === undefined) {
+      this.timer = this.setTimer(() => {
+        this.timer = undefined;
+        const held = this.pending;
+        this.pending = undefined;
+        if (held !== undefined && this.startedAt !== undefined)
+          this.emit(held);
+      }, this.lastNoteAt + this.intervalMs - at);
+    }
+  }
+  emit(note) {
+    const text = note.build();
+    this.lastNoteAt = this.now();
+    this.lastNoteWindowStart = this.lastNoteAt;
+    this.sinceNote = 0;
+    this.namesSinceNote.clear();
+    this.pending = undefined;
+    try {
+      this.send(text);
+    } catch {}
+  }
+  dropPending() {
+    this.pending = undefined;
+    if (this.timer !== undefined) {
+      this.clearTimer(this.timer);
+      this.timer = undefined;
+    }
+  }
+}
+function isStatusQuestion(line) {
+  const text = line.trim().toLowerCase().replace(/[?!.\u2026]+$/u, "").replace(/\s+/g, " ").trim();
+  if (text.length === 0 || text.length > 60)
+    return false;
+  return STATUS_PATTERNS.some((pattern) => pattern.test(text));
+}
+function describeStatus(facts) {
+  const lines = [];
+  const { snapshot } = facts;
+  if (facts.turnRunning && snapshot.running) {
+    const tools = snapshot.toolCalls === 0 ? "no tool calls yet" : `${snapshot.toolCalls} tool call${snapshot.toolCalls === 1 ? "" : "s"}${snapshot.lastTool === undefined ? "" : `, last: ${snapshot.lastTool}`}`;
+    lines.push(`Working: this turn has run for ${formatElapsed(snapshot.elapsedMs)}, ${tools}.`);
+  } else if (facts.turnRunning) {
+    lines.push("Working: a turn is running.");
+  } else {
+    lines.push("Busy: the shell is occupied with a command or its queue; no model turn is writing right now.");
+  }
+  if (snapshot.waveRunning > 0)
+    lines.push(`Subagents: ${snapshot.waveRunning} still running.`);
+  const queued = Math.max(facts.queued ?? 0, facts.topicWaiting);
+  if (queued > 0) {
+    lines.push(`Queue: ${queued} message${queued === 1 ? "" : "s"} waiting${facts.topicWaiting > 0 ? ` (${facts.topicWaiting} from this topic)` : ""}.`);
+  }
+  if (facts.openPrompts > 0) {
+    lines.push(`Waiting for you: ${facts.openPrompts} approval or question open in this topic.`);
+  }
+  if (facts.mode !== undefined)
+    lines.push(`Mode: ${facts.mode}.`);
+  return lines.join(`
+`);
+}
+var DEFAULT_PROGRESS_INTERVAL_MS = 60000, DEFAULT_PROGRESS_TOOL_THRESHOLD = 8, TOOL_NAMES_SHOWN = 4, WAVE_LABELS_SHOWN = 3, ACTIVE, STATUS_PATTERNS;
+var init_progress_notes = __esm(() => {
+  ACTIVE = new Set(["queued", "running", "blocked"]);
+  STATUS_PATTERNS = [
+    /^(status|progress|update)( (update|report|check))?( please| pls)?$/,
+    /^(what'?s|what is|whats) (the )?(current )?(status|progress|going on|happening|up)( (now|right now|here))?$/,
+    /^how('?s| is) (it|that|this|the (run|review|task|work|build)) (going|progressing|doing)( so far| now)?$/,
+    /^(are you|r u) (still )?(working|running|busy|alive|there|done|finished|stuck)( yet| now)?$/,
+    /^(is it|are we) (done|finished|ready|stuck)( yet)?$/,
+    /^what are you (doing|working on)( now| right now)?$/,
+    /^where are (you|we)( now| at)?$/,
+    /^(any )?(news|progress|updates?)$/,
+    /^still (working|running|there|alive)$/,
+    /^(\u0441\u0442\u0430\u0442\u0443\u0441|\u043F\u0440\u043E\u0433\u0440\u0435\u0441\u0441|\u043A\u0430\u043A \u0434\u0435\u043B\u0430|\u043A\u0430\u043A \u0443\u0441\u043F\u0435\u0445\u0438|\u043A\u0430\u043A \u0438\u0434\u0451\u0442|\u043A\u0430\u043A \u0438\u0434\u0435\u0442|\u043A\u0430\u043A \u043F\u0440\u043E\u0434\u0432\u0438\u0433\u0430\u0435\u0442\u0441\u044F( \u0440\u0430\u0431\u043E\u0442\u0430)?|\u0447\u0442\u043E \u0442\u0430\u043C|\u0447\u0442\u043E \u043D\u043E\u0432\u043E\u0433\u043E|\u0447\u0442\u043E \u0434\u0435\u043B\u0430\u0435\u0448\u044C|\u0447\u0442\u043E \u043F\u0440\u043E\u0438\u0441\u0445\u043E\u0434\u0438\u0442|\u0447\u0442\u043E \u0441\u0435\u0439\u0447\u0430\u0441 \u043F\u0440\u043E\u0438\u0441\u0445\u043E\u0434\u0438\u0442)( (\u0441\u0435\u0439\u0447\u0430\u0441|\u0442\u0430\u043C|\u0443\u0436\u0435))*$/,
+    /^(\u0442\u044B )?(\u0442\u0443\u0442|\u0436\u0438\u0432|\u0435\u0449\u0451 \u0440\u0430\u0431\u043E\u0442\u0430\u0435\u0448\u044C|\u0435\u0449\u0435 \u0440\u0430\u0431\u043E\u0442\u0430\u0435\u0448\u044C|\u0440\u0430\u0431\u043E\u0442\u0430\u0435\u0448\u044C|\u0437\u0430\u0432\u0438\u0441|\u0437\u0430\u0432\u0438\u0441(\u043B\u0430)?|\u0437\u0430\u043A\u043E\u043D\u0447\u0438\u043B|\u0437\u0430\u043A\u043E\u043D\u0447\u0438\u043B\u0430|\u0433\u043E\u0442\u043E\u0432|\u0433\u043E\u0442\u043E\u0432\u043E)( (\u0442\u0430\u043C|\u0443\u0436\u0435|\u0435\u0449\u0451|\u0435\u0449\u0435|\u0441\u0435\u0439\u0447\u0430\u0441))*$/
+  ];
+});
+
 // src/remote/shell-bridge.ts
 function preview2(text) {
   const one = redactSensitiveText(text).replace(/\s+/g, " ").trim();
@@ -125273,11 +125561,25 @@ class RemoteBridge {
   lastHistory;
   postingClient;
   enabledOnce = false;
+  progress;
+  openPrompts = 0;
   constructor(options) {
     this.options = options;
     this.host = options.host;
     this.now = options.now ?? Date.now;
     this.approvalOverrideMs = options.approvalTimeoutMs;
+    this.progress = new ProgressNotes({
+      ...options.progressIntervalMs === undefined ? {} : { intervalMs: options.progressIntervalMs },
+      ...options.progressToolThreshold === undefined ? {} : { toolThreshold: options.progressToolThreshold },
+      now: this.now,
+      send: (text) => {
+        const client = this.client;
+        if (client === undefined || !client.connected)
+          return;
+        this.push("reply", "progress note");
+        client.reply(composeReply(text)).catch(() => false);
+      }
+    });
     this.router = new RemoteCommandRouter({
       host: {
         isBusy: () => this.host.isBusy(),
@@ -125292,6 +125594,7 @@ class RemoteBridge {
         ...this.host.resumeSession !== undefined ? { resumeSession: (id) => this.host.resumeSession(id) } : {}
       },
       reply: async (text) => this.client !== undefined ? await this.client.reply(text) : false,
+      live: () => this.client !== undefined,
       history: async (args) => await this.historyForCommand(args),
       record: (text) => this.push("command", text),
       compose: composeReply,
@@ -125326,7 +125629,9 @@ class RemoteBridge {
       limits: {
         runningNoticeMs: options.commandRunningNoticeMs ?? DEFAULT_ROUTER_LIMITS.runningNoticeMs,
         commandLimitMs: options.commandLimitMs ?? DEFAULT_ROUTER_LIMITS.commandLimitMs,
-        choiceTimeoutMs: options.choiceTimeoutMs ?? DEFAULT_ROUTER_LIMITS.choiceTimeoutMs
+        choiceTimeoutMs: options.choiceTimeoutMs ?? DEFAULT_ROUTER_LIMITS.choiceTimeoutMs,
+        ...options.idlePollMs !== undefined ? { idlePollMs: options.idlePollMs } : {},
+        ...options.queuedCommandLimitMs !== undefined ? { queuedCommandLimitMs: options.queuedCommandLimitMs } : {}
       }
     });
   }
@@ -125441,6 +125746,7 @@ class RemoteBridge {
     this.clientConnected = false;
     this.lastHistory = undefined;
     this.endTurnState();
+    this.progress.reset();
     this.waiting.length = 0;
     this.host.recordOff();
     const dropped = this.host.dropQueuedTelegramLines?.() ?? [];
@@ -125491,6 +125797,10 @@ class RemoteBridge {
       return;
     }
     this.push("line", `Telegram: ${preview2(line)}`);
+    if (this.host.isBusy() && isStatusQuestion(line)) {
+      this.answerStatus(meta.updateId);
+      return;
+    }
     this.waiting.push({ updateId: meta.updateId, line, ...meta.fromId === undefined ? {} : { fromId: meta.fromId } });
     if (this.host.isBusy()) {
       this.host.enqueue(line);
@@ -125499,6 +125809,22 @@ class RemoteBridge {
       this.host.runLine(line);
     }
   }
+  answerStatus(updateId) {
+    const client = this.client;
+    if (client === undefined)
+      return;
+    this.push("command", "status question answered from session state");
+    const state = this.host.sessionState?.();
+    const text = describeStatus({
+      turnRunning: this.host.turnRunning !== undefined ? this.host.turnRunning() : true,
+      snapshot: this.progress.snapshot(),
+      topicWaiting: this.waiting.length,
+      ...state === undefined ? {} : { queued: state.queued },
+      openPrompts: this.openPrompts,
+      ...state?.mode === undefined ? {} : { mode: state.mode }
+    });
+    client.reply(composeReply(text)).then((sent) => this.report(updateId, sent ? "done" : "failed")).catch(() => this.report(updateId, "failed"));
+  }
   report(updateId, state) {
     const client = this.client;
     if (client?.reportState === undefined)
@@ -125608,6 +125934,8 @@ class RemoteBridge {
   }
   turnStarted(source) {
     this.endTurnState();
+    if (this.client !== undefined)
+      this.progress.begin();
     if (source !== TG_SOURCE || this.client === undefined)
       return;
     const next = this.waiting.shift();
@@ -125625,7 +125953,7 @@ class RemoteBridge {
       this.runTimer = setTimeout(() => {
         this.timedOut = true;
         this.push("error", "run time limit reached; stopping the turn");
-        this.turnAbort?.abort();
+        this.turnAbort?.abort("cancelled");
         this.host.cancelTurn();
       }, limit);
     }
@@ -125639,7 +125967,7 @@ class RemoteBridge {
       return "stopped";
     this.stoppedByUser = true;
     this.push("command", "/stop: stopping the turn");
-    this.turnAbort?.abort();
+    this.turnAbort?.abort("cancelled");
     this.host.cancelTurn();
     return "stopped";
   }
@@ -125649,7 +125977,8 @@ class RemoteBridge {
     if (text.trim().length > 0)
       this.lastAssistantText = text;
   }
-  toolCall() {
+  toolCall(name) {
+    this.progress.tool(name);
     if (!this.tgTurn)
       return;
     this.lastAssistantText = "";
@@ -125668,6 +125997,7 @@ class RemoteBridge {
     client.reply(`Your message "${preview2(line)}" was removed from the queue in the shell, so it will not run.`).catch(() => false);
   }
   async turnSettled(outcome) {
+    this.progress.end();
     if (!this.tgTurn)
       return;
     const client = this.client;
@@ -125695,14 +126025,20 @@ class RemoteBridge {
     const sent = await client.reply(body).catch(() => false);
     this.push(sent ? "reply" : "error", sent ? `reply sent (${body.length} chars)` : "the reply could not be sent");
   }
+  subagentEvent(event) {
+    if (this.client === undefined)
+      return;
+    this.progress.subagent(event);
+  }
   endTurnState() {
+    this.progress.end();
     this.tgTurn = false;
     this.currentUpdate = undefined;
     this.currentFromId = undefined;
     this.lastAssistantText = "";
     this.timedOut = false;
     this.stoppedByUser = false;
-    this.turnAbort?.abort();
+    this.turnAbort?.abort("cancelled");
     this.turnAbort = undefined;
     if (this.runTimer !== undefined) {
       clearTimeout(this.runTimer);
@@ -125720,11 +126056,13 @@ class RemoteBridge {
     }
     this.push("approval", "asked in the topic");
     let answer;
+    this.openPrompts += 1;
     try {
       const text = composeApprovalPrompt(prompt);
-      const timeoutMs = this.approvalTimeoutMs;
+      const timeoutMs = options.timeoutMs ?? this.approvalTimeoutMs;
       if (client.askApproval !== undefined) {
-        const signal = this.turnAbort?.signal;
+        const signals = [this.turnAbort?.signal, options.signal].filter((one) => one !== undefined);
+        const signal = signals.length === 0 ? undefined : signals.length === 1 ? signals[0] : AbortSignal.any(signals);
         const got = await client.askApproval(text, timeoutMs, {
           ...options.remember === undefined ? {} : { remember: options.remember },
           ...signal === undefined ? {} : { signal }
@@ -125736,6 +126074,8 @@ class RemoteBridge {
       }
     } catch {
       answer = { decision: "deny", always: false };
+    } finally {
+      this.openPrompts -= 1;
     }
     const by = answer.fromId === undefined ? "" : ` by user ${answer.fromId}`;
     this.push("approval", answer.decision === "allow" ? `${answer.always ? "allowed (always)" : "allowed"} in the topic${by}` : `denied${by === "" ? " (or no answer)" : by}`);
@@ -125756,6 +126096,7 @@ class RemoteBridge {
     const timeoutMs = this.options.choiceTimeoutMs ?? DEFAULT_ROUTER_LIMITS.choiceTimeoutMs;
     const forUserId = this.telegramTurnUserId;
     this.push("command", "ask_user question asked in the topic");
+    this.openPrompts += 1;
     try {
       if (client.askChoice === undefined) {
         const index = await client.requestChoice(text, rows, timeoutMs, forUserId);
@@ -125773,6 +126114,8 @@ class RemoteBridge {
       return;
     } catch {
       return;
+    } finally {
+      this.openPrompts -= 1;
     }
   }
   async reportRemembered(approvalId, remembered) {
@@ -125788,9 +126131,49 @@ var init_shell_bridge = __esm(() => {
   init_client3();
   init_command_router();
   init_protocol2();
+  init_progress_notes();
   init_history2();
 });
 
+// src/tui/approval-mirror.ts
+function isTopicPress(answer) {
+  return answer.decision === "allow" || answer.fromId !== undefined;
+}
+async function raceApproval(options) {
+  const dockAbort = new AbortController;
+  const topicAbort = new AbortController;
+  let topicAnswer;
+  let settled = false;
+  let started = false;
+  const race = {
+    signal: AbortSignal.any([options.turnSignal, dockAbort.signal]),
+    opened: () => {
+      if (started || settled)
+        return;
+      started = true;
+      options.topic(topicAbort.signal).then((answer) => {
+        if (settled || !isTopicPress(answer))
+          return;
+        topicAnswer = answer;
+        dockAbort.abort("topic");
+      }).catch(() => {
+        return;
+      });
+    },
+    topicWon: () => topicAnswer !== undefined
+  };
+  try {
+    const result = await options.dock(race);
+    if (topicAnswer !== undefined)
+      return { from: "topic", answer: topicAnswer };
+    return { from: "dock", result };
+  } finally {
+    settled = true;
+    if (topicAnswer === undefined)
+      topicAbort.abort(options.turnSignal.aborted ? "cancelled" : "shell");
+  }
+}
+
 // src/remote/history-host.ts
 function sessionEntryOf(resumed) {
   return { resumed, kind: resumed ? "resumed" : "new" };
@@ -157197,9 +157580,9 @@ function createRemoteQueueWiring(deps) {
       if (bridge?.active !== true)
         return;
       const closing = bridge.disable();
-      deps.say(`\u25C7 remote control is turning off: the session changed, and its Telegram topic is being deleted. Turn it on again with /remote-control <name>.
+      deps.say(`\u25C7 remote control is turning off: the session changed, and its Telegram topic is being archived. Turn it on again with /remote-control <name>.
 `);
-      closing.then(() => deps.say(`\u25C7 remote control off: the topic is deleted.
+      closing.then(() => deps.say(`\u25C7 remote control off: the topic is archived.
 `));
     },
     dropQueuedTelegramLines() {
@@ -157231,7 +157614,7 @@ function createRemoteQueueWiring(deps) {
     },
     wrapOnToolCall(base) {
       return (...args) => {
-        deps.getBridge()?.toolCall();
+        deps.getBridge()?.toolCall(typeof args[0] === "string" ? args[0] : undefined);
         base?.(...args);
       };
     },
@@ -157513,7 +157896,7 @@ function clip6(s, max) {
   }
   return `${s.slice(0, Math.max(1, max - 1))}\u2026`;
 }
-function formatElapsed(ms) {
+function formatElapsed2(ms) {
   if (!Number.isFinite(ms) || ms < 0) {
     return "\u2014";
   }
@@ -157588,7 +157971,7 @@ function formatSubagentMeta(session, now = Date.now()) {
       session.runtime === "external" ? `external${session.agentId === undefined ? "" : ` (${session.agentId})`}` : "keryx"
     ],
     ["Model", session.model ?? "\u2014"],
-    ["Elapsed", formatElapsed(end - session.startedAt)],
+    ["Elapsed", formatElapsed2(end - session.startedAt)],
     ["Task", session.task ?? "\u2014"]
   ];
   const width = rows.reduce((max, [label]) => Math.max(max, label.length), 0);
@@ -166189,6 +166572,7 @@ async function launchTuiAgentShell(opts) {
     jobs.subscribe(paintJobs);
     setSubagentFleetListener((ev) => {
       sessions.apply(ev);
+      remoteBridge?.subagentEvent(ev);
     });
     setBackgroundJobListener((ev) => {
       jobs.apply(ev);
@@ -166608,7 +166992,8 @@ async function launchTuiAgentShell(opts) {
       }));
     };
     const approvalContext = createApprovalContextLoader(opts.session?.cwd ?? process.cwd());
-    const confirmScheduleCard = async (card) => {
+    const confirmScheduleCard = async (card, race) => {
+      const dockSignal = race?.signal ?? foregroundOperation.signal;
       for (const line of card) {
         transcript.add(new otui.TextRenderable(r, { id: `ap${uid++}`, content: otui.t`${roleChunk(otui, "attention", line)}` }));
       }
@@ -166618,14 +167003,19 @@ async function launchTuiAgentShell(opts) {
         title: "Create this schedule and install its background timer?",
         subtitle: card[0] ?? "",
         cancelId: "cancel",
-        onOpen: () => chrome.blurComposer(),
-        signal: foregroundOperation.signal,
+        onOpen: () => {
+          chrome.blurComposer();
+          race?.opened();
+        },
+        signal: dockSignal,
         options: [
           { id: "create", label: "Create and install", description: "Store it and install the timer shown above" },
           { id: "cancel", label: "Cancel", description: "Nothing is written or installed" }
         ]
       }));
       input.focus();
+      if (race?.topicWon() === true)
+        return false;
       setMainAgent("running", id === "create" ? "schedule" : "denied");
       transcript.add(new otui.TextRenderable(r, {
         id: `ap${uid++}`,
@@ -166633,7 +167023,8 @@ async function launchTuiAgentShell(opts) {
       }));
       return id === "create";
     };
-    const confirmUserPromptCard = async (card) => {
+    const confirmUserPromptCard = async (card, race) => {
+      const dockSignal = race?.signal ?? foregroundOperation.signal;
       for (const line of card) {
         transcript.add(new otui.TextRenderable(r, { id: `ap${uid++}`, content: otui.t`${roleChunk(otui, "attention", line)}` }));
       }
@@ -166643,14 +167034,19 @@ async function launchTuiAgentShell(opts) {
         title: "Send this message to the model?",
         subtitle: card[0] ?? "",
         cancelId: "cancel",
-        onOpen: () => chrome.blurComposer(),
-        signal: foregroundOperation.signal,
+        onOpen: () => {
+          chrome.blurComposer();
+          race?.opened();
+        },
+        signal: dockSignal,
         options: [
           { id: "send", label: "Send", description: "Let the message reach the model as written" },
           { id: "cancel", label: "Cancel", description: "The message is not sent" }
         ]
       }));
       input.focus();
+      if (race?.topicWon() === true)
+        return false;
       setMainAgent("running", id === "send" ? "prompt" : "denied");
       transcript.add(new otui.TextRenderable(r, {
         id: `ap${uid++}`,
@@ -166682,7 +167078,8 @@ async function launchTuiAgentShell(opts) {
         content: otui.t`${dimChunk(otui, approvalCauseLine(causeOfMeta(tool, meta)))}`
       }));
     };
-    const requestApprovalLocally = async (tool, inputJson, meta) => {
+    const requestApprovalLocally = async (tool, inputJson, meta, race) => {
+      const dockSignal = race?.signal ?? foregroundOperation.signal;
       if (meta?.untrustedOrigin === true) {
         transcript.add(new otui.TextRenderable(r, {
           id: `ap${uid++}`,
@@ -166691,11 +167088,11 @@ async function launchTuiAgentShell(opts) {
       }
       if (isUserPromptApprovalCard(tool) && meta?.alwaysAsk === true && meta.card !== undefined) {
         addCauseLine(tool, meta);
-        return confirmUserPromptCard(meta.card);
+        return confirmUserPromptCard(meta.card, race);
       }
       if (meta?.alwaysAsk === true && meta.card !== undefined) {
         addCauseLine(tool, meta);
-        return confirmScheduleCard(meta.card);
+        return confirmScheduleCard(meta.card, race);
       }
       if (tool === "spawn_subagent") {
         let mode = "read_only";
@@ -166726,8 +167123,11 @@ async function launchTuiAgentShell(opts) {
           title: mode === "read_only" ? meta?.hookAsk === true ? "Spawn read-only subagent? (policy hook asked)" : "Spawn read-only subagent? (follows untrusted content)" : "Spawn general subagent?",
           subtitle: taskPreview,
           cancelId: "deny",
-          onOpen: () => chrome.blurComposer(),
-          signal: foregroundOperation.signal,
+          onOpen: () => {
+            chrome.blurComposer();
+            race?.opened();
+          },
+          signal: dockSignal,
           options: [
             {
               id: "allow",
@@ -166739,6 +167139,8 @@ async function launchTuiAgentShell(opts) {
           ]
         }));
         input.focus();
+        if (race?.topicWon() === true)
+          return false;
         setMainAgent("running", id === "allow" ? "subagent" : "denied");
         transcript.add(new otui.TextRenderable(r, {
           id: `ap${uid++}`,
@@ -166771,14 +167173,19 @@ async function launchTuiAgentShell(opts) {
           title: "Approve apply_patch?",
           subtitle: "Diff shown above \xB7 Esc denies",
           cancelId: "deny",
-          onOpen: () => chrome.blurComposer(),
-          signal: foregroundOperation.signal,
+          onOpen: () => {
+            chrome.blurComposer();
+            race?.opened();
+          },
+          signal: dockSignal,
           options: [
             { id: "allow", label: "Approve", description: "Write the patch to disk", recommended: true },
             { id: "deny", label: "Deny", description: "Do not write anything" }
           ]
         }));
         input.focus();
+        if (race?.topicWon() === true)
+          return false;
         setMainAgent("running", id === "allow" ? "write" : "denied");
         transcript.add(new otui.TextRenderable(r, {
           id: `ap${uid++}`,
@@ -166813,8 +167220,11 @@ async function launchTuiAgentShell(opts) {
           title: described.title,
           subtitle: summariseUseToolApproval(described),
           cancelId: "deny",
-          onOpen: () => chrome.blurComposer(),
-          signal: foregroundOperation.signal,
+          onOpen: () => {
+            chrome.blurComposer();
+            race?.opened();
+          },
+          signal: dockSignal,
           options: [
             { id: APPROVAL_ALLOW_ID, label: "Approve", description: `run ${described.tool} on ${described.server}` },
             ...canTrustMcp ? [{ id: "trust-mcp", label: "Trust this tool (this session)", description: `Skip future approvals for ${described.fqn} in trust mode` }] : [],
@@ -166822,6 +167232,8 @@ async function launchTuiAgentShell(opts) {
           ]
         }));
         input.focus();
+        if (race?.topicWon() === true)
+          return false;
         const verdict = mcpDockVerdict(id, canTrustMcp, meta?.fingerprint);
         const allowed = verdict !== false;
         setMainAgent("running", allowed ? "write" : "denied");
@@ -166864,14 +167276,19 @@ async function launchTuiAgentShell(opts) {
           title: "Approve codex elicitation?",
           subtitle: elicitationSubtitle,
           cancelId: "deny",
-          onOpen: () => chrome.blurComposer(),
-          signal: foregroundOperation.signal,
+          onOpen: () => {
+            chrome.blurComposer();
+            race?.opened();
+          },
+          signal: dockSignal,
           options: [
             { id: "allow", label: "Approve", description: "codex proceeds with this action", recommended: true },
             { id: "deny", label: "Deny", description: "codex's action is refused" }
           ]
         }));
         input.focus();
+        if (race?.topicWon() === true)
+          return false;
         setMainAgent("running", id === "allow" ? "write" : "denied");
         transcript.add(new otui.TextRenderable(r, {
           id: `ap${uid++}`,
@@ -166927,10 +167344,15 @@ async function launchTuiAgentShell(opts) {
       chrome.hideMenu();
       addCauseLine(tool, meta);
       const choice = await chrome.withOverlay(() => pickShellApproval(otui, r, chrome.dock, cmd, approvalContext, destructive, meta?.credentials === true, {
-        onOpen: () => chrome.blurComposer(),
-        signal: foregroundOperation.signal
+        onOpen: () => {
+          chrome.blurComposer();
+          race?.opened();
+        },
+        signal: dockSignal
       }, ev.publishLease, ev.publishLeaseDetail, ev.hookAsk || ev.untrustedOrigin, causeOfMeta(tool, meta)));
       input.focus();
+      if (race?.topicWon() === true)
+        return false;
       if (choice === "deny") {
         transcript.add(new otui.TextRenderable(r, {
           id: `av${uid++}`,
@@ -167017,7 +167439,30 @@ async function launchTuiAgentShell(opts) {
         return false;
       return approvedAnswer();
     };
-    io.requestApproval = trackApproval(requestApprovalLocally);
+    const mirrorApprovalToTopic = (inner) => async (tool, inputJson, meta) => {
+      const bridge = remoteBridge;
+      if (bridge === undefined || !bridge.active) {
+        return inner(tool, inputJson, meta);
+      }
+      const brief = tool.length > 60 ? `${tool.slice(0, 59)}\u2026` : tool;
+      const outcome = await raceApproval({
+        turnSignal: foregroundOperation.signal,
+        dock: (race) => inner(tool, inputJson, meta, race),
+        topic: (signal) => bridge.askApproval(describeApprovalForTopic(tool, inputJson, meta), { signal, timeoutMs: MAX_APPROVAL_TIMEOUT_MS })
+      });
+      if (outcome.from === "dock")
+        return outcome.result;
+      const allowed = outcome.answer.decision === "allow";
+      input.focus();
+      setMainAgent("running", allowed ? "approved (telegram)" : "denied");
+      io.onSystem?.(allowed ? `\u25C7 ${brief} approved in Telegram.
+` : `\u25C7 ${brief} denied in Telegram.
+`);
+      if (!allowed)
+        return false;
+      return meta?.fingerprint !== undefined ? { approved: true, fingerprint: meta.fingerprint } : true;
+    };
+    io.requestApproval = trackApproval(mirrorApprovalToTopic(requestApprovalLocally));
     const askUserInteractive = async (req) => {
       chrome.hideMenu();
       setMainAgent("blocked", "ask");
@@ -167027,7 +167472,7 @@ async function launchTuiAgentShell(opts) {
         id: `ask${uid++}`,
         content: otui.t`${roleChunk(otui, "attention", "? ")} ${dimChunk(otui, qShort)}`
       }));
-      const topicBridge = remoteBridge?.telegramTurnActive === true ? remoteBridge : undefined;
+      const topicBridge = remoteBridge?.active === true ? remoteBridge : undefined;
       const outcome = await raceAskUser({
         turnSignal: foregroundOperation.signal,
         ...topicBridge === undefined ? {} : { topic: (signal) => topicBridge.askUser(req, signal) },
@@ -170182,6 +170627,7 @@ Turn: ${chrome.isBusy() ? "running" : "idle"} \xB7 queue: ${mainQueue.length} wa
         project: () => sessionCwd,
         isBusy: () => chrome.isBusy() || foregroundOperation.isActive || forceHandoff.isAwaitingSettlement || mainQueue.length > 0 || leaseView()?.held() === true,
         turnRunning: () => chrome.isBusy() || foregroundOperation.isActive,
+        sessionState: () => ({ queued: mainQueue.length, mode: formatModeInForce(modeForTurn(true)) }),
         runLine: (text) => remoteQueue.runTelegramLine(text),
         enqueue: (text) => remoteQueue.enqueueTelegramLine(text),
         notice: (text) => io.onSystem?.(`${text}
@@ -170341,6 +170787,7 @@ var init_tui_shell = __esm(() => {
   init_permissions_inspector();
   init_approval_cause();
   init_shell_bridge();
+  init_protocol2();
   init_command_gateway();
   init_history_host();
   init_channels_client();
@@ -210019,6 +210466,12 @@ function createHttpBotApi(options) {
         message_thread_id: params.messageThreadId
       });
     },
+    async closeForumTopic(params) {
+      await call("closeForumTopic", {
+        chat_id: params.chatId,
+        message_thread_id: params.messageThreadId
+      });
+    },
     async editForumTopic(params) {
       await call("editForumTopic", {
         chat_id: params.chatId,
@@ -212585,7 +213038,7 @@ class RemoteHub {
       if (record === undefined) {
         return { ok: true, existed: false };
       }
-      await this.retire(record, "closed by the session");
+      await this.archive(record, "The session was closed.");
       return { ok: true, existed: true };
     });
   }
@@ -212644,11 +213097,11 @@ class RemoteHub {
           this.event("session-unavailable", record.name);
           this.endActivity(record.sessionId);
           if (now - record.unavailableSince < this.config.orphanMs) {
-            this.queueStatus(record, `Session unavailable: the shell stopped responding. This topic is deleted in ${formatDuration(this.config.orphanMs)} unless the session returns.`);
+            this.queueStatus(record, `Session unavailable: the shell stopped responding. This topic is archived in ${formatDuration(this.config.orphanMs)} unless the session returns.`);
           }
         }
         if (record.status === "unavailable" && record.unavailableSince !== undefined && now - record.unavailableSince >= this.config.orphanMs) {
-          await this.retire(record, "orphan timeout");
+          await this.archive(record, "The shell stopped responding and did not return.");
         }
       }
       await this.flushOutbound();
@@ -212912,6 +213365,7 @@ class RemoteHub {
   markLive(record) {
     record.status = "live";
     delete record.unavailableSince;
+    delete record.closing;
   }
   queueStatus(record, text) {
     this.outbound.enqueue({ chatId: record.chatId, threadId: record.threadId, text });
@@ -212991,6 +213445,31 @@ class RemoteHub {
     await this.flushOutbound();
     return { ok: true, name, threadId: record.threadId, reused: false };
   }
+  async archive(record, reason) {
+    this.stopTyping(record);
+    if (record.closing !== true) {
+      record.closing = true;
+      this.queueStatus(record, `${reason} This topic is archived: the history stays here and nothing more will be posted. A new session opens a new topic.`);
+      this.registry.save();
+    }
+    await this.flushOutbound();
+    try {
+      await this.api.closeForumTopic({ chatId: record.chatId, messageThreadId: record.threadId });
+    } catch (error) {
+      if (isBotApiError(error) && isRetryable(error)) {
+        record.sessionId = "";
+        record.status = "unavailable";
+        record.unavailableSince = this.now() - this.config.orphanMs;
+        this.registry.save();
+        this.event("topic-close-failed", `${record.name}: ${describeError4(error)}`);
+        return;
+      }
+    }
+    this.inbound.remove(nameKey(record.name));
+    this.registry.remove(record.name);
+    this.registry.save();
+    this.event("topic-archived", `${record.name}: ${reason}`);
+  }
   async retire(record, why, strict = false) {
     this.outbound.discardForThread(record.chatId, record.threadId);
     this.stopTyping(record);
@@ -213463,6 +213942,7 @@ class RemoteHttpSurface {
   keepaliveMs;
   ackTimeoutMs;
   approvalAckMs;
+  reminderMs;
   newApprovalId;
   newPromptId;
   streams = new Map;
@@ -213483,6 +213963,7 @@ class RemoteHttpSurface {
     this.keepaliveMs = options.keepaliveMs ?? DEFAULT_KEEPALIVE_MS;
     this.ackTimeoutMs = options.ackTimeoutMs ?? DEFAULT_ACK_TIMEOUT_MS;
     this.approvalAckMs = options.approvalAckMs ?? DEFAULT_APPROVAL_ACK_MS;
+    this.reminderMs = options.reminderMs ?? DEFAULT_PROMPT_REMINDER_MS;
     this.newApprovalId = options.approvalIds ?? (() => `ap${randomBytes16(6).toString("hex")}`);
     this.newPromptId = options.promptIds ?? (() => `pk${randomBytes16(6).toString("hex")}`);
     this.consumer = {
@@ -213779,6 +214260,7 @@ class RemoteHttpSurface {
       timer: this.timers.setTimeout(() => this.expireApproval(approvalId), timeoutMs),
       ...remember === undefined ? {} : { remember }
     });
+    this.scheduleReminder("approval", approvalId);
     const offer = remember === undefined ? "" : `
 Always would remember:
 ${asCodeBlock(remember)}`;
@@ -213908,6 +214390,7 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
       ...own ? { own: true } : {},
       timer: this.timers.setTimeout(() => this.expireChoice(promptId), timeoutMs)
     });
+    this.scheduleReminder("question", promptId);
     const keyboard = [];
     let position = 0;
     for (const width of layout) {
@@ -213940,12 +214423,15 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
     if (!isSessionId(value.sessionId)) {
       return invalid2("sessionId must be 1 to 64 characters of letters, digits, '-' and '_'.");
     }
-    if (typeof value.promptId !== "string" || !isPromptId(value.promptId)) {
-      return invalid2("promptId must be a prompt id this serve issued.");
+    if (typeof value.promptId !== "string" || !(isPromptId(value.promptId) || isApprovalId(value.promptId))) {
+      return invalid2("promptId must be a prompt or approval id this serve issued.");
     }
     if (value.by !== undefined && value.by !== "shell" && value.by !== "cancelled") {
       return invalid2("by must be 'shell' or 'cancelled'.");
     }
+    if (isApprovalId(value.promptId)) {
+      return this.closeApproval(value.promptId, value.sessionId, value.by);
+    }
     const entry = this.choices.get(value.promptId);
     if (entry === undefined || entry.sessionId !== value.sessionId) {
       const done = this.finished.get(value.promptId);
@@ -213967,6 +214453,21 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
     });
     return ok2({ closed: true });
   }
+  closeApproval(approvalId, sessionId, by) {
+    const entry = this.approvals.get(approvalId);
+    if (entry === undefined || entry.sessionId !== sessionId) {
+      return ok2({ closed: false });
+    }
+    this.dropApproval(approvalId);
+    this.rememberDecided(approvalId, sessionId);
+    const when = clockText(this.now());
+    const answered = by !== "cancelled";
+    this.finishApproval(approvalId, sessionId, entry.messageId, entry.text, {
+      result: answered ? `Answered in the shell at ${when}.` : `Cancelled at ${when}: the request is no longer open.`,
+      shortReply: answered ? "Answered in the shell." : "That approval is no longer open."
+    });
+    return ok2({ closed: true });
+  }
   async messageState(hub, request) {
     const body = await readJsonBody(request);
     if (!body.ok) {
@@ -214415,6 +214916,7 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
       return;
     }
     this.timers.clearTimeout(entry.timer);
+    this.timers.clearTimeout(entry.reminder);
     this.choices.delete(promptId);
     if (entry.armedReplyId !== undefined) {
       const armed = this.armedOwn.get(entry.armedReplyId);
@@ -214491,6 +214993,7 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
       return;
     }
     this.timers.clearTimeout(entry.timer);
+    this.timers.clearTimeout(entry.reminder);
     this.approvals.delete(approvalId);
   }
   dropAwaiting(approvalId) {
@@ -214524,12 +215027,36 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
       shortReply: "Sent to the shell, not confirmed; it denies by itself if it did not receive it."
     });
   }
+  scheduleReminder(kind, id) {
+    const entry = kind === "approval" ? this.approvals.get(id) : this.choices.get(id);
+    if (entry === undefined || (entry.reminded ?? 0) >= MAX_PROMPT_REMINDERS || this.reminderMs <= 0) {
+      return;
+    }
+    entry.reminder = this.timers.setTimeout(() => this.remind(kind, id), this.reminderMs);
+  }
+  remind(kind, id) {
+    const entry = kind === "approval" ? this.approvals.get(id) : this.choices.get(id);
+    const hub = this.hub;
+    if (entry === undefined || hub === undefined || this.closed) {
+      return;
+    }
+    entry.reminded = (entry.reminded ?? 0) + 1;
+    const left = entry.expiresAt - this.now();
+    const what = kind === "approval" ? "An approval is" : "A question is";
+    const topic = reminderExcerpt(entry.text);
+    const ends = left > 0 ? ` It expires at ${clockText(entry.expiresAt)}.` : "";
+    hub.send(entry.sessionId, `Reminder: ${what} still waiting for an answer here${topic === "" ? "" : `: ${topic}`}.${ends} The buttons are on the message above.`).catch(() => {
+      return;
+    });
+    this.scheduleReminder(kind, id);
+  }
   expireApproval(approvalId) {
     const entry = this.approvals.get(approvalId);
     if (entry === undefined) {
       return;
     }
     this.timers.clearTimeout(entry.timer);
+    this.timers.clearTimeout(entry.reminder);
     this.approvals.delete(approvalId);
     this.finishApproval(approvalId, entry.sessionId, entry.messageId, entry.text, {
       result: `Expired at ${clockText(this.now())}: no answer, so it was denied.`,
@@ -214581,6 +215108,12 @@ ${asCodeBlock(redactSensitiveText(value.prompt))}${offer}`, {
     }
   }
 }
+function reminderExcerpt(text) {
+  const line = (text ?? "").split(`
+`).map((part) => part.replace(/^`{3,}.*$/, "").replace(/^Approval needed:\s*/, "").trim()).find((part) => part.length > 0) ?? "";
+  const flat = line.replace(/\s+/g, " ");
+  return flat.length <= 80 ? flat : `${flat.slice(0, 79)}\u2026`;
+}
 function alwaysButtonText(pattern) {
   const text = `Always: ${pattern.replace(/\s+/g, " ")}`;
   return text.length <= MAX_BUTTON_TEXT_CHARS ? text : `${text.slice(0, MAX_BUTTON_TEXT_CHARS - 1)}\u2026`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.3.110",
+  "version": "0.3.111",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {