browser-pilot 0.0.15 → 0.0.16

package/README.md

@@ -26,7 +26,20 @@ bun add browser-pilot
 npm install browser-pilot
 ```
 
-For local Chrome:
+For local Chrome on Chrome 144+:
+
+```bash
+# 1. Start Chrome normally
+# 2. Open chrome://inspect/#remote-debugging
+# 3. Enable remote debugging, then run:
+bp connect
+```
+
+Tip: try plain `bp connect` first. Only add `--channel` or `--user-data-dir` if auto-discovery finds more than one eligible profile.
+
+Use `bp connect --channel beta` or `bp connect --user-data-dir <path>` when more than one Chrome profile is eligible.
+
+Legacy/manual fallback still works with a separate debug profile:
 
 ```bash
 /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
@@ -48,7 +61,7 @@ For local Chrome:
 ## Golden path 1: automate a page
 
 ```bash
-bp connect --provider generic --name dev
+bp connect --name dev
 bp snapshot -i -s dev
 bp exec -s dev '[
   {"action":"fill","selector":"ref:e5","value":"user@example.com"},
@@ -74,7 +87,7 @@ Do not start by opening the raw artifact. Use `record summary`, `record inspect`
 ## Golden path 3: debug a realtime or voice session
 
 ```bash
-bp connect --provider generic --name realtime
+bp connect --name realtime
 bp trace start -s realtime --timeout 20000
 # reproduce the issue in the app
 bp trace summary -s realtime --view ws

package/dist/actions.cjs

@@ -582,7 +582,9 @@ function buildTraceSummaries(events) {
   };
 }
 function summarizeWs(events) {
-  const relevant = events.filter((event) => event.channel === "ws" || event.event.startsWith("ws."));
+  const relevant = events.filter(
+    (event) => event.channel === "ws" || event.event.startsWith("ws.")
+  );
   const connections = /* @__PURE__ */ new Map();
   for (const event of relevant) {
     const id = event.connectionId ?? event.requestId ?? event.traceId;
@@ -612,7 +614,7 @@ function summarizeWs(events) {
   }
   const values = [...connections.values()];
   const reconnects = values.reduce((count, connection) => {
-    return connection.closedAt && !connection.createdAt ? count : count;
+    return connection.closedAt && !connection.createdAt ? count + 1 : count;
   }, 0);
   return {
     view: "ws",
@@ -865,6 +867,31 @@ function frameToStep(frame) {
   }
 }
 
+// src/trace/model.ts
+function createTraceId(prefix = "evt") {
+  const random = Math.random().toString(36).slice(2, 10);
+  return `${prefix}-${Date.now().toString(36)}-${random}`;
+}
+function normalizeTraceEvent(event) {
+  return {
+    traceId: event.traceId ?? createTraceId(event.channel),
+    ts: event.ts ?? (/* @__PURE__ */ new Date()).toISOString(),
+    elapsedMs: event.elapsedMs ?? 0,
+    severity: event.severity ?? inferSeverity(event.event),
+    data: event.data ?? {},
+    ...event
+  };
+}
+function inferSeverity(eventName) {
+  if (eventName.includes(".failed") || eventName.includes(".error") || eventName.includes("exception") || eventName.includes("notReady")) {
+    return "error";
+  }
+  if (eventName.includes(".closed") || eventName.includes(".warn") || eventName.includes(".changed")) {
+    return "warn";
+  }
+  return "info";
+}
+
 // src/trace/script.ts
 var TRACE_BINDING_NAME = "__bpTraceBinding";
 var TRACE_SCRIPT = `
@@ -1144,31 +1171,6 @@ var TRACE_SCRIPT = `
 })();
 `;
 
-// src/trace/model.ts
-function createTraceId(prefix = "evt") {
-  const random = Math.random().toString(36).slice(2, 10);
-  return `${prefix}-${Date.now().toString(36)}-${random}`;
-}
-function normalizeTraceEvent(event) {
-  return {
-    traceId: event.traceId ?? createTraceId(event.channel),
-    ts: event.ts ?? (/* @__PURE__ */ new Date()).toISOString(),
-    elapsedMs: event.elapsedMs ?? 0,
-    severity: event.severity ?? inferSeverity(event.event),
-    data: event.data ?? {},
-    ...event
-  };
-}
-function inferSeverity(eventName) {
-  if (eventName.includes(".failed") || eventName.includes(".error") || eventName.includes("exception") || eventName.includes("notReady")) {
-    return "error";
-  }
-  if (eventName.includes(".closed") || eventName.includes(".warn") || eventName.includes(".changed")) {
-    return "warn";
-  }
-  return "info";
-}
-
 // src/trace/live.ts
 function globToRegex(pattern) {
   const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
@@ -1185,6 +1187,15 @@ var DEFAULT_RECORDING_SKIP_ACTIONS = [
   "text",
   "screenshot"
 ];
+function readString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function readStringOr(value, fallback = "") {
+  return readString(value) ?? fallback;
+}
+function formatConsoleArg(entry) {
+  return readString(entry["value"]) ?? readString(entry["description"]) ?? "";
+}
 function loadExistingRecording(manifestPath) {
   try {
     const raw = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
@@ -1985,8 +1996,13 @@ Valid actions: ${valid}`);
       await this.page.cdpClient.send("Runtime.addBinding", { name: TRACE_BINDING_NAME });
     } catch {
     }
-    await this.page.cdpClient.send("Page.addScriptToEvaluateOnNewDocument", { source: TRACE_SCRIPT });
-    await this.page.cdpClient.send("Runtime.evaluate", { expression: TRACE_SCRIPT, awaitPromise: false });
+    await this.page.cdpClient.send("Page.addScriptToEvaluateOnNewDocument", {
+      source: TRACE_SCRIPT
+    });
+    await this.page.cdpClient.send("Runtime.evaluate", {
+      expression: TRACE_SCRIPT,
+      awaitPromise: false
+    });
   }
   async waitForWsMessage(match, where, timeout) {
     await this.ensureTraceHooks();
@@ -2004,12 +2020,12 @@ Valid actions: ${valid}`);
         clearTimeout(timer);
       };
       const onCreated = (params) => {
-        wsUrls.set(String(params["requestId"] ?? ""), String(params["url"] ?? ""));
+        wsUrls.set(readStringOr(params["requestId"]), readStringOr(params["url"]));
       };
       const onFrame = (params) => {
-        const requestId = String(params["requestId"] ?? "");
+        const requestId = readStringOr(params["requestId"]);
         const response = params["response"] ?? {};
-        const payload = String(response.payloadData ?? "");
+        const payload = response.payloadData ?? "";
         const url = wsUrls.get(requestId) ?? "";
         if (!regex.test(url) && !regex.test(payload)) {
           return;
@@ -2025,13 +2041,13 @@ Valid actions: ${valid}`);
           return;
         }
         try {
-          const parsed = JSON.parse(String(params["payload"] ?? ""));
+          const parsed = JSON.parse(readStringOr(params["payload"]));
           if (parsed.event !== "ws.frame.received") {
             return;
           }
           const data = parsed.data ?? {};
-          const payload = String(data["payload"] ?? "");
-          const url = String(data["url"] ?? "");
+          const payload = readStringOr(data["payload"]);
+          const url = readStringOr(data["url"]);
           if (!regex.test(url) && !regex.test(payload)) {
             return;
           }
@@ -2040,7 +2056,7 @@ Valid actions: ${valid}`);
           }
           cleanup();
           resolve({
-            requestId: String(data["connectionId"] ?? ""),
+            requestId: readStringOr(data["connectionId"]),
             url,
             payload
           });
@@ -2084,13 +2100,14 @@ Valid actions: ${valid}`);
       if (!entry || typeof entry !== "object") {
         continue;
       }
-      const event = String(entry["event"] ?? "");
+      const record = entry;
+      const event = readStringOr(record["event"]);
       if (event !== "ws.frame.received") {
         continue;
       }
-      const data = entry["data"] ?? {};
-      const payload = String(data["payload"] ?? "");
-      const url = String(data["url"] ?? "");
+      const data = record["data"] ?? {};
+      const payload = readStringOr(data["payload"]);
+      const url = readStringOr(data["url"]);
       if (!regex.test(url) && !regex.test(payload)) {
         continue;
       }
@@ -2098,7 +2115,7 @@ Valid actions: ${valid}`);
         continue;
       }
       return {
-        requestId: String(data["connectionId"] ?? ""),
+        requestId: readStringOr(data["connectionId"]),
         url,
         payload
       };
@@ -2119,13 +2136,11 @@ Valid actions: ${valid}`);
           return;
         }
         const args = Array.isArray(params["args"]) ? params["args"] : [];
-        errors.push(
-          args.map((entry) => String(entry["value"] ?? entry["description"] ?? "")).filter(Boolean).join(" ")
-        );
+        errors.push(args.map(formatConsoleArg).filter(Boolean).join(" "));
       };
       const onException = (params) => {
         const details = params["exceptionDetails"] ?? {};
-        errors.push(String(details["text"] ?? "Runtime exception"));
+        errors.push(readString(details["text"]) ?? "Runtime exception");
       };
       const timer = setTimeout(() => {
         cleanup();

package/dist/actions.d.cts

@@ -1,5 +1,5 @@
-import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-C9ySEdOX.cjs';
-export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-C9ySEdOX.cjs';
+import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BflRmiDz.cjs';
+export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-BflRmiDz.cjs';
 import './client-B5QBRgIy.cjs';
 
 /**

package/dist/actions.d.ts

@@ -1,5 +1,5 @@
-import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-Cvvf0oGu.js';
-export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-Cvvf0oGu.js';
+import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BzM-IfsL.js';
+export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-BzM-IfsL.js';
 import './client-B5QBRgIy.js';
 
 /**

package/dist/actions.mjs

@@ -2,7 +2,7 @@ import {
   BatchExecutor,
   addBatchToPage,
   validateSteps
-} from "./chunk-7YVCOL2W.mjs";
+} from "./chunk-V3VLBQAM.mjs";
 import "./chunk-JXAUPHZM.mjs";
 export {
   BatchExecutor,

package/dist/{browser-MEWT75IB.mjs → browser-ZCR6AA4D.mjs}

@@ -1,9 +1,9 @@
 import {
   Browser,
   connect
-} from "./chunk-WPNW23CE.mjs";
+} from "./chunk-TJ5B56NV.mjs";
 import "./chunk-LCNFBXB5.mjs";
-import "./chunk-USYSHCI3.mjs";
+import "./chunk-6GBYX7C2.mjs";
 import "./chunk-DTVRFXKI.mjs";
 export {
   Browser,