crewly 1.20.185 → 1.20.187

package/dist/backend/backend/src/services/spend/spend-cap.service.js

@@ -0,0 +1,503 @@
+/**
+ * Per-agent daily spend cap with a hard stop.
+ *
+ * - Caps are the owner's own limits (unlike the runtime fallback, which
+ *   reacts to a provider's usage limit). All are OFF until the owner sets
+ *   one: a default per-agent cap, per-agent overrides, and an optional
+ *   all-agents daily total.
+ * - At {@link SPEND_CAP_CONSTANTS.WARN_FRACTION} of a cap the owner gets ONE
+ *   heads-up.
+ * - At 100% the agent is hard-stopped: {@link stopOf} answers the delivery
+ *   and wake gates, so no new turn starts (the current one may finish) and
+ *   messages stay queued. The owner gets ONE decision card: "Raise to $Y
+ *   today" / "Keep stopped".
+ * - Local midnight resets everything; raises last for the day they were
+ *   made. When a stop lifts (midnight, raise, cap change) the queued
+ *   messages are released.
+ *
+ * Spend comes from {@link SpendLedger} (the shared token ledger and its one
+ * cost computation).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.service
+ */
+import { ORCHESTRATOR_SESSION_NAME, SPEND_CAP_CONSTANTS as C } from '../../constants.js';
+import { localDateKey, localMidnight } from '../project-tickets/ticket-autopilot-decision.js';
+import { formatUsd, spendCapReason } from './spend-cap.gate.js';
+import { cents } from './spend-ledger.service.js';
+import { emptyDay, emptySpendCapFile } from './spend-cap.store.js';
+/** A rejected cap change. */
+export class SpendCapError extends Error {
+    status;
+    /**
+     * @param status - HTTP status
+     * @param message - Owner-facing reason
+     */
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'SpendCapError';
+    }
+}
+/**
+ * Whether a cap value is usable.
+ *
+ * @param v - Value
+ * @returns True for a finite positive number
+ */
+function isCap(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v > 0;
+}
+/**
+ * Validate a cap from the API.
+ *
+ * @param v - Value
+ * @param what - Field name for the error
+ * @returns The cap (whole cents) or null
+ * @throws SpendCapError
+ */
+function parseCap(v, what) {
+    if (v === null)
+        return null;
+    const n = typeof v === 'string' ? Number(v.replace(/^\$/, '')) : v;
+    if (!isCap(n))
+        throw new SpendCapError(400, `${what} must be a positive amount in USD (e.g. 5) or null to turn it off`);
+    return cents(n);
+}
+/**
+ * The "Raise to $Y today" amount: the cap times RAISE_FACTOR, rounded up to
+ * whole dollars, and always above what was already spent.
+ *
+ * @param capUsd - Cap in force
+ * @param spentUsd - Spent today
+ * @returns USD
+ */
+export function suggestedRaise(capUsd, spentUsd) {
+    return Math.max(Math.ceil(capUsd * C.RAISE_FACTOR), Math.ceil(spentUsd) + 1);
+}
+/**
+ * Read the amount out of a "Raise to $Y today" option label.
+ *
+ * @param label - Option label
+ * @returns USD, or null when the label is not a raise
+ */
+export function raiseAmountOf(label) {
+    const m = /^Raise to \$(\d+(?:\.\d+)?) today/i.exec(label ?? '');
+    return m ? Number(m[1]) : null;
+}
+/**
+ * Per-agent daily spend cap service.
+ */
+export class SpendCapService {
+    deps;
+    file;
+    now;
+    logger;
+    timer = null;
+    /** Sessions stopped at the last evaluation (to release them when the stop lifts) */
+    lastStopped = new Set();
+    /** Evaluation passes run one after another */
+    chain = Promise.resolve();
+    queuedPass = null;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? (() => new Date());
+        this.logger = deps.logger;
+        this.file = deps.store.read() ?? emptySpendCapFile(localDateKey(this.now()));
+    }
+    /** Start the enforcement tick. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => void this.evaluate(), C.TICK_MS);
+        this.timer.unref?.();
+        void this.evaluate();
+    }
+    /** Stop the tick. */
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    // ---------------------------------------------------------------- caps
+    /** @returns The owner's caps (a copy) */
+    getConfig() {
+        return JSON.parse(JSON.stringify(this.file.config));
+    }
+    /**
+     * Change caps. Takes effect at once (a stop can lift or start).
+     *
+     * @param patch - Changes
+     * @returns The new caps
+     * @throws SpendCapError on a bad value
+     */
+    async setCaps(patch) {
+        if (!patch || typeof patch !== 'object')
+            throw new SpendCapError(400, 'Send the caps to change as JSON');
+        const next = this.getConfig();
+        if ('defaultAgentCapUsd' in patch)
+            next.defaultAgentCapUsd = parseCap(patch.defaultAgentCapUsd, 'defaultAgentCapUsd');
+        if ('totalCapUsd' in patch)
+            next.totalCapUsd = parseCap(patch.totalCapUsd, 'totalCapUsd');
+        if (patch.agents !== undefined) {
+            if (!patch.agents || typeof patch.agents !== 'object')
+                throw new SpendCapError(400, 'agents must be an object: { "<session>": 5 | null | "default" }');
+            for (const [session, value] of Object.entries(patch.agents)) {
+                if (!session.trim())
+                    throw new SpendCapError(400, 'agents keys must be agent session names');
+                if (value === 'default')
+                    delete next.agentCapsUsd[session];
+                else
+                    next.agentCapsUsd[session] = parseCap(value, `agents.${session}`);
+            }
+        }
+        next.updatedAt = this.now().toISOString();
+        this.file.config = next;
+        this.persist();
+        this.logger?.info('Spend caps changed', { caps: next });
+        await this.evaluate();
+        return this.getConfig();
+    }
+    /**
+     * Lift a cap for today only.
+     *
+     * @param target - Agent session, or `*` for the all-agents total
+     * @param usd - New cap for today (must be above today's spend)
+     * @returns The new cap for today
+     * @throws SpendCapError when the amount is not above today's spend
+     */
+    async raiseToday(target, usd) {
+        const cap = parseCap(usd, 'capUsd');
+        if (cap === null)
+            throw new SpendCapError(400, 'capUsd must be a positive amount in USD');
+        this.rollDay();
+        const spent = target === C.TOTAL_TARGET ? this.deps.ledger.totalToday() : this.deps.ledger.spentToday(target);
+        if (cap <= spent) {
+            throw new SpendCapError(400, `${formatUsd(cap)} is not above what ${this.nameOf(target)} already spent today (${formatUsd(spent)}); pick a higher amount`);
+        }
+        this.file.day.raised[target] = cap;
+        this.persist();
+        this.logger?.info('Spend cap raised for today', { target, capUsd: cap, spentUsd: cents(spent) });
+        await this.evaluate();
+        return cap;
+    }
+    // ---------------------------------------------------------------- gate
+    /**
+     * The stop in force for a session (the delivery / wake gate). Synchronous
+     * and live: it reads today's spend now, not at the last tick.
+     *
+     * @param session - Agent session
+     * @returns Stop, or null when the agent may run
+     */
+    stopOf(session) {
+        this.rollDay();
+        const stop = this.computeStop(session);
+        if (stop && !this.file.day.stopped.includes(this.stopKey(stop)))
+            this.scheduleEvaluate();
+        return stop;
+    }
+    /**
+     * Owner-facing name.
+     *
+     * @param session - Agent session
+     * @returns Name
+     */
+    displayNameOf(session) {
+        return this.nameOf(session);
+    }
+    /**
+     * Cap in force today for a target, and where it comes from.
+     *
+     * @param target - Agent session, or `*`
+     * @returns Cap (null = none) and source
+     */
+    capOf(target) {
+        const raised = this.file.day.raised[target];
+        if (isCap(raised))
+            return { capUsd: raised, source: 'raised' };
+        const cfg = this.file.config;
+        if (target === C.TOTAL_TARGET)
+            return isCap(cfg.totalCapUsd) ? { capUsd: cfg.totalCapUsd, source: 'default' } : { capUsd: null, source: 'none' };
+        if (Object.prototype.hasOwnProperty.call(cfg.agentCapsUsd, target)) {
+            const v = cfg.agentCapsUsd[target];
+            return isCap(v) ? { capUsd: v, source: 'override' } : { capUsd: null, source: 'exempt' };
+        }
+        return isCap(cfg.defaultAgentCapUsd) ? { capUsd: cfg.defaultAgentCapUsd, source: 'default' } : { capUsd: null, source: 'none' };
+    }
+    // ---------------------------------------------------------------- view
+    /**
+     * Spend plus caps for the API / Settings panel.
+     *
+     * @param days - Window
+     * @returns View
+     */
+    async view(days = C.DEFAULT_DAYS) {
+        this.rollDay();
+        const summary = this.deps.ledger.summarize(days);
+        const known = (await this.deps.knownSessions?.().catch(() => [])) ?? [];
+        const rows = new Map(summary.agents.map((a) => [a.session, a]));
+        for (const s of known) {
+            if (!rows.has(s))
+                rows.set(s, { session: s, runtimes: [], todayUsd: 0, windowUsd: 0, daily: summary.days.map(() => 0) });
+        }
+        const agents = [...rows.values()].map((a) => {
+            const cap = this.capOf(a.session);
+            const stop = this.computeStop(a.session);
+            return {
+                ...a,
+                name: this.nameOf(a.session),
+                capUsd: cap.capUsd,
+                capSource: cap.source,
+                stopped: !!stop,
+                ...(stop ? { stopReason: spendCapReason(stop, this.nameOf(a.session)) } : {}),
+            };
+        });
+        const total = this.capOf(C.TOTAL_TARGET).capUsd;
+        return {
+            ...summary,
+            agents,
+            caps: this.getConfig(),
+            raisedToday: { ...this.file.day.raised },
+            totalCapTodayUsd: total,
+            suggestedAgentCapUsd: summary.p90AgentDayUsd > 0 ? Math.max(1, Math.ceil(summary.p90AgentDayUsd)) : null,
+            totalStopped: total !== null && this.deps.ledger.totalToday() >= total,
+        };
+    }
+    // ---------------------------------------------------------------- enforcement
+    /**
+     * One enforcement pass: day roll, 80% notices, stop announcements (one
+     * card per stop), and releasing agents whose stop lifted. Passes run
+     * one at a time; a call during a pass gets another pass after it.
+     */
+    evaluate() {
+        // Coalesce: a pass not yet started is shared; a call during a running
+        // pass gets a fresh pass after it (so it sees the latest change).
+        if (this.queuedPass)
+            return this.queuedPass;
+        const pass = this.chain.then(async () => {
+            this.queuedPass = null;
+            try {
+                await this.evaluateOnce();
+            }
+            catch (err) {
+                this.logger?.warn('Spend cap evaluation failed', { error: err instanceof Error ? err.message : String(err) });
+            }
+        });
+        this.queuedPass = pass;
+        this.chain = pass;
+        return pass;
+    }
+    /**
+     * React to a settled "cap reached" card (decision kind `spend_cap`).
+     *
+     * @param d - The settled decision
+     * @returns Always null (nobody else is told)
+     */
+    async onSettled(d) {
+        if (d.kind !== C.DECISION_KIND || !d.system)
+            return null;
+        const target = d.system.key;
+        this.rollDay();
+        if (this.file.day.cards[target] !== d.id) {
+            if (d.status === 'resolved')
+                await this.reply(d.id, 'This card is from an earlier day; the cap has already reset at midnight.');
+            return null;
+        }
+        const name = this.nameOf(target);
+        if (d.status !== 'resolved')
+            return null;
+        const label = d.options.find((o) => o.key === d.chosenKey)?.label;
+        const amount = raiseAmountOf(label);
+        if (amount === null) {
+            await this.reply(d.id, `OK, ${name} stays stopped until midnight. Its messages stay queued.`);
+            return null;
+        }
+        try {
+            const cap = await this.raiseToday(target, amount);
+            await this.reply(d.id, `Raised ${name}'s cap to ${formatUsd(cap)} for today. Queued messages are being delivered.`);
+        }
+        catch (err) {
+            await this.reply(d.id, `Could not raise the cap: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return null;
+    }
+    // ---------------------------------------------------------------- internals
+    async evaluateOnce() {
+        this.rollDay();
+        if (!this.anyCap() && this.lastStopped.size === 0)
+            return;
+        this.deps.ledger.invalidate();
+        const summary = this.deps.ledger.summarize(1);
+        const known = (await this.deps.knownSessions?.().catch(() => [])) ?? [];
+        const sessions = new Set([...known, ...summary.agents.map((a) => a.session), ...Object.keys(this.file.day.raised).filter((t) => t !== C.TOTAL_TARGET)]);
+        if (this.lastStopped.size > 0)
+            for (const s of this.lastStopped)
+                sessions.add(s);
+        const stoppedNow = new Set();
+        // The all-agents total first: its notice names the whole crew once.
+        const total = this.capOf(C.TOTAL_TARGET).capUsd;
+        if (total !== null) {
+            const spent = this.deps.ledger.totalToday();
+            await this.checkThresholds(C.TOTAL_TARGET, total, spent);
+        }
+        for (const session of sessions) {
+            const cap = this.capOf(session).capUsd;
+            if (cap !== null)
+                await this.checkThresholds(session, cap, this.deps.ledger.spentToday(session));
+            if (this.computeStop(session))
+                stoppedNow.add(session);
+        }
+        const released = [...this.lastStopped].filter((s) => !stoppedNow.has(s));
+        this.lastStopped = stoppedNow;
+        if (released.length > 0) {
+            this.logger?.info('Spend cap stop lifted — releasing queued messages', { sessions: released });
+            await this.deps.onReleased?.(released).catch((err) => this.logger?.warn('Releasing queued messages failed', { sessions: released, error: err instanceof Error ? err.message : String(err) }));
+        }
+    }
+    async checkThresholds(target, cap, spent) {
+        const key = `${target}@${cap}`;
+        const day = this.file.day;
+        const name = this.nameOf(target);
+        if (spent >= cap) {
+            if (day.stopped.includes(key))
+                return;
+            day.stopped.push(key);
+            if (!day.warned.includes(key))
+                day.warned.push(key);
+            this.persist();
+            this.logger?.warn('Daily spend cap reached — hard stop (no new turns until midnight)', { target, capUsd: cap, spentUsd: cents(spent) });
+            await this.announceStop(target, name, cap, spent);
+            return;
+        }
+        if (spent >= cap * C.WARN_FRACTION && !day.warned.includes(key)) {
+            day.warned.push(key);
+            this.persist();
+            const pct = Math.floor((spent / cap) * 100);
+            const who = target === C.TOTAL_TARGET ? 'All agents together have' : `${name} has`;
+            const its = target === C.TOTAL_TARGET ? 'the' : 'its';
+            const stops = target === C.TOTAL_TARGET ? 'every agent stops' : 'it stops';
+            await this.notify(`Heads-up: ${who} spent ${formatUsd(spent)} of ${its} ${formatUsd(cap)} daily spend cap today (${pct}%). At ${formatUsd(cap)} ${stops} taking new turns until midnight.`);
+        }
+    }
+    async announceStop(target, name, cap, spent) {
+        const raise = suggestedRaise(cap, spent);
+        const who = target === C.TOTAL_TARGET ? 'total' : target === ORCHESTRATOR_SESSION_NAME ? 'orc' : name;
+        const headline = target === C.TOTAL_TARGET
+            ? `All agents together hit the daily total spend cap (${formatUsd(cap)}); every agent is stopped until midnight.`
+            : `${name} hit its daily spend cap (${formatUsd(cap)}) and is stopped until midnight.`;
+        const decisions = this.deps.decisions?.() ?? null;
+        if (decisions) {
+            try {
+                const d = await decisions.askSystem({
+                    kind: C.DECISION_KIND,
+                    system: { key: target, defaultIsDecline: true },
+                    title: 'Daily spend cap reached',
+                    question: `${headline} Raise it for today?`,
+                    body: [
+                        `Spent today: ${formatUsd(spent)}. The current turn was allowed to finish; no new turns start. Messages are kept and delivered when it runs again.`,
+                    ],
+                    options: [`Raise to $${raise} today — runs again until midnight`, `${C.OPTIONS.KEEP} — resets at midnight`],
+                    default: C.OPTIONS.KEEP,
+                    deadline: this.nextMidnight(),
+                    sensitive: 'spend',
+                });
+                this.file.day.cards[target] = d.id;
+                this.persist();
+                return;
+            }
+            catch (err) {
+                this.logger?.warn('Could not post the spend cap card — sending a notice instead', { target, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        await this.notify(`${headline} Its messages are queued. Reply \`raise cap for ${who} to $${raise} today\` to raise it.`);
+    }
+    anyCap() {
+        const cfg = this.file.config;
+        return (isCap(cfg.defaultAgentCapUsd) ||
+            isCap(cfg.totalCapUsd) ||
+            Object.values(cfg.agentCapsUsd).some(isCap) ||
+            Object.values(this.file.day.raised).some(isCap));
+    }
+    computeStop(session) {
+        const own = this.capOf(session).capUsd;
+        if (own !== null) {
+            const spent = this.deps.ledger.spentToday(session);
+            if (spent >= own)
+                return { session, scope: 'agent', capUsd: own, spentUsd: spent };
+        }
+        const total = this.capOf(C.TOTAL_TARGET).capUsd;
+        if (total !== null) {
+            const spent = this.deps.ledger.totalToday();
+            if (spent >= total)
+                return { session, scope: 'total', capUsd: total, spentUsd: spent };
+        }
+        return null;
+    }
+    stopKey(stop) {
+        return `${stop.scope === 'total' ? C.TOTAL_TARGET : stop.session}@${stop.capUsd}`;
+    }
+    scheduleEvaluate() {
+        void this.evaluate();
+    }
+    /** Reset today's bookkeeping when the local day changed. */
+    rollDay() {
+        const today = localDateKey(this.now());
+        if (this.file.day.date === today)
+            return;
+        const had = Object.keys(this.file.day.raised).length + this.file.day.stopped.length;
+        this.file.day = emptyDay(today);
+        this.deps.ledger.invalidate();
+        this.persist();
+        if (had > 0)
+            this.logger?.info('Spend caps reset for the new day', { date: today });
+    }
+    nextMidnight() {
+        const next = localMidnight(this.now());
+        next.setDate(next.getDate() + 1);
+        // A card must have a future deadline even in the last minute of the day.
+        return next.getTime() - this.now().getTime() < 60_000 ? new Date(this.now().getTime() + 60_000) : next;
+    }
+    nameOf(target) {
+        if (target === C.TOTAL_TARGET)
+            return 'All agents';
+        try {
+            return this.deps.displayNameOf?.(target) || target;
+        }
+        catch {
+            return target;
+        }
+    }
+    async notify(text) {
+        try {
+            await this.deps.notifyOwner(text);
+        }
+        catch (err) {
+            this.logger?.warn('Could not send the spend cap notice', { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    async reply(decisionId, text) {
+        await this.deps.decisions?.()?.replyInThread(decisionId, text).catch(() => undefined);
+    }
+    persist() {
+        try {
+            this.deps.store.write(this.file);
+        }
+        catch (err) {
+            this.logger?.warn('Could not save spend caps', { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+}
+let instance = null;
+/** @returns The backend's service, or null before it is wired */
+export function getSpendCapService() {
+    return instance;
+}
+/** @param service - Instance (null clears) */
+export function setSpendCapService(service) {
+    instance = service;
+}
+//# sourceMappingURL=spend-cap.service.js.map

package/dist/backend/backend/src/services/spend/spend-cap.service.js.map

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

package/dist/backend/backend/src/services/spend/spend-cap.store.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Spend caps on disk: the owner's caps plus today's bookkeeping (raises,
+ * the 80% notices and stop cards already sent). One small JSON file under
+ * CREWLY_HOME, written atomically.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.store
+ */
+/** The owner's caps (USD per local day). */
+export interface SpendCapConfig {
+    /** Cap for every agent without an override; null = off (the default) */
+    defaultAgentCapUsd: number | null;
+    /** Cap on all agents together; null = off */
+    totalCapUsd: number | null;
+    /** Session → its own cap; null = no cap for this agent even when a default is set */
+    agentCapsUsd: Record<string, number | null>;
+    updatedAt?: string;
+}
+/** Today's bookkeeping; reset at local midnight. */
+export interface SpendCapDayState {
+    /** `YYYY-MM-DD`, local */
+    date: string;
+    /** Target (session, or `*` for the total) → cap raised to for today (USD) */
+    raised: Record<string, number>;
+    /** `target@cap` keys whose 80% notice was sent */
+    warned: string[];
+    /** `target@cap` keys whose stop was announced */
+    stopped: string[];
+    /** Target → id of today's "cap reached" decision card */
+    cards: Record<string, string>;
+}
+/** The file. */
+export interface SpendCapFile {
+    config: SpendCapConfig;
+    day: SpendCapDayState;
+}
+/** Storage the service uses (tests pass an in-memory one). */
+export interface SpendCapStoreLike {
+    read(): SpendCapFile | null;
+    write(file: SpendCapFile): void;
+}
+/**
+ * Caps off, nothing recorded.
+ *
+ * @param date - Local day
+ * @returns Fresh file
+ */
+export declare function emptySpendCapFile(date: string): SpendCapFile;
+/**
+ * Empty day state.
+ *
+ * @param date - Local day
+ * @returns State
+ */
+export declare function emptyDay(date: string): SpendCapDayState;
+/**
+ * JSON file store.
+ */
+export declare class FileSpendCapStore implements SpendCapStoreLike {
+    private readonly file;
+    /**
+     * @param file - Absolute path
+     */
+    constructor(file: string);
+    /**
+     * @returns The file, or null when absent / unreadable
+     */
+    read(): SpendCapFile | null;
+    /**
+     * @param file - Contents to persist
+     */
+    write(file: SpendCapFile): void;
+}
+/**
+ * In-memory store (tests).
+ */
+export declare class MemorySpendCapStore implements SpendCapStoreLike {
+    file: SpendCapFile | null;
+    /** @returns Stored copy */
+    read(): SpendCapFile | null;
+    /** @param file - Contents */
+    write(file: SpendCapFile): void;
+}
+//# sourceMappingURL=spend-cap.store.d.ts.map

package/dist/backend/backend/src/services/spend/spend-cap.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-cap.store.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-cap.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,6CAA6C;IAC7C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,YAAY,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAEvD;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IAI7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC;;OAEG;gBAC0B,IAAI,EAAE,MAAM;IAEzC;;OAEG;IACH,IAAI,IAAI,YAAY,GAAG,IAAI;IAsB3B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAMhC;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,IAAI,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEjC,2BAA2B;IAC3B,IAAI,IAAI,YAAY,GAAG,IAAI;IAI3B,6BAA6B;IAC7B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAGhC"}