agent-nuvira 3.1.3 → 3.2.0

package/dist/learning/model-warmup.d.ts

@@ -24,21 +24,115 @@
  *   // ... later ...
  *   stopWarmupDaemon();
  */
+import { getModelRegistry } from './model-registry.js';
 import type { ConfigManager } from '../config/manager.js';
+/**
+ * Every bound this module spends against a free tier, in one place and
+ * OVERRIDABLE.
+ *
+ * These were module constants, which made the sweep's cost a property of the
+ * build rather than of the user's plan. The sweep is safe because it is bounded,
+ * so the bounds are exactly what an operator needs to see and tune — for a free
+ * tier one probe per cycle may be right, for a paid key tens are harmless. Env
+ * overrides keep that a configuration decision, never a source edit and a
+ * rebuild.
+ */
+export interface WarmupConfig {
+    /** How often the daemon runs a cycle (ms). */
+    intervalMs: number;
+    /** Minimum time between warmups of the same model (ms). */
+    warmThrottleMs: number;
+    /** Max HOT (already-in-use) models warmed per cycle. */
+    hotPerCycle: number;
+    /** Max NEVER-VERIFIED models spot-checked per cycle (the exploration budget). */
+    explorePerCycle: number;
+    /** Never re-probe the same unverified model more often than this (ms). */
+    exploreThrottleMs: number;
+    /** Models used within this window are "hot" (ms). */
+    hotWindowMs: number;
+    /** Models used within this window are "warm" (ms). */
+    warmWindowMs: number;
+}
+/**
+ * Resolve the sweep's bounds (env overrides → defaults).
+ *
+ * Read per call, not captured at import, so a test — or a long-running daemon
+ * whose env was set after boot — observes the value in force at that moment.
+ */
+export declare function warmupConfig(env?: NodeJS.ProcessEnv): WarmupConfig;
 /**
  * Record a model usage event.
  * Called after every successful LLM call to track which models are hot.
  */
 export declare function recordModelUsage(provider: string, model: string): void;
+interface WarmupCandidate {
+    provider: string;
+    model: string;
+    priority: number;
+}
 /**
  * Start the warmup daemon.
- * Runs periodically to keep frequently-used models warm.
+ * Runs periodically to keep frequently-used models warm — and to GROW the
+ * verified pool (see {@link selectExplorationCandidates}).
  */
-export declare function startWarmupDaemon(configManager: ConfigManager): void;
+export declare function startWarmupDaemon(configManager: ConfigManager, deps?: WarmupDeps): void;
 /**
  * Stop the warmup daemon.
  */
 export declare function stopWarmupDaemon(): void;
+/** What one cycle did — returned, so the caller reports it instead of guessing. */
+export interface WarmupCycleResult {
+    /** Hot models spot-checked (already in use — the original behaviour). */
+    warmed: number;
+    /** NEVER-VERIFIED models spot-checked to grow the routing pool. */
+    explored: number;
+    /** Spot-checks of either kind that came back `verified`. */
+    verified: number;
+    /** Hot candidates the per-cycle cap left for the next cycle. */
+    skipped: number;
+    /**
+     * True when the credential shape changed, so this cycle forced a full catalog
+     * re-probe before spot-checking. Reported because it explains why one cycle
+     * did noticeably more network work than its neighbours.
+     */
+    catalogRefreshed: boolean;
+}
+/** Injectable seams for tests — the real spot-check talks to a provider. */
+export interface WarmupDeps {
+    spotCheck?: (provider: string, model: string, cm: ConfigManager) => Promise<'verified' | 'unavailable' | 'skipped' | 'error'>;
+    /**
+     * Seam for the credential-change catalog re-probe. Defaults to the real
+     * `refreshModelRegistry`; injected so a test asserts the re-probe HAPPENS
+     * without any provider traffic.
+     */
+    refreshCatalog?: (cm: ConfigManager) => Promise<unknown>;
+    /** Seam for credential-change detection (defaults to the real sidecar). */
+    detectCredentialChange?: (cm: ConfigManager) => {
+        changed: boolean;
+    };
+}
+/**
+ * Pick unverified models worth a one-token spot-check — the models the router
+ * cannot currently see.
+ *
+ * The ORDER is the fix. Providers with the FEWEST verified models come first,
+ * because that is where the routing pool is thinnest: broadening a *provider*
+ * is what breaks winner-take-all, while verifying a thirteenth model on the
+ * provider that already wins every pick changes nothing about how the agent
+ * behaves. Unservable providers are excluded outright, so a cycle can never
+ * spend its whole budget on something that cannot answer.
+ */
+export declare function selectExplorationCandidates(registry: ReturnType<typeof getModelRegistry>, configManager: ConfigManager, now: number, limit: number): WarmupCandidate[];
+/**
+ * Run one warmup cycle: keep hot models warm, and grow the verified pool.
+ *
+ * Both halves matter and neither is optional. The hot half keeps in-use models
+ * from going stale; the exploration half is what stops the pool from freezing —
+ * and note it runs even when `usageMap` is empty, which is exactly the state of
+ * a fresh process (the old `if (records.length === 0) return;` made the first
+ * cycle of every short-lived CLI run a no-op).
+ */
+export declare function runWarmupCycle(configManager: ConfigManager, deps?: WarmupDeps): Promise<WarmupCycleResult>;
 /**
  * Get warmup statistics (for dashboard display).
  */
@@ -58,4 +152,5 @@ export declare function getTrackedModels(): Array<{
     useCount: number;
     status: 'hot' | 'warm' | 'cold';
 }>;
+export {};
 //# sourceMappingURL=model-warmup.d.ts.map

package/dist/learning/model-warmup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-warmup.d.ts","sourceRoot":"","sources":["../../src/learning/model-warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoC1D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CActE;AA2DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAcpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAwED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAmBA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACjC,CAAC,CAgBD"}
+{"version":3,"file":"model-warmup.d.ts","sourceRoot":"","sources":["../../src/learning/model-warmup.ts"],"names":[],"mappings":"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"}

package/dist/learning/model-warmup.js

@@ -25,19 +25,34 @@
  *   stopWarmupDaemon();
  */
 import { getModelRegistry } from './model-registry.js';
-import { spotCheckModel } from '../inference/model-probe.js';
+import { spotCheckModel, refreshModelRegistry } from '../inference/model-probe.js';
+import { detectCredentialChange } from './credential-fingerprint.js';
+import { ProviderFactory } from '../inference/factory.js';
 import { logger } from '../utils/logger.js';
-// ─── Configuration ──────────────────────────────────────────────────────────
-/** How often to run the warmup cycle (ms). */
-const WARMUP_INTERVAL_MS = 60_000; // 1 minute
-/** Minimum time between warmups of the same model (ms). */
-const WARMUP_THROTTLE_MS = 300_000; // 5 minutes
-/** Maximum models to warm up per cycle. */
-const MAX_WARMUPS_PER_CYCLE = 10;
-/** Models used within this window are considered "hot" (ms). */
-const HOT_WINDOW_MS = 30_600_000; // ~8.5 hours
-/** Models used within this window are considered "warm" (ms). */
-const WARM_WINDOW_MS = 86_400_000; // 24 hours
+/** Parse a positive-integer env override; anything else falls back. */
+function positiveInt(raw, fallback) {
+    if (raw === undefined || raw.trim() === '')
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : fallback;
+}
+/**
+ * Resolve the sweep's bounds (env overrides → defaults).
+ *
+ * Read per call, not captured at import, so a test — or a long-running daemon
+ * whose env was set after boot — observes the value in force at that moment.
+ */
+export function warmupConfig(env = process.env) {
+    return {
+        intervalMs: positiveInt(env.NUVIRA_WARMUP_INTERVAL_MS, 60_000),
+        warmThrottleMs: positiveInt(env.NUVIRA_WARMUP_THROTTLE_MS, 300_000),
+        hotPerCycle: positiveInt(env.NUVIRA_WARMUP_HOT_PER_CYCLE, 10),
+        explorePerCycle: positiveInt(env.NUVIRA_WARMUP_EXPLORE_PER_CYCLE, 6),
+        exploreThrottleMs: positiveInt(env.NUVIRA_WARMUP_EXPLORE_THROTTLE_MS, 600_000),
+        hotWindowMs: positiveInt(env.NUVIRA_WARMUP_HOT_WINDOW_MS, 30_600_000),
+        warmWindowMs: positiveInt(env.NUVIRA_WARMUP_WARM_WINDOW_MS, 86_400_000),
+    };
+}
 /** In-memory usage tracker (persisted to registry via telemetry). */
 const usageMap = new Map();
 function usageKey(provider, model) {
@@ -75,7 +90,7 @@ function scoreWarmupPriority(record, registryEntry) {
     const now = Date.now();
     // Recency score: 0-1 (1 = just used, 0 = used long ago)
     const timeSinceUse = now - record.lastUsedAt;
-    const recencyScore = Math.max(0, 1 - (timeSinceUse / HOT_WINDOW_MS));
+    const recencyScore = Math.max(0, 1 - (timeSinceUse / warmupConfig().hotWindowMs));
     // Frequency score: 0-1 (1 = used many times)
     const frequencyScore = Math.min(1, record.useCount / 100);
     // Verification score: verified = 1, unverified = 0.5, unavailable = 0
@@ -103,21 +118,32 @@ let warmupTimer = null;
 let isRunning = false;
 /**
  * Start the warmup daemon.
- * Runs periodically to keep frequently-used models warm.
+ * Runs periodically to keep frequently-used models warm — and to GROW the
+ * verified pool (see {@link selectExplorationCandidates}).
  */
-export function startWarmupDaemon(configManager) {
+export function startWarmupDaemon(configManager, deps = {}) {
     if (warmupTimer)
         return; // Already running
-    logger.info('[warmup] Starting model warmup daemon');
+    const intervalMs = warmupConfig().intervalMs;
+    logger.info(`[warmup] Starting model warmup daemon (every ${intervalMs}ms)`);
     warmupTimer = setInterval(() => {
         if (!isRunning) {
             isRunning = true;
-            runWarmupCycle(configManager).finally(() => { isRunning = false; });
+            runWarmupCycle(configManager, deps).finally(() => { isRunning = false; });
         }
-    }, WARMUP_INTERVAL_MS);
+    }, intervalMs);
+    // The daemon must never hold the process open.
+    //
+    // Without this, starting it on a normal run would hang every CLI command
+    // forever — which is why it was only ever started from the COLD-START branch
+    // (`getUsableProviders().length === 0`). That made the whole module dead in
+    // practice: once ANY model was verified, nothing ever warmed or verified
+    // another one. `unref()` is the same idiom the model probe already uses, and
+    // it is what makes starting this on every run safe.
+    warmupTimer.unref?.();
     // Run first cycle immediately
     isRunning = true;
-    runWarmupCycle(configManager).finally(() => { isRunning = false; });
+    runWarmupCycle(configManager, deps).finally(() => { isRunning = false; });
 }
 /**
  * Stop the warmup daemon.
@@ -129,63 +155,140 @@ export function stopWarmupDaemon() {
         logger.info('[warmup] Stopped model warmup daemon');
     }
 }
+/** Can this provider actually serve? Real adapter + credentials. */
+function isServable(provider, configManager) {
+    try {
+        if (!ProviderFactory.isConstructible(provider))
+            return false;
+        return configManager.hasRequiredCredentials(provider) === true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Pick unverified models worth a one-token spot-check — the models the router
+ * cannot currently see.
+ *
+ * The ORDER is the fix. Providers with the FEWEST verified models come first,
+ * because that is where the routing pool is thinnest: broadening a *provider*
+ * is what breaks winner-take-all, while verifying a thirteenth model on the
+ * provider that already wins every pick changes nothing about how the agent
+ * behaves. Unservable providers are excluded outright, so a cycle can never
+ * spend its whole budget on something that cannot answer.
+ */
+export function selectExplorationCandidates(registry, configManager, now, limit) {
+    if (limit <= 0)
+        return [];
+    const rows = [];
+    const exploreThrottleMs = warmupConfig().exploreThrottleMs;
+    for (const provider of registry.getTrackedProviders()) {
+        if (!isServable(provider, configManager))
+            continue;
+        const verifiedInProvider = registry.getProviderStats(provider).verified;
+        for (const entry of registry.getAllModelsForProvider(provider)) {
+            if (entry.status !== 'unverified')
+                continue;
+            // The config sentinel is not a model id (same guard the router uses).
+            if (!entry.model || entry.model === 'default')
+                continue;
+            if (entry.quotaParkedUntil > now)
+                continue;
+            if (now - (entry.lastProbedAt ?? 0) < exploreThrottleMs)
+                continue;
+            rows.push({ provider, model: entry.model, priority: -verifiedInProvider, verifiedInProvider });
+        }
+    }
+    rows.sort((a, b) => a.verifiedInProvider - b.verifiedInProvider ||
+        a.provider.localeCompare(b.provider) ||
+        a.model.localeCompare(b.model));
+    return rows.slice(0, limit).map(({ provider, model, priority }) => ({ provider, model, priority }));
+}
 /**
- * Run one warmup cycle.
+ * Run one warmup cycle: keep hot models warm, and grow the verified pool.
+ *
+ * Both halves matter and neither is optional. The hot half keeps in-use models
+ * from going stale; the exploration half is what stops the pool from freezing —
+ * and note it runs even when `usageMap` is empty, which is exactly the state of
+ * a fresh process (the old `if (records.length === 0) return;` made the first
+ * cycle of every short-lived CLI run a no-op).
  */
-async function runWarmupCycle(configManager) {
+export async function runWarmupCycle(configManager, deps = {}) {
     const registry = getModelRegistry();
     const now = Date.now();
-    // Get all usage records
-    const records = Array.from(usageMap.values());
-    if (records.length === 0)
-        return;
-    // Score and sort by priority
-    const candidates = [];
-    for (const record of records) {
-        // Skip if warmed up recently
-        const key = usageKey(record.provider, record.model);
+    const cfg = warmupConfig();
+    const spotCheck = deps.spotCheck ?? spotCheckModel;
+    const result = {
+        warmed: 0,
+        explored: 0,
+        verified: 0,
+        skipped: 0,
+        catalogRefreshed: false,
+    };
+    // ── Half 0: did the KEY SET change since the last run? ──────────────────
+    // The pool can only hold models a probe has verified, and there is no
+    // per-model entitlement API to ask — so the one case a user notices ("I just
+    // bought credits, where are the models?") was invisible until an unrelated
+    // cold start happened to re-probe. Noticing the change and forcing the probe
+    // is cheap and idempotent, and it fires ONCE per change (the sidecar records
+    // the new shape before returning).
+    try {
+        const detect = deps.detectCredentialChange ?? detectCredentialChange;
+        if (detect(configManager).changed) {
+            const refresh = deps.refreshCatalog ?? ((cm) => refreshModelRegistry(cm, { spotCheck: true }));
+            result.catalogRefreshed = true;
+            logger.info('[warmup] Credentials changed — re-probing the catalog');
+            await refresh(configManager);
+        }
+    }
+    catch {
+        // Best-effort — a failed re-probe must never break warmup.
+    }
+    // ── Half 1: models already in use (hot → keep them warm) ────────────────
+    const hot = [];
+    for (const record of usageMap.values()) {
         const entry = registry.getEntry(record.provider, record.model);
-        if (entry && entry.lastUsedAt && now - entry.lastUsedAt < WARMUP_THROTTLE_MS) {
+        if (entry && entry.lastUsedAt && now - entry.lastUsedAt < cfg.warmThrottleMs)
             continue;
-        }
-        // Skip unavailable models
         if (entry?.status === 'unavailable')
             continue;
-        // Skip if not used recently enough
-        if (now - record.lastUsedAt > WARM_WINDOW_MS)
+        if (now - record.lastUsedAt > cfg.warmWindowMs)
             continue;
         const priority = scoreWarmupPriority(record, entry);
-        if (priority > 0.1) { // Minimum threshold
-            candidates.push({
-                provider: record.provider,
-                model: record.model,
-                priority,
-            });
-        }
+        if (priority > 0.1)
+            hot.push({ provider: record.provider, model: record.model, priority });
     }
-    // Sort by priority (highest first)
-    candidates.sort((a, b) => b.priority - a.priority);
-    // Warm up top N models
-    const toWarmup = candidates.slice(0, MAX_WARMUPS_PER_CYCLE);
-    if (toWarmup.length === 0)
-        return;
-    logger.debug(`[warmup] Warming up ${toWarmup.length} models`);
-    for (const candidate of toWarmup) {
+    hot.sort((a, b) => b.priority - a.priority);
+    const toWarm = hot.slice(0, cfg.hotPerCycle);
+    result.skipped = hot.length - toWarm.length;
+    // ── Half 2: never-verified models (the pool the router cannot see) ──────
+    const exploration = selectExplorationCandidates(registry, configManager, now, cfg.explorePerCycle);
+    const exploreKeys = new Set(exploration.map((c) => usageKey(c.provider, c.model)));
+    const cycle = [...toWarm, ...exploration];
+    if (cycle.length === 0)
+        return result;
+    logger.debug(`[warmup] ${toWarm.length} hot · ${exploration.length} unverified candidates`);
+    for (const candidate of cycle) {
+        const key = usageKey(candidate.provider, candidate.model);
         try {
-            const result = await spotCheckModel(candidate.provider, candidate.model, configManager);
-            if (result === 'verified') {
-                // Update usage record
-                const key = usageKey(candidate.provider, candidate.model);
+            const outcome = await spotCheck(candidate.provider, candidate.model, configManager);
+            if (outcome === 'verified')
+                result.verified += 1;
+            if (exploreKeys.has(key))
+                result.explored += 1;
+            else
+                result.warmed += 1;
+            if (outcome === 'verified') {
                 const record = usageMap.get(key);
-                if (record) {
+                if (record)
                     record.lastUsedAt = now; // Reset the clock
-                }
             }
         }
         catch {
             // Best-effort — warmup must never break routing
         }
     }
+    return result;
 }
 // ─── Statistics ─────────────────────────────────────────────────────────────
 /**
@@ -193,14 +296,15 @@ async function runWarmupCycle(configManager) {
  */
 export function getWarmupStats() {
     const now = Date.now();
+    const cfg = warmupConfig();
     const records = Array.from(usageMap.values());
     let hotModels = 0;
     let warmModels = 0;
     for (const record of records) {
         const timeSinceUse = now - record.lastUsedAt;
-        if (timeSinceUse < HOT_WINDOW_MS)
+        if (timeSinceUse < cfg.hotWindowMs)
             hotModels++;
-        else if (timeSinceUse < WARM_WINDOW_MS)
+        else if (timeSinceUse < cfg.warmWindowMs)
             warmModels++;
     }
     return {
@@ -215,12 +319,13 @@ export function getWarmupStats() {
  */
 export function getTrackedModels() {
     const now = Date.now();
+    const cfg = warmupConfig();
     return Array.from(usageMap.values()).map(record => {
         const timeSinceUse = now - record.lastUsedAt;
         let status = 'cold';
-        if (timeSinceUse < HOT_WINDOW_MS)
+        if (timeSinceUse < cfg.hotWindowMs)
             status = 'hot';
-        else if (timeSinceUse < WARM_WINDOW_MS)
+        else if (timeSinceUse < cfg.warmWindowMs)
             status = 'warm';
         return {
             provider: record.provider,

package/dist/learning/model-warmup.js.map

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

package/dist/learning/prompt-layers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Prompt layers — deterministic splitting of a composed prompt into the
+ * layers that matter for review (enterprise hardening, session 3).
+ *
+ * WHY THIS EXISTS (the prompt audit of the last 30 traces):
+ * The trace stored ONE flat `promptPreview` capped at 300–500 chars, and for
+ * chat turns the preview deliberately shortened the system prompt to its first
+ * 80 characters. Result: in 106/106 chat steps the single most important
+ * artifact — the system prompt (persona, tool contract, response rules) — was
+ * INVISIBLE, and `promptDigest` hashed the whole thread so it could not show
+ * whether the stable layer was byte-stable (i.e. cacheable). Prompt
+ * engineering was, in practice, unreviewable.
+ *
+ * This module answers three questions from a flat prompt string, with no LLM
+ * and no caller changes:
+ *   1. Which bytes are the STABLE layer (identity / contract)?
+ *   2. Which are CONTEXT (project knowledge, recalled state, history, tools)?
+ *   3. Which are VOLATILE (the current task / ask)?
+ *
+ * Two transports are recognised because the codebase composes prompts two ways:
+ *   - the chat thread serialisation: `[System]` / `[User]` / `[Assistant]` /
+ *     `[Tool result]` markers (see `chat.ts` callModelWithTrace);
+ *   - the layered assembler: `# Project Context` … `## Task` headings
+ *     (see `agents/prompt-assembly.ts` assemblePrompt).
+ * Anything else falls back to a single `system` layer so a digest still detects
+ * change even when the shape is unknown.
+ */
+export interface PromptLayers {
+    /** Stable layer — identity, tool contract, tool guidance. */
+    system: string;
+    /** Context layer — project assessment, knowledge, recalled state, history. */
+    context: string;
+    /** Volatile layer — the current task / ask. */
+    volatile: string;
+}
+/** Per-layer digest + size record stored on a trace step. */
+export interface PromptLayerDigests {
+    systemDigest: string;
+    contextDigest: string;
+    volatileDigest: string;
+    systemChars: number;
+    contextChars: number;
+    volatileChars: number;
+}
+/**
+ * Split a composed prompt into its stable / context / volatile layers.
+ * Deterministic and transport-aware; never throws.
+ */
+export declare function splitPromptLayers(text: string): PromptLayers;
+/**
+ * Per-layer digests + sizes. The three digests SEPARATELY answer the review
+ * question the flat digest could not: did the stable layer change between
+ * steps (a cache-busting regression), or only the volatile one (expected)?
+ */
+export declare function digestPromptLayers(layers: PromptLayers): PromptLayerDigests;
+/** Convenience: split + digest in one call. */
+export declare function digestPrompt(text: string): {
+    layers: PromptLayers;
+    digests: PromptLayerDigests;
+};
+//# sourceMappingURL=prompt-layers.d.ts.map

package/dist/learning/prompt-layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-layers.d.ts","sourceRoot":"","sources":["../../src/learning/prompt-layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AA+ED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAS3E;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAGhG"}