browser-pilot 0.0.14 → 0.0.16

package/dist/providers.mjs

@@ -1,16 +1,30 @@
 import {
   BrowserBaseProvider,
+  BrowserEndpointResolutionError,
   BrowserlessProvider,
   GenericProvider,
+  buildLocalBrowserScanTargets,
   createProvider,
+  discoverLocalBrowsers,
   discoverTargets,
-  getBrowserWebSocketUrl
-} from "./chunk-BRAFQUMG.mjs";
+  getBrowserWebSocketUrl,
+  parseDevToolsActivePortFile,
+  resolveBrowserEndpoint,
+  resolveChromeUserDataDirs
+} from "./chunk-EZNZ72VA.mjs";
+import "./chunk-BVZALQT4.mjs";
+import "./chunk-JXAUPHZM.mjs";
 export {
   BrowserBaseProvider,
+  BrowserEndpointResolutionError,
   BrowserlessProvider,
   GenericProvider,
+  buildLocalBrowserScanTargets,
   createProvider,
+  discoverLocalBrowsers,
   discoverTargets,
-  getBrowserWebSocketUrl
+  getBrowserWebSocketUrl,
+  parseDevToolsActivePortFile,
+  resolveBrowserEndpoint,
+  resolveChromeUserDataDirs
 };

package/dist/{types-CjT0vClo.d.ts → types-BflRmiDz.d.cts}

@@ -1,4 +1,4 @@
-import { C as CDPClient } from './client-Ck2nQksT.js';
+import { C as CDPClient } from './client-B5QBRgIy.cjs';
 
 /**
  * Audio I/O type definitions
@@ -1247,7 +1247,7 @@ declare class Page {
  */
 
 type FailureReason = 'missing' | 'hidden' | 'covered' | 'disabled' | 'readonly' | 'detached' | 'replaced' | 'notEditable' | 'timeout' | 'navigation' | 'cdpError' | 'unknown';
-type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue';
+type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue' | 'waitForWsMessage' | 'assertNoConsoleErrors' | 'assertTextChanged' | 'assertPermission' | 'assertMediaTrackLive';
 interface Step {
     /** Action type */
     action: ActionType;
@@ -1284,7 +1284,9 @@ interface Step {
     /** Custom select: option selector */
     option?: string | string[];
     /** Custom select: match type */
-    match?: 'text' | 'value' | 'contains';
+    match?: string;
+    /** Structured matcher for trace-backed waits */
+    where?: Record<string, unknown>;
     /** Scroll coordinates */
     x?: number;
     y?: number;
@@ -1302,6 +1304,18 @@ interface Step {
     retry?: number;
     /** Delay between retries in ms (default: 500) */
     retryDelay?: number;
+    /** Previous text expected before a change */
+    from?: string;
+    /** Text expected after a change */
+    to?: string;
+    /** Permission or resource name */
+    name?: string;
+    /** Expected permission state */
+    state?: string;
+    /** Media track kind */
+    kind?: 'audio' | 'video';
+    /** Assertion observation window in milliseconds */
+    windowMs?: number;
 }
 interface RecordOptions {
     /** Base directory for screenshots and recording.json. */

package/dist/{types-BSoh5v1Y.d.cts → types-BzM-IfsL.d.ts}

@@ -1,4 +1,4 @@
-import { C as CDPClient } from './client-Ck2nQksT.cjs';
+import { C as CDPClient } from './client-B5QBRgIy.js';
 
 /**
  * Audio I/O type definitions
@@ -1247,7 +1247,7 @@ declare class Page {
  */
 
 type FailureReason = 'missing' | 'hidden' | 'covered' | 'disabled' | 'readonly' | 'detached' | 'replaced' | 'notEditable' | 'timeout' | 'navigation' | 'cdpError' | 'unknown';
-type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue';
+type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue' | 'waitForWsMessage' | 'assertNoConsoleErrors' | 'assertTextChanged' | 'assertPermission' | 'assertMediaTrackLive';
 interface Step {
     /** Action type */
     action: ActionType;
@@ -1284,7 +1284,9 @@ interface Step {
     /** Custom select: option selector */
     option?: string | string[];
     /** Custom select: match type */
-    match?: 'text' | 'value' | 'contains';
+    match?: string;
+    /** Structured matcher for trace-backed waits */
+    where?: Record<string, unknown>;
     /** Scroll coordinates */
     x?: number;
     y?: number;
@@ -1302,6 +1304,18 @@ interface Step {
     retry?: number;
     /** Delay between retries in ms (default: 500) */
     retryDelay?: number;
+    /** Previous text expected before a change */
+    from?: string;
+    /** Text expected after a change */
+    to?: string;
+    /** Permission or resource name */
+    name?: string;
+    /** Expected permission state */
+    state?: string;
+    /** Media track kind */
+    kind?: 'audio' | 'video';
+    /** Assertion observation window in milliseconds */
+    windowMs?: number;
 }
 interface RecordOptions {
     /** Base directory for screenshots and recording.json. */

package/dist/types-DeVSWhXj.d.cts

@@ -0,0 +1,142 @@
+type ChromeChannel = 'stable' | 'beta' | 'dev' | 'canary';
+type ResolvedBrowserSource = 'explicit-ws' | 'devtools-active-port' | 'json-version';
+interface LocalBrowserScanTarget {
+    channel: ChromeChannel | 'custom';
+    userDataDir: string;
+    portFile: string;
+}
+interface LocalBrowserCandidate extends LocalBrowserScanTarget {
+    port: number;
+    browserPath: string;
+    wsUrl: string;
+    browserVersion?: string;
+}
+type LocalDiscoveryFailureReason = 'missing-file' | 'unreadable-file' | 'malformed-file' | 'invalid-port' | 'invalid-path' | 'connection-refused' | 'connection-timeout' | 'unexpected-close' | 'connection-error' | 'cdp-error';
+interface LocalDiscoveryFailure extends LocalBrowserScanTarget {
+    reason: LocalDiscoveryFailureReason;
+    message: string;
+    wsUrl?: string;
+}
+interface LocalBrowserDiscoveryResult {
+    candidates: LocalBrowserCandidate[];
+    failures: LocalDiscoveryFailure[];
+}
+interface ResolvedBrowserEndpoint {
+    wsUrl: string;
+    source: ResolvedBrowserSource;
+    channel?: ChromeChannel | 'custom';
+    userDataDir?: string;
+}
+interface ChromeUserDataDirOptions {
+    platform?: string;
+    env?: Record<string, string | undefined>;
+    homeDir?: string;
+}
+interface DiscoverLocalBrowsersOptions extends ChromeUserDataDirOptions {
+    channel?: ChromeChannel;
+    userDataDir?: string;
+    probeTimeoutMs?: number;
+}
+interface ResolveBrowserEndpointOptions extends DiscoverLocalBrowsersOptions {
+    explicitWsUrl?: string;
+    allowLocalDiscovery?: boolean;
+    allowLegacyHostFallback?: boolean;
+    legacyHost?: string;
+}
+interface ProbeResult {
+    browserVersion?: string;
+}
+interface LocalDiscoveryDependencies {
+    readTextFile(path: string): Promise<string>;
+    probeBrowserWebSocket(wsUrl: string, timeoutMs: number): Promise<ProbeResult>;
+    getLegacyBrowserWebSocketUrl(host: string): Promise<string>;
+}
+interface ParsedDevToolsActivePort {
+    port: number;
+    browserPath: string;
+    wsUrl: string;
+}
+declare function resolveChromeUserDataDirs(options?: ChromeUserDataDirOptions): Record<ChromeChannel, string>;
+declare function buildLocalBrowserScanTargets(options?: DiscoverLocalBrowsersOptions): LocalBrowserScanTarget[];
+declare function parseDevToolsActivePortFile(content: string): ParsedDevToolsActivePort;
+declare function discoverLocalBrowsers(options?: DiscoverLocalBrowsersOptions, deps?: LocalDiscoveryDependencies): Promise<LocalBrowserDiscoveryResult>;
+type BrowserEndpointResolutionErrorCode = 'multiple-local-browsers' | 'browser-not-found';
+declare class BrowserEndpointResolutionError extends Error {
+    readonly code: BrowserEndpointResolutionErrorCode;
+    readonly details: {
+        candidates?: LocalBrowserCandidate[];
+        failures?: LocalDiscoveryFailure[];
+        legacyError?: Error;
+        legacyHost?: string;
+    };
+    readonly name = "BrowserEndpointResolutionError";
+    constructor(code: BrowserEndpointResolutionErrorCode, message: string, details?: {
+        candidates?: LocalBrowserCandidate[];
+        failures?: LocalDiscoveryFailure[];
+        legacyError?: Error;
+        legacyHost?: string;
+    });
+}
+declare function resolveBrowserEndpoint(options?: ResolveBrowserEndpointOptions, deps?: LocalDiscoveryDependencies): Promise<ResolvedBrowserEndpoint>;
+
+/**
+ * Provider type definitions
+ */
+
+interface ProviderSession {
+    /** WebSocket URL to connect to CDP */
+    wsUrl: string;
+    /** Provider-specific session ID (for resumption) */
+    sessionId?: string;
+    /** Additional metadata from the provider */
+    metadata?: Record<string, unknown>;
+    /** Close the provider session */
+    close(): Promise<void>;
+}
+interface Provider {
+    /** Provider name identifier */
+    readonly name: string;
+    /** Create a new browser session */
+    createSession(options?: CreateSessionOptions): Promise<ProviderSession>;
+    /** Resume an existing session by ID */
+    resumeSession?(sessionId: string): Promise<ProviderSession>;
+}
+interface CreateSessionOptions {
+    /** Viewport width */
+    width?: number;
+    /** Viewport height */
+    height?: number;
+    /** Enable recording (if provider supports) */
+    recording?: boolean;
+    /** Proxy configuration */
+    proxy?: ProxyConfig;
+    /** Additional provider-specific options */
+    [key: string]: unknown;
+}
+interface ProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+}
+interface ConnectOptions {
+    /** Provider type */
+    provider: 'browserbase' | 'browserless' | 'generic';
+    /** API key for hosted providers */
+    apiKey?: string;
+    /** Project ID (for BrowserBase) */
+    projectId?: string;
+    /** Direct WebSocket URL (for generic provider) */
+    wsUrl?: string;
+    /** Preferred local Chrome channel for auto-discovery (generic provider) */
+    channel?: ChromeChannel;
+    /** Explicit local Chrome user data dir for auto-discovery (generic provider) */
+    userDataDir?: string;
+    /** Session creation options */
+    session?: CreateSessionOptions;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Connection timeout in ms */
+    timeout?: number;
+}
+
+export { BrowserEndpointResolutionError as B, type CreateSessionOptions as C, type DiscoverLocalBrowsersOptions as D, type Provider as P, type ResolvedBrowserEndpoint as R, type ProviderSession as a, type ConnectOptions as b, buildLocalBrowserScanTargets as c, type ChromeChannel as d, type ChromeUserDataDirOptions as e, discoverLocalBrowsers as f, type ResolvedBrowserSource as g, resolveChromeUserDataDirs as h, type ProxyConfig as i, parseDevToolsActivePortFile as p, resolveBrowserEndpoint as r };

package/dist/types-DeVSWhXj.d.ts

@@ -0,0 +1,142 @@
+type ChromeChannel = 'stable' | 'beta' | 'dev' | 'canary';
+type ResolvedBrowserSource = 'explicit-ws' | 'devtools-active-port' | 'json-version';
+interface LocalBrowserScanTarget {
+    channel: ChromeChannel | 'custom';
+    userDataDir: string;
+    portFile: string;
+}
+interface LocalBrowserCandidate extends LocalBrowserScanTarget {
+    port: number;
+    browserPath: string;
+    wsUrl: string;
+    browserVersion?: string;
+}
+type LocalDiscoveryFailureReason = 'missing-file' | 'unreadable-file' | 'malformed-file' | 'invalid-port' | 'invalid-path' | 'connection-refused' | 'connection-timeout' | 'unexpected-close' | 'connection-error' | 'cdp-error';
+interface LocalDiscoveryFailure extends LocalBrowserScanTarget {
+    reason: LocalDiscoveryFailureReason;
+    message: string;
+    wsUrl?: string;
+}
+interface LocalBrowserDiscoveryResult {
+    candidates: LocalBrowserCandidate[];
+    failures: LocalDiscoveryFailure[];
+}
+interface ResolvedBrowserEndpoint {
+    wsUrl: string;
+    source: ResolvedBrowserSource;
+    channel?: ChromeChannel | 'custom';
+    userDataDir?: string;
+}
+interface ChromeUserDataDirOptions {
+    platform?: string;
+    env?: Record<string, string | undefined>;
+    homeDir?: string;
+}
+interface DiscoverLocalBrowsersOptions extends ChromeUserDataDirOptions {
+    channel?: ChromeChannel;
+    userDataDir?: string;
+    probeTimeoutMs?: number;
+}
+interface ResolveBrowserEndpointOptions extends DiscoverLocalBrowsersOptions {
+    explicitWsUrl?: string;
+    allowLocalDiscovery?: boolean;
+    allowLegacyHostFallback?: boolean;
+    legacyHost?: string;
+}
+interface ProbeResult {
+    browserVersion?: string;
+}
+interface LocalDiscoveryDependencies {
+    readTextFile(path: string): Promise<string>;
+    probeBrowserWebSocket(wsUrl: string, timeoutMs: number): Promise<ProbeResult>;
+    getLegacyBrowserWebSocketUrl(host: string): Promise<string>;
+}
+interface ParsedDevToolsActivePort {
+    port: number;
+    browserPath: string;
+    wsUrl: string;
+}
+declare function resolveChromeUserDataDirs(options?: ChromeUserDataDirOptions): Record<ChromeChannel, string>;
+declare function buildLocalBrowserScanTargets(options?: DiscoverLocalBrowsersOptions): LocalBrowserScanTarget[];
+declare function parseDevToolsActivePortFile(content: string): ParsedDevToolsActivePort;
+declare function discoverLocalBrowsers(options?: DiscoverLocalBrowsersOptions, deps?: LocalDiscoveryDependencies): Promise<LocalBrowserDiscoveryResult>;
+type BrowserEndpointResolutionErrorCode = 'multiple-local-browsers' | 'browser-not-found';
+declare class BrowserEndpointResolutionError extends Error {
+    readonly code: BrowserEndpointResolutionErrorCode;
+    readonly details: {
+        candidates?: LocalBrowserCandidate[];
+        failures?: LocalDiscoveryFailure[];
+        legacyError?: Error;
+        legacyHost?: string;
+    };
+    readonly name = "BrowserEndpointResolutionError";
+    constructor(code: BrowserEndpointResolutionErrorCode, message: string, details?: {
+        candidates?: LocalBrowserCandidate[];
+        failures?: LocalDiscoveryFailure[];
+        legacyError?: Error;
+        legacyHost?: string;
+    });
+}
+declare function resolveBrowserEndpoint(options?: ResolveBrowserEndpointOptions, deps?: LocalDiscoveryDependencies): Promise<ResolvedBrowserEndpoint>;
+
+/**
+ * Provider type definitions
+ */
+
+interface ProviderSession {
+    /** WebSocket URL to connect to CDP */
+    wsUrl: string;
+    /** Provider-specific session ID (for resumption) */
+    sessionId?: string;
+    /** Additional metadata from the provider */
+    metadata?: Record<string, unknown>;
+    /** Close the provider session */
+    close(): Promise<void>;
+}
+interface Provider {
+    /** Provider name identifier */
+    readonly name: string;
+    /** Create a new browser session */
+    createSession(options?: CreateSessionOptions): Promise<ProviderSession>;
+    /** Resume an existing session by ID */
+    resumeSession?(sessionId: string): Promise<ProviderSession>;
+}
+interface CreateSessionOptions {
+    /** Viewport width */
+    width?: number;
+    /** Viewport height */
+    height?: number;
+    /** Enable recording (if provider supports) */
+    recording?: boolean;
+    /** Proxy configuration */
+    proxy?: ProxyConfig;
+    /** Additional provider-specific options */
+    [key: string]: unknown;
+}
+interface ProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+}
+interface ConnectOptions {
+    /** Provider type */
+    provider: 'browserbase' | 'browserless' | 'generic';
+    /** API key for hosted providers */
+    apiKey?: string;
+    /** Project ID (for BrowserBase) */
+    projectId?: string;
+    /** Direct WebSocket URL (for generic provider) */
+    wsUrl?: string;
+    /** Preferred local Chrome channel for auto-discovery (generic provider) */
+    channel?: ChromeChannel;
+    /** Explicit local Chrome user data dir for auto-discovery (generic provider) */
+    userDataDir?: string;
+    /** Session creation options */
+    session?: CreateSessionOptions;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Connection timeout in ms */
+    timeout?: number;
+}
+
+export { BrowserEndpointResolutionError as B, type CreateSessionOptions as C, type DiscoverLocalBrowsersOptions as D, type Provider as P, type ResolvedBrowserEndpoint as R, type ProviderSession as a, type ConnectOptions as b, buildLocalBrowserScanTargets as c, type ChromeChannel as d, type ChromeUserDataDirOptions as e, discoverLocalBrowsers as f, type ResolvedBrowserSource as g, resolveChromeUserDataDirs as h, type ProxyConfig as i, parseDevToolsActivePortFile as p, resolveBrowserEndpoint as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-pilot",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Lightweight CDP-based browser automation for Node.js, Bun, and Cloudflare Workers",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/browser-LZTEHUDI.mjs

@@ -1,9 +0,0 @@
-import {
-  Browser,
-  connect
-} from "./chunk-7NDR6V7S.mjs";
-import "./chunk-SPSZZH22.mjs";
-export {
-  Browser,
-  connect
-};

package/dist/chunk-BRAFQUMG.mjs

@@ -1,229 +0,0 @@
-// src/providers/browserbase.ts
-var BrowserBaseProvider = class {
-  name = "browserbase";
-  apiKey;
-  projectId;
-  baseUrl;
-  constructor(options) {
-    this.apiKey = options.apiKey;
-    this.projectId = options.projectId;
-    this.baseUrl = options.baseUrl ?? "https://api.browserbase.com";
-  }
-  async createSession(options = {}) {
-    const response = await fetch(`${this.baseUrl}/v1/sessions`, {
-      method: "POST",
-      headers: {
-        "X-BB-API-Key": this.apiKey,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        projectId: this.projectId,
-        browserSettings: {
-          viewport: options.width && options.height ? {
-            width: options.width,
-            height: options.height
-          } : void 0
-        },
-        ...options
-      })
-    });
-    if (!response.ok) {
-      const text = await response.text();
-      throw new Error(`BrowserBase createSession failed: ${response.status} ${text}`);
-    }
-    const session = await response.json();
-    const connectResponse = await fetch(`${this.baseUrl}/v1/sessions/${session.id}`, {
-      headers: {
-        "X-BB-API-Key": this.apiKey
-      }
-    });
-    if (!connectResponse.ok) {
-      throw new Error(`BrowserBase getSession failed: ${connectResponse.status}`);
-    }
-    const sessionDetails = await connectResponse.json();
-    if (!sessionDetails.connectUrl) {
-      throw new Error("BrowserBase session does not have a connectUrl");
-    }
-    return {
-      wsUrl: sessionDetails.connectUrl,
-      sessionId: session.id,
-      metadata: {
-        debugUrl: sessionDetails.debugUrl,
-        projectId: this.projectId,
-        status: sessionDetails.status
-      },
-      close: async () => {
-        await fetch(`${this.baseUrl}/v1/sessions/${session.id}`, {
-          method: "DELETE",
-          headers: {
-            "X-BB-API-Key": this.apiKey
-          }
-        });
-      }
-    };
-  }
-  async resumeSession(sessionId) {
-    const response = await fetch(`${this.baseUrl}/v1/sessions/${sessionId}`, {
-      headers: {
-        "X-BB-API-Key": this.apiKey
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`BrowserBase resumeSession failed: ${response.status}`);
-    }
-    const session = await response.json();
-    if (!session.connectUrl) {
-      throw new Error("BrowserBase session does not have a connectUrl (may be closed)");
-    }
-    return {
-      wsUrl: session.connectUrl,
-      sessionId: session.id,
-      metadata: {
-        debugUrl: session.debugUrl,
-        projectId: this.projectId,
-        status: session.status
-      },
-      close: async () => {
-        await fetch(`${this.baseUrl}/v1/sessions/${sessionId}`, {
-          method: "DELETE",
-          headers: {
-            "X-BB-API-Key": this.apiKey
-          }
-        });
-      }
-    };
-  }
-};
-
-// src/providers/browserless.ts
-var BrowserlessProvider = class {
-  name = "browserless";
-  token;
-  baseUrl;
-  constructor(options) {
-    this.token = options.token;
-    this.baseUrl = options.baseUrl ?? "wss://chrome.browserless.io";
-  }
-  async createSession(options = {}) {
-    const params = new URLSearchParams({
-      token: this.token
-    });
-    if (options.width && options.height) {
-      params.set("--window-size", `${options.width},${options.height}`);
-    }
-    if (options.proxy?.server) {
-      params.set("--proxy-server", options.proxy.server);
-    }
-    const wsUrl = `${this.baseUrl}?${params.toString()}`;
-    return {
-      wsUrl,
-      metadata: {
-        provider: "browserless"
-      },
-      close: async () => {
-      }
-    };
-  }
-  // Browserless doesn't support session resumption in the same way
-  // Each connection is a fresh browser instance
-};
-
-// src/providers/generic.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function fetchDevToolsJson(host, path, errorPrefix, options = {}) {
-  const protocol = host.includes("://") ? "" : "http://";
-  const attempts = options.attempts ?? 1;
-  let delayMs = options.initialDelayMs ?? 50;
-  const maxDelayMs = options.maxDelayMs ?? 250;
-  let lastError;
-  for (let attempt = 1; attempt <= attempts; attempt++) {
-    try {
-      const response = await fetch(`${protocol}${host}${path}`);
-      if (response.ok) {
-        return await response.json();
-      }
-      lastError = new Error(`${errorPrefix}: ${response.status}`);
-    } catch (error) {
-      lastError = new Error(
-        `${errorPrefix}: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-    if (attempt < attempts) {
-      await sleep(delayMs);
-      delayMs = Math.min(delayMs * 2, maxDelayMs);
-    }
-  }
-  throw lastError ?? new Error(errorPrefix);
-}
-var GenericProvider = class {
-  name = "generic";
-  wsUrl;
-  constructor(options) {
-    this.wsUrl = options.wsUrl;
-  }
-  async createSession(_options = {}) {
-    return {
-      wsUrl: this.wsUrl,
-      metadata: {
-        provider: "generic"
-      },
-      close: async () => {
-      }
-    };
-  }
-};
-async function discoverTargets(host = "localhost:9222") {
-  return fetchDevToolsJson(host, "/json/list", "Failed to discover targets");
-}
-async function getBrowserWebSocketUrl(host = "localhost:9222") {
-  const info = await fetchDevToolsJson(host, "/json/version", "Failed to get browser info", {
-    attempts: 10,
-    initialDelayMs: 50,
-    maxDelayMs: 250
-  });
-  return info.webSocketDebuggerUrl;
-}
-
-// src/providers/index.ts
-function createProvider(options) {
-  switch (options.provider) {
-    case "browserbase":
-      if (!options.apiKey) {
-        throw new Error("BrowserBase provider requires apiKey");
-      }
-      if (!options.projectId) {
-        throw new Error("BrowserBase provider requires projectId");
-      }
-      return new BrowserBaseProvider({
-        apiKey: options.apiKey,
-        projectId: options.projectId
-      });
-    case "browserless":
-      if (!options.apiKey) {
-        throw new Error("Browserless provider requires apiKey (token)");
-      }
-      return new BrowserlessProvider({
-        token: options.apiKey
-      });
-    case "generic":
-      if (!options.wsUrl) {
-        throw new Error("Generic provider requires wsUrl");
-      }
-      return new GenericProvider({
-        wsUrl: options.wsUrl
-      });
-    default:
-      throw new Error(`Unknown provider: ${options.provider}`);
-  }
-}
-
-export {
-  BrowserBaseProvider,
-  BrowserlessProvider,
-  GenericProvider,
-  discoverTargets,
-  getBrowserWebSocketUrl,
-  createProvider
-};