@probebrowser/trace-mcp 1.0.2 → 1.1.0

package/tests/tools.test.ts

@@ -0,0 +1,288 @@
+import { describe, it, expect } from 'vitest';
+import { TOOLS } from '../src/tools.js';
+
+describe('Tools Definition', () => {
+    describe('Structure', () => {
+        it('should export TOOLS object with all required tools', () => {
+            expect(TOOLS).toBeDefined();
+            expect(typeof TOOLS).toBe('object');
+        });
+
+        it('should have trace_connect tool for browser connection', () => {
+            expect(TOOLS.trace_connect).toBeDefined();
+            expect(TOOLS.trace_connect.method).toBe('connect');
+            expect(TOOLS.trace_connect.description).toContain('Connect');
+        });
+
+        it('should have trace_p tool for AI debugging', () => {
+            expect(TOOLS.trace_p).toBeDefined();
+            expect(TOOLS.trace_p.method).toBe('deep_debug');
+            expect(TOOLS.trace_p.description).toContain('AI');
+        });
+    });
+
+    describe('Console Tools', () => {
+        it('should have console error tool', () => {
+            expect(TOOLS.trace_get_console_errors).toBeDefined();
+            expect(TOOLS.trace_get_console_errors.method).toBe('get_console_errors');
+        });
+
+        it('should have console summary tool', () => {
+            expect(TOOLS.trace_get_console_summary).toBeDefined();
+            expect(TOOLS.trace_get_console_summary.method).toBe('get_console_summary');
+        });
+
+        it('should have error grouping tool', () => {
+            expect(TOOLS.trace_get_error_groups).toBeDefined();
+            expect(TOOLS.trace_get_error_groups.method).toBe('get_error_groups');
+        });
+
+        it('should have suggest fix tool', () => {
+            expect(TOOLS.trace_suggest_fix).toBeDefined();
+            expect(TOOLS.trace_suggest_fix.method).toBe('suggest_fix');
+        });
+    });
+
+    describe('Network Tools', () => {
+        it('should have network summary tool', () => {
+            expect(TOOLS.trace_get_network_summary).toBeDefined();
+            expect(TOOLS.trace_get_network_summary.method).toBe('get_network_summary');
+        });
+
+        it('should have network failed tool', () => {
+            expect(TOOLS.trace_get_network_failed).toBeDefined();
+            expect(TOOLS.trace_get_network_failed.method).toBe('get_network_failed');
+        });
+
+        it('should have request headers tool with requestId param', () => {
+            expect(TOOLS.trace_get_request_headers).toBeDefined();
+            expect(TOOLS.trace_get_request_headers.schema).toBeDefined();
+        });
+
+        it('should have response body tool', () => {
+            expect(TOOLS.trace_get_response_body).toBeDefined();
+            expect(TOOLS.trace_get_response_body.method).toBe('get_response_body');
+        });
+
+        it('should have timing breakdown tool', () => {
+            expect(TOOLS.trace_get_timing_breakdown).toBeDefined();
+            expect(TOOLS.trace_get_timing_breakdown.method).toBe('get_timing_breakdown');
+        });
+
+        it('should have replay request tool', () => {
+            expect(TOOLS.trace_replay_request).toBeDefined();
+            expect(TOOLS.trace_replay_request.method).toBe('replay_request');
+        });
+    });
+
+    describe('DOM Tools', () => {
+        it('should have inspect element tool', () => {
+            expect(TOOLS.trace_inspect_element).toBeDefined();
+            expect(TOOLS.trace_inspect_element.method).toBe('inspect_element');
+        });
+
+        it('should have find elements tool', () => {
+            expect(TOOLS.trace_find_elements).toBeDefined();
+            expect(TOOLS.trace_find_elements.method).toBe('find_elements');
+        });
+
+        it('should have get DOM tree tool', () => {
+            expect(TOOLS.trace_get_dom_tree).toBeDefined();
+            expect(TOOLS.trace_get_dom_tree.method).toBe('get_dom_tree');
+        });
+
+        it('should have analyze visibility tool', () => {
+            expect(TOOLS.trace_analyze_visibility).toBeDefined();
+            expect(TOOLS.trace_analyze_visibility.method).toBe('analyze_visibility');
+        });
+
+        it('should have why hidden tool as alias', () => {
+            expect(TOOLS.trace_why_hidden).toBeDefined();
+            expect(TOOLS.trace_why_hidden.method).toBe('why_hidden');
+        });
+    });
+
+    describe('Debugger Tools', () => {
+        it('should have debugger state tool', () => {
+            expect(TOOLS.trace_get_debugger_state).toBeDefined();
+            expect(TOOLS.trace_get_debugger_state.method).toBe('get_debugger_state');
+        });
+
+        it('should have call stack tool', () => {
+            expect(TOOLS.trace_get_call_stack).toBeDefined();
+            expect(TOOLS.trace_get_call_stack.method).toBe('get_call_stack');
+        });
+
+        it('should have set breakpoint tool', () => {
+            expect(TOOLS.trace_set_breakpoint).toBeDefined();
+            expect(TOOLS.trace_set_breakpoint.method).toBe('set_breakpoint');
+        });
+
+        it('should have step debugger tool with action enum', () => {
+            expect(TOOLS.trace_step_debugger).toBeDefined();
+            expect(TOOLS.trace_step_debugger.method).toBe('step_debugger');
+        });
+
+        it('should have evaluate expression tool', () => {
+            expect(TOOLS.trace_evaluate_expression).toBeDefined();
+            expect(TOOLS.trace_evaluate_expression.method).toBe('evaluate_expression');
+        });
+
+        it('should have logpoint tool', () => {
+            expect(TOOLS.trace_set_logpoint).toBeDefined();
+            expect(TOOLS.trace_set_logpoint.method).toBe('set_logpoint');
+        });
+
+        it('should have DOM breakpoint tool', () => {
+            expect(TOOLS.trace_set_dom_breakpoint_by_selector).toBeDefined();
+            expect(TOOLS.trace_set_dom_breakpoint_by_selector.method).toBe('set_dom_breakpoint_by_selector');
+        });
+    });
+
+    describe('Performance Tools', () => {
+        it('should have performance metrics tool', () => {
+            expect(TOOLS.trace_get_performance_metrics).toBeDefined();
+            expect(TOOLS.trace_get_performance_metrics.method).toBe('get_performance_metrics');
+        });
+
+        it('should have heap snapshot tool', () => {
+            expect(TOOLS.trace_take_heap_snapshot).toBeDefined();
+            expect(TOOLS.trace_take_heap_snapshot.method).toBe('take_heap_snapshot');
+        });
+
+        it('should have CPU profile tools', () => {
+            expect(TOOLS.trace_start_cpu_profile).toBeDefined();
+            expect(TOOLS.trace_stop_cpu_profile).toBeDefined();
+        });
+    });
+
+    describe('Storage Tools', () => {
+        it('should have cookies tool', () => {
+            expect(TOOLS.trace_get_cookies).toBeDefined();
+            expect(TOOLS.trace_get_cookies.method).toBe('get_cookies');
+        });
+
+        it('should have local storage tool', () => {
+            expect(TOOLS.trace_get_local_storage).toBeDefined();
+            expect(TOOLS.trace_get_local_storage.method).toBe('get_local_storage');
+        });
+
+        it('should have session storage tool', () => {
+            expect(TOOLS.trace_get_session_storage).toBeDefined();
+            expect(TOOLS.trace_get_session_storage.method).toBe('get_session_storage');
+        });
+
+        it('should have indexeddb tool', () => {
+            expect(TOOLS.trace_get_indexeddb_databases).toBeDefined();
+            expect(TOOLS.trace_get_indexeddb_databases.method).toBe('get_indexeddb_databases');
+        });
+
+        it('should have service workers tool', () => {
+            expect(TOOLS.trace_get_service_workers).toBeDefined();
+            expect(TOOLS.trace_get_service_workers.method).toBe('get_service_workers');
+        });
+    });
+
+    describe('Security Tools', () => {
+        it('should have security info tool', () => {
+            expect(TOOLS.trace_get_security_info).toBeDefined();
+            expect(TOOLS.trace_get_security_info.method).toBe('get_security_info');
+        });
+
+        it('should have mixed content check tool', () => {
+            expect(TOOLS.trace_check_mixed_content).toBeDefined();
+            expect(TOOLS.trace_check_mixed_content.method).toBe('check_mixed_content');
+        });
+
+        it('should have certificate info tool', () => {
+            expect(TOOLS.trace_get_certificate_info).toBeDefined();
+            expect(TOOLS.trace_get_certificate_info.method).toBe('get_certificate_info');
+        });
+    });
+
+    describe('Interaction Tools', () => {
+        it('should have click tool', () => {
+            expect(TOOLS.trace_click).toBeDefined();
+            expect(TOOLS.trace_click.method).toBe('click');
+        });
+
+        it('should have type tool', () => {
+            expect(TOOLS.trace_type).toBeDefined();
+            expect(TOOLS.trace_type.method).toBe('type');
+        });
+
+        it('should have hover tool', () => {
+            expect(TOOLS.trace_hover).toBeDefined();
+            expect(TOOLS.trace_hover.method).toBe('hover');
+        });
+
+        it('should have scroll tool', () => {
+            expect(TOOLS.trace_scroll).toBeDefined();
+            expect(TOOLS.trace_scroll.method).toBe('scroll');
+        });
+
+        it('should have wait for tool', () => {
+            expect(TOOLS.trace_wait_for).toBeDefined();
+            expect(TOOLS.trace_wait_for.method).toBe('wait_for');
+        });
+    });
+
+    describe('Code Tools', () => {
+        it('should have read file tool', () => {
+            expect(TOOLS.trace_read_file).toBeDefined();
+            expect(TOOLS.trace_read_file.method).toBe('read_file');
+        });
+
+        it('should have search code tool', () => {
+            expect(TOOLS.trace_search_code).toBeDefined();
+            expect(TOOLS.trace_search_code.method).toBe('search_code');
+        });
+
+        it('should have git blame tool', () => {
+            expect(TOOLS.trace_git_blame).toBeDefined();
+            expect(TOOLS.trace_git_blame.method).toBe('git_blame');
+        });
+
+        it('should have find usages tool', () => {
+            expect(TOOLS.trace_find_usages).toBeDefined();
+            expect(TOOLS.trace_find_usages.method).toBe('find_usages');
+        });
+    });
+
+    describe('Tool Count', () => {
+        it('should have at least 100 tools defined', () => {
+            const toolCount = Object.keys(TOOLS).length;
+            expect(toolCount).toBeGreaterThanOrEqual(100);
+        });
+
+        it('should have unique method names for each tool', () => {
+            const methods = Object.values(TOOLS).map(t => t.method);
+            const uniqueMethods = new Set(methods);
+            // Allow some duplicates for aliases (e.g., why_hidden = analyze_visibility)
+            expect(uniqueMethods.size).toBeGreaterThan(90);
+        });
+    });
+
+    describe('Schema Validation', () => {
+        it('all tools should have a schema', () => {
+            for (const [name, tool] of Object.entries(TOOLS)) {
+                expect(tool.schema, `Tool ${name} should have schema`).toBeDefined();
+            }
+        });
+
+        it('all tools should have a description', () => {
+            for (const [name, tool] of Object.entries(TOOLS)) {
+                expect(tool.description, `Tool ${name} should have description`).toBeDefined();
+                expect(typeof tool.description).toBe('string');
+                expect(tool.description.length).toBeGreaterThan(0);
+            }
+        });
+
+        it('all tools should have a method', () => {
+            for (const [name, tool] of Object.entries(TOOLS)) {
+                expect(tool.method, `Tool ${name} should have method`).toBeDefined();
+                expect(typeof tool.method).toBe('string');
+            }
+        });
+    });
+});

package/vitest.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: 'node',
+        include: ['tests/**/*.test.ts'],
+        testTimeout: 30000,
+        hookTimeout: 30000,
+        coverage: {
+            provider: 'v8',
+            reporter: ['text', 'json', 'html'],
+            include: ['src/**/*.ts'],
+            exclude: ['src/index.ts'],
+        },
+    },
+});