@goodandready/dsh-messenger-gateway 0.3.20 → 0.3.22

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,23 @@ 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),
+          keepalive: true,
+          signal: AbortSignal.timeout(15000),
         })
         if (!res.ok) {
           const errText = await res.text().catch(() => '')
@@ -77,9 +106,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)
@@ -95,37 +124,70 @@ export class DiscordAdapter {
           Authorization: `Bot ${this.botToken}`,
         },
         body: form,
+        keepalive: true,
+        signal: AbortSignal.timeout(30000),
       })
       if (!res.ok) {
         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),
+      keepalive: true,
+      signal: AbortSignal.timeout(15000),
+    })
+    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),
+      keepalive: true,
+      signal: AbortSignal.timeout(15000),
     })
     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,21 @@ 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),
+          keepalive: true,
+          signal: AbortSignal.timeout(15000),
         })
         if (!res.ok) {
           const errText = await res.text().catch(() => '')
@@ -68,23 +102,55 @@ 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),
+        keepalive: true,
+        signal: AbortSignal.timeout(15000),
       })
-      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),
+      keepalive: true,
+      signal: AbortSignal.timeout(15000),
+    })
+    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 }
   }