@overpod/mcp-telegram 1.11.0 → 1.11.1

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/v/@overpod/mcp-telegram)](https://www.npmjs.com/package/@overpod/mcp-telegram)
 [![npm downloads](https://img.shields.io/npm/dm/@overpod/mcp-telegram)](https://www.npmjs.com/package/@overpod/mcp-telegram)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue.svg?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.27-green.svg)](https://modelcontextprotocol.io/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![mcp-telegram MCP server](https://glama.ai/mcp/servers/overpod/mcp-telegram/badges/score.svg)](https://glama.ai/mcp/servers/overpod/mcp-telegram)
@@ -208,6 +208,7 @@ const telegramMcp = new MCPClient({
 | `telegram-read-messages` | Read recent messages from a chat |
 | `telegram-search-chats` | Search for chats, users, or channels by name |
 | `telegram-search-messages` | Search messages in a chat by text |
+| `telegram-search-global` | Search messages across all public chats and channels |
 | `telegram-get-unread` | Get chats with unread messages; forums show per-topic unread breakdown |
 | `telegram-get-contact-requests` | Get incoming messages from non-contacts with preview |
 
@@ -243,6 +244,8 @@ const telegramMcp = new MCPClient({
 |------|-------------|
 | `telegram-get-contacts` | Get your contacts list with phone numbers |
 | `telegram-get-profile` | Get detailed profile info for a user (bio, photo, last seen) |
+| `telegram-get-profile-photo` | Get a user's or chat's profile photo (inline or file) |
+| `telegram-get-reactions` | Get reactions on a specific message with user details |
 
 ### Media
 
@@ -357,7 +360,8 @@ Most tools accept `chatId` as a string -- either a numeric ID (e.g., `"-10012345
 |-----------|------|----------|-------------|
 | `chatId` | string | yes | Chat ID or @username |
 | `messageId` | number | yes | Message ID to react to |
-| `emoji` | string | no | Reaction emoji (e.g. 👍❤️🔥😂🎉). Omit to remove reaction |
+| `emoji` | string \| string[] | no | Single emoji `"👍"` or array `["👍","🔥"]`. Omit to remove all reactions |
+| `addToExisting` | boolean | no | Add to existing reactions instead of replacing (default: false) |
 
 ### telegram-send-scheduled
 
@@ -388,6 +392,15 @@ Most tools accept `chatId` as a string -- either a numeric ID (e.g., `"-10012345
 | `query` | string | yes | Search text |
 | `limit` | number | no | Max results (default: 20) |
 
+### telegram-search-global
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | yes | Search text |
+| `limit` | number | no | Max results (default: 20) |
+| `minDate` | number | no | Unix timestamp: only messages after this date |
+| `maxDate` | number | no | Unix timestamp: only messages before this date |
+
 ### telegram-search-chats
 
 | Parameter | Type | Required | Description |
@@ -414,6 +427,21 @@ Most tools accept `chatId` as a string -- either a numeric ID (e.g., `"-10012345
 |-----------|------|----------|-------------|
 | `userId` | string | yes | User ID or @username |
 
+### telegram-get-profile-photo
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entityId` | string | yes | User/Chat/Channel ID or username |
+| `savePath` | string | no | Absolute path to save file. If omitted, returns inline base64 image |
+| `size` | `"small"` / `"big"` | no | Photo size: small (160x160) or big (640x640). Default: big |
+
+### telegram-get-reactions
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `chatId` | string | yes | Chat ID or @username |
+| `messageId` | number | yes | Message ID to get reactions for |
+
 ### telegram-get-unread
 
 | Parameter | Type | Required | Description |

package/dist/index.js

@@ -18,6 +18,10 @@ if (!API_ID || !API_HASH) {
     process.exit(1);
 }
 const telegram = new TelegramService(API_ID, API_HASH);
+/** Remove unpaired UTF-16 surrogates that break JSON serialization */
+function sanitize(text) {
+    return text.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, "\uFFFD");
+}
 /** Format reactions array into compact text like: [👍×5 ❤️×3(me) 🔥×1] */
 function formatReactions(reactions) {
     if (!reactions?.length)
@@ -153,7 +157,7 @@ server.tool("telegram-list-chats", "List Telegram chats", {
             return `${prefix} ${d.name} (${d.id})${botTag}${contactTag}${unread}`;
         })
             .join("\n");
-        return { content: [{ type: "text", text: text || "No chats" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No chats" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -174,7 +178,7 @@ server.tool("telegram-read-messages", "Read recent messages from a Telegram chat
         const text = messages
             .map((m) => `[#${m.id}] [${m.date}] ${m.sender}: ${m.text}${m.media ? ` [${m.media.type}${m.media.fileName ? `: ${m.media.fileName}` : ""}]` : ""}${formatReactions(m.reactions)}`)
             .join("\n\n");
-        return { content: [{ type: "text", text: text || "No messages" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No messages" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -192,7 +196,7 @@ server.tool("telegram-search-chats", "Search for Telegram chats/users/channels b
         const text = results
             .map((c) => `${c.type === "group" ? "G" : c.type === "channel" ? "C" : "P"} ${c.name}${c.username ? ` (@${c.username})` : ""} (${c.id})${c.membersCount ? ` [${c.membersCount} members]` : ""}${c.description ? ` — ${c.description.split("\n")[0].slice(0, 100)}` : ""}`)
             .join("\n");
-        return { content: [{ type: "text", text: text || "No results" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No results" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -212,7 +216,7 @@ server.tool("telegram-search-global", "Search messages globally across all publi
         const text = messages
             .map((m) => `[#${m.id}] [${m.date}] [${m.chat.type === "channel" ? "C" : m.chat.type === "group" ? "G" : "P"} ${m.chat.name}${m.chat.username ? ` @${m.chat.username}` : ""}] ${m.sender}: ${m.text}${m.media ? ` [${m.media.type}${m.media.fileName ? `: ${m.media.fileName}` : ""}]` : ""}${formatReactions(m.reactions)}`)
             .join("\n\n");
-        return { content: [{ type: "text", text: text || "No messages found" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No messages found" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -233,7 +237,7 @@ server.tool("telegram-search-messages", "Search messages in a Telegram chat by t
         const text = messages
             .map((m) => `[#${m.id}] [${m.date}] ${m.sender}: ${m.text}${m.media ? ` [${m.media.type}${m.media.fileName ? `: ${m.media.fileName}` : ""}]` : ""}${formatReactions(m.reactions)}`)
             .join("\n\n");
-        return { content: [{ type: "text", text: text || "No messages found" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No messages found" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -261,7 +265,7 @@ server.tool("telegram-get-unread", "Get unread Telegram chats", {
             return line;
         })
             .join("\n");
-        return { content: [{ type: "text", text: text || "No unread chats" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No unread chats" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -429,7 +433,7 @@ server.tool("telegram-get-contacts", "Get Telegram contacts list", {
         const text = contacts
             .map((c) => `P ${c.name}${c.username ? ` (@${c.username})` : ""} (${c.id})${c.phone ? ` +${c.phone}` : ""}`)
             .join("\n");
-        return { content: [{ type: "text", text: text || "No contacts" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No contacts" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -445,7 +449,7 @@ server.tool("telegram-get-chat-members", "Get members of a Telegram group or cha
     try {
         const members = await telegram.getChatMembers(chatId, limit);
         const text = members.map((m) => `${m.name}${m.username ? ` (@${m.username})` : ""} (${m.id})`).join("\n");
-        return { content: [{ type: "text", text: text || "No members found" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No members found" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -656,7 +660,7 @@ server.tool("telegram-get-contact-requests", "Get incoming messages from non-con
             return `${tag} ${r.name}${username} (${r.id})${unread}${preview}`;
         })
             .join("\n");
-        return { content: [{ type: "text", text: text }] };
+        return { content: [{ type: "text", text: sanitize(text) }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -726,7 +730,7 @@ server.tool("telegram-list-topics", "List forum topics in a Telegram group with
             return `# ${t.title} (id: ${t.id})${flagStr}${unread}`;
         })
             .join("\n");
-        return { content: [{ type: "text", text: text || "No topics found" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No topics found" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };
@@ -746,7 +750,7 @@ server.tool("telegram-read-topic-messages", "Read messages from a specific forum
         const text = messages
             .map((m) => `[#${m.id}] [${m.date}] ${m.sender}: ${m.text}${m.media ? ` [${m.media.type}${m.media.fileName ? `: ${m.media.fileName}` : ""}]` : ""}${formatReactions(m.reactions)}`)
             .join("\n\n");
-        return { content: [{ type: "text", text: text || "No messages in this topic" }] };
+        return { content: [{ type: "text", text: sanitize(text) || "No messages in this topic" }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overpod/mcp-telegram",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.",
   "type": "module",
   "main": "dist/index.js",
@@ -60,6 +60,6 @@
     "@types/node": "^25.5.0",
     "@types/qrcode": "^1.5.6",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.2"
   }
 }