@goodandready/dsh-messenger-gateway 0.3.22 → 0.4.0

package/lib/commands.js

@@ -1,74 +1,126 @@
-export const DEFAULT_TELEGRAM_COMMANDS = [
-  { command: 'start', description: 'Connect and show greeting' },
-  { command: 'help', description: 'Show commands help' },
-  { command: 'new', description: 'Start a new agent session' },
-  { command: 'whoami', description: 'Show your messenger user ID' },
-  { command: 'stop', description: 'Interrupt current turn' },
-  { command: 'pair', description: 'Approve pairing code: /pair CODE' },
-  { command: 'sethome', description: 'Set home: /sethome [name]' },
-  { command: 'home', description: 'List registered home channels' },
-  { command: 'model', description: 'Interactive model selector' },
-  { command: 'top', description: 'System resources: CPU, RAM, uptime' },
-  { command: 'topic', description: 'Create forum topic: /topic <name>' },
-  { command: 'status', description: 'Gateway and bot status' },
-  { command: 'setalert', description: 'Designate channel for alerts' },
-  { command: 'alert', description: 'Alert channel status: /alert [test]' },
-  { command: 'keyboard', description: 'Toggle quick actions: /keyboard on|off' },
-  { command: 'role', description: 'Switch persona: /role [name]' },
-  { command: 'bind', description: 'Bind preset/persona to forum topic: /bind <name>' },
-  { command: 'preset', description: 'Show or switch agent preset: /preset [name]' },
-  { command: 'cron', description: 'Manage recurring reports: /cron' },
-  { command: 'skills', description: 'List active tools & skills' },
-  { command: 'tools', description: 'List active tools' },
-  { command: 'fork', description: 'Fork session into new branch' },
-  { command: 'export', description: 'Export history to Markdown' },
-  { command: 'rewind', description: 'Rewind turns: /rewind [N]' },
-  { command: 'files', description: 'Workspace file explorer: /files [dir]' },
-  { command: 'get', description: 'Download file to messenger: /get <path>' },
-  { command: 'remind', description: 'Set reminder: /remind <time> <text>' },
-  { command: 'voice', description: 'Voice reply mode: /voice on|off|status' },
-  { command: 'tts', description: 'Speech in this chat: /tts on|off|status' },
-  { command: 'mute', description: 'Mute notifications in this chat' },
-  { command: 'unmute', description: 'Unmute notifications in this chat' },
-  { command: 'update', description: 'Check or install plugin update: /update [now]' },
-]
-
-export function normalizeTelegramCommands(commands) {
-  const source = Array.isArray(commands) && commands.length ? commands : DEFAULT_TELEGRAM_COMMANDS
-  const out = []
-  const seen = new Set()
-  for (const raw of source) {
-    if (!raw || typeof raw !== 'object') continue
-    let command = String(raw.command || '').trim().replace(/^\//, '')
-    const description = String(raw.description || '').trim()
-    if (!command || !description) continue
-    command = command.slice(0, 32).toLowerCase()
-    if (seen.has(command)) continue
-    seen.add(command)
-    out.push({ command, description: description.slice(0, 256) })
-  }
-  return out.length ? out : [...DEFAULT_TELEGRAM_COMMANDS]
-}
-
-export function mergeDynamicCommands(baseCommands = DEFAULT_TELEGRAM_COMMANDS, dynamicCommands = [], maxTotal = 100) {
-  const normalizedBase = normalizeTelegramCommands(baseCommands)
-  const out = [...normalizedBase]
-  const seen = new Set(out.map((c) => c.command))
-
-  for (const item of dynamicCommands || []) {
-    if (out.length >= maxTotal) break
-    if (!item || typeof item !== 'object') continue
-    let command = String(item.command || item.name || '').trim().replace(/^\//, '').toLowerCase()
-    // Telegram format: lowercase alphanumeric and underscore only, 1-32 chars
-    command = command.replace(/[^a-z0-9_]/g, '_').slice(0, 32)
-    if (!command || seen.has(command)) continue
-    let description = String(item.description || item.title || `Skill ${command}`).trim()
-    if (!description) description = `Skill ${command}`
-    description = description.slice(0, 256)
-    seen.add(command)
-    out.push({ command, description })
-  }
-
-  return out.slice(0, maxTotal)
-}
-
+export const DEFAULT_TELEGRAM_COMMANDS = [
+  { command: 'start', description: 'Connect and show greeting' },
+  { command: 'help', description: 'Show commands help' },
+  { command: 'new', description: 'Start a new agent session' },
+  { command: 'whoami', description: 'Show your messenger user ID' },
+  { command: 'stop', description: 'Interrupt current turn' },
+  { command: 'pair', description: 'Approve pairing code: /pair CODE' },
+  { command: 'sethome', description: 'Set home: /sethome [name]' },
+  { command: 'home', description: 'List registered home channels' },
+  { command: 'model', description: 'Interactive model selector' },
+  { command: 'top', description: 'System resources: CPU, RAM, uptime' },
+  { command: 'topic', description: 'Create forum topic: /topic <name>' },
+  { command: 'status', description: 'Gateway and bot status' },
+  { command: 'setalert', description: 'Designate channel for alerts' },
+  { command: 'alert', description: 'Alert channel status: /alert [test]' },
+  { command: 'keyboard', description: 'Toggle quick actions: /keyboard on|off' },
+  { command: 'role', description: 'Switch persona: /role [name]' },
+  { command: 'bind', description: 'Bind preset/persona to forum topic: /bind <name>' },
+  { command: 'preset', description: 'Show or switch agent preset: /preset [name]' },
+  { command: 'cron', description: 'Manage recurring reports: /cron' },
+  { command: 'skills', description: 'List active tools & skills' },
+  { command: 'tools', description: 'List active tools' },
+  { command: 'fork', description: 'Fork session into new branch' },
+  { command: 'export', description: 'Export history to Markdown' },
+  { command: 'rewind', description: 'Rewind turns: /rewind [N]' },
+  { command: 'files', description: 'Workspace file explorer: /files [dir]' },
+  { command: 'get', description: 'Download file to messenger: /get <path>' },
+  { command: 'remind', description: 'Set reminder: /remind <time> <text>' },
+  { command: 'voice', description: 'Voice reply mode: /voice on|off|status' },
+  { command: 'tts', description: 'Speech in this chat: /tts on|off|status' },
+  { command: 'mute', description: 'Mute notifications in this chat' },
+  { command: 'unmute', description: 'Unmute notifications in this chat' },
+  { command: 'update', description: 'Check or install plugin update: /update [now]' },
+]
+
+export function normalizeTelegramCommands(commands) {
+  const source = Array.isArray(commands) && commands.length ? commands : DEFAULT_TELEGRAM_COMMANDS
+  const out = []
+  const seen = new Set()
+  for (const raw of source) {
+    if (!raw || typeof raw !== 'object') continue
+    let command = String(raw.command || '').trim().replace(/^\//, '')
+    const description = String(raw.description || '').trim()
+    if (!command || !description) continue
+    command = command.slice(0, 32).toLowerCase()
+    if (seen.has(command)) continue
+    seen.add(command)
+    out.push({ command, description: description.slice(0, 256) })
+  }
+  return out.length ? out : [...DEFAULT_TELEGRAM_COMMANDS]
+}
+
+export function mergeDynamicCommands(baseCommands = DEFAULT_TELEGRAM_COMMANDS, dynamicCommands = [], maxTotal = 100) {
+  const normalizedBase = normalizeTelegramCommands(baseCommands)
+  const out = [...normalizedBase]
+  const seen = new Set(out.map((c) => c.command))
+
+  for (const item of dynamicCommands || []) {
+    if (out.length >= maxTotal) break
+    if (!item || typeof item !== 'object') continue
+    let command = String(item.command || item.name || '').trim().replace(/^\//, '').toLowerCase()
+    // Telegram format: lowercase alphanumeric and underscore only, 1-32 chars
+    command = command.replace(/[^a-z0-9_]/g, '_').slice(0, 32)
+    if (!command || seen.has(command)) continue
+    let description = String(item.description || item.title || `Skill ${command}`).trim()
+    if (!description) description = `Skill ${command}`
+    description = description.slice(0, 256)
+    seen.add(command)
+    out.push({ command, description })
+  }
+
+  return out.slice(0, maxTotal)
+}
+
+export function buildQuickActionsKeyboard() {
+  return {
+    keyboard: [
+      [{ text: '🔄 /new' }, { text: '🛑 /stop' }],
+      [{ text: '🎙️ /voice' }, { text: '📊 /status' }],
+    ],
+    resize_keyboard: true,
+  }
+}
+
+export const REMOVE_REPLY_KEYBOARD = { remove_keyboard: true }
+
+export const HELP_TEXT = [
+  '📖 <b>Messenger Gateway Help:</b>',
+  '',
+  '💬 <b>Session & Chat:</b>',
+  '• /help — show this command reference',
+  '• /new — start fresh session',
+  '• /stop — interrupt current response',
+  '• /model — interactive model selector (/model list)',
+  '• /role [name] — switch persona or role (/role list)',
+  '• /bind [role] — bind persona to topic / chat',
+  '• /preset [name] — bind preset to topic / chat',
+  '• /lang [en|zh] — switch user language',
+  '• /rewind [N] — rewind last N turns',
+  '• /fork — fork session into new branch',
+  '• /export — export history to Markdown',
+  '',
+  '🛠️ <b>Tools, Files & Cron:</b>',
+  '• /skills / /tools — list active tools & skills',
+  '• /files [dir] — workspace file explorer',
+  '• /get <path> — download file from workspace',
+  '• /remind <time> <text> — set reminder (/remind 10m check deploy)',
+  '• /cron <interval> <prompt> — recurring autonomous task',
+  '',
+  '⚙️ <b>Settings & Stats:</b>',
+  '• /status — gateway and active model status',
+  '• /top — system resource usage (RAM, uptime)',
+  '• /keyboard on|off — quick action keyboard',
+  '• /voice on|off|status — voice replies preference',
+  '• /tts on|off|status — speech synthesis in this chat',
+  '• /mute / /unmute — mute notifications in this chat',
+  '',
+  '🔒 <b>Access & Channels:</b>',
+  '• /whoami — your messenger user ID',
+  '• /pair CODE — approve pairing code',
+  '• /sethome [name] — set home notification channel',
+  '• /setalert — set alert channel',
+].join('\n')
+
+
+

package/lib/documents.js

@@ -169,4 +169,4 @@ export async function parseDocument(filePath, opts = {}) {
   } catch (err) {
     return { parsed: false, error: err.message }
   }
-}
+}

package/lib/file-manager.js

@@ -160,4 +160,30 @@ export async function getFileForDownload(baseCwd, relativePath, maxBytes = 50 *
     size: st.size,
     mime,
   }
-}
+}
+
+export async function handleFilesCommand(agentCwd, subPath = '.') {
+  const res = await listFiles(agentCwd, subPath)
+  if (!res.ok) return { text: `❌ ${res.error}` }
+  return { text: res.formattedText }
+}
+
+export async function handleGetCommand(agentCwd, targetRel, maxDocBytes = 50 * 1024 * 1024) {
+  if (!targetRel) {
+    return { text: 'Specify file path to download: <code>/get &lt;path&gt;</code>\nBrowse: <code>/files</code>' }
+  }
+  const res = await getFileForDownload(agentCwd, targetRel, maxDocBytes)
+  if (!res.ok) return { text: `❌ ${res.error}` }
+  const file = {
+    name: res.name,
+    mime: res.mime,
+    kind: 'document',
+    bytes: res.bytes,
+    dataBase64: res.bytes.toString('base64'),
+  }
+  return {
+    text: `📄 File: <b>${res.name}</b> (${formatFileSize(res.size)})`,
+    files: [file],
+  }
+}
+

package/lib/forum-mirror.js

@@ -0,0 +1,105 @@
+import { mergeDynamicCommands } from './commands.js'
+import { t } from './locales/index.js'
+import { stripReasoningPreamble, splitText } from './text.js'
+import { stripImageUrls } from './outbound.js'
+
+export function collectDynamicSkills(ctx) {
+    const skills = []
+    try {
+      const skillsService = ctx.get?.('skills') || gw.ctx.skills
+      const allSkills = skillsService?.list?.() || []
+      for (const s of allSkills) {
+        if (!s || !s.name) continue
+        if (s.userInvocable === false) continue
+        skills.push({
+          name: String(s.name),
+          description: String(s.description || s.title || `Skill ${s.name}`).slice(0, 256),
+        })
+      }
+    } catch (err) {
+      ctx.logger?.debug?.(`Failed to collect dynamic skills: ${err?.message || err}`)
+    }
+    return skills
+  }
+export async function syncTelegramCommands(gw) {
+    const tgAdapter = gw.adapters.get('telegram')
+    if (!tgAdapter || typeof tgAdapter.registerCommands !== 'function') return
+    const baseCommands = gw.config.telegram?.commands || []
+    const dynamicSkills = collectDynamicSkills(gw.ctx)
+    const merged = mergeDynamicCommands(baseCommands, dynamicSkills, 100)
+    try {
+      await tgAdapter.registerCommands(merged)
+      ctx.logger?.info?.(`Synced ${merged.length} Telegram commands (including ${dynamicSkills.length} dynamic skills)`)
+    } catch (err) {
+      ctx.logger?.warn?.(`Failed to sync Telegram commands: ${err?.message || err}`)
+    }
+  }
+export async function mirrorSessionToForumTopic(gw, session) {
+    if (!session || !session.id) return
+    const sessionId = String(session.id)
+    if (sessionId.startsWith('msgw-')) return
+    if (gw.sessionToThread.has(sessionId)) return
+
+    const tgCfg = gw.config.telegram || {}
+    if (!tgCfg.forumMirrorEnabled || !tgCfg.forumMirrorChatId) return
+
+    const tgAdapter = gw.adapters.get('telegram')
+    if (!tgAdapter || typeof tgAdapter.createForumTopic !== 'function') return
+
+    const forumChatId = tgCfg.forumMirrorChatId
+    const title = String(session.title || session.meta?.name || `Session ${sessionId.slice(0, 8)}`).slice(0, 120)
+
+    try {
+      const topic = await tgAdapter.createForumTopic(forumChatId, title)
+      const threadId = topic?.message_thread_id
+      if (!threadId) return
+
+      const threadKey = `${forumChatId}:${threadId}`
+      gw.sessionToThread.set(sessionId, { chatId: forumChatId, threadId })
+      gw.threadToSession.set(threadKey, sessionId)
+
+      const text = t('mirror.created', { sessionId, title }, 'en')
+      await tgAdapter.sendTo(forumChatId, { text }, { threadId })
+      ctx.logger?.info?.(`Mirrored session ${sessionId} to Telegram forum topic ${threadId} in ${forumChatId}`)
+    } catch (err) {
+      ctx.logger?.warn?.(`Failed to mirror session ${sessionId} to forum topic: ${err?.message || err}`)
+    }
+  }
+export async function relayTurnToForumMirror(gw, session, event) {
+    if (!session || !session.id) return
+    const sessionId = String(session.id)
+    const threadInfo = gw.sessionToThread.get(sessionId)
+    if (!threadInfo) return
+    if (gw.pending.has(sessionId)) return
+
+    const tgAdapter = gw.adapters.get('telegram')
+    if (!tgAdapter) return
+
+    const messages = Array.isArray(session.messages)
+      ? session.messages
+      : (Array.isArray(session.history) ? session.history : [])
+
+    for (let i = messages.length - 1; i >= 0; i--) {
+      const msg = messages[i]
+      const role = msg.role || (msg.type === 'user' ? 'user' : 'assistant')
+      if (role === 'assistant') {
+        let text = ''
+        if (typeof msg.content === 'string') text = msg.content
+        else if (Array.isArray(msg.content)) {
+          text = msg.content
+            .map((p) => (typeof p === 'string' ? p : (p?.text || '')))
+            .filter(Boolean)
+            .join('\n')
+        } else if (msg.text) text = msg.text
+        const clean = stripReasoningPreamble(stripImageUrls(text)).trim()
+        if (clean) {
+          const maxLen = Number(gw.config.agent?.maxMessageLength) || 4000
+          const chunks = splitText(clean, maxLen)
+          for (const chunk of chunks) {
+            await tgAdapter.sendTo(threadInfo.chatId, { text: chunk }, { threadId: threadInfo.threadId })
+          }
+        }
+        break
+      }
+    }
+  }

package/lib/gateway-callbacks.js

@@ -0,0 +1,187 @@
+import { t } from './locales/index.js'
+import {
+  parseCallbackData, parseAskCallback, targetMatchesAsk,
+  releaseCallbacks, buildMultiSelectKeyboard, indexCallbacks, REMOVE_KEYBOARD
+} from './ask.js'
+import {
+  listModelCatalog, buildProvidersKeyboard, buildModelsKeyboard, storeModelSelection
+} from './models.js'
+
+export async function handleGatewayCallback(gw, cb) {
+    if (cb.userId && !gw.isUserAllowed(cb.userId)) {
+      try { await cb.answer(t('msg.not_allowed', {}, 'en')) } catch (err) { gw.recordApiFailure('cb.answer.not_allowed', err) }
+      return
+    }
+    const indexed = gw.callbackIndex.get(cb.data)
+    const { token, buttonId } = parseCallbackData(cb.data)
+    const askToken = indexed || token
+    if (askToken && gw.pendingAsks.has(askToken)) {
+      const pending = gw.pendingAsks.get(askToken)
+      if (!targetMatchesAsk(pending, cb)) {
+        await cb.answer(t('ask.other_chat', {}, 'en'))
+        return
+      }
+      const action = parseAskCallback(cb.data)
+      if (pending.isMulti) {
+        if (action.kind === 'toggle') {
+          if (pending.selected.has(action.id)) pending.selected.delete(action.id)
+          else pending.selected.add(action.id)
+          releaseCallbacks(gw.callbackIndex, pending.callbackKeys)
+          const nextKb = buildMultiSelectKeyboard(askToken, pending.options, pending.selected, pending.page, pending.pageSize, pending.payload)
+          pending.callbackKeys = nextKb.callbackKeys
+          indexCallbacks(gw.callbackIndex, nextKb.callbackKeys, askToken)
+          try {
+            if (cb.editReplyMarkup) await cb.editReplyMarkup(nextKb.replyMarkup)
+            else await cb.editMessage(cb.message?.text || 'Selection', nextKb.replyMarkup)
+          } catch (err) {
+            gw.recordApiFailure('cb.editMessage.ask_multi_toggle', err)
+          }
+          await cb.answer(pending.selected.has(action.id) ? 'Selected' : 'Deselected')
+          return
+        }
+        if (action.kind === 'page') {
+          pending.page = action.page
+          releaseCallbacks(gw.callbackIndex, pending.callbackKeys)
+          const nextKb = buildMultiSelectKeyboard(askToken, pending.options, pending.selected, pending.page, pending.pageSize, pending.payload)
+          pending.callbackKeys = nextKb.callbackKeys
+          indexCallbacks(gw.callbackIndex, nextKb.callbackKeys, askToken)
+          try {
+            if (cb.editReplyMarkup) await cb.editReplyMarkup(nextKb.replyMarkup)
+            else await cb.editMessage(cb.message?.text || 'Selection', nextKb.replyMarkup)
+          } catch (err) {
+            gw.recordApiFailure('cb.editMessage.ask_multi_page', err)
+          }
+          await cb.answer()
+          return
+        }
+        if (action.kind === 'done') {
+          gw.pendingAsks.delete(askToken)
+          clearTimeout(pending.timer)
+          releaseCallbacks(gw.callbackIndex, pending.callbackKeys)
+          await cb.answer('OK')
+          try { await cb.editMessage(cb.message?.text || 'Done', REMOVE_KEYBOARD) } catch (err) { gw.recordApiFailure('cb.editMessage.ask_multi_done', err) }
+          pending.resolve({ buttonId: 'done', selected: Array.from(pending.selected), data: cb.data })
+          return
+        }
+        if (action.kind === 'cancel') {
+          gw.pendingAsks.delete(askToken)
+          clearTimeout(pending.timer)
+          releaseCallbacks(gw.callbackIndex, pending.callbackKeys)
+          await cb.answer('Cancelled')
+          try { await cb.editMessage(cb.message?.text || 'Cancelled', REMOVE_KEYBOARD) } catch (err) { gw.recordApiFailure('cb.editMessage.ask_multi_cancel', err) }
+          pending.resolve({ buttonId: 'cancel', selected: [], data: cb.data })
+          return
+        }
+      }
+      gw.pendingAsks.delete(askToken)
+      clearTimeout(pending.timer)
+      releaseCallbacks(gw.callbackIndex, pending.callbackKeys)
+      await cb.answer('OK')
+      try { await cb.editMessage(cb.message?.text || 'Done', REMOVE_KEYBOARD) } catch (err) { gw.recordApiFailure('cb.editMessage.ask_single_done', err) }
+      pending.resolve({ buttonId: action.id || buttonId, data: cb.data })
+      return
+    }
+
+    // Model picker interactive flow
+    if (cb.data?.startsWith('mdl:')) {
+      const parts = cb.data.split(':')
+      const sub = parts[1]
+      // Step 2: Selected provider -> show its models (10 per page)
+      if (sub === 'p') {
+        const providerId = parts.slice(2).join(':')
+        const current = gw.resolveAgentModel()
+        const catalog = await listModelCatalog(gw.ctx, current)
+        const models = catalog.modelsByProvider.get(providerId) || []
+        if (!models.length) {
+          await cb.answer(t('model.no_models', {}, 'en'))
+          return
+        }
+        const kb = buildModelsKeyboard(providerId, models, current.model, 0)
+        await cb.answer()
+        const text = [
+          `🤖 <b>Provider:</b> <code>${providerId}</code>`,
+          `Select model (page ${kb.page + 1}/${kb.totalPages}):`,
+        ].join('\n')
+        try {
+          if (cb.editMessage) await cb.editMessage(text, kb)
+        } catch (err) {
+          gw.recordApiFailure('cb.editMessage.model_picker_provider', err)
+        }
+        return
+      }
+      // Pagination for models
+      if (sub === 'pg') {
+        const page = parseInt(parts[parts.length - 1], 10) || 0
+        const providerId = parts.slice(2, -1).join(':')
+        const current = gw.resolveAgentModel()
+        const catalog = await listModelCatalog(gw.ctx, current)
+        const models = catalog.modelsByProvider.get(providerId) || []
+        const kb = buildModelsKeyboard(providerId, models, current.model, page)
+        await cb.answer()
+        const text = [
+          `🤖 <b>Provider:</b> <code>${providerId}</code>`,
+          `Select model (page ${kb.page + 1}/${kb.totalPages}):`,
+        ].join('\n')
+        try {
+          if (cb.editMessage) await cb.editMessage(text, kb)
+        } catch (err) {
+          gw.recordApiFailure('cb.editMessage.model_picker_page', err)
+        }
+        return
+      }
+      // Back to providers
+      if (sub === 'back') {
+        const current = gw.resolveAgentModel()
+        const catalog = await listModelCatalog(gw.ctx, current)
+        const kb = buildProvidersKeyboard(catalog.providers, current)
+        await cb.answer()
+        const text = [
+          '🤖 <b>Choose Provider:</b>',
+          `Current: <code>${current.provider}/${current.model}</code>`,
+        ].join('\n')
+        try {
+          if (cb.editMessage) await cb.editMessage(text, kb)
+        } catch (err) {
+          gw.recordApiFailure('cb.editMessage.model_picker_back', err)
+        }
+        return
+      }
+      // Select model
+      if (sub === 's') {
+        const key = parts[2]
+        const stored = getStoredModelSelection(key)
+        if (!stored) {
+          await cb.answer(t('ask.expired', {}, 'en'))
+          return
+        }
+        const { provider, model } = stored
+        try {
+          const adm = gw.ctx.get('agentDefaultModel')
+          if (adm?.saveSelection) {
+            await adm.saveSelection({ provider, model })
+          }
+          gw.config.agent = { ...gw.config.agent, provider, model }
+          try {
+            await gw.hooks?.persistAgentModel?.({ provider, model })
+          } catch (e) {
+            gw.ctx.logger?.warn?.(`persist agent model: ${e.message}`)
+          }
+          await cb.answer(t('ask.chose', { choice: model }, 'en'))
+          try {
+            if (cb.editMessage) await cb.editMessage(t('model.switched', { provider, model }, 'en'), REMOVE_KEYBOARD)
+          } catch (err) {
+            gw.recordApiFailure('cb.editMessage.model_picker_switched', err)
+          }
+        } catch (err) {
+          await cb.answer(`Error: ${err.message}`)
+        }
+        return
+      }
+      if (sub === 'cur') {
+        await cb.answer()
+        return
+      }
+    }
+
+    await cb.answer()
+  }