@kaitranntt/ccs 6.7.0-dev.2 → 6.7.0-dev.4

package/dist/cliproxy/service-manager.js

@@ -40,8 +40,10 @@ const child_process_1 = require("child_process");
 const net = __importStar(require("net"));
 const binary_manager_1 = require("./binary-manager");
 const config_generator_1 = require("./config-generator");
-const stats_fetcher_1 = require("./stats-fetcher");
 const session_tracker_1 = require("./session-tracker");
+const proxy_detector_1 = require("./proxy-detector");
+const startup_lock_1 = require("./startup-lock");
+const stats_fetcher_1 = require("./stats-fetcher");
 /** Background proxy process reference */
 let proxyProcess = null;
 /** Cleanup registered flag */
@@ -108,9 +110,6 @@ async function ensureCliproxyService(port = config_generator_1.CLIPROXY_DEFAULT_
             console.error(`[cliproxy-service] ${msg}`);
         }
     };
-    // Check if already running (from another process or previous start)
-    log(`Checking if CLIProxy is running on port ${port}...`);
-    const running = await (0, stats_fetcher_1.isCliproxyRunning)(port);
     // Check if config needs update (even if running)
     let configRegenerated = false;
     if ((0, config_generator_1.configNeedsRegeneration)()) {
@@ -118,92 +117,120 @@ async function ensureCliproxyService(port = config_generator_1.CLIPROXY_DEFAULT_
         (0, config_generator_1.regenerateConfig)(port);
         configRegenerated = true;
     }
-    if (running) {
-        log('CLIProxy already running');
-        if (configRegenerated) {
-            log('Config was updated - running instance will use new config on next restart');
+    // Use startup lock to coordinate with other CCS processes (ccs agy, ccs config, etc.)
+    return await (0, startup_lock_1.withStartupLock)(async () => {
+        // Use unified detection (HTTP check + session-lock + port-process)
+        log(`Checking if CLIProxy is running on port ${port}...`);
+        const proxyStatus = await (0, proxy_detector_1.detectRunningProxy)(port);
+        log(`Proxy detection: ${JSON.stringify(proxyStatus)}`);
+        if (proxyStatus.running && proxyStatus.verified) {
+            // Already running and healthy
+            log('CLIProxy already running');
+            if (configRegenerated) {
+                log('Config was updated - running instance will use new config on next restart');
+            }
+            return { started: true, alreadyRunning: true, port, configRegenerated };
         }
-        return { started: true, alreadyRunning: true, port, configRegenerated };
-    }
-    // Need to start new instance
-    log('CLIProxy not running, starting background instance...');
-    // 1. Ensure binary exists
-    let binaryPath;
-    try {
-        binaryPath = await (0, binary_manager_1.ensureCLIProxyBinary)(verbose);
-        log(`Binary ready: ${binaryPath}`);
-    }
-    catch (error) {
-        const err = error;
-        return {
-            started: false,
-            alreadyRunning: false,
-            port,
-            error: `Failed to prepare binary: ${err.message}`,
-        };
-    }
-    // 2. Ensure/regenerate config if needed
-    let configPath;
-    if ((0, config_generator_1.configNeedsRegeneration)()) {
-        log('Config needs regeneration, updating...');
-        configPath = (0, config_generator_1.regenerateConfig)(port);
-    }
-    else {
-        // generateConfig only creates if doesn't exist
-        configPath = (0, config_generator_1.generateConfig)('gemini', port); // Provider doesn't matter for unified config
-    }
-    log(`Config ready: ${configPath}`);
-    // 3. Spawn background process
-    const proxyArgs = ['--config', configPath];
-    log(`Spawning: ${binaryPath} ${proxyArgs.join(' ')}`);
-    proxyProcess = (0, child_process_1.spawn)(binaryPath, proxyArgs, {
-        stdio: ['ignore', verbose ? 'pipe' : 'ignore', verbose ? 'pipe' : 'ignore'],
-        detached: true, // Allow process to run independently
-        env: {
-            ...process.env,
-            WRITABLE_PATH: (0, config_generator_1.getCliproxyWritablePath)(), // Logs stored in ~/.ccs/cliproxy/logs/
-        },
-    });
-    // Forward output in verbose mode
-    if (verbose) {
-        proxyProcess.stdout?.on('data', (data) => {
-            process.stderr.write(`[cliproxy] ${data.toString()}`);
+        if (proxyStatus.running && !proxyStatus.verified) {
+            // Proxy detected but not ready yet (another process is starting it)
+            log(`Proxy starting up (detected via ${proxyStatus.method}), waiting...`);
+            const becameHealthy = await (0, proxy_detector_1.waitForProxyHealthy)(port, 5000);
+            if (becameHealthy) {
+                log('Proxy became healthy');
+                return { started: true, alreadyRunning: true, port, configRegenerated };
+            }
+            // Proxy didn't become healthy - will try to start fresh below
+            log('Proxy detected but not responding, will start fresh');
+        }
+        if (proxyStatus.blocked) {
+            // Port blocked by non-CLIProxy process - try HTTP as last resort
+            const isActuallyOurs = await (0, proxy_detector_1.waitForProxyHealthy)(port, 1000);
+            if (isActuallyOurs) {
+                log('Reclaimed CLIProxy with unrecognized process name');
+                return { started: true, alreadyRunning: true, port, configRegenerated };
+            }
+            // Truly blocked
+            return {
+                started: false,
+                alreadyRunning: false,
+                port,
+                error: `Port ${port} is blocked by ${proxyStatus.blocker?.processName}`,
+            };
+        }
+        // Need to start new instance
+        log('CLIProxy not running, starting background instance...');
+        // 1. Ensure binary exists
+        let binaryPath;
+        try {
+            binaryPath = await (0, binary_manager_1.ensureCLIProxyBinary)(verbose);
+            log(`Binary ready: ${binaryPath}`);
+        }
+        catch (error) {
+            const err = error;
+            return {
+                started: false,
+                alreadyRunning: false,
+                port,
+                error: `Failed to prepare binary: ${err.message}`,
+            };
+        }
+        // 2. Ensure/regenerate config if needed
+        let configPath;
+        if ((0, config_generator_1.configNeedsRegeneration)()) {
+            log('Config needs regeneration, updating...');
+            configPath = (0, config_generator_1.regenerateConfig)(port);
+        }
+        else {
+            configPath = (0, config_generator_1.generateConfig)('gemini', port);
+        }
+        log(`Config ready: ${configPath}`);
+        // 3. Spawn background process
+        const proxyArgs = ['--config', configPath];
+        log(`Spawning: ${binaryPath} ${proxyArgs.join(' ')}`);
+        proxyProcess = (0, child_process_1.spawn)(binaryPath, proxyArgs, {
+            stdio: ['ignore', verbose ? 'pipe' : 'ignore', verbose ? 'pipe' : 'ignore'],
+            detached: true,
+            env: {
+                ...process.env,
+                WRITABLE_PATH: (0, config_generator_1.getCliproxyWritablePath)(),
+            },
         });
-        proxyProcess.stderr?.on('data', (data) => {
-            process.stderr.write(`[cliproxy-err] ${data.toString()}`);
+        if (verbose) {
+            proxyProcess.stdout?.on('data', (data) => {
+                process.stderr.write(`[cliproxy] ${data.toString()}`);
+            });
+            proxyProcess.stderr?.on('data', (data) => {
+                process.stderr.write(`[cliproxy-err] ${data.toString()}`);
+            });
+        }
+        proxyProcess.unref();
+        proxyProcess.on('error', (error) => {
+            log(`Spawn error: ${error.message}`);
         });
-    }
-    // Don't let this process prevent parent from exiting
-    proxyProcess.unref();
-    // Handle spawn errors
-    proxyProcess.on('error', (error) => {
-        log(`Spawn error: ${error.message}`);
-    });
-    // Register cleanup handlers
-    registerCleanup();
-    // 4. Wait for proxy to be ready
-    log(`Waiting for CLIProxy on port ${port}...`);
-    const ready = await waitForPort(port, 5000);
-    if (!ready) {
-        // Kill failed process
-        if (proxyProcess && !proxyProcess.killed) {
-            proxyProcess.kill('SIGTERM');
-            proxyProcess = null;
+        registerCleanup();
+        // 4. Wait for proxy to be ready
+        log(`Waiting for CLIProxy on port ${port}...`);
+        const ready = await waitForPort(port, 5000);
+        if (!ready) {
+            if (proxyProcess && !proxyProcess.killed) {
+                proxyProcess.kill('SIGTERM');
+                proxyProcess = null;
+            }
+            return {
+                started: false,
+                alreadyRunning: false,
+                port,
+                error: `CLIProxy failed to start within 5s on port ${port}`,
+            };
         }
-        return {
-            started: false,
-            alreadyRunning: false,
-            port,
-            error: `CLIProxy failed to start within 5s on port ${port}`,
-        };
-    }
-    log(`CLIProxy service started on port ${port}`);
-    // 5. Register session so stopProxy() can find and kill this process
-    if (proxyProcess.pid) {
-        (0, session_tracker_1.registerSession)(port, proxyProcess.pid);
-        log(`Session registered for PID ${proxyProcess.pid}`);
-    }
-    return { started: true, alreadyRunning: false, port };
+        log(`CLIProxy service started on port ${port}`);
+        // 5. Register session
+        if (proxyProcess.pid) {
+            (0, session_tracker_1.registerSession)(port, proxyProcess.pid);
+            log(`Session registered for PID ${proxyProcess.pid}`);
+        }
+        return { started: true, alreadyRunning: false, port };
+    });
 }
 exports.ensureCliproxyService = ensureCliproxyService;
 /**

package/dist/cliproxy/service-manager.js.map

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

package/dist/cliproxy/startup-lock.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Startup Lock for CLIProxy
+ *
+ * File-based mutex to prevent race conditions when multiple
+ * CCS processes try to start CLIProxy simultaneously.
+ *
+ * Uses a lock file with PID and timestamp to coordinate startup.
+ * Lock is automatically released after timeout or process exit.
+ *
+ * Lock Timeout Rationale (10 seconds):
+ * - CLIProxy startup typically takes 1-3s (binary spawn + port bind)
+ * - HTTP health check takes ~1s timeout
+ * - Session registration takes <100ms
+ * - Total expected lock hold time: 2-5s
+ * - 10s provides 2x safety margin for slow systems/disk I/O
+ * - Too short: legitimate startups fail on slow systems
+ * - Too long: dead processes block other terminals unnecessarily
+ *
+ * Why file-based instead of port-based:
+ * - Works before port is bound (prevents duplicate spawn attempts)
+ * - Survives process crashes (stale detection via PID check)
+ * - Cross-platform (Windows, macOS, Linux)
+ */
+/** Lock acquisition result */
+export interface LockResult {
+    acquired: boolean;
+    lockPath: string;
+    release: () => void;
+}
+/**
+ * Acquire the startup lock with retries.
+ *
+ * @param options.retries Number of retry attempts (default: 20)
+ * @param options.retryInterval Ms between retries (default: 250)
+ * @param options.verbose Enable verbose logging (default: false)
+ * @returns LockResult
+ * @throws Error if lock cannot be acquired after all retries
+ */
+export declare function acquireStartupLock(options?: {
+    retries?: number;
+    retryInterval?: number;
+    verbose?: boolean;
+}): Promise<LockResult>;
+/**
+ * Execute a function while holding the startup lock.
+ * Lock is automatically released after function completes or throws.
+ *
+ * @param fn Function to execute
+ * @param options Lock acquisition options (retries, retryInterval, verbose)
+ * @returns Result of fn
+ */
+export declare function withStartupLock<T>(fn: () => Promise<T>, options?: {
+    retries?: number;
+    retryInterval?: number;
+    verbose?: boolean;
+}): Promise<T>;
+//# sourceMappingURL=startup-lock.d.ts.map

package/dist/cliproxy/startup-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-lock.d.ts","sourceRoot":"","sources":["../../src/cliproxy/startup-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAaH,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAkID;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBtB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACxE,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/cliproxy/startup-lock.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Startup Lock for CLIProxy
+ *
+ * File-based mutex to prevent race conditions when multiple
+ * CCS processes try to start CLIProxy simultaneously.
+ *
+ * Uses a lock file with PID and timestamp to coordinate startup.
+ * Lock is automatically released after timeout or process exit.
+ *
+ * Lock Timeout Rationale (10 seconds):
+ * - CLIProxy startup typically takes 1-3s (binary spawn + port bind)
+ * - HTTP health check takes ~1s timeout
+ * - Session registration takes <100ms
+ * - Total expected lock hold time: 2-5s
+ * - 10s provides 2x safety margin for slow systems/disk I/O
+ * - Too short: legitimate startups fail on slow systems
+ * - Too long: dead processes block other terminals unnecessarily
+ *
+ * Why file-based instead of port-based:
+ * - Works before port is bound (prevents duplicate spawn attempts)
+ * - Survives process crashes (stale detection via PID check)
+ * - Cross-platform (Windows, macOS, Linux)
+ */
+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.withStartupLock = exports.acquireStartupLock = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_generator_1 = require("./config-generator");
+/** Lock file name */
+const LOCK_FILE = '.startup.lock';
+/** Lock timeout in ms (stale lock auto-released) */
+const LOCK_TIMEOUT_MS = 10000; // 10 seconds - see module docstring for rationale
+/** No-op logger for when verbose is disabled */
+const noopLog = () => { };
+/**
+ * Get path to startup lock file
+ */
+function getLockPath() {
+    return path.join((0, config_generator_1.getCliproxyDir)(), LOCK_FILE);
+}
+/**
+ * Check if a lock is stale (old or from dead process)
+ */
+function isLockStale(lockData) {
+    // Check timestamp
+    if (Date.now() - lockData.timestamp > LOCK_TIMEOUT_MS) {
+        return true;
+    }
+    // Check if PID is still running
+    try {
+        process.kill(lockData.pid, 0);
+        return false; // Process exists
+    }
+    catch {
+        return true; // Process dead
+    }
+}
+/**
+ * Try to acquire the startup lock once.
+ *
+ * @param log Logger function for verbose output
+ * @returns LockResult with acquired=true if lock obtained
+ */
+function tryAcquireLockOnce(log) {
+    const lockPath = getLockPath();
+    const dir = path.dirname(lockPath);
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+        log(`Creating lock directory: ${dir}`);
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    // Check for existing lock
+    if (fs.existsSync(lockPath)) {
+        try {
+            const content = fs.readFileSync(lockPath, 'utf-8');
+            const lockData = JSON.parse(content);
+            if (!isLockStale(lockData)) {
+                // Lock is held by another active process
+                log(`Lock held by PID ${lockData.pid} (age: ${Date.now() - lockData.timestamp}ms)`);
+                return {
+                    acquired: false,
+                    lockPath,
+                    release: () => { },
+                };
+            }
+            // Lock is stale - remove and continue
+            log(`Removing stale lock from PID ${lockData.pid}`);
+        }
+        catch {
+            // Invalid lock file - remove and continue
+            log('Removing invalid lock file');
+        }
+        try {
+            fs.unlinkSync(lockPath);
+        }
+        catch {
+            // Ignore removal errors
+        }
+    }
+    // Try to create lock atomically
+    const lockData = {
+        pid: process.pid,
+        timestamp: Date.now(),
+        hostname: require('os').hostname(),
+    };
+    try {
+        // Use 'wx' flag for exclusive creation (fails if exists)
+        fs.writeFileSync(lockPath, JSON.stringify(lockData), { flag: 'wx', mode: 0o600 });
+        log(`Lock acquired by PID ${process.pid}`);
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'EEXIST') {
+            // Another process created lock between our check and write
+            log('Lock acquisition race - another process won');
+            return {
+                acquired: false,
+                lockPath,
+                release: () => { },
+            };
+        }
+        throw error;
+    }
+    // Lock acquired - return release function
+    const release = () => {
+        try {
+            // Only release if we still own it
+            const content = fs.readFileSync(lockPath, 'utf-8');
+            const currentLock = JSON.parse(content);
+            if (currentLock.pid === process.pid) {
+                fs.unlinkSync(lockPath);
+                log('Lock released');
+            }
+        }
+        catch {
+            // Ignore release errors
+        }
+    };
+    return {
+        acquired: true,
+        lockPath,
+        release,
+    };
+}
+/**
+ * Acquire the startup lock with retries.
+ *
+ * @param options.retries Number of retry attempts (default: 20)
+ * @param options.retryInterval Ms between retries (default: 250)
+ * @param options.verbose Enable verbose logging (default: false)
+ * @returns LockResult
+ * @throws Error if lock cannot be acquired after all retries
+ */
+async function acquireStartupLock(options) {
+    const retries = options?.retries ?? 20;
+    const retryInterval = options?.retryInterval ?? 250;
+    const log = options?.verbose ? (msg) => console.error(`[startup-lock] ${msg}`) : noopLog;
+    log(`Attempting to acquire startup lock (max ${retries} retries, ${retryInterval}ms interval)`);
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        const result = tryAcquireLockOnce(log);
+        if (result.acquired) {
+            return result;
+        }
+        if (attempt < retries) {
+            log(`Retry ${attempt + 1}/${retries} in ${retryInterval}ms...`);
+            await new Promise((r) => setTimeout(r, retryInterval));
+        }
+    }
+    log(`Failed to acquire lock after ${retries} attempts`);
+    throw new Error(`Failed to acquire startup lock after ${retries} attempts. ` +
+        `Another CCS process may be starting CLIProxy.`);
+}
+exports.acquireStartupLock = acquireStartupLock;
+/**
+ * Execute a function while holding the startup lock.
+ * Lock is automatically released after function completes or throws.
+ *
+ * @param fn Function to execute
+ * @param options Lock acquisition options (retries, retryInterval, verbose)
+ * @returns Result of fn
+ */
+async function withStartupLock(fn, options) {
+    const lock = await acquireStartupLock(options);
+    try {
+        return await fn();
+    }
+    finally {
+        lock.release();
+    }
+}
+exports.withStartupLock = withStartupLock;
+//# sourceMappingURL=startup-lock.js.map

package/dist/cliproxy/startup-lock.js.map

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

package/dist/management/recovery-manager.d.ts

@@ -1,5 +1,7 @@
 /**
  * Auto-recovery for missing or corrupted configuration
+ * Lazy initialization: Creates ~/.ccs/ structure on first CLI run
+ * Mirrors postinstall.js behavior for package managers that skip lifecycle scripts (e.g., bun)
  */
 /**
  * Recovery Manager Class
@@ -8,6 +10,8 @@ declare class RecoveryManager {
     private readonly homedir;
     private readonly ccsDir;
     private readonly claudeDir;
+    private readonly sharedDir;
+    private readonly completionsDir;
     private recovered;
     constructor();
     /**
@@ -23,7 +27,28 @@ declare class RecoveryManager {
      */
     ensureClaudeSettings(): boolean;
     /**
-     * Run all recovery operations
+     * Ensure ~/.ccs/shared/ directory structure exists
+     */
+    ensureSharedDirectories(): boolean;
+    /**
+     * Ensure GLM settings file exists
+     */
+    ensureGlmSettings(): boolean;
+    /**
+     * Ensure GLMT settings file exists
+     */
+    ensureGlmtSettings(): boolean;
+    /**
+     * Ensure Kimi settings file exists
+     */
+    ensureKimiSettings(): boolean;
+    /**
+     * Install shell completion files
+     */
+    ensureShellCompletions(): boolean;
+    /**
+     * Run all recovery operations (lazy initialization)
+     * Mirrors postinstall.js behavior
      */
     recoverAll(): boolean;
     /**

package/dist/management/recovery-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recovery-manager.d.ts","sourceRoot":"","sources":["../../src/management/recovery-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAW;;IAS5B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAS7B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAkC3B;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAsB/B;;OAEG;IACH,UAAU,IAAI,OAAO;IAUrB;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAgB1B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"recovery-manager.d.ts","sourceRoot":"","sources":["../../src/management/recovery-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,SAAS,CAAW;;IAW5B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAS7B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAoC3B;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAsB/B;;OAEG;IACH,uBAAuB,IAAI,OAAO;IAuBlC;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAsB5B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IA6B7B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAuB7B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IA+CjC;;;OAGG;IACH,UAAU,IAAI,OAAO;IAoBrB;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAiC1B;AAED,eAAe,eAAe,CAAC"}