@ekkos/cli 1.3.1 → 1.3.5

package/dist/agent/daemon.js

@@ -1,606 +0,0 @@
-"use strict";
-/**
- * ekkOS Agent Daemon
- *
- * Background daemon that:
- * 1. Maintains WebSocket connection to cloud relay
- * 2. Receives session start requests
- * 3. Spawns `ekkos run -d` in PTY
- * 4. Relays PTY I/O to cloud
- */
-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 () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentDaemon = void 0;
-const ws_1 = __importDefault(require("ws"));
-const os = __importStar(require("os"));
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const pty_runner_1 = require("./pty-runner");
-const log_rotate_1 = require("../utils/log-rotate");
-const RELAY_URL = process.env.RELAY_WS_URL || 'wss://ekkos-relay-production.up.railway.app';
-const HEARTBEAT_INTERVAL = 10000; // 10 seconds - must be well under Railway's 20-30s idle timeout
-const PONG_TIMEOUT = 15000; // If no pong received in 15s, consider connection dead
-const RECONNECT_DELAYS = [1000, 2000, 4000, 8000, 16000, 32000, 60000]; // Exponential backoff
-// Auto-continue: Context wall detection pattern
-const CONTEXT_WALL_REGEX = /context limit reached.*\/(compact|clear)\b.*to continue/i;
-// Session name detection pattern (3-word slug: word-word-word)
-const SESSION_NAME_REGEX = /\b([a-z]+-[a-z]+-[a-z]+)\b/i;
-// Idle prompt detection - Claude shows "> " when ready for input
-const IDLE_PROMPT_REGEX = />\s*$/;
-class AgentDaemon {
-    constructor(config) {
-        this.ws = null;
-        this.reconnectAttempt = 0;
-        this.heartbeatTimer = null;
-        this.pongTimer = null;
-        this.pongReceived = true;
-        this.ptyRunner = null;
-        this.currentSessionId = null;
-        this.sessionStartedAt = 0;
-        this.ptyRestartAttempts = 0;
-        this.QUICK_EXIT_MS = 15000;
-        this.running = false;
-        // Auto-continue state
-        this.outputBuffer = '';
-        this.currentSessionName = null;
-        this.isAutoClearInProgress = false;
-        this.lastContextWallTime = 0;
-        this.CONTEXT_WALL_COOLDOWN = 30000; // 30 seconds between auto-clears
-        this.config = config;
-        this.logPath = path.join(os.homedir(), '.ekkos', 'agent.log');
-    }
-    /**
-     * Start the daemon
-     */
-    async start() {
-        this.running = true;
-        this.log('Starting ekkOS agent daemon...');
-        this.connect();
-    }
-    /**
-     * Stop the daemon
-     */
-    async stop() {
-        this.running = false;
-        // Stop heartbeat
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-        // Stop pong timer
-        if (this.pongTimer) {
-            clearTimeout(this.pongTimer);
-            this.pongTimer = null;
-        }
-        // Close PTY
-        if (this.ptyRunner) {
-            this.ptyRunner.kill();
-            this.ptyRunner = null;
-        }
-        // Close WebSocket
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-        this.log('Daemon stopped');
-    }
-    /**
-     * Connect to relay server
-     */
-    connect() {
-        if (!this.running)
-            return;
-        const url = `${RELAY_URL}/api/v1/relay/device`;
-        this.log(`Connecting to ${url}...`);
-        this.ws = new ws_1.default(url, {
-            headers: {
-                'X-Device-Token': this.config.deviceToken,
-            },
-        });
-        this.ws.on('open', () => this.handleOpen());
-        this.ws.on('message', (data) => this.handleMessage(data));
-        this.ws.on('pong', () => { this.pongReceived = true; });
-        this.ws.on('close', (code, reason) => this.handleClose(code, reason.toString()));
-        this.ws.on('error', (err) => this.handleError(err));
-    }
-    /**
-     * Handle WebSocket open
-     */
-    handleOpen() {
-        this.log('Connected to relay server');
-        this.reconnectAttempt = 0;
-        this.pongReceived = true;
-        // If we have a surviving PTY session, tell relay we're ready to reattach
-        if (this.ptyRunner && this.currentSessionId) {
-            this.log(`Re-advertising surviving session ${this.currentSessionId}`);
-            this.sendMessage({
-                type: 'session_alive',
-                sessionId: this.currentSessionId,
-            });
-        }
-        // Start heartbeat with dual ping: protocol-level + app-level
-        this.heartbeatTimer = setInterval(() => {
-            if (!this.pongReceived) {
-                // Previous ping never got a pong - connection is dead
-                this.log('No pong received, connection dead - forcing reconnect');
-                this.ws?.terminate(); // terminate, not close - skip graceful shutdown
-                return;
-            }
-            this.pongReceived = false;
-            // Protocol-level ping (handled by ws library)
-            if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
-                this.ws.ping();
-            }
-            // App-level heartbeat (for relay server to track device presence)
-            this.sendMessage({ type: 'heartbeat' });
-        }, HEARTBEAT_INTERVAL);
-    }
-    /**
-     * Handle incoming message
-     */
-    handleMessage(rawData) {
-        let message;
-        try {
-            message = JSON.parse(rawData.toString());
-        }
-        catch (err) {
-            this.log('Invalid message from server:', err);
-            return;
-        }
-        switch (message.type) {
-            case 'connected':
-                this.log('Registered with relay');
-                break;
-            case 'session_start':
-                this.handleSessionStart(message.sessionId, message.cwd);
-                break;
-            case 'session_end':
-                this.handleSessionEnd(message.sessionId);
-                break;
-            case 'input':
-                this.handleInput(message.data || '');
-                break;
-            case 'resize':
-                this.handleResize(message.cols || 80, message.rows || 24);
-                break;
-            case 'error':
-                this.log('Server error:', message.error);
-                break;
-            case 'list_dirs':
-                void this.handleListDirectories(message.requestId, message.path);
-                break;
-        }
-    }
-    /**
-     * Handle session start request
-     */
-    handleSessionStart(sessionId, cwd) {
-        this.log(`Session start request: ${sessionId}${cwd ? ` (cwd: ${cwd})` : ''}`);
-        // If reconnecting to the SAME session, reuse existing PTY
-        if (this.ptyRunner && this.currentSessionId === sessionId) {
-            this.log(`Reattaching to existing PTY for session ${sessionId}`);
-            this.sendMessage({ type: 'ready', sessionId });
-            return;
-        }
-        // Different session - kill old PTY if any
-        if (this.ptyRunner) {
-            this.log(`Killing old PTY for session ${this.currentSessionId}`);
-            this.ptyRunner.kill();
-            this.ptyRunner = null;
-        }
-        this.currentSessionId = sessionId;
-        const resolved = this.resolveSessionCwd(cwd);
-        this.currentSessionCwd = resolved.cwd;
-        this.ptyRestartAttempts = 0;
-        // Reset auto-continue state
-        this.outputBuffer = '';
-        this.currentSessionName = null;
-        this.isAutoClearInProgress = false;
-        this.lastContextWallTime = 0;
-        this.startSessionPty(resolved.cwd);
-        if (resolved.warning) {
-            this.sendOutput(`\r\n[ekkOS] ${resolved.warning}\r\n`);
-        }
-        // Notify server that PTY is ready
-        this.sendMessage({
-            type: 'ready',
-            sessionId,
-        });
-    }
-    /**
-     * Handle session end request
-     */
-    handleSessionEnd(sessionId) {
-        if (sessionId && sessionId !== this.currentSessionId) {
-            return; // Not our session
-        }
-        this.log('Session ended');
-        this.currentSessionId = null;
-        this.currentSessionCwd = undefined;
-        this.ptyRestartAttempts = 0;
-        if (this.ptyRunner) {
-            this.ptyRunner.kill();
-            this.ptyRunner = null;
-        }
-    }
-    /**
-     * Handle input from browser
-     */
-    handleInput(data) {
-        if (this.ptyRunner) {
-            this.ptyRunner.write(data);
-        }
-    }
-    /**
-     * Handle resize from browser
-     */
-    handleResize(cols, rows) {
-        if (this.ptyRunner) {
-            this.ptyRunner.resize(cols, rows);
-        }
-    }
-    /**
-     * Handle directory listing request from relay for project browsing UI.
-     */
-    async handleListDirectories(requestId, requestedPath) {
-        if (!requestId)
-            return;
-        try {
-            const resolvedPath = this.resolveBrowsePath(requestedPath);
-            if (resolvedPath === '__WINDOWS_ROOT__') {
-                this.sendMessage({
-                    type: 'list_dirs_result',
-                    requestId,
-                    path: '/',
-                    parentPath: null,
-                    entries: this.getWindowsRootEntries(),
-                });
-                return;
-            }
-            const dirents = await fs.promises.readdir(resolvedPath, { withFileTypes: true });
-            const entries = dirents
-                .filter((entry) => entry.isDirectory())
-                .map((entry) => ({
-                name: entry.name,
-                path: path.join(resolvedPath, entry.name),
-            }))
-                .sort((a, b) => a.name.localeCompare(b.name))
-                .slice(0, 300);
-            this.sendMessage({
-                type: 'list_dirs_result',
-                requestId,
-                path: resolvedPath,
-                parentPath: this.getParentPath(resolvedPath),
-                entries,
-            });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : 'Failed to read directory';
-            this.sendMessage({
-                type: 'list_dirs_result',
-                requestId,
-                error: message,
-            });
-        }
-    }
-    resolveBrowsePath(requestedPath) {
-        const homePath = os.homedir();
-        const raw = requestedPath?.trim() ?? '';
-        if (process.platform === 'win32' && (raw === '' || raw === '/' || raw === '\\')) {
-            return '__WINDOWS_ROOT__';
-        }
-        if (!raw) {
-            return homePath;
-        }
-        if (raw === '~') {
-            return homePath;
-        }
-        if (raw.startsWith('~/') || raw.startsWith('~\\')) {
-            return path.resolve(path.join(homePath, raw.slice(2)));
-        }
-        return path.resolve(raw);
-    }
-    getParentPath(currentPath) {
-        if (process.platform === 'win32' && /^[A-Za-z]:\\?$/.test(currentPath)) {
-            return null;
-        }
-        const parsed = path.parse(currentPath);
-        if (currentPath === parsed.root) {
-            return null;
-        }
-        const parent = path.dirname(currentPath);
-        return parent === currentPath ? null : parent;
-    }
-    getWindowsRootEntries() {
-        const entries = [];
-        for (let code = 65; code <= 90; code++) {
-            const drive = String.fromCharCode(code);
-            const drivePath = `${drive}:\\`;
-            if (fs.existsSync(drivePath)) {
-                entries.push({
-                    name: `${drive}:`,
-                    path: drivePath,
-                });
-            }
-        }
-        return entries;
-    }
-    resolveSessionCwd(cwd) {
-        const homePath = os.homedir();
-        const raw = cwd?.trim();
-        if (!raw) {
-            return { cwd: homePath };
-        }
-        let expanded = raw;
-        if (raw === '~') {
-            expanded = homePath;
-        }
-        else if (raw.startsWith('~/') || raw.startsWith('~\\')) {
-            expanded = path.join(homePath, raw.slice(2));
-        }
-        const resolvedPath = path.resolve(expanded);
-        try {
-            const stat = fs.statSync(resolvedPath);
-            if (stat.isDirectory()) {
-                return { cwd: resolvedPath };
-            }
-            return {
-                cwd: homePath,
-                warning: `Requested path is not a directory: ${raw}. Falling back to ${homePath}.`,
-            };
-        }
-        catch {
-            return {
-                cwd: homePath,
-                warning: `Requested path not found: ${raw}. Falling back to ${homePath}.`,
-            };
-        }
-    }
-    /**
-     * Handle PTY exit
-     */
-    handlePTYExit(code) {
-        this.log(`PTY exited with code ${code}`);
-        const elapsed = Date.now() - this.sessionStartedAt;
-        const hasActiveSession = this.running && this.currentSessionId !== null;
-        const quickExit = elapsed < this.QUICK_EXIT_MS;
-        if (hasActiveSession && code !== 0) {
-            this.ptyRestartAttempts = quickExit ? this.ptyRestartAttempts + 1 : 1;
-            const attempt = this.ptyRestartAttempts;
-            const sessionId = this.currentSessionId;
-            const restartDelay = quickExit
-                ? Math.min(600 * attempt, 5000)
-                : 1000;
-            const reason = quickExit ? 'crashed' : 'exited unexpectedly';
-            this.log(`PTY ${reason} (${elapsed}ms, code ${code}). Restarting in ${restartDelay}ms (attempt ${attempt})...`);
-            this.ptyRunner = null;
-            this.sendOutput(`\r\n[ekkOS] Terminal ${reason} (code ${code}). Restarting in ${Math.max(1, Math.ceil(restartDelay / 1000))}s...\r\n`);
-            setTimeout(() => {
-                if (!this.running || !sessionId || this.currentSessionId !== sessionId || this.ptyRunner) {
-                    return;
-                }
-                this.startSessionPty(this.currentSessionCwd);
-                this.sendMessage({
-                    type: 'ready',
-                    sessionId,
-                });
-            }, restartDelay);
-            return;
-        }
-        this.sendMessage({
-            type: 'session_end',
-            sessionId: this.currentSessionId || undefined,
-        });
-        this.ptyRunner = null;
-        this.currentSessionId = null;
-        this.currentSessionCwd = undefined;
-        this.ptyRestartAttempts = 0;
-    }
-    /**
-     * Send PTY output to server (with auto-continue detection)
-     */
-    sendOutput(data) {
-        // Always forward output to server
-        this.sendMessage({
-            type: 'output',
-            sessionId: this.currentSessionId || undefined,
-            data,
-        });
-        // Auto-continue: Buffer output and detect context wall
-        this.outputBuffer += data;
-        // Keep buffer manageable (last 2KB)
-        if (this.outputBuffer.length > 2048) {
-            this.outputBuffer = this.outputBuffer.slice(-2048);
-        }
-        // Extract session name from output (e.g., "qix-fox-use" in hook output)
-        const sessionMatch = this.outputBuffer.match(SESSION_NAME_REGEX);
-        if (sessionMatch) {
-            this.currentSessionName = sessionMatch[1];
-        }
-        // Detect context wall
-        if (CONTEXT_WALL_REGEX.test(this.outputBuffer) && !this.isAutoClearInProgress) {
-            const now = Date.now();
-            if (now - this.lastContextWallTime > this.CONTEXT_WALL_COOLDOWN) {
-                this.lastContextWallTime = now;
-                this.triggerAutoContinue();
-            }
-        }
-    }
-    /**
-     * Trigger auto /clear + /continue when context wall is hit
-     */
-    async triggerAutoContinue() {
-        if (this.isAutoClearInProgress || !this.ptyRunner)
-            return;
-        this.isAutoClearInProgress = true;
-        this.log('Auto-continue: Context wall detected, initiating /clear + /continue');
-        // Wait for idle prompt
-        await this.waitForIdlePrompt();
-        // Type /clear
-        this.log('Auto-continue: Sending /clear');
-        this.ptyRunner.write('/clear\n');
-        // Wait for clear to complete
-        await this.sleep(2000);
-        await this.waitForIdlePrompt();
-        // Type /continue with session name
-        const continueCmd = this.currentSessionName
-            ? `/continue ${this.currentSessionName}\n`
-            : '/continue\n';
-        this.log(`Auto-continue: Sending ${continueCmd.trim()}`);
-        this.ptyRunner.write(continueCmd);
-        // Reset state
-        this.outputBuffer = '';
-        this.isAutoClearInProgress = false;
-        this.log('Auto-continue: Complete');
-    }
-    /**
-     * Wait for Claude's idle prompt ("> ")
-     */
-    async waitForIdlePrompt(timeout = 10000) {
-        const startTime = Date.now();
-        while (Date.now() - startTime < timeout) {
-            if (IDLE_PROMPT_REGEX.test(this.outputBuffer)) {
-                return;
-            }
-            await this.sleep(100);
-        }
-        this.log('Auto-continue: Timeout waiting for idle prompt');
-    }
-    /**
-     * Sleep helper
-     */
-    sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-    /**
-     * Start or restart PTY for the current session.
-     */
-    startSessionPty(cwd) {
-        this.sessionStartedAt = Date.now();
-        // Run through the same Node runtime as the daemon to avoid PATH/shebang drift
-        // (e.g. Homebrew node upgrades breaking dylib links).
-        const fallbackEntrypoint = path.resolve(__dirname, '..', 'index.js');
-        const argvEntrypoint = process.argv[1];
-        const cliEntrypoint = argvEntrypoint && !argvEntrypoint.includes('/node_modules/.bin/')
-            ? argvEntrypoint
-            : fallbackEntrypoint;
-        // Start PTY with `node <cli> run -b` (skip -d to avoid double spawn).
-        this.ptyRunner = new pty_runner_1.PTYRunner({
-            command: process.execPath,
-            args: [cliEntrypoint, 'run', '-b'],
-            onData: (data) => this.sendOutput(data),
-            onExit: (code) => this.handlePTYExit(code),
-            cwd: cwd || process.env.HOME, // Use specified cwd or fall back to home
-            env: {
-                EKKOS_REMOTE_SESSION: '1',
-                EKKOS_NO_SPLASH: '1',
-            },
-            verbose: this.config.verbose,
-        });
-        this.ptyRunner.start();
-    }
-    /**
-     * Handle WebSocket close
-     *
-     * CRITICAL: Do NOT kill the PTY here. The PTY must survive WebSocket
-     * disconnects so users can reconnect to their existing session.
-     * The PTY is only killed on explicit session_end or daemon stop.
-     */
-    handleClose(code, reason) {
-        this.log(`Disconnected: ${code} ${reason}`);
-        // Stop heartbeat
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-        if (this.pongTimer) {
-            clearTimeout(this.pongTimer);
-            this.pongTimer = null;
-        }
-        // PTY stays alive - user can reconnect to existing session
-        // Only log if there's an active session being preserved
-        if (this.ptyRunner && this.currentSessionId) {
-            this.log(`Preserving PTY session ${this.currentSessionId} across disconnect`);
-        }
-        // Reconnect if still running
-        if (this.running) {
-            this.scheduleReconnect();
-        }
-    }
-    /**
-     * Schedule reconnection with exponential backoff
-     */
-    scheduleReconnect() {
-        const delay = RECONNECT_DELAYS[Math.min(this.reconnectAttempt, RECONNECT_DELAYS.length - 1)];
-        this.reconnectAttempt++;
-        this.log(`Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt})...`);
-        setTimeout(() => this.connect(), delay);
-    }
-    /**
-     * Handle WebSocket error
-     */
-    handleError(err) {
-        this.log('WebSocket error:', err.message);
-    }
-    /**
-     * Send message to server
-     */
-    sendMessage(message) {
-        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
-            this.ws.send(JSON.stringify(message));
-        }
-    }
-    /**
-     * Log message
-     */
-    log(...args) {
-        const timestamp = new Date().toISOString();
-        const message = `[${timestamp}] ${args.map(String).join(' ')}`;
-        if (this.config.verbose) {
-            console.log(message);
-        }
-        // Log to file with rotation
-        try {
-            (0, log_rotate_1.appendLog)(this.logPath, message);
-        }
-        catch {
-            // Ignore log errors
-        }
-    }
-}
-exports.AgentDaemon = AgentDaemon;

package/dist/agent/health-check.d.ts

@@ -1,35 +0,0 @@
-/**
- * Health check for ekkOS agent daemon
- *
- * Verifies:
- * - Service is installed and loaded
- * - Process is running
- * - Recent activity in logs
- * - Network connectivity to relay server
- */
-interface HealthStatus {
-    ok: boolean;
-    service: {
-        installed: boolean;
-        loaded: boolean;
-        running: boolean;
-        pid?: number;
-    };
-    logs: {
-        lastActivity?: Date;
-        recentErrors: string[];
-    };
-    relay: {
-        reachable: boolean;
-        lastError?: string;
-    };
-}
-/**
- * Check agent daemon health
- */
-export declare function checkDaemonHealth(): Promise<HealthStatus>;
-/**
- * Format health status for console output
- */
-export declare function formatHealthStatus(status: HealthStatus): string;
-export {};