@overpod/mcp-telegram 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.22.0] - 2026-04-01
+
+### Added
+- `TelegramService.setTyping(chatId, action?)` — send typing indicators with 10 action types: `typing`, `cancel`, `record_video`, `upload_video`, `record_audio`, `upload_audio`, `upload_photo`, `upload_document`, `choose_sticker`, `game_play` (#17)
+- `TelegramService.getMessageById(chatId, messageId)` — fetch a single message by ID, returns formatted message object or `null`. Uses GramJS `ids` filter for exact lookup (#17)
+
+## [1.21.0] - 2026-04-01
+
+### Added
+- `TelegramService.getClient()` — public accessor for the underlying GramJS `TelegramClient` instance, enabling event handlers like `NewMessage` for real-time listeners (#17)
+
 ## [1.20.0] - 2026-03-31
 
 ### Added

package/dist/telegram-client.d.ts

@@ -1,3 +1,4 @@
+import { TelegramClient } from "telegram";
 import { Api } from "telegram/tl/index.js";
 export declare class TelegramService {
     private client;
@@ -9,6 +10,7 @@ export declare class TelegramService {
     private rateLimiter;
     lastError: string;
     get sessionDir(): string;
+    getClient(): TelegramClient | null;
     constructor(apiId: number, apiHash: string, options?: {
         sessionPath?: string;
     });
@@ -85,6 +87,24 @@ export declare class TelegramService {
     blockUser(userId: string): Promise<void>;
     reportSpam(chatId: string): Promise<void>;
     markAsRead(chatId: string): Promise<void>;
+    private static TYPING_ACTIONS;
+    setTyping(chatId: string, action?: keyof typeof TelegramService.TYPING_ACTIONS): Promise<void>;
+    getMessageById(chatId: string, messageId: number): Promise<{
+        id: number;
+        text: string;
+        sender: string;
+        date: string;
+        media?: {
+            type: string;
+            fileName?: string;
+            size?: number;
+        };
+        reactions?: {
+            emoji: string;
+            count: number;
+            me: boolean;
+        }[];
+    } | null>;
     forwardMessage(fromChatId: string, toChatId: string, messageIds: number[]): Promise<void>;
     editMessage(chatId: string, messageId: number, newText: string): Promise<void>;
     deleteMessages(chatId: string, messageIds: number[]): Promise<void>;

package/dist/telegram-client.js

@@ -56,6 +56,9 @@ export class TelegramService {
     get sessionDir() {
         return dirname(this.sessionPath);
     }
+    getClient() {
+        return this.client;
+    }
     constructor(apiId, apiHash, options) {
         this.apiId = apiId;
         this.apiHash = apiHash;
@@ -523,6 +526,45 @@ export class TelegramService {
             throw new Error(NOT_CONNECTED_ERROR);
         await this.client.markAsRead(chatId);
     }
+    static TYPING_ACTIONS = {
+        typing: () => new Api.SendMessageTypingAction(),
+        cancel: () => new Api.SendMessageCancelAction(),
+        record_video: () => new Api.SendMessageRecordVideoAction(),
+        upload_video: () => new Api.SendMessageUploadVideoAction({ progress: 0 }),
+        record_audio: () => new Api.SendMessageRecordAudioAction(),
+        upload_audio: () => new Api.SendMessageUploadAudioAction({ progress: 0 }),
+        upload_photo: () => new Api.SendMessageUploadPhotoAction({ progress: 0 }),
+        upload_document: () => new Api.SendMessageUploadDocumentAction({ progress: 0 }),
+        choose_sticker: () => new Api.SendMessageChooseStickerAction(),
+        game_play: () => new Api.SendMessageGamePlayAction(),
+    };
+    async setTyping(chatId, action = "typing") {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const factory = TelegramService.TYPING_ACTIONS[action];
+        if (!factory)
+            throw new Error(`Unknown typing action: ${action}. Valid: ${Object.keys(TelegramService.TYPING_ACTIONS).join(", ")}`);
+        const resolved = await this.resolvePeer(chatId);
+        const peer = await this.client.getInputEntity(resolved);
+        await this.client.invoke(new Api.messages.SetTyping({ peer, action: factory() }));
+    }
+    async getMessageById(chatId, messageId) {
+        if (!this.client || !this.connected)
+            throw new Error(NOT_CONNECTED_ERROR);
+        const resolved = await this.resolvePeer(chatId);
+        const messages = await this.client.getMessages(resolved, { ids: [messageId] });
+        const m = messages[0];
+        if (!m || m.id !== messageId)
+            return null;
+        return {
+            id: m.id,
+            text: m.message ?? "",
+            sender: await this.resolveSenderName(m.senderId),
+            date: new Date((m.date ?? 0) * 1000).toISOString(),
+            media: this.extractMediaInfo(m.media),
+            reactions: this.extractReactions(m.reactions),
+        };
+    }
     async forwardMessage(fromChatId, toChatId, messageIds) {
         if (!this.client || !this.connected)
             throw new Error(NOT_CONNECTED_ERROR);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overpod/mcp-telegram",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "MCP server for Telegram userbot — messages, media, reactions, polls & more. Built on GramJS/MTProto.",
   "type": "module",
   "main": "dist/index.js",
@@ -52,14 +52,14 @@
     "url": "https://github.com/overpod/mcp-telegram/issues"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.3.1",
     "qrcode": "^1.5.4",
     "telegram": "^2.26.22",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.9",
+    "@biomejs/biome": "^2.4.10",
     "@types/node": "^25.5.0",
     "@types/qrcode": "^1.5.6",
     "tsx": "^4.21.0",