@operor/provider-telegram 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import EventEmitter from "eventemitter3";
+import { MessageProvider, OutgoingMessage } from "@operor/core";
+
+//#region src/TelegramProvider.d.ts
+interface TelegramProviderConfig {
+  botToken: string;
+  /** Optional webhook URL. If not set, uses long polling. */
+  webhookUrl?: string;
+}
+declare class TelegramProvider extends EventEmitter implements MessageProvider {
+  readonly name = "telegram";
+  private bot;
+  private config;
+  private connected;
+  constructor(config: TelegramProviderConfig);
+  connect(): Promise<void>;
+  disconnect(): Promise<void>;
+  sendTypingIndicator(to: string): Promise<void>;
+  sendMessage(to: string, message: OutgoingMessage): Promise<void>;
+  isActive(): boolean;
+}
+//#endregion
+export { TelegramProvider, type TelegramProviderConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/TelegramProvider.ts"],"mappings":";;;;UAIiB,sBAAA;EACf,QAAA;EADe;EAGf,UAAA;AAAA;AAAA,cAGW,gBAAA,SAAyB,YAAA,YAAwB,eAAA;EAAA,SAC5C,IAAA;EAAA,QACR,GAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;cAEI,MAAA,EAAQ,sBAAA;EAMd,OAAA,CAAA,GAAW,OAAA;EAoDX,UAAA,CAAA,GAAc,OAAA;EAMd,mBAAA,CAAoB,EAAA,WAAa,OAAA;EAWjC,WAAA,CAAY,EAAA,UAAY,OAAA,EAAS,eAAA,GAAkB,OAAA;EAczD,QAAA,CAAA;AAAA"}

package/dist/index.js

@@ -0,0 +1,81 @@
+import EventEmitter from "eventemitter3";
+import { Bot } from "grammy";
+
+//#region src/TelegramProvider.ts
+var TelegramProvider = class extends EventEmitter {
+	name = "telegram";
+	bot;
+	config;
+	connected = false;
+	constructor(config) {
+		super();
+		this.config = config;
+		this.bot = new Bot(config.botToken);
+	}
+	async connect() {
+		this.bot.on("message:text", (ctx) => {
+			const msg = {
+				id: String(ctx.message.message_id),
+				from: String(ctx.from?.id || ctx.chat.id),
+				text: ctx.message.text,
+				timestamp: ctx.message.date * 1e3,
+				channel: "telegram",
+				provider: this.name,
+				metadata: {
+					chatId: ctx.chat.id,
+					username: ctx.from?.username,
+					firstName: ctx.from?.first_name,
+					lastName: ctx.from?.last_name
+				}
+			};
+			console.log(`\n📥 [Telegram] New message from ${ctx.from?.first_name || ctx.from?.username || msg.from}`);
+			console.log(`   Message: "${msg.text}"`);
+			this.emit("message", msg);
+		});
+		this.bot.catch((err) => {
+			console.error("❌ [Telegram] Bot error:", err.message);
+			this.emit("error", err);
+		});
+		if (this.config.webhookUrl) {
+			await this.bot.api.setWebhook(this.config.webhookUrl);
+			console.log(`✅ Telegram bot connected (webhook: ${this.config.webhookUrl})`);
+		} else {
+			this.bot.start({ onStart: () => {
+				console.log("✅ Telegram bot connected (long polling)");
+				this.connected = true;
+				this.emit("ready");
+			} });
+			this.connected = true;
+			return;
+		}
+		this.connected = true;
+		this.emit("ready");
+	}
+	async disconnect() {
+		await this.bot.stop();
+		this.connected = false;
+		console.log("Telegram bot disconnected");
+	}
+	async sendTypingIndicator(to) {
+		if (!this.connected) return;
+		const chatId = parseInt(to, 10);
+		if (isNaN(chatId)) return;
+		try {
+			await this.bot.api.sendChatAction(chatId, "typing");
+		} catch {}
+	}
+	async sendMessage(to, message) {
+		if (!this.connected) throw new Error("Telegram bot not connected");
+		const chatId = parseInt(to, 10);
+		if (isNaN(chatId)) throw new Error(`Invalid Telegram chat ID: "${to}" — must be numeric`);
+		await this.bot.api.sendMessage(chatId, message.text);
+		console.log(`📤 [Telegram] Sent reply to ${to}`);
+	}
+	isActive() {
+		return this.connected;
+	}
+};
+
+//#endregion
+export { TelegramProvider };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/TelegramProvider.ts"],"sourcesContent":["import EventEmitter from 'eventemitter3';\nimport { Bot } from 'grammy';\nimport type { MessageProvider, IncomingMessage, OutgoingMessage } from '@operor/core';\n\nexport interface TelegramProviderConfig {\n  botToken: string;\n  /** Optional webhook URL. If not set, uses long polling. */\n  webhookUrl?: string;\n}\n\nexport class TelegramProvider extends EventEmitter implements MessageProvider {\n  public readonly name = 'telegram';\n  private bot: Bot;\n  private config: TelegramProviderConfig;\n  private connected = false;\n\n  constructor(config: TelegramProviderConfig) {\n    super();\n    this.config = config;\n    this.bot = new Bot(config.botToken);\n  }\n\n  async connect(): Promise<void> {\n    // Listen for text messages\n    this.bot.on('message:text', (ctx) => {\n      const msg: IncomingMessage = {\n        id: String(ctx.message.message_id),\n        from: String(ctx.from?.id || ctx.chat.id),\n        text: ctx.message.text,\n        timestamp: ctx.message.date * 1000,\n        channel: 'telegram',\n        provider: this.name,\n        metadata: {\n          chatId: ctx.chat.id,\n          username: ctx.from?.username,\n          firstName: ctx.from?.first_name,\n          lastName: ctx.from?.last_name,\n        },\n      };\n\n      console.log(`\\n📥 [Telegram] New message from ${ctx.from?.first_name || ctx.from?.username || msg.from}`);\n      console.log(`   Message: \"${msg.text}\"`);\n\n      this.emit('message', msg);\n    });\n\n    // Error handling\n    this.bot.catch((err) => {\n      console.error('❌ [Telegram] Bot error:', err.message);\n      this.emit('error', err);\n    });\n\n    // Start bot\n    if (this.config.webhookUrl) {\n      await this.bot.api.setWebhook(this.config.webhookUrl);\n      console.log(`✅ Telegram bot connected (webhook: ${this.config.webhookUrl})`);\n    } else {\n      // Long polling for development — non-blocking start\n      this.bot.start({\n        onStart: () => {\n          console.log('✅ Telegram bot connected (long polling)');\n          this.connected = true;\n          this.emit('ready');\n        },\n      });\n      // bot.start() is non-blocking in grammY, but onStart fires after first poll\n      this.connected = true;\n      return;\n    }\n\n    this.connected = true;\n    this.emit('ready');\n  }\n\n  async disconnect(): Promise<void> {\n    await this.bot.stop();\n    this.connected = false;\n    console.log('Telegram bot disconnected');\n  }\n\n  async sendTypingIndicator(to: string): Promise<void> {\n    if (!this.connected) return;\n    const chatId = parseInt(to, 10);\n    if (isNaN(chatId)) return;\n    try {\n      await this.bot.api.sendChatAction(chatId, 'typing');\n    } catch {\n      // Non-critical — silently ignore failures\n    }\n  }\n\n  async sendMessage(to: string, message: OutgoingMessage): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Telegram bot not connected');\n    }\n\n    const chatId = parseInt(to, 10);\n    if (isNaN(chatId)) {\n      throw new Error(`Invalid Telegram chat ID: \"${to}\" — must be numeric`);\n    }\n    await this.bot.api.sendMessage(chatId, message.text);\n\n    console.log(`📤 [Telegram] Sent reply to ${to}`);\n  }\n\n  isActive(): boolean {\n    return this.connected;\n  }\n}\n"],"mappings":";;;;AAUA,IAAa,mBAAb,cAAsC,aAAwC;CAC5E,AAAgB,OAAO;CACvB,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAY;CAEpB,YAAY,QAAgC;AAC1C,SAAO;AACP,OAAK,SAAS;AACd,OAAK,MAAM,IAAI,IAAI,OAAO,SAAS;;CAGrC,MAAM,UAAyB;AAE7B,OAAK,IAAI,GAAG,iBAAiB,QAAQ;GACnC,MAAM,MAAuB;IAC3B,IAAI,OAAO,IAAI,QAAQ,WAAW;IAClC,MAAM,OAAO,IAAI,MAAM,MAAM,IAAI,KAAK,GAAG;IACzC,MAAM,IAAI,QAAQ;IAClB,WAAW,IAAI,QAAQ,OAAO;IAC9B,SAAS;IACT,UAAU,KAAK;IACf,UAAU;KACR,QAAQ,IAAI,KAAK;KACjB,UAAU,IAAI,MAAM;KACpB,WAAW,IAAI,MAAM;KACrB,UAAU,IAAI,MAAM;KACrB;IACF;AAED,WAAQ,IAAI,oCAAoC,IAAI,MAAM,cAAc,IAAI,MAAM,YAAY,IAAI,OAAO;AACzG,WAAQ,IAAI,gBAAgB,IAAI,KAAK,GAAG;AAExC,QAAK,KAAK,WAAW,IAAI;IACzB;AAGF,OAAK,IAAI,OAAO,QAAQ;AACtB,WAAQ,MAAM,2BAA2B,IAAI,QAAQ;AACrD,QAAK,KAAK,SAAS,IAAI;IACvB;AAGF,MAAI,KAAK,OAAO,YAAY;AAC1B,SAAM,KAAK,IAAI,IAAI,WAAW,KAAK,OAAO,WAAW;AACrD,WAAQ,IAAI,sCAAsC,KAAK,OAAO,WAAW,GAAG;SACvE;AAEL,QAAK,IAAI,MAAM,EACb,eAAe;AACb,YAAQ,IAAI,0CAA0C;AACtD,SAAK,YAAY;AACjB,SAAK,KAAK,QAAQ;MAErB,CAAC;AAEF,QAAK,YAAY;AACjB;;AAGF,OAAK,YAAY;AACjB,OAAK,KAAK,QAAQ;;CAGpB,MAAM,aAA4B;AAChC,QAAM,KAAK,IAAI,MAAM;AACrB,OAAK,YAAY;AACjB,UAAQ,IAAI,4BAA4B;;CAG1C,MAAM,oBAAoB,IAA2B;AACnD,MAAI,CAAC,KAAK,UAAW;EACrB,MAAM,SAAS,SAAS,IAAI,GAAG;AAC/B,MAAI,MAAM,OAAO,CAAE;AACnB,MAAI;AACF,SAAM,KAAK,IAAI,IAAI,eAAe,QAAQ,SAAS;UAC7C;;CAKV,MAAM,YAAY,IAAY,SAAyC;AACrE,MAAI,CAAC,KAAK,UACR,OAAM,IAAI,MAAM,6BAA6B;EAG/C,MAAM,SAAS,SAAS,IAAI,GAAG;AAC/B,MAAI,MAAM,OAAO,CACf,OAAM,IAAI,MAAM,8BAA8B,GAAG,qBAAqB;AAExE,QAAM,KAAK,IAAI,IAAI,YAAY,QAAQ,QAAQ,KAAK;AAEpD,UAAQ,IAAI,+BAA+B,KAAK;;CAGlD,WAAoB;AAClB,SAAO,KAAK"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@operor/provider-telegram",
+  "version": "0.1.0",
+  "description": "Telegram provider for Agent OS using grammY",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "grammy": "^1.35.0",
+    "@operor/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.20.3",
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  }
+}

package/src/TelegramProvider.ts

@@ -0,0 +1,109 @@
+import EventEmitter from 'eventemitter3';
+import { Bot } from 'grammy';
+import type { MessageProvider, IncomingMessage, OutgoingMessage } from '@operor/core';
+
+export interface TelegramProviderConfig {
+  botToken: string;
+  /** Optional webhook URL. If not set, uses long polling. */
+  webhookUrl?: string;
+}
+
+export class TelegramProvider extends EventEmitter implements MessageProvider {
+  public readonly name = 'telegram';
+  private bot: Bot;
+  private config: TelegramProviderConfig;
+  private connected = false;
+
+  constructor(config: TelegramProviderConfig) {
+    super();
+    this.config = config;
+    this.bot = new Bot(config.botToken);
+  }
+
+  async connect(): Promise<void> {
+    // Listen for text messages
+    this.bot.on('message:text', (ctx) => {
+      const msg: IncomingMessage = {
+        id: String(ctx.message.message_id),
+        from: String(ctx.from?.id || ctx.chat.id),
+        text: ctx.message.text,
+        timestamp: ctx.message.date * 1000,
+        channel: 'telegram',
+        provider: this.name,
+        metadata: {
+          chatId: ctx.chat.id,
+          username: ctx.from?.username,
+          firstName: ctx.from?.first_name,
+          lastName: ctx.from?.last_name,
+        },
+      };
+
+      console.log(`\n📥 [Telegram] New message from ${ctx.from?.first_name || ctx.from?.username || msg.from}`);
+      console.log(`   Message: "${msg.text}"`);
+
+      this.emit('message', msg);
+    });
+
+    // Error handling
+    this.bot.catch((err) => {
+      console.error('❌ [Telegram] Bot error:', err.message);
+      this.emit('error', err);
+    });
+
+    // Start bot
+    if (this.config.webhookUrl) {
+      await this.bot.api.setWebhook(this.config.webhookUrl);
+      console.log(`✅ Telegram bot connected (webhook: ${this.config.webhookUrl})`);
+    } else {
+      // Long polling for development — non-blocking start
+      this.bot.start({
+        onStart: () => {
+          console.log('✅ Telegram bot connected (long polling)');
+          this.connected = true;
+          this.emit('ready');
+        },
+      });
+      // bot.start() is non-blocking in grammY, but onStart fires after first poll
+      this.connected = true;
+      return;
+    }
+
+    this.connected = true;
+    this.emit('ready');
+  }
+
+  async disconnect(): Promise<void> {
+    await this.bot.stop();
+    this.connected = false;
+    console.log('Telegram bot disconnected');
+  }
+
+  async sendTypingIndicator(to: string): Promise<void> {
+    if (!this.connected) return;
+    const chatId = parseInt(to, 10);
+    if (isNaN(chatId)) return;
+    try {
+      await this.bot.api.sendChatAction(chatId, 'typing');
+    } catch {
+      // Non-critical — silently ignore failures
+    }
+  }
+
+  async sendMessage(to: string, message: OutgoingMessage): Promise<void> {
+    if (!this.connected) {
+      throw new Error('Telegram bot not connected');
+    }
+
+    const chatId = parseInt(to, 10);
+    if (isNaN(chatId)) {
+      throw new Error(`Invalid Telegram chat ID: "${to}" — must be numeric`);
+    }
+    await this.bot.api.sendMessage(chatId, message.text);
+
+    console.log(`📤 [Telegram] Sent reply to ${to}`);
+  }
+
+  isActive(): boolean {
+    return this.connected;
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { TelegramProvider } from './TelegramProvider.js';
+export type { TelegramProviderConfig } from './TelegramProvider.js';

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  outExtensions: () => ({ js: '.js', dts: '.d.ts' }),
+});