@browserbridge/bbx 1.0.0 → 1.0.1

package/packages/mcp-server/src/server.js

@@ -24,7 +24,7 @@ import {
   handleStatusTool,
   handleStylesLayoutTool,
   handleTabsTool,
-  handleInvestigateTool
+  handleInvestigateTool,
 } from './handlers.js';
 import {
   BUDGET_PRESETS,
@@ -39,15 +39,17 @@ import {
 } from '../../protocol/src/index.js';
 
 export const BUDGET_PRESET_DESCRIPTION = `Budget preset: "quick", "normal", or "deep" (defaults: query ${BUDGET_PRESETS.normal.maxNodes} nodes / depth ${BUDGET_PRESETS.normal.maxDepth} / text ${BUDGET_PRESETS.normal.textBudget}). Numeric fields override the preset when both are provided.`;
-export const TAB_ID_DESCRIPTION = 'Target a specific tab instead of the active tab in the enabled window.';
+export const TAB_ID_DESCRIPTION =
+  'Target a specific tab instead of the active tab in the enabled window.';
 
 /** @type {readonly import('../../protocol/src/types.js').BridgeMethod[]} */
 const INVESTIGATE_SUBAGENT_BRIDGE_METHODS = Object.freeze(
-  getMethodsByMaxComplexity('low').filter((method) =>
-    method.startsWith('page.') ||
-    method.startsWith('dom.') ||
-    method.startsWith('styles.') ||
-    method.startsWith('layout.')
+  getMethodsByMaxComplexity('low').filter(
+    (method) =>
+      method.startsWith('page.') ||
+      method.startsWith('dom.') ||
+      method.startsWith('styles.') ||
+      method.startsWith('layout.')
   )
 );
 
@@ -58,12 +60,7 @@ const INVESTIGATE_DELEGATION_HINT = Object.freeze({
     modelClass: 'small',
     reasoningEffort: 'low',
   },
-  preferredTools: [
-    'browser_dom',
-    'browser_page',
-    'browser_styles_layout',
-    'browser_batch',
-  ],
+  preferredTools: ['browser_dom', 'browser_page', 'browser_styles_layout', 'browser_batch'],
   escalationTools: ['browser_capture'],
   preferredBridgeMethods: INVESTIGATE_SUBAGENT_BRIDGE_METHODS,
   escalationTriggers: [
@@ -79,270 +76,574 @@ const INVESTIGATE_DELEGATION_HINT = Object.freeze({
 export function createBridgeMcpServer() {
   const server = new McpServer({
     name: 'browser-bridge',
-    version: '1.0.0'
+    version: '1.0.0',
   });
 
-  server.registerTool('browser_status', {
-    title: 'Browser Bridge Status',
-    description: 'Check bridge readiness: daemon connectivity, extension state, and window access. Call first to confirm the bridge is usable. If access is not enabled, ask the user to click Enable in the extension popup or side panel, then retry.',
-    inputSchema: {}
-  }, handleStatusTool);
-
-  server.registerTool('browser_setup', {
-    title: 'Browser Bridge Setup Status',
-    description: 'Check MCP and CLI skill installation status for agent integration.',
-    inputSchema: {
-      global: z.boolean().optional().describe('Check global (true) or local (false) config (default: true)')
-    }
-  }, handleSetupTool);
-
-  server.registerTool('browser_logs', {
-    title: 'Browser Bridge Logs',
-    description: 'Tail recent bridge request logs for debugging connection or routing issues.',
-    inputSchema: {
-      limit: z.number().optional().describe(`Maximum log entries to return (default: ${DEFAULT_CONSOLE_LIMIT})`),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION)
-    }
-  }, handleLogTool);
+  server.registerTool(
+    'browser_status',
+    {
+      title: 'Browser Bridge Status',
+      description:
+        'Check bridge readiness: daemon connectivity, extension state, and window access. Call first to confirm the bridge is usable. If access is not enabled, ask the user to click Enable in the extension popup or side panel, then retry.',
+      inputSchema: {},
+    },
+    handleStatusTool
+  );
 
-  server.registerTool('browser_health', {
-    title: 'Browser Bridge Health',
-    description: 'Ping the bridge to verify daemon and extension connectivity.',
-    inputSchema: {}
-  }, handleHealthTool);
+  server.registerTool(
+    'browser_setup',
+    {
+      title: 'Browser Bridge Setup Status',
+      description: 'Check MCP and CLI skill installation status for agent integration.',
+      inputSchema: {
+        global: z
+          .boolean()
+          .optional()
+          .describe('Check global (true) or local (false) config (default: true)'),
+      },
+    },
+    handleSetupTool
+  );
 
-  server.registerTool('browser_tabs', {
-    title: 'Browser Tabs',
-    description: 'List, create, or close browser tabs. Prefer "list" to work in existing tabs; only use "create" when the user explicitly requests a new page.',
-    inputSchema: {
-      action: z.enum(['list', 'create', 'close']).describe('"list" (preferred), "create" (only when needed), or "close"'),
-      url: z.string().optional().describe('URL for create action'),
-      active: z.boolean().optional().describe('Focus the new tab (default: true)'),
-      tabId: z.number().optional().describe('Tab ID (required for close)')
-    }
-  }, handleTabsTool);
+  server.registerTool(
+    'browser_logs',
+    {
+      title: 'Browser Bridge Logs',
+      description: 'Tail recent bridge request logs for debugging connection or routing issues.',
+      inputSchema: {
+        limit: z
+          .number()
+          .optional()
+          .describe(`Maximum log entries to return (default: ${DEFAULT_CONSOLE_LIMIT})`),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+      },
+    },
+    handleLogTool
+  );
 
-  server.registerTool('browser_dom', {
-    title: 'Browser DOM',
-    description: 'Query, describe, read, search, or wait for DOM elements. Reuse elementRef from prior results. For full-page text, use browser_page action "text". accessibility_tree is debugger-backed — use query/find first.',
-    inputSchema: {
-      action: z.enum(['query', 'describe', 'text', 'attributes', 'wait', 'find_text', 'find_role', 'html', 'accessibility_tree']).describe('DOM operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      selector: z.string().optional().describe('CSS selector (used if no elementRef; resolves to first match)'),
-      elementRef: z.string().optional().describe('Element reference from prior result (preferred over selector)'),
-      withinRef: z.string().optional().describe('Scope query to this elementRef subtree'),
-      maxNodes: z.number().optional().describe(`Maximum nodes to return (default: ${DEFAULT_MAX_NODES})`),
-      maxDepth: z.number().optional().describe(`Maximum tree depth (default: ${DEFAULT_MAX_DEPTH})`),
-      textBudget: z.number().optional().describe(`Max chars of text content per node (default: ${DEFAULT_TEXT_BUDGET})`),
-      includeBbox: z.boolean().optional().describe('Include bounding box (default: true, set false to save tokens)'),
-      attributeAllowlist: z.array(z.string()).optional().describe('Only include these attributes (reduces tokens)'),
-      attributes: z.array(z.string()).optional().describe('Attribute names to fetch (for attributes action)'),
-      text: z.string().optional().describe('Text to search for (for find_text/wait actions)'),
-      exact: z.boolean().optional().describe('Require exact text match (default: false, substring match)'),
-      maxResults: z.number().optional().describe('Maximum search results (default: 10)'),
-      role: z.string().optional().describe('ARIA role to search for (for find_role action)'),
-      name: z.string().optional().describe('Accessible name to match with role'),
-      state: z.enum(['attached', 'detached', 'visible', 'hidden']).optional().describe('Expected element state (for wait action)'),
-      timeoutMs: z.number().optional().describe(`Timeout for wait operations (default: ${DEFAULT_WAIT_TIMEOUT_MS})`),
-      outer: z.boolean().optional().describe('Return outerHTML instead of innerHTML (default: false)'),
-      maxLength: z.number().optional().describe(`Max HTML chars to return (default: ${DEFAULT_MAX_HTML_LENGTH})`)
-    }
-  }, handleDomTool);
+  server.registerTool(
+    'browser_health',
+    {
+      title: 'Browser Bridge Health',
+      description: 'Ping the bridge to verify daemon and extension connectivity.',
+      inputSchema: {},
+    },
+    handleHealthTool
+  );
 
-  server.registerTool('browser_styles_layout', {
-    title: 'Browser Styles And Layout',
-    description: 'Read computed styles, matched CSS rules, box model, or hit-test a viewport point. Reuse elementRef from prior queries. For DOM structure, use browser_dom.',
-    inputSchema: {
-      action: z.enum(['computed', 'matched_rules', 'box_model', 'hit_test']).describe('Style/layout operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      elementRef: z.string().optional().describe('Element reference (preferred over selector)'),
-      selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
-      properties: z.array(z.string()).optional().describe('Style properties to fetch (omitting returns all - expensive)'),
-      x: z.number().optional().describe('X coordinate for hit_test (viewport relative)'),
-      y: z.number().optional().describe('Y coordinate for hit_test (viewport relative)')
-    }
-  }, handleStylesLayoutTool);
+  server.registerTool(
+    'browser_tabs',
+    {
+      title: 'Browser Tabs',
+      description:
+        'List, create, or close browser tabs. Prefer "list" to work in existing tabs; only use "create" when the user explicitly requests a new page.',
+      inputSchema: {
+        action: z
+          .enum(['list', 'create', 'close'])
+          .describe('"list" (preferred), "create" (only when needed), or "close"'),
+        url: z.string().optional().describe('URL for create action'),
+        active: z.boolean().optional().describe('Focus the new tab (default: true)'),
+        tabId: z.number().optional().describe('Tab ID (required for close)'),
+      },
+    },
+    handleTabsTool
+  );
 
-  server.registerTool('browser_page', {
-    title: 'Browser Page State',
-    description: 'Read page-level data: state (URL/title), evaluate (JS), console, storage, text, network, or performance. For element-level reads, use browser_dom. evaluate and performance are debugger-backed — prefer lighter reads first.',
-    inputSchema: {
-      action: z.enum(['state', 'evaluate', 'console', 'wait_for_load', 'storage', 'text', 'network', 'performance']).describe('Page operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      expression: z.string().optional().describe('JavaScript expression to evaluate (for evaluate action)'),
-      awaitPromise: z.boolean().optional().describe('Await returned promises (default: false)'),
-      timeoutMs: z.number().optional().describe(`Timeout for evaluate/wait operations (default: ${DEFAULT_WAIT_TIMEOUT_MS})`),
-      returnByValue: z.boolean().optional().describe('Return actual value vs JSON (default: true)'),
-      level: z.string().optional().describe('Minimum console level: log, warn, error (default: all)'),
-      clear: z.boolean().optional().describe('Clear buffer after reading (default: false)'),
-      limit: z.number().optional().describe(`Maximum entries to return (default: ${DEFAULT_CONSOLE_LIMIT})`),
-      type: z.enum(['local', 'session']).optional().describe('Storage type to read (default: local)'),
-      keys: z.array(z.string()).optional().describe('Specific storage keys to fetch (omitting returns all)'),
-      textBudget: z.number().optional().describe(`Max chars for page text (default: ${DEFAULT_PAGE_TEXT_BUDGET})`),
-      urlPattern: z.string().optional().describe('Filter network entries by URL pattern')
-    }
-  }, handlePageTool);
+  server.registerTool(
+    'browser_dom',
+    {
+      title: 'Browser DOM',
+      description:
+        'Query, describe, read, search, or wait for DOM elements. Reuse elementRef from prior results. For full-page text, use browser_page action "text". accessibility_tree is debugger-backed — use query/find first.',
+      inputSchema: {
+        action: z
+          .enum([
+            'query',
+            'describe',
+            'text',
+            'attributes',
+            'wait',
+            'find_text',
+            'find_role',
+            'html',
+            'accessibility_tree',
+          ])
+          .describe('DOM operation to perform'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        selector: z
+          .string()
+          .optional()
+          .describe('CSS selector (used if no elementRef; resolves to first match)'),
+        elementRef: z
+          .string()
+          .optional()
+          .describe('Element reference from prior result (preferred over selector)'),
+        withinRef: z.string().optional().describe('Scope query to this elementRef subtree'),
+        maxNodes: z
+          .number()
+          .optional()
+          .describe(`Maximum nodes to return (default: ${DEFAULT_MAX_NODES})`),
+        maxDepth: z
+          .number()
+          .optional()
+          .describe(`Maximum tree depth (default: ${DEFAULT_MAX_DEPTH})`),
+        textBudget: z
+          .number()
+          .optional()
+          .describe(`Max chars of text content per node (default: ${DEFAULT_TEXT_BUDGET})`),
+        includeBbox: z
+          .boolean()
+          .optional()
+          .describe('Include bounding box (default: true, set false to save tokens)'),
+        attributeAllowlist: z
+          .array(z.string())
+          .optional()
+          .describe('Only include these attributes (reduces tokens)'),
+        attributes: z
+          .array(z.string())
+          .optional()
+          .describe('Attribute names to fetch (for attributes action)'),
+        text: z.string().optional().describe('Text to search for (for find_text/wait actions)'),
+        exact: z
+          .boolean()
+          .optional()
+          .describe('Require exact text match (default: false, substring match)'),
+        maxResults: z.number().optional().describe('Maximum search results (default: 10)'),
+        role: z.string().optional().describe('ARIA role to search for (for find_role action)'),
+        name: z.string().optional().describe('Accessible name to match with role'),
+        state: z
+          .enum(['attached', 'detached', 'visible', 'hidden'])
+          .optional()
+          .describe('Expected element state (for wait action)'),
+        timeoutMs: z
+          .number()
+          .optional()
+          .describe(`Timeout for wait operations (default: ${DEFAULT_WAIT_TIMEOUT_MS})`),
+        outer: z
+          .boolean()
+          .optional()
+          .describe('Return outerHTML instead of innerHTML (default: false)'),
+        maxLength: z
+          .number()
+          .optional()
+          .describe(`Max HTML chars to return (default: ${DEFAULT_MAX_HTML_LENGTH})`),
+      },
+    },
+    handleDomTool
+  );
 
-  server.registerTool('browser_navigation', {
-    title: 'Browser Navigation',
-    description: 'Navigate to a URL, reload, go back/forward, scroll, or resize the viewport. resize is debugger-backed — use only for exact viewport overrides.',
-    inputSchema: {
-      action: z.enum(['navigate', 'reload', 'go_back', 'go_forward', 'scroll', 'resize']).describe('Navigation operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      url: z.string().optional().describe('URL to navigate to (for navigate action)'),
-      waitForLoad: z.boolean().optional().describe('Wait for load event (default: true)'),
-      timeoutMs: z.number().optional().describe('Timeout for navigation (default: 30000)'),
-      top: z.number().optional().describe('Scroll target Y position (pixels)'),
-      left: z.number().optional().describe('Scroll target X position (pixels)'),
-      behavior: z.enum(['auto', 'smooth']).optional().describe('Scroll behavior (default: auto)'),
-      relative: z.boolean().optional().describe('Scroll relative to current position (default: false)'),
-      width: z.number().optional().describe('Viewport width in pixels'),
-      height: z.number().optional().describe('Viewport height in pixels'),
-      reset: z.boolean().optional().describe('Reset viewport to original size (for resize)')
-    }
-  }, handleNavigationTool);
+  server.registerTool(
+    'browser_styles_layout',
+    {
+      title: 'Browser Styles And Layout',
+      description:
+        'Read computed styles, matched CSS rules, box model, or hit-test a viewport point. Reuse elementRef from prior queries. For DOM structure, use browser_dom.',
+      inputSchema: {
+        action: z
+          .enum(['computed', 'matched_rules', 'box_model', 'hit_test'])
+          .describe('Style/layout operation to perform'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        elementRef: z.string().optional().describe('Element reference (preferred over selector)'),
+        selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
+        properties: z
+          .array(z.string())
+          .optional()
+          .describe('Style properties to fetch (omitting returns all - expensive)'),
+        x: z.number().optional().describe('X coordinate for hit_test (viewport relative)'),
+        y: z.number().optional().describe('Y coordinate for hit_test (viewport relative)'),
+      },
+    },
+    handleStylesLayoutTool
+  );
 
-  server.registerTool('browser_input', {
-    title: 'Browser Input',
-    description: 'Simulate user input: click, focus, type, press keys, set checked, select options, hover, drag, or scroll into view. Reuse elementRef from prior queries.',
-    inputSchema: {
-      action: z.enum(['click', 'focus', 'type', 'press_key', 'set_checked', 'select_option', 'hover', 'drag', 'scroll_into_view']).describe('Input operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      elementRef: z.string().optional().describe('Target element reference (preferred over selector)'),
-      selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
-      button: z.enum(['left', 'middle', 'right']).optional().describe('Mouse button for click (default: left)'),
-      clickCount: z.number().optional().describe('Click count (1=single, 2=double)'),
-      text: z.string().optional().describe('Text to type (for type action)'),
-      clear: z.boolean().optional().describe('Clear field before typing (default: false)'),
-      submit: z.boolean().optional().describe('Press Enter after typing (default: false)'),
-      key: z.string().optional().describe('Key to press (e.g., "Enter", "Tab", "ArrowDown")'),
-      modifiers: z.array(z.enum(['Alt', 'Control', 'Meta', 'Shift'])).optional().describe('Modifier keys'),
-      checked: z.boolean().optional().describe('Checked state (for set_checked action)'),
-      values: z.array(z.string()).optional().describe('Option values to select'),
-      labels: z.array(z.string()).optional().describe('Option labels to select (alternative to values)'),
-      indexes: z.array(z.number()).optional().describe('Option indexes to select (alternative to values/labels)'),
-      duration: z.number().optional().describe('Hover duration in ms (default: 100)'),
-      sourceElementRef: z.string().optional().describe('Drag source element (for drag action)'),
-      sourceSelector: z.string().optional().describe('Drag source selector (alternative to sourceElementRef)'),
-      destinationElementRef: z.string().optional().describe('Drag destination element (for drag action)'),
-      destinationSelector: z.string().optional().describe('Drag destination selector (alternative to destinationElementRef)'),
-      offsetX: z.number().optional().describe('Drag drop offset X (default: 0)'),
-      offsetY: z.number().optional().describe('Drag drop offset Y (default: 0)')
-    }
-  }, handleInputTool);
+  server.registerTool(
+    'browser_page',
+    {
+      title: 'Browser Page State',
+      description:
+        'Read page-level data: state (URL/title), evaluate (JS), console, storage, text, network, or performance. For element-level reads, use browser_dom. evaluate and performance are debugger-backed — prefer lighter reads first.',
+      inputSchema: {
+        action: z
+          .enum([
+            'state',
+            'evaluate',
+            'console',
+            'wait_for_load',
+            'storage',
+            'text',
+            'network',
+            'performance',
+          ])
+          .describe('Page operation to perform'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        expression: z
+          .string()
+          .optional()
+          .describe('JavaScript expression to evaluate (for evaluate action)'),
+        awaitPromise: z.boolean().optional().describe('Await returned promises (default: false)'),
+        timeoutMs: z
+          .number()
+          .optional()
+          .describe(`Timeout for evaluate/wait operations (default: ${DEFAULT_WAIT_TIMEOUT_MS})`),
+        returnByValue: z
+          .boolean()
+          .optional()
+          .describe('Return actual value vs JSON (default: true)'),
+        level: z
+          .string()
+          .optional()
+          .describe('Minimum console level: log, warn, error (default: all)'),
+        clear: z.boolean().optional().describe('Clear buffer after reading (default: false)'),
+        limit: z
+          .number()
+          .optional()
+          .describe(`Maximum entries to return (default: ${DEFAULT_CONSOLE_LIMIT})`),
+        type: z
+          .enum(['local', 'session'])
+          .optional()
+          .describe('Storage type to read (default: local)'),
+        keys: z
+          .array(z.string())
+          .optional()
+          .describe('Specific storage keys to fetch (omitting returns all)'),
+        textBudget: z
+          .number()
+          .optional()
+          .describe(`Max chars for page text (default: ${DEFAULT_PAGE_TEXT_BUDGET})`),
+        urlPattern: z.string().optional().describe('Filter network entries by URL pattern'),
+      },
+    },
+    handlePageTool
+  );
 
-  server.registerTool('browser_patch', {
-    title: 'Browser Patch',
-    description: 'Apply or rollback reversible style and DOM patches for live prototyping before editing source. Set verify=true to get computed results inline without a follow-up query.',
-    inputSchema: {
-      action: z.enum(['apply_styles', 'apply_dom', 'list', 'rollback', 'commit_baseline']).describe('Patch operation to perform'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      elementRef: z.string().optional().describe('Target element reference (preferred over selector)'),
-      selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
-      declarations: z.record(z.string(), z.string()).optional().describe('CSS property: value pairs (for apply_styles)'),
-      important: z.boolean().optional().describe('Add !important flag (default: false)'),
-      operation: z.enum(['setAttribute', 'removeAttribute', 'addClass', 'removeClass', 'setTextContent', 'setProperty']).optional().describe('DOM mutation type'),
-      value: z.unknown().optional().describe('Value for the DOM operation'),
-      name: z.string().optional().describe('Attribute/class/property name (for apply_dom)'),
-      patchId: z.string().optional().describe('Patch ID to rollback (omit for most recent)'),
-      verify: z.boolean().optional().describe('Return computed result inline after applying, eliminating a verification round-trip')
-    }
-  }, handlePatchTool);
+  server.registerTool(
+    'browser_navigation',
+    {
+      title: 'Browser Navigation',
+      description:
+        'Navigate to a URL, reload, go back/forward, scroll, or resize the viewport. resize is debugger-backed — use only for exact viewport overrides.',
+      inputSchema: {
+        action: z
+          .enum(['navigate', 'reload', 'go_back', 'go_forward', 'scroll', 'resize'])
+          .describe('Navigation operation to perform'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        url: z.string().optional().describe('URL to navigate to (for navigate action)'),
+        waitForLoad: z.boolean().optional().describe('Wait for load event (default: true)'),
+        timeoutMs: z.number().optional().describe('Timeout for navigation (default: 30000)'),
+        top: z.number().optional().describe('Scroll target Y position (pixels)'),
+        left: z.number().optional().describe('Scroll target X position (pixels)'),
+        behavior: z.enum(['auto', 'smooth']).optional().describe('Scroll behavior (default: auto)'),
+        relative: z
+          .boolean()
+          .optional()
+          .describe('Scroll relative to current position (default: false)'),
+        width: z.number().optional().describe('Viewport width in pixels'),
+        height: z.number().optional().describe('Viewport height in pixels'),
+        reset: z.boolean().optional().describe('Reset viewport to original size (for resize)'),
+      },
+    },
+    handleNavigationTool
+  );
 
-  server.registerTool('browser_capture', {
-    title: 'Browser Capture',
-    description: 'Capture screenshots or CDP snapshots. Debugger-backed and token-expensive — use only when structured reads (browser_dom, browser_styles_layout) are insufficient. Prefer element, then tight region; full_page only for document-level context.',
-    inputSchema: {
-      action: z.enum(['element', 'region', 'full_page', 'cdp_document', 'cdp_dom_snapshot', 'cdp_box_model', 'cdp_computed_styles']).describe('element (preferred), region (tight crop), full_page (document-level only), or cdp_* for low-level data'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION),
-      elementRef: z.string().optional().describe('Element reference (for element action, preferred)'),
-      selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
-      rect: z.object({
-        x: z.number().describe('Region left edge (viewport pixels)'),
-        y: z.number().describe('Region top edge (viewport pixels)'),
-        width: z.number().describe('Region width (pixels)'),
-        height: z.number().describe('Region height (pixels)')
-      }).optional().describe('Viewport region for region action (keep crop tight)')
-    }
-  }, handleCaptureTool);
+  server.registerTool(
+    'browser_input',
+    {
+      title: 'Browser Input',
+      description:
+        'Simulate user input: click, focus, type, press keys, set checked, select options, hover, drag, or scroll into view. Reuse elementRef from prior queries.',
+      inputSchema: {
+        action: z
+          .enum([
+            'click',
+            'focus',
+            'type',
+            'press_key',
+            'set_checked',
+            'select_option',
+            'hover',
+            'drag',
+            'scroll_into_view',
+          ])
+          .describe('Input operation to perform'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        elementRef: z
+          .string()
+          .optional()
+          .describe('Target element reference (preferred over selector)'),
+        selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
+        button: z
+          .enum(['left', 'middle', 'right'])
+          .optional()
+          .describe('Mouse button for click (default: left)'),
+        clickCount: z.number().optional().describe('Click count (1=single, 2=double)'),
+        text: z.string().optional().describe('Text to type (for type action)'),
+        clear: z.boolean().optional().describe('Clear field before typing (default: false)'),
+        submit: z.boolean().optional().describe('Press Enter after typing (default: false)'),
+        key: z.string().optional().describe('Key to press (e.g., "Enter", "Tab", "ArrowDown")'),
+        modifiers: z
+          .array(z.enum(['Alt', 'Control', 'Meta', 'Shift']))
+          .optional()
+          .describe('Modifier keys'),
+        checked: z.boolean().optional().describe('Checked state (for set_checked action)'),
+        values: z.array(z.string()).optional().describe('Option values to select'),
+        labels: z
+          .array(z.string())
+          .optional()
+          .describe('Option labels to select (alternative to values)'),
+        indexes: z
+          .array(z.number())
+          .optional()
+          .describe('Option indexes to select (alternative to values/labels)'),
+        duration: z.number().optional().describe('Hover duration in ms (default: 100)'),
+        sourceElementRef: z.string().optional().describe('Drag source element (for drag action)'),
+        sourceSelector: z
+          .string()
+          .optional()
+          .describe('Drag source selector (alternative to sourceElementRef)'),
+        destinationElementRef: z
+          .string()
+          .optional()
+          .describe('Drag destination element (for drag action)'),
+        destinationSelector: z
+          .string()
+          .optional()
+          .describe('Drag destination selector (alternative to destinationElementRef)'),
+        offsetX: z.number().optional().describe('Drag drop offset X (default: 0)'),
+        offsetY: z.number().optional().describe('Drag drop offset Y (default: 0)'),
+      },
+    },
+    handleInputTool
+  );
 
-  server.registerTool('browser_batch', {
-    title: 'Browser Bridge Batch',
-    description: 'Execute multiple bridge calls in parallel to reduce round-trips. Combine independent reads (e.g., styles + text + console) in one call. Preserves call order in the response.',
-    inputSchema: {
-      calls: z.array(z.object({
-        method: z.string().describe('Bridge method name (e.g. "dom.query", "page.get_text")'),
-        params: z.record(z.string(), z.unknown()).optional().describe('Method params for this call'),
+  server.registerTool(
+    'browser_patch',
+    {
+      title: 'Browser Patch',
+      description:
+        'Apply or rollback reversible style and DOM patches for live prototyping before editing source. Set verify=true to get computed results inline without a follow-up query.',
+      inputSchema: {
+        action: z
+          .enum(['apply_styles', 'apply_dom', 'list', 'rollback', 'commit_baseline'])
+          .describe('Patch operation to perform'),
         tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-        budgetPreset: z.enum(['quick', 'normal', 'deep']).optional().describe(BUDGET_PRESET_DESCRIPTION)
-      })).min(1).describe('Calls to execute in parallel')
-    }
-  }, handleBatchTool);
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        elementRef: z
+          .string()
+          .optional()
+          .describe('Target element reference (preferred over selector)'),
+        selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
+        declarations: z
+          .record(z.string(), z.string())
+          .optional()
+          .describe('CSS property: value pairs (for apply_styles)'),
+        important: z.boolean().optional().describe('Add !important flag (default: false)'),
+        operation: z
+          .enum([
+            'setAttribute',
+            'removeAttribute',
+            'addClass',
+            'removeClass',
+            'setTextContent',
+            'setProperty',
+          ])
+          .optional()
+          .describe('DOM mutation type'),
+        value: z.unknown().optional().describe('Value for the DOM operation'),
+        name: z.string().optional().describe('Attribute/class/property name (for apply_dom)'),
+        patchId: z.string().optional().describe('Patch ID to rollback (omit for most recent)'),
+        verify: z
+          .boolean()
+          .optional()
+          .describe(
+            'Return computed result inline after applying, eliminating a verification round-trip'
+          ),
+      },
+    },
+    handlePatchTool
+  );
 
-  server.registerTool('browser_call', {
-    title: 'Raw Browser Bridge Call',
-    description: 'Call any bridge method directly by name. Escape hatch when grouped tools lack a needed parameter or method.',
-    inputSchema: {
-      method: z.string().describe('Bridge method name (e.g., "dom.query", "input.click")'),
-      params: z.record(z.string(), z.unknown()).optional().describe('Method parameters as object'),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION)
-    }
-  }, handleRawCallTool);
+  server.registerTool(
+    'browser_capture',
+    {
+      title: 'Browser Capture',
+      description:
+        'Capture screenshots or CDP snapshots. Debugger-backed and token-expensive — use only when structured reads (browser_dom, browser_styles_layout) are insufficient. Prefer element, then tight region; full_page only for document-level context.',
+      inputSchema: {
+        action: z
+          .enum([
+            'element',
+            'region',
+            'full_page',
+            'cdp_document',
+            'cdp_dom_snapshot',
+            'cdp_box_model',
+            'cdp_computed_styles',
+          ])
+          .describe(
+            'element (preferred), region (tight crop), full_page (document-level only), or cdp_* for low-level data'
+          ),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        budgetPreset: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(BUDGET_PRESET_DESCRIPTION),
+        elementRef: z
+          .string()
+          .optional()
+          .describe('Element reference (for element action, preferred)'),
+        selector: z.string().optional().describe('CSS selector (used if no elementRef)'),
+        rect: z
+          .object({
+            x: z.number().describe('Region left edge (viewport pixels)'),
+            y: z.number().describe('Region top edge (viewport pixels)'),
+            width: z.number().describe('Region width (pixels)'),
+            height: z.number().describe('Region height (pixels)'),
+          })
+          .optional()
+          .describe('Viewport region for region action (keep crop tight)'),
+      },
+    },
+    handleCaptureTool
+  );
 
-  server.registerTool('browser_skill', {
-    title: 'Browser Bridge Runtime Context',
-    description: 'Return runtime context: budget presets, method groups, and active limits. Call to discover defaults before inspecting a page.',
-    inputSchema: {}
-  }, handleSkillTool);
+  server.registerTool(
+    'browser_batch',
+    {
+      title: 'Browser Bridge Batch',
+      description:
+        'Execute multiple bridge calls in parallel to reduce round-trips. Combine independent reads (e.g., styles + text + console) in one call. Preserves call order in the response.',
+      inputSchema: {
+        calls: z
+          .array(
+            z.object({
+              method: z.string().describe('Bridge method name (e.g. "dom.query", "page.get_text")'),
+              params: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Method params for this call'),
+              tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+              budgetPreset: z
+                .enum(['quick', 'normal', 'deep'])
+                .optional()
+                .describe(BUDGET_PRESET_DESCRIPTION),
+            })
+          )
+          .min(1)
+          .describe('Calls to execute in parallel'),
+      },
+    },
+    handleBatchTool
+  );
 
-  server.registerTool('browser_access', {
-    title: 'Request Browser Bridge Access',
-    description: 'Request window access for Browser Bridge. Surfaces an Enable prompt in the extension popup or side panel. Use once per window; if access is already pending, ask the user to enable that window instead of requesting again.',
-    inputSchema: {}
-  }, handleAccessTool);
+  server.registerTool(
+    'browser_call',
+    {
+      title: 'Raw Browser Bridge Call',
+      description:
+        'Call any bridge method directly by name. Escape hatch when grouped tools lack a needed parameter or method.',
+      inputSchema: {
+        method: z.string().describe('Bridge method name (e.g., "dom.query", "input.click")'),
+        params: z
+          .record(z.string(), z.unknown())
+          .optional()
+          .describe('Method parameters as object'),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+      },
+    },
+    handleRawCallTool
+  );
 
-  server.registerTool('browser_investigate', {
-    title: 'Browser Investigate',
-    description:
-      'Investigate a page to answer a question or verify a condition. ' +
-      'Pass a natural-language objective and an optional scope (quick/normal/deep). ' +
-      'DELEGATION HINT: Prefer delegating this to a smaller, low-cost subagent ' +
-      'that starts with structured reads via browser_dom, browser_page, ' +
-      'browser_styles_layout, and browser_batch. Escalate to browser_capture only ' +
-      'when structured reads are insufficient. ' +
-      'If subagent delegation is not available, a deterministic heuristic fallback ' +
-      'runs a scripted inspection sequence and returns a best-effort summary.',
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true,
+  server.registerTool(
+    'browser_skill',
+    {
+      title: 'Browser Bridge Runtime Context',
+      description:
+        'Return runtime context: budget presets, method groups, and active limits. Call to discover defaults before inspecting a page.',
+      inputSchema: {},
     },
-    _meta: {
-      delegationHint: INVESTIGATE_DELEGATION_HINT,
+    handleSkillTool
+  );
+
+  server.registerTool(
+    'browser_access',
+    {
+      title: 'Request Browser Bridge Access',
+      description:
+        'Request window access for Browser Bridge. Surfaces an Enable prompt in the extension popup or side panel. Use once per window; if access is already pending, ask the user to enable that window instead of requesting again.',
+      inputSchema: {},
     },
-    inputSchema: {
-      objective: z.string().describe(
-        'What to find, verify, or extract from the current page (natural language).'
-      ),
-      scope: z.enum(['quick', 'normal', 'deep']).optional().describe(
-        'Investigation depth: "quick" (page state + one DOM query), ' +
-        '"normal" (state + DOM + text, default), ' +
-        '"deep" (state + DOM + text + console + network).'
-      ),
-      tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
-      selector: z.string().optional().describe(
-        'Optional CSS selector to scope the investigation to a subtree.'
-      ),
+    handleAccessTool
+  );
+
+  server.registerTool(
+    'browser_investigate',
+    {
+      title: 'Browser Investigate',
+      description:
+        'Investigate a page to answer a question or verify a condition. ' +
+        'Pass a natural-language objective and an optional scope (quick/normal/deep). ' +
+        'DELEGATION HINT: Prefer delegating this to a smaller, low-cost subagent ' +
+        'that starts with structured reads via browser_dom, browser_page, ' +
+        'browser_styles_layout, and browser_batch. Escalate to browser_capture only ' +
+        'when structured reads are insufficient. ' +
+        'If subagent delegation is not available, a deterministic heuristic fallback ' +
+        'runs a scripted inspection sequence and returns a best-effort summary.',
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+      },
+      _meta: {
+        delegationHint: INVESTIGATE_DELEGATION_HINT,
+      },
+      inputSchema: {
+        objective: z
+          .string()
+          .describe('What to find, verify, or extract from the current page (natural language).'),
+        scope: z
+          .enum(['quick', 'normal', 'deep'])
+          .optional()
+          .describe(
+            'Investigation depth: "quick" (page state + one DOM query), ' +
+              '"normal" (state + DOM + text, default), ' +
+              '"deep" (state + DOM + text + console + network).'
+          ),
+        tabId: z.number().optional().describe(TAB_ID_DESCRIPTION),
+        selector: z
+          .string()
+          .optional()
+          .describe('Optional CSS selector to scope the investigation to a subtree.'),
+      },
     },
-  }, handleInvestigateTool);
+    handleInvestigateTool
+  );
 
   return server;
 }