@jonnyhoo/ccs 1.0.0

package/dist/cliproxy/binary/zip-extractor.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Zip Archive Extractor
+ * Handles extraction of zip archives using Node.js built-in modules.
+ */
+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.extractZip = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zlib = __importStar(require("zlib"));
+const platform_detector_1 = require("../platform-detector");
+/**
+ * Extract zip archive using Node.js (simple implementation)
+ */
+function extractZip(archivePath, destDir, verbose = false, backend = platform_detector_1.DEFAULT_BACKEND) {
+    return new Promise((resolve, reject) => {
+        const execName = (0, platform_detector_1.getExecutableName)(backend);
+        const archiveBinaryName = (0, platform_detector_1.getArchiveBinaryName)(backend);
+        const buffer = fs.readFileSync(archivePath);
+        // Find End of Central Directory record (EOCD)
+        let eocdOffset = buffer.length - 22;
+        while (eocdOffset >= 0) {
+            if (buffer.readUInt32LE(eocdOffset) === 0x06054b50)
+                break;
+            eocdOffset--;
+        }
+        if (eocdOffset < 0) {
+            reject(new Error('Invalid ZIP file: EOCD not found'));
+            return;
+        }
+        const centralDirOffset = buffer.readUInt32LE(eocdOffset + 16);
+        let offset = centralDirOffset;
+        while (offset < eocdOffset) {
+            const sig = buffer.readUInt32LE(offset);
+            if (sig !== 0x02014b50)
+                break;
+            const compressionMethod = buffer.readUInt16LE(offset + 10);
+            const compressedSize = buffer.readUInt32LE(offset + 20);
+            const uncompressedSize = buffer.readUInt32LE(offset + 24);
+            const fileNameLength = buffer.readUInt16LE(offset + 28);
+            const extraFieldLength = buffer.readUInt16LE(offset + 30);
+            const commentLength = buffer.readUInt16LE(offset + 32);
+            const localHeaderOffset = buffer.readUInt32LE(offset + 42);
+            const fileName = buffer.toString('utf8', offset + 46, offset + 46 + fileNameLength);
+            const baseName = path.basename(fileName);
+            if (baseName === execName ||
+                baseName === archiveBinaryName ||
+                baseName === 'cli-proxy-api.exe') {
+                const localOffset = localHeaderOffset;
+                const localSig = buffer.readUInt32LE(localOffset);
+                if (localSig !== 0x04034b50) {
+                    reject(new Error('Invalid local file header'));
+                    return;
+                }
+                const localFileNameLength = buffer.readUInt16LE(localOffset + 26);
+                const localExtraLength = buffer.readUInt16LE(localOffset + 28);
+                const dataOffset = localOffset + 30 + localFileNameLength + localExtraLength;
+                let fileData;
+                if (compressionMethod === 0) {
+                    fileData = buffer.subarray(dataOffset, dataOffset + compressedSize);
+                }
+                else if (compressionMethod === 8) {
+                    const compressed = buffer.subarray(dataOffset, dataOffset + compressedSize);
+                    fileData = zlib.inflateRawSync(compressed);
+                }
+                else {
+                    reject(new Error(`Unsupported compression method: ${compressionMethod}`));
+                    return;
+                }
+                if (fileData.length !== uncompressedSize) {
+                    reject(new Error('Decompression size mismatch'));
+                    return;
+                }
+                const destPath = path.join(destDir, execName);
+                fs.writeFileSync(destPath, fileData);
+                if (verbose)
+                    console.error(`[cliproxy] Extracted: ${fileName} -> ${destPath}`);
+                resolve();
+                return;
+            }
+            offset += 46 + fileNameLength + extraFieldLength + commentLength;
+        }
+        reject(new Error(`Executable not found in archive: ${execName}`));
+    });
+}
+exports.extractZip = extractZip;
+//# sourceMappingURL=zip-extractor.js.map

package/dist/cliproxy/binary/zip-extractor.js.map

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

package/dist/cliproxy/binary-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Binary Manager for CLIProxyAPI
+ *
+ * Facade pattern wrapper for modular binary management.
+ * Pattern: Mirrors npm install behavior (fast check, download only when needed)
+ */
+import { BinaryInfo, BinaryManagerConfig } from './types';
+import { UpdateCheckResult, getPinnedVersion, savePinnedVersion, clearPinnedVersion, isVersionPinned, getVersionPinPath, migrateVersionPin } from './binary';
+import type { CLIProxyBackend } from './types';
+/**
+ * Binary Manager class for CLIProxyAPI binary lifecycle
+ */
+export declare class BinaryManager {
+    private config;
+    private backend;
+    constructor(config?: Partial<BinaryManagerConfig>, backend?: CLIProxyBackend);
+    /** Ensure binary is available (download if missing, update if outdated) */
+    ensureBinary(): Promise<string>;
+    /** Check for updates by comparing installed version with latest release */
+    checkForUpdates(): Promise<UpdateCheckResult>;
+    /** Get full path to binary executable */
+    getBinaryPath(): string;
+    /** Check if binary exists */
+    isBinaryInstalled(): boolean;
+    /** Get binary info if installed */
+    getBinaryInfo(): Promise<BinaryInfo | null>;
+    /** Delete binary (for cleanup or reinstall) */
+    deleteBinary(): void;
+}
+/** Convenience function respecting version pin */
+export declare function ensureCLIProxyBinary(verbose?: boolean): Promise<string>;
+/** Check if CLIProxyAPI binary is installed */
+export declare function isCLIProxyInstalled(backend?: CLIProxyBackend): boolean;
+/** Get CLIProxyAPI binary path (may not exist) */
+export declare function getCLIProxyPath(backend?: CLIProxyBackend): string;
+/** Get installed CLIProxyAPI version from .version file */
+export declare function getInstalledCliproxyVersion(backend?: CLIProxyBackend): string;
+/** Install a specific version of CLIProxyAPI */
+export declare function installCliproxyVersion(version: string, verbose?: boolean, backend?: CLIProxyBackend): Promise<void>;
+/** Fetch the latest CLIProxyAPI version from GitHub API */
+export declare function fetchLatestCliproxyVersion(backend?: CLIProxyBackend): Promise<string>;
+/** Update check result for API response */
+export interface CliproxyUpdateCheckResult {
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string;
+    fromCache: boolean;
+    checkedAt: number;
+    backend: CLIProxyBackend;
+    backendLabel: string;
+    isStable: boolean;
+    maxStableVersion: string;
+    stabilityMessage?: string;
+}
+/** Check for CLIProxyAPI binary updates */
+export declare function checkCliproxyUpdate(backend?: CLIProxyBackend): Promise<CliproxyUpdateCheckResult>;
+export { getVersionPinPath, getPinnedVersion, savePinnedVersion, clearPinnedVersion, isVersionPinned, migrateVersionPin, };
+export default BinaryManager;
+//# sourceMappingURL=binary-manager.d.ts.map

package/dist/cliproxy/binary-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.d.ts","sourceRoot":"","sources":["../../src/cliproxy/binary-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAK1D,OAAO,EACL,iBAAiB,EAMjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAGjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAqC/C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAMhF,2EAA2E;IACrE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAIrC,2EAA2E;IACrE,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASnD,yCAAyC;IACzC,aAAa,IAAI,MAAM;IAIvB,6BAA6B;IAC7B,iBAAiB,IAAI,OAAO;IAI5B,mCAAmC;IAC7B,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIjD,+CAA+C;IAC/C,YAAY,IAAI,IAAI;CAGrB;AAED,kDAAkD;AAClD,wBAAsB,oBAAoB,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB3E;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAGtE;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAGjE;AAED,2DAA2D;AAC3D,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAM7E;AAED,gDAAgD;AAChD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,UAAQ,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,2DAA2D;AAC3D,wBAAsB,0BAA0B,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3F;AAED,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2CAA2C;AAC3C,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,yBAAyB,CAAC,CAqBpC;AAGD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/cliproxy/binary-manager.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Binary Manager for CLIProxyAPI
+ *
+ * Facade pattern wrapper for modular binary management.
+ * Pattern: Mirrors npm install behavior (fast check, download only when needed)
+ */
+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.migrateVersionPin = exports.isVersionPinned = exports.clearPinnedVersion = exports.savePinnedVersion = exports.getPinnedVersion = exports.getVersionPinPath = exports.checkCliproxyUpdate = exports.fetchLatestCliproxyVersion = exports.installCliproxyVersion = exports.getInstalledCliproxyVersion = exports.getCLIProxyPath = exports.isCLIProxyInstalled = exports.ensureCLIProxyBinary = exports.BinaryManager = void 0;
+const ui_1 = require("../utils/ui");
+const config_generator_1 = require("./config-generator");
+const platform_detector_1 = require("./platform-detector");
+const proxy_lifecycle_service_1 = require("./services/proxy-lifecycle-service");
+const port_utils_1 = require("../utils/port-utils");
+const unified_config_loader_1 = require("../config/unified-config-loader");
+const binary_1 = require("./binary");
+Object.defineProperty(exports, "getPinnedVersion", { enumerable: true, get: function () { return binary_1.getPinnedVersion; } });
+Object.defineProperty(exports, "savePinnedVersion", { enumerable: true, get: function () { return binary_1.savePinnedVersion; } });
+Object.defineProperty(exports, "clearPinnedVersion", { enumerable: true, get: function () { return binary_1.clearPinnedVersion; } });
+Object.defineProperty(exports, "isVersionPinned", { enumerable: true, get: function () { return binary_1.isVersionPinned; } });
+Object.defineProperty(exports, "getVersionPinPath", { enumerable: true, get: function () { return binary_1.getVersionPinPath; } });
+Object.defineProperty(exports, "migrateVersionPin", { enumerable: true, get: function () { return binary_1.migrateVersionPin; } });
+/**
+ * Get backend from config or default to 'plus'
+ */
+function getConfiguredBackend() {
+    try {
+        const config = (0, unified_config_loader_1.loadOrCreateUnifiedConfig)();
+        return config.cliproxy?.backend || platform_detector_1.DEFAULT_BACKEND;
+    }
+    catch {
+        return platform_detector_1.DEFAULT_BACKEND;
+    }
+}
+/**
+ * Get backend-specific binary directory.
+ * Stores binaries in separate dirs: bin/original/ and bin/plus/
+ */
+function getBackendBinDir(backend = platform_detector_1.DEFAULT_BACKEND) {
+    const baseDir = (0, config_generator_1.getBinDir)();
+    return `${baseDir}/${backend}`;
+}
+/** Default configuration (uses backend from config.yaml or defaults to 'plus') */
+function createDefaultConfig(backend = platform_detector_1.DEFAULT_BACKEND) {
+    const backendConfig = platform_detector_1.BACKEND_CONFIG[backend];
+    return {
+        version: backendConfig.fallbackVersion,
+        releaseUrl: `https://github.com/${backendConfig.repo}/releases/download`,
+        binPath: getBackendBinDir(backend),
+        maxRetries: 3,
+        verbose: false,
+        forceVersion: false,
+        backend, // Pass backend for installer to use correct download URL
+    };
+}
+/**
+ * Binary Manager class for CLIProxyAPI binary lifecycle
+ */
+class BinaryManager {
+    constructor(config = {}, backend) {
+        this.backend = backend ?? getConfiguredBackend();
+        const defaultConfig = createDefaultConfig(this.backend);
+        this.config = { ...defaultConfig, ...config };
+    }
+    /** Ensure binary is available (download if missing, update if outdated) */
+    async ensureBinary() {
+        return (0, binary_1.ensureBinary)(this.config);
+    }
+    /** Check for updates by comparing installed version with latest release */
+    async checkForUpdates() {
+        return (0, binary_1.checkForUpdates)(this.config.binPath, this.config.version, this.config.verbose, this.backend);
+    }
+    /** Get full path to binary executable */
+    getBinaryPath() {
+        return (0, binary_1.getBinaryPath)(this.config.binPath, this.backend);
+    }
+    /** Check if binary exists */
+    isBinaryInstalled() {
+        return (0, binary_1.isBinaryInstalled)(this.config.binPath, this.backend);
+    }
+    /** Get binary info if installed */
+    async getBinaryInfo() {
+        return (0, binary_1.getBinaryInfo)(this.config.binPath, this.config.version, this.backend);
+    }
+    /** Delete binary (for cleanup or reinstall) */
+    deleteBinary() {
+        (0, binary_1.deleteBinary)(this.config.binPath, this.config.verbose, this.backend);
+    }
+}
+exports.BinaryManager = BinaryManager;
+/** Convenience function respecting version pin */
+async function ensureCLIProxyBinary(verbose = false) {
+    const backend = getConfiguredBackend();
+    // Migrate old shared pin to backend-specific location (one-time migration)
+    (0, binary_1.migrateVersionPin)(backend);
+    const pinnedVersion = (0, binary_1.getPinnedVersion)(backend);
+    if (pinnedVersion) {
+        if (verbose)
+            console.error(`[cliproxy] Using pinned version: ${pinnedVersion}`);
+        return new BinaryManager({
+            version: pinnedVersion,
+            verbose,
+            forceVersion: true,
+        }, backend).ensureBinary();
+    }
+    return new BinaryManager({ verbose }, backend).ensureBinary();
+}
+exports.ensureCLIProxyBinary = ensureCLIProxyBinary;
+/** Check if CLIProxyAPI binary is installed */
+function isCLIProxyInstalled(backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    return new BinaryManager({}, effectiveBackend).isBinaryInstalled();
+}
+exports.isCLIProxyInstalled = isCLIProxyInstalled;
+/** Get CLIProxyAPI binary path (may not exist) */
+function getCLIProxyPath(backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    return new BinaryManager({}, effectiveBackend).getBinaryPath();
+}
+exports.getCLIProxyPath = getCLIProxyPath;
+/** Get installed CLIProxyAPI version from .version file */
+function getInstalledCliproxyVersion(backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    return (0, binary_1.readInstalledVersion)(getBackendBinDir(effectiveBackend), platform_detector_1.BACKEND_CONFIG[effectiveBackend].fallbackVersion);
+}
+exports.getInstalledCliproxyVersion = getInstalledCliproxyVersion;
+/** Install a specific version of CLIProxyAPI */
+async function installCliproxyVersion(version, verbose = false, backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    const manager = new BinaryManager({ version, verbose, forceVersion: true }, effectiveBackend);
+    // Check if proxy is running and stop it first
+    if ((0, proxy_lifecycle_service_1.isProxyRunning)()) {
+        if (verbose)
+            console.log((0, ui_1.info)('Stopping running CLIProxy before update...'));
+        const result = await (0, proxy_lifecycle_service_1.stopProxy)();
+        if (result.stopped) {
+            // Wait for port to be fully released
+            const portFree = await (0, port_utils_1.waitForPortFree)(config_generator_1.CLIPROXY_DEFAULT_PORT, 5000);
+            if (!portFree && verbose) {
+                console.log((0, ui_1.warn)('Port did not free up in time, proceeding anyway...'));
+            }
+        }
+        else if (verbose && result.error) {
+            console.log((0, ui_1.warn)(`Could not stop proxy: ${result.error}`));
+        }
+    }
+    if (manager.isBinaryInstalled()) {
+        const label = effectiveBackend === 'plus' ? 'CLIProxy Plus' : 'CLIProxy';
+        if (verbose)
+            console.log((0, ui_1.info)(`Removing existing ${label} v${getInstalledCliproxyVersion(effectiveBackend)}`));
+        manager.deleteBinary();
+    }
+    await manager.ensureBinary();
+    if (verbose) {
+        console.log((0, ui_1.info)('New version will be active on next CLIProxy command'));
+    }
+}
+exports.installCliproxyVersion = installCliproxyVersion;
+/** Fetch the latest CLIProxyAPI version from GitHub API */
+async function fetchLatestCliproxyVersion(backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    const result = await new BinaryManager({}, effectiveBackend).checkForUpdates();
+    return result.latestVersion;
+}
+exports.fetchLatestCliproxyVersion = fetchLatestCliproxyVersion;
+/** Check for CLIProxyAPI binary updates */
+async function checkCliproxyUpdate(backend) {
+    const effectiveBackend = backend ?? getConfiguredBackend();
+    const result = await new BinaryManager({}, effectiveBackend).checkForUpdates();
+    // Import isNewerVersion for stability check
+    const { isNewerVersion } = await Promise.resolve().then(() => __importStar(require('./binary/version-checker')));
+    const isStable = !isNewerVersion(result.currentVersion, platform_detector_1.CLIPROXY_MAX_STABLE_VERSION);
+    const stabilityMessage = isStable
+        ? undefined
+        : `v${result.currentVersion} has known stability issues. Max stable: v${platform_detector_1.CLIPROXY_MAX_STABLE_VERSION}`;
+    const backendLabel = effectiveBackend === 'plus' ? 'CLIProxy Plus' : 'CLIProxy';
+    return {
+        ...result,
+        backend: effectiveBackend,
+        backendLabel,
+        isStable,
+        maxStableVersion: platform_detector_1.CLIPROXY_MAX_STABLE_VERSION,
+        stabilityMessage,
+    };
+}
+exports.checkCliproxyUpdate = checkCliproxyUpdate;
+exports.default = BinaryManager;
+//# sourceMappingURL=binary-manager.js.map

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

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

package/dist/cliproxy/cliproxy-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CLIProxy Executor - Spawn/Kill Pattern for CLIProxyAPI
+ *
+ * Mirrors GLMT architecture:
+ * 1. Ensure binary exists (Phase 1)
+ * 2. Generate config for provider
+ * 3. Spawn CLIProxyAPI binary
+ * 4. Poll port for readiness (no stdout signal)
+ * 5. Execute Claude CLI with proxied environment
+ * 6. Kill proxy on Claude exit
+ *
+ * Key difference from GLMT: Uses TCP port polling instead of PROXY_READY signal
+ */
+import { CLIProxyProvider, ExecutorConfig } from './types';
+/**
+ * Execute Claude CLI with CLIProxy (main entry point)
+ *
+ * @param claudeCli Path to Claude CLI executable
+ * @param provider CLIProxy provider (gemini, codex, agy, qwen)
+ * @param args Arguments to pass to Claude CLI
+ * @param config Optional executor configuration
+ */
+export declare function execClaudeWithCLIProxy(claudeCli: string, provider: CLIProxyProvider, args: string[], config?: Partial<ExecutorConfig>): Promise<void>;
+/**
+ * Check if a port is available
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * Find an available port in range
+ */
+export declare function findAvailablePort(startPort?: number, range?: number): Promise<number>;
+export default execClaudeWithCLIProxy;
+//# sourceMappingURL=cliproxy-executor.d.ts.map

package/dist/cliproxy/cliproxy-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliproxy-executor.d.ts","sourceRoot":"","sources":["../../src/cliproxy/cliproxy-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,OAAO,EAAE,gBAAgB,EAAwC,cAAc,EAAE,MAAM,SAAS,CAAC;AAoFjG;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GACnC,OAAO,CAAC,IAAI,CAAC,CAs+Bf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAepE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,GAAE,MAA8B,EACzC,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,eAAe,sBAAsB,CAAC"}