bn-telegram-mcp-server 0.0.1

package/dist/tools/sendMessage.js

@@ -0,0 +1,116 @@
+import { withClient } from "../helpers.js";
+import { resolveChat } from "../resolvers.js";
+import { transformMessage } from "../transformers.js";
+/**
+ * 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 async function sendMessage(req, args) {
+    return withClient(req, async (client) => {
+        const action = args.action ?? "send";
+        // Load chats first
+        await client.invoke({
+            _: "loadChats",
+            chat_list: { _: "chatListMain" },
+            limit: 100,
+        });
+        // Resolve target chat
+        const toChatId = await resolveChat(client, args.chat);
+        if (action === "forward") {
+            // Forward messages from another chat
+            if (!args.from_chat) {
+                throw new Error('from_chat is required for action="forward". Specify the source chat.');
+            }
+            if (!args.message_ids || args.message_ids.length === 0) {
+                throw new Error('message_ids is required for action="forward". Specify messages to forward.');
+            }
+            const fromChatId = await resolveChat(client, args.from_chat);
+            const result = await client.invoke({
+                _: "forwardMessages",
+                chat_id: toChatId,
+                from_chat_id: fromChatId,
+                message_ids: args.message_ids,
+                send_copy: args.send_copy ?? false,
+                remove_caption: args.remove_caption ?? false,
+            });
+            const messages = result;
+            const forwarded = (messages.messages ?? []).map((m) => transformMessage(m));
+            return {
+                forwarded,
+                count: forwarded.length,
+            };
+        }
+        // Default: send a new message
+        if (!args.text) {
+            throw new Error('text is required for action="send". Provide message content.');
+        }
+        const result = (await client.invoke({
+            _: "sendMessage",
+            chat_id: toChatId,
+            reply_to: args.reply_to_message_id
+                ? {
+                    _: "inputMessageReplyToMessage",
+                    message_id: args.reply_to_message_id,
+                }
+                : undefined,
+            input_message_content: {
+                _: "inputMessageText",
+                text: {
+                    _: "formattedText",
+                    text: args.text,
+                },
+            },
+        }));
+        // Wait for the message to be sent (up to 10 seconds)
+        const sentMessage = await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                reject(new Error("Message send timeout - message may still be sending"));
+            }, 10000);
+            const onUpdate = (update) => {
+                const u = update;
+                if (u._ === "updateMessageSendSucceeded" &&
+                    u.old_message_id === result.id) {
+                    cleanup();
+                    resolve(u.message);
+                }
+                else if (u._ === "updateMessageSendFailed" &&
+                    u.old_message_id === result.id) {
+                    cleanup();
+                    reject(new Error("Failed to send message"));
+                }
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                client.off("update", onUpdate);
+            };
+            client.on("update", onUpdate);
+        });
+        return transformMessage(sentMessage);
+    });
+}
+//# sourceMappingURL=sendMessage.js.map

package/dist/tools/sendMessage.js.map

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

package/dist/transformers.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Output transformers for converting raw TDLib responses to human-friendly formats
+ *
+ * These transform complex nested TDLib objects into simplified, readable structures
+ * that are easier for users and LLMs to understand and work with.
+ */
+/**
+ * Format Unix timestamp to readable date string
+ */
+export declare function formatTimestamp(unix: number): string;
+/**
+ * Format Unix timestamp to relative time (e.g., "2 hours ago")
+ */
+export declare function formatRelativeTime(unix: number): string;
+export interface TransformedUser {
+    id: number;
+    name: string;
+    username?: string;
+    phone?: string;
+    status: string;
+    is_contact: boolean;
+    is_premium: boolean;
+    is_verified: boolean;
+}
+export declare function transformUser(user: unknown): TransformedUser;
+export interface TransformedChat {
+    id: number;
+    title: string;
+    type: string;
+    unread_count: number;
+    last_message?: {
+        preview: string;
+        sender: string;
+        date: string;
+        date_relative: string;
+    };
+    member_count?: number;
+    is_pinned: boolean;
+    is_muted: boolean;
+}
+export declare function transformChat(chat: unknown): TransformedChat;
+export interface TransformedChatList {
+    chats: TransformedChat[];
+    total_count: number;
+    summary: string;
+}
+export declare function transformChatList(chats: unknown[], totalCount: number): TransformedChatList;
+export interface TransformedMessage {
+    id: number;
+    chat_id: number;
+    sender: string;
+    sender_id: number;
+    content: string;
+    content_type: string;
+    date: string;
+    date_relative: string;
+    is_outgoing: boolean;
+    is_pinned: boolean;
+    reply_to_message_id?: number;
+    file_id?: number;
+}
+export declare function transformMessage(message: unknown, userCache?: Map<number, string>): TransformedMessage;
+export interface TransformedMessageHistory {
+    messages: TransformedMessage[];
+    total_count: number;
+    chat_title?: string;
+}
+export declare function transformMessageHistory(messages: unknown[], totalCount: number, chatTitle?: string, userCache?: Map<number, string>): TransformedMessageHistory;
+export interface TransformedContact {
+    id: number;
+    name: string;
+    username?: string;
+    phone?: string;
+    status: string;
+}
+export declare function transformContacts(users: unknown[]): TransformedContact[];
+export interface TransformedGroup {
+    id: number;
+    name: string;
+    type: "basic_group" | "supergroup" | "channel";
+    member_count: number;
+    description?: string;
+    is_verified?: boolean;
+    is_scam?: boolean;
+    join_date?: string;
+}
+export declare function transformBasicGroup(group: unknown, chatInfo?: unknown): TransformedGroup;
+export declare function transformSupergroup(group: unknown, chatInfo?: unknown): TransformedGroup;
+export interface TransformedMember {
+    user_id: number;
+    name: string;
+    username?: string;
+    status: string;
+    role: string;
+    joined_date?: string;
+}
+export declare function transformMembers(members: unknown[], userCache?: Map<number, {
+    name: string;
+    username?: string;
+}>): TransformedMember[];
+export interface TransformedFile {
+    id: number;
+    size: string;
+    size_bytes: number;
+    remote_id?: string;
+}
+export declare function transformFile(file: unknown): TransformedFile;
+export interface TransformedSearchResult {
+    messages: TransformedMessage[];
+    total_count: number;
+    next_offset?: string;
+    search_query: string;
+}
+export declare function transformSearchResults(result: unknown, query: string, userCache?: Map<number, string>): TransformedSearchResult;
+export interface TransformedMessageWithContext extends TransformedMessage {
+    is_target: boolean;
+}
+export interface TransformedMessageContext {
+    messages: TransformedMessageWithContext[];
+    target_message_id: number;
+    context_count: number;
+    chat_id: number;
+    chat_title?: string;
+}
+export interface TransformedMessageContextResult {
+    contexts: TransformedMessageContext[];
+    total_matches: number;
+    search_query?: string;
+    summary: string;
+}
+export declare function transformMessageContext(targetMessage: unknown, messagesBefore: unknown[], messagesAfter: unknown[], contextCount: number, chatId: number, chatTitle?: string, userCache?: Map<number, string>): TransformedMessageContext;
+export declare function transformMessageContextResult(contexts: TransformedMessageContext[], totalMatches: number, searchQuery?: string): TransformedMessageContextResult;
+//# sourceMappingURL=transformers.d.ts.map

package/dist/transformers.d.ts.map

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

package/dist/transformers.js

@@ -0,0 +1,335 @@
+/**
+ * Output transformers for converting raw TDLib responses to human-friendly formats
+ *
+ * These transform complex nested TDLib objects into simplified, readable structures
+ * that are easier for users and LLMs to understand and work with.
+ */
+// ==================== Helper Functions ====================
+/**
+ * Format Unix timestamp to readable date string
+ */
+export function formatTimestamp(unix) {
+    if (!unix || unix === 0)
+        return "";
+    const date = new Date(unix * 1000);
+    return date.toISOString();
+}
+/**
+ * Format Unix timestamp to relative time (e.g., "2 hours ago")
+ */
+export function formatRelativeTime(unix) {
+    if (!unix || unix === 0)
+        return "";
+    const now = Date.now();
+    const diff = now - unix * 1000;
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days} day${days > 1 ? "s" : ""} ago`;
+    if (hours > 0)
+        return `${hours} hour${hours > 1 ? "s" : ""} ago`;
+    if (minutes > 0)
+        return `${minutes} minute${minutes > 1 ? "s" : ""} ago`;
+    return "just now";
+}
+/**
+ * Extract text content from a message
+ */
+function extractMessageText(content) {
+    const c = content;
+    if (!c)
+        return "";
+    switch (c._) {
+        case "messageText":
+            return c.text?.text ?? "";
+        case "messagePhoto":
+            return c.caption?.text ? `[Photo] ${c.caption.text}` : "[Photo]";
+        case "messageVideo":
+            return c.caption?.text ? `[Video] ${c.caption.text}` : "[Video]";
+        case "messageDocument":
+            return c.caption?.text ? `[Document] ${c.caption.text}` : "[Document]";
+        case "messageAudio":
+            return c.caption?.text ? `[Audio] ${c.caption.text}` : "[Audio]";
+        case "messageVoiceNote":
+            return "[Voice message]";
+        case "messageVideoNote":
+            return "[Video message]";
+        case "messageSticker":
+            return "[Sticker]";
+        case "messageAnimation":
+            return "[GIF]";
+        case "messageLocation":
+            return "[Location]";
+        case "messageContact":
+            return "[Contact]";
+        case "messagePoll":
+            return "[Poll]";
+        default:
+            return `[${c._?.replace("message", "") ?? "Unknown"}]`;
+    }
+}
+/**
+ * Get chat type as human-readable string
+ */
+function getChatTypeString(type) {
+    const t = type;
+    if (!t?._)
+        return "unknown";
+    switch (t._) {
+        case "chatTypePrivate":
+            return "private";
+        case "chatTypeBasicGroup":
+            return "group";
+        case "chatTypeSupergroup":
+            return t.is_channel ? "channel" : "supergroup";
+        case "chatTypeSecret":
+            return "secret";
+        default:
+            return t._.replace("chatType", "").toLowerCase();
+    }
+}
+/**
+ * Get user status as human-readable string
+ */
+function getUserStatusString(status) {
+    const s = status;
+    if (!s?._)
+        return "unknown";
+    switch (s._) {
+        case "userStatusOnline":
+            return "online";
+        case "userStatusOffline":
+            return s.was_online ? `last seen ${formatRelativeTime(s.was_online)}` : "offline";
+        case "userStatusRecently":
+            return "last seen recently";
+        case "userStatusLastWeek":
+            return "last seen within a week";
+        case "userStatusLastMonth":
+            return "last seen within a month";
+        case "userStatusEmpty":
+            return "unknown";
+        default:
+            return s._.replace("userStatus", "").toLowerCase();
+    }
+}
+export function transformUser(user) {
+    const u = user;
+    return {
+        id: u.id,
+        name: `${u.first_name ?? ""} ${u.last_name ?? ""}`.trim() || "Unknown",
+        username: u.usernames?.active_usernames?.[0],
+        phone: u.phone_number,
+        status: getUserStatusString(u.status),
+        is_contact: u.is_contact ?? false,
+        is_premium: u.is_premium ?? false,
+        is_verified: u.is_verified ?? false,
+    };
+}
+export function transformChat(chat) {
+    const c = chat;
+    const lastMsg = c.last_message;
+    let senderName = "Unknown";
+    if (lastMsg?.sender_id) {
+        if (lastMsg.sender_id._ === "messageSenderUser") {
+            senderName = `User ${lastMsg.sender_id.user_id}`;
+        }
+        else if (lastMsg.sender_id._ === "messageSenderChat") {
+            senderName = "Channel";
+        }
+    }
+    return {
+        id: c.id,
+        title: c.title,
+        type: getChatTypeString(c.type),
+        unread_count: c.unread_count ?? 0,
+        last_message: lastMsg
+            ? {
+                preview: extractMessageText(lastMsg.content).substring(0, 100),
+                sender: senderName,
+                date: formatTimestamp(lastMsg.date ?? 0),
+                date_relative: formatRelativeTime(lastMsg.date ?? 0),
+            }
+            : undefined,
+        is_pinned: c.positions?.[0]?.is_pinned ?? false,
+        is_muted: (c.notification_settings?.mute_for ?? 0) > 0,
+    };
+}
+export function transformChatList(chats, totalCount) {
+    const transformed = chats.map(transformChat);
+    const unreadCount = transformed.reduce((sum, c) => sum + c.unread_count, 0);
+    return {
+        chats: transformed,
+        total_count: totalCount,
+        summary: `${transformed.length} chats loaded, ${unreadCount} unread messages`,
+    };
+}
+export function transformMessage(message, userCache) {
+    const m = message;
+    let senderName = "Unknown";
+    let senderId = 0;
+    if (m.sender_id) {
+        if (m.sender_id._ === "messageSenderUser" && m.sender_id.user_id) {
+            senderId = m.sender_id.user_id;
+            senderName = userCache?.get(senderId) ?? `User ${senderId}`;
+        }
+        else if (m.sender_id._ === "messageSenderChat" && m.sender_id.chat_id) {
+            senderId = m.sender_id.chat_id;
+            senderName = "Channel";
+        }
+    }
+    // Extract file_id if present
+    const content = m.content;
+    let fileId;
+    if (content?.photo?.sizes) {
+        const lastSize = content.photo.sizes[content.photo.sizes.length - 1];
+        fileId = lastSize?.photo?.id;
+    }
+    else if (content?.document?.document?.id) {
+        fileId = content.document.document.id;
+    }
+    else if (content?.video?.video?.id) {
+        fileId = content.video.video.id;
+    }
+    else if (content?.audio?.audio?.id) {
+        fileId = content.audio.audio.id;
+    }
+    return {
+        id: m.id,
+        chat_id: m.chat_id,
+        sender: senderName,
+        sender_id: senderId,
+        content: extractMessageText(m.content),
+        content_type: m.content?._?.replace("message", "") ?? "unknown",
+        date: formatTimestamp(m.date ?? 0),
+        date_relative: formatRelativeTime(m.date ?? 0),
+        is_outgoing: m.is_outgoing ?? false,
+        is_pinned: m.is_pinned ?? false,
+        reply_to_message_id: m.reply_to?.message_id,
+        file_id: fileId,
+    };
+}
+export function transformMessageHistory(messages, totalCount, chatTitle, userCache) {
+    return {
+        messages: messages.map((m) => transformMessage(m, userCache)),
+        total_count: totalCount,
+        chat_title: chatTitle,
+    };
+}
+export function transformContacts(users) {
+    return users.map((user) => {
+        const u = transformUser(user);
+        return {
+            id: u.id,
+            name: u.name,
+            username: u.username,
+            phone: u.phone,
+            status: u.status,
+        };
+    });
+}
+export function transformBasicGroup(group, chatInfo) {
+    const g = group;
+    const c = chatInfo;
+    return {
+        id: g.id,
+        name: c?.title ?? `Group ${g.id}`,
+        type: "basic_group",
+        member_count: g.member_count ?? 0,
+        join_date: g.status?.joined_chat_date
+            ? formatTimestamp(g.status.joined_chat_date)
+            : undefined,
+    };
+}
+export function transformSupergroup(group, chatInfo) {
+    const g = group;
+    const c = chatInfo;
+    return {
+        id: g.id,
+        name: c?.title ?? `${g.is_channel ? "Channel" : "Supergroup"} ${g.id}`,
+        type: g.is_channel ? "channel" : "supergroup",
+        member_count: g.member_count ?? 0,
+        is_verified: g.is_verified,
+        is_scam: g.is_scam,
+        join_date: g.date ? formatTimestamp(g.date) : undefined,
+    };
+}
+export function transformMembers(members, userCache) {
+    return members.map((member) => {
+        const m = member;
+        const userId = m.member_id?.user_id ?? 0;
+        const userInfo = userCache?.get(userId);
+        const statusType = m.status?._?.replace("chatMemberStatus", "") ?? "Member";
+        return {
+            user_id: userId,
+            name: userInfo?.name ?? `User ${userId}`,
+            username: userInfo?.username,
+            status: "member",
+            role: statusType.toLowerCase(),
+            joined_date: m.status?.joined_chat_date
+                ? formatTimestamp(m.status.joined_chat_date)
+                : undefined,
+        };
+    });
+}
+export function transformFile(file) {
+    const f = file;
+    const sizeBytes = f.size ?? f.expected_size ?? 0;
+    let sizeStr;
+    if (sizeBytes >= 1024 * 1024 * 1024) {
+        sizeStr = `${(sizeBytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+    }
+    else if (sizeBytes >= 1024 * 1024) {
+        sizeStr = `${(sizeBytes / (1024 * 1024)).toFixed(2)} MB`;
+    }
+    else if (sizeBytes >= 1024) {
+        sizeStr = `${(sizeBytes / 1024).toFixed(2)} KB`;
+    }
+    else {
+        sizeStr = `${sizeBytes} bytes`;
+    }
+    return {
+        id: f.id,
+        size: sizeStr,
+        size_bytes: sizeBytes,
+        remote_id: f.remote?.id,
+    };
+}
+export function transformSearchResults(result, query, userCache) {
+    const r = result;
+    return {
+        messages: (r.messages ?? []).map((m) => transformMessage(m, userCache)),
+        total_count: r.total_count ?? 0,
+        next_offset: r.next_offset,
+        search_query: query,
+    };
+}
+export function transformMessageContext(targetMessage, messagesBefore, messagesAfter, contextCount, chatId, chatTitle, userCache) {
+    const targetMsg = transformMessage(targetMessage, userCache);
+    // Build single chronological array: before -> target -> after
+    const messages = [
+        ...messagesBefore.map((m) => ({ ...transformMessage(m, userCache), is_target: false })),
+        { ...targetMsg, is_target: true },
+        ...messagesAfter.map((m) => ({ ...transformMessage(m, userCache), is_target: false })),
+    ];
+    return {
+        messages,
+        target_message_id: targetMsg.id,
+        context_count: contextCount,
+        chat_id: chatId,
+        chat_title: chatTitle,
+    };
+}
+export function transformMessageContextResult(contexts, totalMatches, searchQuery) {
+    const totalMessages = contexts.reduce((sum, ctx) => sum + ctx.messages.length, 0);
+    return {
+        contexts,
+        total_matches: totalMatches,
+        search_query: searchQuery,
+        summary: searchQuery
+            ? `Found ${totalMatches} match(es) for "${searchQuery}", showing context for ${contexts.length} result(s) (${totalMessages} total messages)`
+            : `Showing context for ${contexts.length} message(s) (${totalMessages} total messages)`,
+    };
+}
+//# sourceMappingURL=transformers.js.map

package/dist/transformers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.js","sourceRoot":"","sources":["../src/transformers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6DAA6D;AAE7D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAC7D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACjE,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,UAAU,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAgB;IAC1C,MAAM,CAAC,GAAG,OAAgF,CAAC;IAC3F,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,KAAK,aAAa;YAChB,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,KAAK,iBAAiB;YACpB,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;QACzE,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,KAAK,kBAAkB;YACrB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,kBAAkB;YACrB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,gBAAgB;YACnB,OAAO,WAAW,CAAC;QACrB,KAAK,kBAAkB;YACrB,OAAO,OAAO,CAAC;QACjB,KAAK,iBAAiB;YACpB,OAAO,YAAY,CAAC;QACtB,KAAK,gBAAgB;YACnB,OAAO,WAAW,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,GAAG,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAa;IACtC,MAAM,CAAC,GAAG,IAA4C,CAAC;IACvD,IAAI,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5B,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;QACnB,KAAK,oBAAoB;YACvB,OAAO,OAAO,CAAC;QACjB,KAAK,oBAAoB;YACvB,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;QACjD,KAAK,gBAAgB;YACnB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAe;IAC1C,MAAM,CAAC,GAAG,MAA6C,CAAC;IACxD,IAAI,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5B,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,KAAK,kBAAkB;YACrB,OAAO,QAAQ,CAAC;QAClB,KAAK,mBAAmB;YACtB,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,KAAK,oBAAoB;YACvB,OAAO,oBAAoB,CAAC;QAC9B,KAAK,oBAAoB;YACvB,OAAO,yBAAyB,CAAC;QACnC,KAAK,qBAAqB;YACxB,OAAO,0BAA0B,CAAC;QACpC,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAeD,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,CAAC,GAAG,IAUT,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS;QACtE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAC5C,KAAK,EAAE,CAAC,CAAC,YAAY;QACrB,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,KAAK;QACjC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,KAAK;QACjC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,KAAK;KACpC,CAAC;AACJ,CAAC;AAoBD,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,CAAC,GAAG,IAYT,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/B,IAAI,UAAU,GAAG,SAAS,CAAC;IAC3B,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,mBAAmB,EAAE,CAAC;YAChD,UAAU,GAAG,QAAQ,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACnD,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,mBAAmB,EAAE,CAAC;YACvD,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/B,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;QACjC,YAAY,EAAE,OAAO;YACnB,CAAC,CAAC;gBACE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9D,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;gBACxC,aAAa,EAAE,kBAAkB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;aACrD;YACH,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,KAAK;QAC/C,QAAQ,EAAE,CAAC,CAAC,CAAC,qBAAqB,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;KACvD,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAC/B,KAAgB,EAChB,UAAkB;IAElB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAE5E,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,kBAAkB,WAAW,kBAAkB;KAC9E,CAAC;AACJ,CAAC;AAmBD,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,SAA+B;IAE/B,MAAM,CAAC,GAAG,OAST,CAAC;IAEF,IAAI,UAAU,GAAG,SAAS,CAAC;IAC3B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,mBAAmB,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACjE,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC/B,UAAU,GAAG,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,QAAQ,EAAE,CAAC;QAC9D,CAAC;aAAM,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,mBAAmB,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACxE,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC/B,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,CAAC,CAAC,OAA0L,CAAC;IAC7M,IAAI,MAA0B,CAAC;IAC/B,IAAI,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC;SAAM,IAAI,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxC,CAAC;SAAM,IAAI,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAClC,CAAC;SAAM,IAAI,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAClC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;QACtC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS;QAC/D,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAClC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9C,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,KAAK;QACnC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK;QAC/B,mBAAmB,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU;QAC3C,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,uBAAuB,CACrC,QAAmB,EACnB,UAAkB,EAClB,SAAkB,EAClB,SAA+B;IAE/B,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7D,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAeD,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,QAAkB;IACpE,MAAM,CAAC,GAAG,KAIT,CAAC;IACF,MAAM,CAAC,GAAG,QAA8B,CAAC;IAEzC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC,CAAC,EAAE,EAAE;QACjC,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;QACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB;YACnC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC5C,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,QAAkB;IAElB,MAAM,CAAC,GAAG,KAOT,CAAC;IACF,MAAM,CAAC,GAAG,QAA8B,CAAC;IAEzC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,EAAE;QACtE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;QAC7C,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;QACjC,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACxD,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,gBAAgB,CAC9B,OAAkB,EAClB,SAA4D;IAE5D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,MAGT,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC;QAE5E,OAAO;YACL,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,QAAQ,MAAM,EAAE;YACxC,QAAQ,EAAE,QAAQ,EAAE,QAAQ;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE;YAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB;gBACrC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBAC5C,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAWD,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,CAAC,GAAG,IAKT,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC;IACjD,IAAI,OAAe,CAAC;IACpB,IAAI,SAAS,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QACpC,OAAO,GAAG,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,CAAC;SAAM,IAAI,SAAS,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QACpC,OAAO,GAAG,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3D,CAAC;SAAM,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,OAAO,GAAG,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,GAAG,SAAS,QAAQ,CAAC;IACjC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;KACxB,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,KAAa,EACb,SAA+B;IAE/B,MAAM,CAAC,GAAG,MAIT,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC;QAC/B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC;AAuBD,MAAM,UAAU,uBAAuB,CACrC,aAAsB,EACtB,cAAyB,EACzB,aAAwB,EACxB,YAAoB,EACpB,MAAc,EACd,SAAkB,EAClB,SAA+B;IAE/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAE7D,8DAA8D;IAC9D,MAAM,QAAQ,GAAoC;QAChD,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACvF,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;QACjC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;KACvF,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,iBAAiB,EAAE,SAAS,CAAC,EAAE;QAC/B,aAAa,EAAE,YAAY;QAC3B,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAAqC,EACrC,YAAoB,EACpB,WAAoB;IAEpB,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAElF,OAAO;QACL,QAAQ;QACR,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,WAAW;QACzB,OAAO,EAAE,WAAW;YAClB,CAAC,CAAC,SAAS,YAAY,mBAAmB,WAAW,0BAA0B,QAAQ,CAAC,MAAM,eAAe,aAAa,kBAAkB;YAC5I,CAAC,CAAC,uBAAuB,QAAQ,CAAC,MAAM,gBAAgB,aAAa,kBAAkB;KAC1F,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export interface DebugMetadata {
+    toolName: string;
+    toolInput: unknown;
+    toolCallTime: number;
+    timestamp: string;
+}
+export interface ToolResponse<T = unknown> {
+    data: T;
+    debug?: DebugMetadata;
+}
+/**
+ * TDLib response types
+ *
+ * Note: These are simplified types that don't try to match TDLib's exact types.
+ * TDLib responses are complex and version-dependent. We use these as documentation
+ * of expected structure, but cast through `unknown` when needed.
+ */
+export interface TDLibObject {
+    _: string;
+    [key: string]: unknown;
+}
+export type TelegramUser = TDLibObject & {
+    _: "user";
+    id: number;
+    first_name: string;
+    last_name?: string;
+};
+export type TelegramFile = TDLibObject & {
+    _: "file";
+    id: number;
+    size?: number;
+    expected_size?: number;
+};
+export type TelegramChat = TDLibObject & {
+    _: "chat";
+    id: number;
+    title: string;
+};
+export type TelegramMessage = TDLibObject & {
+    _: "message";
+    id: number;
+    chat_id: number;
+    date: number;
+};
+export type TelegramChats = TDLibObject & {
+    _: "chats";
+    total_count: number;
+    chat_ids: number[];
+};
+export type TelegramUsers = TDLibObject & {
+    _: "users";
+    total_count: number;
+    user_ids: number[];
+};
+//# sourceMappingURL=types.d.ts.map