browser-pilot 0.0.15 → 0.0.16

package/dist/{chunk-WPNW23CE.mjs → chunk-TJ5B56NV.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-LCNFBXB5.mjs";
 import {
   Page
-} from "./chunk-USYSHCI3.mjs";
+} from "./chunk-6GBYX7C2.mjs";
 
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
@@ -190,6 +190,330 @@ async function getBrowserWebSocketUrl(host = "localhost:9222") {
   return info.webSocketDebuggerUrl;
 }
 
+// src/providers/local-discovery.ts
+var CHANNEL_ORDER = ["stable", "beta", "dev", "canary"];
+var DEFAULT_PROBE_TIMEOUT_MS = 1e3;
+var DevToolsActivePortParseError = class extends Error {
+  constructor(message, reason) {
+    super(message);
+    this.reason = reason;
+    this.name = "DevToolsActivePortParseError";
+  }
+};
+function getRuntimeEnv() {
+  if (typeof process === "undefined") {
+    return {};
+  }
+  return process.env;
+}
+function getRuntimePlatform() {
+  if (typeof process === "undefined") {
+    return void 0;
+  }
+  return process.platform;
+}
+function normalizePlatform(platform) {
+  if (platform === "darwin" || platform === "linux" || platform === "win32") {
+    return platform;
+  }
+  throw new Error(`Unsupported platform: ${platform ?? "unknown"}`);
+}
+function trimTrailingSeparator(path) {
+  return path.replace(/[\\/]+$/, "");
+}
+function joinPath(platform, ...parts) {
+  const separator = platform === "win32" ? "\\" : "/";
+  const cleaned = parts.map((part, index) => {
+    if (index === 0) return trimTrailingSeparator(part);
+    return part.replace(/^[\\/]+/, "").replace(/[\\/]+$/, "");
+  }).filter((part) => part.length > 0);
+  return cleaned.join(separator);
+}
+function resolveHomeDir(platform, env, explicitHomeDir) {
+  if (explicitHomeDir) {
+    return explicitHomeDir;
+  }
+  if (platform === "win32") {
+    return env["USERPROFILE"] ?? env["HOME"] ?? "";
+  }
+  return env["HOME"] ?? env["USERPROFILE"] ?? "";
+}
+function toFileFailure(target, error) {
+  const errno = error?.code;
+  if (errno === "ENOENT") {
+    return {
+      ...target,
+      reason: "missing-file",
+      message: `DevToolsActivePort not found at ${target.portFile}`
+    };
+  }
+  return {
+    ...target,
+    reason: "unreadable-file",
+    message: error instanceof Error ? error.message : `Could not read DevToolsActivePort at ${target.portFile}`
+  };
+}
+function toProbeFailure(target, wsUrl, error) {
+  const message = error instanceof Error ? error.message : String(error);
+  const lowerMessage = message.toLowerCase();
+  let reason = "connection-error";
+  if (lowerMessage.includes("refused") || lowerMessage.includes("econnrefused")) {
+    reason = "connection-refused";
+  } else if (lowerMessage.includes("timeout") || lowerMessage.includes("timed out")) {
+    reason = "connection-timeout";
+  } else if (lowerMessage.includes("closed")) {
+    reason = "unexpected-close";
+  } else if (lowerMessage.includes("browser.getversion") || lowerMessage.includes("cdp") || lowerMessage.includes("protocol")) {
+    reason = "cdp-error";
+  }
+  return {
+    ...target,
+    wsUrl,
+    reason,
+    message
+  };
+}
+async function readTextFile(path) {
+  const fs = await import("fs/promises");
+  return fs.readFile(path, "utf-8");
+}
+async function probeBrowserWebSocket(wsUrl, timeoutMs) {
+  let client;
+  try {
+    client = await createCDPClient(wsUrl, { timeout: timeoutMs });
+    const version = await client.send("Browser.getVersion", void 0, null);
+    return { browserVersion: version.product };
+  } finally {
+    await client?.close().catch(() => {
+    });
+  }
+}
+var defaultDependencies = {
+  readTextFile,
+  probeBrowserWebSocket,
+  getLegacyBrowserWebSocketUrl: getBrowserWebSocketUrl
+};
+function resolveChromeUserDataDirs(options = {}) {
+  const env = options.env ?? getRuntimeEnv();
+  const platform = normalizePlatform(options.platform ?? getRuntimePlatform());
+  const homeDir = resolveHomeDir(platform, env, options.homeDir);
+  if (!homeDir) {
+    throw new Error("Could not determine home directory for local Chrome discovery");
+  }
+  switch (platform) {
+    case "darwin": {
+      const base = joinPath(platform, homeDir, "Library", "Application Support", "Google");
+      return {
+        stable: joinPath(platform, base, "Chrome"),
+        beta: joinPath(platform, base, "Chrome Beta"),
+        dev: joinPath(platform, base, "Chrome Dev"),
+        canary: joinPath(platform, base, "Chrome Canary")
+      };
+    }
+    case "linux": {
+      const configHome = env["CHROME_CONFIG_HOME"] ?? env["XDG_CONFIG_HOME"] ?? joinPath(platform, homeDir, ".config");
+      return {
+        stable: joinPath(platform, configHome, "google-chrome"),
+        beta: joinPath(platform, configHome, "google-chrome-beta"),
+        dev: joinPath(platform, configHome, "google-chrome-dev"),
+        canary: joinPath(platform, configHome, "google-chrome-canary")
+      };
+    }
+    case "win32": {
+      const localAppData = env["LOCALAPPDATA"] ?? joinPath(platform, homeDir, "AppData", "Local");
+      const base = joinPath(platform, localAppData, "Google");
+      return {
+        stable: joinPath(platform, base, "Chrome", "User Data"),
+        beta: joinPath(platform, base, "Chrome Beta", "User Data"),
+        dev: joinPath(platform, base, "Chrome Dev", "User Data"),
+        canary: joinPath(platform, base, "Chrome SxS", "User Data")
+      };
+    }
+  }
+  throw new Error(`Unsupported platform for local Chrome discovery: ${platform}`);
+}
+function buildLocalBrowserScanTargets(options = {}) {
+  const env = options.env ?? getRuntimeEnv();
+  const platform = normalizePlatform(options.platform ?? getRuntimePlatform());
+  if (options.userDataDir) {
+    return [
+      {
+        channel: options.channel ?? "custom",
+        userDataDir: options.userDataDir,
+        portFile: joinPath(platform, options.userDataDir, "DevToolsActivePort")
+      }
+    ];
+  }
+  const dirs = resolveChromeUserDataDirs({
+    platform,
+    env,
+    homeDir: options.homeDir
+  });
+  const channels = options.channel ? [options.channel] : CHANNEL_ORDER;
+  return channels.map((channel) => ({
+    channel,
+    userDataDir: dirs[channel],
+    portFile: joinPath(platform, dirs[channel], "DevToolsActivePort")
+  }));
+}
+function parseDevToolsActivePortFile(content) {
+  const lines = content.split(/\r?\n/u).map((line) => line.trim()).filter((line) => line.length > 0);
+  if (lines.length !== 2) {
+    throw new DevToolsActivePortParseError(
+      `Expected exactly 2 non-empty lines in DevToolsActivePort, got ${lines.length}`,
+      "malformed-file"
+    );
+  }
+  const portText = lines[0];
+  const browserPath = lines[1];
+  const port = Number.parseInt(portText, 10);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new DevToolsActivePortParseError(
+      `Invalid DevToolsActivePort port: ${portText}`,
+      "invalid-port"
+    );
+  }
+  if (!browserPath.startsWith("/devtools/browser/") || browserPath.includes("..") || /[?#\s\\]/u.test(browserPath)) {
+    throw new DevToolsActivePortParseError(
+      `Invalid DevToolsActivePort browser path: ${browserPath}`,
+      "invalid-path"
+    );
+  }
+  return {
+    port,
+    browserPath,
+    wsUrl: `ws://127.0.0.1:${port}${browserPath}`
+  };
+}
+async function inspectScanTarget(target, options, deps) {
+  let content;
+  try {
+    content = await deps.readTextFile(target.portFile);
+  } catch (error) {
+    return { kind: "failure", failure: toFileFailure(target, error) };
+  }
+  let parsed;
+  try {
+    parsed = parseDevToolsActivePortFile(content);
+  } catch (error) {
+    if (error instanceof DevToolsActivePortParseError) {
+      return {
+        kind: "failure",
+        failure: {
+          ...target,
+          reason: error.reason,
+          message: error.message
+        }
+      };
+    }
+    throw error;
+  }
+  try {
+    const probe = await deps.probeBrowserWebSocket(
+      parsed.wsUrl,
+      options.probeTimeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS
+    );
+    return {
+      kind: "candidate",
+      candidate: {
+        ...target,
+        port: parsed.port,
+        browserPath: parsed.browserPath,
+        wsUrl: parsed.wsUrl,
+        browserVersion: probe.browserVersion
+      }
+    };
+  } catch (error) {
+    return {
+      kind: "failure",
+      failure: toProbeFailure(target, parsed.wsUrl, error)
+    };
+  }
+}
+async function discoverLocalBrowsers(options = {}, deps = defaultDependencies) {
+  const scanTargets = buildLocalBrowserScanTargets(options);
+  const outcomes = await Promise.all(
+    scanTargets.map((target) => inspectScanTarget(target, options, deps))
+  );
+  const candidates = [];
+  const failures = [];
+  for (const outcome of outcomes) {
+    if (outcome.kind === "candidate") {
+      candidates.push(outcome.candidate);
+    } else {
+      failures.push(outcome.failure);
+    }
+  }
+  return { candidates, failures };
+}
+var BrowserEndpointResolutionError = class extends Error {
+  constructor(code, message, details = {}) {
+    super(message);
+    this.code = code;
+    this.details = details;
+  }
+  name = "BrowserEndpointResolutionError";
+};
+async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies) {
+  if (options.explicitWsUrl) {
+    return {
+      wsUrl: options.explicitWsUrl,
+      source: "explicit-ws"
+    };
+  }
+  let localDiscovery;
+  if (options.allowLocalDiscovery ?? true) {
+    localDiscovery = await discoverLocalBrowsers(options, deps);
+    if (localDiscovery.candidates.length === 1) {
+      const candidate = localDiscovery.candidates[0];
+      return {
+        wsUrl: candidate.wsUrl,
+        source: "devtools-active-port",
+        channel: candidate.channel,
+        userDataDir: candidate.userDataDir
+      };
+    }
+    if (localDiscovery.candidates.length > 1) {
+      throw new BrowserEndpointResolutionError(
+        "multiple-local-browsers",
+        "Multiple local Chrome profiles are available for auto-discovery",
+        {
+          candidates: localDiscovery.candidates,
+          failures: localDiscovery.failures
+        }
+      );
+    }
+  }
+  if (options.allowLegacyHostFallback ?? true) {
+    const legacyHost = options.legacyHost ?? "localhost:9222";
+    try {
+      return {
+        wsUrl: await deps.getLegacyBrowserWebSocketUrl(legacyHost),
+        source: "json-version"
+      };
+    } catch (error) {
+      throw new BrowserEndpointResolutionError(
+        "browser-not-found",
+        "Could not resolve a browser endpoint",
+        {
+          candidates: localDiscovery?.candidates,
+          failures: localDiscovery?.failures,
+          legacyError: error instanceof Error ? error : new Error(String(error)),
+          legacyHost
+        }
+      );
+    }
+  }
+  throw new BrowserEndpointResolutionError(
+    "browser-not-found",
+    "Could not resolve a browser endpoint",
+    {
+      candidates: localDiscovery?.candidates,
+      failures: localDiscovery?.failures
+    }
+  );
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -272,13 +596,26 @@ var Browser = class _Browser {
    * Connect to a browser instance
    */
   static async connect(options) {
-    const provider = createProvider(options);
-    const session = await provider.createSession(options.session);
+    let connectOptions = options;
+    if (options.provider === "generic" && !options.wsUrl) {
+      const endpoint = await resolveBrowserEndpoint({
+        channel: options.channel,
+        userDataDir: options.userDataDir,
+        allowLocalDiscovery: true,
+        allowLegacyHostFallback: true
+      });
+      connectOptions = {
+        ...options,
+        wsUrl: endpoint.wsUrl
+      };
+    }
+    const provider = createProvider(connectOptions);
+    const session = await provider.createSession(connectOptions.session);
     const cdp = await createCDPClient(session.wsUrl, {
-      debug: options.debug,
-      timeout: options.timeout
+      debug: connectOptions.debug,
+      timeout: connectOptions.timeout
     });
-    return new _Browser(cdp, provider, session, options);
+    return new _Browser(cdp, provider, session, connectOptions);
   }
   /**
    * Get or create a page by name.
@@ -460,7 +797,8 @@ function connect(options) {
 }
 
 export {
-  getBrowserWebSocketUrl,
+  BrowserEndpointResolutionError,
+  resolveBrowserEndpoint,
   Browser,
   connect
 };

package/dist/{chunk-7YVCOL2W.mjs → chunk-V3VLBQAM.mjs}

@@ -860,7 +860,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;
@@ -890,7 +892,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",
@@ -1143,6 +1145,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 = `
@@ -1422,31 +1449,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, "\\$&");
@@ -1463,6 +1465,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"));
@@ -2263,8 +2274,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();
@@ -2282,12 +2298,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;
@@ -2303,13 +2319,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;
           }
@@ -2318,7 +2334,7 @@ Valid actions: ${valid}`);
           }
           cleanup();
           resolve({
-            requestId: String(data["connectionId"] ?? ""),
+            requestId: readStringOr(data["connectionId"]),
             url,
             payload
           });
@@ -2362,13 +2378,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;
       }
@@ -2376,7 +2393,7 @@ Valid actions: ${valid}`);
         continue;
       }
       return {
-        requestId: String(data["connectionId"] ?? ""),
+        requestId: readStringOr(data["connectionId"]),
         url,
         payload
       };
@@ -2397,13 +2414,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();