polygram 0.33.3 → 0.33.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "polygram",
-  "version": "0.33.3",
+  "version": "0.33.5",
   "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/db/codex-reconciliation.js

@@ -152,6 +152,10 @@ function listUnresolvedCodexAttempts(rawDb, input = {}) {
          location.telegram_message_id,
          unresolved.telegram_source_message_id
        )
+     WHERE COALESCE(
+       location.telegram_message_id,
+       unresolved.telegram_source_message_id
+     ) IS NOT NULL
      ORDER BY unresolved.ambiguous_ts,
               unresolved.attempt_id
   `).all(sessionKey, sessionKey);

package/lib/handlers/dispatcher.js

@@ -59,7 +59,7 @@ function createDispatcher({
   // the historic 4096 for back-compat in synthetic test runs that pass
   // pre-formatted text.
   chunkBudget = 4096,
-  // Delay before a silent startup auto-retry re-dispatches (TMUX_SESSION_GONE).
+  // Delay before a silent startup auto-retry re-dispatches a pre-delivery failure.
   // Injected so tests can drive it to 0; production uses STARTUP_RETRY_DELAY_MS.
   startupRetryDelayMs = STARTUP_RETRY_DELAY_MS,
   // AUTH_DISABLED dedupe/re-arm gate (docs/AUTH_DISABLED_HANDLING_SPEC.md).
@@ -306,6 +306,11 @@ function createDispatcher({
         chat_id: chatId, session_key: sessionKey,
         msg_id: msg?.message_id,
         error: err.message?.slice(0, 500),
+        code: err.code || undefined,
+        cause_code: err.cause?.code || undefined,
+        stderr_tail: err.code === 'TMUX_SPAWN_FAILED' && typeof err.stderr === 'string'
+          ? err.stderr.replace(/[\x00-\x08\x0b-\x1f\x7f]/g, '').slice(-500)
+          : undefined,
         stack: err.stack?.split('\n').slice(0, 5).join('\n'),
         aborted: wasAborted || undefined,
         replay: isReplay || undefined,
@@ -442,23 +447,17 @@ function createDispatcher({
           }
         }
         const provider = providerRecovery?.provider;
-        // Startup auto-retry (option a, 2026-06-04). TMUX_SESSION_GONE = claude
-        // exited INSIDE the startup gate, before the dev-channels channel went
-        // live — so the user's message was NEVER delivered to claude. That makes
-        // a re-send idempotent BY CONSTRUCTION (unlike a mid-turn drop, where
-        // claude might still be slowly processing). The session_id was just
-        // poison-cleared above, so re-dispatching the SAME message spawns a FRESH
-        // session and delivers it. Silent: a transient startup flake (recurs
-        // ~once/9h on the channels backend) never reaches the user — instead of
-        // the "🔄 reset it, resend" papercut, polygram just retries. One-shot
-        // (_startupRetried) so a host that genuinely can't start claude surfaces
-        // the friendly reset reply (below) after EXACTLY one retry, never a loop.
-        // Scoped to TMUX_SESSION_GONE only: CHANNELS_DIALOG_TIMEOUT is a real
-        // blocking dialog (usage-limit / permission) a retry would just re-hit,
-        // so it keeps its "please resend" copy.
-        if (err.code === 'TMUX_SESSION_GONE' && !msg._startupRetried) {
+        // Retry once when startup fails before the bridge can deliver the user's
+        // message. TMUX_SESSION_GONE is poison-cleared above; TMUX_SPAWN_FAILED
+        // is already torn down by CliProcess's start-failure cleanup. Mid-turn
+        // failures and blocking dialogs are excluded because replay could
+        // duplicate work or immediately re-hit the same user decision.
+        const startupRetryable = err.code === 'TMUX_SESSION_GONE'
+          || err.code === 'TMUX_SPAWN_FAILED';
+        if (startupRetryable && !msg._startupRetried) {
           logEvent('startup-auto-retry', {
             chat_id: chatId, session_key: sessionKey, msg_id: msg?.message_id,
+            code: err.code,
           });
           // Re-dispatch a COPY carrying the one-shot marker — never mutate the
           // caller's msg (the boot-replay path shares/re-reads it). unref the

package/lib/telegram/display-hint.js

@@ -73,7 +73,7 @@ const INLINE_MEDIA_PARAGRAPHS = [
   '',
   '**Inline media or `files:`, not both.** A file you embed inline is already delivered; listing that same path in `files:` too sends it a second time as a separate message. Use inline media when the image belongs in the reply, and `files:` when you are handing over a document.',
   '',
-  '**Media and live streaming do not mix.** A message that streams grows by editing, and an edited bubble can never gain media — images degrade to their caption text. When your answer includes media, keep the media OUT of the streamed report: stream the prose, and deliver the media in its own separate reply (with at least a sentence of text). Do not put media in a message you are streaming.',
+  '**Media and live streaming do not mix.** A message that streams grows by editing, and an edited bubble can never gain media — images degrade to their caption text. When your answer includes media (inline images, a collage, a slideshow), skip streaming for that answer entirely: compose it and send ONE reply, with the media rendering inline in the rich document, pictures in place. Do not stream the prose first, and do not split the media into a separate message.',
   '',
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polygram",
-  "version": "0.33.3",
+  "version": "0.33.5",
   "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": {
@@ -63,7 +63,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.2.123",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@shumkov/orchestra": "0.10.9",
+    "@shumkov/orchestra": "0.10.10",
     "better-sqlite3": "^12.9.0",
     "grammy": "^1.42.0",
     "markdown-it": "^14.1.1",