@agentick/connector-telegram 0.5.0

package/README.md

@@ -0,0 +1,97 @@
+# @agentick/connector-telegram
+
+Telegram platform adapter for the Agentick connector system. Bridge a Telegram
+bot to an agent session.
+
+## Install
+
+```sh
+pnpm add @agentick/connector-telegram grammy
+```
+
+`grammy` is a peer dependency.
+
+## Usage
+
+```typescript
+import { createConnector } from "@agentick/connector";
+import { TelegramPlatform } from "@agentick/connector-telegram";
+
+const connector = createConnector(
+  client,
+  new TelegramPlatform({
+    token: process.env.TELEGRAM_BOT_TOKEN!,
+    allowedUsers: [parseInt(process.env.TELEGRAM_USER_ID!)],
+  }),
+  {
+    sessionId: "main",
+    contentPolicy: "summarized",
+    deliveryStrategy: "debounced",
+    debounceMs: 2000,
+  },
+);
+
+await connector.start();
+```
+
+## Options
+
+```typescript
+interface TelegramConnectorOptions {
+  token: string;
+  allowedUsers?: number[];
+  chatId?: number;
+  confirmationStyle?: "inline-keyboard" | "text";
+}
+```
+
+**`token`** — Telegram bot token from [@BotFather](https://t.me/BotFather).
+
+**`allowedUsers`** — Whitelist of Telegram user IDs. Empty array allows all
+users. Get your ID from [@userinfobot](https://t.me/userinfobot).
+
+**`chatId`** — Specific chat to use. If omitted, auto-detects from the first
+incoming message.
+
+**`confirmationStyle`** — How tool confirmations are presented. Default:
+`"inline-keyboard"`.
+
+## Tool Confirmations
+
+### Inline Keyboard (default)
+
+Sends a message with Approve/Deny buttons. The user taps a button, the
+confirmation resolves.
+
+### Text-based
+
+Sends a text prompt. The next message from the user is parsed as the
+confirmation response. Supports natural language — "yes but skip tests" is
+approved with the full text as reason.
+
+## Recommended Config
+
+For a conversational bot experience:
+
+```typescript
+{
+  contentPolicy: "summarized",   // collapse tool calls into brief summaries
+  deliveryStrategy: "debounced", // wait for a pause before sending
+  debounceMs: 2000,
+}
+```
+
+For a long-running agent that reports results:
+
+```typescript
+{
+  contentPolicy: "text-only",    // only deliver text, no tool noise
+  deliveryStrategy: "on-idle",   // deliver only when execution completes
+}
+```
+
+## Exports
+
+```typescript
+export { TelegramPlatform, type TelegramConnectorOptions } from "./telegram-platform.js";
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { TelegramPlatform, type TelegramConnectorOptions } from "./telegram-platform.js";
+export { escapeMarkdownV2 } from "./telegram-format.js";
+//# 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,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { TelegramPlatform } from "./telegram-platform.js";
+export { escapeMarkdownV2 } from "./telegram-format.js";
+//# 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,OAAO,EAAE,gBAAgB,EAAiC,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/telegram-format.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Escape text for Telegram MarkdownV2 parse mode.
+ *
+ * All special characters are prefixed with a backslash.
+ */
+export declare function escapeMarkdownV2(text: string): string;
+//# sourceMappingURL=telegram-format.d.ts.map

package/dist/telegram-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-format.d.ts","sourceRoot":"","sources":["../src/telegram-format.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/telegram-format.js

@@ -0,0 +1,14 @@
+/**
+ * Characters that must be escaped in Telegram MarkdownV2.
+ * @see https://core.telegram.org/bots/api#markdownv2-style
+ */
+const MARKDOWN_V2_SPECIAL = /[_*[\]()~`>#+\-=|{}.!]/g;
+/**
+ * Escape text for Telegram MarkdownV2 parse mode.
+ *
+ * All special characters are prefixed with a backslash.
+ */
+export function escapeMarkdownV2(text) {
+    return text.replace(MARKDOWN_V2_SPECIAL, "\\$&");
+}
+//# sourceMappingURL=telegram-format.js.map

package/dist/telegram-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-format.js","sourceRoot":"","sources":["../src/telegram-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/telegram-platform.d.ts

@@ -0,0 +1,37 @@
+import type { ConnectorPlatform, ConnectorBridge, ConnectorStatus } from "@agentick/connector";
+export interface TelegramConnectorOptions {
+    /** Telegram bot token. */
+    token: string;
+    /** Whitelist of allowed Telegram user IDs. Empty = allow all. */
+    allowedUsers?: number[];
+    /** Specific chat ID to use. If omitted, auto-detects from first message. */
+    chatId?: number;
+    /** How to present tool confirmations. Default: "inline-keyboard". */
+    confirmationStyle?: "inline-keyboard" | "text";
+}
+/**
+ * Telegram platform adapter for the Agentick connector system.
+ *
+ * Receives messages from a Telegram bot and delivers agent responses
+ * back as Telegram messages. Tool confirmations can use inline keyboards
+ * or text-based confirmation.
+ */
+export declare class TelegramPlatform implements ConnectorPlatform {
+    private readonly _bot;
+    private readonly _allowedUsers;
+    private readonly _confirmationStyle;
+    private _chatId;
+    private _bridge;
+    private _status;
+    /** Pending inline-keyboard confirmations keyed by toolUseId. */
+    private _pendingKeyboardConfirmations;
+    /** Pending text-based confirmation (only one at a time). */
+    private _pendingTextConfirmation;
+    constructor(options: TelegramConnectorOptions);
+    get status(): ConnectorStatus;
+    start(bridge: ConnectorBridge): Promise<void>;
+    stop(): Promise<void>;
+    private _handleDelivery;
+    private _handleConfirmation;
+}
+//# sourceMappingURL=telegram-platform.d.ts.map

package/dist/telegram-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-platform.d.ts","sourceRoot":"","sources":["../src/telegram-platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAEf,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CAChD;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,OAAO,CAAmC;IAElD,gEAAgE;IAChE,OAAO,CAAC,6BAA6B,CAGjC;IAEJ,4DAA4D;IAC5D,OAAO,CAAC,wBAAwB,CAEhB;gBAEJ,OAAO,EAAE,wBAAwB;IAO7C,IAAI,MAAM,IAAI,eAAe,CAE5B;IAEK,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUb,eAAe;YAcf,mBAAmB;CA6BlC"}

package/dist/telegram-platform.js

@@ -0,0 +1,156 @@
+import { Bot, InlineKeyboard } from "grammy";
+import { extractText, splitMessage, parseTextConfirmation, formatConfirmationMessage, } from "@agentick/connector";
+const TELEGRAM_MAX_LENGTH = 4096;
+/**
+ * Telegram platform adapter for the Agentick connector system.
+ *
+ * Receives messages from a Telegram bot and delivers agent responses
+ * back as Telegram messages. Tool confirmations can use inline keyboards
+ * or text-based confirmation.
+ */
+export class TelegramPlatform {
+    _bot;
+    _allowedUsers;
+    _confirmationStyle;
+    _chatId;
+    _bridge = null;
+    _status = "disconnected";
+    /** Pending inline-keyboard confirmations keyed by toolUseId. */
+    _pendingKeyboardConfirmations = new Map();
+    /** Pending text-based confirmation (only one at a time). */
+    _pendingTextConfirmation = null;
+    constructor(options) {
+        this._bot = new Bot(options.token);
+        this._allowedUsers = new Set(options.allowedUsers ?? []);
+        this._chatId = options.chatId ?? null;
+        this._confirmationStyle = options.confirmationStyle ?? "inline-keyboard";
+    }
+    get status() {
+        return this._status;
+    }
+    async start(bridge) {
+        this._bridge = bridge;
+        this._status = "connecting";
+        bridge.reportStatus("connecting");
+        // Handle text messages
+        this._bot.on("message:text", async (ctx) => {
+            const userId = ctx.from.id;
+            const chatId = ctx.chat.id;
+            if (this._allowedUsers.size > 0 && !this._allowedUsers.has(userId)) {
+                return;
+            }
+            if (this._chatId === null) {
+                this._chatId = chatId;
+            }
+            if (chatId !== this._chatId)
+                return;
+            const text = ctx.message.text;
+            // Text-based confirmation response
+            if (this._pendingTextConfirmation) {
+                const { respond } = this._pendingTextConfirmation;
+                this._pendingTextConfirmation = null;
+                respond(parseTextConfirmation(text));
+                return;
+            }
+            bridge.send(text);
+        });
+        // Single callback query handler — routes to pending confirmations by toolUseId
+        this._bot.on("callback_query:data", async (ctx) => {
+            const data = ctx.callbackQuery.data;
+            if (!data.startsWith("confirm:"))
+                return;
+            // Always answer the callback query to dismiss the loading spinner,
+            // even if the confirmation is already resolved (double-click race)
+            await ctx.answerCallbackQuery();
+            // Parse confirm:<toolUseId>:<action> — toolUseId may contain colons
+            const lastColon = data.lastIndexOf(":");
+            const toolUseId = data.slice(8, lastColon); // 8 = "confirm:".length
+            const action = data.slice(lastColon + 1);
+            const pending = this._pendingKeyboardConfirmations.get(toolUseId);
+            if (!pending)
+                return;
+            this._pendingKeyboardConfirmations.delete(toolUseId);
+            const confirmed = action === "approve";
+            pending.respond({ approved: confirmed });
+            try {
+                await ctx.editMessageText(`${pending.messageText}\n\n${confirmed ? "Approved" : "Denied"}`);
+            }
+            catch {
+                // Message may have been deleted
+            }
+        });
+        // Subscribe to delivery events
+        bridge.onDeliver((output) => {
+            return this._handleDelivery(output);
+        });
+        // Subscribe to confirmation requests
+        bridge.onConfirmation((request, respond) => {
+            this._handleConfirmation(request, respond).catch((err) => {
+                console.error("Telegram confirmation error:", err);
+            });
+        });
+        // Typing indicator on execution start
+        bridge.onExecutionStart(() => {
+            if (this._chatId) {
+                this._bot.api.sendChatAction(this._chatId, "typing").catch(() => { });
+            }
+        });
+        // Validate token before starting (fails fast on 401)
+        await this._bot.api.getMe();
+        // Start long polling (fire-and-forget — errors reported via status)
+        this._bot
+            .start({
+            onStart: () => {
+                this._status = "connected";
+                bridge.reportStatus("connected");
+            },
+        })
+            .catch((err) => {
+            this._status = "error";
+            bridge.reportStatus("error", err);
+        });
+    }
+    async stop() {
+        await this._bot.stop();
+        this._status = "disconnected";
+        this._bridge = null;
+        this._pendingTextConfirmation = null;
+        this._pendingKeyboardConfirmations.clear();
+    }
+    // --- Private ---
+    async _handleDelivery(output) {
+        if (!this._chatId)
+            return;
+        for (const message of output.messages) {
+            const text = extractText(message.content, "\n\n");
+            if (!text)
+                continue;
+            const chunks = splitMessage(text, { maxLength: TELEGRAM_MAX_LENGTH });
+            for (const chunk of chunks) {
+                await this._bot.api.sendMessage(this._chatId, chunk);
+            }
+        }
+    }
+    async _handleConfirmation(request, respond) {
+        if (!this._chatId)
+            return;
+        const text = formatConfirmationMessage(request);
+        if (this._confirmationStyle === "inline-keyboard") {
+            this._pendingKeyboardConfirmations.set(request.toolUseId, {
+                respond,
+                messageText: text,
+            });
+            const keyboard = new InlineKeyboard()
+                .text("Approve", `confirm:${request.toolUseId}:approve`)
+                .text("Deny", `confirm:${request.toolUseId}:deny`);
+            await this._bot.api.sendMessage(this._chatId, text, {
+                reply_markup: keyboard,
+            });
+        }
+        else {
+            this._pendingTextConfirmation = { respond };
+            await this._bot.api.sendMessage(this._chatId, `${text}\n\nReply yes/no (or explain what you'd like instead)`);
+        }
+    }
+}
+//# sourceMappingURL=telegram-platform.js.map

package/dist/telegram-platform.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@agentick/connector-telegram",
+  "version": "0.5.0",
+  "description": "Telegram connector for Agentick — bridge Telegram bots to agent sessions",
+  "keywords": [
+    "agent",
+    "ai",
+    "bot",
+    "connector",
+    "telegram"
+  ],
+  "license": "MIT",
+  "author": "Ryan Lindgren",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agenticklabs/agentick.git",
+    "directory": "packages/connector-telegram"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@agentick/connector": "workspace:*",
+    "@agentick/shared": "workspace:*"
+  },
+  "devDependencies": {
+    "grammy": "^1.35.0",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "grammy": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "grammy": {
+      "optional": false
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { TelegramPlatform, type TelegramConnectorOptions } from "./telegram-platform.js";
+
+export { escapeMarkdownV2 } from "./telegram-format.js";