browser-use 0.4.0 → 0.6.0

package/dist/browser/events.js

@@ -276,6 +276,34 @@ export class BrowserConnectedEvent extends BrowserEvent {
         this.cdp_url = init.cdp_url;
     }
 }
+export class BrowserReconnectingEvent extends BrowserEvent {
+    cdp_url;
+    attempt;
+    max_attempts;
+    constructor(init) {
+        super('BrowserReconnectingEvent', {
+            ...init,
+            event_timeout: resolveEventTimeout('BrowserReconnectingEvent', 30, init.event_timeout),
+        });
+        this.cdp_url = init.cdp_url;
+        this.attempt = init.attempt;
+        this.max_attempts = init.max_attempts;
+    }
+}
+export class BrowserReconnectedEvent extends BrowserEvent {
+    cdp_url;
+    attempt;
+    downtime_seconds;
+    constructor(init) {
+        super('BrowserReconnectedEvent', {
+            ...init,
+            event_timeout: resolveEventTimeout('BrowserReconnectedEvent', 30, init.event_timeout),
+        });
+        this.cdp_url = init.cdp_url;
+        this.attempt = init.attempt;
+        this.downtime_seconds = init.downtime_seconds;
+    }
+}
 export class BrowserStoppedEvent extends BrowserEvent {
     reason;
     constructor(init = {}) {
@@ -286,6 +314,42 @@ export class BrowserStoppedEvent extends BrowserEvent {
         this.reason = init.reason ?? null;
     }
 }
+export class CaptchaSolverStartedEvent extends BrowserEvent {
+    target_id;
+    vendor;
+    url;
+    started_at;
+    constructor(init) {
+        super('CaptchaSolverStartedEvent', {
+            ...init,
+            event_timeout: resolveEventTimeout('CaptchaSolverStartedEvent', 5, init.event_timeout),
+        });
+        this.target_id = init.target_id;
+        this.vendor = init.vendor;
+        this.url = init.url;
+        this.started_at = init.started_at;
+    }
+}
+export class CaptchaSolverFinishedEvent extends BrowserEvent {
+    target_id;
+    vendor;
+    url;
+    duration_ms;
+    finished_at;
+    success;
+    constructor(init) {
+        super('CaptchaSolverFinishedEvent', {
+            ...init,
+            event_timeout: resolveEventTimeout('CaptchaSolverFinishedEvent', 5, init.event_timeout),
+        });
+        this.target_id = init.target_id;
+        this.vendor = init.vendor;
+        this.url = init.url;
+        this.duration_ms = init.duration_ms;
+        this.finished_at = init.finished_at;
+        this.success = init.success;
+    }
+}
 export class TabCreatedEvent extends BrowserEvent {
     target_id;
     url;
@@ -529,6 +593,8 @@ export const BROWSER_EVENT_CLASSES = [
     BrowserLaunchEvent,
     BrowserKillEvent,
     BrowserConnectedEvent,
+    BrowserReconnectingEvent,
+    BrowserReconnectedEvent,
     BrowserStoppedEvent,
     TabCreatedEvent,
     TabClosedEvent,

package/dist/browser/profile.d.ts

@@ -137,6 +137,7 @@ export interface BrowserProfileSpecificOptions {
     block_ip_addresses: boolean;
     keep_alive: Nullable<boolean>;
     enable_default_extensions: boolean;
+    captcha_solver: boolean;
     window_size: Nullable<ViewportSize>;
     window_height: Nullable<number>;
     window_width: Nullable<number>;

package/dist/browser/profile.js

@@ -344,6 +344,7 @@ const DEFAULT_BROWSER_PROFILE_OPTIONS = {
     block_ip_addresses: false,
     keep_alive: null,
     enable_default_extensions: getEnableDefaultExtensionsDefault(),
+    captcha_solver: true,
     window_size: null,
     window_height: null,
     window_width: null,
@@ -360,10 +361,17 @@ const DEFAULT_BROWSER_PROFILE_OPTIONS = {
     profile_directory: 'Default',
     cookies_file: null,
 };
+const splitArgOnce = (arg) => {
+    const separatorIndex = arg.indexOf('=');
+    if (separatorIndex === -1) {
+        return [arg, ''];
+    }
+    return [arg.slice(0, separatorIndex), arg.slice(separatorIndex + 1)];
+};
 const argsAsDict = (args) => {
     const result = {};
     for (const arg of args) {
-        const [keyPart, valuePart = ''] = arg.split('=', 1);
+        const [keyPart, valuePart = ''] = splitArgOnce(arg);
         const key = keyPart.trim().replace(/^-+/, '');
         result[key] = valuePart.trim();
     }
@@ -376,9 +384,22 @@ const cloneDefaultOptions = () => JSON.parse(JSON.stringify(DEFAULT_BROWSER_PROF
 const normalizeDomainEntry = (entry) => String(entry ?? '')
     .trim()
     .toLowerCase();
+const isExactHostDomainEntry = (entry) => {
+    if (!entry) {
+        return false;
+    }
+    if (entry.includes('*') || entry.includes('://') || entry.includes('/')) {
+        return false;
+    }
+    // Keep set optimization for plain hostnames only. Entries with ports/pattern-like
+    // delimiters must stay as arrays to preserve wildcard/scheme matching semantics.
+    return !entry.includes(':');
+};
 const optimizeDomainList = (value) => {
     const cleaned = value.map(normalizeDomainEntry).filter(Boolean);
-    if (cleaned.length >= DOMAIN_OPTIMIZATION_THRESHOLD) {
+    const canOptimizeToSet = cleaned.length >= DOMAIN_OPTIMIZATION_THRESHOLD &&
+        cleaned.every(isExactHostDomainEntry);
+    if (canOptimizeToSet) {
         logger.warning(`Optimizing domain list with ${cleaned.length} entries to a Set for O(1) matching`);
         return new Set(cleaned);
     }
@@ -407,16 +428,12 @@ export class BrowserProfile {
             allowed_domains: Array.isArray(init.allowed_domains)
                 ? optimizeDomainList(init.allowed_domains)
                 : init.allowed_domains instanceof Set
-                    ? new Set(Array.from(init.allowed_domains)
-                        .map(normalizeDomainEntry)
-                        .filter(Boolean))
+                    ? optimizeDomainList(Array.from(init.allowed_domains))
                     : defaults.allowed_domains,
             prohibited_domains: Array.isArray(init.prohibited_domains)
                 ? optimizeDomainList(init.prohibited_domains)
                 : init.prohibited_domains instanceof Set
-                    ? new Set(Array.from(init.prohibited_domains)
-                        .map(normalizeDomainEntry)
-                        .filter(Boolean))
+                    ? optimizeDomainList(Array.from(init.prohibited_domains))
                     : defaults.prohibited_domains,
             window_position: init.window_position ?? defaults.window_position,
         };

package/dist/browser/session.d.ts

@@ -5,6 +5,7 @@ import { BrowserStateSummary, type TabInfo } from './views.js';
 import { type WaitUntilState } from './events.js';
 import { DOMElementNode, type SelectorMap } from '../dom/views.js';
 import { SessionManager } from './session-manager.js';
+import { type CaptchaWaitResult } from './watchdogs/captcha-watchdog.js';
 import type { BaseWatchdog } from './watchdogs/base.js';
 export interface BrowserSessionInit {
     id?: string;
@@ -22,6 +23,21 @@ export interface BrowserSessionInit {
     downloaded_files?: string[];
     closed_popup_messages?: string[];
 }
+export interface ChromeProfileInfo {
+    directory: string;
+    name: string;
+    email?: string;
+}
+export declare const systemChrome: {
+    findExecutable(): string | null;
+    getUserDataDir(executablePath?: string | null): string | null;
+    listProfiles(userDataDir?: string | null): ChromeProfileInfo[];
+};
+export interface BrowserSessionFromSystemChromeInit extends Omit<BrowserSessionInit, 'browser_profile' | 'profile'> {
+    browser_profile?: BrowserProfile;
+    profile?: Partial<BrowserProfileOptions>;
+    profile_directory?: string | null;
+}
 export interface BrowserStateOptions {
     cache_clickable_elements_hashes?: boolean;
     include_screenshot?: boolean;
@@ -78,7 +94,18 @@ export declare class BrowserSession {
     private readonly _maxRecentEvents;
     private _watchdogs;
     private _defaultWatchdogsAttached;
+    private _captchaWatchdog;
+    readonly RECONNECT_WAIT_TIMEOUT = 54;
+    private _reconnecting;
+    private _reconnectTask;
+    private _reconnectWaitPromise;
+    private _resolveReconnectWait;
+    private _intentionalStop;
+    private _disconnectAwareBrowser;
+    private _browserDisconnectHandler;
     constructor(init?: BrowserSessionInit);
+    static from_system_chrome(init?: BrowserSessionFromSystemChromeInit): BrowserSession;
+    static list_chrome_profiles(): ChromeProfileInfo[];
     attach_watchdog(watchdog: BaseWatchdog): void;
     attach_watchdogs(watchdogs: BaseWatchdog[]): void;
     detach_watchdog(watchdog: BaseWatchdog): void;
@@ -89,6 +116,7 @@ export declare class BrowserSession {
         cdp_url: string;
     }>;
     attach_default_watchdogs(): void;
+    wait_if_captcha_solving(timeoutSeconds?: number): Promise<CaptchaWaitResult | null>;
     private _formatTabId;
     private _createTabInfo;
     private _buildSyntheticTargetId;
@@ -96,6 +124,8 @@ export declare class BrowserSession {
     get_or_create_cdp_session(page?: Page | null): Promise<any>;
     private _waitForStableNetwork;
     private _setActivePage;
+    private _syncCurrentTabFromPage;
+    private _syncTabsWithBrowserPages;
     private _captureClosedPopupMessage;
     private _getClosedPopupMessagesSnapshot;
     private _recordRecentEvent;
@@ -108,6 +138,10 @@ export declare class BrowserSession {
     describe(): string;
     get _owns_browser_resources(): boolean;
     get is_stopping(): boolean;
+    get is_reconnecting(): boolean;
+    get should_gate_watchdog_events(): boolean;
+    get is_cdp_connected(): boolean;
+    wait_for_reconnect(timeoutSeconds?: number): Promise<void>;
     claim_agent(agentId: string, mode?: 'exclusive' | 'shared'): boolean;
     claimAgent(agentId: string, mode?: 'exclusive' | 'shared'): boolean;
     release_agent(agentId?: string): boolean;
@@ -123,6 +157,22 @@ export declare class BrowserSession {
     private _waitWithAbort;
     private _withAbort;
     private _toPlaywrightOptions;
+    set_extra_headers(headers: Record<string, string>): Promise<void>;
+    private _applyConfiguredExtraHttpHeaders;
+    private _usesRemoteBrowserConnection;
+    private _connectToConfiguredBrowser;
+    private _ensureBrowserContextFromBrowser;
+    private _beginReconnectWait;
+    private _endReconnectWait;
+    private _detachRemoteDisconnectHandler;
+    private _attachRemoteDisconnectHandler;
+    private _handleUnexpectedRemoteDisconnect;
+    private _restorePagesAfterReconnect;
+    reconnect(options?: {
+        preferred_url?: string | null;
+        preferred_tab_index?: number;
+    }): Promise<void>;
+    private _auto_reconnect;
     private _isSandboxLaunchError;
     private _createNoSandboxLaunchOptions;
     private _launchChromiumWithSandboxFallback;
@@ -253,11 +303,17 @@ export declare class BrowserSession {
      */
     wait_for_element(selector: string, timeout?: number): Promise<void>;
     /**
-     * Take a screenshot of the current page
+     * Take a screenshot of the current page.
      * @param full_page Whether to capture the full scrollable page
+     * @param clip Optional clip region for partial screenshots
      * @returns Base64 encoded PNG screenshot
      */
-    take_screenshot(full_page?: boolean): Promise<string | null>;
+    take_screenshot(full_page?: boolean, clip?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null): Promise<string | null>;
     /**
      * Add a request event listener to the current page
      */
@@ -327,6 +383,7 @@ export declare class BrowserSession {
     private _is_new_tab_page;
     private _is_ip_address_host;
     private _get_domain_variants;
+    private _setEntryMatchesUrl;
     /**
      * Check if page is displaying a PDF
      */