@hasna/conversations 0.2.38 → 0.2.39

package/bin/index.js

@@ -14914,7 +14914,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.38",
+    version: "0.2.39",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -47026,6 +47026,98 @@ var init_cloud = __esm(() => {
   CONFLICT_TABLES = new Set(["spaces", "projects", "agent_presence"]);
 });
 
+// src/mcp/telegram-channel.ts
+async function telegramRequest(token, method, params) {
+  const url2 = `https://api.telegram.org/bot${token}/${method}`;
+  const res = await fetch(url2, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: params ? JSON.stringify(params) : undefined
+  });
+  const data = await res.json();
+  if (!data.ok)
+    throw new Error(`Telegram API error: ${data.description}`);
+  return data.result;
+}
+function registerTelegramChannel(server) {
+  const token = process.env.TELEGRAM_BOT_TOKEN;
+  if (!token)
+    return;
+  let lastUpdateId = 0;
+  let pollTimer = null;
+  let botUsername = "bot";
+  telegramRequest(token, "getMe").then((me) => {
+    botUsername = me.username || me.first_name || "bot";
+    console.error(`[telegram-channel] connected as @${botUsername}`);
+  }).catch(() => {});
+  server.registerTool("telegram_send", {
+    description: "Send a message to a Telegram chat. Use this to reply to Telegram messages received via the channel bridge.",
+    inputSchema: {
+      chat_id: exports_external2.coerce.number().describe("Telegram chat ID to send to (from the incoming message's chat_id meta)"),
+      text: exports_external2.string().describe("Message text to send"),
+      parse_mode: exports_external2.string().optional().describe("Optional: HTML or MarkdownV2"),
+      reply_to_message_id: exports_external2.coerce.number().optional().describe("Optional: message ID to reply to")
+    }
+  }, async (args) => {
+    const result = await telegramRequest(token, "sendMessage", {
+      chat_id: args.chat_id,
+      text: args.text,
+      parse_mode: args.parse_mode,
+      reply_to_message_id: args.reply_to_message_id
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  function pushNotification(update) {
+    const msg = update.message;
+    if (!msg?.text)
+      return;
+    const from = msg.from?.username || msg.from?.first_name || "unknown";
+    const chatTitle = msg.chat.title || msg.chat.username || String(msg.chat.id);
+    const context = [
+      `From: ${from}`,
+      `Chat: ${chatTitle} (${msg.chat.id})`,
+      `Message ID: ${msg.message_id}`,
+      msg.chat.type !== "private" ? `Type: ${msg.chat.type}` : null
+    ].filter(Boolean).join(" | ");
+    const enrichedContent = `[${context}]
+${msg.text}`;
+    server.server.notification({
+      method: "notifications/claude/channel",
+      params: {
+        content: enrichedContent,
+        meta: {
+          from,
+          chat_id: String(msg.chat.id),
+          message_id: String(msg.message_id),
+          chat_type: msg.chat.type,
+          ...msg.chat.title ? { chat_title: msg.chat.title } : {}
+        }
+      }
+    }).catch(() => {});
+  }
+  async function poll() {
+    try {
+      const updates = await telegramRequest(token, "getUpdates", {
+        offset: lastUpdateId + 1,
+        timeout: 1,
+        allowed_updates: ["message"]
+      });
+      for (const update of updates) {
+        lastUpdateId = update.update_id;
+        pushNotification(update);
+      }
+    } catch {}
+  }
+  setTimeout(() => {
+    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS2);
+    console.error("[telegram-channel] polling started");
+  }, 2000);
+}
+var POLL_INTERVAL_MS2 = 2000;
+var init_telegram_channel = __esm(() => {
+  init_zod2();
+});
+
 // src/mcp/tools/tmux.ts
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -47166,6 +47258,7 @@ var init_mcp2 = __esm(() => {
   init_advanced();
   init_cloud();
   init_channel();
+  init_telegram_channel();
   init_tmux2();
   import__package2 = __toESM(require_package(), 1);
   server = new McpServer({
@@ -47180,6 +47273,7 @@ var init_mcp2 = __esm(() => {
   registerAdvancedTools(server, import__package2.default.version);
   registerTmuxTools(server);
   registerChannelBridge(server);
+  registerTelegramChannel(server);
   isDirectRun = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("mcp.js") || process.argv[1]?.endsWith("mcp.ts");
   if (isDirectRun) {
     startMcpServer().catch((error48) => {

package/bin/mcp.js

@@ -44169,6 +44169,95 @@ function formatError2(e) {
   return String(e);
 }
 
+// src/mcp/telegram-channel.ts
+var POLL_INTERVAL_MS2 = 2000;
+async function telegramRequest(token, method, params) {
+  const url2 = `https://api.telegram.org/bot${token}/${method}`;
+  const res = await fetch(url2, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: params ? JSON.stringify(params) : undefined
+  });
+  const data = await res.json();
+  if (!data.ok)
+    throw new Error(`Telegram API error: ${data.description}`);
+  return data.result;
+}
+function registerTelegramChannel(server) {
+  const token = process.env.TELEGRAM_BOT_TOKEN;
+  if (!token)
+    return;
+  let lastUpdateId = 0;
+  let pollTimer = null;
+  let botUsername = "bot";
+  telegramRequest(token, "getMe").then((me) => {
+    botUsername = me.username || me.first_name || "bot";
+    console.error(`[telegram-channel] connected as @${botUsername}`);
+  }).catch(() => {});
+  server.registerTool("telegram_send", {
+    description: "Send a message to a Telegram chat. Use this to reply to Telegram messages received via the channel bridge.",
+    inputSchema: {
+      chat_id: exports_external.coerce.number().describe("Telegram chat ID to send to (from the incoming message's chat_id meta)"),
+      text: exports_external.string().describe("Message text to send"),
+      parse_mode: exports_external.string().optional().describe("Optional: HTML or MarkdownV2"),
+      reply_to_message_id: exports_external.coerce.number().optional().describe("Optional: message ID to reply to")
+    }
+  }, async (args) => {
+    const result = await telegramRequest(token, "sendMessage", {
+      chat_id: args.chat_id,
+      text: args.text,
+      parse_mode: args.parse_mode,
+      reply_to_message_id: args.reply_to_message_id
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  function pushNotification(update) {
+    const msg = update.message;
+    if (!msg?.text)
+      return;
+    const from = msg.from?.username || msg.from?.first_name || "unknown";
+    const chatTitle = msg.chat.title || msg.chat.username || String(msg.chat.id);
+    const context = [
+      `From: ${from}`,
+      `Chat: ${chatTitle} (${msg.chat.id})`,
+      `Message ID: ${msg.message_id}`,
+      msg.chat.type !== "private" ? `Type: ${msg.chat.type}` : null
+    ].filter(Boolean).join(" | ");
+    const enrichedContent = `[${context}]
+${msg.text}`;
+    server.server.notification({
+      method: "notifications/claude/channel",
+      params: {
+        content: enrichedContent,
+        meta: {
+          from,
+          chat_id: String(msg.chat.id),
+          message_id: String(msg.message_id),
+          chat_type: msg.chat.type,
+          ...msg.chat.title ? { chat_title: msg.chat.title } : {}
+        }
+      }
+    }).catch(() => {});
+  }
+  async function poll() {
+    try {
+      const updates = await telegramRequest(token, "getUpdates", {
+        offset: lastUpdateId + 1,
+        timeout: 1,
+        allowed_updates: ["message"]
+      });
+      for (const update of updates) {
+        lastUpdateId = update.update_id;
+        pushNotification(update);
+      }
+    } catch {}
+  }
+  setTimeout(() => {
+    pollTimer = setInterval(() => poll(), POLL_INTERVAL_MS2);
+    console.error("[telegram-channel] polling started");
+  }, 2000);
+}
+
 // src/cli/commands/tmux.ts
 import { execSync } from "child_process";
 function sleep(ms) {
@@ -44317,7 +44406,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.38",
+  version: "0.2.39",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -44421,6 +44510,7 @@ registerAgentTools(server, agentFocus, getAgentFocus);
 registerAdvancedTools(server, package_default.version);
 registerTmuxTools(server);
 registerChannelBridge(server);
+registerTelegramChannel(server);
 async function startMcpServer() {
   const transport = new StdioServerTransport;
   registerCloudSyncTools(server);

package/dist/mcp/telegram-channel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Telegram channel bridge for conversations MCP server.
+ *
+ * Polls a Telegram bot for new messages and pushes them as
+ * `notifications/claude/channel` events. Also registers a
+ * `telegram_send` tool for replying.
+ *
+ * Requires: TELEGRAM_BOT_TOKEN env var or connect-telegram profile.
+ *
+ * Usage: Set TELEGRAM_BOT_TOKEN and the bridge auto-starts.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTelegramChannel(server: McpServer): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.2.38",
+  "version": "0.2.39",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {