@framers/agentos-ext-telegram-bot 1.1.0

package/dist/config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configuration management for Telegram Bot extension
+ * Supports loading from options, environment variables, and .env files
+ */
+/**
+ * Telegram bot configuration
+ */
+export interface TelegramConfig {
+    botToken: string;
+    defaultParseMode: 'Markdown' | 'HTML' | 'MarkdownV2';
+    pollingInterval: number;
+    maxRetries: number;
+    priority?: number;
+}
+/**
+ * Loads configuration from multiple sources with priority:
+ * 1. Direct options (highest priority)
+ * 2. Environment variables
+ * 3. .env file (lowest priority)
+ *
+ * @param {Partial<TelegramConfig>} options - Direct configuration options
+ * @returns {TelegramConfig} Complete configuration
+ *
+ * @example
+ * ```typescript
+ * // Priority order: options > env vars > .env file
+ * const config = loadConfig({
+ *   botToken: undefined, // Will check env vars
+ *   defaultParseMode: 'HTML' // Direct override
+ * });
+ * ```
+ */
+export declare function loadConfig(options?: Partial<TelegramConfig>): TelegramConfig;
+/**
+ * Gets API key from multiple sources
+ * Useful for tools that need to check for API keys dynamically
+ *
+ * @param {string} keyName - Name of the key to look for
+ * @param {Record<string, any>} [options] - Optional direct configuration
+ * @returns {string | undefined} The API key if found
+ *
+ * @example
+ * ```typescript
+ * const token = getApiKey('botToken', options);
+ * const apiKey = getApiKey('TELEGRAM_API_KEY');
+ * ```
+ */
+export declare function getApiKey(keyName: string, options?: Record<string, any>): string | undefined;
+/**
+ * Validates that all required configuration is present
+ *
+ * @param {Partial<TelegramConfig>} config - Configuration to validate
+ * @throws {Error} If required configuration is missing
+ */
+export declare function validateConfig(config: Partial<TelegramConfig>): asserts config is TelegramConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAkChF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,MAAM,GAAG,SAAS,CAqBpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAsBhG"}

package/dist/config.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Configuration management for Telegram Bot extension
+ * Supports loading from options, environment variables, and .env files
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.getApiKey = getApiKey;
+exports.validateConfig = validateConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const dotenv_1 = require("dotenv");
+/**
+ * Attempts to find and load .env file from various locations
+ *
+ * @private
+ * @returns {void}
+ */
+function loadDotEnv() {
+    const possiblePaths = [
+        '.env',
+        '../.env',
+        '../../.env',
+        '../../../.env',
+        '../../../../.env',
+        '../../../../../.env', // Root of monorepo
+        path.join(process.cwd(), '.env'),
+        path.join(process.cwd(), '..', '.env'),
+        path.join(process.cwd(), '..', '..', '.env'),
+    ];
+    for (const envPath of possiblePaths) {
+        if (fs.existsSync(envPath)) {
+            (0, dotenv_1.config)({ path: envPath });
+            break;
+        }
+    }
+}
+/**
+ * Loads configuration from multiple sources with priority:
+ * 1. Direct options (highest priority)
+ * 2. Environment variables
+ * 3. .env file (lowest priority)
+ *
+ * @param {Partial<TelegramConfig>} options - Direct configuration options
+ * @returns {TelegramConfig} Complete configuration
+ *
+ * @example
+ * ```typescript
+ * // Priority order: options > env vars > .env file
+ * const config = loadConfig({
+ *   botToken: undefined, // Will check env vars
+ *   defaultParseMode: 'HTML' // Direct override
+ * });
+ * ```
+ */
+function loadConfig(options = {}) {
+    // Try to load .env file if it exists
+    loadDotEnv();
+    // Build config with priority: options > env > defaults
+    const config = {
+        botToken: options.botToken ||
+            process.env.TELEGRAM_BOT_TOKEN ||
+            process.env.TG_BOT_TOKEN ||
+            '',
+        defaultParseMode: options.defaultParseMode ||
+            process.env.TELEGRAM_PARSE_MODE ||
+            'Markdown',
+        pollingInterval: options.pollingInterval ||
+            parseInt(process.env.TELEGRAM_POLLING_INTERVAL || '1000'),
+        maxRetries: options.maxRetries ||
+            parseInt(process.env.TELEGRAM_MAX_RETRIES || '3'),
+        priority: options.priority
+    };
+    // Validate parse mode
+    if (!['Markdown', 'HTML', 'MarkdownV2'].includes(config.defaultParseMode)) {
+        config.defaultParseMode = 'Markdown';
+    }
+    return config;
+}
+/**
+ * Gets API key from multiple sources
+ * Useful for tools that need to check for API keys dynamically
+ *
+ * @param {string} keyName - Name of the key to look for
+ * @param {Record<string, any>} [options] - Optional direct configuration
+ * @returns {string | undefined} The API key if found
+ *
+ * @example
+ * ```typescript
+ * const token = getApiKey('botToken', options);
+ * const apiKey = getApiKey('TELEGRAM_API_KEY');
+ * ```
+ */
+function getApiKey(keyName, options) {
+    // Check options first
+    if (options && options[keyName]) {
+        return options[keyName];
+    }
+    // Check environment variables
+    const envKeys = [
+        keyName,
+        keyName.toUpperCase(),
+        `TELEGRAM_${keyName.toUpperCase()}`,
+        `TG_${keyName.toUpperCase()}`
+    ];
+    for (const envKey of envKeys) {
+        if (process.env[envKey]) {
+            return process.env[envKey];
+        }
+    }
+    return undefined;
+}
+/**
+ * Validates that all required configuration is present
+ *
+ * @param {Partial<TelegramConfig>} config - Configuration to validate
+ * @throws {Error} If required configuration is missing
+ */
+function validateConfig(config) {
+    if (!config.botToken) {
+        throw new Error('Telegram bot token is required. Set it via:\n' +
+            '  1. options.botToken in extension configuration\n' +
+            '  2. TELEGRAM_BOT_TOKEN environment variable\n' +
+            '  3. .env file with TELEGRAM_BOT_TOKEN=your_token\n' +
+            '\nGet a bot token from @BotFather on Telegram');
+    }
+    if (!config.defaultParseMode) {
+        throw new Error('Default parse mode is required');
+    }
+    if (typeof config.pollingInterval !== 'number' || config.pollingInterval < 100) {
+        throw new Error('Polling interval must be at least 100ms');
+    }
+    if (typeof config.maxRetries !== 'number' || config.maxRetries < 0) {
+        throw new Error('Max retries must be non-negative');
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Telegram Bot Extension for AgentOS
+ *
+ * Provides comprehensive Telegram Bot API integration for AgentOS agents.
+ *
+ * @module @framers/agentos-communications-telegram
+ * @version 1.0.0
+ * @license MIT
+ */
+import { ExtensionContext, ExtensionPack } from '@framers/agentos';
+import { SendMessageTool } from './tools/sendMessage';
+import { SendPhotoTool } from './tools/sendPhoto';
+import { SendDocumentTool } from './tools/sendDocument';
+import { ManageChatTool } from './tools/manageChat';
+import { PollMessagesTool } from './tools/pollMessages';
+/**
+ * Extension configuration options
+ */
+export interface TelegramExtensionOptions {
+    /** Telegram Bot token - can be provided directly or via env var */
+    botToken?: string;
+    /** Default parse mode for messages */
+    defaultParseMode?: 'Markdown' | 'HTML' | 'MarkdownV2';
+    /** Polling interval in ms */
+    pollingInterval?: number;
+    /** Max retry attempts */
+    maxRetries?: number;
+    /** Extension priority */
+    priority?: number;
+}
+/**
+ * Creates the Telegram Bot extension pack
+ *
+ * @param {ExtensionContext} context - The extension context
+ * @returns {ExtensionPack} The configured extension pack
+ *
+ * @example
+ * ```typescript
+ * import { createExtensionPack } from '@framers/agentos-communications-telegram';
+ *
+ * const pack = createExtensionPack({
+ *   options: {
+ *     botToken: process.env.TELEGRAM_BOT_TOKEN,
+ *     defaultParseMode: 'Markdown'
+ *   },
+ *   logger: console
+ * });
+ * ```
+ */
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { SendMessageTool, SendPhotoTool, SendDocumentTool, ManageChatTool, PollMessagesTool };
+export { TelegramBotService } from './services/telegramBot';
+export type { TelegramConfig } from './config';
+export default createExtensionPack;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IACtD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAsE5E;AAGD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Telegram Bot Extension for AgentOS
+ *
+ * Provides comprehensive Telegram Bot API integration for AgentOS agents.
+ *
+ * @module @framers/agentos-communications-telegram
+ * @version 1.0.0
+ * @license MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramBotService = exports.PollMessagesTool = exports.ManageChatTool = exports.SendDocumentTool = exports.SendPhotoTool = exports.SendMessageTool = void 0;
+exports.createExtensionPack = createExtensionPack;
+const sendMessage_1 = require("./tools/sendMessage");
+Object.defineProperty(exports, "SendMessageTool", { enumerable: true, get: function () { return sendMessage_1.SendMessageTool; } });
+const sendPhoto_1 = require("./tools/sendPhoto");
+Object.defineProperty(exports, "SendPhotoTool", { enumerable: true, get: function () { return sendPhoto_1.SendPhotoTool; } });
+const sendDocument_1 = require("./tools/sendDocument");
+Object.defineProperty(exports, "SendDocumentTool", { enumerable: true, get: function () { return sendDocument_1.SendDocumentTool; } });
+const manageChat_1 = require("./tools/manageChat");
+Object.defineProperty(exports, "ManageChatTool", { enumerable: true, get: function () { return manageChat_1.ManageChatTool; } });
+const pollMessages_1 = require("./tools/pollMessages");
+Object.defineProperty(exports, "PollMessagesTool", { enumerable: true, get: function () { return pollMessages_1.PollMessagesTool; } });
+const telegramBot_1 = require("./services/telegramBot");
+const config_1 = require("./config");
+/**
+ * Creates the Telegram Bot extension pack
+ *
+ * @param {ExtensionContext} context - The extension context
+ * @returns {ExtensionPack} The configured extension pack
+ *
+ * @example
+ * ```typescript
+ * import { createExtensionPack } from '@framers/agentos-communications-telegram';
+ *
+ * const pack = createExtensionPack({
+ *   options: {
+ *     botToken: process.env.TELEGRAM_BOT_TOKEN,
+ *     defaultParseMode: 'Markdown'
+ *   },
+ *   logger: console
+ * });
+ * ```
+ */
+function createExtensionPack(context) {
+    // Load configuration from options, env vars, or .env file
+    const config = (0, config_1.loadConfig)(context.options || {});
+    if (!config.botToken) {
+        throw new Error('Telegram bot token is required. Set via options, TELEGRAM_BOT_TOKEN env var, or .env file');
+    }
+    // Initialize bot service
+    const botService = new telegramBot_1.TelegramBotService(config);
+    // Create tool instances
+    const sendMessageTool = new sendMessage_1.SendMessageTool(botService);
+    const sendPhotoTool = new sendPhoto_1.SendPhotoTool(botService);
+    const sendDocumentTool = new sendDocument_1.SendDocumentTool(botService);
+    const manageChatTool = new manageChat_1.ManageChatTool(botService);
+    const pollMessagesTool = new pollMessages_1.PollMessagesTool(botService);
+    const priority = config.priority || 50;
+    return {
+        name: '@framers/agentos-communications-telegram',
+        version: '1.0.0',
+        descriptors: [
+            {
+                id: 'telegramSendMessage',
+                kind: 'tool',
+                priority,
+                payload: sendMessageTool
+            },
+            {
+                id: 'telegramSendPhoto',
+                kind: 'tool',
+                priority,
+                payload: sendPhotoTool
+            },
+            {
+                id: 'telegramSendDocument',
+                kind: 'tool',
+                priority,
+                payload: sendDocumentTool
+            },
+            {
+                id: 'telegramManageChat',
+                kind: 'tool',
+                priority,
+                payload: manageChatTool
+            },
+            {
+                id: 'telegramPollMessages',
+                kind: 'tool',
+                priority,
+                payload: pollMessagesTool
+            }
+        ],
+        /**
+         * Called when extension is activated
+         */
+        onActivate: async () => {
+            await botService.initialize();
+            context.logger?.info('Telegram Bot Extension activated');
+        },
+        /**
+         * Called when extension is deactivated
+         */
+        onDeactivate: async () => {
+            await botService.shutdown();
+            context.logger?.info('Telegram Bot Extension deactivated');
+        }
+    };
+}
+var telegramBot_2 = require("./services/telegramBot");
+Object.defineProperty(exports, "TelegramBotService", { enumerable: true, get: function () { return telegramBot_2.TelegramBotService; } });
+// Default export
+exports.default = createExtensionPack;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8CH,kDAsEC;AAjHD,qDAAsD;AAoH7C,gGApHA,6BAAe,OAoHA;AAnHxB,iDAAkD;AAmHxB,8FAnHjB,yBAAa,OAmHiB;AAlHvC,uDAAwD;AAkHf,iGAlHhC,+BAAgB,OAkHgC;AAjHzD,mDAAoD;AAiHO,+FAjHlD,2BAAc,OAiHkD;AAhHzE,uDAAwD;AAgHmB,iGAhHlE,+BAAgB,OAgHkE;AA/G3F,wDAA4D;AAC5D,qCAAsC;AAkBtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,mBAAmB,CAAC,OAAyB;IAC3D,0DAA0D;IAC1D,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,OAAmC,IAAI,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC/G,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,gCAAkB,CAAC,MAAM,CAAC,CAAC;IAElD,wBAAwB;IACxB,MAAM,eAAe,GAAG,IAAI,6BAAe,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,yBAAa,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,+BAAgB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,IAAI,2BAAc,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,IAAI,+BAAgB,CAAC,UAAU,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,OAAO,EAAE,eAAe;aACzB;YACD;gBACE,EAAE,EAAE,mBAAmB;gBACvB,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,OAAO,EAAE,aAAa;aACvB;YACD;gBACE,EAAE,EAAE,sBAAsB;gBAC1B,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,OAAO,EAAE,gBAAgB;aAC1B;YACD;gBACE,EAAE,EAAE,oBAAoB;gBACxB,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,OAAO,EAAE,cAAc;aACxB;YACD;gBACE,EAAE,EAAE,sBAAsB;gBAC1B,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,OAAO,EAAE,gBAAgB;aAC1B;SACF;QACD;;WAEG;QACH,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC3D,CAAC;QACD;;WAEG;QACH,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAID,sDAA4D;AAAnD,iHAAA,kBAAkB,OAAA;AAG3B,iBAAiB;AACjB,kBAAe,mBAAmB,CAAC"}

package/dist/services/telegramBot.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Telegram Bot service for managing bot instance and API calls
+ */
+import TelegramBot from 'node-telegram-bot-api';
+import { TelegramConfig } from '../config';
+/**
+ * Message send options
+ */
+export interface SendMessageOptions {
+    chatId: string | number;
+    text: string;
+    parseMode?: 'Markdown' | 'HTML' | 'MarkdownV2';
+    disableNotification?: boolean;
+    replyToMessageId?: number;
+    replyMarkup?: any;
+}
+/**
+ * Photo send options
+ */
+export interface SendPhotoOptions {
+    chatId: string | number;
+    photo: string | Buffer;
+    caption?: string;
+    parseMode?: 'Markdown' | 'HTML' | 'MarkdownV2';
+    disableNotification?: boolean;
+}
+/**
+ * Service for interacting with Telegram Bot API
+ *
+ * @class TelegramBotService
+ *
+ * @example
+ * ```typescript
+ * const service = new TelegramBotService(config);
+ * await service.initialize();
+ * await service.sendMessage({
+ *   chatId: '@mychannel',
+ *   text: 'Hello from AgentOS!'
+ * });
+ * ```
+ */
+export declare class TelegramBotService {
+    private bot;
+    private config;
+    private retryAttempts;
+    /**
+     * Creates an instance of TelegramBotService
+     *
+     * @param {TelegramConfig} config - Bot configuration
+     */
+    constructor(config: TelegramConfig);
+    /**
+     * Initializes the bot instance
+     *
+     * @returns {Promise<void>}
+     */
+    initialize(): Promise<void>;
+    /**
+     * Sends a text message
+     *
+     * @param {SendMessageOptions} options - Message options
+     * @returns {Promise<any>} Sent message object
+     */
+    sendMessage(options: SendMessageOptions): Promise<any>;
+    /**
+     * Sends a photo
+     *
+     * @param {SendPhotoOptions} options - Photo options
+     * @returns {Promise<any>} Sent message object
+     */
+    sendPhoto(options: SendPhotoOptions): Promise<any>;
+    /**
+     * Sends a document
+     *
+     * @param {Object} options - Document options
+     * @returns {Promise<any>} Sent message object
+     */
+    sendDocument(options: {
+        chatId: string | number;
+        document: string | Buffer;
+        caption?: string;
+        parseMode?: string;
+    }): Promise<any>;
+    /**
+     * Gets information about a chat
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @returns {Promise<any>} Chat information
+     */
+    getChatInfo(chatId: string | number): Promise<any>;
+    /**
+     * Pins a message in a chat
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @param {number} messageId - Message to pin
+     * @param {boolean} disableNotification - Silent pin
+     * @returns {Promise<any>} Operation result
+     */
+    pinMessage(chatId: string | number, messageId: number, disableNotification?: boolean): Promise<any>;
+    /**
+     * Gets recent messages from a chat (if using polling)
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @param {number} limit - Number of messages to retrieve
+     * @returns {Promise<any[]>} Recent messages
+     */
+    getRecentMessages(chatId: string | number, limit?: number): Promise<any[]>;
+    /**
+     * Retries an operation with exponential backoff
+     *
+     * @private
+     * @param {Function} operation - Operation to retry
+     * @returns {Promise<any>} Operation result
+     */
+    private retryOperation;
+    /**
+     * Shuts down the bot service
+     *
+     * @returns {Promise<void>}
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Gets the bot instance (for advanced operations)
+     *
+     * @returns {TelegramBot | null} Bot instance
+     */
+    getBotInstance(): TelegramBot | null;
+}
+//# 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":"AAAA;;GAEG;AAEH,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IAC/C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IAC/C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAkC;IAEvD;;;;OAIG;gBACS,MAAM,EAAE,cAAc;IAIlC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC;IAgC5D;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IA+BxD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;IA4BhB;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBxD;;;;;;;OAOG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,mBAAmB,UAAQ,GAC1B,OAAO,CAAC,GAAG,CAAC;IAmBf;;;;;;OAMG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAY5E;;;;;;OAMG;YACW,cAAc;IAoB5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;;;OAIG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;CAGrC"}

package/dist/services/telegramBot.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * Telegram Bot service for managing bot instance and API calls
+ */
+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
+ *
+ * @example
+ * ```typescript
+ * const service = new TelegramBotService(config);
+ * await service.initialize();
+ * await service.sendMessage({
+ *   chatId: '@mychannel',
+ *   text: 'Hello from AgentOS!'
+ * });
+ * ```
+ */
+class TelegramBotService {
+    bot = null;
+    config;
+    retryAttempts = new Map();
+    /**
+     * Creates an instance of TelegramBotService
+     *
+     * @param {TelegramConfig} config - Bot configuration
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Initializes the bot instance
+     *
+     * @returns {Promise<void>}
+     */
+    async initialize() {
+        if (this.bot)
+            return;
+        this.bot = new node_telegram_bot_api_1.default(this.config.botToken, {
+            polling: false // We'll use webhook or manual polling
+        });
+        // Verify bot token is valid
+        try {
+            const me = await this.bot.getMe();
+            console.info(`Telegram bot initialized: @${me.username}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize Telegram bot: ${error}`);
+        }
+    }
+    /**
+     * Sends a text message
+     *
+     * @param {SendMessageOptions} options - Message options
+     * @returns {Promise<any>} Sent message object
+     */
+    async sendMessage(options) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        const parseMode = options.parseMode || this.config.defaultParseMode;
+        try {
+            const result = await this.retryOperation(async () => {
+                return this.bot.sendMessage(options.chatId, options.text, {
+                    parse_mode: parseMode,
+                    disable_notification: options.disableNotification,
+                    reply_to_message_id: options.replyToMessageId,
+                    reply_markup: options.replyMarkup
+                });
+            });
+            return {
+                success: true,
+                messageId: result.message_id,
+                chatId: result.chat.id,
+                date: result.date,
+                text: result.text
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Sends a photo
+     *
+     * @param {SendPhotoOptions} options - Photo options
+     * @returns {Promise<any>} Sent message object
+     */
+    async sendPhoto(options) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        const parseMode = options.parseMode || this.config.defaultParseMode;
+        try {
+            const result = await this.retryOperation(async () => {
+                return this.bot.sendPhoto(options.chatId, options.photo, {
+                    caption: options.caption,
+                    parse_mode: parseMode,
+                    disable_notification: options.disableNotification
+                });
+            });
+            return {
+                success: true,
+                messageId: result.message_id,
+                chatId: result.chat.id,
+                date: result.date,
+                photo: result.photo
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Sends a document
+     *
+     * @param {Object} options - Document options
+     * @returns {Promise<any>} Sent message object
+     */
+    async sendDocument(options) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await this.retryOperation(async () => {
+                return this.bot.sendDocument(options.chatId, options.document, {
+                    caption: options.caption,
+                    parse_mode: options.parseMode || this.config.defaultParseMode
+                });
+            });
+            return {
+                success: true,
+                messageId: result.message_id,
+                chatId: result.chat.id,
+                date: result.date,
+                document: result.document
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Gets information about a chat
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @returns {Promise<any>} Chat information
+     */
+    async getChatInfo(chatId) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        try {
+            const chat = await this.bot.getChat(chatId);
+            return {
+                success: true,
+                id: chat.id,
+                type: chat.type,
+                title: chat.title,
+                username: chat.username,
+                description: chat.description,
+                inviteLink: chat.invite_link
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Pins a message in a chat
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @param {number} messageId - Message to pin
+     * @param {boolean} disableNotification - Silent pin
+     * @returns {Promise<any>} Operation result
+     */
+    async pinMessage(chatId, messageId, disableNotification = false) {
+        if (!this.bot) {
+            throw new Error('Bot not initialized. Call initialize() first.');
+        }
+        try {
+            await this.bot.pinChatMessage(chatId, messageId, {
+                disable_notification: disableNotification
+            });
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Gets recent messages from a chat (if using polling)
+     *
+     * @param {string | number} chatId - Chat identifier
+     * @param {number} limit - Number of messages to retrieve
+     * @returns {Promise<any[]>} Recent messages
+     */
+    async getRecentMessages(chatId, limit = 10) {
+        // Note: Telegram Bot API doesn't directly support getting message history
+        // This would need to be implemented using message polling/webhooks
+        // and maintaining a message cache
+        return {
+            success: false,
+            error: 'Message history requires webhook setup or message caching',
+            hint: 'Use webhooks or long polling to receive and cache messages'
+        };
+    }
+    /**
+     * Retries an operation with exponential backoff
+     *
+     * @private
+     * @param {Function} operation - Operation to retry
+     * @returns {Promise<any>} Operation result
+     */
+    async retryOperation(operation) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < this.config.maxRetries) {
+                    // Exponential backoff
+                    const delay = Math.min(1000 * Math.pow(2, attempt), 10000);
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Shuts down the bot service
+     *
+     * @returns {Promise<void>}
+     */
+    async shutdown() {
+        if (this.bot) {
+            await this.bot.stopPolling();
+            this.bot = null;
+        }
+        this.retryAttempts.clear();
+    }
+    /**
+     * Gets the bot instance (for advanced operations)
+     *
+     * @returns {TelegramBot | null} Bot instance
+     */
+    getBotInstance() {
+        return this.bot;
+    }
+}
+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/sendMessage.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Send message tool for Telegram Bot extension
+ */
+import { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import { TelegramBotService } from '../services/telegramBot';
+/**
+ * Tool for sending text messages via Telegram
+ *
+ * @class SendMessageTool
+ * @implements {ITool}
+ */
+export declare class SendMessageTool implements ITool {
+    private botService;
+    readonly id = "telegramSendMessage";
+    readonly name = "telegramSendMessage";
+    readonly displayName = "Send Telegram Message";
+    readonly description = "Send a text message to a Telegram chat, channel, or user. Supports Markdown and HTML formatting.";
+    readonly inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            chatId: {
+                type: string[];
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+            parseMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            disableNotification: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            replyToMessageId: {
+                type: string;
+                description: string;
+            };
+            buttons: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            text: {
+                                type: string;
+                            };
+                            url: {
+                                type: string;
+                            };
+                            callbackData: {
+                                type: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: string;
+        properties: {
+            success: {
+                type: string;
+            };
+            messageId: {
+                type: string;
+            };
+            chatId: {
+                type: string[];
+            };
+            date: {
+                type: string;
+            };
+            error: {
+                type: string;
+            };
+        };
+    };
+    readonly requiredCapabilities: string[];
+    readonly category = "communications";
+    readonly version = "1.0.0";
+    readonly hasSideEffects = true;
+    /**
+     * Creates an instance of SendMessageTool
+     *
+     * @param {TelegramBotService} botService - Telegram bot service
+     */
+    constructor(botService: TelegramBotService);
+    /**
+     * Executes the send message operation
+     *
+     * @param {any} args - Input arguments
+     * @param {ToolExecutionContext} context - Execution context
+     * @returns {Promise<ToolExecutionResult>} Execution result
+     */
+    execute(args: any, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    /**
+     * Validates input arguments
+     *
+     * @param {any} args - Arguments to validate
+     * @returns {{isValid: boolean, errors?: string[]}} Validation result
+     */
+    validateArgs(args: any): {
+        isValid: boolean;
+        errors?: string[];
+    };
+}
+//# 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;;GAEG;AAEH,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;IAuE/B,OAAO,CAAC,UAAU;IAtE9B,SAAgB,EAAE,yBAAyB;IAC3C,SAAgB,IAAI,yBAAyB;IAC7C,SAAgB,WAAW,2BAA2B;IACtD,SAAgB,WAAW,sGAAsG;IAEjI,SAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0CzB;IAEF,SAAgB,YAAY;;;;;;;;;;;;;;;;;;;MAS1B;IAEF,SAAgB,oBAAoB,WAAmC;IACvE,SAAgB,QAAQ,oBAAoB;IAC5C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC;;;;OAIG;gBACiB,UAAU,EAAE,kBAAkB;IAElD;;;;;;OAMG;IACG,OAAO,CACX,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAwBjE"}

package/dist/tools/sendMessage.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Send message tool for Telegram Bot extension
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendMessageTool = void 0;
+/**
+ * Tool for sending text messages via Telegram
+ *
+ * @class SendMessageTool
+ * @implements {ITool}
+ */
+class SendMessageTool {
+    botService;
+    id = 'telegramSendMessage';
+    name = 'telegramSendMessage';
+    displayName = 'Send Telegram Message';
+    description = 'Send a text message to a Telegram chat, channel, or user. Supports Markdown and HTML formatting.';
+    inputSchema = {
+        type: 'object',
+        required: ['chatId', 'text'],
+        properties: {
+            chatId: {
+                type: ['string', 'number'],
+                description: 'Chat ID, username (@username), or channel (@channelname)'
+            },
+            text: {
+                type: 'string',
+                description: 'Message text to send (supports Markdown/HTML based on parseMode)'
+            },
+            parseMode: {
+                type: 'string',
+                enum: ['Markdown', 'HTML', 'MarkdownV2'],
+                description: 'Text formatting mode'
+            },
+            disableNotification: {
+                type: 'boolean',
+                description: 'Send message silently',
+                default: false
+            },
+            replyToMessageId: {
+                type: 'number',
+                description: 'ID of message to reply to'
+            },
+            buttons: {
+                type: 'array',
+                description: 'Inline keyboard buttons',
+                items: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            text: { type: 'string' },
+                            url: { type: 'string' },
+                            callbackData: { type: 'string' }
+                        }
+                    }
+                }
+            }
+        }
+    };
+    outputSchema = {
+        type: 'object',
+        properties: {
+            success: { type: 'boolean' },
+            messageId: { type: 'number' },
+            chatId: { type: ['string', 'number'] },
+            date: { type: 'number' },
+            error: { type: 'string' }
+        }
+    };
+    requiredCapabilities = ['capability:network:telegram'];
+    category = 'communications';
+    version = '1.0.0';
+    hasSideEffects = true;
+    /**
+     * Creates an instance of SendMessageTool
+     *
+     * @param {TelegramBotService} botService - Telegram bot service
+     */
+    constructor(botService) {
+        this.botService = botService;
+    }
+    /**
+     * Executes the send message operation
+     *
+     * @param {any} args - Input arguments
+     * @param {ToolExecutionContext} context - Execution context
+     * @returns {Promise<ToolExecutionResult>} Execution result
+     */
+    async execute(args, context) {
+        try {
+            // Prepare reply markup if buttons provided
+            let replyMarkup;
+            if (args.buttons && Array.isArray(args.buttons)) {
+                replyMarkup = {
+                    inline_keyboard: args.buttons.map((row) => row.map(btn => ({
+                        text: btn.text,
+                        url: btn.url,
+                        callback_data: btn.callbackData
+                    })))
+                };
+            }
+            const result = await this.botService.sendMessage({
+                chatId: args.chatId,
+                text: args.text,
+                parseMode: args.parseMode,
+                disableNotification: args.disableNotification,
+                replyToMessageId: args.replyToMessageId,
+                replyMarkup
+            });
+            return {
+                success: result.success,
+                output: result,
+                error: result.error
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to send message: ${error.message}`
+            };
+        }
+    }
+    /**
+     * Validates input arguments
+     *
+     * @param {any} args - Arguments to validate
+     * @returns {{isValid: boolean, errors?: string[]}} Validation result
+     */
+    validateArgs(args) {
+        const errors = [];
+        if (!args.chatId) {
+            errors.push('chatId is required');
+        }
+        if (!args.text) {
+            errors.push('text is required');
+        }
+        else if (typeof args.text !== 'string') {
+            errors.push('text must be a string');
+        }
+        else if (args.text.length > 4096) {
+            errors.push('text must be 4096 characters or less');
+        }
+        if (args.parseMode && !['Markdown', 'HTML', 'MarkdownV2'].includes(args.parseMode)) {
+            errors.push('parseMode must be Markdown, HTML, or MarkdownV2');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined
+        };
+    }
+}
+exports.SendMessageTool = SendMessageTool;
+//# 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/manifest.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.communications.telegram",
+  "name": "Telegram Bot Extension",
+  "version": "1.0.0",
+  "description": "Professional Telegram Bot API integration for AgentOS agents",
+  "author": {
+    "name": "Frame.dev",
+    "email": "support@frame.dev",
+    "url": "https://github.com/framersai"
+  },
+  "license": "MIT",
+  "keywords": ["telegram", "bot", "messaging", "communications", "chat", "channels"],
+  "agentosVersion": "^2.0.0",
+  "categories": ["communications", "integrations"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions"
+  },
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "telegramSendMessage",
+      "displayName": "Send Telegram Message",
+      "description": "Send a message to a Telegram chat or channel",
+      "entry": "./dist/tools/sendMessage.js"
+    },
+    {
+      "kind": "tool",
+      "id": "telegramSendPhoto",
+      "displayName": "Send Telegram Photo",
+      "description": "Send a photo with optional caption to a Telegram chat",
+      "entry": "./dist/tools/sendPhoto.js"
+    },
+    {
+      "kind": "tool",
+      "id": "telegramSendDocument",
+      "displayName": "Send Telegram Document",
+      "description": "Send a document file to a Telegram chat",
+      "entry": "./dist/tools/sendDocument.js"
+    },
+    {
+      "kind": "tool",
+      "id": "telegramManageChat",
+      "displayName": "Manage Telegram Chat",
+      "description": "Get chat info, pin messages, or manage chat settings",
+      "entry": "./dist/tools/manageChat.js"
+    },
+    {
+      "kind": "tool",
+      "id": "telegramPollMessages",
+      "displayName": "Poll Telegram Messages",
+      "description": "Retrieve recent messages from a chat for context",
+      "entry": "./dist/tools/pollMessages.js"
+    }
+  ],
+  "configuration": {
+    "properties": {
+      "telegram.botToken": {
+        "type": "string",
+        "description": "Telegram Bot API token from @BotFather",
+        "secret": true
+      },
+      "telegram.defaultParseMode": {
+        "type": "string",
+        "enum": ["Markdown", "HTML", "MarkdownV2"],
+        "default": "Markdown",
+        "description": "Default message parsing mode"
+      },
+      "telegram.pollingInterval": {
+        "type": "number",
+        "default": 1000,
+        "minimum": 100,
+        "maximum": 10000,
+        "description": "Polling interval in milliseconds"
+      },
+      "telegram.maxRetries": {
+        "type": "number",
+        "default": 3,
+        "minimum": 0,
+        "maximum": 10,
+        "description": "Maximum retry attempts for failed requests"
+      }
+    }
+  },
+  "features": [
+    "Send text messages with formatting (Markdown/HTML)",
+    "Send photos, documents, and media",
+    "Manage chat settings and pins",
+    "Poll messages for context awareness",
+    "Rate limiting and retry logic",
+    "Environment variable support for credentials"
+  ]
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@framers/agentos-ext-telegram-bot",
+  "version": "1.1.0",
+  "description": "Telegram Bot API extension for AgentOS - manage channels, send messages, and interact as a bot",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src test --ext .ts",
+    "lint:fix": "eslint src test --ext .ts --fix",
+    "clean": "rm -rf dist coverage",
+    "docs": "typedoc --out docs src/index.ts"
+  },
+  "keywords": [
+    "agentos",
+    "extension",
+    "telegram",
+    "bot",
+    "messaging",
+    "communications",
+    "chat"
+  ],
+  "author": {
+    "name": "Framers AI",
+    "email": "team@frame.dev",
+    "url": "https://frame.dev"
+  },
+  "contributors": [
+    {
+      "name": "Johnny Dunn",
+      "email": "johnnyfived@protonmail.com",
+      "url": "https://github.com/jddunn"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions",
+    "directory": "registry/curated/communications/telegram-bot"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "dependencies": {
+    "node-telegram-bot-api": "^0.64.0",
+    "dotenv": "^16.0.0"
+  },
+  "devDependencies": {
+    "@framers/agentos": "^0.1.0",
+    "@types/node": "^20.0.0",
+    "@types/node-telegram-bot-api": "^0.64.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "typedoc": "^0.25.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}