@framers/agentos-ext-telegram 1.1.0

package/dist/tools/sendMessage.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendMessageTool = void 0;
+/**
+ * Tool for sending text messages via Telegram
+ *
+ * @class SendMessageTool
+ * @implements {ITool}
+ */
+class SendMessageTool {
+    /**
+     * Creates an instance of SendMessageTool
+     * @param {TelegramBotService} telegramService - The Telegram service
+     */
+    constructor(telegramService) {
+        this.telegramService = telegramService;
+        this.id = 'telegramSendMessage';
+        this.name = 'telegramSendMessage';
+        this.displayName = 'Send Telegram Message';
+        this.description = 'Send a text message to a Telegram chat or user. Supports Markdown and HTML formatting, reply to messages, and custom keyboards.';
+        this.category = 'communication';
+        this.version = '1.0.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['chatId', 'text'],
+            properties: {
+                chatId: {
+                    type: ['string', 'number'],
+                    description: 'Unique identifier for the target chat or username of the target channel'
+                },
+                text: {
+                    type: 'string',
+                    description: 'Text of the message to be sent, 1-4096 characters'
+                },
+                parseMode: {
+                    type: 'string',
+                    enum: ['Markdown', 'HTML'],
+                    description: 'Mode for parsing entities in the message text'
+                },
+                replyToMessageId: {
+                    type: 'number',
+                    description: 'If the message is a reply, ID of the original message'
+                },
+                disableNotification: {
+                    type: 'boolean',
+                    description: 'Sends the message silently'
+                },
+                replyMarkup: {
+                    type: 'object',
+                    description: 'Additional interface options (inline keyboard, custom reply keyboard, etc.)'
+                }
+            }
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                messageId: {
+                    type: 'number',
+                    description: 'Unique message identifier'
+                },
+                chatId: {
+                    type: ['string', 'number'],
+                    description: 'Chat where the message was sent'
+                },
+                date: {
+                    type: 'number',
+                    description: 'Date the message was sent in Unix time'
+                },
+                text: {
+                    type: 'string',
+                    description: 'The actual text of the message'
+                }
+            }
+        };
+    }
+    /**
+     * Executes the message sending
+     */
+    async execute(args, context) {
+        try {
+            // Validate text length
+            if (args.text.length > 4096) {
+                throw new Error('Message text too long (max 4096 characters)');
+            }
+            const message = await this.telegramService.sendMessage({
+                chatId: args.chatId,
+                text: args.text,
+                parseMode: args.parseMode,
+                replyToMessageId: args.replyToMessageId,
+                disableNotification: args.disableNotification,
+                replyMarkup: args.replyMarkup
+            });
+            return {
+                success: true,
+                output: {
+                    messageId: message.message_id,
+                    chatId: message.chat.id,
+                    date: message.date,
+                    text: message.text
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                details: {
+                    code: error.code,
+                    description: error.description
+                }
+            };
+        }
+    }
+    /**
+     * Validates input arguments
+     */
+    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 exceeds maximum length of 4096 characters');
+        }
+        if (args.parseMode && !['Markdown', 'HTML'].includes(args.parseMode)) {
+            errors.push('parseMode must be either "Markdown" or "HTML"');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors
+        };
+    }
+}
+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/dist/tools/sendPhoto.d.ts

@@ -0,0 +1,54 @@
+import { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import { TelegramBotService } from '../services/telegramBot';
+/**
+ * Tool for sending photos via Telegram
+ *
+ * @class SendPhotoTool
+ * @implements {ITool}
+ */
+export declare class SendPhotoTool implements ITool {
+    private telegramService;
+    readonly id = "telegramSendPhoto";
+    readonly name = "telegramSendPhoto";
+    readonly displayName = "Send Telegram Photo";
+    readonly description = "Send a photo to a Telegram chat. Supports URLs, file paths, and base64 encoded images with optional captions.";
+    readonly category = "communication";
+    readonly version = "1.0.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            chatId: {
+                type: string[];
+                description: string;
+            };
+            photo: {
+                type: string;
+                description: string;
+            };
+            caption: {
+                type: string;
+                description: string;
+            };
+            parseMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            replyToMessageId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(telegramService: TelegramBotService);
+    execute(args: {
+        chatId: string | number;
+        photo: string;
+        caption?: string;
+        parseMode?: 'Markdown' | 'HTML';
+        replyToMessageId?: number;
+    }, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=sendPhoto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendPhoto.d.ts","sourceRoot":"","sources":["../../src/tools/sendPhoto.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,aAAc,YAAW,KAAK;IAqC7B,OAAO,CAAC,eAAe;IApCnC,SAAgB,EAAE,uBAAuB;IACzC,SAAgB,IAAI,uBAAuB;IAC3C,SAAgB,WAAW,yBAAyB;IACpD,SAAgB,WAAW,mHAAmH;IAC9I,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BzB;gBAEkB,eAAe,EAAE,kBAAkB;IAEjD,OAAO,CACX,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,EACD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAmChC"}

package/dist/tools/sendPhoto.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendPhotoTool = void 0;
+/**
+ * Tool for sending photos via Telegram
+ *
+ * @class SendPhotoTool
+ * @implements {ITool}
+ */
+class SendPhotoTool {
+    constructor(telegramService) {
+        this.telegramService = telegramService;
+        this.id = 'telegramSendPhoto';
+        this.name = 'telegramSendPhoto';
+        this.displayName = 'Send Telegram Photo';
+        this.description = 'Send a photo to a Telegram chat. Supports URLs, file paths, and base64 encoded images with optional captions.';
+        this.category = 'communication';
+        this.version = '1.0.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['chatId', 'photo'],
+            properties: {
+                chatId: {
+                    type: ['string', 'number'],
+                    description: 'Unique identifier for the target chat'
+                },
+                photo: {
+                    type: 'string',
+                    description: 'Photo URL, file path, or base64 encoded image'
+                },
+                caption: {
+                    type: 'string',
+                    description: 'Photo caption, 0-1024 characters'
+                },
+                parseMode: {
+                    type: 'string',
+                    enum: ['Markdown', 'HTML'],
+                    description: 'Mode for parsing entities in the caption'
+                },
+                replyToMessageId: {
+                    type: 'number',
+                    description: 'If the message is a reply, ID of the original message'
+                }
+            }
+        };
+    }
+    async execute(args, context) {
+        try {
+            // Convert base64 to buffer if needed
+            let photoData = args.photo;
+            if (args.photo.startsWith('data:image/')) {
+                const base64Data = args.photo.split(',')[1];
+                photoData = Buffer.from(base64Data, 'base64');
+            }
+            const message = await this.telegramService.sendPhoto(args.chatId, photoData, {
+                caption: args.caption,
+                parseMode: args.parseMode,
+                replyToMessageId: args.replyToMessageId
+            });
+            return {
+                success: true,
+                output: {
+                    messageId: message.message_id,
+                    chatId: message.chat.id,
+                    date: message.date
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                details: { code: error.code }
+            };
+        }
+    }
+}
+exports.SendPhotoTool = SendPhotoTool;
+//# sourceMappingURL=sendPhoto.js.map

package/dist/tools/sendPhoto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendPhoto.js","sourceRoot":"","sources":["../../src/tools/sendPhoto.ts"],"names":[],"mappings":";;;AAGA;;;;;GAKG;AACH,MAAa,aAAa;IAqCxB,YAAoB,eAAmC;QAAnC,oBAAe,GAAf,eAAe,CAAoB;QApCvC,OAAE,GAAG,mBAAmB,CAAC;QACzB,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,qBAAqB,CAAC;QACpC,gBAAW,GAAG,+GAA+G,CAAC;QAC9H,aAAQ,GAAG,eAAe,CAAC;QAC3B,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,IAAI,CAAC;QAEtB,gBAAW,GAAG;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;YAC7B,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;oBAC1B,WAAW,EAAE,uCAAuC;iBACrD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;oBAC1B,WAAW,EAAE,0CAA0C;iBACxD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;aACF;SACF,CAAC;IAEwD,CAAC;IAE3D,KAAK,CAAC,OAAO,CACX,IAMC,EACD,OAA6B;QAE7B,IAAI,CAAC;YACH,qCAAqC;YACrC,IAAI,SAAS,GAAoB,IAAI,CAAC,KAAK,CAAC;YAC5C,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAClD,IAAI,CAAC,MAAM,EACX,SAAS,EACT;gBACE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;aACxC,CACF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,SAAS,EAAE,OAAO,CAAC,UAAU;oBAC7B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;oBACvB,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;aAC9B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAnFD,sCAmFC"}

package/manifest.json

@@ -0,0 +1,176 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.integrations.telegram",
+  "name": "Telegram Bot Extension",
+  "version": "1.0.0",
+  "description": "Professional Telegram Bot API integration for AgentOS - send messages, manage groups, handle callbacks",
+  "author": {
+    "name": "Frame.dev",
+    "email": "support@frame.dev",
+    "url": "https://github.com/framersai"
+  },
+  "license": "MIT",
+  "keywords": ["telegram", "bot", "messaging", "chat", "communication", "integration"],
+  "agentosVersion": "^2.0.0",
+  "categories": ["communication", "integration"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions"
+  },
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "telegramSendMessage",
+      "displayName": "Send Telegram Message",
+      "description": "Send formatted text messages to Telegram chats",
+      "entry": "./dist/tools/sendMessage.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["chatId", "text"],
+          "properties": {
+            "chatId": { "type": ["string", "number"] },
+            "text": { "type": "string" },
+            "parseMode": { "type": "string", "enum": ["Markdown", "HTML"] }
+          }
+        }
+      }
+    },
+    {
+      "kind": "tool",
+      "id": "telegramSendPhoto",
+      "displayName": "Send Telegram Photo",
+      "description": "Send photos with captions to Telegram chats",
+      "entry": "./dist/tools/sendPhoto.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["chatId", "photo"],
+          "properties": {
+            "chatId": { "type": ["string", "number"] },
+            "photo": { "type": "string" },
+            "caption": { "type": "string" }
+          }
+        }
+      }
+    },
+    {
+      "kind": "tool",
+      "id": "telegramSendDocument",
+      "displayName": "Send Telegram Document",
+      "description": "Send documents and files to Telegram chats",
+      "entry": "./dist/tools/sendDocument.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["chatId", "document"],
+          "properties": {
+            "chatId": { "type": ["string", "number"] },
+            "document": { "type": "string" },
+            "filename": { "type": "string" }
+          }
+        }
+      }
+    },
+    {
+      "kind": "tool",
+      "id": "telegramGetChatInfo",
+      "displayName": "Get Telegram Chat Info",
+      "description": "Retrieve information about a Telegram chat",
+      "entry": "./dist/tools/getChatInfo.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["chatId"],
+          "properties": {
+            "chatId": { "type": ["string", "number"] },
+            "includeMemberCount": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    {
+      "kind": "tool",
+      "id": "telegramManageGroup",
+      "displayName": "Manage Telegram Group",
+      "description": "Perform admin actions in Telegram groups",
+      "entry": "./dist/tools/manageGroup.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["chatId", "action"],
+          "properties": {
+            "chatId": { "type": ["string", "number"] },
+            "action": { "type": "string", "enum": ["pinMessage", "unpinMessage", "setDescription", "setTitle"] }
+          }
+        }
+      }
+    },
+    {
+      "kind": "tool",
+      "id": "telegramHandleCallback",
+      "displayName": "Handle Telegram Callback",
+      "description": "Handle callback queries from inline keyboards",
+      "entry": "./dist/tools/handleCallback.js",
+      "schema": {
+        "input": {
+          "type": "object",
+          "required": ["callbackQueryId"],
+          "properties": {
+            "callbackQueryId": { "type": "string" },
+            "text": { "type": "string" },
+            "showAlert": { "type": "boolean" }
+          }
+        }
+      }
+    }
+  ],
+  "features": [
+    "Send messages, photos, and documents",
+    "Manage groups (pin, descriptions, titles)",
+    "Handle inline keyboard callbacks",
+    "Flexible bot token configuration (env vars)",
+    "Rate limiting and queue management",
+    "Webhook and polling support",
+    "Markdown and HTML formatting"
+  ],
+  "configuration": {
+    "properties": {
+      "telegram.botToken": {
+        "type": "string",
+        "description": "Telegram Bot API token",
+        "secret": true
+      },
+      "telegram.botTokenEnv": {
+        "type": "string",
+        "default": "TELEGRAM_BOT_TOKEN",
+        "description": "Environment variable name for bot token"
+      },
+      "telegram.webhookUrl": {
+        "type": "string",
+        "description": "Webhook URL for receiving updates"
+      },
+      "telegram.pollingInterval": {
+        "type": "number",
+        "default": 300,
+        "description": "Polling interval in milliseconds"
+      },
+      "telegram.parseMode": {
+        "type": "string",
+        "enum": ["Markdown", "HTML"],
+        "default": "Markdown",
+        "description": "Default message parse mode"
+      },
+      "telegram.rateLimit.maxRequests": {
+        "type": "number",
+        "default": 30,
+        "description": "Maximum requests per window"
+      },
+      "telegram.rateLimit.windowMs": {
+        "type": "number",
+        "default": 1000,
+        "description": "Rate limit window in milliseconds"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@framers/agentos-ext-telegram",
+  "version": "1.1.0",
+  "description": "Telegram Bot API integration for AgentOS - send messages, manage groups, handle callbacks",
+  "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",
+    "chat",
+    "integration"
+  ],
+  "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/integrations/telegram"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "dependencies": {
+    "telegraf": "^4.15.0",
+    "node-telegram-bot-api": "^0.64.0",
+    "dotenv": "^16.3.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/"
+  }
+}