@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/index.js

@@ -0,0 +1,357 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI Entry Point for openchrome
+ * MCP Server for parallel Claude Code browser sessions
+ *
+ * Uses puppeteer-core to directly connect to Chrome DevTools Protocol,
+ * enabling multiple Claude Code sessions to control Chrome simultaneously.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const mcp_server_1 = require("./mcp-server");
+const tools_1 = require("./tools");
+const global_1 = require("./config/global");
+const pid_manager_1 = require("./utils/pid-manager");
+const version_1 = require("./version");
+// Prevent silent crashes from unhandled promise rejections in background tasks
+process.on('unhandledRejection', (reason) => {
+    console.error('[openchrome] Unhandled promise rejection:', reason);
+});
+process.on('uncaughtException', (error) => {
+    console.error('[openchrome] Uncaught exception:', error);
+    process.exit(1);
+});
+const program = new commander_1.Command();
+program
+    .name('openchrome')
+    .description('MCP server for parallel Claude Code browser sessions')
+    .version((0, version_1.getVersion)());
+program
+    .command('serve')
+    .description('Start the MCP server')
+    .option('-p, --port <port>', 'Chrome remote debugging port', '9222')
+    .option('--auto-launch', 'Auto-launch Chrome if not running (default: false)')
+    .option('--user-data-dir <dir>', 'Chrome user data directory (default: real Chrome profile on macOS)')
+    .option('--profile-directory <name>', 'Chrome profile directory name (e.g., "Profile 1", "Default")')
+    .option('--chrome-binary <path>', 'Path to Chrome binary (e.g., chrome-headless-shell)')
+    .option('--headless-shell', 'Use chrome-headless-shell if available (default: false)')
+    .option('--visible', 'Show Chrome window (default: headless when auto-launch)')
+    .option('--restart-chrome', 'Quit running Chrome to reuse real profile (default: uses temp profile)')
+    .option('--hybrid', 'Enable hybrid mode (Lightpanda + Chrome routing)')
+    .option('--lp-port <port>', 'Lightpanda debugging port (default: 9223)', '9223')
+    .option('--blocked-domains <domains>', 'Comma-separated list of blocked domains (e.g., "*.bank.com,mail.google.com")')
+    .option('--audit-log', 'Enable security audit logging (default: false)')
+    .option('--all-tools', 'Expose all tools from startup (bypass progressive disclosure)')
+    .option('--server-mode', 'Server/headless mode: auto-launch headless Chrome, skip cookie bridge')
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    let autoLaunch = options.autoLaunch || false;
+    // Server mode forces headless + auto-launch + no cookie bridge
+    if (options.serverMode) {
+        autoLaunch = true;
+        if (options.visible) {
+            console.error('[openchrome] Warning: --visible ignored in server mode (headless forced)');
+        }
+        options.visible = false;
+        console.error('[openchrome] Server mode: enabled (headless, no cookie bridge)');
+    }
+    const userDataDir = options.userDataDir || process.env.CHROME_USER_DATA_DIR || undefined;
+    const profileDirectory = options.profileDirectory || process.env.CHROME_PROFILE_DIRECTORY || undefined;
+    const chromeBinary = options.chromeBinary || process.env.CHROME_BINARY || undefined;
+    const useHeadlessShell = options.headlessShell || false;
+    const restartChrome = options.restartChrome || false;
+    console.error(`[openchrome] Starting MCP server`);
+    console.error(`[openchrome] Chrome debugging port: ${port}`);
+    console.error(`[openchrome] Auto-launch Chrome: ${autoLaunch}`);
+    if (userDataDir) {
+        console.error(`[openchrome] User data dir: ${userDataDir}`);
+    }
+    if (profileDirectory) {
+        console.error(`[openchrome] Profile directory: ${profileDirectory}`);
+    }
+    if (chromeBinary) {
+        console.error(`[openchrome] Chrome binary: ${chromeBinary}`);
+    }
+    if (useHeadlessShell) {
+        console.error(`[openchrome] Using headless-shell mode`);
+    }
+    // Headless by default when auto-launching, unless --visible is specified
+    const headless = autoLaunch && !options.visible;
+    if (autoLaunch) {
+        console.error(`[openchrome] Headless mode: ${headless}`);
+    }
+    // Set global config before initializing anything
+    (0, global_1.setGlobalConfig)({ port, autoLaunch, userDataDir, profileDirectory, chromeBinary, useHeadlessShell, headless, restartChrome });
+    if (restartChrome) {
+        console.error(`[openchrome] Restart Chrome mode: enabled (will quit existing Chrome)`);
+    }
+    // Apply server mode config (skip cookie bridge)
+    if (options.serverMode) {
+        (0, global_1.setGlobalConfig)({ skipCookieBridge: true });
+    }
+    // Configure hybrid mode if enabled
+    const hybrid = options.hybrid || false;
+    const lpPort = parseInt(options.lpPort || '9223', 10);
+    if (hybrid) {
+        (0, global_1.setGlobalConfig)({
+            hybrid: {
+                enabled: true,
+                lightpandaPort: lpPort,
+            },
+        });
+        console.error(`[openchrome] Hybrid mode: enabled`);
+        console.error(`[openchrome] Lightpanda port: ${lpPort}`);
+    }
+    // Configure domain blocklist if provided
+    if (options.blockedDomains) {
+        const blockedList = options.blockedDomains.split(',').map((d) => d.trim()).filter(Boolean);
+        const existing = (0, global_1.getGlobalConfig)().security || {};
+        (0, global_1.setGlobalConfig)({
+            security: { ...existing, blocked_domains: blockedList },
+        });
+        console.error(`[openchrome] Blocked domains: ${blockedList.join(', ')}`);
+    }
+    // Configure audit logging if enabled
+    if (options.auditLog) {
+        const existing = (0, global_1.getGlobalConfig)().security || {};
+        (0, global_1.setGlobalConfig)({
+            security: { ...existing, audit_log: true },
+        });
+        console.error('[openchrome] Audit logging: enabled');
+    }
+    // Tool tier configuration
+    const envTier = parseInt(process.env.OPENCHROME_TOOL_TIER || '', 10);
+    if (options.allTools || envTier >= 3) {
+        (0, mcp_server_1.setMCPServerOptions)({ initialToolTier: 3 });
+        console.error('[openchrome] All tools exposed from startup');
+    }
+    else if (envTier === 2) {
+        (0, mcp_server_1.setMCPServerOptions)({ initialToolTier: 2 });
+        console.error('[openchrome] Tier 2 tools exposed from startup');
+    }
+    const server = (0, mcp_server_1.getMCPServer)();
+    (0, tools_1.registerAllTools)(server);
+    // Write PID file for zombie process detection
+    (0, pid_manager_1.writePidFile)(port);
+    // Register signal handlers for graceful shutdown
+    const shutdown = async (signal) => {
+        console.error(`[openchrome] Received ${signal}, shutting down...`);
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    // Windows: closing the console window sends CTRL_CLOSE_EVENT mapped to SIGHUP by libuv.
+    // Node.js will be force-killed by Windows ~5-10s later; shutdown() is best-effort.
+    if (process.platform === 'win32') {
+        process.on('SIGHUP', () => shutdown('SIGHUP'));
+    }
+    server.start();
+});
+program
+    .command('check')
+    .description('Check Chrome connection status')
+    .option('-p, --port <port>', 'Chrome remote debugging port', '9222')
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    console.log('=== OpenChrome Status ===\n');
+    // Check Chrome
+    let chromeConnected = false;
+    try {
+        const response = await fetch(`http://localhost:${port}/json/version`);
+        const data = (await response.json());
+        console.log(`Chrome (port ${port}): ✓ Connected`);
+        console.log(`  Browser: ${data.Browser}`);
+        console.log(`  WebSocket: ${data.webSocketDebuggerUrl}`);
+        chromeConnected = true;
+    }
+    catch (error) {
+        console.log(`Chrome (port ${port}): ✗ Not connected`);
+    }
+    console.log('\n=== Instructions ===\n');
+    if (!chromeConnected) {
+        console.log('Start Chrome with debugging enabled:');
+        console.log(`  chrome --remote-debugging-port=${port}\n`);
+        console.log('Or let openchrome auto-launch Chrome.\n');
+    }
+    if (chromeConnected) {
+        console.log('Chrome is ready! Add to your Claude Code MCP config:\n');
+        console.log(JSON.stringify({
+            "mcpServers": {
+                "openchrome": {
+                    "command": "openchrome",
+                    "args": ["serve"]
+                }
+            }
+        }, null, 2));
+    }
+    process.exit(chromeConnected ? 0 : 1);
+});
+program
+    .command('verify')
+    .description('Verify performance optimizations are working')
+    .option('-p, --port <port>', 'Chrome remote debugging port', '9222')
+    .action(async (options) => {
+    const port = parseInt(options.port, 10);
+    console.log('=== OpenChrome - Optimization Verification ===\n');
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    // 1. Check Chrome connection
+    try {
+        const response = await fetch(`http://localhost:${port}/json/version`);
+        const data = await response.json();
+        console.log(`✓ Chrome connected: ${data.Browser}`);
+        passed++;
+    }
+    catch {
+        console.log('✗ Chrome not connected - start Chrome with --remote-debugging-port=' + port);
+        console.log('\nCannot proceed without Chrome. Exiting.\n');
+        process.exit(1);
+    }
+    // 2. Verify launch flags (check Chrome command line)
+    try {
+        const response = await fetch(`http://localhost:${port}/json/version`);
+        const versionData = await response.json();
+        // Check if we launched Chrome (not user's existing instance)
+        const commandLine = versionData['Protocol-Version'] ? 'available' : 'unknown';
+        console.log(`✓ Chrome DevTools Protocol: ${commandLine}`);
+        passed++;
+    }
+    catch {
+        console.log('⚠ Could not verify protocol version');
+        skipped++;
+    }
+    // 3. Verify WebP screenshot support
+    try {
+        // Import dynamically to avoid loading everything
+        const puppeteer = require('puppeteer-core');
+        const browser = await puppeteer.connect({
+            browserURL: `http://localhost:${port}`,
+            defaultViewport: null,
+        });
+        const page = await browser.newPage();
+        await page.goto('about:blank');
+        // Test WebP screenshot
+        const webpBuffer = await page.screenshot({ type: 'webp', quality: 80, encoding: 'base64' });
+        const pngBuffer = await page.screenshot({ type: 'png', encoding: 'base64' });
+        const webpSize = webpBuffer.length;
+        const pngSize = pngBuffer.length;
+        const ratio = (pngSize / webpSize).toFixed(1);
+        console.log(`✓ WebP screenshots: ${ratio}x smaller (WebP: ${(webpSize / 1024).toFixed(1)}KB vs PNG: ${(pngSize / 1024).toFixed(1)}KB)`);
+        passed++;
+        // 4. Verify GC command support
+        try {
+            const client = await page.createCDPSession();
+            await client.send('HeapProfiler.collectGarbage');
+            console.log('✓ Forced GC (HeapProfiler.collectGarbage): supported');
+            passed++;
+            await client.detach();
+        }
+        catch {
+            console.log('⚠ Forced GC: not supported by this Chrome version');
+            skipped++;
+        }
+        // 5. Verify page creation speed (simulates pool benefit)
+        const startTime = Date.now();
+        const testPage = await browser.newPage();
+        const createTime = Date.now() - startTime;
+        await testPage.close();
+        console.log(`✓ Page creation: ${createTime}ms`);
+        passed++;
+        // 6. Check memory stats
+        try {
+            const response = await fetch(`http://localhost:${port}/json`);
+            const targets = await response.json();
+            const pageCount = targets.filter((t) => t.type === 'page').length;
+            console.log(`✓ Active targets: ${pageCount} pages`);
+            passed++;
+        }
+        catch {
+            console.log('⚠ Could not check active targets');
+            skipped++;
+        }
+        await page.close();
+        browser.disconnect();
+    }
+    catch (error) {
+        console.log(`✗ Browser verification failed: ${error instanceof Error ? error.message : String(error)}`);
+        failed++;
+    }
+    // Summary
+    console.log(`\n=== Results: ${passed} passed, ${failed} failed, ${skipped} skipped ===`);
+    if (failed === 0) {
+        console.log('\nAll optimizations verified! Performance features are active.\n');
+        console.log('Optimization summary:');
+        console.log('  • WebP screenshots (3-5x smaller)');
+        console.log('  • Cookie bridge caching (30s TTL)');
+        console.log('  • Forced GC on tab close');
+        console.log('  • Memory-saving Chrome flags');
+        console.log('  • Find tool batched CDP calls');
+        console.log('  • Connection pool (pre-warmed pages)');
+    }
+    process.exit(failed > 0 ? 1 : 0);
+});
+program
+    .command('info')
+    .description('Show how it works')
+    .action(() => {
+    console.log(`
+=== OpenChrome ===
+
+Enables multiple Claude Code sessions to control Chrome simultaneously
+without "Detached" errors.
+
+HOW IT WORKS:
+
+  Claude Code 1 ──► puppeteer process 1 ──► CDP connection 1 ──┐
+                                                                ├──► Chrome
+  Claude Code 2 ──► puppeteer process 2 ──► CDP connection 2 ──┘
+
+  Each Claude Code session gets its own:
+  - Independent MCP server process
+  - Separate Chrome DevTools Protocol connection
+  - Isolated browser tabs
+
+WHY NO "DETACHED" ERRORS:
+
+  Unlike the Chrome extension (which shares state),
+  each puppeteer-core process maintains its own CDP connection.
+  Chrome handles multiple CDP connections natively.
+
+TESTED CONCURRENCY:
+
+  ✓ 20+ simultaneous sessions confirmed working
+
+USAGE:
+
+  # Check Chrome status
+  openchrome check
+
+  # Start Chrome with debugging enabled (required unless --auto-launch)
+  chrome --remote-debugging-port=9222
+
+  # Add to ~/.claude/.mcp.json
+  {
+    "mcpServers": {
+      "openchrome": {
+        "command": "openchrome",
+        "args": ["serve"]
+      }
+    }
+  }
+
+  # Or with auto-launch (Chrome starts automatically)
+  {
+    "mcpServers": {
+      "openchrome": {
+        "command": "openchrome",
+        "args": ["serve", "--auto-launch"]
+      }
+    }
+  }
+`);
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lightpanda/launcher.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Lightpanda Launcher - Manages the Lightpanda browser process lifecycle
+ */
+import type { Browser } from 'puppeteer-core';
+export interface LightpandaLauncherConfig {
+    port: number;
+    binaryPath?: string;
+    startupTimeoutMs?: number;
+    healthCheckIntervalMs?: number;
+}
+export declare class LightpandaLauncher {
+    private process;
+    private port;
+    private binaryPath;
+    private startupTimeoutMs;
+    private healthCheckIntervalMs;
+    private _isRunning;
+    private browser;
+    constructor(config: LightpandaLauncherConfig);
+    /**
+     * Start Lightpanda process on the configured port
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Lightpanda process
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if Lightpanda is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the port Lightpanda is running on
+     */
+    getPort(): number;
+    /**
+     * Connect via puppeteer-core and return Browser instance
+     */
+    connect(): Promise<Browser>;
+    /**
+     * Disconnect browser (without stopping process)
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get the connected browser instance
+     */
+    getBrowser(): Browser | null;
+    /**
+     * Health check - verify Lightpanda is responsive
+     */
+    private healthCheck;
+    /**
+     * Wait for Lightpanda to become ready using setInterval-based polling.
+     * Compatible with jest fake timers.
+     */
+    private waitForReady;
+}
+//# sourceMappingURL=launcher.d.ts.map

package/dist/lightpanda/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/lightpanda/launcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,EAAE,wBAAwB;IAO5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAOjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;OAEG;YACW,WAAW;IASzB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAoCrB"}

package/dist/lightpanda/launcher.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Lightpanda Launcher - Manages the Lightpanda browser process lifecycle
+ */
+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.LightpandaLauncher = void 0;
+const child_process_1 = require("child_process");
+const puppeteer = __importStar(require("puppeteer-core"));
+class LightpandaLauncher {
+    process = null;
+    port;
+    binaryPath;
+    startupTimeoutMs;
+    healthCheckIntervalMs;
+    _isRunning = false;
+    browser = null;
+    constructor(config) {
+        this.port = config.port;
+        this.binaryPath = config.binaryPath ?? (process.platform === 'win32' ? 'lightpanda.exe' : 'lightpanda');
+        this.startupTimeoutMs = config.startupTimeoutMs ?? 10000;
+        this.healthCheckIntervalMs = config.healthCheckIntervalMs ?? 500;
+    }
+    /**
+     * Start Lightpanda process on the configured port
+     */
+    async start() {
+        if (this._isRunning) {
+            return;
+        }
+        this.process = (0, child_process_1.spawn)(this.binaryPath, ['--port', String(this.port)], {
+            stdio: ['ignore', 'ignore', 'ignore'],
+            shell: process.platform === 'win32',
+        });
+        this.process.on('exit', () => {
+            this._isRunning = false;
+            this.process = null;
+        });
+        await this.waitForReady();
+        this._isRunning = true;
+    }
+    /**
+     * Stop the Lightpanda process
+     */
+    async stop() {
+        if (!this.process || !this._isRunning) {
+            this._isRunning = false;
+            this.process = null;
+            return;
+        }
+        const proc = this.process;
+        this._isRunning = false;
+        this.process = null;
+        await new Promise((resolve) => {
+            const killTimer = setTimeout(() => {
+                try {
+                    // On Windows, SIGKILL is not supported; use default kill (TerminateProcess)
+                    if (process.platform === 'win32') {
+                        proc.kill();
+                    }
+                    else {
+                        proc.kill('SIGKILL');
+                    }
+                }
+                catch {
+                    // ignore
+                }
+                resolve();
+            }, 5000);
+            proc.once('exit', () => {
+                clearTimeout(killTimer);
+                resolve();
+            });
+            try {
+                // On Windows, SIGTERM is not supported; use default kill which calls TerminateProcess
+                if (process.platform === 'win32') {
+                    proc.kill();
+                }
+                else {
+                    proc.kill('SIGTERM');
+                }
+            }
+            catch {
+                clearTimeout(killTimer);
+                resolve();
+            }
+        });
+    }
+    /**
+     * Check if Lightpanda is running
+     */
+    isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Get the port Lightpanda is running on
+     */
+    getPort() {
+        return this.port;
+    }
+    /**
+     * Connect via puppeteer-core and return Browser instance
+     */
+    async connect() {
+        this.browser = await puppeteer.connect({
+            browserWSEndpoint: `ws://localhost:${this.port}`,
+        });
+        return this.browser;
+    }
+    /**
+     * Disconnect browser (without stopping process)
+     */
+    async disconnect() {
+        if (this.browser) {
+            await this.browser.disconnect();
+            this.browser = null;
+        }
+    }
+    /**
+     * Get the connected browser instance
+     */
+    getBrowser() {
+        return this.browser;
+    }
+    /**
+     * Health check - verify Lightpanda is responsive
+     */
+    async healthCheck() {
+        try {
+            await fetch(`http://localhost:${this.port}/json/version`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Wait for Lightpanda to become ready using setInterval-based polling.
+     * Compatible with jest fake timers.
+     */
+    waitForReady() {
+        return new Promise((resolve, reject) => {
+            const startTime = Date.now();
+            let settled = false;
+            const intervalId = setInterval(() => {
+                if (settled)
+                    return;
+                if (Date.now() - startTime >= this.startupTimeoutMs) {
+                    settled = true;
+                    clearInterval(intervalId);
+                    reject(new Error(`Lightpanda not ready: timed out after ${this.startupTimeoutMs}ms`));
+                    return;
+                }
+                this.healthCheck().then((ok) => {
+                    if (settled)
+                        return;
+                    if (ok) {
+                        settled = true;
+                        clearInterval(intervalId);
+                        resolve();
+                    }
+                });
+            }, this.healthCheckIntervalMs);
+            // Also check immediately (before first interval fires)
+            this.healthCheck().then((ok) => {
+                if (settled)
+                    return;
+                if (ok) {
+                    settled = true;
+                    clearInterval(intervalId);
+                    resolve();
+                }
+            });
+        });
+    }
+}
+exports.LightpandaLauncher = LightpandaLauncher;
+//# sourceMappingURL=launcher.js.map

package/dist/lightpanda/launcher.js.map

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