@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/core/src/monitoring/zombie-detector.js

@@ -0,0 +1,232 @@
+/**
+ * Zombie Process Detector
+ *
+ * Periodically scans for defunct (zombie) processes and attempts automatic cleanup.
+ * Zombie processes are dead processes that haven't been reaped by their parent.
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { logger } from '../utils/logger-server.js';
+import { processRegistry } from './process-registry.js';
+import { DEFAULT_MONITORING_CONFIG } from './types.js';
+const execAsync = promisify(exec);
+/**
+ * Zombie detector class
+ */
+class ZombieDetector {
+    interval = null;
+    zombieHistory = [];
+    enabled = DEFAULT_MONITORING_CONFIG.enabled;
+    detectionInterval = DEFAULT_MONITORING_CONFIG.zombieDetectionInterval;
+    maxHistory = DEFAULT_MONITORING_CONFIG.maxZombieHistory;
+    onZombieDetected;
+    /**
+     * Start zombie detection
+     */
+    start() {
+        if (!this.enabled || this.interval)
+            return;
+        logger.info('Starting zombie process detector', {
+            interval: this.detectionInterval,
+        });
+        this.interval = setInterval(() => {
+            this.scan().catch((error) => {
+                logger.error('Zombie detection scan failed', { error });
+            });
+        }, this.detectionInterval);
+        // Prevent interval from keeping process alive
+        this.interval.unref();
+    }
+    /**
+     * Stop zombie detection
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+            logger.info('Stopped zombie process detector');
+        }
+    }
+    /**
+     * Perform a single scan for zombie processes
+     */
+    async scan() {
+        if (!this.enabled)
+            return [];
+        try {
+            // Use ps to find defunct processes
+            // Format: PID PPID COMMAND STATE
+            const { stdout } = await execAsync("ps axo pid,ppid,comm,state | grep -E ' (Z|z)' || true");
+            const zombies = [];
+            if (stdout.trim()) {
+                const lines = stdout.trim().split('\n');
+                for (const line of lines) {
+                    const match = line.trim().match(/^(\d+)\s+(\d+)\s+(\S+)\s+[Zz]/);
+                    if (match?.[1] && match[2] && match[3]) {
+                        const pid = parseInt(match[1], 10);
+                        const ppid = parseInt(match[2], 10);
+                        const command = match[3];
+                        const zombie = {
+                            pid,
+                            ppid,
+                            command,
+                            detectedAt: Date.now(),
+                            trackedProcess: processRegistry.get(pid),
+                        };
+                        zombies.push(zombie);
+                        // Mark in registry
+                        processRegistry.markZombie(pid);
+                        // Add to history
+                        this.addToHistory(zombie);
+                        // Log detection
+                        logger.warn('Zombie process detected', {
+                            pid,
+                            ppid,
+                            command,
+                        });
+                        // Attempt cleanup
+                        await this.attemptCleanup(zombie);
+                        // Notify callback
+                        if (this.onZombieDetected) {
+                            this.onZombieDetected(zombie);
+                        }
+                    }
+                }
+            }
+            return zombies;
+        }
+        catch (error) {
+            logger.error('Failed to scan for zombie processes', { error });
+            return [];
+        }
+    }
+    /**
+     * Attempt to clean up a zombie process
+     */
+    async attemptCleanup(zombie) {
+        try {
+            // Zombies can't be killed directly - need to signal parent to reap them
+            // Try sending SIGCHLD to parent process
+            logger.info('Attempting zombie cleanup by signaling parent', {
+                zombie: zombie.pid,
+                parent: zombie.ppid,
+            });
+            // Check if parent exists
+            const { stdout: parentExists } = await execAsync(`ps -p ${zombie.ppid} -o pid= || true`);
+            if (!parentExists.trim()) {
+                logger.warn('Zombie parent process does not exist', {
+                    zombie: zombie.pid,
+                    parent: zombie.ppid,
+                });
+                return false;
+            }
+            // Send SIGCHLD to parent
+            process.kill(zombie.ppid, 'SIGCHLD');
+            // Wait a moment and check if zombie is gone
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            const { stdout: zombieStillExists } = await execAsync(`ps -p ${zombie.pid} -o state= || true`);
+            if (!zombieStillExists.trim()) {
+                logger.info('Zombie process successfully reaped', {
+                    pid: zombie.pid,
+                });
+                return true;
+            }
+            logger.warn('Zombie process persists after cleanup attempt', {
+                pid: zombie.pid,
+                ppid: zombie.ppid,
+            });
+            return false;
+        }
+        catch (error) {
+            logger.error('Failed to cleanup zombie process', {
+                zombie: zombie.pid,
+                error,
+            });
+            return false;
+        }
+    }
+    /**
+     * Add zombie to history
+     */
+    addToHistory(zombie) {
+        this.zombieHistory.unshift(zombie);
+        // Trim history
+        if (this.zombieHistory.length > this.maxHistory) {
+            this.zombieHistory = this.zombieHistory.slice(0, this.maxHistory);
+        }
+    }
+    /**
+     * Get zombie history
+     */
+    getHistory() {
+        return [...this.zombieHistory];
+    }
+    /**
+     * Get current zombie count
+     */
+    getCount() {
+        return processRegistry.getZombies().length;
+    }
+    /**
+     * Clear history
+     */
+    clearHistory() {
+        this.zombieHistory = [];
+    }
+    /**
+     * Set zombie detection callback
+     */
+    onZombie(callback) {
+        this.onZombieDetected = callback;
+    }
+    /**
+     * Enable or disable detection
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        if (!enabled && this.interval) {
+            this.stop();
+        }
+        else if (enabled && !this.interval) {
+            this.start();
+        }
+    }
+    /**
+     * Check if detection is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Check if detector is running
+     */
+    isRunning() {
+        return this.interval !== null;
+    }
+}
+/**
+ * Singleton instance
+ */
+export const zombieDetector = new ZombieDetector();
+/**
+ * Convenience functions
+ */
+export function startZombieDetection() {
+    zombieDetector.start();
+}
+export function stopZombieDetection() {
+    zombieDetector.stop();
+}
+export function scanForZombies() {
+    return zombieDetector.scan();
+}
+export function getZombieHistory() {
+    return zombieDetector.getHistory();
+}
+export function getZombieCount() {
+    return zombieDetector.getCount();
+}
+export function onZombieDetected(callback) {
+    zombieDetector.onZombie(callback);
+}
+//# sourceMappingURL=zombie-detector.js.map

package/dist/packages/core/src/monitoring/zombie-detector.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * Structured Logging Infrastructure
+ *
+ * Re-exports from @revealui/utils to maintain backward compatibility.
+ * The actual implementation has been moved to @revealui/utils to break circular dependencies.
+ */
+export type { LogContext, LogEntry, LoggerConfig, LogLevel, } from '@revealui/utils/logger';
+export { createLogger, Logger, logAudit, logError, logger, logQuery, } from '@revealui/utils/logger';
+/**
+ * Request logger middleware
+ */
+export declare function createRequestLogger<TRequest = unknown, TResponse = unknown>(options?: {
+    includeBody?: boolean;
+    includeHeaders?: boolean;
+}): (request: TRequest & {
+    method: string;
+    url: string;
+    headers?: {
+        get?: (key: string) => string | null;
+        entries?: () => Iterable<[string, string]>;
+    };
+}, next: () => Promise<TResponse>) => Promise<TResponse>;
+/**
+ * Performance logger
+ */
+export declare function logPerformance(operation: string, duration: number, context?: Record<string, unknown>): void;
+/**
+ * API call logger
+ */
+export declare function logAPICall(method: string, url: string, status: number, duration: number, context?: Record<string, unknown>): void;
+/**
+ * Cache operation logger
+ */
+export declare function logCache(operation: 'hit' | 'miss' | 'set' | 'delete', key: string, context?: Record<string, unknown>): void;
+/**
+ * User action logger
+ */
+export declare function logUserAction(action: string, userId?: string, context?: Record<string, unknown>): void;
+/**
+ * System event logger
+ */
+export declare function logSystemEvent(event: string, context?: Record<string, unknown>): void;
+/**
+ * Sanitize sensitive data from logs
+ */
+export declare function sanitizeLogData(data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../../core/src/observability/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,YAAY,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,QAAQ,GACT,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,GACT,MAAM,wBAAwB,CAAA;AAK/B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EACzE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,IAG/D,SAAS,QAAQ,GAAG;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAA;CAC/F,EACD,MAAM,MAAM,OAAO,CAAC,SAAS,CAAC,KAC7B,OAAO,CAAC,SAAS,CAAC,CA6CtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EAC5C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKrF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BtF"}

package/dist/packages/core/src/observability/logger.js

@@ -0,0 +1,141 @@
+/**
+ * Structured Logging Infrastructure
+ *
+ * Re-exports from @revealui/utils to maintain backward compatibility.
+ * The actual implementation has been moved to @revealui/utils to break circular dependencies.
+ */
+// Import logger for internal use
+import { logger as utilsLogger } from '@revealui/utils/logger';
+export { createLogger, Logger, logAudit, logError, logger, logQuery, } from '@revealui/utils/logger';
+// Additional helper functions that were in core but not in utils
+// These can stay here as they're core-specific
+/**
+ * Request logger middleware
+ */
+export function createRequestLogger(options = {}) {
+    return async (request, next) => {
+        // Import logger at runtime to avoid circular deps
+        const { logger } = await import('@revealui/utils/logger');
+        const requestId = crypto.randomUUID();
+        const startTime = Date.now();
+        const requestLogger = logger.child({
+            requestId,
+            method: request.method,
+            url: request.url,
+            userAgent: request.headers?.get?.('user-agent'),
+        });
+        requestLogger.info('Request started');
+        if (options.includeHeaders) {
+            requestLogger.debug('Request headers', {
+                headers: Object.fromEntries(request.headers?.entries?.() || []),
+            });
+        }
+        try {
+            const response = await next();
+            const duration = Date.now() - startTime;
+            const responseWithStatus = response;
+            requestLogger.info('Request completed', {
+                status: responseWithStatus.status ?? 200,
+                duration,
+            });
+            return response;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            requestLogger.error('Request failed', error instanceof Error ? error : new Error(String(error)), { duration });
+            throw error;
+        }
+    };
+}
+/**
+ * Performance logger
+ */
+export function logPerformance(operation, duration, context) {
+    const level = duration > 1000 ? 'warn' : 'info';
+    utilsLogger[level](`Performance: ${operation}`, {
+        ...context,
+        operation,
+        duration,
+        slow: duration > 1000,
+    });
+}
+/**
+ * API call logger
+ */
+export function logAPICall(method, url, status, duration, context) {
+    const apiContext = {
+        ...context,
+        method,
+        url,
+        status,
+        duration,
+    };
+    if (status >= 400) {
+        utilsLogger.error('API call', undefined, apiContext);
+    }
+    else if (status >= 300) {
+        utilsLogger.warn('API call', apiContext);
+    }
+    else {
+        utilsLogger.info('API call', apiContext);
+    }
+}
+/**
+ * Cache operation logger
+ */
+export function logCache(operation, key, context) {
+    utilsLogger.debug(`Cache ${operation}`, {
+        ...context,
+        operation,
+        key,
+    });
+}
+/**
+ * User action logger
+ */
+export function logUserAction(action, userId, context) {
+    utilsLogger.info('User action', {
+        ...context,
+        action,
+        userId,
+    });
+}
+/**
+ * System event logger
+ */
+export function logSystemEvent(event, context) {
+    utilsLogger.info('System event', {
+        ...context,
+        event,
+    });
+}
+/**
+ * Sanitize sensitive data from logs
+ */
+export function sanitizeLogData(data) {
+    const sensitiveKeys = [
+        'password',
+        'token',
+        'secret',
+        'apiKey',
+        'accessToken',
+        'refreshToken',
+        'creditCard',
+        'ssn',
+    ];
+    const sanitized = {};
+    for (const [key, value] of Object.entries(data)) {
+        const lowerKey = key.toLowerCase();
+        if (sensitiveKeys.some((sensitive) => lowerKey.includes(sensitive))) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            sanitized[key] = sanitizeLogData(value);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+//# sourceMappingURL=logger.js.map

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

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

package/dist/packages/core/src/utils/logger-server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Server Logger Utility
+ *
+ * Server-side logging utility for RevealUI framework.
+ * Supports different log levels and structured output.
+ * Automatically includes request ID from request context when available.
+ *
+ * WARNING: This module uses Node.js APIs (async_hooks via request-context).
+ * For client-safe logging, use './logger-client.js' instead.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    [key: string]: unknown;
+}
+export interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+}
+/**
+ * Create a logger instance
+ *
+ * @param minLevel - Minimum log level to output (default: 'info')
+ * @returns Logger instance
+ */
+export declare function createLogger(minLevel?: LogLevel): Logger;
+/**
+ * Default logger instance
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger-server.d.ts.map

package/dist/packages/core/src/utils/logger-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-server.d.ts","sourceRoot":"","sources":["../../../../../../core/src/utils/logger-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACnD;AAsDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAiB,CAAA"}

package/dist/packages/core/src/utils/logger-server.js

@@ -0,0 +1,69 @@
+/**
+ * Server Logger Utility
+ *
+ * Server-side logging utility for RevealUI framework.
+ * Supports different log levels and structured output.
+ * Automatically includes request ID from request context when available.
+ *
+ * WARNING: This module uses Node.js APIs (async_hooks via request-context).
+ * For client-safe logging, use './logger-client.js' instead.
+ */
+import { getRequestId } from './request-context.js';
+class ConsoleLogger {
+    minLevel;
+    constructor(minLevel = 'info') {
+        this.minLevel = minLevel;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.minLevel);
+    }
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+        // Automatically include request ID if available
+        const requestId = getRequestId();
+        const enrichedContext = requestId ? { requestId, ...context } : context;
+        if (enrichedContext && Object.keys(enrichedContext).length > 0) {
+            return `${prefix} ${message} ${JSON.stringify(enrichedContext)}`;
+        }
+        return `${prefix} ${message}`;
+    }
+    debug(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug(this.formatMessage('debug', message, context));
+        }
+    }
+    info(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.info(this.formatMessage('info', message, context));
+        }
+    }
+    warn(message, context) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn(this.formatMessage('warn', message, context));
+        }
+    }
+    error(message, context) {
+        if (this.shouldLog('error')) {
+            console.error(this.formatMessage('error', message, context));
+        }
+    }
+}
+/**
+ * Create a logger instance
+ *
+ * @param minLevel - Minimum log level to output (default: 'info')
+ * @returns Logger instance
+ */
+export function createLogger(minLevel) {
+    // In production, can be extended to use structured logging services
+    // For now, use console-based logger
+    const level = minLevel || process.env.LOG_LEVEL || 'info';
+    return new ConsoleLogger(level);
+}
+/**
+ * Default logger instance
+ */
+export const logger = createLogger();
+//# sourceMappingURL=logger-server.js.map

package/dist/packages/core/src/utils/logger-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-server.js","sourceRoot":"","sources":["../../../../../../core/src/utils/logger-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAenD,MAAM,aAAa;IACT,QAAQ,CAAU;IAE1B,YAAY,WAAqB,MAAM;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,OAAoB;QAC1E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAA;QAExD,gDAAgD;QAChD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;QAChC,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QAEvE,IAAI,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAA;QAClE,CAAC;QAED,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAmB;IAC9C,oEAAoE;IACpE,oCAAoC;IACpC,MAAM,KAAK,GAAG,QAAQ,IAAK,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAA;IACvE,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA"}