@adonis-agora/agent 0.61.0 → 0.63.0

package/dist/src/channels/adapters/evolution_api.js

@@ -0,0 +1,241 @@
+import { ChannelDeliveryError, ChannelMediaTooLargeError, decodeBase64, fetchBytes, postJson, queryParam, record, safeEqual, sizeOf, str, } from '../http.js';
+const PHONE_JID = /^(\d{5,20})@s\.whatsapp\.net$/;
+/** A phone jid's digits; any other jid as is. */
+function addressOf(jid) {
+    return PHONE_JID.exec(jid)?.[1] ?? jid;
+}
+/** The id and label of a button / list reply, in any of the shapes Evolution forwards them. */
+function buttonReply(message) {
+    const buttons = record(message.buttonsResponseMessage);
+    const template = record(message.templateButtonReplyMessage);
+    const list = record(message.listResponseMessage);
+    const interactive = record(record(message.interactiveResponseMessage)?.nativeFlowResponseMessage);
+    const id = str(buttons?.selectedButtonId) ??
+        str(template?.selectedId) ??
+        str(record(list?.singleSelectReply)?.selectedRowId) ??
+        (() => {
+            const params = str(interactive?.paramsJson);
+            if (params === undefined)
+                return undefined;
+            try {
+                return str(record(JSON.parse(params))?.id);
+            }
+            catch {
+                return undefined;
+            }
+        })();
+    if (id === undefined)
+        return undefined;
+    return {
+        id,
+        label: str(buttons?.selectedDisplayText) ?? str(template?.selectedDisplayText) ?? str(list?.title),
+    };
+}
+const MEDIA_FIELDS = [
+    ['imageMessage', 'image'],
+    ['audioMessage', 'audio'],
+    ['videoMessage', 'video'],
+    ['documentMessage', 'document'],
+    ['stickerMessage', 'sticker'],
+];
+/** The file a message carries, and its caption. */
+function mediaOf(message, key) {
+    // A document sent with a caption arrives wrapped.
+    const wrapped = record(record(message.documentWithCaptionMessage)?.message);
+    const source = wrapped ?? message;
+    for (const [field, kind] of MEDIA_FIELDS) {
+        const body = record(source[field]);
+        if (!body)
+            continue;
+        const ref = {
+            key,
+            ...(str(message.base64) !== undefined ? { base64: str(message.base64) } : {}),
+            ...(str(message.mediaUrl) !== undefined ? { mediaUrl: str(message.mediaUrl) } : {}),
+        };
+        const contentType = str(body.mimetype);
+        const filename = str(body.fileName);
+        const sizeBytes = sizeOf(body.fileLength);
+        return {
+            media: {
+                kind,
+                ref,
+                ...(contentType !== undefined ? { contentType } : {}),
+                ...(filename !== undefined ? { filename } : {}),
+                ...(sizeBytes !== undefined ? { sizeBytes } : {}),
+            },
+            caption: str(body.caption),
+        };
+    }
+    return undefined;
+}
+function parseOne(data, options) {
+    const key = record(data.key);
+    const remoteJid = str(key?.remoteJid);
+    const id = str(key?.id);
+    if (!key || !remoteJid || !id)
+        return null;
+    // Only a message explicitly marked as incoming: never assume a missing `fromMe` means "not mine".
+    if (!(key.fromMe === false || data.fromMe === false) || key.fromMe === true)
+        return null;
+    if (remoteJid.endsWith('@broadcast') || remoteJid.endsWith('@newsletter'))
+        return null;
+    const group = remoteJid.endsWith('@g.us');
+    if (group && options.groups !== true)
+        return null;
+    const sender = group
+        ? str(key.participant)
+        : // A `@lid` chat hides the number; Evolution adds it alongside when it knows it.
+            ([remoteJid, str(key.remoteJidAlt), str(key.senderPn)].find((jid) => jid !== undefined && PHONE_JID.test(jid)) ?? remoteJid);
+    if (sender === undefined)
+        return null;
+    const message = record(data.message);
+    if (!message)
+        return null;
+    const button = buttonReply(message);
+    const file = button ? undefined : mediaOf(message, key);
+    const text = button
+        ? (button.label ?? button.id)
+        : file
+            ? (file.caption ?? '')
+            : (str(message.conversation) ?? str(record(message.extendedTextMessage)?.text));
+    if (text === undefined || (text.trim() === '' && !file))
+        return null;
+    return {
+        id,
+        from: addressOf(sender),
+        conversation: remoteJid,
+        text: text.trim(),
+        ...(button ? { buttonId: button.id } : {}),
+        ...(file ? { media: [file.media] } : {}),
+        raw: data,
+    };
+}
+/** The WhatsApp reply-button limit. */
+const MAX_BUTTONS = 3;
+/**
+ * WhatsApp through [Evolution API](https://doc.evolution-api.com) v2 (or a server with the same
+ * routes). Point the instance's webhook — event `MESSAGES_UPSERT` — at the route, with the token:
+ * `https://app.example.com/webhooks/whatsapp?token=<webhookToken>`.
+ *
+ * Reads `messages.upsert` (text, extended text, button and list replies, images, audio, video,
+ * documents and stickers); ignores the instance's own messages, broadcasts and (unless `groups`)
+ * groups. Sends with `POST {url}/message/sendText/{instance}`. Downloads media from the webhook's
+ * inline `base64` (Evolution's "webhook base64" setting), else its `mediaUrl`, else
+ * `POST {url}/chat/getBase64FromMediaMessage/{instance}`.
+ */
+export function evolutionApi(options) {
+    const name = options.name ?? 'whatsapp';
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? 20_000;
+    const base = options.url.replace(/\/+$/, '');
+    const instance = encodeURIComponent(options.instance);
+    const headers = { apikey: options.apiKey };
+    const post = (path, body) => postJson(name, fetcher, `${base}${path}/${instance}`, headers, body, timeoutMs);
+    return {
+        name,
+        capabilities: {
+            ...(options.buttons === true ? { buttons: MAX_BUTTONS } : {}),
+            markdown: 'whatsapp',
+            maxLength: options.maxLength ?? 4096,
+        },
+        verify(request) {
+            if (options.webhookToken === false)
+                return true;
+            const bearer = request.header('authorization')?.replace(/^Bearer\s+/i, '');
+            const supplied = [
+                queryParam(request.url, 'token'),
+                typeof request.params.token === 'string' ? request.params.token : undefined,
+                bearer,
+                request.header('x-webhook-token'),
+            ];
+            return supplied.some((token) => safeEqual(token, options.webhookToken));
+        },
+        parse(body) {
+            const envelope = record(body);
+            if (!envelope)
+                return null;
+            const event = str(envelope.event)?.toLowerCase().replace(/_/g, '.');
+            if (event !== 'messages.upsert')
+                return null;
+            const from = str(envelope.instance);
+            if (from !== undefined && from !== options.instance)
+                return null;
+            const items = Array.isArray(envelope.data) ? envelope.data : [envelope.data];
+            return items
+                .map((item) => record(item))
+                .filter((item) => item !== undefined)
+                .map((item) => parseOne(item, options))
+                .filter((item) => item !== null);
+        },
+        async download(media, { maxBytes }) {
+            const ref = media.ref;
+            if (media.sizeBytes !== undefined && media.sizeBytes > maxBytes) {
+                throw new ChannelMediaTooLargeError(maxBytes);
+            }
+            const fallbackType = media.contentType ?? 'application/octet-stream';
+            const named = media.filename !== undefined ? { filename: media.filename } : {};
+            if (ref.base64 !== undefined) {
+                return { data: decodeBase64(ref.base64, maxBytes), contentType: fallbackType, ...named };
+            }
+            if (ref.mediaUrl !== undefined) {
+                // The instance's key goes only to the Evolution server itself, never to a storage host.
+                const sameHost = new URL(ref.mediaUrl).origin === new URL(base).origin;
+                const file = await fetchBytes(name, fetcher, ref.mediaUrl, sameHost ? headers : {}, timeoutMs, maxBytes);
+                return {
+                    data: file.data,
+                    contentType: media.contentType ?? file.contentType ?? fallbackType,
+                    ...named,
+                };
+            }
+            const answer = record(await post('/chat/getBase64FromMediaMessage', {
+                message: { key: ref.key },
+                convertToMp4: false,
+            }));
+            const base64 = str(answer?.base64);
+            if (base64 === undefined) {
+                throw new ChannelDeliveryError(name, null, `${name}: the media could not be downloaded`);
+            }
+            const filename = str(answer?.fileName) ?? media.filename;
+            return {
+                data: decodeBase64(base64, maxBytes),
+                contentType: str(answer?.mimetype) ?? fallbackType,
+                ...(filename !== undefined ? { filename } : {}),
+            };
+        },
+        async send(conversation, message) {
+            const number = addressOf(conversation);
+            if (message.buttons !== undefined && options.buttons === true) {
+                const [first = '', ...rest] = message.text.split('\n');
+                const title = first.replace(/[*_~]/g, '').trim();
+                const description = rest.join('\n').trim();
+                if (title.length <= 60 && description.length <= 1024 && message.buttons.length > 0) {
+                    try {
+                        await post('/message/sendButtons', {
+                            number,
+                            title,
+                            description: description === '' ? title : description,
+                            buttons: message.buttons.slice(0, MAX_BUTTONS).map((button) => ({
+                                type: 'reply',
+                                displayText: button.label.slice(0, 20),
+                                id: button.id,
+                            })),
+                        });
+                        return;
+                    }
+                    catch (error) {
+                        // Only a definite refusal falls back: a timeout may have delivered the buttons already.
+                        if (!(error instanceof ChannelDeliveryError) || !error.definite)
+                            throw error;
+                    }
+                }
+                await post('/message/sendText', { number, text: message.fallbackText });
+                return;
+            }
+            await post('/message/sendText', {
+                number,
+                text: message.buttons !== undefined ? message.fallbackText : message.text,
+            });
+        },
+    };
+}
+//# sourceMappingURL=evolution_api.js.map

package/dist/src/channels/adapters/evolution_api.js.map

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

package/dist/src/channels/adapters/telegram.d.ts

@@ -0,0 +1,34 @@
+import { type ChannelFetch } from '../http.js';
+import type { ChannelAdapter } from '../types.js';
+export interface TelegramOptions {
+    /** The bot's token from @BotFather. */
+    botToken: string;
+    /**
+     * The `secret_token` given to `setWebhook`: Telegram sends it back as
+     * `X-Telegram-Bot-Api-Secret-Token` on every update, and a request without it is refused.
+     */
+    secretToken: string;
+    /** Format replies as MarkdownV2 (`true`, default) or send plain text (`false`). */
+    markdown?: boolean;
+    /** Answer in groups and supergroups too. Default `false`: private chats only. */
+    groups?: boolean;
+    /** The adapter's name — the dedupe prefix and the decision's `via`. Default `'telegram'`. */
+    name?: string;
+    /** Per-request timeout. Default 20 s. */
+    timeoutMs?: number;
+    /** Bot API origin. Default `https://api.telegram.org` (a self-hosted Bot API server goes here). */
+    apiUrl?: string;
+    fetch?: ChannelFetch;
+}
+/**
+ * A Telegram bot over the [Bot API](https://core.telegram.org/bots/api) webhook. Register it with
+ * `setWebhook({ url, secret_token, allowed_updates: ['message', 'callback_query'] })`.
+ *
+ * Reads text messages, media (photos, documents, voice notes, audio, video, stickers — downloaded
+ * with `getFile`, which serves up to 20 MB) and inline-keyboard presses (`callback_query`, answered with
+ * `answerCallbackQuery` and the keyboard removed so it cannot be pressed twice); ignores bots and
+ * (unless `groups`) group chats. Sends `sendMessage` in MarkdownV2 — when Telegram refuses the
+ * formatting, the same text goes again as plain text.
+ */
+export declare function telegram(options: TelegramOptions): ChannelAdapter;
+//# sourceMappingURL=telegram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../../../src/channels/adapters/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAQlB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AA4DD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAuIjE"}

package/dist/src/channels/adapters/telegram.js

@@ -0,0 +1,196 @@
+import { ChannelDeliveryError, ChannelMediaTooLargeError, fetchBytes, postJson, record, safeEqual, sizeOf, str, } from '../http.js';
+import { unescapeTelegramMarkdown } from '../markdown.js';
+/** Telegram's limits: message text, buttons we put in one keyboard. */
+const MAX_TEXT = 4096;
+const MAX_BUTTONS = 8;
+/** The file a message carries: the largest photo size, a document, a voice note, audio, video, a sticker. */
+function mediaOf(message) {
+    const photo = Array.isArray(message.photo) ? record(message.photo.at(-1)) : undefined;
+    const candidates = [
+        ['image', photo, 'image/jpeg'],
+        ['document', record(message.document), undefined],
+        ['audio', record(message.voice), 'audio/ogg'],
+        ['audio', record(message.audio), undefined],
+        ['video', record(message.video), 'video/mp4'],
+        ['video', record(message.video_note), 'video/mp4'],
+        [
+            'sticker',
+            record(message.sticker),
+            record(message.sticker)?.is_animated === true
+                ? 'application/x-tgsticker'
+                : record(message.sticker)?.is_video === true
+                    ? 'video/webm'
+                    : 'image/webp',
+        ],
+    ];
+    for (const [kind, body, implied] of candidates) {
+        const fileId = str(body?.file_id);
+        if (!body || fileId === undefined)
+            continue;
+        const contentType = str(body.mime_type) ?? implied;
+        const filename = str(body.file_name);
+        const sizeBytes = sizeOf(body.file_size);
+        return {
+            kind,
+            ref: fileId,
+            ...(contentType !== undefined ? { contentType } : {}),
+            ...(filename !== undefined ? { filename } : {}),
+            ...(sizeBytes !== undefined ? { sizeBytes } : {}),
+        };
+    }
+    return undefined;
+}
+/** The label of the inline button with `data` on the message it was pressed on. */
+function pressedLabel(message, data) {
+    const rows = record(message?.reply_markup)?.inline_keyboard;
+    if (!Array.isArray(rows))
+        return undefined;
+    for (const row of rows) {
+        if (!Array.isArray(row))
+            continue;
+        for (const button of row) {
+            if (record(button)?.callback_data === data)
+                return str(record(button)?.text);
+        }
+    }
+    return undefined;
+}
+/**
+ * A Telegram bot over the [Bot API](https://core.telegram.org/bots/api) webhook. Register it with
+ * `setWebhook({ url, secret_token, allowed_updates: ['message', 'callback_query'] })`.
+ *
+ * Reads text messages, media (photos, documents, voice notes, audio, video, stickers — downloaded
+ * with `getFile`, which serves up to 20 MB) and inline-keyboard presses (`callback_query`, answered with
+ * `answerCallbackQuery` and the keyboard removed so it cannot be pressed twice); ignores bots and
+ * (unless `groups`) group chats. Sends `sendMessage` in MarkdownV2 — when Telegram refuses the
+ * formatting, the same text goes again as plain text.
+ */
+export function telegram(options) {
+    const name = options.name ?? 'telegram';
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? 20_000;
+    const markdown = options.markdown !== false;
+    const origin = (options.apiUrl ?? 'https://api.telegram.org').replace(/\/+$/, '');
+    const api = `${origin}/bot${options.botToken}`;
+    const call = (method, body) => postJson(name, fetcher, `${api}/${method}`, {}, body, timeoutMs);
+    const privateOnly = (chat) => options.groups === true || chat?.type === 'private';
+    return {
+        name,
+        capabilities: {
+            buttons: MAX_BUTTONS,
+            markdown: markdown ? 'telegram' : 'none',
+            maxLength: MAX_TEXT,
+        },
+        verify(request) {
+            return safeEqual(request.header('x-telegram-bot-api-secret-token'), options.secretToken);
+        },
+        parse(body) {
+            const update = record(body);
+            const updateId = update?.update_id;
+            if (typeof updateId !== 'number' && typeof updateId !== 'string')
+                return null;
+            const id = String(updateId);
+            const message = record(update?.message);
+            if (message) {
+                const chat = record(message.chat);
+                const from = record(message.from);
+                const media = mediaOf(message);
+                const text = (str(message.text) ?? str(message.caption) ?? '').trim();
+                if (!chat || !from || from.is_bot === true || !privateOnly(chat))
+                    return null;
+                if (text === '' && !media)
+                    return null;
+                return {
+                    id,
+                    from: String(from.id),
+                    conversation: String(chat.id),
+                    text,
+                    ...(media ? { media: [media] } : {}),
+                    raw: update,
+                };
+            }
+            const query = record(update?.callback_query);
+            if (query) {
+                const from = record(query.from);
+                const pressedOn = record(query.message);
+                const chat = record(pressedOn?.chat);
+                const data = str(query.data);
+                if (!from || !chat || !data || from.is_bot === true || !privateOnly(chat))
+                    return null;
+                return {
+                    id,
+                    from: String(from.id),
+                    conversation: String(chat.id),
+                    text: pressedLabel(pressedOn, data) ?? data,
+                    buttonId: data,
+                    raw: update,
+                };
+            }
+            return null;
+        },
+        async acknowledge(message) {
+            const query = record(record(message.raw)?.callback_query);
+            const queryId = str(query?.id);
+            if (queryId === undefined)
+                return;
+            await call('answerCallbackQuery', { callback_query_id: queryId }).catch(() => { });
+            const pressedOn = record(query?.message);
+            if (pressedOn?.message_id !== undefined) {
+                await call('editMessageReplyMarkup', {
+                    chat_id: message.conversation,
+                    message_id: pressedOn.message_id,
+                    reply_markup: { inline_keyboard: [] },
+                }).catch(() => { });
+            }
+        },
+        async download(media, { maxBytes }) {
+            if (media.sizeBytes !== undefined && media.sizeBytes > maxBytes) {
+                throw new ChannelMediaTooLargeError(maxBytes);
+            }
+            const answer = record(await call('getFile', { file_id: media.ref }));
+            const path = str(record(answer?.result)?.file_path);
+            if (path === undefined) {
+                // The Bot API serves files up to 20 MB; a larger one has no path.
+                throw new ChannelDeliveryError(name, null, `${name}: the file could not be downloaded`);
+            }
+            const file = await fetchBytes(name, fetcher, `${origin}/file/bot${options.botToken}/${path}`, {}, timeoutMs, maxBytes);
+            return {
+                data: file.data,
+                contentType: media.contentType ?? file.contentType ?? 'application/octet-stream',
+                ...(media.filename !== undefined ? { filename: media.filename } : {}),
+            };
+        },
+        async send(conversation, message) {
+            const body = {
+                chat_id: conversation,
+                text: message.text,
+                link_preview_options: { is_disabled: true },
+                ...(message.buttons !== undefined && message.buttons.length > 0
+                    ? {
+                        reply_markup: {
+                            inline_keyboard: [
+                                message.buttons
+                                    .slice(0, MAX_BUTTONS)
+                                    .map((button) => ({ text: button.label, callback_data: button.id })),
+                            ],
+                        },
+                    }
+                    : {}),
+            };
+            if (!markdown) {
+                await call('sendMessage', body);
+                return;
+            }
+            try {
+                await call('sendMessage', { ...body, parse_mode: 'MarkdownV2' });
+            }
+            catch (error) {
+                // "can't parse entities": the same words, unformatted, beat no answer.
+                if (!(error instanceof ChannelDeliveryError) || error.status !== 400)
+                    throw error;
+                await call('sendMessage', { ...body, text: unescapeTelegramMarkdown(message.text) });
+            }
+        },
+    };
+}
+//# sourceMappingURL=telegram.js.map

package/dist/src/channels/adapters/telegram.js.map

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

package/dist/src/channels/adapters/whatsapp_cloud.d.ts

@@ -0,0 +1,31 @@
+import { type ChannelFetch } from '../http.js';
+import type { ChannelAdapter } from '../types.js';
+export interface WhatsappCloudOptions {
+    /** The business phone number's id (WhatsApp Manager → API setup) — not the number itself. */
+    phoneNumberId: string;
+    /** A system-user (or temporary) access token with `whatsapp_business_messaging`. */
+    accessToken: string;
+    /** The Meta app's secret: `X-Hub-Signature-256` is an HMAC of the raw body under it. */
+    appSecret: string;
+    /** The "Verify token" typed into the app's webhook settings, echoed by the subscription check. */
+    verifyToken: string;
+    /** Graph API version. Default `'v23.0'`. */
+    graphVersion?: string;
+    /** The adapter's name — the dedupe prefix and the decision's `via`. Default `'whatsapp'`. */
+    name?: string;
+    /** Per-request timeout. Default 20 s. */
+    timeoutMs?: number;
+    fetch?: ChannelFetch;
+}
+/**
+ * WhatsApp through Meta's [Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api).
+ * Route both `GET` (the subscription check) and `POST` (messages) to the same handler, and subscribe
+ * the app to the `messages` field.
+ *
+ * Verifies `X-Hub-Signature-256` over the raw body; reads text, interactive button/list replies,
+ * template quick replies and media (image, audio, video, document, sticker — downloaded through the
+ * Graph API media endpoint) addressed to `phoneNumberId` (status updates are ignored); sends text and
+ * interactive reply buttons (at most 3, 20-character titles).
+ */
+export declare function whatsappCloud(options: WhatsappCloudOptions): ChannelAdapter;
+//# sourceMappingURL=whatsapp_cloud.d.ts.map

package/dist/src/channels/adapters/whatsapp_cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp_cloud.d.ts","sourceRoot":"","sources":["../../../../src/channels/adapters/whatsapp_cloud.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EASlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,6FAA6F;IAC7F,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAmI3E"}