@sympoies/dsh-telegram 0.0.0-bootstrap.0 → 0.6.0

package/lib/telegram/api.js

@@ -0,0 +1,518 @@
+/**
+ * Telegram Bot API client.
+ *
+ * Speaks the HTTP protocol directly — no SDK — because the surface this plugin
+ * needs is a dozen methods wide and an SDK would only add a dependency and a
+ * translation layer between us and the error messages that matter.
+ *
+ * Three behaviours are deliberate and are the reason this client exists rather
+ * than a thin fetch wrapper:
+ *
+ * - **Replies are sent as rich markdown.** Since Bot API 10.1 Telegram parses
+ *   markdown itself, so the agent's tables, headings and lists arrive as real
+ *   elements. The plugin's own prompts stay on plain HTML: they are short,
+ *   built from escaped text, and carry the inline keyboards.
+ * - **Rate limits are waited out, not thrown.** A 429 carries `retry_after`;
+ *   the client sleeps that long and retries, so a burst of streaming edits
+ *   degrades into slower edits rather than a failed turn.
+ * - **The token never reaches a log.** It lives in the request path, so every
+ *   error message is redacted before it escapes.
+ */
+/** Attempts for a request that fails with a retryable status. */
+const MAX_RETRIES = 3;
+/** Backoff for retryable failures that carry no `retry_after`. */
+const BACKOFF_MS = [500, 1500, 4000];
+/** Statuses worth retrying: rate limit, and Telegram's own transient faults. */
+const RETRYABLE = new Set([429, 500, 502, 503, 504]);
+/**
+ * Methods safe to repeat after a transport failure.
+ *
+ * A dropped connection leaves no way to know whether the request arrived, so
+ * repeating a send could post the same message twice. These are all reads or
+ * idempotent, so repeating one costs nothing and rescues the call.
+ *
+ * This matters most for `getFile`: it runs while the long poll holds its own
+ * connection open, so it is the call most likely to need a fresh one, and a
+ * single flaky connect was turning a sent screenshot into an error.
+ */
+const IDEMPOTENT = new Set(['getMe', 'getFile', 'getUpdates', 'deleteWebhook', 'downloadFile']);
+/** Deadline for one file download; larger than an API call's, for large files. */
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 60_000;
+/** A Bot API call that failed, with the token stripped from every field. */
+export class TelegramApiError extends Error {
+    code;
+    description;
+    retryAfterSeconds;
+    constructor(message, code, description, 
+    /** Seconds Telegram asked us to wait, from a 429's `parameters.retry_after`. */
+    retryAfterSeconds) {
+        super(message);
+        this.code = code;
+        this.description = description;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.name = 'TelegramApiError';
+    }
+    /** Whether the failure means the bot token itself is not valid. */
+    get isAuthFailure() {
+        return this.code === 401;
+    }
+}
+export class TelegramApi {
+    options;
+    fetchImpl;
+    sleep;
+    downloadTimeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        this.sleep = options.sleep ?? defaultSleep;
+        this.downloadTimeoutMs = options.downloadTimeoutMs ?? DEFAULT_DOWNLOAD_TIMEOUT_MS;
+    }
+    /** Verify the token and read the bot's own identity. */
+    getMe() {
+        return this.call('getMe', {});
+    }
+    /** Drop any webhook so long polling is the only delivery path. */
+    async deleteWebhook() {
+        await this.call('deleteWebhook', { drop_pending_updates: false });
+    }
+    /**
+     * Long-poll for updates.
+     *
+     * `allowed_updates` includes `callback_query`, which is what lets a button
+     * press reach the agent at all.
+     */
+    getUpdates(offset, timeoutSeconds, signal) {
+        return this.call('getUpdates', {
+            offset,
+            timeout: timeoutSeconds,
+            allowed_updates: ['message', 'callback_query'],
+        }, { ...(signal ? { signal } : {}), timeoutMs: timeoutSeconds * 1000 + 5000 });
+    }
+    /**
+     * Send one HTML message, falling back to plain text if Telegram rejects the
+     * markup rather than letting the content vanish.
+     */
+    async sendMessage(options) {
+        const body = {
+            chat_id: options.chatId,
+            text: options.html,
+            parse_mode: 'HTML',
+            link_preview_options: { is_disabled: true },
+            ...(options.keyboard ? { reply_markup: toReplyMarkup(options.keyboard) } : {}),
+            ...(options.replyToMessageId
+                ? { reply_parameters: { message_id: options.replyToMessageId } }
+                : {}),
+            ...(options.threadId !== undefined ? { message_thread_id: options.threadId } : {}),
+        };
+        const sent = await this.call('sendMessage', body, {
+            ...(options.signal ? { signal: options.signal } : {}),
+        });
+        return { messageId: sent.message_id };
+    }
+    /**
+     * Edit one message in place — the mechanism behind streamed replies.
+     *
+     * Telegram answers 400 when the new text equals the old, which during
+     * streaming is an ordinary and frequent event, so it is reported rather than
+     * thrown.
+     */
+    async editMessageText(options) {
+        const body = {
+            chat_id: options.chatId,
+            message_id: options.messageId,
+            text: options.html,
+            parse_mode: 'HTML',
+            link_preview_options: { is_disabled: true },
+            ...(options.keyboard ? { reply_markup: toReplyMarkup(options.keyboard) } : {}),
+        };
+        try {
+            await this.call('editMessageText', body, {
+                ...(options.signal ? { signal: options.signal } : {}),
+            });
+            return 'edited';
+        }
+        catch (error) {
+            if (isNotModified(error))
+                return 'unchanged';
+            throw error;
+        }
+    }
+    /**
+     * Send one rich message.
+     *
+     * Telegram parses the Rich Markdown itself, so tables, headings, lists and
+     * task lists arrive as real elements rather than as an approximation of
+     * them — and the cap is 32768 characters rather than 4096.
+     */
+    async sendRichMessage(options) {
+        const sent = await this.call('sendRichMessage', {
+            chat_id: options.chatId,
+            rich_message: { markdown: options.markdown },
+            ...(options.keyboard ? { reply_markup: toReplyMarkup(options.keyboard) } : {}),
+            ...(options.replyToMessageId
+                ? { reply_parameters: { message_id: options.replyToMessageId } }
+                : {}),
+            ...(options.threadId !== undefined ? { message_thread_id: options.threadId } : {}),
+        }, { ...(options.signal ? { signal: options.signal } : {}) });
+        return { messageId: sent.message_id };
+    }
+    /**
+     * Stream one frame of a partial reply.
+     *
+     * The draft is a 30-second ephemeral preview, and Telegram animates changes
+     * carrying the same `draftId` — so a turn keeps one id throughout and the
+     * text grows in place. It must still be persisted with a real send when the
+     * turn ends, and it works in private chats only.
+     */
+    async sendRichMessageDraft(options) {
+        await this.call('sendRichMessageDraft', {
+            chat_id: options.chatId,
+            draft_id: options.draftId,
+            rich_message: { markdown: options.markdown },
+            ...(options.threadId !== undefined ? { message_thread_id: options.threadId } : {}),
+        }, { ...(options.signal ? { signal: options.signal } : {}) });
+    }
+    /** Replace a message's content with rich markdown. */
+    async editRichMessage(options) {
+        try {
+            await this.call('editMessageText', {
+                chat_id: options.chatId,
+                message_id: options.messageId,
+                rich_message: { markdown: options.markdown },
+                ...(options.keyboard ? { reply_markup: toReplyMarkup(options.keyboard) } : {}),
+            });
+            return 'edited';
+        }
+        catch (error) {
+            if (isNotModified(error))
+                return 'unchanged';
+            throw error;
+        }
+    }
+    /** Replace or clear a message's inline keyboard, leaving its text alone. */
+    async editMessageReplyMarkup(options) {
+        try {
+            await this.call('editMessageReplyMarkup', {
+                chat_id: options.chatId,
+                message_id: options.messageId,
+                reply_markup: toReplyMarkup(options.keyboard),
+            });
+        }
+        catch (error) {
+            if (!isNotModified(error))
+                throw error;
+        }
+    }
+    /**
+     * Acknowledge a button press. Telegram shows a spinner on the button until
+     * this lands, so it is sent before any slow work the press triggers.
+     */
+    async answerCallbackQuery(id, text) {
+        try {
+            await this.call('answerCallbackQuery', {
+                callback_query_id: id,
+                ...(text ? { text } : {}),
+            });
+        }
+        catch {
+            // An expired callback id is normal (the user pressed twice, or waited);
+            // failing to acknowledge must never abort the work the press started.
+        }
+    }
+    /**
+     * Upload one file to a chat.
+     *
+     * Multipart rather than the JSON path every other call uses, because
+     * Telegram takes file bytes no other way. Node builds the body: `FormData`
+     * and `Blob` are standard here, so there is no boundary to get wrong.
+     *
+     * Not retried. A retry would re-upload the whole file, and the failures that
+     * matter for one — too large, wrong type — do not pass on a second attempt.
+     *
+     * @param method - `sendPhoto` or `sendDocument`.
+     * @param field - the form field Telegram expects the bytes under.
+     * @param options - the chat, the bytes, and what to call them.
+     */
+    async uploadFile(method, field, options) {
+        const form = new FormData();
+        form.set('chat_id', options.chatId);
+        if (options.caption !== undefined)
+            form.set('caption', options.caption);
+        if (options.caption !== undefined)
+            form.set('parse_mode', 'HTML');
+        if (options.threadId !== undefined)
+            form.set('message_thread_id', String(options.threadId));
+        form.set(field, 
+        // Copied into a plain ArrayBuffer: a Uint8Array view may sit on a larger
+        // pooled buffer, and Blob would take the whole thing.
+        new Blob([options.data.slice().buffer], { type: options.contentType }), options.filename);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.downloadTimeoutMs);
+        try {
+            const response = await this.fetchImpl(`${this.base()}/bot${this.options.token}/${method}`, {
+                method: 'POST',
+                body: form,
+                signal: controller.signal,
+            });
+            const envelope = parseEnvelope(await response.text(), method);
+            if (!envelope.ok) {
+                throw new TelegramApiError(this.redact(`telegram ${method} failed: ${envelope.description ?? `http ${response.status}`}`), envelope.error_code ?? response.status, envelope.description === undefined ? undefined : this.redact(envelope.description));
+            }
+            return { messageId: envelope.result.message_id };
+        }
+        catch (error) {
+            throw this.normalize(error, method);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Publish the command menu Telegram offers when someone types `/`.
+     *
+     * Without this the bot answers every command correctly and advertises none
+     * of them, so they are discoverable only by reading the README. Best-effort:
+     * a bot that cannot publish its menu still works, it is only harder to find
+     * your way around.
+     *
+     * @param commands - name and one-line description, in menu order.
+     */
+    async setMyCommands(commands) {
+        try {
+            await this.call('setMyCommands', { commands });
+        }
+        catch {
+            // Cosmetic only.
+        }
+    }
+    /** Show a progress indicator in the chat. Best-effort by design. */
+    async sendChatAction(chatId, action, threadId) {
+        try {
+            await this.call('sendChatAction', {
+                chat_id: chatId,
+                action,
+                ...(threadId === undefined ? {} : { message_thread_id: threadId }),
+            });
+        }
+        catch {
+            // Cosmetic only.
+        }
+    }
+    /** Resolve a file id to downloadable metadata. */
+    getFile(fileId) {
+        return this.call('getFile', { file_id: fileId });
+    }
+    /**
+     * Download a resolved file's bytes.
+     *
+     * The download URL carries the token in its path, and a transport failure
+     * quotes the URL it was given — so this fetch is wrapped like every other,
+     * or a dropped connection would hand the token to the caller's log.
+     */
+    async downloadFile(filePath, signal) {
+        const url = `${this.base()}/file/bot${this.options.token}/${filePath.replace(/^\/+/, '')}`;
+        return this.withRetries('downloadFile', signal, async () => {
+            // Its own deadline, and a generous one: without a timeout this waited on
+            // the operating system's TCP timeout, which is minutes, and a file may
+            // legitimately be 20 MB over a slow link.
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.downloadTimeoutMs);
+            const onAbort = () => controller.abort();
+            signal?.addEventListener('abort', onAbort, { once: true });
+            try {
+                const response = await this.fetchImpl(url, { signal: controller.signal });
+                if (!response.ok) {
+                    throw new TelegramApiError(`telegram file download failed with http ${response.status}`, response.status, undefined);
+                }
+                return new Uint8Array(await response.arrayBuffer());
+            }
+            catch (error) {
+                throw this.normalize(error, 'downloadFile');
+            }
+            finally {
+                clearTimeout(timer);
+                signal?.removeEventListener('abort', onAbort);
+            }
+        });
+    }
+    /** Base url without a trailing slash. */
+    base() {
+        return this.options.baseUrl.replace(/\/+$/, '');
+    }
+    /**
+     * One Bot API call, with retries for transient failures.
+     *
+     * @throws {TelegramApiError} with the token redacted from every field.
+     */
+    call(method, body, options = {}) {
+        return this.withRetries(method, options.signal, () => this.request(method, body, options));
+    }
+    /**
+     * Run one operation, backing off and repeating what is safe to repeat.
+     *
+     * Shared with the download path rather than living inside `call`: a download
+     * is the most retry-worthy request this client makes — a pure read of bytes
+     * — and leaving it outside the retry loop is what turned an intermittent
+     * connection into a screenshot the agent never saw.
+     */
+    async withRetries(method, signal, run) {
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt += 1) {
+            try {
+                return await run();
+            }
+            catch (error) {
+                lastError = error;
+                const delay = retryDelay(error, attempt, IDEMPOTENT.has(method));
+                if (delay === undefined)
+                    throw error;
+                await this.sleep(delay, signal);
+            }
+        }
+        throw lastError;
+    }
+    /** One attempt: build, send, validate, unwrap. */
+    async request(method, body, options) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? this.options.timeoutMs);
+        const onAbort = () => controller.abort();
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            const response = await this.fetchImpl(`${this.base()}/bot${this.options.token}/${method}`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(prune(body)),
+                signal: controller.signal,
+            });
+            const envelope = parseEnvelope(await response.text(), method);
+            if (!envelope.ok) {
+                throw new TelegramApiError(this.redact(`telegram ${method} failed: ${envelope.description ?? `http ${response.status}`}`), envelope.error_code ?? response.status, 
+                // Redacted too, though Telegram's own descriptions do not quote the
+                // request. `description` is read straight into a log line on an auth
+                // failure, and a field that skips this is a field that only has to be
+                // wrong once.
+                envelope.description === undefined ? undefined : this.redact(envelope.description), envelope.parameters?.retry_after);
+            }
+            return envelope.result;
+        }
+        catch (error) {
+            throw this.normalize(error, method);
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    /** Wrap any thrown value as a redacted TelegramApiError. */
+    normalize(error, method) {
+        if (error instanceof TelegramApiError)
+            return error;
+        return new TelegramApiError(`telegram ${method} failed: ${this.redact(describeCause(error))}`, undefined, undefined);
+    }
+    /** Remove the bot token from any string bound for a log or an error. */
+    redact(text) {
+        return text.split(this.options.token).join('<redacted>');
+    }
+}
+/** Parse a response body, treating unparseable output as a failed call. */
+function parseEnvelope(text, method) {
+    if (text === '')
+        return { ok: true, result: undefined };
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new TelegramApiError(`telegram ${method} returned a non-JSON response`, undefined, undefined);
+    }
+}
+/**
+ * How long to wait before retrying, or undefined when the failure is final.
+ * A 429 names its own delay; everything else uses fixed backoff.
+ *
+ * @param repeatable - whether repeating this method is safe when the transport
+ *   failed and the request's fate is unknown.
+ */
+function retryDelay(error, attempt, repeatable) {
+    if (!(error instanceof TelegramApiError))
+        return undefined;
+    if (attempt >= MAX_RETRIES - 1)
+        return undefined;
+    // No status means the request never got an answer: a refused connection, a
+    // dropped socket, a name that would not resolve. The poll loop already
+    // survives those; an individual call did not, so one flaky connect surfaced
+    // to the user as a failure.
+    if (error.code === undefined) {
+        return repeatable ? (BACKOFF_MS[attempt] ?? BACKOFF_MS[BACKOFF_MS.length - 1]) : undefined;
+    }
+    if (!RETRYABLE.has(error.code))
+        return undefined;
+    if (error.retryAfterSeconds !== undefined)
+        return error.retryAfterSeconds * 1000;
+    const stated = /retry after (\d+)/i.exec(error.description ?? '')?.[1];
+    if (stated)
+        return Number(stated) * 1000;
+    if (error.code === 429)
+        return 1000;
+    return BACKOFF_MS[attempt] ?? BACKOFF_MS[BACKOFF_MS.length - 1];
+}
+/**
+ * One readable line from an error and everything underneath it.
+ *
+ * Node's fetch reports every transport failure as the same three words —
+ * `fetch failed` — and puts what actually happened in `cause`: a refused
+ * connection, an unresolved name, an expired certificate, a timeout. Reporting
+ * only the top layer turns four distinct problems into one unactionable
+ * sentence, which is exactly how far a diagnosis gets on it.
+ *
+ * @param error - any thrown value.
+ * @returns the message chain, outermost first.
+ */
+export function describeCause(error) {
+    const chain = [];
+    let current = error;
+    // Bounded: a cause chain is normally two or three deep, and a cyclic one
+    // must not become an infinite loop inside an error handler.
+    for (let depth = 0; depth < 5 && current !== undefined && current !== null; depth += 1) {
+        const message = current instanceof Error ? current.message : String(current);
+        const code = current.code;
+        const labelled = typeof code === 'string' && !message.includes(code) ? `${message} (${code})` : message;
+        if (labelled !== '' && !chain.includes(labelled))
+            chain.push(labelled);
+        current = current instanceof Error ? current.cause : undefined;
+    }
+    return chain.length > 0 ? chain.join(': ') : String(error);
+}
+/** Whether a failure means "the edit changed nothing", which is not a failure. */
+function isNotModified(error) {
+    if (!(error instanceof TelegramApiError))
+        return false;
+    return /message is not modified/i.test(error.description ?? '');
+}
+/** Convert our keyboard shape into the Bot API's snake-cased markup. */
+function toReplyMarkup(keyboard) {
+    return {
+        inline_keyboard: keyboard.map((row) => row.map((button) => ({ text: button.text, callback_data: button.callbackData }))),
+    };
+}
+/** Drop undefined values so `parse_mode: undefined` really omits the field. */
+function prune(body) {
+    return Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined));
+}
+/** Cancellable sleep used by the retry path. */
+function defaultSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted)
+            return resolve();
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=api.js.map

package/lib/telegram/api.js.map

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

package/lib/telegram/poller.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The long-poll receive loop.
+ *
+ * Telegram's `getUpdates` offset is the delivery guarantee: an update is
+ * redelivered until an offset past it is acknowledged. So the offset advances
+ * only after the handler for that update returns. A handler that throws leaves
+ * the offset where it is and the update comes back on the next poll — which is
+ * why the router above it never throws for ordinary failures, and only a real
+ * fault gets a retry.
+ *
+ * Reconnection is the loop's other job. A laptop that sleeps, a network that
+ * drops, a Telegram hiccup — each surfaces as a rejected poll, and the bot has
+ * to come back on its own rather than going quietly silent.
+ */
+import type { Logger } from '../harness/types.js';
+import type { TelegramUpdate } from './types.js';
+/** Where updates come from — narrowed so tests need no Bot API client. */
+export interface UpdateSource {
+    getUpdates(offset: number, timeoutSeconds: number, signal?: AbortSignal): Promise<TelegramUpdate[]>;
+}
+/** Construction options. */
+export interface PollerOptions {
+    readonly source: UpdateSource;
+    /** Handles one update; may throw, which leaves the update unacknowledged. */
+    readonly onUpdate: (update: TelegramUpdate) => Promise<void>;
+    /** Seconds Telegram holds an empty poll open. */
+    readonly longPollSeconds?: number;
+    /** First reconnect delay; doubles up to `maxDelayMs`. */
+    readonly baseDelayMs?: number;
+    readonly maxDelayMs?: number;
+    /** Called the first time a poll succeeds after a failure. */
+    readonly onConnected?: () => void;
+    readonly sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    readonly logger?: Logger;
+}
+export declare class UpdatePoller {
+    private readonly options;
+    private readonly logger;
+    private readonly sleep;
+    private offset;
+    private connected;
+    constructor(options: PollerOptions);
+    /** The next offset that will be acknowledged; exposed for tests and status. */
+    get acknowledged(): number;
+    /**
+     * Poll until the signal aborts.
+     *
+     * @param signal - stops the loop; an in-flight poll is aborted with it.
+     */
+    run(signal: AbortSignal): Promise<void>;
+    /**
+     * Hand each update to the handler, acknowledging only after it returns.
+     * A throw stops the batch so the failed update is redelivered.
+     */
+    private dispatch;
+    /** Exponential backoff, capped so a long outage still retries regularly. */
+    private backoff;
+}
+//# sourceMappingURL=poller.d.ts.map

package/lib/telegram/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/telegram/poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;CACpG;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,iDAAiD;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqD;IAC3E,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,SAAS,CAAQ;gBAEI,OAAO,EAAE,aAAa;IAKnD,+EAA+E;IAC/E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C;;;OAGG;YACW,QAAQ;IAQtB,4EAA4E;IAC5E,OAAO,CAAC,OAAO;CAKhB"}