@s0nderlabs/anima-plugin-telegram 0.24.16 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s0nderlabs/anima-plugin-telegram",
-  "version": "0.24.16",
+  "version": "0.25.0",
   "type": "module",
   "description": "Telegram gateway plugin for anima — long-poll bot, debounced dispatch, reactions, allowlist",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@s0nderlabs/anima-core": "0.24.16",
+    "@s0nderlabs/anima-core": "0.25.0",
     "grammy": "^1.42.0",
     "zod": "^3.23.8"
   }

package/src/listener.ts

@@ -64,7 +64,7 @@ export function formatApprovalResolution(choice: ApprovalChoice, byUserId: numbe
  * buttons rendered for tool approvals). Without `'callback_query'` here,
  * Telegram silently filters the click events out of `getUpdates`, the
  * `bot.on('callback_query:data', ...)` handler never fires, and operator
- * taps register on the device but never reach the harness — the modal
+ * taps register on the device but never reach the harness, the modal
  * appears stuck and the brain's tool call hangs until timeout.
  *
  * Latent bug from v0.18.0 (the introduction of inline-keyboard approvals);
@@ -172,7 +172,7 @@ export class TelegramListener {
     // Resolve the modal visually: append the choice + drop the inline
     // keyboard. Without this, every clicked approval message stays on
     // screen with all four buttons, leaving operators unsure whether
-    // their tap registered. Best-effort — if the edit fails (rate
+    // their tap registered. Best-effort, if the edit fails (rate
     // limit, message age, deleted), the underlying approval is still
     // resolved at the runtime level, so we swallow the error.
     const originalText =
@@ -185,7 +185,7 @@ export class TelegramListener {
         await ctx.editMessageReplyMarkup({ reply_markup: undefined })
       }
     } catch {
-      /* ignore — modal was clicked, runtime already resolved; keyboard cleanup is cosmetic */
+      /* ignore, modal was clicked, runtime already resolved; keyboard cleanup is cosmetic */
     }
   }
 
@@ -514,11 +514,15 @@ export class TelegramListener {
       const stack = err instanceof Error && err.stack ? `\n${err.stack}` : ''
       console.error(`[telegram] dispatch failed: ${msg.slice(0, 500)}${stack}`)
       void reactError(this.bot, chatId, messageId)
-      // Translate LedgerInsufficientError into an actionable topup hint
-      // instead of the generic "something went wrong" reply. Detect by
-      // name (avoids requiring the plugin to import core's typed class).
-      const isLedger = err instanceof Error && err.name === 'LedgerInsufficientError'
-      const replyText = isLedger
+      // Translate a credit/ledger-exhaustion error into an actionable topup
+      // hint instead of the generic "something went wrong" reply. Detect by
+      // name (avoids importing core's typed classes): Direct throws
+      // LedgerInsufficientError ("anima topup --compute"), Router throws
+      // RouterCreditError ("anima topup --router"), both carry the actionable
+      // message, so surface it verbatim.
+      const errName = err instanceof Error ? err.name : ''
+      const isTopupHint = errName === 'LedgerInsufficientError' || errName === 'RouterCreditError'
+      const replyText = isTopupHint
         ? `⚠️ I need a top-up to keep working.\n\n${msg}`
         : 'sorry, something went wrong on my side. try again in a moment.'
       try {