bn-telegram-mcp-server 0.0.1

package/dist/tools/getMe.js

@@ -0,0 +1,20 @@
+import { withClient } from "../helpers.js";
+import { transformUser } from "../transformers.js";
+/**
+ * Get information about the current Telegram user (the authenticated user)
+ *
+ * Returns a simplified user profile with:
+ * - id: User's numeric ID
+ * - name: Full name
+ * - username: @username if set
+ * - phone: Phone number if visible
+ * - status: Online status (e.g., "online", "last seen 2 hours ago")
+ * - is_premium: Whether user has Telegram Premium
+ */
+export async function getMe(req, _args) {
+    return withClient(req, async (client) => {
+        const result = await client.invoke({ _: "getMe" });
+        return transformUser(result);
+    });
+}
+//# sourceMappingURL=getMe.js.map

package/dist/tools/getMe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMe.js","sourceRoot":"","sources":["../../src/tools/getMe.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,GAAY,EACZ,KAAkC;IAElC,OAAO,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/getMessageContext.d.ts

@@ -0,0 +1,21 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { GetMessageContextSchema } from "../schemas.js";
+import { type TransformedMessageContextResult } from "../transformers.js";
+/**
+ * Get message context - fetches surrounding messages for better understanding
+ *
+ * Modes:
+ * - mode="message_id": Get context around a specific message ID
+ * - mode="search": Search for messages and get context around each match
+ *
+ * Parameters:
+ * - chat: Chat identifier (required for message_id mode, optional for search)
+ * - mode: "message_id" | "search" (default: "message_id")
+ * - message_id: (message_id mode) Target message ID
+ * - query: (search mode) Search query text
+ * - search_limit: (search mode) Max results to get context for (default: 5)
+ * - context_count: Messages to fetch before AND after target (default: 5)
+ */
+export declare function getMessageContext(req: Request, args: z.infer<typeof GetMessageContextSchema>): Promise<TransformedMessageContextResult>;
+//# sourceMappingURL=getMessageContext.d.ts.map

package/dist/tools/getMessageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessageContext.d.ts","sourceRoot":"","sources":["../../src/tools/getMessageContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA2M1C"}

package/dist/tools/getMessageContext.js

@@ -0,0 +1,164 @@
+import { withClient } from "../helpers.js";
+import { resolveChat } from "../resolvers.js";
+import { transformMessageContext, transformMessageContextResult, } from "../transformers.js";
+/**
+ * Get message context - fetches surrounding messages for better understanding
+ *
+ * Modes:
+ * - mode="message_id": Get context around a specific message ID
+ * - mode="search": Search for messages and get context around each match
+ *
+ * Parameters:
+ * - chat: Chat identifier (required for message_id mode, optional for search)
+ * - mode: "message_id" | "search" (default: "message_id")
+ * - message_id: (message_id mode) Target message ID
+ * - query: (search mode) Search query text
+ * - search_limit: (search mode) Max results to get context for (default: 5)
+ * - context_count: Messages to fetch before AND after target (default: 5)
+ */
+export async function getMessageContext(req, args) {
+    return withClient(req, async (client) => {
+        const mode = args.mode ?? "message_id";
+        const contextCount = args.context_count ?? 5;
+        // Load chats first
+        await client.invoke({
+            _: "loadChats",
+            chat_list: { _: "chatListMain" },
+            limit: 100,
+        });
+        // Helper function to get context around a single message
+        async function getContextForMessage(chatId, messageId, chatTitle) {
+            // Get the target message first
+            const targetResult = (await client.invoke({
+                _: "getMessages",
+                chat_id: chatId,
+                message_ids: [messageId],
+            }));
+            const targetMessage = targetResult.messages?.[0];
+            if (!targetMessage) {
+                throw new Error(`Message ${messageId} not found in chat ${chatId}`);
+            }
+            // Get messages BEFORE the target (older messages)
+            // offset=0 starts from the message, returns in reverse chronological order
+            const beforeResult = (await client.invoke({
+                _: "getChatHistory",
+                chat_id: chatId,
+                from_message_id: messageId,
+                offset: 0,
+                limit: contextCount + 1, // +1 because it includes the target message
+                only_local: false,
+            }));
+            // Get messages AFTER the target (newer messages)
+            // offset=-N gets N messages newer than from_message_id
+            const afterResult = (await client.invoke({
+                _: "getChatHistory",
+                chat_id: chatId,
+                from_message_id: messageId,
+                offset: -contextCount,
+                limit: contextCount,
+                only_local: false,
+            }));
+            // Process before messages (skip the first one as it's the target itself)
+            // Messages are returned newest first, so we reverse to get chronological order
+            const messagesBefore = (beforeResult.messages ?? [])
+                .slice(1) // Skip target message
+                .reverse(); // Reverse to get chronological order (oldest first)
+            // Process after messages (already in reverse chronological order, newest first)
+            // Filter out the target message (it may be included due to offset behavior)
+            // Then reverse to get chronological order
+            const messagesAfter = (afterResult.messages ?? [])
+                .filter((m) => m.id !== messageId) // Filter out target message
+                .reverse(); // Reverse to get chronological order
+            return transformMessageContext(targetMessage, messagesBefore, messagesAfter, contextCount, chatId, chatTitle);
+        }
+        // Handle message_id mode
+        if (mode === "message_id") {
+            if (args.message_id === undefined) {
+                throw new Error('message_id is required for mode="message_id". Provide a message ID.');
+            }
+            if (args.chat === undefined) {
+                throw new Error('chat is required for mode="message_id". Provide a chat ID or name.');
+            }
+            const chatId = await resolveChat(client, args.chat);
+            // Get chat info for title
+            const chatInfo = (await client.invoke({
+                _: "getChat",
+                chat_id: chatId,
+            }));
+            const context = await getContextForMessage(chatId, args.message_id, chatInfo.title);
+            return transformMessageContextResult([context], 1);
+        }
+        // Handle search mode
+        if (mode === "search") {
+            const query = args.query;
+            if (!query) {
+                throw new Error('query is required for mode="search". Provide a search query.');
+            }
+            const searchLimit = args.search_limit ?? 5;
+            const contexts = [];
+            if (args.chat !== undefined) {
+                // Search in specific chat
+                const chatId = await resolveChat(client, args.chat);
+                const chatInfo = (await client.invoke({
+                    _: "getChat",
+                    chat_id: chatId,
+                }));
+                const searchResult = (await client.invoke({
+                    _: "searchChatMessages",
+                    chat_id: chatId,
+                    query: query,
+                    from_message_id: 0,
+                    offset: 0,
+                    limit: searchLimit,
+                    filter: { _: "searchMessagesFilterEmpty" },
+                }));
+                // Get context for each search result
+                for (const message of searchResult.messages ?? []) {
+                    try {
+                        const context = await getContextForMessage(chatId, message.id, chatInfo.title);
+                        contexts.push(context);
+                    }
+                    catch {
+                        // Skip messages that can't be found
+                    }
+                }
+                return transformMessageContextResult(contexts, searchResult.total_count, query);
+            }
+            else {
+                // Global search across all chats
+                const searchResult = (await client.invoke({
+                    _: "searchMessages",
+                    chat_list: { _: "chatListMain" },
+                    query: query,
+                    offset: "",
+                    limit: searchLimit,
+                    filter: { _: "searchMessagesFilterEmpty" },
+                    min_date: 0,
+                    max_date: 0,
+                }));
+                // Get context for each search result (may be from different chats)
+                const chatTitleCache = new Map();
+                for (const message of searchResult.messages ?? []) {
+                    try {
+                        // Get chat title if not cached
+                        if (!chatTitleCache.has(message.chat_id)) {
+                            const chatInfo = (await client.invoke({
+                                _: "getChat",
+                                chat_id: message.chat_id,
+                            }));
+                            chatTitleCache.set(message.chat_id, chatInfo.title ?? "");
+                        }
+                        const context = await getContextForMessage(message.chat_id, message.id, chatTitleCache.get(message.chat_id));
+                        contexts.push(context);
+                    }
+                    catch {
+                        // Skip messages that can't be found
+                    }
+                }
+                return transformMessageContextResult(contexts, searchResult.total_count, query);
+            }
+        }
+        throw new Error(`Unknown mode: ${mode}`);
+    });
+}
+//# sourceMappingURL=getMessageContext.js.map

package/dist/tools/getMessageContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessageContext.js","sourceRoot":"","sources":["../../src/tools/getMessageContext.ts"],"names":[],"mappings":"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"}

package/dist/tools/getMessages.d.ts

@@ -0,0 +1,38 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { GetMessagesSchema } from "../schemas.js";
+import { type TransformedMessage, type TransformedMessageHistory, type TransformedSearchResult } from "../transformers.js";
+type GetMessagesResult = TransformedMessageHistory | {
+    messages: TransformedMessage[];
+    count: number;
+    chat_title?: string;
+} | TransformedSearchResult;
+/**
+ * Get messages from a chat - supports history, specific IDs, or search
+ *
+ * Modes:
+ * - mode="history" (default): Get paginated message history from a chat
+ * - mode="specific": Get specific messages by their IDs
+ * - mode="search": Search for messages by text content
+ *
+ * Parameters:
+ * - chat: Chat identifier (required for "history" and "specific" modes, optional for "search")
+ * - mode: "history" | "specific" | "search" (default: "history")
+ *
+ * History mode parameters:
+ * - from_message_id: Start from this message (0 = latest)
+ * - offset: Pagination offset
+ * - limit: Max messages to return (default: 50, max: 100)
+ * - only_local: Only return cached messages
+ *
+ * Specific mode parameters:
+ * - message_ids: Array of message IDs to retrieve
+ *
+ * Search mode parameters:
+ * - query: Search text
+ * - offset: Pagination offset
+ * - limit: Max results (default: 50)
+ */
+export declare function getMessages(req: Request, args: z.infer<typeof GetMessagesSchema>): Promise<GetMessagesResult>;
+export {};
+//# sourceMappingURL=getMessages.d.ts.map

package/dist/tools/getMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessages.d.ts","sourceRoot":"","sources":["../../src/tools/getMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,KAAK,iBAAiB,GAClB,yBAAyB,GACzB;IAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,uBAAuB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CA0H5B"}

package/dist/tools/getMessages.js

@@ -0,0 +1,123 @@
+import { withClient } from "../helpers.js";
+import { resolveChat } from "../resolvers.js";
+import { transformMessage, transformMessageHistory, transformSearchResults, } from "../transformers.js";
+/**
+ * Get messages from a chat - supports history, specific IDs, or search
+ *
+ * Modes:
+ * - mode="history" (default): Get paginated message history from a chat
+ * - mode="specific": Get specific messages by their IDs
+ * - mode="search": Search for messages by text content
+ *
+ * Parameters:
+ * - chat: Chat identifier (required for "history" and "specific" modes, optional for "search")
+ * - mode: "history" | "specific" | "search" (default: "history")
+ *
+ * History mode parameters:
+ * - from_message_id: Start from this message (0 = latest)
+ * - offset: Pagination offset
+ * - limit: Max messages to return (default: 50, max: 100)
+ * - only_local: Only return cached messages
+ *
+ * Specific mode parameters:
+ * - message_ids: Array of message IDs to retrieve
+ *
+ * Search mode parameters:
+ * - query: Search text
+ * - offset: Pagination offset
+ * - limit: Max results (default: 50)
+ */
+export async function getMessages(req, args) {
+    return withClient(req, async (client) => {
+        const mode = args.mode ?? "history";
+        // Load chats first
+        await client.invoke({
+            _: "loadChats",
+            chat_list: { _: "chatListMain" },
+            limit: 100,
+        });
+        // Handle search mode (can be global or chat-specific)
+        if (mode === "search") {
+            const query = args.query ?? "";
+            const limit = args.limit ?? 50;
+            const nextOffset = args.next_offset ?? "";
+            if (args.chat !== undefined) {
+                // Search in specific chat using searchChatMessages
+                // This uses from_message_id for pagination (different from global search)
+                const chatId = await resolveChat(client, args.chat);
+                const result = await client.invoke({
+                    _: "searchChatMessages",
+                    chat_id: chatId,
+                    query: query,
+                    from_message_id: args.from_message_id ?? 0,
+                    offset: 0,
+                    limit: limit,
+                    filter: { _: "searchMessagesFilterEmpty" },
+                });
+                const messages = result;
+                // For chat search, next_offset is based on last message ID
+                const lastMessage = messages.messages?.[messages.messages.length - 1];
+                const chatNextOffset = lastMessage?.id ? String(lastMessage.id) : "";
+                return transformSearchResults({
+                    messages: messages.messages,
+                    total_count: messages.total_count,
+                    next_offset: chatNextOffset,
+                }, query);
+            }
+            else {
+                // Global search across all chats using cursor-based pagination
+                const result = await client.invoke({
+                    _: "searchMessages",
+                    chat_list: { _: "chatListMain" },
+                    query: query,
+                    offset: nextOffset,
+                    limit: limit,
+                    filter: { _: "searchMessagesFilterEmpty" },
+                    min_date: 0,
+                    max_date: 0,
+                });
+                return transformSearchResults(result, query);
+            }
+        }
+        // For history and specific modes, chat is required
+        if (args.chat === undefined) {
+            throw new Error(`Chat is required for mode="${mode}". Provide a chat ID or name.`);
+        }
+        const chatId = await resolveChat(client, args.chat);
+        // Get chat info for title
+        const chatInfo = (await client.invoke({
+            _: "getChat",
+            chat_id: chatId,
+        }));
+        if (mode === "specific") {
+            // Get specific messages by IDs
+            if (!args.message_ids || args.message_ids.length === 0) {
+                throw new Error('message_ids is required for mode="specific". Provide an array of message IDs.');
+            }
+            const result = (await client.invoke({
+                _: "getMessages",
+                chat_id: chatId,
+                message_ids: args.message_ids,
+            }));
+            const messages = (result.messages ?? [])
+                .filter((m) => m !== null)
+                .map((m) => transformMessage(m));
+            return {
+                messages,
+                count: messages.length,
+                chat_title: chatInfo.title,
+            };
+        }
+        // Default: history mode
+        const result = (await client.invoke({
+            _: "getChatHistory",
+            chat_id: chatId,
+            from_message_id: args.from_message_id ?? 0,
+            offset: args.offset ?? 0,
+            limit: args.limit ?? 50,
+            only_local: args.only_local ?? false,
+        }));
+        return transformMessageHistory(result.messages ?? [], result.total_count, chatInfo.title);
+    });
+}
+//# sourceMappingURL=getMessages.js.map

package/dist/tools/getMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessages.js","sourceRoot":"","sources":["../../src/tools/getMessages.ts"],"names":[],"mappings":"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"}

package/dist/tools/getUser.d.ts

@@ -0,0 +1,22 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { GetUserSchema } from "../schemas.js";
+import { type TransformedUser } from "../transformers.js";
+/**
+ * Get information about a user
+ *
+ * Accepts:
+ * - user: User identifier - can be:
+ *   - Numeric ID (e.g., 8572674464)
+ *   - Username (e.g., "@johndoe")
+ *   - Name to search (e.g., "John Doe")
+ *
+ * Returns simplified user info with:
+ * - id: User's numeric ID
+ * - name: Full name
+ * - username: @username if set
+ * - phone: Phone number if visible
+ * - status: Online status (e.g., "online", "last seen 2 hours ago")
+ */
+export declare function getUser(req: Request, args: z.infer<typeof GetUserSchema>): Promise<TransformedUser>;
+//# sourceMappingURL=getUser.d.ts.map

package/dist/tools/getUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUser.d.ts","sourceRoot":"","sources":["../../src/tools/getUser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/tools/getUser.js

@@ -0,0 +1,38 @@
+import { withClient } from "../helpers.js";
+import { resolveUser } from "../resolvers.js";
+import { transformUser } from "../transformers.js";
+/**
+ * Get information about a user
+ *
+ * Accepts:
+ * - user: User identifier - can be:
+ *   - Numeric ID (e.g., 8572674464)
+ *   - Username (e.g., "@johndoe")
+ *   - Name to search (e.g., "John Doe")
+ *
+ * Returns simplified user info with:
+ * - id: User's numeric ID
+ * - name: Full name
+ * - username: @username if set
+ * - phone: Phone number if visible
+ * - status: Online status (e.g., "online", "last seen 2 hours ago")
+ */
+export async function getUser(req, args) {
+    return withClient(req, async (client) => {
+        // Load chats and contacts first to populate user cache
+        await client.invoke({
+            _: "loadChats",
+            chat_list: { _: "chatListMain" },
+            limit: 100,
+        });
+        await client.invoke({ _: "getContacts" });
+        // Resolve user identifier
+        const userId = await resolveUser(client, args.user);
+        const result = await client.invoke({
+            _: "getUser",
+            user_id: userId,
+        });
+        return transformUser(result);
+    });
+}
+//# sourceMappingURL=getUser.js.map

package/dist/tools/getUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUser.js","sourceRoot":"","sources":["../../src/tools/getUser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAY,EACZ,IAAmC;IAEnC,OAAO,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACtC,uDAAuD;QACvD,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,CAAC,EAAE,WAAW;YACd,SAAS,EAAE,EAAE,CAAC,EAAE,cAAc,EAAE;YAChC,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;QAE1C,0BAA0B;QAC1B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACjC,CAAC,EAAE,SAAS;YACZ,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,11 @@
+export { getMe } from "./getMe.js";
+export { getChat } from "./getChat.js";
+export { getMessages } from "./getMessages.js";
+export { sendMessage } from "./sendMessage.js";
+export { getUser } from "./getUser.js";
+export { getContacts } from "./getContacts.js";
+export { getFile } from "./getFile.js";
+export { getGroup } from "./getGroup.js";
+export { getChatMembers } from "./getChatMembers.js";
+export { getMessageContext } from "./getMessageContext.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,12 @@
+// Consolidated MCP Tools (10 tools total)
+export { getMe } from "./getMe.js";
+export { getChat } from "./getChat.js";
+export { getMessages } from "./getMessages.js";
+export { sendMessage } from "./sendMessage.js";
+export { getUser } from "./getUser.js";
+export { getContacts } from "./getContacts.js";
+export { getFile } from "./getFile.js";
+export { getGroup } from "./getGroup.js";
+export { getChatMembers } from "./getChatMembers.js";
+export { getMessageContext } from "./getMessageContext.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/sendMessage.d.ts

@@ -0,0 +1,39 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { SendMessageSchema } from "../schemas.js";
+import { type TransformedMessage } from "../transformers.js";
+type SendMessageResult = TransformedMessage | {
+    forwarded: TransformedMessage[];
+    count: number;
+};
+/**
+ * Send or forward messages to a chat
+ *
+ * Actions:
+ * - action="send" (default): Compose and send a new text message
+ * - action="forward": Forward existing messages from another chat
+ *
+ * Parameters:
+ * - chat: Target chat (ID or name like "Gong Zhe", "Family Group")
+ * - action: "send" | "forward" (default: "send")
+ *
+ * Send action parameters:
+ * - text: Message content
+ * - reply_to_message_id: Optional - reply to specific message
+ *
+ * Forward action parameters:
+ * - from_chat: Source chat to forward from
+ * - message_ids: Array of message IDs to forward
+ * - send_copy: Send as copy without "Forwarded from" header
+ * - remove_caption: Remove media captions when forwarding
+ *
+ * Returns (send):
+ * - The sent message with id, content, date, is_outgoing
+ *
+ * Returns (forward):
+ * - forwarded: Array of forwarded messages
+ * - count: Number of messages forwarded
+ */
+export declare function sendMessage(req: Request, args: z.infer<typeof SendMessageSchema>): Promise<SendMessageResult>;
+export {};
+//# sourceMappingURL=sendMessage.d.ts.map

package/dist/tools/sendMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessage.d.ts","sourceRoot":"","sources":["../../src/tools/sendMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,KAAK,iBAAiB,GAClB,kBAAkB,GAClB;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CA4G5B"}