@fre4x/telegram 1.1.2 → 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

@@ -28398,22 +28398,26 @@ import { JSDOM } from "jsdom";
 // ../packages/shared/dist/errors.js
 function createApiError(message, statusCode) {
   let hint = "Check your network connection and retry.";
+  let type = "Service Error";
   if (statusCode === 429) {
-    hint = "Rate limit exceeded. Suggestion: Wait for 60 seconds (Exponential Backoff) before retrying or reduce concurrent calls.";
+    type = "Rate Limit";
+    hint = "Request volume is too high. Suggestion: Wait briefly before retrying or reduce concurrent calls.";
   } else if (statusCode === 401 || statusCode === 403) {
-    hint = "Authentication failed. Suggestion: Verify your API key or token in the environment configuration.";
+    type = "Authentication Error";
+    hint = "The request could not be authorized. Suggestion: Verify your API key or token in the environment configuration.";
   } else if (statusCode && statusCode >= 500) {
-    hint = "Upstream service is having issues. Suggestion: This is a temporary external error. Try again in a few minutes.";
+    type = "Upstream Error";
+    hint = "The remote service is experiencing temporary issues. Suggestion: Try again in a few minutes.";
   } else if (statusCode === 404) {
-    hint = "The requested resource was not found. Suggestion: Check if the ID or Ticker is correct, or search for it first.";
+    type = "Not Found";
+    hint = "The requested information could not be found. Suggestion: Check if the ID, Ticker, or query parameters are correct.";
   }
-  const detail = statusCode ? ` (HTTP ${statusCode})` : "";
   return {
     isError: true,
     content: [
       {
         type: "text",
-        text: `API Error${detail}: ${message}
+        text: `${type}: ${message}
 
 **Next Action**: ${hint}`
       }
@@ -28471,7 +28475,8 @@ _Showing ${start}\u2013${end} of ${total}. Use \`offset: ${offset + limit}\` for
 }
 
 // ../packages/shared/dist/pagination.js
-var z2 = external_exports3 || zod_default || zod_exports;
+var zodCompat = zod_exports;
+var z2 = zodCompat.z ?? zodCompat.default?.z ?? zodCompat.default ?? zodCompat;
 var paginationSchema = z2.object({
   limit: z2.number().int().min(1).max(100).default(20).describe("Maximum results to return (1\u2013100, default 20)"),
   offset: z2.number().int().min(0).default(0).describe("Number of results to skip for pagination (default 0)")
@@ -28617,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);
@@ -28957,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.2",
+  "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",