4runr-os 1.0.23 → 1.0.36

package/dist/core/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Core Constants
+ * Phase 4: Thresholds and configuration for widgets
+ */
+/**
+ * Latency classification thresholds (ms)
+ */
+export declare const LATENCY_THRESHOLDS: {
+    readonly LOW: 50;
+    readonly MEDIUM: 150;
+    readonly HIGH: number;
+};
+/**
+ * Get latency class from milliseconds
+ */
+export declare function getLatencyClass(ms: number | "UNKNOWN"): "LOW" | "MEDIUM" | "HIGH" | "UNKNOWN";
+/**
+ * Sparkline history window (samples)
+ */
+export declare const SPARKLINE_HISTORY_SIZE = 60;
+/**
+ * Sparkline tick interval (ms) - approximate
+ */
+export declare const SPARKLINE_TICK_MS = 1000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAK7F;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,33 @@
+/**
+ * Core Constants
+ * Phase 4: Thresholds and configuration for widgets
+ */
+/**
+ * Latency classification thresholds (ms)
+ */
+export const LATENCY_THRESHOLDS = {
+    LOW: 50, // < 50ms = LOW
+    MEDIUM: 150, // 50-150ms = MEDIUM
+    HIGH: Infinity, // > 150ms = HIGH
+};
+/**
+ * Get latency class from milliseconds
+ */
+export function getLatencyClass(ms) {
+    if (ms === "UNKNOWN")
+        return "UNKNOWN";
+    if (ms < LATENCY_THRESHOLDS.LOW)
+        return "LOW";
+    if (ms < LATENCY_THRESHOLDS.MEDIUM)
+        return "MEDIUM";
+    return "HIGH";
+}
+/**
+ * Sparkline history window (samples)
+ */
+export const SPARKLINE_HISTORY_SIZE = 60;
+/**
+ * Sparkline tick interval (ms) - approximate
+ */
+export const SPARKLINE_TICK_MS = 1000;
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,EAAE,EAAO,eAAe;IAC7B,MAAM,EAAE,GAAG,EAAG,oBAAoB;IAClC,IAAI,EAAE,QAAQ,EAAE,iBAAiB;CACzB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAAsB;IACpD,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,EAAE,GAAG,kBAAkB,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,EAAE,GAAG,kBAAkB,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC"}

package/dist/core/eventBus.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Event Bus
+ * Phase 3: Fire-and-forget event system for feed updates
+ */
+export type FeedEvent = {
+    tag: "RUN" | "NET" | "SEC" | "DB" | "GATEWAY" | "SYSTEM";
+    msg: string;
+    ts: number;
+};
+type EventHandler = (event: FeedEvent) => void;
+declare class EventBus {
+    private handlers;
+    /**
+     * Emit event (fire and forget)
+     */
+    emit(event: FeedEvent): void;
+    /**
+     * Subscribe to events
+     * Returns unsubscribe function
+     */
+    subscribe(handler: EventHandler): () => void;
+    /**
+     * Clear all handlers (for testing)
+     */
+    clear(): void;
+}
+/**
+ * Global event bus instance
+ */
+export declare const eventBus: EventBus;
+/**
+ * Helper: Emit feed event
+ */
+export declare function emitFeedEvent(tag: FeedEvent['tag'], msg: string): void;
+export {};
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/core/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../src/core/eventBus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE/C,cAAM,QAAQ;IACZ,OAAO,CAAC,QAAQ,CAAgC;IAEhD;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAW5B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAO5C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,UAAiB,CAAC;AAEvC;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMtE"}

package/dist/core/eventBus.js

@@ -0,0 +1,52 @@
+/**
+ * Event Bus
+ * Phase 3: Fire-and-forget event system for feed updates
+ */
+class EventBus {
+    handlers = new Set();
+    /**
+     * Emit event (fire and forget)
+     */
+    emit(event) {
+        this.handlers.forEach(handler => {
+            try {
+                handler(event);
+            }
+            catch (error) {
+                // Silently fail - don't break event bus
+                console.error('[EventBus] Handler error:', error);
+            }
+        });
+    }
+    /**
+     * Subscribe to events
+     * Returns unsubscribe function
+     */
+    subscribe(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    /**
+     * Clear all handlers (for testing)
+     */
+    clear() {
+        this.handlers.clear();
+    }
+}
+/**
+ * Global event bus instance
+ */
+export const eventBus = new EventBus();
+/**
+ * Helper: Emit feed event
+ */
+export function emitFeedEvent(tag, msg) {
+    eventBus.emit({
+        tag,
+        msg,
+        ts: Date.now(),
+    });
+}
+//# sourceMappingURL=eventBus.js.map

package/dist/core/eventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../src/core/eventBus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,QAAQ;IACJ,QAAQ,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEhD;;OAEG;IACH,IAAI,CAAC,KAAgB;QACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC9B,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wCAAwC;gBACxC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAqB;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAqB,EAAE,GAAW;IAC9D,QAAQ,CAAC,IAAI,CAAC;QACZ,GAAG;QACH,GAAG;QACH,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Core Types
+ * Phase 3: Data contracts for collectors and UiState
+ */
+/**
+ * Collector Result Envelope
+ * Phase 9: Standard collector contract with status, asOf, reasonCode, message, action
+ */
+export type CollectorStatus = 'LIVE' | 'STALE' | 'UNAVAILABLE' | 'DISABLED';
+export type CollectorResult<T> = {
+    status: CollectorStatus;
+    asOf: number;
+    data?: T;
+    source: string;
+    staleAfterMs: number;
+    reasonCode?: string;
+    message?: string;
+    action?: string;
+    ok?: boolean;
+    ts?: number;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * UiState - Single authoritative snapshot
+ * Phase 3: Complete state for hub rendering
+ */
+export type UiState = {
+    ts: number;
+    posture: {
+        posture: "OPERATIONAL" | "DEGRADED" | "OFFLINE" | "CRITICAL" | "UNKNOWN";
+        risk: "LOW" | "ELEVATED" | "HIGH" | "UNKNOWN";
+        connected: boolean | "UNKNOWN";
+        target: string | "UNKNOWN";
+        lastChange: number | "UNKNOWN";
+        cause: string | "UNKNOWN";
+        dependencies: {
+            config: "OK" | "WARN" | "ERROR" | "UNKNOWN";
+            gateway: "OK" | "WARN" | "ERROR" | "UNKNOWN";
+            database: "OK" | "WARN" | "ERROR" | "UNKNOWN";
+            registry: "OK" | "WARN" | "ERROR" | "UNKNOWN";
+        };
+    };
+    network: {
+        originRegion: string | "UNKNOWN";
+        originClass: "LOCAL" | "VPN" | "CLOUD" | "UNKNOWN";
+        gatewayRegion: string | "UNKNOWN";
+        dbRegion: string | "NONE" | "UNKNOWN";
+        latencyMs: number | "UNKNOWN";
+        latencyClass: "LOW" | "MEDIUM" | "HIGH" | "UNKNOWN";
+        publicIpMasked: string | "HIDDEN" | "UNKNOWN";
+    };
+    resources: {
+        cpuPercent: number | "UNKNOWN";
+        load1m: number | "UNKNOWN";
+        ramUsedMb: number | "UNKNOWN";
+        ramTotalMb: number | "UNKNOWN";
+        diskUsedGb: number | "UNKNOWN";
+        diskTotalGb: number | "UNKNOWN";
+        uptimeSec: number | "UNKNOWN";
+        procCount: number | "UNKNOWN";
+    };
+    assets: {
+        total: number | "UNKNOWN";
+        active: number | "UNKNOWN";
+        idle: number | "UNKNOWN";
+        error: number | "UNKNOWN";
+        highlight: string | "UNKNOWN";
+        lastAction: string | "NONE" | "UNKNOWN";
+    };
+    capabilities: {
+        gateway: "READY" | "DEGRADED" | "UNKNOWN";
+        database: "READY" | "NOT_INITIALIZED" | "UNKNOWN";
+        memory: "IN_MEMORY" | "PERSISTENT" | "UNKNOWN";
+        security: "OPEN" | "BASIC" | "JWT" | "UNKNOWN";
+        rateLimit: "ENABLED" | "DISABLED" | "UNKNOWN";
+    };
+    feed: {
+        events: Array<{
+            ts: number;
+            tag: "RUN" | "NET" | "SEC" | "DB" | "GATEWAY" | "SYSTEM";
+            msg: string;
+        }>;
+    };
+    freshness: {
+        posture: "FRESH" | "STALE";
+        network: "FRESH" | "STALE";
+        resources: "FRESH" | "STALE";
+        assets: "FRESH" | "STALE";
+        capabilities: "FRESH" | "STALE";
+    };
+    history?: {
+        cpu: Array<number | null>;
+        ram: Array<number | null>;
+        latency: Array<number | null>;
+    };
+    geo?: GeoContext;
+};
+/**
+ * Geographic Context
+ * Phase 5: Geographic situational awareness
+ */
+export type GeoContext = {
+    originLabel: string | "UNKNOWN";
+    originRegion: string | "UNKNOWN";
+    originLatLon?: {
+        lat: number;
+        lon: number;
+    } | "UNKNOWN";
+    gatewayRegion: string | "UNKNOWN";
+    gatewayLatLon?: {
+        lat: number;
+        lon: number;
+    } | "UNKNOWN";
+    dbRegion: string | "UNKNOWN";
+    dbLatLon?: {
+        lat: number;
+        lon: number;
+    } | "UNKNOWN";
+    routeLabel: string | "UNKNOWN";
+    pingMs: number | "UNKNOWN";
+    pingClass: "LOW" | "MEDIUM" | "HIGH" | "UNKNOWN";
+    confidence: "LOW" | "MEDIUM" | "HIGH" | "UNKNOWN";
+    source: "MANUAL" | "LOCAL_IP" | "AWS_META" | "NONE";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core Types
+ * Phase 3: Data contracts for collectors and UiState
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/events.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Event Ring Buffer
+ * Phase 2: Track meaningful operational events for Live Operations Feed
+ */
+import type { OperationEvent } from './models.js';
+/**
+ * Add event to operations feed
+ * Events are structured objects, not strings
+ */
+export declare function addOperationEvent(event: OperationEvent): void;
+/**
+ * Helper: Create event for run started
+ */
+export declare function eventRunStarted(agentName: string, runId: string): OperationEvent;
+/**
+ * Helper: Create event for run completed
+ */
+export declare function eventRunCompleted(agentName: string, runId: string, status: 'SUCCESS' | 'FAILED'): OperationEvent;
+/**
+ * Helper: Create event for error detected
+ */
+export declare function eventErrorDetected(description: string, metadata?: Record<string, any>, severity?: 'warning' | 'critical'): OperationEvent;
+/**
+ * Helper: Create event for connection established
+ */
+export declare function eventConnectionEstablished(target: string): OperationEvent;
+/**
+ * Helper: Create event for connection lost
+ */
+export declare function eventConnectionLost(): OperationEvent;
+/**
+ * Helper: Create event for system state change
+ */
+export declare function eventSystemStateChange(description: string, metadata?: Record<string, any>): OperationEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAQhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,cAAc,CAQhH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,GAAE,SAAS,GAAG,UAAsB,GAAG,cAAc,CAQpJ;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAOpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAQ1G"}

package/dist/events.js

@@ -0,0 +1,89 @@
+/**
+ * Event Ring Buffer
+ * Phase 2: Track meaningful operational events for Live Operations Feed
+ */
+import { updateAppState, getState } from './store.js';
+const MAX_EVENTS = 10; // Ring buffer size
+/**
+ * Add event to operations feed
+ * Events are structured objects, not strings
+ */
+export function addOperationEvent(event) {
+    const state = getState();
+    const events = [...state.operationEvents, event];
+    // Keep only last MAX_EVENTS
+    const trimmedEvents = events.slice(-MAX_EVENTS);
+    updateAppState({ operationEvents: trimmedEvents });
+}
+/**
+ * Helper: Create event for run started
+ */
+export function eventRunStarted(agentName, runId) {
+    return {
+        type: 'RUN_STARTED',
+        description: `Execution started: ${agentName}`,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata: { agentName, runId },
+    };
+}
+/**
+ * Helper: Create event for run completed
+ */
+export function eventRunCompleted(agentName, runId, status) {
+    return {
+        type: 'RUN_COMPLETED',
+        description: `Execution ${status.toLowerCase()}: ${agentName}`,
+        timestamp: Date.now(),
+        severity: status === 'FAILED' ? 'warning' : 'info',
+        metadata: { agentName, runId, status },
+    };
+}
+/**
+ * Helper: Create event for error detected
+ */
+export function eventErrorDetected(description, metadata, severity = 'warning') {
+    return {
+        type: 'ERROR_DETECTED',
+        description,
+        timestamp: Date.now(),
+        severity,
+        metadata,
+    };
+}
+/**
+ * Helper: Create event for connection established
+ */
+export function eventConnectionEstablished(target) {
+    return {
+        type: 'CONNECTION_ESTABLISHED',
+        description: `Connected to ${target}`,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata: { target },
+    };
+}
+/**
+ * Helper: Create event for connection lost
+ */
+export function eventConnectionLost() {
+    return {
+        type: 'CONNECTION_LOST',
+        description: 'Connection lost',
+        timestamp: Date.now(),
+        severity: 'warning',
+    };
+}
+/**
+ * Helper: Create event for system state change
+ */
+export function eventSystemStateChange(description, metadata) {
+    return {
+        type: 'SYSTEM_STATE_CHANGE',
+        description,
+        timestamp: Date.now(),
+        severity: 'info',
+        metadata,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,mBAAmB;AAE1C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAEjD,4BAA4B;IAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAEhD,cAAc,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,KAAa;IAC9D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sBAAsB,SAAS,EAAE;QAC9C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAa,EAAE,MAA4B;IAC9F,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,aAAa,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE;QAC9D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAClD,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,QAA8B,EAAE,WAAmC,SAAS;IAClI,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gBAAgB,MAAM,EAAE;QACrC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,EAAE,MAAM,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,iBAAiB;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,QAA8B;IACxF,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM;QAChB,QAAQ;KACT,CAAC;AACJ,CAAC"}