@sparkleideas/browser 3.0.0-alpha.7 → 3.0.0-alpha.9

package/dist/mcp-tools/browser-tools.js

@@ -0,0 +1,1163 @@
+/**
+ * @sparkleideas/browser - MCP Tools
+ * 50+ browser automation tools for claude-flow MCP server
+ */
+import { AgentBrowserAdapter } from '../infrastructure/agent-browser-adapter.js';
+// Session registry for multi-agent coordination
+const sessions = new Map();
+function getAdapter(sessionId) {
+    const id = sessionId || 'default';
+    if (!sessions.has(id)) {
+        sessions.set(id, new AgentBrowserAdapter({ session: id }));
+    }
+    return sessions.get(id);
+}
+// ============================================================================
+// Navigation Tools
+// ============================================================================
+const navigationTools = [
+    {
+        name: 'browser/open',
+        description: 'Navigate to a URL. Returns page title and final URL after redirects.',
+        category: 'browser-navigation',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to navigate to' },
+                session: { type: 'string', description: 'Session ID for isolated browser instance' },
+                waitUntil: {
+                    type: 'string',
+                    enum: ['load', 'domcontentloaded', 'networkidle'],
+                    description: 'When to consider navigation complete',
+                },
+                headers: {
+                    type: 'object',
+                    description: 'HTTP headers to set (scoped to URL origin)',
+                    additionalProperties: { type: 'string' },
+                },
+            },
+            required: ['url'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.open({
+                url: input.url,
+                waitUntil: input.waitUntil,
+                headers: input.headers,
+            });
+        },
+    },
+    {
+        name: 'browser/back',
+        description: 'Navigate back in browser history',
+        category: 'browser-navigation',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.back();
+        },
+    },
+    {
+        name: 'browser/forward',
+        description: 'Navigate forward in browser history',
+        category: 'browser-navigation',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.forward();
+        },
+    },
+    {
+        name: 'browser/reload',
+        description: 'Reload the current page',
+        category: 'browser-navigation',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.reload();
+        },
+    },
+    {
+        name: 'browser/close',
+        description: 'Close the browser session',
+        category: 'browser-navigation',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            const result = await adapter.close();
+            sessions.delete(input.session || 'default');
+            return result;
+        },
+    },
+];
+// ============================================================================
+// Snapshot Tools (AI-Optimized)
+// ============================================================================
+const snapshotTools = [
+    {
+        name: 'browser/snapshot',
+        description: 'Get accessibility tree with element refs (@e1, @e2). Best for AI - use refs to interact with elements. Returns structured tree with interactive elements highlighted.',
+        category: 'browser-snapshot',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                interactive: { type: 'boolean', description: 'Only show interactive elements (buttons, links, inputs)', default: true },
+                compact: { type: 'boolean', description: 'Remove empty structural elements', default: true },
+                depth: { type: 'number', description: 'Limit tree depth (e.g., 3 levels)' },
+                selector: { type: 'string', description: 'Scope snapshot to CSS selector' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.snapshot({
+                interactive: input.interactive !== false,
+                compact: input.compact !== false,
+                depth: input.depth,
+                selector: input.selector,
+            });
+        },
+    },
+    {
+        name: 'browser/screenshot',
+        description: 'Capture screenshot. Returns base64 PNG if no path specified.',
+        category: 'browser-snapshot',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'File path to save (optional, returns base64 if omitted)' },
+                fullPage: { type: 'boolean', description: 'Capture full scrollable page', default: false },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.screenshot({
+                path: input.path,
+                fullPage: input.fullPage,
+            });
+        },
+    },
+    {
+        name: 'browser/pdf',
+        description: 'Save page as PDF',
+        category: 'browser-snapshot',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'File path to save PDF' },
+            },
+            required: ['path'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.pdf(input.path);
+        },
+    },
+];
+// ============================================================================
+// Interaction Tools
+// ============================================================================
+const interactionTools = [
+    {
+        name: 'browser/click',
+        description: 'Click an element. Use @e1 refs from snapshot or CSS selectors.',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                button: { type: 'string', enum: ['left', 'right', 'middle'], default: 'left' },
+                clickCount: { type: 'number', description: 'Number of clicks (2 for double-click)' },
+                force: { type: 'boolean', description: 'Force click even if element is not visible' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.click({
+                target: input.target,
+                button: input.button,
+                clickCount: input.clickCount,
+                force: input.force,
+            });
+        },
+    },
+    {
+        name: 'browser/fill',
+        description: 'Clear and fill an input field. Use @e1 refs from snapshot.',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                value: { type: 'string', description: 'Text to fill' },
+                force: { type: 'boolean', description: 'Force fill even if element is not visible' },
+            },
+            required: ['target', 'value'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.fill({
+                target: input.target,
+                value: input.value,
+                force: input.force,
+            });
+        },
+    },
+    {
+        name: 'browser/type',
+        description: 'Type text character by character (with key events). Slower than fill but simulates real typing.',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                text: { type: 'string', description: 'Text to type' },
+                delay: { type: 'number', description: 'Delay between keystrokes in ms' },
+            },
+            required: ['target', 'text'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.type({
+                target: input.target,
+                text: input.text,
+                delay: input.delay,
+            });
+        },
+    },
+    {
+        name: 'browser/press',
+        description: 'Press a keyboard key (Enter, Tab, Escape, Control+a, etc.)',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                key: { type: 'string', description: 'Key to press (Enter, Tab, Control+a, etc.)' },
+                delay: { type: 'number', description: 'Key hold duration in ms' },
+            },
+            required: ['key'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.press(input.key, input.delay);
+        },
+    },
+    {
+        name: 'browser/hover',
+        description: 'Hover over an element',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.hover(input.target);
+        },
+    },
+    {
+        name: 'browser/select',
+        description: 'Select dropdown option by value',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                value: { type: 'string', description: 'Option value to select' },
+            },
+            required: ['target', 'value'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.select(input.target, input.value);
+        },
+    },
+    {
+        name: 'browser/check',
+        description: 'Check a checkbox',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.check(input.target);
+        },
+    },
+    {
+        name: 'browser/uncheck',
+        description: 'Uncheck a checkbox',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.uncheck(input.target);
+        },
+    },
+    {
+        name: 'browser/scroll',
+        description: 'Scroll the page or element',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                direction: { type: 'string', enum: ['up', 'down', 'left', 'right'], description: 'Scroll direction' },
+                pixels: { type: 'number', description: 'Pixels to scroll (default: viewport height)' },
+            },
+            required: ['direction'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.scroll(input.direction, input.pixels);
+        },
+    },
+    {
+        name: 'browser/upload',
+        description: 'Upload files to a file input',
+        category: 'browser-interaction',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                files: { type: 'array', items: { type: 'string' }, description: 'File paths to upload' },
+            },
+            required: ['target', 'files'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.upload(input.target, input.files);
+        },
+    },
+];
+// ============================================================================
+// Get Info Tools
+// ============================================================================
+const getInfoTools = [
+    {
+        name: 'browser/get-text',
+        description: 'Get text content of an element',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getText(input.target);
+        },
+    },
+    {
+        name: 'browser/get-html',
+        description: 'Get innerHTML of an element',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getHtml(input.target);
+        },
+    },
+    {
+        name: 'browser/get-value',
+        description: 'Get value of an input element',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getValue(input.target);
+        },
+    },
+    {
+        name: 'browser/get-attr',
+        description: 'Get an attribute value from an element',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+                attribute: { type: 'string', description: 'Attribute name (href, src, data-*, etc.)' },
+            },
+            required: ['target', 'attribute'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getAttr(input.target, input.attribute);
+        },
+    },
+    {
+        name: 'browser/get-title',
+        description: 'Get the page title',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getTitle();
+        },
+    },
+    {
+        name: 'browser/get-url',
+        description: 'Get the current page URL',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getUrl();
+        },
+    },
+    {
+        name: 'browser/get-count',
+        description: 'Count elements matching a selector',
+        category: 'browser-info',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                selector: { type: 'string', description: 'CSS selector to count' },
+            },
+            required: ['selector'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getCount(input.selector);
+        },
+    },
+];
+// ============================================================================
+// State Check Tools
+// ============================================================================
+const stateTools = [
+    {
+        name: 'browser/is-visible',
+        description: 'Check if an element is visible',
+        category: 'browser-state',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.isVisible(input.target);
+        },
+    },
+    {
+        name: 'browser/is-enabled',
+        description: 'Check if an element is enabled',
+        category: 'browser-state',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.isEnabled(input.target);
+        },
+    },
+    {
+        name: 'browser/is-checked',
+        description: 'Check if a checkbox is checked',
+        category: 'browser-state',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.isChecked(input.target);
+        },
+    },
+];
+// ============================================================================
+// Wait Tools
+// ============================================================================
+const waitTools = [
+    {
+        name: 'browser/wait',
+        description: 'Wait for element, time, text, URL, or load state',
+        category: 'browser-wait',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                selector: { type: 'string', description: 'Wait for element to be visible' },
+                timeout: { type: 'number', description: 'Wait for milliseconds' },
+                text: { type: 'string', description: 'Wait for text to appear on page' },
+                url: { type: 'string', description: 'Wait for URL pattern (glob)' },
+                load: { type: 'string', enum: ['load', 'domcontentloaded', 'networkidle'], description: 'Wait for load state' },
+                fn: { type: 'string', description: 'Wait for JavaScript condition to be true' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.wait({
+                selector: input.selector,
+                timeout: input.timeout,
+                text: input.text,
+                url: input.url,
+                load: input.load,
+                fn: input.fn,
+            });
+        },
+    },
+];
+// ============================================================================
+// JavaScript Execution
+// ============================================================================
+const evalTools = [
+    {
+        name: 'browser/eval',
+        description: 'Execute JavaScript in the page context',
+        category: 'browser-eval',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                script: { type: 'string', description: 'JavaScript code to execute' },
+            },
+            required: ['script'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.eval({ script: input.script });
+        },
+    },
+];
+// ============================================================================
+// Storage Tools
+// ============================================================================
+const storageTools = [
+    {
+        name: 'browser/cookies-get',
+        description: 'Get all cookies for the current page',
+        category: 'browser-storage',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getCookies();
+        },
+    },
+    {
+        name: 'browser/cookies-set',
+        description: 'Set a cookie',
+        category: 'browser-storage',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                name: { type: 'string', description: 'Cookie name' },
+                value: { type: 'string', description: 'Cookie value' },
+            },
+            required: ['name', 'value'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setCookie(input.name, input.value);
+        },
+    },
+    {
+        name: 'browser/cookies-clear',
+        description: 'Clear all cookies',
+        category: 'browser-storage',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.clearCookies();
+        },
+    },
+    {
+        name: 'browser/localstorage-get',
+        description: 'Get localStorage value (or all if no key)',
+        category: 'browser-storage',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                key: { type: 'string', description: 'Key to get (omit for all)' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.getLocalStorage(input.key);
+        },
+    },
+    {
+        name: 'browser/localstorage-set',
+        description: 'Set localStorage value',
+        category: 'browser-storage',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                key: { type: 'string', description: 'Key to set' },
+                value: { type: 'string', description: 'Value to set' },
+            },
+            required: ['key', 'value'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setLocalStorage(input.key, input.value);
+        },
+    },
+];
+// ============================================================================
+// Network Tools
+// ============================================================================
+const networkTools = [
+    {
+        name: 'browser/network-route',
+        description: 'Intercept, block, or mock network requests',
+        category: 'browser-network',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                urlPattern: { type: 'string', description: 'URL pattern to match (glob)' },
+                abort: { type: 'boolean', description: 'Block matching requests' },
+                body: { type: 'string', description: 'Mock response body (JSON string)' },
+                status: { type: 'number', description: 'Mock response status code' },
+            },
+            required: ['urlPattern'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.networkRoute({
+                urlPattern: input.urlPattern,
+                abort: input.abort,
+                body: input.body,
+                status: input.status,
+            });
+        },
+    },
+    {
+        name: 'browser/network-unroute',
+        description: 'Remove network route',
+        category: 'browser-network',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                urlPattern: { type: 'string', description: 'URL pattern to remove (omit for all)' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.networkUnroute(input.urlPattern);
+        },
+    },
+    {
+        name: 'browser/network-requests',
+        description: 'Get tracked network requests',
+        category: 'browser-network',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                filter: { type: 'string', description: 'Filter by URL substring' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.networkRequests(input.filter);
+        },
+    },
+];
+// ============================================================================
+// Tab & Session Tools
+// ============================================================================
+const tabTools = [
+    {
+        name: 'browser/tab-list',
+        description: 'List all open tabs',
+        category: 'browser-tabs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.listTabs();
+        },
+    },
+    {
+        name: 'browser/tab-new',
+        description: 'Open a new tab',
+        category: 'browser-tabs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                url: { type: 'string', description: 'URL to open in new tab' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.newTab(input.url);
+        },
+    },
+    {
+        name: 'browser/tab-switch',
+        description: 'Switch to a specific tab',
+        category: 'browser-tabs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                index: { type: 'number', description: 'Tab index (0-based)' },
+            },
+            required: ['index'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.switchTab(input.index);
+        },
+    },
+    {
+        name: 'browser/tab-close',
+        description: 'Close a tab',
+        category: 'browser-tabs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                index: { type: 'number', description: 'Tab index to close (current if omitted)' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.closeTab(input.index);
+        },
+    },
+    {
+        name: 'browser/session-list',
+        description: 'List all active browser sessions',
+        category: 'browser-session',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: async () => {
+            const adapter = getAdapter();
+            return adapter.listSessions();
+        },
+    },
+];
+// ============================================================================
+// Settings Tools
+// ============================================================================
+const settingsTools = [
+    {
+        name: 'browser/set-viewport',
+        description: 'Set browser viewport size',
+        category: 'browser-settings',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                width: { type: 'number', description: 'Viewport width' },
+                height: { type: 'number', description: 'Viewport height' },
+            },
+            required: ['width', 'height'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setViewport(input.width, input.height);
+        },
+    },
+    {
+        name: 'browser/set-device',
+        description: 'Emulate a device (iPhone 14, Pixel 5, etc.)',
+        category: 'browser-settings',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                device: { type: 'string', description: 'Device name (e.g., "iPhone 14", "Pixel 5")' },
+            },
+            required: ['device'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setDevice(input.device);
+        },
+    },
+    {
+        name: 'browser/set-geolocation',
+        description: 'Set geolocation',
+        category: 'browser-settings',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                latitude: { type: 'number', description: 'Latitude' },
+                longitude: { type: 'number', description: 'Longitude' },
+            },
+            required: ['latitude', 'longitude'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setGeolocation(input.latitude, input.longitude);
+        },
+    },
+    {
+        name: 'browser/set-offline',
+        description: 'Toggle offline mode',
+        category: 'browser-settings',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                enabled: { type: 'boolean', description: 'Enable offline mode' },
+            },
+            required: ['enabled'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setOffline(input.enabled);
+        },
+    },
+    {
+        name: 'browser/set-media',
+        description: 'Emulate color scheme (dark/light mode)',
+        category: 'browser-settings',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                scheme: { type: 'string', enum: ['dark', 'light'], description: 'Color scheme' },
+            },
+            required: ['scheme'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.setMedia(input.scheme);
+        },
+    },
+];
+// ============================================================================
+// Debug Tools
+// ============================================================================
+const debugTools = [
+    {
+        name: 'browser/trace-start',
+        description: 'Start recording a trace for debugging',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'Path to save trace' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.traceStart(input.path);
+        },
+    },
+    {
+        name: 'browser/trace-stop',
+        description: 'Stop recording trace and save',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'Path to save trace' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.traceStop(input.path);
+        },
+    },
+    {
+        name: 'browser/console',
+        description: 'Get console messages',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                clear: { type: 'boolean', description: 'Clear console after getting messages' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            if (input.clear) {
+                return adapter.clearConsole();
+            }
+            return adapter.getConsole();
+        },
+    },
+    {
+        name: 'browser/errors',
+        description: 'Get page errors',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                clear: { type: 'boolean', description: 'Clear errors after getting' },
+            },
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            if (input.clear) {
+                return adapter.clearErrors();
+            }
+            return adapter.getErrors();
+        },
+    },
+    {
+        name: 'browser/highlight',
+        description: 'Highlight an element on the page (for visual debugging)',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                target: { type: 'string', description: 'Element ref (@e1) or CSS selector' },
+            },
+            required: ['target'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.highlight(input.target);
+        },
+    },
+    {
+        name: 'browser/state-save',
+        description: 'Save authentication state (cookies, localStorage) to file',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'Path to save state file' },
+            },
+            required: ['path'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.saveState(input.path);
+        },
+    },
+    {
+        name: 'browser/state-load',
+        description: 'Load authentication state from file',
+        category: 'browser-debug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                path: { type: 'string', description: 'Path to state file' },
+            },
+            required: ['path'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.loadState(input.path);
+        },
+    },
+];
+// ============================================================================
+// Semantic Locator Tools (Find Commands)
+// ============================================================================
+const findTools = [
+    {
+        name: 'browser/find-role',
+        description: 'Find element by ARIA role and perform action',
+        category: 'browser-find',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                role: { type: 'string', description: 'ARIA role (button, link, textbox, etc.)' },
+                action: { type: 'string', enum: ['click', 'fill', 'check', 'hover', 'text'], description: 'Action to perform' },
+                name: { type: 'string', description: 'Accessible name to match' },
+                value: { type: 'string', description: 'Value for fill action' },
+                exact: { type: 'boolean', description: 'Exact text match' },
+            },
+            required: ['role', 'action'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.findByRole(input.role, input.action, {
+                name: input.name,
+                exact: input.exact,
+            });
+        },
+    },
+    {
+        name: 'browser/find-text',
+        description: 'Find element by text content and perform action',
+        category: 'browser-find',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                text: { type: 'string', description: 'Text to find' },
+                action: { type: 'string', enum: ['click', 'hover', 'text'], description: 'Action to perform' },
+            },
+            required: ['text', 'action'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.findByText(input.text, input.action);
+        },
+    },
+    {
+        name: 'browser/find-label',
+        description: 'Find input by label and perform action',
+        category: 'browser-find',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                label: { type: 'string', description: 'Label text' },
+                action: { type: 'string', enum: ['click', 'fill', 'check', 'hover', 'text'], description: 'Action to perform' },
+                value: { type: 'string', description: 'Value for fill action' },
+            },
+            required: ['label', 'action'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.findByLabel(input.label, input.action, input.value);
+        },
+    },
+    {
+        name: 'browser/find-testid',
+        description: 'Find element by data-testid and perform action',
+        category: 'browser-find',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session: { type: 'string', description: 'Session ID' },
+                testId: { type: 'string', description: 'data-testid value' },
+                action: { type: 'string', enum: ['click', 'fill', 'check', 'hover', 'text'], description: 'Action to perform' },
+                value: { type: 'string', description: 'Value for fill action' },
+            },
+            required: ['testId', 'action'],
+        },
+        handler: async (input) => {
+            const adapter = getAdapter(input.session);
+            return adapter.findByTestId(input.testId, input.action, input.value);
+        },
+    },
+];
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const browserTools = [
+    ...navigationTools,
+    ...snapshotTools,
+    ...interactionTools,
+    ...getInfoTools,
+    ...stateTools,
+    ...waitTools,
+    ...evalTools,
+    ...storageTools,
+    ...networkTools,
+    ...tabTools,
+    ...settingsTools,
+    ...debugTools,
+    ...findTools,
+];
+export default browserTools;
+//# sourceMappingURL=browser-tools.js.map