oc-codex-multi-auth 6.14.4 → 6.16.0

package/dist/lib/desktop-notifications.d.ts

@@ -0,0 +1,14 @@
+type NotificationCallback = (error: Error | null) => void;
+type ExecuteFile = (file: string, args: string[], options: {
+    timeout: number;
+    windowsHide: boolean;
+}, callback: NotificationCallback) => unknown;
+export type DesktopNotifier = (title: string, message: string) => Promise<boolean>;
+export declare function isDesktopNotificationSupported(platform?: NodeJS.Platform): boolean;
+export declare function createDesktopNotifier(options?: {
+    platform?: NodeJS.Platform;
+    executeFile?: ExecuteFile;
+}): DesktopNotifier;
+export declare const sendDesktopNotification: DesktopNotifier;
+export {};
+//# sourceMappingURL=desktop-notifications.d.ts.map

package/dist/lib/desktop-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-notifications.d.ts","sourceRoot":"","sources":["../../lib/desktop-notifications.ts"],"names":[],"mappings":"AAaA,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;AAC1D,KAAK,WAAW,GAAG,CAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,EAClD,QAAQ,EAAE,oBAAoB,KAC1B,OAAO,CAAC;AAEb,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAYnF,wBAAgB,8BAA8B,CAC7C,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,OAAO,CAET;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B,GAAG,eAAe,CAwClB;AAED,eAAO,MAAM,uBAAuB,iBAA0B,CAAC"}

package/dist/lib/desktop-notifications.js

@@ -0,0 +1,59 @@
+import { execFile } from "node:child_process";
+import { logDebug, logWarn } from "./logger.js";
+const DELIVERY_TIMEOUT_MS = 10_000;
+const MACOS_NOTIFICATION_SCRIPT = `
+function run(argv) {
+	const app = Application.currentApplication();
+	app.includeStandardAdditions = true;
+	app.displayNotification(argv[1], { withTitle: argv[0] });
+}
+`.trim();
+const executeFile = (file, args, options, callback) => {
+    return execFile(file, args, options, (error) => callback(error));
+};
+function getErrorCode(error) {
+    if (typeof error !== "object" || error === null)
+        return "unknown";
+    const code = error.code;
+    return typeof code === "string" || typeof code === "number" ? String(code) : "unknown";
+}
+export function isDesktopNotificationSupported(platform = process.platform) {
+    return platform === "darwin";
+}
+export function createDesktopNotifier(options) {
+    const platform = options?.platform ?? process.platform;
+    const run = options?.executeFile ?? executeFile;
+    let warningLogged = false;
+    const warnOnce = (message) => {
+        if (warningLogged)
+            return;
+        warningLogged = true;
+        logWarn(message);
+    };
+    return async (title, message) => {
+        if (!isDesktopNotificationSupported(platform)) {
+            warnOnce("Desktop quota notifications are supported only on macOS.");
+            return false;
+        }
+        return await new Promise((resolve) => {
+            try {
+                run("/usr/bin/osascript", ["-l", "JavaScript", "-e", MACOS_NOTIFICATION_SCRIPT, title, message], { timeout: DELIVERY_TIMEOUT_MS, windowsHide: true }, (error) => {
+                    if (!error) {
+                        resolve(true);
+                        return;
+                    }
+                    logDebug(`Desktop quota notification failed with code ${getErrorCode(error)}`);
+                    warnOnce("Desktop quota notification delivery failed on macOS.");
+                    resolve(false);
+                });
+            }
+            catch (error) {
+                logDebug(`Desktop quota notification threw with code ${getErrorCode(error)}`);
+                warnOnce("Desktop quota notification delivery failed on macOS.");
+                resolve(false);
+            }
+        });
+    };
+}
+export const sendDesktopNotification = createDesktopNotifier();
+//# sourceMappingURL=desktop-notifications.js.map

package/dist/lib/desktop-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-notifications.js","sourceRoot":"","sources":["../../lib/desktop-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,yBAAyB,GAAG;;;;;;CAMjC,CAAC,IAAI,EAAE,CAAC;AAYT,MAAM,WAAW,GAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAClE,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,SAAS,YAAY,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,IAAI,GAAI,KAAiC,CAAC,IAAI,CAAC;IACrD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC7C,WAA4B,OAAO,CAAC,QAAQ;IAE5C,OAAO,QAAQ,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAGrC;IACA,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACvD,MAAM,GAAG,GAAG,OAAO,EAAE,WAAW,IAAI,WAAW,CAAC;IAChD,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAQ,EAAE;QAC1C,IAAI,aAAa;YAAE,OAAO;QAC1B,aAAa,GAAG,IAAI,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,CAAC,8BAA8B,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,QAAQ,CAAC,0DAA0D,CAAC,CAAC;YACrE,OAAO,KAAK,CAAC;QACd,CAAC;QAED,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YAC7C,IAAI,CAAC;gBACJ,GAAG,CACF,oBAAoB,EACpB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,OAAO,CAAC,EACrE,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,IAAI,EAAE,EACnD,CAAC,KAAK,EAAE,EAAE;oBACT,IAAI,CAAC,KAAK,EAAE,CAAC;wBACZ,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACR,CAAC;oBACD,QAAQ,CAAC,+CAA+C,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC/E,QAAQ,CAAC,sDAAsD,CAAC,CAAC;oBACjE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC,CACD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,QAAQ,CAAC,8CAA8C,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC9E,QAAQ,CAAC,sDAAsD,CAAC,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,EAAE,CAAC"}

package/dist/lib/quota-notification-state.d.ts

@@ -0,0 +1,25 @@
+export interface QuotaWindowNotificationState {
+    /**
+     * The remaining-percent reading this window was last seen at. It is the
+     * only per-window state: which threshold is "armed" is derived from it, so
+     * storing that separately would let a corrupt extra field invalidate an
+     * otherwise usable file.
+     */
+    lastPercent?: number;
+}
+export interface QuotaNotificationState {
+    fiveHour: QuotaWindowNotificationState;
+    weekly: QuotaWindowNotificationState;
+    lastDeliveredAt?: number;
+    updatedAt: number;
+}
+export declare function getQuotaNotificationStatePath(activeProjectStoragePath: string): string;
+export declare function readQuotaNotificationState(statePath: string): Promise<QuotaNotificationState | undefined>;
+export declare function updateQuotaNotificationState<T>(statePath: string, update: (state: QuotaNotificationState | undefined) => Promise<{
+    state: QuotaNotificationState;
+    result: T;
+}> | {
+    state: QuotaNotificationState;
+    result: T;
+}): Promise<T>;
+//# sourceMappingURL=quota-notification-state.d.ts.map

package/dist/lib/quota-notification-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-notification-state.d.ts","sourceRoot":"","sources":["../../lib/quota-notification-state.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,4BAA4B;IAC5C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,MAAM,EAAE,4BAA4B,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,6BAA6B,CAAC,wBAAwB,EAAE,MAAM,GAAG,MAAM,CAEtF;AAsCD,wBAAsB,0BAA0B,CAC/C,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAS7C;AAYD,wBAAsB,4BAA4B,CAAC,CAAC,EACnD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,KAAK,OAAO,CAAC;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC;CACV,CAAC,GAAG;IACJ,KAAK,EAAE,sBAAsB,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC;CACV,GACC,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/dist/lib/quota-notification-state.js

@@ -0,0 +1,94 @@
+import { promises as fs } from "node:fs";
+import { dirname, join } from "node:path";
+import { lock } from "proper-lockfile";
+import { renameWithWindowsRetry } from "./storage/atomic-write.js";
+import { logDebug, logWarn } from "./logger.js";
+export function getQuotaNotificationStatePath(activeProjectStoragePath) {
+    return join(dirname(activeProjectStoragePath), "oc-codex-multi-auth-quota-notifications.json");
+}
+function parseWindowState(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const record = value;
+    const lastPercent = record.lastPercent;
+    if (lastPercent !== undefined &&
+        (typeof lastPercent !== "number" ||
+            !Number.isFinite(lastPercent) ||
+            lastPercent < 0 ||
+            lastPercent > 100)) {
+        return undefined;
+    }
+    // Older files may carry an `activeThreshold` key. It is ignored rather than
+    // rejected so an upgrade does not discard a usable state file.
+    return { lastPercent };
+}
+function parseState(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const record = value;
+    const fiveHour = parseWindowState(record.fiveHour);
+    const weekly = parseWindowState(record.weekly);
+    const lastDeliveredAt = record.lastDeliveredAt;
+    if (!fiveHour || !weekly || typeof record.updatedAt !== "number" || !Number.isFinite(record.updatedAt)) {
+        return undefined;
+    }
+    if (lastDeliveredAt !== undefined &&
+        (typeof lastDeliveredAt !== "number" || !Number.isFinite(lastDeliveredAt) || lastDeliveredAt < 0)) {
+        return undefined;
+    }
+    return { fiveHour, weekly, lastDeliveredAt, updatedAt: record.updatedAt };
+}
+export async function readQuotaNotificationState(statePath) {
+    try {
+        return parseState(JSON.parse(await fs.readFile(statePath, "utf-8")));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            logWarn(`Failed to read quota notification state from ${statePath}: ${error.message}`);
+        }
+        return undefined;
+    }
+}
+async function writeState(statePath, state) {
+    const tempPath = `${statePath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await fs.writeFile(tempPath, JSON.stringify(state, null, 2), { mode: 0o600 });
+        await renameWithWindowsRetry(tempPath, statePath);
+    }
+    finally {
+        await fs.rm(tempPath, { force: true }).catch(() => undefined);
+    }
+}
+export async function updateQuotaNotificationState(statePath, update) {
+    await fs.mkdir(dirname(statePath), { recursive: true, mode: 0o700 });
+    let compromised;
+    const release = await lock(statePath, {
+        realpath: false,
+        stale: 10_000,
+        update: 2_000,
+        retries: {
+            retries: 5,
+            factor: 1.5,
+            minTimeout: 50,
+            maxTimeout: 500,
+            randomize: true,
+        },
+        onCompromised: (error) => {
+            compromised = error;
+            logDebug(`Quota notification state lock compromised: ${error.message}`);
+        },
+    });
+    try {
+        const next = await update(await readQuotaNotificationState(statePath));
+        if (compromised)
+            throw compromised;
+        await writeState(statePath, next.state);
+        return next.result;
+    }
+    finally {
+        await release().catch((error) => {
+            logDebug(`Failed to release quota notification state lock: ${error.message}`);
+        });
+    }
+}
+//# sourceMappingURL=quota-notification-state.js.map

package/dist/lib/quota-notification-state.js.map

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

package/dist/lib/quota-notifications.d.ts

@@ -0,0 +1,79 @@
+import { type QuotaNotificationsConfig } from "./config.js";
+import { type CodexUsageSummary } from "./codex-usage.js";
+import { type DesktopNotifier } from "./desktop-notifications.js";
+import { type QuotaNotificationState, type QuotaWindowNotificationState } from "./quota-notification-state.js";
+import { type AccountMetadataV3, type AccountStorageV3 } from "./storage.js";
+export type QuotaWindowName = "fiveHour" | "weekly";
+export interface AggregatedQuotaWindow {
+    /** Headroom of the enabled account with the most room left in this window. */
+    remainingPercent?: number;
+    /**
+     * Reset time of the account `remainingPercent` was taken from. Always the
+     * same account, so the pair describes a quota one account actually has.
+     */
+    resetAtMs?: number;
+    /**
+     * Earliest reset across every enabled account with usable usage, set only
+     * when some other account recovers before {@link resetAtMs}. Reported as its
+     * own value rather than folded into `resetAtMs`, because a max-percent /
+     * min-reset pair describes a quota no account holds.
+     */
+    earliestResetAtMs?: number;
+}
+export interface AggregatedQuotaUsage {
+    fiveHour: AggregatedQuotaWindow;
+    weekly: AggregatedQuotaWindow;
+}
+export interface QuotaThresholdCrossing {
+    window: QuotaWindowName;
+    threshold: number;
+    remainingPercent: number;
+    /** Reset of the account `remainingPercent` came from; never a different one. */
+    resetAtMs?: number;
+    /** Earliest reset in the pool, when it is not `resetAtMs`. */
+    earliestResetAtMs?: number;
+}
+export interface AccountQuotaSummary {
+    usage: CodexUsageSummary;
+}
+export interface QuotaMonitor {
+    start(): void;
+    dispose(): void;
+    runNow(): Promise<void>;
+}
+type MonitorDependencies = {
+    loadConfig: () => QuotaNotificationsConfig;
+    loadStorage: () => Promise<AccountStorageV3 | null>;
+    fetchSummary: (storage: AccountStorageV3, account: AccountMetadataV3 | undefined, onCredentialsPersisted: () => void) => Promise<AccountQuotaSummary | null>;
+    notify: DesktopNotifier;
+    notificationsSupported: () => boolean;
+    /**
+     * Called once per check when refreshing an account rotated its single-use
+     * refresh token to disk. The host wires this to its account-manager cache
+     * invalidation; see {@link fetchUsageForAccount} for why it is mandatory.
+     */
+    onCredentialsPersisted: () => void;
+    now: () => number;
+    initialDelayMs: number;
+};
+export declare function aggregateQuotaUsage(summaries: readonly AccountQuotaSummary[], now?: number): AggregatedQuotaUsage;
+/**
+ * Decide whether this observation crosses a threshold downward.
+ *
+ * A threshold fires when the window is at or below it *and* the previous
+ * observation was strictly above it, which is the "rises above it after a
+ * reset" contract in `docs/configuration.md`. The most severe matching
+ * threshold wins, and the selection does not assume `thresholds` is sorted.
+ */
+export declare function transitionQuotaWindow(previous: QuotaWindowNotificationState, current: AggregatedQuotaWindow, thresholds: readonly number[]): {
+    state: QuotaWindowNotificationState;
+    threshold?: number;
+};
+export declare function transitionQuotaState(previous: QuotaNotificationState | undefined, usage: AggregatedQuotaUsage, thresholds: readonly number[], now?: number): {
+    state: QuotaNotificationState;
+    crossings: QuotaThresholdCrossing[];
+};
+export declare function formatQuotaNotification(usage: AggregatedQuotaUsage): string;
+export declare function createQuotaMonitor(overrides?: Partial<MonitorDependencies>): QuotaMonitor;
+export {};
+//# sourceMappingURL=quota-notifications.d.ts.map

package/dist/lib/quota-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-notifications.d.ts","sourceRoot":"","sources":["../../lib/quota-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EASN,KAAK,iBAAiB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGN,KAAK,eAAe,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGN,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAM3F,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,KAAK,mBAAmB,GAAG;IAC1B,UAAU,EAAE,MAAM,wBAAwB,CAAC;IAC3C,WAAW,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,YAAY,EAAE,CACb,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,sBAAsB,EAAE,MAAM,IAAI,KAC9B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,sBAAsB,EAAE,MAAM,OAAO,CAAC;IACtC;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAsEF,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,GAAG,SAAa,GACd,oBAAoB,CAKtB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,4BAA4B,EACtC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC3B;IAAE,KAAK,EAAE,4BAA4B,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAa7D;AAED,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,sBAAsB,GAAG,SAAS,EAC5C,KAAK,EAAE,oBAAoB,EAC3B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,GAAG,SAAa,GACd;IAAE,KAAK,EAAE,sBAAsB,CAAC;IAAC,SAAS,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAgCxE;AAeD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAE3E;AAUD,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,YAAY,CA0O7F"}