glass_do

Added value: +{
+  "enum": [
+    "auto",
+    "native",
+    "pointer"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "query": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "role": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "states": {
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "query": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "role": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "states": {
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "within": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ActionScopeArgs"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "type": "object"
+}

Previous value: -"Consecutive clicks at this point (default 1, valid range 1 through 10); pass 2 for a\ndouble-click."New value: +"Click count (default 1, range 1 through 10); 2 double-clicks."

Previous value: -"Modifier keys to hold during the action, e.g. [\"ctrl\"] or [\"ctrl\",\"shift\"] for multi/range-select."New value: +"Held modifiers, e.g. [\"ctrl\", \"shift\"]."

Previous value: -"Click point x, window-relative — 0 is the window's left edge, not the screen's."New value: +"Click x in window-relative pixels."

Previous value: -"Click point y, window-relative — 0 is the window's top edge, not the screen's."New value: +"Click y in window-relative pixels."

Previous value: -"Element `#id` from the latest `glass_a11y_snapshot`.\nRe-snapshot after UI changes.\nPopover-owned targets route to their window and restore the prior active window.\nThe role-appropriate native accessibility operation handles occluded or off-screen targets\nand separate labels through their enclosing control.\nUnavailable native operations fall back to a pointer click at the target center.\nText editors may receive focus without activation.\n`method:\"native-action\"` labels any native path.\n`native_fallback` explains pointer fallback.\n`actuated_id` identifies a substituted enclosing control."New value: +"Latest snapshot ID, exclusive with target; re-read after UI changes. Native action may focus text editors; fallback clicks the center. Popover actions restore the prior window."

Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]

Added value: +{
+  "format": "uint32",
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ActionModeArg"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Previous value: -"Terminal observation: \"snapshot\" settles and refreshes/folds a11y, \"settle\" waits for\nvisual stability and returns text-only metadata, and \"none\" skips observation (default)."New value: +"none (default): no observation; settle: text-only visual stability; snapshot: settle and refresh/fold the accessibility tree."

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ActionTargetArgs"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Added value: +{
+  "format": "uint64",
+  "maximum": 120000,
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Removed value: -[
-  "id"
-]

Previous value: -"Window-relative rectangles to exclude from the comparison. Use for\nperpetually animating content — a blinking text caret, a clock, a\nspinner — which otherwise keeps `changed_pct` permanently non-zero.\n`changed_pct` is measured over the pixels that remain; the excluded\ncount is reported as `ignored_pixels`. Combines with `region`: rects are\nalways window-relative and are intersected with it."New value: +"Window-relative excluded rects intersected with region. changed_pct uses remaining pixels; ignored_pixels reports the excluded count."

Added value: +{
+  "description": "Maximum returned image height; omit both limits for native output.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Maximum returned image width; shrinks after crop, preserving native comparison pixels.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Name of a baseline saved by `glass_baseline_save`; an unsaved name errors\nrather than reporting no change."New value: +"Saved baseline name; unsaved names error."

Previous value: -"Optional window-relative sub-rectangle to diff; omit to diff the whole\nwindow. Scopes the comparison (and the reported `bbox`, which becomes\nregion-relative) to just this area — the way to ask \"did *only* this part\nchange?\" Mirrors `glass_wait_for_region`'s `region`."New value: +"Window-relative comparison area; omit for whole window. Returned bbox is region-relative."

Previous value: -"Span the drag's motion over this many milliseconds so a frame-based GUI\nsamples the path across multiple frames (and registers the drag even while\nit repaints). Default 200. Lower = faster but coarser."New value: +"Motion duration in ms (default 200). Faster motion gives the app fewer sampled frames."

Previous value: -"Modifier keys to hold during the action, e.g. [\"ctrl\"] or [\"ctrl\",\"shift\"] for multi/range-select."New value: +"Held modifiers, e.g. [\"ctrl\", \"shift\"]."

Previous value: -"Press-point x, window-relative — 0 is the window's left edge, not the screen's."New value: +"Press x in window-relative pixels."

Previous value: -"Release-point x, window-relative."New value: +"Release x in window-relative pixels."

Previous value: -"Press-point y, window-relative — 0 is the window's top edge, not the screen's."New value: +"Press y in window-relative pixels."

Previous value: -"Release-point y, window-relative."New value: +"Release y in window-relative pixels."

Previous value: -"A chord like \"ctrl+s\", \"Return\", \"alt+F4\"."New value: +"Modifiers plus one key: ctrl+s, Return, alt+F4. Modifiers: ctrl/shift/alt/super (cmd/win/meta aliases). Key: named key, F1-F12 or printable ASCII; case-insensitive names."

Previous value: -"Destination x, window-relative — 0 is the window's left edge, not the screen's."New value: +"Destination x in window-relative pixels."

Previous value: -"Destination y, window-relative — 0 is the window's top edge, not the screen's."New value: +"Destination y in window-relative pixels."

Previous value: -"Height in pixels, extending down from `y`."New value: +"Height in pixels."

Previous value: -"Width in pixels, extending right from `x`."New value: +"Width in pixels."

Previous value: -"Left edge in pixels, window-relative — 0 is the window's left edge, not the screen's."New value: +"Left edge in window-relative pixels."

Previous value: -"Top edge in pixels, window-relative — 0 is the window's top edge, not the screen's."New value: +"Top edge in window-relative pixels."

Added value: +{
+  "description": "Maximum returned image height; omit both limits for native output.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Maximum returned image width; shrinks after crop, preserving native comparison pixels.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Capture/observe this window (id from `glass_list_windows`) instead of the\nactive one, without changing which window subsequent ops target. Omit for\nthe active window."New value: +"Observe this current glass_list_windows ID without selecting it; omit for active window."

Previous value: -"Horizontal wheel notches from -100 through 100, not pixels.\nPositive is right and negative is left, repeated `|dx|` times.\nTypical values are 1–5."New value: +"Horizontal wheel notches, -100 through 100 (positive right, negative left); typically 1-5, not pixels."

Previous value: -"Vertical wheel notches from -100 through 100, not pixels.\nPositive is down and negative is up, repeated `|dy|` times.\nTypical values are 1–5.\nApps choose how a notch maps to lines, pixels, or zoom."New value: +"Vertical wheel notches, -100 through 100 (positive down, negative up); typically 1-5. App determines distance/zoom."

Previous value: -"Modifier keys to hold during the action, e.g. [\"ctrl\"] or [\"ctrl\",\"shift\"] for multi/range-select."New value: +"Held modifiers, e.g. [\"ctrl\", \"shift\"]."

Previous value: -"Pointer x the wheel is aimed at, window-relative — apps scroll the container\nunder this point, so it selects which pane moves."New value: +"Window-relative anchor x; selects the container under the pointer."

Previous value: -"Pointer y the wheel is aimed at, window-relative. See `x`."New value: +"Window-relative anchor y."

Previous value: -"Substring of the target element's accessible description (selector). This can select\nan unnamed control, including an Android text field labelled only by its hint."New value: +"Accessible-description substring; can select unnamed controls."

Previous value: -"Sweep direction: \"up\"/\"down\" (vertical) or \"left\"/\"right\" (horizontal).\nOmit to infer it from the target's off-screen position (falls back to a\nvertical down→up sweep when the target isn't in the a11y tree yet). The\nsearch reverses to the other end if the target isn't found first."New value: +"up/down/left/right. Default infers off-screen direction, or down then up if absent. Reverses at the first end."

Previous value: -"Wheel notches per scroll step (default 3). A calibration escape hatch — larger\ncovers distance faster but risks stepping past a row's/column's realized band."New value: +"Wheel notches per step (default 3); large steps can skip realized rows."

Previous value: -"Give up after this long (default 20000ms); returns `{matched:false}`."New value: +"Timeout in ms (default 20000). Standalone: matched:false; batched: fails the sequence."

Previous value: -"Additionally require the matched element's `value` to contain this substring.\nNot a standalone selector — `name`, `description`, and/or `role` is still required."New value: +"Value substring; requires name, description and/or role."

Previous value: -"Scroll anchor x (window-relative). By default the swipe anchors on the target's\nown row/column (falling back to the window center if it isn't in the a11y tree\nyet); set both `x` and `y` to point the wheel at a specific container instead."New value: +"Window-relative anchor x; supply both x/y for a container. Default target row/column, or window center if absent."

Previous value: -"The element `#id` from `glass_a11y_snapshot`."New value: +"Latest snapshot ID, exclusive with target."

Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]

Added value: +{
+  "format": "uint32",
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Optional observe folded into the result: \"snapshot\" (wait for the UI to settle, then\nfold a fresh a11y tree, also refreshing the snapshot cache), \"settle\" (waits for visual\nstability and returns text-only metadata), or \"none\" (default)."New value: +"none (default): no observation; settle: text-only visual stability; snapshot: settle and refresh/fold the accessibility tree."

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ActionTargetArgs"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Previous value: -"The value to set. For a text field, the text. For a spin/slider, a number.\nFor a switch/checkbox/toggle, a boolean (`\"true\"`/`\"false\"`/`\"on\"`/`\"off\"`/\n`\"1\"`/`\"0\"`) — idempotent. For a dropdown/combo box, an option label\n(case-insensitive); glass opens it and picks that option."New value: +"Text, slider/spin number, toggle boolean (true/false/on/off/1/0), or case-insensitive combo option label. Toggle writes are idempotent; combos open and choose the option."

Added value: +{
+  "format": "uint64",
+  "maximum": 120000,
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -[
-  "id",
-  "text"
-]New value: +[
+  "text"
+]

Previous value: -"Window-relative rectangles to exclude from the settle comparison. Use for\nperpetually animating content — a blinking text caret, a clock, a\nspinner — which otherwise keeps the window from ever settling.\nCombines with `stability_region`: rects are always window-relative and\nare intersected with it. A rect that falls partially or entirely\noutside the compared area is silently clamped or dropped, masking less\nthan requested or nothing at all — double-check placement."New value: +"Window-relative excluded rects intersected with stability_region. Off-area rects clamp/drop silently; check placement."

Previous value: -"Window-relative sub-rectangle to watch for settling; when set, changes outside\nit are ignored."New value: +"Window-relative area watched for settling."

Previous value: -"Give up after this long (default 5000ms).\nThis settle's timeout returns settled:false and completes the step.\nThe enclosing glass_do deadline fails the sequence."New value: +"Timeout in ms (default 5000) completes with settled:false. The overall glass_do deadline instead fails the sequence."

Previous value: -"Per-channel difference (0–255) two frames may have and still count as\nunchanged (default 0, exact match)."New value: +"Per-channel difference allowed (0-255, default 0)."

Previous value: -"Capture the window as an image — the only field here that always spends image\ntokens; prefer `diff` when you just need to know whether something changed."New value: +"Return a screenshot. Prefer diff for change detection without image tokens."

Previous value: -"Wait for the UI to stop changing first. Set this whenever `diff` or\n`screenshot` follows, or they observe a half-drawn frame."New value: +"Wait for quiescence before diff/screenshot; otherwise they may observe a half-drawn frame."

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ActionModeArg"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Added value: +{
+  "format": "uint32",
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Terminal observation: \"snapshot\" settles and refreshes/folds a11y, \"settle\" waits for\nvisual stability and returns text-only metadata, and \"none\" skips observation (default)."New value: +"none (default): no observation; settle: text-only visual stability; snapshot: settle and read the current accessibility tree, including app-visible text, with secure values redacted."

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ActionTargetArgs"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Previous value: -"Text to type into whatever currently has keyboard focus — this tool does not\nfocus a field, so click or `glass_click_element` one first. Sent as synthetic\nkey events, not pasted, so an app's per-keystroke handlers run."New value: +"Synthetic keystrokes, not paste. When `target` is omitted: current keyboard focus. When `target` is supplied: resolves and focuses the target, confirms focus, then types. Newlines do not press Return."

Added value: +{
+  "format": "uint64",
+  "maximum": 120000,
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"What to wait for (default \"appears\"): appears|disappears|enabled|disabled|\nchecked|unchecked|selected|unselected|expanded|collapsed|focused|visible|hidden.\n`checked`/`unchecked` only match a checkable element (one exposing a real toggle\nstate) — a non-toggle element matches neither."New value: +"Default appears. appears|disappears|enabled|disabled|checked|unchecked|selected|unselected|expanded|collapsed|focused|visible|hidden. checked/unchecked require a real checkable state."

Previous value: -"Substring of the element's accessible description (selector). Useful for unnamed\ncontrols whose platform label is exposed as a hint, help text, or description."New value: +"Accessible-description substring; can select unnamed controls."

Previous value: -"Give up after this long (default 10000ms); returns `{matched:false}`."New value: +"Timeout in ms (default 10000). Standalone: matched:false; batched: fails the sequence."

Previous value: -"Additionally require the matched element's `value` to contain this substring.\nNot a standalone selector — `name`, `description`, and/or `role` is still required."New value: +"Value substring; requires name, description and/or role; exclusive with value."

Previous value: -"Actions to run in order; must be non-empty. Fail-fast — the first failing\naction aborts the rest and reports its index, so a partial sequence may\nalready have landed."New value: +"Non-empty ordered actions; failure stops remaining steps. Completed mutations may already have landed."

Previous value: -"Optional observe run once after the last action, in the order settle → diff\n→ screenshot."New value: +"Terminal observation in order: settle, diff, screenshot."

Previous value: -"Overall sequence budget in milliseconds. Omit for 30000; valid range\n1..=120000. One absolute deadline is shared by all actions and terminal\nobservations."New value: +"Overall budget in ms (default 30000, range 1..120000), shared by all actions and terminal observations."

Previous value: -[
-  {
-    "$ref": "#/$defs/ClickArgs",
-    "properties": {
-      "action": {
-        "const": "click",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/MoveArgs",
-    "properties": {
-      "action": {
-        "const": "move",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/DragArgs",
-    "properties": {
-      "action": {
-        "const": "drag",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/ScrollArgs",
-    "properties": {
-      "action": {
-        "const": "scroll",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/TypeArgs",
-    "properties": {
-      "action": {
-        "const": "type",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/KeyArgs",
-    "properties": {
-      "action": {
-        "const": "key",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "$ref": "#/$defs/SettleArgs",
-    "properties": {
-      "action": {
-        "const": "settle",
-        "type": "string"
-      }
-    },
-    "required": [
-      "action"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "$ref": "#/$defs/ClickArgs",
+    "properties": {
+      "action": {
+        "const": "click",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/MoveArgs",
+    "properties": {
+      "action": {
+        "const": "move",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/DragArgs",
+    "properties": {
+      "action": {
+        "const": "drag",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/ScrollArgs",
+    "properties": {
+      "action": {
+        "const": "scroll",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/TypeArgs",
+    "properties": {
+      "action": {
+        "const": "type",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/KeyArgs",
+    "properties": {
+      "action": {
+        "const": "key",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/SettleArgs",
+    "properties": {
+      "action": {
+        "const": "settle",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/ClickElementArgs",
+    "properties": {
+      "action": {
+        "const": "click_element",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/SetValueArgs",
+    "properties": {
+      "action": {
+        "const": "set_value",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/WaitForElementArgs",
+    "properties": {
+      "action": {
+        "const": "wait_for_element",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "$ref": "#/$defs/ScrollToElementArgs",
+    "properties": {
+      "action": {
+        "const": "scroll_to_element",
+        "type": "string"
+      }
+    },
+    "required": [
+      "action"
+    ],
+    "type": "object"
+  }
+]

Previous value: -"Consecutive clicks at this point (default 1); pass 2 for a double-click."New value: +"Consecutive clicks at this point (default 1, valid range 1 through 10); pass 2 for a\ndouble-click."

Added value: +10

Previous value: -0New value: +1

Added value: +{
+  "properties": {
+    "id": {
+      "description": "Element `#id` from the latest `glass_a11y_snapshot`.\nRe-snapshot after UI changes.\nPopover-owned targets route to their window and restore the prior active window.\nThe role-appropriate native accessibility operation handles occluded or off-screen targets\nand separate labels through their enclosing control.\nUnavailable native operations fall back to a pointer click at the target center.\nText editors may receive focus without activation.\n`method:\"native-action\"` labels any native path.\n`native_fallback` explains pointer fallback.\n`actuated_id` identifies a substituted enclosing control.",
+      "format": "uint32",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "return": {
+      "description": "Terminal observation: \"snapshot\" settles and refreshes/folds a11y, \"settle\" waits for\nvisual stability and returns text-only metadata, and \"none\" skips observation (default).",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "id"
+  ],
+  "type": "object"
+}

Previous value: -"Horizontal scroll in **wheel notches** (discrete clicks — small integers like 1–5, NOT\npixels). Positive `dx` sends wheel-right, negative wheel-left; glass clicks `|dx|` times."New value: +"Horizontal wheel notches from -100 through 100, not pixels.\nPositive is right and negative is left, repeated `|dx|` times.\nTypical values are 1–5."

Added value: +100

Added value: +-100

Previous value: -"Vertical scroll in **wheel notches** (discrete clicks — small integers like 1–5, NOT\npixels). Positive `dy` sends wheel-down, negative wheel-up; glass clicks `|dy|` times. How\nan app maps a wheel notch to its view (lines, pixels, zoom) is the app's choice."New value: +"Vertical wheel notches from -100 through 100, not pixels.\nPositive is down and negative is up, repeated `|dy|` times.\nTypical values are 1–5.\nApps choose how a notch maps to lines, pixels, or zoom."

Added value: +100

Added value: +-100

Added value: +{
+  "properties": {
+    "description": {
+      "description": "Substring of the target element's accessible description (selector). This can select\nan unnamed control, including an Android text field labelled only by its hint.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "direction": {
+      "description": "Sweep direction: \"up\"/\"down\" (vertical) or \"left\"/\"right\" (horizontal).\nOmit to infer it from the target's off-screen position (falls back to a\nvertical down→up sweep when the target isn't in the a11y tree yet). The\nsearch reverses to the other end if the target isn't found first.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "name": {
+      "description": "Substring of the target element's accessible name (selector).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "role": {
+      "description": "Element role filter, e.g. \"ListItem\", \"Button\", \"Document\" (selector).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "step": {
+      "description": "Wheel notches per scroll step (default 3). A calibration escape hatch — larger\ncovers distance faster but risks stepping past a row's/column's realized band.",
+      "format": "uint32",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "timeout_ms": {
+      "description": "Give up after this long (default 20000ms); returns `{matched:false}`.",
+      "format": "uint64",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "value_contains": {
+      "description": "Additionally require the matched element's `value` to contain this substring.\nNot a standalone selector — `name`, `description`, and/or `role` is still required.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "x": {
+      "description": "Scroll anchor x (window-relative). By default the swipe anchors on the target's\nown row/column (falling back to the window center if it isn't in the a11y tree\nyet); set both `x` and `y` to point the wheel at a specific container instead.",
+      "format": "int32",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "y": {
+      "description": "Scroll anchor y (window-relative). See `x`.",
+      "format": "int32",
+      "type": [
+        "integer",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "properties": {
+    "id": {
+      "description": "The element `#id` from `glass_a11y_snapshot`.",
+      "format": "uint32",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "return": {
+      "description": "Optional observe folded into the result: \"snapshot\" (wait for the UI to settle, then\nfold a fresh a11y tree, also refreshing the snapshot cache), \"settle\" (waits for visual\nstability and returns text-only metadata), or \"none\" (default).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "text": {
+      "description": "The value to set. For a text field, the text. For a spin/slider, a number.\nFor a switch/checkbox/toggle, a boolean (`\"true\"`/`\"false\"`/`\"on\"`/`\"off\"`/\n`\"1\"`/`\"0\"`) — idempotent. For a dropdown/combo box, an option label\n(case-insensitive); glass opens it and picks that option.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "text"
+  ],
+  "type": "object"
+}

Previous value: -"Give up after this long (default 5000ms); the sequence continues rather than\nfailing."New value: +"Give up after this long (default 5000ms).\nThis settle's timeout returns settled:false and completes the step.\nThe enclosing glass_do deadline fails the sequence."

Previous value: -"Optional observe folded into the result: \"snapshot\" (wait for the UI to settle, then\nfold a fresh a11y tree, also refreshing the snapshot cache), \"settle\" (wait for the UI\nto stop changing, text-only), or \"none\" (default). Not accepted inside a `glass_do`\n`type` action — use a `settle` action or the terminal `then` observe there."New value: +"Terminal observation: \"snapshot\" settles and refreshes/folds a11y, \"settle\" waits for\nvisual stability and returns text-only metadata, and \"none\" skips observation (default)."

Added value: +{
+  "properties": {
+    "condition": {
+      "description": "What to wait for (default \"appears\"): appears|disappears|enabled|disabled|\nchecked|unchecked|selected|unselected|expanded|collapsed|focused|visible|hidden.\n`checked`/`unchecked` only match a checkable element (one exposing a real toggle\nstate) — a non-toggle element matches neither.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "description": {
+      "description": "Substring of the element's accessible description (selector). Useful for unnamed\ncontrols whose platform label is exposed as a hint, help text, or description.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "interval_ms": {
+      "description": "Poll interval (default 200ms — an a11y snapshot per tick).",
+      "format": "uint64",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "name": {
+      "description": "Substring of the element's accessible name (selector).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "role": {
+      "description": "Element role filter, e.g. \"Button\", \"ProgressBar\", \"Document\" (selector).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "timeout_ms": {
+      "description": "Give up after this long (default 10000ms); returns `{matched:false}`.",
+      "format": "uint64",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "value": {
+      "description": "Exact case-sensitive accessible value, requiring another selector and excluding `value_contains`.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "value_contains": {
+      "description": "Additionally require the matched element's `value` to contain this substring.\nNot a standalone selector — `name`, `description`, and/or `role` is still required.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Overall sequence budget in milliseconds. Omit for 30000; valid range\n1..=120000. One absolute deadline is shared by all actions and terminal\nobservations.",
+  "format": "uint64",
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +"Consecutive clicks at this point (default 1); pass 2 for a double-click."

Added value: +"Click point x, window-relative — 0 is the window's left edge, not the screen's."

Added value: +"Click point y, window-relative — 0 is the window's top edge, not the screen's."

Added value: +"Name of a baseline saved by `glass_baseline_save`; an unsaved name errors\nrather than reporting no change."

Added value: +"Button held for the drag: \"left\" (default), \"right\", or \"middle\"."

Added value: +"Press-point x, window-relative — 0 is the window's left edge, not the screen's."

Added value: +"Release-point x, window-relative."

Added value: +"Press-point y, window-relative — 0 is the window's top edge, not the screen's."

Added value: +"Release-point y, window-relative."

Added value: +"Destination x, window-relative — 0 is the window's left edge, not the screen's."

Added value: +"Destination y, window-relative — 0 is the window's top edge, not the screen's."

Added value: +"Height in pixels, extending down from `y`."

Added value: +"Width in pixels, extending right from `x`."

Added value: +"Left edge in pixels, window-relative — 0 is the window's left edge, not the screen's."

Added value: +"Top edge in pixels, window-relative — 0 is the window's top edge, not the screen's."

Added value: +"Pointer x the wheel is aimed at, window-relative — apps scroll the container\nunder this point, so it selects which pane moves."

Added value: +"Pointer y the wheel is aimed at, window-relative. See `x`."

Added value: +"How long to wait between capture ticks (default 100ms)."

Added value: +"Consecutive unchanged frames required before the UI counts as settled (default 3)."

Added value: +"Window-relative sub-rectangle to watch for settling; when set, changes outside\nit are ignored."

Added value: +"Give up after this long (default 5000ms); the sequence continues rather than\nfailing."

Added value: +"Per-channel difference (0–255) two frames may have and still count as\nunchanged (default 0, exact match)."

Added value: +"Compare against a saved baseline and return change stats as text."

Added value: +"Capture the window as an image — the only field here that always spends image\ntokens; prefer `diff` when you just need to know whether something changed."

Added value: +"Wait for the UI to stop changing first. Set this whenever `diff` or\n`screenshot` follows, or they observe a half-drawn frame."

Added value: +{
+  "description": "Optional observe folded into the result: \"snapshot\" (wait for the UI to settle, then\nfold a fresh a11y tree, also refreshing the snapshot cache), \"settle\" (wait for the UI\nto stop changing, text-only), or \"none\" (default). Not accepted inside a `glass_do`\n`type` action — use a `settle` action or the terminal `then` observe there.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +"Text to type into whatever currently has keyboard focus — this tool does not\nfocus a field, so click or `glass_click_element` one first. Sent as synthetic\nkey events, not pasted, so an app's per-keystroke handlers run."

Removed value: -"Arguments for `glass_do`: an ordered, non-empty action sequence + optional observe."

Added value: +"Actions to run in order; must be non-empty. Fail-fast — the first failing\naction aborts the rest and reports its index, so a partial sequence may\nalready have landed."

Added value: +"Optional observe run once after the last action, in the order settle → diff\n→ screenshot."

Removed value: -"DoArgs"