browser-use 0.2.0 → 0.3.0

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import { createLogger } from './logging-config.js';
 type Callback = (() => void) | undefined;
 export interface SignalHandlerOptions {
     pause_callback?: Callback;
@@ -35,6 +36,14 @@ export declare const check_env_variables: (keys: string[], predicate?: (values:
 export declare const is_unsafe_pattern: (pattern: string) => boolean;
 export declare const merge_dicts: (a: Record<string, any>, b: Record<string, any>, path?: (string | number)[]) => Record<string, any>;
 export declare const get_browser_use_version: () => string;
+export declare const check_latest_browser_use_version: () => Promise<string | null>;
+export interface CreateTaskWithErrorHandlingOptions {
+    name?: string;
+    logger_instance?: ReturnType<typeof createLogger>;
+    suppress_exceptions?: boolean;
+}
+export declare const create_task_with_error_handling: <T>(promise: Promise<T>, options?: CreateTaskWithErrorHandlingOptions) => Promise<T | undefined>;
+export declare const sanitize_surrogates: (text: string) => string;
 export declare const get_git_info: () => Record<string, string> | null;
 export declare const _log_pretty_path: (input: unknown) => string;
 export declare const _log_pretty_url: (value: string, max_len?: number | null) => string;
@@ -107,7 +116,7 @@ export declare function createSemaphore(maxConcurrent: number): {
     getQueueLength(): number;
 };
 /**
- * Check if a URL is a new tab page (about:blank or chrome://new-tab-page).
+ * Check if a URL is a new tab page (about:blank, chrome://new-tab-page, or chrome://newtab).
  */
 export declare function is_new_tab_page(url: string): boolean;
 /**

package/dist/utils.js

@@ -8,11 +8,14 @@ import { stderr } from 'node:process';
 import { performance } from 'node:perf_hooks';
 import { fileURLToPath } from 'node:url';
 import { config as loadEnv } from 'dotenv';
-import minimatch from 'minimatch';
+import * as minimatchModule from 'minimatch';
 import { createLogger } from './logging-config.js';
 loadEnv();
 const logger = createLogger('browser_use.utils');
 let _exiting = false;
+const minimatch = (minimatchModule.minimatch ??
+    minimatchModule.default ??
+    minimatchModule);
 export class SignalHandler {
     loop = null;
     pause_callback;
@@ -240,6 +243,68 @@ export const get_browser_use_version = () => {
     }
     return 'unknown';
 };
+export const check_latest_browser_use_version = async () => {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    timeout.unref?.();
+    try {
+        const response = await fetch('https://registry.npmjs.org/browser-use/latest', {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+            },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const payload = (await response.json());
+        if (typeof payload.version === 'string' && payload.version.trim()) {
+            return payload.version.trim();
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+};
+export const create_task_with_error_handling = (promise, options = {}) => {
+    const { name = 'unnamed', logger_instance, suppress_exceptions = false, } = options;
+    const log = logger_instance ?? logger;
+    return promise.catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        if (suppress_exceptions) {
+            log.error(`Exception in background task [${name}]: ${message}`);
+            return undefined;
+        }
+        log.warning(`Exception in background task [${name}]: ${message}`);
+        throw error;
+    });
+};
+export const sanitize_surrogates = (text) => {
+    let result = '';
+    for (let index = 0; index < text.length; index += 1) {
+        const code = text.charCodeAt(index);
+        // High surrogate
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const nextCode = index + 1 < text.length ? text.charCodeAt(index + 1) : null;
+            if (nextCode != null && nextCode >= 0xdc00 && nextCode <= 0xdfff) {
+                result += text[index] + text[index + 1];
+                index += 1;
+            }
+            continue;
+        }
+        // Low surrogate without preceding high surrogate
+        if (code >= 0xdc00 && code <= 0xdfff) {
+            continue;
+        }
+        result += text[index];
+    }
+    return result;
+};
 let cached_git_info;
 export const get_git_info = () => {
     if (cached_git_info !== undefined) {
@@ -423,12 +488,14 @@ export function createSemaphore(maxConcurrent) {
     };
 }
 /**
- * Check if a URL is a new tab page (about:blank or chrome://new-tab-page).
+ * Check if a URL is a new tab page (about:blank, chrome://new-tab-page, or chrome://newtab).
  */
 export function is_new_tab_page(url) {
     return (url === 'about:blank' ||
         url === 'chrome://new-tab-page/' ||
-        url === 'chrome://new-tab-page');
+        url === 'chrome://new-tab-page' ||
+        url === 'chrome://newtab/' ||
+        url === 'chrome://newtab');
 }
 /**
  * Check if a URL matches a domain pattern. SECURITY CRITICAL.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-use",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A TypeScript-first library for programmatic browser control, designed for building AI-powered web agents.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,16 +16,36 @@
       "import": "./dist/agent/index.js",
       "default": "./dist/agent/index.js"
     },
+    "./actor": {
+      "types": "./dist/actor/index.d.ts",
+      "import": "./dist/actor/index.js",
+      "default": "./dist/actor/index.js"
+    },
     "./browser": {
       "types": "./dist/browser/index.d.ts",
       "import": "./dist/browser/index.js",
       "default": "./dist/browser/index.js"
     },
+    "./browser/cloud": {
+      "types": "./dist/browser/cloud/index.d.ts",
+      "import": "./dist/browser/cloud/index.js",
+      "default": "./dist/browser/cloud/index.js"
+    },
     "./controller": {
       "types": "./dist/controller/index.d.ts",
       "import": "./dist/controller/index.js",
       "default": "./dist/controller/index.js"
     },
+    "./code-use": {
+      "types": "./dist/code-use/index.d.ts",
+      "import": "./dist/code-use/index.js",
+      "default": "./dist/code-use/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "default": "./dist/tools/index.js"
+    },
     "./filesystem": {
       "types": "./dist/filesystem/index.d.ts",
       "import": "./dist/filesystem/index.js",
@@ -51,6 +71,16 @@
       "import": "./dist/llm/azure/index.js",
       "default": "./dist/llm/azure/index.js"
     },
+    "./llm/cerebras": {
+      "types": "./dist/llm/cerebras/index.d.ts",
+      "import": "./dist/llm/cerebras/index.js",
+      "default": "./dist/llm/cerebras/index.js"
+    },
+    "./llm/browser-use": {
+      "types": "./dist/llm/browser-use/index.d.ts",
+      "import": "./dist/llm/browser-use/index.js",
+      "default": "./dist/llm/browser-use/index.js"
+    },
     "./llm/base": {
       "types": "./dist/llm/base.d.ts",
       "import": "./dist/llm/base.js",
@@ -81,6 +111,16 @@
       "import": "./dist/llm/messages.js",
       "default": "./dist/llm/messages.js"
     },
+    "./llm/mistral": {
+      "types": "./dist/llm/mistral/index.d.ts",
+      "import": "./dist/llm/mistral/index.js",
+      "default": "./dist/llm/mistral/index.js"
+    },
+    "./llm/models": {
+      "types": "./dist/llm/models.d.ts",
+      "import": "./dist/llm/models.js",
+      "default": "./dist/llm/models.js"
+    },
     "./llm/ollama": {
       "types": "./dist/llm/ollama/index.d.ts",
       "import": "./dist/llm/ollama/index.js",
@@ -96,6 +136,11 @@
       "import": "./dist/llm/openrouter/index.js",
       "default": "./dist/llm/openrouter/index.js"
     },
+    "./llm/vercel": {
+      "types": "./dist/llm/vercel/index.d.ts",
+      "import": "./dist/llm/vercel/index.js",
+      "default": "./dist/llm/vercel/index.js"
+    },
     "./llm/schema": {
       "types": "./dist/llm/schema.d.ts",
       "import": "./dist/llm/schema.js",
@@ -121,6 +166,21 @@
       "import": "./dist/sync/index.js",
       "default": "./dist/sync/index.js"
     },
+    "./skill-cli": {
+      "types": "./dist/skill-cli/index.d.ts",
+      "import": "./dist/skill-cli/index.js",
+      "default": "./dist/skill-cli/index.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "import": "./dist/skills/index.js",
+      "default": "./dist/skills/index.js"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox/index.d.ts",
+      "import": "./dist/sandbox/index.js",
+      "default": "./dist/sandbox/index.js"
+    },
     "./telemetry": {
       "types": "./dist/telemetry/index.d.ts",
       "import": "./dist/telemetry/index.js",
@@ -221,52 +281,53 @@
   "author": "unadlib",
   "license": "MIT",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.73.0",
+    "@anthropic-ai/sdk": "^0.74.0",
     "@aws-sdk/client-bedrock-runtime": "^3.985.0",
     "@cfworker/json-schema": "^4.1.1",
     "@google/genai": "^1.40.0",
-    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "adm-zip": "^0.5.16",
-    "axios": "^1.7.7",
-    "canvas": "^3.2.0",
-    "dotenv": "^16.4.5",
-    "eventemitter3": "^5.0.1",
+    "axios": "^1.13.4",
+    "canvas": "^3.2.1",
+    "dotenv": "^17.2.4",
+    "eventemitter3": "^5.0.4",
     "extract-zip": "^2.0.1",
     "gif-encoder-2": "^1.0.5",
-    "googleapis": "^166.0.0",
+    "googleapis": "^171.4.0",
     "gpt-tokenizer": "^3.4.0",
     "groq-sdk": "^0.37.0",
     "ollama": "^0.6.3",
     "openai": "^6.18.0",
     "pdf-parse": "^2.4.5",
     "pdfkit": "^0.17.2",
-    "playwright": "^1.54.2",
-    "posthog-node": "^5.11.2",
-    "turndown": "^7.2.1",
-    "zod": "^3.23.8",
-    "zod-to-json-schema": "^3.24.6"
+    "playwright": "^1.58.2",
+    "posthog-node": "^5.24.11",
+    "turndown": "^7.2.2",
+    "zod": "^4.3.6",
+    "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/adm-zip": "^0.5.7",
     "@types/minimatch": "^6.0.0",
-    "@types/node": "^24.2.0",
+    "@types/node": "^25.2.2",
     "@types/pdf-parse": "^1.1.5",
-    "@types/pdfkit": "^0.17.3",
-    "@types/turndown": "^5.0.5",
-    "@typescript-eslint/eslint-plugin": "^8.39.0",
-    "@typescript-eslint/parser": "^8.39.0",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/pdfkit": "^0.17.4",
+    "@types/turndown": "^5.0.6",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "commitizen": "^4.3.1",
-    "eslint": "^9.32.0",
+    "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2",
-    "tsx": "^4.20.3",
-    "typescript": "^5.9.2",
-    "vite": "^7.1.0",
-    "vitest": "^3.2.4"
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18"
   },
   "config": {
     "commitizen": {

package/dist/dom/playground/process-dom.js

@@ -1,5 +0,0 @@
-async function main() {
-    console.log('Process DOM playground');
-}
-main();
-export {};

package/dist/dom/playground/test-accessibility.d.ts

@@ -1,44 +0,0 @@
-/**
- * Accessibility Tree Playground for browser-use
- *
- * - Launches a browser and navigates to a target URL (default: amazon.com)
- * - Extracts both the full and interesting-only accessibility trees using Playwright
- * - Prints and saves both trees to JSON files
- * - Recursively prints relevant info for each node (role, name, value, description, focusable, focused, checked, selected, disabled, children count)
- * - Explains the difference between the accessibility tree and the DOM tree
- * - Notes on React/Vue/SPA apps
- * - Easy to modify for your own experiments
- *
- * Run with: npx tsx src/dom/playground/test-accessibility.ts
- */
-type AXNode = {
-    role?: string;
-    name?: string;
-    value?: string | number;
-    description?: string;
-    focusable?: boolean;
-    focused?: boolean;
-    checked?: boolean | 'mixed';
-    selected?: boolean;
-    disabled?: boolean;
-    children?: AXNode[];
-    [key: string]: any;
-};
-/**
- * Helper to recursively print relevant info from the accessibility tree
- */
-declare function printAxTree(node: AXNode | null, depth?: number): void;
-/**
- * Helper to print all available accessibility node attributes
- * Prints all key-value pairs for each node (except 'children'), then recurses into children
- */
-declare function printAllFields(node: AXNode | null, depth?: number): void;
-/**
- * Flatten the accessibility tree into a list of "role name" strings
- */
-declare function flattenAxTree(node: AXNode | null, lines: string[]): void;
-/**
- * Get and analyze the accessibility tree for a given URL
- */
-declare function getAxTree(targetUrl: string): Promise<void>;
-export { printAxTree, printAllFields, flattenAxTree, getAxTree };

package/dist/dom/playground/test-accessibility.js

@@ -1,111 +0,0 @@
-/**
- * Accessibility Tree Playground for browser-use
- *
- * - Launches a browser and navigates to a target URL (default: amazon.com)
- * - Extracts both the full and interesting-only accessibility trees using Playwright
- * - Prints and saves both trees to JSON files
- * - Recursively prints relevant info for each node (role, name, value, description, focusable, focused, checked, selected, disabled, children count)
- * - Explains the difference between the accessibility tree and the DOM tree
- * - Notes on React/Vue/SPA apps
- * - Easy to modify for your own experiments
- *
- * Run with: npx tsx src/dom/playground/test-accessibility.ts
- */
-import { chromium } from 'playwright';
-/**
- * Helper to recursively print relevant info from the accessibility tree
- */
-function printAxTree(node, depth = 0) {
-    if (!node) {
-        return;
-    }
-    const indent = '  '.repeat(depth);
-    const info = [
-        `role=${JSON.stringify(node.role)}`,
-        node.name ? `name=${JSON.stringify(node.name)}` : null,
-        node.value !== undefined ? `value=${JSON.stringify(node.value)}` : null,
-        node.description ? `desc=${JSON.stringify(node.description)}` : null,
-        'focusable' in node ? `focusable=${JSON.stringify(node.focusable)}` : null,
-        'focused' in node ? `focused=${JSON.stringify(node.focused)}` : null,
-        'checked' in node ? `checked=${JSON.stringify(node.checked)}` : null,
-        'selected' in node ? `selected=${JSON.stringify(node.selected)}` : null,
-        'disabled' in node ? `disabled=${JSON.stringify(node.disabled)}` : null,
-        node.children ? `children=${node.children.length}` : null,
-    ];
-    console.log('--------------------------------');
-    console.log(indent + info.filter((x) => x !== null).join(', '));
-    for (const child of node.children || []) {
-        printAxTree(child, depth + 1);
-    }
-}
-/**
- * Helper to print all available accessibility node attributes
- * Prints all key-value pairs for each node (except 'children'), then recurses into children
- */
-function printAllFields(node, depth = 0) {
-    if (!node) {
-        return;
-    }
-    const indent = '  '.repeat(depth);
-    for (const [k, v] of Object.entries(node)) {
-        if (k !== 'children') {
-            console.log(`${indent}${k}: ${JSON.stringify(v)}`);
-        }
-    }
-    if ('children' in node && node.children) {
-        console.log(`${indent}children: ${node.children.length}`);
-        for (const child of node.children) {
-            printAllFields(child, depth + 1);
-        }
-    }
-}
-/**
- * Flatten the accessibility tree into a list of "role name" strings
- */
-function flattenAxTree(node, lines) {
-    if (!node) {
-        return;
-    }
-    const role = node.role || '';
-    const name = node.name || '';
-    lines.push(`${role} ${name}`);
-    for (const child of node.children || []) {
-        flattenAxTree(child, lines);
-    }
-}
-/**
- * Get and analyze the accessibility tree for a given URL
- */
-async function getAxTree(targetUrl) {
-    const browser = await chromium.launch({ headless: true });
-    const page = await browser.newPage();
-    console.log(`Navigating to ${targetUrl}`);
-    await page.goto(targetUrl, { waitUntil: 'load' });
-    const axTreeInteresting = await page.accessibility.snapshot({
-        interestingOnly: true,
-    });
-    const lines = [];
-    flattenAxTree(axTreeInteresting, lines);
-    console.log(lines);
-    console.log(`length of ax_tree_interesting: ${lines.length}`);
-    await browser.close();
-}
-/**
- * Main execution
- */
-async function main() {
-    const TARGET_URLS = [
-        // 'https://amazon.com/',
-        // 'https://www.google.com/',
-        // 'https://www.facebook.com/',
-        // 'https://platform.openai.com/tokenizer',
-        'https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/checkbox',
-    ];
-    for (const url of TARGET_URLS) {
-        await getAxTree(url);
-    }
-}
-if (require.main === module) {
-    main().catch(console.error);
-}
-export { printAxTree, printAllFields, flattenAxTree, getAxTree };