@senpi/runtime 1.0.95-dev.runtime-phase-2.20260420121147 → 1.0.95-dev.runtime-phase-2.20260420130250

package/dist/dsl/notifications/close-resolver.js

@@ -0,0 +1,302 @@
+/**
+ * Deferred close notifications: match `discovery_get_trader_history` rows to closed DSL positions
+ * and send enriched PnL / exit / fees, with a timeout fallback when history lags.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdir, readdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CLOSE_RESOLVE_POLL_MS, CLOSE_RESOLVE_TIMEOUT_MS, } from "../../constants/dsl/index.js";
+import { normalizeDslCoinDex } from "../../utils/perp-coin.js";
+import { createLogger } from "../../utils/logger.js";
+import { formatDslClosedEnriched, formatDslClosedFallback } from "./formatter.js";
+const logger = createLogger("[senpi-core][dsl-close-resolver]");
+/** Match tolerance (ms) between DSL timestamps and trade history `openTime` / `closedTime`. */
+export const MATCH_OPEN_TIME_MS = 120_000;
+export const MATCH_CLOSE_TIME_MS = 120_000;
+/** Page size for paginated trade-history fetches. */
+const TRADE_PAGE_SIZE = 20;
+/** Safety cap on pages to prevent runaway pagination against a misbehaving API. */
+const MAX_TRADE_PAGES = 10;
+/**
+ * Finds the trade row that corresponds to a closed DSL position (coin/dex/direction + open/close times).
+ *
+ * Edge case: two closes for the same coin/direction within {@link MATCH_OPEN_TIME_MS} / {@link MATCH_CLOSE_TIME_MS}
+ * could both score the same row; follow-up could track claimed trade IDs per resolver pass if needed.
+ */
+export function matchTrade(pending, trades) {
+    const p = normalizeDslCoinDex(pending.asset, pending.dex);
+    const createdMs = Date.parse(pending.createdAt);
+    const closedMs = Date.parse(pending.closedAt);
+    if (!Number.isFinite(createdMs) || !Number.isFinite(closedMs))
+        return undefined;
+    let best;
+    let bestScore = Infinity;
+    for (const t of trades) {
+        const tcd = normalizeDslCoinDex(t.coin, t.dex ?? "");
+        if (tcd.coin !== p.coin || tcd.dex !== p.dex)
+            continue;
+        if (t.direction !== pending.direction)
+            continue;
+        const openDelta = Math.abs(t.openTime - createdMs);
+        const closeDelta = Math.abs(t.closedTime - closedMs);
+        if (openDelta > MATCH_OPEN_TIME_MS || closeDelta > MATCH_CLOSE_TIME_MS)
+            continue;
+        const score = openDelta + closeDelta;
+        if (score < bestScore) {
+            bestScore = score;
+            best = t;
+        }
+    }
+    return best;
+}
+/** Builds a pending record from a bus payload (also used for immediate fallback when no resolver). */
+export function buildPendingCloseFromEvent(e, id) {
+    const margin = e.margin ??
+        (e.leverage && e.leverage > 0 && e.entryPrice != null && e.size != null
+            ? (e.size * e.entryPrice) / e.leverage
+            : 0);
+    return {
+        id,
+        address: e.address,
+        asset: e.asset,
+        dex: e.dex ?? "",
+        direction: e.direction ?? "LONG",
+        entryPrice: e.entryPrice ?? 0,
+        leverage: e.leverage ?? 1,
+        margin,
+        size: e.size ?? 0,
+        closeReason: e.closeReason,
+        createdAt: e.createdAt ?? e.timestamp,
+        closedAt: e.timestamp,
+        lastPrice: e.lastPrice ?? 0,
+        currentROE: e.currentROE ?? 0,
+        peakROE: e.peakROE ?? 0,
+        currentTierIndex: e.currentTierIndex ?? null,
+        enqueuedAt: Date.now(),
+        retryCount: 0,
+        resolved: false,
+    };
+}
+/**
+ * Polls trade history and sends Telegram lines when a pending close is enriched or times out.
+ */
+export class CloseNotificationResolver {
+    pendingDir;
+    getStrategy;
+    notify;
+    pending = new Map();
+    timer = null;
+    pollMs = CLOSE_RESOLVE_POLL_MS;
+    /** Prevents overlapping `tick()` runs when a poll takes longer than `pollMs` (await yields). */
+    tickInFlight = false;
+    constructor(opts) {
+        this.pendingDir = opts.pendingDir;
+        this.getStrategy = opts.getStrategy;
+        this.notify = opts.notify;
+    }
+    /**
+     * Loads pending JSON from disk and starts the polling loop.
+     * Awaits the first {@link tick} so callers (tests, plugin init) do not observe stale in-memory state.
+     */
+    async start(pollIntervalMs = CLOSE_RESOLVE_POLL_MS) {
+        this.pollMs = pollIntervalMs;
+        await mkdir(this.pendingDir, { recursive: true });
+        await this.hydrateFromDisk();
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.runTickSafe();
+        }, this.pollMs);
+        await this.runTickSafe();
+    }
+    /**
+     * Runs one poll pass; swallows errors so `setInterval` callbacks never surface as unhandled
+     * rejections. The initial call from {@link start} is awaited so the first `tick` completes
+     * before `start` resolves. Skips if the previous tick is still in progress so slow MCP calls
+     * cannot overlap and double-notify.
+     */
+    async runTickSafe() {
+        if (this.tickInFlight)
+            return;
+        this.tickInFlight = true;
+        try {
+            await this.tick();
+        }
+        catch (err) {
+            logger.warn("[dsl-close-resolver] tick failed", { err });
+        }
+        finally {
+            this.tickInFlight = false;
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Queue a close for enrichment (writes disk, in-memory map).
+     *
+     * On disk failure after the in-memory enqueue, the row stays in `pending` so polling can still
+     * resolve or time out; failures are logged and never propagate (subscriber uses fire-and-forget).
+     */
+    async enqueue(event) {
+        const id = randomUUID();
+        const rec = buildPendingCloseFromEvent(event, id);
+        this.pending.set(id, rec);
+        try {
+            await mkdir(this.pendingDir, { recursive: true });
+            await this.persist(rec);
+        }
+        catch (err) {
+            logger.warn("[dsl-close-resolver] enqueue disk write failed; pending close kept in memory", {
+                err,
+                id,
+            });
+        }
+    }
+    async hydrateFromDisk() {
+        let names;
+        try {
+            names = await readdir(this.pendingDir);
+        }
+        catch {
+            return;
+        }
+        for (const name of names) {
+            if (!name.endsWith(".json"))
+                continue;
+            try {
+                const raw = await readFile(join(this.pendingDir, name), "utf-8");
+                const rec = JSON.parse(raw);
+                if (rec.resolved) {
+                    await unlink(join(this.pendingDir, name)).catch(() => { });
+                    continue;
+                }
+                this.pending.set(rec.id, rec);
+            }
+            catch (err) {
+                logger.warn("[dsl-close-resolver] skip bad pending file", { name, err });
+            }
+        }
+    }
+    async persist(rec) {
+        const path = join(this.pendingDir, `${rec.id}.json`);
+        await writeFile(path, JSON.stringify(rec, null, 2), "utf-8");
+    }
+    async removeFile(id) {
+        await unlink(join(this.pendingDir, `${id}.json`)).catch(() => { });
+    }
+    async tick() {
+        for (const id of [...this.pending.keys()]) {
+            const rec = this.pending.get(id);
+            if (!rec || rec.resolved)
+                continue;
+            try {
+                await this.resolveOne(rec);
+            }
+            catch (err) {
+                logger.warn("[dsl-close-resolver] resolveOne failed", { id: rec.id, err });
+                await this.bumpRetryAndMaybeFallback(rec);
+            }
+        }
+    }
+    /**
+     * Increments retry count and sends the no-PnL fallback once the enqueue age exceeds the timeout.
+     * Used after unexpected errors so a pending row cannot wedge the resolver forever.
+     */
+    async bumpRetryAndMaybeFallback(rec) {
+        rec.retryCount += 1;
+        const elapsed = Date.now() - rec.enqueuedAt;
+        if (elapsed >= CLOSE_RESOLVE_TIMEOUT_MS && this.pending.has(rec.id) && !rec.resolved) {
+            this.notify(formatDslClosedFallback(rec));
+            await this.finish(rec);
+        }
+    }
+    /**
+     * Paginates `fetchPastTrades` (sorted by closedTime DESC) until a match is found or
+     * trades fall before the position's open time.  Returns the matched trade, `undefined`
+     * when no match was found across all pages, or `"error"` on fetch failure.
+     *
+     * NOTE: offset-based pagination with descending closedTime can skip or duplicate a row
+     * when a new trade lands between page fetches (row shifts down by one). Cursor-style
+     * pagination (closedTime < lastSeen) would avoid this but the upstream API does not
+     * support it. At typical trade cadence and the ±120s match tolerance this is unlikely
+     * to cause a missed notification.
+     */
+    async fetchAndMatch(strategy, rec) {
+        const cutoffMs = Date.parse(rec.createdAt) - MATCH_OPEN_TIME_MS;
+        let offset = 0;
+        for (let page = 0; page < MAX_TRADE_PAGES; page++) {
+            let trades;
+            try {
+                trades = await strategy.fetchPastTrades({
+                    limit: TRADE_PAGE_SIZE,
+                    offset,
+                    sort_by: "closedTime",
+                    sort_direction: "desc",
+                });
+            }
+            catch (err) {
+                logger.warn("[dsl-close-resolver] fetchPastTrades failed", { id: rec.id, page, err });
+                return "error";
+            }
+            if (!trades?.length)
+                return undefined;
+            const hit = matchTrade(rec, trades);
+            if (hit)
+                return hit;
+            // Oldest trade in this page — if it predates the position open window, stop.
+            const oldestClosedTime = Math.min(...trades.map((t) => t.closedTime));
+            if (oldestClosedTime < cutoffMs)
+                return undefined;
+            // Partial page means we've exhausted results.
+            if (trades.length < TRADE_PAGE_SIZE)
+                return undefined;
+            offset += TRADE_PAGE_SIZE;
+        }
+        return undefined;
+    }
+    async resolveOne(rec) {
+        const elapsed = Date.now() - rec.enqueuedAt;
+        const strategy = this.getStrategy(rec.address);
+        if (!strategy) {
+            rec.retryCount += 1;
+            if (elapsed >= CLOSE_RESOLVE_TIMEOUT_MS) {
+                this.notify(formatDslClosedFallback(rec));
+                await this.finish(rec);
+            }
+            return;
+        }
+        const hit = await this.fetchAndMatch(strategy, rec);
+        if (hit === "error") {
+            rec.retryCount += 1;
+            if (elapsed >= CLOSE_RESOLVE_TIMEOUT_MS) {
+                this.notify(formatDslClosedFallback(rec));
+                await this.finish(rec);
+            }
+            return;
+        }
+        if (hit) {
+            this.notify(formatDslClosedEnriched(rec, {
+                realizedPnl: hit.realizedPnl,
+                closePx: hit.closePx,
+                totalFees: hit.totalFees,
+            }));
+            await this.finish(rec);
+            return;
+        }
+        rec.retryCount += 1;
+        if (elapsed >= CLOSE_RESOLVE_TIMEOUT_MS) {
+            this.notify(formatDslClosedFallback(rec));
+            await this.finish(rec);
+        }
+    }
+    async finish(rec) {
+        rec.resolved = true;
+        this.pending.delete(rec.id);
+        await this.removeFile(rec.id);
+    }
+}
+//# sourceMappingURL=close-resolver.js.map

package/dist/dsl/notifications/close-resolver.js.map

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

package/dist/dsl/notifications/format-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * User-facing number formatting for DSL Telegram notifications (smart decimals, signs, duration).
+ */
+/**
+ * Smart USD price: BTC/ETH — whole dollars + grouping; alts — 2–4 decimals by magnitude.
+ */
+export declare function fmtUsdPrice(price: number, asset?: string): string;
+/**
+ * Signed P/L in USD with two decimals (+$80.27, -$48.15).
+ */
+export declare function fmtUsdPnl(amount: number): string;
+/** ROE percent with one decimal and sign (+6.6%, -3.5%). */
+export declare function fmtRoe(pct: number): string;
+/**
+ * Human duration between two ISO timestamps: `45m`, `2h 30m`, `1d 2h`.
+ */
+export declare function fmtDuration(startIso: string, endIso: string): string;
+/** Collateral display: trim meaningless trailing zeros (e.g. $500, $493.20). */
+export declare function fmtMargin(amount: number): string;
+/**
+ * Signed distance from entry to protective floor as a negative percentage (user-facing buffer).
+ */
+export declare function fmtFloorDistancePct(entry: number, floor: number, direction: "LONG" | "SHORT"): string;
+//# sourceMappingURL=format-utils.d.ts.map

package/dist/dsl/notifications/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../../src/dsl/notifications/format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,OAAO,GAC1B,MAAM,CAUR"}

package/dist/dsl/notifications/format-utils.js

@@ -0,0 +1,102 @@
+/**
+ * User-facing number formatting for DSL Telegram notifications (smart decimals, signs, duration).
+ */
+/**
+ * Strip `xyz:` prefix for major-coin detection.
+ */
+function baseSymbol(asset) {
+    const t = asset.trim();
+    return t.toLowerCase().startsWith("xyz:") ? t.slice(4) : t;
+}
+function formatUsdWithCommas(n, fractionDigits) {
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
+        minimumFractionDigits: fractionDigits,
+        maximumFractionDigits: fractionDigits,
+    }).format(n);
+}
+/**
+ * Smart USD price: BTC/ETH — whole dollars + grouping; alts — 2–4 decimals by magnitude.
+ */
+export function fmtUsdPrice(price, asset) {
+    if (!Number.isFinite(price))
+        return "$0";
+    const base = asset != null ? baseSymbol(asset).toUpperCase() : "";
+    if (base === "BTC" || base === "ETH") {
+        return formatUsdWithCommas(Math.round(price), 0);
+    }
+    const ap = Math.abs(price);
+    let digits = 2;
+    if (ap > 0 && ap < 1)
+        digits = 4;
+    else if (ap < 100)
+        digits = 2;
+    else
+        digits = 2;
+    return formatUsdWithCommas(price, digits);
+}
+/**
+ * Signed P/L in USD with two decimals (+$80.27, -$48.15).
+ */
+export function fmtUsdPnl(amount) {
+    if (!Number.isFinite(amount))
+        return "$0.00";
+    const sign = amount >= 0 ? "+" : "";
+    return `${sign}${formatUsdWithCommas(amount, 2)}`;
+}
+/** ROE percent with one decimal and sign (+6.6%, -3.5%). */
+export function fmtRoe(pct) {
+    if (!Number.isFinite(pct))
+        return "0.0%";
+    const sign = pct >= 0 ? "+" : "";
+    return `${sign}${pct.toFixed(1)}%`;
+}
+/**
+ * Human duration between two ISO timestamps: `45m`, `2h 30m`, `1d 2h`.
+ */
+export function fmtDuration(startIso, endIso) {
+    const a = Date.parse(startIso);
+    const b = Date.parse(endIso);
+    if (!Number.isFinite(a) || !Number.isFinite(b))
+        return "—";
+    let ms = Math.max(0, b - a);
+    const days = Math.floor(ms / (24 * 60 * 60 * 1000));
+    ms -= days * 24 * 60 * 60 * 1000;
+    const hours = Math.floor(ms / (60 * 60 * 1000));
+    ms -= hours * 60 * 60 * 1000;
+    const minutes = Math.floor(ms / (60 * 1000));
+    if (days > 0) {
+        return hours > 0 ? `${days}d ${hours}h` : `${days}d`;
+    }
+    if (hours > 0) {
+        return minutes > 0 ? `${hours}h ${minutes}m` : `${hours}h`;
+    }
+    return `${minutes}m`;
+}
+/** Collateral display: trim meaningless trailing zeros (e.g. $500, $493.20). */
+export function fmtMargin(amount) {
+    if (!Number.isFinite(amount))
+        return "$0";
+    const ap = Math.abs(amount);
+    const digits = ap >= 100 ? 0 : ap >= 1 ? 2 : 4;
+    return formatUsdWithCommas(amount, digits);
+}
+/**
+ * Signed distance from entry to protective floor as a negative percentage (user-facing buffer).
+ */
+export function fmtFloorDistancePct(entry, floor, direction) {
+    if (!Number.isFinite(entry) || entry === 0 || !Number.isFinite(floor))
+        return "0.0%";
+    let pct;
+    if (direction === "LONG") {
+        pct = ((floor - entry) / entry) * 100;
+    }
+    else {
+        pct = ((entry - floor) / entry) * 100;
+    }
+    if (pct > 0)
+        pct = -pct;
+    return `${pct.toFixed(1)}%`;
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/dsl/notifications/format-utils.js.map

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

package/dist/dsl/notifications/formatter.d.ts

@@ -1,18 +1,37 @@
 /**
  * Plain-text messages for DSL lifecycle Telegram notifications.
  */
-import type { DslCreatedEvent, DslClosedEvent, DslPhaseChangedEvent, DslTierAdvancedEvent, DslSlUpdatedEvent } from "../../types/dsl/index.js";
-export declare function formatDslCreated(e: DslCreatedEvent): string;
-export declare function formatDslPhaseChanged(e: DslPhaseChangedEvent): string;
+import type { DslCreatedEvent, DslTierAdvancedEvent, DslSlUpdatedEvent, DslHeartbeatEvent } from "../../types/dsl/index.js";
+import type { PendingCloseNotification } from "./types.js";
+/**
+ * User-facing line for `dsl.created`. Returns `null` when the position change should stay silent
+ * (increase / decrease / flip rebuilds).
+ */
+export declare function formatDslCreated(e: DslCreatedEvent): string | null;
+/**
+ * Tier / profit-lock notification.
+ */
 export declare function formatDslTierAdvanced(e: DslTierAdvancedEvent): string;
 export declare function formatDslSlUpdated(e: DslSlUpdatedEvent): string;
 export declare function formatDslClosePending(e: {
     asset: string;
     attempt: number;
 }): string;
-export declare function formatDslClosed(e: DslClosedEvent): string;
+export declare function plainEnglishCloseReason(closeReason: string): string;
+export interface CloseEnrichment {
+    realizedPnl: number;
+    closePx: number;
+    totalFees: number;
+}
+/**
+ * Full three-line close when trade history matched.
+ */
+export declare function formatDslClosedEnriched(p: PendingCloseNotification, x: CloseEnrichment): string;
+/** Timeout path: no reliable exit PnL from history. */
+export declare function formatDslClosedFallback(p: PendingCloseNotification): string;
 export declare function formatDslDeleted(e: {
     asset: string;
     dex?: string;
 }): string;
+export declare function formatDslHeartbeat(e: DslHeartbeatEvent): string;
 //# sourceMappingURL=formatter.d.ts.map

package/dist/dsl/notifications/formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/dsl/notifications/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA0BlC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAU3D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGrE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGrE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAG/D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEnF;AAiBD,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAOzD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG3E"}
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/dsl/notifications/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAmB3D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAQlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAerE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAG/D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEnF;AAwBD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAwCD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,wBAAwB,EAC3B,CAAC,EAAE,eAAe,GACjB,MAAM,CAQR;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAK3E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG3E;AAUD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAY/D"}