browser-use 0.5.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,

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;
@@ -110,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;
@@ -125,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;
@@ -255,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
      */