openchrome-mcp 1.9.0 → 1.9.2

package/dist/desktop/sidecar-manager.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Sidecar Manager — manages a Node.js child process sidecar with crash recovery.
+ * Detects crashes via process exit event, auto-restarts up to maxCrashes times
+ * within a sliding window, and handles port conflicts via auto-increment.
+ * Part of #524: Desktop App error handling + local fallback + CLI coexistence.
+ */
+import { EventEmitter } from 'events';
+export interface SidecarOptions {
+    /** Executable command, e.g. 'node' */
+    command: string;
+    /** Arguments, e.g. ['dist/index.js', 'serve'] */
+    args: string[];
+    /** Base port for the sidecar server. Default: 3100 */
+    basePort?: number;
+    /** Maximum crash count before giving up. Default: 3 */
+    maxCrashes?: number;
+    /** Sliding window in ms to count crashes. Default: 300000 (5 min) */
+    crashWindowMs?: number;
+    /** Additional environment variables for the child process */
+    env?: Record<string, string>;
+}
+export type SidecarStatus = 'stopped' | 'starting' | 'running' | 'restarting' | 'crashed' | 'exhausted';
+export interface SidecarState {
+    status: SidecarStatus;
+    pid: number | null;
+    port: number;
+    crashCount: number;
+    lastError: string | null;
+    /** Milliseconds since last successful start, or 0 if not started */
+    uptime: number;
+}
+/**
+ * SidecarManager events:
+ *
+ * 'started'      → { pid: number | undefined, port: number }
+ * 'restarting'   → { crashCount: number, reason: string }
+ * 'running'      → { pid: number | undefined, port: number }
+ * 'crashed'      → { reason: string, crashCount: number }
+ * 'exhausted'    → { crashCount: number, message: string }
+ * 'port-changed' → { oldPort: number, newPort: number }
+ * 'stderr'       → { data: string }
+ */
+export declare class SidecarManager extends EventEmitter {
+    private readonly options;
+    private child;
+    private status;
+    private currentPort;
+    private crashTimestamps;
+    private lastError;
+    private startedAt;
+    private intentionalStop;
+    private stderrLines;
+    private readonly maxStderrLines;
+    /** SIGKILL delay after SIGTERM in milliseconds */
+    private readonly killTimeoutMs;
+    constructor(options: SidecarOptions);
+    /**
+     * Start the sidecar child process.
+     * Idempotent: no-op if already starting or running.
+     */
+    start(): void;
+    /**
+     * Stop the sidecar gracefully.
+     * Sends SIGTERM, then SIGKILL after killTimeoutMs if still alive.
+     */
+    stop(): Promise<void>;
+    /**
+     * Returns current sidecar state snapshot.
+     */
+    getState(): SidecarState;
+    /**
+     * Returns last N lines of captured stderr output.
+     */
+    getStderrLog(lines?: number): string[];
+    private _spawn;
+    private _handleCrash;
+    private _killChild;
+    private _appendStderr;
+}
+//# sourceMappingURL=sidecar-manager.d.ts.map

package/dist/desktop/sidecar-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-manager.d.ts","sourceRoot":"","sources":["../../src/desktop/sidecar-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAExG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;IAEtC,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAE1B,OAAO,EAAE,cAAc;IAanC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAWxB;;OAEG;IACH,YAAY,CAAC,KAAK,SAAM,GAAG,MAAM,EAAE;IAMnC,OAAO,CAAC,MAAM;IAoEd,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,UAAU;IA2ClB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/desktop/sidecar-manager.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Sidecar Manager — manages a Node.js child process sidecar with crash recovery.
+ * Detects crashes via process exit event, auto-restarts up to maxCrashes times
+ * within a sliding window, and handles port conflicts via auto-increment.
+ * Part of #524: Desktop App error handling + local fallback + CLI coexistence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SidecarManager = void 0;
+const events_1 = require("events");
+const child_process_1 = require("child_process");
+/**
+ * SidecarManager events:
+ *
+ * 'started'      → { pid: number | undefined, port: number }
+ * 'restarting'   → { crashCount: number, reason: string }
+ * 'running'      → { pid: number | undefined, port: number }
+ * 'crashed'      → { reason: string, crashCount: number }
+ * 'exhausted'    → { crashCount: number, message: string }
+ * 'port-changed' → { oldPort: number, newPort: number }
+ * 'stderr'       → { data: string }
+ */
+class SidecarManager extends events_1.EventEmitter {
+    options;
+    child = null;
+    status = 'stopped';
+    currentPort;
+    crashTimestamps = [];
+    lastError = null;
+    startedAt = null;
+    intentionalStop = false;
+    stderrLines = [];
+    maxStderrLines = 500;
+    /** SIGKILL delay after SIGTERM in milliseconds */
+    killTimeoutMs = 5000;
+    constructor(options) {
+        super();
+        this.options = {
+            command: options.command,
+            args: options.args,
+            basePort: options.basePort ?? 3100,
+            maxCrashes: options.maxCrashes ?? 3,
+            crashWindowMs: options.crashWindowMs ?? 300000,
+            env: options.env,
+        };
+        this.currentPort = this.options.basePort;
+    }
+    /**
+     * Start the sidecar child process.
+     * Idempotent: no-op if already starting or running.
+     */
+    start() {
+        if (this.status === 'starting' || this.status === 'running') {
+            return;
+        }
+        this.intentionalStop = false;
+        this._spawn();
+    }
+    /**
+     * Stop the sidecar gracefully.
+     * Sends SIGTERM, then SIGKILL after killTimeoutMs if still alive.
+     */
+    stop() {
+        this.intentionalStop = true;
+        return this._killChild();
+    }
+    /**
+     * Returns current sidecar state snapshot.
+     */
+    getState() {
+        return {
+            status: this.status,
+            pid: this.child?.pid ?? null,
+            port: this.currentPort,
+            crashCount: this.crashTimestamps.length,
+            lastError: this.lastError,
+            uptime: this.startedAt !== null ? Date.now() - this.startedAt : 0,
+        };
+    }
+    /**
+     * Returns last N lines of captured stderr output.
+     */
+    getStderrLog(lines = 100) {
+        return this.stderrLines.slice(-lines);
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────────
+    _spawn() {
+        this.status = 'starting';
+        this.startedAt = null;
+        const env = {
+            ...process.env,
+            ...this.options.env,
+            PORT: String(this.currentPort),
+        };
+        let child;
+        try {
+            child = (0, child_process_1.spawn)(this.options.command, this.options.args, {
+                env,
+                stdio: ['ignore', 'ignore', 'pipe'],
+            });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            this._handleCrash(reason);
+            return;
+        }
+        // Guard: if spawn returns a non-process object (e.g. in tests when mock is exhausted)
+        if (!child || typeof child.on !== 'function') {
+            this._handleCrash('spawn returned invalid process');
+            return;
+        }
+        this.child = child;
+        this.startedAt = Date.now();
+        this.status = 'running';
+        // Capture stderr BEFORE emitting events so that listeners attached in tests
+        // see a fully-initialized state.
+        if (child.stderr) {
+            child.stderr.setEncoding('utf8');
+            child.stderr.on('data', (data) => {
+                this._appendStderr(data);
+                this.emit('stderr', { data });
+            });
+        }
+        // Register exit/error handlers before emitting 'started'/'running' so
+        // synchronous crashes in tests are handled correctly.
+        child.on('exit', (code, signal) => {
+            if (this.intentionalStop) {
+                this.status = 'stopped';
+                this.child = null;
+                return;
+            }
+            const reason = signal
+                ? `killed by signal ${signal}`
+                : `exited with code ${code ?? 'unknown'}`;
+            this._handleCrash(reason);
+        });
+        child.on('error', (err) => {
+            if (!this.intentionalStop) {
+                this._handleCrash(err.message);
+            }
+        });
+        this.emit('started', { pid: child.pid, port: this.currentPort });
+        this.emit('running', { pid: child.pid, port: this.currentPort });
+    }
+    _handleCrash(reason) {
+        this.lastError = reason;
+        this.child = null;
+        const now = Date.now();
+        // Evict timestamps outside the sliding window
+        this.crashTimestamps = this.crashTimestamps.filter((ts) => now - ts < this.options.crashWindowMs);
+        this.crashTimestamps.push(now);
+        const crashCount = this.crashTimestamps.length;
+        this.status = 'crashed';
+        console.error(`[SidecarManager] Sidecar crashed (${crashCount}/${this.options.maxCrashes}): ${reason}`);
+        this.emit('crashed', { reason, crashCount });
+        if (crashCount >= this.options.maxCrashes) {
+            this.status = 'exhausted';
+            console.error('[SidecarManager] Crash limit reached — giving up');
+            this.emit('exhausted', { crashCount, message: 'Server keeps crashing' });
+            return;
+        }
+        // Check if recent stderr suggests port conflict
+        const recentStderr = this.stderrLines.slice(-20).join('\n');
+        if (recentStderr.includes('EADDRINUSE')) {
+            const oldPort = this.currentPort;
+            this.currentPort = oldPort + 1;
+            console.error(`[SidecarManager] Port ${oldPort} in use, incrementing to ${this.currentPort}`);
+            this.emit('port-changed', { oldPort, newPort: this.currentPort });
+        }
+        this.status = 'restarting';
+        this.emit('restarting', { crashCount, reason });
+        this._spawn();
+    }
+    _killChild() {
+        const child = this.child;
+        this.child = null;
+        if (!child || child.exitCode !== null) {
+            this.status = 'stopped';
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            let killTimer = null;
+            const onExit = () => {
+                if (killTimer)
+                    clearTimeout(killTimer);
+                this.status = 'stopped';
+                resolve();
+            };
+            child.once('exit', onExit);
+            try {
+                child.kill('SIGTERM');
+            }
+            catch {
+                // Already dead — proceed to cleanup
+                onExit();
+                return;
+            }
+            killTimer = setTimeout(() => {
+                child.removeListener('exit', onExit);
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    // Already dead
+                }
+                this.status = 'stopped';
+                resolve();
+            }, this.killTimeoutMs);
+            if (killTimer.unref)
+                killTimer.unref();
+        });
+    }
+    _appendStderr(data) {
+        const lines = data.split('\n');
+        this.stderrLines.push(...lines);
+        if (this.stderrLines.length > this.maxStderrLines) {
+            this.stderrLines = this.stderrLines.slice(-this.maxStderrLines);
+        }
+    }
+}
+exports.SidecarManager = SidecarManager;
+//# sourceMappingURL=sidecar-manager.js.map

package/dist/desktop/sidecar-manager.js.map

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

package/dist/desktop/tunnel-failure-handler.d.ts

@@ -0,0 +1,56 @@
+/**
+ * TunnelFailureHandler — classifies cloudflared failures, manages retries,
+ * and falls back to local-only mode after max retries are exceeded.
+ * Part of #524 Error handling + local fallback + CLI coexistence.
+ */
+import { EventEmitter } from 'events';
+export type TunnelFailureReason = 'process_crash' | 'network_disconnect' | 'firewall_block' | 'timeout' | 'dns_failure' | 'unknown';
+export type TunnelMode = 'tunnel' | 'local-only' | 'reconnecting';
+export interface TunnelFailureEvent {
+    reason: TunnelFailureReason;
+    message: string;
+    suggestion: string;
+    canRetry: boolean;
+    timestamp: number;
+}
+export declare class TunnelFailureHandler extends EventEmitter {
+    private mode;
+    private consecutiveFailures;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private retryTimer;
+    /**
+     * Detect failure reason from cloudflared stderr output and process exit code.
+     */
+    classifyFailure(exitCode: number | null, stderr: string): TunnelFailureReason;
+    /**
+     * Handle a tunnel failure: increment counter, emit events, manage retries.
+     * Switches to local-only mode after maxRetries consecutive failures.
+     */
+    handleFailure(exitCode: number | null, stderr: string): TunnelFailureEvent;
+    /**
+     * Get plain-language message for a failure reason (no technical jargon).
+     */
+    private getPlainMessage;
+    /**
+     * Get actionable suggestion for a failure reason.
+     */
+    private getSuggestion;
+    /**
+     * Switch to local-only mode after max retries exceeded.
+     */
+    private fallbackToLocalOnly;
+    /**
+     * Reset failure counter and mode when tunnel is successfully restored.
+     */
+    resetOnSuccess(): void;
+    /**
+     * Get the current tunnel mode.
+     */
+    getMode(): TunnelMode;
+    /**
+     * Clean up timers and remove all listeners.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=tunnel-failure-handler.d.ts.map

package/dist/desktop/tunnel-failure-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-failure-handler.d.ts","sourceRoot":"","sources":["../../src/desktop/tunnel-failure-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,oBAAoB,GACpB,gBAAgB,GAChB,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,UAAU,CAA+B;IAEjD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB;IA0B7E;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAmC1E;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,cAAc,IAAI,IAAI;IAiBtB;;OAEG;IACH,OAAO,IAAI,UAAU;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/desktop/tunnel-failure-handler.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * TunnelFailureHandler — classifies cloudflared failures, manages retries,
+ * and falls back to local-only mode after max retries are exceeded.
+ * Part of #524 Error handling + local fallback + CLI coexistence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TunnelFailureHandler = void 0;
+const events_1 = require("events");
+class TunnelFailureHandler extends events_1.EventEmitter {
+    mode = 'tunnel';
+    consecutiveFailures = 0;
+    maxRetries = 3;
+    retryDelayMs = 10000;
+    retryTimer = null;
+    /**
+     * Detect failure reason from cloudflared stderr output and process exit code.
+     */
+    classifyFailure(exitCode, stderr) {
+        const lower = stderr.toLowerCase();
+        if (lower.includes('connection refused') || lower.includes('econnrefused')) {
+            return 'network_disconnect';
+        }
+        if (lower.includes('permission denied') || lower.includes('eacces')) {
+            return 'firewall_block';
+        }
+        if (lower.includes('dns') || lower.includes('resolve')) {
+            return 'dns_failure';
+        }
+        if (exitCode === null) {
+            return 'timeout';
+        }
+        if (exitCode === 1) {
+            return 'process_crash';
+        }
+        return 'unknown';
+    }
+    /**
+     * Handle a tunnel failure: increment counter, emit events, manage retries.
+     * Switches to local-only mode after maxRetries consecutive failures.
+     */
+    handleFailure(exitCode, stderr) {
+        const reason = this.classifyFailure(exitCode, stderr);
+        this.consecutiveFailures++;
+        const event = {
+            reason,
+            message: this.getPlainMessage(reason),
+            suggestion: this.getSuggestion(reason),
+            canRetry: this.consecutiveFailures < this.maxRetries,
+            timestamp: Date.now(),
+        };
+        this.emit('tunnel-failure', event);
+        if (this.consecutiveFailures < this.maxRetries) {
+            this.mode = 'reconnecting';
+            this.emit('tunnel-reconnecting', { attempt: this.consecutiveFailures, delayMs: this.retryDelayMs });
+            if (this.retryTimer) {
+                clearTimeout(this.retryTimer);
+            }
+            // Backoff delay — callers should listen to 'tunnel-reconnecting' and re-attempt
+            // connection after the delay expires. The timer itself only resets state.
+            this.retryTimer = setTimeout(() => {
+                this.retryTimer = null;
+                this.emit('tunnel-retry-ready', { attempt: this.consecutiveFailures });
+            }, this.retryDelayMs);
+            this.retryTimer.unref();
+        }
+        else {
+            this.fallbackToLocalOnly();
+        }
+        return event;
+    }
+    /**
+     * Get plain-language message for a failure reason (no technical jargon).
+     */
+    getPlainMessage(reason) {
+        switch (reason) {
+            case 'process_crash':
+                return 'The secure connection stopped unexpectedly';
+            case 'network_disconnect':
+                return 'Your internet connection appears to be down';
+            case 'firewall_block':
+                return 'Your firewall or antivirus may be blocking the connection';
+            case 'timeout':
+                return 'The connection is taking too long to establish';
+            case 'dns_failure':
+                return 'Unable to reach the connection service';
+            case 'unknown':
+                return 'An unexpected connection error occurred';
+        }
+    }
+    /**
+     * Get actionable suggestion for a failure reason.
+     */
+    getSuggestion(reason) {
+        switch (reason) {
+            case 'process_crash':
+                return 'The app will try to reconnect automatically. If this keeps happening, try restarting the app.';
+            case 'network_disconnect':
+                return 'Check your internet connection and try again.';
+            case 'firewall_block':
+                return 'Check your firewall or antivirus settings and allow this app, then restart.';
+            case 'timeout':
+                return 'Check your internet connection. If the problem persists, try restarting the app.';
+            case 'dns_failure':
+                return 'Check your internet connection or try switching to a different network.';
+            case 'unknown':
+                return 'Try restarting the app. If the problem continues, check your network settings.';
+        }
+    }
+    /**
+     * Switch to local-only mode after max retries exceeded.
+     */
+    fallbackToLocalOnly() {
+        this.mode = 'local-only';
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        this.emit('tunnel-local-only', {
+            consecutiveFailures: this.consecutiveFailures,
+        });
+    }
+    /**
+     * Reset failure counter and mode when tunnel is successfully restored.
+     */
+    resetOnSuccess() {
+        const wasReconnecting = this.mode === 'reconnecting';
+        const wasLocalOnly = this.mode === 'local-only';
+        this.consecutiveFailures = 0;
+        this.mode = 'tunnel';
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        if (wasReconnecting || wasLocalOnly) {
+            this.emit('tunnel-restored');
+        }
+    }
+    /**
+     * Get the current tunnel mode.
+     */
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Clean up timers and remove all listeners.
+     */
+    destroy() {
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        this.removeAllListeners();
+    }
+}
+exports.TunnelFailureHandler = TunnelFailureHandler;
+//# sourceMappingURL=tunnel-failure-handler.js.map

package/dist/desktop/tunnel-failure-handler.js.map

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

package/dist/desktop/tunnel-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tunnel Resilience Manager — manages cloudflared tunnel lifecycle with
+ * auto-reconnect, blip detection, and local-only fallback.
+ * Part of #524 Desktop App: Error handling + local fallback + CLI coexistence.
+ */
+import { EventEmitter } from 'events';
+export type TunnelStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'local-only';
+export interface TunnelOptions {
+    cloudflaredPath?: string;
+    targetPort: number;
+    maxReconnectAttempts?: number;
+    reconnectIntervalMs?: number;
+    blipThresholdMs?: number;
+}
+export interface TunnelState {
+    status: TunnelStatus;
+    tunnelUrl: string | null;
+    reconnectAttempt: number;
+    lastError: string | null;
+    disconnectedAt: number | null;
+    localModeReason: string | null;
+}
+/**
+ * TunnelManager manages the cloudflared tunnel process with:
+ * - Auto-reconnect on crash (up to maxReconnectAttempts)
+ * - Blip detection (transparent for short disconnects)
+ * - Local-only fallback when all reconnects fail
+ * - Antivirus/permission block detection
+ *
+ * Events emitted:
+ * - 'connected'      → { tunnelUrl: string }
+ * - 'disconnected'   → { reason: string }
+ * - 'reconnecting'   → { attempt: number, maxAttempts: number }
+ * - 'reconnected'    → { tunnelUrl: string }
+ * - 'local-only'     → { reason: string, guidance: string }
+ * - 'status-changed' → { oldStatus: TunnelStatus, newStatus: TunnelStatus }
+ * - 'blocked'        → { reason: string, guidance: string }
+ */
+export declare class TunnelManager extends EventEmitter {
+    private readonly options;
+    private process;
+    private state;
+    private intentionalStop;
+    private reconnectTimer;
+    constructor(options: TunnelOptions);
+    /**
+     * Start the tunnel. Finds cloudflared binary and spawns the process.
+     * Resolves once the process is spawned (not once URL is received).
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the tunnel gracefully. Does not trigger reconnect.
+     */
+    stop(): void;
+    /**
+     * Manual retry from local-only mode.
+     */
+    retry(): Promise<void>;
+    /**
+     * Get the current tunnel state snapshot.
+     */
+    getState(): TunnelState;
+    /**
+     * Find the cloudflared binary path.
+     * Checks known install locations and PATH.
+     */
+    findCloudflared(): Promise<string | null>;
+    private _launchTunnel;
+    /**
+     * Synchronously spawn the cloudflared process and register all event handlers.
+     * This is separated from _launchTunnel so handlers are registered in the same
+     * synchronous tick as the spawn call.
+     */
+    private _spawnProcess;
+    private _parseOutput;
+    private _handleSpawnError;
+    private _handleExit;
+    private _scheduleReconnect;
+    private _transitionToLocalOnly;
+    private _isBlip;
+    private _setStatus;
+    private _clearReconnectTimer;
+    private _runCommand;
+}
+//# sourceMappingURL=tunnel-manager.d.ts.map

package/dist/desktop/tunnel-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-manager.d.ts","sourceRoot":"","sources":["../../src/desktop/tunnel-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAEvG,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAA+B;gBAEzC,OAAO,EAAE,aAAa;IAmBlC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAmDjC,aAAa;IAoB3B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,WAAW;CAsBpB"}