@mono-agent/telegram-adapter 0.2.0 → 0.2.2

package/README.md

@@ -8,6 +8,8 @@ Category: `communication`
 
 Telegram communication adapter for agent hosts. It provides a Bot API client, long poller, update handler, streamed message edits, cancellation, allowlist enforcement, and Telegram-owned settings helpers.
 
+The adapter is opt-in: `telegram.enabled` / `MONO_AGENT_TELEGRAM_ENABLED` defaults to `false`. While disabled the loader skips credential validation and the channel reports `disabled` rather than `waiting_for_config`. Set `enabled: true` to turn it on; a missing bot token or allowlist then surfaces as a real `waiting_for_config` reason.
+
 ## Install / Usage
 
 ```bash

package/dist/adapter.d.ts

@@ -1,6 +1,6 @@
-import { type AgentRequestBase, type AgentResponder as SharedAgentResponder, type AgentResponse } from "@mono-agent/agent-contracts";
-import { type AgentMessageStream, type TelegramMessageStreamLogger } from "./message-stream.js";
-import type { TelegramBotApi, TelegramChatId, TelegramUpdate } from "./types.js";
+import type { AgentRequestBase, AgentResponder as SharedAgentResponder, AgentResponse } from "@mono-agent/agent-contracts";
+import { TelegramMessageStream, type AgentMessageStream, type TelegramMessageStreamLogger } from "./message-stream.js";
+import type { TelegramChatId, TelegramMessage, TelegramUpdate } from "./types.js";
 export interface AgentRequest extends AgentRequestBase {
     conversationId: string;
     chatId: TelegramChatId;
@@ -44,68 +44,46 @@ export interface TelegramAdapterMessages {
     busyText?: string;
     unauthorizedText?: string;
     cancelledText?: string;
-    errorText?: string;
+    errorText?: TelegramAdapterErrorText;
     unsupportedText?: string;
 }
+export type TelegramAdapterErrorText = string | ((input: TelegramAdapterErrorTextInput) => string | Promise<string>);
+export interface TelegramAdapterErrorTextInput {
+    readonly error: unknown;
+    readonly request: AgentRequest;
+}
 export interface TelegramAdapterStreamOptions {
     initialStatusText?: string;
     editDebounceMs?: number;
     maxMessageChars?: number;
+    maxSendRetries?: number;
+    retryCapMs?: number;
+    retryBaseDelayMs?: number;
+    showThoughts?: boolean;
+    formatMarkdown?: boolean;
 }
 export interface TelegramAdapterLogger extends TelegramMessageStreamLogger {
     info?(message: string, metadata?: Record<string, unknown>): void;
 }
-export interface TelegramAdapterOptions {
-    api: TelegramBotApi;
-    responder: AgentResponder;
-    allowedChatIds?: TelegramChatId[];
-    allowAllChats?: boolean;
-    stream?: TelegramAdapterStreamOptions;
-    messages?: TelegramAdapterMessages;
-    logger?: TelegramAdapterLogger;
-}
-export type TelegramUpdateHandlingResult = {
-    kind: "handled";
-    updateId: number;
-    chatId: TelegramChatId;
-    action: "command" | "responded";
-    command?: "start" | "help";
-    metadata?: Record<string, unknown>;
-} | {
-    kind: "ignored";
-    updateId: number;
-    reason: "non_message_update" | "unsupported_message" | "empty_text";
-    chatId?: TelegramChatId;
-} | {
-    kind: "unauthorized";
-    updateId: number;
-    chatId: TelegramChatId;
-} | {
-    kind: "busy";
-    updateId: number;
-    chatId: TelegramChatId;
-} | {
-    kind: "cancelled";
-    updateId: number;
-    chatId: TelegramChatId;
-} | {
-    kind: "error";
-    updateId: number;
-    chatId?: TelegramChatId;
-    error: unknown;
-};
-export declare class TelegramAdapter {
-    private readonly api;
-    private readonly responder;
-    private readonly allowAllChats;
-    private readonly allowedChatIds;
-    private readonly streamOptions;
-    private readonly messages;
-    private readonly logger;
-    private readonly activeRuns;
-    constructor(options: TelegramAdapterOptions);
-    handleUpdate(update: TelegramUpdate): Promise<TelegramUpdateHandlingResult>;
-    private respondToMessage;
-    private isAuthorized;
-}
+export declare const DEFAULT_ERROR_TEXT = "The agent failed while processing your message.";
+export declare const DEFAULT_MESSAGES: Required<TelegramAdapterMessages>;
+/**
+ * Build the responder-facing {@link AgentRequest} from a Telegram update. The
+ * grammY message handler passes `ctx.update` and `ctx.message`, which are
+ * structurally compatible with the wire types this reads.
+ */
+export declare function buildAgentRequest(update: TelegramUpdate, message: TelegramMessage, text: string, abortSignal: AbortSignal): AgentRequest;
+/**
+ * Deliver a terminal/system message (cancelled, error, …) in place. Such copy is
+ * fixed text we author, not model output, so it is delivered as plain text
+ * (`format: false`) — no MarkdownV2 escaping — while still reusing the stream's
+ * resilient edit-or-recreate delivery.
+ */
+export declare function finishSafely(stream: TelegramMessageStream, text: string, logger: TelegramAdapterLogger | undefined): Promise<void>;
+export declare function resolveErrorText(input: {
+    readonly configured: TelegramAdapterErrorText;
+    readonly error: unknown;
+    readonly request: AgentRequest;
+    readonly logger: TelegramAdapterLogger | undefined;
+}): Promise<string>;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -1,182 +1,20 @@
-import { isAgentResponseCancelledError, } from "@mono-agent/agent-contracts";
 import { TelegramMessageStream, } from "./message-stream.js";
-const DEFAULT_MESSAGES = {
+export const DEFAULT_ERROR_TEXT = "The agent failed while processing your message.";
+export const DEFAULT_MESSAGES = {
     welcomeText: "Hello! Send me a text message and I will pass it to the configured agent.",
     helpText: "Send a text message to talk to the agent. Use /cancel to stop the current response.",
     busyText: "I am still working on your previous message. Use /cancel to stop it.",
     unauthorizedText: "This Telegram chat is not authorized to use this bot.",
     cancelledText: "Cancelled.",
-    errorText: "The agent failed while processing your message.",
+    errorText: DEFAULT_ERROR_TEXT,
     unsupportedText: "I can only handle text messages in this adapter for now.",
 };
-export class TelegramAdapter {
-    api;
-    responder;
-    allowAllChats;
-    allowedChatIds;
-    streamOptions;
-    messages;
-    logger;
-    activeRuns = new Map();
-    constructor(options) {
-        this.api = options.api;
-        this.responder = options.responder;
-        this.allowAllChats = options.allowAllChats === true;
-        this.allowedChatIds = new Set(options.allowedChatIds?.map((chatId) => String(chatId)) ?? []);
-        this.streamOptions = options.stream ?? {};
-        this.messages = { ...DEFAULT_MESSAGES, ...options.messages };
-        this.logger = options.logger;
-        if (!this.allowAllChats && this.allowedChatIds.size === 0) {
-            throw new TypeError("TelegramAdapter requires allowedChatIds or allowAllChats: true.");
-        }
-    }
-    async handleUpdate(update) {
-        const message = update.message;
-        if (message === undefined) {
-            return { kind: "ignored", updateId: update.update_id, reason: "non_message_update" };
-        }
-        const chatId = message.chat.id;
-        if (!this.isAuthorized(chatId)) {
-            await this.api.sendMessage({
-                chat_id: chatId,
-                text: this.messages.unauthorizedText,
-            });
-            return { kind: "unauthorized", updateId: update.update_id, chatId };
-        }
-        const text = message.text;
-        if (typeof text !== "string") {
-            await this.api.sendMessage({
-                chat_id: chatId,
-                text: this.messages.unsupportedText,
-            });
-            return {
-                kind: "ignored",
-                updateId: update.update_id,
-                chatId,
-                reason: "unsupported_message",
-            };
-        }
-        const trimmedText = text.trim();
-        if (trimmedText.length === 0) {
-            await this.api.sendMessage({
-                chat_id: chatId,
-                text: this.messages.unsupportedText,
-            });
-            return {
-                kind: "ignored",
-                updateId: update.update_id,
-                chatId,
-                reason: "empty_text",
-            };
-        }
-        const command = parseCommand(trimmedText);
-        if (command?.name === "start") {
-            await this.api.sendMessage({ chat_id: chatId, text: this.messages.welcomeText });
-            return {
-                kind: "handled",
-                updateId: update.update_id,
-                chatId,
-                action: "command",
-                command: "start",
-            };
-        }
-        if (command?.name === "help") {
-            await this.api.sendMessage({ chat_id: chatId, text: this.messages.helpText });
-            return {
-                kind: "handled",
-                updateId: update.update_id,
-                chatId,
-                action: "command",
-                command: "help",
-            };
-        }
-        const runKey = String(chatId);
-        const activeRun = this.activeRuns.get(runKey);
-        if (command?.name === "cancel") {
-            if (activeRun !== undefined) {
-                activeRun.controller.abort(new Error("Cancelled by Telegram user."));
-            }
-            await this.api.sendMessage({
-                chat_id: chatId,
-                text: this.messages.cancelledText,
-            });
-            return { kind: "cancelled", updateId: update.update_id, chatId };
-        }
-        if (activeRun !== undefined) {
-            await this.api.sendMessage({ chat_id: chatId, text: this.messages.busyText });
-            return { kind: "busy", updateId: update.update_id, chatId };
-        }
-        return await this.respondToMessage(update, message, trimmedText, runKey);
-    }
-    async respondToMessage(update, message, text, runKey) {
-        const chatId = message.chat.id;
-        const controller = new AbortController();
-        const activeRun = { controller };
-        this.activeRuns.set(runKey, activeRun);
-        const telegramStreamOptions = {
-            api: this.api,
-            chatId,
-            replyToMessageId: message.message_id,
-        };
-        if (this.streamOptions.initialStatusText !== undefined) {
-            telegramStreamOptions.initialStatusText = this.streamOptions.initialStatusText;
-        }
-        if (this.streamOptions.editDebounceMs !== undefined) {
-            telegramStreamOptions.editDebounceMs = this.streamOptions.editDebounceMs;
-        }
-        if (this.streamOptions.maxMessageChars !== undefined) {
-            telegramStreamOptions.maxMessageChars = this.streamOptions.maxMessageChars;
-        }
-        if (this.logger !== undefined) {
-            telegramStreamOptions.logger = this.logger;
-        }
-        const stream = new TelegramMessageStream(telegramStreamOptions);
-        try {
-            await stream.status(this.streamOptions.initialStatusText ?? "Thinking…");
-            if (controller.signal.aborted) {
-                await stream.finish(this.messages.cancelledText);
-                return { kind: "cancelled", updateId: update.update_id, chatId };
-            }
-            const request = buildAgentRequest(update, message, text, controller.signal);
-            const response = await this.responder.respond(request, stream);
-            if (controller.signal.aborted) {
-                await stream.finish(this.messages.cancelledText);
-                return { kind: "cancelled", updateId: update.update_id, chatId };
-            }
-            await stream.finish(response.text);
-            const result = {
-                kind: "handled",
-                updateId: update.update_id,
-                chatId,
-                action: "responded",
-            };
-            if (response.metadata !== undefined) {
-                result.metadata = response.metadata;
-            }
-            return result;
-        }
-        catch (error) {
-            if (controller.signal.aborted || isAgentResponseCancelledError(error)) {
-                await finishSafely(stream, this.messages.cancelledText, this.logger);
-                return { kind: "cancelled", updateId: update.update_id, chatId };
-            }
-            this.logger?.error?.("Telegram adapter responder failed.", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-            await finishSafely(stream, this.messages.errorText, this.logger);
-            return { kind: "error", updateId: update.update_id, chatId, error };
-        }
-        finally {
-            if (this.activeRuns.get(runKey) === activeRun) {
-                this.activeRuns.delete(runKey);
-            }
-        }
-    }
-    isAuthorized(chatId) {
-        return this.allowAllChats || this.allowedChatIds.has(String(chatId));
-    }
-}
-function buildAgentRequest(update, message, text, abortSignal) {
+/**
+ * Build the responder-facing {@link AgentRequest} from a Telegram update. The
+ * grammY message handler passes `ctx.update` and `ctx.message`, which are
+ * structurally compatible with the wire types this reads.
+ */
+export function buildAgentRequest(update, message, text, abortSignal) {
     const from = metadataFromUser(message.from);
     const request = {
         conversationId: `telegram:${String(message.chat.id)}`,
@@ -246,21 +84,41 @@ function metadataFromUser(user) {
     }
     return metadata;
 }
-function parseCommand(text) {
-    const match = text.match(/^\/([A-Za-z0-9_]+)(?:@[A-Za-z0-9_]+)?(?:\s|$)/u);
-    if (match?.[1] === undefined) {
-        return undefined;
+/**
+ * Deliver a terminal/system message (cancelled, error, …) in place. Such copy is
+ * fixed text we author, not model output, so it is delivered as plain text
+ * (`format: false`) — no MarkdownV2 escaping — while still reusing the stream's
+ * resilient edit-or-recreate delivery.
+ */
+export async function finishSafely(stream, text, logger) {
+    try {
+        await stream.finish(text, { format: false });
+    }
+    catch (error) {
+        logger?.error?.("Failed to send Telegram terminal stream message.", {
+            error: error instanceof Error ? error.message : String(error),
+        });
     }
-    return { name: match[1].toLowerCase() };
 }
-async function finishSafely(stream, text, logger) {
+export async function resolveErrorText(input) {
+    if (typeof input.configured === "string") {
+        return input.configured;
+    }
     try {
-        await stream.finish(text);
+        const resolved = await input.configured({
+            error: input.error,
+            request: input.request,
+        });
+        if (typeof resolved === "string" && resolved.trim().length > 0) {
+            return resolved;
+        }
+        input.logger?.warn?.("Telegram adapter error text callback returned empty text.");
     }
     catch (error) {
-        logger?.error?.("Failed to send Telegram terminal stream message.", {
+        input.logger?.error?.("Telegram adapter error text callback failed.", {
             error: error instanceof Error ? error.message : String(error),
         });
     }
+    return DEFAULT_ERROR_TEXT;
 }
 //# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/bot.d.ts

@@ -0,0 +1,50 @@
+import { type RunnerHandle } from "@grammyjs/runner";
+import { Bot } from "grammy";
+import { type AgentResponder, type TelegramAdapterLogger, type TelegramAdapterMessages, type TelegramAdapterStreamOptions } from "./adapter.js";
+import type { TelegramChatId } from "./types.js";
+export interface CreateTelegramBotOptions {
+    readonly botToken: string;
+    readonly responder: AgentResponder;
+    readonly allowedChatIds?: readonly TelegramChatId[];
+    readonly allowAllChats?: boolean;
+    readonly stream?: TelegramAdapterStreamOptions;
+    readonly messages?: TelegramAdapterMessages;
+    readonly logger?: TelegramAdapterLogger;
+    /** Update types to long-poll for. Defaults to messages only. */
+    readonly allowedUpdates?: readonly string[];
+    /** Delete any configured webhook before polling. Defaults to true. */
+    readonly deleteWebhookOnStart?: boolean;
+    /** Drop updates queued before start. Defaults to false. */
+    readonly dropPendingUpdates?: boolean;
+    /**
+     * Called when polling crashes after a successful start (the runner's task
+     * rejects). Lets a host mark the channel failed instead of leaving it running.
+     */
+    readonly onPollingError?: (error: unknown) => void;
+    /** Test seam: build the grammY Bot (e.g. with a fake botInfo + transformer). */
+    readonly botFactory?: (token: string) => Bot;
+    /** Test seam: build the polling runner. Defaults to `@grammyjs/runner`'s `run`. */
+    readonly runnerFactory?: (bot: Bot) => RunnerHandle;
+}
+export interface TelegramBotController {
+    /** The configured grammY bot. Exposed mainly so tests can drive `handleUpdate`. */
+    readonly bot: Bot;
+    /** Start concurrent long polling. Idempotent while already running. */
+    start(): Promise<void>;
+    /** Stop polling and wait for the runner to settle. */
+    stop(): Promise<void>;
+}
+/**
+ * Build a grammY bot that routes authorized text messages to an agent responder.
+ *
+ * grammY owns the transport and (via `@grammyjs/runner`) concurrent polling.
+ * Middleware order is: authorization gate → `/start` `/help` `/cancel` commands →
+ * agent run handler (`message:text`) → unsupported fallback (other messages).
+ *
+ * Per-chat concurrency is guarded by an `activeRuns` map: a run is recorded
+ * synchronously at handler entry, so a second message arriving for the same chat
+ * mid-run gets a "busy" reply rather than starting a competing run. The long run
+ * is intentionally NOT sequentialized, which is what makes "busy" reachable.
+ */
+export declare function createTelegramBot(options: CreateTelegramBotOptions): TelegramBotController;
+//# sourceMappingURL=bot.d.ts.map

package/dist/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,KAAK,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAgB,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAKL,KAAK,cAAc,EAEnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAOlF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,qBAAqB,CAyN1F"}