pi-harness-runtime 0.10.12 → 0.10.13

package/packages/observability/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * Observability Package
+ *
+ * A comprehensive observability system with structured logging,
+ * distributed tracing, metrics collection, health monitoring, and alerting.
+ */
+// --- Logger ----------------------------------------------------------------
+export { Logger, createLogger, defaultLogger } from "./logger.js";
+// --- Tracer ----------------------------------------------------------------
+export { Tracer, createTracer, SpanHandle } from "./tracer.js";
+// --- Metrics ----------------------------------------------------------------
+export { Metrics, createMetrics, createBuiltInMetrics, Timer, } from "./metrics.js";
+// --- Health ----------------------------------------------------------------
+export { HealthMonitor, createHealthMonitor, createConnectivityHealthCheck, createMemoryHealthCheck, createDiskSpaceHealthCheck, } from "./health.js";
+// --- Alerts ----------------------------------------------------------------
+export { AlertEngine, createAlertEngine } from "./alerts.js";
+// --- Re-exports ------------------------------------------------------------
+export { SDK_VERSION } from "./types.js";
+//# sourceMappingURL=index.js.map

package/packages/observability/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASlE,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAU/D,+EAA+E;AAE/E,OAAO,EACN,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,KAAK,GACL,MAAM,cAAc,CAAC;AAYtB,8EAA8E;AAE9E,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,6BAA6B,EAC7B,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,aAAa,CAAC;AAQrB,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAS7D,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/packages/observability/dist/logger.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Observability Package - Logger
+ *
+ * Structured logging with correlation IDs and child loggers.
+ */
+import type { LogEntry, LoggerConfig } from "./types.js";
+export declare class Logger {
+    private readonly config;
+    private readonly streams;
+    private currentCorrelationId?;
+    private fileStream?;
+    private fileSize;
+    constructor(config?: LoggerConfig);
+    /**
+     * Create output streams based on config
+     */
+    private createStreams;
+    /**
+     * Initialize file stream
+     */
+    private initializeFileStream;
+    /**
+     * Check if level should be logged
+     */
+    private shouldLog;
+    /**
+     * Format entry as JSON
+     */
+    private formatJSON;
+    /**
+     * Format entry as pretty text
+     */
+    private formatPretty;
+    /**
+     * Format log entry
+     */
+    private format;
+    /**
+     * Write log entry
+     */
+    private write;
+    /**
+     * Rotate log file
+     */
+    private rotateFile;
+    /**
+     * Create log entry with base fields
+     */
+    private createEntry;
+    /**
+     * Log debug message
+     */
+    debug(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     */
+    info(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
+    /**
+     * Log fatal message
+     */
+    fatal(message: string, error?: Error, meta?: Record<string, unknown>): void;
+    /**
+     * Create child logger with default metadata
+     */
+    child(defaults?: Partial<LogEntry>): Logger;
+    /**
+     * Set correlation ID for this logger
+     */
+    withCorrelationId(id: string): Logger;
+    /**
+     * Set job ID for this logger
+     */
+    withJob(jobId: string): Logger;
+    /**
+     * Set task ID for this logger
+     */
+    withTask(taskId: string): Logger;
+    /**
+     * Set component name for this logger
+     */
+    withComponent(component: string): Logger;
+    /**
+     * Generate a new correlation ID and set it on this logger
+     */
+    generateCorrelationId(): string;
+    /**
+     * Get current correlation ID
+     */
+    getCorrelationId(): string | undefined;
+    /**
+     * Close logger and cleanup resources
+     */
+    close(): void;
+}
+/**
+ * Create a logger with the given configuration
+ */
+export declare function createLogger(config?: LoggerConfig): Logger;
+/**
+ * Default logger instance
+ */
+export declare const defaultLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/packages/observability/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,YAAY,CAAC;AAiDnE,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,UAAU,CAAC,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,MAAM,GAAE,YAAiB,EAGpC;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,MAAM;IAOd;;OAEG;IACH,OAAO,CAAC,KAAK;IAkBb;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE3D;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE1D;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE1D;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY1E;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY1E;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,MAAM,CAQ9C;IAED;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIpC;IAED;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/B;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED;;OAEG;IACH,qBAAqB,IAAI,MAAM,CAI9B;IAED;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAKZ;CACD;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAE1D;AAID;;GAEG;AACH,eAAO,MAAM,aAAa,QAAe,CAAC"}

package/packages/observability/dist/logger.js

@@ -0,0 +1,317 @@
+/**
+ * Observability Package - Logger
+ *
+ * Structured logging with correlation IDs and child loggers.
+ */
+import { createWriteStream } from "node:fs";
+import { mkdir, rename as renameAsync } from "node:fs/promises";
+import { dirname } from "node:path";
+// --- Level Order ------------------------------------------------------------
+const LOG_LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    fatal: 4,
+};
+// --- Default Configuration -------------------------------------------------
+const DEFAULT_CONFIG = {
+    level: "info",
+    format: "json",
+    output: "stdout",
+    filePath: "",
+    maxFileSize: 10 * 1024 * 1024, // 10MB
+    maxFiles: 5,
+    correlationIdHeader: "x-correlation-id",
+    defaultMeta: {},
+};
+// --- Colors for Pretty Output -----------------------------------------------
+const COLORS = {
+    debug: "\x1b[36m", // Cyan
+    info: "\x1b[32m", // Green
+    warn: "\x1b[33m", // Yellow
+    error: "\x1b[31m", // Red
+    fatal: "\x1b[35m", // Magenta
+};
+const RESET = "\x1b[0m";
+// --- UUID Generator ---------------------------------------------------------
+function generateId() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+// --- Logger Class -----------------------------------------------------------
+export class Logger {
+    config;
+    streams;
+    currentCorrelationId;
+    fileStream;
+    fileSize = 0;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.streams = this.createStreams();
+    }
+    /**
+     * Create output streams based on config
+     */
+    createStreams() {
+        const streams = [];
+        if (this.config.output === "stdout" || this.config.output === "both") {
+            streams.push(process.stdout);
+        }
+        if (this.config.output === "stderr" || this.config.output === "both") {
+            streams.push(process.stderr);
+        }
+        if (this.config.output === "file" || this.config.filePath) {
+            if (this.config.filePath) {
+                this.initializeFileStream();
+                if (this.fileStream) {
+                    streams.push(this.fileStream);
+                }
+            }
+        }
+        return streams;
+    }
+    /**
+     * Initialize file stream
+     */
+    async initializeFileStream() {
+        if (!this.config.filePath)
+            return;
+        try {
+            await mkdir(dirname(this.config.filePath), { recursive: true });
+            this.fileStream = createWriteStream(this.config.filePath, {
+                flags: "a",
+                highWaterMark: 64 * 1024, // 64KB
+            });
+            this.fileStream?.on("error", (err) => {
+                console.error("File stream error:", err);
+            });
+        }
+        catch (err) {
+            console.error("Failed to initialize file stream:", err);
+        }
+    }
+    /**
+     * Check if level should be logged
+     */
+    shouldLog(level) {
+        return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[this.config.level];
+    }
+    /**
+     * Format entry as JSON
+     */
+    formatJSON(entry) {
+        return JSON.stringify(entry) + "\n";
+    }
+    /**
+     * Format entry as pretty text
+     */
+    formatPretty(entry) {
+        const color = COLORS[entry.level];
+        const timestamp = new Date(entry.timestamp).toISOString();
+        const meta = entry.metadata ? ` ${JSON.stringify(entry.metadata)}` : "";
+        let line = `${color}[${timestamp}]${RESET} ${color.toUpperCase()[0]} ${entry.message}${meta}`;
+        if (entry.correlationId) {
+            line += ` ${color}[corr: ${entry.correlationId}]${RESET}`;
+        }
+        if (entry.jobId) {
+            line += ` ${color}[job: ${entry.jobId}]${RESET}`;
+        }
+        if (entry.taskId) {
+            line += ` ${color}[task: ${entry.taskId}]${RESET}`;
+        }
+        if (entry.component) {
+            line += ` ${color}[${entry.component}]${RESET}`;
+        }
+        if (entry.durationMs !== undefined) {
+            line += ` ${color}[${entry.durationMs}ms]${RESET}`;
+        }
+        return line + "\n";
+    }
+    /**
+     * Format log entry
+     */
+    format(entry) {
+        if (this.config.format === "json") {
+            return this.formatJSON(entry);
+        }
+        return this.formatPretty(entry);
+    }
+    /**
+     * Write log entry
+     */
+    write(entry) {
+        if (!this.shouldLog(entry.level))
+            return;
+        const formatted = this.format(entry);
+        for (const stream of this.streams) {
+            stream.write(formatted);
+        }
+        // Track file size for rotation
+        if (this.fileStream) {
+            this.fileSize += Buffer.byteLength(formatted);
+            if (this.fileSize >= this.config.maxFileSize) {
+                this.rotateFile();
+            }
+        }
+    }
+    /**
+     * Rotate log file
+     */
+    rotateFile() {
+        if (!this.fileStream || !this.config.filePath)
+            return;
+        // Close current stream
+        this.fileStream.end();
+        this.fileSize = 0;
+        // Rename current file for rotation
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const rotatedPath = `${this.config.filePath}.${timestamp}`;
+        // Perform rotation asynchronously
+        renameAsync(this.config.filePath, rotatedPath).catch((err) => {
+            console.error("Failed to rotate log file:", err);
+        });
+        // Reopen the stream
+        this.initializeFileStream();
+    }
+    /**
+     * Create log entry with base fields
+     */
+    createEntry(level, message, meta) {
+        return {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            correlationId: this.currentCorrelationId,
+            ...this.config.defaultMeta,
+            ...meta,
+        };
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, meta) {
+        this.write(this.createEntry("debug", message, meta));
+    }
+    /**
+     * Log info message
+     */
+    info(message, meta) {
+        this.write(this.createEntry("info", message, meta));
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, meta) {
+        this.write(this.createEntry("warn", message, meta));
+    }
+    /**
+     * Log error message
+     */
+    error(message, error, meta) {
+        const entry = this.createEntry("error", message, {
+            ...meta,
+            error: error
+                ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                }
+                : undefined,
+        });
+        this.write(entry);
+    }
+    /**
+     * Log fatal message
+     */
+    fatal(message, error, meta) {
+        const entry = this.createEntry("fatal", message, {
+            ...meta,
+            error: error
+                ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                }
+                : undefined,
+        });
+        this.write(entry);
+    }
+    /**
+     * Create child logger with default metadata
+     */
+    child(defaults = {}) {
+        const childLogger = new Logger(this.config);
+        childLogger.currentCorrelationId = this.currentCorrelationId;
+        childLogger.config.defaultMeta = {
+            ...this.config.defaultMeta,
+            ...defaults,
+        };
+        return childLogger;
+    }
+    /**
+     * Set correlation ID for this logger
+     */
+    withCorrelationId(id) {
+        const logger = this.child();
+        logger.currentCorrelationId = id;
+        return logger;
+    }
+    /**
+     * Set job ID for this logger
+     */
+    withJob(jobId) {
+        return this.child({ jobId });
+    }
+    /**
+     * Set task ID for this logger
+     */
+    withTask(taskId) {
+        return this.child({ taskId });
+    }
+    /**
+     * Set component name for this logger
+     */
+    withComponent(component) {
+        return this.child({ component });
+    }
+    /**
+     * Generate a new correlation ID and set it on this logger
+     */
+    generateCorrelationId() {
+        const id = generateId();
+        this.currentCorrelationId = id;
+        return id;
+    }
+    /**
+     * Get current correlation ID
+     */
+    getCorrelationId() {
+        return this.currentCorrelationId;
+    }
+    /**
+     * Close logger and cleanup resources
+     */
+    close() {
+        if (this.fileStream) {
+            this.fileStream.end();
+            this.fileStream = undefined;
+        }
+    }
+}
+// --- Factory Function --------------------------------------------------------
+/**
+ * Create a logger with the given configuration
+ */
+export function createLogger(config) {
+    return new Logger(config);
+}
+// --- Default Logger ----------------------------------------------------------
+/**
+ * Default logger instance
+ */
+export const defaultLogger = new Logger();
+//# sourceMappingURL=logger.js.map

package/packages/observability/dist/logger.js.map

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

package/packages/observability/dist/metrics.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Observability Package - Metrics
+ *
+ * Metrics collection with Prometheus-compatible format.
+ */
+import type { Labels, MetricsConfig } from "./types.js";
+export declare class Timer {
+    private startTime;
+    constructor();
+    /**
+     * Get elapsed time in seconds
+     */
+    elapsed(): number;
+    /**
+     * Reset the timer
+     */
+    reset(): void;
+}
+export declare class Metrics {
+    private readonly config;
+    private readonly counters;
+    private readonly gauges;
+    private readonly histograms;
+    private readonly histogramSums;
+    private readonly histogramCounts;
+    private readonly summaries;
+    constructor(config?: MetricsConfig);
+    /**
+     * Generate label key from labels
+     */
+    private labelKey;
+    /**
+     * Get full metric name with prefix
+     */
+    private fullName;
+    /**
+     * Create default histogram buckets
+     */
+    private defaultBuckets;
+    /**
+     * Register a counter metric
+     */
+    registerCounter(name: string, _help: string, _labels?: string[]): void;
+    /**
+     * Increment a counter
+     */
+    incrementCounter(name: string, labels?: Labels): void;
+    /**
+     * Add to a counter
+     */
+    addToCounter(name: string, value: number, labels?: Labels): void;
+    /**
+     * Get counter value
+     */
+    getCounter(name: string, labels?: Labels): number;
+    /**
+     * Register a gauge metric
+     */
+    registerGauge(name: string, _help: string, _labels?: string[]): void;
+    /**
+     * Set a gauge value
+     */
+    setGauge(name: string, value: number, labels?: Labels): void;
+    /**
+     * Increment a gauge
+     */
+    incrementGauge(name: string, labels?: Labels): void;
+    /**
+     * Decrement a gauge
+     */
+    decrementGauge(name: string, labels?: Labels): void;
+    /**
+     * Register a histogram metric
+     */
+    registerHistogram(name: string, _help: string, buckets?: number[], _labels?: string[]): void;
+    /**
+     * Create histogram buckets
+     */
+    private createBuckets;
+    /**
+     * Observe a value for histogram
+     */
+    observeHistogram(name: string, value: number, labels?: Labels): void;
+    /**
+     * Register a summary metric
+     */
+    registerSummary(name: string, _help: string, _labels?: string[]): void;
+    /**
+     * Observe a value for summary
+     */
+    observeSummary(name: string, value: number, labels?: Labels): void;
+    /**
+     * Start a timer
+     */
+    startTimer(): Timer;
+    /**
+     * Observe duration from timer
+     */
+    observeDuration(name: string, timer: Timer, labels?: Labels): void;
+    /**
+     * Async timer wrapper
+     */
+    asyncTimer<T>(name: string, fn: () => Promise<T>, labels?: Labels): Promise<T>;
+    /**
+     * Sync timer wrapper
+     */
+    timer<T>(name: string, fn: () => T, labels?: Labels): T;
+    /**
+     * Export metrics in Prometheus format
+     */
+    exportPrometheus(): string;
+    /**
+     * Export metrics as JSON
+     */
+    exportJSON(): string;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+}
+/**
+ * Create built-in runtime metrics
+ */
+export declare function createBuiltInMetrics(metrics: Metrics): void;
+/**
+ * Create a metrics collector with the given configuration
+ */
+export declare function createMetrics(config?: MetricsConfig): Metrics;
+//# sourceMappingURL=metrics.d.ts.map

package/packages/observability/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAmB,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAazE,qBAAa,KAAK;IACjB,OAAO,CAAC,SAAS,CAAS;IAE1B,cAEC;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACD;AAID,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6C;IACxE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CACrB;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGZ;IAEd,YAAY,MAAM,GAAE,aAAkB,EAErC;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAGrE;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAUpD;IAED;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAU/D;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;IAID;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAEnE;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAU3D;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAUlD;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAUlD;IAID;;OAEG;IACH,iBAAiB,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,MAAM,EAAE,GAChB,IAAI,CAKN;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CA4BnE;IAID;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAErE;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAcjE;IAID;;OAEG;IACH,UAAU,IAAI,KAAK,CAElB;IAED;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAEjE;IAED;;OAEG;IACG,UAAU,CAAC,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAUZ;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAOtD;IAID;;OAEG;IACH,gBAAgB,IAAI,MAAM,CA4DzB;IAED;;OAEG;IACH,UAAU,IAAI,MAAM,CAkBnB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAOZ;CACD;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmC3D;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAE7D"}