opera-devtools-mcp 0.2.3 → 0.3.0

package/build/src/bin/chrome-devtools-cli-options.js

@@ -30,6 +30,48 @@ export const commands = {
             },
         },
     },
+    click_at: {
+        description: 'Clicks at the provided coordinates (requires flag: --experimentalVision=true)',
+        category: 'Input automation',
+        args: {
+            x: {
+                name: 'x',
+                type: 'number',
+                description: 'The x coordinate',
+                required: true,
+            },
+            y: {
+                name: 'y',
+                type: 'number',
+                description: 'The y coordinate',
+                required: true,
+            },
+            dblClick: {
+                name: 'dblClick',
+                type: 'boolean',
+                description: 'Set to true for double clicks. Default is false.',
+                required: false,
+            },
+            includeSnapshot: {
+                name: 'includeSnapshot',
+                type: 'boolean',
+                description: 'Whether to include a snapshot in the response. Default is false.',
+                required: false,
+            },
+        },
+    },
+    close_heapsnapshot: {
+        description: 'Closes a previously loaded memory heapsnapshot, freeing its memory. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to the .heapsnapshot file to close.',
+                required: true,
+            },
+        },
+    },
     close_page: {
         description: 'Closes the page by its index. The last open page cannot be closed.',
         category: 'Navigation automation',
@@ -42,6 +84,30 @@ export const commands = {
             },
         },
     },
+    compare_heapsnapshots: {
+        description: 'Loads two memory heapsnapshots and returns the comparison. If classIndex is provided, returns detailed diff for that class, otherwise returns summary diff. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            baseFilePath: {
+                name: 'baseFilePath',
+                type: 'string',
+                description: 'A path to the base .heapsnapshot file (earlier snapshot).',
+                required: true,
+            },
+            currentFilePath: {
+                name: 'currentFilePath',
+                type: 'string',
+                description: 'A path to the current .heapsnapshot file (later snapshot).',
+                required: true,
+            },
+            classIndex: {
+                name: 'classIndex',
+                type: 'number',
+                description: 'Optional 0-based index of the class in the summary list to filter results, showing individual objects.',
+                required: false,
+            },
+        },
+    },
     drag: {
         description: 'Drag an element onto another element',
         category: 'Input automation',
@@ -86,7 +152,7 @@ export const commands = {
             geolocation: {
                 name: 'geolocation',
                 type: 'string',
-                description: 'Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.',
+                description: 'Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.',
                 required: false,
             },
             userAgent: {
@@ -108,16 +174,22 @@ export const commands = {
                 description: "Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.",
                 required: false,
             },
+            extraHttpHeaders: {
+                name: 'extraHttpHeaders',
+                type: 'string',
+                description: 'Extra HTTP headers as a JSON string object, e.g. {"X-Custom": "value", "Authorization": "Bearer token"}. Headers are included into every HTTP request originating from the page and persist across navigations until cleared. Pass an empty string to clear all extra headers.',
+                required: false,
+            },
         },
     },
     evaluate_script: {
-        description: 'Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON,\nso returned values have to be JSON-serializable.',
+        description: 'Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.',
         category: 'Debugging',
         args: {
             function: {
                 name: 'function',
                 type: 'string',
-                description: 'A JavaScript function declaration to be executed by the tool in the currently selected page.\nExample without arguments: `() => {\n  return document.title\n}` or `async () => {\n  return await fetch("example.com")\n}`.\nExample with arguments: `(el) => {\n  return el.innerText;\n}`\n',
+                description: 'A JavaScript function declaration to be executed by the tool in the currently selected page.\nExample without arguments: `() => document.title` or `async () => await fetch("example.com")`.\nExample with arguments: `(el) => el.innerText`\n',
                 required: true,
             },
             args: {
@@ -126,12 +198,60 @@ export const commands = {
                 description: 'An optional list of arguments to pass to the function.',
                 required: false,
             },
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.',
+                required: false,
+            },
             dialogAction: {
                 name: 'dialogAction',
                 type: 'string',
                 description: 'Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.',
                 required: false,
             },
+            waitForStableDom: {
+                name: 'waitForStableDom',
+                type: 'boolean',
+                description: 'Whether to wait for the DOM to settle. Pass false if the script only reads data. Defaults to true.',
+                required: false,
+            },
+        },
+    },
+    execute_3p_developer_tool: {
+        description: 'Executes a tool exposed by the page. (requires flag: --categoryExperimentalThirdParty=true)',
+        category: 'Third-party',
+        args: {
+            toolName: {
+                name: 'toolName',
+                type: 'string',
+                description: 'The name of the tool to execute',
+                required: true,
+            },
+            params: {
+                name: 'params',
+                type: 'string',
+                description: 'The JSON-stringified parameters to pass to the tool',
+                required: false,
+            },
+        },
+    },
+    execute_webmcp_tool: {
+        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
+        args: {
+            toolName: {
+                name: 'toolName',
+                type: 'string',
+                description: 'The name of the WebMCP tool to execute',
+                required: true,
+            },
+            input: {
+                name: 'input',
+                type: 'string',
+                description: 'The JSON-stringified parameters to pass to the WebMCP tool',
+                required: false,
+            },
         },
     },
     fill: {
@@ -170,6 +290,289 @@ export const commands = {
             },
         },
     },
+    get_heapsnapshot_class_nodes: {
+        description: 'Loads a memory heapsnapshot and returns instances of a specific class with their IDs. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            id: {
+                name: 'id',
+                type: 'number',
+                description: 'The ID for the class, obtained from details.',
+                required: true,
+            },
+            filterName: {
+                name: 'filterName',
+                type: 'string',
+                description: 'An optional filter to apply to the nodes.',
+                required: false,
+                enum: [
+                    'objectsRetainedByDetachedDomNodes',
+                    'objectsRetainedByConsole',
+                    'objectsRetainedByEventHandlers',
+                    'objectsRetainedByContexts',
+                    'sharedNativeContext',
+                    'noNativeContext',
+                    'attributedToSpecificNativeContext',
+                ],
+            },
+            objectId: {
+                name: 'objectId',
+                type: 'number',
+                description: 'The object ID (nodeId) of the specific native context to filter by when filterName is attributedToSpecificNativeContext.',
+                required: false,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_details: {
+        description: 'Loads a memory heapsnapshot and returns all available information including statistics, static data, and aggregated node information. Supports pagination for aggregates. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            filterName: {
+                name: 'filterName',
+                type: 'string',
+                description: 'An optional filter to apply to the aggregates.',
+                required: false,
+                enum: [
+                    'objectsRetainedByDetachedDomNodes',
+                    'objectsRetainedByConsole',
+                    'objectsRetainedByEventHandlers',
+                    'objectsRetainedByContexts',
+                    'sharedNativeContext',
+                    'noNativeContext',
+                    'attributedToSpecificNativeContext',
+                ],
+            },
+            objectId: {
+                name: 'objectId',
+                type: 'number',
+                description: 'The object ID (nodeId) of the specific native context to filter by when filterName is attributedToSpecificNativeContext.',
+                required: false,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination of aggregates.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination of aggregates.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_dominators: {
+        description: 'Loads a memory heapsnapshot and returns the dominator chain for a specific node ID. This helps to identify which objects are keeping the target node alive. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get the dominator chain for.',
+                required: true,
+            },
+        },
+    },
+    get_heapsnapshot_duplicate_strings: {
+        description: 'Loads a memory heapsnapshot and returns duplicate strings grouped by their value. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_edges: {
+        description: 'Loads a memory heapsnapshot and returns outgoing edges (references) for a specific node ID. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get outgoing edges for.',
+                required: true,
+            },
+            sortBy: {
+                name: 'sortBy',
+                type: 'string',
+                description: 'Sort order for edges. Default is retainedSize.',
+                required: false,
+                enum: ['retainedSize', 'selfSize', 'name'],
+            },
+            minRetainedSize: {
+                name: 'minRetainedSize',
+                type: 'number',
+                description: 'Minimum retained size in bytes for target nodes.',
+                required: false,
+            },
+            excludePrimitives: {
+                name: 'excludePrimitives',
+                type: 'boolean',
+                description: 'Whether to exclude primitive target nodes. Default is true.',
+                required: false,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_object_details: {
+        description: 'Loads a memory heapsnapshot and returns detailed information about a specific object by its node ID, including size, type, distance, and DOM detachedness. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get object details for.',
+                required: true,
+            },
+        },
+    },
+    get_heapsnapshot_retainers: {
+        description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get retainers for.',
+                required: true,
+            },
+            pageIdx: {
+                name: 'pageIdx',
+                type: 'number',
+                description: 'The page index for pagination.',
+                required: false,
+            },
+            pageSize: {
+                name: 'pageSize',
+                type: 'number',
+                description: 'The page size for pagination.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_retaining_paths: {
+        description: 'Loads a memory heapsnapshot and returns retaining paths for a specific node ID. This helps to understand why a node is not being garbage collected. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            nodeId: {
+                name: 'nodeId',
+                type: 'number',
+                description: 'The node ID to get retaining paths for.',
+                required: true,
+            },
+            maxDepth: {
+                name: 'maxDepth',
+                type: 'number',
+                description: 'The maximum depth to search for retaining paths.',
+                required: false,
+            },
+            maxNodes: {
+                name: 'maxNodes',
+                type: 'number',
+                description: 'The maximum number of nodes to return.',
+                required: false,
+            },
+            maxSiblings: {
+                name: 'maxSiblings',
+                type: 'number',
+                description: 'The maximum number of siblings to return.',
+                required: false,
+            },
+        },
+    },
+    get_heapsnapshot_summary: {
+        description: 'Loads a memory heapsnapshot and returns snapshot summary stats, including native contexts and their sizes, and retained by context summary. (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+        },
+    },
     get_network_request: {
         description: 'Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.',
         category: 'Network',
@@ -194,6 +597,18 @@ export const commands = {
             },
         },
     },
+    get_os_app_state: {
+        description: 'Returns the OS integration state (badge count and registered file handlers) for an installed web app, identified by its manifest ID. (requires flag: --categoryPwa=true)',
+        category: 'Progressive Web Apps',
+        args: {
+            manifestId: {
+                name: 'manifestId',
+                type: 'string',
+                description: 'The manifest ID of the web app: the resolved `id` member of its manifest. If `id` is omitted, it defaults to the resolved `start_url` (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.',
+                required: true,
+            },
+        },
+    },
     handle_dialog: {
         description: 'If a browser dialog was opened, use this command to handle it',
         category: 'Input automation',
@@ -231,6 +646,61 @@ export const commands = {
             },
         },
     },
+    install_extension: {
+        description: 'Installs a Chrome extension from the given path. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            path: {
+                name: 'path',
+                type: 'string',
+                description: 'Absolute path to the unpacked extension folder.',
+                required: true,
+            },
+        },
+    },
+    install_pwa: {
+        description: 'Installs a Progressive Web App (PWA) identified by its manifest ID. This installs through the PWA CDP domain without a user gesture or install dialog. DevTools installs default to browser display mode. (requires flag: --categoryPwa=true)',
+        category: 'Progressive Web Apps',
+        args: {
+            manifestId: {
+                name: 'manifestId',
+                type: 'string',
+                description: 'The manifest ID of the web app: the resolved `id` member of its manifest. If `id` is omitted, it defaults to the resolved `start_url` (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.',
+                required: true,
+            },
+            installUrlOrBundleUrl: {
+                name: 'installUrlOrBundleUrl',
+                type: 'string',
+                description: 'The location of the app or bundle. For a normal site this is the page URL; for an Isolated Web App it can be a file:// or http(s):// signed web bundle.',
+                required: true,
+            },
+            displayMode: {
+                name: 'displayMode',
+                type: 'string',
+                description: 'Optional user display mode preference applied after install. "standalone" opens the app in its own window; "browser" opens it as a tab. Installs via the PWA CDP domain default to "browser" because they do not simulate the install dialog, so pass "standalone" to get an app-window experience.',
+                required: false,
+                enum: ['standalone', 'browser'],
+            },
+        },
+    },
+    launch_pwa: {
+        description: 'Launches an installed Progressive Web App using its saved display mode. Optionally opens a specific URL within the same app instead of the default start URL. (requires flag: --categoryPwa=true)',
+        category: 'Progressive Web Apps',
+        args: {
+            manifestId: {
+                name: 'manifestId',
+                type: 'string',
+                description: 'The manifest ID of the web app: the resolved `id` member of its manifest. If `id` is omitted, it defaults to the resolved `start_url` (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.',
+                required: true,
+            },
+            url: {
+                name: 'url',
+                type: 'string',
+                description: 'Optional URL within the app to open instead of the default start URL.',
+                required: false,
+            },
+        },
+    },
     lighthouse_audit: {
         description: 'Get Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_trace',
         category: 'Debugging',
@@ -259,6 +729,11 @@ export const commands = {
             },
         },
     },
+    list_3p_developer_tools: {
+        description: "Lists all third-party developer tools the page exposes for providing runtime information.\nThird-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.\nAlternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the\nfollowing command to the script:\n`window.__dtmcp.executeTool(toolName, params)`\nThis might be helpful when the third-party developer tools return non-serializable values or when composing\nthird-party developer tools with additional functionality. (requires flag: --categoryExperimentalThirdParty=true)",
+        category: 'Third-party',
+        args: {},
+    },
     list_console_messages: {
         description: 'List all console messages for the currently selected page since the last navigation.',
         category: 'Debugging',
@@ -288,10 +763,28 @@ export const commands = {
                 required: false,
                 default: false,
             },
+            includeStackTraces: {
+                name: 'includeStackTraces',
+                type: 'boolean',
+                description: 'Set to true to include the stack trace for each message when available. Increases the response size.',
+                required: false,
+                default: false,
+            },
+            serviceWorkerId: {
+                name: 'serviceWorkerId',
+                type: 'string',
+                description: 'Filter messages to only return messages of the specified service worker.',
+                required: false,
+            },
         },
     },
+    list_extensions: {
+        description: 'Lists all the Chrome extensions installed in the browser. This includes their name, ID, version, and enabled status. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {},
+    },
     list_network_requests: {
-        description: 'List all requests for the currently selected page since the last navigation.',
+        description: 'Lists the most recent requests for the currently selected page since the last navigation.',
         category: 'Network',
         args: {
             pageSize: {
@@ -326,6 +819,11 @@ export const commands = {
         category: 'Navigation automation',
         args: {},
     },
+    list_webmcp_tools: {
+        description: 'Lists all WebMCP tools the page exposes. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
+        args: {},
+    },
     navigate_page: {
         description: 'Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.',
         category: 'Navigation automation',
@@ -354,7 +852,7 @@ export const commands = {
                 type: 'string',
                 description: 'Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept.',
                 required: false,
-                enum: ['accept', 'decline'],
+                enum: ['accept', 'dismiss'],
             },
             initScript: {
                 name: 'initScript',
@@ -540,6 +1038,18 @@ export const commands = {
             },
         },
     },
+    reload_extension: {
+        description: 'Reloads an unpacked Chrome extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to reload.',
+                required: true,
+            },
+        },
+    },
     resize_page: {
         description: "Resizes the selected page's window so that the page has specified dimension",
         category: 'Emulation',
@@ -558,6 +1068,23 @@ export const commands = {
             },
         },
     },
+    screencast_start: {
+        description: 'Starts recording a screencast (video) of the selected page in specified format. (requires flag: --experimentalScreencast=true)',
+        category: 'Debugging',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'Output file path (.webm,.mp4 are supported). Uses mkdtemp to generate a unique path if not provided.',
+                required: false,
+            },
+        },
+    },
+    screencast_stop: {
+        description: 'Stops the active screencast recording on the selected page. (requires flag: --experimentalScreencast=true)',
+        category: 'Debugging',
+        args: {},
+    },
     select_page: {
         description: 'Select a page as a context for future tool calls.',
         category: 'Navigation automation',
@@ -576,7 +1103,7 @@ export const commands = {
             },
         },
     },
-    take_memory_snapshot: {
+    take_heapsnapshot: {
         description: 'Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.',
         category: 'Memory',
         args: {
@@ -644,6 +1171,18 @@ export const commands = {
             },
         },
     },
+    trigger_extension_action: {
+        description: 'Triggers the default action of an extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to trigger the action for.',
+                required: true,
+            },
+        },
+    },
     type_text: {
         description: 'Type text using keyboard into a previously focused input',
         category: 'Input automation',
@@ -662,6 +1201,30 @@ export const commands = {
             },
         },
     },
+    uninstall_extension: {
+        description: 'Uninstalls a Chrome extension by its ID. (requires flag: --categoryExtensions=true)',
+        category: 'Extensions',
+        args: {
+            id: {
+                name: 'id',
+                type: 'string',
+                description: 'ID of the extension to uninstall.',
+                required: true,
+            },
+        },
+    },
+    uninstall_pwa: {
+        description: 'Uninstalls a Progressive Web App identified by its manifest ID and closes any open app windows. (requires flag: --categoryPwa=true)',
+        category: 'Progressive Web Apps',
+        args: {
+            manifestId: {
+                name: 'manifestId',
+                type: 'string',
+                description: 'The manifest ID of the web app: the resolved `id` member of its manifest. If `id` is omitted, it defaults to the resolved `start_url` (e.g. "https://example.com/"). See https://w3c.github.io/manifest/#id-member.',
+                required: true,
+            },
+        },
+    },
     upload_file: {
         description: 'Upload a file through a provided element.',
         category: 'Input automation',
@@ -672,10 +1235,10 @@ export const commands = {
                 description: 'The uid of the file input element or an element that will open file chooser on the page from the page content snapshot',
                 required: true,
             },
-            filePath: {
-                name: 'filePath',
-                type: 'string',
-                description: 'The local path of the file to upload',
+            filePaths: {
+                name: 'filePaths',
+                type: 'array',
+                description: 'One or more files paths to upload. File paths have to be local to the browser instance (not the MCP).',
                 required: true,
             },
             includeSnapshot: {