@chat-adapter/telegram

Patch Changes

• 7d496a7: Count a reply to the bot as a mention (with mentionOnReply) in regular supergroups. The forum-topic exclusion for replies to the topic's creation message now applies only to topic messages (is_topic_message), so ordinary replies, which carry message_thread_id equal to the replied-to message's id, are no longer dropped.

Patch Changes

• f893470: Stop cutting Telegram MarkdownV2 messages and captions at a backtick inside a link destination. Messages that fit the length limit now ship exactly as rendered, and a length cut that lands inside a link, code span, or underline now removes the incomplete entity before the ellipsis.

• 91683e5: Wait for Telegram polling handlers to settle before advancing update offsets.

Minor Changes

• 043386b: Add Telegram Business mode support. Opt in via businessMode: true.

  The adapter handles business_connection, business_message, and edited_business_message updates, encodes business threads as telegram:biz:{connectionId}:{chatId}, and passes business_connection_id on outbound sends, edits, typing, file uploads, and inline-keyboard callbacks. Business threads are their own channel, slash commands route through onSlashCommand, deletes use deleteBusinessMessages, and connection state is cached in the state adapter so a revoked connection is honoured by every instance. Reactions on business threads throw a NotImplementedError, since the Bot API has no business variant of setMessageReaction.

Patch Changes

• 43dba3d: Skip unused plain-text conversion for rich and Markdown native draft updates. Plain-text fallback and final delivery keep their existing behavior.

Minor Changes

• c4a359e: require webhook verification by default with an explicit unverified opt-in

• 26a06ca: Add mentionOnReply: when enabled, a reply to one of the bot's own messages reports isMention, so a bot in a group keeps the conversation going without the handle being repeated. Off by default, so existing mention-only bots are unaffected, and readable from TELEGRAM_MENTION_ON_REPLY. Implicit forum-topic replies and the bot's own echoed messages never count, and polling mode now retries the startup getMe lazily so a transient outage cannot leave mention detection disabled.

• d5ebec1: Implement reply in the Telegram adapter so Thread.reply() threads the answer to its target instead of throwing NotImplementedError. The reference travels as Bot API reply_parameters and covers text, rich messages, documents, attachments and media groups; allow_sending_without_reply keeps delivery working when the target has been deleted. Malformed reply target ids are rejected before anything is sent, and a rich-message gateway that rejects reply_parameters falls back to a regular threaded send.

• a18e792: Describe the message kinds Telegram sends with no text and no file. A shared location, venue, contact, poll, dice, game, invoice or story used to arrive as an empty message: the payload carried the content, but a handler reading text saw nothing. Each now gets a short literal description (📍 55.75, 37.61, 👤 Ada Lovelace +1555…, 📊 Lunch or dinner?), and the structured payload stays on the raw message for anyone who needs the numbers.

• a0ba986: Parse stickers and animations. A sticker used to arrive as an empty message, since it carries no text, and an animation (Telegram GIF) was dropped entirely. A sticker now reports the emoji it stands for as its text (falling back to the sticker set name, then to "sticker") plus an attachment matching its real format: an image for a still WebP sticker, a video for a WebM one, a file for a Lottie (TGS) one. An animation arrives as a single video attachment; the redundant document field Telegram sets alongside it for backward compatibility is no longer reported as a second attachment.

Patch Changes

• eddcd7e: Return Telegram file downloads as portable ArrayBuffer data while preserving Buffer support in the shared attachment contract.

• b6fa24c: guard attachment downloads across the remaining adapters

  Slack, Discord, and WhatsApp attachment downloads now go through the shared guarded downloader: private and internal addresses are refused (as URL literals, through DNS resolution, and after redirects), responses are capped at 25 MB, and downloads time out after 30 seconds. Slack sends the bot token only on hops to trusted Slack origins, and WhatsApp keeps its access token on Meta's media hosts and the configured Graph origin. Telegram enforces the same size cap and timeout with the Web Fetch API so downloads keep working in runtimes like Cloudflare Workers.

  downloadAttachment in @chat-adapter/shared now resolves headers per hop (pass a function to control what each redirect target receives), forwards the resolved headers to custom transports, and accepts an onResponse hook to reject unexpected final responses before the body is read.

Minor Changes

• 0f24cc3: Preserve normalized replied-to message context and populate it from Telegram replies.

• 7a1150c: Add outbound-only Vercel Connect authentication for Telegram while retaining native webhook verification or polling.

• 3bbf3ff: Use post-and-edit streaming by default and make native Telegram drafts opt-in. Streams now render the same way in every chat type; set the new nativeStreaming: true config option to restore draft previews in private chats.

  The adapter now owns the post-and-edit loop so edits stay under Telegram's per-chat rate limit. Edits are throttled to a 1100ms floor, configurable with the new streamingEditIntervalMs option, and a rate-limited final edit is retried once instead of failing the post.

Patch Changes

• 1d2b78d: Deduplicate repeated Telegram webhook updates by their update ID using the configured state adapter.

• 745fdf5: respect Telegram streaming rate limits and target XChat read receipts exactly

Patch Changes

• 629e655: Combine incoming Telegram media groups into one message with ordered attachments and the shared caption.

Patch Changes

• 53bf73d: Preserve Telegram stable media identifiers in normalized attachment metadata and report photo attachments as JPEG.

Minor Changes

• 54eea71: Add an optional Telegram user allowlist via allowedUserIds or the comma-separated TELEGRAM_ALLOWED_USER_IDS environment variable.

Patch Changes

• 0701679: Cache the compiled bot-mention regex in isBotMentioned instead of recompiling it per message, and make the protected sleep helper accept an optional AbortSignal so stopPolling() interrupts the polling backoff delay immediately.