@withbuddi/buddi 0.1.0-pre.26 → 0.1.0-pre.28

package/node_modules/@buddi/tool-email/dist/sources/idle.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Mail almost instantly: one IMAP IDLE connection per mailbox, on INBOX.
+ *
+ * The poll (`inbox-poll.ts`) reads what changed; this file only learns *that*
+ * something changed, and asks for that account's poll right away. So nothing
+ * here touches a cursor, a row or a flag, and everything the poll guarantees
+ * (the quad, the transaction, the dedup key) holds for a poll IDLE started.
+ *
+ *  - **Its own connection.** Never the poll's reader and never the write
+ *    port's, so a mailbox action (a MOVE, a STORE) cannot break IDLE, and an
+ *    IDLE that dies costs the poll nothing. INBOX only, opened read-only;
+ *    Sent stays on the poll.
+ *  - **Coalesced.** A burst of EXISTS/EXPUNGE/FLAGS starts one timer
+ *    (`IDLE_DEBOUNCE_MS`, 2s) and the poll runs when it fires. The source
+ *    never runs two polls of one account at once; a change that lands during
+ *    a poll asks for one more after it (`inbox-poll.ts`, `runLocked`).
+ *  - **Re-issued.** imapflow breaks and re-issues IDLE every
+ *    `IDLE_RESTART_MS` (10 min), inside the 29 minutes a server may allow.
+ *  - **Reconnected with backoff.** A drop or a failed connect waits 5s, then
+ *    10s, 20s … up to 5 minutes; a session that stayed up a minute resets it.
+ *    After a reconnect the poll runs once, for whatever arrived meanwhile.
+ *  - **Quiet when it cannot.** A server without IDLE is said once and left to
+ *    the poll. A refused login records the same `login_failed_at` the poll
+ *    does ("Password needed") and is not retried until the password changes
+ *    (Set password, or a poll whose login works again).
+ *  - **Stopped cleanly.** Plugin taken out, buddi stopping, account removed or
+ *    turned off: the socket is closed and every timer cleared.
+ *
+ * While IDLE is live the poll slows to `IDLE_SLOW_POLL_SECONDS` for that
+ * account (the safety net); while it is not, the poll keeps its normal period.
+ */
+import type { BuddiHost } from '@buddi/core/plugin';
+import { type EnvLike } from '../config.js';
+import type { ImapIdleFactory } from '../ports.js';
+/** How long a burst of IDLE changes is gathered before the poll runs. */
+export declare const IDLE_DEBOUNCE_MS = 2000;
+/** First reconnect delay; doubled per failure up to `IDLE_BACKOFF_MAX_MS`. */
+export declare const IDLE_BACKOFF_FIRST_MS = 5000;
+export declare const IDLE_BACKOFF_MAX_MS: number;
+/** A session that lived this long counts as healthy: the backoff starts over. */
+export declare const IDLE_STABLE_MS = 60000;
+/** The poll's period for an account whose IDLE is live: the safety net. */
+export declare const IDLE_SLOW_POLL_SECONDS: number;
+export type IdleState = 
+/** Opening the connection. */
+'connecting'
+/** Idling: the server tells us. */
+ | 'live'
+/** Dropped or could not connect; waiting to try again. */
+ | 'retrying'
+/** The server has no IDLE. The poll does it all. */
+ | 'unsupported'
+/** The server refused the password. Waits for a new one. */
+ | 'refused'
+/** No password could be read. Waits for the account to change. */
+ | 'no-password' | 'stopped';
+export interface AccountChange {
+    /** The account that changed; absent when a mailbox was added or removed. */
+    accountId?: string;
+    /** Its password was replaced: reconnect with the new one. */
+    password?: boolean;
+}
+/** Said by the page tools after add, remove and Set password. */
+export declare function accountChanged(change?: AccountChange): void;
+/** Whether this process has a live IDLE on this account's INBOX right now. */
+export declare function idleLive(accountId: string): boolean;
+export interface IdleWatchersOptions {
+    idle: ImapIdleFactory;
+    host: BuddiHost;
+    /** Ask for this account's poll now. The source serialises it. */
+    poll: (accountId: string) => Promise<void>;
+    /** Passwords by name instead of the owner's secrets (tests). */
+    env?: EnvLike;
+    debounceMs?: number;
+    backoffFirstMs?: number;
+    backoffMaxMs?: number;
+    stableMs?: number;
+}
+/** Every enabled account's watcher, kept in step with `email.accounts`. */
+export declare class IdleWatchers {
+    #private;
+    constructor(opts: IdleWatchersOptions);
+    state(accountId: string): IdleState | null;
+    /** Start, stop or restart watchers so they match the enabled accounts. Serialised. */
+    reconcile(): Promise<void>;
+    /** The password changed: drop the connection and open one with the new one. */
+    restart(accountId: string): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=idle.d.ts.map

package/node_modules/@buddi/tool-email/dist/sources/idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../src/sources/idle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,KAAK,EAAiB,eAAe,EAAmB,MAAM,aAAa,CAAC;AAEnF,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,iFAAiF;AACjF,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,QAAU,CAAC;AAE9C,MAAM,MAAM,SAAS;AACnB,8BAA8B;AAC5B,YAAY;AACd,mCAAmC;GACjC,MAAM;AACR,0DAA0D;GACxD,UAAU;AACZ,oDAAoD;GAClD,aAAa;AACf,4DAA4D;GAC1D,SAAS;AACX,kEAAkE;GAChE,aAAa,GACb,SAAS,CAAC;AAMd,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAAkB,GAAG,IAAI,CAQ/D;AAQD,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGnD;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,iEAAiE;IACjE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,qBAAa,YAAY;;gBAOX,IAAI,EAAE,mBAAmB;IAWrC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,sFAAsF;IACtF,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC1B,+EAA+E;IACzE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAS5B"}

package/node_modules/@buddi/tool-email/dist/sources/idle.js

@@ -0,0 +1,250 @@
+import { listAccounts } from '../config.js';
+import { mailboxAuth } from '../credentials.js';
+import { isAuthFailure, recordLoginFailure } from '../logins.js';
+/** How long a burst of IDLE changes is gathered before the poll runs. */
+export const IDLE_DEBOUNCE_MS = 2_000;
+/** First reconnect delay; doubled per failure up to `IDLE_BACKOFF_MAX_MS`. */
+export const IDLE_BACKOFF_FIRST_MS = 5_000;
+export const IDLE_BACKOFF_MAX_MS = 5 * 60_000;
+/** A session that lived this long counts as healthy: the backoff starts over. */
+export const IDLE_STABLE_MS = 60_000;
+/** The poll's period for an account whose IDLE is live: the safety net. */
+export const IDLE_SLOW_POLL_SECONDS = 15 * 60;
+const changeListeners = new Set();
+/** Said by the page tools after add, remove and Set password. */
+export function accountChanged(change = {}) {
+    for (const listener of changeListeners) {
+        try {
+            listener(change);
+        }
+        catch {
+            // A watcher's trouble is its own; the tool that changed the row is done.
+        }
+    }
+}
+/* ------------------------------------------------------------------------ */
+/* What the page reads.                                                      */
+/* ------------------------------------------------------------------------ */
+const managers = new Set();
+/** Whether this process has a live IDLE on this account's INBOX right now. */
+export function idleLive(accountId) {
+    for (const manager of managers)
+        if (manager.state(accountId) === 'live')
+            return true;
+    return false;
+}
+/** Every enabled account's watcher, kept in step with `email.accounts`. */
+export class IdleWatchers {
+    #opts;
+    #watchers = new Map();
+    #unlisten;
+    #stopped = false;
+    #reconciling = Promise.resolve();
+    constructor(opts) {
+        this.#opts = opts;
+        managers.add(this);
+        const listener = (change) => {
+            const done = change.password && change.accountId ? this.restart(change.accountId) : this.reconcile();
+            done.catch((err) => this.#opts.host.log(`email.idle: ${err instanceof Error ? err.message : String(err)}`));
+        };
+        changeListeners.add(listener);
+        this.#unlisten = () => changeListeners.delete(listener);
+    }
+    state(accountId) {
+        return this.#watchers.get(accountId)?.state ?? null;
+    }
+    /** Start, stop or restart watchers so they match the enabled accounts. Serialised. */
+    reconcile() {
+        const next = this.#reconciling.then(() => this.#reconcile()).catch((err) => {
+            this.#opts.host.log(`email.idle: ${err instanceof Error ? err.message : String(err)}`);
+        });
+        this.#reconciling = next;
+        return next;
+    }
+    async #reconcile() {
+        if (this.#stopped)
+            return;
+        const accounts = await listAccounts(this.#opts.host.db);
+        if (this.#stopped)
+            return;
+        const byId = new Map(accounts.map((a) => [a.id, a]));
+        for (const [id, watcher] of [...this.#watchers]) {
+            const account = byId.get(id);
+            const moved = account !== undefined &&
+                (account.imapHost !== watcher.account.imapHost || account.imapPort !== watcher.account.imapPort ||
+                    account.address !== watcher.account.address || account.secretName !== watcher.account.secretName);
+            // A refusal is over once a login works again (the poll or Set password
+            // cleared `login_failed_at`).
+            const unrefused = account !== undefined && watcher.state === 'refused' && !account.loginFailedAt;
+            // A password that could not be read may be readable now.
+            const unread = watcher.state === 'no-password';
+            if (account === undefined || moved || unrefused || unread) {
+                this.#watchers.delete(id);
+                await watcher.stop();
+            }
+            else {
+                watcher.account = account;
+            }
+        }
+        for (const account of accounts) {
+            if (this.#stopped || this.#watchers.has(account.id))
+                continue;
+            // A row whose password the provider refused waits for a new one.
+            if (account.loginFailedAt)
+                continue;
+            const watcher = new AccountWatcher(account, this.#opts);
+            this.#watchers.set(account.id, watcher);
+            watcher.start();
+        }
+    }
+    /** The password changed: drop the connection and open one with the new one. */
+    async restart(accountId) {
+        const watcher = this.#watchers.get(accountId);
+        if (watcher) {
+            this.#watchers.delete(accountId);
+            await watcher.stop();
+        }
+        await this.reconcile();
+    }
+    async stop() {
+        this.#stopped = true;
+        this.#unlisten();
+        managers.delete(this);
+        await this.#reconciling;
+        const all = [...this.#watchers.values()];
+        this.#watchers.clear();
+        await Promise.all(all.map((w) => w.stop()));
+    }
+}
+/** One account's IDLE connection, its reconnects and its debounce. */
+class AccountWatcher {
+    account;
+    opts;
+    state = 'connecting';
+    #session = null;
+    #connecting = null;
+    #retryTimer = null;
+    #debounceTimer = null;
+    #attempt = 0;
+    #stopped = false;
+    constructor(account, opts) {
+        this.account = account;
+        this.opts = opts;
+    }
+    start() {
+        this.#launch(false);
+    }
+    /** Connect, never leaving a rejection unhandled: an unexpected error (a database read, the vault) retries with backoff. */
+    #launch(reconnect) {
+        this.#connecting = this.#connect(reconnect)
+            .catch((err) => {
+            if (!this.#stopped)
+                this.#retry(err);
+        })
+            .finally(() => {
+            this.#connecting = null;
+        });
+    }
+    #log(line) {
+        this.opts.host.log(`email.idle: ${this.account.address}: ${line}`);
+    }
+    async #connect(reconnect) {
+        if (this.#stopped)
+            return;
+        this.state = 'connecting';
+        const auth = await mailboxAuth({ buddi: this.opts.host }, this.account, this.opts.env);
+        if (this.#stopped)
+            return;
+        if (!auth.ok) {
+            this.state = 'no-password';
+            this.#log(`no IDLE: ${auth.problem.message}; checking on the poll`);
+            return;
+        }
+        let session;
+        try {
+            session = await this.opts.idle(this.account, auth.value, () => this.#changed());
+        }
+        catch (err) {
+            if (this.#stopped)
+                return;
+            if (isAuthFailure(err)) {
+                this.state = 'refused';
+                await recordLoginFailure(this.opts.host.db, this.account.id, err, this.opts.host.clock.now()).catch(() => { });
+                this.#log('refused its stored password; IDLE waits for a new one (Settings → Email → Set password)');
+                return;
+            }
+            this.#retry(err);
+            return;
+        }
+        if (session === 'unsupported') {
+            this.state = 'unsupported';
+            this.#log('the server has no IDLE; checking on the poll');
+            return;
+        }
+        if (this.#stopped) {
+            await session.close().catch(() => { });
+            return;
+        }
+        this.#session = session;
+        this.state = 'live';
+        const since = Date.now();
+        this.#log(reconnect ? 'IDLE is back' : 'IDLE on INBOX');
+        // Mail that arrived while the connection was down is the poll's to find.
+        if (reconnect)
+            this.#changed();
+        void session.ended.then(({ error }) => {
+            if (this.#session !== session)
+                return;
+            this.#session = null;
+            if (this.#stopped)
+                return;
+            if (Date.now() - since >= (this.opts.stableMs ?? IDLE_STABLE_MS))
+                this.#attempt = 0;
+            this.#retry(error ?? new Error('the server closed the connection'));
+        });
+    }
+    #retry(err) {
+        if (this.#stopped)
+            return;
+        this.state = 'retrying';
+        const first = this.opts.backoffFirstMs ?? IDLE_BACKOFF_FIRST_MS;
+        const max = this.opts.backoffMaxMs ?? IDLE_BACKOFF_MAX_MS;
+        const delay = Math.min(max, first * 2 ** Math.min(this.#attempt, 20));
+        this.#attempt += 1;
+        this.#log(`IDLE dropped (${err instanceof Error ? err.message : String(err)}); trying again in ${Math.round(delay / 1000)}s`);
+        this.#retryTimer = setTimeout(() => {
+            this.#retryTimer = null;
+            this.#launch(true);
+        }, delay);
+        this.#retryTimer.unref?.();
+    }
+    /** Something changed on INBOX: one poll, at most `debounceMs` from the first change. */
+    #changed() {
+        if (this.#stopped || this.#debounceTimer)
+            return;
+        this.#debounceTimer = setTimeout(() => {
+            this.#debounceTimer = null;
+            if (this.#stopped)
+                return;
+            this.opts.poll(this.account.id).catch((err) => {
+                this.#log(`poll after IDLE failed: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        }, this.opts.debounceMs ?? IDLE_DEBOUNCE_MS);
+        this.#debounceTimer.unref?.();
+    }
+    async stop() {
+        this.#stopped = true;
+        this.state = 'stopped';
+        if (this.#retryTimer)
+            clearTimeout(this.#retryTimer);
+        if (this.#debounceTimer)
+            clearTimeout(this.#debounceTimer);
+        this.#retryTimer = null;
+        this.#debounceTimer = null;
+        await this.#connecting?.catch(() => { });
+        const session = this.#session;
+        this.#session = null;
+        await session?.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=idle.js.map

package/node_modules/@buddi/tool-email/dist/sources/idle.js.map

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

package/node_modules/@buddi/tool-email/dist/sources/inbox-poll.d.ts

@@ -1,5 +1,6 @@
 import { type EnvLike } from '../config.js';
-import type { ImapClientFactory } from '../ports.js';
+import type { ImapClientFactory, ImapIdleFactory } from '../ports.js';
+import { type IdleWatchersOptions } from './idle.js';
 import type { Source } from '../types.js';
 /** The agent every new message is triaged by. */
 export declare const TRIAGE_AGENT_ID = "mail-triage";
@@ -58,6 +59,16 @@ export interface InboxPollOptions {
     timeoutMs?: number;
     /** Newest-N to bring along on first contact. Overrides `EMAIL_BACKFILL`. */
     backfill?: number;
+    /**
+     * How IDLE connections are made. With one, the source has a `watch` that
+     * keeps one IDLE connection per enabled account on INBOX (`idle.ts`);
+     * without one (tests, one-shot callers) it only polls.
+     */
+    idle?: ImapIdleFactory;
+    /** Debounce and backoff, for tests. */
+    idleTuning?: Pick<IdleWatchersOptions, 'debounceMs' | 'backoffFirstMs' | 'backoffMaxMs' | 'stableMs'>;
+    /** The poll period, in seconds, for an account whose IDLE is live. Default 15 minutes. */
+    slowPollSeconds?: number;
 }
 /**
  * Build the source. The IMAP factory is a parameter, not a default, so the

package/node_modules/@buddi/tool-email/dist/sources/inbox-poll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-poll.d.ts","sourceRoot":"","sources":["../../src/sources/inbox-poll.ts"],"names":[],"mappings":"AAkDA,OAAO,EAA0C,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAQpF,OAAO,KAAK,EAA6B,iBAAiB,EAAiB,MAAM,aAAa,CAAC;AAI/F,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAKzD,iDAAiD;AACjD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,sFAAsF;AACtF,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,6EAA6E;AAC7E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAE7C,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM;IAHrB,SAAkB,IAAI,sBAAsB;gBAEjC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM;CAItB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC/B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAUD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA8TD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAkLpE;AAmdD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,KAAK,CAAC"}
+{"version":3,"file":"inbox-poll.d.ts","sourceRoot":"","sources":["../../src/sources/inbox-poll.ts"],"names":[],"mappings":"AAkDA,OAAO,EAAuD,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAUjG,OAAO,KAAK,EAA6B,iBAAiB,EAAE,eAAe,EAAiB,MAAM,aAAa,CAAC;AAChH,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAI3F,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAMzD,iDAAiD;AACjD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,sFAAsF;AACtF,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,6EAA6E;AAC7E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAE7C,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM;IAHrB,SAAkB,IAAI,sBAAsB;gBAEjC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM;CAItB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC/B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAUD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,uCAAuC;IACvC,UAAU,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,UAAU,CAAC,CAAC;IACtG,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA+TD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAwTpE;AAoeD,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,KAAK,CAAC"}