@tokenbuddy/tokenbuddy 1.0.9 → 1.0.12

package/dist/src/prewarm-cache.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Default TTL for a successfully warmed entry. 10 minutes is the v1.2 starting
+ * point; see buyer-driven-fallback-design.md §18.13 for the trade-off. The
+ * cache constructor accepts an override so tests and the future PR-E config
+ * loader can change this without re-architecting.
+ */
+export declare const DEFAULT_PREWARM_TTL_MS: number;
+export type PrewarmState = "warming" | "warm" | "stale" | "empty";
+export interface PrewarmCandidate {
+    sellerId: string;
+    url: string;
+    healthScore: number;
+    lastSuccessAt: number;
+    lastFailAt: number;
+    avgLatencyMs: number;
+}
+export interface PrewarmEntry {
+    modelId: string;
+    protocol: string;
+    paymentMethod: string;
+    state: PrewarmState;
+    candidates: PrewarmCandidate[];
+    warmedAt: number;
+    ttlMs: number;
+    consecutiveWarmingFailures: number;
+    lastInFlightAt?: number;
+}
+export interface PrewarmCandidateInput {
+    sellerId: string;
+    url: string;
+    healthScore?: number;
+    lastSuccessAt?: number;
+    lastFailAt?: number;
+    avgLatencyMs?: number;
+}
+/**
+ * Build the cache key for a (model, protocol, payment) triple. The colon
+ * separator is reserved at the model-id level because `RegistrySeller.models`
+ * entries are trimmed but not colon-escaped. v1.2 forbids `:` inside model
+ * ids so this format is collision-free.
+ */
+export declare function prewarmKey(modelId: string, protocol: string, paymentMethod: string): string;
+interface PrewarmCacheOptions {
+    defaultTtlMs?: number;
+    now?: () => number;
+}
+export declare class PrewarmCache {
+    private readonly entries;
+    private readonly defaultTtlMs;
+    private readonly now;
+    constructor(options?: PrewarmCacheOptions);
+    /**
+     * Read an entry without mutating state. Returns `undefined` when the key is
+     * unknown; the caller decides whether "absent" should be treated as a miss
+     * (i.e. trigger a fresh prewarm) or as a known empty model.
+     */
+    get(modelId: string, protocol: string, paymentMethod: string): PrewarmEntry | undefined;
+    /**
+     * Look up an entry and return a `Freshness` descriptor. This is the cheap
+     * path used on every inference request to decide whether a prewarm is
+     * still authoritative, expiring soon, or already stale.
+     */
+    freshness(modelId: string, protocol: string, paymentMethod: string): PrewarmFreshness;
+    /**
+     * Mark a (model, protocol, payment) triple as currently being warmed. If an
+     * existing warm entry is present it is kept untouched (the new probe
+     * supersedes it on commit) and the previous state is reported to the
+     * caller via the returned descriptor.
+     */
+    beginWarming(modelId: string, protocol: string, paymentMethod: string, ttlMs?: number): PrewarmBeginResult;
+    /**
+     * Commit a successful warm. The entry's `warmedAt` is reset to the current
+     * time so the TTL window starts fresh, and any prior stale candidates are
+     * replaced with the new probe results. The previous candidate set is
+     * returned for caller-side telemetry (e.g. detecting churn).
+     */
+    commitWarm(input: {
+        modelId: string;
+        protocol: string;
+        paymentMethod: string;
+        candidates: PrewarmCandidateInput[];
+        ttlMs?: number;
+    }): PrewarmCommitResult;
+    /**
+     * Mark a warm as failed. Consecutive failures are tracked so the scheduler
+     * can apply exponential backoff and so `tb doctor` can surface persistently
+     * broken models.
+     */
+    recordFailure(modelId: string, protocol: string, paymentMethod: string, errorMessage?: string): PrewarmEntry | undefined;
+    /**
+     * Invalidate every entry that references the given seller. Used when the
+     * registry signals a seller is gone (grace period expires) or when a hard
+     * failure (e.g. 5xx storm) should drop the seller from the cache
+     * immediately.
+     */
+    invalidateSeller(sellerId: string): number;
+    /**
+     * Invalidate a specific cache key. Used by `tb doctor --refresh <model>`
+     * and by the registry loop when a model is removed from the focus set.
+     */
+    invalidateKey(modelId: string, protocol: string, paymentMethod: string): boolean;
+    /**
+     * Drop every entry whose TTL has expired. Returns the number of removed
+     * entries so the caller can log it.
+     */
+    evictExpired(now?: number): number;
+    /**
+     * Returns `true` when the entry's TTL is within `withinMs` of expiring. The
+     * scheduler uses this to schedule idle-cycle prewarms just-in-time rather
+     * than at fixed wall-clock intervals.
+     */
+    isExpiringSoon(modelId: string, protocol: string, paymentMethod: string, withinMs: number, now?: number): boolean;
+    /**
+     * Snapshot all entries for diagnostics. Returns a deep-copy of the values
+     * so callers can serialize without risking mutation of cache state.
+     */
+    snapshot(): PrewarmEntry[];
+    /**
+     * List every cached key, decoded back into its (model, protocol, payment)
+     * triple. Used by `tb doctor` to render the prewarm table.
+     */
+    keys(): Array<{
+        modelId: string;
+        protocol: string;
+        paymentMethod: string;
+    }>;
+    size(): number;
+    clear(): void;
+}
+export interface PrewarmFreshness {
+    present: boolean;
+    expired: boolean;
+    expiringSoon: boolean;
+    remainingMs?: number;
+    state: PrewarmState;
+    entry?: PrewarmEntry;
+}
+export interface PrewarmBeginResult {
+    key: string;
+    entry: PrewarmEntry;
+    hadPrevious: boolean;
+}
+export interface PrewarmCommitResult {
+    key: string;
+    entry: PrewarmEntry;
+    replacedSellers: string[];
+}
+export {};
+//# sourceMappingURL=prewarm-cache.d.ts.map

package/dist/src/prewarm-cache.d.ts.map

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

package/dist/src/prewarm-cache.js

@@ -0,0 +1,288 @@
+import { createModuleLogger } from "@tokenbuddy/logging";
+const logger = createModuleLogger("tb-proxyd:prewarm-cache");
+/**
+ * Default TTL for a successfully warmed entry. 10 minutes is the v1.2 starting
+ * point; see buyer-driven-fallback-design.md §18.13 for the trade-off. The
+ * cache constructor accepts an override so tests and the future PR-E config
+ * loader can change this without re-architecting.
+ */
+export const DEFAULT_PREWARM_TTL_MS = 10 * 60 * 1000;
+/**
+ * Build the cache key for a (model, protocol, payment) triple. The colon
+ * separator is reserved at the model-id level because `RegistrySeller.models`
+ * entries are trimmed but not colon-escaped. v1.2 forbids `:` inside model
+ * ids so this format is collision-free.
+ */
+export function prewarmKey(modelId, protocol, paymentMethod) {
+    return `${modelId.trim().toLowerCase()}\u0001${protocol.trim().toLowerCase()}\u0001${paymentMethod.trim().toLowerCase()}`;
+}
+function parseKey(key) {
+    const parts = key.split("\u0001");
+    if (parts.length !== 3) {
+        return undefined;
+    }
+    const [modelId, protocol, paymentMethod] = parts;
+    if (!modelId || !protocol || !paymentMethod) {
+        return undefined;
+    }
+    return { modelId, protocol, paymentMethod };
+}
+export class PrewarmCache {
+    entries = new Map();
+    defaultTtlMs;
+    now;
+    constructor(options = {}) {
+        this.defaultTtlMs = options.defaultTtlMs ?? DEFAULT_PREWARM_TTL_MS;
+        this.now = options.now ?? Date.now;
+    }
+    /**
+     * Read an entry without mutating state. Returns `undefined` when the key is
+     * unknown; the caller decides whether "absent" should be treated as a miss
+     * (i.e. trigger a fresh prewarm) or as a known empty model.
+     */
+    get(modelId, protocol, paymentMethod) {
+        return this.entries.get(prewarmKey(modelId, protocol, paymentMethod));
+    }
+    /**
+     * Look up an entry and return a `Freshness` descriptor. This is the cheap
+     * path used on every inference request to decide whether a prewarm is
+     * still authoritative, expiring soon, or already stale.
+     */
+    freshness(modelId, protocol, paymentMethod) {
+        const entry = this.get(modelId, protocol, paymentMethod);
+        if (!entry) {
+            return { present: false, expired: true, expiringSoon: true, state: "empty" };
+        }
+        const now = this.now();
+        const ageMs = now - entry.warmedAt;
+        const expired = ageMs >= entry.ttlMs;
+        const remainingMs = Math.max(0, entry.ttlMs - ageMs);
+        return {
+            present: true,
+            expired,
+            expiringSoon: !expired && remainingMs <= entry.ttlMs * 0.1,
+            remainingMs,
+            state: expired ? "stale" : entry.state,
+            entry
+        };
+    }
+    /**
+     * Mark a (model, protocol, payment) triple as currently being warmed. If an
+     * existing warm entry is present it is kept untouched (the new probe
+     * supersedes it on commit) and the previous state is reported to the
+     * caller via the returned descriptor.
+     */
+    beginWarming(modelId, protocol, paymentMethod, ttlMs) {
+        const key = prewarmKey(modelId, protocol, paymentMethod);
+        const previous = this.entries.get(key);
+        const now = this.now();
+        const entry = {
+            modelId,
+            protocol,
+            paymentMethod,
+            state: "warming",
+            candidates: previous?.candidates ?? [],
+            warmedAt: previous?.warmedAt ?? now,
+            ttlMs: ttlMs ?? previous?.ttlMs ?? this.defaultTtlMs,
+            consecutiveWarmingFailures: previous?.consecutiveWarmingFailures ?? 0,
+            lastInFlightAt: now
+        };
+        this.entries.set(key, entry);
+        logger.debug("prewarm.cache.warming_started", "prewarm probe in flight", {
+            modelId,
+            protocol,
+            paymentMethod,
+            ttlMs: entry.ttlMs,
+            previousState: previous?.state
+        });
+        return { key, entry, hadPrevious: Boolean(previous) };
+    }
+    /**
+     * Commit a successful warm. The entry's `warmedAt` is reset to the current
+     * time so the TTL window starts fresh, and any prior stale candidates are
+     * replaced with the new probe results. The previous candidate set is
+     * returned for caller-side telemetry (e.g. detecting churn).
+     */
+    commitWarm(input) {
+        const key = prewarmKey(input.modelId, input.protocol, input.paymentMethod);
+        const previous = this.entries.get(key);
+        const now = this.now();
+        const next = {
+            modelId: input.modelId,
+            protocol: input.protocol,
+            paymentMethod: input.paymentMethod,
+            state: input.candidates.length > 0 ? "warm" : "empty",
+            candidates: input.candidates.map(toCandidate),
+            warmedAt: now,
+            ttlMs: input.ttlMs ?? previous?.ttlMs ?? this.defaultTtlMs,
+            consecutiveWarmingFailures: 0,
+            lastInFlightAt: now
+        };
+        this.entries.set(key, next);
+        if (input.candidates.length === 0) {
+            logger.warn("prewarm.cache.commit_empty", "prewarm commit returned no candidates", {
+                modelId: input.modelId,
+                protocol: input.protocol,
+                paymentMethod: input.paymentMethod
+            });
+        }
+        else {
+            logger.info("prewarm.cache.committed", "prewarm commit updated candidates", {
+                modelId: input.modelId,
+                protocol: input.protocol,
+                paymentMethod: input.paymentMethod,
+                candidateCount: next.candidates.length,
+                ttlMs: next.ttlMs
+            });
+        }
+        return {
+            key,
+            entry: next,
+            replacedSellers: previous?.candidates.map((c) => c.sellerId) ?? []
+        };
+    }
+    /**
+     * Mark a warm as failed. Consecutive failures are tracked so the scheduler
+     * can apply exponential backoff and so `tb doctor` can surface persistently
+     * broken models.
+     */
+    recordFailure(modelId, protocol, paymentMethod, errorMessage) {
+        const key = prewarmKey(modelId, protocol, paymentMethod);
+        const previous = this.entries.get(key);
+        if (!previous) {
+            return undefined;
+        }
+        const next = {
+            ...previous,
+            state: "stale",
+            consecutiveWarmingFailures: previous.consecutiveWarmingFailures + 1,
+            lastInFlightAt: this.now()
+        };
+        this.entries.set(key, next);
+        logger.warn("prewarm.cache.failure_recorded", "prewarm commit failed; entry marked stale", {
+            modelId,
+            protocol,
+            paymentMethod,
+            consecutiveFailures: next.consecutiveWarmingFailures,
+            errorMessage
+        });
+        return next;
+    }
+    /**
+     * Invalidate every entry that references the given seller. Used when the
+     * registry signals a seller is gone (grace period expires) or when a hard
+     * failure (e.g. 5xx storm) should drop the seller from the cache
+     * immediately.
+     */
+    invalidateSeller(sellerId) {
+        let removed = 0;
+        for (const [key, entry] of this.entries.entries()) {
+            const filtered = entry.candidates.filter((candidate) => candidate.sellerId !== sellerId);
+            if (filtered.length !== entry.candidates.length) {
+                removed += 1;
+                this.entries.set(key, {
+                    ...entry,
+                    candidates: filtered,
+                    state: filtered.length > 0 ? entry.state : "empty"
+                });
+            }
+        }
+        if (removed > 0) {
+            logger.info("prewarm.cache.seller_invalidated", "seller dropped from all prewarm entries", {
+                sellerId,
+                entriesAffected: removed
+            });
+        }
+        return removed;
+    }
+    /**
+     * Invalidate a specific cache key. Used by `tb doctor --refresh <model>`
+     * and by the registry loop when a model is removed from the focus set.
+     */
+    invalidateKey(modelId, protocol, paymentMethod) {
+        return this.entries.delete(prewarmKey(modelId, protocol, paymentMethod));
+    }
+    /**
+     * Drop every entry whose TTL has expired. Returns the number of removed
+     * entries so the caller can log it.
+     */
+    evictExpired(now = this.now()) {
+        let removed = 0;
+        for (const [key, entry] of this.entries.entries()) {
+            if (now - entry.warmedAt >= entry.ttlMs) {
+                this.entries.delete(key);
+                removed += 1;
+            }
+        }
+        if (removed > 0) {
+            logger.info("prewarm.cache.evicted", "expired prewarm entries evicted", { removed });
+        }
+        return removed;
+    }
+    /**
+     * Returns `true` when the entry's TTL is within `withinMs` of expiring. The
+     * scheduler uses this to schedule idle-cycle prewarms just-in-time rather
+     * than at fixed wall-clock intervals.
+     */
+    isExpiringSoon(modelId, protocol, paymentMethod, withinMs, now = this.now()) {
+        const entry = this.get(modelId, protocol, paymentMethod);
+        if (!entry) {
+            return false;
+        }
+        const age = now - entry.warmedAt;
+        return age >= entry.ttlMs - withinMs && age < entry.ttlMs;
+    }
+    /**
+     * Snapshot all entries for diagnostics. Returns a deep-copy of the values
+     * so callers can serialize without risking mutation of cache state.
+     */
+    snapshot() {
+        return Array.from(this.entries.values()).map((entry) => ({
+            ...entry,
+            candidates: entry.candidates.map((candidate) => ({ ...candidate }))
+        }));
+    }
+    /**
+     * List every cached key, decoded back into its (model, protocol, payment)
+     * triple. Used by `tb doctor` to render the prewarm table.
+     */
+    keys() {
+        const out = [];
+        for (const key of this.entries.keys()) {
+            const parsed = parseKey(key);
+            if (parsed) {
+                out.push(parsed);
+            }
+        }
+        return out;
+    }
+    size() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+function toCandidate(input) {
+    return {
+        sellerId: input.sellerId,
+        url: input.url,
+        healthScore: clampScore(input.healthScore ?? 50),
+        lastSuccessAt: input.lastSuccessAt ?? 0,
+        lastFailAt: input.lastFailAt ?? 0,
+        avgLatencyMs: Math.max(0, input.avgLatencyMs ?? 0)
+    };
+}
+function clampScore(score) {
+    if (!Number.isFinite(score)) {
+        return 50;
+    }
+    if (score < 0) {
+        return 0;
+    }
+    if (score > 100) {
+        return 100;
+    }
+    return score;
+}
+//# sourceMappingURL=prewarm-cache.js.map

package/dist/src/prewarm-cache.js.map

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

package/dist/src/prewarm-scheduler.d.ts

@@ -0,0 +1,150 @@
+import type { RegistrySeller } from "./seller-catalog.js";
+import type { ModelIndex } from "./model-index.js";
+import type { PrewarmCache } from "./prewarm-cache.js";
+export type PrewarmReason = "startup" | "lazy" | "idle" | "explicit";
+export interface ProbeResult {
+    ok: boolean;
+    latencyMs: number;
+    httpStatus?: number;
+    errorMessage?: string;
+}
+/**
+ * The probe function used by the scheduler. Decoupled so the scheduler can
+ * be unit-tested without spinning up HTTP servers. The default
+ * implementation in `health-probe.ts` (PR-2/PR-3) calls
+ * `GET <seller.url>/healthz` with a 3s `AbortSignal.timeout`. Probers must
+ * observe the provided `AbortSignal` and reject when it aborts so the
+ * scheduler can short-circuit in-flight probes on `stop()`.
+ */
+export type SellerProber = (seller: RegistrySeller, signal: AbortSignal) => Promise<ProbeResult>;
+export interface PrewarmSchedulerOptions {
+    modelIndex: ModelIndex;
+    cache: PrewarmCache;
+    prober: SellerProber;
+    concurrency?: number;
+    perSellerMinIntervalMs?: number;
+    maxPrewarmPerMinute?: number;
+    idleIntervalMs?: number;
+    startupJitterMinMs?: number;
+    startupJitterMaxMs?: number;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    random?: () => number;
+    now?: () => number;
+    protocol?: string;
+    paymentMethod?: string;
+}
+interface PrewarmTask {
+    id: number;
+    modelId: string;
+    reason: PrewarmReason;
+    protocol: string;
+    paymentMethod: string;
+    enqueuedAt: number;
+    sellerIds: string[];
+    startedAt?: number;
+    completedAt?: number;
+    status: "queued" | "running" | "succeeded" | "failed" | "canceled" | "rate_limited";
+    errorMessage?: string;
+}
+export interface PrewarmSchedulerStats {
+    queueDepth: number;
+    inFlight: number;
+    totalScheduled: number;
+    totalSucceeded: number;
+    totalFailed: number;
+    totalRateLimited: number;
+    recentProbesInLastMinute: number;
+    concurrency: number;
+    maxPrewarmPerMinute: number;
+}
+/**
+ * Background scheduler that warms up sellers for a (model, protocol,
+ * payment) triple on demand. The scheduler owns:
+ *   - queue management with bounded concurrency (default 4)
+ *   - per-seller rate limiting (default 30s between probes to the same
+ *     seller, even across different models)
+ *   - global rate limiting (default 30 probes/minute)
+ *   - jitter on startup and between probes to avoid thundering herds
+ *
+ * The scheduler does NOT own HTTP I/O; that lives in the injected
+ * `prober` so tests can swap in a deterministic stub.
+ */
+export declare class PrewarmScheduler {
+    private readonly modelIndex;
+    private readonly cache;
+    private readonly prober;
+    private readonly concurrency;
+    private readonly perSellerMinIntervalMs;
+    private readonly maxPrewarmPerMinute;
+    private readonly idleIntervalMs;
+    private readonly startupJitterMinMs;
+    private readonly startupJitterMaxMs;
+    private readonly sleep;
+    private readonly random;
+    private readonly now;
+    private readonly protocol;
+    private readonly paymentMethod;
+    private readonly queue;
+    private inFlight;
+    private recentProbes;
+    private lastProbeAtBySeller;
+    private nextTaskId;
+    private totalScheduled;
+    private totalSucceeded;
+    private totalFailed;
+    private totalRateLimited;
+    private abortController;
+    private idleLoopPromise;
+    constructor(options: PrewarmSchedulerOptions);
+    /**
+     * Start the background idle loop. Safe to call once per scheduler
+     * instance; subsequent calls are no-ops. The idle loop probes any cached
+     * entry whose TTL is within 10% of expiry (`isExpiringSoon`).
+     */
+    start(): void;
+    /**
+     * Cancel the idle loop and any pending tasks. Existing `inFlight` probes
+     * are not aborted (the prober owns its own timeout) but will not be
+     * dispatched to the cache.
+     */
+    stop(): Promise<void>;
+    /**
+     * Enqueue a prewarm for a (model, protocol, payment) triple. The
+     * `reason` controls how aggressively the scheduler resolves candidates
+     * (e.g. `startup` defers; `lazy` waits on the returned promise). The
+     * returned promise resolves with the final task status once the queue
+     * drains or the scheduler is stopped.
+     */
+    schedulePrewarm(input: {
+        modelId: string;
+        reason: PrewarmReason;
+        protocol?: string;
+        paymentMethod?: string;
+        blockOnFirst?: boolean;
+    }): Promise<PrewarmTask>;
+    /**
+     * Run a one-shot sweep that probes every focus-set model. Used by the
+     * `tb doctor --prewarm` explicit trigger and by the startup hook after
+     * the configured jitter window. Resolves once every scheduled task has
+     * reached a terminal state.
+     */
+    runStartupPrewarm(modelIds: string[]): Promise<void>;
+    /**
+     * Force a sweep of any cache key whose TTL is about to expire. Returns
+     * the number of tasks that were enqueued. Intended to be called from
+     * the registry loop's heartbeat (replaces the v1 "all sellers" probe
+     * cycle with "only the ones we are about to forget").
+     */
+    tickIdle(): number;
+    stats(): PrewarmSchedulerStats;
+    private jitterMs;
+    private runIdleLoop;
+    private dispatch;
+    private runTask;
+    private isOverBudget;
+    private recentProbesInLastMinute;
+    private recordProbeAttempt;
+    private isSellerRateLimited;
+}
+export {};
+//# sourceMappingURL=prewarm-scheduler.d.ts.map

package/dist/src/prewarm-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prewarm-scheduler.d.ts","sourceRoot":"","sources":["../../src/prewarm-scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AAIzE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAEjG,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IAErB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAC;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAE7B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,eAAe,CAA8B;gBAEzC,OAAO,EAAE,uBAAuB;IAiB5C;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,WAAW,CAAC;IA4CxB;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;IAkBlB,KAAK,IAAI,qBAAqB;IAiB9B,OAAO,CAAC,QAAQ;YAKF,WAAW;YAoBX,QAAQ;YAuDR,OAAO;IA4IrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;CAO5B"}