browser-use 0.7.1 → 0.7.3

package/dist/browser/session.d.ts

@@ -499,7 +499,7 @@ export declare class BrowserSession {
     private _scrollWithCdpGesture;
     /**
      * Scroll the current page container
-     * @param pixels - Number of pixels to scroll (positive = up, negative = down)
+     * @param pixels - Number of pixels to scroll (positive = down, negative = up)
      */
     private _scrollContainer;
     /**

package/dist/browser/session.js

@@ -1404,7 +1404,11 @@ export class BrowserSession {
         });
         const reconnectTask = this._auto_reconnect();
         this._reconnectTask = reconnectTask;
-        void reconnectTask.finally(() => {
+        void reconnectTask
+            .catch((error) => {
+            this.logger.warning(`Automatic reconnect failed: ${error instanceof Error ? error.message : String(error)}`);
+        })
+            .finally(() => {
             if (this._reconnectTask === reconnectTask) {
                 this._reconnectTask = null;
             }
@@ -2572,7 +2576,7 @@ export class BrowserSession {
                 }
             }
             if (direction === 'up' || direction === 'down') {
-                const pixels = direction === 'down' ? -normalizedAmount : normalizedAmount;
+                const pixels = direction === 'down' ? normalizedAmount : -normalizedAmount;
                 await this._withAbort(this._scrollContainer(pixels), signal);
                 return;
             }
@@ -5293,7 +5297,7 @@ export class BrowserSession {
     }
     /**
      * Scroll the current page container
-     * @param pixels - Number of pixels to scroll (positive = up, negative = down)
+     * @param pixels - Number of pixels to scroll (positive = down, negative = up)
      */
     async _scrollContainer(pixels) {
         const page = await this.getCurrentPage();

package/dist/browser/watchdogs/base.d.ts

@@ -17,5 +17,11 @@ export declare abstract class BaseWatchdog {
     detach_from_session(): void;
     protected onAttached(): void;
     protected onDetached(): void;
+    /**
+     * Run fire-and-forget background work without letting a rejection surface
+     * as an unhandled promise rejection (which terminates the process on
+     * modern Node). Failures are logged at debug level.
+     */
+    protected runBackground(label: string, work: Promise<unknown>): void;
     private _collectHandlerMethods;
 }

package/dist/browser/watchdogs/base.js

@@ -91,6 +91,16 @@ export class BaseWatchdog {
     }
     onAttached() { }
     onDetached() { }
+    /**
+     * Run fire-and-forget background work without letting a rejection surface
+     * as an unhandled promise rejection (which terminates the process on
+     * modern Node). Failures are logged at debug level.
+     */
+    runBackground(label, work) {
+        void work.catch((error) => {
+            this.browser_session.logger.debug(`[${this.constructor.name}] ${label} failed: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
     _collectHandlerMethods() {
         const methodNames = new Set();
         let prototype = Object.getPrototypeOf(this);

package/dist/browser/watchdogs/cdp-session-watchdog.js

@@ -12,7 +12,7 @@ export class CDPSessionWatchdog extends BaseWatchdog {
         await this._teardownCdpMonitoring();
     }
     onDetached() {
-        void this._teardownCdpMonitoring();
+        this.runBackground('teardown CDP monitoring', this._teardownCdpMonitoring());
     }
     async _ensureCdpMonitoring() {
         if (this._rootCdpSession) {

package/dist/browser/watchdogs/crash-watchdog.js

@@ -69,7 +69,7 @@ export class CrashWatchdog extends BaseWatchdog {
             return;
         }
         const crashListener = (payload) => {
-            void this._handlePageCrash(page, payload);
+            this.runBackground('handle page crash', this._handlePageCrash(page, payload));
         };
         const requestListener = (payload) => {
             this._trackRequestStart(payload);
@@ -215,7 +215,7 @@ export class CrashWatchdog extends BaseWatchdog {
             return;
         }
         this._healthInterval = setInterval(() => {
-            void this._runHealthCheck();
+            this.runBackground('run health check', this._runHealthCheck());
         }, this._healthCheckIntervalMs);
     }
     _stopHealthMonitor() {

package/dist/browser/watchdogs/downloads-watchdog.js

@@ -77,7 +77,7 @@ export class DownloadsWatchdog extends BaseWatchdog {
         this._downloadCompleteCallbacks = [];
         this._networkDownloads.clear();
         this._detectedDownloadUrls.clear();
-        void this._stopCdpDownloadMonitoring();
+        this.runBackground('stop CDP download monitoring', this._stopCdpDownloadMonitoring());
     }
     on_TabCreatedEvent() {
         return null;
@@ -199,7 +199,7 @@ export class DownloadsWatchdog extends BaseWatchdog {
         this._downloadCompleteCallbacks = [];
         this._networkDownloads.clear();
         this._detectedDownloadUrls.clear();
-        void this._stopCdpDownloadMonitoring();
+        this.runBackground('stop CDP download monitoring', this._stopCdpDownloadMonitoring());
     }
     _normalizeCallbackRegistration(on_start_or_options, on_progress, on_complete) {
         if (on_start_or_options &&
@@ -229,10 +229,10 @@ export class DownloadsWatchdog extends BaseWatchdog {
             await session.send?.('Network.enable');
             this._cdpSession = session;
             const onResponseReceived = (payload) => {
-                void this._handleNetworkResponse(payload);
+                this.runBackground('handle network response', this._handleNetworkResponse(payload));
             };
             const onLoadingFinished = (payload) => {
-                void this._handleNetworkLoadingFinished(payload);
+                this.runBackground('handle loading finished', this._handleNetworkLoadingFinished(payload));
             };
             session.on?.('Network.responseReceived', onResponseReceived);
             session.on?.('Network.loadingFinished', onLoadingFinished);

package/dist/browser/watchdogs/har-recording-watchdog.js

@@ -125,7 +125,7 @@ export class HarRecordingWatchdog extends BaseWatchdog {
         }
     }
     onDetached() {
-        void this._teardownCapture();
+        this.runBackground('teardown HAR capture', this._teardownCapture());
     }
     _resolveConfiguredHarPath() {
         const configuredPath = this.browser_session.browser_profile.config.record_har_path;

package/dist/browser/watchdogs/popups-watchdog.js

@@ -20,7 +20,7 @@ export class PopupsWatchdog extends BaseWatchdog {
         await this._detachCdpDialogHandlers();
     }
     onDetached() {
-        void this._detachCdpDialogHandlers();
+        this.runBackground('detach CDP dialog handlers', this._detachCdpDialogHandlers());
     }
     async _attachCdpDialogHandler(targetId, page) {
         if (this._dialogListenersRegistered.has(targetId)) {
@@ -30,7 +30,7 @@ export class PopupsWatchdog extends BaseWatchdog {
             const session = (await this.browser_session.get_or_create_cdp_session(page));
             await session.send?.('Page.enable');
             const handler = (payload) => {
-                void this._handleJavascriptDialog(payload, session);
+                this.runBackground('handle javascript dialog', this._handleJavascriptDialog(payload, session));
             };
             session.on?.('Page.javascriptDialogOpening', handler);
             this._dialogListenersRegistered.add(targetId);

package/dist/browser/watchdogs/recording-watchdog.js

@@ -70,7 +70,7 @@ export class RecordingWatchdog extends BaseWatchdog {
         await this._startCdpScreencastIfConfigured();
     }
     onDetached() {
-        void this._stopCdpScreencastIfStarted();
+        this.runBackground('stop CDP screencast', this._stopCdpScreencastIfStarted());
         this._detachVideoListeners();
     }
     _recordingDisabledByDomainPolicy() {
@@ -161,7 +161,7 @@ export class RecordingWatchdog extends BaseWatchdog {
             else if (typeof page.removeListener === 'function') {
                 page.removeListener('close', listener);
             }
-            void this._captureVideoArtifact(page);
+            this.runBackground('capture video artifact', this._captureVideoArtifact(page));
         };
         page.on('close', listener);
         this._videoCloseListeners.set(page, listener);
@@ -222,6 +222,9 @@ export class RecordingWatchdog extends BaseWatchdog {
                 flags: 'a',
                 mode: 0o600,
             });
+            stream.on('error', (error) => {
+                this.browser_session.logger.warning(`[RecordingWatchdog] CDP screencast stream error: ${error.message}`);
+            });
             chmodPrivatePath(filePath, 0o600);
             const handler = (payload) => {
                 const frameData = typeof payload?.data === 'string' ? payload.data : '';

package/dist/code-use/service.d.ts

@@ -17,6 +17,7 @@ export declare class CodeAgent {
     constructor(options: CodeAgentOptions);
     add_cell(source: string): import("./views.js").CodeCell;
     execute_cell(source: string): Promise<import("./views.js").CodeCell>;
+    private _run_cell;
     run(max_steps?: number): Promise<CodeAgentHistoryList>;
     get history(): CodeAgentHistoryList;
     close(): Promise<void>;

package/dist/code-use/service.js

@@ -29,7 +29,9 @@ export class CodeAgent {
         return this.session.add_cell(source);
     }
     async execute_cell(source) {
-        const cell = this.add_cell(source);
+        return this._run_cell(this.add_cell(source));
+    }
+    async _run_cell(cell) {
         const startedAt = Date.now() / 1000;
         cell.status = 'running';
         cell.execution_count = this.session.increment_execution_count();
@@ -92,7 +94,7 @@ export class CodeAgent {
         const pending = this.session.cells.filter((cell) => cell.status === 'pending');
         const toRun = pending.slice(0, Math.max(max_steps, 0));
         for (const cell of toRun) {
-            await this.execute_cell(cell.source);
+            await this._run_cell(cell);
         }
         return this.history;
     }

package/dist/controller/registry/service.js

@@ -358,7 +358,7 @@ export class Registry {
     }));
     replace_sensitive_data(params, sensitiveData, currentUrl) {
         const secretPattern = /<secret>(.*?)<\/secret>/g;
-        const applicableSecrets = {};
+        const applicableSecrets = Object.create(null);
         for (const [domainOrKey, content] of Object.entries(sensitiveData)) {
             if (content && typeof content === 'object' && !Array.isArray(content)) {
                 if (currentUrl &&
@@ -371,6 +371,13 @@ export class Registry {
                 applicableSecrets[domainOrKey] = content;
             }
         }
+        // Filter out empty values so they are reported as missing instead of
+        // silently replacing placeholders with empty strings.
+        for (const key of Object.keys(applicableSecrets)) {
+            if (!applicableSecrets[key]) {
+                delete applicableSecrets[key];
+            }
+        }
         const cloneValue = (value) => {
             if (Array.isArray(value)) {
                 return value.map((item) => cloneValue(item));
@@ -383,21 +390,30 @@ export class Registry {
         const processed = cloneValue(params);
         const replaced = new Set();
         const missing = new Set();
+        const resolveSecret = (placeholder) => {
+            replaced.add(placeholder);
+            const replacement = applicableSecrets[placeholder];
+            if (placeholder.endsWith('bu_2fa_code')) {
+                return generateTotpCode(replacement);
+            }
+            return replacement;
+        };
         const traverse = (value) => {
             if (typeof value === 'string') {
-                return value.replace(secretPattern, (_, placeholderValue) => {
+                const withTagsReplaced = value.replace(secretPattern, (_, placeholderValue) => {
                     const placeholder = String(placeholderValue);
                     if (placeholder in applicableSecrets) {
-                        replaced.add(placeholder);
-                        const replacement = applicableSecrets[placeholder];
-                        if (placeholder.endsWith('bu_2fa_code')) {
-                            return generateTotpCode(replacement);
-                        }
-                        return replacement;
+                        return resolveSecret(placeholder);
                     }
                     missing.add(placeholder);
                     return `<secret>${placeholder}</secret>`;
                 });
+                // Handle literal secrets ("user_name" without tags) for cases where
+                // the LLM forgets the <secret> tags but uses the exact placeholder.
+                if (withTagsReplaced in applicableSecrets) {
+                    return resolveSecret(withTagsReplaced);
+                }
+                return withTagsReplaced;
             }
             if (Array.isArray(value)) {
                 return value.map(traverse);

package/dist/llm/deepseek/serializer.js

@@ -1,4 +1,4 @@
-import { AssistantMessage, ContentPartImageParam, ContentPartTextParam, SystemMessage, UserMessage, } from '../messages.js';
+import { AssistantMessage, ContentPartImageParam, ContentPartRefusalParam, ContentPartTextParam, SystemMessage, UserMessage, } from '../messages.js';
 export class DeepSeekMessageSerializer {
     serialize(messages) {
         return messages.map((message) => this.serializeMessage(message));
@@ -38,9 +38,26 @@ export class DeepSeekMessageSerializer {
             };
         }
         if (message instanceof AssistantMessage) {
+            let content = null;
+            if (typeof message.content === 'string') {
+                content = message.content;
+            }
+            else if (Array.isArray(message.content)) {
+                content = message.content.flatMap((part) => {
+                    if (part instanceof ContentPartTextParam) {
+                        return [{ type: 'text', text: part.text }];
+                    }
+                    if (part instanceof ContentPartRefusalParam) {
+                        return [
+                            { type: 'text', text: `[Refusal] ${part.refusal}` },
+                        ];
+                    }
+                    return [];
+                });
+            }
             return {
                 role: 'assistant',
-                content: typeof message.content === 'string' ? message.content : null,
+                content,
                 // DeepSeek supports tool calls in newer models
                 tool_calls: message.tool_calls?.map((toolCall) => ({
                     id: toolCall.id,

package/dist/llm/google/chat.js

@@ -1,4 +1,4 @@
-import { GoogleGenAI } from '@google/genai';
+import { GoogleGenAI, ThinkingLevel } from '@google/genai';
 import { ModelProviderError } from '../exceptions.js';
 import { ChatInvokeCompletion } from '../views.js';
 import { SchemaOptimizer, zodSchemaToJsonSchema } from '../schema.js';
@@ -19,6 +19,12 @@ const buildGoogleHttpOptions = (httpOptions) => {
     resolvedHttpOptions.headers = headers;
     return resolvedHttpOptions;
 };
+const googleThinkingLevelByName = {
+    minimal: ThinkingLevel.MINIMAL,
+    low: ThinkingLevel.LOW,
+    medium: ThinkingLevel.MEDIUM,
+    high: ThinkingLevel.HIGH,
+};
 export class ChatGoogle {
     model;
     provider = 'google';
@@ -212,15 +218,17 @@ export class ChatGoogle {
     async ainvoke(messages, output_format, options = {}) {
         const serializer = new GoogleMessageSerializer();
         const { contents, systemInstruction } = serializer.serializeWithSystem(messages, this.includeSystemInUser);
-        const generationConfig = this.config ? { ...this.config } : {};
+        const requestConfig = this.config
+            ? { ...this.config }
+            : {};
         if (this.temperature !== null) {
-            generationConfig.temperature = this.temperature;
+            requestConfig.temperature = this.temperature;
         }
         if (this.topP !== null) {
-            generationConfig.topP = this.topP;
+            requestConfig.topP = this.topP;
         }
         if (this.seed !== null) {
-            generationConfig.seed = this.seed;
+            requestConfig.seed = this.seed;
         }
         const isGemini3Pro = this.model.includes('gemini-3-pro');
         const isGemini3Flash = this.model.includes('gemini-3-flash');
@@ -229,18 +237,18 @@ export class ChatGoogle {
             if (level === 'minimal' || level === 'medium') {
                 level = 'low';
             }
-            generationConfig.thinkingConfig = {
-                thinkingLevel: level.toUpperCase(),
+            requestConfig.thinkingConfig = {
+                thinkingLevel: googleThinkingLevelByName[level],
             };
         }
         else if (isGemini3Flash) {
             if (this.thinkingLevel !== null) {
-                generationConfig.thinkingConfig = {
-                    thinkingLevel: this.thinkingLevel.toUpperCase(),
+                requestConfig.thinkingConfig = {
+                    thinkingLevel: googleThinkingLevelByName[this.thinkingLevel],
                 };
             }
             else {
-                generationConfig.thinkingConfig = {
+                requestConfig.thinkingConfig = {
                     thinkingBudget: this.thinkingBudget === null ? -1 : this.thinkingBudget,
                 };
             }
@@ -253,11 +261,11 @@ export class ChatGoogle {
                 budget = -1;
             }
             if (budget !== null) {
-                generationConfig.thinkingConfig = { thinkingBudget: budget };
+                requestConfig.thinkingConfig = { thinkingBudget: budget };
             }
         }
         if (this.maxOutputTokens !== null) {
-            generationConfig.maxOutputTokens = this.maxOutputTokens;
+            requestConfig.maxOutputTokens = this.maxOutputTokens;
         }
         // Try to get schema from output_format
         const schemaForJson = (() => {
@@ -289,8 +297,8 @@ export class ChatGoogle {
             }
         }
         if (cleanSchemaForJson && this.supportsStructuredOutput) {
-            generationConfig.responseMimeType = 'application/json';
-            generationConfig.responseSchema = cleanSchemaForJson;
+            requestConfig.responseMimeType = 'application/json';
+            requestConfig.responseSchema = cleanSchemaForJson;
         }
         const requestContents = contents.map((entry) => ({
             ...entry,
@@ -309,22 +317,25 @@ export class ChatGoogle {
                 }
             }
         }
-        const request = {
-            model: this.model,
-            contents: requestContents,
-        };
         if (systemInstruction && !this.includeSystemInUser) {
-            request.systemInstruction = {
+            requestConfig.systemInstruction = {
                 role: 'system',
                 parts: [{ text: systemInstruction }],
             };
         }
-        if (Object.keys(generationConfig).length > 0) {
-            request.generationConfig = generationConfig;
+        if (options.signal) {
+            requestConfig.abortSignal = options.signal;
+        }
+        const request = {
+            model: this.model,
+            contents: requestContents,
+        };
+        if (Object.keys(requestConfig).length > 0) {
+            request.config = requestConfig;
         }
         for (let attempt = 0; attempt < this.maxRetries; attempt += 1) {
             try {
-                const result = await this.client.models.generateContent(request, options.signal ? { signal: options.signal } : undefined);
+                const result = await this.client.models.generateContent(request);
                 const candidate = result.candidates?.[0];
                 const textParts = candidate?.content?.parts?.filter((p) => p.text) || [];
                 const text = textParts.map((p) => p.text).join('');

package/dist/llm/groq/serializer.js

@@ -45,9 +45,12 @@ export class GroqMessageSerializer {
                     arguments: toolCall.functionCall.arguments,
                 },
             }));
+            // Groq expects assistant content as plain text; AssistantMessage.text
+            // already joins the text parts (refusal parts excluded).
+            const content = message.content == null ? null : message.text;
             return {
                 role: 'assistant',
-                content: typeof message.content === 'string' ? message.content : null,
+                content,
                 tool_calls: toolCalls,
             };
         }

package/dist/llm/openai/serializer.js

@@ -1,4 +1,4 @@
-import { AssistantMessage, ContentPartImageParam, ContentPartTextParam, SystemMessage, UserMessage, } from '../messages.js';
+import { AssistantMessage, ContentPartImageParam, ContentPartRefusalParam, ContentPartTextParam, SystemMessage, UserMessage, } from '../messages.js';
 export class OpenAIMessageSerializer {
     serialize(messages) {
         return messages.map((message) => this.serializeMessage(message));
@@ -45,9 +45,24 @@ export class OpenAIMessageSerializer {
                     arguments: toolCall.functionCall.arguments,
                 },
             }));
+            let content = null;
+            if (typeof message.content === 'string') {
+                content = message.content;
+            }
+            else if (Array.isArray(message.content)) {
+                content = message.content.flatMap((part) => {
+                    if (part instanceof ContentPartTextParam) {
+                        return [{ type: 'text', text: part.text }];
+                    }
+                    if (part instanceof ContentPartRefusalParam) {
+                        return [{ type: 'refusal', refusal: part.refusal }];
+                    }
+                    return [];
+                });
+            }
             return {
                 role: 'assistant',
-                content: typeof message.content === 'string' ? message.content : null, // OpenAI expects string or null for content in assistant message if tool_calls are present
+                content,
                 tool_calls: toolCalls,
                 refusal: message.refusal || undefined,
             };

package/dist/skill-cli/direct.js

@@ -979,7 +979,7 @@ export const run_direct_command = async (argv, options = {}) => {
                             writeLine(environment.stdout, 'Cleared 0 cookies');
                         }
                         else {
-                            const addCookies = session.browser_context.addCookies;
+                            const addCookies = session.browser_context.addCookies?.bind(session.browser_context);
                             if (blockedCookies.length > 0 && !addCookies) {
                                 throw new Error('Browser context does not support preserving blocked cookies');
                             }
@@ -996,7 +996,7 @@ export const run_direct_command = async (argv, options = {}) => {
                     const allCookies = (await session.get_cookies?.({ include_blocked: true })) ?? [];
                     const remaining = allCookies.filter((cookie) => !cookieMatchesUrl(cookie, url));
                     const removedCount = allCookies.length - remaining.length;
-                    const addCookies = session.browser_context.addCookies;
+                    const addCookies = session.browser_context.addCookies?.bind(session.browser_context);
                     if (remaining.length > 0 && !addCookies) {
                         throw new Error('Browser context does not support preserving non-matching cookies');
                     }

package/dist/tokens/service.js

@@ -236,9 +236,9 @@ export class TokenCost {
         return {
             new_prompt_tokens: usage.prompt_tokens,
             new_prompt_cost: uncachedPrompt * (pricing.input_cost_per_token ?? 0),
-            prompt_read_cached_tokens: cached || null,
-            prompt_read_cached_cost: cached
-                ? cached * (pricing.cache_read_input_token_cost ?? 0)
+            prompt_read_cached_tokens: usage.prompt_cached_tokens ?? null,
+            prompt_read_cached_cost: cached && pricing.cache_read_input_token_cost
+                ? cached * pricing.cache_read_input_token_cost
                 : null,
             prompt_cached_creation_tokens: usage.prompt_cache_creation_tokens ?? null,
             prompt_cache_creation_cost: usage.prompt_cache_creation_tokens &&

package/dist/utils.js

@@ -196,7 +196,7 @@ export const is_unsafe_pattern = (pattern) => {
         const [, ...rest] = pattern.split('://');
         pattern = rest.join('://');
     }
-    const bare_domain = pattern.replace('.*', '').replace('*.', '');
+    const bare_domain = pattern.replaceAll('.*', '').replaceAll('*.', '');
     return bare_domain.includes('*');
 };
 export const merge_dicts = (a, b, path = []) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-use",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "A TypeScript-first library for programmatic browser control, designed for building AI-powered web agents.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -286,6 +286,12 @@
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest --watch",
     "test:pack": "node scripts/smoke-pack.mjs",
+    "version:check": "node scripts/update-version.mjs --check",
+    "version:sync": "node scripts/update-version.mjs sync",
+    "version:bump": "node scripts/update-version.mjs",
+    "version:patch": "node scripts/update-version.mjs patch",
+    "version:minor": "node scripts/update-version.mjs minor",
+    "version:major": "node scripts/update-version.mjs major",
     "check": "pnpm lint && pnpm typecheck && pnpm typecheck:test && pnpm test:unit && pnpm test:integration && pnpm test:e2e && pnpm test:pack",
     "commit": "cz",
     "typecheck": "tsc --noEmit",
@@ -354,7 +360,7 @@
     "@types/turndown": "^5.0.6",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-v8": "^4.1.8",
     "commitizen": "^4.3.1",
     "cz-conventional-changelog": "^3.3.0",
     "eslint": "^9.39.2",
@@ -366,7 +372,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.2",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.8"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
@@ -384,7 +390,7 @@
       "fast-xml-builder": "1.2.0",
       "fast-xml-parser": "5.7.3",
       "flatted": "3.4.2",
-      "hono": "4.12.18",
+      "hono": "4.12.23",
       "ip-address": "10.2.0",
       "lodash": "4.18.1",
       "minimatch": "10.2.4",