browser-pilot 0.0.17 → 0.0.18

package/README.md

@@ -143,6 +143,23 @@ bp env visibility hidden -s realtime
 - `listen` preserved as a compatibility alias to `trace tail`
 - `audio` for active control, `trace` for explanation, `env` for browser-state controls
 
+## Cloud provider
+
+When local Chrome is not available, [Browser Use](https://browser-use.com) is the recommended cloud provider:
+
+```bash
+BROWSER_USE_API_KEY=bu_... bp connect --provider browser-use
+```
+
+```typescript
+const browser = await connect({
+  provider: 'browser-use',
+  apiKey: process.env.BROWSER_USE_API_KEY,
+});
+```
+
+See [Providers](./docs/providers.md) for BrowserBase, Browserless, and other options.
+
 ## Programmatic example
 
 ```typescript

package/dist/{browser-4ZHNAQR5.mjs → browser-GHQRYU4R.mjs}

@@ -1,7 +1,7 @@
 import {
   Browser,
   connect
-} from "./chunk-IRLHCVNH.mjs";
+} from "./chunk-FSB25GRR.mjs";
 import "./chunk-LCNFBXB5.mjs";
 import "./chunk-MRY3HRFJ.mjs";
 import "./chunk-DTVRFXKI.mjs";

package/dist/browser.cjs

@@ -558,6 +558,108 @@ function buildCDPClient(transport, options = {}) {
   return client;
 }
 
+// src/providers/browser-use.ts
+var BrowserUseProvider = class {
+  name = "browser-use";
+  apiKey;
+  baseUrl;
+  proxyCountryCode;
+  profileId;
+  timeout;
+  allowResizing;
+  customProxy;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.browser-use.com/api/v2";
+    this.proxyCountryCode = options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode;
+    this.profileId = options.profileId;
+    this.timeout = options.timeout;
+    this.allowResizing = options.allowResizing;
+    this.customProxy = options.customProxy;
+  }
+  async createSession(options = {}) {
+    const body = {};
+    body["proxyCountryCode"] = this.proxyCountryCode;
+    if (options.width) body["browserScreenWidth"] = options.width;
+    if (options.height) body["browserScreenHeight"] = options.height;
+    if (this.profileId) body["profileId"] = this.profileId;
+    if (this.timeout !== void 0) body["timeout"] = this.timeout;
+    if (this.allowResizing !== void 0) body["allowResizing"] = this.allowResizing;
+    if (this.customProxy) body["customProxy"] = this.customProxy;
+    const response = await fetch(`${this.baseUrl}/browsers`, {
+      method: "POST",
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      this.throwApiError(response.status, text);
+    }
+    const session = await response.json();
+    if (!session.cdpUrl) {
+      throw new Error("Browser Use session does not have a cdpUrl");
+    }
+    return this.toProviderSession(session);
+  }
+  async resumeSession(sessionId) {
+    const response = await fetch(`${this.baseUrl}/browsers/${sessionId}`, {
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Browser Use resumeSession failed: ${response.status} ${text}`);
+    }
+    const session = await response.json();
+    if (session.status !== "active" || !session.cdpUrl) {
+      throw new Error(
+        "Browser Use session is not active or does not have a cdpUrl (may be stopped)"
+      );
+    }
+    return this.toProviderSession(session);
+  }
+  toProviderSession(session) {
+    return {
+      wsUrl: session.cdpUrl,
+      sessionId: session.id,
+      metadata: {
+        liveUrl: session.liveUrl,
+        status: session.status,
+        timeoutAt: session.timeoutAt,
+        proxyCountryCode: this.proxyCountryCode
+      },
+      close: async () => {
+        await fetch(`${this.baseUrl}/browsers/${session.id}`, {
+          method: "PATCH",
+          headers: {
+            "X-Browser-Use-API-Key": this.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ action: "stop" })
+        });
+      }
+    };
+  }
+  throwApiError(status, body) {
+    switch (status) {
+      case 402:
+        throw new Error(`Browser Use: insufficient credits (min $0.10 required). ${body}`);
+      case 403:
+        throw new Error(`Browser Use: invalid API key. ${body}`);
+      case 422:
+        throw new Error(`Browser Use: validation error. ${body}`);
+      case 429:
+        throw new Error(`Browser Use: rate limit exceeded. ${body}`);
+      default:
+        throw new Error(`Browser Use createSession failed: ${status} ${body}`);
+    }
+  }
+};
+
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
   name = "browserbase";
@@ -1067,6 +1169,17 @@ async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies)
   );
 }
 
+// src/runtime/env.ts
+function getProcessEnv() {
+  if (typeof globalThis.process !== "undefined" && globalThis.process.env) {
+    return globalThis.process.env;
+  }
+  return {};
+}
+function getEnv(name) {
+  return getProcessEnv()[name];
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -1088,6 +1201,18 @@ function createProvider(options) {
       return new BrowserlessProvider({
         token: options.apiKey
       });
+    case "browser-use": {
+      const apiKey = options.apiKey ?? getEnv("BROWSER_USE_API_KEY");
+      if (!apiKey) {
+        throw new Error("Browser Use provider requires apiKey or BROWSER_USE_API_KEY env var");
+      }
+      return new BrowserUseProvider({
+        apiKey,
+        proxyCountryCode: options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode,
+        profileId: options.profileId,
+        timeout: options.cloudTimeout
+      });
+    }
     case "generic":
       if (!options.wsUrl) {
         throw new Error("Generic provider requires wsUrl");
@@ -9474,6 +9599,9 @@ var Browser = class _Browser {
     }
     const provider = createProvider(connectOptions);
     const session = await provider.createSession(connectOptions.session);
+    if (session.metadata?.["liveUrl"]) {
+      console.error(`Live viewer: ${session.metadata["liveUrl"]}`);
+    }
     const cdp = await createCDPClient(session.wsUrl, {
       debug: connectOptions.debug,
       timeout: connectOptions.timeout

package/dist/browser.d.cts

@@ -1,6 +1,6 @@
 import { C as CDPClient } from './client-B5QBRgIy.cjs';
 import { TargetInfo as TargetInfo$1 } from './cdp.cjs';
-import { b as ConnectOptions } from './types-DeVSWhXj.cjs';
+import { b as ConnectOptions } from './types-D2pJQpWs.cjs';
 import { W as Page, $ as SnapshotNode, c as Condition, O as OutcomeStatus, M as MatchedCondition } from './types-Yuybzq53.cjs';
 export { m as ActionOptions, n as ActionResult, o as ConsoleHandler, p as ConsoleMessage, q as ConsoleMessageType, r as CustomSelectConfig, D as DeltaChange, t as DeltaResult, u as Dialog, v as DialogHandler, w as DialogType, x as Download, E as ElementInfo, y as ElementNotFoundError, z as EmulationState, F as ErrorHandler, av as FailureHint, I as FileInput, J as FillOptions, K as FormField, L as FormOption, N as GeolocationOptions, Q as InteractiveElement, T as KeyValuePair, U as NavigationError, V as NetworkIdleOptions, X as PageError, Y as PageSnapshot, Z as PageState, _ as ReviewResult, a0 as SnapshotOptions, a1 as SubmitOptions, a2 as SummaryCard, a3 as TableData, a4 as TimeoutError, a5 as TypeOptions, a6 as UserAgentMetadata, a7 as UserAgentOptions, a8 as ViewportOptions, a9 as WaitForOptions, s as computeDelta, G as extractPageState, H as extractReview } from './types-Yuybzq53.cjs';
 

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
 import { C as CDPClient } from './client-B5QBRgIy.js';
 import { TargetInfo as TargetInfo$1 } from './cdp.js';
-import { b as ConnectOptions } from './types-DeVSWhXj.js';
+import { b as ConnectOptions } from './types-D2pJQpWs.js';
 import { W as Page, $ as SnapshotNode, c as Condition, O as OutcomeStatus, M as MatchedCondition } from './types-B_v62K7C.js';
 export { m as ActionOptions, n as ActionResult, o as ConsoleHandler, p as ConsoleMessage, q as ConsoleMessageType, r as CustomSelectConfig, D as DeltaChange, t as DeltaResult, u as Dialog, v as DialogHandler, w as DialogType, x as Download, E as ElementInfo, y as ElementNotFoundError, z as EmulationState, F as ErrorHandler, av as FailureHint, I as FileInput, J as FillOptions, K as FormField, L as FormOption, N as GeolocationOptions, Q as InteractiveElement, T as KeyValuePair, U as NavigationError, V as NetworkIdleOptions, X as PageError, Y as PageSnapshot, Z as PageState, _ as ReviewResult, a0 as SnapshotOptions, a1 as SubmitOptions, a2 as SummaryCard, a3 as TableData, a4 as TimeoutError, a5 as TypeOptions, a6 as UserAgentMetadata, a7 as UserAgentOptions, a8 as ViewportOptions, a9 as WaitForOptions, s as computeDelta, G as extractPageState, H as extractReview } from './types-B_v62K7C.js';
 

package/dist/browser.mjs

@@ -14,8 +14,8 @@ import {
   recoverPinnedTarget,
   recoverStaleRef,
   submitAndVerify
-} from "./chunk-FEEGNSHB.mjs";
-import "./chunk-EZNZ72VA.mjs";
+} from "./chunk-SW52ALBD.mjs";
+import "./chunk-ASEIFKKV.mjs";
 import "./chunk-BVZALQT4.mjs";
 import {
   ElementNotFoundError,

package/dist/{chunk-EZNZ72VA.mjs → chunk-ASEIFKKV.mjs}

@@ -2,6 +2,108 @@ import {
   createCDPClient
 } from "./chunk-BVZALQT4.mjs";
 
+// src/providers/browser-use.ts
+var BrowserUseProvider = class {
+  name = "browser-use";
+  apiKey;
+  baseUrl;
+  proxyCountryCode;
+  profileId;
+  timeout;
+  allowResizing;
+  customProxy;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.browser-use.com/api/v2";
+    this.proxyCountryCode = options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode;
+    this.profileId = options.profileId;
+    this.timeout = options.timeout;
+    this.allowResizing = options.allowResizing;
+    this.customProxy = options.customProxy;
+  }
+  async createSession(options = {}) {
+    const body = {};
+    body["proxyCountryCode"] = this.proxyCountryCode;
+    if (options.width) body["browserScreenWidth"] = options.width;
+    if (options.height) body["browserScreenHeight"] = options.height;
+    if (this.profileId) body["profileId"] = this.profileId;
+    if (this.timeout !== void 0) body["timeout"] = this.timeout;
+    if (this.allowResizing !== void 0) body["allowResizing"] = this.allowResizing;
+    if (this.customProxy) body["customProxy"] = this.customProxy;
+    const response = await fetch(`${this.baseUrl}/browsers`, {
+      method: "POST",
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      this.throwApiError(response.status, text);
+    }
+    const session = await response.json();
+    if (!session.cdpUrl) {
+      throw new Error("Browser Use session does not have a cdpUrl");
+    }
+    return this.toProviderSession(session);
+  }
+  async resumeSession(sessionId) {
+    const response = await fetch(`${this.baseUrl}/browsers/${sessionId}`, {
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Browser Use resumeSession failed: ${response.status} ${text}`);
+    }
+    const session = await response.json();
+    if (session.status !== "active" || !session.cdpUrl) {
+      throw new Error(
+        "Browser Use session is not active or does not have a cdpUrl (may be stopped)"
+      );
+    }
+    return this.toProviderSession(session);
+  }
+  toProviderSession(session) {
+    return {
+      wsUrl: session.cdpUrl,
+      sessionId: session.id,
+      metadata: {
+        liveUrl: session.liveUrl,
+        status: session.status,
+        timeoutAt: session.timeoutAt,
+        proxyCountryCode: this.proxyCountryCode
+      },
+      close: async () => {
+        await fetch(`${this.baseUrl}/browsers/${session.id}`, {
+          method: "PATCH",
+          headers: {
+            "X-Browser-Use-API-Key": this.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ action: "stop" })
+        });
+      }
+    };
+  }
+  throwApiError(status, body) {
+    switch (status) {
+      case 402:
+        throw new Error(`Browser Use: insufficient credits (min $0.10 required). ${body}`);
+      case 403:
+        throw new Error(`Browser Use: invalid API key. ${body}`);
+      case 422:
+        throw new Error(`Browser Use: validation error. ${body}`);
+      case 429:
+        throw new Error(`Browser Use: rate limit exceeded. ${body}`);
+      default:
+        throw new Error(`Browser Use createSession failed: ${status} ${body}`);
+    }
+  }
+};
+
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
   name = "browserbase";
@@ -514,6 +616,17 @@ async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies)
   );
 }
 
+// src/runtime/env.ts
+function getProcessEnv() {
+  if (typeof globalThis.process !== "undefined" && globalThis.process.env) {
+    return globalThis.process.env;
+  }
+  return {};
+}
+function getEnv(name) {
+  return getProcessEnv()[name];
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -535,6 +648,18 @@ function createProvider(options) {
       return new BrowserlessProvider({
         token: options.apiKey
       });
+    case "browser-use": {
+      const apiKey = options.apiKey ?? getEnv("BROWSER_USE_API_KEY");
+      if (!apiKey) {
+        throw new Error("Browser Use provider requires apiKey or BROWSER_USE_API_KEY env var");
+      }
+      return new BrowserUseProvider({
+        apiKey,
+        proxyCountryCode: options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode,
+        profileId: options.profileId,
+        timeout: options.cloudTimeout
+      });
+    }
     case "generic":
       if (!options.wsUrl) {
         throw new Error("Generic provider requires wsUrl");
@@ -548,6 +673,7 @@ function createProvider(options) {
 }
 
 export {
+  BrowserUseProvider,
   BrowserBaseProvider,
   BrowserlessProvider,
   GenericProvider,

package/dist/{chunk-IRLHCVNH.mjs → chunk-FSB25GRR.mjs}

@@ -5,6 +5,108 @@ import {
   Page
 } from "./chunk-MRY3HRFJ.mjs";
 
+// src/providers/browser-use.ts
+var BrowserUseProvider = class {
+  name = "browser-use";
+  apiKey;
+  baseUrl;
+  proxyCountryCode;
+  profileId;
+  timeout;
+  allowResizing;
+  customProxy;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.browser-use.com/api/v2";
+    this.proxyCountryCode = options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode;
+    this.profileId = options.profileId;
+    this.timeout = options.timeout;
+    this.allowResizing = options.allowResizing;
+    this.customProxy = options.customProxy;
+  }
+  async createSession(options = {}) {
+    const body = {};
+    body["proxyCountryCode"] = this.proxyCountryCode;
+    if (options.width) body["browserScreenWidth"] = options.width;
+    if (options.height) body["browserScreenHeight"] = options.height;
+    if (this.profileId) body["profileId"] = this.profileId;
+    if (this.timeout !== void 0) body["timeout"] = this.timeout;
+    if (this.allowResizing !== void 0) body["allowResizing"] = this.allowResizing;
+    if (this.customProxy) body["customProxy"] = this.customProxy;
+    const response = await fetch(`${this.baseUrl}/browsers`, {
+      method: "POST",
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      this.throwApiError(response.status, text);
+    }
+    const session = await response.json();
+    if (!session.cdpUrl) {
+      throw new Error("Browser Use session does not have a cdpUrl");
+    }
+    return this.toProviderSession(session);
+  }
+  async resumeSession(sessionId) {
+    const response = await fetch(`${this.baseUrl}/browsers/${sessionId}`, {
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Browser Use resumeSession failed: ${response.status} ${text}`);
+    }
+    const session = await response.json();
+    if (session.status !== "active" || !session.cdpUrl) {
+      throw new Error(
+        "Browser Use session is not active or does not have a cdpUrl (may be stopped)"
+      );
+    }
+    return this.toProviderSession(session);
+  }
+  toProviderSession(session) {
+    return {
+      wsUrl: session.cdpUrl,
+      sessionId: session.id,
+      metadata: {
+        liveUrl: session.liveUrl,
+        status: session.status,
+        timeoutAt: session.timeoutAt,
+        proxyCountryCode: this.proxyCountryCode
+      },
+      close: async () => {
+        await fetch(`${this.baseUrl}/browsers/${session.id}`, {
+          method: "PATCH",
+          headers: {
+            "X-Browser-Use-API-Key": this.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ action: "stop" })
+        });
+      }
+    };
+  }
+  throwApiError(status, body) {
+    switch (status) {
+      case 402:
+        throw new Error(`Browser Use: insufficient credits (min $0.10 required). ${body}`);
+      case 403:
+        throw new Error(`Browser Use: invalid API key. ${body}`);
+      case 422:
+        throw new Error(`Browser Use: validation error. ${body}`);
+      case 429:
+        throw new Error(`Browser Use: rate limit exceeded. ${body}`);
+      default:
+        throw new Error(`Browser Use createSession failed: ${status} ${body}`);
+    }
+  }
+};
+
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
   name = "browserbase";
@@ -514,6 +616,17 @@ async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies)
   );
 }
 
+// src/runtime/env.ts
+function getProcessEnv() {
+  if (typeof globalThis.process !== "undefined" && globalThis.process.env) {
+    return globalThis.process.env;
+  }
+  return {};
+}
+function getEnv(name) {
+  return getProcessEnv()[name];
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -535,6 +648,18 @@ function createProvider(options) {
       return new BrowserlessProvider({
         token: options.apiKey
       });
+    case "browser-use": {
+      const apiKey = options.apiKey ?? getEnv("BROWSER_USE_API_KEY");
+      if (!apiKey) {
+        throw new Error("Browser Use provider requires apiKey or BROWSER_USE_API_KEY env var");
+      }
+      return new BrowserUseProvider({
+        apiKey,
+        proxyCountryCode: options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode,
+        profileId: options.profileId,
+        timeout: options.cloudTimeout
+      });
+    }
     case "generic":
       if (!options.wsUrl) {
         throw new Error("Generic provider requires wsUrl");
@@ -611,6 +736,9 @@ var Browser = class _Browser {
     }
     const provider = createProvider(connectOptions);
     const session = await provider.createSession(connectOptions.session);
+    if (session.metadata?.["liveUrl"]) {
+      console.error(`Live viewer: ${session.metadata["liveUrl"]}`);
+    }
     const cdp = await createCDPClient(session.wsUrl, {
       debug: connectOptions.debug,
       timeout: connectOptions.timeout

package/dist/{chunk-FEEGNSHB.mjs → chunk-SW52ALBD.mjs}

@@ -1,7 +1,7 @@
 import {
   createProvider,
   resolveBrowserEndpoint
-} from "./chunk-EZNZ72VA.mjs";
+} from "./chunk-ASEIFKKV.mjs";
 import {
   createCDPClient,
   stringifyUnknown
@@ -5666,6 +5666,9 @@ var Browser = class _Browser {
     }
     const provider = createProvider(connectOptions);
     const session = await provider.createSession(connectOptions.session);
+    if (session.metadata?.["liveUrl"]) {
+      console.error(`Live viewer: ${session.metadata["liveUrl"]}`);
+    }
     const cdp = await createCDPClient(session.wsUrl, {
       debug: connectOptions.debug,
       timeout: connectOptions.timeout

package/dist/cli.mjs

@@ -5,7 +5,7 @@ import {
   BrowserEndpointResolutionError,
   connect,
   resolveBrowserEndpoint
-} from "./chunk-IRLHCVNH.mjs";
+} from "./chunk-FSB25GRR.mjs";
 import "./chunk-LCNFBXB5.mjs";
 import {
   DEEP_QUERY_SCRIPT,
@@ -2186,7 +2186,7 @@ Usage:
   bp connect [options]
 
 Local options:
-  -p, --provider <type>   Provider: generic | browserbase | browserless (default: generic)
+  -p, --provider <type>   Provider: generic | browserbase | browserless | browser-use (default: generic)
   --browser-url <ws-url>  Explicit browser WebSocket URL (preferred)
   --page-url <url>        Page URL to open in the attached tab/new tab (preferred)
   --url <value>           Compatibility shorthand; browser URL, or page URL with --new-tab
@@ -2199,6 +2199,9 @@ Local options:
   --target-url <str>      Filter targets to those whose URL contains this string
   --api-key <key>         API key for cloud providers
   --project-id <id>       Project ID for BrowserBase provider
+  --proxy-country <code>  Proxy country code for browser-use (default: uk)
+  --profile-id <id>       Browser profile ID for browser-use
+  --cloud-timeout <mins>  Session timeout in minutes for browser-use (max 240)
   --export-log <path>     Export session log to file on close
   --record                Enable screenshot recording for all subsequent exec calls
   --record-format <fmt>   Screenshot format: webp (default), png, jpeg
@@ -2224,6 +2227,10 @@ Examples:
   bp connect --record                            # Connect with session-level recording
   bp connect --new-tab --page-url https://example.com
   bp connect --no-daemon                         # Connect without daemon (file-based only)
+  bp connect --provider browser-use                              # UK proxy (default)
+  bp connect --provider browser-use --proxy-country de           # German proxy
+  bp connect --provider browser-use --proxy-country null         # No proxy
+  bp connect --provider browser-use --cloud-timeout 30           # 30-min session
 
 Likely next commands:
   bp exec -s dev '{"action":"goto","url":"https://example.com"}'
@@ -2251,9 +2258,9 @@ function parseConnectArgs(args) {
     const arg = args[i];
     if (arg === "--provider" || arg === "-p") {
       const p = args[++i];
-      if (p !== "browserbase" && p !== "browserless" && p !== "generic") {
+      if (p !== "browserbase" && p !== "browserless" && p !== "browser-use" && p !== "generic") {
         throw new Error(
-          `Invalid provider: ${p}. Must be one of: browserbase, browserless, generic`
+          `Invalid provider: ${p}. Must be one of: browserbase, browserless, browser-use, generic`
         );
       }
       options.provider = p;
@@ -2307,6 +2314,17 @@ function parseConnectArgs(args) {
       options.noDaemon = true;
     } else if (arg === "--daemon-idle") {
       options.daemonIdleMins = parseInt(args[++i] ?? "60", 10);
+    } else if (arg === "--proxy-country") {
+      const val = args[++i];
+      options.proxyCountry = val === "null" ? null : val;
+    } else if (arg === "--profile-id") {
+      options.profileId = args[++i];
+    } else if (arg === "--cloud-timeout") {
+      const mins = parseInt(args[++i] ?? "", 10);
+      if (Number.isNaN(mins) || mins < 1 || mins > 240) {
+        throw new Error("--cloud-timeout must be 1-240 minutes");
+      }
+      options.cloudTimeout = mins;
     }
   }
   return options;
@@ -2381,7 +2399,10 @@ async function connectCommand(args, globalOptions) {
     channel: options.channel,
     userDataDir: options.userDataDir,
     apiKey: options.apiKey,
-    projectId: options.projectId
+    projectId: options.projectId,
+    proxyCountryCode: options.proxyCountry,
+    profileId: options.profileId,
+    cloudTimeout: options.cloudTimeout
   };
   const browser = await connect(connectOptions);
   const page = options.newTab ? await browser.newPage(pageUrl ?? "about:blank") : await browser.page(
@@ -2389,6 +2410,11 @@ async function connectCommand(args, globalOptions) {
     options.targetUrl ? { targetUrl: options.targetUrl } : void 0
   );
   const currentUrl = await resolveInitialPageUrl(page, pageUrl);
+  if (browser.metadata?.["liveUrl"]) {
+    console.error(`
+Live viewer: ${browser.metadata["liveUrl"]}
+`);
+  }
   const sessionId = options.name ?? generateSessionId();
   let recordSettings;
   if (options.record) {
@@ -4148,7 +4174,7 @@ async function attachSession(session, options = {}) {
         const cdp = createCDPClientFromTransport(transport, {
           debug: options.trace
         });
-        const { Browser: BrowserClass } = await import("./browser-4ZHNAQR5.mjs");
+        const { Browser: BrowserClass } = await import("./browser-GHQRYU4R.mjs");
         const { Page: PageClass } = await import("./page-SD64DY3F.mjs");
         const browser2 = BrowserClass.fromCDP(cdp, session);
         const page2 = session.daemon.cdpSessionId && session.targetId ? addBatchToPage(
@@ -8294,7 +8320,7 @@ function getCliVersion() {
   if (cachedCliVersion) {
     return cachedCliVersion;
   }
-  cachedCliVersion = "0.0.17";
+  cachedCliVersion = "0.0.18";
   return cachedCliVersion;
 }
 

package/dist/index.cjs

@@ -239,6 +239,7 @@ __export(src_exports, {
   Browser: () => Browser,
   BrowserBaseProvider: () => BrowserBaseProvider,
   BrowserEndpointResolutionError: () => BrowserEndpointResolutionError,
+  BrowserUseProvider: () => BrowserUseProvider,
   BrowserlessProvider: () => BrowserlessProvider,
   CDPError: () => CDPError,
   ElementNotFoundError: () => ElementNotFoundError,
@@ -5661,6 +5662,108 @@ function buildCDPClient(transport, options = {}) {
   return client;
 }
 
+// src/providers/browser-use.ts
+var BrowserUseProvider = class {
+  name = "browser-use";
+  apiKey;
+  baseUrl;
+  proxyCountryCode;
+  profileId;
+  timeout;
+  allowResizing;
+  customProxy;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.browser-use.com/api/v2";
+    this.proxyCountryCode = options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode;
+    this.profileId = options.profileId;
+    this.timeout = options.timeout;
+    this.allowResizing = options.allowResizing;
+    this.customProxy = options.customProxy;
+  }
+  async createSession(options = {}) {
+    const body = {};
+    body["proxyCountryCode"] = this.proxyCountryCode;
+    if (options.width) body["browserScreenWidth"] = options.width;
+    if (options.height) body["browserScreenHeight"] = options.height;
+    if (this.profileId) body["profileId"] = this.profileId;
+    if (this.timeout !== void 0) body["timeout"] = this.timeout;
+    if (this.allowResizing !== void 0) body["allowResizing"] = this.allowResizing;
+    if (this.customProxy) body["customProxy"] = this.customProxy;
+    const response = await fetch(`${this.baseUrl}/browsers`, {
+      method: "POST",
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      this.throwApiError(response.status, text);
+    }
+    const session = await response.json();
+    if (!session.cdpUrl) {
+      throw new Error("Browser Use session does not have a cdpUrl");
+    }
+    return this.toProviderSession(session);
+  }
+  async resumeSession(sessionId) {
+    const response = await fetch(`${this.baseUrl}/browsers/${sessionId}`, {
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Browser Use resumeSession failed: ${response.status} ${text}`);
+    }
+    const session = await response.json();
+    if (session.status !== "active" || !session.cdpUrl) {
+      throw new Error(
+        "Browser Use session is not active or does not have a cdpUrl (may be stopped)"
+      );
+    }
+    return this.toProviderSession(session);
+  }
+  toProviderSession(session) {
+    return {
+      wsUrl: session.cdpUrl,
+      sessionId: session.id,
+      metadata: {
+        liveUrl: session.liveUrl,
+        status: session.status,
+        timeoutAt: session.timeoutAt,
+        proxyCountryCode: this.proxyCountryCode
+      },
+      close: async () => {
+        await fetch(`${this.baseUrl}/browsers/${session.id}`, {
+          method: "PATCH",
+          headers: {
+            "X-Browser-Use-API-Key": this.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ action: "stop" })
+        });
+      }
+    };
+  }
+  throwApiError(status, body) {
+    switch (status) {
+      case 402:
+        throw new Error(`Browser Use: insufficient credits (min $0.10 required). ${body}`);
+      case 403:
+        throw new Error(`Browser Use: invalid API key. ${body}`);
+      case 422:
+        throw new Error(`Browser Use: validation error. ${body}`);
+      case 429:
+        throw new Error(`Browser Use: rate limit exceeded. ${body}`);
+      default:
+        throw new Error(`Browser Use createSession failed: ${status} ${body}`);
+    }
+  }
+};
+
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
   name = "browserbase";
@@ -6173,6 +6276,17 @@ async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies)
   );
 }
 
+// src/runtime/env.ts
+function getProcessEnv() {
+  if (typeof globalThis.process !== "undefined" && globalThis.process.env) {
+    return globalThis.process.env;
+  }
+  return {};
+}
+function getEnv(name) {
+  return getProcessEnv()[name];
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -6194,6 +6308,18 @@ function createProvider(options) {
       return new BrowserlessProvider({
         token: options.apiKey
       });
+    case "browser-use": {
+      const apiKey = options.apiKey ?? getEnv("BROWSER_USE_API_KEY");
+      if (!apiKey) {
+        throw new Error("Browser Use provider requires apiKey or BROWSER_USE_API_KEY env var");
+      }
+      return new BrowserUseProvider({
+        apiKey,
+        proxyCountryCode: options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode,
+        profileId: options.profileId,
+        timeout: options.cloudTimeout
+      });
+    }
     case "generic":
       if (!options.wsUrl) {
         throw new Error("Generic provider requires wsUrl");
@@ -10543,6 +10669,9 @@ var Browser = class _Browser {
     }
     const provider = createProvider(connectOptions);
     const session = await provider.createSession(connectOptions.session);
+    if (session.metadata?.["liveUrl"]) {
+      console.error(`Live viewer: ${session.metadata["liveUrl"]}`);
+    }
     const cdp = await createCDPClient(session.wsUrl, {
       debug: connectOptions.debug,
       timeout: connectOptions.timeout
@@ -11401,6 +11530,7 @@ function formatWorkflowSummary(summary) {
   Browser,
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   CDPError,
   ElementNotFoundError,

package/dist/index.d.cts

@@ -5,8 +5,8 @@ import { C as CDPClient } from './client-B5QBRgIy.cjs';
 export { a as CDPClientOptions, c as createCDPClient } from './client-B5QBRgIy.cjs';
 export { Browser, BrowserOptions, ComboboxConfig, ComboboxResult, OverlayInfo, PageOptions, PinRecoveryResult, SemanticFingerprint, SubmitAndVerifyOptions, SubmitAndVerifyResult, TargetFingerprint, UploadConfig, UploadResult, buildFingerprintMap, chooseOption, connect, createFingerprint, createTargetFingerprint, detectOverlay, fingerprintKey, fingerprintSimilarity, recoverPinnedTarget, recoverStaleRef, submitAndVerify, uploadFiles } from './browser.cjs';
 export { CDPError } from './cdp.cjs';
-export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.cjs';
-export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.cjs';
+export { BrowserBaseProvider, BrowserUseOptions, BrowserUseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.cjs';
+export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-D2pJQpWs.cjs';
 
 /**
  * Request interception implementation

package/dist/index.d.ts

@@ -5,8 +5,8 @@ import { C as CDPClient } from './client-B5QBRgIy.js';
 export { a as CDPClientOptions, c as createCDPClient } from './client-B5QBRgIy.js';
 export { Browser, BrowserOptions, ComboboxConfig, ComboboxResult, OverlayInfo, PageOptions, PinRecoveryResult, SemanticFingerprint, SubmitAndVerifyOptions, SubmitAndVerifyResult, TargetFingerprint, UploadConfig, UploadResult, buildFingerprintMap, chooseOption, connect, createFingerprint, createTargetFingerprint, detectOverlay, fingerprintKey, fingerprintSimilarity, recoverPinnedTarget, recoverStaleRef, submitAndVerify, uploadFiles } from './browser.js';
 export { CDPError } from './cdp.js';
-export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.js';
-export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.js';
+export { BrowserBaseProvider, BrowserUseOptions, BrowserUseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.js';
+export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-D2pJQpWs.js';
 
 /**
  * Request interception implementation

package/dist/index.mjs

@@ -28,10 +28,11 @@ import {
   waitForElement,
   waitForNavigation,
   waitForNetworkIdle
-} from "./chunk-FEEGNSHB.mjs";
+} from "./chunk-SW52ALBD.mjs";
 import {
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   GenericProvider,
   buildLocalBrowserScanTargets,
@@ -42,7 +43,7 @@ import {
   parseDevToolsActivePortFile,
   resolveBrowserEndpoint,
   resolveChromeUserDataDirs
-} from "./chunk-EZNZ72VA.mjs";
+} from "./chunk-ASEIFKKV.mjs";
 import {
   createCDPClient
 } from "./chunk-BVZALQT4.mjs";
@@ -546,6 +547,7 @@ export {
   Browser,
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   CDPError,
   ElementNotFoundError,

package/dist/providers.cjs

@@ -32,6 +32,7 @@ var providers_exports = {};
 __export(providers_exports, {
   BrowserBaseProvider: () => BrowserBaseProvider,
   BrowserEndpointResolutionError: () => BrowserEndpointResolutionError,
+  BrowserUseProvider: () => BrowserUseProvider,
   BrowserlessProvider: () => BrowserlessProvider,
   GenericProvider: () => GenericProvider,
   buildLocalBrowserScanTargets: () => buildLocalBrowserScanTargets,
@@ -45,6 +46,108 @@ __export(providers_exports, {
 });
 module.exports = __toCommonJS(providers_exports);
 
+// src/providers/browser-use.ts
+var BrowserUseProvider = class {
+  name = "browser-use";
+  apiKey;
+  baseUrl;
+  proxyCountryCode;
+  profileId;
+  timeout;
+  allowResizing;
+  customProxy;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://api.browser-use.com/api/v2";
+    this.proxyCountryCode = options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode;
+    this.profileId = options.profileId;
+    this.timeout = options.timeout;
+    this.allowResizing = options.allowResizing;
+    this.customProxy = options.customProxy;
+  }
+  async createSession(options = {}) {
+    const body = {};
+    body["proxyCountryCode"] = this.proxyCountryCode;
+    if (options.width) body["browserScreenWidth"] = options.width;
+    if (options.height) body["browserScreenHeight"] = options.height;
+    if (this.profileId) body["profileId"] = this.profileId;
+    if (this.timeout !== void 0) body["timeout"] = this.timeout;
+    if (this.allowResizing !== void 0) body["allowResizing"] = this.allowResizing;
+    if (this.customProxy) body["customProxy"] = this.customProxy;
+    const response = await fetch(`${this.baseUrl}/browsers`, {
+      method: "POST",
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      this.throwApiError(response.status, text);
+    }
+    const session = await response.json();
+    if (!session.cdpUrl) {
+      throw new Error("Browser Use session does not have a cdpUrl");
+    }
+    return this.toProviderSession(session);
+  }
+  async resumeSession(sessionId) {
+    const response = await fetch(`${this.baseUrl}/browsers/${sessionId}`, {
+      headers: {
+        "X-Browser-Use-API-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Browser Use resumeSession failed: ${response.status} ${text}`);
+    }
+    const session = await response.json();
+    if (session.status !== "active" || !session.cdpUrl) {
+      throw new Error(
+        "Browser Use session is not active or does not have a cdpUrl (may be stopped)"
+      );
+    }
+    return this.toProviderSession(session);
+  }
+  toProviderSession(session) {
+    return {
+      wsUrl: session.cdpUrl,
+      sessionId: session.id,
+      metadata: {
+        liveUrl: session.liveUrl,
+        status: session.status,
+        timeoutAt: session.timeoutAt,
+        proxyCountryCode: this.proxyCountryCode
+      },
+      close: async () => {
+        await fetch(`${this.baseUrl}/browsers/${session.id}`, {
+          method: "PATCH",
+          headers: {
+            "X-Browser-Use-API-Key": this.apiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ action: "stop" })
+        });
+      }
+    };
+  }
+  throwApiError(status, body) {
+    switch (status) {
+      case 402:
+        throw new Error(`Browser Use: insufficient credits (min $0.10 required). ${body}`);
+      case 403:
+        throw new Error(`Browser Use: invalid API key. ${body}`);
+      case 422:
+        throw new Error(`Browser Use: validation error. ${body}`);
+      case 429:
+        throw new Error(`Browser Use: rate limit exceeded. ${body}`);
+      default:
+        throw new Error(`Browser Use createSession failed: ${status} ${body}`);
+    }
+  }
+};
+
 // src/providers/browserbase.ts
 var BrowserBaseProvider = class {
   name = "browserbase";
@@ -846,6 +949,17 @@ async function resolveBrowserEndpoint(options = {}, deps = defaultDependencies)
   );
 }
 
+// src/runtime/env.ts
+function getProcessEnv() {
+  if (typeof globalThis.process !== "undefined" && globalThis.process.env) {
+    return globalThis.process.env;
+  }
+  return {};
+}
+function getEnv(name) {
+  return getProcessEnv()[name];
+}
+
 // src/providers/index.ts
 function createProvider(options) {
   switch (options.provider) {
@@ -867,6 +981,18 @@ function createProvider(options) {
       return new BrowserlessProvider({
         token: options.apiKey
       });
+    case "browser-use": {
+      const apiKey = options.apiKey ?? getEnv("BROWSER_USE_API_KEY");
+      if (!apiKey) {
+        throw new Error("Browser Use provider requires apiKey or BROWSER_USE_API_KEY env var");
+      }
+      return new BrowserUseProvider({
+        apiKey,
+        proxyCountryCode: options.proxyCountryCode === void 0 ? "uk" : options.proxyCountryCode,
+        profileId: options.profileId,
+        timeout: options.cloudTimeout
+      });
+    }
     case "generic":
       if (!options.wsUrl) {
         throw new Error("Generic provider requires wsUrl");
@@ -882,6 +1008,7 @@ function createProvider(options) {
 0 && (module.exports = {
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   GenericProvider,
   buildLocalBrowserScanTargets,

package/dist/providers.d.cts

@@ -1,5 +1,40 @@
-import { P as Provider, C as CreateSessionOptions, a as ProviderSession, b as ConnectOptions } from './types-DeVSWhXj.cjs';
-export { B as BrowserEndpointResolutionError, d as ChromeChannel, e as ChromeUserDataDirOptions, D as DiscoverLocalBrowsersOptions, i as ProxyConfig, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.cjs';
+import { P as Provider, C as CreateSessionOptions, a as ProviderSession, b as ConnectOptions } from './types-D2pJQpWs.cjs';
+export { B as BrowserEndpointResolutionError, d as ChromeChannel, e as ChromeUserDataDirOptions, D as DiscoverLocalBrowsersOptions, i as ProxyConfig, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-D2pJQpWs.cjs';
+
+/**
+ * Browser Use provider implementation
+ * https://browser-use.com/
+ */
+
+interface BrowserUseOptions {
+    apiKey: string;
+    baseUrl?: string;
+    proxyCountryCode?: string | null;
+    profileId?: string;
+    timeout?: number;
+    allowResizing?: boolean;
+    customProxy?: {
+        host: string;
+        port: number;
+        username?: string;
+        password?: string;
+    };
+}
+declare class BrowserUseProvider implements Provider {
+    readonly name = "browser-use";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly proxyCountryCode;
+    private readonly profileId?;
+    private readonly timeout?;
+    private readonly allowResizing?;
+    private readonly customProxy?;
+    constructor(options: BrowserUseOptions);
+    createSession(options?: CreateSessionOptions): Promise<ProviderSession>;
+    resumeSession(sessionId: string): Promise<ProviderSession>;
+    private toProviderSession;
+    private throwApiError;
+}
 
 /**
  * BrowserBase provider implementation
@@ -83,4 +118,4 @@ declare function getBrowserWebSocketUrl(host?: string): Promise<string>;
  */
 declare function createProvider(options: ConnectOptions): Provider;
 
-export { type BrowserBaseOptions, BrowserBaseProvider, type BrowserlessOptions, BrowserlessProvider, ConnectOptions, CreateSessionOptions, GenericProvider, type GenericProviderOptions, Provider, ProviderSession, createProvider, discoverTargets, getBrowserWebSocketUrl };
+export { type BrowserBaseOptions, BrowserBaseProvider, type BrowserUseOptions, BrowserUseProvider, type BrowserlessOptions, BrowserlessProvider, ConnectOptions, CreateSessionOptions, GenericProvider, type GenericProviderOptions, Provider, ProviderSession, createProvider, discoverTargets, getBrowserWebSocketUrl };

package/dist/providers.d.ts

@@ -1,5 +1,40 @@
-import { P as Provider, C as CreateSessionOptions, a as ProviderSession, b as ConnectOptions } from './types-DeVSWhXj.js';
-export { B as BrowserEndpointResolutionError, d as ChromeChannel, e as ChromeUserDataDirOptions, D as DiscoverLocalBrowsersOptions, i as ProxyConfig, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.js';
+import { P as Provider, C as CreateSessionOptions, a as ProviderSession, b as ConnectOptions } from './types-D2pJQpWs.js';
+export { B as BrowserEndpointResolutionError, d as ChromeChannel, e as ChromeUserDataDirOptions, D as DiscoverLocalBrowsersOptions, i as ProxyConfig, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-D2pJQpWs.js';
+
+/**
+ * Browser Use provider implementation
+ * https://browser-use.com/
+ */
+
+interface BrowserUseOptions {
+    apiKey: string;
+    baseUrl?: string;
+    proxyCountryCode?: string | null;
+    profileId?: string;
+    timeout?: number;
+    allowResizing?: boolean;
+    customProxy?: {
+        host: string;
+        port: number;
+        username?: string;
+        password?: string;
+    };
+}
+declare class BrowserUseProvider implements Provider {
+    readonly name = "browser-use";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly proxyCountryCode;
+    private readonly profileId?;
+    private readonly timeout?;
+    private readonly allowResizing?;
+    private readonly customProxy?;
+    constructor(options: BrowserUseOptions);
+    createSession(options?: CreateSessionOptions): Promise<ProviderSession>;
+    resumeSession(sessionId: string): Promise<ProviderSession>;
+    private toProviderSession;
+    private throwApiError;
+}
 
 /**
  * BrowserBase provider implementation
@@ -83,4 +118,4 @@ declare function getBrowserWebSocketUrl(host?: string): Promise<string>;
  */
 declare function createProvider(options: ConnectOptions): Provider;
 
-export { type BrowserBaseOptions, BrowserBaseProvider, type BrowserlessOptions, BrowserlessProvider, ConnectOptions, CreateSessionOptions, GenericProvider, type GenericProviderOptions, Provider, ProviderSession, createProvider, discoverTargets, getBrowserWebSocketUrl };
+export { type BrowserBaseOptions, BrowserBaseProvider, type BrowserUseOptions, BrowserUseProvider, type BrowserlessOptions, BrowserlessProvider, ConnectOptions, CreateSessionOptions, GenericProvider, type GenericProviderOptions, Provider, ProviderSession, createProvider, discoverTargets, getBrowserWebSocketUrl };

package/dist/providers.mjs

@@ -1,6 +1,7 @@
 import {
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   GenericProvider,
   buildLocalBrowserScanTargets,
@@ -11,12 +12,13 @@ import {
   parseDevToolsActivePortFile,
   resolveBrowserEndpoint,
   resolveChromeUserDataDirs
-} from "./chunk-EZNZ72VA.mjs";
+} from "./chunk-ASEIFKKV.mjs";
 import "./chunk-BVZALQT4.mjs";
 import "./chunk-JXAUPHZM.mjs";
 export {
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
+  BrowserUseProvider,
   BrowserlessProvider,
   GenericProvider,
   buildLocalBrowserScanTargets,

package/dist/{types-DeVSWhXj.d.cts → types-D2pJQpWs.d.cts}

@@ -120,7 +120,7 @@ interface ProxyConfig {
 }
 interface ConnectOptions {
     /** Provider type */
-    provider: 'browserbase' | 'browserless' | 'generic';
+    provider: 'browserbase' | 'browserless' | 'browser-use' | 'generic';
     /** API key for hosted providers */
     apiKey?: string;
     /** Project ID (for BrowserBase) */
@@ -137,6 +137,12 @@ interface ConnectOptions {
     debug?: boolean;
     /** Connection timeout in ms */
     timeout?: number;
+    /** Proxy country code for Browser Use provider (default: 'uk'). Set null to disable. */
+    proxyCountryCode?: string | null;
+    /** Browser profile ID for Browser Use provider */
+    profileId?: string;
+    /** Session timeout in minutes for Browser Use provider (max 240) */
+    cloudTimeout?: 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 → types-D2pJQpWs.d.ts}

@@ -120,7 +120,7 @@ interface ProxyConfig {
 }
 interface ConnectOptions {
     /** Provider type */
-    provider: 'browserbase' | 'browserless' | 'generic';
+    provider: 'browserbase' | 'browserless' | 'browser-use' | 'generic';
     /** API key for hosted providers */
     apiKey?: string;
     /** Project ID (for BrowserBase) */
@@ -137,6 +137,12 @@ interface ConnectOptions {
     debug?: boolean;
     /** Connection timeout in ms */
     timeout?: number;
+    /** Proxy country code for Browser Use provider (default: 'uk'). Set null to disable. */
+    proxyCountryCode?: string | null;
+    /** Browser profile ID for Browser Use provider */
+    profileId?: string;
+    /** Session timeout in minutes for Browser Use provider (max 240) */
+    cloudTimeout?: 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.17",
+  "version": "0.0.18",
   "description": "Lightweight CDP-based browser automation for Node.js, Bun, and Cloudflare Workers",
   "type": "module",
   "main": "./dist/index.cjs",