devharness 0.8.0

package/build/runners/docker-runner.js

@@ -0,0 +1,414 @@
+/**
+ * Docker Runner
+ * Runs containers using Docker CLI
+ */
+import { spawnSync } from 'child_process';
+import { debugLog } from '../debug-logger.js';
+/**
+ * Check if Docker is available on the system
+ * @throws Error if Docker is not installed or not running
+ */
+function ensureDockerAvailable() {
+    try {
+        const result = spawnSync('docker', ['version', '--format', '{{.Server.Version}}'], {
+            encoding: 'utf-8',
+            timeout: 10000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.error || result.status !== 0) {
+            const stderr = result.stderr?.toString() || '';
+            // Reset cache on any failure so we re-check next time
+            dockerChecked = false;
+            if (stderr.includes('Cannot connect') || stderr.includes('Is the docker daemon running')) {
+                throw new Error('Docker daemon is not running. Please start Docker and try again.');
+            }
+            if (stderr.includes('paused') || stderr.includes('Paused')) {
+                throw new Error('Docker Desktop is paused. Please unpause it and try again.');
+            }
+            // Pass through Docker's error message if available, otherwise generic message
+            if (stderr.trim()) {
+                throw new Error(stderr.trim());
+            }
+            throw new Error('Docker is not available. Please install Docker and try again.');
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error('Docker is not installed. Please install Docker from https://docs.docker.com/get-docker/');
+        }
+        // Reset cache on any error so we re-check next time
+        dockerChecked = false;
+        throw err;
+    }
+}
+/** Cache for Docker availability check - reset on failure */
+let dockerChecked = false;
+/**
+ * Reset the Docker availability cache.
+ * Called before autoRun to ensure Docker is checked fresh.
+ */
+export function resetDockerCheck() {
+    dockerChecked = false;
+}
+/**
+ * Sanitize a string to be safe for use as a Docker container/project name.
+ * Only allows alphanumeric characters, dashes, and underscores.
+ */
+function sanitizeForDocker(name) {
+    // Replace any character that isn't alphanumeric, dash, or underscore
+    return name.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+export class DockerRunner {
+    type = 'docker';
+    id;
+    command = '';
+    cwd = '';
+    containerId = null;
+    containerName = null;
+    port = null;
+    startedAt = null;
+    lastLogTimestamp = null;
+    env = {};
+    constructor(id) {
+        this.id = sanitizeForDocker(id);
+        // Use sanitized server ID as container name for easy reference
+        this.containerName = `cdp-tools-${this.id}`;
+    }
+    /**
+     * Restore state from persisted data
+     */
+    restore(data) {
+        this.command = data.command;
+        this.cwd = data.cwd;
+        this.containerId = data.containerId ?? null;
+        this.port = data.port ?? null;
+        this.startedAt = new Date(data.startedAt);
+    }
+    /**
+     * Execute docker command using spawn with args array (prevents shell injection)
+     */
+    execDocker(args, options) {
+        // Check Docker is available on first use
+        if (!dockerChecked) {
+            ensureDockerAvailable();
+            dockerChecked = true;
+        }
+        const result = spawnSync('docker', args, {
+            cwd: options?.cwd,
+            encoding: 'utf-8',
+            timeout: 30000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.error) {
+            throw new Error(result.error.message);
+        }
+        if (result.status !== 0) {
+            const stderr = result.stderr?.toString() || '';
+            const stdout = result.stdout?.toString() || '';
+            const errorMsg = stderr || stdout || '';
+            // Check if Docker daemon stopped while MCP was running
+            if (errorMsg.includes('Cannot connect') || errorMsg.includes('Is the docker daemon running')) {
+                // Reset cache so next attempt will re-check
+                dockerChecked = false;
+                throw new Error('Docker daemon is not running. Please start Docker and try again.');
+            }
+            throw new Error(errorMsg || `Docker command failed with status ${result.status}`);
+        }
+        return (result.stdout || '').trim();
+    }
+    /**
+     * Parse a docker run command string into an array of arguments.
+     * This handles quoted strings properly.
+     */
+    parseCommandArgs(command) {
+        const args = [];
+        let current = '';
+        let inQuote = null;
+        let i = 0;
+        // Skip 'docker run' prefix
+        const runMatch = command.match(/^docker\s+run\s+/i);
+        if (runMatch) {
+            i = runMatch[0].length;
+        }
+        while (i < command.length) {
+            const char = command[i];
+            if (inQuote) {
+                if (char === inQuote) {
+                    inQuote = null;
+                }
+                else {
+                    current += char;
+                }
+            }
+            else if (char === '"' || char === "'") {
+                inQuote = char;
+            }
+            else if (char === ' ' || char === '\t') {
+                if (current) {
+                    args.push(current);
+                    current = '';
+                }
+            }
+            else {
+                current += char;
+            }
+            i++;
+        }
+        if (current) {
+            args.push(current);
+        }
+        return args;
+    }
+    /**
+     * Build docker run arguments from the command and options
+     */
+    buildDockerRunArgs(command, envVars) {
+        const parsedArgs = this.parseCommandArgs(command);
+        const args = ['run'];
+        // Check if already has -d flag
+        const hasDetached = parsedArgs.some(arg => arg === '-d' || arg === '--detach');
+        const hasName = parsedArgs.some((arg, i) => arg === '--name' || (i > 0 && parsedArgs[i - 1] === '--name'));
+        // Always run detached
+        if (!hasDetached) {
+            args.push('-d');
+        }
+        // Add container name if not present
+        if (!hasName) {
+            args.push('--name', this.containerName);
+        }
+        // Add environment variables
+        for (const [key, value] of Object.entries(envVars)) {
+            args.push('-e', `${key}=${value}`);
+        }
+        // Add all parsed args
+        args.push(...parsedArgs);
+        return args;
+    }
+    async start(options) {
+        const { command, cwd, env } = options;
+        // Check Docker is available
+        if (!dockerChecked) {
+            ensureDockerAvailable();
+            dockerChecked = true;
+        }
+        this.command = command;
+        this.cwd = cwd;
+        this.env = env ?? {};
+        await debugLog('DockerRunner', `Starting: ${command}`);
+        // Remove any existing container with same name
+        try {
+            this.execDocker(['rm', '-f', this.containerName]);
+        }
+        catch {
+            // Container didn't exist, that's fine
+        }
+        // Build docker run arguments
+        const dockerArgs = this.buildDockerRunArgs(command, this.env);
+        await debugLog('DockerRunner', `Docker args: ${JSON.stringify(dockerArgs)}`);
+        // Execute docker run with spawn (not shell) to prevent injection
+        const result = spawnSync('docker', dockerArgs, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 60000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.error) {
+            throw new Error(`Failed to start container: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            const stderr = result.stderr?.toString() || '';
+            const stdout = result.stdout?.toString() || '';
+            throw new Error(`Failed to start container: ${stderr || stdout}`);
+        }
+        // Get short container ID (first 12 chars)
+        const containerId = (result.stdout || '').trim();
+        this.containerId = containerId.substring(0, 12);
+        this.startedAt = new Date();
+        await debugLog('DockerRunner', `Started container: ${this.containerId}`);
+        // Try to detect port immediately
+        await this.detectPort();
+        return {
+            pid: -1, // Docker doesn't use PIDs the same way
+            containerId: this.containerId,
+            port: this.port ?? undefined,
+        };
+    }
+    async stop(options) {
+        const timeout = Math.floor((options?.timeout ?? 10000) / 1000); // Convert to seconds
+        if (!this.containerId && !this.containerName) {
+            return;
+        }
+        const target = this.containerId || this.containerName;
+        await debugLog('DockerRunner', `Stopping container: ${target}`);
+        try {
+            // Docker stop with timeout
+            this.execDocker(['stop', '-t', timeout.toString(), target]);
+            await debugLog('DockerRunner', `Stopped container: ${target}`);
+        }
+        catch (err) {
+            await debugLog('DockerRunner', `Stop failed, trying kill: ${err}`);
+            try {
+                this.execDocker(['kill', target]);
+            }
+            catch {
+                // Already dead
+            }
+        }
+        // Remove the container
+        try {
+            this.execDocker(['rm', '-f', target]);
+            await debugLog('DockerRunner', `Removed container: ${target}`);
+        }
+        catch {
+            // Ignore removal errors
+        }
+        this.containerId = null;
+    }
+    async isRunning() {
+        if (!this.containerId && !this.containerName) {
+            return false;
+        }
+        const target = this.containerId || this.containerName;
+        try {
+            const output = this.execDocker(['inspect', '-f', '{{.State.Running}}', target]);
+            return output === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    async getStatus() {
+        const running = await this.isRunning();
+        const target = this.containerId || this.containerName;
+        let details = {};
+        if (target && running) {
+            try {
+                const output = this.execDocker([
+                    'inspect',
+                    '-f',
+                    '{{.State.Status}}|{{.State.StartedAt}}|{{.RestartCount}}',
+                    target,
+                ]);
+                const [status, startedAt, restartCount] = output.split('|');
+                details = { status, startedAt, restartCount: parseInt(restartCount, 10) };
+            }
+            catch {
+                // Ignore
+            }
+        }
+        return {
+            running,
+            pid: -1,
+            containerId: this.containerId ?? undefined,
+            port: this.port ?? undefined,
+            startedAt: this.startedAt ?? undefined,
+            details,
+        };
+    }
+    async getLogs(options) {
+        const { type = 'all', lines } = options ?? {};
+        if (!this.containerId && !this.containerName) {
+            return [];
+        }
+        const target = this.containerId || this.containerName;
+        const args = ['logs'];
+        // Add timestamps for delta tracking
+        args.push('--timestamps');
+        if (lines !== undefined) {
+            args.push('--tail', lines.toString());
+        }
+        else if (this.lastLogTimestamp) {
+            // Get logs since last check
+            args.push('--since', this.lastLogTimestamp);
+        }
+        args.push(target);
+        try {
+            // LIMITATION: Docker CLI's 'logs' command returns both stdout and stderr interleaved
+            // in chronological order. There's no reliable way to separate them without running
+            // two separate processes or using the Docker API directly. The 'type' filter parameter
+            // is ignored for Docker containers - all logs are returned regardless of type.
+            // This is a known Docker CLI limitation.
+            const output = this.execDocker(args);
+            const logLines = output.split('\n').filter(l => l.length > 0);
+            // Update timestamp for delta mode
+            if (lines === undefined && logLines.length > 0) {
+                // Extract timestamp from last line (format: 2024-01-01T12:00:00.000000000Z message)
+                const lastLine = logLines[logLines.length - 1];
+                const match = lastLine.match(/^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})/);
+                if (match) {
+                    this.lastLogTimestamp = match[1];
+                }
+            }
+            return logLines;
+        }
+        catch {
+            return [];
+        }
+    }
+    async detectPort() {
+        if (this.port)
+            return this.port;
+        if (!this.containerId && !this.containerName) {
+            return null;
+        }
+        const target = this.containerId || this.containerName;
+        try {
+            // Get port mappings from container
+            const output = this.execDocker(['port', target]);
+            // Parse output like "8080/tcp -> 0.0.0.0:3000"
+            for (const line of output.split('\n')) {
+                const match = line.match(/-> (?:0\.0\.0\.0|127\.0\.0\.1|localhost):(\d+)/);
+                if (match) {
+                    this.port = parseInt(match[1], 10);
+                    await debugLog('DockerRunner', `Detected port ${this.port} for ${this.id}`);
+                    return this.port;
+                }
+            }
+        }
+        catch {
+            // No port mappings
+        }
+        // Also try docker inspect for exposed ports
+        try {
+            const output = this.execDocker([
+                'inspect',
+                '-f',
+                '{{range $p, $conf := .NetworkSettings.Ports}}{{$p}}={{(index $conf 0).HostPort}} {{end}}',
+                target,
+            ]);
+            const match = output.match(/=(\d+)/);
+            if (match) {
+                this.port = parseInt(match[1], 10);
+                return this.port;
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return null;
+    }
+    async cleanup() {
+        // Nothing special to clean up
+    }
+    /** Getters for state persistence */
+    getId() { return this.id; }
+    getCommand() { return this.command; }
+    getCwd() { return this.cwd; }
+    getPid() { return -1; }
+    getContainerId() { return this.containerId; }
+    getPort() { return this.port; }
+    getStartedAt() { return this.startedAt; }
+    /** Setters */
+    setPort(port) { this.port = port; }
+    /**
+     * Get log access info
+     */
+    getLogAccess() {
+        const target = this.containerId || this.containerName || this.id;
+        return {
+            type: 'command',
+            command: `docker logs ${target}`,
+        };
+    }
+}
+//# sourceMappingURL=docker-runner.js.map

package/build/runners/docker-runner.js.map

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

package/build/runners/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Runners Index
+ * Export all runner types and factory function
+ */
+export * from './types.js';
+export { NativeRunner } from './native-runner.js';
+export { DockerRunner, resetDockerCheck } from './docker-runner.js';
+export { DockerComposeRunner, resetComposeCheck } from './docker-compose-runner.js';
+import type { Runner, RunnerType } from './types.js';
+/**
+ * Create a runner instance based on type
+ */
+export declare function createRunner(type: RunnerType, id: string): Runner;
+/**
+ * Reset Docker availability caches.
+ * Called before autoRun to ensure Docker is checked fresh each time.
+ */
+export declare function resetDockerCaches(): void;
+//# sourceMappingURL=index.d.ts.map

package/build/runners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runners/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKrD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAWjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}

package/build/runners/index.js

@@ -0,0 +1,35 @@
+/**
+ * Runners Index
+ * Export all runner types and factory function
+ */
+export * from './types.js';
+export { NativeRunner } from './native-runner.js';
+export { DockerRunner, resetDockerCheck } from './docker-runner.js';
+export { DockerComposeRunner, resetComposeCheck } from './docker-compose-runner.js';
+import { NativeRunner } from './native-runner.js';
+import { DockerRunner, resetDockerCheck } from './docker-runner.js';
+import { DockerComposeRunner, resetComposeCheck } from './docker-compose-runner.js';
+/**
+ * Create a runner instance based on type
+ */
+export function createRunner(type, id) {
+    switch (type) {
+        case 'native':
+            return new NativeRunner(id);
+        case 'docker':
+            return new DockerRunner(id);
+        case 'docker-compose':
+            return new DockerComposeRunner(id);
+        default:
+            throw new Error(`Unknown runner type: ${type}`);
+    }
+}
+/**
+ * Reset Docker availability caches.
+ * Called before autoRun to ensure Docker is checked fresh each time.
+ */
+export function resetDockerCaches() {
+    resetDockerCheck();
+    resetComposeCheck();
+}
+//# sourceMappingURL=index.js.map

package/build/runners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runners/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAgB,EAAE,EAAU;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,gBAAgB;YACnB,OAAO,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,EAAE,CAAC;AACtB,CAAC"}

package/build/runners/native-runner.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Native Runner
+ * Runs processes directly using Node.js spawn (the original behavior)
+ */
+import type { Runner, RunnerType, RunnerStartOptions, RunnerStartResult, RunnerStopOptions, RunnerLogOptions, RunnerStatus, PersistedRunnerState } from './types.js';
+export declare class NativeRunner implements Runner {
+    readonly type: RunnerType;
+    private id;
+    private command;
+    private cwd;
+    private process;
+    private pid;
+    private port;
+    private startedAt;
+    /** OS-reported start time of `pid`, to detect a recycled pid. */
+    private pidStartedAt;
+    private logCursor;
+    private global;
+    constructor(id: string);
+    /**
+     * Set whether this runner uses global storage
+     */
+    setGlobal(global: boolean): void;
+    /**
+     * Restore state from persisted data (for recovery)
+     */
+    restore(data: PersistedRunnerState): void;
+    private getLogDir;
+    private getStdoutLogPath;
+    private getStderrLogPath;
+    private ensureLogDir;
+    /**
+     * PROCESS IDENTITY
+     *
+     * `kill(pid, 0)` only answers "is some process wearing this number", which
+     * is not the same question. A dev server that crashed leaves its pid behind
+     * in servers.json, and once the OS recycles that number the dead server
+     * reads as running: it gets recovered instead of restarted, autoRun never
+     * fires, and `server list` reports a corpse as live.
+     *
+     * So a pid recovered from disk is only trusted when the OS still reports the
+     * same start time for it. An unreadable start time on either side cannot
+     * disprove anything, so it counts as alive - the cost of being wrong that way
+     * is a server we decline to touch, rather than one we wrongly declare dead.
+     */
+    private isProcessRunning;
+    private detectPortFromLine;
+    start(options: RunnerStartOptions): Promise<RunnerStartResult>;
+    stop(options?: RunnerStopOptions): Promise<void>;
+    isRunning(): Promise<boolean>;
+    getStatus(): Promise<RunnerStatus>;
+    getLogs(options?: RunnerLogOptions): Promise<string[]>;
+    private countFileLines;
+    detectPort(): Promise<number | null>;
+    cleanup(): Promise<void>;
+    /**
+     * Initialize cursor to end of file (for recovered servers)
+     */
+    initializeCursorToEOF(): Promise<void>;
+    /**
+     * Clear log files
+     */
+    clearLogs(): Promise<{
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    }>;
+    /**
+     * Get log access info
+     */
+    getLogAccess(): {
+        type: 'file';
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    };
+    /**
+     * Get log stats for status line
+     */
+    getLogStats(): {
+        newStdout: number;
+        newStderr: number;
+    };
+    /** Getters for state persistence */
+    getId(): string;
+    getCommand(): string;
+    getCwd(): string;
+    getPid(): number;
+    getPidStartedAt(): string;
+    getPort(): number | null;
+    getStartedAt(): Date | null;
+    /** Setters for port (when detected externally) */
+    setPort(port: number): void;
+}
+//# sourceMappingURL=native-runner.d.ts.map

package/build/runners/native-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-runner.d.ts","sourceRoot":"","sources":["../../src/runners/native-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAY;IAErC,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAqB;IACtC,iEAAiE;IACjE,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,EAAE,EAAE,MAAM;IAItB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAWzC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;YAIV,YAAY;IAO1B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,kBAAkB;IAmBpB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6D9D,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEhD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7B,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAsBlC,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2C5D,OAAO,CAAC,cAAc;IAUhB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwBpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAatF;;OAEG;IACH,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IASxF;;OAEG;IACH,WAAW,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAUvD,oCAAoC;IACpC,KAAK,IAAI,MAAM;IACf,UAAU,IAAI,MAAM;IACpB,MAAM,IAAI,MAAM;IAChB,MAAM,IAAI,MAAM;IAChB,eAAe,IAAI,MAAM;IACzB,OAAO,IAAI,MAAM,GAAG,IAAI;IACxB,YAAY,IAAI,IAAI,GAAG,IAAI;IAE3B,kDAAkD;IAClD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAC5B"}