chrometools-mcp 2.4.2 → 3.1.2

package/server/tool-schemas.js

@@ -1,296 +1,367 @@
-/**
- * server/tool-schemas.js
- *
- * Zod schemas for all MCP tools
- */
-
-import { z } from 'zod';
-
-// Basic tools
-export const PingSchema = z.object({
-  message: z.string().optional().describe("Optional message to send"),
-});
-
-export const OpenBrowserSchema = z.object({
-  url: z.string().describe("URL to open in the browser"),
-});
-
-export const ClickSchema = z.object({
-  selector: z.string().describe("CSS selector for element to click"),
-  waitAfter: z.number().optional().describe("Milliseconds to wait after click (default: 1500)"),
-  screenshot: z.boolean().optional().describe("Capture screenshot after click (default: false for performance)"),
-  timeout: z.number().optional().describe("Maximum time to wait for operation in ms (default: 30000)"),
-});
-
-export const TypeSchema = z.object({
-  selector: z.string().describe("CSS selector for input element"),
-  text: z.string().describe("Text to type"),
-  delay: z.number().optional().describe("Delay between keystrokes in ms (default: 0)"),
-  clearFirst: z.boolean().optional().describe("Clear field before typing (default: true)"),
-});
-
-export const GetElementSchema = z.object({
-  selector: z.string().optional().describe("CSS selector (optional, defaults to body)"),
-});
-
-export const HoverSchema = z.object({
-  selector: z.string().describe("CSS selector for element to hover"),
-});
-
-// CSS tools
-export const GetComputedCssSchema = z.object({
-  selector: z.string().optional().describe("CSS selector (optional, defaults to body)"),
-  category: z.enum(['all', 'layout', 'typography', 'colors', 'visual']).optional().describe("Filter by CSS category: 'layout' (sizing, positioning), 'typography' (fonts, text), 'colors' (color schemes), 'visual' (effects, transforms), 'all' (default)"),
-  properties: z.array(z.string()).optional().describe("Specific CSS properties to return (e.g., ['color', 'font-size']). Overrides category filter."),
-  includeDefaults: z.boolean().optional().describe("Include properties with default values (default: false)"),
-});
-
-export const GetBoxModelSchema = z.object({
-  selector: z.string().describe("CSS selector for element"),
-});
-
-export const SetStylesSchema = z.object({
-  selector: z.string().describe("CSS selector for element to modify"),
-  styles: z.array(z.object({
-    name: z.string().describe("CSS property name (e.g., 'color')"),
-    value: z.string().describe("CSS property value (e.g., 'red')")
-  })).describe("Array of CSS property name-value pairs"),
-});
-
-// Screenshot tools
-export const ScreenshotSchema = z.object({
-  selector: z.string().describe("CSS selector for element to screenshot"),
-  padding: z.number().optional().describe("Padding around element in pixels (default: 0)"),
-  maxWidth: z.number().nullable().optional().describe("Maximum width in pixels, auto-scales if larger (default: 1024, set to null for original size)"),
-  maxHeight: z.number().nullable().optional().describe("Maximum height in pixels, auto-scales if larger (default: 8000 for API limit, set to null for original size)"),
-  quality: z.number().min(1).max(100).optional().describe("JPEG quality 1-100 (default: 80, only applies to JPEG format)"),
-  format: z.enum(['png', 'jpeg', 'auto']).optional().describe("Image format: 'png', 'jpeg', or 'auto' (default: 'auto' - chooses based on size)"),
-});
-
-export const SaveScreenshotSchema = z.object({
-  selector: z.string().describe("CSS selector for element to screenshot"),
-  filePath: z.string().describe("Absolute path where to save file"),
-  padding: z.number().optional().describe("Padding around element in pixels (default: 0)"),
-  maxWidth: z.number().nullable().optional().describe("Maximum width in pixels, auto-scales if larger (default: 1024, set to null for original size)"),
-  maxHeight: z.number().nullable().optional().describe("Maximum height in pixels, auto-scales if larger (default: 8000 for API limit, set to null for original size)"),
-  quality: z.number().min(1).max(100).optional().describe("JPEG quality 1-100 (default: 80, only applies to JPEG format)"),
-  format: z.enum(['png', 'jpeg', 'auto']).optional().describe("Image format: 'png', 'jpeg', or 'auto' (default: 'auto' - chooses based on size)"),
-});
-
-// Navigation tools
-export const ScrollToSchema = z.object({
-  selector: z.string().describe("CSS selector for element to scroll to"),
-  behavior: z.enum(['auto', 'smooth']).optional().describe("Scroll behavior (default: auto)"),
-});
-
-export const WaitForElementSchema = z.object({
-  selector: z.string().describe("CSS selector to wait for"),
-  timeout: z.number().optional().describe("Maximum time to wait in milliseconds (default: 5000)"),
-  visible: z.boolean().optional().describe("Wait for element to be visible (default: true)"),
-});
-
-export const NavigateToSchema = z.object({
-  url: z.string().describe("URL to navigate to"),
-  waitUntil: z.enum(['load', 'domcontentloaded', 'networkidle0', 'networkidle2'])
-    .optional()
-    .describe("Wait until event (default: networkidle2)"),
-});
-
-export const SetViewportSchema = z.object({
-  width: z.number().min(320).max(4000).describe("Viewport width in pixels (320-4000)"),
-  height: z.number().min(200).max(3000).describe("Viewport height in pixels (200-3000)"),
-  deviceScaleFactor: z.number().min(0.5).max(3).optional().describe("Device pixel ratio (0.5-3, default: 1)"),
-});
-
-export const GetViewportSchema = z.object({});
-
-// Script execution
-export const ExecuteScriptSchema = z.object({
-  script: z.string().describe("JavaScript code to execute in page context"),
-  waitAfter: z.number().optional().describe("Milliseconds to wait after execution (default: 500)"),
-  screenshot: z.boolean().optional().describe("Capture screenshot after execution (default: false for performance)"),
-  timeout: z.number().optional().describe("Maximum time to wait for operation in ms (default: 30000)"),
-});
-
-// Network monitoring tools
-export const GetConsoleLogsSchema = z.object({
-  types: z.array(z.enum(['log', 'warn', 'error', 'info', 'debug', 'verbose', 'warning']))
-    .optional()
-    .describe("Filter by log types (default: all)"),
-  clear: z.boolean().optional().describe("Clear logs after reading (default: false)"),
-});
-
-export const ListNetworkRequestsSchema = z.object({
-  types: z.array(z.enum(['Document', 'Stylesheet', 'Image', 'Media', 'Font', 'Script', 'XHR', 'Fetch', 'WebSocket', 'Other']))
-    .optional()
-    .default(['Fetch', 'XHR'])
-    .describe("Filter by request types (default: Fetch, XHR)"),
-  status: z.enum(['pending', 'completed', 'failed', 'all'])
-    .optional()
-    .describe("Filter by status (default: all)"),
-  limit: z.number().min(1).max(500).optional().default(50).describe("Maximum number of requests to return (default: 50)"),
-  offset: z.number().min(0).optional().default(0).describe("Number of requests to skip before returning results (default: 0)"),
-  clear: z.boolean().optional().describe("Clear requests after reading (default: false)"),
-});
-
-export const GetNetworkRequestSchema = z.object({
-  requestId: z.string().describe("Request ID to get details for"),
-});
-
-export const FilterNetworkRequestsSchema = z.object({
-  urlPattern: z.string().describe("URL pattern to filter by (regex or partial match)"),
-  types: z.array(z.enum(['Document', 'Stylesheet', 'Image', 'Media', 'Font', 'Script', 'XHR', 'Fetch', 'WebSocket', 'Other']))
-    .optional()
-    .default(['Fetch', 'XHR'])
-    .describe("Filter by request types (default: Fetch, XHR)"),
-  clear: z.boolean().optional().describe("Clear requests after reading (default: false)"),
-});
-
-// Figma tools
-export const GetFigmaFrameSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key (from URL: figma.com/file/FILE_KEY/...)"),
-  nodeId: z.string().describe("Figma node ID (frame/component ID)"),
-  scale: z.number().min(0.1).max(4).optional().describe("Export scale (0.1-4, default: 2)"),
-  format: z.enum(['png', 'jpg', 'svg']).optional().describe("Export format (default: png)")
-});
-
-export const CompareFigmaToElementSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key"),
-  nodeId: z.string().describe("Figma frame/component ID"),
-  selector: z.string().describe("CSS selector for page element"),
-  threshold: z.number().min(0).max(1).optional().describe("Difference threshold (0-1, default: 0.05)"),
-  figmaScale: z.number().min(0.1).max(4).optional().describe("Figma export scale (default: 2)")
-});
-
-export const GetFigmaSpecsSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key"),
-  nodeId: z.string().describe("Figma frame/component ID")
-});
-
-export const ParseFigmaUrlSchema = z.object({
-  url: z.string().describe("Full Figma URL or fileKey")
-});
-
-export const ListFigmaPagesSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key or full Figma URL")
-});
-
-export const SearchFigmaFramesSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key or full Figma URL"),
-  searchQuery: z.string().describe("Search query")
-});
-
-export const GetFigmaComponentsSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key or full Figma URL")
-});
-
-export const GetFigmaStylesSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key or full Figma URL")
-});
-
-export const GetFigmaColorPaletteSchema = z.object({
-  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
-  fileKey: z.string().describe("Figma file key or full Figma URL")
-});
-
-// Page analysis tools
-export const SmartFindElementSchema = z.object({
-  description: z.string().describe("Natural language description of element to find (e.g., 'login button', 'email field')"),
-  maxResults: z.number().min(1).max(20).optional().describe("Maximum number of candidates to return (default: 5)"),
-  action: z.object({
-    type: z.enum(['click', 'type', 'scrollTo', 'screenshot', 'hover', 'setStyles']).describe("Action to perform on the best match"),
-    text: z.string().optional().describe("Text to type (required for 'type' action)"),
-    styles: z.array(z.object({
-      name: z.string(),
-      value: z.string()
-    })).optional().describe("Styles to apply (required for 'setStyles' action)"),
-    screenshot: z.boolean().optional().describe("Capture screenshot after action (default: false)"),
-    waitAfter: z.number().optional().describe("Wait time in ms after action"),
-  }).optional().describe("Optional action to perform on the best matching element"),
-});
-
-export const AnalyzePageSchema = z.object({
-  refresh: z.boolean().optional().describe("Force refresh of cached analysis (default: false)"),
-  includeAll: z.boolean().optional().describe("Include all elements on page, not just interactive ones (default: false). Useful for layout work and finding non-interactive elements to style."),
-});
-
-export const GetAllInteractiveElementsSchema = z.object({
-  includeHidden: z.boolean().optional().describe("Include hidden elements (default: false)"),
-});
-
-export const FindElementsByTextSchema = z.object({
-  text: z.string().describe("Text to search for in elements"),
-  exact: z.boolean().optional().describe("Exact match only (default: false)"),
-  caseSensitive: z.boolean().optional().describe("Case sensitive search (default: false)"),
-  action: z.object({
-    type: z.enum(['click', 'type', 'scrollTo', 'screenshot', 'hover', 'setStyles']).describe("Action to perform on the first match"),
-    text: z.string().optional().describe("Text to type (required for 'type' action)"),
-    styles: z.array(z.object({
-      name: z.string(),
-      value: z.string()
-    })).optional().describe("Styles to apply (required for 'setStyles' action)"),
-    screenshot: z.boolean().optional().describe("Capture screenshot after action (default: false)"),
-    waitAfter: z.number().optional().describe("Wait time in ms after action"),
-  }).optional().describe("Optional action to perform on the first matching element"),
-});
-
-// Recorder tools (schemas created from inline definitions)
-export const EnableRecorderSchema = z.object({
-  directory: z.string().optional().describe("Directory to save scenarios (optional, defaults to auto-detected project root)")
-});
-
-export const ExecuteScenarioSchema = z.object({
-  name: z.string().describe("Scenario name"),
-  projectId: z.string().optional().describe("Optional: Project ID (domain) to disambiguate scenarios with same name"),
-  parameters: z.record(z.any()).optional().describe("Execution parameters"),
-  executeDependencies: z.boolean().optional().describe("Execute dependencies (default: true)")
-});
-
-export const ListScenariosSchema = z.object({
-  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
-});
-
-export const SearchScenariosSchema = z.object({
-  text: z.string().optional().describe("Search text"),
-  tags: z.array(z.string()).optional().describe("Filter tags"),
-  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
-});
-
-export const GetScenarioInfoSchema = z.object({
-  name: z.string().describe("Scenario name"),
-  includeSecrets: z.boolean().optional().describe("Include secrets (default: false)"),
-  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
-});
-
-export const DeleteScenarioSchema = z.object({
-  name: z.string().describe("Scenario name"),
-  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
-});
-
-export const ExportScenarioAsCodeSchema = z.object({
-  scenarioName: z.string().describe("Name of scenario to export"),
-  language: z.enum(['playwright-typescript', 'playwright-python', 'selenium-python', 'selenium-java']).describe("Target test framework and language"),
-  cleanSelectors: z.boolean().optional().describe("Remove unstable CSS classes (default: true)"),
-  includeComments: z.boolean().optional().describe("Include descriptive comments (default: true)"),
-  generatePageObject: z.boolean().optional().describe("Also generate Page Object class for the page (default: false)"),
-  pageObjectClassName: z.string().optional().describe("Page Object class name (optional, auto-generated if not provided)"),
-  directory: z.string().optional().describe("Directory where scenarios are stored (optional)"),
-  appendToFile: z.string().optional().describe("Path to existing test file to append to (enables append mode)"),
-  testName: z.string().optional().describe("Override test name (default: from scenario name)"),
-  insertPosition: z.enum(['end', 'before', 'after']).optional().describe("Where to insert test: 'end' (default), 'before', or 'after' a reference test"),
-  referenceTestName: z.string().optional().describe("Reference test name for 'before'/'after' insertion")
-});
-
-export const GeneratePageObjectSchema = z.object({
-  className: z.string().optional().describe("Page Object class name (optional, auto-generated from page title/URL if not provided)"),
-  framework: z.enum(['playwright-typescript', 'playwright-python', 'selenium-python', 'selenium-java']).optional().describe("Target test framework (default: playwright-typescript)"),
-  includeComments: z.boolean().optional().describe("Include descriptive comments in generated code (default: true)"),
-  groupElements: z.boolean().optional().describe("Group elements by page sections (default: true)")
-});
+/**
+ * server/tool-schemas.js
+ *
+ * Zod schemas for all MCP tools
+ */
+
+import { z } from 'zod';
+
+// Basic tools
+export const PingSchema = z.object({
+  message: z.string().optional().describe("Optional message to send"),
+});
+
+export const OpenBrowserSchema = z.object({
+  url: z.string().describe("URL to open in the browser"),
+});
+
+export const ClickSchema = z.object({
+  id: z.string().optional().describe("APOM element ID from analyzePage (e.g., 'button_45', 'link_7'). Mutually exclusive with selector."),
+  selector: z.string().optional().describe("CSS selector for element to click. Mutually exclusive with id."),
+  waitAfter: z.number().optional().describe("Milliseconds to wait after click (default: 1500)"),
+  screenshot: z.boolean().optional().describe("Capture screenshot after click (default: false for performance)"),
+  timeout: z.number().optional().describe("Maximum time to wait for operation in ms (default: 30000)"),
+}).refine(data => (data.id && !data.selector) || (!data.id && data.selector), {
+  message: "Either 'id' or 'selector' must be provided, but not both"
+});
+
+export const TypeSchema = z.object({
+  id: z.string().optional().describe("APOM element ID from analyzePage (e.g., 'input_20', 'input_33'). Mutually exclusive with selector."),
+  selector: z.string().optional().describe("CSS selector for input element. Mutually exclusive with id."),
+  text: z.string().describe("Text to type"),
+  delay: z.number().optional().describe("Delay between keystrokes in ms (default: 0)"),
+  clearFirst: z.boolean().optional().describe("Clear field before typing (default: true)"),
+}).refine(data => (data.id && !data.selector) || (!data.id && data.selector), {
+  message: "Either 'id' or 'selector' must be provided, but not both"
+});
+
+export const GetElementSchema = z.object({
+  selector: z.string().optional().describe("CSS selector (optional, defaults to body)"),
+});
+
+export const HoverSchema = z.object({
+  id: z.string().optional().describe("APOM element ID from analyzePage. Mutually exclusive with selector."),
+  selector: z.string().optional().describe("CSS selector for element to hover. Mutually exclusive with id."),
+}).refine(data => (data.id && !data.selector) || (!data.id && data.selector), {
+  message: "Either 'id' or 'selector' must be provided, but not both"
+});
+
+export const SelectOptionSchema = z.object({
+  id: z.string().optional().describe("APOM element ID from analyzePage for select element. Mutually exclusive with selector."),
+  selector: z.string().optional().describe("CSS selector for select element. Mutually exclusive with id."),
+  value: z.string().optional().describe("Value of option to select (option's value attribute)"),
+  text: z.string().optional().describe("Text content of option to select"),
+  index: z.number().min(0).optional().describe("Index of option to select (0-based)"),
+}).refine(data => (data.id && !data.selector) || (!data.id && data.selector), {
+  message: "Either 'id' or 'selector' must be provided, but not both"
+});
+
+export const DragSchema = z.object({
+  selector: z.string().describe("CSS selector for element to drag"),
+  direction: z.enum(['up', 'down', 'left', 'right', 'up-left', 'up-right', 'down-left', 'down-right'])
+    .describe("Direction to drag: vertical (up, down), horizontal (left, right), or diagonal (up-left, up-right, down-left, down-right)"),
+  distance: z.number().min(1).optional().describe("Distance to drag in pixels (default: 100)"),
+  duration: z.number().min(100).optional().describe("Duration of drag operation in milliseconds (default: 500)"),
+});
+
+export const ScrollHorizontalSchema = z.object({
+  selector: z.string().describe("CSS selector for element to scroll"),
+  direction: z.enum(['left', 'right']).describe("Direction to scroll horizontally"),
+  amount: z.union([z.number().min(1), z.literal('full')]).describe("Amount to scroll in pixels, or 'full' to scroll to the end"),
+  behavior: z.enum(['auto', 'smooth']).optional().describe("Scroll behavior (default: auto)"),
+});
+
+// CSS tools
+export const GetComputedCssSchema = z.object({
+  selector: z.string().optional().describe("CSS selector (optional, defaults to body)"),
+  category: z.enum(['all', 'layout', 'typography', 'colors', 'visual']).optional().describe("Filter by CSS category: 'layout' (sizing, positioning), 'typography' (fonts, text), 'colors' (color schemes), 'visual' (effects, transforms), 'all' (default)"),
+  properties: z.array(z.string()).optional().describe("Specific CSS properties to return (e.g., ['color', 'font-size']). Overrides category filter."),
+  includeDefaults: z.boolean().optional().describe("Include properties with default values (default: false)"),
+});
+
+export const GetBoxModelSchema = z.object({
+  selector: z.string().describe("CSS selector for element"),
+});
+
+export const SetStylesSchema = z.object({
+  selector: z.string().describe("CSS selector for element to modify"),
+  styles: z.array(z.object({
+    name: z.string().describe("CSS property name (e.g., 'color')"),
+    value: z.string().describe("CSS property value (e.g., 'red')")
+  })).describe("Array of CSS property name-value pairs"),
+});
+
+// Screenshot tools
+export const ScreenshotSchema = z.object({
+  selector: z.string().describe("CSS selector for element to screenshot"),
+  padding: z.number().optional().describe("Padding around element in pixels (default: 0)"),
+  maxWidth: z.number().nullable().optional().describe("Maximum width in pixels, auto-scales if larger (default: 1024, set to null for original size)"),
+  maxHeight: z.number().nullable().optional().describe("Maximum height in pixels, auto-scales if larger (default: 8000 for API limit, set to null for original size)"),
+  quality: z.number().min(1).max(100).optional().describe("JPEG quality 1-100 (default: 80, only applies to JPEG format)"),
+  format: z.enum(['png', 'jpeg', 'auto']).optional().describe("Image format: 'png', 'jpeg', or 'auto' (default: 'auto' - chooses based on size)"),
+});
+
+export const SaveScreenshotSchema = z.object({
+  selector: z.string().describe("CSS selector for element to screenshot"),
+  filePath: z.string().describe("Absolute path where to save file"),
+  padding: z.number().optional().describe("Padding around element in pixels (default: 0)"),
+  maxWidth: z.number().nullable().optional().describe("Maximum width in pixels, auto-scales if larger (default: 1024, set to null for original size)"),
+  maxHeight: z.number().nullable().optional().describe("Maximum height in pixels, auto-scales if larger (default: 8000 for API limit, set to null for original size)"),
+  quality: z.number().min(1).max(100).optional().describe("JPEG quality 1-100 (default: 80, only applies to JPEG format)"),
+  format: z.enum(['png', 'jpeg', 'auto']).optional().describe("Image format: 'png', 'jpeg', or 'auto' (default: 'auto' - chooses based on size)"),
+});
+
+// Navigation tools
+export const ScrollToSchema = z.object({
+  selector: z.string().describe("CSS selector for element to scroll to"),
+  behavior: z.enum(['auto', 'smooth']).optional().describe("Scroll behavior (default: auto)"),
+});
+
+export const WaitForElementSchema = z.object({
+  selector: z.string().describe("CSS selector to wait for"),
+  timeout: z.number().optional().describe("Maximum time to wait in milliseconds (default: 5000)"),
+  visible: z.boolean().optional().describe("Wait for element to be visible (default: true)"),
+});
+
+export const NavigateToSchema = z.object({
+  url: z.string().describe("URL to navigate to"),
+  waitUntil: z.enum(['load', 'domcontentloaded', 'networkidle0', 'networkidle2'])
+    .optional()
+    .describe("Wait until event (default: networkidle2)"),
+});
+
+export const SetViewportSchema = z.object({
+  width: z.number().min(320).max(4000).describe("Viewport width in pixels (320-4000)"),
+  height: z.number().min(200).max(3000).describe("Viewport height in pixels (200-3000)"),
+  deviceScaleFactor: z.number().min(0.5).max(3).optional().describe("Device pixel ratio (0.5-3, default: 1)"),
+});
+
+export const GetViewportSchema = z.object({});
+
+// Script execution
+export const ExecuteScriptSchema = z.object({
+  script: z.string().describe("JavaScript code to execute in page context"),
+  waitAfter: z.number().optional().describe("Milliseconds to wait after execution (default: 500)"),
+  screenshot: z.boolean().optional().describe("Capture screenshot after execution (default: false for performance)"),
+  timeout: z.number().optional().describe("Maximum time to wait for operation in ms (default: 30000)"),
+});
+
+// Network monitoring tools
+export const GetConsoleLogsSchema = z.object({
+  types: z.array(z.enum(['log', 'warn', 'error', 'info', 'debug', 'verbose', 'warning']))
+    .optional()
+    .describe("Filter by log types (default: all)"),
+  clear: z.boolean().optional().describe("Clear logs after reading (default: false)"),
+});
+
+export const ListNetworkRequestsSchema = z.object({
+  types: z.array(z.enum(['Document', 'Stylesheet', 'Image', 'Media', 'Font', 'Script', 'XHR', 'Fetch', 'WebSocket', 'Other']))
+    .optional()
+    .default(['Fetch', 'XHR'])
+    .describe("Filter by request types (default: Fetch, XHR)"),
+  status: z.enum(['pending', 'completed', 'failed', 'all'])
+    .optional()
+    .describe("Filter by status (default: all)"),
+  limit: z.number().min(1).max(500).optional().default(50).describe("Maximum number of requests to return (default: 50)"),
+  offset: z.number().min(0).optional().default(0).describe("Number of requests to skip before returning results (default: 0)"),
+  clear: z.boolean().optional().describe("Clear requests after reading (default: false)"),
+});
+
+export const GetNetworkRequestSchema = z.object({
+  requestId: z.string().describe("Request ID to get details for"),
+});
+
+export const FilterNetworkRequestsSchema = z.object({
+  urlPattern: z.string().describe("URL pattern to filter by (regex or partial match)"),
+  types: z.array(z.enum(['Document', 'Stylesheet', 'Image', 'Media', 'Font', 'Script', 'XHR', 'Fetch', 'WebSocket', 'Other']))
+    .optional()
+    .default(['Fetch', 'XHR'])
+    .describe("Filter by request types (default: Fetch, XHR)"),
+  clear: z.boolean().optional().describe("Clear requests after reading (default: false)"),
+});
+
+// Figma tools
+export const GetFigmaFrameSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key (from URL: figma.com/file/FILE_KEY/...)"),
+  nodeId: z.string().describe("Figma node ID (frame/component ID)"),
+  scale: z.number().min(0.1).max(4).optional().describe("Export scale (0.1-4, default: 2)"),
+  format: z.enum(['png', 'jpg', 'svg']).optional().describe("Export format (default: png)")
+});
+
+export const CompareFigmaToElementSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key"),
+  nodeId: z.string().describe("Figma frame/component ID"),
+  selector: z.string().describe("CSS selector for page element"),
+  threshold: z.number().min(0).max(1).optional().describe("Difference threshold (0-1, default: 0.05)"),
+  figmaScale: z.number().min(0.1).max(4).optional().describe("Figma export scale (default: 2)")
+});
+
+export const GetFigmaSpecsSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key"),
+  nodeId: z.string().describe("Figma frame/component ID")
+});
+
+export const ParseFigmaUrlSchema = z.object({
+  url: z.string().describe("Full Figma URL or fileKey")
+});
+
+export const ListFigmaPagesSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key or full Figma URL")
+});
+
+export const SearchFigmaFramesSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key or full Figma URL"),
+  searchQuery: z.string().describe("Search query")
+});
+
+export const GetFigmaComponentsSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key or full Figma URL")
+});
+
+export const GetFigmaStylesSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key or full Figma URL")
+});
+
+export const GetFigmaColorPaletteSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key or full Figma URL")
+});
+
+export const ConvertFigmaToCodeSchema = z.object({
+  figmaToken: z.string().optional().describe("Figma API token (optional if FIGMA_TOKEN env var is set)"),
+  fileKey: z.string().describe("Figma file key (from URL: figma.com/file/FILE_KEY/...)"),
+  nodeId: z.string().describe("Figma node ID (frame/component ID, formats: '123:456' or '123-456')"),
+  framework: z.enum(['react', 'react-typescript', 'html']).optional().describe("Target framework (default: react)"),
+  includeComments: z.boolean().optional().describe("Include descriptive comments in generated code (default: true)")
+});
+
+// Page analysis tools
+export const SmartFindElementSchema = z.object({
+  description: z.string().describe("Natural language description of element to find (e.g., 'login button', 'email field')"),
+  maxResults: z.number().min(1).max(20).optional().describe("Maximum number of candidates to return (default: 5)"),
+  action: z.object({
+    type: z.enum(['click', 'type', 'scrollTo', 'screenshot', 'hover', 'setStyles']).describe("Action to perform on the best match"),
+    text: z.string().optional().describe("Text to type (required for 'type' action)"),
+    styles: z.array(z.object({
+      name: z.string(),
+      value: z.string()
+    })).optional().describe("Styles to apply (required for 'setStyles' action)"),
+    screenshot: z.boolean().optional().describe("Capture screenshot after action (default: false)"),
+    waitAfter: z.number().optional().describe("Wait time in ms after action"),
+  }).optional().describe("Optional action to perform on the best matching element"),
+});
+
+export const AnalyzePageSchema = z.object({
+  refresh: z.boolean().optional().describe("Force refresh of cached analysis (default: false)"),
+  includeAll: z.boolean().optional().describe("Include all elements on page, not just interactive ones (default: false). Useful for layout work and finding non-interactive elements to style."),
+  useLegacyFormat: z.boolean().optional().describe("Return legacy format instead of APOM (default: false - APOM is now the default format)"),
+  registerElements: z.boolean().optional().describe("Automatically register elements in selector resolver (default: true)"),
+  groupBy: z.enum(['type', 'flat']).optional().describe("Group elements by type or return flat structure (default: 'type')"),
+});
+
+export const GetElementByApomIdSchema = z.object({
+  id: z.string().describe("APOM element ID (e.g., 'input_20', 'button_45') from analyzePage result"),
+});
+
+export const GetAllInteractiveElementsSchema = z.object({
+  includeHidden: z.boolean().optional().describe("Include hidden elements (default: false)"),
+});
+
+export const FindElementsByTextSchema = z.object({
+  text: z.string().describe("Text to search for in elements"),
+  exact: z.boolean().optional().describe("Exact match only (default: false)"),
+  caseSensitive: z.boolean().optional().describe("Case sensitive search (default: false)"),
+  action: z.object({
+    type: z.enum(['click', 'type', 'scrollTo', 'screenshot', 'hover', 'setStyles']).describe("Action to perform on the first match"),
+    text: z.string().optional().describe("Text to type (required for 'type' action)"),
+    styles: z.array(z.object({
+      name: z.string(),
+      value: z.string()
+    })).optional().describe("Styles to apply (required for 'setStyles' action)"),
+    screenshot: z.boolean().optional().describe("Capture screenshot after action (default: false)"),
+    waitAfter: z.number().optional().describe("Wait time in ms after action"),
+  }).optional().describe("Optional action to perform on the first matching element"),
+});
+
+// Group selection tools
+export const SelectFromGroupSchema = z.object({
+  name: z.string().describe("Name attribute of the radio/checkbox group"),
+  value: z.string().optional().describe("Single value to select (for radio or single checkbox)"),
+  values: z.array(z.string()).optional().describe("Multiple values to select (for checkbox group)"),
+  text: z.string().optional().describe("Label text to match (alternative to value)"),
+  texts: z.array(z.string()).optional().describe("Multiple label texts to match (for checkbox group)"),
+  mode: z.enum(['set', 'add', 'remove', 'toggle']).optional().describe("For checkboxes: 'set' (replace), 'add', 'remove', 'toggle' (default: 'set')"),
+  by: z.enum(['value', 'text', 'auto']).optional().describe("Match by value, text, or auto-detect (default: 'auto')"),
+});
+
+// Recorder tools (schemas created from inline definitions)
+export const EnableRecorderSchema = z.object({
+  directory: z.string().optional().describe("Directory to save scenarios (optional, defaults to auto-detected project root)")
+});
+
+export const ExecuteScenarioSchema = z.object({
+  name: z.string().describe("Scenario name"),
+  projectId: z.string().optional().describe("Optional: Project ID (domain) to disambiguate scenarios with same name"),
+  parameters: z.record(z.any()).optional().describe("Execution parameters"),
+  executeDependencies: z.boolean().optional().describe("Execute dependencies (default: true)")
+});
+
+export const ListScenariosSchema = z.object({
+  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
+});
+
+export const SearchScenariosSchema = z.object({
+  text: z.string().optional().describe("Search text"),
+  tags: z.array(z.string()).optional().describe("Filter tags"),
+  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
+});
+
+export const GetScenarioInfoSchema = z.object({
+  name: z.string().describe("Scenario name"),
+  includeSecrets: z.boolean().optional().describe("Include secrets (default: false)"),
+  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
+});
+
+export const DeleteScenarioSchema = z.object({
+  name: z.string().describe("Scenario name"),
+  directory: z.string().optional().describe("Directory where scenarios are stored (optional)")
+});
+
+export const ExportScenarioAsCodeSchema = z.object({
+  scenarioName: z.string().describe("Name of scenario to export"),
+  language: z.enum(['playwright-typescript', 'playwright-python', 'selenium-python', 'selenium-java']).describe("Target test framework and language"),
+  cleanSelectors: z.boolean().optional().describe("Remove unstable CSS classes (default: true)"),
+  includeComments: z.boolean().optional().describe("Include descriptive comments (default: true)"),
+  generatePageObject: z.boolean().optional().describe("Also generate Page Object class for the page (default: false)"),
+  pageObjectClassName: z.string().optional().describe("Page Object class name (optional, auto-generated if not provided)"),
+  directory: z.string().optional().describe("Directory where scenarios are stored (optional)"),
+  appendToFile: z.string().optional().describe("Path to existing test file to append to (enables append mode)"),
+  testName: z.string().optional().describe("Override test name (default: from scenario name)"),
+  insertPosition: z.enum(['end', 'before', 'after']).optional().describe("Where to insert test: 'end' (default), 'before', or 'after' a reference test"),
+  referenceTestName: z.string().optional().describe("Reference test name for 'before'/'after' insertion")
+});
+
+export const GeneratePageObjectSchema = z.object({
+  className: z.string().optional().describe("Page Object class name (optional, auto-generated from page title/URL if not provided)"),
+  framework: z.enum(['playwright-typescript', 'playwright-python', 'selenium-python', 'selenium-java']).optional().describe("Target test framework (default: playwright-typescript)"),
+  includeComments: z.boolean().optional().describe("Include descriptive comments in generated code (default: true)"),
+  groupElements: z.boolean().optional().describe("Group elements by page sections (default: true)")
+});
+
+// Tab management tools
+export const ListTabsSchema = z.object({});
+
+export const SwitchTabSchema = z.object({
+  tab: z.union([
+    z.number().min(0).describe("Tab index (0-based)"),
+    z.string().describe("URL pattern to match (partial match)")
+  ]).describe("Tab identifier: index number or URL pattern to match"),
+});
+