@mono-agent/telegram-adapter 0.2.1 → 0.3.0

package/dist/bot.js

@@ -0,0 +1,214 @@
+import { isAgentResponseCancelledError } from "@mono-agent/agent-contracts";
+import { run } from "@grammyjs/runner";
+import { Bot } from "grammy";
+import { DEFAULT_MESSAGES, buildAgentRequest, finishSafely, resolveErrorText, } from "./adapter.js";
+import { createGrammyTelegramApi } from "./grammy-client.js";
+import { TelegramMessageStream, } from "./message-stream.js";
+const DEFAULT_INITIAL_STATUS_TEXT = "Thinking…";
+/**
+ * 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 function createTelegramBot(options) {
+    const allowAllChats = options.allowAllChats === true;
+    const allowedChatIds = new Set((options.allowedChatIds ?? []).map((id) => String(id)));
+    if (!allowAllChats && allowedChatIds.size === 0) {
+        throw new TypeError("createTelegramBot requires allowedChatIds or allowAllChats: true.");
+    }
+    const messages = { ...DEFAULT_MESSAGES, ...options.messages };
+    const logger = options.logger;
+    const initialStatusText = options.stream?.initialStatusText ?? DEFAULT_INITIAL_STATUS_TEXT;
+    const activeRuns = new Map();
+    const bot = options.botFactory?.(options.botToken) ?? new Bot(options.botToken);
+    const sender = createGrammyTelegramApi(bot.api);
+    const isAuthorized = (chatId) => chatId !== undefined && (allowAllChats || allowedChatIds.has(String(chatId)));
+    bot.use(async (ctx, next) => {
+        const chatId = ctx.chat?.id;
+        if (chatId === undefined) {
+            return;
+        }
+        if (!isAuthorized(chatId)) {
+            await ctx.reply(messages.unauthorizedText);
+            return;
+        }
+        await next();
+    });
+    bot.command("start", async (ctx) => {
+        await ctx.reply(messages.welcomeText);
+    });
+    bot.command("help", async (ctx) => {
+        await ctx.reply(messages.helpText);
+    });
+    bot.command("cancel", async (ctx) => {
+        const chatId = ctx.chat?.id;
+        if (chatId !== undefined) {
+            activeRuns.get(String(chatId))?.controller.abort(new Error("Cancelled by Telegram user."));
+        }
+        await ctx.reply(messages.cancelledText);
+    });
+    bot.on("message:text", async (ctx) => {
+        await handleAgentMessage(ctx);
+    });
+    bot.on("message", async (ctx) => {
+        await ctx.reply(messages.unsupportedText);
+    });
+    async function handleAgentMessage(ctx) {
+        const message = ctx.message;
+        const chatId = ctx.chat?.id;
+        if (message === undefined || chatId === undefined) {
+            return;
+        }
+        const text = (message.text ?? "").trim();
+        if (text.length === 0) {
+            await ctx.reply(messages.unsupportedText);
+            return;
+        }
+        const key = String(chatId);
+        if (activeRuns.has(key)) {
+            await ctx.reply(messages.busyText);
+            return;
+        }
+        // Record the run synchronously, before any await, so a concurrent message for
+        // the same chat observes it and gets the "busy" reply above.
+        const controller = new AbortController();
+        const activeRun = { controller };
+        activeRuns.set(key, activeRun);
+        const request = buildAgentRequest(ctx.update, message, text, controller.signal);
+        const stream = new TelegramMessageStream(buildStreamOptions(chatId, message.message_id, controller.signal));
+        try {
+            try {
+                await stream.status(initialStatusText);
+            }
+            catch (statusError) {
+                logger?.warn?.("Telegram initial status send failed; continuing to the agent run.", {
+                    error: errorMessage(statusError),
+                });
+            }
+            if (controller.signal.aborted) {
+                await finishSafely(stream, messages.cancelledText, logger);
+                return;
+            }
+            let response;
+            try {
+                response = await options.responder.respond(request, stream);
+            }
+            catch (error) {
+                if (controller.signal.aborted || isAgentResponseCancelledError(error)) {
+                    await finishSafely(stream, messages.cancelledText, logger);
+                    return;
+                }
+                logger?.error?.("Telegram bot responder failed.", { error: errorMessage(error) });
+                const errorText = await resolveErrorText({
+                    configured: messages.errorText,
+                    error,
+                    request,
+                    logger,
+                });
+                await finishSafely(stream, errorText, logger);
+                return;
+            }
+            if (controller.signal.aborted) {
+                await finishSafely(stream, messages.cancelledText, logger);
+                return;
+            }
+            try {
+                await stream.finish(response.text);
+            }
+            catch (error) {
+                if (controller.signal.aborted || isAgentResponseCancelledError(error)) {
+                    return;
+                }
+                // The AI run succeeded; a delivery failure is degraded, never an error.
+                logger?.error?.("Telegram final delivery failed after a successful AI run.", {
+                    error: errorMessage(error),
+                });
+            }
+        }
+        finally {
+            if (activeRuns.get(key) === activeRun) {
+                activeRuns.delete(key);
+            }
+        }
+    }
+    function buildStreamOptions(chatId, replyToMessageId, signal) {
+        const streamOptions = {
+            api: sender,
+            chatId,
+            replyToMessageId,
+            abortSignal: signal,
+        };
+        const tuning = options.stream;
+        if (tuning?.initialStatusText !== undefined) {
+            streamOptions.initialStatusText = tuning.initialStatusText;
+        }
+        if (tuning?.editDebounceMs !== undefined) {
+            streamOptions.editDebounceMs = tuning.editDebounceMs;
+        }
+        if (tuning?.maxMessageChars !== undefined) {
+            streamOptions.maxMessageChars = tuning.maxMessageChars;
+        }
+        if (tuning?.maxSendRetries !== undefined) {
+            streamOptions.maxSendRetries = tuning.maxSendRetries;
+        }
+        if (tuning?.retryCapMs !== undefined) {
+            streamOptions.retryCapMs = tuning.retryCapMs;
+        }
+        if (tuning?.retryBaseDelayMs !== undefined) {
+            streamOptions.retryBaseDelayMs = tuning.retryBaseDelayMs;
+        }
+        if (tuning?.showThoughts !== undefined) {
+            streamOptions.showThoughts = tuning.showThoughts;
+        }
+        if (tuning?.formatMarkdown !== undefined) {
+            streamOptions.formatMarkdown = tuning.formatMarkdown;
+        }
+        if (logger !== undefined) {
+            streamOptions.logger = logger;
+        }
+        return streamOptions;
+    }
+    let runnerHandle;
+    return {
+        bot,
+        async start() {
+            if (runnerHandle?.isRunning() === true) {
+                return;
+            }
+            if ((options.deleteWebhookOnStart ?? true) === true) {
+                await bot.api.deleteWebhook({ drop_pending_updates: options.dropPendingUpdates ?? false });
+            }
+            runnerHandle = (options.runnerFactory ?? defaultRunnerFactory)(bot);
+            // Surface a late polling crash to the shared logger and the host's
+            // onPollingError callback without leaving an unhandled rejection; stop()
+            // still settles the runner independently.
+            runnerHandle.task?.()?.catch((error) => {
+                logger?.error?.("Telegram polling stopped with an error.", {
+                    error: errorMessage(error),
+                });
+                options.onPollingError?.(error);
+            });
+        },
+        async stop() {
+            if (runnerHandle?.isRunning() === true) {
+                await runnerHandle.stop();
+            }
+            runnerHandle = undefined;
+        },
+    };
+    function defaultRunnerFactory(target) {
+        const allowed = [...(options.allowedUpdates ?? ["message"])];
+        return run(target, { runner: { fetch: { allowed_updates: allowed } } });
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=bot.js.map

package/dist/bot.js.map

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

package/dist/config.d.ts

@@ -1,10 +1,12 @@
 import type { FieldGroup, RedactedSecretValue, SettingsJson } from "@mono-agent/settings";
 export interface TelegramAdapterConfig {
+    readonly enabled: boolean;
     readonly botToken: string;
     readonly allowedChatIds: readonly string[];
     readonly allowAllChats: boolean;
 }
 export interface RedactedTelegramAdapterConfig {
+    readonly enabled: boolean;
     readonly botToken: RedactedSecretValue;
     readonly allowedChatIds: {
         readonly count: number;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,8BAA8B,GACtC,yBAAyB,GACzB,gBAAgB,CAAC;AAErB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,8BAA8B,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;gBAGlD,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iCAAsC;CAOlD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAcD,eAAO,MAAM,kBAAkB,EAAE,UA4B/B,CAAC;AAEH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAwBhC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,qBAAqB,GAC5B,6BAA6B,CAM/B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,8BAA8B,GACtC,yBAAyB,GACzB,gBAAgB,CAAC;AAErB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,8BAA8B,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;gBAGlD,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iCAAsC;CAOlD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAcD,eAAO,MAAM,kBAAkB,EAAE,UAmC/B,CAAC;AAEH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAsChC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,qBAAqB,GAC5B,6BAA6B,CAO/B"}

package/dist/config.js

@@ -16,6 +16,13 @@ export const telegramFieldGroup = defineFieldGroup({
     label: "Telegram",
     description: "Optional Telegram adapter configuration. The token is write-only.",
     fields: [
+        {
+            id: "telegram.enabled",
+            label: "Enable Telegram",
+            description: "Start the Telegram adapter with the app. Off by default.",
+            kind: "switch",
+            path: ["telegram", "enabled"],
+        },
         {
             id: "telegram.botToken",
             label: "Bot token",
@@ -43,16 +50,24 @@ export const telegramFieldGroup = defineFieldGroup({
 export async function loadTelegramAdapterConfig(input) {
     const json = input.json ?? (input.jsonPath === undefined ? {} : (await readSettingsJson(input.jsonPath)).json);
     const env = layerTelegramJsonOntoEnv(json, input.env);
-    const botToken = readRequired(env.MONO_AGENT_TELEGRAM_BOT_TOKEN, "MONO_AGENT_TELEGRAM_BOT_TOKEN", missingRequiredConfig);
+    const enabled = readBoolean(env.MONO_AGENT_TELEGRAM_ENABLED, "MONO_AGENT_TELEGRAM_ENABLED", false, invalidConfig);
     const allowedChatIds = readCsv(env.MONO_AGENT_TELEGRAM_ALLOWED_CHAT_IDS);
     const allowAllChats = readBoolean(env.MONO_AGENT_TELEGRAM_ALLOW_ALL_CHATS, "MONO_AGENT_TELEGRAM_ALLOW_ALL_CHATS", false, invalidConfig);
+    // A disabled channel never validates its credentials: the status surface reads
+    // it as "disabled", not "waiting for config". Only an enabled channel demands
+    // its required fields (a missing token then becomes a real "waiting" reason).
+    if (!enabled) {
+        return { enabled: false, botToken: "", allowedChatIds, allowAllChats };
+    }
+    const botToken = readRequired(env.MONO_AGENT_TELEGRAM_BOT_TOKEN, "MONO_AGENT_TELEGRAM_BOT_TOKEN", missingRequiredConfig);
     if (!allowAllChats && allowedChatIds.length === 0) {
         throw missingRequiredConfig("Telegram adapter requires MONO_AGENT_TELEGRAM_ALLOWED_CHAT_IDS or MONO_AGENT_TELEGRAM_ALLOW_ALL_CHATS=true.", { env: "MONO_AGENT_TELEGRAM_ALLOWED_CHAT_IDS" });
     }
-    return { botToken, allowedChatIds, allowAllChats };
+    return { enabled: true, botToken, allowedChatIds, allowAllChats };
 }
 export function redactTelegramAdapterConfig(config) {
     return {
+        enabled: config.enabled,
         botToken: redactedSecret(config.botToken),
         allowedChatIds: { count: config.allowedChatIds.length },
         allowAllChats: config.allowAllChats,
@@ -61,6 +76,7 @@ export function redactTelegramAdapterConfig(config) {
 function layerTelegramJsonOntoEnv(json, env) {
     const section = readJsonSection(json, "telegram");
     return layerJsonOntoEnv(env, [
+        { env: "MONO_AGENT_TELEGRAM_ENABLED", value: section.enabled, kind: "boolean" },
         { env: "MONO_AGENT_TELEGRAM_BOT_TOKEN", value: section.botToken },
         { env: "MONO_AGENT_TELEGRAM_ALLOWED_CHAT_IDS", value: section.allowedChatIds, kind: "csv" },
         { env: "MONO_AGENT_TELEGRAM_ALLOW_ALL_CHATS", value: section.allowAllChats, kind: "boolean" },

package/dist/config.js.map

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

package/dist/grammy-client.d.ts

@@ -0,0 +1,14 @@
+import { type Api } from "grammy";
+import type { TelegramMessageSender } from "./types.js";
+/**
+ * Adapt a grammY {@link Api} to the {@link TelegramMessageSender} the streaming
+ * delivery layer depends on.
+ *
+ * Two responsibilities: translate our params-object calls into grammY's
+ * positional `(chat_id, text, other, signal)` form, and translate grammY's
+ * thrown errors (`GrammyError`, `HttpError`) back into {@link TelegramApiError}
+ * so the existing recovery policy (`classifyTelegramError`) keeps working
+ * unchanged.
+ */
+export declare function createGrammyTelegramApi(api: Api): TelegramMessageSender;
+//# sourceMappingURL=grammy-client.d.ts.map

package/dist/grammy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammy-client.d.ts","sourceRoot":"","sources":["../src/grammy-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAM1D,OAAO,KAAK,EAEV,qBAAqB,EAItB,MAAM,YAAY,CAAC;AAYpB;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,qBAAqB,CAoDvE"}

package/dist/grammy-client.js

@@ -0,0 +1,103 @@
+import { GrammyError, HttpError } from "grammy";
+import { TelegramApiError, } from "./telegram-error.js";
+// grammY's `Api` types its `signal` parameter with the `abort-controller` shim's
+// AbortSignal rather than the global one; the runtime value is identical, so we
+// cast through this helper at the call boundary.
+function asGrammySignal(signal) {
+    return signal;
+}
+/**
+ * Adapt a grammY {@link Api} to the {@link TelegramMessageSender} the streaming
+ * delivery layer depends on.
+ *
+ * Two responsibilities: translate our params-object calls into grammY's
+ * positional `(chat_id, text, other, signal)` form, and translate grammY's
+ * thrown errors (`GrammyError`, `HttpError`) back into {@link TelegramApiError}
+ * so the existing recovery policy (`classifyTelegramError`) keeps working
+ * unchanged.
+ */
+export function createGrammyTelegramApi(api) {
+    return {
+        async sendMessage(params, options) {
+            try {
+                const message = await api.sendMessage(params.chat_id, params.text, buildSendOther(params), asGrammySignal(options?.signal));
+                return message;
+            }
+            catch (error) {
+                throw toTelegramApiError("sendMessage", error, options?.signal);
+            }
+        },
+        async editMessageText(params, options) {
+            try {
+                if (params.inline_message_id !== undefined) {
+                    const result = await api.editMessageTextInline(params.inline_message_id, params.text, buildEditOther(params), asGrammySignal(options?.signal));
+                    return result === true ? true : result;
+                }
+                if (params.chat_id !== undefined && params.message_id !== undefined) {
+                    const result = await api.editMessageText(params.chat_id, params.message_id, params.text, buildEditOther(params), asGrammySignal(options?.signal));
+                    return result === true ? true : result;
+                }
+            }
+            catch (error) {
+                throw toTelegramApiError("editMessageText", error, options?.signal);
+            }
+            throw new TelegramApiError("grammY editMessageText requires inline_message_id, or chat_id and message_id.", { kind: "telegram", method: "editMessageText" });
+        },
+    };
+}
+function buildSendOther(params) {
+    const other = {};
+    if (params.parse_mode !== undefined) {
+        other.parse_mode = params.parse_mode;
+    }
+    if (params.reply_to_message_id !== undefined) {
+        other.reply_parameters = { message_id: params.reply_to_message_id };
+    }
+    if (params.disable_web_page_preview !== undefined) {
+        other.link_preview_options = { is_disabled: params.disable_web_page_preview };
+    }
+    return other;
+}
+function buildEditOther(params) {
+    const other = {};
+    if (params.parse_mode !== undefined) {
+        other.parse_mode = params.parse_mode;
+    }
+    if (params.disable_web_page_preview !== undefined) {
+        other.link_preview_options = { is_disabled: params.disable_web_page_preview };
+    }
+    return other;
+}
+function toTelegramApiError(method, error, signal) {
+    if (error instanceof TelegramApiError) {
+        return error;
+    }
+    if (signal?.aborted === true || isAbortError(error)) {
+        return new TelegramApiError(`Telegram API ${method} request was aborted.`, {
+            kind: "aborted",
+            method,
+        });
+    }
+    if (error instanceof GrammyError) {
+        const details = {
+            kind: "telegram",
+            method,
+            errorCode: error.error_code,
+            telegramDescription: error.description,
+        };
+        const retryAfter = error.parameters.retry_after;
+        if (typeof retryAfter === "number" && Number.isFinite(retryAfter)) {
+            details.retryAfterMs = Math.max(0, retryAfter) * 1000;
+        }
+        return new TelegramApiError(`Telegram API ${method} rejected the request.`, details);
+    }
+    if (error instanceof HttpError) {
+        return new TelegramApiError(`Network failure while calling Telegram API ${method}.`, { kind: "network", method, cause: error });
+    }
+    return new TelegramApiError(`Unexpected failure while calling Telegram API ${method}.`, { kind: "network", method, cause: error });
+}
+function isAbortError(value) {
+    return ((value instanceof DOMException && value.name === "AbortError") ||
+        (value instanceof Error && value.name === "AbortError"));
+}
+//# sourceMappingURL=grammy-client.js.map

package/dist/grammy-client.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-export type { TelegramBotApi, TelegramChat, TelegramChatId, TelegramDeleteWebhookParams, TelegramEditMessageTextParams, TelegramGetUpdatesParams, TelegramMessage, TelegramRequestOptions, TelegramSendMessageParams, TelegramSentMessage, TelegramUpdate, TelegramUser, } from "./types.js";
-export { TelegramApiError, TelegramBotApiClient, } from "./telegram-client.js";
-export type { TelegramApiErrorDetails, TelegramApiErrorKind, TelegramBotApiClientOptions, } from "./telegram-client.js";
-export { TelegramMessageStream } from "./message-stream.js";
-export type { TelegramMessageStreamLogger, TelegramMessageStreamOptions, } from "./message-stream.js";
-export { TelegramAdapter } from "./adapter.js";
-export type { AgentRequest, AgentResponder, AgentResponse, TelegramAdapterLogger, TelegramAdapterMessages, TelegramAdapterOptions, TelegramAdapterStreamOptions, TelegramRequestMetadata, TelegramUpdateHandlingResult, } from "./adapter.js";
-export { TelegramLongPoller } from "./long-poller.js";
-export type { TelegramLongPollerBackoffOptions, TelegramLongPollerLogger, TelegramLongPollerOptions, TelegramLongPollerPollOptions, TelegramLongPollerStartOptions, TelegramUpdateHandler, } from "./long-poller.js";
+export type { TelegramBotApi, TelegramChat, TelegramChatId, TelegramDeleteWebhookParams, TelegramEditMessageTextParams, TelegramGetUpdatesParams, TelegramMessage, TelegramMessageSender, TelegramRequestOptions, TelegramSendMessageParams, TelegramSentMessage, TelegramUpdate, TelegramUser, } from "./types.js";
+export { TelegramApiError } from "./telegram-error.js";
+export type { TelegramApiErrorDetails, TelegramApiErrorKind, } from "./telegram-error.js";
+export { TelegramDeliveryError, TelegramMessageStream, classifyTelegramError, } from "./message-stream.js";
+export type { AgentMessageStream, TelegramMessageStreamLogger, TelegramMessageStreamOptions, TelegramSendOutcome, } from "./message-stream.js";
+export { renderTelegramMarkdown } from "./telegram-markdown.js";
+export { createGrammyTelegramApi } from "./grammy-client.js";
+export { createTelegramBot } from "./bot.js";
+export type { CreateTelegramBotOptions, TelegramBotController, } from "./bot.js";
+export type { AgentRequest, AgentResponder, AgentResponse, TelegramAdapterErrorText, TelegramAdapterErrorTextInput, TelegramAdapterLogger, TelegramAdapterMessages, TelegramAdapterStreamOptions, TelegramRequestMetadata, } from "./adapter.js";
 export { startTelegramAdapter } from "./start.js";
-export type { TelegramAdapterStartOptions, TelegramAdapterStartResult, TelegramPollerLike, } from "./start.js";
+export type { TelegramAdapterStartOptions, TelegramAdapterStartResult, } from "./start.js";
 export { loadTelegramAdapterConfig, redactTelegramAdapterConfig, TelegramAdapterConfigError, telegramFieldGroup, } from "./config.js";
 export type { LoadTelegramAdapterConfigInput, RedactedTelegramAdapterConfig, TelegramAdapterConfig, TelegramAdapterConfigErrorCode, TelegramAdapterConfigErrorDetails, } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EACV,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
-export { TelegramApiError, TelegramBotApiClient, } from "./telegram-client.js";
-export { TelegramMessageStream } from "./message-stream.js";
-export { TelegramAdapter } from "./adapter.js";
-export { TelegramLongPoller } from "./long-poller.js";
+export { TelegramApiError } from "./telegram-error.js";
+export { TelegramDeliveryError, TelegramMessageStream, classifyTelegramError, } from "./message-stream.js";
+export { renderTelegramMarkdown } from "./telegram-markdown.js";
+export { createGrammyTelegramApi } from "./grammy-client.js";
+export { createTelegramBot } from "./bot.js";
 export { startTelegramAdapter } from "./start.js";
 export { loadTelegramAdapterConfig, redactTelegramAdapterConfig, TelegramAdapterConfigError, telegramFieldGroup, } from "./config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAK5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAY/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAStD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMlD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAMvD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAkB7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMlD,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/message-stream.d.ts

@@ -1,18 +1,31 @@
-import type { AgentMessageStream as AgentMessageStreamBase } from "@mono-agent/agent-contracts";
-import type { TelegramBotApi, TelegramChatId } from "./types.js";
+import type { AgentMessageStream as AgentMessageStreamBase, AgentStreamEvent } from "@mono-agent/agent-contracts";
+import type { TelegramChatId, TelegramMessageSender } from "./types.js";
 export interface AgentMessageStream extends AgentMessageStreamBase {
     status(text: string): Promise<void>;
     append(delta: string): Promise<void>;
     replace(text: string): Promise<void>;
+    event(event: AgentStreamEvent): Promise<void>;
     finish(finalText?: string): Promise<void>;
 }
 export interface TelegramMessageStreamOptions {
-    api: TelegramBotApi;
+    api: TelegramMessageSender;
     chatId: TelegramChatId;
     initialStatusText?: string;
     editDebounceMs?: number;
     maxMessageChars?: number;
     replyToMessageId?: number;
+    /** Maximum retries for a *final* delivery before giving up. Default 3. */
+    maxSendRetries?: number;
+    /** Upper bound on any honored `retry_after`/backoff wait, in ms. Default 60000. */
+    retryCapMs?: number;
+    /** Base delay for exponential backoff between final-delivery retries. Default 500. */
+    retryBaseDelayMs?: number;
+    /** Render accumulated reasoning as a live "💭" message. Default true. */
+    showThoughts?: boolean;
+    /** Render the final answer as Telegram MarkdownV2 (plain fallback). Default true. */
+    formatMarkdown?: boolean;
+    /** Aborts in-flight retry waits (e.g. on /cancel). */
+    abortSignal?: AbortSignal;
     logger?: TelegramMessageStreamLogger;
 }
 export interface TelegramMessageStreamLogger {
@@ -20,6 +33,32 @@ export interface TelegramMessageStreamLogger {
     warn?(message: string, metadata?: Record<string, unknown>): void;
     error?(message: string, metadata?: Record<string, unknown>): void;
 }
+/**
+ * Raised only when a *final* delivery cannot reach Telegram after retries and
+ * the last-resort fresh send. The AI request itself already succeeded, so the
+ * adapter treats this as a degraded delivery — never as an agent failure.
+ */
+export declare class TelegramDeliveryError extends Error {
+    readonly cause: unknown;
+    readonly attempts: number;
+    constructor(message: string, details: {
+        cause: unknown;
+        attempts: number;
+    });
+}
+/** How a failed Telegram send/edit should be handled. */
+export type TelegramSendOutcome = {
+    kind: "not_modified";
+} | {
+    kind: "recreate";
+} | {
+    kind: "reformat_plain";
+} | {
+    kind: "retry";
+    retryAfterMs?: number;
+} | {
+    kind: "fatal";
+};
 export declare class TelegramMessageStream implements AgentMessageStream {
     private readonly api;
     private readonly chatId;
@@ -27,28 +66,62 @@ export declare class TelegramMessageStream implements AgentMessageStream {
     private readonly editDebounceMs;
     private readonly maxMessageChars;
     private readonly replyToMessageId;
+    private readonly maxSendRetries;
+    private readonly retryCapMs;
+    private readonly retryBaseDelayMs;
+    private readonly showThoughts;
+    private readonly formatMarkdown;
+    private readonly abortSignal;
     private readonly logger;
     private currentText;
+    private thinkingText;
+    private hasAnswerText;
     private statusText;
     private sentMessage;
     private sendMessagePromise;
     private editTimer;
     private inFlightEdit;
-    private lastAsyncError;
+    private lastFlushedText;
+    private lastFlushedMarkdown;
     private finished;
     constructor(options: TelegramMessageStreamOptions);
     status(text: string): Promise<void>;
     append(delta: string): Promise<void>;
     replace(text: string): Promise<void>;
-    finish(finalText?: string): Promise<void>;
+    event(event: AgentStreamEvent): Promise<void>;
+    finish(finalText?: string, options?: {
+        format?: boolean;
+    }): Promise<void>;
+    private interimDisplayText;
     private ensureMessage;
     private scheduleEdit;
     private startInFlightEdit;
-    private flushEdit;
+    /**
+     * Send `sourceText` to Telegram, classifying failures and recovering where
+     * possible. Interim edits (`final: false`) are best-effort and never throw;
+     * final delivery retries transient failures and throws TelegramDeliveryError
+     * only when every path is exhausted.
+     */
+    private deliverText;
+    /**
+     * The streamed message could not be edited or recreated in place. Post the
+     * final answer as a brand-new plain message so the user still receives it.
+     */
+    private lastResortSend;
+    /** Overflow continuation chunks are best-effort: the primary answer already landed. */
+    private sendOverflowChunk;
+    private buildEditParams;
+    private buildSendParams;
+    private retryDelayMs;
+    private sleep;
     private cancelScheduledEdit;
     private awaitInFlightEdit;
-    private throwIfAsyncError;
     private assertOpen;
 }
+/**
+ * Classify a Telegram send/edit failure into a recovery strategy. Pure and
+ * exported so the recovery policy can be unit-tested directly.
+ */
+export declare function classifyTelegramError(error: unknown): TelegramSendOutcome;
 export declare function splitTelegramText(text: string, maxChars: number): string[];
 //# sourceMappingURL=message-stream.d.ts.map