byterover-cli 1.7.2 → 2.0.0

package/dist/server/infra/process/process-manager.d.ts

@@ -1,242 +0,0 @@
-/**
- * Process Manager - Manages the lifecycle of Transport and Agent processes.
- *
- * Architecture v0.5.0:
- * - Spawns 2 separate child processes: Transport and Agent
- * - Transport Process: Socket.IO server only (message hub)
- * - Agent Process: TaskProcessor + UseCases + CipherAgent
- * - ALL task communication via Socket.IO (NO IPC for tasks)
- * - IPC only for process lifecycle: ready, shutdown, stopped
- *
- * Startup sequence:
- * 1. fork('transport-worker.js')
- * 2. Wait for Transport 'ready' with port
- * 3. fork('agent-worker.js') with TRANSPORT_PORT env
- * 4. Wait for Agent 'ready'
- *
- * Shutdown sequence:
- * 1. Send 'shutdown' to Agent via IPC
- * 2. Wait for Agent to exit
- * 3. Send 'shutdown' to Transport via IPC
- * 4. Wait for Transport to exit
- */
-import { type ChildProcess } from 'node:child_process';
-/**
- * Process state tracking.
- */
-export type ProcessState = {
-    /** Agent child process */
-    agentProcess?: ChildProcess;
-    /** Whether Agent is connected */
-    agentReady: boolean;
-    /** Transport port (from Transport Process) */
-    port?: number;
-    /** Whether system is running */
-    running: boolean;
-    /** Transport child process */
-    transportProcess?: ChildProcess;
-    /** Whether Transport is ready */
-    transportReady: boolean;
-};
-/**
- * ProcessManager configuration.
- */
-export type ProcessManagerConfig = {
-    /** Timeout for process shutdown (ms) */
-    shutdownTimeoutMs?: number;
-    /** Timeout for process startup (ms) */
-    startupTimeoutMs?: number;
-};
-/**
- * Options for starting the process manager.
- */
-export type ProcessStartOptions = {
-    /** Session ID to pass to Agent process (for stateful sessions) */
-    sessionId?: string;
-};
-/**
- * ProcessManager - Spawns and manages Transport and Agent processes.
- *
- * Architecture v0.5.0:
- * - Single source of truth for child process lifecycle
- * - Transport spawned first (needs port)
- * - Agent spawned second (needs transport port)
- * - Crash recovery: respawn on exit
- */
-export declare class ProcessManager {
-    /** Whether an Agent health-check is pending response */
-    private agentHealthCheckPending;
-    /** Timeout for Agent health-check response */
-    private agentHealthCheckTimeout?;
-    private currentSessionId?;
-    private healthCheckInterval?;
-    /** Guard to prevent concurrent Agent restarts */
-    private isRestartingAgent;
-    /** Guard to prevent concurrent Transport restarts */
-    private isRestartingTransport;
-    private lastHealthCheckTime;
-    /** Periodic health check interval (30s) */
-    private periodicHealthCheckInterval?;
-    /** Stored handler ref for idempotent listener setup (prevents accumulation on respawn) */
-    private runtimeMessageHandler?;
-    private readonly shutdownTimeoutMs;
-    private readonly startupTimeoutMs;
-    private state;
-    /** Stored handler ref for Transport runtime messages (prevents accumulation on respawn) */
-    private transportMessageHandler?;
-    /** Whether a Transport ping is pending response */
-    private transportPingPending;
-    /** Timeout for Transport ping response */
-    private transportPingTimeout?;
-    constructor(config?: ProcessManagerConfig);
-    /**
-     * Get current state.
-     */
-    getState(): Readonly<ProcessState>;
-    /**
-     * Get transport port (for TUI to connect).
-     */
-    getTransportPort(): number | undefined;
-    /**
-     * Check if system is fully running.
-     */
-    isRunning(): boolean;
-    /**
-     * Start Transport and Agent processes.
-     *
-     * Sequence:
-     * 1. Start Transport Process
-     * 2. Wait for Transport 'ready' with port
-     * 3. Start Agent Process with TRANSPORT_PORT env
-     * 4. Wait for Agent 'ready'
-     *
-     * @param options - Start options including session ID for stateful sessions
-     * @throws Error if startup fails or times out
-     */
-    start(options?: ProcessStartOptions): Promise<void>;
-    /**
-     * Stop all processes gracefully.
-     *
-     * Sequence:
-     * 1. Stop Agent first (so it can disconnect cleanly)
-     * 2. Stop Transport after Agent is gone
-     */
-    stop(): Promise<void>;
-    /**
-     * Get directory for worker files.
-     * In dev mode (tsx), import.meta.url points to src/ but workers need compiled .js from dist/
-     */
-    private getWorkerDir;
-    /**
-     * Handle runtime IPC messages from Agent process.
-     * Called by the message event handler set up in setupAgentRuntimeHandlers.
-     */
-    private handleAgentRuntimeMessage;
-    /**
-     * Handle system wake from sleep.
-     * Verify processes are still alive and restart if needed.
-     * Triggers immediate health checks on both Transport and Agent.
-     */
-    private handleSystemWake;
-    /**
-     * Handle runtime IPC messages from Transport process.
-     * Called by the message event handler set up in setupTransportRuntimeHandlers.
-     */
-    private handleTransportRuntimeMessage;
-    /**
-     * Send health-check to Agent with timeout.
-     * If no response within timeout, Agent is considered stuck and restarted.
-     * Used by periodic health check and after system wake.
-     */
-    private healthCheckAgentWithTimeout;
-    /**
-     * Send ping to Transport with timeout.
-     * If no pong received within timeout, Transport is considered zombie and restarted.
-     */
-    private pingTransportWithTimeout;
-    /**
-     * Restart Agent process gracefully.
-     * Used when health-check fails after sleep/wake or periodic check.
-     * Guarded to prevent concurrent restart race conditions.
-     */
-    private restartAgent;
-    /**
-     * Restart Transport process gracefully.
-     * Used when ping timeout detects zombie process after sleep/wake or periodic check.
-     * Note: Agent must also be restarted since Transport port changes.
-     * Guarded to prevent concurrent restart race conditions.
-     */
-    private restartTransport;
-    /**
-     * Send IPC message to child process.
-     */
-    private sendToChild;
-    /**
-     * Setup Agent crash recovery.
-     */
-    private setupAgentCrashRecovery;
-    /**
-     * Setup runtime message handlers for Agent process.
-     * Handles IPC messages that arrive during normal operation (not just startup).
-     *
-     * IMPORTANT: Uses stored handler reference to prevent listener accumulation.
-     * Each respawn calls this method, so we must remove the old listener first.
-     */
-    private setupAgentRuntimeHandlers;
-    /**
-     * Setup Transport crash recovery.
-     */
-    private setupTransportCrashRecovery;
-    /**
-     * Setup runtime message handlers for Transport process.
-     * Handles IPC messages that arrive during normal operation (pong for health check).
-     *
-     * IMPORTANT: Uses stored handler reference to prevent listener accumulation.
-     * Each respawn calls this method, so we must remove the old listener first.
-     */
-    private setupTransportRuntimeHandlers;
-    /**
-     * Start Agent Process.
-     */
-    private startAgentProcess;
-    /**
-     * Start health check interval for sleep/wake detection.
-     * Detects system sleep by monitoring for large time gaps between checks.
-     */
-    private startHealthCheck;
-    /**
-     * Start periodic health check for Transport and Agent.
-     * Runs every 30s to detect zombie processes mid-session (not just after wake).
-     */
-    private startPeriodicHealthCheck;
-    /**
-     * Start Transport Process.
-     * @returns The port Transport is listening on
-     */
-    private startTransportProcess;
-    /**
-     * Stop Agent Process.
-     */
-    private stopAgentProcess;
-    /**
-     * Stop health check interval.
-     */
-    private stopHealthCheck;
-    /**
-     * Stop periodic health check interval.
-     * Also clears any pending agent health check timeout.
-     */
-    private stopPeriodicHealthCheck;
-    /**
-     * Stop Transport Process.
-     */
-    private stopTransportProcess;
-}
-/**
- * Get or create the ProcessManager singleton.
- */
-export declare function getProcessManager(config?: ProcessManagerConfig): ProcessManager;
-/**
- * Dispose the ProcessManager singleton.
- */
-export declare function disposeProcessManager(): Promise<void>;