name: set_value

description:
Set value of an AT-SPI element via SetValue action.

input_schema:
{
  "additionalProperties": false,
  "properties": {
    "element_index": {
      "description": "Element index from get_window_state. Requires the matching `snapshot_id` alongside it. Prefer `element_token`, which carries both values.",
      "type": "integer"
    },
    "element_token": {
      "description": "Opaque per-snapshot element handle from `structuredContent.elements[].element_token`. If element_index, snapshot_id, or window_id are also supplied they must agree. Returns an explicit stale error once a newer snapshot supersedes it.",
      "type": "string"
    },
    "pid": {
      "type": "integer"
    },
    "session": {
      "description": "For multi-call work, prefer a short public session label and repeat it on every call that accepts it. Omit it to use the authenticated transport's implicit lifecycle session.",
      "type": "string"
    },
    "snapshot_id": {
      "description": "Snapshot handle from get_window_state. Required when targeting by element_index; stale snapshots fail closed.",
      "pattern": "^s[0-9a-f]{8}$",
      "type": "string"
    },
    "value": {
      "type": "string"
    },
    "window_id": {
      "description": "Required when element_index is used; optional when element_token is supplied (the token carries it).",
      "type": "integer"
    }
  },
  "required": [
    "pid",
    "value"
  ],
  "type": "object"
}