@trillboards/edge-core 0.2.1 → 0.2.3

package/dist/MemoryAttenuationManager.js

@@ -0,0 +1,400 @@
+"use strict";
+/**
+ * MemoryAttenuationManager — Monitors V8 heap and OS memory, applies tiered
+ * shedding to keep edge devices stable under pressure.
+ *
+ * Port of CTV agent's MemoryAttenuationManager.kt, adapted for the V8 heap
+ * model. Uses `process.memoryUsage()` for heap metrics and `os.freemem()` /
+ * `os.totalmem()` for system-level awareness.
+ *
+ * Tiers (based on heap usage percentage = heapUsed / heapTotal):
+ *   GREEN    — Normal operation, all systems active
+ *   YELLOW   — >70% heap — disable cloud inference
+ *   ORANGE   — >80% heap — disable federated learning, reduce FPS
+ *   RED      — >90% heap — shed lowest-priority models (one per cycle)
+ *   CRITICAL — >95% heap — camera-only emergency mode, force GC
+ *
+ * Hysteresis prevents oscillation: a tier is only restored when usage drops
+ * a configurable percentage (default 15%) below the threshold that triggered
+ * escalation. For example, YELLOW triggers at 70% but only restores to GREEN
+ * when usage falls below 55%.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAttenuationManager = exports.MemoryTier = void 0;
+const events_1 = require("events");
+const os = __importStar(require("os"));
+// ─── Public Types ───────────────────────────────────────────────────────────
+var MemoryTier;
+(function (MemoryTier) {
+    MemoryTier["GREEN"] = "GREEN";
+    MemoryTier["YELLOW"] = "YELLOW";
+    MemoryTier["ORANGE"] = "ORANGE";
+    MemoryTier["RED"] = "RED";
+    MemoryTier["CRITICAL"] = "CRITICAL";
+})(MemoryTier || (exports.MemoryTier = MemoryTier = {}));
+// ─── Internal Constants ─────────────────────────────────────────────────────
+const MB = 1024 * 1024;
+const MAX_HISTORY = 100;
+const MAX_ACTIONS = 200;
+const DEFAULT_CHECK_INTERVAL_MS = 10000;
+const DEFAULT_YELLOW_THRESHOLD = 0.70;
+const DEFAULT_ORANGE_THRESHOLD = 0.80;
+const DEFAULT_RED_THRESHOLD = 0.90;
+const DEFAULT_CRITICAL_THRESHOLD = 0.95;
+const DEFAULT_HYSTERESIS_PERCENT = 0.15;
+const DEFAULT_NORMAL_FPS = 8;
+const DEFAULT_REDUCED_FPS = 2;
+const DEFAULT_SHED_ORDER = [
+    'yamnet',
+    'whisperAsr',
+    'ferEmotion',
+    'poseEngagement',
+    'ageGender',
+    'gazeTracking',
+];
+/**
+ * Ordered tier list from lowest severity to highest. Used for comparison
+ * and iteration when escalating or restoring.
+ */
+const TIER_SEVERITY = [
+    MemoryTier.GREEN,
+    MemoryTier.YELLOW,
+    MemoryTier.ORANGE,
+    MemoryTier.RED,
+    MemoryTier.CRITICAL,
+];
+function tierIndex(tier) {
+    return TIER_SEVERITY.indexOf(tier);
+}
+// ─── Implementation ─────────────────────────────────────────────────────────
+class MemoryAttenuationManager extends events_1.EventEmitter {
+    constructor(options) {
+        super();
+        // Runtime state
+        this.currentTier = MemoryTier.GREEN;
+        this.intervalHandle = null;
+        this.history = [];
+        this.actions = [];
+        // Tracked attenuation state — what we have already told callers to do
+        this.cloudInferenceDisabled = false;
+        this.federatedLearningDisabled = false;
+        this.fpsReduced = false;
+        this.shedModels = new Set();
+        this.emergencyModeActive = false;
+        this.callbacks = options.callbacks;
+        this.checkIntervalMs = options.checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+        this.yellowThreshold = options.yellowThreshold ?? DEFAULT_YELLOW_THRESHOLD;
+        this.orangeThreshold = options.orangeThreshold ?? DEFAULT_ORANGE_THRESHOLD;
+        this.redThreshold = options.redThreshold ?? DEFAULT_RED_THRESHOLD;
+        this.criticalThreshold = options.criticalThreshold ?? DEFAULT_CRITICAL_THRESHOLD;
+        this.hysteresisPercent = options.hysteresisPercent ?? DEFAULT_HYSTERESIS_PERCENT;
+        this.normalFps = options.normalFps ?? DEFAULT_NORMAL_FPS;
+        this.reducedFps = options.reducedFps ?? DEFAULT_REDUCED_FPS;
+        this.shedOrder = options.shedOrder ? [...options.shedOrder] : [...DEFAULT_SHED_ORDER];
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────
+    /**
+     * Start the periodic memory monitoring interval. The timer is `unref()`'d
+     * so it will not keep the Node.js event loop alive on its own.
+     */
+    start() {
+        if (this.intervalHandle !== null)
+            return;
+        this.intervalHandle = setInterval(() => this.check(), this.checkIntervalMs);
+        this.intervalHandle.unref();
+    }
+    /** Stop the periodic monitoring interval. */
+    stop() {
+        if (this.intervalHandle !== null) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+    }
+    /** Return the current memory tier. */
+    getCurrentTier() {
+        return this.currentTier;
+    }
+    /** Take a point-in-time memory snapshot (does NOT trigger actions). */
+    getSnapshot() {
+        return this.takeSnapshot();
+    }
+    /** Return the last N snapshots (up to 100). */
+    getHistory() {
+        return [...this.history];
+    }
+    /** Return the list of model names currently shed. */
+    getShedModels() {
+        return [...this.shedModels];
+    }
+    /** Return the full log of attenuation actions taken. */
+    getActions() {
+        return [...this.actions];
+    }
+    // ─── Core Check Loop ───────────────────────────────────────────────────
+    /**
+     * Single check cycle. Exposed as package-internal so tests can drive it
+     * deterministically without timers.
+     */
+    check() {
+        const snapshot = this.takeSnapshot();
+        // Record history (ring buffer, capped at MAX_HISTORY)
+        this.history.push(snapshot);
+        if (this.history.length > MAX_HISTORY) {
+            this.history.shift();
+        }
+        const newTier = this.classifyTier(snapshot.heapUsedPercent);
+        if (newTier !== this.currentTier) {
+            const previousTier = this.currentTier;
+            this.currentTier = newTier;
+            snapshot.tier = newTier;
+            // Apply actions for every step between old and new tier
+            const oldIdx = tierIndex(previousTier);
+            const newIdx = tierIndex(newTier);
+            if (newIdx > oldIdx) {
+                // Escalating — apply each step from old+1 up to new
+                for (let i = oldIdx + 1; i <= newIdx; i++) {
+                    this.applyEscalation(TIER_SEVERITY[i]);
+                }
+            }
+            else {
+                // Restoring — apply each step from old-1 down to new
+                for (let i = oldIdx - 1; i >= newIdx; i--) {
+                    this.applyRestoration(TIER_SEVERITY[i]);
+                }
+            }
+            this.emit('tierChanged', {
+                from: previousTier,
+                to: newTier,
+                snapshot,
+            });
+        }
+        else if (newTier === MemoryTier.RED) {
+            // While staying in RED, shed one more model per cycle if available
+            this.shedNextModel();
+        }
+    }
+    // ─── Tier Classification (with hysteresis) ─────────────────────────────
+    /**
+     * Classify a heap usage percentage into a MemoryTier, applying hysteresis
+     * to prevent oscillation at tier boundaries.
+     *
+     * Escalation uses the raw threshold (jumps to the highest applicable tier).
+     * Restoration requires the usage to drop below `threshold - hysteresisPercent`
+     * at each boundary, and walks down through all qualifying tiers in a single
+     * check. For example with default settings:
+     *   - Escalate to YELLOW at 70%, restore to GREEN below 55% (70 - 15)
+     *   - Escalate to ORANGE at 80%, restore to YELLOW below 65% (80 - 15)
+     *   - Escalate to RED at 90%, restore to ORANGE below 75% (90 - 15)
+     *   - Escalate to CRITICAL at 95%, restore to RED below 80% (95 - 15)
+     */
+    classifyTier(heapUsedPercent) {
+        const currentIdx = tierIndex(this.currentTier);
+        // Check for escalation (use raw thresholds, jump to highest applicable)
+        if (heapUsedPercent >= this.criticalThreshold * 100 && currentIdx < tierIndex(MemoryTier.CRITICAL)) {
+            return MemoryTier.CRITICAL;
+        }
+        if (heapUsedPercent >= this.redThreshold * 100 && currentIdx < tierIndex(MemoryTier.RED)) {
+            return MemoryTier.RED;
+        }
+        if (heapUsedPercent >= this.orangeThreshold * 100 && currentIdx < tierIndex(MemoryTier.ORANGE)) {
+            return MemoryTier.ORANGE;
+        }
+        if (heapUsedPercent >= this.yellowThreshold * 100 && currentIdx < tierIndex(MemoryTier.YELLOW)) {
+            return MemoryTier.YELLOW;
+        }
+        // Check for restoration — walk downward through each tier boundary,
+        // applying hysteresis at each step. This allows multi-step drops in a
+        // single check when memory falls far enough.
+        const hysteresisThresholds = [
+            { tier: MemoryTier.CRITICAL, restoreBelow: (this.criticalThreshold - this.hysteresisPercent) * 100 },
+            { tier: MemoryTier.RED, restoreBelow: (this.redThreshold - this.hysteresisPercent) * 100 },
+            { tier: MemoryTier.ORANGE, restoreBelow: (this.orangeThreshold - this.hysteresisPercent) * 100 },
+            { tier: MemoryTier.YELLOW, restoreBelow: (this.yellowThreshold - this.hysteresisPercent) * 100 },
+        ];
+        let resolvedTier = this.currentTier;
+        for (const { tier, restoreBelow } of hysteresisThresholds) {
+            if (resolvedTier === tier && heapUsedPercent < restoreBelow) {
+                // Drop one level
+                const idx = tierIndex(tier);
+                resolvedTier = TIER_SEVERITY[idx - 1];
+            }
+        }
+        return resolvedTier;
+    }
+    // ─── Escalation Actions ────────────────────────────────────────────────
+    /** Apply the actions for entering a given tier (escalating). */
+    applyEscalation(tier) {
+        switch (tier) {
+            case MemoryTier.YELLOW:
+                if (!this.cloudInferenceDisabled) {
+                    this.cloudInferenceDisabled = true;
+                    this.callbacks.onDisableCloudInference();
+                    this.recordAction(tier, 'disable_cloud_inference');
+                }
+                break;
+            case MemoryTier.ORANGE:
+                if (!this.federatedLearningDisabled) {
+                    this.federatedLearningDisabled = true;
+                    this.callbacks.onDisableFederatedLearning();
+                    this.recordAction(tier, 'disable_federated_learning');
+                }
+                if (!this.fpsReduced) {
+                    this.fpsReduced = true;
+                    this.callbacks.onReduceSensingFps(this.reducedFps);
+                    this.recordAction(tier, `reduce_fps_to_${this.reducedFps}`);
+                }
+                break;
+            case MemoryTier.RED:
+                this.shedNextModel();
+                break;
+            case MemoryTier.CRITICAL:
+                if (!this.emergencyModeActive) {
+                    this.emergencyModeActive = true;
+                    this.callbacks.onEmergencyMode();
+                    this.recordAction(tier, 'emergency_mode');
+                }
+                // Attempt GC if exposed via --expose-gc
+                if (typeof global.gc === 'function') {
+                    global.gc();
+                }
+                this.callbacks.onForceGC();
+                this.recordAction(tier, 'force_gc');
+                break;
+            case MemoryTier.GREEN:
+                // No escalation action for GREEN
+                break;
+        }
+    }
+    // ─── Restoration Actions ───────────────────────────────────────────────
+    /**
+     * Apply the restoration actions for entering a given tier (de-escalating).
+     * `tier` is the tier we are *entering* on the way down.
+     */
+    applyRestoration(tier) {
+        switch (tier) {
+            case MemoryTier.RED:
+                // Leaving CRITICAL → RED: restore emergency mode
+                if (this.emergencyModeActive) {
+                    this.emergencyModeActive = false;
+                    this.recordAction(tier, 'exit_emergency_mode');
+                }
+                break;
+            case MemoryTier.ORANGE:
+                // Leaving RED → ORANGE: restore all shed models in reverse order
+                this.restoreAllShedModels();
+                break;
+            case MemoryTier.YELLOW:
+                // Leaving ORANGE → YELLOW: restore FPS and federated learning
+                if (this.fpsReduced) {
+                    this.fpsReduced = false;
+                    this.callbacks.onRestoreSensingFps(this.normalFps);
+                    this.recordAction(tier, `restore_fps_to_${this.normalFps}`);
+                }
+                if (this.federatedLearningDisabled) {
+                    this.federatedLearningDisabled = false;
+                    this.callbacks.onEnableFederatedLearning();
+                    this.recordAction(tier, 'enable_federated_learning');
+                }
+                break;
+            case MemoryTier.GREEN:
+                // Leaving YELLOW → GREEN: restore cloud inference
+                if (this.cloudInferenceDisabled) {
+                    this.cloudInferenceDisabled = false;
+                    this.callbacks.onEnableCloudInference();
+                    this.recordAction(tier, 'enable_cloud_inference');
+                }
+                this.callbacks.onRestoreNormal();
+                this.recordAction(tier, 'restore_normal');
+                break;
+            case MemoryTier.CRITICAL:
+                // No restoration for entering CRITICAL (only escalation)
+                break;
+        }
+    }
+    // ─── Model Shedding ───────────────────────────────────────────────────
+    /**
+     * Shed the next model in the shed order. Models are shed from the *end*
+     * of `shedOrder` (lowest priority) toward the beginning (highest priority).
+     * One model per call.
+     */
+    shedNextModel() {
+        // Walk backwards from end of shedOrder, skipping already-shed models
+        for (let i = this.shedOrder.length - 1; i >= 0; i--) {
+            const model = this.shedOrder[i];
+            if (!this.shedModels.has(model)) {
+                this.shedModels.add(model);
+                this.callbacks.onShedModel(model);
+                this.recordAction(MemoryTier.RED, `shed_model_${model}`);
+                return;
+            }
+        }
+        // All models already shed — nothing more to do
+    }
+    /**
+     * Restore all shed models in reverse order (highest priority first,
+     * i.e., from the beginning of `shedOrder`).
+     */
+    restoreAllShedModels() {
+        // Restore in forward order through shedOrder (most important first)
+        for (const model of this.shedOrder) {
+            if (this.shedModels.has(model)) {
+                this.shedModels.delete(model);
+                this.callbacks.onRestoreModel(model);
+                this.recordAction(MemoryTier.ORANGE, `restore_model_${model}`);
+            }
+        }
+    }
+    // ─── Snapshot / Recording ──────────────────────────────────────────────
+    takeSnapshot() {
+        const mem = process.memoryUsage();
+        const osTotalBytes = os.totalmem();
+        const osFreeBytes = os.freemem();
+        const osUsedBytes = osTotalBytes - osFreeBytes;
+        return {
+            heapUsedMb: Math.round((mem.heapUsed / MB) * 100) / 100,
+            heapTotalMb: Math.round((mem.heapTotal / MB) * 100) / 100,
+            heapUsedPercent: Math.round((mem.heapUsed / mem.heapTotal) * 10000) / 100,
+            rssUsedMb: Math.round((mem.rss / MB) * 100) / 100,
+            osFreeMemMb: Math.round((osFreeBytes / MB) * 100) / 100,
+            osTotalMemMb: Math.round((osTotalBytes / MB) * 100) / 100,
+            osUsedPercent: Math.round((osUsedBytes / osTotalBytes) * 10000) / 100,
+            tier: this.currentTier,
+            timestamp: Date.now(),
+        };
+    }
+    recordAction(tier, action) {
+        this.actions.push({
+            tier,
+            action,
+            timestamp: Date.now(),
+        });
+        if (this.actions.length > MAX_ACTIONS) {
+            this.actions.shift();
+        }
+    }
+}
+exports.MemoryAttenuationManager = MemoryAttenuationManager;
+//# sourceMappingURL=MemoryAttenuationManager.js.map

package/dist/MemoryAttenuationManager.js.map

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

package/dist/ModelManager.d.ts

@@ -0,0 +1,166 @@
+/**
+ * ModelManager — Model lifecycle management with OTA (over-the-air) updates.
+ * Port of CTV agent's ModelManager.kt (387 lines), adapted for Node.js/ONNX.
+ *
+ * Manages registration, version-checking, and atomic download of ML model files.
+ * Downloads use a .tmp + rename pattern to prevent corrupted model loads.
+ * The version check timer is unref()'d so it does not keep the process alive.
+ *
+ * Events emitted:
+ *   'modelUpdated'      — { name, oldVersion, newVersion, path }
+ *   'updateAvailable'   — { name, currentVersion, availableVersion }
+ *   'downloadProgress'  — { name, bytesDownloaded, totalBytes, percent }
+ *   'downloadError'     — { name, error }
+ *   'checkComplete'     — { checkedCount, updatesAvailable }
+ */
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+export interface ModelInfo {
+    /** Model identifier, e.g. 'blazeface', 'yamnet', 'ageGender'. */
+    name: string;
+    /** Semver version string, e.g. '1.2.0'. */
+    version: string;
+    /** Absolute path to the .onnx file on disk. */
+    filePath: string;
+    /** SHA-256 hex digest of the current file. */
+    sha256: string;
+    /** File size in bytes. */
+    sizeBytes: number;
+    /** Timestamp (ms) of last version check against the API. */
+    lastChecked: number;
+    /** Timestamp (ms) of last successful download. */
+    lastUpdated: number;
+}
+export interface ModelVersionResponse {
+    name: string;
+    version: string;
+    sha256: string;
+    downloadUrl: string;
+    sizeBytes: number;
+    releaseNotes?: string;
+}
+export interface ModelManagerOptions {
+    /** Directory for storing model files and manifest. */
+    modelsDir: string;
+    /** Backend API base URL (e.g. 'https://api.trillboards.com'). */
+    apiBaseUrl: string;
+    /** Device fingerprint for the version-check API call. */
+    deviceFingerprint: string;
+    /** Interval between automatic version checks. Default: 3600000 (1 hour). */
+    checkIntervalMs?: number;
+    /** Maximum concurrent model downloads. Default: 1. */
+    maxConcurrentDownloads?: number;
+    /** Whether to auto-download discovered updates. Default: true. */
+    autoUpdate?: boolean;
+    /** Request timeout for API calls in milliseconds. Default: 30000. */
+    requestTimeoutMs?: number;
+    /** Request timeout for file downloads in milliseconds. Default: 300000 (5 min). */
+    downloadTimeoutMs?: number;
+    /** Maximum number of HTTP redirects to follow. Default: 5. */
+    maxRedirects?: number;
+}
+export declare class ModelManager extends EventEmitter {
+    private models;
+    private readonly options;
+    private checkTimer;
+    private downloading;
+    private readonly manifestPath;
+    constructor(options: ModelManagerOptions);
+    /**
+     * Initialize — ensure models directory exists, load manifest, compute
+     * hashes for any registered model files already on disk.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start periodic version checking.  The timer is unref()'d so it does not
+     * prevent the Node.js process from exiting naturally.
+     */
+    start(): void;
+    /**
+     * Stop periodic checking and cancel any in-flight state tracking.
+     */
+    stop(): void;
+    /**
+     * Register a model to track.  Called during EdgeAgent init for each model type.
+     * If the file exists on disk, its SHA-256 is computed immediately.
+     * If the manifest already has version info for this name, it is merged.
+     */
+    registerModel(name: string, filePath: string): void;
+    /**
+     * Check for updates for all registered models by calling the backend API.
+     * Endpoint: GET /v1/federated/models?deviceFingerprint=X&modelType=Y
+     *
+     * Returns the list of ModelVersionResponse objects for which a newer
+     * version is available.  If autoUpdate is enabled, downloads are
+     * initiated automatically (respecting maxConcurrentDownloads).
+     */
+    checkForUpdates(): Promise<ModelVersionResponse[]>;
+    /**
+     * Download a specific model update.
+     *
+     * 1. Download to a .tmp file alongside the target path
+     * 2. Verify SHA-256 checksum matches the expected value
+     * 3. Atomic swap: rename .tmp -> target .onnx path
+     * 4. Update manifest with new version info
+     * 5. Emit 'modelUpdated' event
+     *
+     * Returns true if the model was successfully downloaded and verified.
+     */
+    downloadUpdate(update: ModelVersionResponse): Promise<boolean>;
+    /**
+     * Get info about a registered model.  Returns null if not registered.
+     */
+    getModel(name: string): ModelInfo | null;
+    /**
+     * Get all registered models.
+     */
+    getModels(): ModelInfo[];
+    /**
+     * Check if a model's file exists on disk.
+     */
+    hasModel(name: string): boolean;
+    /**
+     * Check if a download is currently in progress for a model.
+     */
+    isDownloading(name: string): boolean;
+    /**
+     * Compute the SHA-256 hex digest of a file using a streaming reader.
+     */
+    private computeFileHash;
+    /**
+     * Download a file from a URL to a local destination path.
+     * Follows HTTP redirects (up to maxRedirects), emits progress events,
+     * and enforces a download timeout.
+     */
+    private downloadFile;
+    private downloadFileWithRedirects;
+    /**
+     * Load model manifest from disk.  If the file does not exist or is corrupt,
+     * start with an empty manifest — never crash.
+     */
+    private loadManifest;
+    /**
+     * Save the current model state to the manifest file on disk.
+     * Uses atomic write: write to .tmp, then rename.
+     */
+    private saveManifest;
+    /**
+     * Make an HTTPS GET request to the backend API and return parsed JSON.
+     */
+    private apiGet;
+    /**
+     * Verify that a model file exists on disk, recompute its hash if present,
+     * or clear stale info if the file has been deleted.
+     */
+    private verifyModelOnDisk;
+    /**
+     * Semver comparison: returns true if `available` is strictly newer than `current`.
+     * Handles non-semver gracefully by falling back to string comparison.
+     */
+    private isNewerVersion;
+    /**
+     * Safely remove a .tmp file if it exists.  Never throws.
+     */
+    private cleanupTmpFile;
+}
+//# sourceMappingURL=ModelManager.d.ts.map

package/dist/ModelManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelManager.d.ts","sourceRoot":"","sources":["../src/ModelManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAStC,MAAM,WAAW,SAAS;IACxB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAiBD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,EAAE,mBAAmB;IAkBxC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAyBnD;;;;;;;OAOG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAwDxD;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6EpE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM/B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,yBAAyB;IA0GjC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAsCpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,MAAM;IAmDd;;;OAGG;YACW,iBAAiB;IAmB/B;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}