claude-chrome-parallel 1.0.0

package/dist/tools/performance-metrics.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Performance Metrics Tool - Collect page performance data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPerformanceMetricsTool = registerPerformanceMetricsTool;
+const session_manager_1 = require("../session-manager");
+const definition = {
+    name: 'performance_metrics',
+    description: `Get performance metrics for the current page.
+Collects various metrics including:
+- Puppeteer metrics (JS heap, layout counts, etc.)
+- Navigation timing (page load, DOM content loaded)
+- Paint timing (first paint, first contentful paint)
+- Resource timing (optional)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to get metrics from',
+            },
+            type: {
+                type: 'string',
+                enum: ['all', 'puppeteer', 'navigation', 'paint', 'resource'],
+                description: 'Type of metrics to retrieve (default: all)',
+            },
+            includeResources: {
+                type: 'boolean',
+                description: 'Whether to include resource timing data (can be large)',
+            },
+        },
+        required: ['tabId'],
+    },
+};
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const type = args.type ?? 'all';
+    const includeResources = args.includeResources ?? false;
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    try {
+        const page = await sessionManager.getPage(sessionId, tabId, undefined, 'performance_metrics');
+        if (!page) {
+            return {
+                content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+                isError: true,
+            };
+        }
+        const metrics = {};
+        // Puppeteer metrics
+        if (type === 'all' || type === 'puppeteer') {
+            const puppeteerMetrics = await page.metrics();
+            metrics.puppeteer = {};
+            for (const [key, value] of Object.entries(puppeteerMetrics)) {
+                if (typeof value === 'number') {
+                    metrics.puppeteer[key] = value;
+                }
+            }
+        }
+        // Navigation timing
+        if (type === 'all' || type === 'navigation') {
+            const navigationTiming = await page.evaluate(() => {
+                const nav = performance.getEntriesByType('navigation')[0];
+                if (!nav)
+                    return null;
+                return {
+                    redirectTime: nav.redirectEnd - nav.redirectStart,
+                    dnsTime: nav.domainLookupEnd - nav.domainLookupStart,
+                    connectTime: nav.connectEnd - nav.connectStart,
+                    requestTime: nav.responseStart - nav.requestStart,
+                    responseTime: nav.responseEnd - nav.responseStart,
+                    domInteractive: nav.domInteractive,
+                    domContentLoadedEventEnd: nav.domContentLoadedEventEnd,
+                    loadEventEnd: nav.loadEventEnd,
+                    duration: nav.duration,
+                };
+            });
+            if (navigationTiming) {
+                metrics.navigation = navigationTiming;
+            }
+        }
+        // Paint timing
+        if (type === 'all' || type === 'paint') {
+            const paintTiming = await page.evaluate(() => {
+                const paints = performance.getEntriesByType('paint');
+                const result = {};
+                for (const paint of paints) {
+                    result[paint.name] = paint.startTime;
+                }
+                return result;
+            });
+            metrics.paint = paintTiming;
+        }
+        // Resource timing
+        if ((type === 'all' && includeResources) || type === 'resource') {
+            const resourceTiming = await page.evaluate(() => {
+                const resources = performance.getEntriesByType('resource');
+                return resources.slice(0, 50).map(r => ({
+                    name: r.name.split('?')[0].split('/').pop() || r.name,
+                    type: r.initiatorType,
+                    duration: Math.round(r.duration),
+                    size: r.transferSize || 0,
+                }));
+            });
+            metrics.resource = resourceTiming;
+        }
+        // Calculate summary
+        if (type === 'all') {
+            const jsHeapUsed = metrics.puppeteer?.JSHeapUsedSize;
+            const resources = metrics.resource || [];
+            metrics.summary = {
+                pageLoadTime: metrics.navigation?.loadEventEnd ?? null,
+                domContentLoaded: metrics.navigation?.domContentLoadedEventEnd ?? null,
+                firstPaint: metrics.paint?.['first-paint'] ?? null,
+                firstContentfulPaint: metrics.paint?.['first-contentful-paint'] ?? null,
+                jsHeapUsedMB: jsHeapUsed ? Math.round((jsHeapUsed / 1024 / 1024) * 100) / 100 : null,
+                totalResources: resources.length,
+                largestResource: resources.length > 0
+                    ? resources.sort((a, b) => b.size - a.size)[0]?.name || null
+                    : null,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        action: 'performance_metrics',
+                        type,
+                        metrics,
+                        message: `Performance metrics collected (type: ${type})`,
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Performance metrics error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerPerformanceMetricsTool(server) {
+    server.registerTool('performance_metrics', handler, definition);
+}
+//# sourceMappingURL=performance-metrics.js.map

package/dist/tools/performance-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-metrics.js","sourceRoot":"","sources":["../../src/tools/performance-metrics.ts"],"names":[],"mappings":"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"}

package/dist/tools/read-page.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read Page Tool - Get accessibility tree representation
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerReadPageTool(server: MCPServer): void;
+//# sourceMappingURL=read-page.d.ts.map

package/dist/tools/read-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-page.d.ts","sourceRoot":"","sources":["../../src/tools/read-page.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwV1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D"}

package/dist/tools/read-page.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * Read Page Tool - Get accessibility tree representation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReadPageTool = registerReadPageTool;
+const session_manager_1 = require("../session-manager");
+const ref_id_manager_1 = require("../utils/ref-id-manager");
+const definition = {
+    name: 'read_page',
+    description: 'Get an accessibility tree representation of elements on the page. Returns element references that can be used with other tools.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to read from',
+            },
+            depth: {
+                type: 'number',
+                description: 'Maximum depth of the tree to traverse (default: 8 for "all", 5 for "interactive")',
+            },
+            filter: {
+                type: 'string',
+                enum: ['interactive', 'all'],
+                description: 'Filter elements: "interactive" for buttons/links/inputs only',
+            },
+            ref_id: {
+                type: 'string',
+                description: 'Reference ID of a parent element to read from (uses faster partial tree fetch)',
+            },
+            selector: {
+                type: 'string',
+                description: 'CSS selector to extract a single element and its subtree (faster than full AX tree). Returns text content and attributes.',
+            },
+            selectorAll: {
+                type: 'string',
+                description: 'CSS selector to extract multiple matching elements. Returns array of {tag, text, attributes} objects. Use for lists, tables, repeated elements.',
+            },
+            selectorLimit: {
+                type: 'number',
+                description: 'Maximum number of elements to return when using selectorAll (default: 50)',
+            },
+        },
+        required: ['tabId'],
+    },
+};
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const filter = args.filter || 'all';
+    const refIdParam = args.ref_id;
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    const refIdManager = (0, ref_id_manager_1.getRefIdManager)();
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    try {
+        const page = await sessionManager.getPage(sessionId, tabId, undefined, 'read_page');
+        if (!page) {
+            return {
+                content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+                isError: true,
+            };
+        }
+        const cdpClient = sessionManager.getCDPClient();
+        // Fast path: CSS selector-based extraction (skips full AX tree)
+        const selectorParam = args.selector;
+        const selectorAllParam = args.selectorAll;
+        if (selectorParam || selectorAllParam) {
+            const cssSelector = (selectorParam || selectorAllParam);
+            const isAll = !!selectorAllParam;
+            const limit = args.selectorLimit || 50;
+            const extractResult = await page.evaluate((sel, all, max) => {
+                function extractElement(el) {
+                    const attrs = {};
+                    for (const attr of el.attributes) {
+                        // Skip very long attributes (e.g. inline styles, data URIs)
+                        if (attr.value.length <= 200) {
+                            attrs[attr.name] = attr.value;
+                        }
+                    }
+                    return {
+                        tag: el.tagName.toLowerCase(),
+                        text: (el.textContent || '').trim().slice(0, 500),
+                        attributes: attrs,
+                        childCount: el.children.length,
+                    };
+                }
+                if (all) {
+                    const elements = document.querySelectorAll(sel);
+                    const results = [];
+                    for (let i = 0; i < Math.min(elements.length, max); i++) {
+                        results.push(extractElement(elements[i]));
+                    }
+                    return { count: elements.length, elements: results };
+                }
+                else {
+                    const el = document.querySelector(sel);
+                    if (!el)
+                        return { count: 0, elements: [] };
+                    return { count: 1, elements: [extractElement(el)] };
+                }
+            }, cssSelector, isAll, limit);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(extractResult, null, 2),
+                    },
+                ],
+            };
+        }
+        // Determine depth: explicit arg > filter-based default
+        // Reduce default from 15→8 for "all" (15 is excessively deep and very slow on complex pages)
+        const defaultDepth = filter === 'interactive' ? 5 : 8;
+        const maxDepth = args.depth || defaultDepth;
+        const fetchDepth = filter === 'interactive' ? Math.min(maxDepth, 5) : maxDepth;
+        let nodes;
+        // When ref_id is provided, use getPartialAXTree to scope the fetch to a subtree.
+        // This is significantly faster than getFullAXTree on complex pages (e.g. Twitter).
+        if (refIdParam) {
+            const backendDOMNodeId = refIdManager.getBackendDOMNodeId(sessionId, tabId, refIdParam);
+            if (!backendDOMNodeId) {
+                return {
+                    content: [{ type: 'text', text: `Error: ref_id "${refIdParam}" not found or expired` }],
+                    isError: true,
+                };
+            }
+            // Resolve backendDOMNodeId → DOM nodeId via DOM.describeNode
+            let domNodeId;
+            try {
+                const { node: domNode } = await cdpClient.send(page, 'DOM.describeNode', { backendNodeId: backendDOMNodeId });
+                domNodeId = domNode.nodeId;
+            }
+            catch {
+                // DOM.describeNode may return nodeId=0 for non-document nodes if DOM hasn't been enabled.
+                // Fall back to getFullAXTree in that case.
+            }
+            if (domNodeId && domNodeId !== 0) {
+                const result = await cdpClient.send(page, 'Accessibility.getPartialAXTree', { nodeId: domNodeId, fetchRelatives: true });
+                nodes = result.nodes;
+            }
+            else {
+                // Fallback: full tree
+                const result = await cdpClient.send(page, 'Accessibility.getFullAXTree', { depth: fetchDepth });
+                nodes = result.nodes;
+            }
+        }
+        else {
+            const result = await cdpClient.send(page, 'Accessibility.getFullAXTree', { depth: fetchDepth });
+            nodes = result.nodes;
+        }
+        // Clear previous refs for this target
+        refIdManager.clearTargetRefs(sessionId, tabId);
+        // Build the tree structure
+        const nodeMap = new Map();
+        for (const node of nodes) {
+            nodeMap.set(node.nodeId, node);
+        }
+        // Interactive roles
+        const interactiveRoles = new Set([
+            'button',
+            'link',
+            'textbox',
+            'checkbox',
+            'radio',
+            'combobox',
+            'listbox',
+            'menu',
+            'menuitem',
+            'menuitemcheckbox',
+            'menuitemradio',
+            'option',
+            'searchbox',
+            'slider',
+            'spinbutton',
+            'switch',
+            'tab',
+            'treeitem',
+        ]);
+        // Format nodes
+        const lines = [];
+        let charCount = 0;
+        const MAX_OUTPUT = 50000;
+        function formatNode(node, indent) {
+            if (charCount > MAX_OUTPUT)
+                return;
+            const role = node.role?.value || 'unknown';
+            const name = node.name?.value || '';
+            const value = node.value?.value || '';
+            // Apply filter
+            if (filter === 'interactive' && !interactiveRoles.has(role)) {
+                // Still process children
+                if (node.childIds) {
+                    for (const childId of node.childIds) {
+                        const child = nodeMap.get(childId);
+                        if (child)
+                            formatNode(child, indent);
+                    }
+                }
+                return;
+            }
+            // Generate ref ID if element has a backend DOM node
+            let refId = '';
+            if (node.backendDOMNodeId) {
+                refId = refIdManager.generateRef(sessionId, tabId, node.backendDOMNodeId, role, name);
+            }
+            // Build line
+            const indentStr = '  '.repeat(indent);
+            let line = `${indentStr}[${refId || 'no-ref'}] ${role}`;
+            if (name)
+                line += `: "${name}"`;
+            if (value)
+                line += ` = "${value}"`;
+            // Add relevant properties
+            if (node.properties) {
+                const props = [];
+                for (const prop of node.properties) {
+                    if (['focused', 'disabled', 'checked', 'selected', 'expanded'].includes(prop.name)) {
+                        if (prop.value.value === true) {
+                            props.push(prop.name);
+                        }
+                    }
+                }
+                if (props.length > 0) {
+                    line += ` (${props.join(', ')})`;
+                }
+            }
+            lines.push(line);
+            charCount += line.length + 1;
+            // Process children
+            if (node.childIds && indent < maxDepth) {
+                for (const childId of node.childIds) {
+                    const child = nodeMap.get(childId);
+                    if (child)
+                        formatNode(child, indent + 1);
+                }
+            }
+        }
+        // Start from root nodes — O(n) Set-based detection (replaces O(n²) nested .some())
+        const childIdSet = new Set();
+        for (const node of nodes) {
+            if (node.childIds) {
+                for (const childId of node.childIds) {
+                    childIdSet.add(childId);
+                }
+            }
+        }
+        const rootNodes = nodes.filter((n) => !childIdSet.has(n.nodeId));
+        for (const root of rootNodes) {
+            formatNode(root, 0);
+        }
+        const output = lines.join('\n');
+        if (charCount > MAX_OUTPUT) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output +
+                            '\n\n[Output truncated. Use smaller depth or ref_id to focus on specific element.]',
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Read page error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerReadPageTool(server) {
+    server.registerTool('read_page', handler, definition);
+}
+//# sourceMappingURL=read-page.js.map

package/dist/tools/read-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-page.js","sourceRoot":"","sources":["../../src/tools/read-page.ts"],"names":[],"mappings":"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"}

package/dist/tools/request-intercept.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Request Intercept Tool - Intercept and modify network requests
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerRequestInterceptTool(server: MCPServer): void;
+//# sourceMappingURL=request-intercept.d.ts.map

package/dist/tools/request-intercept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-intercept.d.ts","sourceRoot":"","sources":["../../src/tools/request-intercept.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAkgB1C,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpE"}