@framers/agentos-ext-channel-telegram 0.1.0

package/dist/TelegramChannelAdapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview IChannelAdapter implementation for Telegram via grammY.
+ */
+import type { IChannelAdapter, ChannelPlatform, ChannelCapability, ChannelAuthConfig, ChannelConnectionInfo, ChannelSendResult, MessageContent, ChannelEventHandler, ChannelEventType } from '@framers/agentos';
+import { TelegramService } from './TelegramService';
+export declare class TelegramChannelAdapter implements IChannelAdapter {
+    private readonly service;
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Telegram";
+    readonly capabilities: readonly ChannelCapability[];
+    private handlers;
+    private ctxHandler;
+    constructor(service: TelegramService);
+    initialize(auth: ChannelAuthConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    getConnectionInfo(): ChannelConnectionInfo;
+    sendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    sendTypingIndicator(conversationId: string, _isTyping: boolean): Promise<void>;
+    on(handler: ChannelEventHandler, eventTypes?: ChannelEventType[]): () => void;
+    editMessage(conversationId: string, messageId: string, content: MessageContent): Promise<void>;
+    deleteMessage(conversationId: string, messageId: string): Promise<void>;
+    addReaction(conversationId: string, messageId: string, emoji: string): Promise<void>;
+    getConversationInfo(conversationId: string): Promise<{
+        name?: string;
+        memberCount?: number;
+        isGroup: boolean;
+        metadata?: Record<string, unknown>;
+    }>;
+    private handleInboundMessage;
+    private emit;
+}
+//# sourceMappingURL=TelegramChannelAdapter.d.ts.map

package/dist/TelegramChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramChannelAdapter.d.ts","sourceRoot":"","sources":["../src/TelegramChannelAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAKjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,qBAAa,sBAAuB,YAAW,eAAe;IAwBhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAvBpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAc;IAChD,QAAQ,CAAC,WAAW,cAAc;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAgBxC;IAEX,OAAO,CAAC,QAAQ,CAAkE;IAClF,OAAO,CAAC,UAAU,CAAyC;gBAE9B,OAAO,EAAE,eAAe;IAE/C,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,iBAAiB,IAAI,qBAAqB;IAMpC,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BxF,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAI;IAOvE,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9F,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpF,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QACzD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IAaF,OAAO,CAAC,oBAAoB;IA2C5B,OAAO,CAAC,IAAI;CASb"}

package/dist/TelegramChannelAdapter.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * @fileoverview IChannelAdapter implementation for Telegram via grammY.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramChannelAdapter = void 0;
+class TelegramChannelAdapter {
+    constructor(service) {
+        this.service = service;
+        this.platform = 'telegram';
+        this.displayName = 'Telegram';
+        this.capabilities = [
+            'text',
+            'rich_text',
+            'images',
+            'video',
+            'audio',
+            'documents',
+            'stickers',
+            'reactions',
+            'inline_keyboard',
+            'buttons',
+            'typing_indicator',
+            'group_chat',
+            'editing',
+            'deletion',
+            'mentions',
+        ];
+        this.handlers = new Map();
+        this.ctxHandler = null;
+    }
+    async initialize(auth) {
+        // Service is initialized by the extension pack lifecycle, but
+        // if called directly (e.g., standalone usage), we wire up here.
+        this.ctxHandler = (ctx) => this.handleInboundMessage(ctx);
+        this.service.onMessage(this.ctxHandler);
+    }
+    async shutdown() {
+        if (this.ctxHandler) {
+            this.service.offMessage(this.ctxHandler);
+            this.ctxHandler = null;
+        }
+        this.handlers.clear();
+    }
+    getConnectionInfo() {
+        return {
+            status: this.service.isRunning ? 'connected' : 'disconnected',
+        };
+    }
+    async sendMessage(conversationId, content) {
+        const textBlock = content.blocks.find((b) => b.type === 'text');
+        const imageBlock = content.blocks.find((b) => b.type === 'image');
+        const documentBlock = content.blocks.find((b) => b.type === 'document');
+        let messageId;
+        if (imageBlock && imageBlock.type === 'image') {
+            const result = await this.service.sendPhoto(conversationId, imageBlock.url, {
+                caption: imageBlock.caption ?? textBlock?.text,
+            });
+            messageId = result.message_id;
+        }
+        else if (documentBlock && documentBlock.type === 'document') {
+            const result = await this.service.sendDocument(conversationId, documentBlock.url, {
+                caption: textBlock?.text,
+                filename: documentBlock.filename,
+            });
+            messageId = result.message_id;
+        }
+        else {
+            const text = textBlock?.text ?? '';
+            const result = await this.service.sendMessage(conversationId, text, {
+                replyToMessageId: content.replyToMessageId
+                    ? Number(content.replyToMessageId)
+                    : undefined,
+            });
+            messageId = result.message_id;
+        }
+        return { messageId: String(messageId), timestamp: new Date().toISOString() };
+    }
+    async sendTypingIndicator(conversationId, _isTyping) {
+        if (_isTyping) {
+            await this.service.sendChatAction(conversationId, 'typing');
+        }
+        // Telegram doesn't have a "stop typing" API — it auto-clears.
+    }
+    on(handler, eventTypes) {
+        this.handlers.set(handler, eventTypes);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    async editMessage(conversationId, messageId, content) {
+        const textBlock = content.blocks.find((b) => b.type === 'text');
+        if (textBlock && textBlock.type === 'text') {
+            await this.service.api.editMessageText(conversationId, Number(messageId), textBlock.text);
+        }
+    }
+    async deleteMessage(conversationId, messageId) {
+        await this.service.api.deleteMessage(conversationId, Number(messageId));
+    }
+    async addReaction(conversationId, messageId, emoji) {
+        await this.service.api.setMessageReaction(conversationId, Number(messageId), [
+            { type: 'emoji', emoji },
+        ]);
+    }
+    async getConversationInfo(conversationId) {
+        const chat = await this.service.api.getChat(conversationId);
+        const isGroup = ['group', 'supergroup'].includes(chat.type);
+        return {
+            name: chat.title ?? chat.first_name,
+            memberCount: isGroup ? await this.service.api.getChatMemberCount(conversationId) : undefined,
+            isGroup,
+            metadata: { type: chat.type, username: chat.username },
+        };
+    }
+    // ── Private ──
+    handleInboundMessage(ctx) {
+        const msg = ctx.message;
+        if (!msg)
+            return;
+        const sender = {
+            id: String(msg.from?.id ?? 'unknown'),
+            displayName: [msg.from?.first_name, msg.from?.last_name].filter(Boolean).join(' ') || undefined,
+            username: msg.from?.username,
+        };
+        // grammY's message typings can be narrower than Telegram's full chat-type
+        // union; treat it as a string to support channel posts consistently.
+        const chatType = msg.chat.type;
+        const conversationType = chatType === 'private' ? 'direct' :
+            chatType === 'channel' ? 'channel' : 'group';
+        const channelMessage = {
+            messageId: String(msg.message_id),
+            platform: 'telegram',
+            conversationId: String(msg.chat.id),
+            conversationType,
+            sender,
+            content: [{ type: 'text', text: msg.text ?? '' }],
+            text: msg.text ?? '',
+            timestamp: new Date(msg.date * 1000).toISOString(),
+            replyToMessageId: msg.reply_to_message
+                ? String(msg.reply_to_message.message_id)
+                : undefined,
+            rawEvent: ctx,
+        };
+        const event = {
+            type: 'message',
+            platform: 'telegram',
+            conversationId: String(msg.chat.id),
+            timestamp: channelMessage.timestamp,
+            data: channelMessage,
+        };
+        this.emit(event);
+    }
+    emit(event) {
+        for (const [handler, filter] of this.handlers) {
+            if (!filter || filter.includes(event.type)) {
+                Promise.resolve(handler(event)).catch((err) => {
+                    console.error('[TelegramChannelAdapter] Handler error:', err);
+                });
+            }
+        }
+    }
+}
+exports.TelegramChannelAdapter = TelegramChannelAdapter;
+//# sourceMappingURL=TelegramChannelAdapter.js.map

package/dist/TelegramChannelAdapter.js.map

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

package/dist/TelegramService.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Telegram SDK wrapper using grammY.
+ * Handles bot lifecycle, message sending, and rate limiting.
+ */
+import { type Api, type Context } from 'grammy';
+export interface TelegramChannelConfig {
+    botToken: string;
+    webhookUrl?: string;
+    pollingTimeout?: number;
+    defaultParseMode?: 'Markdown' | 'MarkdownV2' | 'HTML';
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+}
+export declare class TelegramService {
+    private bot;
+    private running;
+    private messageHandlers;
+    private rateMap;
+    private readonly config;
+    constructor(config: TelegramChannelConfig);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    get api(): Api;
+    get isRunning(): boolean;
+    onMessage(handler: (ctx: Context) => void): void;
+    offMessage(handler: (ctx: Context) => void): void;
+    sendMessage(chatId: string | number, text: string, options?: {
+        parseMode?: string;
+        replyToMessageId?: number;
+        replyMarkup?: unknown;
+        disableNotification?: boolean;
+    }): Promise<{
+        message_id: number;
+        chat: {
+            id: number;
+        };
+        date: number;
+        text?: string;
+    }>;
+    sendPhoto(chatId: string | number, photo: string, options?: {
+        caption?: string;
+        parseMode?: string;
+    }): Promise<{
+        message_id: number;
+    }>;
+    sendDocument(chatId: string | number, document: string, options?: {
+        caption?: string;
+        filename?: string;
+    }): Promise<{
+        message_id: number;
+    }>;
+    sendChatAction(chatId: string | number, action: string): Promise<void>;
+    getBotInfo(): Promise<{
+        id: number;
+        first_name: string;
+        username?: string;
+    }>;
+    private checkRateLimit;
+}
+//# sourceMappingURL=TelegramService.d.ts.map

package/dist/TelegramService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramService.d.ts","sourceRoot":"","sources":["../src/TelegramService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAO,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IACtD,SAAS,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAOD,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAEG;gBAEd,MAAM,EAAE,qBAAqB;IAQnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,IAAI,GAAG,IAAI,GAAG,CAGb;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIhD,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAK3C,WAAW,CACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,GACA,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAU/E,SAAS,CACb,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ5B,YAAY,CAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAO5B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,UAAU,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAKpE,cAAc;CAe7B"}

package/dist/TelegramService.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * @fileoverview Telegram SDK wrapper using grammY.
+ * Handles bot lifecycle, message sending, and rate limiting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramService = void 0;
+const grammy_1 = require("grammy");
+class TelegramService {
+    constructor(config) {
+        this.bot = null;
+        this.running = false;
+        this.messageHandlers = [];
+        this.rateMap = new Map();
+        this.config = {
+            ...config,
+            defaultParseMode: config.defaultParseMode ?? 'HTML',
+            rateLimit: config.rateLimit ?? { maxRequests: 30, windowMs: 1000 },
+        };
+    }
+    async initialize() {
+        if (this.running)
+            return;
+        this.bot = new grammy_1.Bot(this.config.botToken);
+        // Wire up inbound message handler
+        this.bot.on('message', (ctx) => {
+            for (const handler of this.messageHandlers) {
+                handler(ctx);
+            }
+        });
+        if (this.config.webhookUrl) {
+            await this.bot.api.setWebhook(this.config.webhookUrl);
+        }
+        else {
+            // Fire-and-forget polling start
+            this.bot.start({
+                drop_pending_updates: true,
+                onStart: () => { this.running = true; },
+            });
+        }
+        this.running = true;
+    }
+    async shutdown() {
+        if (!this.running || !this.bot)
+            return;
+        await this.bot.stop();
+        this.running = false;
+        this.bot = null;
+    }
+    get api() {
+        if (!this.bot)
+            throw new Error('TelegramService not initialized');
+        return this.bot.api;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    offMessage(handler) {
+        const idx = this.messageHandlers.indexOf(handler);
+        if (idx >= 0)
+            this.messageHandlers.splice(idx, 1);
+    }
+    async sendMessage(chatId, text, options) {
+        await this.checkRateLimit(String(chatId));
+        return this.api.sendMessage(chatId, text, {
+            parse_mode: (options?.parseMode ?? this.config.defaultParseMode),
+            reply_to_message_id: options?.replyToMessageId,
+            reply_markup: options?.replyMarkup,
+            disable_notification: options?.disableNotification,
+        });
+    }
+    async sendPhoto(chatId, photo, options) {
+        await this.checkRateLimit(String(chatId));
+        return this.api.sendPhoto(chatId, photo, {
+            caption: options?.caption,
+            parse_mode: (options?.parseMode ?? this.config.defaultParseMode),
+        });
+    }
+    async sendDocument(chatId, document, options) {
+        await this.checkRateLimit(String(chatId));
+        return this.api.sendDocument(chatId, document, {
+            caption: options?.caption,
+        });
+    }
+    async sendChatAction(chatId, action) {
+        await this.api.sendChatAction(chatId, action);
+    }
+    async getBotInfo() {
+        const me = await this.api.getMe();
+        return { id: me.id, first_name: me.first_name, username: me.username };
+    }
+    async checkRateLimit(key) {
+        const now = Date.now();
+        const state = this.rateMap.get(key);
+        if (!state || now >= state.resetAt) {
+            this.rateMap.set(key, { count: 1, resetAt: now + this.config.rateLimit.windowMs });
+            return;
+        }
+        if (state.count >= this.config.rateLimit.maxRequests) {
+            const waitMs = state.resetAt - now;
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+            this.rateMap.set(key, { count: 1, resetAt: Date.now() + this.config.rateLimit.windowMs });
+            return;
+        }
+        state.count++;
+    }
+}
+exports.TelegramService = TelegramService;
+//# sourceMappingURL=TelegramService.js.map

package/dist/TelegramService.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Telegram Channel Extension for AgentOS.
+ *
+ * Provides a bidirectional messaging channel adapter using grammY,
+ * plus ITool descriptors for programmatic message sending.
+ *
+ * @module @framers/agentos-ext-channel-telegram
+ */
+import type { ExtensionContext, ExtensionPack } from '@framers/agentos';
+import { TelegramService, type TelegramChannelConfig } from './TelegramService';
+import { TelegramChannelAdapter } from './TelegramChannelAdapter';
+import { TelegramSendMessageTool } from './tools/sendMessage';
+import { TelegramSendMediaTool } from './tools/sendMedia';
+export interface TelegramChannelOptions {
+    botToken?: string;
+    botTokenEnv?: string;
+    webhookUrl?: string;
+    pollingTimeout?: number;
+    defaultParseMode?: 'Markdown' | 'MarkdownV2' | 'HTML';
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+    priority?: number;
+}
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { TelegramService, TelegramChannelAdapter, TelegramSendMessageTool, TelegramSendMediaTool };
+export type { TelegramChannelConfig };
+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;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IACtD,SAAS,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAuC5E;AAED,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;AACnG,YAAY,EAAE,qBAAqB,EAAE,CAAC;AACtC,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @fileoverview Telegram Channel Extension for AgentOS.
+ *
+ * Provides a bidirectional messaging channel adapter using grammY,
+ * plus ITool descriptors for programmatic message sending.
+ *
+ * @module @framers/agentos-ext-channel-telegram
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramSendMediaTool = exports.TelegramSendMessageTool = exports.TelegramChannelAdapter = exports.TelegramService = void 0;
+exports.createExtensionPack = createExtensionPack;
+const TelegramService_1 = require("./TelegramService");
+Object.defineProperty(exports, "TelegramService", { enumerable: true, get: function () { return TelegramService_1.TelegramService; } });
+const TelegramChannelAdapter_1 = require("./TelegramChannelAdapter");
+Object.defineProperty(exports, "TelegramChannelAdapter", { enumerable: true, get: function () { return TelegramChannelAdapter_1.TelegramChannelAdapter; } });
+const sendMessage_1 = require("./tools/sendMessage");
+Object.defineProperty(exports, "TelegramSendMessageTool", { enumerable: true, get: function () { return sendMessage_1.TelegramSendMessageTool; } });
+const sendMedia_1 = require("./tools/sendMedia");
+Object.defineProperty(exports, "TelegramSendMediaTool", { enumerable: true, get: function () { return sendMedia_1.TelegramSendMediaTool; } });
+function resolveBotToken(options, secrets) {
+    if (options.botToken)
+        return options.botToken;
+    // Check secrets map from registry
+    if (secrets?.['telegram.botToken'])
+        return secrets['telegram.botToken'];
+    // Environment variable fallback
+    const envName = options.botTokenEnv ?? 'TELEGRAM_BOT_TOKEN';
+    const envValue = process.env[envName];
+    if (envValue)
+        return envValue;
+    // Common variations
+    for (const v of ['TELEGRAM_BOT_TOKEN', 'TELEGRAM_TOKEN']) {
+        if (process.env[v])
+            return process.env[v];
+    }
+    throw new Error('Telegram bot token not found. Provide via options.botToken, secrets["telegram.botToken"], or TELEGRAM_BOT_TOKEN env var.');
+}
+function createExtensionPack(context) {
+    const options = (context.options ?? {});
+    const botToken = resolveBotToken(options, options.secrets);
+    const config = {
+        botToken,
+        webhookUrl: options.webhookUrl,
+        pollingTimeout: options.pollingTimeout,
+        defaultParseMode: options.defaultParseMode ?? 'HTML',
+        rateLimit: options.rateLimit ?? { maxRequests: 30, windowMs: 1000 },
+    };
+    const service = new TelegramService_1.TelegramService(config);
+    const adapter = new TelegramChannelAdapter_1.TelegramChannelAdapter(service);
+    const sendMessageTool = new sendMessage_1.TelegramSendMessageTool(service);
+    const sendMediaTool = new sendMedia_1.TelegramSendMediaTool(service);
+    const priority = options.priority ?? 50;
+    return {
+        name: '@framers/agentos-ext-channel-telegram',
+        version: '0.1.0',
+        descriptors: [
+            { id: 'telegramChannelSendMessage', kind: 'tool', priority, payload: sendMessageTool },
+            { id: 'telegramChannelSendMedia', kind: 'tool', priority, payload: sendMediaTool },
+            { id: 'telegramChannel', kind: 'messaging-channel', priority, payload: adapter },
+        ],
+        onActivate: async () => {
+            await service.initialize();
+            // Wire adapter event listeners after service is running
+            await adapter.initialize({ platform: 'telegram', credential: botToken });
+            context.logger?.info('[TelegramChannel] Extension activated');
+        },
+        onDeactivate: async () => {
+            await adapter.shutdown();
+            await service.shutdown();
+            context.logger?.info('[TelegramChannel] Extension deactivated');
+        },
+    };
+}
+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":"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"}

package/dist/tools/sendMedia.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview ITool for sending media (photo, document, video) via the Telegram channel adapter.
+ */
+import type { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { TelegramService } from '../TelegramService';
+export declare class TelegramSendMediaTool implements ITool {
+    private readonly service;
+    readonly id = "telegramChannelSendMedia";
+    readonly name = "telegramChannelSendMedia";
+    readonly displayName = "Send Telegram Media";
+    readonly description = "Send a photo or document to a Telegram chat via the channel adapter.";
+    readonly category = "communication";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        required: readonly ["chatId", "mediaType", "url"];
+        properties: {
+            chatId: {
+                type: string;
+                description: string;
+            };
+            mediaType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            url: {
+                type: string;
+                description: string;
+            };
+            caption: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: "object";
+        properties: {
+            messageId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(service: TelegramService);
+    execute(args: {
+        chatId: string;
+        mediaType: 'photo' | 'document';
+        url: string;
+        caption?: string;
+        filename?: string;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    validateArgs(args: Record<string, any>): {
+        isValid: boolean;
+        errors?: string[];
+    };
+}
+//# sourceMappingURL=sendMedia.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendMedia.d.ts","sourceRoot":"","sources":["../../src/tools/sendMedia.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAAa,qBAAsB,YAAW,KAAK;IA4BrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3BpC,SAAgB,EAAE,8BAA8B;IAChD,SAAgB,IAAI,8BAA8B;IAClD,SAAgB,WAAW,yBAAyB;IACpD,SAAgB,WAAW,0EAA0E;IACrG,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MAUzB;IAEF,SAAgB,YAAY;;;;;;;;MAK1B;gBAE2B,OAAO,EAAE,eAAe;IAE/C,OAAO,CACX,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3G,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAmB/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;CASjF"}

package/dist/tools/sendMedia.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * @fileoverview ITool for sending media (photo, document, video) via the Telegram channel adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramSendMediaTool = void 0;
+class TelegramSendMediaTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'telegramChannelSendMedia';
+        this.name = 'telegramChannelSendMedia';
+        this.displayName = 'Send Telegram Media';
+        this.description = 'Send a photo or document to a Telegram chat via the channel adapter.';
+        this.category = 'communication';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['chatId', 'mediaType', 'url'],
+            properties: {
+                chatId: { type: 'string', description: 'Target chat ID' },
+                mediaType: { type: 'string', enum: ['photo', 'document'], description: 'Type of media to send' },
+                url: { type: 'string', description: 'URL or file_id of the media' },
+                caption: { type: 'string', description: 'Optional caption' },
+                filename: { type: 'string', description: 'Filename (documents only)' },
+            },
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                messageId: { type: 'number', description: 'Sent message ID' },
+            },
+        };
+    }
+    async execute(args, _context) {
+        try {
+            let result;
+            if (args.mediaType === 'photo') {
+                result = await this.service.sendPhoto(args.chatId, args.url, { caption: args.caption });
+            }
+            else {
+                result = await this.service.sendDocument(args.chatId, args.url, {
+                    caption: args.caption,
+                    filename: args.filename,
+                });
+            }
+            return { success: true, output: { messageId: result.message_id } };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    validateArgs(args) {
+        const errors = [];
+        if (!args.chatId)
+            errors.push('chatId is required');
+        if (!args.mediaType || !['photo', 'document'].includes(args.mediaType)) {
+            errors.push('mediaType must be "photo" or "document"');
+        }
+        if (!args.url)
+            errors.push('url is required');
+        return { isValid: errors.length === 0, errors };
+    }
+}
+exports.TelegramSendMediaTool = TelegramSendMediaTool;
+//# sourceMappingURL=sendMedia.js.map

package/dist/tools/sendMedia.js.map

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

package/dist/tools/sendMessage.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview ITool for sending text messages via the Telegram channel adapter.
+ */
+import type { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { TelegramService } from '../TelegramService';
+export declare class TelegramSendMessageTool implements ITool {
+    private readonly service;
+    readonly id = "telegramChannelSendMessage";
+    readonly name = "telegramChannelSendMessage";
+    readonly displayName = "Send Telegram Message";
+    readonly description = "Send a text message to a Telegram chat via the channel adapter.";
+    readonly category = "communication";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        required: readonly ["chatId", "text"];
+        properties: {
+            chatId: {
+                type: string;
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+            parseMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            replyToMessageId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: "object";
+        properties: {
+            messageId: {
+                type: string;
+                description: string;
+            };
+            chatId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(service: TelegramService);
+    execute(args: {
+        chatId: string;
+        text: string;
+        parseMode?: string;
+        replyToMessageId?: number;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    validateArgs(args: Record<string, 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,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAAa,uBAAwB,YAAW,KAAK;IA4BvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3BpC,SAAgB,EAAE,gCAAgC;IAClD,SAAgB,IAAI,gCAAgC;IACpD,SAAgB,WAAW,2BAA2B;IACtD,SAAgB,WAAW,qEAAqE;IAChG,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;MASzB;IAEF,SAAgB,YAAY;;;;;;;;;;;;MAM1B;gBAE2B,OAAO,EAAE,eAAe;IAE/C,OAAO,CACX,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,EACrF,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAoB/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;CAQjF"}

package/dist/tools/sendMessage.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * @fileoverview ITool for sending text messages via the Telegram channel adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramSendMessageTool = void 0;
+class TelegramSendMessageTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'telegramChannelSendMessage';
+        this.name = 'telegramChannelSendMessage';
+        this.displayName = 'Send Telegram Message';
+        this.description = 'Send a text message to a Telegram chat via the channel adapter.';
+        this.category = 'communication';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['chatId', 'text'],
+            properties: {
+                chatId: { type: 'string', description: 'Target chat ID' },
+                text: { type: 'string', description: 'Message text (max 4096 chars)' },
+                parseMode: { type: 'string', enum: ['Markdown', 'MarkdownV2', 'HTML'], description: 'Parse mode' },
+                replyToMessageId: { type: 'number', description: 'Reply to message ID' },
+            },
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                messageId: { type: 'number', description: 'Sent message ID' },
+                chatId: { type: 'string', description: 'Target chat ID' },
+            },
+        };
+    }
+    async execute(args, _context) {
+        try {
+            if (args.text.length > 4096) {
+                throw new Error('Message text exceeds 4096 character limit');
+            }
+            const result = await this.service.sendMessage(args.chatId, args.text, {
+                parseMode: args.parseMode,
+                replyToMessageId: args.replyToMessageId,
+            });
+            return {
+                success: true,
+                output: { messageId: result.message_id, chatId: args.chatId },
+            };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    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 4096 character limit');
+        return { isValid: errors.length === 0, errors };
+    }
+}
+exports.TelegramSendMessageTool = TelegramSendMessageTool;
+//# 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":";AAAA;;GAEG;;;AAKH,MAAa,uBAAuB;IA4BlC,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QA3BrC,OAAE,GAAG,4BAA4B,CAAC;QAClC,SAAI,GAAG,4BAA4B,CAAC;QACpC,gBAAW,GAAG,uBAAuB,CAAC;QACtC,gBAAW,GAAG,iEAAiE,CAAC;QAChF,aAAQ,GAAG,eAAe,CAAC;QAC3B,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,IAAI,CAAC;QAEtB,gBAAW,GAAG;YAC5B,IAAI,EAAE,QAAiB;YACvB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAU;YACrC,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;gBACzD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;gBACtE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE;gBAClG,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;aACzE;SACF,CAAC;QAEc,iBAAY,GAAG;YAC7B,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;aAC1D;SACF,CAAC;IAEsD,CAAC;IAEzD,KAAK,CAAC,OAAO,CACX,IAAqF,EACrF,QAA8B;QAE9B,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE;gBACpE,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;aACxC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;aAC9D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAyB;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;aAC3C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;aACxE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;CACF;AA7DD,0DA6DC"}

package/manifest.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.channels.telegram",
+  "name": "Telegram Channel Extension",
+  "version": "0.1.0",
+  "description": "Bidirectional Telegram messaging via grammY — supports text, images, documents, inline keyboards, and groups.",
+  "categories": ["channel", "communication"],
+  "platforms": ["telegram"],
+  "sdk": "grammy",
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "telegramChannelSendMessage",
+      "displayName": "Send Telegram Message"
+    },
+    {
+      "kind": "tool",
+      "id": "telegramChannelSendMedia",
+      "displayName": "Send Telegram Media"
+    },
+    {
+      "kind": "messaging-channel",
+      "id": "telegramChannel",
+      "displayName": "Telegram Channel Adapter"
+    }
+  ],
+  "requiredSecrets": ["telegram.botToken"],
+  "features": [
+    "Text messages with Markdown/HTML formatting",
+    "Photo and document sending",
+    "Rate limiting with queue management",
+    "Webhook and polling support",
+    "Group chat and channel support",
+    "Message editing and deletion",
+    "Inline keyboard interactions",
+    "Typing indicators"
+  ]
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@framers/agentos-ext-channel-telegram",
+  "version": "0.1.0",
+  "description": "Telegram messaging channel adapter for AgentOS — bidirectional messaging via grammY",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["agentos", "extension", "channel", "telegram", "grammy", "messaging"],
+  "author": { "name": "Framers AI", "url": "https://frame.dev" },
+  "license": "MIT",
+  "files": ["dist", "manifest.json"],
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "dependencies": {
+    "grammy": "^1.21.0"
+  },
+  "devDependencies": {
+    "@framers/agentos": "workspace:*",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": { "node": ">=18.0.0" }
+}