episoda 0.2.0

package/dist/core/websocket-client.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Episoda WebSocket Client
+ *
+ * EP589-9: Implemented with comprehensive error handling and reconnection logic
+ *
+ * Provides reliable WebSocket connection to episoda.dev CLI gateway with:
+ * - Automatic reconnection with exponential backoff
+ * - Heartbeat/ping-pong to keep connection alive
+ * - Event-driven architecture for handling server commands
+ * - Graceful error handling and recovery
+ */
+import { ServerMessage, ClientMessage, ConnectionStatus } from './command-protocol';
+export type DisconnectEvent = {
+    type: 'disconnected';
+    code: number;
+    reason: string;
+    willReconnect: boolean;
+};
+export type ClientEvent = ServerMessage | DisconnectEvent;
+export type EventHandler = (event: ClientEvent) => void | Promise<void>;
+/**
+ * WebSocket client for connecting to episoda.dev/cli gateway
+ *
+ * DESIGN PRINCIPLES:
+ * - Reverse WebSocket: Client connects TO server (bypasses NAT/firewall)
+ * - Automatic reconnection with exponential backoff
+ * - Server-initiated heartbeat via WebSocket ping/pong (30s interval)
+ * - Event-driven architecture for handling server commands
+ */
+export declare class EpisodaClient {
+    private ws?;
+    private eventHandlers;
+    private reconnectAttempts;
+    private reconnectTimeout?;
+    private url;
+    private token;
+    private machineId?;
+    private hostname?;
+    private osPlatform?;
+    private osArch?;
+    private daemonPid?;
+    private isConnected;
+    private isDisconnecting;
+    private isGracefulShutdown;
+    private heartbeatTimer?;
+    private heartbeatTimeoutTimer?;
+    private lastCommandTime;
+    private firstDisconnectTime?;
+    private isIntentionalDisconnect;
+    private rateLimitBackoffUntil?;
+    private lastConnectAttemptTime;
+    private lastErrorCode?;
+    /**
+     * Connect to episoda.dev WebSocket gateway
+     * @param url - WebSocket URL (wss://episoda.dev/cli)
+     * @param token - OAuth access token
+     * @param machineId - Optional machine identifier for multi-machine support
+     * @param deviceInfo - Optional device information (hostname, OS, daemonPid)
+     */
+    connect(url: string, token: string, machineId?: string, deviceInfo?: {
+        hostname?: string;
+        osPlatform?: string;
+        osArch?: string;
+        daemonPid?: number;
+    }): Promise<void>;
+    /**
+     * Disconnect from the server
+     * @param intentional - If true, prevents automatic reconnection (user-initiated disconnect)
+     */
+    disconnect(intentional?: boolean): Promise<void>;
+    /**
+     * Register an event handler
+     * @param event - Event type ('command', 'ping', 'error', 'auth_success')
+     * @param handler - Handler function
+     */
+    on(event: string, handler: EventHandler): void;
+    /**
+     * Send a message to the server
+     * @param message - Client message to send
+     */
+    send(message: ClientMessage): Promise<void>;
+    /**
+     * Get current connection status
+     */
+    getStatus(): ConnectionStatus;
+    /**
+     * EP605: Update last command time to reset idle detection
+     * Call this when a command is received/executed
+     */
+    updateActivity(): void;
+    /**
+     * EP701: Emit a client-side event to registered handlers
+     * Used for events like 'disconnected' that originate from the client, not server
+     */
+    private emit;
+    /**
+     * Handle incoming message from server
+     */
+    private handleMessage;
+    /**
+     * Schedule reconnection with exponential backoff and randomization
+     *
+     * EP605: Conservative reconnection with multiple safeguards:
+     * - 6-hour maximum retry duration to prevent indefinite retrying
+     * - Activity-based backoff (10 min delay if idle for 1+ hour)
+     * - No reconnection after intentional disconnect
+     * - Randomization to prevent thundering herd
+     *
+     * EP648: Additional protections against reconnection loops:
+     * - Rate limit awareness: respect server's RATE_LIMITED response
+     * - Rapid close detection: if connection closes within 2s, apply longer backoff
+     */
+    private scheduleReconnect;
+    /**
+     * EP605: Start client-side heartbeat to detect dead connections
+     *
+     * Sends ping every 45 seconds and expects pong within 15 seconds.
+     * If no pong received, terminates connection to trigger reconnection.
+     */
+    private startHeartbeat;
+}
+//# sourceMappingURL=websocket-client.d.ts.map

package/dist/core/websocket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.d.ts","sourceRoot":"","sources":["../../src/core/websocket-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAInF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,eAAe,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAqBvE;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAC,CAAI;IACf,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAgB;IACzC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,kBAAkB,CAAQ;IAElC,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAgB;IAE9C,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,mBAAmB,CAAC,CAAQ;IACpC,OAAO,CAAC,uBAAuB,CAAQ;IAEvC,OAAO,CAAC,qBAAqB,CAAC,CAAQ;IACtC,OAAO,CAAC,sBAAsB,CAAI;IAClC,OAAO,CAAC,aAAa,CAAC,CAAQ;IAE9B;;;;;;OAMG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3F,OAAO,CAAC,IAAI,CAAC;IAoHhB;;;OAGG;IACG,UAAU,CAAC,WAAW,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAO9C;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAM7B;;;OAGG;IACH,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,OAAO,CAAC,IAAI;IAWZ;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,iBAAiB;IAkHzB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAgCvB"}

package/dist/core/websocket-client.js

@@ -0,0 +1,438 @@
+"use strict";
+/**
+ * Episoda WebSocket Client
+ *
+ * EP589-9: Implemented with comprehensive error handling and reconnection logic
+ *
+ * Provides reliable WebSocket connection to episoda.dev CLI gateway with:
+ * - Automatic reconnection with exponential backoff
+ * - Heartbeat/ping-pong to keep connection alive
+ * - Event-driven architecture for handling server commands
+ * - Graceful error handling and recovery
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EpisodaClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const version_1 = require("./version");
+// EP605: Reconnection configuration for long-term stability
+const INITIAL_RECONNECT_DELAY = 1000; // 1 second
+const MAX_RECONNECT_DELAY = 60000; // 60 seconds standard max
+const IDLE_RECONNECT_DELAY = 600000; // 10 minutes when idle (no commands for 1+ hour)
+const MAX_RETRY_DURATION = 6 * 60 * 60 * 1000; // 6 hours maximum retry duration
+const IDLE_THRESHOLD = 60 * 60 * 1000; // 1 hour - after this, use slower retry
+// EP648: Rate limit and rapid reconnect prevention
+const RATE_LIMIT_BACKOFF = 60000; // 60 seconds when rate limited
+const RAPID_CLOSE_THRESHOLD = 2000; // If connection closes within 2s, it's likely an error
+const RAPID_CLOSE_BACKOFF = 30000; // 30 seconds backoff for rapid close scenarios
+// EP605: Client-side heartbeat to detect dead connections
+const CLIENT_HEARTBEAT_INTERVAL = 45000; // 45 seconds (offset from server's 30s to avoid collision)
+const CLIENT_HEARTBEAT_TIMEOUT = 15000; // 15 seconds to wait for pong
+// EP606: Connection timeout for initial WebSocket connection
+const CONNECTION_TIMEOUT = 15000; // 15 seconds to establish connection
+/**
+ * WebSocket client for connecting to episoda.dev/cli gateway
+ *
+ * DESIGN PRINCIPLES:
+ * - Reverse WebSocket: Client connects TO server (bypasses NAT/firewall)
+ * - Automatic reconnection with exponential backoff
+ * - Server-initiated heartbeat via WebSocket ping/pong (30s interval)
+ * - Event-driven architecture for handling server commands
+ */
+class EpisodaClient {
+    constructor() {
+        this.eventHandlers = new Map();
+        this.reconnectAttempts = 0;
+        this.url = '';
+        this.token = '';
+        this.isConnected = false;
+        this.isDisconnecting = false;
+        this.isGracefulShutdown = false; // Track if shutdown was graceful (server-initiated)
+        // EP605: Activity and retry duration tracking
+        this.lastCommandTime = Date.now(); // Track last command for idle detection
+        this.isIntentionalDisconnect = false; // Prevent reconnection after intentional disconnect
+        this.lastConnectAttemptTime = 0; // Track when we last attempted to connect
+    }
+    /**
+     * Connect to episoda.dev WebSocket gateway
+     * @param url - WebSocket URL (wss://episoda.dev/cli)
+     * @param token - OAuth access token
+     * @param machineId - Optional machine identifier for multi-machine support
+     * @param deviceInfo - Optional device information (hostname, OS, daemonPid)
+     */
+    async connect(url, token, machineId, deviceInfo) {
+        this.url = url;
+        this.token = token;
+        this.machineId = machineId;
+        this.hostname = deviceInfo?.hostname;
+        this.osPlatform = deviceInfo?.osPlatform;
+        this.osArch = deviceInfo?.osArch;
+        this.daemonPid = deviceInfo?.daemonPid;
+        this.isDisconnecting = false;
+        this.isGracefulShutdown = false; // Reset graceful shutdown flag on new connection
+        this.isIntentionalDisconnect = false; // Allow reconnection on fresh connect
+        this.lastConnectAttemptTime = Date.now(); // EP648: Track when this connection attempt started
+        this.lastErrorCode = undefined; // EP648: Clear last error code
+        return new Promise((resolve, reject) => {
+            // EP606: Connection timeout to prevent hanging indefinitely
+            const connectionTimeout = setTimeout(() => {
+                if (this.ws) {
+                    this.ws.terminate();
+                }
+                reject(new Error(`Connection timeout after ${CONNECTION_TIMEOUT / 1000}s - server may be unreachable`));
+            }, CONNECTION_TIMEOUT);
+            try {
+                this.ws = new ws_1.default(url);
+                // Connection opened
+                this.ws.on('open', () => {
+                    clearTimeout(connectionTimeout); // EP606: Clear timeout on successful connection
+                    console.log('[EpisodaClient] WebSocket connected');
+                    this.isConnected = true;
+                    this.reconnectAttempts = 0;
+                    this.firstDisconnectTime = undefined; // EP605: Reset retry duration tracking
+                    this.lastCommandTime = Date.now(); // EP605: Reset activity timer
+                    // Send auth message (K722: includes machineId, EP596: includes device info, EP601: includes daemonPid)
+                    this.send({
+                        type: 'auth',
+                        token,
+                        version: version_1.VERSION,
+                        machineId,
+                        hostname: this.hostname,
+                        osPlatform: this.osPlatform,
+                        osArch: this.osArch,
+                        daemonPid: this.daemonPid
+                    });
+                    // EP605: Start client-side heartbeat
+                    this.startHeartbeat();
+                    resolve();
+                });
+                // EP605: Handle pong response from server (for client-initiated pings)
+                this.ws.on('pong', () => {
+                    // Clear the timeout - connection is alive
+                    if (this.heartbeatTimeoutTimer) {
+                        clearTimeout(this.heartbeatTimeoutTimer);
+                        this.heartbeatTimeoutTimer = undefined;
+                    }
+                });
+                // Message received
+                this.ws.on('message', (data) => {
+                    try {
+                        const message = JSON.parse(data.toString());
+                        this.handleMessage(message);
+                    }
+                    catch (error) {
+                        console.error('[EpisodaClient] Failed to parse message:', error);
+                    }
+                });
+                // EP603: Log ping events for debugging connection health
+                this.ws.on('ping', () => {
+                    console.log('[EpisodaClient] Received ping from server');
+                });
+                // Connection closed
+                this.ws.on('close', (code, reason) => {
+                    console.log(`[EpisodaClient] WebSocket closed: ${code} ${reason.toString()}`);
+                    this.isConnected = false;
+                    const willReconnect = !this.isDisconnecting;
+                    // EP701: Emit 'disconnected' event so daemon can clean up connection
+                    this.emit({
+                        type: 'disconnected',
+                        code,
+                        reason: reason.toString(),
+                        willReconnect
+                    });
+                    // Attempt reconnection if not intentional disconnect
+                    if (willReconnect) {
+                        this.scheduleReconnect();
+                    }
+                });
+                // Error occurred
+                this.ws.on('error', (error) => {
+                    console.error('[EpisodaClient] WebSocket error:', error);
+                    if (!this.isConnected) {
+                        // Connection failed, reject the promise
+                        clearTimeout(connectionTimeout); // EP606: Clear timeout on error
+                        reject(error);
+                    }
+                });
+            }
+            catch (error) {
+                clearTimeout(connectionTimeout); // EP606: Clear timeout on exception
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from the server
+     * @param intentional - If true, prevents automatic reconnection (user-initiated disconnect)
+     */
+    async disconnect(intentional = true) {
+        this.isDisconnecting = true;
+        this.isIntentionalDisconnect = intentional; // EP605: Prevent reconnection if user intentionally disconnected
+        // EP605: Clear all timers
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = undefined;
+        }
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        if (this.heartbeatTimeoutTimer) {
+            clearTimeout(this.heartbeatTimeoutTimer);
+            this.heartbeatTimeoutTimer = undefined;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = undefined;
+        }
+        this.isConnected = false;
+    }
+    /**
+     * Register an event handler
+     * @param event - Event type ('command', 'ping', 'error', 'auth_success')
+     * @param handler - Handler function
+     */
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, []);
+        }
+        this.eventHandlers.get(event).push(handler);
+    }
+    /**
+     * Send a message to the server
+     * @param message - Client message to send
+     */
+    async send(message) {
+        if (!this.ws || !this.isConnected) {
+            throw new Error('WebSocket not connected');
+        }
+        return new Promise((resolve, reject) => {
+            this.ws.send(JSON.stringify(message), (error) => {
+                if (error) {
+                    console.error('[EpisodaClient] Failed to send message:', error);
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Get current connection status
+     */
+    getStatus() {
+        return {
+            connected: this.isConnected
+        };
+    }
+    /**
+     * EP605: Update last command time to reset idle detection
+     * Call this when a command is received/executed
+     */
+    updateActivity() {
+        this.lastCommandTime = Date.now();
+    }
+    /**
+     * EP701: Emit a client-side event to registered handlers
+     * Used for events like 'disconnected' that originate from the client, not server
+     */
+    emit(event) {
+        const handlers = this.eventHandlers.get(event.type) || [];
+        handlers.forEach(handler => {
+            try {
+                handler(event);
+            }
+            catch (error) {
+                console.error(`[EpisodaClient] Handler error for ${event.type}:`, error);
+            }
+        });
+    }
+    /**
+     * Handle incoming message from server
+     */
+    handleMessage(message) {
+        // Special handling for graceful shutdown messages from server
+        if (message.type === 'shutdown') {
+            console.log('[EpisodaClient] Received graceful shutdown message from server');
+            this.isGracefulShutdown = true;
+        }
+        // EP648: Handle error messages, especially rate limiting and rapid reconnect
+        if (message.type === 'error') {
+            const errorMessage = message;
+            this.lastErrorCode = errorMessage.code;
+            if (errorMessage.code === 'RATE_LIMITED' || errorMessage.code === 'TOO_SOON') {
+                // Use server-provided retryAfter or default to 60 seconds for rate limit, 5 seconds for too soon
+                const defaultRetry = errorMessage.code === 'RATE_LIMITED' ? 60 : 5;
+                const retryAfterMs = (errorMessage.retryAfter || defaultRetry) * 1000;
+                this.rateLimitBackoffUntil = Date.now() + retryAfterMs;
+                console.log(`[EpisodaClient] ${errorMessage.code}: will retry after ${retryAfterMs / 1000}s`);
+            }
+        }
+        const handlers = this.eventHandlers.get(message.type) || [];
+        // Execute all handlers for this message type
+        handlers.forEach(handler => {
+            try {
+                handler(message);
+            }
+            catch (error) {
+                console.error(`[EpisodaClient] Handler error for ${message.type}:`, error);
+            }
+        });
+    }
+    /**
+     * Schedule reconnection with exponential backoff and randomization
+     *
+     * EP605: Conservative reconnection with multiple safeguards:
+     * - 6-hour maximum retry duration to prevent indefinite retrying
+     * - Activity-based backoff (10 min delay if idle for 1+ hour)
+     * - No reconnection after intentional disconnect
+     * - Randomization to prevent thundering herd
+     *
+     * EP648: Additional protections against reconnection loops:
+     * - Rate limit awareness: respect server's RATE_LIMITED response
+     * - Rapid close detection: if connection closes within 2s, apply longer backoff
+     */
+    scheduleReconnect() {
+        // EP605: Don't reconnect if user intentionally disconnected
+        if (this.isIntentionalDisconnect) {
+            console.log('[EpisodaClient] Intentional disconnect - not reconnecting');
+            return;
+        }
+        // EP605: Clear heartbeat timers before reconnection attempt
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        if (this.heartbeatTimeoutTimer) {
+            clearTimeout(this.heartbeatTimeoutTimer);
+            this.heartbeatTimeoutTimer = undefined;
+        }
+        // EP605: Track when reconnection attempts started
+        if (!this.firstDisconnectTime) {
+            this.firstDisconnectTime = Date.now();
+        }
+        // EP605: Check 6-hour maximum retry duration
+        const retryDuration = Date.now() - this.firstDisconnectTime;
+        if (retryDuration >= MAX_RETRY_DURATION) {
+            console.error(`[EpisodaClient] Maximum retry duration (6 hours) exceeded, giving up. Please restart the CLI.`);
+            return;
+        }
+        // EP605: Log periodically to show we're still trying
+        if (this.reconnectAttempts > 0 && this.reconnectAttempts % 10 === 0) {
+            const hoursRemaining = ((MAX_RETRY_DURATION - retryDuration) / (60 * 60 * 1000)).toFixed(1);
+            console.log(`[EpisodaClient] Still attempting to reconnect (attempt ${this.reconnectAttempts}, ${hoursRemaining}h remaining)...`);
+        }
+        // EP648: Check if we're still in rate limit backoff period
+        if (this.rateLimitBackoffUntil && Date.now() < this.rateLimitBackoffUntil) {
+            const waitTime = this.rateLimitBackoffUntil - Date.now();
+            console.log(`[EpisodaClient] Rate limited, waiting ${Math.round(waitTime / 1000)}s before retry`);
+            this.reconnectAttempts++;
+            this.reconnectTimeout = setTimeout(() => {
+                this.rateLimitBackoffUntil = undefined; // Clear rate limit after waiting
+                this.scheduleReconnect();
+            }, waitTime);
+            return;
+        }
+        // EP648: Detect rapid close (connection closed within 2 seconds of opening)
+        // This indicates an error condition like rate limiting, auth failure, etc.
+        const timeSinceConnect = Date.now() - this.lastConnectAttemptTime;
+        const wasRapidClose = timeSinceConnect < RAPID_CLOSE_THRESHOLD && this.lastConnectAttemptTime > 0;
+        // EP605: Check if connection is idle (no commands for 1+ hour)
+        const timeSinceLastCommand = Date.now() - this.lastCommandTime;
+        const isIdle = timeSinceLastCommand >= IDLE_THRESHOLD;
+        // Calculate base delay based on shutdown type and conditions
+        let baseDelay;
+        if (this.isGracefulShutdown && this.reconnectAttempts < 3) {
+            // Graceful shutdown: try reconnecting quickly (500ms, 1s, 2s)
+            baseDelay = 500 * Math.pow(2, this.reconnectAttempts);
+        }
+        else if (wasRapidClose) {
+            // EP648: Connection failed almost immediately - likely rate limited or auth error
+            // Apply longer backoff to prevent spam
+            baseDelay = Math.max(RAPID_CLOSE_BACKOFF, INITIAL_RECONNECT_DELAY * Math.pow(2, Math.min(this.reconnectAttempts, 6)));
+            console.log(`[EpisodaClient] Rapid close detected (${timeSinceConnect}ms), applying ${baseDelay / 1000}s backoff`);
+        }
+        else if (isIdle) {
+            // EP605: Use slower retry for idle connections (10 minutes)
+            baseDelay = IDLE_RECONNECT_DELAY;
+        }
+        else {
+            // EP605: Use capped exponential backoff
+            // After 6 attempts, we hit max delay and stay there
+            const cappedAttempts = Math.min(this.reconnectAttempts, 6);
+            baseDelay = INITIAL_RECONNECT_DELAY * Math.pow(2, cappedAttempts);
+        }
+        // Add randomization (±25%) to prevent thundering herd
+        // When server restarts, all clients shouldn't hit it at the exact same time
+        const jitter = baseDelay * 0.25 * (Math.random() * 2 - 1); // Random between -25% and +25%
+        const maxDelay = isIdle ? IDLE_RECONNECT_DELAY : MAX_RECONNECT_DELAY;
+        const delay = Math.min(baseDelay + jitter, maxDelay);
+        this.reconnectAttempts++;
+        const shutdownType = this.isGracefulShutdown ? 'graceful' : 'ungraceful';
+        const idleStatus = isIdle ? ', idle' : '';
+        const rapidStatus = wasRapidClose ? ', rapid-close' : '';
+        // EP605: Only log first few attempts and then periodically
+        if (this.reconnectAttempts <= 5 || this.reconnectAttempts % 10 === 0) {
+            console.log(`[EpisodaClient] Reconnecting in ${Math.round(delay / 1000)}s (attempt ${this.reconnectAttempts}, ${shutdownType}${idleStatus}${rapidStatus})`);
+        }
+        this.reconnectTimeout = setTimeout(() => {
+            console.log('[EpisodaClient] Attempting reconnection...');
+            this.connect(this.url, this.token, this.machineId, {
+                hostname: this.hostname,
+                osPlatform: this.osPlatform,
+                osArch: this.osArch,
+                daemonPid: this.daemonPid
+            }).then(() => {
+                // EP605: Reset counters after successful reconnection
+                console.log('[EpisodaClient] Reconnection successful, resetting retry counter');
+                this.reconnectAttempts = 0;
+                this.isGracefulShutdown = false;
+                this.firstDisconnectTime = undefined;
+                this.rateLimitBackoffUntil = undefined; // EP648: Clear rate limit on success
+            }).catch(error => {
+                console.error('[EpisodaClient] Reconnection failed:', error);
+                // scheduleReconnect will be called again from the 'close' event
+            });
+        }, delay);
+    }
+    /**
+     * EP605: Start client-side heartbeat to detect dead connections
+     *
+     * Sends ping every 45 seconds and expects pong within 15 seconds.
+     * If no pong received, terminates connection to trigger reconnection.
+     */
+    startHeartbeat() {
+        // Clear any existing heartbeat
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+        }
+        this.heartbeatTimer = setInterval(() => {
+            if (!this.ws || this.ws.readyState !== ws_1.default.OPEN) {
+                return;
+            }
+            // Send ping
+            try {
+                this.ws.ping();
+                // Clear any existing timeout before setting new one (prevents timer leak)
+                if (this.heartbeatTimeoutTimer) {
+                    clearTimeout(this.heartbeatTimeoutTimer);
+                }
+                // Set timeout for pong response
+                this.heartbeatTimeoutTimer = setTimeout(() => {
+                    console.log('[EpisodaClient] Heartbeat timeout - no pong received, terminating connection');
+                    if (this.ws) {
+                        this.ws.terminate(); // Force close to trigger reconnection
+                    }
+                }, CLIENT_HEARTBEAT_TIMEOUT);
+            }
+            catch (error) {
+                console.error('[EpisodaClient] Error sending heartbeat ping:', error);
+            }
+        }, CLIENT_HEARTBEAT_INTERVAL);
+    }
+}
+exports.EpisodaClient = EpisodaClient;
+//# sourceMappingURL=websocket-client.js.map

package/dist/core/websocket-client.js.map

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

package/dist/daemon/daemon-manager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Daemon lifecycle management
+ *
+ * Manages the Episoda daemon process lifecycle:
+ * - Spawning daemon in detached mode
+ * - Checking daemon status
+ * - Stopping daemon gracefully
+ * - PID file management
+ *
+ * Ensures only one daemon runs per user.
+ */
+/**
+ * EP734: Kill all stale Episoda processes
+ *
+ * Finds and kills any existing episoda-related processes to ensure
+ * a clean slate before starting a new daemon. This prevents:
+ * - Multiple daemon processes running simultaneously
+ * - Stale `episoda dev` foreground processes from previous sessions
+ * - Orphaned node processes running daemon-process.js
+ *
+ * @returns Number of processes killed
+ */
+export declare function killAllEpisodaProcesses(): number;
+/**
+ * Get path to daemon PID file
+ */
+export declare function getPidFilePath(): string;
+/**
+ * Check if daemon is running
+ *
+ * Reads PID from file and checks if process exists.
+ *
+ * @returns PID if running, null if not
+ */
+export declare function isDaemonRunning(): number | null;
+/**
+ * Start the daemon process
+ *
+ * Spawns daemon in detached mode. Daemon survives terminal close.
+ *
+ * @throws Error if daemon already running or spawn fails
+ */
+export declare function startDaemon(): Promise<number>;
+/**
+ * Stop the daemon process
+ *
+ * Sends SIGTERM for graceful shutdown. If daemon doesn't stop
+ * within timeout, sends SIGKILL.
+ *
+ * @param timeout Milliseconds to wait before SIGKILL (default: 5000)
+ * @returns true if stopped, false if wasn't running
+ */
+export declare function stopDaemon(timeout?: number): Promise<boolean>;
+/**
+ * Restart the daemon
+ *
+ * Stops existing daemon and starts new one.
+ *
+ * @returns PID of new daemon
+ */
+export declare function restartDaemon(): Promise<number>;
+/**
+ * Get daemon status information
+ *
+ * @returns Status object with running state and PID
+ */
+export declare function getDaemonStatus(): {
+    running: boolean;
+    pid: number | null;
+};
+//# sourceMappingURL=daemon-manager.d.ts.map

package/dist/daemon/daemon-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-manager.d.ts","sourceRoot":"","sources":["../../src/daemon/daemon-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CA6DhD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CA+B/C;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAmDnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CzE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAM1E"}