@mono-agent/telegram-adapter 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# @mono-agent/telegram-adapter
+
+## Category
+
+Category: `communication`
+
+## Responsibility
+
+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.
+
+## Install / Usage
+
+```bash
+pnpm --filter @mono-agent/telegram-adapter run build
+```
+
+```ts
+import {
+  TelegramAdapter,
+  TelegramBotApiClient,
+  TelegramLongPoller,
+  loadTelegramAdapterConfig,
+  telegramFieldGroup,
+} from "@mono-agent/telegram-adapter";
+```
+
+Load adapter settings separately from core config, then pass a structural `AgentResponder` from the host or harness. The base responder, stream, response, and cancellation contracts come from `@mono-agent/agent-contracts`.
+
+## Public API
+
+- `TelegramAdapter`, `TelegramAdapterOptions`
+- `TelegramBotApiClient`, `TelegramApiError`
+- `TelegramLongPoller`
+- `TelegramMessageStream`, `splitTelegramText`
+- `loadTelegramAdapterConfig`, `redactTelegramAdapterConfig`, `telegramFieldGroup`
+- Telegram Bot API, request/response, and config types
+
+## Dependency Boundary
+
+This adapter depends only on shared contracts and settings primitives inside the workspace. It does not depend on the harness, operator console, core config, memory, runtime package, or other adapters. Hosts compose those pieces outside the adapter.
+
+## What This Package Does Not Own
+
+It does not build prompts, run models, store memory, serve UI, manage provider credentials, or decide core runtime settings.
+
+## Verification
+
+```bash
+pnpm --filter @mono-agent/telegram-adapter run build
+pnpm --filter @mono-agent/telegram-adapter run typecheck
+pnpm --filter @mono-agent/telegram-adapter run test
+```

package/dist/adapter.d.ts

@@ -0,0 +1,111 @@
+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";
+export interface AgentRequest extends AgentRequestBase {
+    conversationId: string;
+    chatId: TelegramChatId;
+    messageId: number;
+    updateId: number;
+    userId?: number;
+    username?: string;
+    text: string;
+    abortSignal: AbortSignal;
+    metadata: {
+        telegram: TelegramRequestMetadata;
+        [key: string]: unknown;
+    };
+}
+export interface TelegramRequestMetadata {
+    updateId: number;
+    chat: {
+        id: TelegramChatId;
+        type?: string;
+        title?: string;
+        username?: string;
+    };
+    message: {
+        id: number;
+        date?: number;
+    };
+    from?: {
+        id: number;
+        isBot?: boolean;
+        username?: string;
+        firstName?: string;
+        lastName?: string;
+        languageCode?: string;
+    };
+}
+export type { AgentResponse };
+export type AgentResponder = SharedAgentResponder<AgentRequest, AgentMessageStream, AgentResponse>;
+export interface TelegramAdapterMessages {
+    welcomeText?: string;
+    helpText?: string;
+    busyText?: string;
+    unauthorizedText?: string;
+    cancelledText?: string;
+    errorText?: string;
+    unsupportedText?: string;
+}
+export interface TelegramAdapterStreamOptions {
+    initialStatusText?: string;
+    editDebounceMs?: number;
+    maxMessageChars?: number;
+}
+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;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,266 @@
+import { isAgentResponseCancelledError, } from "@mono-agent/agent-contracts";
+import { TelegramMessageStream, } from "./message-stream.js";
+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.",
+    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) {
+    const from = metadataFromUser(message.from);
+    const request = {
+        conversationId: `telegram:${String(message.chat.id)}`,
+        chatId: message.chat.id,
+        messageId: message.message_id,
+        updateId: update.update_id,
+        text,
+        abortSignal,
+        metadata: {
+            telegram: {
+                updateId: update.update_id,
+                chat: metadataFromChat(message.chat),
+                message: metadataFromMessage(message),
+            },
+        },
+    };
+    if (message.from?.id !== undefined) {
+        request.userId = message.from.id;
+    }
+    if (message.from?.username !== undefined) {
+        request.username = message.from.username;
+    }
+    if (from !== undefined) {
+        request.metadata.telegram.from = from;
+    }
+    return request;
+}
+function metadataFromChat(messageChat) {
+    const chat = { id: messageChat.id };
+    if (messageChat.type !== undefined) {
+        chat.type = messageChat.type;
+    }
+    if (messageChat.title !== undefined) {
+        chat.title = messageChat.title;
+    }
+    if (messageChat.username !== undefined) {
+        chat.username = messageChat.username;
+    }
+    return chat;
+}
+function metadataFromMessage(message) {
+    const metadata = { id: message.message_id };
+    if (message.date !== undefined) {
+        metadata.date = message.date;
+    }
+    return metadata;
+}
+function metadataFromUser(user) {
+    if (user === undefined) {
+        return undefined;
+    }
+    const metadata = { id: user.id };
+    if (user.is_bot !== undefined) {
+        metadata.isBot = user.is_bot;
+    }
+    if (user.username !== undefined) {
+        metadata.username = user.username;
+    }
+    if (user.first_name !== undefined) {
+        metadata.firstName = user.first_name;
+    }
+    if (user.last_name !== undefined) {
+        metadata.lastName = user.last_name;
+    }
+    if (user.language_code !== undefined) {
+        metadata.languageCode = user.language_code;
+    }
+    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;
+    }
+    return { name: match[1].toLowerCase() };
+}
+async function finishSafely(stream, text, logger) {
+    try {
+        await stream.finish(text);
+    }
+    catch (error) {
+        logger?.error?.("Failed to send Telegram terminal stream message.", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+import type { FieldGroup, RedactedSecretValue, SettingsJson } from "@mono-agent/settings";
+export interface TelegramAdapterConfig {
+    readonly botToken: string;
+    readonly allowedChatIds: readonly string[];
+    readonly allowAllChats: boolean;
+}
+export interface RedactedTelegramAdapterConfig {
+    readonly botToken: RedactedSecretValue;
+    readonly allowedChatIds: {
+        readonly count: number;
+    };
+    readonly allowAllChats: boolean;
+}
+export type TelegramAdapterConfigErrorCode = "missing_required_config" | "invalid_config";
+export interface TelegramAdapterConfigErrorDetails {
+    readonly code?: TelegramAdapterConfigErrorCode;
+    readonly env?: string;
+    readonly reason?: string;
+    readonly [key: string]: unknown;
+}
+export declare class TelegramAdapterConfigError extends Error {
+    readonly code: TelegramAdapterConfigErrorCode;
+    readonly details: TelegramAdapterConfigErrorDetails;
+    constructor(code: TelegramAdapterConfigErrorCode, message: string, details?: TelegramAdapterConfigErrorDetails);
+}
+export interface LoadTelegramAdapterConfigInput {
+    readonly env: Record<string, string | undefined>;
+    readonly json?: SettingsJson;
+    readonly jsonPath?: string;
+}
+export declare const telegramFieldGroup: FieldGroup;
+export declare function loadTelegramAdapterConfig(input: LoadTelegramAdapterConfigInput): Promise<TelegramAdapterConfig>;
+export declare function redactTelegramAdapterConfig(config: TelegramAdapterConfig): RedactedTelegramAdapterConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,69 @@
+import { defineFieldGroup, layerJsonOntoEnv, readBoolean, readCsv, readJsonSection, readRequired, readSettingsJson, redactedSecret, } from "@mono-agent/settings";
+export class TelegramAdapterConfigError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "TelegramAdapterConfigError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+const missingRequiredConfig = (message, details) => new TelegramAdapterConfigError("missing_required_config", message, details);
+const invalidConfig = (message, details) => new TelegramAdapterConfigError("invalid_config", message, details);
+export const telegramFieldGroup = defineFieldGroup({
+    id: "telegram",
+    label: "Telegram",
+    description: "Optional Telegram adapter configuration. The token is write-only.",
+    fields: [
+        {
+            id: "telegram.botToken",
+            label: "Bot token",
+            description: "Bot API token. Stored on disk only; never returned to the UI after save.",
+            kind: "secret",
+            path: ["telegram", "botToken"],
+        },
+        {
+            id: "telegram.allowedChatIds",
+            label: "Allowed chat ids",
+            description: "Comma-separated list of chat ids the bot will respond to.",
+            kind: "csv",
+            placeholder: "111111111, 222222222",
+            path: ["telegram", "allowedChatIds"],
+        },
+        {
+            id: "telegram.allowAllChats",
+            label: "Allow all chats",
+            description: "Explicitly permit every chat. Leave off when using an allowlist.",
+            kind: "switch",
+            path: ["telegram", "allowAllChats"],
+        },
+    ],
+});
+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 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);
+    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 };
+}
+export function redactTelegramAdapterConfig(config) {
+    return {
+        botToken: redactedSecret(config.botToken),
+        allowedChatIds: { count: config.allowedChatIds.length },
+        allowAllChats: config.allowAllChats,
+    };
+}
+function layerTelegramJsonOntoEnv(json, env) {
+    const section = readJsonSection(json, "telegram");
+    return layerJsonOntoEnv(env, [
+        { 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" },
+    ]);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+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 { startTelegramAdapter } from "./start.js";
+export type { TelegramAdapterStartOptions, TelegramAdapterStartResult, TelegramPollerLike, } 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

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,7 @@
+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 { startTelegramAdapter } from "./start.js";
+export { loadTelegramAdapterConfig, redactTelegramAdapterConfig, TelegramAdapterConfigError, telegramFieldGroup, } from "./config.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":"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"}

package/dist/long-poller.d.ts

@@ -0,0 +1,55 @@
+import type { TelegramBotApi, TelegramUpdate } from "./types.js";
+import type { TelegramUpdateHandlingResult } from "./adapter.js";
+export interface TelegramUpdateHandler {
+    handleUpdate(update: TelegramUpdate): Promise<TelegramUpdateHandlingResult>;
+}
+export interface TelegramLongPollerBackoffOptions {
+    initialMs?: number;
+    maxMs?: number;
+}
+export interface TelegramLongPollerLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    info?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+    error?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface TelegramLongPollerOptions {
+    api: TelegramBotApi;
+    adapter: TelegramUpdateHandler;
+    initialOffset?: number;
+    limit?: number;
+    timeoutSeconds?: number;
+    allowedUpdates?: string[];
+    deleteWebhookOnStart?: boolean;
+    dropPendingUpdates?: boolean;
+    backoff?: TelegramLongPollerBackoffOptions;
+    onError?: (error: unknown) => void | Promise<void>;
+    logger?: TelegramLongPollerLogger;
+}
+export interface TelegramLongPollerStartOptions {
+    signal?: AbortSignal;
+}
+export interface TelegramLongPollerPollOptions {
+    signal?: AbortSignal;
+}
+export declare class TelegramLongPoller {
+    private readonly api;
+    private readonly adapter;
+    private readonly limit;
+    private readonly timeoutSeconds;
+    private readonly allowedUpdates;
+    private readonly deleteWebhookOnStart;
+    private readonly dropPendingUpdates;
+    private readonly initialBackoffMs;
+    private readonly maxBackoffMs;
+    private readonly onError;
+    private readonly logger;
+    private nextUpdateOffset;
+    constructor(options: TelegramLongPollerOptions);
+    get nextOffset(): number | undefined;
+    start(options?: TelegramLongPollerStartOptions): Promise<void>;
+    pollOnce(options?: TelegramLongPollerPollOptions): Promise<number>;
+    private buildGetUpdatesParams;
+    private deleteWebhook;
+}
+//# sourceMappingURL=long-poller.d.ts.map