@super-one/cli 0.58.0-alpha → 0.59.0-alpha

package/lib/cli.mjs

@@ -164,113 +164,10 @@ var init_host_actions = __esm({
 });
 
 // ../../packages/shared/src/environment/host-action-superone-descriptors.ts
-var deviceDescriptionProperty, deviceTargetProperty, deviceConditionSchema, deviceActionSchema, HOST_ACTION_SUPERONE_TOOL_DESCRIPTORS;
+var HOST_ACTION_SUPERONE_TOOL_DESCRIPTORS;
 var init_host_action_superone_descriptors = __esm({
   "../../packages/shared/src/environment/host-action-superone-descriptors.ts"() {
     "use strict";
-    deviceDescriptionProperty = {
-      type: "string",
-      minLength: 1,
-      maxLength: 160,
-      description: "A short human-friendly explanation of what this step accomplishes, phrased for the user watching (e.g. 'Open the profile tab', 'Check the order total'). Shown in the UI in place of refs and coordinates. Write it in the conversation's language."
-    };
-    deviceTargetProperty = {
-      type: "string",
-      description: "Which controlled device to act on \u2014 the id from device_list, or its name. Optional while this session controls exactly one device; required once it controls more than one (driving the wrong app there looks like a bug in the right one). Use device_request_control to be granted another."
-    };
-    deviceConditionSchema = {
-      type: "object",
-      properties: {
-        kind: { type: "string", enum: ["exists", "notExists", "textEquals", "textContains"] },
-        ref: {
-          description: "Only valid within the snapshot it came from; prefer label or identifier when waiting.",
-          type: "string"
-        },
-        label: { description: "Visible name of the element.", type: "string" },
-        identifier: {
-          description: "Developer-assigned id. Survives copy changes and translation \u2014 the most durable target.",
-          type: "string"
-        },
-        text: {
-          description: "The string textEquals/textContains compares against. Required by those two kinds, and NOT a way to name an element \u2014 use label for that.",
-          type: "string",
-          minLength: 1
-        }
-      },
-      required: ["kind"],
-      additionalProperties: false
-    };
-    deviceActionSchema = {
-      type: "object",
-      properties: {
-        type: {
-          type: "string",
-          enum: ["tap", "doubleTap", "longPress", "swipe", "pinch", "press", "type", "key", "rotate", "keyboard"]
-        },
-        ref: { description: 'Element ref from the snapshot, e.g. "@e12". Preferred over coordinates.', type: "string" },
-        x: {
-          description: "Horizontal position as a fraction of the screen (0-1). Only when no ref fits.",
-          type: "number",
-          minimum: 0,
-          maximum: 1
-        },
-        y: {
-          description: "Vertical position as a fraction of the screen (0-1).",
-          type: "number",
-          minimum: 0,
-          maximum: 1
-        },
-        direction: {
-          description: 'swipe: which way the finger travels. Content moves the opposite way, so "up" scrolls down a list.',
-          type: "string",
-          enum: ["up", "down", "left", "right"]
-        },
-        distance: {
-          description: "swipe: travel as a fraction of the screen. Default 0.6.",
-          type: "number",
-          minimum: 0.05,
-          maximum: 1
-        },
-        toX: {
-          description: "swipe: explicit destination instead of direction.",
-          type: "number",
-          minimum: 0,
-          maximum: 1
-        },
-        toY: { type: "number", minimum: 0, maximum: 1 },
-        scale: {
-          description: "pinch: final separation factor. Below 1 pinches in (zoom out), above 1 spreads.",
-          type: "number",
-          minimum: 0.1,
-          maximum: 5
-        },
-        durationMs: {
-          description: "How long the gesture takes. Short swipes flick and coast; long ones drag and stop.",
-          type: "integer",
-          minimum: 16,
-          maximum: 1e4
-        },
-        text: {
-          description: "type: text to enter. Anything the simulated keyboard cannot spell (Chinese, emoji) is pasted automatically.",
-          type: "string"
-        },
-        button: {
-          type: "string",
-          enum: ["home", "lock", "side", "volume-up", "volume-down", "back", "app-switch"],
-          description: "key: a hardware button. `back` and `app-switch` are Android-only and are refused elsewhere."
-        },
-        orientation: {
-          type: "string",
-          enum: ["portrait", "landscape-left", "portrait-upside-down", "landscape-right"]
-        },
-        connected: {
-          description: "keyboard: attach or detach the hardware keyboard. Detach it to make the on-screen keyboard appear.",
-          type: "boolean"
-        }
-      },
-      required: ["type"],
-      additionalProperties: false
-    };
     HOST_ACTION_SUPERONE_TOOL_DESCRIPTORS = [
       {
         "name": "session_collab_list_agents",
@@ -283,7 +180,7 @@ var init_host_action_superone_descriptors = __esm({
       },
       {
         "name": "session_collab_request",
-        "description": 'Request user approval for collaboration launches: "spawn" (default) creates a nested child you keep messaging; "handoff" creates a top-level sibling that takes the task over one-way (no mailbox); "link" opens a mailbox with an existing sessionId. Spawn/handoff: list_agents; require agentId, name, role, summary, task; for cwd/worktree call read_manual({ domain: "product", topic: "collaboration" }); same-repo isolation belongs in config.worktree. Link: require sessionId + summary; optional task opening (turn-injected, not system prompt). User must approve; credential for session_collab_start.',
+        "description": 'Request user approval for collaboration launches. See the mode field for spawn vs handoff vs link. Spawn/handoff: pick an agentId from session_collab_list_agents; require name, role, summary, task. Link: require sessionId + summary. Read read_manual({ domain: "product", topic: "collaboration" }) before the first launch in a session. User must approve; returns the credential for session_collab_start.',
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -305,7 +202,7 @@ var init_host_action_superone_descriptors = __esm({
                       "handoff",
                       "link"
                     ],
-                    "description": '"spawn" (default) creates a new child session nested under this one, with a two-way mailbox. "handoff" creates a new top-level sibling session that receives the task and owns it from then on \u2014 no mailbox, no reply, not nested. Use it to pass work forward (fresh context, next phase, unattended follow-up) instead of supervising it. "link" connects to an already-existing SuperOne session (sessionId required).'
+                    "description": '"spawn" (default) = nested child with a two-way mailbox. "handoff" = top-level sibling, not nested: it owns the task from then on, with no mailbox and no reply \u2014 pass work forward rather than supervise it. "link" = connect to an existing session (sessionId required).'
                   },
                   "sessionId": {
                     "type": "string",
@@ -364,7 +261,7 @@ var init_host_action_superone_descriptors = __esm({
                           "auto",
                           "agent"
                         ],
-                        "description": 'How autonomous the child session is. Prefer the most autonomous mode it can finish the task under \u2014 "bypassPermissions" (shown as Bypass on Claude-family harnesses, Full Access on Codex/Cursor), "agent" for Cursor, or "auto" for ACP agents. Nobody watches a child session, so a conservative mode strands it on an approval prompt that is never answered. Requesting an autonomous mode is safe by construction: nothing runs until the user approves this very request, and that approval dialog is where they downgrade permission or sandbox per launch. Pick "plan" or "default" only when stopping for human review is the point of the launch.'
+                        "description": 'How autonomous the child session is. Nobody watches a child, so prefer the most autonomous mode it can finish under; "plan"/"default" only when stopping for human review is the point. Per-harness mode names, and why requesting autonomy is safe here: See read_manual({ domain: "product", topic: "collaboration" }).'
                       },
                       "sandboxMode": {
                         "type": "string",
@@ -376,11 +273,11 @@ var init_host_action_superone_descriptors = __esm({
                       },
                       "cwd": {
                         "type": "string",
-                        "description": 'Set only to a genuinely different project root. Omit for the current project. Never pass ~/.worktrees/... or another same-repo worktree leaf; use config.worktree for same-repo isolation. See read_manual({ domain: "product", topic: "collaboration" }).'
+                        "description": 'Only for a genuinely different project root; omit for the current project. Never a same-repo worktree leaf \u2014 express isolation with config.worktree. See read_manual({ domain: "product", topic: "collaboration" }).'
                       },
                       "worktree": {
                         "type": "object",
-                        "description": 'Request a host-managed worktree for same-repo isolation while cwd stays omitted or at the project root. Use for parallel implementers (mode branch + unique branchName), not for default read-only review of the current shared checkout. Use mode detach only when reviewing a feature branch another implementer already has checked out. See read_manual({ domain: "product", topic: "collaboration" }).',
+                        "description": 'Host-managed worktree for same-repo isolation; leave cwd unset. For parallel implementers, not for read-only review of the shared checkout. See read_manual({ domain: "product", topic: "collaboration" }).',
                         "properties": {
                           "enabled": {
                             "type": "boolean"
@@ -495,7 +392,7 @@ var init_host_action_superone_descriptors = __esm({
       },
       {
         "name": "read_manual",
-        "description": "Read bundled SuperOne manuals. Omit domain to list all domains; pass domain to list its topics; pass domain with topic to read one topic. For widget, pass either topic or modules, never both. Use product/contribute for GitHub issues and PRs (issue-first, optional red\u2013green), product/debug for support and runtime paths, miniapp/overview before mini-app development, and media/overview before provider-specific options. Use config_read for live settings and widget_list_templates for saved widgets.",
+        "description": "Read bundled SuperOne manuals. Omit domain to list all domains; pass domain to list its topics; pass domain with topic to read one topic. For widget, pass either topic or modules, never both. Read product/collaboration before session_collab_request, product/automation before automation_apply, product/devices before device_request_control, product/browser before saving a browser action, miniapp/overview before mini-app development, and media/overview before provider-specific options. Use config_read for live settings and widget_list_templates for saved widgets.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -533,9 +430,6 @@ var init_host_action_superone_descriptors = __esm({
             }
           },
           "additionalProperties": false
-        },
-        "_meta": {
-          "anthropic/alwaysLoad": true
         }
       },
       {
@@ -765,11 +659,7 @@ var init_host_action_superone_descriptors = __esm({
       },
       {
         "name": "session_rename",
-        "description": `Rename the current chat session to a concise topic label shown in the sidebar. Always pass tags (set): 1\u20134 short kebab-case labels you choose so session_list/session_search can find this chat. Reuse names from session_tag_list when they fit; invent one when they don't.
-
-Only the top-level agent talking directly to the user may call this. If you were launched as a Task/subagent worker, do NOT call it \u2014 you do not own the user-facing session title.
-
-If the tool returns an error containing "user_locked", the user has manually named this session \u2014 do not call session_rename again. Tags in the same call were still applied; use session_tag for later tag edits.`,
+        "description": "Rename the current chat session to a concise topic label shown in the sidebar. Always pass tags (set): 1\u20134 short kebab-case labels you choose so session_list/session_search can find this chat. Reuse names from session_tag_list when they fit; invent one when they don't. Top-level agent only \u2014 a Task/subagent worker does not own the user-facing title and must not call it.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -781,7 +671,9 @@ If the tool returns an error containing "user_locked", the user has manually nam
             },
             "tags": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "maxItems": 8,
               "description": "Replace this session's tags (set). Pass 1\u20134 short kebab-case labels you choose. Reuse names from session_tag_list when they fit; invent when they don't. Empty array clears. Applied even when the title is user_locked."
             }
@@ -894,7 +786,7 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "session_list",
-        "description": "List SuperOne sessions (metadata only). Default: current project. Pass projectId (from project_list) or allProjects=true. Rows include projectId only \u2014 use project_list for path/name. Use before session_read/session_search. Filter by title query, harness, pin/hidden, dates, or tags + tagMatch (any=at least one, all=every tag; default any). Discover tags with session_tag_list. Sort with order (default last_active_desc; also created_*, message_count_*, size_*). When order is size_*, rows include sizeBytes (character length of message JSON, not disk bytes). Paginate with limit/offset. Not live collab or harness resume.",
+        "description": "List SuperOne sessions (metadata only). Default: current project. Pass projectId (from project_list) or allProjects=true. Rows include projectId only \u2014 use project_list for path/name. Filter by title query, harness, pin/hidden, dates or tags (discover them with session_tag_list). Use before session_read/session_search. Not live collab or harness resume.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -934,13 +826,18 @@ If the tool returns an error containing "user_locked", the user has manually nam
             },
             "tags": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "maxItems": 8,
               "description": "Tags from session_tag_list. Filter sessions that have these labels."
             },
             "tagMatch": {
               "type": "string",
-              "enum": ["any", "all"],
+              "enum": [
+                "any",
+                "all"
+              ],
               "description": "any = at least one listed tag (default). all = every listed tag. Ignored when tags is omitted."
             },
             "projectId": {
@@ -1212,7 +1109,7 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "media_generate_video",
-        "description": 'Submit an asynchronous video generation after the user reviews its parameters. Stop on cancelled or error; use feedback before retrying a rejected proposal. After submission, poll media_video_status about every 30 seconds until generated or error. The finished video is displayed automatically; do not embed it again. Before provider-specific options, call media_list_providers with category "video" and read media/overview plus the matching provider topic. Check warnings for ignored options.',
+        "description": 'Submit an asynchronous video generation after the user reviews its parameters. Stop on cancelled or error; use feedback before retrying. Poll media_video_status about every 30s until generated or error. The finished video is displayed automatically \u2014 do not embed it again. For provider options call media_list_providers(category:"video"), then read media/overview and the matching provider topic.',
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -1313,452 +1210,6 @@ If the tool returns an error containing "user_locked", the user has manually nam
           "additionalProperties": false
         }
       },
-      {
-        "name": "browser_action_list",
-        "description": "List saved semantic browser actions. Omit domain to list all actions, or pass a domain for an exact normalized-domain match. Returns compact summaries by default; set includeSteps:true before replacing an existing action when you need its complete definition.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "domain": {
-              "description": "Optional domain filter, e.g. github.com. Scheme, path, case, and a trailing dot are normalized away.",
-              "type": "string"
-            },
-            "includeSteps": {
-              "default": false,
-              "description": "Include complete step definitions. Default false for a lean action catalog.",
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "includeSteps"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_action_save",
-        "description": 'Create or replace a reusable semantic browser action. Actions are global across projects and sessions and are keyed by normalized domain + name. Steps run sequentially and support kind:"tool", "action", "set", "if", "forEach", and "repeat". Tool/action steps may saveAs a shared variable. Templates in tool args and nested action input may reference ${input.*}, ${vars.*}, ${result.*}, ${item.*}, and ${index}. Structured expressions use literal scalars, {kind:"literal",value}, {kind:"ref",path}, or {kind:"op",op,args}; arbitrary code is not executed. This tool does not record prior browser calls.',
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "domain": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 500,
-              "description": "Semantic domain namespace, normally a hostname such as github.com."
-            },
-            "name": {
-              "type": "string",
-              "pattern": "^[a-z][a-z0-9_-]{0,63}$",
-              "description": "Stable lowercase action name using letters, numbers, underscores, or hyphens."
-            },
-            "description": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 1e3,
-              "description": "Concise explanation of the action outcome and when to use it. Do not embed credentials or other secrets in steps; pass them as action inputs."
-            },
-            "parameters": {
-              "default": [],
-              "description": "Inputs accepted by browser_action_do. Values are referenced in steps as ${input.name}.",
-              "maxItems": 50,
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$",
-                    "description": "Input name referenced in step templates as ${input.name}."
-                  },
-                  "description": {
-                    "description": "What the caller should provide.",
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 500
-                  },
-                  "type": {
-                    "description": "Optional runtime type constraint.",
-                    "type": "string",
-                    "enum": [
-                      "string",
-                      "number",
-                      "boolean",
-                      "object",
-                      "array"
-                    ]
-                  },
-                  "required": {
-                    "default": true,
-                    "type": "boolean"
-                  },
-                  "default": {}
-                },
-                "required": [
-                  "name",
-                  "required"
-                ],
-                "additionalProperties": false
-              }
-            },
-            "steps": {
-              "minItems": 1,
-              "maxItems": 50,
-              "type": "array",
-              "items": {
-                "$ref": "#/$defs/__schema0"
-              },
-              "description": "Ordered flow steps. set writes to shared vars; if runs then or else; forEach exposes item and index; repeat exposes index. Loops allow at most 50 iterations, definitions at most 50 total steps, and execution at most 100 cumulative steps. Execution is fail-fast."
-            }
-          },
-          "required": [
-            "domain",
-            "name",
-            "description",
-            "parameters",
-            "steps"
-          ],
-          "additionalProperties": false,
-          "$defs": {
-            "__schema0": {
-              "description": "A sequential tool, nested action, set, if, forEach, or repeat step. Control-flow child steps execute in order and count toward execution limits.",
-              "oneOf": [
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "tool"
-                    },
-                    "tool": {
-                      "type": "string",
-                      "enum": [
-                        "browser_snapshot",
-                        "browser_query",
-                        "browser_inspect",
-                        "browser_screenshot",
-                        "browser_click",
-                        "browser_hover",
-                        "browser_type",
-                        "browser_navigate",
-                        "browser_wait_for",
-                        "browser_press",
-                        "browser_scroll",
-                        "browser_drag",
-                        "browser_select",
-                        "browser_open",
-                        "browser_evaluate",
-                        "browser_tabs",
-                        "browser_resize",
-                        "browser_network_start",
-                        "browser_network_stop",
-                        "browser_network_wait",
-                        "browser_network_body",
-                        "browser_cookies",
-                        "browser_upload_file",
-                        "browser_download",
-                        "browser_list_downloads",
-                        "browser_emulate",
-                        "browser_mock"
-                      ]
-                    },
-                    "args": {
-                      "default": {},
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {}
-                    },
-                    "saveAs": {
-                      "description": "Save the primitive tool result into vars under this name.",
-                      "type": "string",
-                      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "tool",
-                    "args"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "action"
-                    },
-                    "domain": {
-                      "type": "string",
-                      "minLength": 1,
-                      "maxLength": 500
-                    },
-                    "name": {
-                      "type": "string",
-                      "pattern": "^[a-z][a-z0-9_-]{0,63}$"
-                    },
-                    "input": {
-                      "default": {},
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {}
-                    },
-                    "saveAs": {
-                      "description": "Save the nested action last result into vars under this name.",
-                      "type": "string",
-                      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "domain",
-                    "name",
-                    "input"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "set"
-                    },
-                    "name": {
-                      "type": "string",
-                      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$"
-                    },
-                    "value": {
-                      "$ref": "#/$defs/__schema1"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "name",
-                    "value"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "if"
-                    },
-                    "condition": {
-                      "$ref": "#/$defs/__schema1"
-                    },
-                    "then": {
-                      "minItems": 1,
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/$defs/__schema0"
-                      }
-                    },
-                    "else": {
-                      "minItems": 1,
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/$defs/__schema0"
-                      }
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "condition",
-                    "then"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "forEach"
-                    },
-                    "items": {
-                      "$ref": "#/$defs/__schema1"
-                    },
-                    "steps": {
-                      "minItems": 1,
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/$defs/__schema0"
-                      }
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "items",
-                    "steps"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "repeat"
-                    },
-                    "times": {
-                      "$ref": "#/$defs/__schema1"
-                    },
-                    "steps": {
-                      "minItems": 1,
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/$defs/__schema0"
-                      }
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "times",
-                    "steps"
-                  ],
-                  "additionalProperties": false
-                }
-              ]
-            },
-            "__schema1": {
-              "description": 'A literal JSON scalar, {kind:"literal",value:any JSON}, {kind:"ref",path:"input|vars|result|item|index..."}, or {kind:"op",op,args}. Operators: eq, ne, gt, gte, lt, lte, and, or, not, exists, contains, add, subtract, multiply, divide.',
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "null"
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "literal"
-                    },
-                    "value": {}
-                  },
-                  "required": [
-                    "kind",
-                    "value"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "ref"
-                    },
-                    "path": {
-                      "type": "string",
-                      "pattern": "^(?:input|vars|result|item|index)(?:\\.[A-Za-z0-9_-]+)*$"
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "path"
-                  ],
-                  "additionalProperties": false
-                },
-                {
-                  "type": "object",
-                  "properties": {
-                    "kind": {
-                      "type": "string",
-                      "const": "op"
-                    },
-                    "op": {
-                      "type": "string",
-                      "enum": [
-                        "eq",
-                        "ne",
-                        "gt",
-                        "gte",
-                        "lt",
-                        "lte",
-                        "and",
-                        "or",
-                        "not",
-                        "exists",
-                        "contains",
-                        "add",
-                        "subtract",
-                        "multiply",
-                        "divide"
-                      ]
-                    },
-                    "args": {
-                      "minItems": 1,
-                      "maxItems": 20,
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/$defs/__schema1"
-                      }
-                    }
-                  },
-                  "required": [
-                    "kind",
-                    "op",
-                    "args"
-                  ],
-                  "additionalProperties": false
-                }
-              ]
-            }
-          }
-        }
-      },
-      {
-        "name": "browser_action_do",
-        "description": "Execute one saved semantic browser action, including flow control and nested actions. Call browser_action_list first when you do not know its parameters. Variables are shared across nested actions for the duration of this call. Execution is sequential and fail-fast, detects recursive action cycles, and returns the last primitive tool result plus the actual step count. The domain is a semantic namespace only and does not restrict navigation.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "domain": {
-              "type": "string",
-              "description": "Action domain namespace. Normalized before lookup."
-            },
-            "name": {
-              "type": "string",
-              "description": "Saved action name."
-            },
-            "input": {
-              "default": {},
-              "description": "Values for the action parameters.",
-              "type": "object",
-              "propertyNames": {
-                "type": "string"
-              },
-              "additionalProperties": {}
-            },
-            "tab": {
-              "description": "Browser view id inherited by tab-scoped primitive steps unless a step sets its own tab.",
-              "type": "string"
-            }
-          },
-          "required": [
-            "domain",
-            "name",
-            "input"
-          ],
-          "additionalProperties": false
-        }
-      },
       {
         "name": "browser_tools_list",
         "description": "List WebMCP tools registered by the current secure page. Use this to discover page-provided actions and their input schemas, then call browser_tools_call with a returned name.",
@@ -1788,8 +1239,8 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "name": {
-              "type": "string",
-              "description": "Tool name from browser_tools_list."
+              "description": "Tool name from browser_tools_list. Required.",
+              "type": "string"
             },
             "input": {
               "default": {},
@@ -1802,7 +1253,6 @@ If the tool returns an error containing "user_locked", the user has manually nam
             }
           },
           "required": [
-            "name",
             "input"
           ],
           "additionalProperties": false
@@ -1810,7 +1260,7 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "browser_snapshot",
-        "description": "Inspect the current browser page. Pick which data sections to return via `include`: 'meta' (url/title/loading), 'elements' (flat list of top interactive elements + CSS selectors + total count), 'tree' (hierarchical accessibility tree of landmarks/headings/interactive nodes \u2014 use when you need page STRUCTURE and nesting, not just a flat list), 'text' (truncated visible text), 'console' (recent console entries, filterable). Default include is ['meta','elements','console'] (lean, warning+error console only). Fetch just logs with include:['console'] \u2014 that skips the DOM scan entirely. Call this first to orient. The result is TOON, not JSON: arrays render as a header row `name[N]{col,col}:` followed by one indented CSV-style row per item.",
+        "description": "Inspect the current page. `include` picks sections: meta, elements (flat interactive + CSS selectors), tree (structure), text, console, screenshot. Default [meta, elements, console] (lean). include:[console] skips the DOM scan. include:[screenshot] saves a PNG and returns path \u2014 image is NOT loaded; Read the path if pixels matter. Result is TOON unless a screenshot is requested with other sections (then JSON {screenshot, page}). Prefer this before browser_act. Use browser_query when you already know the target.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -1818,13 +1268,12 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
               "type": "string"
             },
+            "description": {
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "type": "string"
+            },
             "include": {
-              "default": [
-                "meta",
-                "elements",
-                "console"
-              ],
-              "description": "Which data sections to return. Default ['meta','elements','console'].",
+              "description": "Which sections to return. Default ['meta','elements','console'].",
               "type": "array",
               "items": {
                 "type": "string",
@@ -1833,48 +1282,42 @@ If the tool returns an error containing "user_locked", the user has manually nam
                   "elements",
                   "tree",
                   "text",
-                  "console"
+                  "console",
+                  "screenshot"
                 ]
               }
             },
             "filter": {
-              "description": "Elements section only: case-insensitive substring; only return interactive elements whose name or role contains it.",
               "type": "string"
             },
             "max": {
-              "default": 40,
-              "description": "Elements section only: max interactive elements, ranked by viewport proximity. Default 40.",
               "type": "integer",
               "minimum": 1,
               "maximum": 200
             },
             "depth": {
-              "default": 12,
-              "description": "Tree section only: max nesting depth to descend. Default 12.",
               "type": "integer",
               "minimum": 1,
               "maximum": 30
             },
             "treeMax": {
-              "default": 150,
-              "description": "Tree section only: max nodes to emit (overload budget). When hit, the tree is cut and treeTruncated:true is returned. Default 150.",
               "type": "integer",
               "minimum": 1,
               "maximum": 500
             },
             "textMaxChars": {
-              "default": 4e3,
-              "description": "Text section only: truncate visible text to this many chars. Default 4000.",
               "type": "integer",
               "minimum": 0,
               "maximum": 2e4
             },
+            "selector": {
+              "description": "Element to screenshot when include contains screenshot.",
+              "type": "string"
+            },
             "console": {
-              "description": "Console section filtering. Only consulted when `include` contains 'console'.",
               "type": "object",
               "properties": {
                 "level": {
-                  "description": "Console levels to include. Default ['warning','error']. Pass all four for everything.",
                   "type": "array",
                   "items": {
                     "type": "string",
@@ -1887,54 +1330,32 @@ If the tool returns an error containing "user_locked", the user has manually nam
                   }
                 },
                 "grep": {
-                  "description": "Only return console entries whose text matches this pattern (substring by default).",
                   "type": "string"
                 },
                 "regex": {
-                  "default": false,
-                  "description": "Treat grep as a JS regular expression instead of a substring. Default false.",
                   "type": "boolean"
                 },
                 "ignoreCase": {
-                  "default": true,
-                  "description": "Case-insensitive grep. Default true.",
                   "type": "boolean"
                 },
                 "invert": {
-                  "default": false,
-                  "description": "Keep only entries that do NOT match grep (like grep -v). Default false.",
                   "type": "boolean"
                 },
                 "max": {
-                  "default": 50,
-                  "description": "Return the most recent N matching entries. Default 50.",
                   "type": "integer",
                   "minimum": 1,
                   "maximum": 200
                 }
               },
-              "required": [
-                "regex",
-                "ignoreCase",
-                "invert",
-                "max"
-              ],
               "additionalProperties": false
             }
           },
-          "required": [
-            "include",
-            "max",
-            "depth",
-            "treeMax",
-            "textMaxChars"
-          ],
           "additionalProperties": false
         }
       },
       {
         "name": "browser_query",
-        "description": "Find elements on the page by structured criteria. Combine role, text, css selector, and attribute matchers. Returns matching elements with reusable selectors plus the total match count, as TOON (matches render as a `matches[N]{...}:` table + rows). Use this instead of snapshot when you already know what you are looking for.",
+        "description": "Find or inspect elements. op=search (default) matches role / text / css / attributes and returns a TOON table of reusable selectors. op=inspect returns detail on one selector (fields: text, html, attributes, value, box, styles, context). Use this instead of snapshot when you already know what you are looking for. Do not use this to click or type (browser_act).",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -1943,23 +1364,28 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
+            "op": {
+              "description": "Default search.",
+              "type": "string",
+              "enum": [
+                "search",
+                "inspect"
+              ]
+            },
             "role": {
-              "description": "Match ARIA role or tag name, e.g. 'button', 'textbox', 'link'.",
               "type": "string"
             },
             "text": {
-              "description": "Case-insensitive substring in the element's accessible name or text.",
               "type": "string"
             },
             "selector": {
-              "description": "CSS selector to match. Combine with role/text or use alone.",
+              "description": "CSS selector. Required for inspect.",
               "type": "string"
             },
             "attributes": {
-              "description": "Attribute equals matchers, e.g. { type: 'submit' }.",
               "type": "object",
               "propertyNames": {
                 "type": "string"
@@ -1969,63 +1395,14 @@ If the tool returns an error containing "user_locked", the user has manually nam
               }
             },
             "visible": {
-              "default": true,
-              "description": "Only return visible elements. Default true.",
               "type": "boolean"
             },
             "max": {
-              "default": 20,
               "type": "integer",
               "minimum": 1,
               "maximum": 100
             },
             "fields": {
-              "description": "Extra per-match fields beyond the lean reference. Omit for the cheapest result.",
-              "type": "array",
-              "items": {
-                "type": "string",
-                "enum": [
-                  "text",
-                  "html",
-                  "attributes",
-                  "value",
-                  "box"
-                ]
-              }
-            }
-          },
-          "required": [
-            "visible",
-            "max"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_inspect",
-        "description": 'Get detail on one element identified by a CSS selector (typically from a snapshot or query result). Choose which fields to return; "context" adds the ancestor chain, associated labels, and the enclosing form.',
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "selector": {
-              "type": "string",
-              "description": "CSS selector of the element to inspect."
-            },
-            "fields": {
-              "default": [
-                "text",
-                "attributes",
-                "box"
-              ],
-              "description": "Which detail fields to return.",
               "type": "array",
               "items": {
                 "type": "string",
@@ -2041,24 +1418,17 @@ If the tool returns an error containing "user_locked", the user has manually nam
               }
             },
             "maxChars": {
-              "default": 4e3,
-              "description": "Truncate text/html to this many characters.",
               "type": "integer",
               "minimum": 0,
               "maximum": 2e4
             }
           },
-          "required": [
-            "selector",
-            "fields",
-            "maxChars"
-          ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_screenshot",
-        "description": "Capture a PNG screenshot of the visible viewport (or one element when a selector is given), save it to disk, and return its file path plus width/height. Oversized files are JPEG-re-encoded (same dimensions) for cheaper Read. To capture content below the fold, scroll to it first (browser_scroll) and screenshot again. The image is NOT loaded into your context automatically \u2014 if you actually need to look at it, call Read on the returned path. Prefer the text tools (snapshot/query/inspect) first; use a screenshot when pixels matter or to leave a visual record for the user.",
+        "name": "browser_wait_for",
+        "description": "Block until the page reaches a desired state. Provide at least one condition; all are AND-combined: a css selector that must be visible, a selector that must be gone, a visible-text substring, and/or a URL substring. Use after browser_act or browser_tabs navigate when the page changes asynchronously. Defaults to 15s, max 60s. Do not sleep+poll with snapshot yourself.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -2067,67 +1437,38 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
             "selector": {
-              "description": "CSS selector to screenshot just that element. Omit for the visible viewport.",
-              "type": "string"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_click",
-        "description": "Click one element. Prefer selector with a CSS selector from snapshot/query. Alternatively pass text to click the first matching visible element, or x/y viewport coordinates. Provide exactly one targeting mode.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "CSS selector that must be present and visible.",
               "type": "string"
             },
-            "selector": {
-              "description": "CSS selector of the element to click.",
+            "selectorGone": {
+              "description": "CSS selector that must be absent or hidden.",
               "type": "string"
             },
             "text": {
-              "description": "Click the first visible element whose accessible name or text contains this substring.",
+              "description": "Substring that must appear in visible document text.",
               "type": "string"
             },
-            "x": {
-              "description": "Viewport X coordinate in CSS pixels. Must be paired with y.",
-              "type": "number"
-            },
-            "y": {
-              "description": "Viewport Y coordinate in CSS pixels. Must be paired with x.",
-              "type": "number"
+            "urlIncludes": {
+              "description": "Substring that must appear in the current URL.",
+              "type": "string"
             },
-            "engine": {
-              "default": "auto",
-              "description": "'auto' (default): trusted CDP click when the CDP setting is on, else synthetic. 'cdp': trusted click via the browser input pipeline \u2014 needed for pointer-event UIs (e.g. Radix), popups/window.open, file pickers, autoplay, canvas; errors if the CDP setting is off. 'synthetic': untrusted DOM mouse events only \u2014 fine for a plain button/link.",
-              "type": "string",
-              "enum": [
-                "auto",
-                "cdp",
-                "synthetic"
-              ]
+            "timeoutMs": {
+              "description": "Maximum wait in milliseconds. Default 15000, max 60000.",
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 6e4
             }
           },
-          "required": [
-            "engine"
-          ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_hover",
-        "description": "Hover the pointer over one element without clicking. Reveals hover-triggered UI: dropdown/flyout menus, tooltips, and controls that only appear on mouseover. Prefer selector with a CSS selector from snapshot/query; alternatively pass text to match the first visible element, or x/y viewport coordinates. Provide exactly one targeting mode. After hovering, snapshot/query again to read whatever the hover revealed.",
+        "name": "browser_evaluate",
+        "description": "Evaluate a JavaScript expression in the page and return its serializable result. Prefer snapshot and browser_act; use evaluate only for inspection or interactions those tools cannot express. The expression may mutate page state. A returned Promise is awaited. A large result (>32KB) is spilled to a file as { spilled:true, path, bytes, preview }.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -2136,113 +1477,60 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
-            "selector": {
-              "description": "CSS selector of the element to hover.",
-              "type": "string"
-            },
-            "text": {
-              "description": "Hover the first visible element whose accessible name or text contains this substring.",
-              "type": "string"
-            },
-            "x": {
-              "description": "Viewport X coordinate in CSS pixels. Must be paired with y.",
-              "type": "number"
-            },
-            "y": {
-              "description": "Viewport Y coordinate in CSS pixels. Must be paired with x.",
-              "type": "number"
-            },
-            "engine": {
-              "default": "auto",
-              "description": "'auto' (default): trusted CDP mouse move when the CDP setting is on, else synthetic. 'cdp': trusted hover via the browser input pipeline \u2014 needed for menus/tooltips gated on real pointer events (e.g. Radix, native title tooltips); errors if the CDP setting is off. 'synthetic': untrusted DOM pointer/mouse events only (pointerover/mouseover/mouseenter/mousemove) \u2014 fine for CSS :hover and most JS handlers.",
+            "expression": {
               "type": "string",
-              "enum": [
-                "auto",
-                "cdp",
-                "synthetic"
-              ]
+              "minLength": 1,
+              "maxLength": 64e3,
+              "description": "JavaScript expression to evaluate in the page."
             }
           },
           "required": [
-            "engine"
+            "expression"
           ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_type",
-        "description": "Type text into an input. Prefer selector with a CSS selector; if omitted, types into the currently focused element. Set clear=true to replace existing text. Dispatches native input/change events so framework-controlled inputs update.",
+        "name": "browser_tabs",
+        "description": "Discover and change browser tabs for this session. action=list (default) returns a TOON table of tab id / url / title / loading. action=open creates or reuses a tab (optional url). action=navigate|back|forward|reload changes that tab's page \u2014 pass url, or port (+ optional path) for localhost. Use the returned tab id as `tab` on other browser tools. Not for clicking or typing (browser_act).",
         "inputSchema": {
           "type": "object",
           "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
-            "text": {
-              "type": "string",
-              "description": "Literal text to insert."
-            },
-            "selector": {
-              "description": "CSS selector of the input. Omit to type into the focused element.",
-              "type": "string"
-            },
-            "clear": {
-              "default": false,
-              "description": "Clear the existing value before typing. Default false.",
-              "type": "boolean"
-            },
-            "engine": {
-              "default": "synthetic",
-              "description": "'synthetic' (default): sets the value natively and fires input/change \u2014 enough for ordinary framework-controlled inputs. 'cdp': trusted insert via the browser editing pipeline \u2014 use for rich editors (Monaco, CodeMirror, ProseMirror), masked/per-keystroke inputs, or logic gated on trusted events; requires the CDP setting. Neither engine emits per-character keydown.",
+            "action": {
+              "description": "Default list.",
               "type": "string",
               "enum": [
-                "synthetic",
-                "cdp"
+                "list",
+                "open",
+                "navigate",
+                "back",
+                "forward",
+                "reload"
               ]
-            }
-          },
-          "required": [
-            "text",
-            "clear",
-            "engine"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_navigate",
-        "description": "Change the page the browser shows. Provide exactly one of: url (a website), port (a local dev-server on localhost), or action (back/forward/reload to move through history). Waits for the page to stop loading by default.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
             },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+            "tab": {
+              "description": "Existing tab id to reuse (open) or target (navigate/history).",
               "type": "string"
             },
             "url": {
-              "description": "Website URL, e.g. https://example.com. A schemeless host like 'example.com' gets https; loopback gets http.",
+              "description": "Website URL for open/navigate. Schemeless host gets https; loopback gets http.",
               "type": "string"
             },
             "port": {
-              "description": "Local dev-server port on localhost.",
+              "description": "Localhost port for navigate.",
               "type": "integer",
               "minimum": 1,
               "maximum": 65535
             },
             "path": {
-              "description": "Optional path/query for the port form, e.g. '/settings'.",
+              "description": "Optional path/query for the port form.",
               "type": "string"
             },
             "protocol": {
@@ -2253,17 +1541,7 @@ If the tool returns an error containing "user_locked", the user has manually nam
                 "https"
               ]
             },
-            "action": {
-              "description": "Move through history instead of loading a URL.",
-              "type": "string",
-              "enum": [
-                "back",
-                "forward",
-                "reload"
-              ]
-            },
             "readiness": {
-              "default": "load",
               "description": "'load' waits for loading to stop (default); 'none' returns immediately.",
               "type": "string",
               "enum": [
@@ -2272,59 +1550,12 @@ If the tool returns an error containing "user_locked", the user has manually nam
               ]
             }
           },
-          "required": [
-            "readiness"
-          ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_wait_for",
-        "description": "Block until the page reaches a desired state, then return. Provide at least one condition; all are AND-combined: a css selector that must be visible, a selector that must be gone (e.g. a loading spinner), a visible-text substring, and/or a URL substring. Use after click/type/navigate when the page changes asynchronously. Defaults to 15s, max 60s.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "selector": {
-              "description": "CSS selector that must be present and visible.",
-              "type": "string"
-            },
-            "selectorGone": {
-              "description": "CSS selector that must be absent or hidden (e.g. a spinner that should disappear).",
-              "type": "string"
-            },
-            "text": {
-              "description": "Substring that must appear in visible document text.",
-              "type": "string"
-            },
-            "urlIncludes": {
-              "description": "Substring that must appear in the current URL.",
-              "type": "string"
-            },
-            "timeoutMs": {
-              "default": 15e3,
-              "description": "Maximum wait in milliseconds. Default 15000, max 60000.",
-              "type": "integer",
-              "minimum": 100,
-              "maximum": 6e4
-            }
-          },
-          "required": [
-            "timeoutMs"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_press",
-        "description": "Press one keyboard key, e.g. { key: 'Enter' }, { key: 'Escape' }, or { key: 'a', modifiers: ['Meta'] }. Targets the element at selector, or the focused element if omitted. Enter submits the enclosing form when no modifiers are held.",
+        "name": "browser_act",
+        "description": "Act on the page: click, hover, type, press, scroll, drag, select, upload. Send ONE action per call by default. Batch 2\u201320 only for a sequence you would not stop between (fill a form then submit) \u2014 the user sees a batch as one step. Re-read the page between anything else. Prefer a CSS selector from snapshot/query; click/hover also accept text or x/y. engine=auto|cdp|synthetic (default auto). description is shown to the user instead of raw selectors. recording=true saves a video of just this transaction; expect holds it open until a page condition is met. Not for navigation (browser_tabs), waiting (browser_wait_for), or JS (browser_evaluate). Fail-fast: stops at the first error.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -2333,284 +1564,189 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
-            "key": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Key name such as Enter, Escape, Tab, ArrowDown, Backspace, or a single character."
-            },
-            "modifiers": {
-              "description": "Modifier keys held while pressing.",
+            "actions": {
+              "minItems": 1,
+              "maxItems": 20,
               "type": "array",
               "items": {
-                "type": "string",
-                "enum": [
-                  "Alt",
-                  "Control",
-                  "Meta",
-                  "Shift"
-                ]
-              }
-            },
-            "selector": {
-              "description": "CSS selector of the key target. Omit to target the focused element.",
-              "type": "string"
-            },
-            "engine": {
-              "default": "synthetic",
-              "description": "'synthetic' (default): a DOM KeyboardEvent \u2014 enough for JS key handlers (shortcuts, Enter-to-submit, Escape) but untrusted, no native browser behavior. 'cdp': trusted key via the browser input pipeline \u2014 use when a key must move focus (Tab), type into a native input, trigger a browser shortcut, or when a synthetic press had no effect; requires the CDP setting.",
-              "type": "string",
-              "enum": [
-                "synthetic",
-                "cdp"
-              ]
-            }
-          },
-          "required": [
-            "key",
-            "engine"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_scroll",
-        "description": "Scroll by CSS pixels. Positive deltaY scrolls down, positive deltaX scrolls right. Without a selector it scrolls the viewport; with one it scrolls that container. Provide at least one delta. Useful to trigger lazy-loading or reveal off-screen elements.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "deltaX": {
-              "description": "Horizontal scroll in CSS pixels. Positive scrolls right.",
-              "type": "number"
-            },
-            "deltaY": {
-              "description": "Vertical scroll in CSS pixels. Positive scrolls down.",
-              "type": "number"
-            },
-            "selector": {
-              "description": "CSS selector of a scrollable container. Omit to scroll the viewport.",
-              "type": "string"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_drag",
-        "description": "Drag from a source point to a destination point. Handles both pointer-driven gestures (sliders, sortable lists, canvas panning, drag-resize) and native HTML5 drag-and-drop (elements with draggable=true, e.g. kanban cards and file drop zones) \u2014 with the browser CDP setting on, it auto-detects which and drives trusted events for either. Target the source via `from` and the destination via `to`, each by selector, visible text, or x/y viewport coordinates. Tip: enable the browser CDP setting for reliable drags; without it, a best-effort synthetic fallback is used.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "click",
+                      "hover",
+                      "type",
+                      "press",
+                      "scroll",
+                      "drag",
+                      "select",
+                      "upload"
+                    ]
+                  },
+                  "selector": {
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": "string"
+                  },
+                  "x": {
+                    "type": "number"
+                  },
+                  "y": {
+                    "type": "number"
+                  },
+                  "clear": {
+                    "type": "boolean"
+                  },
+                  "key": {
+                    "type": "string"
+                  },
+                  "modifiers": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "enum": [
+                        "Alt",
+                        "Control",
+                        "Meta",
+                        "Shift"
+                      ]
+                    }
+                  },
+                  "deltaX": {
+                    "type": "number"
+                  },
+                  "deltaY": {
+                    "type": "number"
+                  },
+                  "from": {
+                    "type": "object",
+                    "properties": {
+                      "selector": {
+                        "type": "string"
+                      },
+                      "text": {
+                        "type": "string"
+                      },
+                      "x": {
+                        "type": "number"
+                      },
+                      "y": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "to": {
+                    "type": "object",
+                    "properties": {
+                      "selector": {
+                        "type": "string"
+                      },
+                      "text": {
+                        "type": "string"
+                      },
+                      "x": {
+                        "type": "number"
+                      },
+                      "y": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "steps": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                  },
+                  "holdMs": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                  },
+                  "humanize": {
+                    "type": "boolean"
+                  },
+                  "value": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "index": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                  },
+                  "checked": {
+                    "type": "boolean"
+                  },
+                  "files": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "engine": {
+                    "type": "string",
+                    "enum": [
+                      "auto",
+                      "cdp",
+                      "synthetic"
+                    ]
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Normally one action. Use 2\u201320 only for a single uninterruptible sequence; they run in order, fail-fast."
             },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
+            "recording": {
+              "description": "Save a video of only this action transaction. Default false.",
+              "type": "boolean"
             },
-            "from": {
+            "expect": {
+              "description": "Explicit completion condition checked before recording stops.",
               "type": "object",
               "properties": {
                 "selector": {
-                  "description": "CSS selector of the element.",
                   "type": "string"
                 },
-                "text": {
-                  "description": "Match the first visible element whose accessible name or text contains this substring.",
-                  "type": "string"
-                },
-                "x": {
-                  "description": "Viewport X coordinate in CSS pixels. Must be paired with y.",
-                  "type": "number"
-                },
-                "y": {
-                  "description": "Viewport Y coordinate in CSS pixels. Must be paired with x.",
-                  "type": "number"
-                }
-              },
-              "additionalProperties": false,
-              "description": "Drag source. Provide exactly one targeting mode: selector, text, or x+y."
-            },
-            "to": {
-              "type": "object",
-              "properties": {
-                "selector": {
-                  "description": "CSS selector of the element.",
+                "selectorGone": {
                   "type": "string"
                 },
                 "text": {
-                  "description": "Match the first visible element whose accessible name or text contains this substring.",
                   "type": "string"
                 },
-                "x": {
-                  "description": "Viewport X coordinate in CSS pixels. Must be paired with y.",
-                  "type": "number"
-                },
-                "y": {
-                  "description": "Viewport Y coordinate in CSS pixels. Must be paired with x.",
-                  "type": "number"
+                "urlIncludes": {
+                  "type": "string"
                 }
               },
-              "additionalProperties": false,
-              "description": "Drag destination. Provide exactly one targeting mode: selector, text, or x+y."
-            },
-            "steps": {
-              "default": 10,
-              "description": "Number of intermediate move events between source and target. More steps = a slower, smoother drag (each step adds a small delay); fewer = a faster drag. Default 10.",
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 50
-            },
-            "holdMs": {
-              "default": 0,
-              "description": "Time in milliseconds to pause on the target after arriving, before releasing/dropping. Some drop zones only register the drop after a hover. Default 0.",
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 1e4
-            },
-            "humanize": {
-              "default": false,
-              "description": "When true, vary per-step timing and add positional jitter along an ease-in-out motion curve to mimic a human drag. Improves success on libraries that reject robotic linear moves. The final position is still exact. Default false.",
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "from",
-            "to",
-            "steps",
-            "holdMs",
-            "humanize"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_select",
-        "description": "Set the value of a <select> dropdown (by value, visible label, or index) or toggle a checkbox/radio (by checked). Provide the selector plus exactly one of value, label, index, or checked. Dispatches native change events.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "selector": {
-              "type": "string",
-              "description": "CSS selector of the <select>, checkbox, or radio."
-            },
-            "value": {
-              "description": "Option value to select (for <select>).",
-              "type": "string"
-            },
-            "label": {
-              "description": "Visible option text to select (for <select>); exact match preferred, falls back to substring.",
-              "type": "string"
+              "additionalProperties": false
             },
-            "index": {
-              "description": "Zero-based option index (for <select>).",
+            "timeoutMs": {
+              "description": "Maximum wait for expect. Default 15000.",
               "type": "integer",
-              "minimum": 0,
-              "maximum": 9007199254740991
-            },
-            "checked": {
-              "description": "Desired checked state (for checkbox/radio). Defaults to true.",
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "selector"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_open",
-        "description": 'Open a new browser tab (optionally at a URL) and return its tab id. Use this when no browser is open yet, or to start a fresh page. Pass the returned tab id as the "tab" argument to the other browser tools. Waits for the page to stop loading by default.',
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "url": {
-              "description": "Initial URL. A schemeless host like 'example.com' gets https; loopback gets http. Defaults to a blank tab.",
-              "type": "string"
-            },
-            "tab": {
-              "description": "Existing browser tab id to reuse/focus instead of creating a new one.",
-              "type": "string"
-            },
-            "readiness": {
-              "default": "load",
-              "description": "'load' waits for loading to stop (default); 'none' returns as soon as the tab exists.",
-              "type": "string",
-              "enum": [
-                "load",
-                "none"
-              ]
-            }
-          },
-          "required": [
-            "readiness"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_evaluate",
-        "description": "Evaluate a JavaScript expression in the page and return its serializable result. Prefer snapshot and the semantic action tools; use evaluate only for inspection or interactions those tools cannot express. The expression runs in the page and may mutate its state. A returned Promise is awaited. A large result (>32KB serialized) is written to a temp file and returned as { spilled:true, path, bytes, preview } \u2014 Read/grep the path for the full value instead of it flooding context.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "expression": {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 64e3,
-              "description": 'JavaScript expression, e.g. document.title or (() => ({ items: [...document.querySelectorAll("li")].map(li => li.textContent) }))().'
+              "minimum": 100,
+              "maximum": 6e4
             }
           },
           "required": [
-            "expression"
+            "actions"
           ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_tabs",
-        "description": 'List the browser tabs available to this session, each with its tab id, url, title, and loading state (result in TOON: a `tabs[N]{...}:` table). Use the returned tab id as the "tab" argument to target a specific tab. Only tabs belonging to this session are listed.',
-        "inputSchema": {
-          "type": "object",
-          "properties": {},
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_resize",
-        "description": "Resize the browser viewport to test responsive layouts \u2014 no CDP setting required. Pass a preset ('mobile' 375\xD7812, 'tablet' 768\xD71024, 'desktop' 1280\xD7800) or explicit width/height (CSS pixels). Pass reset:true to restore the panel's natural size. Only responsive pages (with a width=device-width viewport meta) reflow; non-responsive pages keep their wide layout. For device-pixel-ratio, touch emulation, user-agent, color scheme, timezone, or geolocation, use browser_emulate instead (it requires the CDP setting).",
+        "name": "browser_network",
+        "description": "Network, downloads, and page environment. Recording ladder: action=start \u2192 do an act/navigate \u2192 action=wait or stop (lean manifest) \u2192 action=body({requestId}) for one response. action=download fetches a URL through the session; action=downloads lists page-triggered captures. action=cookies|mock|emulate need CDP experimental settings, except emulate with only preset/width/height/reset. Prefer snapshot/query for page content.",
         "inputSchema": {
           "type": "object",
           "properties": {
@@ -2619,273 +1755,70 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "type": "string"
             },
             "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
               "type": "string"
             },
-            "preset": {
-              "description": "Named viewport size: mobile 375\xD7812, tablet 768\xD71024, desktop 1280\xD7800.",
+            "action": {
               "type": "string",
               "enum": [
-                "mobile",
-                "tablet",
-                "desktop"
-              ]
-            },
-            "width": {
-              "description": "Explicit viewport width in CSS pixels (pair with height). Overrides preset.",
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 1e4
-            },
-            "height": {
-              "description": "Explicit viewport height in CSS pixels (pair with width). Overrides preset.",
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 1e4
+                "start",
+                "stop",
+                "wait",
+                "body",
+                "download",
+                "downloads",
+                "cookies",
+                "mock",
+                "emulate"
+              ],
+              "description": "Which network/env operation to run."
             },
-            "reset": {
-              "description": "Restore the panel's natural size, clearing any resize.",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_network_start",
-        "description": "Start recording network requests on a tab (requires the browser CDP setting). Nothing is captured until you start, and capture is torn down with zero overhead when you stop \u2014 so record only around the action you care about. Response bodies of matching requests are captured EAGERLY, so they are always readable later (never lost to the browser's cache eviction). Typical flow: browser_network_start \u2192 do an action (browser_click / browser_navigate) \u2192 browser_network_stop to collect exactly what that action triggered. Scope with `match` + `resourceTypes` to keep it lean.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
+            "recordingId": {
+              "description": "From action=start. Required for stop/wait/body.",
               "type": "string"
             },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+            "requestId": {
+              "description": "From a stop/wait manifest. Required for body.",
               "type": "string"
             },
             "match": {
-              "description": "Only record requests whose URL contains this substring. Omit to record everything (within resourceTypes).",
               "type": "string"
             },
             "resourceTypes": {
-              "description": "Resource types to record, case-insensitive: XHR, Fetch, Document, Script, Image, Stylesheet, Font, Media, WebSocket. Default ['XHR','Fetch'] (the app's own API calls). Pass ['*'] for all types.",
               "type": "array",
               "items": {
                 "type": "string"
               }
             },
             "captureBodies": {
-              "default": true,
-              "description": "Capture response bodies of matching requests. Default true. Set false to record only metadata + headers (cheaper).",
               "type": "boolean"
             },
             "max": {
-              "default": 200,
-              "description": "Max requests to record before ignoring further ones. Default 200.",
               "type": "integer",
-              "minimum": 1,
-              "maximum": 1e3
-            }
-          },
-          "required": [
-            "captureBodies",
-            "max"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_network_stop",
-        "description": "Stop a recording started with browser_network_start and return a lean manifest of what it captured, as TOON (a compact tabular format \u2014 read the rows top-to-bottom). Each row has requestId, method, status, resourceType, url, and bodyBytes \u2014 enough to scan and pick which requests matter. It deliberately does NOT include headers, the request payload, or the response body: read one request's full detail (headers + payload + response body) on demand with browser_network_body({ recordingId, requestId }), so a many-request recording never floods context. Bodies stay readable after stop (recent recordings are retained). Pass keep:true to read the manifest so far WITHOUT stopping (peek during a long-running action).",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "recordingId": {
-              "type": "string",
-              "description": "The id returned by browser_network_start."
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
             },
             "keep": {
-              "default": false,
-              "description": "Keep recording (peek) instead of stopping. Default false: stop and tear down capture.",
+              "description": "stop only: peek without tearing down.",
               "type": "boolean"
-            }
-          },
-          "required": [
-            "recordingId",
-            "keep"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_network_wait",
-        "description": "Within an active recording, block until a recorded request whose URL contains the given substring finishes, then return its manifest row as TOON (requestId, method, status, resourceType, url, bodyBytes; read the full detail/body with browser_network_body via requestId). Use after an action that fires an async XHR/fetch, before browser_network_stop, instead of guessing a delay. Default timeout 15s, max 60s.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "recordingId": {
-              "type": "string",
-              "description": "The id returned by browser_network_start."
             },
             "url": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Substring the request URL must contain."
+              "description": "wait: substring to match. download: absolute URL. mock: url substring.",
+              "type": "string"
             },
             "timeoutMs": {
-              "default": 15e3,
-              "description": "Maximum wait in milliseconds. Default 15000.",
               "type": "integer",
-              "minimum": 100,
-              "maximum": 6e4
-            }
-          },
-          "required": [
-            "recordingId",
-            "url",
-            "timeoutMs"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_network_body",
-        "description": "Read one recorded request's full detail on demand (result in TOON), by the requestId from a browser_network_stop / browser_network_wait manifest: method, url, status, mimeType, requestHeaders, requestBody (POST payload), responseHeaders, and the full response body. Reads from the recording's own captured store (not the browser's volatile cache), so it works even for large bodies long after the request finished. A large response body is written to a temp file and returned as { spilled:true, path, bytes, preview } \u2014 Read/grep the path. Works while the recording is active or after it has stopped (recent recordings are retained).",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "recordingId": {
-              "type": "string",
-              "description": "The id returned by browser_network_start."
-            },
-            "requestId": {
-              "type": "string",
-              "description": "The requestId of the entry (from the stop/wait manifest) whose detail to read."
-            }
-          },
-          "required": [
-            "recordingId",
-            "requestId"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_cookies",
-        "description": "Read the cookies visible to the page (experimental; requires the browser CDP setting + cookie-access sub-setting). Returns name, value, domain, path, and key flags as TOON (a `cookies[N]{...}:` table). Long cookie values are truncated (a valueLength field carries the original length). Pass urls to scope to specific URLs.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "urls": {
-              "description": "Only return cookies that would be sent to these URLs. Omit for the current page.",
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_upload_file",
-        "description": "Set the files on a file <input> element (requires the browser CDP setting). This is the only way to attach files to an upload control, which cannot be driven by synthetic events. Provide the input selector and absolute file paths.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
-            },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "selector": {
-              "type": "string",
-              "description": "CSS selector of the file <input> element (input[type=file])."
-            },
-            "files": {
-              "minItems": 1,
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Absolute paths of the files to attach."
-            }
-          },
-          "required": [
-            "selector",
-            "files"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_download",
-        "description": "Fetch a file by URL and save it to disk through the browser session (cookies/auth apply, no CORS; data: URLs ok). Completes synchronously if finished within `timeoutMs`; otherwise continues in the background and returns status 'background' with a taskId \u2014 you will receive a task notification when it finishes. For downloads the page starts itself (export buttons, attachment links), click first then use browser_list_downloads. Files land in a temp dir \u2014 Read the path, or copy/move if the user wants it kept.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
-            },
-            "url": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Absolute URL (or data: URL) of the file to download."
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
             },
             "filename": {
-              "description": "Override the saved file name. Defaults to Content-Disposition or the URL path segment.",
               "type": "string"
             },
-            "timeoutMs": {
-              "default": 15e3,
-              "description": "How long to wait for a synchronous result before moving the job to the background. Default 15000.",
-              "type": "integer",
-              "minimum": 100,
-              "maximum": 12e4
-            }
-          },
-          "required": [
-            "url",
-            "timeoutMs"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_list_downloads",
-        "description": "List files the page triggered for download in this session (export buttons, Content-Disposition links, etc.). Captures are saved automatically without a save dialog. Newest first. Use after browser_click on a download control. Set wait:true to block until at least one matching capture is terminal and nothing is still progressing (or until timeout). Filter with state. This is observation only \u2014 to fetch a known URL use browser_download.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+            "dir": {
+              "description": "download only: absolute directory to save into. Defaults to the configured download directory.",
               "type": "string"
             },
             "state": {
-              "default": "all",
-              "description": "Which captures to include. 'failed' = cancelled or interrupted. Default all.",
               "type": "string",
               "enum": [
                 "all",
@@ -2895,67 +1828,71 @@ If the tool returns an error containing "user_locked", the user has manually nam
               ]
             },
             "wait": {
-              "default": false,
-              "description": "If true, wait for captures to settle (see timeoutMs). Default false (immediate snapshot).",
+              "description": "downloads only: block until captures settle.",
               "type": "boolean"
             },
-            "timeoutMs": {
-              "default": 15e3,
-              "description": "Max wait when wait is true. Default 15000. Ignored when wait is false.",
+            "urls": {
+              "description": "cookies only.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "status": {
               "type": "integer",
-              "minimum": 0,
-              "maximum": 12e4
-            }
-          },
-          "required": [
-            "state",
-            "wait",
-            "timeoutMs"
-          ],
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_emulate",
-        "description": "Emulate device and environment conditions for the page (experimental; requires the browser CDP setting + device-emulation sub-setting): viewport size, device scale, mobile mode, user agent, color scheme, timezone, locale, and geolocation. Pass reset:true to clear all overrides; they persist until reset or the tab is closed. width/height reflow only responsive pages (with a width=device-width viewport meta); non-responsive pages keep their wide layout.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "body": {
               "type": "string"
             },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+            "contentType": {
               "type": "string"
             },
+            "headers": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "clear": {
+              "type": "boolean"
+            },
+            "preset": {
+              "description": "emulate: named viewport (no CDP).",
+              "type": "string",
+              "enum": [
+                "mobile",
+                "tablet",
+                "desktop"
+              ]
+            },
             "width": {
-              "description": "Viewport width in CSS pixels (pair with height).",
               "type": "integer",
-              "minimum": 1,
+              "minimum": -9007199254740991,
               "maximum": 9007199254740991
             },
             "height": {
-              "description": "Viewport height in CSS pixels (pair with width).",
               "type": "integer",
-              "minimum": 1,
+              "minimum": -9007199254740991,
               "maximum": 9007199254740991
             },
+            "reset": {
+              "type": "boolean"
+            },
             "deviceScaleFactor": {
-              "description": "Device pixel ratio. 0 keeps the default.",
-              "type": "number",
-              "minimum": 0
+              "type": "number"
             },
             "mobile": {
-              "description": "Emulate a mobile device (touch, mobile viewport).",
               "type": "boolean"
             },
             "userAgent": {
-              "description": "Override the User-Agent header.",
               "type": "string"
             },
             "colorScheme": {
-              "description": "Emulate prefers-color-scheme.",
               "type": "string",
               "enum": [
                 "light",
@@ -2964,152 +1901,128 @@ If the tool returns an error containing "user_locked", the user has manually nam
               ]
             },
             "timezone": {
-              "description": "IANA timezone id, e.g. 'America/New_York'.",
               "type": "string"
             },
             "locale": {
-              "description": "Locale, e.g. 'en-US' or 'ja-JP'.",
               "type": "string"
             },
             "latitude": {
-              "description": "Geolocation latitude (pair with longitude).",
               "type": "number"
             },
             "longitude": {
-              "description": "Geolocation longitude (pair with latitude).",
               "type": "number"
-            },
-            "reset": {
-              "description": "Clear all emulation overrides.",
-              "type": "boolean"
             }
           },
+          "required": [
+            "action"
+          ],
           "additionalProperties": false
         }
       },
       {
-        "name": "browser_mock",
-        "description": "Intercept matching network requests and respond with a mocked response (experimental; requires the browser CDP setting + network-mocking sub-setting). Provide a url substring to match and the response to return. Pass clear:true to remove all mocks. WARNING: this can read and alter all page traffic \u2014 use only in trusted scenarios.",
+        "name": "browser_action",
+        "description": "Saved semantic browser actions (dynamic catalog \u2014 list then do). action=list (optional domain; includeSteps to see the full definition). action=do runs one saved action with input. action=save creates or replaces a named flow (domain+name) \u2014 read the manual first. This does not record prior browser calls. Use browser_act for one-off clicks/types.",
         "inputSchema": {
           "type": "object",
           "properties": {
-            "tab": {
-              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
-              "type": "string"
+            "action": {
+              "type": "string",
+              "enum": [
+                "list",
+                "save",
+                "do"
+              ],
+              "description": "list / save / do."
             },
-            "description": {
-              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching (e.g. 'Fill in the login email', 'Submit the checkout form'). Shown in the UI in place of the raw selector. Write it in the conversation's language.",
-              "type": "string"
+            "domain": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500,
+              "description": "Semantic domain namespace, normally a hostname such as github.com."
             },
-            "url": {
-              "description": "Substring; requests whose URL contains it are fulfilled with the mock. Required unless clear is set.",
+            "name": {
               "type": "string"
             },
-            "status": {
-              "description": "HTTP status code to return (default 200).",
-              "type": "integer",
-              "minimum": 100,
-              "maximum": 599
-            },
-            "body": {
-              "description": "Response body to return (default empty).",
-              "type": "string"
+            "includeSteps": {
+              "type": "boolean"
             },
-            "contentType": {
-              "description": "Response Content-Type (default 'application/json').",
-              "type": "string"
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1e3
             },
-            "headers": {
-              "description": "Extra response headers.",
-              "type": "object",
-              "propertyNames": {
-                "type": "string"
-              },
-              "additionalProperties": {
-                "type": "string"
+            "parameters": {
+              "default": [],
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$",
+                    "description": "Input name referenced in step templates as ${input.name}."
+                  },
+                  "description": {
+                    "description": "What the caller should provide.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 500
+                  },
+                  "type": {
+                    "description": "Optional runtime type constraint.",
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "object",
+                      "array"
+                    ]
+                  },
+                  "required": {
+                    "default": true,
+                    "type": "boolean"
+                  },
+                  "default": {}
+                },
+                "required": [
+                  "name",
+                  "required"
+                ],
+                "additionalProperties": false
               }
             },
-            "clear": {
-              "description": "Remove all mock rules for this tab and stop intercepting.",
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      {
-        "name": "browser_act",
-        "description": "Submit 1\u201320 page actions as one call: click, hover, type, press, scroll, drag, select, upload. Prefer a CSS selector from snapshot/query; click/hover also accept text or x/y. engine=auto|cdp|synthetic (default auto). description is shown to the user instead of raw selectors. Set recording=true to save a short video containing only this action transaction. Optional expect keeps the recording open until an explicit page condition is met. Do not use this to navigate (browser_tabs), wait (browser_wait_for), or run JS (browser_evaluate). Fail-fast: stops at the first error.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "tab": { "type": "string" },
-            "description": { "type": "string" },
-            "actions": {
-              "type": "array",
+            "steps": {
+              "description": 'save only: 1-50 flow steps, each {kind:"tool"|"action"|"set"|"if"|"forEach"|"repeat"}. Read read_manual({ domain: "product", topic: "browser" }) for the grammar before writing them.',
               "minItems": 1,
-              "maxItems": 20,
+              "maxItems": 50,
+              "type": "array",
               "items": {
                 "type": "object",
-                "properties": {
-                  "type": { "type": "string", "enum": ["click", "hover", "type", "press", "scroll", "drag", "select", "upload"] }
+                "propertyNames": {
+                  "type": "string"
                 },
-                "required": ["type"],
-                "additionalProperties": true
+                "additionalProperties": {}
               }
             },
-            "recording": { "type": "boolean", "description": "Save a video of only this action transaction. Default false." },
-            "expect": {
+            "input": {
               "type": "object",
-              "properties": {
-                "selector": { "type": "string" },
-                "selectorGone": { "type": "string" },
-                "text": { "type": "string" },
-                "urlIncludes": { "type": "string" }
+              "propertyNames": {
+                "type": "string"
               },
-              "additionalProperties": false
+              "additionalProperties": {}
             },
-            "timeoutMs": { "type": "integer", "minimum": 100, "maximum": 6e4 }
+            "tab": {
+              "type": "string"
+            }
           },
-          "required": ["actions"],
+          "required": [
+            "action"
+          ],
           "additionalProperties": false
         }
       },
-      {
-        "name": "browser_network",
-        "description": "Network, downloads, and page environment. Recording ladder: action=start \u2192 do an act/navigate \u2192 action=wait or stop (lean manifest) \u2192 action=body({requestId}) for one response. action=download fetches a URL through the session; action=downloads lists page-triggered captures. action=cookies|mock|emulate need CDP experimental settings. emulate with only preset/width/height/reset resizes without CDP. Prefer snapshot/query for page content.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "action": {
-              "type": "string",
-              "enum": ["start", "stop", "wait", "body", "download", "downloads", "cookies", "mock", "emulate"]
-            },
-            "tab": { "type": "string" },
-            "description": { "type": "string" },
-            "recordingId": { "type": "string" },
-            "requestId": { "type": "string" },
-            "url": { "type": "string" }
-          },
-          "required": ["action"],
-          "additionalProperties": true
-        }
-      },
-      {
-        "name": "browser_action",
-        "description": "Saved semantic browser actions (dynamic catalog \u2014 list then do). action=list (optional domain; includeSteps to see the full definition). action=save creates or replaces a named flow (domain+name). action=do runs one saved action with input. This does not record prior browser calls. Use browser_act for one-off clicks/types.",
-        "inputSchema": {
-          "type": "object",
-          "properties": {
-            "action": { "type": "string", "enum": ["list", "save", "do"] },
-            "domain": { "type": "string" },
-            "name": { "type": "string" },
-            "input": { "type": "object", "additionalProperties": true }
-          },
-          "required": ["action"],
-          "additionalProperties": true
-        }
-      },
       {
         "name": "miniapp_list",
         "description": "List mini-apps authorized for this session and their tools. Omit appId for a compact catalog (tool names + one-line descriptions). Pass appId to inspect one app; includeSchema defaults true for that app's full tool definitions including inputSchema. Call this before miniapp_call when you do not know the tool names or parameters.",
@@ -3624,13 +2537,16 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "automation_apply",
-        "description": "Create or update a project automation. action=create needs name, prompt, schedule; agentConfig optional (defaults claude + bypassPermissions). action=update needs id plus any of name/prompt/enabled/schedule/agentConfig (toggle via enabled). Always set schedule.summary to a short natural-language phrase for the UI (user language). Always opens a user confirmation dialog; applies nothing without approval. Call automation_list first for ids. Delete with automation_delete.",
+        "description": 'Create or update a project automation. create needs name, prompt, schedule; update needs id plus any field (pause via enabled=false). Call automation_list first for ids; remove with automation_delete. Always opens a user confirmation dialog and applies nothing without approval. For schedule and agentConfig shapes see read_manual({ domain: "product", topic: "automation" }).',
         "inputSchema": {
           "type": "object",
           "properties": {
             "action": {
               "type": "string",
-              "enum": ["create", "update"],
+              "enum": [
+                "create",
+                "update"
+              ],
               "description": "create a new automation, or update an existing one (including toggle enabled)."
             },
             "id": {
@@ -3651,11 +2567,14 @@ If the tool returns an error containing "user_locked", the user has manually nam
             },
             "schedule": {
               "type": "object",
-              "description": `When to run. one-time needs runAt (ISO). recurring needs cron (e.g. "0 9 * * *"). Always include summary: natural language for the confirm UI in the user's language (e.g. "Every weekday at 9:00 AM", "\u6BCF\u5929\u4E0A\u5348 9 \u70B9"). Machine fields still drive the scheduler.`,
+              "description": 'When to run. one-time needs runAt (ISO); recurring needs cron. Always include summary. Preset fields and examples: read_manual({ domain: "product", topic: "automation" }).',
               "properties": {
                 "type": {
                   "type": "string",
-                  "enum": ["one-time", "recurring"]
+                  "enum": [
+                    "one-time",
+                    "recurring"
+                  ]
                 },
                 "cron": {
                   "type": "string",
@@ -3667,7 +2586,12 @@ If the tool returns an error containing "user_locked", the user has manually nam
                 },
                 "preset": {
                   "type": "string",
-                  "enum": ["hourly", "daily", "weekly", "custom"]
+                  "enum": [
+                    "hourly",
+                    "daily",
+                    "weekly",
+                    "custom"
+                  ]
                 },
                 "timeOfDay": {
                   "type": "string",
@@ -3692,19 +2616,27 @@ If the tool returns an error containing "user_locked", the user has manually nam
                   "type": "string",
                   "minLength": 1,
                   "maxLength": 200,
-                  "description": `Natural-language schedule shown in the UI (list + confirm). Use the user's language. Examples: "Every weekday at 9:00 AM", "\u6BCF\u5929\u4E0A\u5348 9 \u70B9", "Once on May 1 at 3pm". Required for create.`
+                  "description": `Natural-language schedule shown in the list and confirm dialog, in the user's language (e.g. "Every weekday at 9:00 AM"). Required for create.`
                 }
               },
-              "required": ["type", "summary"],
+              "required": [
+                "type",
+                "summary"
+              ],
               "additionalProperties": false
             },
             "agentConfig": {
               "type": "object",
-              "description": "Harness + model for the automation run. type is required (claude|codex|acp|opencode). Defaults on create: claude + bypassPermissions + sandbox off. Prefer unified fields: model, effort, permissionMode, sandboxMode, apiProviderId, acpAgentId.",
+              "description": 'Harness for the run; only type is required. Create defaults to claude + bypassPermissions. Field-by-field: read_manual({ domain: "product", topic: "automation" }).',
               "properties": {
                 "type": {
                   "type": "string",
-                  "enum": ["claude", "codex", "acp", "opencode"]
+                  "enum": [
+                    "claude",
+                    "codex",
+                    "acp",
+                    "opencode"
+                  ]
                 },
                 "agentName": {
                   "type": "string",
@@ -3719,16 +2651,31 @@ If the tool returns an error containing "user_locked", the user has manually nam
                 },
                 "permissionMode": {
                   "type": "string",
-                  "enum": ["default", "acceptEdits", "bypassPermissions", "plan", "dontAsk", "auto", "agent"],
+                  "enum": [
+                    "default",
+                    "acceptEdits",
+                    "bypassPermissions",
+                    "plan",
+                    "dontAsk",
+                    "auto",
+                    "agent"
+                  ],
                   "description": "Unified permission mode. Prefer bypassPermissions for unattended runs."
                 },
                 "sandboxMode": {
                   "type": "string",
-                  "enum": ["off", "on", "auto"],
+                  "enum": [
+                    "off",
+                    "on",
+                    "auto"
+                  ],
                   "description": "Claude sandbox (ignored by other harnesses)."
                 },
                 "apiProviderId": {
-                  "type": ["string", "null"],
+                  "type": [
+                    "string",
+                    "null"
+                  ],
                   "description": "Optional third-party AI provider credential id (claude/codex)."
                 },
                 "acpAgentId": {
@@ -3737,20 +2684,37 @@ If the tool returns an error containing "user_locked", the user has manually nam
                 },
                 "reasoningEffort": {
                   "type": "string",
-                  "enum": ["minimal", "low", "medium", "high", "xhigh", "max", "ultra"],
+                  "enum": [
+                    "minimal",
+                    "low",
+                    "medium",
+                    "high",
+                    "xhigh",
+                    "max",
+                    "ultra"
+                  ],
                   "description": "Codex legacy alias for effort."
                 },
                 "permissionPreset": {
                   "type": "string",
-                  "enum": ["read-only", "default", "auto-review", "full-access"],
+                  "enum": [
+                    "read-only",
+                    "default",
+                    "auto-review",
+                    "full-access"
+                  ],
                   "description": "Codex legacy alias for permissionMode (full-access \u2248 bypassPermissions)."
                 }
               },
-              "required": ["type"],
+              "required": [
+                "type"
+              ],
               "additionalProperties": false
             }
           },
-          "required": ["action"],
+          "required": [
+            "action"
+          ],
           "additionalProperties": false
         }
       },
@@ -3797,17 +2761,17 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "device_list",
-        "description": "Browse the devices this machine can offer, one tier at a time \u2014 a dev machine holds over a hundred simulators, so this never dumps them all. No arguments: what is running (attaching is instant; a cold boot costs ~20s), what this project used before, and which kinds exist. kind: that kind's models. model: that model's devices, one per runtime, with the ids. Prefer a running or recent device; ids only matter when you need a specific runtime, since device_request_control also takes a model name and picks its newest. Free and side-effect-free \u2014 it grants nothing and boots nothing.",
+        "description": "Browse the devices this machine can offer, one tier at a time. No arguments: what is running, what this project used before, and which kinds exist. kind: its models. model: its devices, one per runtime, with ids. Prefer a running or recent one \u2014 attaching is instant, a cold boot costs ~20s. Free: it grants nothing and boots nothing.",
         "inputSchema": {
           "type": "object",
           "properties": {
             "kind": {
-              "type": "string",
-              "description": 'Narrow to one family: "iphone", "ipad", "watch", "tv", "vision". Returns its models.'
+              "description": 'Narrow to one family: "iphone", "ipad", "watch", "tv", "vision". Returns its models.',
+              "type": "string"
             },
             "model": {
-              "type": "string",
-              "description": 'A model name from the kind tier ("iPhone 17 Pro Max"). Returns one entry per runtime, with ids.'
+              "description": 'A model name from the kind tier ("iPhone 17 Pro Max"). Returns one entry per runtime, with ids.',
+              "type": "string"
             }
           },
           "additionalProperties": false
@@ -3815,14 +2779,19 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "device_request_control",
-        "description": "Ask the user to let this session control one specific device, and wait for their answer. Every other device_* tool needs that grant and fails with NO_DEVICE until this succeeds \u2014 call it first, not after a failure. Pick the device from device_list yourself; the user only approves or declines, and a decline carries their feedback (often naming a different device \u2014 read it before retrying). Returns it once bound and ready, booting it if it was not running; asking again for one this session already holds returns it without prompting. A session may hold several, and then every device_* call must name one with `device`. Install a build afterwards with `xcrun simctl install/launch`.",
+        "description": 'Ask the user to let this session control one device, and wait for their answer. Every other device_* tool fails with NO_DEVICE until this succeeds \u2014 call it first, not after a failure. Pick the device from device_list yourself; a decline carries feedback that often names a different one. Returns it bound and booted. See read_manual({ domain: "product", topic: "devices" }).',
         "inputSchema": {
           "type": "object",
           "properties": {
-            "description": deviceDescriptionProperty,
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short explanation of this step for the user watching, in the conversation's language (e.g. 'Open the profile tab'). Shown in place of refs and coordinates."
+            },
             "device": {
               "type": "string",
-              "description": 'The id from device_list. A device name ("iPhone 17 Pro Max") is matched loosely against the catalog as a fallback, but the id is what makes the approved device the one you meant.'
+              "description": "The id from device_list. A name is matched loosely as a fallback, but the id is what makes the approved device the one you meant."
             }
           },
           "required": [
@@ -3834,13 +2803,29 @@ If the tool returns an error containing "user_locked", the user has manually nam
       },
       {
         "name": "device_snapshot",
-        "description": "Capture the screen and return a stateId later calls must quote. mode=semantic (default) returns the accessibility tree with @eN refs, labels, identifiers and bounds \u2014 prefer it: refs survive animation and rotation, coordinates do not. mode=visual saves a PNG and returns image.path (not pixels); Read it to look. fused returns both. Waits for animation to stop; settled=false means geometry is approximate. A region with no accessibility tree \u2014 a WebView, a canvas \u2014 has its text read from pixels and merged in, marked (ocr): tap those, never press. The reply says source=ocr or hybrid. Re-snapshot after anything that changes the screen \u2014 refs are positional and device_act rejects a stale stateId.",
+        "description": 'Capture the screen and return a stateId later calls must quote. Waits for animation to stop. mode=semantic (default) returns the accessibility tree with @eN refs \u2014 prefer it: refs survive animation and rotation, coordinates do not. mode=visual saves a PNG and returns image.path (not pixels); Read it to look. fused returns both. Regions with no tree (WebView, canvas) are read from pixels and marked (ocr): tap those, never press. Re-snapshot after anything that changes the screen \u2014 refs are positional and device_act rejects a stale stateId. See read_manual({ domain: "product", topic: "devices" }).',
         "inputSchema": {
           "type": "object",
           "properties": {
-            "description": deviceDescriptionProperty,
-            "device": deviceTargetProperty,
-            "mode": { "description": "Default semantic", "type": "string", "enum": ["semantic", "visual", "fused"] },
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short explanation of this step for the user watching, in the conversation's language (e.g. 'Open the profile tab'). Shown in place of refs and coordinates."
+            },
+            "device": {
+              "description": "Device id or name from device_list. Optional while this session controls exactly one; required once it holds more. Use device_request_control to be granted another.",
+              "type": "string"
+            },
+            "mode": {
+              "description": "Default semantic",
+              "type": "string",
+              "enum": [
+                "semantic",
+                "visual",
+                "fused"
+              ]
+            },
             "maxNodes": {
               "description": "Ceiling on tree size. Default 500; truncated=true means the screen has more.",
               "type": "integer",
@@ -3848,54 +2833,295 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "maximum": 2e3
             }
           },
-          "required": ["description"],
+          "required": [
+            "description"
+          ],
           "additionalProperties": false
         }
       },
       {
         "name": "device_query",
-        "description": "Search or inspect an existing snapshot without re-capturing the device. Use this instead of taking another snapshot when you only need to find an element or read its details \u2014 it costs no device round trip and cannot race an animation. op=search matches text against labels, values and identifiers. op=inspect returns one element and its children.",
+        "description": "Search or inspect an existing snapshot without re-capturing the device. Prefer it over another snapshot when you only need to find an element or read its details: no device round trip, and it cannot race an animation. op=search matches labels, values and identifiers; op=inspect returns one element and its children.",
         "inputSchema": {
           "type": "object",
           "properties": {
-            "description": deviceDescriptionProperty,
-            "device": deviceTargetProperty,
-            "stateId": { "type": "string", "description": "From a prior device_snapshot." },
-            "op": { "type": "string", "enum": ["search", "inspect"] },
-            "text": { "description": "For search.", "type": "string" },
-            "ref": { "description": 'For inspect, e.g. "@e12".', "type": "string" }
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short explanation of this step for the user watching, in the conversation's language (e.g. 'Open the profile tab'). Shown in place of refs and coordinates."
+            },
+            "device": {
+              "description": "Device id or name from device_list. Optional while this session controls exactly one; required once it holds more. Use device_request_control to be granted another.",
+              "type": "string"
+            },
+            "stateId": {
+              "type": "string",
+              "description": "From a prior device_snapshot."
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "search",
+                "inspect"
+              ]
+            },
+            "text": {
+              "description": "For search.",
+              "type": "string"
+            },
+            "ref": {
+              "description": 'For inspect, e.g. "@e12".',
+              "type": "string"
+            }
           },
-          "required": ["description", "stateId", "op"],
+          "required": [
+            "description",
+            "stateId",
+            "op"
+          ],
           "additionalProperties": false
         }
       },
       {
         "name": "device_act",
-        "description": "Run 1-10 touch actions against a snapshot, then re-observe to judge if they worked. Actions: tap, doubleTap, longPress, swipe(direction|toX/toY), pinch(scale), press(ref), type, key, rotate, keyboard. Prefer refs; press uses accessibility and is resilient to animation (use tap for source=ocr). Raw x/y is a last resort. The batch and stale stateId are validated before side effects. rotate must be last; re-snapshot afterwards. Set recording=true to save a short video containing only this action transaction. Returns worked|didnt|unknown. Pass expect to define and wait for success.",
+        "description": 'Run 1-10 touch actions against a snapshot, then re-observe to judge if they worked. Prefer refs; press survives animation, but use tap for source=ocr and raw x/y only as a last resort. The batch and a stale stateId are validated before any side effect. rotate must be last, then re-snapshot. Returns worked|didnt|unknown; pass expect to define success. See read_manual({ domain: "product", topic: "devices" }).',
         "inputSchema": {
           "type": "object",
           "properties": {
-            "description": deviceDescriptionProperty,
-            "device": deviceTargetProperty,
-            "stateId": { "type": "string" },
-            "actions": { "minItems": 1, "maxItems": 10, "type": "array", "items": deviceActionSchema },
-            "expect": { "description": "Postcondition checked after the actions run.", ...deviceConditionSchema },
-            "timeoutMs": { "description": "Maximum wait for expect before the action is judged. Default 5000.", "type": "integer", "minimum": 100, "maximum": 6e4 },
-            "recording": { "description": "Save a video of only this action transaction. Default false.", "type": "boolean" }
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short explanation of this step for the user watching, in the conversation's language (e.g. 'Open the profile tab'). Shown in place of refs and coordinates."
+            },
+            "device": {
+              "description": "Device id or name from device_list. Optional while this session controls exactly one; required once it holds more. Use device_request_control to be granted another.",
+              "type": "string"
+            },
+            "stateId": {
+              "type": "string"
+            },
+            "actions": {
+              "minItems": 1,
+              "maxItems": 10,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "tap",
+                      "doubleTap",
+                      "longPress",
+                      "swipe",
+                      "pinch",
+                      "press",
+                      "type",
+                      "key",
+                      "rotate",
+                      "keyboard"
+                    ]
+                  },
+                  "ref": {
+                    "description": 'Element ref from the snapshot, e.g. "@e12". Preferred over coordinates.',
+                    "type": "string"
+                  },
+                  "x": {
+                    "description": "Horizontal position as a fraction of the screen (0-1). Only when no ref fits.",
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  },
+                  "y": {
+                    "description": "Vertical position as a fraction of the screen (0-1).",
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  },
+                  "direction": {
+                    "description": 'swipe: which way the finger travels. Content moves the opposite way, so "up" scrolls down a list.',
+                    "type": "string",
+                    "enum": [
+                      "up",
+                      "down",
+                      "left",
+                      "right"
+                    ]
+                  },
+                  "distance": {
+                    "description": "swipe: travel as a fraction of the screen. Default 0.6.",
+                    "type": "number",
+                    "minimum": 0.05,
+                    "maximum": 1
+                  },
+                  "toX": {
+                    "description": "swipe: explicit destination instead of direction.",
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  },
+                  "toY": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  },
+                  "scale": {
+                    "description": "pinch: final separation factor. Below 1 pinches in (zoom out), above 1 spreads.",
+                    "type": "number",
+                    "minimum": 0.1,
+                    "maximum": 5
+                  },
+                  "durationMs": {
+                    "description": "How long the gesture takes. Short swipes flick and coast; long ones drag and stop.",
+                    "type": "integer",
+                    "minimum": 16,
+                    "maximum": 1e4
+                  },
+                  "text": {
+                    "description": "type: text to enter. Anything the simulated keyboard cannot spell (Chinese, emoji) is pasted automatically.",
+                    "type": "string"
+                  },
+                  "button": {
+                    "description": "key: a hardware button. `back` and `app-switch` are Android-only and are refused elsewhere.",
+                    "type": "string",
+                    "enum": [
+                      "home",
+                      "lock",
+                      "side",
+                      "volume-up",
+                      "volume-down",
+                      "back",
+                      "app-switch"
+                    ]
+                  },
+                  "orientation": {
+                    "type": "string",
+                    "enum": [
+                      "portrait",
+                      "landscape-left",
+                      "portrait-upside-down",
+                      "landscape-right"
+                    ]
+                  },
+                  "connected": {
+                    "description": "keyboard: attach or detach the hardware keyboard. Detach it to make the on-screen keyboard appear.",
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "expect": {
+              "description": "Postcondition checked after the actions run.",
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "exists",
+                    "notExists",
+                    "textEquals",
+                    "textContains"
+                  ]
+                },
+                "ref": {
+                  "description": "Only valid within the snapshot it came from; prefer label or identifier when waiting.",
+                  "type": "string"
+                },
+                "label": {
+                  "description": "Visible name of the element.",
+                  "type": "string"
+                },
+                "identifier": {
+                  "description": "Developer-assigned id. Survives copy changes and translation \u2014 the most durable target.",
+                  "type": "string"
+                },
+                "text": {
+                  "description": "The string textEquals/textContains compares against. Required by those two kinds, and NOT a way to name an element \u2014 use label for that.",
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false
+            },
+            "timeoutMs": {
+              "description": "Maximum wait for expect before the action is judged. Default 5000.",
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 6e4
+            },
+            "recording": {
+              "description": "Save a video of only this action transaction. Default false.",
+              "type": "boolean"
+            }
           },
-          "required": ["description", "stateId", "actions"],
+          "required": [
+            "description",
+            "stateId",
+            "actions"
+          ],
           "additionalProperties": false
         }
       },
       {
         "name": "device_wait_for",
-        "description": "Wait until the screen satisfies a condition. Use this instead of snapshotting in a loop. Distinguishes preexisting (already true when asked) from verified (became true while waiting), so you can tell a real transition from a check that was never going to fail. Returns a fresh settled stateId and matching tree when successful. Target the element by label or identifier, not by ref: refs belong to one snapshot, and what you are waiting for usually does not exist yet. Every condition must name an element that way \u2014 text only says what to compare, it never selects.",
+        "description": "Wait until the screen satisfies a condition, instead of snapshotting in a loop. Target the element by label or identifier, never by ref: refs belong to one snapshot and what you are waiting for usually does not exist yet \u2014 text only says what to compare, it never selects. Returns a fresh settled stateId and tree, and reports preexisting vs verified.",
         "inputSchema": {
           "type": "object",
           "properties": {
-            "description": deviceDescriptionProperty,
-            "device": deviceTargetProperty,
-            "condition": deviceConditionSchema,
+            "description": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short explanation of this step for the user watching, in the conversation's language (e.g. 'Open the profile tab'). Shown in place of refs and coordinates."
+            },
+            "device": {
+              "description": "Device id or name from device_list. Optional while this session controls exactly one; required once it holds more. Use device_request_control to be granted another.",
+              "type": "string"
+            },
+            "condition": {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "exists",
+                    "notExists",
+                    "textEquals",
+                    "textContains"
+                  ]
+                },
+                "ref": {
+                  "description": "Only valid within the snapshot it came from; prefer label or identifier when waiting.",
+                  "type": "string"
+                },
+                "label": {
+                  "description": "Visible name of the element.",
+                  "type": "string"
+                },
+                "identifier": {
+                  "description": "Developer-assigned id. Survives copy changes and translation \u2014 the most durable target.",
+                  "type": "string"
+                },
+                "text": {
+                  "description": "The string textEquals/textContains compares against. Required by those two kinds, and NOT a way to name an element \u2014 use label for that.",
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false
+            },
             "timeoutMs": {
               "description": "Default 5000",
               "type": "integer",
@@ -3903,7 +3129,89 @@ If the tool returns an error containing "user_locked", the user has manually nam
               "maximum": 6e4
             }
           },
-          "required": ["description", "condition"],
+          "required": [
+            "description",
+            "condition"
+          ],
+          "additionalProperties": false
+        }
+      },
+      {
+        "name": "browser_perf",
+        "description": "Profile what a page (or SuperOne itself) burns CPU on: hotspot functions by self time, plus layout/style/heap deltas. Pass `action` to measure ONE interaction: the window opens and closes around it, and a ~1s ambient baseline is subtracted. Omit `action` to profile steady state for `sampleMs` (no baseline; the only mode for target='app'). The reply flags a truncated window or a non-script bottleneck when either applies.",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "tab": {
+              "description": "Browser view id. Omit to target the focused browser view (errors if multiple are open).",
+              "type": "string"
+            },
+            "description": {
+              "description": "A short, human-friendly explanation of what this action accomplishes, phrased for the end user watching. Shown in the UI in place of the raw selector. Write it in the conversation's language.",
+              "type": "string"
+            },
+            "target": {
+              "description": "'tab' (default) = a browser view. 'app' = SuperOne's own renderer; sample mode only.",
+              "type": "string",
+              "enum": [
+                "tab",
+                "app"
+              ]
+            },
+            "action": {
+              "description": "Action mode: the action runs inside the profiling window. Omit for sample mode.",
+              "type": "object",
+              "properties": {
+                "tool": {
+                  "type": "string",
+                  "description": "Browser primitive to measure, e.g. 'browser_click', 'browser_navigate', 'browser_scroll'."
+                },
+                "args": {
+                  "description": "Arguments for that tool, as you would pass them directly.",
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                }
+              },
+              "required": [
+                "tool"
+              ],
+              "additionalProperties": false
+            },
+            "sampleMs": {
+              "description": "Sample mode: how long to profile steady-state load. Default 3000.",
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "until": {
+              "description": "Action mode: explicit completion signal for an exact window.",
+              "type": "object",
+              "properties": {
+                "urlContains": {
+                  "type": "string"
+                },
+                "selector": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            "maxWaitMs": {
+              "description": "Action mode: upper bound on the wait. Default 10000.",
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "baselineMs": {
+              "description": "Action mode: ambient-load sample length. Default 1000.",
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
           "additionalProperties": false
         }
       }
@@ -70921,8 +70229,8 @@ import { fileURLToPath } from "node:url";
 function resolveCliReleaseVersion() {
   const fromEnv = process.env.SUPERONE_CLI_VERSION?.trim();
   if (fromEnv) return fromEnv;
-  if ("0.58.0-alpha".trim()) {
-    return "0.58.0-alpha".trim();
+  if ("0.59.0-alpha".trim()) {
+    return "0.59.0-alpha".trim();
   }
   const fromDist = readDistManifestVersion();
   if (fromDist) return fromDist;
@@ -78142,7 +77450,7 @@ import { existsSync as existsSync28, mkdirSync as mkdirSync17, readFileSync as r
 import { arch as osArch2, platform as osPlatform2 } from "node:os";
 import { join as join26, resolve as resolve7 } from "node:path";
 var OFFICIAL_CLAUDE_SDK_VERSION = "0.3.246";
-var OFFICIAL_CODEX_NPM_VERSION = "0.149.0";
+var OFFICIAL_CODEX_NPM_VERSION = "0.150.1";
 var OFFICIAL_CODEX_PACKAGE = "@openai/codex";
 function codexPlatformPackageVersion(baseVersion = OFFICIAL_CODEX_NPM_VERSION) {
   const platform2 = process.platform;
@@ -78784,11 +78092,12 @@ function resolveManagedTarballBinary(id, installRoot) {
   return resolveCodexNativeUnderPrefix(installRoot) ?? resolveOfficialInstallBinaryInRoot("codex", installRoot);
 }
 function readRuntimeVersionFromRoot(id, installRoot) {
+  let metadataVersion = null;
   try {
     const metaPath = join27(installRoot, "install-meta.json");
     if (existsSync31(metaPath)) {
       const raw = JSON.parse(readFileSync17(metaPath, "utf8"));
-      if (raw.runtimeVersion) return raw.runtimeVersion;
+      metadataVersion = raw.runtimeVersion?.trim() || null;
     }
   } catch {
   }
@@ -78802,7 +78111,7 @@ function readRuntimeVersionFromRoot(id, installRoot) {
     }
   } catch {
   }
-  return null;
+  return metadataVersion;
 }
 async function resolveArtifactPin(id, channel, opts, fetchJson) {
   if (opts.artifactPin !== void 0) return opts.artifactPin;
@@ -78870,16 +78179,24 @@ function createManagedTarballInstaller(opts = {}) {
       }
       const channel = resolveHarnessManifestChannel(opts.channel, opts.releaseVersion);
       const artifactPin = await resolveArtifactPin(id, channel, opts, fetchJson);
+      const compatibleArtifactPin = artifactPin && pins.packages.some(
+        (pkg) => pkg.name === artifactPin.npmName && pkg.version === artifactPin.npmVersion
+      ) ? artifactPin : null;
+      if (artifactPin && !compatibleArtifactPin) {
+        log2?.warn?.(
+          `[harness] ignoring stale ${id} artifact ${artifactPin.npmName}@${artifactPin.npmVersion}; requested ${pins.packages.map((pkg) => `${pkg.name}@${pkg.version}`).join(", ")}`
+        );
+      }
       let packageSpec = "";
       let source = "npm-tarball";
       mkdirSync19(versionDir, { recursive: true });
       for (const pkg of pins.packages) {
-        const npmName = artifactPin?.npmName ?? pkg.name;
-        const npmVersion = artifactPin?.npmVersion ?? pkg.version;
+        const npmName = compatibleArtifactPin?.npmName ?? pkg.name;
+        const npmVersion = compatibleArtifactPin?.npmVersion ?? pkg.version;
         packageSpec = `${npmName}@${npmVersion}`;
         const downloadKey = harnessArtifactDownloadKey({
           harnessId: id,
-          digestSha256: artifactPin?.digestSha256,
+          digestSha256: compatibleArtifactPin?.digestSha256,
           npmName,
           npmVersion
         });
@@ -78890,7 +78207,7 @@ function createManagedTarballInstaller(opts = {}) {
             destPath: partialPath,
             npmName,
             npmVersion,
-            pin: artifactPin,
+            pin: compatibleArtifactPin,
             npmOnly: opts.npmOnly === true,
             fetchJson,
             downloadToFile,
@@ -78922,7 +78239,7 @@ function createManagedTarballInstaller(opts = {}) {
             packageSpec,
             source,
             channel,
-            digestSha256: artifactPin?.digestSha256 ?? null,
+            digestSha256: compatibleArtifactPin?.digestSha256 ?? null,
             installedAt: Date.now()
           },
           null,
@@ -78949,7 +78266,7 @@ function createManagedTarballInstaller(opts = {}) {
           packageSpec,
           installPrefix: versionDir,
           channel,
-          digestSha256: artifactPin?.digestSha256,
+          digestSha256: compatibleArtifactPin?.digestSha256,
           runtimeVersion: pins.runtimeVersion
         }
       };