browser-use 0.4.0 → 0.6.0

package/dist/cli.js

@@ -2,12 +2,16 @@
 import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 import { stdin, stdout } from 'node:process';
 import { createInterface } from 'node:readline/promises';
 import { Agent } from './agent/service.js';
 import { BrowserProfile, } from './browser/profile.js';
-import { BrowserSession } from './browser/session.js';
+import { BrowserSession, systemChrome } from './browser/session.js';
 import { CONFIG } from './config.js';
+import { CloudBrowserClient } from './browser/cloud/cloud.js';
+import { CloudManagementClient, } from './browser/cloud/management.js';
 import { ChatOpenAI } from './llm/openai/chat.js';
 import { ChatAnthropic } from './llm/anthropic/chat.js';
 import { ChatGoogle } from './llm/google/chat.js';
@@ -17,6 +21,7 @@ import { ChatOpenRouter } from './llm/openrouter/chat.js';
 import { ChatAzure } from './llm/azure/chat.js';
 import { ChatOllama } from './llm/ollama/chat.js';
 import { ChatMistral } from './llm/mistral/chat.js';
+import { ChatOCIRaw } from './llm/oci-raw/chat.js';
 import { ChatCerebras } from './llm/cerebras/chat.js';
 import { ChatVercel } from './llm/vercel/chat.js';
 import { ChatAnthropicBedrock } from './llm/aws/chat-anthropic.js';
@@ -25,8 +30,11 @@ import { ChatBrowserUse } from './llm/browser-use/chat.js';
 import { MCPServer } from './mcp/server.js';
 import { get_browser_use_version } from './utils.js';
 import { setupLogging } from './logging-config.js';
+import { get_tunnel_manager } from './skill-cli/tunnel.js';
+import { DeviceAuthClient, save_cloud_api_token } from './sync/auth.js';
 import dotenv from 'dotenv';
 dotenv.config();
+const require = createRequire(import.meta.url);
 const CLI_PROVIDER_ALIASES = {
     openai: 'openai',
     anthropic: 'anthropic',
@@ -128,6 +136,10 @@ export const parseCliArgs = (argv) => {
         provider: null,
         prompt: null,
         mcp: false,
+        json: false,
+        yes: false,
+        setup_mode: null,
+        api_key: null,
         positional: [],
     };
     for (let i = 0; i < argv.length; i += 1) {
@@ -156,6 +168,14 @@ export const parseCliArgs = (argv) => {
             parsed.mcp = true;
             continue;
         }
+        if (arg === '--json') {
+            parsed.json = true;
+            continue;
+        }
+        if (arg === '-y' || arg === '--yes') {
+            parsed.yes = true;
+            continue;
+        }
         if (arg === '-p' || arg === '--prompt' || arg.startsWith('--prompt=')) {
             const { value, nextIndex } = takeOptionValue(arg, i, argv);
             parsed.prompt = value;
@@ -174,6 +194,18 @@ export const parseCliArgs = (argv) => {
             i = nextIndex;
             continue;
         }
+        if (arg === '--mode' || arg.startsWith('--mode=')) {
+            const { value, nextIndex } = takeOptionValue(arg, i, argv);
+            parsed.setup_mode = value.trim();
+            i = nextIndex;
+            continue;
+        }
+        if (arg === '--api-key' || arg.startsWith('--api-key=')) {
+            const { value, nextIndex } = takeOptionValue(arg, i, argv);
+            parsed.api_key = value.trim();
+            i = nextIndex;
+            continue;
+        }
         if (arg === '--window-width' || arg.startsWith('--window-width=')) {
             const { value, nextIndex } = takeOptionValue(arg, i, argv);
             parsed.window_width = parsePositiveInt('--window-width', value);
@@ -512,7 +544,9 @@ const createLlmForProvider = (provider, model) => {
                 baseURL: process.env.VERCEL_BASE_URL,
             });
         case 'oci':
-            throw new Error('OCI models require manual configuration in TypeScript runtime. Use a custom BaseChatModel integration for OCI credentials and endpoint setup.');
+            return new ChatOCIRaw({
+                model,
+            });
         case 'ollama': {
             const host = process.env.OLLAMA_HOST || 'http://localhost:11434';
             return new ChatOllama(model, host);
@@ -741,6 +775,14 @@ const runInteractiveMode = async (args, llm) => {
 };
 export const getCliUsage = () => `Usage:
   browser-use                    # interactive mode (TTY)
+  browser-use doctor
+  browser-use install
+  browser-use setup [--mode <local|remote|full>]
+  browser-use tunnel <port>
+  browser-use task <list|status|stop|logs>
+  browser-use session <list|get|stop|create|share>
+  browser-use profile <list|get|create|update|delete|cookies|sync>
+  browser-use run --remote <task>
   browser-use <task>
   browser-use -p "<task>"
   browser-use [options] <task>
@@ -750,9 +792,13 @@ Options:
   -h, --help                  Show this help message
   --version                   Print version and exit
   --mcp                       Run as MCP server
+  --json                      Output command results as JSON when supported
+  -y, --yes                   Skip optional setup prompts where supported
   --provider <name>           Force provider (openai|anthropic|google|deepseek|groq|openrouter|azure|mistral|cerebras|vercel|oci|ollama|browser-use|aws|aws-anthropic)
   --model <model>             Set model (e.g., gpt-5-mini, claude-4-sonnet, gemini-2.5-pro)
   -p, --prompt <task>         Run a single task
+  --mode <name>              Setup mode for setup command (local|remote|full)
+  --api-key <value>          Browser Use API key for setup or cloud operations
   --headless                  Run browser in headless mode
   --allowed-domains <items>   Comma-separated allowlist (e.g., example.com,*.example.org)
   --window-width <px>         Browser window width
@@ -765,6 +811,1696 @@ Options:
   --proxy-password <value>    Proxy password
   --cdp-url <url>             Connect to an existing Chromium instance via CDP
   --debug                     Enable debug logging`;
+const resolvePlaywrightCliPath = () => require.resolve('playwright/cli');
+export const runInstallCommand = (options = {}) => {
+    const playwrightCliPath = options.playwright_cli_path ?? resolvePlaywrightCliPath();
+    const spawnImpl = options.spawn_impl ?? spawnSync;
+    const result = spawnImpl(process.execPath, [playwrightCliPath, 'install', 'chromium'], {
+        stdio: 'inherit',
+    });
+    if (result.error) {
+        throw result.error;
+    }
+    if (result.status !== 0) {
+        throw new Error(`Playwright browser install failed with exit code ${result.status ?? 1}`);
+    }
+};
+const writeLine = (stream, value) => {
+    stream.write(`${value}\n`);
+};
+const parseTunnelPort = (value) => {
+    const port = Number.parseInt(String(value ?? ''), 10);
+    if (!Number.isFinite(port) || port <= 0) {
+        throw new Error(`Invalid port: ${value ?? ''}`);
+    }
+    return port;
+};
+export const runTunnelCommand = async (argv, options = {}) => {
+    const manager = options.manager ?? get_tunnel_manager();
+    const output = options.stdout ?? process.stdout;
+    const errorOutput = options.stderr ?? process.stderr;
+    const json_output = Boolean(options.json_output);
+    const render = (value) => {
+        if (json_output) {
+            writeLine(output, JSON.stringify(value, null, 2));
+        }
+    };
+    try {
+        const first = argv[0] ?? null;
+        if (!first) {
+            writeLine(errorOutput, 'Usage: browser-use tunnel <port> | list | stop <port> | stop --all');
+            return 1;
+        }
+        if (first === 'list') {
+            const result = manager.list_tunnels();
+            if (json_output) {
+                render(result);
+            }
+            else if (result.tunnels.length > 0) {
+                for (const tunnel of result.tunnels) {
+                    writeLine(output, `${tunnel.port}: ${tunnel.url}`);
+                }
+            }
+            else {
+                writeLine(output, 'No active tunnels');
+            }
+            return 0;
+        }
+        if (first === 'stop' || first === 'stop-all') {
+            const stopAll = first === 'stop-all' || argv.includes('--all');
+            if (stopAll) {
+                const result = await manager.stop_all_tunnels();
+                if (json_output) {
+                    render(result);
+                }
+                else if (result.count > 0) {
+                    writeLine(output, `Stopped ${result.count} tunnel(s): ${result.stopped.join(', ')}`);
+                }
+                else {
+                    writeLine(output, 'No tunnels to stop');
+                }
+                return 0;
+            }
+            const port = parseTunnelPort(argv[1]);
+            const result = await manager.stop_tunnel(port);
+            if ('error' in result) {
+                writeLine(errorOutput, result.error);
+                return 1;
+            }
+            if (json_output) {
+                render(result);
+            }
+            else {
+                writeLine(output, `Stopped tunnel on port ${result.stopped}`);
+            }
+            return 0;
+        }
+        const port = parseTunnelPort(first);
+        const result = await manager.start_tunnel(port);
+        if ('error' in result) {
+            writeLine(errorOutput, result.error);
+            return 1;
+        }
+        if (json_output) {
+            render(result);
+        }
+        else if (result.existing) {
+            writeLine(output, `Tunnel already running: http://localhost:${result.port} -> ${result.url}`);
+        }
+        else {
+            writeLine(output, `Tunnel started: http://localhost:${result.port} -> ${result.url}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        writeLine(errorOutput, error.message);
+        return 1;
+    }
+};
+const validateSetupMode = (mode) => {
+    const normalized = (mode ?? 'local').trim().toLowerCase();
+    if (normalized === 'local' ||
+        normalized === 'remote' ||
+        normalized === 'full') {
+        return normalized;
+    }
+    throw new Error(`Invalid setup mode "${mode ?? ''}". Expected local, remote, or full.`);
+};
+const renderSetupChecks = (mode, report) => {
+    const checks = {
+        browser_use_package: report.checks.package,
+    };
+    if (mode === 'local' || mode === 'full') {
+        checks.browser = report.checks.browser;
+    }
+    if (mode === 'remote' || mode === 'full') {
+        checks.api_key = report.checks.api_key;
+        checks.cloudflared = report.checks.cloudflared;
+    }
+    return checks;
+};
+const planSetupActions = (mode, checks, yes, api_key) => {
+    const actions = [];
+    if ((mode === 'local' || mode === 'full') &&
+        checks.browser?.status !== 'ok') {
+        actions.push({
+            type: 'install_browser',
+            description: 'Install browser (Chromium)',
+            required: true,
+        });
+    }
+    if ((mode === 'remote' || mode === 'full') &&
+        checks.api_key?.status !== 'ok') {
+        if (api_key?.trim()) {
+            actions.push({
+                type: 'configure_api_key',
+                description: 'Configure API key',
+                required: true,
+                api_key: api_key.trim(),
+            });
+        }
+        else if (!yes) {
+            actions.push({
+                type: 'prompt_api_key',
+                description: 'Prompt for API key',
+                required: false,
+            });
+        }
+    }
+    if ((mode === 'remote' || mode === 'full') &&
+        checks.cloudflared?.status !== 'ok') {
+        actions.push({
+            type: 'install_cloudflared',
+            description: 'Install cloudflared (for tunneling)',
+            required: true,
+        });
+    }
+    return actions;
+};
+const logSetupChecks = (stream, checks) => {
+    writeLine(stream, '');
+    writeLine(stream, 'Running checks...');
+    writeLine(stream, '');
+    for (const [name, check] of Object.entries(checks)) {
+        const icon = check.status === 'ok' ? '✓' : check.status === 'missing' ? '⚠' : '✗';
+        writeLine(stream, `  ${icon} ${name.replace(/_/g, ' ')}: ${check.message}`);
+    }
+    writeLine(stream, '');
+};
+const logSetupActions = (stream, actions) => {
+    if (actions.length === 0) {
+        writeLine(stream, 'No additional setup needed.');
+        writeLine(stream, '');
+        return;
+    }
+    writeLine(stream, '');
+    writeLine(stream, 'Setup actions:');
+    writeLine(stream, '');
+    actions.forEach((action, index) => {
+        writeLine(stream, `  ${index + 1}. ${action.description} ${action.required ? '(required)' : '(optional)'}`);
+    });
+    writeLine(stream, '');
+};
+const logSetupValidation = (stream, validation) => {
+    writeLine(stream, '');
+    writeLine(stream, 'Validation:');
+    writeLine(stream, '');
+    for (const [name, result] of Object.entries(validation)) {
+        const normalized = String(result);
+        const ok = normalized === 'ok' || normalized === 'true';
+        writeLine(stream, `  ${ok ? '✓' : '✗'} ${name.replace(/_/g, ' ')}: ${normalized}`);
+    }
+    writeLine(stream, '');
+};
+export const runSetupCommand = async (params, options = {}) => {
+    const mode = validateSetupMode(params.mode);
+    const yes = Boolean(params.yes);
+    const api_key = params.api_key?.trim() || null;
+    const runDoctor = options.run_doctor_checks ??
+        ((doctorOptions) => runDoctorChecks(doctorOptions));
+    const installCommand = options.install_command ?? runInstallCommand;
+    const saveApiKey = options.save_api_key ?? save_cloud_api_token;
+    const output = options.stdout ?? process.stdout;
+    const json_output = Boolean(options.json_output);
+    const initialReport = await runDoctor();
+    const checks = renderSetupChecks(mode, initialReport);
+    const actions = planSetupActions(mode, checks, yes, api_key);
+    if (!json_output) {
+        logSetupChecks(output, checks);
+        logSetupActions(output, actions);
+    }
+    for (const action of actions) {
+        if (action.type === 'install_browser') {
+            if (!json_output) {
+                writeLine(output, 'Installing Chromium browser...');
+            }
+            await installCommand();
+            continue;
+        }
+        if (action.type === 'configure_api_key') {
+            if (!json_output) {
+                writeLine(output, 'Configuring API key...');
+            }
+            saveApiKey(action.api_key);
+            continue;
+        }
+        if (action.type === 'prompt_api_key' && !json_output) {
+            writeLine(output, 'API key not configured');
+            writeLine(output, '  Set via: export BROWSER_USE_API_KEY=your_key');
+            writeLine(output, '  Or: browser-use setup --api-key <key>');
+            continue;
+        }
+        if (action.type === 'install_cloudflared' && !json_output) {
+            writeLine(output, 'cloudflared not installed');
+            writeLine(output, '  Install via:');
+            writeLine(output, '  macOS:   brew install cloudflared');
+            writeLine(output, '  Linux:   curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o ~/.local/bin/cloudflared && chmod +x ~/.local/bin/cloudflared');
+            writeLine(output, '  Windows: winget install Cloudflare.cloudflared');
+            writeLine(output, '');
+        }
+    }
+    const validationReport = await runDoctor();
+    const validation = {
+        browser_use_import: 'ok',
+    };
+    if (mode === 'local' || mode === 'full') {
+        validation.browser_available =
+            validationReport.checks.browser.status === 'ok'
+                ? 'ok'
+                : `failed: ${validationReport.checks.browser.message}`;
+    }
+    if (mode === 'remote' || mode === 'full') {
+        validation.api_key_available =
+            validationReport.checks.api_key.status === 'ok';
+        validation.cloudflared_available =
+            validationReport.checks.cloudflared.status === 'ok';
+    }
+    const result = {
+        status: 'success',
+        mode,
+        checks,
+        validation,
+    };
+    if (json_output) {
+        writeLine(output, JSON.stringify(result, null, 2));
+    }
+    else {
+        logSetupValidation(output, validation);
+    }
+    return 0;
+};
+const formatDuration = (startedAt, finishedAt) => {
+    if (!startedAt) {
+        return '';
+    }
+    const start = new Date(startedAt).getTime();
+    const end = finishedAt ? new Date(finishedAt).getTime() : Date.now();
+    if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) {
+        return '';
+    }
+    const totalSeconds = Math.floor((end - start) / 1000);
+    if (totalSeconds < 60) {
+        return `${totalSeconds}s`;
+    }
+    if (totalSeconds < 3600) {
+        return `${Math.floor(totalSeconds / 60)}m ${totalSeconds % 60}s`;
+    }
+    return `${Math.floor(totalSeconds / 3600)}h ${Math.floor((totalSeconds % 3600) / 60)}m`;
+};
+const printTaskStep = (stream, step, verbose) => {
+    const stepNumber = step.number ?? '?';
+    const memory = String(step.memory ?? '');
+    if (verbose) {
+        const url = String(step.url ?? '');
+        const shortUrl = url.length > 60 ? `${url.slice(0, 57)}...` : url;
+        writeLine(stream, `  [${stepNumber}] ${shortUrl}`);
+        if (memory) {
+            const shortMemory = memory.length > 100 ? `${memory.slice(0, 97)}...` : memory;
+            writeLine(stream, `      Reasoning: ${shortMemory}`);
+        }
+        const actions = Array.isArray(step.actions) ? step.actions : [];
+        actions.slice(0, 2).forEach((action) => {
+            const text = String(action);
+            const shortAction = text.length > 70 ? `${text.slice(0, 67)}...` : text;
+            writeLine(stream, `      Action: ${shortAction}`);
+        });
+        if (actions.length > 2) {
+            writeLine(stream, `      ... and ${actions.length - 2} more actions`);
+        }
+        return;
+    }
+    const shortMemory = memory
+        ? memory.length > 80
+            ? `${memory.slice(0, 77)}...`
+            : memory
+        : '(no reasoning)';
+    writeLine(stream, `  ${stepNumber}. ${shortMemory}`);
+};
+const requireCommandTarget = (value, usage) => {
+    const target = value?.trim();
+    if (!target || target.startsWith('-')) {
+        throw new Error(usage);
+    }
+    return target;
+};
+const rejectUnexpectedPositionals = (positionals, usage) => {
+    if (positionals.length > 0) {
+        throw new Error(usage);
+    }
+};
+const markUsedOption = (used_options, option) => {
+    if (!used_options.includes(option)) {
+        used_options.push(option);
+    }
+};
+const rejectUnsupportedFlags = (used_options, allowed_options, usage) => {
+    const allowed = new Set(allowed_options);
+    const unsupported = used_options.find((option) => !allowed.has(option));
+    if (unsupported) {
+        throw new Error(usage);
+    }
+};
+const parseTaskCommandFlags = (argv) => {
+    const flags = {
+        json: false,
+        limit: 10,
+        status: null,
+        session: null,
+        compact: false,
+        verbose: false,
+        last: null,
+        reverse: false,
+        step: null,
+        positionals: [],
+        used_options: [],
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index] ?? '';
+        if (arg === '--json') {
+            flags.json = true;
+            markUsedOption(flags.used_options, '--json');
+            continue;
+        }
+        if (arg === '--compact' || arg === '-c') {
+            flags.compact = true;
+            markUsedOption(flags.used_options, '--compact');
+            continue;
+        }
+        if (arg === '--verbose' || arg === '-v') {
+            flags.verbose = true;
+            markUsedOption(flags.used_options, '--verbose');
+            continue;
+        }
+        if (arg === '--reverse' || arg === '-r') {
+            flags.reverse = true;
+            markUsedOption(flags.used_options, '--reverse');
+            continue;
+        }
+        if (arg === '--limit' || arg.startsWith('--limit=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.limit = parsePositiveInt('--limit', value);
+            markUsedOption(flags.used_options, '--limit');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--status' || arg.startsWith('--status=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.status = value;
+            markUsedOption(flags.used_options, '--status');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--session' || arg.startsWith('--session=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.session = value;
+            markUsedOption(flags.used_options, '--session');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--last' || arg === '-n' || arg.startsWith('--last=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.last = parsePositiveInt('--last', value);
+            markUsedOption(flags.used_options, '--last');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--step' || arg === '-s' || arg.startsWith('--step=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.step = parsePositiveInt('--step', value);
+            markUsedOption(flags.used_options, '--step');
+            index = nextIndex;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        flags.positionals.push(arg);
+    }
+    return flags;
+};
+export const runTaskCommand = async (argv, options = {}) => {
+    const client = options.client ?? new CloudManagementClient();
+    const output = options.stdout ?? process.stdout;
+    const errorOutput = options.stderr ?? process.stderr;
+    const subcommand = argv[0] ?? '';
+    try {
+        if (subcommand === 'list') {
+            const flags = parseTaskCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use task list [options]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--limit', '--status', '--session'], 'Usage: browser-use task list [options]');
+            const result = await client.list_tasks({
+                pageSize: flags.limit,
+                filterBy: flags.status,
+                sessionId: flags.session,
+            });
+            if (flags.json) {
+                writeLine(output, JSON.stringify(result.items, null, 2));
+                return 0;
+            }
+            if (result.items.length === 0) {
+                writeLine(output, 'No tasks found');
+                return 0;
+            }
+            writeLine(output, `Tasks (${result.items.length}):`);
+            for (const task of result.items) {
+                const emoji = {
+                    created: '🕒',
+                    started: '🔄',
+                    running: '🔄',
+                    finished: '✅',
+                    stopped: '⏹️',
+                    failed: '❌',
+                }[task.status] ?? '❓';
+                const text = task.task.length > 50 ? `${task.task.slice(0, 47)}...` : task.task;
+                writeLine(output, `  ${emoji} ${task.id.slice(0, 8)}... [${task.status}] ${text}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'status') {
+            const taskId = requireCommandTarget(argv[1], 'Usage: browser-use task status <task-id>');
+            const flags = parseTaskCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use task status <task-id>');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--compact', '--verbose', '--reverse', '--last', '--step'], 'Usage: browser-use task status <task-id>');
+            const task = await client.get_task(taskId);
+            if (flags.json) {
+                writeLine(output, JSON.stringify(task, null, 2));
+                return 0;
+            }
+            const parts = [
+                `${{
+                    created: '🕒',
+                    started: '🔄',
+                    running: '🔄',
+                    finished: '✅',
+                    stopped: '⏹️',
+                    failed: '❌',
+                }[task.status] ?? '❓'} ${task.id.slice(0, 8)}... [${task.status}]`,
+            ];
+            const duration = formatDuration(task.startedAt, task.finishedAt);
+            if (duration) {
+                parts.push(duration);
+            }
+            writeLine(output, parts.join(' '));
+            let steps = [...(task.steps ?? [])];
+            const showAllSteps = flags.compact || flags.verbose;
+            if (flags.step !== null) {
+                steps = steps.filter((step) => Number(step.number) === flags.step);
+            }
+            else if (!showAllSteps && steps.length > 1) {
+                writeLine(output, `  ... ${steps.length - 1} earlier steps`);
+                steps = [steps[steps.length - 1]];
+            }
+            else if (flags.last !== null && flags.last < steps.length) {
+                writeLine(output, `  ... ${steps.length - flags.last} earlier steps`);
+                steps = steps.slice(-flags.last);
+            }
+            if (flags.reverse) {
+                steps.reverse();
+            }
+            steps.forEach((step) => printTaskStep(output, step, flags.verbose));
+            if (task.output) {
+                writeLine(output, '');
+                writeLine(output, `Output: ${task.output}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'stop') {
+            const taskId = requireCommandTarget(argv[1], 'Usage: browser-use task stop <task-id>');
+            const flags = parseTaskCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use task stop <task-id>');
+            rejectUnsupportedFlags(flags.used_options, ['--json'], 'Usage: browser-use task stop <task-id>');
+            await client.update_task(taskId, 'stop');
+            if (flags.json) {
+                writeLine(output, JSON.stringify({ stopped: taskId }, null, 2));
+            }
+            else {
+                writeLine(output, `Stopped task: ${taskId}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'logs') {
+            const taskId = requireCommandTarget(argv[1], 'Usage: browser-use task logs <task-id>');
+            const flags = parseTaskCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use task logs <task-id>');
+            rejectUnsupportedFlags(flags.used_options, ['--json'], 'Usage: browser-use task logs <task-id>');
+            const result = await client.get_task_logs(taskId);
+            if (flags.json) {
+                writeLine(output, JSON.stringify(result, null, 2));
+            }
+            else if (result.downloadUrl) {
+                writeLine(output, `Download logs: ${result.downloadUrl}`);
+            }
+            else {
+                writeLine(output, 'No logs available for this task');
+            }
+            return 0;
+        }
+        writeLine(errorOutput, 'Usage: browser-use task <list|status|stop|logs> [options]');
+        return 1;
+    }
+    catch (error) {
+        writeLine(errorOutput, `Error: ${error.message}`);
+        return 1;
+    }
+};
+const parseSessionCommandFlags = (argv) => {
+    const flags = {
+        json: false,
+        limit: 10,
+        status: null,
+        all: false,
+        delete: false,
+        profile: null,
+        proxy_country: null,
+        start_url: null,
+        screen_size: null,
+        positionals: [],
+        used_options: [],
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index] ?? '';
+        if (arg === '--json') {
+            flags.json = true;
+            markUsedOption(flags.used_options, '--json');
+            continue;
+        }
+        if (arg === '--all') {
+            flags.all = true;
+            markUsedOption(flags.used_options, '--all');
+            continue;
+        }
+        if (arg === '--delete') {
+            flags.delete = true;
+            markUsedOption(flags.used_options, '--delete');
+            continue;
+        }
+        if (arg === '--limit' || arg.startsWith('--limit=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.limit = parsePositiveInt('--limit', value);
+            markUsedOption(flags.used_options, '--limit');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--status' || arg.startsWith('--status=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.status = value;
+            markUsedOption(flags.used_options, '--status');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--profile' || arg.startsWith('--profile=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.profile = value;
+            markUsedOption(flags.used_options, '--profile');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--proxy-country' || arg.startsWith('--proxy-country=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.proxy_country = value;
+            markUsedOption(flags.used_options, '--proxy-country');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--start-url' || arg.startsWith('--start-url=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.start_url = value;
+            markUsedOption(flags.used_options, '--start-url');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--screen-size' || arg.startsWith('--screen-size=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.screen_size = value;
+            markUsedOption(flags.used_options, '--screen-size');
+            index = nextIndex;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        flags.positionals.push(arg);
+    }
+    return flags;
+};
+export const runSessionCommand = async (argv, options = {}) => {
+    const client = options.client ?? new CloudManagementClient();
+    const output = options.stdout ?? process.stdout;
+    const errorOutput = options.stderr ?? process.stderr;
+    const subcommand = argv[0] ?? '';
+    try {
+        if (subcommand === 'list') {
+            const flags = parseSessionCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use session list [options]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--limit', '--status'], 'Usage: browser-use session list [options]');
+            const result = await client.list_sessions({
+                pageSize: flags.limit,
+                filterBy: flags.status,
+            });
+            if (flags.json) {
+                writeLine(output, JSON.stringify(result.items, null, 2));
+                return 0;
+            }
+            if (result.items.length === 0) {
+                writeLine(output, 'No sessions found');
+                return 0;
+            }
+            writeLine(output, `Sessions (${result.items.length}):`);
+            for (const session of result.items) {
+                const emoji = session.status === 'active' ? '🟢' : '⏹️';
+                const duration = formatDuration(session.startedAt, session.finishedAt);
+                const details = duration ? ` ${duration}` : '';
+                writeLine(output, `  ${emoji} ${session.id.slice(0, 8)}... [${session.status}]${details}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'get') {
+            const sessionId = requireCommandTarget(argv[1], 'Usage: browser-use session get <session-id>');
+            const flags = parseSessionCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use session get <session-id>');
+            rejectUnsupportedFlags(flags.used_options, ['--json'], 'Usage: browser-use session get <session-id>');
+            const session = await client.get_session(sessionId);
+            if (flags.json) {
+                writeLine(output, JSON.stringify(session, null, 2));
+            }
+            else {
+                writeLine(output, `${session.id} [${session.status}]`);
+                if (session.liveUrl) {
+                    writeLine(output, `Live URL: ${session.liveUrl}`);
+                }
+                const duration = formatDuration(session.startedAt, session.finishedAt);
+                if (duration) {
+                    writeLine(output, `Duration: ${duration}`);
+                }
+            }
+            return 0;
+        }
+        if (subcommand === 'stop') {
+            const flags = parseSessionCommandFlags(argv.slice(1));
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--all'], 'Usage: browser-use session stop <session-id> | --all');
+            if (flags.all) {
+                rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use session stop <session-id> | --all');
+                const sessions = await client.list_sessions({
+                    pageSize: 100,
+                    filterBy: 'active',
+                });
+                const stopped = [];
+                for (const session of sessions.items) {
+                    await client.update_session(session.id, 'stop');
+                    stopped.push(session.id);
+                }
+                if (flags.json) {
+                    writeLine(output, JSON.stringify({ stopped }, null, 2));
+                }
+                else if (stopped.length > 0) {
+                    writeLine(output, `Stopped ${stopped.length} session(s): ${stopped.join(', ')}`);
+                }
+                else {
+                    writeLine(output, 'No sessions to stop');
+                }
+                return 0;
+            }
+            const [sessionIdCandidate, ...unexpectedPositionals] = flags.positionals;
+            rejectUnexpectedPositionals(unexpectedPositionals, 'Usage: browser-use session stop <session-id> | --all');
+            const sessionId = requireCommandTarget(sessionIdCandidate ?? argv[1], 'Usage: browser-use session stop <session-id> | --all');
+            await client.update_session(sessionId, 'stop');
+            if (flags.json) {
+                writeLine(output, JSON.stringify({ stopped: sessionId }, null, 2));
+            }
+            else {
+                writeLine(output, `Stopped session: ${sessionId}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'create') {
+            const flags = parseSessionCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use session create [options]');
+            rejectUnsupportedFlags(flags.used_options, [
+                '--json',
+                '--profile',
+                '--proxy-country',
+                '--start-url',
+                '--screen-size',
+            ], 'Usage: browser-use session create [options]');
+            let browserScreenWidth = null;
+            let browserScreenHeight = null;
+            if (flags.screen_size) {
+                const match = flags.screen_size.match(/^(\d+)x(\d+)$/i);
+                if (!match) {
+                    throw new Error('Expected --screen-size WIDTHxHEIGHT');
+                }
+                browserScreenWidth = Number.parseInt(match[1], 10);
+                browserScreenHeight = Number.parseInt(match[2], 10);
+            }
+            const session = await client.create_session({
+                profileId: flags.profile,
+                proxyCountryCode: flags.proxy_country,
+                startUrl: flags.start_url,
+                browserScreenWidth,
+                browserScreenHeight,
+            });
+            if (flags.json) {
+                writeLine(output, JSON.stringify(session, null, 2));
+            }
+            else {
+                writeLine(output, `Created session: ${session.id}`);
+                if (session.liveUrl) {
+                    writeLine(output, `Live URL: ${session.liveUrl}`);
+                }
+            }
+            return 0;
+        }
+        if (subcommand === 'share') {
+            const sessionId = requireCommandTarget(argv[1], 'Usage: browser-use session share <session-id> [--delete]');
+            const flags = parseSessionCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use session share <session-id> [--delete]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--delete'], 'Usage: browser-use session share <session-id> [--delete]');
+            if (flags.delete) {
+                await client.delete_session_public_share(sessionId);
+                if (flags.json) {
+                    writeLine(output, JSON.stringify({ deleted: sessionId }, null, 2));
+                }
+                else {
+                    writeLine(output, `Deleted public share for session: ${sessionId}`);
+                }
+            }
+            else {
+                const share = await client.create_session_public_share(sessionId);
+                if (flags.json) {
+                    writeLine(output, JSON.stringify(share, null, 2));
+                }
+                else {
+                    writeLine(output, `Public share URL: ${share.shareUrl}`);
+                }
+            }
+            return 0;
+        }
+        writeLine(errorOutput, 'Usage: browser-use session <list|get|stop|create|share> [options]');
+        return 1;
+    }
+    catch (error) {
+        writeLine(errorOutput, `Error: ${error.message}`);
+        return 1;
+    }
+};
+const parseProfileCommandFlags = (argv) => {
+    const flags = {
+        json: false,
+        remote: false,
+        limit: 20,
+        name: null,
+        domain: null,
+        from_profile: null,
+        positionals: [],
+        used_options: [],
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index] ?? '';
+        if (arg === '--json') {
+            flags.json = true;
+            markUsedOption(flags.used_options, '--json');
+            continue;
+        }
+        if (arg === '--remote') {
+            flags.remote = true;
+            markUsedOption(flags.used_options, '--remote');
+            continue;
+        }
+        if (arg === '--limit' || arg.startsWith('--limit=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.limit = parsePositiveInt('--limit', value);
+            markUsedOption(flags.used_options, '--limit');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--name' || arg.startsWith('--name=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.name = value;
+            markUsedOption(flags.used_options, '--name');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--domain' || arg.startsWith('--domain=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.domain = value;
+            markUsedOption(flags.used_options, '--domain');
+            index = nextIndex;
+            continue;
+        }
+        if (arg === '--from' || arg.startsWith('--from=')) {
+            const { value, nextIndex } = takeOptionValue(arg, index, argv);
+            flags.from_profile = value;
+            markUsedOption(flags.used_options, '--from');
+            index = nextIndex;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        flags.positionals.push(arg);
+    }
+    return flags;
+};
+const normalizeProfileCookieDomain = (value) => String(value ?? '')
+    .trim()
+    .replace(/^\./, '')
+    .toLowerCase();
+const cookieMatchesDomainFilter = (cookie, domainFilter) => {
+    if (!domainFilter) {
+        return true;
+    }
+    const cookieDomain = normalizeProfileCookieDomain(cookie.domain);
+    const normalizedFilter = normalizeProfileCookieDomain(domainFilter);
+    return Boolean(cookieDomain &&
+        normalizedFilter &&
+        (cookieDomain === normalizedFilter ||
+            cookieDomain.endsWith(`.${normalizedFilter}`) ||
+            normalizedFilter.endsWith(`.${cookieDomain}`)));
+};
+export const runProfileCommand = async (argv, options = {}) => {
+    const client = options.client ?? new CloudManagementClient();
+    const profileLister = options.profile_lister ?? (() => systemChrome.listProfiles());
+    const localSessionFactory = options.local_session_factory ??
+        ((profile_directory) => BrowserSession.from_system_chrome({
+            profile_directory,
+            profile: { headless: true },
+        }));
+    const remoteSessionFactory = options.remote_session_factory ??
+        ((init) => new BrowserSession({
+            cdp_url: init.cdp_url,
+        }));
+    const cloudBrowserClientFactory = options.cloud_browser_client_factory ?? (() => new CloudBrowserClient());
+    const output = options.stdout ?? process.stdout;
+    const errorOutput = options.stderr ?? process.stderr;
+    const subcommand = argv[0] ?? '';
+    try {
+        if (subcommand === 'list') {
+            const flags = parseProfileCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile list [--remote] [options]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--remote', '--limit'], 'Usage: browser-use profile list [--remote] [options]');
+            if (flags.remote) {
+                const result = await client.list_profiles({
+                    pageSize: flags.limit,
+                });
+                if (flags.json) {
+                    writeLine(output, JSON.stringify(result.items, null, 2));
+                }
+                else if (result.items.length === 0) {
+                    writeLine(output, 'No cloud profiles found');
+                }
+                else {
+                    writeLine(output, `Cloud profiles (${result.items.length}):`);
+                    result.items.forEach((profile) => {
+                        writeLine(output, `  ${profile.id}: ${profile.name || 'Unnamed'}`);
+                    });
+                }
+                return 0;
+            }
+            const profiles = profileLister();
+            if (flags.json) {
+                writeLine(output, JSON.stringify({ profiles }, null, 2));
+            }
+            else if (profiles.length === 0) {
+                writeLine(output, 'No Chrome profiles found');
+            }
+            else {
+                writeLine(output, 'Local Chrome profiles:');
+                profiles.forEach((profile) => {
+                    const emailSuffix = profile.email ? ` (${profile.email})` : '';
+                    writeLine(output, `  ${profile.directory}: ${profile.name}${emailSuffix}`);
+                });
+            }
+            return 0;
+        }
+        if (subcommand === 'get') {
+            const profileId = requireCommandTarget(argv[1], 'Usage: browser-use profile get <profile-id> [--remote]');
+            const flags = parseProfileCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile get <profile-id> [--remote]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--remote'], 'Usage: browser-use profile get <profile-id> [--remote]');
+            if (flags.remote) {
+                const profile = await client.get_profile(profileId);
+                if (flags.json) {
+                    writeLine(output, JSON.stringify(profile, null, 2));
+                }
+                else {
+                    writeLine(output, `Profile: ${profile.id}`);
+                    if (profile.name) {
+                        writeLine(output, `  Name: ${profile.name}`);
+                    }
+                    writeLine(output, `  Updated: ${profile.updatedAt}`);
+                }
+                return 0;
+            }
+            const profile = profileLister().find((entry) => entry.directory === profileId || entry.name === profileId);
+            if (!profile) {
+                throw new Error(`Profile "${profileId}" not found`);
+            }
+            if (flags.json) {
+                writeLine(output, JSON.stringify(profile, null, 2));
+            }
+            else {
+                writeLine(output, `Profile: ${profile.directory}`);
+                writeLine(output, `  Name: ${profile.name}`);
+                if (profile.email) {
+                    writeLine(output, `  Email: ${profile.email}`);
+                }
+            }
+            return 0;
+        }
+        if (subcommand === 'create') {
+            const flags = parseProfileCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile create --remote [--name <name>] [--json]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--remote', '--name'], 'Usage: browser-use profile create --remote [--name <name>] [--json]');
+            if (!flags.remote) {
+                throw new Error('Profile create is only supported with --remote');
+            }
+            const profile = await client.create_profile({ name: flags.name });
+            if (flags.json) {
+                writeLine(output, JSON.stringify(profile, null, 2));
+            }
+            else {
+                writeLine(output, `Created cloud profile: ${profile.id}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'delete') {
+            const profileId = requireCommandTarget(argv[1], 'Usage: browser-use profile delete <profile-id> --remote');
+            const flags = parseProfileCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile delete <profile-id> --remote');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--remote'], 'Usage: browser-use profile delete <profile-id> --remote');
+            if (!flags.remote) {
+                throw new Error('Profile delete is only supported with --remote');
+            }
+            await client.delete_profile(profileId);
+            if (flags.json) {
+                writeLine(output, JSON.stringify({ deleted: profileId }, null, 2));
+            }
+            else {
+                writeLine(output, `Deleted cloud profile: ${profileId}`);
+            }
+            return 0;
+        }
+        if (subcommand === 'cookies') {
+            const profileId = requireCommandTarget(argv[1], 'Usage: browser-use profile cookies <profile-id>');
+            const flags = parseProfileCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile cookies <profile-id>');
+            rejectUnsupportedFlags(flags.used_options, ['--json'], 'Usage: browser-use profile cookies <profile-id>');
+            if (flags.remote) {
+                throw new Error('Profile cookies is only supported for local Chrome profiles');
+            }
+            const profile = profileLister().find((entry) => entry.directory === profileId || entry.name === profileId);
+            if (!profile) {
+                throw new Error(`Profile "${profileId}" not found`);
+            }
+            const session = localSessionFactory(profile.directory);
+            await session.start();
+            try {
+                const cookies = (await session.get_cookies?.()) ?? [];
+                const domains = new Map();
+                for (const cookie of cookies) {
+                    const domain = normalizeProfileCookieDomain(cookie.domain) || 'unknown';
+                    domains.set(domain, (domains.get(domain) ?? 0) + 1);
+                }
+                const sortedDomains = Array.from(domains.entries()).sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));
+                if (flags.json) {
+                    writeLine(output, JSON.stringify({
+                        domains: Object.fromEntries(sortedDomains),
+                        total_cookies: cookies.length,
+                    }, null, 2));
+                }
+                else {
+                    const emailSuffix = profile.email ? ` (${profile.email})` : '';
+                    writeLine(output, `Loading cookies from: ${profile.name}${emailSuffix}`);
+                    writeLine(output, '');
+                    writeLine(output, `Cookies by domain (${cookies.length} total):`);
+                    sortedDomains.slice(0, 20).forEach(([domain, count]) => {
+                        writeLine(output, `  ${domain}: ${count}`);
+                    });
+                    if (sortedDomains.length > 20) {
+                        writeLine(output, `  ... and ${sortedDomains.length - 20} more domains`);
+                    }
+                    writeLine(output, '');
+                    writeLine(output, 'To sync cookies to cloud:');
+                    writeLine(output, `  browser-use profile sync --from "${profile.directory}" --domain <domain>`);
+                }
+            }
+            finally {
+                await session.stop?.();
+            }
+            return 0;
+        }
+        if (subcommand === 'sync') {
+            const flags = parseProfileCommandFlags(argv.slice(1));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile sync --from <profile-id> [--name <name>] [--domain <domain>] [--json]');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--from', '--name', '--domain'], 'Usage: browser-use profile sync --from <profile-id> [--name <name>] [--domain <domain>] [--json]');
+            const profiles = profileLister();
+            const fromProfile = flags.from_profile?.trim();
+            if (!fromProfile) {
+                writeLine(errorOutput, 'Usage: browser-use profile sync --from <profile-id> [--name <name>] [--domain <domain>] [--json]');
+                if (profiles.length > 0) {
+                    writeLine(errorOutput, 'Available local profiles:');
+                    profiles.forEach((profile) => {
+                        const emailSuffix = profile.email ? ` (${profile.email})` : '';
+                        writeLine(errorOutput, `  ${profile.directory}: ${profile.name}${emailSuffix}`);
+                    });
+                }
+                return 1;
+            }
+            const profile = profiles.find((entry) => entry.directory === fromProfile || entry.name === fromProfile);
+            if (!profile) {
+                throw new Error(`Profile "${fromProfile}" not found`);
+            }
+            const progress = flags.json ? errorOutput : output;
+            const logProgress = (message) => writeLine(progress, message);
+            const cloudName = flags.name ??
+                (flags.domain
+                    ? `Chrome - ${profile.name} (${flags.domain})`
+                    : `Chrome - ${profile.name}`);
+            let cloudProfileId = null;
+            let cloudBrowserSessionId = null;
+            const cloudBrowserClient = cloudBrowserClientFactory();
+            try {
+                logProgress(`Syncing: ${profile.name}${profile.email ? ` (${profile.email})` : ''}`);
+                logProgress('  Creating cloud profile...');
+                const cloudProfile = await client.create_profile({ name: cloudName });
+                cloudProfileId = cloudProfile.id;
+                logProgress(`  Created: ${cloudProfileId}`);
+                logProgress('  Exporting cookies from local profile...');
+                const localSession = localSessionFactory(profile.directory);
+                let filteredCookies = [];
+                await localSession.start();
+                try {
+                    const cookies = ((await localSession.get_cookies?.()) ??
+                        []);
+                    filteredCookies = cookies.filter((cookie) => cookieMatchesDomainFilter(cookie, flags.domain));
+                }
+                finally {
+                    await localSession.stop?.();
+                }
+                if (filteredCookies.length === 0) {
+                    throw new Error(flags.domain
+                        ? `No cookies found for domain: ${flags.domain}`
+                        : 'No cookies found in local profile');
+                }
+                logProgress(`  Found ${filteredCookies.length} cookies`);
+                logProgress('  Importing cookies to cloud profile...');
+                const cloudBrowser = await cloudBrowserClient.create_browser({
+                    profile_id: cloudProfileId,
+                });
+                cloudBrowserSessionId = cloudBrowser.id;
+                if (!cloudBrowser.cdpUrl) {
+                    throw new Error('Cloud browser did not return a CDP URL');
+                }
+                const remoteSession = remoteSessionFactory({
+                    cdp_url: cloudBrowser.cdpUrl,
+                });
+                await remoteSession.start();
+                try {
+                    if (!remoteSession.browser_context?.addCookies) {
+                        throw new Error('Remote browser context does not support addCookies');
+                    }
+                    await remoteSession.browser_context.addCookies(filteredCookies);
+                }
+                finally {
+                    await remoteSession.stop?.();
+                }
+                await cloudBrowserClient.stop_browser(cloudBrowserSessionId);
+                cloudBrowserSessionId = null;
+                if (flags.json) {
+                    writeLine(output, JSON.stringify({
+                        success: true,
+                        profile_id: cloudProfileId,
+                        cookies_synced: filteredCookies.length,
+                    }, null, 2));
+                }
+                else {
+                    logProgress('Profile synced successfully!');
+                    logProgress(`  Cloud profile ID: ${cloudProfileId}`);
+                }
+                return 0;
+            }
+            catch (error) {
+                if (cloudBrowserSessionId) {
+                    try {
+                        await cloudBrowserClient.stop_browser(cloudBrowserSessionId);
+                    }
+                    catch {
+                        // Ignore cleanup failures.
+                    }
+                }
+                if (cloudProfileId) {
+                    try {
+                        await client.delete_profile(cloudProfileId);
+                    }
+                    catch {
+                        // Ignore cleanup failures.
+                    }
+                }
+                throw error;
+            }
+        }
+        if (subcommand === 'update') {
+            const profileId = requireCommandTarget(argv[1], 'Usage: browser-use profile update <profile-id> --remote --name <name>');
+            const flags = parseProfileCommandFlags(argv.slice(2));
+            rejectUnexpectedPositionals(flags.positionals, 'Usage: browser-use profile update <profile-id> --remote --name <name>');
+            rejectUnsupportedFlags(flags.used_options, ['--json', '--remote', '--name'], 'Usage: browser-use profile update <profile-id> --remote --name <name>');
+            if (!flags.remote) {
+                throw new Error('Profile update is only supported with --remote');
+            }
+            if (!flags.name) {
+                throw new Error('Usage: browser-use profile update <profile-id> --remote --name <name>');
+            }
+            const profile = await client.update_profile(profileId, {
+                name: flags.name,
+            });
+            if (flags.json) {
+                writeLine(output, JSON.stringify(profile, null, 2));
+            }
+            else {
+                writeLine(output, `Updated cloud profile: ${profile.id}`);
+            }
+            return 0;
+        }
+        writeLine(errorOutput, 'Usage: browser-use profile <list|get|create|update|delete|cookies|sync> [--remote] [options]');
+        return 1;
+    }
+    catch (error) {
+        writeLine(errorOutput, `Error: ${error.message}`);
+        return 1;
+    }
+};
+const CLOUD_RUN_FLAGS = new Set([
+    '--remote',
+    '--llm',
+    '--session-id',
+    '--proxy-country',
+    '--wait',
+    '--stream',
+    '--flash',
+    '--thinking',
+    '--vision',
+    '--no-vision',
+    '--start-url',
+    '--metadata',
+    '--secret',
+    '--allowed-domain',
+    '--skill-id',
+    '--structured-output',
+    '--judge',
+    '--judge-ground-truth',
+    '--max-steps',
+    '--profile',
+]);
+const CLOUD_RUN_VALUE_FLAGS = new Set([
+    '--llm',
+    '--session-id',
+    '--proxy-country',
+    '--start-url',
+    '--structured-output',
+    '--judge-ground-truth',
+    '--max-steps',
+    '--profile',
+    '--metadata',
+    '--secret',
+    '--allowed-domain',
+    '--skill-id',
+]);
+export const hasCloudRunFlags = (argv) => {
+    for (const arg of argv) {
+        if (arg === '--') {
+            break;
+        }
+        if (CLOUD_RUN_FLAGS.has(arg)) {
+            return true;
+        }
+        const separator = arg.indexOf('=');
+        if (separator > 0 && CLOUD_RUN_VALUE_FLAGS.has(arg.slice(0, separator))) {
+            return true;
+        }
+    }
+    return false;
+};
+const hasExplicitRemoteRunFlag = (argv) => {
+    for (const arg of argv) {
+        if (arg === '--') {
+            break;
+        }
+        if (arg === '--remote') {
+            return true;
+        }
+    }
+    return false;
+};
+const PREFIXED_SUBCOMMAND_VALUE_FLAGS = [
+    '--api-key',
+    '--provider',
+    '--model',
+    '--window-width',
+    '--window-height',
+    '--user-data-dir',
+    '--profile-directory',
+    '--allowed-domains',
+    '--proxy-url',
+    '--no-proxy',
+    '--proxy-username',
+    '--proxy-password',
+    '--cdp-url',
+];
+const matchesOptionWithValue = (arg, option) => arg === option || arg.startsWith(`${option}=`);
+export const extractPrefixedSubcommand = (argv) => {
+    const forwardedArgs = [];
+    let debug = false;
+    let index = 0;
+    while (index < argv.length) {
+        const arg = argv[index] ?? '';
+        if (arg === '--debug') {
+            debug = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--json') {
+            forwardedArgs.push(arg);
+            index += 1;
+            continue;
+        }
+        if (arg === '--headless') {
+            index += 1;
+            continue;
+        }
+        const valueOption = PREFIXED_SUBCOMMAND_VALUE_FLAGS.find((option) => matchesOptionWithValue(arg, option));
+        if (valueOption) {
+            if (arg === valueOption) {
+                if (index + 1 >= argv.length) {
+                    break;
+                }
+                index += 2;
+            }
+            else {
+                index += 1;
+            }
+            continue;
+        }
+        break;
+    }
+    const command = argv[index];
+    if (command !== 'run' &&
+        command !== 'task' &&
+        command !== 'session' &&
+        command !== 'profile') {
+        return null;
+    }
+    return {
+        command,
+        argv: argv.slice(index + 1),
+        debug,
+        forwardedArgs,
+    };
+};
+const parseKeyValuePairs = (values, option) => {
+    const result = {};
+    values.forEach((value) => {
+        const separator = value.indexOf('=');
+        if (separator <= 0) {
+            throw new Error(`Invalid value for ${option}: expected KEY=VALUE`);
+        }
+        const key = value.slice(0, separator).trim();
+        if (!key) {
+            throw new Error(`Invalid value for ${option}: expected KEY=VALUE`);
+        }
+        result[key] = value.slice(separator + 1);
+    });
+    return Object.keys(result).length > 0 ? result : null;
+};
+const parseCloudRunArgs = (argv) => {
+    const flags = {
+        remote: false,
+        wait: false,
+        stream: false,
+        flash: false,
+        thinking: false,
+        vision: null,
+        llm: null,
+        session_id: null,
+        proxy_country: null,
+        start_url: null,
+        structured_output: null,
+        judge: false,
+        judge_ground_truth: null,
+        max_steps: null,
+        profile: null,
+        metadata: [],
+        secret: [],
+        allowed_domain: [],
+        skill_id: [],
+        task_parts: [],
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const rawArg = argv[index] ?? '';
+        if (rawArg === '--') {
+            flags.task_parts.push(...argv.slice(index + 1));
+            break;
+        }
+        const separator = rawArg.indexOf('=');
+        const hasInlineValue = separator > 0;
+        const arg = hasInlineValue ? rawArg.slice(0, separator) : rawArg;
+        const inlineValue = hasInlineValue
+            ? rawArg.slice(separator + 1).trim()
+            : '';
+        if (arg === '--remote') {
+            flags.remote = true;
+            continue;
+        }
+        if (arg === '--wait') {
+            flags.wait = true;
+            continue;
+        }
+        if (arg === '--stream') {
+            flags.stream = true;
+            continue;
+        }
+        if (arg === '--flash') {
+            flags.flash = true;
+            continue;
+        }
+        if (arg === '--thinking') {
+            flags.thinking = true;
+            continue;
+        }
+        if (arg === '--vision') {
+            flags.vision = true;
+            continue;
+        }
+        if (arg === '--no-vision') {
+            flags.vision = false;
+            continue;
+        }
+        if (arg === '--judge') {
+            flags.judge = true;
+            continue;
+        }
+        if (arg === '--llm' ||
+            arg === '--session-id' ||
+            arg === '--proxy-country' ||
+            arg === '--start-url' ||
+            arg === '--structured-output' ||
+            arg === '--judge-ground-truth' ||
+            arg === '--max-steps' ||
+            arg === '--profile' ||
+            arg === '--metadata' ||
+            arg === '--secret' ||
+            arg === '--allowed-domain' ||
+            arg === '--skill-id') {
+            const { value: next, nextIndex } = takeOptionValue(rawArg, index, argv);
+            if (arg === '--llm') {
+                flags.llm = next;
+            }
+            else if (arg === '--session-id') {
+                flags.session_id = next;
+            }
+            else if (arg === '--proxy-country') {
+                flags.proxy_country = next;
+            }
+            else if (arg === '--start-url') {
+                flags.start_url = next;
+            }
+            else if (arg === '--structured-output') {
+                flags.structured_output = next;
+            }
+            else if (arg === '--judge-ground-truth') {
+                flags.judge_ground_truth = next;
+            }
+            else if (arg === '--max-steps') {
+                flags.max_steps = parsePositiveInt('--max-steps', next);
+            }
+            else if (arg === '--profile') {
+                flags.profile = next;
+            }
+            else if (arg === '--metadata') {
+                flags.metadata.push(next);
+            }
+            else if (arg === '--secret') {
+                flags.secret.push(next);
+            }
+            else if (arg === '--allowed-domain') {
+                flags.allowed_domain.push(next);
+            }
+            else {
+                flags.skill_id.push(next);
+            }
+            index = nextIndex;
+            continue;
+        }
+        if (rawArg.startsWith('-')) {
+            throw new Error(`Unknown option: ${rawArg}`);
+        }
+        flags.task_parts.push(rawArg);
+    }
+    return flags;
+};
+export const runCloudTaskCommand = async (argv, options = {}) => {
+    const client = options.client ?? new CloudManagementClient();
+    const output = options.stdout ?? process.stdout;
+    const errorOutput = options.stderr ?? process.stderr;
+    const sleepImpl = options.sleep_impl ??
+        ((ms) => new Promise((r) => setTimeout(r, ms)));
+    let autoCreatedSessionId = null;
+    let taskCreated = false;
+    try {
+        const flags = parseCloudRunArgs(argv);
+        if (!flags.remote) {
+            throw new Error('Usage: browser-use run --remote <task>');
+        }
+        const task = flags.task_parts.join(' ').trim();
+        if (!task) {
+            throw new Error('Usage: browser-use run --remote <task>');
+        }
+        let sessionId = flags.session_id;
+        if (!sessionId && (flags.profile || flags.proxy_country)) {
+            const session = await client.create_session({
+                profileId: flags.profile,
+                proxyCountryCode: flags.proxy_country,
+                startUrl: flags.start_url,
+            });
+            sessionId = session.id;
+            autoCreatedSessionId = session.id;
+            writeLine(output, `Created cloud session: ${sessionId}`);
+        }
+        const created = await client.create_task({
+            task,
+            llm: flags.llm,
+            sessionId,
+            startUrl: flags.start_url,
+            maxSteps: flags.max_steps,
+            structuredOutput: flags.structured_output,
+            metadata: parseKeyValuePairs(flags.metadata, '--metadata'),
+            secrets: parseKeyValuePairs(flags.secret, '--secret'),
+            allowedDomains: flags.allowed_domain.length > 0 ? flags.allowed_domain : null,
+            flashMode: flags.flash,
+            thinking: flags.thinking,
+            vision: flags.vision,
+            judge: flags.judge,
+            judgeGroundTruth: flags.judge_ground_truth,
+            skillIds: flags.skill_id.length > 0 ? flags.skill_id : null,
+        });
+        taskCreated = true;
+        if (!flags.wait) {
+            writeLine(output, `Task started: ${created.id} (session: ${created.sessionId})`);
+            writeLine(output, `Use "browser-use task status ${created.id}" to check progress.`);
+            return 0;
+        }
+        let lastStatus = null;
+        while (true) {
+            const taskView = await client.get_task(created.id);
+            if (flags.stream && taskView.status !== lastStatus) {
+                writeLine(output, `Status: ${taskView.status}`);
+                lastStatus = taskView.status;
+            }
+            if (taskView.status === 'finished' ||
+                taskView.status === 'stopped' ||
+                taskView.status === 'failed') {
+                writeLine(output, `Task ${taskView.status}: ${taskView.id}`);
+                if (taskView.output) {
+                    writeLine(output, taskView.output);
+                }
+                return taskView.status === 'finished' ? 0 : 1;
+            }
+            await sleepImpl(1000);
+        }
+    }
+    catch (error) {
+        if (autoCreatedSessionId && !taskCreated) {
+            try {
+                await client.update_session(autoCreatedSessionId, 'stop');
+            }
+            catch {
+                // Ignore cleanup failures.
+            }
+        }
+        writeLine(errorOutput, `Error: ${error.message}`);
+        return 1;
+    }
+};
+const enableDebugLogging = () => {
+    process.env.BROWSER_USE_LOGGING_LEVEL = 'debug';
+    setupLogging({ logLevel: 'debug', forceSetup: true });
+};
+const summarizeDoctorChecks = (checks) => {
+    const values = Object.values(checks);
+    const total = values.length;
+    const ok = values.filter((check) => check.status === 'ok').length;
+    const warning = values.filter((check) => check.status === 'warning').length;
+    const missing = values.filter((check) => check.status === 'missing').length;
+    const error = values.filter((check) => check.status === 'error').length;
+    const parts = [`${ok}/${total} checks passed`];
+    if (warning > 0) {
+        parts.push(`${warning} warnings`);
+    }
+    if (missing > 0) {
+        parts.push(`${missing} missing`);
+    }
+    if (error > 0) {
+        parts.push(`${error} errors`);
+    }
+    return parts.join(', ');
+};
+const findSystemBinary = (binary) => {
+    const command = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(command, [binary], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    if (result.status !== 0) {
+        return null;
+    }
+    const firstLine = result.stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find(Boolean);
+    return firstLine ?? null;
+};
+export const runDoctorChecks = async (options = {}) => {
+    const fetchImpl = options.fetch_impl ?? fetch;
+    const configuredApiKey = options.api_key !== undefined
+        ? options.api_key?.trim() || null
+        : process.env.BROWSER_USE_API_KEY?.trim() ||
+            new DeviceAuthClient().api_token?.trim() ||
+            null;
+    const apiKeySource = options.api_key !== undefined
+        ? 'argument'
+        : process.env.BROWSER_USE_API_KEY?.trim()
+            ? 'environment'
+            : new DeviceAuthClient().api_token?.trim()
+                ? 'cloud_auth'
+                : null;
+    const tunnelStatus = options.cloudflared_path !== undefined
+        ? options.cloudflared_path
+            ? {
+                available: true,
+                source: 'system',
+                path: options.cloudflared_path,
+                note: 'cloudflared installed',
+            }
+            : {
+                available: false,
+                source: null,
+                path: null,
+                note: 'cloudflared not installed - install it manually before using tunnel',
+            }
+        : get_tunnel_manager().get_status();
+    const checks = {
+        package: {
+            status: 'ok',
+            message: `browser-use ${options.version ?? get_browser_use_version()}`,
+        },
+        browser: (() => {
+            const executable = options.browser_executable !== undefined
+                ? options.browser_executable
+                : systemChrome.findExecutable();
+            if (executable) {
+                return {
+                    status: 'ok',
+                    message: `Chrome detected at ${executable}`,
+                };
+            }
+            return {
+                status: 'warning',
+                message: 'Chrome executable not detected',
+                note: 'Local browser launch may fail until Chrome or Chromium is installed.',
+            };
+        })(),
+        api_key: (() => {
+            if (configuredApiKey) {
+                return {
+                    status: 'ok',
+                    message: apiKeySource === 'cloud_auth'
+                        ? 'Browser Use API key is configured in cloud auth'
+                        : 'BROWSER_USE_API_KEY is configured',
+                };
+            }
+            return {
+                status: 'missing',
+                message: 'BROWSER_USE_API_KEY is not configured',
+                note: 'Required for browser-use cloud browser features.',
+            };
+        })(),
+        cloudflared: (() => {
+            if (tunnelStatus.available && tunnelStatus.path) {
+                return {
+                    status: 'ok',
+                    message: `cloudflared detected at ${tunnelStatus.path}`,
+                };
+            }
+            return {
+                status: 'missing',
+                message: 'cloudflared not found',
+                note: tunnelStatus.note ||
+                    'Tunnel features remain unavailable until cloudflared is installed.',
+            };
+        })(),
+        network: {
+            status: 'warning',
+            message: 'Network connectivity check inconclusive',
+            note: 'Some remote features may not work offline.',
+        },
+    };
+    try {
+        const response = await fetchImpl('https://api.github.com', {
+            method: 'HEAD',
+        });
+        if (response.ok || response.status < 500) {
+            checks.network = {
+                status: 'ok',
+                message: 'Network connectivity OK',
+            };
+        }
+    }
+    catch {
+        checks.network = {
+            status: 'warning',
+            message: 'Network connectivity check inconclusive',
+            note: 'Some remote features may not work offline.',
+        };
+    }
+    const allOk = Object.values(checks).every((check) => check.status === 'ok');
+    return {
+        status: allOk ? 'healthy' : 'issues_found',
+        checks,
+        summary: summarizeDoctorChecks(checks),
+    };
+};
+const printDoctorReport = (report) => {
+    console.log(`status: ${report.status}`);
+    console.log(`summary: ${report.summary}`);
+    for (const [name, check] of Object.entries(report.checks)) {
+        console.log(`${name}: ${check.status} - ${check.message}`);
+        if (check.note) {
+            console.log(`  note: ${check.note}`);
+        }
+        if (check.fix) {
+            console.log(`  fix: ${check.fix}`);
+        }
+    }
+};
 async function runMcpServer() {
     const server = new MCPServer('browser-use', get_browser_use_version());
     await server.start();
@@ -777,6 +2513,50 @@ async function runMcpServer() {
     await new Promise(() => { });
 }
 export async function main(argv = process.argv.slice(2)) {
+    const prefixedSubcommand = extractPrefixedSubcommand(argv);
+    if (prefixedSubcommand) {
+        if (prefixedSubcommand.debug) {
+            enableDebugLogging();
+        }
+        if (prefixedSubcommand.command === 'run') {
+            if (!hasCloudRunFlags(prefixedSubcommand.argv) ||
+                !hasExplicitRemoteRunFlag(prefixedSubcommand.argv)) {
+                await main([
+                    ...prefixedSubcommand.forwardedArgs,
+                    ...prefixedSubcommand.argv,
+                ]);
+                return;
+            }
+            const exitCode = await runCloudTaskCommand(prefixedSubcommand.argv);
+            if (exitCode !== 0) {
+                process.exit(exitCode);
+            }
+            return;
+        }
+        const subcommandArgv = [
+            ...prefixedSubcommand.argv,
+            ...prefixedSubcommand.forwardedArgs,
+        ];
+        if (prefixedSubcommand.command === 'task') {
+            const exitCode = await runTaskCommand(subcommandArgv);
+            if (exitCode !== 0) {
+                process.exit(exitCode);
+            }
+            return;
+        }
+        if (prefixedSubcommand.command === 'session') {
+            const exitCode = await runSessionCommand(subcommandArgv);
+            if (exitCode !== 0) {
+                process.exit(exitCode);
+            }
+            return;
+        }
+        const exitCode = await runProfileCommand(subcommandArgv);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
+        return;
+    }
     let args;
     try {
         args = parseCliArgs(argv);
@@ -796,13 +2576,45 @@ export async function main(argv = process.argv.slice(2)) {
         return;
     }
     if (args.debug) {
-        process.env.BROWSER_USE_LOGGING_LEVEL = 'debug';
-        setupLogging({ logLevel: 'debug', forceSetup: true });
+        enableDebugLogging();
     }
     if (args.mcp) {
         await runMcpServer();
         return;
     }
+    if (args.prompt == null && args.positional[0] === 'doctor') {
+        const report = await runDoctorChecks();
+        printDoctorReport(report);
+        return;
+    }
+    if (args.prompt == null && args.positional[0] === 'install') {
+        console.log('Installing Chromium browser...');
+        runInstallCommand();
+        console.log('Chromium browser installed.');
+        return;
+    }
+    if (args.prompt == null && args.positional[0] === 'setup') {
+        const exitCode = await runSetupCommand({
+            mode: args.setup_mode,
+            yes: args.yes,
+            api_key: args.api_key,
+        }, {
+            json_output: args.json,
+        });
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
+        return;
+    }
+    if (args.prompt == null && args.positional[0] === 'tunnel') {
+        const exitCode = await runTunnelCommand(args.positional.slice(1), {
+            json_output: args.json,
+        });
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
+        return;
+    }
     const task = resolveTask(args);
     const shouldStartInteractive = shouldStartInteractiveMode(task);
     if (!task && !shouldStartInteractive) {