polygram 0.10.0-rc.23 → 0.10.0-rc.24

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "polygram",
-  "version": "0.10.0-rc.23",
+  "version": "0.10.0-rc.24",
   "description": "Telegram integration for Claude Code that preserves the OpenClaw per-chat session model. Migration target for OpenClaw users. Multi-bot, multi-chat, per-topic isolation; SQLite transcripts; inline-keyboard approvals. Bundles /polygram:status|logs|pair-code|approvals admin commands plus history (transcript queries) and polygram-send (out-of-turn IPC sends with file-upload validation) skills.",
   "keywords": [
     "telegram",

package/lib/process/tmux-process.js

@@ -1363,6 +1363,40 @@ class TmuxProcess extends Process {
   async _waitForReady() {
     const deadline = this._now() + this.readyTimeoutMs;
     let lastBuf = '';
+    // B6 (shumorobot 2026-05-18, Music topic, twice): a slow
+    // custom-agent spawn (`music-curation:music-curator` loading
+    // several MCP servers) leaves the claude TUI mid-startup for
+    // SECONDS — the production debug log shows MCP connections
+    // spanning 14:45:31→14:45:40 (playwright 2.9s, context7 3.1s,
+    // serena 3.8s, …) with the screen repainting hard the whole time
+    // ("High write ratio: 100.0% writes"). Throughout that window the
+    // TUI ALREADY renders its ready hint (`? for shortcuts` /
+    // `bypass permissions on`) at the bottom of its startup banner.
+    //
+    // The old `_waitForReady` returned the INSTANT `READY_HINTS_RE`
+    // matched — i.e. on the first poll, while MCP servers were still
+    // loading. `start()` resolved early; the first `send()` pasted
+    // the prompt into a TUI still ingesting startup, and the
+    // submitted Enter was dropped → the prompt sat unsubmitted → the
+    // turn never began (a fake THINKING→STALL followed). On a
+    // no-agent TUI the startup window is sub-poll so it never bit; a
+    // slow custom-agent spawn opens a multi-second window every time.
+    //
+    // The banner is NOT a usable "not ready" signal — it stays on the
+    // pane indefinitely (the agent emits nothing pre-turn, so it
+    // never scrolls into scrollback). The real discriminator is
+    // QUIESCENCE: a genuinely-ready idle TUI produces a BYTE-STABLE
+    // `capture-pane` between polls (static banner + empty input box +
+    // ready hint), whereas a mid-startup TUI repaints every tick.
+    //
+    // Fix: require the ready hint to be present AND the captured pane
+    // to be UNCHANGED across consecutive polls for `quiesceMs`
+    // continuously before declaring ready — the same "must hold this
+    // long" idea `_awaitTurnComplete` already uses for turn
+    // completion. Bounded by `readyTimeoutMs`, so a genuinely wedged
+    // spawn still throws TMUX_READY_TIMEOUT.
+    let readySinceAt = null;   // when the (hint + stable-pane) state began
+    let prevBuf = null;        // last poll's capture, for the stability compare
     if (this.pollScheduler) this.pollScheduler.acquire();
     try {
       while (this._now() < deadline) {
@@ -1370,7 +1404,20 @@ class TmuxProcess extends Process {
         // pane. Polling 1000 lines each tick is wasteful — cap at 80
         // for a ~12× cheaper tmux subprocess.
         lastBuf = await this.runner.captureWide(this.tmuxName, { lines: 80 });
-        if (READY_HINTS_RE.test(lastBuf)) return;
+        // Ready ⇔ the hint is on the pane AND the pane is identical to
+        // the previous poll (the MCP-loading repaint storm has
+        // stopped). The first poll has no previous buffer to compare,
+        // so it can never satisfy stability — readiness needs at
+        // least two matching captures, which is the point.
+        const hintPresent = READY_HINTS_RE.test(lastBuf);
+        const paneStable = prevBuf !== null && lastBuf === prevBuf;
+        if (hintPresent && paneStable) {
+          if (readySinceAt == null) readySinceAt = this._now();
+          if (this._now() - readySinceAt >= this.quiesceMs) return;
+        } else {
+          readySinceAt = null;   // pane moved / hint gone → reset the clock
+        }
+        prevBuf = lastBuf;
         await this._waitForNextTick();
       }
     } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polygram",
-  "version": "0.10.0-rc.23",
+  "version": "0.10.0-rc.24",
   "description": "Telegram daemon for Claude Code that preserves the OpenClaw per-chat session model. Migration path for OpenClaw users moving to Claude Code.",
   "main": "lib/ipc/client.js",
   "bin": {