@spinabot/brigade 1.1.0 → 1.2.0

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

@@ -0,0 +1,359 @@
+/**
+ * Telegram Bot API connection (grammY long-polling).
+ *
+ * The Brigade analogue of `whatsapp/connection.ts`, distilled from the
+ * reference Telegram polling session. grammY + its runner + the throttler transformer are
+ * HEAVY and only needed when a Telegram channel actually starts, so they are
+ * lazy-imported here (`await import("grammy")` inside `connectTelegram`) — a
+ * non-Telegram boot never pays for them. Types are `type`-only so the static
+ * import never pulls the runtime in.
+ *
+ * Lifecycle:
+ *   - `deleteWebhook({ drop_pending_updates: false })` is called BEFORE polling.
+ *     If a webhook was ever set on this bot, `getUpdates` returns 409 forever
+ *     and the bot silently "receives nothing" — clearing it first is the #1 fix.
+ *   - `getMe` caches the bot's numeric id + @username (the group ACL needs the
+ *     username to detect @-mentions; without it group messages never reach the
+ *     agent).
+ *   - `bot.on("message")` normalizes each update into a `TgInboundMessage` and
+ *     hands it to `onMessage` with a DEFERRED `resolveMedia` thunk — bytes are
+ *     downloaded only after the central access gate admits the sender (mirrors
+ *     WhatsApp).
+ *   - The grammY runner drives `getUpdates`; `apiThrottler()` rate-limits the
+ *     outbound API.
+ *   - Reconnect backoff COPIES WhatsApp's constants (2s → 30s, ×1.8, ±25%).
+ *   - 401 Unauthorized → sticky `tokenInvalid` (terminal; the only fix is a new
+ *     token — stop polling).
+ *   - 409 Conflict (getUpdates) → another poller/webhook is live: clear the
+ *     webhook and restart ONCE, then fall back to normal backoff.
+ *   - Updates are de-duplicated by `update_id` (a redelivered update after a
+ *     restart must not double-run the agent).
+ *
+ * Scope cut (v1): `callback_query` (inline-button taps) is intentionally NOT
+ * subscribed — Brigade's approvals are central TEXT replies handled in
+ * `inbound-pipeline.ts`, so `allowed_updates` only needs message updates.
+ */
+import { type InboundMediaAttachment, type InboundReplyContext, type OutboundMedia } from "../sdk.js";
+import type { Message, Update } from "@grammyjs/types";
+/**
+ * Jittered exponential backoff for reconnect attempt `attempt` (0-based).
+ * Thin wrapper over the neutral `nextBackoffDelay` helper — kept as a named
+ * export so `index.ts` and the connection tests have a stable entry point.
+ */
+export declare function telegramBackoffDelay(attempt: number): number;
+/** A normalized inbound Telegram message (text and/or media). */
+export interface TgInboundMessage {
+    /** Chat id as a string — the conversation id. */
+    conversationId: string;
+    /** Telegram `message_id` as a string — surfaces for reply targeting. */
+    messageId?: string;
+    /** When Telegram stamped the message (epoch ms). */
+    messageTimestampMs?: number;
+    /** Sender id within the channel — the user's numeric id as a string. */
+    from: string;
+    /** Sender display name (`First Last` or `@username`), when present. */
+    fromName?: string;
+    /** Plain message text (caption-aware, text_link-expanded). May be empty for media. */
+    text: string;
+    /** `direct` (private) or `group` (group/supergroup). */
+    chatType: "direct" | "group";
+    /** Forum-topic / thread id (`message_thread_id`) as a string, when present. */
+    threadId?: string;
+    /** Numeric ids of @-mentioned accounts (incl. the bot's own id when addressed). */
+    mentions?: string[];
+    /** Quoted-reply context, when this message replies to another. */
+    replyTo?: InboundReplyContext;
+    /**
+     * DEFERRED media download. The connection layer does NOT download eagerly —
+     * the pipeline invokes this ONLY after the access gate admits the sender, so
+     * a blocked stranger's group video is never fetched. Resolves to an empty
+     * array for text-only messages.
+     */
+    resolveMedia?: () => Promise<InboundMediaAttachment[]>;
+    /**
+     * Inline-button callback context — present ONLY when this inbound is a
+     * `callback_query` (a button press) rather than a typed message. `data` is
+     * the opaque payload the pressed button declared at send time (an
+     * approval-callback codec string); `callbackId` is the Telegram
+     * `callback_query.id` used to `answerCallbackQuery`. Undefined for ordinary
+     * messages. The central pipeline routes a present `callbackQuery` to the
+     * approval-callback path.
+     */
+    callbackQuery?: {
+        data: string;
+        callbackId: string;
+    };
+    /** Raw grammY message (for adapters that need more). */
+    raw: Message;
+}
+/**
+ * The minimal slice of grammY's `Bot` the connection drives. Declared as an
+ * interface (rather than importing grammY's concrete `Bot`) so tests can inject
+ * a fake bot with zero network — the runtime path builds a real grammY `Bot`
+ * and it structurally satisfies this shape.
+ */
+export interface TelegramBotLike {
+    api: {
+        getMe(): Promise<TelegramBotIdentity>;
+        deleteWebhook(opts?: {
+            drop_pending_updates?: boolean;
+        }): Promise<boolean>;
+        /** Register a webhook (webhook transport mode). */
+        setWebhook?(url: string, opts?: Record<string, unknown>): Promise<boolean>;
+        sendMessage(chatId: string | number, text: string, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendChatAction(chatId: string | number, action: string, opts?: Record<string, unknown>): Promise<boolean>;
+        setMessageReaction?(chatId: string | number, messageId: number, reaction: unknown, opts?: Record<string, unknown>): Promise<boolean>;
+        getFile(fileId: string): Promise<{
+            file_path?: string;
+            file_unique_id?: string;
+            file_size?: number;
+        }>;
+        sendPhoto?(chatId: string | number, photo: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendVideo?(chatId: string | number, video: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendAudio?(chatId: string | number, audio: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendVoice?(chatId: string | number, voice: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendDocument?(chatId: string | number, document: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        sendSticker?(chatId: string | number, sticker: unknown, opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        /** Send a native poll (outbound poll support). */
+        sendPoll?(chatId: string | number, question: string, options: string[], opts?: Record<string, unknown>): Promise<{
+            message_id: number;
+        }>;
+        /** Acknowledge an inline-button press (clears the loading spinner client-side). */
+        answerCallbackQuery?(callbackQueryId: string, opts?: Record<string, unknown>): Promise<boolean>;
+        /** Edit a previously-sent message's text (message_action `edit`). */
+        editMessageText?(chatId: string | number, messageId: number, text: string, opts?: Record<string, unknown>): Promise<unknown>;
+        /** Delete a message (message_action `delete`). */
+        deleteMessage?(chatId: string | number, messageId: number, opts?: Record<string, unknown>): Promise<boolean>;
+        /** Pin a chat message (message_action `pin`). */
+        pinChatMessage?(chatId: string | number, messageId: number, opts?: Record<string, unknown>): Promise<boolean>;
+        /** Unpin a chat message (message_action `unpin`). */
+        unpinChatMessage?(chatId: string | number, opts?: Record<string, unknown>): Promise<boolean>;
+        /** Rename a forum topic (thread auto-labeling). */
+        editForumTopic?(chatId: string | number, messageThreadId: number, opts?: Record<string, unknown>): Promise<boolean>;
+        /** Register the bot's `/` command menu (native command surface). */
+        setMyCommands?(commands: Array<{
+            command: string;
+            description: string;
+        }>, opts?: Record<string, unknown>): Promise<boolean>;
+        config?: {
+            use(transformer: unknown): void;
+        };
+    };
+    /**
+     * Subscribe to an update kind. The connection subscribes `"message"` for the
+     * inbound text/media path and `"callback_query"` for inline-button presses
+     * (interactive approvals). grammY's real `on` is overloaded across every
+     * filter; this minimal contract declares only the two Brigade consumes.
+     */
+    on(filter: "message", handler: (ctx: {
+        update: Update;
+        message?: Message;
+    }) => unknown): void;
+    on(filter: "callback_query", handler: (ctx: {
+        update: Update;
+        callbackQuery?: TelegramCallbackQuery;
+        answerCallbackQuery: (opts?: Record<string, unknown>) => Promise<unknown>;
+    }) => unknown): void;
+    /** Stop the bot (grammY). */
+    stop(): Promise<void> | void;
+}
+/** What `getMe` returns — the bot's identity + group/inline capability flags. */
+export interface TelegramBotIdentity {
+    id: number;
+    username?: string;
+    first_name?: string;
+    can_join_groups?: boolean;
+    can_read_all_group_messages?: boolean;
+    supports_inline_queries?: boolean;
+}
+/** A Telegram `callback_query` update payload (the subset Brigade reads). */
+export interface TelegramCallbackQuery {
+    id: string;
+    data?: string;
+    from?: {
+        id?: number;
+        username?: string;
+        first_name?: string;
+        last_name?: string;
+    };
+    message?: Message;
+}
+/** A grammY-runner-like handle (what `run(bot)` returns). */
+interface RunnerLike {
+    isRunning(): boolean;
+    stop(): Promise<void> | void;
+    task(): Promise<void>;
+}
+export interface ConnectTelegramArgs {
+    /** Bot API token. NEVER logged (redacted in any URL). */
+    token: string;
+    /** Account namespace stamped on inbounds (single-account v1 → "default"). */
+    accountId?: string;
+    /** Called once `getMe` succeeds and polling starts. */
+    onConnected?: () => void;
+    /** Called when the token is rejected (401) — terminal, re-token required. */
+    onTokenInvalid?: () => void;
+    /** Called for every inbound message. */
+    onMessage: (msg: TgInboundMessage) => void;
+    /**
+     * Called for every inbound `callback_query` (inline-button press). The
+     * connection has ALREADY acked the press via `answerCallbackQuery` before
+     * this fires, so the handler only has to route the normalized inbound
+     * (which carries `callbackQuery: { data, callbackId }`). Optional — when
+     * omitted, callback updates are still acked + de-duplicated but not routed.
+     */
+    onCallbackQuery?: (msg: TgInboundMessage) => void;
+    /**
+     * The `allowed_updates` list to request from `getUpdates`. Defaults to the
+     * minimal `["message", "callback_query"]` set (see `allowed-updates.ts`).
+     * Threaded so the adapter/plugin can widen it (e.g. inbound reactions).
+     */
+    allowedUpdates?: string[];
+    /**
+     * Commands to register on connect via `setMyCommands` (the bot's `/` menu).
+     * Empty / omitted → no menu sync. Re-applied on each successful (re)connect.
+     */
+    commandMenu?: Array<{
+        command: string;
+        description: string;
+    }>;
+    /**
+     * Transport mode. `"polling"` (default) drives `getUpdates` via the runner;
+     * `"webhook"` builds the bot + (optionally) registers a webhook via
+     * `setWebhook` but does NOT poll — the gateway HTTP route feeds updates in
+     * via {@link TelegramConnection.feedUpdate}. Defaults to polling (local-first).
+     */
+    mode?: "polling" | "webhook";
+    /**
+     * Webhook registration details (webhook mode only). When `url` is set the
+     * connection calls `setWebhook(url, { secret_token, allowed_updates })` on
+     * connect. Omit `url` to skip registration (the operator registered it out
+     * of band) and only wire the inbound `feedUpdate` path.
+     */
+    webhook?: {
+        url?: string;
+        secretToken?: string;
+    };
+    /** Subsystem logger. */
+    log: (msg: string, meta?: Record<string, unknown>) => void;
+    /**
+     * TEST SEAM: supply the bot + runner instead of building real grammY ones.
+     * Production leaves this undefined and grammY is lazy-imported. When present,
+     * `botFactory(token)` returns the bot and `runnerFactory(bot)` the runner.
+     */
+    botFactory?: (token: string) => TelegramBotLike;
+    runnerFactory?: (bot: TelegramBotLike) => RunnerLike;
+    /** TEST SEAM: skip the real backoff sleep so reconnect tests run instantly. */
+    sleepImpl?: (ms: number) => Promise<void>;
+}
+export interface TelegramConnection {
+    /** The bot's numeric id once connected, else null. */
+    selfId(): string | null;
+    /** The bot's @username (without `@`) once connected, else null. */
+    selfUsername(): string | null;
+    /** Epoch ms of the most recent successful connect, else null. */
+    connectedAt(): number | null;
+    /** True once `getMe` has succeeded and polling is live. */
+    isConnected(): boolean;
+    /** True once a 401 marked the token terminally invalid. */
+    isTokenInvalid(): boolean;
+    /** Send a single text message. `opts.html` true → `parse_mode: HTML`. */
+    sendText(chatId: string, text: string, opts?: TelegramSendTextOpts): Promise<{
+        messageId: number;
+    }>;
+    /**
+     * Send a text message carrying an inline keyboard (`reply_markup`). Used by
+     * the native approval prompt; `replyMarkup` is an opaque grammY-shaped
+     * `InlineKeyboardMarkup`. Text is sent verbatim (no markdown→HTML pass) so the
+     * caller controls formatting.
+     */
+    sendInteractive(chatId: string, text: string, replyMarkup: unknown, opts?: TelegramSendTextOpts): Promise<{
+        messageId: number;
+    }>;
+    /** Send a media attachment. */
+    sendMedia(chatId: string, media: OutboundMedia, opts?: TelegramSendMediaOpts): Promise<void>;
+    /** Send a native poll. Returns the poll message's id. */
+    sendPoll(chatId: string, poll: TelegramPollSpec, opts?: TelegramSendMediaOpts): Promise<{
+        messageId: number;
+    }>;
+    /** React to a previous message with an emoji (`""` clears). */
+    react(chatId: string, messageId: string, emoji: string): Promise<void>;
+    /** Edit a previously-sent message's text. `opts.html` true → `parse_mode: HTML`. */
+    editMessageText(chatId: string, messageId: string, text: string, opts?: TelegramSendTextOpts): Promise<void>;
+    /** Delete a message. */
+    deleteMessage(chatId: string, messageId: string): Promise<void>;
+    /** Pin a message (silent by default). */
+    pinMessage(chatId: string, messageId: string): Promise<void>;
+    /** Unpin a message (or the most recent pin when no id is given). */
+    unpinMessage(chatId: string, messageId?: string): Promise<void>;
+    /** Rename a forum topic (thread auto-labeling). Best-effort. */
+    editForumTopic(chatId: string, threadId: string, name: string): Promise<void>;
+    /** Ack an inline-button press (`answerCallbackQuery`). Best-effort. */
+    answerCallback(callbackId: string, text?: string): Promise<void>;
+    /**
+     * Feed a raw Telegram `Update` object into the inbound path (webhook mode).
+     * Dispatches to the SAME message / callback_query handlers polling uses, so
+     * webhook + polling share one normalize + dedupe surface. No-op in polling
+     * mode is fine — the gateway route only calls this when webhook is active.
+     */
+    feedUpdate(update: Update): void;
+    /** The transport mode this connection runs (`"polling"` | `"webhook"`). */
+    mode(): "polling" | "webhook";
+    /** The bot's identity (`getMe`) — cached after connect, re-fetched on demand. */
+    getIdentity(force?: boolean): Promise<TelegramBotIdentity | null>;
+    /** Register the bot's `/` command menu. Best-effort. */
+    setCommandMenu(commands: Array<{
+        command: string;
+        description: string;
+    }>): Promise<void>;
+    /** Signal typing (`composing`) / clear (`paused`). Best-effort. */
+    setComposing(chatId: string, state: "composing" | "paused", threadId?: string): Promise<void>;
+    /** Read-receipt no-op (Telegram bots can't mark-read). */
+    markRead(): Promise<void>;
+    /** Stop polling + tear down. */
+    close(): Promise<void>;
+}
+/** Outbound poll spec — normalized before reaching `sendPoll`. */
+export interface TelegramPollSpec {
+    /** The poll question. */
+    question: string;
+    /** 2–10 answer options. */
+    options: string[];
+    /** Anonymous poll (default true, matching Telegram). */
+    isAnonymous?: boolean;
+    /** Allow multiple answers (default false). */
+    allowsMultipleAnswers?: boolean;
+}
+export interface TelegramSendTextOpts {
+    /** When true the text is already Telegram HTML and sent with `parse_mode: HTML`. */
+    html?: boolean;
+    /** Forum-topic thread id. */
+    threadId?: string;
+}
+export interface TelegramSendMediaOpts {
+    /** Forum-topic thread id. */
+    threadId?: string;
+}
+/** 401 Unauthorized → the bot token is wrong / revoked (terminal). */
+export declare function isTelegramUnauthorized(err: unknown): boolean;
+/** 409 Conflict on getUpdates → another poller or a webhook is active. */
+export declare function isTelegramGetUpdatesConflict(err: unknown): boolean;
+/** Strip a bot token out of any string before it reaches a log. */
+export declare function redactTelegramToken(text: string, token: string): string;
+export declare function connectTelegram(args: ConnectTelegramArgs): Promise<TelegramConnection>;
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

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