browser-use 0.0.1 → 0.0.2

package/dist/browser/types.js

@@ -0,0 +1 @@
+export const async_playwright = async () => import('playwright');

package/dist/browser/utils.d.ts

@@ -0,0 +1 @@
+export declare const normalize_url: (url: string) => string;

package/dist/browser/utils.js

@@ -0,0 +1,19 @@
+const SPECIAL_PROTOCOLS = [
+    'about:',
+    'mailto:',
+    'tel:',
+    'ftp:',
+    'file:',
+    'data:',
+    'javascript:',
+];
+export const normalize_url = (url) => {
+    const normalized = url.trim();
+    if (normalized.includes('://')) {
+        return normalized;
+    }
+    if (SPECIAL_PROTOCOLS.some((protocol) => normalized.startsWith(protocol))) {
+        return normalized;
+    }
+    return `https://${normalized}`;
+};

package/dist/browser/views.d.ts

@@ -0,0 +1,78 @@
+import { DOMState } from '../dom/views.js';
+import type { DOMHistoryElement } from '../dom/history-tree-processor/view.js';
+export declare const PLACEHOLDER_4PX_SCREENSHOT = "iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIAAAAmkwkpAAAAFElEQVR4nGP8//8/AwwwMSAB3BwAlm4DBfIlvvkAAAAASUVORK5CYII=";
+export interface TabInfo {
+    page_id: number;
+    url: string;
+    title: string;
+    parent_page_id?: number | null;
+}
+export interface PageInfo {
+    viewport_width: number;
+    viewport_height: number;
+    page_width: number;
+    page_height: number;
+    scroll_x: number;
+    scroll_y: number;
+    pixels_above: number;
+    pixels_below: number;
+    pixels_left: number;
+    pixels_right: number;
+}
+interface BrowserStateSummaryInit {
+    url: string;
+    title: string;
+    tabs: TabInfo[];
+    screenshot?: string | null;
+    page_info?: PageInfo | null;
+    pixels_above?: number;
+    pixels_below?: number;
+    browser_errors?: string[];
+    is_pdf_viewer?: boolean;
+    loading_status?: string | null;
+}
+export declare class BrowserStateSummary extends DOMState {
+    url: string;
+    title: string;
+    tabs: TabInfo[];
+    screenshot: string | null;
+    page_info: PageInfo | null;
+    pixels_above: number;
+    pixels_below: number;
+    browser_errors: string[];
+    is_pdf_viewer: boolean;
+    loading_status: string | null;
+    constructor(dom_state: DOMState, init: BrowserStateSummaryInit);
+}
+export declare class BrowserStateHistory {
+    url: string;
+    title: string;
+    tabs: TabInfo[];
+    interacted_element: Array<DOMHistoryElement | null>;
+    screenshot_path: string | null;
+    constructor(url: string, title: string, tabs: TabInfo[], interacted_element: Array<DOMHistoryElement | null>, screenshot_path?: string | null);
+    get_screenshot(): string | null;
+    to_dict(): {
+        tabs: TabInfo[];
+        screenshot_path: string | null;
+        interacted_element: ({
+            tag_name: string;
+            xpath: string;
+            highlight_index: number | null;
+            entire_parent_branch_path: string[];
+            attributes: Record<string, string>;
+            shadow_root: boolean;
+            css_selector: string | null;
+            page_coordinates: import("../index.js").CoordinateSet | null;
+            viewport_coordinates: import("../index.js").CoordinateSet | null;
+            viewport_info: import("../index.js").ViewportInfo | null;
+        } | null)[];
+        url: string;
+        title: string;
+    };
+}
+export declare class BrowserError extends Error {
+}
+export declare class URLNotAllowedError extends BrowserError {
+}
+export {};

package/dist/browser/views.js

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DOMState } from '../dom/views.js';
+export const PLACEHOLDER_4PX_SCREENSHOT = 'iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAIAAAAmkwkpAAAAFElEQVR4nGP8//8/AwwwMSAB3BwAlm4DBfIlvvkAAAAASUVORK5CYII=';
+export class BrowserStateSummary extends DOMState {
+    url;
+    title;
+    tabs;
+    screenshot;
+    page_info;
+    pixels_above;
+    pixels_below;
+    browser_errors;
+    is_pdf_viewer;
+    loading_status;
+    constructor(dom_state, init) {
+        super(dom_state.element_tree, dom_state.selector_map);
+        this.url = init.url;
+        this.title = init.title;
+        this.tabs = init.tabs;
+        this.screenshot = init.screenshot ?? null;
+        this.page_info = init.page_info ?? null;
+        this.pixels_above = init.pixels_above ?? 0;
+        this.pixels_below = init.pixels_below ?? 0;
+        this.browser_errors = init.browser_errors ?? [];
+        this.is_pdf_viewer = init.is_pdf_viewer ?? false;
+        this.loading_status = init.loading_status ?? null;
+    }
+}
+export class BrowserStateHistory {
+    url;
+    title;
+    tabs;
+    interacted_element;
+    screenshot_path;
+    constructor(url, title, tabs, interacted_element, screenshot_path = null) {
+        this.url = url;
+        this.title = title;
+        this.tabs = tabs;
+        this.interacted_element = interacted_element;
+        this.screenshot_path = screenshot_path;
+    }
+    get_screenshot() {
+        if (!this.screenshot_path) {
+            return null;
+        }
+        const resolved = path.resolve(this.screenshot_path);
+        if (!fs.existsSync(resolved)) {
+            return null;
+        }
+        try {
+            const data = fs.readFileSync(resolved);
+            return data.toString('base64');
+        }
+        catch {
+            return null;
+        }
+    }
+    to_dict() {
+        return {
+            tabs: this.tabs,
+            screenshot_path: this.screenshot_path,
+            interacted_element: this.interacted_element.map((element) => element?.to_dict?.() ?? null),
+            url: this.url,
+            title: this.title,
+        };
+    }
+}
+export class BrowserError extends Error {
+}
+export class URLNotAllowedError extends BrowserError {
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { Agent } from './agent/service.js';
+import { ChatOpenAI } from './llm/openai/chat.js';
+import { MCPServer } from './mcp/server.js';
+import { get_browser_use_version } from './utils.js';
+import dotenv from 'dotenv';
+dotenv.config();
+async function runMcpServer() {
+    const server = new MCPServer('browser-use', get_browser_use_version());
+    await server.start();
+    const shutdown = async () => {
+        await server.stop();
+        process.exit(0);
+    };
+    process.once('SIGINT', () => void shutdown());
+    process.once('SIGTERM', () => void shutdown());
+    await new Promise(() => { });
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--mcp')) {
+        await runMcpServer();
+        return;
+    }
+    if (args.length === 0 || args.includes('--help')) {
+        console.log('Usage: browser-use <task>');
+        console.log('       browser-use --mcp');
+        process.exit(1);
+    }
+    const task = args.join(' ');
+    console.log(`Starting task: ${task}`);
+    const llm = new ChatOpenAI();
+    const agent = new Agent({ task, llm });
+    try {
+        await agent.run();
+    }
+    catch (error) {
+        console.error('Error running agent:', error);
+        process.exit(1);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

package/dist/config.d.ts

@@ -0,0 +1,108 @@
+export declare const is_running_in_docker: () => boolean;
+declare class OldConfig {
+    private _dirs_created;
+    get BROWSER_USE_LOGGING_LEVEL(): string;
+    get ANONYMIZED_TELEMETRY(): boolean;
+    get BROWSER_USE_CLOUD_SYNC(): boolean;
+    get BROWSER_USE_CLOUD_API_URL(): string;
+    get BROWSER_USE_CLOUD_UI_URL(): string;
+    get XDG_CACHE_HOME(): string;
+    get XDG_CONFIG_HOME(): string;
+    get BROWSER_USE_CONFIG_DIR(): string;
+    get BROWSER_USE_CONFIG_FILE(): string;
+    get BROWSER_USE_PROFILES_DIR(): string;
+    get BROWSER_USE_DEFAULT_USER_DATA_DIR(): string;
+    get BROWSER_USE_EXTENSIONS_DIR(): string;
+    get OPENAI_API_KEY(): string;
+    get ANTHROPIC_API_KEY(): string;
+    get GOOGLE_API_KEY(): string;
+    get DEEPSEEK_API_KEY(): string;
+    get GROK_API_KEY(): string;
+    get NOVITA_API_KEY(): string;
+    get AZURE_OPENAI_ENDPOINT(): string;
+    get AZURE_OPENAI_KEY(): string;
+    get SKIP_LLM_API_KEY_VERIFICATION(): boolean;
+    get IN_DOCKER(): boolean;
+    get IS_IN_EVALS(): boolean;
+    get WIN_FONT_DIR(): string;
+    _ensure_dirs(base_dir?: string): void;
+}
+declare class FlatEnvConfig {
+    get BROWSER_USE_LOGGING_LEVEL(): string;
+    get ANONYMIZED_TELEMETRY(): boolean;
+    get BROWSER_USE_CLOUD_SYNC(): boolean | null;
+    get BROWSER_USE_CLOUD_API_URL(): string;
+    get BROWSER_USE_CLOUD_UI_URL(): string;
+    get XDG_CACHE_HOME(): string;
+    get XDG_CONFIG_HOME(): string;
+    get BROWSER_USE_CONFIG_DIR(): string | null;
+    get OPENAI_API_KEY(): string;
+    get ANTHROPIC_API_KEY(): string;
+    get GOOGLE_API_KEY(): string;
+    get DEEPSEEK_API_KEY(): string;
+    get GROK_API_KEY(): string;
+    get NOVITA_API_KEY(): string;
+    get AZURE_OPENAI_ENDPOINT(): string;
+    get AZURE_OPENAI_KEY(): string;
+    get SKIP_LLM_API_KEY_VERIFICATION(): boolean;
+    get IN_DOCKER(): boolean | null;
+    get IS_IN_EVALS(): boolean;
+    get WIN_FONT_DIR(): string;
+    get BROWSER_USE_CONFIG_PATH(): string | null;
+    get BROWSER_USE_HEADLESS(): boolean | null;
+    get BROWSER_USE_ALLOWED_DOMAINS(): string | null;
+    get BROWSER_USE_LLM_MODEL(): string | null;
+}
+interface DBStyleEntry {
+    id: string;
+    default: boolean;
+    created_at: string;
+}
+export interface BrowserProfileEntry extends DBStyleEntry {
+    headless?: boolean | null;
+    user_data_dir?: string | null;
+    allowed_domains?: string[] | null;
+    downloads_path?: string | null;
+    [key: string]: unknown;
+}
+export interface LLMEntry extends DBStyleEntry {
+    api_key?: string | null;
+    model?: string | null;
+    temperature?: number | null;
+    max_tokens?: number | null;
+}
+export interface AgentEntry extends DBStyleEntry {
+    max_steps?: number | null;
+    use_vision?: boolean | null;
+    system_prompt?: string | null;
+}
+export interface DBStyleConfigJSON {
+    browser_profile: Record<string, BrowserProfileEntry>;
+    llm: Record<string, LLMEntry>;
+    agent: Record<string, AgentEntry>;
+}
+type RuntimeConfig = {
+    browser_profile: Record<string, any>;
+    llm: Record<string, any>;
+    agent: Record<string, any>;
+};
+declare class ConfigCore {
+    private _get_config_path;
+    private _get_db_config;
+    private _get_default_entry;
+    _get_default_profile(): Record<string, any>;
+    _get_default_llm(): Record<string, any>;
+    _get_default_agent(): Record<string, any>;
+    _load_config(): RuntimeConfig;
+    _ensure_dirs(): void;
+    load_config(): RuntimeConfig;
+    get_default_profile(): Record<string, any>;
+    get_default_llm(): Record<string, any>;
+    get_default_agent(): Record<string, any>;
+}
+type ConfigType = ConfigCore & OldConfig & FlatEnvConfig;
+export declare const CONFIG: ConfigType;
+export declare const load_browser_use_config: () => RuntimeConfig;
+export declare const get_default_profile: (config: Record<string, any>) => any;
+export declare const get_default_llm: (config: Record<string, any>) => any;
+export {};