@_nazmiforreal/agent-browser-mcp 0.2.0

package/dist/tools/browser.js

@@ -0,0 +1,885 @@
+import { z } from "zod";
+import { execBrowser } from "./executor.js";
+import { listBrowsers, installBrowser } from "../browsers/installer.js";
+import { discoverBrowsers, discoverActiveBrowser, selectBrowser } from "../browsers/discover.js";
+export function registerBrowserTools(server) {
+    // ============================================================
+    // Navigation (5 tools)
+    // ============================================================
+    server.tool("browser_navigate", "Navigate to a URL (or launch browser if no URL)", {
+        url: z.string().url().describe("The URL to navigate to"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ url, sessionId }) => {
+        const result = await execBrowser("navigate", { url }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_go_back", "Go back in browser history", { sessionId: z.string().optional().describe("Browser session ID") }, async ({ sessionId }) => {
+        const result = await execBrowser("go_back", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_go_forward", "Go forward in browser history", { sessionId: z.string().optional().describe("Browser session ID") }, async ({ sessionId }) => {
+        const result = await execBrowser("go_forward", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_reload", "Reload the current page", { sessionId: z.string().optional().describe("Browser session ID") }, async ({ sessionId }) => {
+        const result = await execBrowser("reload", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_pushstate", "SPA client-side navigation via history.pushState", {
+        url: z.string().describe("URL to push onto the history stack"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ url, sessionId }) => {
+        const result = await execBrowser("pushstate", { url }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Core Interaction (13 tools)
+    // ============================================================
+    server.tool("browser_click", "Click an element by CSS selector", {
+        selector: z.string().describe("CSS selector of element to click"),
+        newTab: z.boolean().optional().describe("Open link in new tab"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, newTab, sessionId }) => {
+        const result = await execBrowser("click", { selector, newTab }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_dblclick", "Double-click an element", {
+        selector: z.string().describe("CSS selector of element to double-click"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("dblclick", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_fill", "Clear and fill an input field", {
+        selector: z.string().describe("CSS selector of the input element"),
+        value: z.string().describe("Text value to fill in"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, value, sessionId }) => {
+        const result = await execBrowser("fill", { selector, value }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_type", "Type text into an element (does not clear first)", {
+        selector: z.string().describe("CSS selector of the input element"),
+        text: z.string().describe("Text to type"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, text, sessionId }) => {
+        const result = await execBrowser("type", { selector, text }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_hover", "Hover over an element", {
+        selector: z.string().describe("CSS selector of element to hover"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("hover", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_focus", "Focus an element", {
+        selector: z.string().describe("CSS selector of element to focus"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("focus", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_check", "Check a checkbox or radio element", {
+        selector: z.string().describe("CSS selector of the checkbox/radio element"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("check", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_uncheck", "Uncheck a checkbox element", {
+        selector: z.string().describe("CSS selector of the checkbox element"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("uncheck", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_select", "Select option(s) from a dropdown", {
+        selector: z.string().describe("CSS selector of the select element"),
+        values: z.union([z.string(), z.array(z.string())]).describe("Value(s) to select"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, values, sessionId }) => {
+        const result = await execBrowser("select", { selector, values }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_drag", "Drag and drop from source to target", {
+        source: z.string().describe("CSS selector of the source element"),
+        target: z.string().describe("CSS selector of the target element"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ source, target, sessionId }) => {
+        const result = await execBrowser("drag", { source, target }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_upload", "Upload file(s) via a file input element", {
+        selector: z.string().describe("CSS selector of the file input element"),
+        files: z.array(z.string()).describe("File path(s) to upload"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, files, sessionId }) => {
+        const result = await execBrowser("upload", { selector, files }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_download", "Download a file by clicking a download link/button", {
+        selector: z.string().describe("CSS selector of the element that triggers download"),
+        path: z.string().describe("File path to save the download to"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, path, sessionId }) => {
+        const result = await execBrowser("download", { selector, path }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Keyboard (1 tool)
+    // ============================================================
+    server.tool("browser_keyboard", "Keyboard actions: press key, key down/up, type text, insert text", {
+        action: z.enum(["press", "keydown", "keyup", "type", "inserttext"])
+            .describe("Keyboard action to perform"),
+        key: z.string().optional().describe("Key name (for press/keydown/keyup, e.g. 'Enter', 'Tab', 'Control+a')"),
+        text: z.string().optional().describe("Text to type or insert (for type/inserttext)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, key, text, sessionId }) => {
+        let command;
+        let options;
+        if (action === "press" || action === "keydown" || action === "keyup") {
+            command = action;
+            options = { key };
+        }
+        else if (action === "type") {
+            command = "keyboard_type";
+            options = { text };
+        }
+        else {
+            command = "keyboard_inserttext";
+            options = { text };
+        }
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Mouse (1 tool)
+    // ============================================================
+    server.tool("browser_mouse", "Mouse actions: move, down, up, wheel", {
+        action: z.enum(["move", "down", "up", "wheel"]).describe("Mouse action to perform"),
+        x: z.number().optional().describe("X coordinate (for move)"),
+        y: z.number().optional().describe("Y coordinate (for move)"),
+        button: z.enum(["left", "right", "middle"]).optional().describe("Mouse button (for down/up)"),
+        deltaY: z.number().optional().describe("Vertical scroll amount (for wheel)"),
+        deltaX: z.number().optional().describe("Horizontal scroll amount (for wheel, defaults to 0)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, x, y, button, deltaY, deltaX, sessionId }) => {
+        const command = `mouse_${action}`;
+        const result = await execBrowser(command, { x, y, button, deltaY, deltaX }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Scroll (2 tools)
+    // ============================================================
+    server.tool("browser_scroll", "Scroll the page in a direction", {
+        direction: z.enum(["up", "down", "left", "right"]).describe("Scroll direction"),
+        amount: z.number().optional().describe("Scroll amount in pixels"),
+        selector: z.string().optional().describe("CSS selector to scroll within"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ direction, amount, selector, sessionId }) => {
+        const result = await execBrowser("scroll", { direction, amount, selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_scroll_into_view", "Scroll an element into view", {
+        selector: z.string().describe("CSS selector of the element to scroll into view"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("scroll_into_view", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Get Info (1 tool)
+    // ============================================================
+    const GET_COMMANDS = {
+        text: "get_text",
+        html: "get_html",
+        value: "get_value",
+        attr: "get_attribute",
+        url: "get_url",
+        title: "get_title",
+        "cdp-url": "get_cdp_url",
+        count: "get_count",
+        box: "get_bounding_box",
+        styles: "get_styles",
+    };
+    server.tool("browser_get", "Get page information (text, HTML, attribute, URL, title, etc.)", {
+        property: z.enum(["text", "html", "value", "attr", "url", "title", "cdp-url", "count", "box", "styles"])
+            .describe("What information to retrieve"),
+        selector: z.string().optional().describe("CSS selector (required for text/html/value/attr/count/box/styles)"),
+        attribute: z.string().optional().describe("Attribute name (only for property='attr')"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ property, selector, attribute, sessionId }) => {
+        const command = GET_COMMANDS[property];
+        const result = await execBrowser(command, { selector, attribute }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // State Checks (1 tool)
+    // ============================================================
+    server.tool("browser_is", "Check element state: visible, enabled, checked", {
+        state: z.enum(["visible", "enabled", "checked"]).describe("State to check"),
+        selector: z.string().describe("CSS selector of the element"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ state, selector, sessionId }) => {
+        const command = `is_${state}`;
+        const result = await execBrowser(command, { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Find / Locators (1 tool)
+    // ============================================================
+    server.tool("browser_find", "Find and optionally interact with elements by various locator strategies", {
+        by: z.enum(["role", "text", "label", "placeholder", "alt", "title", "testid", "first", "last", "nth"])
+            .describe("Locator strategy"),
+        value: z.string().describe("The value to search for (for 'nth', this is the CSS selector)"),
+        subaction: z.string().optional().describe("Action to perform on the located element (default: click)"),
+        name: z.string().optional().describe("Accessible name filter (for by='role')"),
+        exact: z.boolean().optional().describe("Exact match"),
+        index: z.number().optional().describe("Index (only for by='nth')"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ by, value, subaction, name, exact, index, sessionId }) => {
+        const command = by === "nth" ? "find_nth" : `find_${by}`;
+        const options = by === "nth"
+            ? { index, selector: value, subaction }
+            : { value, subaction, name, exact };
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Wait (1 tool)
+    // ============================================================
+    server.tool("browser_wait", "Wait for various conditions: selector visibility, URL, load state, JS function, text, download, or timeout", {
+        mode: z.enum(["selector", "timeout", "url", "load-state", "function", "text", "download"])
+            .describe("What to wait for"),
+        target: z.string().optional().describe("CSS selector or timeout in ms (for selector/timeout mode)"),
+        value: z.string().optional().describe("URL pattern (url mode), load state (load-state mode), JS expression (function mode), or text (text mode)"),
+        path: z.string().optional().describe("File path (download mode)"),
+        timeout: z.number().optional().describe("Maximum time to wait in milliseconds"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ mode, target, value, path, timeout, sessionId }) => {
+        let command;
+        let options;
+        switch (mode) {
+            case "selector":
+                command = "wait_for_selector";
+                options = { selector: target, timeout };
+                break;
+            case "timeout":
+                command = "wait";
+                options = { target: String(target || timeout), timeout };
+                break;
+            case "url":
+                command = "wait_for_url";
+                options = { url: value, timeout };
+                break;
+            case "load-state":
+                command = "wait_for_load_state";
+                options = { state: value, timeout };
+                break;
+            case "function":
+                command = "wait_for_function";
+                options = { expression: value, timeout };
+                break;
+            case "text":
+                command = "wait_for_text";
+                options = { text: value, timeout };
+                break;
+            case "download":
+                command = "wait_for_download";
+                options = { path, timeout };
+                break;
+            default:
+                command = "wait";
+                options = { target };
+        }
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Screenshot / PDF (2 tools)
+    // ============================================================
+    server.tool("browser_screenshot", "Take a screenshot of the page", {
+        path: z.string().optional().describe("File path to save the screenshot"),
+        fullPage: z.boolean().optional().describe("Capture full scrollable page"),
+        selector: z.string().optional().describe("CSS selector to capture specific element"),
+        annotate: z.boolean().optional().describe("Annotate screenshot with element labels"),
+        format: z.enum(["png", "jpeg"]).optional().describe("Image format"),
+        quality: z.number().min(0).max(100).optional().describe("Image quality (0-100)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ path, fullPage, selector, annotate, format, quality, sessionId }) => {
+        const result = await execBrowser("screenshot", { path, fullPage, selector, annotate, format, quality }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_pdf", "Save the page as a PDF", {
+        path: z.string().describe("File path to save the PDF"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ path, sessionId }) => {
+        const result = await execBrowser("pdf", { path }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Snapshot (1 tool)
+    // ============================================================
+    server.tool("browser_snapshot", "Get the accessibility tree snapshot with element references (for AI)", {
+        interactive: z.boolean().optional().describe("Only show interactive elements"),
+        compact: z.boolean().optional().describe("Remove empty structural elements"),
+        cursor: z.boolean().optional().describe("Show cursor position indicator"),
+        urls: z.boolean().optional().describe("Show URLs of links"),
+        depth: z.number().optional().describe("Limit tree depth"),
+        selector: z.string().optional().describe("Scope snapshot to a CSS selector"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ interactive, compact, cursor, urls, depth, selector, sessionId }) => {
+        const result = await execBrowser("snapshot", { interactive, compact, cursor, urls, depth, selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Eval (2 tools)
+    // ============================================================
+    server.tool("browser_evaluate", "Execute JavaScript code in the browser context", {
+        script: z.string().describe("JavaScript code to execute"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ script, sessionId }) => {
+        const result = await execBrowser("evaluate", { script }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_evaluate_base64", "Execute base64-encoded JavaScript in the browser context", {
+        script: z.string().describe("Base64-encoded JavaScript code to execute"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ script, sessionId }) => {
+        const result = await execBrowser("evaluate_base64", { script }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Batch (1 tool)
+    // ============================================================
+    server.tool("browser_batch", "Execute multiple agent-browser commands sequentially", {
+        commands: z.array(z.string()).describe("Array of commands to execute"),
+        bail: z.boolean().optional().describe("Stop execution on first error"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ commands, bail, sessionId }) => {
+        const result = await execBrowser("batch", { commands, bail }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Clipboard (1 tool)
+    // ============================================================
+    server.tool("browser_clipboard", "Clipboard operations: read, write, copy, paste", {
+        action: z.enum(["read", "write", "copy", "paste"]).describe("Clipboard action"),
+        text: z.string().optional().describe("Text to write (for write action)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, text, sessionId }) => {
+        const command = `clipboard_${action}`;
+        const result = await execBrowser(command, { text }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Settings (1 tool)
+    // ============================================================
+    server.tool("browser_settings", "Browser settings: viewport, device emulation, geolocation, offline, headers, credentials, media", {
+        setting: z.enum(["viewport", "device", "geo", "offline", "headers", "credentials", "media"])
+            .describe("Setting to change"),
+        width: z.number().optional().describe("Viewport width (for viewport)"),
+        height: z.number().optional().describe("Viewport height (for viewport)"),
+        scale: z.number().optional().describe("Device scale factor (for viewport)"),
+        device: z.string().optional().describe("Device name (for device)"),
+        latitude: z.number().optional().describe("Latitude (for geo)"),
+        longitude: z.number().optional().describe("Longitude (for geo)"),
+        offline: z.boolean().optional().describe("Enable/disable offline mode (for offline)"),
+        headers: z.string().optional().describe("Headers as JSON string (for headers)"),
+        username: z.string().optional().describe("Username (for credentials)"),
+        password: z.string().optional().describe("Password (for credentials)"),
+        colorScheme: z.enum(["dark", "light", "no-preference"]).optional().describe("Color scheme (for media)"),
+        reducedMotion: z.boolean().optional().describe("Reduced motion (for media)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ setting, width, height, scale, device, latitude, longitude, offline, headers, username, password, colorScheme, reducedMotion, sessionId }) => {
+        const command = `set_${setting === "geo" ? "geolocation" : setting}`;
+        const result = await execBrowser(command, { width, height, scale, device, latitude, longitude, offline, headers, username, password, colorScheme, reducedMotion }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Cookies (1 tool)
+    // ============================================================
+    server.tool("browser_cookies", "Cookie operations: get, set individual cookie, set from file, clear all", {
+        action: z.enum(["get", "set", "set-file", "clear"]).describe("Cookie action"),
+        name: z.string().optional().describe("Cookie name (for set)"),
+        value: z.string().optional().describe("Cookie value (for set)"),
+        url: z.string().optional().describe("Cookie URL (for set/set-file)"),
+        domain: z.string().optional().describe("Cookie domain (for set/set-file)"),
+        path: z.string().optional().describe("Cookie path (for set)"),
+        httpOnly: z.boolean().optional().describe("HTTP-only flag (for set)"),
+        secure: z.boolean().optional().describe("Secure flag (for set)"),
+        sameSite: z.enum(["Strict", "Lax", "None"]).optional().describe("SameSite attribute (for set)"),
+        expires: z.number().optional().describe("Expiration timestamp in seconds (for set)"),
+        file: z.string().optional().describe("Path to cookie file (for set-file)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, name, value, url, domain, path, httpOnly, secure, sameSite, expires, file, sessionId }) => {
+        let command;
+        let options;
+        switch (action) {
+            case "get":
+                command = "get_cookies";
+                options = {};
+                break;
+            case "set":
+                command = "set_cookie";
+                options = { name, value, url, domain, path, httpOnly, secure, sameSite, expires };
+                break;
+            case "set-file":
+                command = "set_cookies_from_file";
+                options = { file, domain, url };
+                break;
+            case "clear":
+                command = "clear_cookies";
+                options = {};
+                break;
+            default:
+                command = "get_cookies";
+                options = {};
+        }
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Storage (1 tool)
+    // ============================================================
+    server.tool("browser_storage", "Web storage operations: local/session storage get, set, clear", {
+        area: z.enum(["local", "session"]).describe("Storage area"),
+        action: z.enum(["get", "set", "clear"]).describe("Storage action"),
+        key: z.string().optional().describe("Storage key (for get/set)"),
+        value: z.string().optional().describe("Storage value (for set)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ area, action, key, value, sessionId }) => {
+        const command = `storage_${action}_${area}`;
+        const options = action === "get" ? { key } : action === "set" ? { key, value } : {};
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Network (1 tool)
+    // ============================================================
+    server.tool("browser_network", "Network operations: route, unroute, list requests, request details, HAR recording", {
+        action: z.enum(["route", "unroute", "requests", "request-detail", "har-start", "har-stop"])
+            .describe("Network action"),
+        url: z.string().optional().describe("URL pattern (for route/unroute)"),
+        abort: z.boolean().optional().describe("Abort the request (for route)"),
+        body: z.string().optional().describe("Response body to return (for route)"),
+        resourceType: z.string().optional().describe("Filter by resource type (for route)"),
+        clear: z.boolean().optional().describe("Clear log after reading (for requests)"),
+        filter: z.string().optional().describe("Filter by URL pattern (for requests)"),
+        type: z.string().optional().describe("Filter by resource type (for requests)"),
+        method: z.string().optional().describe("Filter by HTTP method (for requests)"),
+        status: z.string().optional().describe("Filter by HTTP status (for requests)"),
+        requestId: z.string().optional().describe("Request ID to inspect (for request-detail)"),
+        path: z.string().optional().describe("File path to save HAR (for har-stop)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, url, abort, body, resourceType, clear, filter, type, method, status, requestId, path, sessionId }) => {
+        let command;
+        let options;
+        switch (action) {
+            case "route":
+                command = "network_route";
+                options = { url, abort, body, resourceType };
+                break;
+            case "unroute":
+                command = "network_unroute";
+                options = { url };
+                break;
+            case "requests":
+                command = "network_requests";
+                options = { clear, filter, type, method, status };
+                break;
+            case "request-detail":
+                command = "network_request_detail";
+                options = { requestId };
+                break;
+            case "har-start":
+                command = "network_har_start";
+                options = {};
+                break;
+            case "har-stop":
+                command = "network_har_stop";
+                options = { path };
+                break;
+            default:
+                command = "network_requests";
+                options = {};
+        }
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Tabs (1 tool)
+    // ============================================================
+    server.tool("browser_tab", "Tab and window operations: list, new, close, switch, new window", {
+        action: z.enum(["list", "new", "close", "switch", "new-window"]).describe("Tab action"),
+        tabId: z.string().optional().describe("Tab ID (for close/switch)"),
+        url: z.string().optional().describe("URL to open (for new)"),
+        label: z.string().optional().describe("Tab label (for new)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, tabId, url, label, sessionId }) => {
+        let command;
+        let options;
+        switch (action) {
+            case "list":
+                command = "tab_list";
+                options = {};
+                break;
+            case "new":
+                command = "tab_new";
+                options = { url, label };
+                break;
+            case "close":
+                command = "tab_close";
+                options = { tabId };
+                break;
+            case "switch":
+                command = "tab_switch";
+                options = { tabId };
+                break;
+            case "new-window":
+                command = "window_new";
+                options = {};
+                break;
+            default:
+                command = "tab_list";
+                options = {};
+        }
+        const result = await execBrowser(command, options, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Frames (1 tool)
+    // ============================================================
+    server.tool("browser_frame", "Frame operations: switch to an iframe by selector, or switch to main frame", {
+        action: z.enum(["switch", "main"]).describe("Frame action"),
+        selector: z.string().optional().describe("CSS selector of the iframe (for switch)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, selector, sessionId }) => {
+        const command = action === "main" ? "frame_main" : "frame_switch";
+        const result = await execBrowser(command, { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Dialogs (1 tool)
+    // ============================================================
+    server.tool("browser_dialog", "Dialog operations: accept, dismiss, or check status of browser dialogs (alert/confirm/prompt)", {
+        action: z.enum(["accept", "dismiss", "status"]).describe("Dialog action"),
+        promptText: z.string().optional().describe("Text to enter for prompt dialogs (for accept/dismiss)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, promptText, sessionId }) => {
+        const command = `dialog_${action}`;
+        const result = await execBrowser(command, { promptText }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Debug (5 tools)
+    // ============================================================
+    server.tool("browser_trace", "Tracing operations: start/stop Chrome DevTools trace recording", {
+        action: z.enum(["start", "stop"]).describe("Trace action"),
+        path: z.string().optional().describe("File path to save the trace (for stop)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, path, sessionId }) => {
+        const command = `trace_${action}`;
+        const result = await execBrowser(command, { path }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_profiler", "Profiler operations: start/stop Chrome DevTools profiler recording", {
+        action: z.enum(["start", "stop"]).describe("Profiler action"),
+        categories: z.string().optional().describe("Comma-separated profiling categories (for start)"),
+        path: z.string().optional().describe("File path to save the profile (for stop)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, categories, path, sessionId }) => {
+        const command = `profiler_${action}`;
+        const result = await execBrowser(command, { categories, path }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_console", "View page console logs", {
+        clear: z.boolean().optional().describe("Clear console log after reading"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ clear, sessionId }) => {
+        const result = await execBrowser("get_console", { clear }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_errors", "View page JavaScript errors", {
+        clear: z.boolean().optional().describe("Clear error log after reading"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ clear, sessionId }) => {
+        const result = await execBrowser("get_errors", { clear }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_highlight", "Highlight an element on the page", {
+        selector: z.string().describe("CSS selector of the element to highlight"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("highlight", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_inspect", "Open Chrome DevTools for the active page", { sessionId: z.string().optional().describe("Browser session ID") }, async ({ sessionId }) => {
+        const result = await execBrowser("inspect", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // State Management (1 tool)
+    // ============================================================
+    server.tool("browser_state", "State management: save, load, list, show, rename, clear, clean browser states", {
+        action: z.enum(["save", "load", "list", "show", "rename", "clear", "clean"])
+            .describe("State action"),
+        path: z.string().optional().describe("State name or path (for save/load/show)"),
+        oldName: z.string().optional().describe("Current state name (for rename)"),
+        newName: z.string().optional().describe("New state name (for rename)"),
+        sessionName: z.string().optional().describe("Session name to clear (for clear)"),
+        all: z.boolean().optional().describe("Clear all states (for clear)"),
+        days: z.number().optional().describe("Remove states older than N days (for clean)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, path, oldName, newName, sessionName, all, days, sessionId }) => {
+        const command = `state_${action}`;
+        const result = await execBrowser(command, { path, oldName, newName, sessionName, all, days }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Recording (1 tool)
+    // ============================================================
+    server.tool("browser_record", "Video recording operations: start, stop, restart screen recording", {
+        action: z.enum(["start", "stop", "restart"]).describe("Recording action"),
+        path: z.string().optional().describe("Output WebM file path (for start/restart)"),
+        url: z.string().optional().describe("URL to navigate to (for start/restart)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, path, url, sessionId }) => {
+        const command = `record_${action}`;
+        const result = await execBrowser(command, { path, url }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Auth Vault (1 tool)
+    // ============================================================
+    server.tool("browser_auth", "Auth vault operations: save, login, list, delete, show saved credentials", {
+        action: z.enum(["save", "login", "list", "delete", "show"]).describe("Auth action"),
+        name: z.string().optional().describe("Credential name (for save/login/delete/show)"),
+        url: z.string().optional().describe("Login URL (for save)"),
+        username: z.string().optional().describe("Username (for save)"),
+        password: z.string().optional().describe("Password (for save)"),
+        usernameSelector: z.string().optional().describe("CSS selector for username field (for save)"),
+        passwordSelector: z.string().optional().describe("CSS selector for password field (for save)"),
+        submitSelector: z.string().optional().describe("CSS selector for submit button (for save)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, name, url, username, password, usernameSelector, passwordSelector, submitSelector, sessionId }) => {
+        const command = `auth_${action}`;
+        const result = await execBrowser(command, { name, url, username, password, usernameSelector, passwordSelector, submitSelector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Diff (1 tool)
+    // ============================================================
+    server.tool("browser_diff", "Diff operations: compare snapshots, screenshots, or URLs", {
+        mode: z.enum(["snapshot", "screenshot", "url"]).describe("Diff mode"),
+        baseline: z.string().optional().describe("Baseline path (for snapshot/screenshot)"),
+        selector: z.string().optional().describe("CSS selector to scope the diff"),
+        compact: z.boolean().optional().describe("Use compact format (for snapshot/url)"),
+        depth: z.number().optional().describe("Limit tree depth (for snapshot/url)"),
+        output: z.string().optional().describe("Output path for diff image (for screenshot)"),
+        threshold: z.number().min(0).max(1).optional().describe("Mismatch threshold 0-1 (for screenshot)"),
+        fullPage: z.boolean().optional().describe("Compare full page (for screenshot/url)"),
+        url1: z.string().optional().describe("First URL (for url mode)"),
+        url2: z.string().optional().describe("Second URL (for url mode)"),
+        screenshot: z.boolean().optional().describe("Take screenshot comparison (for url mode)"),
+        waitUntil: z.string().optional().describe("Wait state before capture (for url mode)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ mode, baseline, selector, compact, depth, output, threshold, fullPage, url1, url2, screenshot, waitUntil, sessionId }) => {
+        const command = `diff_${mode}`;
+        const result = await execBrowser(command, { baseline, selector, compact, depth, output, threshold, fullPage, url1, url2, screenshot, waitUntil }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // React DevTools (1 tool)
+    // ============================================================
+    server.tool("browser_react", "React DevTools operations: component tree, fiber inspection, render tracking, suspense boundaries", {
+        action: z.enum(["tree", "inspect", "renders-start", "renders-stop", "suspense"])
+            .describe("React action"),
+        fiberId: z.number().optional().describe("Numeric fiber ID (for inspect)"),
+        json: z.boolean().optional().describe("Output as JSON"),
+        onlyDynamic: z.boolean().optional().describe("Show only dynamic suspense boundaries (for suspense)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, fiberId, json, onlyDynamic, sessionId }) => {
+        const command = action === "renders-start" ? "react_renders_start"
+            : action === "renders-stop" ? "react_renders_stop"
+                : `react_${action}`;
+        const result = await execBrowser(command, { fiberId, json, onlyDynamic }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Vitals (1 tool)
+    // ============================================================
+    server.tool("browser_vitals", "Get Core Web Vitals measurements (LCP, CLS, TTFB, FCP, INP)", {
+        url: z.string().optional().describe("URL to measure vitals on"),
+        json: z.boolean().optional().describe("Output as JSON"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ url, json, sessionId }) => {
+        const result = await execBrowser("vitals", { url, json }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Init Scripts (1 tool)
+    // ============================================================
+    server.tool("browser_remove_init_script", "Remove a previously registered initialization script", {
+        identifier: z.string().describe("Identifier of the init script to remove"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ identifier, sessionId }) => {
+        const result = await execBrowser("remove_init_script", { identifier }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Session (1 tool)
+    // ============================================================
+    server.tool("browser_session", "Session operations: show current session, list active sessions", {
+        action: z.enum(["show", "list"]).describe("Session action"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, sessionId }) => {
+        const command = action === "list" ? "session_list" : "session_show";
+        const result = await execBrowser(command, {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Streaming (1 tool)
+    // ============================================================
+    server.tool("browser_stream", "WebSocket streaming operations for real-time page observation", {
+        action: z.enum(["enable", "disable", "status"]).describe("Stream action"),
+        port: z.number().optional().describe("Port for the stream (for enable)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, port, sessionId }) => {
+        const command = `stream_${action}`;
+        const result = await execBrowser(command, { port }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Dashboard (1 tool)
+    // ============================================================
+    server.tool("browser_dashboard", "Dashboard operations: start/stop the observability dashboard server", {
+        action: z.enum(["start", "stop"]).describe("Dashboard action"),
+        port: z.number().optional().describe("Port for the dashboard (for start)"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ action, port, sessionId }) => {
+        const command = `dashboard_${action}`;
+        const result = await execBrowser(command, { port }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // iOS (3 tools)
+    // ============================================================
+    server.tool("browser_device_list", "List available iOS simulators", { sessionId: z.string().optional().describe("Browser session ID") }, async ({ sessionId }) => {
+        const result = await execBrowser("device_list", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_tap", "Tap an element on a touch/iOS device", {
+        selector: z.string().describe("CSS selector of the element to tap"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ selector, sessionId }) => {
+        const result = await execBrowser("tap", { selector }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_swipe", "Swipe gesture on a touch/iOS device", {
+        direction: z.enum(["up", "down", "left", "right"]).describe("Swipe direction"),
+        distance: z.number().optional().describe("Swipe distance in pixels"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ direction, distance, sessionId }) => {
+        const result = await execBrowser("swipe", { direction, distance }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Confirm / Deny (2 tools)
+    // ============================================================
+    server.tool("browser_confirm", "Approve a pending action/confirmation", {
+        confirmationId: z.string().describe("ID of the confirmation to accept"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ confirmationId, sessionId }) => {
+        const result = await execBrowser("confirm_action", { confirmationId }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    server.tool("browser_deny", "Reject a pending action/confirmation", {
+        confirmationId: z.string().describe("ID of the confirmation to reject"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ confirmationId, sessionId }) => {
+        const result = await execBrowser("deny_action", { confirmationId }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Connect (1 tool)
+    // ============================================================
+    server.tool("browser_connect", "Connect to a browser via CDP (Chrome DevTools Protocol)", {
+        endpoint: z.string().describe("CDP endpoint URL or port number"),
+        sessionId: z.string().optional().describe("Browser session ID"),
+    }, async ({ endpoint, sessionId }) => {
+        const result = await execBrowser("connect", { endpoint }, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Session Management (MCP-specific, 1 tool)
+    // ============================================================
+    server.tool("browser_close", "Close the current browser session (the daemon creates sessions automatically)", { sessionId: z.string().optional().describe("Browser session ID to close") }, async ({ sessionId }) => {
+        const result = await execBrowser("close_session", {}, sessionId);
+        return { content: [{ type: "text", text: result }] };
+    });
+    // ============================================================
+    // Browser Manager (1 tool)
+    // ============================================================
+    server.tool("browser_manager", "Browser manager: list available browsers, discover installed browsers, install a browser, or select the active browser", {
+        action: z.enum(["list", "discover", "install", "select"])
+            .describe("Manager action: list (all browsers), discover (installed only), install (by name), select (set active)"),
+        browser: z.enum(["chromium", "cloakbrowser", "chrome", "firefox", "brave", "edge"]).optional()
+            .describe("Browser name (required for install/select actions)"),
+    }, async ({ action, browser }) => {
+        switch (action) {
+            case "list": {
+                const browsers = listBrowsers();
+                const active = discoverActiveBrowser();
+                let output = "Available browsers:\n\n";
+                for (const b of browsers) {
+                    const isActive = active?.name === b.name;
+                    const status = b.installed ? "installed" : "not installed";
+                    const marker = isActive ? " [ACTIVE]" : "";
+                    const pathInfo = b.path ? ` → ${b.path}` : "";
+                    output += `  ${b.name.padEnd(16)} ${status}${marker}${pathInfo}\n`;
+                    output += `  ${"".padEnd(16)} ${b.description}\n\n`;
+                }
+                output += active ? `Active: ${active.name}` : `No active browser. Use action=select.`;
+                return { content: [{ type: "text", text: output }] };
+            }
+            case "discover": {
+                const browsers = discoverBrowsers();
+                const active = discoverActiveBrowser();
+                let output = "Discovered browsers:\n\n";
+                if (browsers.length === 0) {
+                    output += "  None found. Use action=install to add one.";
+                }
+                else {
+                    for (const b of browsers) {
+                        const isActive = active?.name === b.name;
+                        const marker = isActive ? " [ACTIVE]" : "";
+                        const source = b.source === "env" ? "(.env)" : "(auto)";
+                        output += `  ${b.name.padEnd(16)} ${b.path} ${source}${marker}\n`;
+                    }
+                }
+                return { content: [{ type: "text", text: output }] };
+            }
+            case "install": {
+                if (!browser)
+                    return { content: [{ type: "text", text: "Error: browser name required for install" }], isError: true };
+                const result = installBrowser(browser);
+                if (result.success) {
+                    return { content: [{ type: "text", text: `${browser} installed → ${result.path}` }] };
+                }
+                return { content: [{ type: "text", text: `Failed: ${result.error}` }], isError: true };
+            }
+            case "select": {
+                if (!browser)
+                    return { content: [{ type: "text", text: "Error: browser name required for select" }], isError: true };
+                const result = selectBrowser(browser);
+                if (result.success) {
+                    return { content: [{ type: "text", text: `Active: ${browser} → ${result.path}` }] };
+                }
+                return { content: [{ type: "text", text: result.error || "Failed" }], isError: true };
+            }
+        }
+    });
+}
+//# sourceMappingURL=browser.js.map