@goodandready/dsh-messenger-gateway 0.3.20 → 0.3.21

package/README.md

@@ -1,6 +1,44 @@
-# @goodandready/dsh-messenger-gateway
+# 📦 @goodandready/dsh-messenger-gateway
 
-Telegram messenger bridge for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+<div align="center">
+
+<h3>Telegram Messenger Bridge with Interactive Buttons, Forum Topics & Voice Notes for DeepSeek Harness</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-messenger-gateway"><img src="https://img.shields.io/npm/v/@goodandready/dsh-messenger-gateway.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-10b981.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
+</p>
+
+<p align="center">
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/All_Author_Projects-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="All Author Projects"></a>
+</p>
+
+<p align="center">
+  <a href="README.md"><b>🇬🇧 English</b></a> •
+  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
+  <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
+</p>
+
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
+</div>
+
+---
+
+## ⚡ Overview
+
+**`dsh-messenger-gateway`** provides an enterprise-grade, multi-transport messaging gateway for **DeepSeek Harness** agents.
+Talk to your Harness agent directly from Telegram: interactive keyboard buttons, forum topic sessions, private user workspaces, pairing codes, and optional spoken voice replies.
 
 Talk to your Harness agent from Telegram: text, voice, photos, documents, inline buttons, named homes, and optional spoken replies.
 

package/README.ru.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---

package/README.zh.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---

package/lib/adapters/discord.js

@@ -20,6 +20,30 @@ export function splitDiscordText(text, limit = DISCORD_MAX_LENGTH) {
   return chunks
 }
 
+export function toDiscordComponents(buttons) {
+  if (!buttons || !Array.isArray(buttons) || !buttons.length) return undefined
+  const rows = []
+  const grid = Array.isArray(buttons[0]) ? buttons : [buttons]
+  for (const row of grid.slice(0, 5)) {
+    const components = []
+    for (const btn of (row || []).slice(0, 5)) {
+      if (!btn) continue
+      const custom_id = String(btn.id || btn.callback_data || btn.text || 'btn').slice(0, 100)
+      const label = String(btn.text || btn.label || 'Action').slice(0, 80)
+      components.push({
+        type: 2, // Button
+        style: 1, // Primary
+        label,
+        custom_id,
+      })
+    }
+    if (components.length) {
+      rows.push({ type: 1, components })
+    }
+  }
+  return rows.length ? rows : undefined
+}
+
 export class DiscordAdapter {
   constructor(opts = {}) {
     this.name = 'discord'
@@ -45,18 +69,21 @@ export class DiscordAdapter {
     const body = typeof payload === 'string' ? { text: payload } : (payload || {})
     const text = String(body.text || '')
     const files = Array.isArray(body.files) ? body.files : []
+    const components = toDiscordComponents(body.buttons || body.replyMarkup?.inline_keyboard)
 
     const chunks = splitDiscordText(text)
-    if (!chunks.length && !files.length) return { ok: true }
+    if (!chunks.length && !files.length && !components) return { ok: true }
 
     // Case 1: Webhook sending
     const isWebhookTarget = !channelId || channelId === 'default' || channelId === 'webhook'
     if (this.webhookUrl && isWebhookTarget) {
       for (const chunk of (chunks.length ? chunks : [''])) {
+        const payloadJson = { content: chunk }
+        if (components) payloadJson.components = components
         const res = await fetch(this.webhookUrl, {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ content: chunk }),
+          body: JSON.stringify(payloadJson),
         })
         if (!res.ok) {
           const errText = await res.text().catch(() => '')
@@ -77,9 +104,9 @@ export class DiscordAdapter {
     // Handle files if any on the first chunk
     if (files.length > 0 && typeof FormData !== 'undefined') {
       const form = new FormData()
-      form.append('payload_json', JSON.stringify({
-        content: chunks[0] || '',
-      }))
+      const payloadJson = { content: chunks[0] || '' }
+      if (components) payloadJson.components = components
+      form.append('payload_json', JSON.stringify(payloadJson))
       for (let i = 0; i < files.length; i++) {
         const file = files[i]
         const bytes = file.bytes || (file.path ? await readFile(file.path) : null)
@@ -100,32 +127,59 @@ export class DiscordAdapter {
         const errText = await res.text().catch(() => '')
         throw new Error(`discord send error ${res.status}: ${errText}`)
       }
+      const json = await res.json().catch(() => ({}))
       // Send remaining text chunks if any
       for (let i = 1; i < chunks.length; i++) {
         await this._sendRestMessage(targetChannel, chunks[i])
       }
-      return { ok: true }
+      return { ok: true, messageId: json.id }
     }
 
-    // Pure text chunks
-    for (const chunk of chunks) {
-      await this._sendRestMessage(targetChannel, chunk)
+    // Pure text chunks with components on first chunk
+    let firstResult = { ok: true }
+    for (let i = 0; i < (chunks.length ? chunks.length : 1); i++) {
+      const chunk = chunks[i] || ''
+      const res = await this._sendRestMessage(targetChannel, chunk, i === 0 ? components : undefined)
+      if (i === 0) firstResult = res
+    }
+    return firstResult
+  }
+
+  async editMessage(channelId, messageId, content, components) {
+    if (!this.botToken) throw new Error('discord botToken required to edit message')
+    const body = { content: String(content || '').slice(0, DISCORD_MAX_LENGTH) }
+    if (components !== undefined) body.components = components
+    const res = await fetch(`${DISCORD_API}/channels/${channelId}/messages/${messageId}`, {
+      method: 'PATCH',
+      headers: {
+        Authorization: `Bot ${this.botToken}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(body),
+    })
+    if (!res.ok) {
+      const errText = await res.text().catch(() => '')
+      throw new Error(`discord edit error ${res.status}: ${errText}`)
     }
     return { ok: true }
   }
 
-  async _sendRestMessage(channelId, content) {
+  async _sendRestMessage(channelId, content, components) {
+    const body = { content }
+    if (components && components.length) body.components = components
     const res = await fetch(`${DISCORD_API}/channels/${channelId}/messages`, {
       method: 'POST',
       headers: {
         Authorization: `Bot ${this.botToken}`,
         'Content-Type': 'application/json',
       },
-      body: JSON.stringify({ content }),
+      body: JSON.stringify(body),
     })
     if (!res.ok) {
       const errText = await res.text().catch(() => '')
       throw new Error(`discord send error ${res.status}: ${errText}`)
     }
+    const json = typeof res.json === 'function' ? await res.json().catch(() => ({})) : {}
+    return { ok: true, messageId: json?.id }
   }
 }

package/lib/adapters/slack.js

@@ -17,6 +17,35 @@ export function splitSlackText(text, limit = SLACK_MAX_LENGTH) {
   return chunks
 }
 
+export function toSlackBlocks(text, buttons) {
+  const blocks = []
+  if (text) {
+    blocks.push({
+      type: 'section',
+      text: { type: 'mrkdwn', text: String(text).slice(0, 3000) },
+    })
+  }
+  if (buttons && Array.isArray(buttons) && buttons.length) {
+    const flat = (Array.isArray(buttons[0]) ? buttons.flat() : buttons).slice(0, 25)
+    const elements = []
+    for (const btn of flat) {
+      if (!btn) continue
+      const action_id = String(btn.id || btn.callback_data || btn.text || 'btn').slice(0, 100)
+      const label = String(btn.text || btn.label || 'Action').slice(0, 75)
+      elements.push({
+        type: 'button',
+        text: { type: 'plain_text', text: label },
+        action_id,
+        value: action_id,
+      })
+    }
+    if (elements.length) {
+      blocks.push({ type: 'actions', elements })
+    }
+  }
+  return blocks.length ? blocks : undefined
+}
+
 export class SlackAdapter {
   constructor(opts = {}) {
     this.name = 'slack'
@@ -41,16 +70,19 @@ export class SlackAdapter {
     if (this.stopped) throw new Error('slack adapter stopped')
     const body = typeof payload === 'string' ? { text: payload } : (payload || {})
     const text = String(body.text || '')
+    const blocks = toSlackBlocks(text, body.buttons || body.options || body.replyMarkup?.inline_keyboard)
     const chunks = splitSlackText(text)
-    if (!chunks.length) return { ok: true }
+    if (!chunks.length && !blocks) return { ok: true }
 
     const isWebhookTarget = !channelId || channelId === 'default' || channelId === 'webhook'
     if (this.webhookUrl && isWebhookTarget) {
-      for (const chunk of chunks) {
+      for (const chunk of (chunks.length ? chunks : [''])) {
+        const payloadJson = { text: chunk }
+        if (blocks) payloadJson.blocks = blocks
         const res = await fetch(this.webhookUrl, {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ text: chunk }),
+          body: JSON.stringify(payloadJson),
         })
         if (!res.ok) {
           const errText = await res.text().catch(() => '')
@@ -68,23 +100,51 @@ export class SlackAdapter {
     if (!targetChannel) throw new Error('slack channelId required')
 
     const threadTs = opts.threadId || undefined
-    for (const chunk of chunks) {
+    let firstResult = { ok: true }
+    for (let i = 0; i < (chunks.length ? chunks.length : 1); i++) {
+      const chunk = chunks[i] || ''
+      const reqBody = {
+        channel: targetChannel,
+        text: chunk,
+        thread_ts: threadTs,
+      }
+      if (i === 0 && blocks) reqBody.blocks = blocks
       const res = await fetch(`${SLACK_API}/chat.postMessage`, {
         method: 'POST',
         headers: {
           Authorization: `Bearer ${this.botToken}`,
           'Content-Type': 'application/json; charset=utf-8',
         },
-        body: JSON.stringify({
-          channel: targetChannel,
-          text: chunk,
-          thread_ts: threadTs,
-        }),
+        body: JSON.stringify(reqBody),
       })
-      const json = await res.json().catch(() => ({}))
-      if (!res.ok || json.ok === false) {
-        throw new Error(`slack chat.postMessage error: ${json.error || res.status}`)
+      const json = typeof res.json === 'function' ? await res.json().catch(() => ({})) : {}
+      if (!res.ok || json?.ok === false) {
+        throw new Error(`slack chat.postMessage error: ${json?.error || res.status}`)
       }
+      if (i === 0) firstResult = { ok: true, ts: json?.ts }
+    }
+    return firstResult
+  }
+
+  async editMessage(channelId, ts, text, blocks) {
+    if (!this.botToken) throw new Error('slack botToken required to edit message')
+    const body = {
+      channel: channelId,
+      ts: String(ts),
+      text: String(text || '').slice(0, SLACK_MAX_LENGTH),
+    }
+    if (blocks !== undefined) body.blocks = blocks
+    const res = await fetch(`${SLACK_API}/chat.update`, {
+      method: 'POST',
+      headers: {
+        Authorization: `Bearer ${this.botToken}`,
+        'Content-Type': 'application/json; charset=utf-8',
+      },
+      body: JSON.stringify(body),
+    })
+    const json = typeof res.json === 'function' ? await res.json().catch(() => ({})) : {}
+    if (!res.ok || json?.ok === false) {
+      throw new Error(`slack chat.update error: ${json?.error || res.status}`)
     }
     return { ok: true }
   }

package/lib/adapters/telegram.js

@@ -243,7 +243,7 @@ export class TelegramAdapter {
       if (fromId && !this.allowed(fromId)) {
         await this.call('answerCallbackQuery', {
           callback_query_id: update.callback_query.id,
-          text: 'Нет доступа',
+          text: 'Access denied',
           show_alert: true,
         }).catch(() => {})
         return
@@ -361,7 +361,7 @@ export class TelegramAdapter {
       const quoted = replyMsg.text ?? replyMsg.caption ?? ''
       const quoteFrag = msg.quote?.text || ''
       replyText = quoteFrag
-        ? `${quoted}${quoted ? '\n' : ''}[цитата: ${quoteFrag}]`
+        ? `${quoted}${quoted ? '\n' : ''}[quote: ${quoteFrag}]`
         : quoted
     }
 
@@ -377,17 +377,17 @@ export class TelegramAdapter {
         try {
           const { path } = await this.downloadByFileId(st.file_id, 'sticker-video', '.webm', st.file_unique_id || '')
           attachments.push({ kind: 'animation', path, mime: 'video/webm', emoji: st.emoji || '', name: `sticker${st.emoji || ''}.webm` })
-          if (st.emoji) text = `${text}\n[Видео-стикер ${st.emoji}]`.trim()
+          if (st.emoji) text = `${text}\n[Video sticker ${st.emoji}]`.trim()
         } catch (e) {
-          text = `${text}\n[Видео-стикер ${st.emoji || ''} (не скачан: ${e.message})]`.trim()
+          text = `${text}\n[Video sticker ${st.emoji || ''} (download failed: ${e.message})]`.trim()
         }
       } else if (st.is_animated) {
         try {
           const { path } = await this.downloadByFileId(st.file_id, 'sticker-anim', '.tgs', st.file_unique_id || '')
           attachments.push({ kind: 'document', path, mime: 'application/x-tgsticker', emoji: st.emoji || '', name: `sticker${st.emoji || ''}.tgs` })
-          if (st.emoji) text = `${text}\n[Анимированный стикер ${st.emoji}]`.trim()
+          if (st.emoji) text = `${text}\n[Animated sticker ${st.emoji}]`.trim()
         } catch (e) {
-          text = `${text}\n[Анимированный стикер ${st.emoji || ''} (не скачан: ${e.message})]`.trim()
+          text = `${text}\n[Animated sticker ${st.emoji || ''} (download failed: ${e.message})]`.trim()
         }
       } else {
         const { path } = await this.downloadByFileId(st.file_id, 'sticker', '.webp', st.file_unique_id || '')
@@ -467,7 +467,7 @@ export class TelegramAdapter {
   async startProgressMessage(chatId, replyTo, threadId = 0) {
     const result = await this.call('sendMessage', {
       chat_id: chatId,
-      text: '⏳ Думаю…',
+      text: '⏳ Thinking…',
       reply_to_message_id: replyTo,
       ...telegramThreadParams(threadId),
     })
@@ -475,9 +475,9 @@ export class TelegramAdapter {
     return {
       messageId,
       edit: async (text) => {
-        const plain = String(text || '⏳ Думаю…').slice(0, TELEGRAM_MAX)
+        const plain = String(text || '⏳ Thinking…').slice(0, TELEGRAM_MAX)
         try {
-          await this.call('editMessageText', { chat_id: chatId, message_id: messageId, text: plain || '⏳ Думаю…' })
+          await this.call('editMessageText', { chat_id: chatId, message_id: messageId, text: plain || '⏳ Thinking…' })
         } catch (err) {
           const msg = String(err.message || '')
           if (!msg.includes('message is not modified')) this.logger?.warn?.(`progress edit: ${err.message}`)

package/lib/alerts.js

@@ -8,26 +8,26 @@ export function formatAlertMessage(type, payload = {}) {
     const { userId, username, code } = payload
     const userStr = username ? `@${username} (id: <code>${userId}</code>)` : `id: <code>${userId}</code>`
     return [
-      `🔐 <b>[Запрос сопряжения]</b> <i>(${timestamp})</i>`,
+      `🔐 <b>[Pairing Request]</b> <i>(${timestamp})</i>`,
       '',
-      `Пользователь: ${userStr}`,
-      `Код доступа: <code>${code}</code>`,
+      `User: ${userStr}`,
+      `Pairing Code: <code>${code}</code>`,
       '',
-      `Для одобрения отправьте боту:`,
+      `To approve, send to bot:`,
       `<code>/pair ${code}</code>`,
     ].join('\n')
   }
 
   if (type === 'error') {
     const { message, code, sessionId, chatId, threadId } = payload
-    const location = chatId ? `Чат: <code>${chatId}</code>${threadId ? ` / топик <code>${threadId}</code>` : ''}` : ''
-    const sess = sessionId ? `Сессия: <code>${sessionId}</code>` : ''
+    const location = chatId ? `Chat: <code>${chatId}</code>${threadId ? ` / thread <code>${threadId}</code>` : ''}` : ''
+    const sess = sessionId ? `Session: <code>${sessionId}</code>` : ''
     const meta = [location, sess].filter(Boolean).join('\n')
 
     return [
-      `🚨 <b>[Ошибка шлюза]</b> <i>(${timestamp})</i>`,
+      `🚨 <b>[Gateway Error]</b> <i>(${timestamp})</i>`,
       meta ? `\n${meta}` : '',
-      `Ошибка: <b>${escapeHtml(String(code || 'error'))}</b>`,
+      `Error code: <b>${escapeHtml(String(code || 'error'))}</b>`,
       `<code>${escapeHtml(String(message || 'unknown error'))}</code>`,
     ].filter(Boolean).join('\n')
   }
@@ -35,12 +35,12 @@ export function formatAlertMessage(type, payload = {}) {
   if (type === 'status') {
     const { title, details } = payload
     return [
-      `⚡ <b>[Шлюз: ${escapeHtml(title || 'Статус')}]</b> <i>(${timestamp})</i>`,
+      `⚡ <b>[Gateway: ${escapeHtml(title || 'Status')}]</b> <i>(${timestamp})</i>`,
       details ? `\n${escapeHtml(details)}` : '',
     ].filter(Boolean).join('\n')
   }
 
-  return `🔔 <b>[Алерт: ${type}]</b> <i>(${timestamp})</i>\n${escapeHtml(JSON.stringify(payload))}`
+  return `🔔 <b>[Alert: ${type}]</b> <i>(${timestamp})</i>\n${escapeHtml(JSON.stringify(payload))}`
 }
 
 export function resolveAlertTarget(gateway) {