@adriangalilea/utils 0.11.0 → 0.13.0

package/dist/bot/llm-stream.d.ts

@@ -1,86 +0,0 @@
-/**
- * LLM streaming output for GramIO bots.
- *
- * Sends a placeholder, then debounces `editMessageText` calls as the
- * LLM produces chunks. Markdown is parsed locally with
- * `markdownToFormattable` — invalid markup degrades to plain text
- * instead of failing (Telegram's `parse_mode` would reject the whole
- * message). Splits at 4000 chars by promoting the next chunk to a
- * fresh message at a paragraph/line/word boundary.
- *
- * Peer deps: `gramio`, `@gramio/format`, `marked`.
- *
- * @example
- * import { Bot } from 'gramio'
- * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
- * import Anthropic from '@anthropic-ai/sdk'
- *
- * const claude = new Anthropic()
- * const bot = new Bot(process.env.BOT_TOKEN!)
- *   .extend(llmStream())
- *   .on('message', async (ctx) => {
- *     const stream = ctx.startStream()
- *     const sse = await claude.messages.stream({
- *       model: 'claude-opus-4-5',
- *       max_tokens: 1024,
- *       messages: [{ role: 'user', content: ctx.text ?? '' }],
- *     })
- *     for await (const chunk of sse) {
- *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
- *         await stream.append(chunk.delta.text)
- *       }
- *     }
- *     await stream.end()
- *   })
- *
- * bot.start()
- */
-import { Plugin } from 'gramio';
-export type StreamOptions = {
-    /** Debounce window between edits, in ms. Default 800. */
-    debounceMs?: number;
-    /** Initial placeholder shown until the first chunk arrives. Default "…". */
-    placeholder?: string;
-    /** Parse buffer as markdown. Default true. Set false for plain text streaming. */
-    markdown?: boolean;
-    /** Called on edit/send errors after internal recovery (rate limits, etc.). */
-    onError?: (err: unknown) => void;
-};
-export declare class MarkdownStreamer {
-    private buffer;
-    private currentMessageId?;
-    private firstSendPromise?;
-    private debounceTimer?;
-    private inFlight;
-    private dirty;
-    private ended;
-    private chatId;
-    private threadId?;
-    private bot;
-    private opts;
-    constructor(ctx: {
-        chat: {
-            id: number;
-        };
-        threadId?: number;
-        bot: MarkdownStreamer['bot'];
-    }, opts: StreamOptions);
-    /** Append a chunk. Schedules a debounced edit. */
-    append(text: string): Promise<void>;
-    /** Flush any pending edit and close the stream. Idempotent. */
-    end(): Promise<void>;
-    private scheduleFlush;
-    private flushNow;
-}
-/**
- * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
- *
- * Defaults set here apply to every stream; per-call options in
- * `ctx.startStream({...})` override them.
- */
-export declare const llmStream: (defaults?: StreamOptions) => Plugin<{}, import("gramio").DeriveDefinitions & {
-    message: {
-        startStream: (opts?: StreamOptions) => MarkdownStreamer;
-    };
-}, {}>;
-//# sourceMappingURL=llm-stream.d.ts.map

package/dist/bot/llm-stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm-stream.d.ts","sourceRoot":"","sources":["../../src/bot/llm-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAC,CAAQ;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAe;IACxC,OAAO,CAAC,aAAa,CAAC,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAQ;IAErB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IAIzB,OAAO,CAAC,GAAG,CAaV;IACD,OAAO,CAAC,IAAI,CAAyB;gBAGnC,GAAG,EAAE;QACH,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;KAC7B,EACD,IAAI,EAAE,aAAa;IAgBrB,kDAAkD;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CzC,+DAA+D;IACzD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,OAAO,CAAC,aAAa;YAaP,QAAQ;CAmCvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,WAAU,aAAkB;;6BAI9B,aAAa;;MAEhC,CAAA"}

package/dist/bot/llm-stream.js

@@ -1,207 +0,0 @@
-/**
- * LLM streaming output for GramIO bots.
- *
- * Sends a placeholder, then debounces `editMessageText` calls as the
- * LLM produces chunks. Markdown is parsed locally with
- * `markdownToFormattable` — invalid markup degrades to plain text
- * instead of failing (Telegram's `parse_mode` would reject the whole
- * message). Splits at 4000 chars by promoting the next chunk to a
- * fresh message at a paragraph/line/word boundary.
- *
- * Peer deps: `gramio`, `@gramio/format`, `marked`.
- *
- * @example
- * import { Bot } from 'gramio'
- * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
- * import Anthropic from '@anthropic-ai/sdk'
- *
- * const claude = new Anthropic()
- * const bot = new Bot(process.env.BOT_TOKEN!)
- *   .extend(llmStream())
- *   .on('message', async (ctx) => {
- *     const stream = ctx.startStream()
- *     const sse = await claude.messages.stream({
- *       model: 'claude-opus-4-5',
- *       max_tokens: 1024,
- *       messages: [{ role: 'user', content: ctx.text ?? '' }],
- *     })
- *     for await (const chunk of sse) {
- *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
- *         await stream.append(chunk.delta.text)
- *       }
- *     }
- *     await stream.end()
- *   })
- *
- * bot.start()
- */
-import { Plugin } from 'gramio';
-import { markdownToFormattable } from '@gramio/format/markdown';
-const MAX_LEN = 4000; // Telegram caps at 4096; leave headroom for entity offsets
-const DEFAULT_DEBOUNCE_MS = 800;
-export class MarkdownStreamer {
-    buffer = '';
-    currentMessageId;
-    firstSendPromise;
-    debounceTimer;
-    inFlight = false;
-    dirty = false;
-    ended = false;
-    chatId;
-    threadId;
-    // Match gramio's `bot.api` shape structurally. `text` accepts string or any
-    // `Formattable` (from `@gramio/format`) — both stringify safely. We don't
-    // import gramio's full Bot type to keep the streamer testable in isolation.
-    bot;
-    opts;
-    constructor(ctx, opts) {
-        this.chatId = ctx.chat.id;
-        // Captured so the streamed reply stays in the same thread.
-        // We call bot.api.sendMessage directly (no ctx.send), so the
-        // SendMixin's auto-thread doesn't help us here.
-        this.threadId = ctx.threadId;
-        this.bot = ctx.bot;
-        this.opts = {
-            debounceMs: opts.debounceMs ?? DEFAULT_DEBOUNCE_MS,
-            placeholder: opts.placeholder ?? '…',
-            markdown: opts.markdown ?? true,
-            onError: opts.onError ?? ((e) => console.error('[llm-stream]', e)),
-        };
-    }
-    /** Append a chunk. Schedules a debounced edit. */
-    async append(text) {
-        if (this.ended)
-            throw new Error('stream already ended');
-        if (!text)
-            return;
-        // first chunk: send the placeholder so we have a message_id to edit.
-        // Serialized via firstSendPromise so concurrent appends don't double-send.
-        if (this.currentMessageId === undefined && !this.firstSendPromise) {
-            this.firstSendPromise = (async () => {
-                const sent = await this.bot.api.sendMessage({
-                    chat_id: this.chatId,
-                    ...(this.threadId !== undefined && { message_thread_id: this.threadId }),
-                    text: this.opts.placeholder,
-                });
-                this.currentMessageId = sent.message_id;
-            })();
-        }
-        if (this.firstSendPromise)
-            await this.firstSendPromise;
-        // overflow: freeze current message at last good split, start a new one.
-        const next = this.buffer + text;
-        if (next.length > MAX_LEN) {
-            const splitAt = findSplit(next, MAX_LEN);
-            const head = next.slice(0, splitAt);
-            const tail = next.slice(splitAt).trimStart();
-            this.buffer = head;
-            this.dirty = true;
-            await this.flushNow(); // commits head into current message
-            this.buffer = '';
-            this.currentMessageId = undefined;
-            this.firstSendPromise = undefined;
-            this.dirty = false;
-            if (this.debounceTimer) {
-                clearTimeout(this.debounceTimer);
-                this.debounceTimer = undefined;
-            }
-            if (tail)
-                await this.append(tail);
-            return;
-        }
-        this.buffer = next;
-        this.dirty = true;
-        this.scheduleFlush();
-    }
-    /** Flush any pending edit and close the stream. Idempotent. */
-    async end() {
-        if (this.ended)
-            return;
-        this.ended = true;
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-            this.debounceTimer = undefined;
-        }
-        while (this.inFlight)
-            await sleep(50);
-        if (this.dirty)
-            await this.flushNow();
-    }
-    scheduleFlush() {
-        if (this.debounceTimer)
-            return;
-        this.debounceTimer = setTimeout(async () => {
-            this.debounceTimer = undefined;
-            if (this.inFlight) {
-                this.scheduleFlush();
-                return;
-            }
-            await this.flushNow();
-            if (this.dirty && !this.ended)
-                this.scheduleFlush();
-        }, this.opts.debounceMs);
-    }
-    async flushNow() {
-        if (!this.dirty)
-            return;
-        if (this.currentMessageId === undefined) {
-            // No active message yet — likely the first send is still in flight
-            // or the recovery path cleared it. Caller's next append() will
-            // re-create one.
-            return;
-        }
-        this.inFlight = true;
-        this.dirty = false;
-        const snapshot = this.buffer;
-        try {
-            const payload = this.opts.markdown ? markdownToFormattable(snapshot) : snapshot;
-            await this.bot.api.editMessageText({
-                chat_id: this.chatId,
-                message_id: this.currentMessageId,
-                text: payload,
-            });
-        }
-        catch (e) {
-            const msg = String(e?.message ?? e);
-            if (msg.includes('message is not modified')) {
-                // identical content — fine
-            }
-            else if (msg.includes('message to edit not found')) {
-                // message gone (deleted by user, etc.) — restart with a fresh send
-                this.currentMessageId = undefined;
-                this.firstSendPromise = undefined;
-                this.dirty = true;
-            }
-            else {
-                this.dirty = true;
-                this.opts.onError(e);
-            }
-        }
-        finally {
-            this.inFlight = false;
-        }
-    }
-}
-/**
- * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
- *
- * Defaults set here apply to every stream; per-call options in
- * `ctx.startStream({...})` override them.
- */
-export const llmStream = (defaults = {}) => new Plugin('@adriangalilea/utils/bot/llm-stream').derive('message', (ctx) => ({
-    // gramio's `message` scope guarantees `ctx.chat`. `ctx.bot.api` is on
-    // every Context. Structural compat → no cast needed.
-    startStream: (opts = {}) => new MarkdownStreamer(ctx, { ...defaults, ...opts }),
-}));
-function findSplit(text, maxLen) {
-    // Prefer paragraph break, then line, then space. Reject splits in the
-    // first half — better to truncate at maxLen than to leave a stub.
-    for (const sep of ['\n\n', '\n', ' ']) {
-        const idx = text.lastIndexOf(sep, maxLen);
-        if (idx > maxLen / 2)
-            return idx;
-    }
-    return maxLen;
-}
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-//# sourceMappingURL=llm-stream.js.map

package/dist/bot/llm-stream.js.map

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

package/dist/bot/message-history.d.ts

@@ -1,279 +0,0 @@
-/**
- * Per-user rolling message history for GramIO bots — opt-in, with
- * retention, **sharded by thread**.
- *
- * Each user has one session record. Inside that record, `history` keeps
- * a separate ring buffer per thread:
- *
- *     storage[userId].history.shards = {
- *       'general':   [ ...entries from no-thread messages ],
- *       '12345':     [ ...entries from message_thread_id=12345 ],
- *       '98765':     [ ...entries from message_thread_id=98765 ],
- *     }
- *
- * This makes the plugin compatible with both forum-supergroup topics
- * and BotFather's Threaded Mode for private chats (which is the whole
- * point of those features: parallel conversations with separate
- * context). `ctx.history` returns ONLY the slice for the current
- * thread; `ctx.allHistory` returns the full sharded map when you need
- * a cross-thread view (e.g. for `/export`).
- *
- * Thread key: `String(ctx.threadId)`, or `'general'` when no thread.
- *
- * ## What this plugin owns
- *
- *   - Appends each incoming user message to the shard for its thread
- *   - Prunes per-shard by `retentionDays` and `maxMessages`
- *   - Exposes `ctx.history` (current thread's pruned slice) and
- *     `ctx.allHistory` (full map) to handlers
- *
- * ## GDPR caveat — retention IS personal data
- *
- * Unlike `bot/language` (preference data, covered by Telegram's standard
- * privacy policy), retaining user **message content** is the one thing
- * the [standard policy](https://telegram.org/privacy-tpa) does NOT cover
- * by default. If you extend `messageHistory`, you should:
- *
- *   1. Set a custom `privacy` URL on your `botMenu` describing what you
- *      retain and for how long.
- *   2. Pass `personalData: { storage }` to your `botMenu` so 🗑 Forget
- *      and 📥 Export buttons appear — letting users see and delete
- *      the data you keep about them.
- *
- * These are not enforced by this plugin (would couple it to menu); they
- * are documented as the bot author's legal responsibility.
- *
- * Peer deps: `gramio`, `@gramio/session`.
- *
- * @example
- * import { Bot } from 'gramio'
- * import { session } from '@gramio/session'
- * import { redisStorage } from '@gramio/storage-redis'
- * import { messageHistory } from '@adriangalilea/utils/bot/message-history'
- *
- * const userSession = session({ storage: redisStorage(), key: 'session', initial: () => ({}) })
- *
- * const history = messageHistory({
- *   session: userSession,
- *   maxMessages: 100,         // cap per-thread
- *   retentionDays: 7,
- * })
- *
- * const bot = new Bot(process.env.BOT_TOKEN!)
- *   .extend(userSession)
- *   .extend(history.plugin)
- *   .command('replay', (ctx) => {
- *     const last = ctx.history.slice(-3).map((e) => e.text).join('\n---\n')
- *     return ctx.send(last || '(no history in this thread)')
- *   })
- */
-import { type DeriveDefinitions, Plugin } from 'gramio';
-import { session } from '@gramio/session';
-export type HistoryEntry = {
-    /** Telegram message id. */
-    messageId: number;
-    /** Unix seconds (Telegram's `message.date`). */
-    date: number;
-    /** Message text, or empty string if non-text. */
-    text: string;
-};
-/**
- * Per-thread shards. Key is `String(ctx.threadId)` or `'general'`
- * when no thread. Each shard is an independently capped + pruned
- * ring buffer.
- */
-export type HistoryRecord = {
-    shards: {
-        [threadKey: string]: HistoryEntry[];
-    };
-};
-/** Loose session shape — this plugin only touches the `history` field. */
-type SessionLike = {
-    history?: HistoryRecord;
-};
-/** @internal — kept unexported so it doesn't clash with peers' refs. */
-type HistorySessionPluginRef = ReturnType<typeof session<SessionLike, 'session'>>;
-export type MessageHistoryOptions = {
-    /**
-     * Shared session plugin. This plugin extends it for the type flow;
-     * gramio's runtime dedup ensures it only runs once per update.
-     */
-    session: HistorySessionPluginRef;
-    /** Ring buffer cap **per thread**. Oldest entries dropped when exceeded. */
-    maxMessages: number;
-    /** Entries older than this (in days) are dropped on read. */
-    retentionDays: number;
-};
-export type MessageHistoryFeature = {
-    plugin: ReturnType<typeof buildHistoryPlugin>;
-};
-type HistoryDerives = {
-    /** Pruned snapshot for the CURRENT thread only. */
-    history: ReadonlyArray<HistoryEntry>;
-    /**
-     * Pruned snapshot of all threads, keyed by thread (`'general'` or
-     * stringified threadId). Use for cross-thread views (e.g. /export).
-     */
-    allHistory: Readonly<{
-        [threadKey: string]: ReadonlyArray<HistoryEntry>;
-    }>;
-};
-export declare const messageHistory: (opts: MessageHistoryOptions) => MessageHistoryFeature;
-declare const buildHistoryPlugin: (args: {
-    sessionPlugin: HistorySessionPluginRef;
-    maxMessages: number;
-    retentionDays: number;
-}) => Plugin<{}, DeriveDefinitions & {
-    global: HistoryDerives;
-} & {
-    message: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    channel_post: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    inline_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chosen_inline_result: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    callback_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    shipping_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    pre_checkout_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    poll_answer: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chat_join_request: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_members: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_title: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_photo: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    delete_chat_photo: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    group_chat_created: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    message_auto_delete_timer_changed: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    migrate_to_chat_id: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    migrate_from_chat_id: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    pinned_message: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    invoice: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    successful_payment: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chat_shared: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    proximity_alert_triggered: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_scheduled: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_started: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_ended: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_participants_invited: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    web_app_data: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    location: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    passport_data: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-} & {
-    message: HistoryDerives;
-    callback_query: HistoryDerives;
-}, {}>;
-export {};
-//# sourceMappingURL=message-history.d.ts.map

package/dist/bot/message-history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-history.d.ts","sourceRoot":"","sources":["../../src/bot/message-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAIzC,MAAM,MAAM,YAAY,GAAG;IACzB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;KAAE,CAAA;CAChD,CAAA;AAaD,0EAA0E;AAC1E,KAAK,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAAA;AAE9C,wEAAwE;AACxE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;AAEjF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,OAAO,EAAE,uBAAuB,CAAA;IAChC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAC9C,CAAA;AAID,KAAK,cAAc,GAAG;IACpB,mDAAmD;IACnD,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IACpC;;;OAGG;IACH,UAAU,EAAE,QAAQ,CAAC;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAA;CAC3E,CAAA;AA6BD,eAAO,MAAM,cAAc,GAAI,MAAM,qBAAqB,KAAG,qBAW5D,CAAA;AAID,QAAA,MAAM,kBAAkB,GAAI,MAAM;IAChC,aAAa,EAAE,uBAAuB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;YAGqD,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqCnE,CAAA"}