@ekkos/cli 1.3.1 → 1.3.5

package/dist/agent/health-check.js

@@ -1,243 +0,0 @@
-"use strict";
-/**
- * Health check for ekkOS agent daemon
- *
- * Verifies:
- * - Service is installed and loaded
- * - Process is running
- * - Recent activity in logs
- * - Network connectivity to relay server
- */
-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.checkDaemonHealth = checkDaemonHealth;
-exports.formatHealthStatus = formatHealthStatus;
-const os = __importStar(require("os"));
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-const ws_1 = __importDefault(require("ws"));
-const RELAY_URL = process.env.RELAY_WS_URL || 'wss://ekkos-relay-production.up.railway.app';
-/**
- * Check agent daemon health
- */
-async function checkDaemonHealth() {
-    const status = {
-        ok: true,
-        service: {
-            installed: false,
-            loaded: false,
-            running: false,
-        },
-        logs: {
-            recentErrors: [],
-        },
-        relay: {
-            reachable: false,
-        },
-    };
-    // Check if service is installed
-    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'dev.ekkos.agent.plist');
-    status.service.installed = fs.existsSync(plistPath);
-    // Check if service is loaded
-    try {
-        const output = (0, child_process_1.execSync)('launchctl list | grep dev.ekkos.agent', { encoding: 'utf-8' }).trim();
-        status.service.loaded = !!output;
-        // Extract PID if running
-        const pidMatch = output.match(/^(\d+)\s+/);
-        if (pidMatch) {
-            status.service.pid = parseInt(pidMatch[1], 10);
-            status.service.running = status.service.pid > 0;
-        }
-    }
-    catch {
-        // Service not loaded
-        status.service.loaded = false;
-        status.service.running = false;
-    }
-    // Check logs
-    const logDir = path.join(os.homedir(), '.ekkos');
-    const errLogPath = path.join(logDir, 'agent.err.log');
-    const outLogPath = path.join(logDir, 'agent.out.log');
-    if (fs.existsSync(errLogPath)) {
-        try {
-            const errLog = fs.readFileSync(errLogPath, 'utf-8');
-            if (errLog) {
-                status.logs.lastActivity = new Date(fs.statSync(errLogPath).mtime);
-                status.logs.recentErrors = extractRecentErrors(errLog, 10);
-            }
-        }
-        catch {
-            // Ignore log read errors
-        }
-    }
-    if (fs.existsSync(outLogPath)) {
-        try {
-            const stat = fs.statSync(outLogPath);
-            const mtime = new Date(stat.mtime);
-            if (!status.logs.lastActivity || mtime > status.logs.lastActivity) {
-                status.logs.lastActivity = mtime;
-            }
-        }
-        catch {
-            // Ignore
-        }
-    }
-    // Check relay connectivity
-    try {
-        status.relay.reachable = await checkRelayConnectivity();
-    }
-    catch (err) {
-        status.relay.reachable = false;
-        status.relay.lastError = err.message;
-    }
-    // Overall health
-    status.ok = status.service.running && status.relay.reachable && status.logs.recentErrors.length === 0;
-    return status;
-}
-/**
- * Check if relay server is reachable
- */
-async function checkRelayConnectivity() {
-    return new Promise((resolve) => {
-        const timeout = setTimeout(() => {
-            ws.terminate();
-            resolve(false);
-        }, 5000);
-        const ws = new ws_1.default(`${RELAY_URL}/health`);
-        ws.on('open', () => {
-            clearTimeout(timeout);
-            ws.close();
-            resolve(true);
-        });
-        ws.on('error', () => {
-            clearTimeout(timeout);
-            resolve(false);
-        });
-        ws.on('close', () => {
-            clearTimeout(timeout);
-            resolve(false);
-        });
-    });
-}
-/**
- * Extract recent error lines from log
- */
-function extractRecentErrors(log, count) {
-    return log
-        .split('\n')
-        .filter((line) => {
-        const lower = line.toLowerCase();
-        return lower.includes('error') || lower.includes('failed') || lower.includes('exception');
-    })
-        .slice(-count);
-}
-/**
- * Format health status for console output
- */
-function formatHealthStatus(status) {
-    const lines = [];
-    lines.push('ekkOS Agent Daemon Health Check');
-    lines.push('================================\n');
-    // Service status
-    lines.push(`Service Installation: ${status.service.installed ? '✓' : '✗'} ${status.service.installed ? 'Installed' : 'Not installed'}`);
-    lines.push(`Service Loaded: ${status.service.loaded ? '✓' : '✗'} ${status.service.loaded ? 'Loaded' : 'Not loaded'}`);
-    if (status.service.running) {
-        lines.push(`Service Running: ✓ Running (PID ${status.service.pid})`);
-    }
-    else {
-        lines.push('Service Running: ✗ Not running');
-    }
-    lines.push('');
-    // Logs status
-    if (status.logs.lastActivity) {
-        const now = new Date();
-        const age = now.getTime() - status.logs.lastActivity.getTime();
-        const ageStr = formatAge(age);
-        lines.push(`Last Activity: ${ageStr} ago (${status.logs.lastActivity.toISOString()})`);
-    }
-    else {
-        lines.push('Last Activity: No logs found');
-    }
-    if (status.logs.recentErrors.length > 0) {
-        lines.push(`Recent Errors (${status.logs.recentErrors.length}):`);
-        for (const err of status.logs.recentErrors) {
-            lines.push(`  - ${err.substring(0, 100)}`);
-        }
-    }
-    lines.push('');
-    // Relay status
-    lines.push(`Relay Server: ${status.relay.reachable ? '✓' : '✗'} ${status.relay.reachable ? 'Reachable' : 'Unreachable'}`);
-    if (status.relay.lastError) {
-        lines.push(`  Error: ${status.relay.lastError}`);
-    }
-    lines.push('');
-    // Overall status
-    if (status.ok) {
-        lines.push('Overall: ✓ Healthy - All systems operational');
-    }
-    else {
-        lines.push('Overall: ✗ Unhealthy - Issues detected');
-        if (!status.service.running) {
-            lines.push('  → Service is not running. Run: launchctl start dev.ekkos.agent');
-        }
-        if (!status.relay.reachable) {
-            lines.push('  → Cannot reach relay server. Check network connectivity.');
-        }
-        if (status.logs.recentErrors.length > 0) {
-            lines.push('  → Recent errors found in logs. Check ~/.ekkos/agent.err.log');
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Format age duration
- */
-function formatAge(ms) {
-    const seconds = Math.floor(ms / 1000);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-    if (days > 0)
-        return `${days}d ${hours % 24}h`;
-    if (hours > 0)
-        return `${hours}h ${minutes % 60}m`;
-    if (minutes > 0)
-        return `${minutes}m ${seconds % 60}s`;
-    return `${seconds}s`;
-}

package/dist/agent/pty-runner.d.ts

@@ -1,53 +0,0 @@
-/**
- * PTY Runner for ekkOS Agent
- *
- * Spawns `ekkos run -d` in a pseudoterminal and handles I/O.
- * Based on the PTY patterns from packages/ekkos-cli/src/commands/run.ts
- */
-interface PTYRunnerConfig {
-    command: string;
-    args: string[];
-    onData: (data: string) => void;
-    onExit: (code: number) => void;
-    cols?: number;
-    rows?: number;
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    verbose?: boolean;
-}
-export declare class PTYRunner {
-    private config;
-    private ptyProcess;
-    private spawnProcess;
-    private usePty;
-    constructor(config: PTYRunnerConfig);
-    /**
-     * Start the PTY process
-     */
-    start(): void;
-    /**
-     * Start using node-pty (preferred)
-     */
-    private startWithPty;
-    /**
-     * Start using spawn (fallback for Windows without PTY)
-     */
-    private startWithSpawn;
-    /**
-     * Write data to PTY stdin
-     */
-    write(data: string): void;
-    /**
-     * Resize PTY
-     */
-    resize(cols: number, rows: number): void;
-    /**
-     * Kill the PTY process
-     */
-    kill(): void;
-    /**
-     * Check if PTY is running
-     */
-    isRunning(): boolean;
-}
-export {};

package/dist/agent/pty-runner.js

@@ -1,190 +0,0 @@
-"use strict";
-/**
- * PTY Runner for ekkOS Agent
- *
- * Spawns `ekkos run -d` in a pseudoterminal and handles I/O.
- * Based on the PTY patterns from packages/ekkos-cli/src/commands/run.ts
- */
-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;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PTYRunner = void 0;
-const os = __importStar(require("os"));
-const child_process_1 = require("child_process");
-// Try to load node-pty
-let pty = null;
-try {
-    pty = require('node-pty');
-}
-catch {
-    // node-pty not available, will use spawn fallback
-}
-class PTYRunner {
-    constructor(config) {
-        this.ptyProcess = null;
-        this.spawnProcess = null;
-        this.config = config;
-        this.usePty = pty !== null;
-    }
-    /**
-     * Start the PTY process
-     */
-    start() {
-        if (this.usePty && pty) {
-            this.startWithPty();
-        }
-        else {
-            this.startWithSpawn();
-        }
-    }
-    /**
-     * Start using node-pty (preferred)
-     */
-    startWithPty() {
-        if (!pty)
-            return;
-        const shell = os.platform() === 'win32' ? 'cmd.exe' : 'bash';
-        const shellArgs = os.platform() === 'win32'
-            ? ['/c', this.config.command, ...this.config.args]
-            : ['-c', `${this.config.command} ${this.config.args.join(' ')}`];
-        this.ptyProcess = pty.spawn(shell, shellArgs, {
-            name: 'xterm-256color',
-            cols: this.config.cols || 80,
-            rows: this.config.rows || 24,
-            cwd: this.config.cwd || process.cwd(),
-            env: {
-                ...process.env,
-                ...(this.config.env || {}),
-                TERM: 'xterm-256color',
-                COLORTERM: 'truecolor',
-            },
-        });
-        this.ptyProcess.onData((data) => {
-            this.config.onData(data);
-        });
-        this.ptyProcess.onExit(({ exitCode }) => {
-            this.config.onExit(exitCode);
-        });
-    }
-    /**
-     * Start using spawn (fallback for Windows without PTY)
-     */
-    startWithSpawn() {
-        const isWindows = os.platform() === 'win32';
-        const cwd = this.config.cwd || process.cwd();
-        if (isWindows) {
-            // Windows: Use cmd.exe
-            this.spawnProcess = (0, child_process_1.spawn)('cmd.exe', ['/c', this.config.command, ...this.config.args], {
-                stdio: ['pipe', 'pipe', 'pipe'],
-                cwd,
-                env: {
-                    ...process.env,
-                    ...(this.config.env || {}),
-                },
-            });
-        }
-        else {
-            // Unix: Use script for PTY emulation
-            const scriptArgs = os.platform() === 'darwin'
-                ? ['-q', '/dev/null', this.config.command, ...this.config.args]
-                : ['-q', '-c', `${this.config.command} ${this.config.args.join(' ')}`, '/dev/null'];
-            this.spawnProcess = (0, child_process_1.spawn)('script', scriptArgs, {
-                stdio: ['pipe', 'pipe', 'pipe'],
-                cwd,
-                env: {
-                    ...process.env,
-                    ...(this.config.env || {}),
-                    TERM: 'xterm-256color',
-                },
-            });
-        }
-        if (this.spawnProcess.stdout) {
-            this.spawnProcess.stdout.on('data', (data) => {
-                this.config.onData(data.toString());
-            });
-        }
-        if (this.spawnProcess.stderr) {
-            this.spawnProcess.stderr.on('data', (data) => {
-                this.config.onData(data.toString());
-            });
-        }
-        this.spawnProcess.on('exit', (code) => {
-            this.config.onExit(code || 0);
-        });
-        this.spawnProcess.on('error', (err) => {
-            this.config.onData(`Error: ${err.message}\r\n`);
-            this.config.onExit(1);
-        });
-    }
-    /**
-     * Write data to PTY stdin
-     */
-    write(data) {
-        if (this.ptyProcess) {
-            this.ptyProcess.write(data);
-        }
-        else if (this.spawnProcess && this.spawnProcess.stdin) {
-            this.spawnProcess.stdin.write(data);
-        }
-    }
-    /**
-     * Resize PTY
-     */
-    resize(cols, rows) {
-        if (this.ptyProcess && this.ptyProcess.resize) {
-            this.ptyProcess.resize(cols, rows);
-        }
-        // Spawn fallback doesn't support resize
-    }
-    /**
-     * Kill the PTY process
-     */
-    kill() {
-        if (this.ptyProcess) {
-            this.ptyProcess.kill();
-            this.ptyProcess = null;
-        }
-        if (this.spawnProcess) {
-            this.spawnProcess.kill('SIGTERM');
-            this.spawnProcess = null;
-        }
-    }
-    /**
-     * Check if PTY is running
-     */
-    isRunning() {
-        return this.ptyProcess !== null || this.spawnProcess !== null;
-    }
-}
-exports.PTYRunner = PTYRunner;

package/dist/commands/agent.d.ts

@@ -1,50 +0,0 @@
-/**
- * ekkos agent - Agent management commands for remote terminal
- *
- * Subcommands:
- * - daemon: Run the agent daemon (used by service)
- * - start: Start the agent service
- * - stop: Stop the agent service
- * - restart: Restart the agent service
- * - status: Check agent status
- * - uninstall: Remove agent service
- */
-export interface AgentOptions {
-    verbose?: boolean;
-}
-/**
- * Run the agent daemon (foreground)
- */
-export declare function agentDaemon(options?: AgentOptions): Promise<void>;
-/**
- * Start the agent service
- */
-export declare function agentStart(options?: AgentOptions): Promise<void>;
-/**
- * Stop the agent service
- */
-export declare function agentStop(options?: AgentOptions): Promise<void>;
-/**
- * Restart the agent service
- */
-export declare function agentRestart(options?: AgentOptions): Promise<void>;
-/**
- * Check agent status
- */
-export declare function agentStatus(options?: AgentOptions): Promise<void>;
-/**
- * Uninstall the agent service
- */
-export declare function agentUninstall(options?: AgentOptions): Promise<void>;
-/**
- * Show agent logs
- */
-export declare function agentLogs(options?: {
-    follow?: boolean;
-}): Promise<void>;
-/**
- * Check agent daemon health and diagnose connection issues
- */
-export declare function agentHealth(options?: {
-    json?: boolean;
-}): Promise<void>;