@goodandready/dsh-messenger-gateway 0.3.14 → 0.3.18

package/README.md

@@ -104,6 +104,12 @@ In addition to Telegram, outbound messages can be dispatched to Discord and Slac
 - `notifyBridge` — forward non-messenger web session events to a home
 - Bot token is a DSH secret field — never commit it
 
+## Client UI & Settings Card
+
+- Mounted into `settings.plugin.item` on the Plugins tab (`key: dsh-messenger-gateway`).
+- Configuration is managed reactively via `settingsScope.bind({ namespace: 'dsh-messenger-gateway' })` with snapshot status checking (`loading`, `unavailable`, `ready`).
+- Protected dictionary registration: duplicate registration attempts on page reload are safely caught with non-fatal warnings, ensuring the settings card never fails to mount.
+
 ## Requirements
 
 - DeepSeek Harness web (or compatible) profile

package/lib/adapters/telegram.js

@@ -11,7 +11,7 @@ import { normalizeThreadId, telegramThreadParams } from '../topics.js'
 import {
   shouldProcessTelegramMessage, stripBotCommandSuffix,
 } from '../groups.js'
-import { isResendSafeNetworkError, isPollingConflict } from '../telegram-errors.js'
+import { isResendSafeNetworkError, isPollingConflict, computePollBackoffMs } from '../telegram-errors.js'
 
 const API = 'https://api.telegram.org'
 const TELEGRAM_MAX = 4096
@@ -55,6 +55,7 @@ export class TelegramAdapter {
     this.sendRetryMax = 2
     this.sendRetryBaseMs = 400
     this.pollingConflict = false
+    this.pollErrorCount = 0
     this.webhookUrl = String(opts.webhookUrl || '').trim()
     this.webhookSecret = String(opts.webhookSecret || '').trim()
     this.offset = 0
@@ -181,9 +182,10 @@ export class TelegramAdapter {
     if (this.statusIndicator) this.setStatusIndicator(this.statusOffline).catch(() => {})
   }
 
-  schedulePoll() {
+  schedulePoll(delayMs) {
     if (this.stopped) return
-    this.pollTimer = setTimeout(() => this.poll(), this.pollIntervalMs)
+    const delay = delayMs !== undefined ? delayMs : this.pollIntervalMs
+    this.pollTimer = setTimeout(() => this.poll(), delay)
     this.pollTimer.unref?.()
   }
 
@@ -196,6 +198,7 @@ export class TelegramAdapter {
         allowed_updates: ['message', 'callback_query'],
       })
       this.pollingConflict = false
+    this.pollErrorCount = 0
       for (const update of updates || []) {
         this.offset = Math.max(this.offset, update.update_id + 1)
         await this.dispatchUpdate(update)
@@ -579,6 +582,46 @@ export class TelegramAdapter {
     return this.sendReply(chatId, undefined, payload, normalizeThreadId(opts.threadId))
   }
 
+  async probeHealth(timeoutMs = 10000) {
+    if (!this.token) {
+      return { ok: false, error: 'Telegram bot token is empty' }
+    }
+    const start = Date.now()
+    try {
+      const res = await fetch(`${API}/bot${this.token}/getMe`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({}),
+        signal: AbortSignal.timeout(Math.max(1000, Number(timeoutMs) || 10000)),
+      })
+      const latencyMs = Date.now() - start
+      const json = await res.json().catch(() => ({}))
+      if (!res.ok || json.ok === false) {
+        return {
+          ok: false,
+          latencyMs,
+          error: json.description || `HTTP ${res.status}`,
+        }
+      }
+      const me = json.result || {}
+      this.botId = Number(me.id) || this.botId
+      this.botUsername = String(me.username || this.botUsername)
+      return {
+        ok: true,
+        latencyMs,
+        botId: this.botId,
+        botUsername: this.botUsername,
+        firstName: me.first_name || '',
+      }
+    } catch (err) {
+      return {
+        ok: false,
+        latencyMs: Date.now() - start,
+        error: err instanceof Error ? err.message : String(err),
+      }
+    }
+  }
+
   async createForumTopic(chatId, name, opts = {}) {
     return this.call('createForumTopic', {
       chat_id: chatId,