dsh-connect 0.7.2 → 0.8.0

package/lib/channels/telegram/adapter.js

@@ -0,0 +1,454 @@
+import { TelegramClient, telegramFileMethod } from "./client.js";
+import { telegramMessages } from "./i18n.js";
+const CHOICE_TIMEOUT_MS = 60_000;
+/** Key a pending choice by chat + option so concurrent menus never collide. */
+function choiceKey(chatId, optionId) {
+    return `${chatId}\u0000${optionId}`;
+}
+/** Encode chatId + messageId into the opaque message id the core passes around. */
+export function encodeMessageRef(chatId, messageId) {
+    return `${chatId}:${messageId}`;
+}
+/** Split an opaque message ref back into chatId + messageId. */
+export function decodeMessageRef(ref) {
+    const idx = ref.lastIndexOf(":");
+    const chatId = idx >= 0 ? ref.slice(0, idx) : ref;
+    const messageId = idx >= 0 ? Number(ref.slice(idx + 1)) : Number(ref);
+    return { chatId, messageId: Number.isFinite(messageId) ? messageId : NaN };
+}
+/** Escape text for Telegram HTML parse mode (only `& < >` need escaping). */
+export function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** Convert plain markdown (bold/italic/inline code/code blocks/headings/links) to Telegram HTML. */
+export function markdownToTelegramHtml(markdown) {
+    // Token-based conversion: plain text is escaped as-is (Telegram HTML mode
+    // rejects unescaped `& < >` anywhere), then markdown spans are converted and
+    // their inner content escaped too. Everything the LLM writes — "R&D",
+    // "x < y", fenced ```code``` blocks — survives without breaking parse mode.
+    let html = "";
+    let i = 0;
+    const n = markdown.length;
+    const MARKERS = ["*", "`", "[", "#"];
+    while (i < n) {
+        // Skip ahead to the next potential marker, escaping plain text in bulk.
+        let next = n;
+        for (const m of MARKERS) {
+            const idx = markdown.indexOf(m, i);
+            if (idx !== -1 && idx < next)
+                next = idx;
+        }
+        if (next > i) {
+            html += escapeHtml(markdown.slice(i, next));
+            i = next;
+        }
+        if (i >= n)
+            break;
+        const rest = markdown.slice(i);
+        // Fenced code block (```lang\n...\n```) — inner text fully escaped.
+        const fence = rest.match(/^```[^\n]*\n([\s\S]*?)(?:```|$)/);
+        if (fence !== null) {
+            html += `<pre>${escapeHtml(fence[1])}</pre>`;
+            i += fence[0].length;
+            continue;
+        }
+        // Inline code.
+        const inline = rest.match(/^`([^`\n]+)`/);
+        if (inline !== null) {
+            html += `<code>${escapeHtml(inline[1])}</code>`;
+            i += inline[0].length;
+            continue;
+        }
+        // Bold.
+        const bold = rest.match(/^\*\*([^*\n]+)\*\*/);
+        if (bold !== null) {
+            html += `<b>${escapeHtml(bold[1])}</b>`;
+            i += bold[0].length;
+            continue;
+        }
+        // Italic (single asterisk, not part of a bold pair).
+        const italic = rest.match(/^\*([^*\n]+)\*/);
+        if (italic !== null) {
+            html += `<i>${escapeHtml(italic[1])}</i>`;
+            i += italic[0].length;
+            continue;
+        }
+        // Link [label](url) — the href is escaped to survive HTML attribute parsing.
+        const link = rest.match(/^\[([^\]]+)\]\(([^)\s]+)\)/);
+        if (link !== null) {
+            html += `<a href="${escapeHtml(link[2])}">${escapeHtml(link[1])}</a>`;
+            i += link[0].length;
+            continue;
+        }
+        // Heading — only at the start of a line.
+        const atLineStart = i === 0 || markdown[i - 1] === "\n";
+        const heading = rest.match(/^#{1,6}\s+([^\n]+)/);
+        if (atLineStart && heading !== null) {
+            html += `<b>${escapeHtml(heading[1])}</b>`;
+            i += heading[0].length;
+            continue;
+        }
+        // Not a real marker after all — emit the character escaped.
+        html += escapeHtml(markdown[i]);
+        i += 1;
+    }
+    return html;
+}
+/** Render @-mentions into HTML (tg://user?id= links). */
+function mentionHtml(users) {
+    return users
+        .map((id) => `<a href="tg://user?id=${id}">@</a>`)
+        .join(" ");
+}
+/** Build the inline-keyboard reply_markup for a choice prompt. */
+export function buildInlineKeyboard(options, columnsPerRow) {
+    const rows = [];
+    for (let i = 0; i < options.length; i += columnsPerRow) {
+        const group = options.slice(i, i + columnsPerRow);
+        rows.push(group.map((o) => ({ text: o.label, callback_data: `choice:${o.id}` })));
+    }
+    return { inline_keyboard: rows };
+}
+/** Pick a callback data prefix that won't collide with menu ids. */
+const CHOICE_PREFIX = "choice:";
+export class TelegramAdapter {
+    logger;
+    id = "telegram";
+    client;
+    t;
+    requireMention;
+    pendingChoices = new Map();
+    handler;
+    pollPromise;
+    stopped = false;
+    /** The bot's own user id (from getMe) — used for precise mention/reply checks. */
+    botId;
+    /** The bot's username (from getMe) — used to verify @-mentions. */
+    botUsername;
+    constructor(config, logger) {
+        this.logger = logger;
+        const botToken = config.botToken ?? process.env.TELEGRAM_BOT_TOKEN;
+        if (!botToken) {
+            throw new Error(telegramMessages(config.language ?? "zh").tokenMissing);
+        }
+        this.t = telegramMessages(config.language ?? "zh");
+        this.requireMention = config.requireMention ?? true;
+        this.client = new TelegramClient({
+            botToken,
+            ...(config.pollingTimeoutSeconds === undefined ? {} : { pollingTimeoutSeconds: config.pollingTimeoutSeconds }),
+            ...(config.baseUrl === undefined ? {} : { baseUrl: config.baseUrl }),
+        });
+    }
+    onInbound(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        this.stopped = false;
+        // Resolve the bot's own identity for precise mention/reply checks. On
+        // failure, fall back to a permissive heuristic (logged so it's observable).
+        try {
+            const me = await this.client.getMe();
+            this.botId = me.id;
+            this.botUsername = me.username;
+        }
+        catch (error) {
+            this.logger?.warn?.(`connect-telegram: getMe failed: ${String(error)} — mention checks use a permissive fallback`);
+        }
+        // Skip the backlog: don't replay old messages on (re)connect. A failure
+        // here leaves offset=0 and would replay history — log it instead of hiding.
+        try {
+            await this.client.resetOffset();
+        }
+        catch (error) {
+            this.logger?.warn?.(`connect-telegram: resetOffset failed (old messages may be replayed): ${String(error)}`);
+        }
+        const loop = async () => {
+            while (!this.stopped) {
+                try {
+                    const updates = await this.client.pollUpdates();
+                    for (const update of updates) {
+                        // Confirm the offset per update AFTER it is handled, so a failure
+                        // mid-batch never drops the remaining updates.
+                        try {
+                            await this.handleUpdate(update);
+                        }
+                        catch (error) {
+                            this.logger?.warn?.(`connect-telegram: update ${update.update_id} failed: ${error instanceof Error ? error.message : String(error)}`);
+                        }
+                        this.client.confirmOffset(update.update_id);
+                    }
+                }
+                catch (error) {
+                    this.logger?.warn?.(this.t.pollFailed(error instanceof Error ? error.message : String(error)));
+                    await sleep(this.client.config.retryDelayMs ?? 3_000);
+                }
+            }
+        };
+        this.pollPromise = loop();
+    }
+    async stop() {
+        this.stopped = true;
+        // The in-flight getUpdates will settle (server closes or times out); wait briefly.
+        const p = this.pollPromise;
+        if (p !== undefined)
+            await Promise.race([p, sleep(1000)]).catch(() => undefined);
+    }
+    async handleUpdate(update) {
+        if (update.callback_query !== undefined) {
+            await this.handleCallbackQuery(update.callback_query);
+            return;
+        }
+        // Only fresh messages are processed. `edited_message` (including the bot's
+        // own streamed edits) is ignored — otherwise every in-place stream edit
+        // would re-trigger an agent turn.
+        const message = update.message;
+        if (message === undefined)
+            return;
+        const normalized = await this.normalizeMessage(message);
+        if (normalized !== undefined)
+            await this.handler?.(normalized);
+    }
+    async handleCallbackQuery(query) {
+        const data = query.data ?? "";
+        if (!data.startsWith(CHOICE_PREFIX)) {
+            await this.client.answerCallbackQuery(query.id).catch(() => undefined);
+            return;
+        }
+        const choiceId = data.slice(CHOICE_PREFIX.length);
+        const queryChatId = query.message?.chat !== undefined ? String(query.message.chat.id) : undefined;
+        // Pending entries are keyed by (chat, option) so concurrent menus in
+        // different chats never overwrite each other.
+        const pending = queryChatId === undefined ? undefined : this.pendingChoices.get(choiceKey(queryChatId, choiceId));
+        if (pending !== undefined) {
+            // `resolve` is the prompt's settle(): clears its keys and the timer.
+            pending.resolve(choiceId);
+            await this.client.answerCallbackQuery(query.id, this.t.choiceDone).catch(() => undefined);
+        }
+        else {
+            await this.client.answerCallbackQuery(query.id, this.t.choiceExpired).catch(() => undefined);
+        }
+    }
+    /** Normalize a Telegram message into dsh-connect's InboundMessage; returns undefined when ignored. */
+    async normalizeMessage(message) {
+        // Never echo-loop: Telegram delivers the bot's own messages back through
+        // getUpdates, and treating them as inbound would re-trigger the agent on
+        // every ack / reply / summary card.
+        if (message.from?.is_bot === true)
+            return undefined;
+        const chat = message.chat;
+        const chatId = String(chat.id);
+        const chatType = chat.type === "private" ? "p2p" : "group";
+        const senderKey = message.from === undefined ? chatId : String(message.from.id);
+        const text = message.text ?? message.caption ?? "";
+        // Group mention policy: require an @-mention of this bot (or a reply to it).
+        if (chatType === "group" && this.requireMention && !isBotMentioned(message, text, this.botUsername, this.botId)) {
+            return undefined;
+        }
+        // Download attached images / files / audio / video.
+        const images = [];
+        const files = [];
+        let imageError;
+        let fileError;
+        if (message.photo !== undefined && message.photo.length > 0) {
+            const largest = message.photo[message.photo.length - 1];
+            const res = await this.client.downloadFileToTemp(largest.file_id, `photo_${largest.file_unique_id}.jpg`);
+            if (res.error !== undefined)
+                imageError = res.error;
+            else if (res.path !== "")
+                images.push(res.path);
+        }
+        const media = message.document ?? message.voice ?? message.video ?? message.audio;
+        if (media !== undefined) {
+            const name = message.document?.file_name ?? `${media.file_id}.${media === message.voice ? "ogg" : media === message.video ? "mp4" : "mp3"}`;
+            const res = await this.client.downloadFileToTemp(media.file_id, name);
+            if (res.error !== undefined)
+                fileError = res.error;
+            else if (res.path !== "")
+                files.push(res.path);
+        }
+        // A message with no text and no media has nothing for the agent — ignore
+        // (e.g. stickers, service messages) instead of running an empty turn.
+        if (text.trim() === "" && images.length === 0 && files.length === 0)
+            return undefined;
+        return {
+            channel: "telegram",
+            chatKey: chatId,
+            chatType,
+            senderKey,
+            text,
+            ...(message.reply_to_message === undefined ? {} : { replyRef: String(message.reply_to_message.message_id) }),
+            ...(images.length > 0 ? { images } : {}),
+            ...(files.length > 0 ? { files } : {}),
+            ...(imageError === undefined ? {} : { imageError }),
+            ...(fileError === undefined ? {} : { fileError }),
+        };
+    }
+    async sendText(target, text) {
+        const html = markdownToTelegramHtml(text);
+        await this.client.sendMessage(target.chatKey, html, {
+            parse_mode: "HTML",
+            ...(target.replyRef === undefined ? {} : { reply_to_message_id: Number(target.replyRef) }),
+            disable_web_page_preview: true,
+        });
+    }
+    async sendCard(target, card) {
+        const html = markdownToTelegramHtml(card.markdown);
+        const atPrefix = target.atUsers !== undefined && target.atUsers.length > 0 ? `${mentionHtml(target.atUsers)}\n` : "";
+        await this.client.sendMessage(target.chatKey, `${atPrefix}${html}`, {
+            parse_mode: "HTML",
+            ...(target.replyRef === undefined ? {} : { reply_to_message_id: Number(target.replyRef) }),
+            disable_web_page_preview: true,
+        });
+    }
+    async sendFile(target, filePath, options) {
+        const filename = options?.filename ?? filePath.split(/[\\/]/).pop() ?? "file";
+        const replyTo = target.replyRef === undefined ? undefined : Number(target.replyRef);
+        if (telegramFileMethod(filename) === "sendPhoto") {
+            await this.client.sendPhoto(target.chatKey, filePath, undefined, { reply_to_message_id: replyTo });
+        }
+        else {
+            await this.client.sendDocument(target.chatKey, filePath, { reply_to_message_id: replyTo });
+        }
+    }
+    async streamText(target, chunks) {
+        // editMessageText REPLACES the whole message text, so the stream must
+        // accumulate the full answer and send the complete text on every flush —
+        // sending only the incremental delta would wipe the earlier content.
+        let messageId;
+        let fullText = "";
+        let lastFlushAt = 0;
+        const chatId = target.chatKey;
+        const sendOpts = {
+            parse_mode: "HTML",
+            ...(target.replyRef === undefined ? {} : { reply_to_message_id: Number(target.replyRef) }),
+            disable_web_page_preview: true,
+        };
+        const flush = async () => {
+            if (fullText === "")
+                return;
+            // Telegram caps a message at 4096 characters; truncate (with a marker)
+            // so a long answer still delivers instead of failing to send.
+            const MAX_TEXT = 4000;
+            const body = fullText.length > MAX_TEXT ? `${fullText.slice(0, MAX_TEXT)}\n\n…` : fullText;
+            const html = markdownToTelegramHtml(body);
+            try {
+                if (messageId === undefined) {
+                    const sent = await this.client.sendMessage(chatId, html, sendOpts);
+                    messageId = sent.message_id;
+                }
+                else {
+                    await this.client.editMessageText(Number(chatId), messageId, html, { parse_mode: "HTML" });
+                }
+                lastFlushAt = Date.now();
+            }
+            catch (error) {
+                // Keep `fullText` intact: a transient failure (429, network) is retried
+                // by the next flush carrying the full text — content is never dropped.
+                this.logger?.warn?.(`connect-telegram: stream flush failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        };
+        for await (const chunk of chunks) {
+            fullText += chunk;
+            const now = Date.now();
+            // Throttle: flush at most every ~700ms, but force a flush past 4KB.
+            if (fullText.length >= 4096) {
+                await flush();
+            }
+            else if (fullText.length >= 200 && now - lastFlushAt >= 700) {
+                await flush();
+            }
+        }
+        await flush();
+    }
+    async promptChoice(target, prompt, updateMessageId) {
+        const keyboard = buildInlineKeyboard(prompt.options, prompt.columnsPerRow ?? 2);
+        const title = `<b>${escapeHtml(prompt.title)}</b>`;
+        const desc = prompt.description === undefined ? "" : `\n${escapeHtml(prompt.description)}`;
+        const text = `${title}${desc}`;
+        const chatId = target.chatKey;
+        let messageId;
+        if (updateMessageId !== undefined) {
+            const ref = decodeMessageRef(updateMessageId);
+            messageId = ref.messageId;
+            await this.client.editMessageText(ref.chatId, messageId, text, {
+                parse_mode: "HTML",
+                reply_markup: keyboard,
+            });
+        }
+        else {
+            const sent = await this.client.sendMessage(chatId, text, {
+                parse_mode: "HTML",
+                reply_markup: keyboard,
+            });
+            messageId = sent.message_id;
+        }
+        // One pending record per (chat, option) key — concurrent menus in different
+        // chats never collide. Timeout resolves `undefined` (dismiss) and replaces
+        // the stale keyboard with an expired notice (parity with Feishu).
+        return new Promise((resolve) => {
+            const registered = prompt.options.map((o) => choiceKey(chatId, o.id));
+            const settle = (choice) => {
+                clearTimeout(timer);
+                for (const key of registered)
+                    this.pendingChoices.delete(key);
+                resolve({ choice, messageId: encodeMessageRef(chatId, messageId) });
+            };
+            const timer = setTimeout(() => {
+                void this.client
+                    .editMessageText(Number(chatId), messageId, `<i>${escapeHtml(this.t.menuExpired)}</i>`, { parse_mode: "HTML" })
+                    .catch(() => undefined);
+                settle(undefined);
+            }, CHOICE_TIMEOUT_MS);
+            for (const key of registered) {
+                this.pendingChoices.set(key, { chatId, keys: registered, resolve: settle, timer });
+            }
+        });
+    }
+    async closeMenu(messageId, summary) {
+        const ref = decodeMessageRef(messageId);
+        if (Number.isNaN(ref.messageId))
+            return;
+        try {
+            await this.client.editMessageText(ref.chatId, ref.messageId, escapeHtml(summary), { parse_mode: "HTML" });
+        }
+        catch {
+            // Best-effort: the menu may already be gone.
+        }
+    }
+}
+/** True when the message mentions this bot: a reply to it, or an @-mention of its username. */
+export function isBotMentioned(message, text, botUsername, botId) {
+    // A reply counts as a mention only when it targets this bot (or any bot,
+    // when the bot's own id is unknown) — replying to an arbitrary user in a
+    // group must not trigger the agent.
+    if (message.reply_to_message !== undefined) {
+        const replied = message.reply_to_message.from;
+        if (botId !== undefined)
+            return replied?.id === botId;
+        return replied?.is_bot === true;
+    }
+    // @-mention entities: match against the bot's username when known; otherwise
+    // accept any mention entity (permissive fallback).
+    const entities = message.entities ?? [];
+    for (const e of entities) {
+        if (e.type !== "mention")
+            continue;
+        const mention = text.slice(e.offset, e.offset + e.length);
+        if (botUsername === undefined)
+            return true;
+        if (mention.toLowerCase() === `@${botUsername.toLowerCase()}`)
+            return true;
+    }
+    // Clients without entities (rare): a leading @-mention that names the bot.
+    if (/^\s*@/.test(text)) {
+        if (botUsername === undefined)
+            return true;
+        const m = text.match(/^\s*@([A-Za-z0-9_]+)/);
+        return m !== null && m[1].toLowerCase() === botUsername.toLowerCase();
+    }
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=adapter.js.map

package/lib/channels/telegram/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channels/telegram/adapter.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAA6C,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAyB,MAAM,WAAW,CAAC;AAsBpE,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,+EAA+E;AAC/E,SAAS,SAAS,CAAC,MAAc,EAAE,QAAgB;IACjD,OAAO,GAAG,MAAM,SAAS,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAiB;IAChE,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;AAClC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC7E,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,0EAA0E;IAC1E,6EAA6E;IAC7E,sEAAsE;IACtE,4EAA4E;IAC5E,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,wEAAwE;QACxE,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI;gBAAE,IAAI,GAAG,GAAG,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5C,CAAC,GAAG,IAAI,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,oEAAoE;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,IAAI,QAAQ,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7C,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrB,SAAS;QACX,CAAC;QACD,eAAe;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,IAAI,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtB,SAAS;QACX,CAAC;QACD,QAAQ;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS;QACX,CAAC;QACD,qDAAqD;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1C,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtB,SAAS;QACX,CAAC;QACD,6EAA6E;QAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,IAAI,YAAY,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS;QACX,CAAC;QACD,yCAAyC;QACzC,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpC,IAAI,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3C,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACvB,SAAS;QACX,CAAC;QACD,4DAA4D;QAC5D,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yDAAyD;AACzD,SAAS,WAAW,CAAC,KAAwB;IAC3C,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,yBAAyB,EAAE,SAAS,CAAC;SACjD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,mBAAmB,CAAC,OAAgC,EAAE,aAAqB;IACzF,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,oEAAoE;AACpE,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,MAAM,OAAO,eAAe;IAgBP;IAfV,EAAE,GAAG,UAAU,CAAC;IACR,MAAM,CAAiB;IACvB,CAAC,CAAmB;IACpB,cAAc,CAAU;IACxB,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC3D,OAAO,CAAiD;IACxD,WAAW,CAAiB;IAC5B,OAAO,GAAG,KAAK,CAAC;IACxB,kFAAkF;IAC1E,KAAK,CAAU;IACvB,mEAAmE;IAC3D,WAAW,CAAU;IAE7B,YACE,MAAsB,EACL,MAAgD;QAAhD,WAAM,GAAN,MAAM,CAA0C;QAEjE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,QAAQ;YACR,GAAG,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAC9G,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;SACrE,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAsD;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,sEAAsE;QACtE,4EAA4E;QAC5E,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACrH,CAAC;QACD,wEAAwE;QACxE,4EAA4E;QAC5E,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,wEAAwE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;YACrC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;oBAChD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;wBAC7B,kEAAkE;wBAClE,+CAA+C;wBAC/C,IAAI,CAAC;4BACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;wBAClC,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,4BAA4B,MAAM,CAAC,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBACxI,CAAC;wBACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC/F,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC;gBACxD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,mFAAmF;QACnF,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3B,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnF,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAsB;QAC/C,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QACD,2EAA2E;QAC3E,wEAAwE;QACxE,kCAAkC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAClC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,UAAU,KAAK,SAAS;YAAE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,KAA2B;QAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClG,qEAAqE;QACrE,8CAA8C;QAC9C,MAAM,OAAO,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClH,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,qEAAqE;YACrE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,sGAAsG;IAC9F,KAAK,CAAC,gBAAgB,CAAC,OAAwB;QACrD,yEAAyE;QACzE,yEAAyE;QACzE,oCAAoC;QACpC,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAEpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAoB,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAEnD,6EAA6E;QAC7E,IAAI,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChH,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,oDAAoD;QACpD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,UAA8B,CAAC;QACnC,IAAI,SAA6B,CAAC;QAElC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,OAAO,CAAC,cAAc,MAAM,CAAC,CAAC;YACzG,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC;iBAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;QAClF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,SAAS,IAAI,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YAC5I,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACtE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;iBAC9C,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAEtF,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,MAAM;YACf,QAAQ;YACR,SAAS;YACT,IAAI;YACJ,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5G,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;YACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;SAClD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB,EAAE,IAAY;QACjD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;YAClD,UAAU,EAAE,MAAM;YAClB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1F,wBAAwB,EAAE,IAAI;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB,EAAE,IAAiB;QACtD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrH,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE;YAClE,UAAU,EAAE,MAAM;YAClB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1F,wBAAwB,EAAE,IAAI;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAsB,EAAE,QAAgB,EAAE,OAA+B;QACtF,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC;QAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpF,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAK,WAAW,EAAE,CAAC;YACjD,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAsB,EAAE,MAA6B;QACpE,sEAAsE;QACtE,yEAAyE;QACzE,qEAAqE;QACrE,IAAI,SAA6B,CAAC;QAClC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,MAAe;YAC3B,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1F,wBAAwB,EAAE,IAAI;SAC/B,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;YACtC,IAAI,QAAQ,KAAK,EAAE;gBAAE,OAAO;YAC5B,uEAAuE;YACvE,8DAA8D;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC;YACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3F,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;oBACnE,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC7F,CAAC;gBACD,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wEAAwE;gBACxE,uEAAuE;gBACvE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1H,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,QAAQ,IAAI,KAAK,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,oEAAoE;YACpE,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;gBAC5B,MAAM,KAAK,EAAE,CAAC;YAChB,CAAC;iBAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,GAAG,WAAW,IAAI,GAAG,EAAE,CAAC;gBAC9D,MAAM,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAsB,EAAE,MAAoB,EAAE,eAAwB;QACvF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,GAAG,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAE9B,IAAI,SAAiB,CAAC;QACtB,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;YAC9C,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE;gBAC7D,UAAU,EAAE,MAAM;gBAClB,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE;gBACvD,UAAU,EAAE,MAAM;gBAClB,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;YACH,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,CAAC;QAED,4EAA4E;QAC5E,2EAA2E;QAC3E,kEAAkE;QAClE,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE;YAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,CAAC,MAA0B,EAAQ,EAAE;gBAClD,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,MAAM,GAAG,IAAI,UAAU;oBAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,KAAK,IAAI,CAAC,MAAM;qBACb,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;qBAC9G,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC1B,MAAM,CAAC,SAAS,CAAC,CAAC;YACpB,CAAC,EAAE,iBAAiB,CAAC,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,OAAe;QAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,OAAwB,EAAE,IAAY,EAAE,WAAoB,EAAE,KAAc;IACzG,yEAAyE;IACzE,yEAAyE;IACzE,oCAAoC;IACpC,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,EAAE,EAAE,KAAK,KAAK,CAAC;QACtD,OAAO,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,CAAC;IACD,6EAA6E;IAC7E,mDAAmD;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3C,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE;YAAE,OAAO,IAAI,CAAC;IAC7E,CAAC;IACD,2EAA2E;IAC3E,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/lib/channels/telegram/client.d.ts

@@ -0,0 +1,115 @@
+/** Raw Telegram update (subset of the full schema we use). */
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    callback_query?: TelegramCallbackQuery;
+}
+export interface TelegramMessage {
+    message_id: number;
+    chat: {
+        id: number;
+        type: string;
+        title?: string;
+    };
+    from?: {
+        id: number;
+        is_bot?: boolean;
+        first_name?: string;
+        username?: string;
+    };
+    text?: string;
+    caption?: string;
+    reply_to_message?: TelegramMessage;
+    entities?: {
+        type: string;
+        offset: number;
+        length: number;
+    }[];
+    photo?: {
+        file_id: string;
+        file_unique_id: string;
+        width: number;
+        height: number;
+    }[];
+    document?: {
+        file_id: string;
+        file_name?: string;
+    };
+    voice?: {
+        file_id: string;
+    };
+    video?: {
+        file_id: string;
+    };
+    audio?: {
+        file_id: string;
+    };
+    sticker?: {
+        file_id: string;
+    };
+}
+export interface TelegramCallbackQuery {
+    id: string;
+    from: {
+        id: number;
+        username?: string;
+    };
+    message?: TelegramMessage;
+    data?: string;
+}
+/** Options accepted by `sendMessage` (parse_mode, reply_markup, …). */
+export interface SendMessageOptions {
+    parse_mode?: "HTML" | "MarkdownV2";
+    reply_to_message_id?: number;
+    reply_markup?: unknown;
+    disable_web_page_preview?: boolean;
+}
+export interface TelegramClientConfig {
+    botToken: string;
+    /** getUpdates polling timeout (seconds). Default 50. */
+    pollingTimeoutSeconds?: number;
+    /** getUpdates long-poll gap after an error. Default 3s. */
+    retryDelayMs?: number;
+    /** HTTP timeout for each API call (ms). Default 15s. */
+    timeoutMs?: number;
+    /** Optional base URL override (e.g. for a local Bot API server). */
+    baseUrl?: string;
+}
+/** Normalized photo/file location after download. */
+export interface DownloadedResource {
+    path: string;
+    kind: "image" | "file";
+    error?: string;
+}
+export declare class TelegramClient {
+    readonly config: TelegramClientConfig;
+    private offset;
+    constructor(config: TelegramClientConfig);
+    private base;
+    private call;
+    /** Long-poll for new updates. Does NOT advance the offset — the caller confirms each update via {@link confirmOffset} after processing it, so a failure mid-batch never loses the remaining updates. */
+    pollUpdates(): Promise<TelegramUpdate[]>;
+    /** Advance the polling offset past `updateId` — call only after the update was fully handled. */
+    confirmOffset(updateId: number): void;
+    /** Skip all pending updates (used on startup so we don't replay history). */
+    resetOffset(): Promise<void>;
+    /** Fetch the bot's own identity (id + username) — used for @-mention / reply-to checks. */
+    getMe(): Promise<{
+        id: number;
+        username?: string;
+    }>;
+    sendMessage(chatId: number | string, text: string, opts?: SendMessageOptions): Promise<TelegramMessage>;
+    editMessageText(chatId: number | string, messageId: number, text: string, opts?: SendMessageOptions): Promise<unknown>;
+    sendPhoto(chatId: number | string, photoPath: string, caption?: string, opts?: SendMessageOptions): Promise<TelegramMessage>;
+    sendDocument(chatId: number | string, documentPath: string, opts?: SendMessageOptions): Promise<TelegramMessage>;
+    answerCallbackQuery(callbackQueryId: string, text?: string): Promise<boolean>;
+    /** Download a file (photo / document / …) by file_id into a temp dir; returns the local path. */
+    downloadFile(fileId: string, dir: string, fileName?: string): Promise<DownloadedResource>;
+    /** Convenience: download to the OS temp dir. */
+    downloadFileToTemp(fileId: string, fileName?: string): Promise<DownloadedResource>;
+}
+/** Pick the Bot API method for a local file (sendPhoto vs sendDocument). */
+export declare function telegramFileMethod(filename: string): "sendPhoto" | "sendDocument";
+/** Strip path separators / control chars from a downloaded file's name. */
+export declare function sanitizeFileName(name: string): string;
+//# sourceMappingURL=client.d.ts.map

package/lib/channels/telegram/client.d.ts.map

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