pi-browser-use 0.11.6 → 0.11.7

package/dist/chrome-launcher.d.ts

@@ -6,6 +6,7 @@ export interface ChromeLaunchOptions {
     chromeArgs?: string[];
     executablePath?: string;
     readyTimeoutMs?: number;
+    launchAttempts?: number;
     signal?: AbortSignal;
 }
 export interface ChromeProcess {
@@ -28,6 +29,9 @@ export declare function buildChromeArgs(options: {
     headless?: boolean;
     chromeArgs?: string[];
 }): string[];
+export declare class DevToolsReadyTimeoutError extends Error {
+    constructor(browserUrl: string, timeoutMs: number, lastError: unknown);
+}
 export declare function waitForDevToolsEndpoint(port: number, options?: {
     timeoutMs?: number;
     fetchImpl?: typeof fetch;

package/dist/chrome-launcher.js

@@ -1,5 +1,6 @@
 import { execFileSync, spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
+import { once } from 'node:events';
 import { createServer } from 'node:net';
 import { setTimeout as delay } from 'node:timers/promises';
 export function chromeExecutableCandidates() {
@@ -94,6 +95,21 @@ export function buildChromeArgs(options) {
     args.push(...(options.chromeArgs ?? []));
     return args;
 }
+export class DevToolsReadyTimeoutError extends Error {
+    constructor(browserUrl, timeoutMs, lastError) {
+        super(`Timed out waiting for Chrome DevTools on ${browserUrl} after ${timeoutMs}ms (${describeError(lastError)})`);
+        this.name = 'DevToolsReadyTimeoutError';
+    }
+}
+function describeError(error) {
+    if (error instanceof Error) {
+        const cause = error.cause;
+        if (cause instanceof Error && cause.message)
+            return cause.message;
+        return error.message;
+    }
+    return String(error);
+}
 export async function waitForDevToolsEndpoint(port, options) {
     const timeoutMs = options?.timeoutMs ?? 15_000;
     const fetchImpl = options?.fetchImpl ?? fetch;
@@ -118,7 +134,7 @@ export async function waitForDevToolsEndpoint(port, options) {
         }
         await delay(100, undefined, { signal: options?.signal });
     }
-    throw new Error(`Timed out waiting for Chrome DevTools on ${browserUrl} (${lastError instanceof Error ? lastError.message : String(lastError)})`);
+    throw new DevToolsReadyTimeoutError(browserUrl, timeoutMs, lastError);
 }
 class OwnedChromeProcess {
     port;
@@ -168,40 +184,66 @@ class OwnedChromeProcess {
         }
     }
 }
+async function waitReadyWatchingExit(child, port, timeoutMs, signal) {
+    const endpointReady = waitForDevToolsEndpoint(port, { timeoutMs, signal });
+    const exited = once(child, 'exit');
+    exited.catch(() => { });
+    try {
+        await Promise.race([
+            endpointReady,
+            exited.then(([code, exitSignal]) => {
+                const reason = code !== null ? `code ${code}` : `signal ${exitSignal ?? 'unknown'}`;
+                throw new Error(`Chrome exited (${reason}) before the DevTools endpoint on http://127.0.0.1:${port} opened.`);
+            }),
+        ]);
+    }
+    catch (error) {
+        endpointReady.catch(() => { });
+        throw error;
+    }
+}
 export async function launchChrome(options) {
     options.signal?.throwIfAborted();
     const executable = findChromeExecutable(options.executablePath);
-    const port = options.port ?? (await allocateEphemeralPort());
-    const args = buildChromeArgs({
-        userDataDir: options.userDataDir,
-        profileDirectory: options.profileDirectory,
-        port,
-        headless: options.headless,
-        chromeArgs: options.chromeArgs,
-    });
-    const child = spawn(executable, args, { stdio: 'ignore', detached: false });
-    await new Promise((resolve, reject) => {
-        child.on('error', reject);
-        setTimeout(resolve, 50);
-    });
-    if (child.exitCode !== null) {
-        throw new Error(`Chrome exited immediately (code ${child.exitCode}).`);
-    }
-    try {
-        await waitForDevToolsEndpoint(port, {
-            timeoutMs: options.readyTimeoutMs,
-            signal: options.signal,
+    const attempts = Math.max(1, options.launchAttempts ?? 2);
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        options.signal?.throwIfAborted();
+        const port = options.port ?? (await allocateEphemeralPort());
+        const args = buildChromeArgs({
+            userDataDir: options.userDataDir,
+            profileDirectory: options.profileDirectory,
+            port,
+            headless: options.headless,
+            chromeArgs: options.chromeArgs,
         });
-    }
-    catch (error) {
+        const child = spawn(executable, args, { stdio: 'ignore', detached: false });
+        await new Promise((resolve, reject) => {
+            child.on('error', reject);
+            setTimeout(resolve, 50);
+        });
+        if (child.exitCode !== null) {
+            throw new Error(`Chrome exited immediately (code ${child.exitCode}).`);
+        }
         try {
-            child.kill('SIGKILL');
+            await waitReadyWatchingExit(child, port, options.readyTimeoutMs, options.signal);
+            return new OwnedChromeProcess(child, port, `http://127.0.0.1:${port}`, options.userDataDir);
         }
-        catch {
+        catch (error) {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch {
+            }
+            lastError = error;
+            if (!(error instanceof DevToolsReadyTimeoutError))
+                throw error;
         }
-        throw error;
     }
-    return new OwnedChromeProcess(child, port, `http://127.0.0.1:${port}`, options.userDataDir);
+    if (lastError instanceof DevToolsReadyTimeoutError && attempts > 1) {
+        lastError.message += ` (${attempts} launch attempts)`;
+    }
+    throw lastError;
 }
 export function buildFrontProcessScript(pid) {
     return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-browser-use",
-  "version": "0.11.6",
+  "version": "0.11.7",
   "description": "Opinionated browser automation via chrome-devtools-mcp: native Pi extension and portable Agent Plugins 1.0 skills + MCP server.",
   "keywords": [
     "automation",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pi-browser-use",
-  "version": "0.11.6",
+  "version": "0.11.7",
   "description": "Managed persistent, fresh, and existing Chrome sessions with focus-safe browser tools and CLI-first skills.",
   "author": {
     "name": "0xPlayerOne"