@spinabot/brigade 1.1.0 → 1.2.1

package/dist/agents/channels/telegram/adapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Telegram channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the grammY
+ * long-polling connection. Unlike WhatsApp (QR pairing), Telegram is
+ * TOKEN-based: the operator pastes a Bot API token from @BotFather, so this
+ * adapter declares a `setup` wizard (single `botToken` credential) and has NO
+ * `link`/QR flow. Enablement is explicit — `channels.telegram.enabled: true`
+ * plus a resolvable token.
+ *
+ * Modeled directly on `whatsapp/adapter.ts`: same health-flag mirroring, same
+ * deferred-media passthrough on inbound, same chunk-then-send outbound shape
+ * (chunk markdown ≤4096, convert each chunk to Telegram HTML, send with
+ * `parse_mode: HTML`, and on a parse / empty-text error RETRY as plain text).
+ *
+ * Scope cut (v1): single account, and `callback_query` inline buttons are not
+ * handled (Brigade approvals are central text replies).
+ */
+import { type ChannelAdapter, type ChannelCapabilities, type OutboundSendOptions } from "../sdk.js";
+import { type ConnectTelegramArgs, type TelegramConnection, type TelegramPollSpec } from "./connection.js";
+/** Adapter construction options — all optional for back-compat. */
+export interface CreateTelegramAdapterOptions {
+    /** Per-account scope. Defaults to `"default"` (single-account v1). */
+    accountId?: string;
+    /**
+     * TEST SEAM: override how the connection is built. Production leaves this
+     * undefined and `connectTelegram` lazy-loads grammY. Tests inject a fake.
+     */
+    connectImpl?: (args: ConnectTelegramArgs) => Promise<TelegramConnection>;
+    /**
+     * The bot's `/` command menu to register on connect (Brigade's central
+     * commands, already mapped to `{ command, description }` via
+     * `buildTelegramCommandMenu`). Empty/omitted → no menu sync. The manager
+     * supplies this from `buildBundledCommands(adapter)`.
+     */
+    commandMenu?: Array<{
+        command: string;
+        description: string;
+    }>;
+    /**
+     * Widen the `allowed_updates` poller subscription beyond the default
+     * `message` + `callback_query`. Omitted → the minimal set.
+     */
+    allowedUpdates?: string[];
+    /**
+     * Enable forum-topic auto-labeling: when set, the FIRST message seen on a
+     * forum thread renames that topic from the message text. Off by default —
+     * the plugin path enables it from `channels.telegram.autoLabelTopics`.
+     */
+    autoLabelTopics?: boolean;
+}
+export declare function createTelegramAdapter(opts?: CreateTelegramAdapterOptions): ChannelAdapter;
+/** Static Telegram capability flags (shared by the legacy adapter + plugin meta). */
+export declare const TELEGRAM_CAPABILITIES: ChannelCapabilities;
+/**
+ * The Telegram adapter shape with its poll extension. `createTelegramAdapter`
+ * returns a `ChannelAdapter`, but the concrete object ALSO carries `sendPoll`
+ * (not in the base contract). Callers that want polls cast through this type.
+ */
+export interface TelegramAdapter extends ChannelAdapter {
+    sendPoll(conversationId: string, poll: TelegramPollSpec, opts?: OutboundSendOptions): Promise<{
+        messageId?: string;
+    }>;
+    /**
+     * Feed a raw Telegram `Update` (webhook mode). The gateway HTTP route calls
+     * this after verifying the secret-token header. No-op when not started or in
+     * polling mode. The argument is the parsed JSON body Telegram POSTed.
+     */
+    feedWebhookUpdate(update: unknown): void;
+    /** The transport mode this adapter's connection runs (`"polling"` | `"webhook"`). */
+    transportMode(): "polling" | "webhook" | "unstarted";
+}
+/**
+ * Derive a forum-topic name from a message's first line. Telegram caps topic
+ * names at 128 chars; we use the first line, collapsed + trimmed, clamped to a
+ * readable length. Returns "" when nothing usable remains.
+ */
+export declare function deriveTopicName(text: string): string;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/agents/channels/telegram/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,EACN,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EAMxB,KAAK,mBAAmB,EAExB,MAAM,WAAW,CAAC;AAUnB,OAAO,EAAmB,KAAK,mBAAmB,EAA4B,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUtJ,mEAAmE;AACnE,MAAM,WAAW,4BAA4B;IAC5C,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE;;;;;OAKG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,4BAAiC,GAAG,cAAc,CAkZ7F;AAED,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,EAAE,mBAUnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtH;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,qFAAqF;IACrF,aAAa,IAAI,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CACrD;AAgBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/agents/channels/telegram/adapter.js

@@ -0,0 +1,475 @@
+/**
+ * Telegram channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the grammY
+ * long-polling connection. Unlike WhatsApp (QR pairing), Telegram is
+ * TOKEN-based: the operator pastes a Bot API token from @BotFather, so this
+ * adapter declares a `setup` wizard (single `botToken` credential) and has NO
+ * `link`/QR flow. Enablement is explicit — `channels.telegram.enabled: true`
+ * plus a resolvable token.
+ *
+ * Modeled directly on `whatsapp/adapter.ts`: same health-flag mirroring, same
+ * deferred-media passthrough on inbound, same chunk-then-send outbound shape
+ * (chunk markdown ≤4096, convert each chunk to Telegram HTML, send with
+ * `parse_mode: HTML`, and on a parse / empty-text error RETRY as plain text).
+ *
+ * Scope cut (v1): single account, and `callback_query` inline buttons are not
+ * handled (Brigade approvals are central text replies).
+ */
+import { loadConfig } from "../../../core/config.js";
+// Channel SDK barrel — the single import surface for the channel-authoring
+// contract + shared helpers. Telegram is the proving ground: contract types
+// (ChannelAdapter / ChannelHealth / ChannelStartContext / OutboundMedia /
+// OutboundSendOptions) and `chunkText` now come from one place instead of
+// scattered `../../extensions/types.js` + `../whatsapp/chunk.js` paths.
+import { chunkText, } from "../sdk.js";
+import { listTelegramAccountIds, resolveTelegramBotToken, telegramChannelEnabled, telegramWebhookConfig, TELEGRAM_CHANNEL_ID, TELEGRAM_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { buildTelegramApprovalKeyboard, buildTelegramApprovalText } from "./approval-native.js";
+import { connectTelegram } from "./connection.js";
+import { markdownToTelegramHtml, telegramHtmlIsEmpty } from "./format.js";
+import { resolveTelegramApprover } from "./approval-authorize.js";
+/** Telegram's per-message text limit. */
+const TELEGRAM_TEXT_LIMIT = 4096;
+/** Errors Telegram returns when HTML failed to parse / produced an empty body. */
+const PARSE_ERROR_RE = /can't parse entities|parse entities|find end of the entity|message text is empty/i;
+export function createTelegramAdapter(opts = {}) {
+    const accountId = opts.accountId?.trim() || TELEGRAM_DEFAULT_ACCOUNT_ID;
+    const connectImpl = opts.connectImpl ?? connectTelegram;
+    let connection = null;
+    // Forum threads we've already auto-labeled this process, so the rename fires
+    // only on the FIRST message of a topic (keyed `${chatId}:${threadId}`).
+    const autoLabeledThreads = new Set();
+    // The ChannelStartContext doesn't carry the config, but the manager ALWAYS
+    // calls `isConfigured(cfg, env)` immediately before `start(ctx)` — so we
+    // capture the config + env it passed there and read the token from them in
+    // start(). This avoids a second config load and keeps the adapter pure.
+    let lastConfig = null;
+    let lastEnv = process.env;
+    // Health flags mirrored from the connection lifecycle so health() never has
+    // to round-trip Telegram on the hot path (cron timer / send pre-flight).
+    //   - `connected` flips true on a successful getMe + poll start.
+    //   - `tokenInvalid` is STICKY: a 401 means the token is dead and the only
+    //     recovery is `brigade channels add --channel telegram` with a new token.
+    let connected = false;
+    let tokenInvalid = false;
+    const adapter = {
+        id: TELEGRAM_CHANNEL_ID,
+        label: "Telegram",
+        isConfigured(cfg, env) {
+            // Capture for start() — the manager calls this right before start(ctx).
+            lastConfig = cfg;
+            lastEnv = env ?? process.env;
+            if (!telegramChannelEnabled(cfg))
+                return false;
+            // Need a resolvable bot token (config `${VAR}` ref or TELEGRAM_BOT_TOKEN env).
+            if (!resolveTelegramBotToken(cfg, accountId, env ?? process.env))
+                return false;
+            // Multi-account follow-up: when the operator declares >1 account, the
+            // (future) plugin path owns lifecycle and the legacy single adapter
+            // steps aside. v1 only ever runs the default account.
+            const isLegacyAdapter = accountId === TELEGRAM_DEFAULT_ACCOUNT_ID;
+            if (isLegacyAdapter && listTelegramAccountIds(cfg).length > 1)
+                return false;
+            return true;
+        },
+        async start(ctx) {
+            // Resolve the token from the config the manager handed isConfigured().
+            // Fall back to a fresh load defensively (e.g. a direct start() in a test
+            // that skipped isConfigured).
+            const cfg = lastConfig ?? (await loadStartConfig());
+            const token = resolveTelegramBotToken(cfg, accountId, lastEnv);
+            if (!token) {
+                // Defensive — isConfigured already gates this, but never start a bot
+                // with an empty token (grammY would throw an opaque error).
+                ctx.log("Telegram not started — no bot token resolved (set channels.telegram.botToken or TELEGRAM_BOT_TOKEN).");
+                return;
+            }
+            // Resolve transport mode (polling default; webhook opt-in). Webhook mode
+            // registers the webhook on connect; the gateway HTTP route feeds updates
+            // via `feedWebhookUpdate` (wired by the module when webhook is active).
+            const transport = telegramWebhookConfig(cfg, lastEnv);
+            connection = await connectImpl({
+                token,
+                accountId,
+                ...(opts.commandMenu && opts.commandMenu.length > 0 ? { commandMenu: opts.commandMenu } : {}),
+                ...(opts.allowedUpdates && opts.allowedUpdates.length > 0 ? { allowedUpdates: opts.allowedUpdates } : {}),
+                ...(transport.mode === "webhook"
+                    ? {
+                        mode: "webhook",
+                        webhook: {
+                            ...(transport.url ? { url: transport.url } : {}),
+                            ...(transport.secretToken ? { secretToken: transport.secretToken } : {}),
+                        },
+                    }
+                    : {}),
+                log: ctx.log,
+                onConnected: () => {
+                    connected = true;
+                    tokenInvalid = false;
+                    ctx.log("Telegram ready");
+                    ctx.onConnected?.();
+                },
+                onTokenInvalid: () => {
+                    connected = false;
+                    tokenInvalid = true;
+                    ctx.log("Telegram bot token was rejected. Run `brigade channels add --channel telegram` with a fresh @BotFather token.");
+                    ctx.onLoggedOut?.();
+                },
+                onMessage: (msg) => {
+                    // Forum-topic auto-labeling: rename a topic from its first message.
+                    // Fire-and-forget + best-effort — never blocks inbound delivery.
+                    if (opts.autoLabelTopics && msg.threadId && msg.chatType === "group" && msg.text.trim()) {
+                        maybeAutoLabelThread(msg.conversationId, msg.threadId, msg.text);
+                    }
+                    void ctx.onInbound({
+                        channel: TELEGRAM_CHANNEL_ID,
+                        accountId,
+                        conversationId: msg.conversationId,
+                        messageId: msg.messageId,
+                        messageTimestampMs: msg.messageTimestampMs,
+                        from: msg.from,
+                        fromName: msg.fromName,
+                        text: msg.text,
+                        chatType: msg.chatType,
+                        isGroup: msg.chatType === "group",
+                        threadId: msg.threadId,
+                        mentions: msg.mentions,
+                        replyTo: msg.replyTo,
+                        // Deferred media thunk rides through untouched — the pipeline
+                        // resolves it only after the access gate admits the sender.
+                        resolveMedia: msg.resolveMedia,
+                        raw: msg.raw,
+                    });
+                },
+                // Inline-button press → emit an InboundMessage carrying `callbackQuery`
+                // so the central pipeline's approval-callback path resolves it. The
+                // connection has already acked the press via `answerCallbackQuery`.
+                onCallbackQuery: (msg) => {
+                    if (!msg.callbackQuery)
+                        return;
+                    void ctx.onInbound({
+                        channel: TELEGRAM_CHANNEL_ID,
+                        accountId,
+                        conversationId: msg.conversationId,
+                        from: msg.from,
+                        ...(msg.fromName !== undefined ? { fromName: msg.fromName } : {}),
+                        text: "",
+                        chatType: msg.chatType,
+                        isGroup: msg.chatType === "group",
+                        ...(msg.threadId !== undefined ? { threadId: msg.threadId } : {}),
+                        callbackQuery: msg.callbackQuery,
+                        raw: msg.raw,
+                    });
+                },
+            });
+        },
+        async stop() {
+            await connection?.close();
+            connection = null;
+            connected = false;
+        },
+        /**
+         * Synchronous read of the cached connection state:
+         *   - `{ ok: true }` once polling is live.
+         *   - `{ ok: false, kind: "logged-out" }` after a 401 (sticky; re-token).
+         *   - `{ ok: false, kind: "starting" }` between start() and first connect.
+         *   - `{ ok: false, kind: "disconnected" }` for a transient drop mid-reconnect.
+         */
+        health() {
+            if (tokenInvalid || connection?.isTokenInvalid()) {
+                return {
+                    ok: false,
+                    kind: "logged-out",
+                    reason: "Telegram bot token was rejected — Brigade can't send until a new token is set.",
+                    remediation: "Run `brigade channels add --channel telegram` and paste a fresh @BotFather token.",
+                };
+            }
+            if (!connection) {
+                return { ok: false, kind: "starting", reason: "Telegram adapter is not started yet." };
+            }
+            if (!connected || !connection.isConnected()) {
+                return {
+                    ok: false,
+                    kind: "disconnected",
+                    reason: "Telegram is reconnecting — sends will fail until polling resumes.",
+                };
+            }
+            return { ok: true };
+        },
+        async sendText(conversationId, text, opts) {
+            if (!connection)
+                throw new Error("Telegram channel is not started");
+            if (tokenInvalid || connection.isTokenInvalid()) {
+                throw new Error("Telegram token is invalid — run `brigade channels add --channel telegram` with a new token, then retry.");
+            }
+            const threadId = opts?.threadId;
+            // Chunk on the RAW markdown so fences/paragraphs aren't shredded, then
+            // convert each chunk to Telegram HTML and send. A chunk whose HTML is
+            // empty (syntax-only) or that Telegram rejects with a parse error is
+            // re-sent as plain text.
+            const chunks = chunkText(text, { limit: TELEGRAM_TEXT_LIMIT });
+            for (const chunk of chunks) {
+                const html = markdownToTelegramHtml(chunk);
+                if (telegramHtmlIsEmpty(html)) {
+                    // Nothing renderable — send the raw chunk as plain text (if it has any).
+                    if (chunk.trim().length > 0) {
+                        await connection.sendText(conversationId, chunk, { threadId });
+                    }
+                    continue;
+                }
+                try {
+                    await connection.sendText(conversationId, html, { html: true, threadId });
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (PARSE_ERROR_RE.test(msg) && chunk.trim().length > 0) {
+                        // HTML failed to parse — fall back to the plain chunk.
+                        await connection.sendText(conversationId, chunk, { threadId });
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+        },
+        // Telegram ids are numeric user/chat ids and @usernames, so the pairing
+        // challenge card uses the "Your username" line.
+        pairing: { idLabel: "username" },
+        // Token-based setup wizard — `brigade channels add --channel telegram`
+        // prompts for the bot token and writes `channels.telegram.botToken`.
+        setup: {
+            credentialKeys: [
+                {
+                    key: "botToken",
+                    prompt: "Telegram bot token (from @BotFather)",
+                    secret: true,
+                    envVar: "TELEGRAM_BOT_TOKEN",
+                    docsUrl: "https://core.telegram.org/bots#botfather",
+                },
+            ],
+            validateInput(key, value) {
+                if (key !== "botToken")
+                    return null;
+                const v = value.trim();
+                // @BotFather tokens look like `<digits>:<35-ish base64url chars>`.
+                if (/^\d{6,}:[A-Za-z0-9_-]{30,}$/.test(v))
+                    return null;
+                // Allow a `${VAR}` ref through (resolved at runtime).
+                if (/^\$\{[A-Z_][A-Z0-9_]*\}$/.test(v))
+                    return null;
+                return "That doesn't look like a bot token — expected `123456:ABC-DEF…` from @BotFather.";
+            },
+        },
+        async sendMedia(conversationId, media) {
+            if (!connection)
+                throw new Error("Telegram channel is not started");
+            await connection.sendMedia(conversationId, media);
+        },
+        // Outbound poll. Not part of the base `ChannelAdapter` contract — exposed as
+        // an extra method the plugin outbound + a typed accessor reach. Returns the
+        // poll message's id (string) so the agent can later act on it.
+        async sendPoll(conversationId, poll, opts) {
+            if (!connection)
+                throw new Error("Telegram channel is not started");
+            const normalized = normalizePollSpec(poll);
+            const sent = await connection.sendPoll(conversationId, normalized, {
+                ...(opts?.threadId !== undefined ? { threadId: opts.threadId } : {}),
+            });
+            return { messageId: String(sent.messageId) };
+        },
+        async react(conversationId, messageId, emoji) {
+            if (!connection)
+                return; // cosmetic — refuse silently when not started
+            await connection.react(conversationId, messageId, emoji);
+        },
+        async setComposing(conversationId, state) {
+            if (!connection)
+                return;
+            await connection.setComposing(conversationId, state);
+        },
+        // Static capability flags. The central `message_action` tool PRE-CHECKS the
+        // relevant flag here before calling `handleAction`, so an unsupported action
+        // fails cleanly without touching the adapter. Telegram supports edit
+        // (editMessageText), unsend (deleteMessage), reactions (setMessageReaction),
+        // reply (sendText with a thread), threads (forum topics), media, polls, and
+        // the native command menu.
+        capabilities: TELEGRAM_CAPABILITIES,
+        // Native inline-button approvals. When a channel-routed turn raises an
+        // approval, the central router calls `sendApprovalPrompt` to render the
+        // question as buttons (payloads from the central codec); the press comes
+        // back as `InboundMessage.callbackQuery` and is resolved centrally. A
+        // pathological approval id that can't fit the 64-byte button budget falls
+        // back to the text prompt (the router sends text when this throws/returns
+        // without a keyboard — here we throw so the router's catch path runs).
+        approvalCapability: {
+            async sendApprovalPrompt(params) {
+                if (!connection)
+                    throw new Error("Telegram channel is not started");
+                const keyboard = buildTelegramApprovalKeyboard({ approvalId: params.approvalId });
+                if (!keyboard) {
+                    // Too few byte-safe buttons — let the router fall back to text.
+                    throw new Error("telegram approval prompt: approval id too long for inline buttons");
+                }
+                const text = buildTelegramApprovalText({
+                    command: params.command,
+                    approvalKind: params.approvalKind,
+                    ...(params.toolName !== undefined ? { toolName: params.toolName } : {}),
+                });
+                // Send with the inline keyboard via the dedicated interactive path.
+                await connection.sendInteractive(params.conversationId, text, keyboard, {
+                    ...(params.threadId !== undefined ? { threadId: params.threadId } : {}),
+                });
+            },
+            authorizeApprover(p) {
+                return resolveTelegramApprover({
+                    cfg: p.cfg,
+                    ...(p.senderId !== undefined ? { senderId: p.senderId } : {}),
+                    ...(p.accountId !== undefined ? { accountId: p.accountId } : {}),
+                });
+            },
+        },
+        // Edit / delete / react / pin / unpin a message. The manager pre-checks the
+        // capability flag (above) before calling, so an action only reaches here
+        // when Telegram advertised support for it. Edit text is already sanitized +
+        // HTML-formatted centrally? No — `message_action` sanitizes <think> leaks
+        // but the HTML formatting is ours, so run `edit` text through the same
+        // markdown→HTML converter the reply path uses.
+        async handleAction(p) {
+            if (!connection)
+                return { ok: false, error: "Telegram channel is not started" };
+            if (tokenInvalid || connection.isTokenInvalid()) {
+                return { ok: false, error: "Telegram token is invalid — re-token before acting on messages." };
+            }
+            const a = p.action;
+            try {
+                switch (a.kind) {
+                    case "edit": {
+                        // Run the new text through the Telegram HTML formatter (same as
+                        // the reply path); fall back to plain text on a parse error.
+                        const html = markdownToTelegramHtml(a.text);
+                        if (telegramHtmlIsEmpty(html)) {
+                            await connection.editMessageText(p.conversationId, a.messageId, a.text);
+                        }
+                        else {
+                            try {
+                                await connection.editMessageText(p.conversationId, a.messageId, html, { html: true });
+                            }
+                            catch (err) {
+                                const m = err instanceof Error ? err.message : String(err);
+                                if (PARSE_ERROR_RE.test(m)) {
+                                    await connection.editMessageText(p.conversationId, a.messageId, a.text);
+                                }
+                                else {
+                                    throw err;
+                                }
+                            }
+                        }
+                        return { ok: true, messageId: a.messageId };
+                    }
+                    case "delete":
+                        await connection.deleteMessage(p.conversationId, a.messageId);
+                        return { ok: true, messageId: a.messageId };
+                    case "react":
+                        await connection.react(p.conversationId, a.messageId, a.emoji);
+                        return { ok: true, messageId: a.messageId };
+                    case "pin":
+                        await connection.pinMessage(p.conversationId, a.messageId);
+                        return { ok: true, messageId: a.messageId };
+                    case "unpin":
+                        await connection.unpinMessage(p.conversationId, a.messageId);
+                        return { ok: true, messageId: a.messageId };
+                    case "reply": {
+                        // A reply is just a threaded send; surface the new id.
+                        const sent = await connection.sendText(p.conversationId, a.text, {
+                            ...(a.threadId !== undefined ? { threadId: a.threadId } : {}),
+                        });
+                        return { ok: true, messageId: String(sent.messageId) };
+                    }
+                    default:
+                        return { ok: false, error: `unsupported action kind` };
+                }
+            }
+            catch (err) {
+                return { ok: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+        selfId() {
+            return connection?.selfId() ?? undefined;
+        },
+        connectedAt() {
+            return connection?.connectedAt() ?? null;
+        },
+        feedWebhookUpdate(update) {
+            // Defensive: only dispatch a plausibly-shaped update object.
+            if (!connection || !update || typeof update !== "object")
+                return;
+            connection.feedUpdate(update);
+        },
+        transportMode() {
+            return connection ? connection.mode() : "unstarted";
+        },
+    };
+    /**
+     * Best-effort forum-topic auto-label: on the FIRST message seen on a thread
+     * (this process), rename the topic from the message text. Fire-and-forget so
+     * it never delays inbound delivery; the connection swallows API errors.
+     */
+    function maybeAutoLabelThread(conversationId, threadId, text) {
+        const key = `${conversationId}:${threadId}`;
+        if (autoLabeledThreads.has(key))
+            return;
+        autoLabeledThreads.add(key);
+        const name = deriveTopicName(text);
+        if (!name)
+            return;
+        void connection?.editForumTopic(conversationId, threadId, name);
+    }
+    return adapter;
+}
+/** Static Telegram capability flags (shared by the legacy adapter + plugin meta). */
+export const TELEGRAM_CAPABILITIES = {
+    chatTypes: ["direct", "group", "thread"],
+    reactions: true,
+    edit: true,
+    unsend: true,
+    reply: true,
+    threads: true,
+    media: true,
+    polls: true,
+    nativeCommands: true,
+};
+/** Telegram allows 2–10 poll options; clamp + require a non-empty question. */
+function normalizePollSpec(poll) {
+    const question = (poll.question ?? "").trim();
+    if (!question)
+        throw new Error("Telegram poll: a non-empty question is required.");
+    const options = (poll.options ?? []).map((o) => String(o).trim()).filter(Boolean).slice(0, 10);
+    if (options.length < 2)
+        throw new Error("Telegram poll: at least 2 options are required.");
+    return {
+        question: question.length > 300 ? question.slice(0, 300) : question,
+        options,
+        ...(poll.isAnonymous !== undefined ? { isAnonymous: poll.isAnonymous } : {}),
+        ...(poll.allowsMultipleAnswers !== undefined ? { allowsMultipleAnswers: poll.allowsMultipleAnswers } : {}),
+    };
+}
+/**
+ * Derive a forum-topic name from a message's first line. Telegram caps topic
+ * names at 128 chars; we use the first line, collapsed + trimmed, clamped to a
+ * readable length. Returns "" when nothing usable remains.
+ */
+export function deriveTopicName(text) {
+    const firstLine = (text.split(/\r?\n/, 1)[0] ?? "").replace(/\s+/g, " ").trim();
+    if (!firstLine)
+        return "";
+    return firstLine.length > 64 ? `${firstLine.slice(0, 63)}…` : firstLine;
+}
+/**
+ * Defensive config fallback for a direct `start()` that skipped `isConfigured`
+ * (the manager always calls isConfigured first, so this is the rare path). Sync
+ * + cached — `loadConfig` carries no heavy deps.
+ */
+async function loadStartConfig() {
+    return loadConfig();
+}
+//# sourceMappingURL=adapter.js.map

package/dist/agents/channels/telegram/adapter.js.map

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

package/dist/agents/channels/telegram/allowed-updates.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Telegram `allowed_updates` resolver.
+ *
+ * Telegram's `getUpdates` / `setWebhook` take an `allowed_updates` allow-list:
+ * only the named update kinds are delivered. Brigade subscribes the MINIMAL set
+ * its central pipeline actually consumes — keeping the firehose narrow means a
+ * chatty group never floods the poller with update kinds Brigade ignores
+ * (business messages, channel posts, inline queries, shipping/checkout, …, all
+ * of which the reference upstream subscribes but Brigade has no consumer for).
+ *
+ * The base set is always:
+ *   - `message`        — the inbound text/media path (the core surface).
+ *   - `callback_query` — inline-button presses (interactive approvals). Without
+ *     this in the list, a button tap is silently never delivered and the
+ *     approval prompt hangs for its full timeout. Subscribed unconditionally so
+ *     a button rendered by `sendApprovalPrompt` is always answerable.
+ *
+ * Conditionally added:
+ *   - `message_reaction` — only when the channel opts into reaction inbound
+ *     handling (`opts.reactions`). Brigade does not route inbound reactions to a
+ *     turn today, so it is OFF by default; the flag exists so a future reaction-
+ *     trigger feature can switch it on without touching the poller wiring.
+ *   - `edited_message`   — only when `opts.editedMessages` (off by default;
+ *     Brigade treats an edit as a no-op rather than re-running the turn).
+ *
+ * Output is always a DEDUPED, STABLE-ORDER array of plain lowercase ASCII update
+ * names (no NUL / control bytes — these are fixed string literals).
+ */
+/** One Telegram update kind Brigade may subscribe. */
+export type TelegramAllowedUpdate = "message" | "callback_query" | "message_reaction" | "edited_message";
+/** Options gating the conditional update kinds. */
+export interface ResolveTelegramAllowedUpdatesOptions {
+    /** Subscribe `message_reaction` (inbound reaction events). Default false. */
+    reactions?: boolean;
+    /** Subscribe `edited_message` (inbound message edits). Default false. */
+    editedMessages?: boolean;
+}
+/**
+ * Resolve the `allowed_updates` list Brigade's Telegram poller/webhook should
+ * request. `message` + `callback_query` are always present; reactions / edited
+ * messages are added only when explicitly enabled. Deduped + stable order.
+ */
+export declare function resolveTelegramAllowedUpdates(opts?: ResolveTelegramAllowedUpdatesOptions): TelegramAllowedUpdate[];
+//# sourceMappingURL=allowed-updates.d.ts.map

package/dist/agents/channels/telegram/allowed-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowed-updates.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/allowed-updates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAC9B,SAAS,GACT,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,CAAC;AAEpB,mDAAmD;AACnD,MAAM,WAAW,oCAAoC;IACpD,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC5C,IAAI,GAAE,oCAAyC,GAC7C,qBAAqB,EAAE,CAczB"}