@jonnyhoo/ccs 1.0.0

package/dist/cliproxy/session-tracker.js

@@ -0,0 +1,420 @@
+"use strict";
+/**
+ * Session Tracker for CLIProxy Multi-Instance Support
+ *
+ * Manages reference counting for shared CLIProxy instances.
+ * Multiple CCS sessions can share a single proxy on the same port.
+ * Proxy only terminates when ALL sessions exit (count reaches 0).
+ *
+ * Lock file format: ~/.ccs/cliproxy/sessions.json
+ * {
+ *   "port": 8317,
+ *   "pid": 12345,        // CLIProxy process PID
+ *   "sessions": ["abc123", "def456"],  // Active session IDs
+ *   "startedAt": "2024-01-01T00:00:00Z"
+ * }
+ */
+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.getRunningProxyVersion = exports.getProxyStatus = exports.stopProxy = exports.cleanupOrphanedSessions = exports.hasActiveSessions = exports.getSessionCount = exports.unregisterSession = exports.registerSession = exports.getExistingProxy = exports.deleteSessionLockForPort = exports.getSessionLockPath = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const config_generator_1 = require("./config-generator");
+const port_utils_1 = require("../utils/port-utils");
+const config_generator_2 = require("./config-generator");
+/** Generate unique session ID */
+function generateSessionId() {
+    return crypto.randomBytes(8).toString('hex');
+}
+/** Get path to session lock file for specific port */
+function getSessionLockPathForPort(port) {
+    if (port === config_generator_2.CLIPROXY_DEFAULT_PORT) {
+        return path.join((0, config_generator_1.getCliproxyDir)(), 'sessions.json');
+    }
+    return path.join((0, config_generator_1.getCliproxyDir)(), `sessions-${port}.json`);
+}
+/** Get path to session lock file (default port) - kept for future use */
+function _getSessionLockPath() {
+    return getSessionLockPathForPort(config_generator_2.CLIPROXY_DEFAULT_PORT);
+}
+exports.getSessionLockPath = _getSessionLockPath;
+/** Read session lock file for specific port (returns null if not exists or invalid) */
+function readSessionLockForPort(port) {
+    const lockPath = getSessionLockPathForPort(port);
+    try {
+        if (!fs.existsSync(lockPath)) {
+            return null;
+        }
+        const content = fs.readFileSync(lockPath, 'utf-8');
+        const lock = JSON.parse(content);
+        // Validate structure
+        if (typeof lock.port !== 'number' ||
+            typeof lock.pid !== 'number' ||
+            !Array.isArray(lock.sessions)) {
+            return null;
+        }
+        return lock;
+    }
+    catch {
+        return null;
+    }
+}
+/** Read session lock file (default port, returns null if not exists or invalid) */
+function readSessionLock() {
+    return readSessionLockForPort(config_generator_2.CLIPROXY_DEFAULT_PORT);
+}
+/** Write session lock file for specific port */
+function writeSessionLockForPort(lock) {
+    const lockPath = getSessionLockPathForPort(lock.port);
+    const dir = path.dirname(lockPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2), { mode: 0o600 });
+}
+/** Delete session lock file for specific port */
+function deleteSessionLockForPort(port) {
+    const lockPath = getSessionLockPathForPort(port);
+    try {
+        if (fs.existsSync(lockPath)) {
+            fs.unlinkSync(lockPath);
+        }
+    }
+    catch {
+        // Ignore errors on cleanup
+    }
+}
+exports.deleteSessionLockForPort = deleteSessionLockForPort;
+/** Delete session lock file (default port) */
+function deleteSessionLock() {
+    deleteSessionLockForPort(config_generator_2.CLIPROXY_DEFAULT_PORT);
+}
+/** Check if a PID is still running */
+function isProcessRunning(pid) {
+    try {
+        // Sending signal 0 checks if process exists without killing it
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const e = err;
+        // EPERM means process exists but we don't have permission to signal it
+        if (e.code === 'EPERM') {
+            return true;
+        }
+        // ESRCH means no such process
+        return false;
+    }
+}
+/**
+ * Wait for a process to exit within a timeout.
+ * @param pid Process ID to wait for
+ * @param timeoutMs Maximum time to wait in milliseconds
+ * @returns true if process exited, false if timeout
+ */
+async function waitForProcessExit(pid, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (!isProcessRunning(pid)) {
+            return true; // Process exited
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    return false; // Timeout
+}
+/**
+ * Check if there's an existing proxy running that we can reuse.
+ * Returns the existing lock if proxy is healthy, null otherwise.
+ */
+function getExistingProxy(port) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return null;
+    }
+    // Verify port matches
+    if (lock.port !== port) {
+        return null;
+    }
+    // Verify proxy process is still running
+    if (!isProcessRunning(lock.pid)) {
+        // Proxy crashed - clean up stale lock
+        deleteSessionLockForPort(port);
+        return null;
+    }
+    return lock;
+}
+exports.getExistingProxy = getExistingProxy;
+/**
+ * Register a new session with the proxy.
+ * Call this when starting a new CCS session that will use an existing proxy.
+ * @param port Port the proxy is running on
+ * @param proxyPid PID of the proxy process
+ * @param version Optional CLIProxy version (stored when spawning new proxy)
+ * @param backend Optional backend type (original vs plus)
+ * @returns Session ID for this session
+ */
+function registerSession(port, proxyPid, version, backend) {
+    const sessionId = generateSessionId();
+    const existingLock = readSessionLockForPort(port);
+    if (existingLock && existingLock.port === port && existingLock.pid === proxyPid) {
+        // Add to existing sessions
+        existingLock.sessions.push(sessionId);
+        writeSessionLockForPort(existingLock);
+    }
+    else {
+        // Create new lock (first session for this proxy)
+        const newLock = {
+            port,
+            pid: proxyPid,
+            sessions: [sessionId],
+            startedAt: new Date().toISOString(),
+            version,
+            backend,
+        };
+        writeSessionLockForPort(newLock);
+    }
+    return sessionId;
+}
+exports.registerSession = registerSession;
+/**
+ * Unregister a session from the proxy.
+ * @param sessionId Session ID to unregister
+ * @param port Port to unregister from (optional, searches default port if not provided)
+ * @returns true if this was the last session (proxy should be killed)
+ */
+function unregisterSession(sessionId, port) {
+    // If port provided, use port-specific lookup
+    if (port !== undefined) {
+        const lock = readSessionLockForPort(port);
+        if (!lock) {
+            return true;
+        }
+        const index = lock.sessions.indexOf(sessionId);
+        if (index !== -1) {
+            lock.sessions.splice(index, 1);
+        }
+        if (lock.sessions.length === 0) {
+            deleteSessionLockForPort(port);
+            return true;
+        }
+        writeSessionLockForPort(lock);
+        return false;
+    }
+    // Fallback: search default port (backward compat)
+    const lock = readSessionLock();
+    if (!lock) {
+        // No lock file - assume we're the only session
+        return true;
+    }
+    // Remove this session from the list
+    const index = lock.sessions.indexOf(sessionId);
+    if (index !== -1) {
+        lock.sessions.splice(index, 1);
+    }
+    // Check if any sessions remain
+    if (lock.sessions.length === 0) {
+        // Last session - clean up lock file
+        deleteSessionLock();
+        return true;
+    }
+    // Other sessions still active - keep proxy running
+    writeSessionLockForPort(lock);
+    return false;
+}
+exports.unregisterSession = unregisterSession;
+/**
+ * Get current session count for the proxy.
+ * @param port Port to check (defaults to CLIPROXY_DEFAULT_PORT)
+ */
+function getSessionCount(port = config_generator_2.CLIPROXY_DEFAULT_PORT) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return 0;
+    }
+    return lock.sessions.length;
+}
+exports.getSessionCount = getSessionCount;
+/**
+ * Check if proxy has any active sessions.
+ * Used to determine if a "zombie" proxy should be killed.
+ * @param port Port to check (defaults to CLIPROXY_DEFAULT_PORT)
+ */
+function hasActiveSessions(port = config_generator_2.CLIPROXY_DEFAULT_PORT) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return false;
+    }
+    // Verify proxy is still running
+    if (!isProcessRunning(lock.pid)) {
+        deleteSessionLockForPort(port);
+        return false;
+    }
+    return lock.sessions.length > 0;
+}
+exports.hasActiveSessions = hasActiveSessions;
+/**
+ * Clean up orphaned sessions (when proxy crashes).
+ * Called on startup to ensure clean state.
+ */
+function cleanupOrphanedSessions(port) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return;
+    }
+    // If port doesn't match, this shouldn't happen with port-specific files
+    if (lock.port !== port) {
+        return;
+    }
+    // If proxy is dead, clean up lock
+    if (!isProcessRunning(lock.pid)) {
+        deleteSessionLockForPort(port);
+    }
+}
+exports.cleanupOrphanedSessions = cleanupOrphanedSessions;
+/**
+ * Stop the CLIProxy process and clean up session lock.
+ * Falls back to port-based detection if no session lock exists.
+ * @param port Port to stop (defaults to CLIPROXY_DEFAULT_PORT)
+ * @returns Object with success status and details
+ */
+async function stopProxy(port = config_generator_2.CLIPROXY_DEFAULT_PORT) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        // No session lock - try to find process by port (legacy/untracked proxy)
+        const portProcess = await (0, port_utils_1.getPortProcess)(port);
+        if (!portProcess) {
+            return { stopped: false, error: 'No active CLIProxy session found' };
+        }
+        if (!(0, port_utils_1.isCLIProxyProcess)(portProcess)) {
+            return {
+                stopped: false,
+                error: `Port ${port} is in use by ${portProcess.processName}, not CLIProxy`,
+            };
+        }
+        // Found CLIProxy running without session lock - kill it
+        try {
+            process.kill(portProcess.pid, 'SIGTERM');
+            // Wait for graceful shutdown
+            const exited = await waitForProcessExit(portProcess.pid, 3000);
+            if (!exited) {
+                // Escalate to SIGKILL
+                try {
+                    process.kill(portProcess.pid, 'SIGKILL');
+                    await waitForProcessExit(portProcess.pid, 1000);
+                }
+                catch {
+                    // Process may have exited between check and kill
+                }
+            }
+            return { stopped: true, pid: portProcess.pid, sessionCount: 0 };
+        }
+        catch (err) {
+            const error = err;
+            if (error.code === 'ESRCH') {
+                return { stopped: false, error: 'CLIProxy process already terminated' };
+            }
+            return { stopped: false, pid: portProcess.pid, error: `Failed to stop: ${error.message}` };
+        }
+    }
+    // Check if proxy is running
+    if (!isProcessRunning(lock.pid)) {
+        deleteSessionLockForPort(port);
+        return { stopped: false, error: 'CLIProxy was not running (cleaned up stale lock)' };
+    }
+    const sessionCount = lock.sessions.length;
+    const pid = lock.pid;
+    try {
+        // Kill the proxy process
+        process.kill(pid, 'SIGTERM');
+        // Wait for graceful shutdown
+        const exited = await waitForProcessExit(pid, 3000);
+        if (!exited) {
+            // Escalate to SIGKILL
+            try {
+                process.kill(pid, 'SIGKILL');
+                await waitForProcessExit(pid, 1000);
+            }
+            catch {
+                // Process may have exited between check and kill
+            }
+        }
+        // Clean up session lock
+        deleteSessionLockForPort(port);
+        return { stopped: true, pid, sessionCount };
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'ESRCH') {
+            // Process already gone
+            deleteSessionLockForPort(port);
+            return { stopped: false, error: 'CLIProxy process already terminated' };
+        }
+        return { stopped: false, pid, error: `Failed to stop: ${error.message}` };
+    }
+}
+exports.stopProxy = stopProxy;
+/**
+ * Get proxy status information for specific port.
+ */
+function getProxyStatus(port = config_generator_2.CLIPROXY_DEFAULT_PORT) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return { running: false };
+    }
+    // Verify proxy is still running
+    if (!isProcessRunning(lock.pid)) {
+        deleteSessionLockForPort(port);
+        return { running: false };
+    }
+    return {
+        running: true,
+        port: lock.port,
+        pid: lock.pid,
+        sessionCount: lock.sessions.length,
+        startedAt: lock.startedAt,
+        version: lock.version,
+    };
+}
+exports.getProxyStatus = getProxyStatus;
+/**
+ * Get the version of the running proxy from session lock.
+ * @param port Port to check (defaults to CLIPROXY_DEFAULT_PORT)
+ * @returns Version string if available, null otherwise
+ */
+function getRunningProxyVersion(port = config_generator_2.CLIPROXY_DEFAULT_PORT) {
+    const lock = readSessionLockForPort(port);
+    if (!lock) {
+        return null;
+    }
+    // Verify proxy is still running
+    if (!isProcessRunning(lock.pid)) {
+        deleteSessionLockForPort(port);
+        return null;
+    }
+    return lock.version ?? null;
+}
+exports.getRunningProxyVersion = getRunningProxyVersion;
+//# sourceMappingURL=session-tracker.js.map

package/dist/cliproxy/session-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.js","sourceRoot":"","sources":["../../src/cliproxy/session-tracker.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"}