@goodandready/dsh-messenger-gateway 0.3.21 → 0.4.0

package/lib/commands.js

@@ -30,6 +30,7 @@ export const DEFAULT_TELEGRAM_COMMANDS = [
   { 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) {
@@ -71,3 +72,55 @@ export function mergeDynamicCommands(baseCommands = DEFAULT_TELEGRAM_COMMANDS, d
   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/config.js

@@ -1,104 +1,104 @@
-import z from '@deepseek-ai/schemastery'
-
-const HomeEntry = z.object({
-  name: z.string().default('default'),
-  chatId: z.union([z.number(), z.string()]),
-  threadId: z.number().default(0),
-})
-
-export const PluginConfig = z.object({
-  enabled: z.boolean().default(true),
-  internalBaseURL: z.string().default('http://127.0.0.1:3080'),
-  telegram: z.object({
-    enabled: z.boolean().default(false),
-    botToken: z.string().role('secret').default(''),
-    allowedUserIds: z.array(z.number()).default([]),
-    pollTimeoutSeconds: z.number().default(50),
-    pollIntervalMs: z.number().default(500),
-    commands: z.array(z.object({
-      command: z.string(),
-      description: z.string(),
-    })).default([]),
-    textFormat: z.union([z.const('html'), z.const('plain')]).default('html').description('html: Markdown→Telegram HTML; plain: unformatted plain text'),
-    homeChatId: z.union([z.number(), z.string()]).default('').description('Legacy default home chatId'),
-    homeThreadId: z.number().default(0),
-    homes: z.array(HomeEntry).default([]).description('Named homes (forum topics / channels)'),
-    pairingEnabled: z.boolean().default(true).description('Issue pairing codes to unknown users when allowlist is non-empty'),
-    streaming: z.boolean().default(false).description('If true, edit one Telegram message while tokens arrive; default off'),
-    streamEditIntervalMs: z.number().default(1200),
-    progressEnabled: z.boolean().default(true),
-    approvalsEnabled: z.boolean().default(true),
-    groupsEnabled: z.boolean().default(true).description('Process group/supergroup messages'),
-    groupRequireMention: z.boolean().default(true).description('In groups, only respond to @mention, reply-to-bot, or /commands'),
-    reactionsEnabled: z.boolean().default(true).description('React with 👀 while processing a turn'),
-    statusIndicator: z.boolean().default(false).description('Opt-in: set bot short description to Online/Offline (bots have no presence)'),
-    statusOnline: z.string().default('Online'),
-    statusOffline: z.string().default('Offline'),
-    transport: z.union([z.const('poll'), z.const('webhook')]).default('poll'),
-    webhookUrl: z.string().default(''),
-    webhookSecret: z.string().role('secret').default(''),
-    webhookPath: z.string().default('/dsh-messenger-gateway/telegram/webhook'),
-    voiceMode: z.union([z.const('mirror'), z.const('always'), z.const('off')]).default('mirror')
-      .description('mirror: TTS when inbound was voice; always/off override (per-user /voice wins)'),
-    quickActions: z.boolean().default(false).description('Show quick actions keyboard in Telegram (/new, /stop, /voice, /status)'),
-    artifactPreviews: z.boolean().default(true).description('Render diagrams and formatted tables as previews'),
-    notifyBridge: z.object({
-      enabled: z.boolean().default(false),
-      events: z.array(z.string()).default(['task_done', 'error']),
-      home: z.string().default('default'),
-      excludeSessionPrefixes: z.array(z.string()).default(['msgw-']),
-    }).default({ enabled: false }),
-    alerts: z.object({
-      enabled: z.boolean().default(false),
-      chatId: z.union([z.number(), z.string()]).default(''),
-      threadId: z.number().default(0),
-      home: z.string().default(''),
-      events: z.array(z.string()).default(['error', 'pairing']),
-    }).default({ enabled: false }),
-    forumMirror: z.object({
-      enabled: z.boolean().default(false),
-      chatId: z.union([z.number(), z.string()]).default(''),
-    }).default({ enabled: false }),
-    forumMirrorChatId: z.union([z.number(), z.string()]).default(''),
-    forumMirrorEnabled: z.boolean().default(false),
-  }),
-  discord: z.object({
-    enabled: z.boolean().default(false),
-    botToken: z.string().role('secret').default(''),
-    webhookUrl: z.string().default(''),
-  }).default({ enabled: false }),
-  slack: z.object({
-    enabled: z.boolean().default(false),
-    botToken: z.string().role('secret').default(''),
-    webhookUrl: z.string().default(''),
-  }).default({ enabled: false }),
-  webhooks: z.object({
-    enabled: z.boolean().default(true),
-    secret: z.string().role('secret').default(''),
-  }).default({ enabled: true }),
-  media: z.object({
-    cacheDir: z.string().default(''),
-    maxDocBytes: z.number().default(20 * 1024 * 1024),
-    maxTextInjectBytes: z.number().default(100 * 1024),
-    maxImageBytes: z.number().default(20 * 1024 * 1024),
-  }),
-  tts: z.object({
-    enabled: z.boolean().default(false),
-    maxChars: z.number().default(4000),
-    voiceSummary: z.boolean().default(false).description('Speak concise TL;DR summary while full text is sent to chat'),
-  }),
-  agent: z.object({
-    provider: z.string().default(''),
-    model: z.string().default(''),
-    cwd: z.string().default(''),
-    instructionPrefix: z.string().default(''),
-    maxMessageLength: z.number().default(4000),
-    idleTimeoutMs: z.number().default(3_600_000),
-    turnTimeoutMs: z.number().default(600_000),
-    photoOnlyMode: z.union([z.const('prompt'), z.const('run')]).default('prompt'),
-    sessionScope: z.union([z.const('chat'), z.const('user')]).default('user')
-      .description('In groups: user = per-user session; chat = shared session for the chat/topic'),
-  }),
-})
-
-export const Config = PluginConfig
+import z from '@deepseek-ai/schemastery'
+
+const HomeEntry = z.object({
+  name: z.string().default('default'),
+  chatId: z.union([z.number(), z.string()]),
+  threadId: z.number().default(0),
+})
+
+export const PluginConfig = z.object({
+  enabled: z.boolean().default(true),
+  internalBaseURL: z.string().default('http://127.0.0.1:3080'),
+  telegram: z.object({
+    enabled: z.boolean().default(false),
+    botToken: z.string().role('secret').default(''),
+    allowedUserIds: z.array(z.number()).default([]),
+    pollTimeoutSeconds: z.number().default(50),
+    pollIntervalMs: z.number().default(500),
+    commands: z.array(z.object({
+      command: z.string(),
+      description: z.string(),
+    })).default([]),
+    textFormat: z.union([z.const('html'), z.const('plain')]).default('html').description('html: Markdown→Telegram HTML; plain: unformatted plain text'),
+    homeChatId: z.union([z.number(), z.string()]).default('').description('Legacy default home chatId'),
+    homeThreadId: z.number().default(0),
+    homes: z.array(HomeEntry).default([]).description('Named homes (forum topics / channels)'),
+    pairingEnabled: z.boolean().default(true).description('Issue pairing codes to unknown users when allowlist is non-empty'),
+    streaming: z.boolean().default(false).description('If true, edit one Telegram message while tokens arrive; default off'),
+    streamEditIntervalMs: z.number().default(1200),
+    progressEnabled: z.boolean().default(true),
+    approvalsEnabled: z.boolean().default(true),
+    groupsEnabled: z.boolean().default(true).description('Process group/supergroup messages'),
+    groupRequireMention: z.boolean().default(true).description('In groups, only respond to @mention, reply-to-bot, or /commands'),
+    reactionsEnabled: z.boolean().default(true).description('React with 👀 while processing a turn'),
+    statusIndicator: z.boolean().default(false).description('Opt-in: set bot short description to Online/Offline (bots have no presence)'),
+    statusOnline: z.string().default('Online'),
+    statusOffline: z.string().default('Offline'),
+    transport: z.union([z.const('poll'), z.const('webhook')]).default('poll'),
+    webhookUrl: z.string().default(''),
+    webhookSecret: z.string().role('secret').default(''),
+    webhookPath: z.string().default('/dsh-messenger-gateway/telegram/webhook'),
+    voiceMode: z.union([z.const('mirror'), z.const('always'), z.const('off')]).default('mirror')
+      .description('mirror: TTS when inbound was voice; always/off override (per-user /voice wins)'),
+    quickActions: z.boolean().default(false).description('Show quick actions keyboard in Telegram (/new, /stop, /voice, /status)'),
+    artifactPreviews: z.boolean().default(true).description('Render diagrams and formatted tables as previews'),
+    notifyBridge: z.object({
+      enabled: z.boolean().default(false),
+      events: z.array(z.string()).default(['task_done', 'error']),
+      home: z.string().default('default'),
+      excludeSessionPrefixes: z.array(z.string()).default(['msgw-']),
+    }).default({ enabled: false }),
+    alerts: z.object({
+      enabled: z.boolean().default(false),
+      chatId: z.union([z.number(), z.string()]).default(''),
+      threadId: z.number().default(0),
+      home: z.string().default(''),
+      events: z.array(z.string()).default(['error', 'pairing']),
+    }).default({ enabled: false }),
+    forumMirror: z.object({
+      enabled: z.boolean().default(false),
+      chatId: z.union([z.number(), z.string()]).default(''),
+    }).default({ enabled: false }),
+    forumMirrorChatId: z.union([z.number(), z.string()]).default(''),
+    forumMirrorEnabled: z.boolean().default(false),
+  }),
+  discord: z.object({
+    enabled: z.boolean().default(false),
+    botToken: z.string().role('secret').default(''),
+    webhookUrl: z.string().default(''),
+  }).default({ enabled: false }),
+  slack: z.object({
+    enabled: z.boolean().default(false),
+    botToken: z.string().role('secret').default(''),
+    webhookUrl: z.string().default(''),
+  }).default({ enabled: false }),
+  webhooks: z.object({
+    enabled: z.boolean().default(true),
+    secret: z.string().role('secret').default(''),
+  }).default({ enabled: true }),
+  media: z.object({
+    cacheDir: z.string().default(''),
+    maxDocBytes: z.number().default(20 * 1024 * 1024),
+    maxTextInjectBytes: z.number().default(100 * 1024),
+    maxImageBytes: z.number().default(20 * 1024 * 1024),
+  }),
+  tts: z.object({
+    enabled: z.boolean().default(false),
+    maxChars: z.number().default(4000),
+    voiceSummary: z.boolean().default(false).description('Speak concise TL;DR summary while full text is sent to chat'),
+  }),
+  agent: z.object({
+    provider: z.string().default(''),
+    model: z.string().default(''),
+    cwd: z.string().default(''),
+    instructionPrefix: z.string().default(''),
+    maxMessageLength: z.number().default(4000),
+    idleTimeoutMs: z.number().default(3_600_000),
+    turnTimeoutMs: z.number().default(600_000),
+    photoOnlyMode: z.union([z.const('prompt'), z.const('run')]).default('prompt'),
+    sessionScope: z.union([z.const('chat'), z.const('user')]).default('user')
+      .description('In groups: user = per-user session; chat = shared session for the chat/topic'),
+  }),
+})
+
+export const Config = PluginConfig

package/lib/content-guard.js

@@ -1,14 +1,14 @@
-/**
- * Normalize any content value to ContentBlock[].
- * DSH core (dsh-llm) calls content.some() without Array.isArray guard,
- * so we must ensure every message we create or copy has array content.
- * Refs: #51
- */
-export function ensureContentArray(content) {
-  if (Array.isArray(content)) return content
-  if (typeof content === 'string') {
-    return content ? [{ type: 'text', text: content }] : [{ type: 'text', text: '(empty message)' }]
-  }
-  if (content && typeof content === 'object' && content.type) return [content]
-  return [{ type: 'text', text: String(content ?? '(empty message)') }]
-}
+/**
+ * Normalize any content value to ContentBlock[].
+ * DSH core (dsh-llm) calls content.some() without Array.isArray guard,
+ * so we must ensure every message we create or copy has array content.
+ * Refs: #51
+ */
+export function ensureContentArray(content) {
+  if (Array.isArray(content)) return content
+  if (typeof content === 'string') {
+    return content ? [{ type: 'text', text: content }] : [{ type: 'text', text: '(empty message)' }]
+  }
+  if (content && typeof content === 'object' && content.type) return [content]
+  return [{ type: 'text', text: String(content ?? '(empty message)') }]
+}

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()
+  }