@georgedong32/ccs 7.67.0 → 8.0.0

package/dist/cliproxy/proxy/proxy-detector.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Unified Proxy Detector
+ *
+ * Single source of truth for CLIProxy detection.
+ * Uses multiple detection methods with fallbacks:
+ * 1. HTTP health check (most reliable, ~1s timeout)
+ * 2. Session lock file (sessions.json)
+ * 3. Port process detection (fallback for orphaned proxies)
+ *
+ * Detection Order Rationale:
+ * - HTTP first: Fastest verification that proxy is responsive
+ * - Session lock second: Catches proxies that are starting up
+ * - Port process third: Handles orphaned proxies and Windows PID-XXXXX case
+ *
+ * Solves race conditions between cliproxy-executor.ts and service-manager.ts
+ */
+import { PortProcess } from '../../utils/port-utils';
+/** Detection method used to find the proxy */
+export type DetectionMethod = 'http' | 'session-lock' | 'port-process' | 'http-retry';
+/** Proxy detection status */
+export interface ProxyStatus {
+    /** Whether a proxy is running on the port */
+    running: boolean;
+    /** Whether the proxy was verified healthy via HTTP */
+    verified: boolean;
+    /** How the proxy was detected */
+    method?: DetectionMethod;
+    /** PID of the running proxy (if known) */
+    pid?: number;
+    /** Whether port is blocked by non-CLIProxy process */
+    blocked?: boolean;
+    /** Process blocking the port (if blocked) */
+    blocker?: PortProcess;
+    /** Number of active sessions (if session-lock found) */
+    sessionCount?: number;
+    /** Version of the running proxy (from session lock) */
+    version?: string;
+}
+/**
+ * Detect running CLIProxy using multiple methods with fallbacks.
+ *
+ * Detection order (most reliable first):
+ * 1. HTTP health check - fastest, verifies proxy is responsive
+ * 2. Session lock - checks sessions.json for tracked proxy
+ * 3. Port process - checks OS-level port ownership
+ *
+ * @param port Port to check (default: 8317)
+ * @param verbose Enable verbose logging (default: false)
+ * @returns ProxyStatus with detection details
+ */
+export declare function detectRunningProxy(port?: number, verbose?: boolean): Promise<ProxyStatus>;
+/**
+ * Wait for proxy to become ready (healthy via HTTP).
+ * Useful after detecting proxy via session-lock or port-process.
+ *
+ * @param port Port to check
+ * @param timeout Max wait time in ms (default: 5000)
+ * @param pollInterval Time between checks in ms (default: 100)
+ * @returns true if proxy became ready, false if timeout
+ */
+export declare function waitForProxyHealthy(port: number, timeout?: number, pollInterval?: number): Promise<boolean>;
+/**
+ * Attempt to reclaim an orphaned CLIProxy (running but not in session tracker).
+ * Registers a new session with the detected proxy.
+ *
+ * @param port Port where proxy is running
+ * @param pid PID of the proxy process
+ * @param verbose Enable verbose logging (default: false)
+ * @returns Session ID if reclaimed, null if failed
+ */
+export declare function reclaimOrphanedProxy(port: number, pid: number, verbose?: boolean): string | null;
+//# sourceMappingURL=proxy-detector.d.ts.map

package/dist/cliproxy/proxy/proxy-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-detector.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/proxy/proxy-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAqC,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIxF,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;AAEtF,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,MAA8B,EACpC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAgItB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAa,EACtB,YAAY,GAAE,MAAY,GACzB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAe,GACvB,MAAM,GAAG,IAAI,CAef"}

package/dist/cliproxy/proxy/proxy-detector.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Unified Proxy Detector
+ *
+ * Single source of truth for CLIProxy detection.
+ * Uses multiple detection methods with fallbacks:
+ * 1. HTTP health check (most reliable, ~1s timeout)
+ * 2. Session lock file (sessions.json)
+ * 3. Port process detection (fallback for orphaned proxies)
+ *
+ * Detection Order Rationale:
+ * - HTTP first: Fastest verification that proxy is responsive
+ * - Session lock second: Catches proxies that are starting up
+ * - Port process third: Handles orphaned proxies and Windows PID-XXXXX case
+ *
+ * Solves race conditions between cliproxy-executor.ts and service-manager.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reclaimOrphanedProxy = exports.waitForProxyHealthy = exports.detectRunningProxy = void 0;
+const session_tracker_1 = require("../session-tracker");
+const stats_fetcher_1 = require("../services/stats-fetcher");
+const port_utils_1 = require("../../utils/port-utils");
+const port_manager_1 = require("../config/port-manager");
+const logging_1 = require("../../services/logging");
+/** No-op logger for when verbose is disabled */
+const noopLog = () => { };
+const logger = (0, logging_1.createLogger)('cliproxy:proxy-detector');
+/**
+ * Detect running CLIProxy using multiple methods with fallbacks.
+ *
+ * Detection order (most reliable first):
+ * 1. HTTP health check - fastest, verifies proxy is responsive
+ * 2. Session lock - checks sessions.json for tracked proxy
+ * 3. Port process - checks OS-level port ownership
+ *
+ * @param port Port to check (default: 8317)
+ * @param verbose Enable verbose logging (default: false)
+ * @returns ProxyStatus with detection details
+ */
+async function detectRunningProxy(port = port_manager_1.CLIPROXY_DEFAULT_PORT, verbose = false) {
+    const log = verbose ? (msg) => logger.debug('detect.verbose', msg, { port }) : noopLog;
+    // Validate port - fallback to default if invalid
+    const validPort = port && Number.isFinite(port) && port >= 1 && port <= 65535 ? port : port_manager_1.CLIPROXY_DEFAULT_PORT;
+    log(`Detecting proxy on port ${validPort}...`);
+    // 1. First: HTTP health check (fastest, most reliable)
+    log('Trying HTTP health check...');
+    const healthy = await (0, stats_fetcher_1.isCliproxyRunning)(validPort);
+    if (healthy) {
+        // Proxy is running and responsive
+        // Try to get PID from session lock if available
+        const lock = (0, session_tracker_1.getExistingProxy)(validPort);
+        let pid = lock?.pid;
+        // If no PID from session lock, try port-process detection
+        // This handles orphaned proxies (running but no sessions.json)
+        if (!pid) {
+            log('No PID from session lock, checking port process...');
+            const portProcess = await (0, port_utils_1.getPortProcess)(validPort);
+            if (portProcess) {
+                pid = portProcess.pid;
+                log(`Got PID from port process: ${pid}`);
+            }
+        }
+        // Get version from session lock
+        const runningVersion = (0, session_tracker_1.getRunningProxyVersion)(validPort);
+        log(`HTTP check passed, proxy healthy (PID: ${pid ?? 'unknown'}, version: ${runningVersion ?? 'unknown'})`);
+        return {
+            running: true,
+            verified: true,
+            method: 'http',
+            pid,
+            sessionCount: lock?.sessions?.length,
+            version: runningVersion ?? undefined,
+        };
+    }
+    log('HTTP check failed, proxy not responding');
+    // 2. Second: Check session lock file
+    log('Checking session lock file...');
+    const lock = (0, session_tracker_1.getExistingProxy)(validPort);
+    if (lock) {
+        // Session lock exists - proxy might be starting up
+        // The lock validates PID is running, so proxy exists but not ready
+        const lockVersion = (0, session_tracker_1.getRunningProxyVersion)(validPort);
+        log(`Session lock found: PID ${lock.pid}, ${lock.sessions.length} sessions, version: ${lockVersion ?? 'unknown'}`);
+        return {
+            running: true,
+            verified: false,
+            method: 'session-lock',
+            pid: lock.pid,
+            sessionCount: lock.sessions.length,
+            version: lockVersion ?? undefined,
+        };
+    }
+    log('No session lock found');
+    // 3. Third: Check port process (fallback for orphaned/untracked proxy)
+    log('Checking port process...');
+    const portProcess = await (0, port_utils_1.getPortProcess)(validPort);
+    if (portProcess) {
+        log(`Port occupied by: ${portProcess.processName} (PID ${portProcess.pid})`);
+        // Check by process name first (works on Linux/macOS, may fail on Windows)
+        if ((0, port_utils_1.isCLIProxyProcess)(portProcess)) {
+            log('Process name matches CLIProxy, retrying HTTP...');
+            // Looks like CLIProxy by name - verify with HTTP
+            const retryHealth = await (0, stats_fetcher_1.isCliproxyRunning)(validPort);
+            if (retryHealth) {
+                log('HTTP retry passed, proxy is healthy');
+                return {
+                    running: true,
+                    verified: true,
+                    method: 'http-retry',
+                    pid: portProcess.pid,
+                };
+            }
+            // CLIProxy by name but not responding - might be starting up
+            log('HTTP retry failed, proxy starting up or unresponsive');
+            return {
+                running: true,
+                verified: false,
+                method: 'port-process',
+                pid: portProcess.pid,
+            };
+        }
+        // Process name doesn't match (or Windows returned PID-XXXXX)
+        // Do one more HTTP check to be sure it's not ours
+        log('Process name unrecognized, final HTTP check (Windows PID-XXXXX case)...');
+        const finalHealthCheck = await (0, stats_fetcher_1.isCliproxyRunning)(validPort);
+        if (finalHealthCheck) {
+            // It IS our proxy, just with unrecognized name (Windows case)
+            log('Final HTTP check passed, reclaiming proxy with unrecognized name');
+            return {
+                running: true,
+                verified: true,
+                method: 'http-retry',
+                pid: portProcess.pid,
+            };
+        }
+        // Definitely not our proxy - port is blocked
+        log(`Port blocked by non-CLIProxy process: ${portProcess.processName}`);
+        return {
+            running: false,
+            verified: false,
+            blocked: true,
+            blocker: portProcess,
+        };
+    }
+    // Port is free
+    log('Port is free, no proxy detected');
+    return {
+        running: false,
+        verified: false,
+    };
+}
+exports.detectRunningProxy = detectRunningProxy;
+/**
+ * Wait for proxy to become ready (healthy via HTTP).
+ * Useful after detecting proxy via session-lock or port-process.
+ *
+ * @param port Port to check
+ * @param timeout Max wait time in ms (default: 5000)
+ * @param pollInterval Time between checks in ms (default: 100)
+ * @returns true if proxy became ready, false if timeout
+ */
+async function waitForProxyHealthy(port, timeout = 5000, pollInterval = 100) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        const healthy = await (0, stats_fetcher_1.isCliproxyRunning)(port);
+        if (healthy) {
+            return true;
+        }
+        await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    return false;
+}
+exports.waitForProxyHealthy = waitForProxyHealthy;
+/**
+ * Attempt to reclaim an orphaned CLIProxy (running but not in session tracker).
+ * Registers a new session with the detected proxy.
+ *
+ * @param port Port where proxy is running
+ * @param pid PID of the proxy process
+ * @param verbose Enable verbose logging (default: false)
+ * @returns Session ID if reclaimed, null if failed
+ */
+function reclaimOrphanedProxy(port, pid, verbose = false) {
+    const log = verbose
+        ? (msg) => logger.debug('reclaim.verbose', msg, { port, pid })
+        : noopLog;
+    try {
+        log(`Reclaiming orphaned proxy: port=${port}, pid=${pid}`);
+        const sessionId = (0, session_tracker_1.registerSession)(port, pid);
+        log(`Successfully reclaimed proxy, session ID: ${sessionId}`);
+        return sessionId;
+    }
+    catch (err) {
+        const error = err;
+        log(`Failed to reclaim proxy: ${error.message}`);
+        return null;
+    }
+}
+exports.reclaimOrphanedProxy = reclaimOrphanedProxy;
+//# sourceMappingURL=proxy-detector.js.map

package/dist/cliproxy/proxy/proxy-detector.js.map

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

package/dist/cliproxy/proxy/proxy-target-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-target-resolver.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/proxy/proxy-target-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CA8B5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,EACnB,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxB"}

package/dist/cliproxy/proxy/proxy-target-resolver.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Proxy Target Resolver
+ *
+ * Determines whether CLIProxyAPI requests should go to local or remote
+ * based on unified config. Used by stats-fetcher, auth-routes, and UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildManagementHeaders = exports.buildProxyHeaders = exports.buildProxyUrl = exports.getProxyTarget = void 0;
+const port_manager_1 = require("../config/port-manager");
+const proxy_config_resolver_1 = require("./proxy-config-resolver");
+const auth_token_manager_1 = require("../auth/auth-token-manager");
+const config_loader_facade_1 = require("../../config/config-loader-facade");
+/**
+ * Load cliproxy_server configuration from unified config.
+ * Returns undefined if not configured.
+ */
+function loadCliproxyServerConfig() {
+    const config = (0, config_loader_facade_1.loadOrCreateUnifiedConfig)();
+    return config.cliproxy_server;
+}
+/**
+ * Get the current CLIProxyAPI target based on unified config.
+ * Returns remote server config if enabled, otherwise localhost.
+ */
+function getProxyTarget() {
+    const config = loadCliproxyServerConfig();
+    const envConfig = (0, proxy_config_resolver_1.getProxyEnvVars)();
+    if (config?.remote?.enabled && config.remote?.host) {
+        // Normalize protocol (handles case sensitivity and invalid values)
+        const protocol = (0, port_manager_1.normalizeProtocol)(config.remote.protocol);
+        // Validate port (returns undefined for invalid, triggering default)
+        const validatedPort = (0, port_manager_1.validateRemotePort)(config.remote.port);
+        const port = validatedPort ?? (0, port_manager_1.getRemoteDefaultPort)(protocol);
+        return {
+            host: config.remote.host,
+            port,
+            protocol,
+            authToken: config.remote.auth_token || undefined, // Empty string -> undefined
+            managementKey: config.remote.management_key || undefined, // Empty string -> undefined
+            allowSelfSigned: envConfig.allowSelfSigned,
+            isRemote: true,
+        };
+    }
+    const localPort = (0, port_manager_1.validatePort)(config?.local?.port ?? port_manager_1.CLIPROXY_DEFAULT_PORT);
+    return {
+        host: '127.0.0.1',
+        port: localPort,
+        protocol: 'http',
+        isRemote: false,
+    };
+}
+exports.getProxyTarget = getProxyTarget;
+/**
+ * Build URL for proxy endpoint
+ * @param target Resolved proxy target
+ * @param path Endpoint path (e.g., '/v0/management/usage')
+ */
+function buildProxyUrl(target, path) {
+    // Normalize path to ensure leading slash
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    return `${target.protocol}://${target.host}:${target.port}${normalizedPath}`;
+}
+exports.buildProxyUrl = buildProxyUrl;
+/**
+ * Build request headers for proxy requests
+ * Handles optional auth token - only adds Authorization header if token is set.
+ *
+ * @param target Resolved proxy target
+ * @param additionalHeaders Extra headers to merge
+ */
+function buildProxyHeaders(target, additionalHeaders = {}) {
+    const headers = {
+        Accept: 'application/json',
+        ...additionalHeaders,
+    };
+    // Only add auth header if token is configured
+    if (target.authToken) {
+        headers['Authorization'] = `Bearer ${target.authToken}`;
+    }
+    return headers;
+}
+exports.buildProxyHeaders = buildProxyHeaders;
+/**
+ * Build request headers for management API endpoints (/v0/management/*).
+ * For remote targets: uses management_key, falls back to authToken.
+ * For local targets: uses the effective management secret from CCS config.
+ *
+ * @param target Resolved proxy target
+ * @param additionalHeaders Extra headers to merge
+ */
+function buildManagementHeaders(target, additionalHeaders = {}) {
+    const headers = {
+        Accept: 'application/json',
+        ...additionalHeaders,
+    };
+    // Remote: use configured management key or auth token
+    // Local: use CCS management secret (default: 'ccs')
+    const authKey = target.isRemote
+        ? (target.managementKey ?? target.authToken)
+        : (0, auth_token_manager_1.getEffectiveManagementSecret)();
+    if (authKey) {
+        headers['Authorization'] = `Bearer ${authKey}`;
+    }
+    return headers;
+}
+exports.buildManagementHeaders = buildManagementHeaders;
+//# sourceMappingURL=proxy-target-resolver.js.map

package/dist/cliproxy/proxy/proxy-target-resolver.js.map

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

package/dist/cliproxy/proxy/tool-sanitization-proxy.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Tool Sanitization Proxy
+ *
+ * HTTP proxy that intercepts Claude CLI → CLIProxy requests to:
+ * 1. Sanitize MCP tool names exceeding Gemini's 64-char limit
+ * 2. Sanitize MCP tool input_schema to remove non-standard JSON Schema properties
+ * 3. Forward sanitized requests to upstream
+ * 4. Restore original names in responses
+ *
+ * Follows CodexReasoningProxy pattern for consistency.
+ */
+export interface ToolSanitizationProxyConfig {
+    /** Upstream CLIProxy URL */
+    upstreamBaseUrl: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Log warnings when sanitization occurs */
+    warnOnSanitize?: boolean;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+    /** Skip TLS certificate validation for self-signed remote HTTPS proxies */
+    allowSelfSigned?: boolean;
+}
+export declare class ToolSanitizationProxy {
+    private server;
+    private port;
+    private readonly config;
+    private readonly logFilePath;
+    private readonly debugMode;
+    private readonly logger;
+    constructor(config: ToolSanitizationProxyConfig);
+    /**
+     * Initialize log file path and ensure directory exists.
+     */
+    private initLogFile;
+    /**
+     * Write log entry to file (always) and console (if CCS_DEBUG=1).
+     */
+    private writeLog;
+    private log;
+    private warn;
+    /**
+     * Start the proxy server on an ephemeral port.
+     * @returns The assigned port number
+     */
+    start(): Promise<number>;
+    /**
+     * Stop the proxy server.
+     */
+    stop(): void;
+    /**
+     * Get the port the proxy is listening on.
+     */
+    getPort(): number | null;
+    private readBody;
+    private handleRequest;
+    private buildForwardHeaders;
+    private getRequestFn;
+    private startResponseTimeout;
+    private buildRequestOptions;
+    private forwardRaw;
+    /**
+     * Forward JSON request and buffer response for tool name restoration.
+     */
+    private forwardJsonBuffered;
+    /**
+     * Forward JSON request and stream response with tool name restoration.
+     * Handles SSE (Server-Sent Events) format.
+     */
+    private forwardJsonStreaming;
+    /**
+     * Process a single SSE event, restoring tool names if present.
+     */
+    private processSSEEvent;
+    /**
+     * Build a synthetic minimal SSE response when upstream returns empty content.
+     * Prevents Claude Code from crashing with "No assistant message found".
+     * Omits lifecycle events that upstream already sent to avoid protocol violations.
+     */
+    private buildSyntheticErrorResponse;
+}
+//# sourceMappingURL=tool-sanitization-proxy.d.ts.map

package/dist/cliproxy/proxy/tool-sanitization-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-sanitization-proxy.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/proxy/tool-sanitization-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA+GD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;gBAE/D,MAAM,EAAE,2BAA2B;IAY/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,IAAI;IAMZ;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAmB9B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,OAAO,CAAC,QAAQ;YAqBF,aAAa;IA6I3B,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,UAAU;IAiClB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwE3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmJ5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsDvB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;CAiCpC"}