@fre4x/telegram 1.1.3 → 1.1.4

package/README.md

@@ -4,7 +4,7 @@ Telegram MCP server implementing Claude Code Channels for bidirectional communic
 
 ## Features
 
-- **Push Notifications:** Sends incoming Telegram messages directly to the Claude Code session via `notifications/push_event`.
+- **Push Notifications:** Sends incoming Telegram messages to the connected MCP client via `notifications/message` (claude/channel protocol).
 - **Bidirectional Chat:** Allows Claude to send messages to Telegram using the `send_telegram_message` tool.
 - **Security:** Filters incoming messages based on an allowed user ID.
 - **Remote Control:** (Planned) Approve or deny Claude's tool-use prompts from your mobile device.
@@ -62,14 +62,19 @@ If you are using this plugin as a bidirectional Claude Code channel rather than
 claude --channels plugin:telegram --dangerously-load-development-channels
 ```
 
-## Development
+## Mock Mode
+
+Run without a real bot token (returns fixture data of identical shape):
 
 ```bash
-npm run dev
+MOCK=true npx @fre4x/telegram
 ```
 
-Run the MCP Inspector:
+## Development
 
 ```bash
-npm run inspector
+npm run dev       # tsx, no build
+npm run build     # esbuild → dist/
+npm test          # vitest unit tests (MOCK=true)
+npm run inspector # MCP Inspector (MOCK=true)
 ```

package/dist/index.js

@@ -28622,10 +28622,24 @@ var server = new Server(
   },
   {
     capabilities: {
-      tools: {}
-    }
+      tools: {},
+      logging: {},
+      // Required by SDK for notifications/message
+      experimental: {
+        "claude/channel": {
+          description: "Telegram events are delivered via channel notifications"
+        }
+      }
+    },
+    instructions: "Telegram MCP server. Delivers inbound Telegram messages as channel notifications via notifications/message."
   }
 );
+var isInitialized = false;
+server.oninitialized = () => {
+  isInitialized = true;
+};
+var seenMessageIds = /* @__PURE__ */ new Set();
+var MAX_SEEN_IDS = 500;
 var isImage = (filePath) => {
   const ext = path.extname(filePath).toLowerCase();
   return [".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp"].includes(ext);
@@ -28962,18 +28976,37 @@ if (bot) {
     if (messageHistory.length > MAX_HISTORY) {
       messageHistory.shift();
     }
+    if (!isInitialized) {
+      console.warn(
+        `[telegram] Pre-init notification dropped (message_id=${metadata.message_id})`
+      );
+      return;
+    }
+    const msgId = metadata.message_id;
+    if (seenMessageIds.has(msgId)) {
+      return;
+    }
+    if (seenMessageIds.size >= MAX_SEEN_IDS) {
+      seenMessageIds.delete(seenMessageIds.values().next().value);
+    }
+    seenMessageIds.add(msgId);
     try {
       await server.notification({
-        method: "notifications/push_event",
+        method: "notifications/message",
         params: {
-          type: "message",
-          senderId,
-          content: messageContent,
-          metadata
+          _meta: {
+            channel: "telegram"
+          },
+          content: [
+            {
+              type: "text",
+              text: `New message from ${senderId} in ${chatTitle} (${chatId}): ${messageContent}`
+            }
+          ]
         }
       });
     } catch (error48) {
-      console.error("Failed to push notification:", error48);
+      console.error("Failed to push channel notification:", error48);
     }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/telegram",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Telegram MCP server implementing Claude Code Channels for bidirectional communication and remote permission relay.",
   "type": "module",
   "main": "dist/index.js",