@georgedong32/ccs 7.66.0

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

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Proxy Config Resolver
+ *
+ * Resolves proxy configuration from multiple sources with priority:
+ * CLI flags > Environment variables > config.yaml > defaults
+ *
+ * Supports both local (spawn CLIProxyAPI) and remote (connect to external) modes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasProxyFlags = exports.resolveProxyConfig = exports.getProxyEnvVars = exports.parseProxyFlags = exports.PROXY_ENV_VARS = exports.PROXY_CLI_FLAGS = void 0;
+const config_generator_1 = require("./config-generator");
+/** CLI flags for proxy configuration */
+exports.PROXY_CLI_FLAGS = [
+    '--proxy-host',
+    '--proxy-port',
+    '--proxy-protocol',
+    '--proxy-auth-token',
+    '--proxy-timeout',
+    '--local-proxy',
+    '--remote-only',
+    '--allow-self-signed',
+];
+/** Environment variable names for proxy configuration */
+exports.PROXY_ENV_VARS = {
+    host: 'CCS_PROXY_HOST',
+    port: 'CCS_PROXY_PORT',
+    protocol: 'CCS_PROXY_PROTOCOL',
+    authToken: 'CCS_PROXY_AUTH_TOKEN',
+    timeout: 'CCS_PROXY_TIMEOUT',
+    fallbackEnabled: 'CCS_PROXY_FALLBACK_ENABLED',
+    allowSelfSigned: 'CCS_ALLOW_SELF_SIGNED',
+};
+/**
+ * Parse proxy-related CLI flags from argv.
+ * Returns parsed flags and remaining args (with proxy flags removed).
+ */
+function parseProxyFlags(args) {
+    const flags = {
+        localProxy: false,
+        remoteOnly: false,
+    };
+    const remainingArgs = [];
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--proxy-host' && args[i + 1] && !args[i + 1].startsWith('-')) {
+            flags.host = args[i + 1];
+            i += 2;
+            continue;
+        }
+        if (arg === '--proxy-port' && args[i + 1] && !args[i + 1].startsWith('-')) {
+            const port = parseInt(args[i + 1], 10);
+            if (!isNaN(port) && port > 0 && port <= 65535) {
+                flags.port = port;
+            }
+            i += 2;
+            continue;
+        }
+        if (arg === '--proxy-protocol' && args[i + 1] && !args[i + 1].startsWith('-')) {
+            const proto = args[i + 1].toLowerCase();
+            if (proto === 'http' || proto === 'https') {
+                flags.protocol = proto;
+            }
+            i += 2;
+            continue;
+        }
+        if (arg === '--proxy-auth-token' && args[i + 1] && !args[i + 1].startsWith('-')) {
+            flags.authToken = args[i + 1];
+            i += 2;
+            continue;
+        }
+        if (arg === '--proxy-timeout' && args[i + 1] && !args[i + 1].startsWith('-')) {
+            const timeout = parseInt(args[i + 1], 10);
+            if (!isNaN(timeout) && timeout >= 100 && timeout <= 60000) {
+                flags.timeout = timeout;
+            }
+            i += 2;
+            continue;
+        }
+        if (arg === '--local-proxy') {
+            flags.localProxy = true;
+            i += 1;
+            continue;
+        }
+        if (arg === '--remote-only') {
+            flags.remoteOnly = true;
+            i += 1;
+            continue;
+        }
+        if (arg === '--allow-self-signed') {
+            flags.allowSelfSigned = true;
+            i += 1;
+            continue;
+        }
+        // Not a proxy flag - keep in remaining args
+        remainingArgs.push(arg);
+        i += 1;
+    }
+    return { flags, remainingArgs };
+}
+exports.parseProxyFlags = parseProxyFlags;
+/**
+ * Get proxy configuration from environment variables.
+ */
+function getProxyEnvVars() {
+    const config = {};
+    const host = process.env[exports.PROXY_ENV_VARS.host];
+    if (host) {
+        config.host = host;
+    }
+    const port = process.env[exports.PROXY_ENV_VARS.port];
+    if (port) {
+        const portNum = parseInt(port, 10);
+        if (!isNaN(portNum) && portNum > 0 && portNum <= 65535) {
+            config.port = portNum;
+        }
+    }
+    const protocol = process.env[exports.PROXY_ENV_VARS.protocol];
+    if (protocol) {
+        const proto = protocol.toLowerCase();
+        if (proto === 'http' || proto === 'https') {
+            config.protocol = proto;
+        }
+    }
+    const authToken = process.env[exports.PROXY_ENV_VARS.authToken];
+    if (authToken) {
+        config.authToken = authToken;
+    }
+    const timeout = process.env[exports.PROXY_ENV_VARS.timeout];
+    if (timeout) {
+        const timeoutNum = parseInt(timeout, 10);
+        if (!isNaN(timeoutNum) && timeoutNum >= 100 && timeoutNum <= 60000) {
+            config.timeout = timeoutNum;
+        }
+    }
+    const fallback = process.env[exports.PROXY_ENV_VARS.fallbackEnabled];
+    if (fallback !== undefined) {
+        // Accept: '1', 'true', 'yes' as enabled; '0', 'false', 'no' as disabled
+        const lower = fallback.toLowerCase();
+        if (lower === '1' || lower === 'true' || lower === 'yes') {
+            config.fallbackEnabled = true;
+        }
+        else if (lower === '0' || lower === 'false' || lower === 'no') {
+            config.fallbackEnabled = false;
+        }
+    }
+    const allowSelfSigned = process.env[exports.PROXY_ENV_VARS.allowSelfSigned];
+    if (allowSelfSigned !== undefined) {
+        const lower = allowSelfSigned.toLowerCase();
+        if (lower === '1' || lower === 'true' || lower === 'yes') {
+            config.allowSelfSigned = true;
+        }
+        else if (lower === '0' || lower === 'false' || lower === 'no') {
+            config.allowSelfSigned = false;
+        }
+    }
+    return config;
+}
+exports.getProxyEnvVars = getProxyEnvVars;
+/**
+ * Default proxy configuration values.
+ */
+const DEFAULT_PROXY_CONFIG = {
+    mode: 'local',
+    port: config_generator_1.CLIPROXY_DEFAULT_PORT,
+    protocol: 'http',
+    fallbackEnabled: true,
+    autoStartLocal: true,
+    remoteOnly: false,
+    forceLocal: false,
+};
+/**
+ * Resolve proxy configuration with priority: CLI > ENV > config.yaml > defaults.
+ *
+ * @param cliArgs - Raw CLI arguments
+ * @param configYamlProxy - Proxy section from config.yaml (optional, Phase 1)
+ * @returns Resolved configuration and remaining args (without proxy flags)
+ */
+function resolveProxyConfig(cliArgs, _configYamlProxy) {
+    // 1. Parse CLI flags (highest priority)
+    const { flags: cliFlags, remainingArgs } = parseProxyFlags(cliArgs);
+    // 2. Get environment variables
+    const envConfig = getProxyEnvVars();
+    // 3. config.yaml proxy section (passed as parameter - Phase 1 provides this)
+    // For now, we use empty object if not provided; Phase 1 integrates unified config loading
+    const yamlConfig = _configYamlProxy || {};
+    // 4. Build resolved config with priority merge
+    const resolved = {
+        ...DEFAULT_PROXY_CONFIG,
+    };
+    // Determine mode: remote if host is specified AND remote is not explicitly disabled
+    // Priority: CLI flags > ENV > YAML config
+    // If YAML config has enabled: false, it only blocks YAML-sourced config (CLI/ENV override)
+    const yamlRemoteEnabled = yamlConfig.remote?.enabled !== false;
+    const hasRemoteHost = cliFlags.host || envConfig.host || (yamlRemoteEnabled && yamlConfig.remote?.host);
+    // --local-proxy forces local mode regardless of remote config
+    if (cliFlags.localProxy) {
+        resolved.mode = 'local';
+        resolved.forceLocal = true;
+    }
+    else if (hasRemoteHost) {
+        resolved.mode = 'remote';
+    }
+    // Merge host: CLI > ENV > config.yaml
+    resolved.host = cliFlags.host ?? envConfig.host ?? yamlConfig.remote?.host;
+    // Merge port: CLI > ENV > config.yaml (remote or local) > default
+    // Validate YAML-sourced ports before use (CLI/ENV already validated during parse)
+    const yamlPort = resolved.mode === 'remote' ? yamlConfig.remote?.port : yamlConfig.local?.port;
+    resolved.port =
+        cliFlags.port ??
+            envConfig.port ??
+            (yamlPort !== undefined ? (0, config_generator_1.validatePort)(yamlPort) : undefined) ??
+            DEFAULT_PROXY_CONFIG.port;
+    // Merge protocol: CLI > ENV > config.yaml > default
+    resolved.protocol =
+        cliFlags.protocol ?? envConfig.protocol ?? yamlConfig.remote?.protocol ?? 'http';
+    // Merge auth token: CLI > ENV > config.yaml
+    resolved.authToken = cliFlags.authToken ?? envConfig.authToken ?? yamlConfig.remote?.auth_token;
+    resolved.managementKey = yamlConfig.remote?.management_key;
+    // Merge timeout: CLI > ENV > config.yaml > default (2000ms in executor)
+    resolved.timeout = cliFlags.timeout ?? envConfig.timeout ?? yamlConfig.remote?.timeout;
+    // Merge allowSelfSigned: CLI > ENV > default (true for backwards compatibility)
+    resolved.allowSelfSigned = cliFlags.allowSelfSigned ?? envConfig.allowSelfSigned ?? true;
+    // Merge fallback enabled: ENV > config.yaml > default
+    resolved.fallbackEnabled =
+        envConfig.fallbackEnabled ?? yamlConfig.remote?.fallback_enabled ?? true;
+    // --remote-only from CLI
+    resolved.remoteOnly = cliFlags.remoteOnly;
+    // If --remote-only, disable fallback
+    if (resolved.remoteOnly) {
+        resolved.fallbackEnabled = false;
+    }
+    // Auto-start local from config.yaml > default
+    resolved.autoStartLocal = yamlConfig.local?.auto_start ?? true;
+    return { config: resolved, remainingArgs };
+}
+exports.resolveProxyConfig = resolveProxyConfig;
+/**
+ * Check if args contain any proxy flags.
+ * Used for quick filtering before full parse.
+ */
+function hasProxyFlags(args) {
+    return args.some((arg) => arg === '--proxy-host' ||
+        arg === '--proxy-port' ||
+        arg === '--proxy-protocol' ||
+        arg === '--proxy-auth-token' ||
+        arg === '--proxy-timeout' ||
+        arg === '--local-proxy' ||
+        arg === '--remote-only' ||
+        arg === '--allow-self-signed');
+}
+exports.hasProxyFlags = hasProxyFlags;
+//# sourceMappingURL=proxy-config-resolver.js.map

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

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

package/dist/cliproxy/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-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-detector.d.ts","sourceRoot":"","sources":["../../src/cliproxy/proxy-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAqC,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGrF,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;AAQD;;;;;;;;;;;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,CAaf"}

package/dist/cliproxy/proxy-detector.js

@@ -0,0 +1,196 @@
+"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("./stats-fetcher");
+const port_utils_1 = require("../utils/port-utils");
+const config_generator_1 = require("./config-generator");
+/** No-op logger for when verbose is disabled */
+const noopLog = () => { };
+/**
+ * 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 = config_generator_1.CLIPROXY_DEFAULT_PORT, verbose = false) {
+    const log = verbose ? (msg) => console.error(`[proxy-detector] ${msg}`) : noopLog;
+    // Validate port - fallback to default if invalid
+    const validPort = port && Number.isFinite(port) && port >= 1 && port <= 65535 ? port : config_generator_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) => console.error(`[proxy-detector] ${msg}`) : 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-detector.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+/** Resolved proxy target for making requests */
+export interface ProxyTarget {
+    /** Target hostname or IP */
+    host: string;
+    /** Target port */
+    port: number;
+    /** Protocol (http/https) */
+    protocol: 'http' | 'https';
+    /** Optional auth token for API endpoints - only send header if defined and non-empty */
+    authToken?: string;
+    /** Optional management key for management API endpoints (/v0/management/*) */
+    managementKey?: string;
+    /** Whether HTTPS requests should allow self-signed certificates */
+    allowSelfSigned?: boolean;
+    /** True if targeting remote server, false if local */
+    isRemote: boolean;
+}
+/**
+ * Get the current CLIProxyAPI target based on unified config.
+ * Returns remote server config if enabled, otherwise localhost.
+ */
+export declare function getProxyTarget(): ProxyTarget;
+/**
+ * Build URL for proxy endpoint
+ * @param target Resolved proxy target
+ * @param path Endpoint path (e.g., '/v0/management/usage')
+ */
+export declare function buildProxyUrl(target: ProxyTarget, path: string): string;
+/**
+ * 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
+ */
+export declare function buildProxyHeaders(target: ProxyTarget, additionalHeaders?: Record<string, string>): Record<string, string>;
+/**
+ * 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
+ */
+export declare function buildManagementHeaders(target: ProxyTarget, additionalHeaders?: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=proxy-target-resolver.d.ts.map

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

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