fix(cli): have pageId as first argument

Author: Samiya Caur

skills/chrome-devtools-cli/SKILL.md

@@ -88,7 +88,7 @@ chrome-devtools performance_start_trace true false # Starts a performance trace
 chrome-devtools performance_start_trace true true --filePath t.gz # Start trace and save to a file
 chrome-devtools performance_stop_trace # Stops the active performance trace
 chrome-devtools performance_stop_trace --filePath "t.json" # Stop trace and save to a file
-chrome-devtools take_memory_snapshot "./snap.heapsnapshot" # Capture a memory heapsnapshot
+chrome-devtools take_heapsnapshot "./snap.heapsnapshot" # Capture a memory heapsnapshot
 ```
 
 ## Network
@@ -144,6 +144,22 @@ chrome-devtools screencast_stop # Stops the active screencast
 chrome-devtools list_webmcp_tools # List all WebMCP tools (requires --categoryExperimentalWebmcp=true)
 ```
 
+### Page ID Routing
+
+When enabled, **all page-scoped tools** require the `pageId` (obtained from `list_pages` or `new_page`) as their **first positional argument**.
+
+Example syntax changes when `--experimentalPageIdRouting` is enabled:
+
+```bash
+# Default (without flag):
+chrome-devtools click "uid"
+chrome-devtools take_snapshot
+
+# With --experimentalPageIdRouting:
+chrome-devtools click <pageId> "uid"
+chrome-devtools take_snapshot <pageId>
+```
+
 ## Service Management
 
 ```bash

src/ToolHandler.ts

@@ -163,7 +163,7 @@ export class ToolHandler {
       tool.pageScoped &&
       serverArgs.experimentalPageIdRouting &&
       !serverArgs.slim
-        ? {...tool.schema, ...pageIdSchema}
+        ? {...pageIdSchema, ...tool.schema}
         : tool.schema;
     this.registeredInputSchema = zod.object(this.inputSchema).passthrough();
   }

src/tools/script.ts

@@ -24,6 +24,7 @@ so returned values have to be JSON-serializable.`,
       readOnlyHint: false,
     },
     schema: {
+      ...(cliArgs?.experimentalPageIdRouting ? pageIdSchema : {}),
       function: zod.string().describe(
         `A JavaScript function declaration to be executed by the tool in the currently selected page.
 Example without arguments: \`() => {
@@ -58,7 +59,6 @@ Example with arguments: \`(el) => {
         .describe(
           'Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.',
         ),
-      ...(cliArgs?.experimentalPageIdRouting ? pageIdSchema : {}),
       ...(cliArgs?.categoryExtensions
         ? {
             serviceWorkerId: zod