opera-devtools-mcp 0.6.0 → 0.7.0

package/build/src/{bin/chrome-devtools-cli-options.js → config/cli-options.js}

@@ -10,6 +10,12 @@ export const commands = {
         description: 'Clicks on the provided element',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             uid: {
                 name: 'uid',
                 type: 'string',
@@ -34,6 +40,12 @@ export const commands = {
         description: 'Clicks at the provided coordinates (requires flag: --experimentalVision=true)',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             x: {
                 name: 'x',
                 type: 'number',
@@ -112,6 +124,12 @@ export const commands = {
         description: 'Drag an element onto another element',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             from_uid: {
                 name: 'from_uid',
                 type: 'string',
@@ -133,9 +151,15 @@ export const commands = {
         },
     },
     emulate: {
-        description: 'Emulates various features on the selected page.',
+        description: 'Emulates various features on the target page.',
         category: 'Emulation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             networkConditions: {
                 name: 'networkConditions',
                 type: 'string',
@@ -183,13 +207,19 @@ export const commands = {
         },
     },
     evaluate_script: {
-        description: 'Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.',
+        description: 'Evaluate a JavaScript function inside the target page or service worker. Returns the response as JSON, so returned values have to be JSON-serializable.',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID. Required when not evaluating in a service worker.',
+                required: false,
+            },
             function: {
                 name: 'function',
                 type: 'string',
-                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',
+                description: 'A JavaScript function declaration to be executed by the tool in the target page.\nExample without arguments: `() => document.title` or `async () => await fetch("example.com")`.\nExample with arguments: `(el) => el.innerText`\n',
                 required: true,
             },
             args: {
@@ -216,12 +246,24 @@ export const commands = {
                 description: 'Whether to wait for the DOM to settle. Pass false if the script only reads data. Defaults to true.',
                 required: false,
             },
+            serviceWorkerId: {
+                name: 'serviceWorkerId',
+                type: 'string',
+                description: "The optional service worker id to evaluate the script in. If provided, 'pageId' should be omitted. Note: 'args' (element UIDs) cannot be used when evaluating in a service worker.",
+                required: false,
+            },
         },
     },
     execute_3p_developer_tool: {
         description: 'Executes a tool exposed by the page. (requires flag: --categoryExperimentalThirdParty=true)',
         category: 'Third-party',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             toolName: {
                 name: 'toolName',
                 type: 'string',
@@ -240,6 +282,12 @@ export const commands = {
         description: 'Executes a WebMCP tool exposed by the page. (requires flag: --categoryExperimentalWebmcp=true)',
         category: 'WebMCP',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             toolName: {
                 name: 'toolName',
                 type: 'string',
@@ -258,6 +306,12 @@ export const commands = {
         description: 'Type text into an input, text area or select an option from a <select> element.',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             uid: {
                 name: 'uid',
                 type: 'string',
@@ -282,6 +336,12 @@ export const commands = {
         description: 'Gets a console message by its ID. You can get all messages by calling list_console_messages.',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             msgid: {
                 name: 'msgid',
                 type: 'number',
@@ -451,10 +511,10 @@ export const commands = {
                 required: false,
                 enum: ['retainedSize', 'selfSize', 'name'],
             },
-            minRetainedSize: {
-                name: 'minRetainedSize',
-                type: 'number',
-                description: 'Minimum retained size in bytes for target nodes.',
+            retainedSize: {
+                name: 'retainedSize',
+                type: 'string',
+                description: 'Inclusive retained size range (e.g. "1MB-2MB", "-1MB", or "1MB-") for target nodes. A single value is treated as a minimum. Currently, only the lower bound is applied.',
                 required: false,
             },
             excludePrimitives: {
@@ -574,9 +634,15 @@ export const commands = {
         },
     },
     get_network_request: {
-        description: 'Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.',
+        description: "Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel. Useful for inspecting request headers (including 'Cookie') and response headers (including 'Set-Cookie' and directives).",
         category: 'Network',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             reqid: {
                 name: 'reqid',
                 type: 'number',
@@ -613,6 +679,12 @@ export const commands = {
         description: 'If a browser dialog was opened, use this command to handle it',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             action: {
                 name: 'action',
                 type: 'string',
@@ -632,6 +704,12 @@ export const commands = {
         description: 'Hover over the provided element',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             uid: {
                 name: 'uid',
                 type: 'string',
@@ -705,6 +783,12 @@ export const commands = {
         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',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             mode: {
                 name: 'mode',
                 type: 'string',
@@ -732,12 +816,25 @@ 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: {},
+        args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
+        },
     },
     list_console_messages: {
-        description: 'List all console messages for the currently selected page since the last navigation.',
+        description: 'List all console messages for the target page since the last navigation. This includes console messages originating from extensions content scripts.',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             pageSize: {
                 name: 'pageSize',
                 type: 'integer',
@@ -784,9 +881,15 @@ export const commands = {
         args: {},
     },
     list_network_requests: {
-        description: 'Lists the most recent requests for the currently selected page since the last navigation.',
+        description: 'Lists the most recent requests for the target page since the last navigation.',
         category: 'Network',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             pageSize: {
                 name: 'pageSize',
                 type: 'integer',
@@ -815,19 +918,32 @@ export const commands = {
         },
     },
     list_pages: {
-        description: 'Get a list of pages open in the browser.',
+        description: 'Get a list of pages including extension service workers open in the browser.',
         category: 'Navigation automation',
         args: {},
     },
     list_webmcp_tools: {
         description: 'Lists all WebMCP tools the page exposes. (requires flag: --categoryExperimentalWebmcp=true)',
         category: 'WebMCP',
-        args: {},
+        args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
+        },
     },
     navigate_page: {
         description: 'Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.',
         category: 'Navigation automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             type: {
                 name: 'type',
                 type: 'string',
@@ -887,7 +1003,7 @@ export const commands = {
             isolatedContext: {
                 name: 'isolatedContext',
                 type: 'string',
-                description: 'If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isolated.',
+                description: 'If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isolated (useful for clean-slate testing of cookies and authentication).',
                 required: false,
             },
             timeout: {
@@ -902,6 +1018,12 @@ export const commands = {
         description: 'Complete OAuth sign-in for an MCP server that requires authentication. Opens a browser popup for the OAuth flow; requires a headed (visible) browser. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -914,6 +1036,12 @@ export const commands = {
         description: 'Execute a tool on a specific MCP server registered in the browser. Use opera_list_mcp_servers to discover available servers and tools. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -938,6 +1066,12 @@ export const commands = {
         description: "Send a chat prompt to Opera's built-in AI and return the response. Only available when connected to Opera Neon.",
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             prompt: {
                 name: 'prompt',
                 type: 'string',
@@ -956,12 +1090,24 @@ export const commands = {
                 description: 'Conversation ID to continue an existing conversation. Omit to start a new conversation.',
                 required: false,
             },
+            openFullTabView: {
+                name: 'openFullTabView',
+                type: 'boolean',
+                description: 'When true, activate the created chat tab so the user sees it immediately. Default false (tab created in the background). Only meaningful for headed sessions.',
+                required: false,
+            },
         },
     },
     opera_connect_mcp_server: {
         description: 'Connect to a registered MCP server. If the server requires OAuth, the response includes requiresAuth: "needed" — follow with opera_authenticate_mcp_server. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -974,6 +1120,12 @@ export const commands = {
         description: 'Disable an MCP server without unregistering it. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -986,18 +1138,36 @@ export const commands = {
         description: "Instruct Opera's built-in AI to perform an action on the current page and return the result. Only available when connected to Opera Neon.",
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             prompt: {
                 name: 'prompt',
                 type: 'string',
                 description: 'The action to perform, described in natural language.',
                 required: true,
             },
+            openFullTabView: {
+                name: 'openFullTabView',
+                type: 'boolean',
+                description: 'When true, activate the created do tab so the user sees it immediately. Default false (tab created in the background). Only meaningful for headed sessions.',
+                required: false,
+            },
         },
     },
     opera_enable_mcp_server: {
         description: 'Enable a disabled MCP server. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -1009,12 +1179,25 @@ export const commands = {
     opera_list_mcp_servers: {
         description: 'List MCP servers registered in the browser, including their connection status. Only available when connected to Opera Neon.',
         category: 'Opera',
-        args: {},
+        args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
+        },
     },
     opera_list_mcp_tools: {
         description: 'List the tools exposed by a single MCP server. Prefer opera_list_mcp_servers when discovering everything at once; use this for a targeted refresh of one server. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -1026,12 +1209,25 @@ export const commands = {
     opera_list_models: {
         description: 'List available AI models for Opera chat. Returns model IDs, display names, and which is the default. Only available when connected to Opera Neon.',
         category: 'Opera',
-        args: {},
+        args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
+        },
     },
     opera_make: {
         description: "Ask Opera's built-in AI to create or generate content and return the result. Only available when connected to Opera Neon.",
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             prompt: {
                 name: 'prompt',
                 type: 'string',
@@ -1044,12 +1240,24 @@ export const commands = {
                 description: 'Conversation ID to continue an existing conversation. Omit to start a new conversation.',
                 required: false,
             },
+            openFullTabView: {
+                name: 'openFullTabView',
+                type: 'boolean',
+                description: 'When true, activate the created make tab so the user sees it immediately. Default false (tab created in the background). Only meaningful for headed sessions.',
+                required: false,
+            },
         },
     },
     opera_register_mcp_server: {
         description: 'Register an MCP server in the browser. Does not connect or authenticate — follow with opera_connect_mcp_server. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -1068,6 +1276,12 @@ export const commands = {
         description: "Ask Opera's built-in AI to research a topic and return a summary. Only available when connected to Opera Neon.",
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             prompt: {
                 name: 'prompt',
                 type: 'string',
@@ -1081,12 +1295,24 @@ export const commands = {
                 required: false,
                 enum: ['local', 'one-minute', 'deep'],
             },
+            openFullTabView: {
+                name: 'openFullTabView',
+                type: 'boolean',
+                description: 'When true, activate the created research tab so the user sees it immediately. Default false (tab created in the background). Only meaningful for headed sessions.',
+                required: false,
+            },
         },
     },
     opera_unregister_mcp_server: {
         description: 'Remove a registered MCP server and its stored auth tokens. Only available when connected to Opera Neon.',
         category: 'Opera',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             server: {
                 name: 'server',
                 type: 'string',
@@ -1099,6 +1325,12 @@ export const commands = {
         description: 'Provides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.',
         category: 'Performance',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             insightSetId: {
                 name: 'insightSetId',
                 type: 'string',
@@ -1114,13 +1346,19 @@ export const commands = {
         },
     },
     performance_start_trace: {
-        description: 'Start a performance trace on the selected webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.',
+        description: 'Start a performance trace on the target webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.',
         category: 'Performance',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             reload: {
                 name: 'reload',
                 type: 'boolean',
-                description: 'Determines if, once tracing has started, the current selected page should be automatically reloaded. Navigate the page to the right URL using the navigate_page tool BEFORE starting the trace if reload or autoStop is set to true.',
+                description: 'Determines if, once tracing has started, the target page should be automatically reloaded. Navigate the page to the right URL using the navigate_page tool BEFORE starting the trace if reload or autoStop is set to true.',
                 required: false,
                 default: true,
             },
@@ -1140,9 +1378,15 @@ export const commands = {
         },
     },
     performance_stop_trace: {
-        description: 'Stop the active performance trace recording on the selected webpage.',
+        description: 'Stop the active performance trace recording on the target webpage.',
         category: 'Performance',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             filePath: {
                 name: 'filePath',
                 type: 'string',
@@ -1155,6 +1399,12 @@ export const commands = {
         description: 'Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             key: {
                 name: 'key',
                 type: 'string',
@@ -1169,6 +1419,73 @@ export const commands = {
             },
         },
     },
+    query_heapsnapshot_objects: {
+        description: 'Loads a memory heapsnapshot and queries objects matching specific filters (className, propertyName, nodeType, retainedSize, selfSize, isDetached, sortBy). (requires flag: --memoryDebugging=true)',
+        category: 'Memory',
+        args: {
+            filePath: {
+                name: 'filePath',
+                type: 'string',
+                description: 'A path to a .heapsnapshot file to read.',
+                required: true,
+            },
+            className: {
+                name: 'className',
+                type: 'string',
+                description: 'Optional regex or text matching object class name.',
+                required: false,
+            },
+            propertyName: {
+                name: 'propertyName',
+                type: 'string',
+                description: 'Optional property name filter for outgoing reference edges.',
+                required: false,
+            },
+            nodeType: {
+                name: 'nodeType',
+                type: 'string',
+                description: 'Optional V8 node type filter (e.g. object, closure, string, array, code).',
+                required: false,
+            },
+            retainedSize: {
+                name: 'retainedSize',
+                type: 'string',
+                description: 'Inclusive retained size range (e.g. "1MB-2MB", "-1MB", or "1MB-"). A single value is treated as a minimum.',
+                required: false,
+            },
+            selfSize: {
+                name: 'selfSize',
+                type: 'string',
+                description: 'Inclusive self size range (e.g. "1MB-2MB", "-1MB", or "1MB-"). A single value is treated as a minimum.',
+                required: false,
+            },
+            isDetached: {
+                name: 'isDetached',
+                type: 'boolean',
+                description: 'Whether to filter for detached DOM nodes.',
+                required: false,
+            },
+            sortBy: {
+                name: 'sortBy',
+                type: 'string',
+                description: 'Sort order for results. Default is retainedSize.',
+                required: false,
+                enum: ['retainedSize', 'selfSize', 'id'],
+            },
+            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,
+            },
+        },
+    },
     reload_extension: {
         description: 'Reloads an unpacked Chrome extension by its ID. (requires flag: --categoryExtensions=true)',
         category: 'Extensions',
@@ -1182,9 +1499,15 @@ export const commands = {
         },
     },
     resize_page: {
-        description: "Resizes the selected page's window so that the page has specified dimension",
+        description: "Resizes the page's window so that the page has specified dimension",
         category: 'Emulation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             width: {
                 name: 'width',
                 type: 'number',
@@ -1200,9 +1523,15 @@ export const commands = {
         },
     },
     screencast_start: {
-        description: 'Starts recording a screencast (video) of the selected page in specified format. (requires flag: --experimentalScreencast=true)',
+        description: 'Starts recording a screencast (video) of the target page in specified format. (requires flag: --experimentalScreencast=true)',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             filePath: {
                 name: 'filePath',
                 type: 'string',
@@ -1212,9 +1541,16 @@ export const commands = {
         },
     },
     screencast_stop: {
-        description: 'Stops the active screencast recording on the selected page. (requires flag: --experimentalScreencast=true)',
+        description: 'Stops the active screencast recording on the target page. (requires flag: --experimentalScreencast=true)',
         category: 'Debugging',
-        args: {},
+        args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
+        },
     },
     select_page: {
         description: 'Select a page as a context for future tool calls.',
@@ -1235,9 +1571,15 @@ export const commands = {
         },
     },
     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.',
+        description: 'Capture a heap snapshot of the target page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.',
         category: 'Memory',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             filePath: {
                 name: 'filePath',
                 type: 'string',
@@ -1250,6 +1592,12 @@ export const commands = {
         description: 'Take a screenshot of the page or element.',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             format: {
                 name: 'format',
                 type: 'string',
@@ -1285,9 +1633,15 @@ export const commands = {
         },
     },
     take_snapshot: {
-        description: 'Take a text snapshot of the currently selected page based on the a11y tree. The snapshot lists page elements along with a unique\nidentifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected\nin the DevTools Elements panel (if any).',
+        description: 'Take a text snapshot of the target page based on the a11y tree. The snapshot lists page elements along with a unique\nidentifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected\nin the DevTools Elements panel (if any).',
         category: 'Debugging',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             verbose: {
                 name: 'verbose',
                 type: 'boolean',
@@ -1318,6 +1672,12 @@ export const commands = {
         description: 'Type text using keyboard into a previously focused input',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             text: {
                 name: 'text',
                 type: 'string',
@@ -1360,6 +1720,12 @@ export const commands = {
         description: 'Upload a file through a provided element.',
         category: 'Input automation',
         args: {
+            pageId: {
+                name: 'pageId',
+                type: 'number',
+                description: 'Targets a specific page by ID.',
+                required: true,
+            },
             uid: {
                 name: 'uid',
                 type: 'string',
@@ -1381,4 +1747,4 @@ export const commands = {
         },
     },
 };
-//# sourceMappingURL=chrome-devtools-cli-options.js.map
+//# sourceMappingURL=cli-options.js.map