click_element

Added value: +"http://json-schema.org/draft-07/schema#"

Removed value: -false

Previous value: -"Narration level. rich includes UIA or browser state diff when supported, and is withheld with post.rich.diffDegraded when the diff cannot be shown to describe the window that was acted on."New value: +"Narration level. \"rich\": include UIA diff in post.rich (appeared/disappeared/valueDeltas, and nameDeltas when an element's name changed, such as a calculator display) — usually removes the need for a verification screenshot. It is withheld, with post.rich.diffDegraded saying why, when the diff cannot be shown to describe the window that was acted on. On click_element and keyboard (and set_element_value where the server registers it), which resolve the target window before acting: another open window's title contains the text this call resolved to, whether you named the hwnd or the server did — \"@active\" and the dialog rescue both resolve one (\"ambiguous_title\"); or the target moved between the snapshot and the action (\"target_changed\"). On those and on mouse_click, retrying with a fixId also withholds it, because the stored fix names a window this cannot see (\"fix_target_unknown\") — browser tools keep their diff on a fixId retry, because theirs is a tab diff and does not depend on a window title. mouse_click and mouse_drag accept an hwnd and still take their snapshots by windowTitle, so nothing else is withheld for them: verify those with a screenshot. A window too large to read whole is withheld too (\"tree_truncated\"). The action itself is unaffected in every case; only the diff is. Default: \"minimal\"."

Previous value: -"Narration level. rich includes UIA or browser state diff when supported."New value: +"Narration level. rich includes UIA or browser state diff when supported, and is withheld with post.rich.diffDegraded when the diff cannot be shown to describe the window that was acted on."

Added value: +{
+  "description": "Optional response-shape opt-in. `['envelope']` returns the self-documenting envelope (`_version` / `data` / `as_of` / `confidence`). `['raw']` forces raw shape (overrides DESKTOP_TOUCH_ENVELOPE=1 server default). Default behaviour is raw shape (compat with existing clients).",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Direct window handle ID (takes precedence over windowTitle). String to avoid 64-bit precision issues.",
+  "maxLength": 20,
+  "type": "string"
+}

Previous value: -"Partial window title of the target window"New value: +"Partial window title of the target window. Use '@active' for the current foreground window."

Added value: +{
+  "description": "Approve a pending suggestedFix (one-shot, 15s TTL).",
+  "type": "string"
+}

Removed value: -"http://json-schema.org/draft-07/schema#"

Added value: +false

Removed value: -{
-  "description": "Stub tool — arguments ignored."
-}

Added value: +{
+  "description": "Exact AutomationId of the element",
+  "maxLength": 200,
+  "type": "string"
+}

Added value: +{
+  "description": "Control type filter, e.g. 'Button', 'MenuItem'",
+  "maxLength": 100,
+  "type": "string"
+}

Added value: +{
+  "description": "Optional perception lens ID. Guards (safe.keyboardTarget, target.identityStable) are evaluated before clicking, and a perception envelope is attached to post.perception on success.",
+  "type": "string"
+}

Added value: +{
+  "description": "Element name/label (partial match, case-insensitive)",
+  "maxLength": 200,
+  "type": "string"
+}

Added value: +{
+  "default": "minimal",
+  "description": "Narration level. rich includes UIA or browser state diff when supported.",
+  "enum": [
+    "minimal",
+    "rich"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Partial window title of the target window",
+  "maxLength": 200,
+  "type": "string"
+}

Added value: +[
+  "windowTitle"
+]