openchrome-mcp 1.6.0 → 1.6.2

package/dist/tools/query-dom.js

@@ -0,0 +1,421 @@
+"use strict";
+/**
+ * Query DOM Tool - Unified CSS selector and XPath queries
+ *
+ * Replaces: selector_query, xpath_query
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQueryDomTool = registerQueryDomTool;
+const session_manager_1 = require("../session-manager");
+// ---------------------------------------------------------------------------
+// Definition
+// ---------------------------------------------------------------------------
+const definition = {
+    name: 'query_dom',
+    description: 'Query DOM elements via CSS selectors or XPath. Returns tag, attributes, text, and position.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to query',
+            },
+            method: {
+                type: 'string',
+                enum: ['css', 'xpath'],
+                description: 'Query method: css or xpath',
+            },
+            selector: {
+                type: 'string',
+                description: '(css) CSS selector, e.g. "#search", ".button"',
+            },
+            xpath: {
+                type: 'string',
+                description: '(xpath) XPath expression',
+            },
+            multiple: {
+                type: 'boolean',
+                description: 'Return all matches. Default: false',
+            },
+            limit: {
+                type: 'number',
+                description: '(xpath, multiple) Max results to return',
+            },
+        },
+        required: ['tabId', 'method'],
+    },
+};
+// ---------------------------------------------------------------------------
+// CSS handler
+// ---------------------------------------------------------------------------
+async function handleCSS(sessionId, args) {
+    const tabId = args.tabId;
+    const selector = args.selector;
+    const multiple = args.multiple ?? false;
+    if (!selector) {
+        return {
+            content: [{ type: 'text', text: 'Error: selector is required for css method' }],
+            isError: true,
+        };
+    }
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    const page = await sessionManager.getPage(sessionId, tabId, undefined, 'query_dom');
+    if (!page) {
+        return {
+            content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+            isError: true,
+        };
+    }
+    if (multiple) {
+        const elements = await page.$$(selector);
+        if (elements.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            action: 'query_dom',
+                            method: 'css',
+                            selector,
+                            multiple: true,
+                            elements: [],
+                            count: 0,
+                            message: `No elements found matching "${selector}"`,
+                        }),
+                    },
+                ],
+            };
+        }
+        const MAX_SELECTOR_RESULTS = 50;
+        const totalCount = elements.length;
+        const limitedElements = elements.slice(0, MAX_SELECTOR_RESULTS);
+        const elementInfos = [];
+        for (let i = 0; i < limitedElements.length; i++) {
+            const element = limitedElements[i];
+            const info = await page.evaluate((el, index) => {
+                const rect = el.getBoundingClientRect();
+                const style = window.getComputedStyle(el);
+                const isVisible = style.display !== 'none' &&
+                    style.visibility !== 'hidden' &&
+                    style.opacity !== '0' &&
+                    rect.width > 0 &&
+                    rect.height > 0;
+                const attributes = {};
+                for (const attr of el.attributes) {
+                    attributes[attr.name] = attr.value;
+                }
+                return {
+                    ref: `ref_${index}`,
+                    tagName: el.tagName.toLowerCase(),
+                    id: el.id || null,
+                    className: el.className,
+                    attributes,
+                    textContent: (el.textContent || '').trim().slice(0, 100),
+                    isVisible,
+                    boundingBox: rect.width > 0 && rect.height > 0
+                        ? {
+                            x: Math.round(rect.x),
+                            y: Math.round(rect.y),
+                            width: Math.round(rect.width),
+                            height: Math.round(rect.height),
+                        }
+                        : null,
+                };
+            }, element, i);
+            elementInfos.push(info);
+        }
+        const result = {
+            action: 'query_dom',
+            method: 'css',
+            selector,
+            multiple: true,
+            elements: elementInfos,
+            count: elementInfos.length,
+        };
+        if (totalCount > MAX_SELECTOR_RESULTS) {
+            result.totalCount = totalCount;
+            result.note = `Results limited to first ${MAX_SELECTOR_RESULTS} of ${totalCount} matching elements`;
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    }
+    else {
+        const element = await page.$(selector);
+        if (!element) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            action: 'query_dom',
+                            method: 'css',
+                            selector,
+                            multiple: false,
+                            element: null,
+                            message: `No element found matching "${selector}"`,
+                        }),
+                    },
+                ],
+            };
+        }
+        const info = await page.evaluate((el) => {
+            const rect = el.getBoundingClientRect();
+            const style = window.getComputedStyle(el);
+            const isVisible = style.display !== 'none' &&
+                style.visibility !== 'hidden' &&
+                style.opacity !== '0' &&
+                rect.width > 0 &&
+                rect.height > 0;
+            const attributes = {};
+            for (const attr of el.attributes) {
+                attributes[attr.name] = attr.value;
+            }
+            return {
+                ref: 'ref_0',
+                tagName: el.tagName.toLowerCase(),
+                id: el.id || null,
+                className: el.className,
+                attributes,
+                textContent: (el.textContent || '').trim().slice(0, 100),
+                isVisible,
+                boundingBox: rect.width > 0 && rect.height > 0
+                    ? {
+                        x: Math.round(rect.x),
+                        y: Math.round(rect.y),
+                        width: Math.round(rect.width),
+                        height: Math.round(rect.height),
+                    }
+                    : null,
+            };
+        }, element);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        action: 'query_dom',
+                        method: 'css',
+                        selector,
+                        multiple: false,
+                        element: info,
+                    }),
+                },
+            ],
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// XPath handler
+// ---------------------------------------------------------------------------
+async function handleXPath(sessionId, args) {
+    const tabId = args.tabId;
+    const xpath = args.xpath;
+    const multiple = args.multiple ?? false;
+    const limit = args.limit ?? 50;
+    if (!xpath) {
+        return {
+            content: [{ type: 'text', text: 'Error: xpath is required for xpath method' }],
+            isError: true,
+        };
+    }
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    const page = await sessionManager.getPage(sessionId, tabId, undefined, 'query_dom');
+    if (!page) {
+        return {
+            content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+            isError: true,
+        };
+    }
+    if (multiple) {
+        const result = await page.evaluate((xpathExpr, maxResults) => {
+            function extractElementInfo(element, xpathStr) {
+                const tagName = element.tagName.toLowerCase();
+                const id = element.id || undefined;
+                const classNameAttr = element.getAttribute('class');
+                const className = classNameAttr || undefined;
+                const text = element.textContent?.trim().slice(0, 200) || undefined;
+                const attributes = {};
+                for (let i = 0; i < element.attributes.length; i++) {
+                    const attr = element.attributes[i];
+                    if (attr.name !== 'id' && attr.name !== 'class') {
+                        attributes[attr.name] = attr.value.slice(0, 100);
+                    }
+                }
+                const rect = element.getBoundingClientRect();
+                return {
+                    tagName,
+                    id,
+                    className,
+                    text,
+                    attributes,
+                    rect: {
+                        x: Math.round(rect.x),
+                        y: Math.round(rect.y),
+                        width: Math.round(rect.width),
+                        height: Math.round(rect.height),
+                    },
+                    xpath: xpathStr,
+                };
+            }
+            const xpathResult = document.evaluate(xpathExpr, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+            const elements = [];
+            const count = Math.min(xpathResult.snapshotLength, maxResults);
+            for (let i = 0; i < count; i++) {
+                const node = xpathResult.snapshotItem(i);
+                if (node instanceof Element) {
+                    const simpleXpath = `(${xpathExpr})[${i + 1}]`;
+                    elements.push(extractElementInfo(node, simpleXpath));
+                }
+            }
+            return {
+                elements,
+                totalCount: xpathResult.snapshotLength,
+            };
+        }, xpath, limit);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        action: 'query_dom',
+                        method: 'xpath',
+                        xpath,
+                        multiple: true,
+                        results: result.elements,
+                        count: result.elements.length,
+                        totalCount: result.totalCount,
+                        message: result.elements.length > 0
+                            ? `Found ${result.totalCount} element(s), returned ${result.elements.length}`
+                            : 'No elements found',
+                    }),
+                },
+            ],
+        };
+    }
+    else {
+        const element = await page.evaluate((xpathExpr) => {
+            function extractElementInfo(el, xpathStr) {
+                const tagName = el.tagName.toLowerCase();
+                const id = el.id || undefined;
+                const classNameAttr = el.getAttribute('class');
+                const className = classNameAttr || undefined;
+                const text = el.textContent?.trim().slice(0, 200) || undefined;
+                const attributes = {};
+                for (let i = 0; i < el.attributes.length; i++) {
+                    const attr = el.attributes[i];
+                    if (attr.name !== 'id' && attr.name !== 'class') {
+                        attributes[attr.name] = attr.value.slice(0, 100);
+                    }
+                }
+                const rect = el.getBoundingClientRect();
+                return {
+                    tagName,
+                    id,
+                    className,
+                    text,
+                    attributes,
+                    rect: {
+                        x: Math.round(rect.x),
+                        y: Math.round(rect.y),
+                        width: Math.round(rect.width),
+                        height: Math.round(rect.height),
+                    },
+                    xpath: xpathStr,
+                };
+            }
+            const xpathResult = document.evaluate(xpathExpr, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+            const node = xpathResult.singleNodeValue;
+            if (!node || !(node instanceof Element)) {
+                return null;
+            }
+            return extractElementInfo(node, xpathExpr);
+        }, xpath);
+        if (!element) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            action: 'query_dom',
+                            method: 'xpath',
+                            xpath,
+                            multiple: false,
+                            result: null,
+                            message: 'No element found matching XPath',
+                        }),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        action: 'query_dom',
+                        method: 'xpath',
+                        xpath,
+                        multiple: false,
+                        result: element,
+                        message: `Found element: <${element.tagName}${element.id ? ` id="${element.id}"` : ''}>`,
+                    }),
+                },
+            ],
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Router
+// ---------------------------------------------------------------------------
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const method = args.method;
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    try {
+        switch (method) {
+            case 'css':
+                return await handleCSS(sessionId, args);
+            case 'xpath':
+                return await handleXPath(sessionId, args);
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Unknown method "${method}". Use "css" or "xpath".`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Check for XPath syntax errors
+        if (method === 'xpath' && (errorMessage.includes('XPath') || errorMessage.includes('syntax'))) {
+            return {
+                content: [{ type: 'text', text: `XPath syntax error: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `DOM query error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerQueryDomTool(server) {
+    server.registerTool('query_dom', handler, definition);
+}
+//# sourceMappingURL=query-dom.js.map

package/dist/tools/query-dom.js.map

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

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

@@ -1 +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;AA4e1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D"}
+{"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;AAugB1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D"}

package/dist/tools/read-page.js

@@ -25,7 +25,7 @@ function formatPaginationSection(pagination) {
 }
 const definition = {
     name: 'read_page',
-    description: 'Get page content. Default mode "ax" returns accessibility tree with ref_N identifiers. Mode "dom" returns compact DOM (~5-10x fewer tokens). Mode "css" returns CSS diagnostic info (variables, computed styles, framework detection) — use this BEFORE javascript_tool for style inspection or visual debugging.',
+    description: 'Get page content as compact DOM (default), accessibility tree (ax), or CSS diagnostics (css). Use css mode BEFORE javascript_tool for style inspection.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -35,29 +35,29 @@ const definition = {
             },
             depth: {
                 type: 'number',
-                description: 'Maximum depth of the tree to traverse (default: 8 for "all", 5 for "interactive")',
+                description: 'Max tree depth. Default: 8 (all), 5 (interactive)',
             },
             filter: {
                 type: 'string',
                 enum: ['interactive', 'all'],
-                description: 'Filter elements: "interactive" for buttons/links/inputs only',
+                description: 'Filter: "interactive" for buttons/links/inputs only',
             },
             ref_id: {
                 type: 'string',
-                description: 'Reference ID of a parent element to read from',
+                description: 'Parent element ref for subtree scoping',
             },
             selector: {
                 type: 'string',
-                description: '(css mode only) CSS selector to inspect specific elements. If omitted, inspects all elements with visual properties.',
+                description: 'CSS selector to inspect (css mode only)',
             },
             mode: {
                 type: 'string',
                 enum: ['ax', 'dom', 'css'],
-                description: 'Output mode: "ax" for accessibility tree (default), "dom" for compact DOM, "css" for CSS diagnostics (variables, computed styles, framework detection)',
+                description: 'Output mode: dom (default), ax, or css',
             },
             includePagination: {
                 type: 'boolean',
-                description: 'Whether to detect and include pagination info in the output (default: true)',
+                description: 'Include pagination info. Default: true',
             },
         },
         required: ['tabId'],
@@ -87,7 +87,7 @@ const handler = async (sessionId, args) => {
         }
         const cdpClient = sessionManager.getCDPClient();
         // Mode dispatch
-        const mode = args.mode || 'ax';
+        const mode = args.mode || 'dom';
         if (mode !== 'ax' && mode !== 'dom' && mode !== 'css') {
             return {
                 content: [{ type: 'text', text: `Error: Invalid mode "${mode}". Must be "ax", "dom", or "css".` }],
@@ -250,22 +250,27 @@ const handler = async (sessionId, args) => {
             };
         }
         if (mode === 'dom') {
-            const refId = args.ref_id;
-            const depth = args.depth;
-            const result = await (0, dom_1.serializeDOM)(page, cdpClient, {
-                maxDepth: depth ?? -1,
-                filter: filter,
-                interactiveOnly: filter === 'interactive',
-            });
-            let outputText = result.content;
-            if (refId) {
-                outputText = '[Note: ref_id is ignored in DOM mode. Use mode "ax" for subtree scoping.]\n\n' + outputText;
+            try {
+                const refId = args.ref_id;
+                const depth = args.depth;
+                const result = await (0, dom_1.serializeDOM)(page, cdpClient, {
+                    maxDepth: depth ?? -1,
+                    filter: filter,
+                    interactiveOnly: filter === 'interactive',
+                });
+                let outputText = result.content;
+                if (refId) {
+                    outputText = '[Note: ref_id is ignored in DOM mode. Use mode "ax" for subtree scoping.]\n\n' + outputText;
+                }
+                const includePaginationDom = args.includePagination !== false;
+                const domPaginationSection = includePaginationDom ? formatPaginationSection(await (0, pagination_detector_1.detectPagination)(page, tabId)) : '';
+                return {
+                    content: [{ type: 'text', text: outputText + domPaginationSection }],
+                };
+            }
+            catch {
+                // DOM serialization failed — fall through to AX mode as fallback
             }
-            const includePaginationDom = args.includePagination !== false;
-            const domPaginationSection = includePaginationDom ? formatPaginationSection(await (0, pagination_detector_1.detectPagination)(page, tabId)) : '';
-            return {
-                content: [{ type: 'text', text: outputText + domPaginationSection }],
-            };
         }
         // Resolve ref_id to backendDOMNodeId if provided (AX mode subtree scoping)
         const refIdParam = args.ref_id;
@@ -402,17 +407,39 @@ const handler = async (sessionId, args) => {
         const includePaginationAx = args.includePagination !== false;
         const axPaginationSection = includePaginationAx ? formatPaginationSection(await (0, pagination_detector_1.detectPagination)(page, tabId)) : '';
         if (charCount > MAX_OUTPUT) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: pageStatsLine +
-                            output +
-                            '\n\n[Output truncated. Try mode: "dom" for ~5-10x fewer tokens, or use smaller depth / ref_id to focus on specific element.]' +
-                            axPaginationSection,
-                    },
-                ],
-            };
+            // Auto-fallback: DOM mode produces complete output at ~5-10x fewer tokens
+            try {
+                const domResult = await (0, dom_1.serializeDOM)(page, cdpClient, {
+                    maxDepth: -1,
+                    filter: filter,
+                    interactiveOnly: filter === 'interactive',
+                });
+                const fallbackNote = '\n\n[AX tree exceeded output limit (' + charCount + ' chars). ' +
+                    'Auto-switched to DOM mode for complete output. ' +
+                    'Use mode: "ax" with ref_id to scope specific subtrees for AX format.]';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: domResult.content + fallbackNote + axPaginationSection,
+                        },
+                    ],
+                };
+            }
+            catch {
+                // If DOM serialization fails, fall back to truncated AX (original behavior)
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: pageStatsLine +
+                                output +
+                                '\n\n[Output truncated. Try mode: "dom" for ~5-10x fewer tokens, or use smaller depth / ref_id to focus on specific element.]' +
+                                axPaginationSection,
+                        },
+                    ],
+                };
+            }
         }
         return {
             content: [{ type: 'text', text: pageStatsLine + output + axPaginationSection }],