@framers/agentos-ext-telegram 1.1.0

package/dist/services/telegramBot.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Telegram Bot Service
+ * Manages the Telegram bot connection and provides API methods
+ */
+import TelegramBot from 'node-telegram-bot-api';
+/**
+ * Configuration for the Telegram bot service
+ */
+export interface TelegramConfig {
+    botToken: string;
+    webhookUrl?: string;
+    pollingInterval?: number;
+    defaultParseMode: 'Markdown' | 'HTML';
+    enableTypingAction: boolean;
+    rateLimit: {
+        maxRequests: number;
+        windowMs: number;
+    };
+}
+/**
+ * Message sending options
+ */
+export interface SendMessageOptions {
+    chatId: string | number;
+    text: string;
+    parseMode?: 'Markdown' | 'HTML';
+    replyToMessageId?: number;
+    disableNotification?: boolean;
+    replyMarkup?: any;
+}
+/**
+ * Service for interacting with Telegram Bot API
+ *
+ * @class TelegramBotService
+ */
+export declare class TelegramBotService {
+    private bot;
+    private config;
+    private rateLimitState;
+    private messageQueue;
+    private isProcessingQueue;
+    /**
+     * Creates an instance of TelegramBotService
+     * @param {TelegramConfig} config - Service configuration
+     */
+    constructor(config: TelegramConfig);
+    /**
+     * Initializes the bot connection
+     */
+    initialize(): Promise<void>;
+    /**
+     * Checks and enforces rate limiting
+     *
+     * @private
+     * @param {string} key - Rate limit key (usually chatId)
+     * @returns {Promise<boolean>} True if within limits
+     */
+    private checkRateLimit;
+    /**
+     * Queues an API call with rate limiting
+     *
+     * @private
+     * @param {Function} fn - Function to execute
+     * @returns {Promise<T>} Result of the function
+     */
+    private queueApiCall;
+    /**
+     * Processes the message queue
+     *
+     * @private
+     */
+    private processQueue;
+    /**
+     * Sends a text message
+     *
+     * @param {SendMessageOptions} options - Message options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    sendMessage(options: SendMessageOptions): Promise<TelegramBot.Message>;
+    /**
+     * Sends a photo
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {string | Buffer} photo - Photo URL or buffer
+     * @param {Object} options - Additional options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    sendPhoto(chatId: string | number, photo: string | Buffer, options?: {
+        caption?: string;
+        parseMode?: 'Markdown' | 'HTML';
+        replyToMessageId?: number;
+    }): Promise<TelegramBot.Message>;
+    /**
+     * Sends a document
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {string | Buffer} document - Document URL or buffer
+     * @param {Object} options - Additional options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    sendDocument(chatId: string | number, document: string | Buffer, options?: {
+        caption?: string;
+        parseMode?: 'Markdown' | 'HTML';
+        replyToMessageId?: number;
+        filename?: string;
+    }): Promise<TelegramBot.Message>;
+    /**
+     * Gets chat information
+     *
+     * @param {string | number} chatId - Chat ID
+     * @returns {Promise<TelegramBot.Chat>} Chat information
+     */
+    getChatInfo(chatId: string | number): Promise<TelegramBot.Chat>;
+    /**
+     * Gets chat member count
+     *
+     * @param {string | number} chatId - Chat ID
+     * @returns {Promise<number>} Member count
+     */
+    getChatMemberCount(chatId: string | number): Promise<number>;
+    /**
+     * Pins a message in a chat
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {number} messageId - Message ID to pin
+     * @param {boolean} disableNotification - Disable notification
+     * @returns {Promise<boolean>} Success status
+     */
+    pinMessage(chatId: string | number, messageId: number, disableNotification?: boolean): Promise<boolean>;
+    /**
+     * Answers a callback query
+     *
+     * @param {string} callbackQueryId - Callback query ID
+     * @param {Object} options - Answer options
+     * @returns {Promise<boolean>} Success status
+     */
+    answerCallbackQuery(callbackQueryId: string, options?: {
+        text?: string;
+        showAlert?: boolean;
+        url?: string;
+        cacheTime?: number;
+    }): Promise<boolean>;
+    /**
+     * Registers a message handler
+     *
+     * @param {RegExp | string} pattern - Message pattern to match
+     * @param {Function} handler - Handler function
+     */
+    onMessage(pattern: RegExp | string, handler: (msg: TelegramBot.Message) => void): void;
+    /**
+     * Registers a callback query handler
+     *
+     * @param {Function} handler - Handler function
+     */
+    onCallbackQuery(handler: (query: TelegramBot.CallbackQuery) => void): void;
+    /**
+     * Gets the bot instance for advanced operations
+     *
+     * @returns {TelegramBot | null} The bot instance
+     */
+    getBotInstance(): TelegramBot | null;
+    /**
+     * Shuts down the bot connection
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=telegramBot.d.ts.map

package/dist/services/telegramBot.d.ts.map

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

package/dist/services/telegramBot.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * Telegram Bot Service
+ * Manages the Telegram bot connection and provides API methods
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramBotService = void 0;
+const node_telegram_bot_api_1 = __importDefault(require("node-telegram-bot-api"));
+/**
+ * Service for interacting with Telegram Bot API
+ *
+ * @class TelegramBotService
+ */
+class TelegramBotService {
+    /**
+     * Creates an instance of TelegramBotService
+     * @param {TelegramConfig} config - Service configuration
+     */
+    constructor(config) {
+        this.bot = null;
+        this.messageQueue = [];
+        this.isProcessingQueue = false;
+        this.config = config;
+        this.rateLimitState = new Map();
+    }
+    /**
+     * Initializes the bot connection
+     */
+    async initialize() {
+        if (this.bot) {
+            return; // Already initialized
+        }
+        const options = {
+            polling: !this.config.webhookUrl,
+            webHook: this.config.webhookUrl ? true : false
+        };
+        if (options.polling) {
+            options.polling = {
+                interval: this.config.pollingInterval || 300,
+                autoStart: true,
+                params: {
+                    timeout: 10
+                }
+            };
+        }
+        this.bot = new node_telegram_bot_api_1.default(this.config.botToken, options);
+        if (this.config.webhookUrl) {
+            await this.bot.setWebHook(this.config.webhookUrl);
+        }
+        // Set up error handling
+        this.bot.on('error', (error) => {
+            console.error('Telegram Bot Error:', error);
+        });
+        this.bot.on('polling_error', (error) => {
+            console.error('Telegram Polling Error:', error);
+        });
+    }
+    /**
+     * Checks and enforces rate limiting
+     *
+     * @private
+     * @param {string} key - Rate limit key (usually chatId)
+     * @returns {Promise<boolean>} True if within limits
+     */
+    async checkRateLimit(key = 'global') {
+        const now = Date.now();
+        const state = this.rateLimitState.get(key);
+        if (!state || now > state.resetTime) {
+            this.rateLimitState.set(key, {
+                count: 1,
+                resetTime: now + this.config.rateLimit.windowMs
+            });
+            return true;
+        }
+        if (state.count >= this.config.rateLimit.maxRequests) {
+            // Wait until reset time
+            const waitTime = state.resetTime - now;
+            if (waitTime > 0) {
+                await new Promise(resolve => setTimeout(resolve, waitTime));
+                return this.checkRateLimit(key);
+            }
+        }
+        state.count++;
+        return true;
+    }
+    /**
+     * Queues an API call with rate limiting
+     *
+     * @private
+     * @param {Function} fn - Function to execute
+     * @returns {Promise<T>} Result of the function
+     */
+    async queueApiCall(fn) {
+        return new Promise((resolve, reject) => {
+            this.messageQueue.push(async () => {
+                try {
+                    const result = await fn();
+                    resolve(result);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+            this.processQueue();
+        });
+    }
+    /**
+     * Processes the message queue
+     *
+     * @private
+     */
+    async processQueue() {
+        if (this.isProcessingQueue || this.messageQueue.length === 0) {
+            return;
+        }
+        this.isProcessingQueue = true;
+        while (this.messageQueue.length > 0) {
+            await this.checkRateLimit();
+            const task = this.messageQueue.shift();
+            if (task) {
+                await task();
+            }
+        }
+        this.isProcessingQueue = false;
+    }
+    /**
+     * Sends a text message
+     *
+     * @param {SendMessageOptions} options - Message options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    async sendMessage(options) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.queueApiCall(async () => {
+            if (this.config.enableTypingAction) {
+                await this.bot.sendChatAction(options.chatId, 'typing');
+            }
+            return this.bot.sendMessage(options.chatId, options.text, {
+                parse_mode: options.parseMode || this.config.defaultParseMode,
+                reply_to_message_id: options.replyToMessageId,
+                disable_notification: options.disableNotification,
+                reply_markup: options.replyMarkup
+            });
+        });
+    }
+    /**
+     * Sends a photo
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {string | Buffer} photo - Photo URL or buffer
+     * @param {Object} options - Additional options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    async sendPhoto(chatId, photo, options = {}) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.queueApiCall(async () => {
+            if (this.config.enableTypingAction) {
+                await this.bot.sendChatAction(chatId, 'upload_photo');
+            }
+            return this.bot.sendPhoto(chatId, photo, {
+                caption: options.caption,
+                parse_mode: options.parseMode || this.config.defaultParseMode,
+                reply_to_message_id: options.replyToMessageId
+            });
+        });
+    }
+    /**
+     * Sends a document
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {string | Buffer} document - Document URL or buffer
+     * @param {Object} options - Additional options
+     * @returns {Promise<TelegramBot.Message>} Sent message
+     */
+    async sendDocument(chatId, document, options = {}) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.queueApiCall(async () => {
+            if (this.config.enableTypingAction) {
+                await this.bot.sendChatAction(chatId, 'upload_document');
+            }
+            const sendOptions = {
+                caption: options.caption,
+                parse_mode: options.parseMode || this.config.defaultParseMode,
+                reply_to_message_id: options.replyToMessageId
+            };
+            if (options.filename && Buffer.isBuffer(document)) {
+                return this.bot.sendDocument(chatId, document, sendOptions, {
+                    filename: options.filename,
+                    contentType: 'application/octet-stream'
+                });
+            }
+            return this.bot.sendDocument(chatId, document, sendOptions);
+        });
+    }
+    /**
+     * Gets chat information
+     *
+     * @param {string | number} chatId - Chat ID
+     * @returns {Promise<TelegramBot.Chat>} Chat information
+     */
+    async getChatInfo(chatId) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.bot.getChat(chatId);
+    }
+    /**
+     * Gets chat member count
+     *
+     * @param {string | number} chatId - Chat ID
+     * @returns {Promise<number>} Member count
+     */
+    async getChatMemberCount(chatId) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.bot.getChatMemberCount(chatId);
+    }
+    /**
+     * Pins a message in a chat
+     *
+     * @param {string | number} chatId - Chat ID
+     * @param {number} messageId - Message ID to pin
+     * @param {boolean} disableNotification - Disable notification
+     * @returns {Promise<boolean>} Success status
+     */
+    async pinMessage(chatId, messageId, disableNotification = false) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.bot.pinChatMessage(chatId, messageId, { disable_notification: disableNotification });
+    }
+    /**
+     * Answers a callback query
+     *
+     * @param {string} callbackQueryId - Callback query ID
+     * @param {Object} options - Answer options
+     * @returns {Promise<boolean>} Success status
+     */
+    async answerCallbackQuery(callbackQueryId, options = {}) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        return this.bot.answerCallbackQuery(callbackQueryId, options);
+    }
+    /**
+     * Registers a message handler
+     *
+     * @param {RegExp | string} pattern - Message pattern to match
+     * @param {Function} handler - Handler function
+     */
+    onMessage(pattern, handler) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        this.bot.onText(pattern instanceof RegExp ? pattern : new RegExp(pattern), handler);
+    }
+    /**
+     * Registers a callback query handler
+     *
+     * @param {Function} handler - Handler function
+     */
+    onCallbackQuery(handler) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        this.bot.on('callback_query', handler);
+    }
+    /**
+     * Gets the bot instance for advanced operations
+     *
+     * @returns {TelegramBot | null} The bot instance
+     */
+    getBotInstance() {
+        return this.bot;
+    }
+    /**
+     * Shuts down the bot connection
+     */
+    async shutdown() {
+        if (this.bot) {
+            if (this.config.webhookUrl) {
+                await this.bot.deleteWebHook();
+            }
+            else {
+                this.bot.stopPolling();
+            }
+            this.bot = null;
+        }
+    }
+}
+exports.TelegramBotService = TelegramBotService;
+//# sourceMappingURL=telegramBot.js.map

package/dist/services/telegramBot.js.map

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

package/dist/tools/getChatInfo.d.ts

@@ -0,0 +1,77 @@
+import { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import { TelegramBotService } from '../services/telegramBot';
+/**
+ * Tool for getting Telegram chat information
+ *
+ * @class GetChatInfoTool
+ * @implements {ITool}
+ */
+export declare class GetChatInfoTool implements ITool {
+    private telegramService;
+    readonly id = "telegramGetChatInfo";
+    readonly name = "telegramGetChatInfo";
+    readonly displayName = "Get Telegram Chat Info";
+    readonly description = "Retrieve information about a Telegram chat including type, title, member count, and settings.";
+    readonly category = "communication";
+    readonly version = "1.0.0";
+    readonly hasSideEffects = false;
+    readonly inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            chatId: {
+                type: string[];
+                description: string;
+            };
+            includeMemberCount: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: string;
+        properties: {
+            id: {
+                type: string[];
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            username: {
+                type: string;
+                description: string;
+            };
+            firstName: {
+                type: string;
+                description: string;
+            };
+            lastName: {
+                type: string;
+                description: string;
+            };
+            memberCount: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(telegramService: TelegramBotService);
+    execute(args: {
+        chatId: string | number;
+        includeMemberCount?: boolean;
+    }, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    validateArgs(args: Record<string, any>): {
+        isValid: boolean;
+        errors?: string[];
+    };
+}
+//# sourceMappingURL=getChatInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getChatInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getChatInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,KAAK;IA4D/B,OAAO,CAAC,eAAe;IA3DnC,SAAgB,EAAE,yBAAyB;IAC3C,SAAgB,IAAI,yBAAyB;IAC7C,SAAgB,WAAW,4BAA4B;IACvD,SAAgB,WAAW,mGAAmG;IAC9H,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,SAAS;IAEvC,SAAgB,WAAW;;;;;;;;;;;;;;MAczB;IAEF,SAAgB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiC1B;gBAEkB,eAAe,EAAE,kBAAkB;IAEjD,OAAO,CACX,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,EACD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAuC/B,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAYjF"}

package/dist/tools/getChatInfo.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetChatInfoTool = void 0;
+/**
+ * Tool for getting Telegram chat information
+ *
+ * @class GetChatInfoTool
+ * @implements {ITool}
+ */
+class GetChatInfoTool {
+    constructor(telegramService) {
+        this.telegramService = telegramService;
+        this.id = 'telegramGetChatInfo';
+        this.name = 'telegramGetChatInfo';
+        this.displayName = 'Get Telegram Chat Info';
+        this.description = 'Retrieve information about a Telegram chat including type, title, member count, and settings.';
+        this.category = 'communication';
+        this.version = '1.0.0';
+        this.hasSideEffects = false;
+        this.inputSchema = {
+            type: 'object',
+            required: ['chatId'],
+            properties: {
+                chatId: {
+                    type: ['string', 'number'],
+                    description: 'Unique identifier for the target chat or username of the target channel'
+                },
+                includeMemberCount: {
+                    type: 'boolean',
+                    description: 'Whether to include member count (requires additional API call)',
+                    default: false
+                }
+            }
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                id: {
+                    type: ['string', 'number'],
+                    description: 'Unique chat identifier'
+                },
+                type: {
+                    type: 'string',
+                    enum: ['private', 'group', 'supergroup', 'channel'],
+                    description: 'Type of chat'
+                },
+                title: {
+                    type: 'string',
+                    description: 'Title for groups/channels'
+                },
+                username: {
+                    type: 'string',
+                    description: 'Username for private chats and channels'
+                },
+                firstName: {
+                    type: 'string',
+                    description: 'First name for private chats'
+                },
+                lastName: {
+                    type: 'string',
+                    description: 'Last name for private chats'
+                },
+                memberCount: {
+                    type: 'number',
+                    description: 'Number of members (if requested)'
+                }
+            }
+        };
+    }
+    async execute(args, context) {
+        try {
+            const chatInfo = await this.telegramService.getChatInfo(args.chatId);
+            const output = {
+                id: chatInfo.id,
+                type: chatInfo.type,
+                title: chatInfo.title,
+                username: chatInfo.username,
+                firstName: chatInfo.first_name,
+                lastName: chatInfo.last_name
+            };
+            if (args.includeMemberCount && ['group', 'supergroup', 'channel'].includes(chatInfo.type)) {
+                try {
+                    const memberCount = await this.telegramService.getChatMemberCount(args.chatId);
+                    output.memberCount = memberCount;
+                }
+                catch (err) {
+                    // Member count might not be available for all chats
+                    console.warn('Could not get member count:', err);
+                }
+            }
+            return {
+                success: true,
+                output
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                details: {
+                    code: error.code,
+                    description: error.description
+                }
+            };
+        }
+    }
+    validateArgs(args) {
+        const errors = [];
+        if (!args.chatId) {
+            errors.push('chatId is required');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors
+        };
+    }
+}
+exports.GetChatInfoTool = GetChatInfoTool;
+//# sourceMappingURL=getChatInfo.js.map