@goodandready/dsh-messenger-gateway 0.3.20 → 0.3.21

package/lib/index.js

@@ -266,7 +266,7 @@ export function apply(ctx, config) {
     const started = turnStarts.get(String(session.id))
     turnStarts.delete(String(session.id))
     const dur = started ? Math.round((Date.now() - started) / 1000) : null
-    const title = kind === 'task_done' ? 'Задача завершена' : 'Ошибка агента'
+    const title = kind === 'task_done' ? 'Task completed' : 'Agent error'
     const lines = [
       `【${title}】`,
       `session: ${session.id}`,

package/lib/locales/en.js

@@ -0,0 +1,114 @@
+// Canonical English locale dictionary
+export const en = {
+  // Command descriptions
+  'cmd.help': 'Show commands help',
+  'cmd.new': 'Start new session',
+  'cmd.stop': 'Interrupt current turn',
+  'cmd.model': 'Interactive model selector',
+  'cmd.role': 'Switch agent persona or role',
+  'cmd.rewind': 'Rewind last N turns',
+  'cmd.fork': 'Fork session into new branch',
+  'cmd.export': 'Export history to Markdown',
+  'cmd.skills': 'List active tools & skills',
+  'cmd.files': 'Workspace file explorer',
+  'cmd.get': 'Download file from workspace',
+  'cmd.remind': 'Set a timer or reminder',
+  'cmd.status': 'Gateway and model status',
+  'cmd.top': 'System resources (RAM, uptime)',
+  'cmd.keyboard': 'Toggle quick action buttons',
+  'cmd.voice': 'Voice reply mode',
+  'cmd.tts': 'Toggle speech in this chat',
+  'cmd.mute': 'Mute notifications in this chat',
+  'cmd.unmute': 'Unmute notifications in this chat',
+  'cmd.whoami': 'Show your messenger user ID',
+  'cmd.pair': 'Approve pairing code',
+  'cmd.sethome': 'Set primary notification home',
+  'cmd.setalert': 'Set alert notification target',
+  'cmd.bind': 'Bind preset or persona to forum topic',
+  'cmd.preset': 'Show or switch agent preset',
+  'cmd.cron': 'Schedule recurring autonomous report',
+
+  // Bot replies & statuses
+  'msg.start': 'Gateway connected. Send messages to the agent. /help for commands.',
+  'msg.steer_added': '↪️ Added to current turn',
+  'msg.turn_stopped': 'Turn interrupted.',
+  'msg.no_active_session': 'No active session found.',
+  'msg.unknown_command': 'Unknown command {cmd}. /help',
+  'msg.not_allowed': 'Access denied. Ask the owner to whitelist your ID.',
+  'msg.pairing_requested': 'Access required.\nYour ID: {userId}\nPairing code: {code}\n\nThe owner must send to bot:\n/pair {code}',
+  'msg.pairing_rate_limit': 'Pairing code already issued. Please wait or ask owner for /pair.',
+  'msg.pairing_approved': '✅ User {userId} successfully approved!',
+  'msg.pairing_invalid': 'Invalid or expired pairing code.',
+  'msg.muted_on': 'Notifications in this chat: muted (/unmute)',
+  'msg.muted_off': 'Notifications in this chat: enabled',
+  'msg.no_response': '(no response)',
+  'msg.agent_error': 'Agent error: {code}: {message}',
+  'msg.exception': 'Internal error: {message}',
+
+  // Photo & media
+  'photo.received_one': 'Photo received. Send a question — e.g. "what is in this photo?"',
+  'photo.received_many': 'Received {count} attachments. Send your question.',
+  'photo.hint_photo': '[Photo attached]',
+  'photo.hint_photos': '[{count} photos attached]',
+  'doc.hint': '[Document attached: {name}]',
+
+  // Interactive buttons & ask
+  'ask.confirm_title': '⚠️ Confirmation Required\nTool: <code>{tool}</code>{reason}',
+  'ask.allow_once': '✅ Allow Once',
+  'ask.allow_session': '🛡️ Allow for Session',
+  'ask.deny': '❌ Deny',
+  'ask.chose': 'Chose: {choice}',
+  'ask.done': 'Done',
+  'ask.cancel': 'Cancel',
+  'ask.canceled': 'Canceled',
+  'ask.expired': 'Interaction expired. Please try again.',
+  'ask.other_chat': 'Button belongs to another chat',
+
+  // Model selector
+  'model.title': '🤖 <b>Choose Provider:</b>',
+  'model.current': 'Current: <code>{current}</code>',
+  'model.provider_models': '🤖 <b>Provider:</b> <code>{provider}</code>\nSelect model (page {page}/{total}):',
+  'model.no_models': 'No models available for this provider',
+  'model.switched': '✅ Model successfully switched to: <b>{provider}/{model}</b>',
+
+  // Personas & Presets
+  'persona.title': '🎭 <b>Available Roles & Personas:</b>',
+  'persona.usage': 'Switch role: <code>/role coder</code> (or /role reset)',
+  'persona.reset': '🎭 Role reset to default (Default).',
+  'persona.switched': '🎭 Role changed to: {icon} <b>{name}</b>\n{description}',
+  'persona.unknown': 'Unknown role "{target}". List: /role list',
+  'persona.bound_topic': '📌 Topic bound to {kind}: <b>{name}</b>',
+
+  // Builtin persona descriptions
+  'persona.default.name': 'Default',
+  'persona.default.desc': 'General assistant, concise and balanced',
+  'persona.coder.name': 'Developer',
+  'persona.coder.desc': 'Senior developer, code focus without fluff',
+  'persona.writer.name': 'Editor',
+  'persona.writer.desc': 'Copywriter, clean text and clear tone',
+  'persona.analyst.name': 'Analyst',
+  'persona.analyst.desc': 'Structured decomposition and data analysis',
+  'persona.concise.name': 'Brief',
+  'persona.concise.desc': 'Ultra-short replies, 1-2 sentences',
+
+  // File explorer & export
+  'files.title': '📁 <b>Workspace:</b> <code>{path}</code>\nTotal files: {count}\n\n',
+  'files.empty': '📁 Directory is empty: <code>{path}</code>',
+  'files.download_hint': '\nDownload file: <code>/get &lt;path&gt;</code>',
+  'files.not_found': 'File not found: {path}',
+  'export.title': '📄 Dialog export ({count} messages):',
+  'export.empty': 'Session is empty, nothing to export.',
+
+  // Reminders & Cron
+  'remind.scheduled': '⏰ Reminder set for {time} (in {duration}):\n{text}',
+  'remind.invalid': 'Invalid time format. Example: /remind 10m check deploy',
+  'remind.prefix': '⏰ <b>[Reminder]</b>\n{text}',
+  'cron.scheduled': '⏱️ Autonomous cron task scheduled: <code>{id}</code>\nSchedule: <code>{schedule}</code>\nPrompt: {prompt}',
+  'cron.list_title': '⏱️ <b>Scheduled Cron Tasks:</b>\n',
+  'cron.none': 'No active cron tasks.',
+  'cron.cancelled': '✅ Cron task cancelled: <code>{id}</code>',
+  'cron.prefix': '⏱️ <b>[Scheduled Report: {id}]</b>\n',
+
+  // Mirror & Forum
+  'mirror.created': '🪞 <b>[DSH Session Mirror]</b>\nSession: <code>{sessionId}</code>\nTitle: <b>{title}</b>\nMessages in this topic are synchronized with DSH.',
+}

package/lib/locales/index.js

@@ -0,0 +1,21 @@
+import { en } from './en.js'
+import { zh } from './zh.js'
+
+export const locales = { en, zh }
+
+export function getLocaleDictionary(locale = 'en') {
+  const norm = String(locale || '').toLowerCase()
+  if (norm.startsWith('zh')) return zh
+  return en
+}
+
+export function t(key, params = {}, locale = 'en') {
+  const dict = getLocaleDictionary(locale)
+  let template = dict[key] || en[key] || key
+  for (const [k, v] of Object.entries(params)) {
+    template = template.replaceAll(`{${k}}`, String(v))
+  }
+  return template
+}
+
+export { en, zh }

package/lib/locales/zh.js

@@ -0,0 +1,114 @@
+// Canonical Chinese (zh) locale dictionary
+export const zh = {
+  // Command descriptions
+  'cmd.help': '显示帮助信息',
+  'cmd.new': '开始新会话',
+  'cmd.stop': '中断当前回答',
+  'cmd.model': '交互式模型选择器',
+  'cmd.role': '切换智能体角色/人设',
+  'cmd.rewind': '回退最近N轮对话',
+  'cmd.fork': '将会话派生到新分支',
+  'cmd.export': '导出历史记录为Markdown',
+  'cmd.skills': '列出当前可用工具与技能',
+  'cmd.files': '工作区文件浏览器',
+  'cmd.get': '从工作区下载文件',
+  'cmd.remind': '设置提醒或定时器',
+  'cmd.status': '查看网关与模型状态',
+  'cmd.top': '查看系统资源（内存、运行时间）',
+  'cmd.keyboard': '开关快捷操作键盘',
+  'cmd.voice': '设置语音回复模式',
+  'cmd.tts': '在此聊天开关语音朗读',
+  'cmd.mute': '在此聊天静音通知',
+  'cmd.unmute': '在此聊天恢复通知',
+  'cmd.whoami': '显示你的用户ID',
+  'cmd.pair': '批准配对申请码',
+  'cmd.sethome': '设置主通知频道',
+  'cmd.setalert': '设置告警通知目标',
+  'cmd.bind': '绑定预设或人设到论坛话题',
+  'cmd.preset': '查看或切换智能体预设',
+  'cmd.cron': '配置定时周期性任务报告',
+
+  // Bot replies & statuses
+  'msg.start': '网关已连接。请向智能体发送消息。发送 /help 查看命令。',
+  'msg.steer_added': '↪️ 已追加到当前回答',
+  'msg.turn_stopped': '回答已中断。',
+  'msg.no_active_session': '未找到活跃会话。',
+  'msg.unknown_command': '未知命令 {cmd}。发送 /help',
+  'msg.not_allowed': '访问受限。请联系管理员将您的ID加入白名单。',
+  'msg.pairing_requested': '需要访问配对。\n您的ID: {userId}\n配对码: {code}\n\n管理员请向机器人发送：\n/pair {code}',
+  'msg.pairing_rate_limit': '配对码已发出，请稍候或联系管理员。',
+  'msg.pairing_approved': '✅ 用户 {userId} 已成功授权！',
+  'msg.pairing_invalid': '配对码无效或已过期。',
+  'msg.muted_on': '此聊天通知：已静音 (/unmute)',
+  'msg.muted_off': '此聊天通知：已开启',
+  'msg.no_response': '(无回复)',
+  'msg.agent_error': '智能体错误: {code}: {message}',
+  'msg.exception': '内部处理异常: {message}',
+
+  // Photo & media
+  'photo.received_one': '已收到图片。请输入您的问题 — 例如：“图片中有什么？”',
+  'photo.received_many': '已收到 {count} 个附件。请输入您的问题。',
+  'photo.hint_photo': '[附加图片]',
+  'photo.hint_photos': '[附加了 {count} 张图片]',
+  'doc.hint': '[附加文件: {name}]',
+
+  // Interactive buttons & ask
+  'ask.confirm_title': '⚠️ 需要授权确认\n工具: <code>{tool}</code>{reason}',
+  'ask.allow_once': '✅ 允许单次',
+  'ask.allow_session': '🛡️ 本会话始终允许',
+  'ask.deny': '❌ 拒绝',
+  'ask.chose': '已选择: {choice}',
+  'ask.done': '完成',
+  'ask.cancel': '取消',
+  'ask.canceled': '已取消',
+  'ask.expired': '交互已超时，请重新发起。',
+  'ask.other_chat': '该按钮属于其他聊天',
+
+  // Model selector
+  'model.title': '🤖 <b>选择服务商：</b>',
+  'model.current': '当前: <code>{current}</code>',
+  'model.provider_models': '🤖 <b>服务商:</b> <code>{provider}</code>\n请选择模型 (第 {page}/{total} 页):',
+  'model.no_models': '该服务商暂无可用的模型',
+  'model.switched': '✅ 模型已成功切换至: <b>{provider}/{model}</b>',
+
+  // Personas & Presets
+  'persona.title': '🎭 <b>可用角色与人设:</b>',
+  'persona.usage': '切换角色: <code>/role coder</code> (或 /role reset)',
+  'persona.reset': '🎭 角色已重置为默认 (Default)。',
+  'persona.switched': '🎭 角色已切换为: {icon} <b>{name}</b>\n{description}',
+  'persona.unknown': '未知角色 "{target}"。列表请见: /role list',
+  'persona.bound_topic': '📌 话题已绑定到{kind}: <b>{name}</b>',
+
+  // Builtin persona descriptions
+  'persona.default.name': '默认',
+  'persona.default.desc': '通用智能助手，回答平衡清晰',
+  'persona.coder.name': '开发者',
+  'persona.coder.desc': '资深全栈工程师，直奔代码核心',
+  'persona.writer.name': '文案编辑',
+  'persona.writer.desc': '专业编辑润色，文笔优美流畅',
+  'persona.analyst.name': '分析师',
+  'persona.analyst.desc': '结构化逻辑拆解，深度数据分析',
+  'persona.concise.name': '极简',
+  'persona.concise.desc': '极速短促回复，1-2句话答复',
+
+  // File explorer & export
+  'files.title': '📁 <b>工作区路径:</b> <code>{path}</code>\n文件总计: {count}\n\n',
+  'files.empty': '📁 目录为空: <code>{path}</code>',
+  'files.download_hint': '\n下载文件命令: <code>/get &lt;path&gt;</code>',
+  'files.not_found': '未找到文件: {path}',
+  'export.title': '📄 对话导出 ({count} 条消息):',
+  'export.empty': '会话为空，无消息可导出。',
+
+  // Reminders & Cron
+  'remind.scheduled': '⏰ 提醒已设置在 {time} ({duration} 后):\n{text}',
+  'remind.invalid': '时间格式错误。例如: /remind 10m 检查构建',
+  'remind.prefix': '⏰ <b>[提醒]</b>\n{text}',
+  'cron.scheduled': '⏱️ 定时任务已配置: <code>{id}</code>\n周期表达式: <code>{schedule}</code>\n指令: {prompt}',
+  'cron.list_title': '⏱️ <b>当前定时任务列表:</b>\n',
+  'cron.none': '暂无活动的定时任务。',
+  'cron.cancelled': '✅ 定时任务已取消: <code>{id}</code>',
+  'cron.prefix': '⏱️ <b>[定时报告: {id}]</b>\n',
+
+  // Mirror & Forum
+  'mirror.created': '🪞 <b>[DSH 会话镜像]</b>\n会话ID: <code>{sessionId}</code>\n标题: <b>{title}</b>\n此话题消息与 DSH 双向同步。',
+}

package/lib/models.js

@@ -114,7 +114,7 @@ export function buildModelsKeyboard(providerId, models, currentModel, page = 0,
   if (navRow.length) rows.push(navRow)
 
   // Back row
-  rows.push([{ text: '🔙 Назад к провайдерам', callback_data: 'mdl:back' }])
+  rows.push([{ text: '🔙 Back to providers', callback_data: 'mdl:back' }])
 
   return { inline_keyboard: rows, page: curPage, totalPages }
 }

package/lib/personas.js

@@ -6,51 +6,58 @@ export const BUILTIN_PERSONAS = {
     id: 'default',
     name: 'Default',
     icon: '🤖',
-    description: 'Стандартный универсальный ассистент',
+    description: 'General assistant, concise and balanced',
     instruction: '',
   },
   coder: {
     id: 'coder',
     name: 'Senior Developer',
     icon: '💻',
-    description: 'Опытный разработчик: чистый код, архитектура, минимум лишних слов',
+    description: 'Senior developer: clean code, architecture, minimum fluff',
     instruction: 'You are an expert senior software engineer. Provide high-quality, production-ready code with best practices, proper error handling, and concise explanations.',
   },
   architect: {
     id: 'architect',
     name: 'System Architect',
     icon: '📐',
-    description: 'Системный архитектор: проектирование, масштабируемость, компромиссы',
+    description: 'System architect: design, scalability, modularity and trade-offs',
     instruction: 'You are a principal system architect. Focus on high-level architecture, scalability, security, trade-offs, modular design, and clear diagrams.',
   },
   reviewer: {
     id: 'reviewer',
     name: 'Code Reviewer',
     icon: '🔍',
-    description: 'Строгий код-ревьюер: поиск багов, безопасность, краевые случаи',
+    description: 'Rigorous code reviewer: edge cases, security and maintainability',
     instruction: 'You are a meticulous code reviewer. Analyze code for bugs, edge cases, security vulnerabilities, performance bottlenecks, and maintainability.',
   },
   writer: {
     id: 'writer',
     name: 'Tech Writer',
     icon: '📝',
-    description: 'Технический писатель: понятные тексты, структура, документация',
+    description: 'Technical writer: clear text, structure and thorough docs',
     instruction: 'You are a professional technical writer and editor. Structure information clearly with clean formatting, intuitive language, and thorough documentation.',
   },
   translator: {
     id: 'translator',
     name: 'Translator',
     icon: '🌐',
-    description: 'Переводчик: точный перевод с сохранением терминологии',
+    description: 'Translator: accurate translation with technical terminology preserved',
     instruction: 'You are an expert translator and localization specialist. Translate accurately while preserving technical context, nuance, and terminology.',
   },
   concise: {
     id: 'concise',
     name: 'Concise',
     icon: '⚡',
-    description: 'Лаконичный режим: краткие и емкие ответы без воды',
+    description: 'Ultra-concise mode: direct, dense answers without filler',
     instruction: 'Be extremely concise. Answer directly in 1-3 sentences or short bullet points without unnecessary filler or pleasantries.',
   },
+  analyst: {
+    id: 'analyst',
+    name: 'Analyst',
+    icon: '📊',
+    description: 'Data & business analyst: decomposition, metrics and logic',
+    instruction: 'You are a senior data and systems analyst. Focus on structured problem breakdown, data interpretation, metrics, and methodical decision making.',
+  },
 }
 
 export function getPersona(id) {
@@ -64,9 +71,16 @@ export function listPersonas() {
 }
 
 export function createPersonaStore(filePath) {
-  let cache = {}
+  let cache = { personas: {}, presets: {} }
   try {
-    cache = JSON.parse(readFileSync(filePath, 'utf8'))
+    const raw = JSON.parse(readFileSync(filePath, 'utf8'))
+    if (raw && typeof raw === 'object') {
+      if (raw.personas || raw.presets) {
+        cache = { personas: raw.personas || {}, presets: raw.presets || {} }
+      } else {
+        cache = { personas: raw, presets: {} }
+      }
+    }
   } catch {}
 
   function save() {
@@ -76,18 +90,57 @@ export function createPersonaStore(filePath) {
     } catch {}
   }
 
+  function makeKey(chatId, threadId = 0) {
+    const tid = Number(threadId) || 0
+    return tid > 0 ? `${chatId}:${tid}` : String(chatId)
+  }
+
   return {
-    get(chatId) {
+    get(chatId, threadId = 0) {
       if (chatId === undefined || chatId === null) return 'default'
-      return cache[String(chatId)] || 'default'
+      const key = makeKey(chatId, threadId)
+      if (cache.personas[key]) return cache.personas[key]
+      // Fallback to chat-level persona if in thread
+      const baseKey = String(chatId)
+      return cache.personas[baseKey] || 'default'
     },
-    set(chatId, personaId) {
+    set(chatId, personaId, threadId = 0) {
       if (chatId === undefined || chatId === null) return
+      const key = makeKey(chatId, threadId)
       const valid = getPersona(personaId)
       if (valid && valid.id !== 'default') {
-        cache[String(chatId)] = valid.id
+        cache.personas[key] = valid.id
+      } else {
+        delete cache.personas[key]
+      }
+      save()
+    },
+    getPersonaForChat(chatId, threadId = 0) {
+      return this.get(chatId, threadId)
+    },
+    getPreset(chatId, threadId = 0) {
+      if (chatId === undefined || chatId === null) return null
+      const key = makeKey(chatId, threadId)
+      if (cache.presets[key]) return cache.presets[key]
+      const baseKey = String(chatId)
+      return cache.presets[baseKey] || null
+    },
+    setPreset(chatId, a, b) {
+      if (chatId === undefined || chatId === null) return
+      let presetName, threadId
+      if (typeof a === 'number' || (typeof a === 'string' && !isNaN(Number(a)) && b !== undefined && isNaN(Number(b)))) {
+        threadId = a
+        presetName = b
+      } else {
+        presetName = a
+        threadId = b || 0
+      }
+      const key = makeKey(chatId, threadId)
+      const clean = String(presetName || '').trim()
+      if (clean && clean !== 'default' && clean !== 'null') {
+        cache.presets[key] = clean
       } else {
-        delete cache[String(chatId)]
+        delete cache.presets[key]
       }
       save()
     },

package/lib/photos.js

@@ -26,6 +26,6 @@ export function photoOnlyHint(attachments, userText) {
   if (String(userText || '').trim()) return ''
   const photos = attachments.filter((a) => a.kind === 'photo')
   if (!photos.length) return ''
-  if (photos.length === 1) return '[Пользователь отправил фото]'
-  return `[Пользователь отправил ${photos.length} фото]`
+  if (photos.length === 1) return '[User attached a photo]'
+  return `[User attached ${photos.length} photos]`
 }