@goodandready/dsh-messenger-gateway 0.3.19 → 0.3.21

package/lib/client.js

@@ -116,107 +116,107 @@ window.__ModuleLoader__.load({
       'stats.active_chats': 'Active Chats in Memory',
     }
 
-    const ru = {
+    const zh = {
       title: 'Messenger gateway',
-      description: 'Telegram-бот: текст, голос, фото, документы и интерактивные опросы.',
-      'settings.loading': 'Загрузка настроек Messenger gateway…',
-      'settings.retry': 'Повторить попытку',
-      'settings.unavailable': 'Настройки недоступны (пространство хоста ещё не готово).',
-      'header.title': 'Шлюз Telegram и мессенджеров',
-      'header.sub': 'Мост между DeepSeek Harness и Telegram: сессии, steer, топики форума, инлайн-кнопки и голосовые ответы.',
-      'badge.online': 'Telegram онлайн (@{username})',
-      'badge.running': 'Работает',
-      'badge.stopped': 'Остановлен',
-      'badge.token_ok': 'Токен ✓',
-      'badge.token_missing': 'Токен отсутствует',
-      'badge.pairing_count': 'Сопряжение: {count}',
-      'badge.transport': 'Транспорт: {mode}',
-      save: 'Сохранить изменения',
-      saved: 'Настройки успешно сохранены',
-      saving: 'Сохранение…',
-      showAdvanced: '⚙️ Расширенные настройки подключения и polling',
-      hideAdvanced: 'Скрыть расширенные настройки',
-      telegram: 'Настройки бота Telegram',
-      telegramSub: 'Ключи доступа, белый список пользователей и параметры доставки сообщений.',
-      agent: 'Поведение агента и рассуждения',
-      agentSub: 'Маршрутизация модели, дополнительные инструкции и таймаут хода.',
-      media: 'Ограничения медиа и документов',
-      mediaSub: 'Лимиты на извлечение текста и размер загружаемых файлов.',
-      tts: 'Голосовые ответы (dsh-tts)',
-      ttsSub: 'Синтез аудиоответов на голосовые сообщения в чате.',
-      advanced: 'Параметры соединения и polling',
-      botToken: 'Токен бота Telegram',
-      botTokenHint: 'Получен от @BotFather. Оставьте пустым, чтобы сохранить текущий.',
-      allowedIds: 'Разрешённые ID пользователей',
-      allowedIdsHint: 'ID пользователей через запятую. Пусто = доступно всем (включено сопряжение по кодам).',
-      textFormat: 'Форматирование текста',
-      textFormatHtml: 'Markdown → Telegram HTML (рекомендуется)',
-      textFormatPlain: 'Простой текст (без форматирования)',
-      disableTelegram: 'Выключить Telegram-бота',
-      enableTelegram: 'Включить Telegram-бота',
-      provider: 'Провайдер по умолчанию',
-      providerHint: 'Пусто = провайдер по умолчанию DSH',
-      model: 'Модель по умолчанию',
-      modelHint: 'Пусто = модель по умолчанию DSH',
-      photoOnly: 'Поведение фото без подписи',
-      photoPrompt: 'Ждать вопроса (рекомендуется)',
-      photoRun: 'Отвечать сразу',
-      instruction: 'Дополнительная инструкция агенту',
-      instructionHint: 'Добавляется к каждому входящему сообщению из мессенджера',
-      instructionPlaceholder: 'Пусто = встроенная инструкция (русский язык, лаконичный ответ)',
-      maxMessageLength: 'Макс. длина ответа (символов)',
-      turnTimeout: 'Таймаут хода агента (сек)',
-      maxDocMb: 'Макс. размер документа (МБ)',
-      maxImageMb: 'Макс. размер фото (МБ)',
-      maxTextKb: 'Макс. объём текста из документа (КБ)',
-      ttsEnable: 'Включить голосовые ответы (требуется dsh-tts)',
-      ttsMaxChars: 'Макс. символов для озвучивания',
-      pollTimeout: 'Таймаут Long Poll (сек)',
-      pollInterval: 'Интервал Long Poll (мс)',
-      idleTimeout: 'Таймаут неактивного чата (сек)',
-      pairing: 'Запросы сопряжения и авторизация',
-      pairingSub: 'Подтверждение доступа новых пользователей при ограниченном списке.',
-      pairingEmpty: 'Нет ожидающих кодов сопряжения',
-      pairingApprove: 'Одобрить',
-      pairingReject: 'Отклонить',
-      pairingRefresh: 'Обновить список',
-      groupsEnable: 'Отвечать в группах и супергруппах',
-      groupMention: 'В группах отвечать только на @упоминание, reply или /команду',
-      reactionsEnable: 'Реакция 👀 пока агент думает',
-      progressEnable: 'Индикатор прогресса (Думаю → Удалить → Ответ)',
-      statusIndicator: 'Индикатор статуса (Online/Offline)',
-      statusIndicatorHint: 'Меняет краткое описание бота в Telegram (видно всем).',
-      transport: 'Режим транспорта',
-      transportPoll: 'Long poll (getUpdates)',
+      description: 'Telegram 机器人：文本、语音、图片、文档和交互式询问。',
+      'settings.loading': '正在加载 Messenger gateway 设置…',
+      'settings.retry': '重试',
+      'settings.unavailable': '设置不可用（主机命名空间未就绪）。',
+      'header.title': 'Telegram 与多消息平台网关',
+      'header.sub': 'DeepSeek Harness 与 Telegram 之间的桥梁：会话、转向提示、论坛话题、内联按钮和可选语音。',
+      'badge.online': 'Telegram 在线 (@{username})',
+      'badge.running': '运行中',
+      'badge.stopped': '已停止',
+      'badge.token_ok': '令牌有效 ✓',
+      'badge.token_missing': '缺少令牌',
+      'badge.pairing_count': '配对: {count}',
+      'badge.transport': '传输方式: {mode}',
+      save: '保存更改',
+      saved: '设置保存成功',
+      saving: '保存中…',
+      showAdvanced: '⚙️ 高级连接与轮询设置',
+      hideAdvanced: '隐藏高级设置',
+      telegram: 'Telegram 机器人设置',
+      telegramSub: '主机器人凭证、白名单与消息发送设置。',
+      agent: '智能体与推理行为',
+      agentSub: '模型路由、附加指令与轮次超时设置。',
+      media: '媒体与文件限制',
+      mediaSub: '文档提取与图片上传限制。',
+      tts: '语音回复 (dsh-tts)',
+      ttsSub: '为 Telegram 语音消息合成语音回复。',
+      advanced: '连接与轮询内部设置',
+      botToken: 'Telegram 机器人令牌',
+      botTokenHint: '从 @BotFather 获取。留空保持现有配置。',
+      allowedIds: '允许的 Telegram 用户 ID',
+      allowedIdsHint: '逗号分隔的用户 ID 列表。留空允许所有用户（启用配对请求）。',
+      textFormat: '文本格式化渲染',
+      textFormatHtml: 'Markdown → Telegram HTML (推荐)',
+      textFormatPlain: '纯文本 (无格式化)',
+      disableTelegram: '停用 Telegram 机器人',
+      enableTelegram: '启用 Telegram 机器人',
+      provider: '提供商覆盖',
+      providerHint: '留空使用 DSH 默认提供商',
+      model: '模型覆盖',
+      modelHint: '留空使用 DSH 默认模型',
+      photoOnly: '无附言图片处理方式',
+      photoPrompt: '等待问题 (推荐)',
+      photoRun: '立即回复',
+      instruction: '额外智能体指令',
+      instructionHint: '添加到每条来自网关的消息前',
+      instructionPlaceholder: '留空 = 内置指令',
+      maxMessageLength: '最大回复长度 (字符)',
+      turnTimeout: '智能体轮次超时 (秒)',
+      maxDocMb: '最大文档大小 (MB)',
+      maxImageMb: '最大图片大小 (MB)',
+      maxTextKb: '文档提取最大文本量 (KB)',
+      ttsEnable: '启用语音回复 (需 dsh-tts)',
+      ttsMaxChars: '每条语音消息最大字数',
+      pollTimeout: '长轮询超时 (秒)',
+      pollInterval: '长轮询间隔 (毫秒)',
+      idleTimeout: '空闲会话超时 (秒)',
+      pairing: '配对请求与授权',
+      pairingSub: '受限白名单下授权新用户。',
+      pairingEmpty: '暂无待处理配对码',
+      pairingApprove: '批准',
+      pairingReject: '拒绝',
+      pairingRefresh: '刷新列表',
+      groupsEnable: '在群组和超级群组中响应',
+      groupMention: '群组中需 @提及、回复或 /命令',
+      reactionsEnable: '处理中添加 👀 表情反应',
+      progressEnable: '进度状态提示 (思考中 → 删除 → 最终回复)',
+      statusIndicator: '机器人状态描述指示器 (Online/Offline)',
+      statusIndicatorHint: '通过 Telegram API 设置机器人简介（所有人可见）。',
+      transport: 'Telegram 传输模式',
+      transportPoll: '长轮询 (getUpdates)',
       transportWebhook: 'Webhook (HTTPS)',
-      webhookUrl: 'Публичный HTTPS URL webhook',
-      webhookUrlHint: 'Публичный адрес, куда Telegram доставляет входящие обновления',
-      webhookSecret: 'Секретный токен webhook',
-      webhookSecretHint: 'Оставьте пустым, чтобы не менять текущий секрет',
-      sessionScope: 'Сессии в группах',
-      sessionScopeChat: 'Общая сессия на чат/топик',
-      sessionScopeUser: 'Индивидуальная на пользователя (рекомендуется)',
-      voiceMode: 'Режим голосовых ответов',
-      voiceModeMirror: 'Как входящее (голос на голос)',
-      voiceModeAlways: 'Всегда отвечать голосовым',
-      voiceModeOff: 'Выключено (если не включено через /voice)',
-      notifyBridge: 'Мост уведомлений → Telegram Home',
-      notifyBridgeHint: 'Пересылка событий task_done/error из web-сессий в указанный канал/топик',
-      notifyHome: 'Имя целевого канала (Home)',
-      quickActions: 'Клавиатура быстрых действий (/new, /stop, /voice, /status)',
-      artifactPreviews: 'Превью диаграмм и таблиц в Telegram',
-      'diag.title': '⚡ Диагностика и проверка связи (Smoke test)',
-      'diag.desc': 'Проверка подключения к Telegram Bot API, замер сетевой задержки и валидация имени бота.',
-      'diag.smoke_btn': 'Проверить соединение с Telegram (Ping)',
-      'diag.smoke_testing': 'Проверка связи с Telegram API…',
-      'diag.smoke_ok': 'Связь с Telegram API установлена! Задержка: {latency} мс (@{username}, ID: {id})',
-      'diag.smoke_err': 'Ошибка проверки связи: {error}',
-      'stats.title': '📊 Телеметрия шлюза и счётчики',
-      'stats.desc': 'Статистика реального времени работающего процесса шлюза.',
-      'stats.sent': 'Сообщений отправлено',
-      'stats.errors': 'Ошибок доставки',
-      'stats.uptime': 'Время работы шлюза',
-      'stats.active_chats': 'Активных чатов в памяти',
+      webhookUrl: '公开 Webhook HTTPS 地址',
+      webhookUrlHint: 'Telegram 投递更新的公开端点',
+      webhookSecret: 'Webhook 密钥令牌',
+      webhookSecretHint: '留空保持当前配置的密钥',
+      sessionScope: '群组会话范围',
+      sessionScopeChat: '每个聊天/话题共享',
+      sessionScopeUser: '每用户独立会话 (推荐)',
+      voiceMode: '语音回复模式',
+      voiceModeMirror: '镜像输入语音 (仅语音输入时回复语音)',
+      voiceModeAlways: '始终合成语音回复',
+      voiceModeOff: '关闭 (除非通过 /voice 启用)',
+      notifyBridge: '通知网桥 → Telegram Home',
+      notifyBridgeHint: '将 Web 会话的 task_done/error 事件转发至指定频道/话题',
+      notifyHome: '目标频道名称 (Home)',
+      quickActions: '快捷操作键盘 (/new, /stop, /voice, /status)',
+      artifactPreviews: '在 Telegram 中预览图表与表格',
+      'diag.title': '⚡ 诊断与连通性检查 (Smoke test)',
+      'diag.desc': '检查 Telegram Bot API 连接、测量延迟并验证机器人名称。',
+      'diag.smoke_btn': '测试 Telegram 连接 (Ping)',
+      'diag.smoke_testing': '正在连接 Telegram API…',
+      'diag.smoke_ok': 'Telegram API 连接成功！延迟: {latency} 毫秒 (@{username}, ID: {id})',
+      'diag.smoke_err': '连通性检查失败: {error}',
+      'stats.title': '📊 网关遥测与计数器',
+      'stats.desc': '运行中网关进程的实时统计。',
+      'stats.sent': '已发送消息',
+      'stats.errors': '发送错误数',
+      'stats.uptime': '运行时间',
+      'stats.active_chats': '内存中活跃聊天数',
     }
 
     function useActiveLocale(ctx) {
@@ -234,7 +234,7 @@ window.__ModuleLoader__.load({
     }
 
     function makeT(locale) {
-      const DICT = String(locale || '').startsWith('ru') ? ru : en
+      const DICT = String(locale || '').startsWith('zh') ? zh : en
       return (key, params) => {
         let text = DICT[key] || en[key] || key
         if (params && typeof params === 'object') {
@@ -1243,20 +1243,20 @@ window.__ModuleLoader__.load({
             try {
               const loc = ctx?.get?.('locale') || ctx?.locale
               if (loc?.register) {
-                loc.register(NS, { en, ru })
+                loc.register(NS, { en, zh })
               }
             } catch (taken) {
-              console.warn('[dsh-messenger-gateway] словарь уже зарегистрирован:', taken && taken.message)
+              console.warn('[dsh-messenger-gateway] dictionary already registered:', taken && taken.message)
             }
           }, 'dsh-messenger-gateway: dictionaries')
         } else {
           const loc = ctx?.get?.('locale') || ctx?.locale
           if (loc?.register) {
-            loc.register(NS, { en, ru })
+            loc.register(NS, { en, zh })
           }
         }
       } catch (err) {
-        console.warn('[dsh-messenger-gateway] ошибка регистрации словаря:', err && err.message)
+        console.warn('[dsh-messenger-gateway] dictionary registration error:', err && err.message)
       }
 
       if (typeof ctx.effect === 'function') {

package/lib/commands.js

@@ -1,47 +1,73 @@
-export const DEFAULT_TELEGRAM_COMMANDS = [
-  { command: 'start', description: 'Подключение и приветствие' },
-  { command: 'help', description: 'Список команд' },
-  { command: 'new', description: 'Новая сессия агента' },
-  { command: 'whoami', description: 'Показать ваш Telegram id' },
-  { command: 'stop', description: 'Прервать текущий ответ' },
-  { command: 'pair', description: 'Одобрить код сопряжения: /pair CODE' },
-  { command: 'sethome', description: 'Home: /sethome [name]' },
-  { command: 'home', description: 'Список home-каналов' },
-  { command: 'model', description: 'Интерактивный выбор или смена модели' },
-  { command: 'top', description: 'Ресурсы сервера: CPU, RAM, uptime, сессии' },
-  { command: 'topic', description: 'Создать новый форум-топик под задачу: /topic <имя>' },
-  { command: 'status', description: 'Статус шлюза' },
-  { command: 'setalert', description: 'Назначить этот чат каналом алертов' },
-  { command: 'alert', description: 'Статус канала алертов: /alert [test]' },
-  { command: 'keyboard', description: 'Клавиатура быстрых действий: /keyboard on|off' },
-  { command: 'role', description: 'Роль и персона агента: /role [name]' },
-  { command: 'skills', description: 'Список активных инструментов и навыков' },
-  { command: 'tools', description: 'Список активных инструментов' },
-  { command: 'fork', description: 'Форк текущей сессии в новую ветку' },
-  { command: 'export', description: 'Экспорт истории диалога в Markdown' },
-  { command: 'rewind', description: 'Откат сообщений: /rewind [N]' },
-  { command: 'files', description: 'Файловый менеджер рабочей папки: /files [dir]' },
-  { command: 'get', description: 'Скачать файл в Telegram: /get <path>' },
-  { command: 'remind', description: 'Напоминание: /remind <время> <текст>' },
-  { command: 'voice', description: 'Голосовые ответы: /voice on|off|status' },
-  { command: 'tts', description: 'Озвучка в этом чате: /tts on|off|status' },
-  { command: 'mute', description: 'Не присылать уведомления в этот чат' },
-  { command: 'unmute', description: 'Вернуть уведомления в этот чат' },
-]
-
-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 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' },
+]
+
+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)
+}
+

package/lib/config.js

@@ -1,98 +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: без разметки'),
-    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 }),
-  }),
-  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: '(пустое сообщение)' }]
-  }
-  if (content && typeof content === 'object' && content.type) return [content]
-  return [{ type: 'text', text: String(content ?? '(пустое сообщение)') }]
-}
+/**
+ * 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)') }]
+}