@probebrowser/mcp-server 1.2.0

package/dist/tools.js

@@ -0,0 +1,761 @@
+import { z } from 'zod';
+export const TOOLS = {
+    // ============================================
+    // CONSOLE & ERRORS (6)
+    // ============================================
+    trace_get_console_summary: {
+        method: 'get_console_summary',
+        description: 'Get a summary of console logs by type (info, warn, error) and confidence.',
+        schema: z.object({}),
+    },
+    trace_get_console_errors: {
+        method: 'get_console_errors',
+        description: 'Get all console errors from the current page. Useful for debugging crashes and JS exceptions.',
+        schema: z.object({}),
+    },
+    trace_get_error_groups: {
+        method: 'get_error_groups',
+        description: 'Get errors grouped by message/stack to reduce noise.',
+        schema: z.object({}),
+    },
+    trace_get_grouped_exceptions: {
+        method: 'get_grouped_exceptions',
+        description: 'Get grouped exceptions with occurrence counts.',
+        schema: z.object({}),
+    },
+    trace_suggest_fix: {
+        method: 'suggest_fix',
+        description: 'Get AI-powered code fix suggestions for specific errors.',
+        schema: z.object({}),
+    },
+    trace_explain_call_stack: {
+        method: 'explain_call_stack',
+        description: 'Get AI explanation of the stack trace logic.',
+        schema: z.object({}),
+    },
+    // ============================================
+    // NETWORK TOOLS (10)
+    // ============================================
+    trace_get_network_summary: {
+        method: 'get_network_summary',
+        description: 'Get a summary of network activity (total requests, failed, size, finish time).',
+        schema: z.object({}),
+    },
+    trace_get_network_failed: {
+        method: 'get_network_failed',
+        description: 'Get a list of all failed network requests (4xx, 5xx, or connection errors).',
+        schema: z.object({}),
+    },
+    trace_get_request_headers: {
+        method: 'get_request_headers',
+        description: 'Inspect raw headers for a specific request ID.',
+        schema: z.object({
+            requestId: z.string().describe('The ID of the request'),
+        }),
+    },
+    trace_get_response_body: {
+        method: 'get_response_body',
+        description: 'Read the body content of a response.',
+        schema: z.object({
+            requestId: z.string().describe('The ID of the request'),
+        }),
+    },
+    trace_get_cached_requests: {
+        method: 'get_cached_requests',
+        description: 'List requests served from browser cache.',
+        schema: z.object({}),
+    },
+    trace_get_timing_breakdown: {
+        method: 'get_timing_breakdown',
+        description: 'Detailed timing (DNS, SSL, TTFB, Content Download).',
+        schema: z.object({
+            requestId: z.string().describe('The ID of the request'),
+        }),
+    },
+    trace_filter_requests_by_type: {
+        method: 'filter_requests_by_type',
+        description: 'Filter by XHR, Fetch, Image, CSS, JS.',
+        schema: z.object({
+            type: z.string().describe('The resource type (XHR, Script, Image, etc.)'),
+        }),
+    },
+    trace_search_in_responses: {
+        method: 'search_in_responses',
+        description: 'Text search across all response bodies.',
+        schema: z.object({
+            pattern: z.string().describe('The text or regex to search for'),
+        }),
+    },
+    trace_get_redirect_chain: {
+        method: 'get_redirect_chain',
+        description: 'Trace HTTP redirect paths.',
+        schema: z.object({
+            requestId: z.string().describe('The ID of the request'),
+        }),
+    },
+    trace_replay_request: {
+        method: 'replay_request',
+        description: 'Replay a specific network request by ID to test if it fails again.',
+        schema: z.object({
+            requestId: z.string().describe('The ID of the request to replay'),
+        }),
+    },
+    // ============================================
+    // DOM & UI TOOLS (16)
+    // ============================================
+    trace_inspect_element: {
+        method: 'inspect_element',
+        description: 'Inspect a DOM element by selector (visibility, size, attributes).',
+        schema: z.object({
+            selector: z.string().describe('CSS selector of the element to inspect'),
+        }),
+    },
+    trace_find_elements: {
+        method: 'find_elements',
+        description: 'Search DOM by CSS selector.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_get_element_styles: {
+        method: 'get_element_styles',
+        description: 'Get full computed style object.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_get_dom_tree: {
+        method: 'get_dom_tree',
+        description: 'Get a simplified tree structure of the page.',
+        schema: z.object({
+            depth: z.number().optional().describe('Depth of tree to retrieve (default 3)'),
+        }),
+    },
+    trace_get_element_events: {
+        method: 'get_element_events',
+        description: 'List event listeners attached to a node.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_edit_element_style: {
+        method: 'edit_element_style',
+        description: 'Apply CSS changes to an element live.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+            property: z.string().describe('CSS property name'),
+            value: z.string().describe('CSS property value'),
+        }),
+    },
+    trace_watch_dom_changes: {
+        method: 'watch_dom_changes',
+        description: 'Monitor mutations (sub-tree modifications).',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_diagnose_layout: {
+        method: 'diagnose_layout',
+        description: 'AI analysis of layout shifts or breaking elements.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_analyze_visibility: {
+        method: 'analyze_visibility',
+        description: 'Deep visibility audit (opacity, display, overlap).',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_why_hidden: {
+        method: 'why_hidden',
+        description: 'Alias for analyze_visibility.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_style_summary: {
+        method: 'style_summary',
+        description: 'Aggregate style report.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_css_influence: {
+        method: 'css_influence',
+        description: 'See which selectors match and which win.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_check_accessibility: {
+        method: 'check_accessibility',
+        description: 'Check the page for accessibility issues (missing alt text, low contrast).',
+        schema: z.object({
+            selector: z.string().optional().describe('Optional selector to limit check'),
+        }),
+    },
+    trace_highlight_element: {
+        method: 'highlight_element',
+        description: 'Visually highlight an element on the screen.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_scroll_to_element: {
+        method: 'scroll_to_element',
+        description: 'Scroll viewport to element.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    // ============================================
+    // DEBUGGER TOOLS (24)
+    // ============================================
+    trace_get_debugger_state: {
+        method: 'get_debugger_state',
+        description: 'Is the debugger paused? On what line?',
+        schema: z.object({}),
+    },
+    trace_get_call_stack: {
+        method: 'get_call_stack',
+        description: 'Current execution stack frames.',
+        schema: z.object({}),
+    },
+    trace_get_variables: {
+        method: 'get_variables',
+        description: 'Scope variables (Local, Closure, Global).',
+        schema: z.object({
+            frameIndex: z.number().optional().describe('Stack frame index (default 0)'),
+        }),
+    },
+    trace_step_debugger: {
+        method: 'step_debugger',
+        description: 'Step Over/Into/Out control.',
+        schema: z.object({
+            action: z.enum(['over', 'into', 'out', 'resume', 'pause']).describe('Action to perform'),
+        }),
+    },
+    trace_set_breakpoint: {
+        method: 'set_breakpoint',
+        description: 'Pause on specific file/line.',
+        schema: z.object({
+            url: z.string().describe('File URL'),
+            line: z.number().describe('Line number (0-indexed)'),
+            condition: z.string().optional().describe('Optional JS condition'),
+        }),
+    },
+    trace_remove_breakpoint: {
+        method: 'remove_breakpoint',
+        description: 'Clear breakpoint.',
+        schema: z.object({
+            breakpointId: z.string().describe('ID of breakpoint to remove'),
+        }),
+    },
+    trace_evaluate_expression: {
+        method: 'evaluate_expression',
+        description: 'Run Arbitrary JS in context.',
+        schema: z.object({
+            expression: z.string().describe('JS code to evaluate'),
+        }),
+    },
+    trace_set_exception_breakpoint: {
+        method: 'set_exception_breakpoint',
+        description: 'Pause on All or Uncaught exceptions.',
+        schema: z.object({
+            state: z.enum(['all', 'uncaught', 'none']).describe('Exception pause state'),
+        }),
+    },
+    trace_set_logpoint: {
+        method: 'set_logpoint',
+        description: 'console.log without changing code.',
+        schema: z.object({
+            url: z.string().describe('File URL'),
+            line: z.number().describe('Line number'),
+            expression: z.string().describe('Expression to log'),
+        }),
+    },
+    trace_get_logpoints: {
+        method: 'get_logpoints',
+        description: 'List active logpoints.',
+        schema: z.object({}),
+    },
+    trace_add_watch: {
+        method: 'add_watch',
+        description: 'Monitor expression value over time.',
+        schema: z.object({
+            expression: z.string().describe('Expression to watch'),
+        }),
+    },
+    trace_remove_watch: {
+        method: 'remove_watch',
+        description: 'Stop monitoring.',
+        schema: z.object({
+            expression: z.string().describe('Expression to remove'),
+        }),
+    },
+    trace_get_watches: {
+        method: 'get_watches',
+        description: 'Get current values of watched expressions.',
+        schema: z.object({}),
+    },
+    trace_watch_for_changes: {
+        method: 'watch_for_changes',
+        description: 'Pause when a variable value changes.',
+        schema: z.object({
+            expression: z.string().describe('Expression to watch'),
+        }),
+    },
+    trace_check_changes: {
+        method: 'check_changes',
+        description: 'Verify if watched variables changed.',
+        schema: z.object({}),
+    },
+    trace_trace_variable_origin: {
+        method: 'trace_variable_origin',
+        description: 'Attempt to find where a variable was defined.',
+        schema: z.object({
+            variable: z.string().describe('Variable name'),
+        }),
+    },
+    trace_capture_execution_state: {
+        method: 'capture_execution_state',
+        description: 'Snapshot of current state.',
+        schema: z.object({}),
+    },
+    trace_get_execution_history: {
+        method: 'get_execution_history',
+        description: 'Reverse debugging/step-back data (if enabled).',
+        schema: z.object({}),
+    },
+    trace_pause_execution: {
+        method: 'pause_execution',
+        description: 'Force pause.',
+        schema: z.object({}),
+    },
+    trace_resume_execution: {
+        method: 'resume_execution',
+        description: 'Continue execution.',
+        schema: z.object({}),
+    },
+    trace_set_dom_breakpoint: {
+        method: 'set_dom_breakpoint_by_selector',
+        description: 'Break on node modification.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+            type: z.enum(['subtree-modified', 'attribute-modified', 'node-removed']).describe('Breakpoint type'),
+        }),
+    },
+    trace_set_event_breakpoint: {
+        method: 'set_event_breakpoint',
+        description: 'Break on events (click, submit, etc).',
+        schema: z.object({
+            eventName: z.string().describe('Event name'),
+        }),
+    },
+    trace_inspect_mode: {
+        method: 'inspect_mode',
+        description: 'Enable element selection mode.',
+        schema: z.object({
+            enable: z.boolean().describe('True to enable, false to disable'),
+        }),
+    },
+    // ============================================
+    // SOURCE TOOLS (8)
+    // ============================================
+    trace_list_scripts: {
+        method: 'list_scripts',
+        description: 'List loaded scripts.',
+        schema: z.object({}),
+    },
+    trace_get_source_snippet: {
+        method: 'get_source_snippet',
+        description: 'Get source code around a line.',
+        schema: z.object({
+            scriptId: z.string().describe('Script ID'),
+            line: z.number().describe('Line number'),
+        }),
+    },
+    trace_format_source: {
+        method: 'format_source',
+        description: 'Prettify minified source code.',
+        schema: z.object({
+            scriptId: z.string().describe('Script ID'),
+        }),
+    },
+    trace_search_in_sources: {
+        method: 'search_in_sources',
+        description: 'Search across loaded scripts.',
+        schema: z.object({
+            query: z.string().describe('Search query'),
+        }),
+    },
+    trace_blackbox_script: {
+        method: 'blackbox_script',
+        description: 'Ignore script in debugger stepping.',
+        schema: z.object({
+            pattern: z.string().describe('Regex pattern for script URL'),
+        }),
+    },
+    trace_get_original_location: {
+        method: 'get_original_location',
+        description: 'Map compiled location to source map location.',
+        schema: z.object({
+            scriptId: z.string().describe('Script ID'),
+            line: z.number().describe('Line number'),
+            column: z.number().default(0).describe('Column number'),
+        }),
+    },
+    trace_list_original_sources: {
+        method: 'list_original_sources',
+        description: 'List original source files from source maps.',
+        schema: z.object({
+            scriptId: z.string().describe('Script ID'),
+        }),
+    },
+    // ============================================
+    // PERFORMANCE TOOLS (4)
+    // ============================================
+    trace_get_performance_metrics: {
+        method: 'get_performance_metrics',
+        description: 'LCP, CLS, FID, Web Vitals.',
+        schema: z.object({}),
+    },
+    trace_take_heap_snapshot: {
+        method: 'take_heap_snapshot',
+        description: 'Take memory heap snapshot.',
+        schema: z.object({}),
+    },
+    trace_get_heap_snapshots: {
+        method: 'get_heap_snapshots',
+        description: 'List taken snapshots.',
+        schema: z.object({}),
+    },
+    trace_compare_heap_snapshots: {
+        method: 'compare_heap_snapshots',
+        description: 'Find memory leaks by comparing dumps.',
+        schema: z.object({
+            snapshot1: z.string().describe('ID of first snapshot'),
+            snapshot2: z.string().describe('ID of second snapshot'),
+        }),
+    },
+    // ============================================
+    // TIMELINE TOOLS (8)
+    // ============================================
+    trace_get_timeline: {
+        method: 'get_timeline',
+        description: 'Get Chrome tracing timeline events.',
+        schema: z.object({}),
+    },
+    trace_get_console_errors_after_network_failures: {
+        method: 'get_console_errors_after_network_failures',
+        description: 'Correlate events.',
+        schema: z.object({}),
+    },
+    trace_get_events_since_navigation: {
+        method: 'get_events_since_navigation',
+        description: 'Event log since last page load.',
+        schema: z.object({}),
+    },
+    trace_diff_from_snapshot: {
+        method: 'diff_from_snapshot',
+        description: 'Compare time ranges.',
+        schema: z.object({}),
+    },
+    trace_get_events_in_window: {
+        method: 'get_events_in_window',
+        description: 'Filter events by time window.',
+        schema: z.object({
+            window_ms: z.number().describe('Window size in ms'),
+        }),
+    },
+    trace_start_trace: {
+        method: 'start_trace',
+        description: 'Start recording a performance profile.',
+        schema: z.object({
+            name: z.string().describe('Name of the trace'),
+        }),
+    },
+    trace_get_trace_spans: {
+        method: 'get_trace_spans',
+        description: 'Get OpenTelemetry-style spans.',
+        schema: z.object({}),
+    },
+    trace_get_error_rate: {
+        method: 'get_error_rate',
+        description: 'Statistics on error frequency.',
+        schema: z.object({}),
+    },
+    // ============================================
+    // APPLICATION & STORAGE (14)
+    // ============================================
+    trace_get_cookies: {
+        method: 'get_cookies',
+        description: 'List cookies with security flags.',
+        schema: z.object({
+            urls: z.array(z.string()).optional().describe('Filter by URLs'),
+        }),
+    },
+    trace_set_cookie: {
+        method: 'set_cookie',
+        description: 'Set a cookie.',
+        schema: z.object({
+            name: z.string(),
+            value: z.string(),
+            domain: z.string(),
+            options: z.any().optional(),
+        }),
+    },
+    trace_delete_cookies: {
+        method: 'delete_cookies',
+        description: 'Delete cookies.',
+        schema: z.object({
+            name: z.string(),
+            domain: z.string().optional(),
+        }),
+    },
+    trace_clear_all_cookies: {
+        method: 'clear_all_cookies',
+        description: 'Clear all cookies.',
+        schema: z.object({}),
+    },
+    trace_get_local_storage: {
+        method: 'get_local_storage',
+        description: 'Read Local Storage.',
+        schema: z.object({}),
+    },
+    trace_get_session_storage: {
+        method: 'get_session_storage',
+        description: 'Read Session Storage.',
+        schema: z.object({}),
+    },
+    trace_set_storage_item: {
+        method: 'set_storage_item',
+        description: 'Set storage item.',
+        schema: z.object({
+            key: z.string(),
+            value: z.string(),
+            session: z.boolean().describe('True for session storage, false for local'),
+        }),
+    },
+    trace_clear_storage: {
+        method: 'clear_storage',
+        description: 'Wipe (local or session) storage.',
+        schema: z.object({
+            session: z.boolean().describe('True for session storage, false for local'),
+        }),
+    },
+    trace_get_service_workers: {
+        method: 'get_service_workers',
+        description: 'List active Service Workers.',
+        schema: z.object({}),
+    },
+    trace_unregister_service_worker: {
+        method: 'unregister_service_worker',
+        description: 'Unregister a Service Worker.',
+        schema: z.object({
+            scope: z.string(),
+        }),
+    },
+    trace_get_indexeddb_databases: {
+        method: 'get_indexeddb_databases',
+        description: 'List IndexedDB databases.',
+        schema: z.object({}),
+    },
+    trace_get_indexeddb_data: {
+        method: 'get_indexeddb_data',
+        description: 'Read IndexedDB object store.',
+        schema: z.object({
+            database: z.string(),
+            objectStore: z.string(),
+        }),
+    },
+    trace_get_caches: {
+        method: 'get_caches',
+        description: 'Inspect Cache Storage API.',
+        schema: z.object({}),
+    },
+    trace_get_cache_contents: {
+        method: 'get_cache_contents',
+        description: 'Read Cache Storage contents.',
+        schema: z.object({
+            cacheName: z.string(),
+        }),
+    },
+    // ============================================
+    // SECURITY TOOLS (3)
+    // ============================================
+    trace_get_security_info: {
+        method: 'get_security_info',
+        description: 'Get security state (HTTPS, Certificate, Mixed Content).',
+        schema: z.object({}),
+    },
+    trace_check_mixed_content: {
+        method: 'check_mixed_content',
+        description: 'Check for mixed content issues.',
+        schema: z.object({}),
+    },
+    trace_get_certificate_info: {
+        method: 'get_certificate_info',
+        description: 'Get detailed SSL/TLS certificate info.',
+        schema: z.object({}),
+    },
+    // ============================================
+    // PROFILER (3)
+    // ============================================
+    trace_start_cpu_profile: {
+        method: 'start_cpu_profile',
+        description: 'Start CPU profiling.',
+        schema: z.object({}),
+    },
+    trace_stop_cpu_profile: {
+        method: 'stop_cpu_profile',
+        description: 'Stop CPU profiling.',
+        schema: z.object({}),
+    },
+    trace_get_profile_snapshot: {
+        method: 'get_profile_snapshot',
+        description: 'Get simple profile snapshot (hot paths).',
+        schema: z.object({
+            duration_ms: z.number().optional().describe('Duration to profile in ms (default 5000)'),
+        }),
+    },
+    // ============================================
+    // INTERACTION TOOLS (ACTIVE) (5)
+    // ============================================
+    trace_click: {
+        method: 'click',
+        description: 'Click an element (smart wait & scroll).',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_type: {
+        method: 'type',
+        description: 'Type text into input.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+            text: z.string().describe('Text to type'),
+        }),
+    },
+    trace_hover: {
+        method: 'hover',
+        description: 'Hover over element.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    trace_scroll: {
+        method: 'scroll',
+        description: 'Scroll page.',
+        schema: z.object({
+            direction: z.enum(['up', 'down', 'top', 'bottom']).optional().describe('Scroll direction (default bottom)'),
+        }),
+    },
+    trace_wait_for: {
+        method: 'wait_for',
+        description: 'Pause until element appears.',
+        schema: z.object({
+            selector: z.string().describe('CSS selector'),
+        }),
+    },
+    // ============================================
+    // CODE TOOLS (11)
+    // ============================================
+    trace_read_file: {
+        method: 'read_file',
+        description: 'Read local file content.',
+        schema: z.object({
+            path: z.string().describe('Absolute path'),
+        }),
+    },
+    trace_search_code: {
+        method: 'search_code',
+        description: 'Grep search in project.',
+        schema: z.object({
+            query: z.string().describe('Search term'),
+        }),
+    },
+    trace_get_file_tree: {
+        method: 'get_file_tree',
+        description: 'List project files.',
+        schema: z.object({
+            depth: z.number().optional().describe('Directory depth (default 3)'),
+        }),
+    },
+    trace_get_project_info: {
+        method: 'get_project_info',
+        description: 'Get package.json and tech stack summary.',
+        schema: z.object({}),
+    },
+    trace_get_error_context: {
+        method: 'get_error_context',
+        description: 'Automatically get code around a stack trace.',
+        schema: z.object({
+            error: z.string().describe('Error message or stack'),
+        }),
+    },
+    trace_git_blame: {
+        method: 'git_blame',
+        description: 'Get git authorship for lines.',
+        schema: z.object({
+            filePath: z.string().describe('File path'),
+            line: z.number().describe('Line number'),
+        }),
+    },
+    trace_git_recent_changes: {
+        method: 'git_recent_changes',
+        description: 'List recent commits affecting a file.',
+        schema: z.object({
+            filePath: z.string().describe('File path'),
+            days: z.number().optional().describe('Days lookback'),
+        }),
+    },
+    trace_get_imports: {
+        method: 'get_imports',
+        description: 'Static analysis of imports.',
+        schema: z.object({
+            filePath: z.string().describe('File path'),
+        }),
+    },
+    trace_find_usages: {
+        method: 'find_usages',
+        description: 'Find references to a symbol.',
+        schema: z.object({
+            query: z.string().describe('Symbol name'),
+        }),
+    },
+    trace_get_related_files: {
+        method: 'get_related_files',
+        description: 'Guess related files (e.g. Controller -> Model).',
+        schema: z.object({
+            filePath: z.string().describe('File path'),
+        }),
+    },
+    trace_get_env_vars: {
+        method: 'get_env_vars',
+        description: 'Safe subset of environment variables.',
+        schema: z.object({
+            filePath: z.string().optional().describe('Env file path'),
+        }),
+    },
+    // ============================================
+    // CONNECTION & META (2)
+    // ============================================
+    trace_connect: {
+        method: 'connect',
+        description: 'Connect to a browser page to start debugging. MUST be called first.',
+        schema: z.object({
+            url: z.string().describe('The URL to debug'),
+            headless: z.boolean().optional().describe('Run headless (default true)'),
+        }),
+    },
+    trace_p: {
+        method: 'deep_debug',
+        description: 'Run an interactive AI debugging session on the page.',
+        schema: z.object({
+            prompt: z.string().describe('The debugging question/goal'),
+        }),
+    },
+};