@s0nderlabs/anima-plugin-telegram 0.24.11 → 0.24.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s0nderlabs/anima-plugin-telegram",
-  "version": "0.24.11",
+  "version": "0.24.13",
   "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.11",
+    "@s0nderlabs/anima-core": "0.24.13",
     "grammy": "^1.42.0",
     "zod": "^3.23.8"
   }

package/src/listener.ts

@@ -237,6 +237,14 @@ export class TelegramListener {
         this.installCallbackHandler(handler)
     }
 
+    // v0.24.12: operator-notifier slot. Gateway fills it with brain clarify
+    // questions on autonomous market wakes; we broadcast to every allowed
+    // chat so the operator sees the question on their phone when no TUI is
+    // attached.
+    if (this.opts.operatorNotifier) {
+      this.opts.operatorNotifier.current = text => this.notifyOperators(text)
+    }
+
     await clearWebhookBeforePolling(this.bot)
 
     // v0.20.0: register the bot command menu so Telegram clients show
@@ -279,6 +287,7 @@ export class TelegramListener {
       clearTimeout(this.retryTimer)
       this.retryTimer = null
     }
+    if (this.opts.operatorNotifier) this.opts.operatorNotifier.current = null
     if (!this.running) {
       this.releaseLock()
       return
@@ -298,6 +307,30 @@ export class TelegramListener {
     this.releaseLock()
   }
 
+  /**
+   * v0.24.12: broadcast a short text to every allowed operator chat. Used
+   * by the gateway to forward unsolicited brain prompts (clarify on
+   * autonomous market wakes) when no TUI is connected. Best-effort: per-chat
+   * failures are logged but don't stop the broadcast.
+   */
+  private async notifyOperators(text: string): Promise<void> {
+    if (!this.running) return
+    const trimmed = text.trim()
+    if (trimmed.length === 0) return
+    const body = trimmed.length > 3500 ? `${trimmed.slice(0, 3500)}\n[truncated]` : trimmed
+    await Promise.allSettled(
+      this.opts.allowedUserIds.map(async chatId => {
+        try {
+          await this.bot.api.sendMessage(chatId, body)
+        } catch (err) {
+          console.warn(
+            `[telegram] notifyOperators chat=${chatId} failed: ${(err as Error).message?.slice(0, 200) ?? 'unknown'}`,
+          )
+        }
+      }),
+    )
+  }
+
   private scheduleStartRetry(): void {
     if (this.stopped) return
     if (this.retryAttempts >= MAX_LOCK_RETRY_ATTEMPTS) {

package/src/types.ts

@@ -50,6 +50,19 @@ export interface TelegramRuntimeContext {
    * modal handles all approvals as before.
    */
   approvalBridge?: TelegramApprovalBridge
+  /**
+   * v0.24.12: outbound slot the listener fills on `start()` with a method
+   * that broadcasts a short text to every allowed operator chat. The
+   * gateway uses it to forward unsolicited brain prompts (clarify on
+   * autonomous market wakes) when no TUI is connected. When absent, the
+   * gateway logs the question to activity-log only.
+   */
+  operatorNotifier?: OperatorNotifierSlot
+}
+
+/** Mutable slot the listener fills on start so the gateway can broadcast clarify questions. */
+export interface OperatorNotifierSlot {
+  current: ((text: string) => Promise<void>) | null
 }
 
 export type ApprovalChoiceKind = 'once' | 'session' | 'always' | 'deny'