@cogitator-ai/channels 0.7.5 → 0.8.0

package/README.md

@@ -72,7 +72,30 @@ telegramChannel({
 });
 ```
 
-Supports: text, photos (→ vision), voice and audio (→ STT), video, documents, replies, streaming via drafts/editText, emoji reactions, sending files from buffers or URLs, 4096 char limit. Docs: [Telegram](https://cogitator.app/docs/channels/telegram).
+Built on the current Bot API, through grammY's raw API so newer methods work on any grammY:
+
+- **Rich Markdown** (default on, `richMessages: false` to turn off): the agent's Markdown goes out as written, with headings, tables, code blocks, task lists, footnotes and formulas, up to 32,768 characters. A refused rich message falls back to classic Markdown, then plain text.
+- **Streaming** through rich drafts with a **stop button**: a press stops the run and keeps what was written as the reply. Groups stream by editing.
+- **Buttons** with colors, URLs, copy-text and disabled buttons (`SendOptions.buttons`); presses reach the `action:received` hook or `onAction`. Tool approval prompts get Approve and Deny buttons.
+- **Topics** (forum topics and private chat topics), `@username` chat ids, captions, GIFs and voice notes, **albums** (`sendFiles`), silent, protected, ephemeral and effect messages, link preview options.
+- **Command menus** by scope and language (`setCommands`, `setCommandMenu`), bot name and descriptions (`setProfile`), and `call(method, args)` for any other Bot API method.
+- Incoming text, photos (→ vision), voice and audio (→ STT), video, video notes, GIFs, documents, replies and topics.
+
+```typescript
+const telegram = telegramChannel({ token: process.env.TG_TOKEN! });
+
+await telegram.sendText(chatId, 'Publish the noon edition?', {
+  buttons: [
+    [
+      { text: 'Publish', data: 'publish', style: 'success' },
+      { text: 'Hold', data: 'hold', style: 'danger' },
+    ],
+  ],
+});
+await telegram.setCommands([{ command: 'status', description: 'What is going on' }], { chatId });
+```
+
+Docs: [Telegram](https://cogitator.app/docs/channels/telegram).
 
 ### Discord
 
@@ -228,6 +251,8 @@ Tools marked `requiresApproval` (for example `create_tool` from `capabilities.se
 2. The user replies `approve` / `yes` to run the calls, or `deny` / `no` to refuse, optionally followed by a reason (`no, too risky`) that the agent sees. Replies are case-insensitive and may end with punctuation; `да` / `одобряю` and `нет` / `отклоняю` work out of the box.
 3. The Gateway calls `cogitator.resume(agent, threadId, { userId, defaultDecision })` and delivers the result like any reply, streaming included. If the run pauses again, a new prompt is sent.
 
+On channels with buttons (Telegram), the prompt also carries **Approve** and **Deny** buttons. A press answers exactly like the reply words, through the same middleware and checks, and the buttons then show the decision. `approvals.buttons: false` turns them off and `approvals.buttonLabels` renames them. A press counts only from the user the prompt asked, while their run is still paused; any other press gets an alert (`notAllowedMessage`, or `expiredMessage` once the request was answered, dropped or predates a restart, when a reply word still works).
+
 Any other message on a paused thread runs as usual, and the runtime answers the waiting calls as declined. An approve-only word with more text after it (`yes, but rename it`) counts as a new message, so nothing runs by accident.
 
 Only the user who started the run can answer it: the runtime checks the run's `userId` on resume. In a shared thread (a `threadKey` per group chat), someone else replying `approve` gets `notAllowedMessage` and the pause stays put.
@@ -402,20 +427,21 @@ const gateway = new Gateway({ /* ... */ hooks });
 
 Handlers are typed by hook name through `HookPayloads` (exported here and from `@cogitator-ai/types`, which also exports each event type):
 
-| Hook                 | Payload                  | Fields                                                              |
-| -------------------- | ------------------------ | ------------------------------------------------------------------- |
-| `message:received`   | `MessageReceivedEvent`   | `msg`, `threadId`, `user`                                           |
-| `message:sending`    | `MessageSendingEvent`    | `msg`, `threadId`, `text`, `channelId`                              |
-| `message:sent`       | `MessageSentEvent`       | `msg`, `threadId`, `text`, `messageId` (first chunk)                |
-| `agent:before_run`   | `AgentBeforeRunEvent`    | `msg`, `threadId`, `agent` (agent name)                             |
-| `agent:after_run`    | `AgentAfterRunEvent`     | `msg`, `threadId`, `output`                                         |
-| `agent:error`        | `AgentErrorEvent`        | `msg`, `threadId`, `error` (always an `Error`)                      |
-| `session:created`    | `SessionCreatedEvent`    | `session`, `threadId`                                               |
-| `session:compacted`  | `SessionCompactedEvent`  | `threadId`, `result` (`CompactionResult`)                           |
-| `stream:started`     | `StreamStartedEvent`     | `msg`, `threadId`                                                   |
-| `stream:finished`    | `StreamFinishedEvent`    | `msg`, `threadId`, `messageIds`                                     |
-| `approval:requested` | `ApprovalRequestedEvent` | `msg`, `threadId`, `userId`, `approvals`                            |
-| `approval:resolved`  | `ApprovalResolvedEvent`  | `msg`, `threadId`, `userId`, `decision`, `approvals?`, `superseded` |
+| Hook                 | Payload                  | Fields                                                                          |
+| -------------------- | ------------------------ | ------------------------------------------------------------------------------- |
+| `message:received`   | `MessageReceivedEvent`   | `msg`, `threadId`, `user`                                                       |
+| `message:sending`    | `MessageSendingEvent`    | `msg`, `threadId`, `text`, `channelId`                                          |
+| `message:sent`       | `MessageSentEvent`       | `msg`, `threadId`, `text`, `messageId` (first chunk)                            |
+| `agent:before_run`   | `AgentBeforeRunEvent`    | `msg`, `threadId`, `agent` (agent name)                                         |
+| `agent:after_run`    | `AgentAfterRunEvent`     | `msg`, `threadId`, `output`                                                     |
+| `agent:error`        | `AgentErrorEvent`        | `msg`, `threadId`, `error` (always an `Error`)                                  |
+| `session:created`    | `SessionCreatedEvent`    | `session`, `threadId`                                                           |
+| `session:compacted`  | `SessionCompactedEvent`  | `threadId`, `result` (`CompactionResult`)                                       |
+| `stream:started`     | `StreamStartedEvent`     | `msg`, `threadId`                                                               |
+| `stream:finished`    | `StreamFinishedEvent`    | `msg`, `threadId`, `messageIds`                                                 |
+| `approval:requested` | `ApprovalRequestedEvent` | `msg`, `threadId`, `userId`, `approvals`                                        |
+| `approval:resolved`  | `ApprovalResolvedEvent`  | `msg`, `threadId`, `userId`, `decision`, `approvals?`, `superseded`             |
+| `action:received`    | `ActionReceivedEvent`    | `action`, `answer(options?)`: a button press the Gateway does not handle itself |
 
 A handler typed `HookHandler` (`unknown` payload) is still accepted for any hook. Errors in one handler don't affect others (they are logged). Unsubscribe with `hooks.off(name, handler)`. Docs: [Lifecycle Hooks](https://cogitator.app/docs/channels/gateway#lifecycle-hooks).
 

package/dist/approvals.d.ts

@@ -16,7 +16,25 @@ export interface GatewayApprovalsConfig {
     denyWords?: readonly string[];
     /** Sent when someone other than the user who started the run answers it */
     notAllowedMessage?: string;
+    /**
+     * Put Approve and Deny buttons under the prompt on channels that have buttons (default
+     * true). A press answers like the reply words do, and the buttons then show the decision.
+     */
+    buttons?: boolean;
+    /** Labels of the buttons and of the decision they show once pressed */
+    buttonLabels?: {
+        approve?: string;
+        deny?: string;
+        approved?: string;
+        denied?: string;
+    };
+    /** Shown on a press of buttons whose request was answered, dropped or is from before a restart */
+    expiredMessage?: string;
 }
+export declare const DEFAULT_EXPIRED_MESSAGE = "This request is no longer waiting. Reply \"approve\" or \"deny\" if it is still paused.";
+/** The `data` of the approval buttons the gateway puts under its prompt. */
+export declare const APPROVE_ACTION = "cogitator:approve";
+export declare const DENY_ACTION = "cogitator:deny";
 export declare const DEFAULT_APPROVE_WORDS: readonly string[];
 export declare const DEFAULT_DENY_WORDS: readonly string[];
 export declare const DEFAULT_NOT_ALLOWED_MESSAGE = "Only the person who made this request can approve or deny it.";

package/dist/approvals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EAAE,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC;IAC1F,oFAAoF;IACpF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sFAAsF;IACtF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAC5F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAsC,CAAC;AACvF,eAAO,MAAM,2BAA2B,kEACyB,CAAC;AAuBlE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,GACxB,oBAAoB,GAAG,IAAI,CAU7B;AAoBD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAqBR"}
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EAAE,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC;IAC1F,oFAAoF;IACpF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sFAAsF;IACtF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,4FACmD,CAAC;AAExF,4EAA4E;AAC5E,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAC5F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAsC,CAAC;AACvF,eAAO,MAAM,2BAA2B,kEACyB,CAAC;AAuBlE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,GACxB,oBAAoB,GAAG,IAAI,CAU7B;AAoBD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAqBR"}

package/dist/approvals.js

@@ -1,3 +1,7 @@
+export const DEFAULT_EXPIRED_MESSAGE = 'This request is no longer waiting. Reply "approve" or "deny" if it is still paused.';
+/** The `data` of the approval buttons the gateway puts under its prompt. */
+export const APPROVE_ACTION = 'cogitator:approve';
+export const DENY_ACTION = 'cogitator:deny';
 export const DEFAULT_APPROVE_WORDS = ['approve', 'yes', 'да', 'одобряю'];
 export const DEFAULT_DENY_WORDS = ['deny', 'no', 'нет', 'отклоняю'];
 export const DEFAULT_NOT_ALLOWED_MESSAGE = 'Only the person who made this request can approve or deny it.';

package/dist/approvals.js.map

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

package/dist/channels/telegram.d.ts

@@ -1,4 +1,4 @@
-import type { Channel, ChannelMessage, ChannelType, Attachment, SendOptions } from '@cogitator-ai/types';
+import type { Attachment, Channel, ChannelAction, ChannelButton, ChannelCommand, ChannelMessage, ChannelStop, ChannelType, DraftOptions, SendOptions } from '@cogitator-ai/types';
 export interface TelegramConfig {
     token: string;
     allowedUpdates?: string[];
@@ -13,16 +13,82 @@ export interface TelegramConfig {
         path?: string;
         secretToken?: string;
     };
+    /**
+     * Send Markdown as Telegram rich messages (Bot API 10.1+), which render standard Markdown
+     * with headings, tables, code blocks, task lists, footnotes and formulas, up to 32768
+     * characters. Default true. When a rich message is refused, the text goes out in Telegram's
+     * classic Markdown instead.
+     */
+    richMessages?: boolean;
+}
+/** Who a command menu is for, as Telegram scopes it. */
+export type TelegramCommandScope = {
+    type: 'default';
+} | {
+    type: 'all_private_chats';
+} | {
+    type: 'all_group_chats';
+} | {
+    type: 'all_chat_administrators';
+} | {
+    type: 'chat';
+    chatId: string;
+} | {
+    type: 'chat_administrators';
+    chatId: string;
+} | {
+    type: 'chat_member';
+    chatId: string;
+    userId: string;
+};
+/** The bot's name and the texts users see before they start it. */
+export interface TelegramProfile {
+    /** 0-64 characters */
+    name?: string;
+    /** Shown in an empty chat with the bot, 0-512 characters */
+    description?: string;
+    /** Shown on the bot's profile and in shared links, 0-120 characters */
+    shortDescription?: string;
+    languageCode?: string;
 }
+/** A chat id as Telegram takes it: a number, or a public `@username`. */
+export declare function telegramChatId(id: string): number | string;
+/** The inline keyboard for rows of buttons. */
+export declare function telegramKeyboard(rows: ChannelButton[][]): {
+    inline_keyboard: Record<string, unknown>[][];
+};
+/**
+ * Telegram through grammY, on the current Bot API: rich messages that render standard Markdown,
+ * streamed drafts with a stop button, inline buttons with colors and their presses, topics,
+ * captions and albums, message effects, link previews, ephemeral messages and command menus.
+ * Every call goes through grammY's raw API, so a Bot API feature newer than the installed grammY
+ * still works, and `call` reaches any method this class does not wrap.
+ */
 export declare class TelegramChannel implements Channel {
     private readonly config;
     readonly type: ChannelType;
     private handler;
+    private actionHandler;
+    private stopHandler;
     private bot;
     private grammy;
     private server;
+    /** Set when the Bot API server does not know rich messages, so they are not tried again. */
+    private richUnavailable;
     constructor(config: TelegramConfig);
+    /**
+     * With rich messages on, Markdown arrives as written (GitHub Flavored) and is adapted to
+     * Telegram's classic Markdown here when a rich message cannot be sent.
+     */
+    get nativeMarkdown(): boolean;
+    get maxMessageChars(): number;
+    /** Text for a classic message: Markdown written for rich messages is adapted first. */
+    private classic;
     onMessage(handler: (msg: ChannelMessage) => Promise<void>): void;
+    onAction(handler: (action: ChannelAction) => Promise<void>): void;
+    onStop(handler: (stop: ChannelStop) => void): void;
+    /** Calls any Bot API method by name, for features this class does not wrap. */
+    call<T = unknown>(method: string, args?: Record<string, unknown>): Promise<T>;
     private requireBot;
     private downloadFile;
     private buildBaseMessage;
@@ -31,13 +97,65 @@ export declare class TelegramChannel implements Channel {
     private startWebhook;
     private closeServer;
     stop(): Promise<void>;
+    /** The parameters every send shares: topic, reply, notification, protection, effect, buttons. */
+    private envelope;
+    private get useRich();
+    /** Notes a refusal of a rich call, so an unknown method is not tried again. */
+    private richRefused;
     sendText(channelId: string, text: string, options?: SendOptions): Promise<string>;
-    editText(channelId: string, messageId: string, text: string): Promise<void>;
-    sendFile(channelId: string, file: Attachment): Promise<void>;
-    sendTyping(channelId: string): Promise<void>;
-    sendDraft(channelId: string, draftId: number, text: string, options?: SendOptions): Promise<void>;
+    /**
+     * A text message in Telegram's classic formatting, in as many messages as the limit needs:
+     * the reply goes on the first, the buttons on the last, and a parse failure is sent as plain
+     * text.
+     */
+    private sendClassic;
+    editText(channelId: string, messageId: string, text: string, options?: SendOptions): Promise<void>;
+    private source;
+    /** The Bot API method and field a file is sent with. */
+    private static mediaKind;
+    /** A caption in classic formatting, or none when it is too long to be one. */
+    private caption;
+    /** Sends one file and returns the id of its message. */
+    sendFile(channelId: string, file: Attachment, options?: SendOptions): Promise<string>;
+    /**
+     * Sends files as albums of up to ten. Photos and videos share an album, while audio and
+     * documents each go in albums of their own kind, as Telegram requires; GIFs, which albums do
+     * not take, go on their own as animations. Each file keeps its own caption, and a caption too
+     * long for an album follows it as a message. Albums carry no buttons. Returns the ids of every
+     * message sent.
+     */
+    sendFiles(channelId: string, files: Attachment[], options?: SendOptions): Promise<string[]>;
+    sendTyping(channelId: string, options?: Pick<SendOptions, 'topicId'>): Promise<void>;
+    /**
+     * Streams a partial answer as a draft, a preview Telegram shows for 30 seconds; the final
+     * answer is sent as a message. Drafts exist in private chats only, so a group throws and the
+     * caller falls back to sending and editing messages. With `canStop`, the user gets a stop
+     * button and the draft stays on screen after a press until the final message replaces it.
+     */
+    sendDraft(channelId: string, draftId: number, text: string, options?: DraftOptions): Promise<void>;
     deleteMessage(channelId: string, messageId: string): Promise<void>;
     setReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    answerAction(actionId: string, options?: {
+        text?: string;
+        alert?: boolean;
+    }): Promise<void>;
+    editButtons(channelId: string, messageId: string, buttons: ChannelButton[][] | null): Promise<void>;
+    setCommands(commands: ChannelCommand[], scope?: {
+        chatId?: string;
+    }): Promise<void>;
+    /** Sets the command menu for a scope and, optionally, a language. */
+    setCommandMenu(commands: ChannelCommand[], options?: {
+        scope?: TelegramCommandScope;
+        languageCode?: string;
+    }): Promise<void>;
+    /** Removes the command menu of a scope. */
+    deleteCommandMenu(options?: {
+        scope?: TelegramCommandScope;
+        languageCode?: string;
+    }): Promise<void>;
+    private scopeArgs;
+    /** Sets the bot's name, description and short description; fields left out are not changed. */
+    setProfile(profile: TelegramProfile): Promise<void>;
 }
-export declare function telegramChannel(config: TelegramConfig): Channel;
+export declare function telegramChannel(config: TelegramConfig): TelegramChannel;
 //# sourceMappingURL=telegram.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9E;AA0HD,qBAAa,eAAgB,YAAW,OAAO;IAOjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAc;IACxC,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAuB;gBAER,MAAM,EAAE,cAAc;IAEnD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIhE,OAAO,CAAC,UAAU;YAKJ,YAAY;IAU1B,OAAO,CAAC,gBAAgB;YAeV,YAAY;IAmBpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoGd,YAAY;YA0CZ,WAAW;IAOnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;IAQV,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMtF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE/D"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"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"}