@kaeawc/auto-mobile 0.0.39 → 0.0.41

package/schemas/tool-definitions.json

@@ -132,34 +132,22 @@
               "type": "object",
               "properties": {
                 "left": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "top": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "right": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "bottom": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerX": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerY": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 }
               },
               "required": [
@@ -168,7 +156,8 @@
                 "right",
                 "bottom"
               ],
-              "additionalProperties": false
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
             },
             "text": {
               "type": "string"
@@ -176,9 +165,21 @@
             "resource-id": {
               "type": "string"
             },
+            "view-id": {
+              "type": "string"
+            },
             "content-desc": {
               "type": "string"
             },
+            "occlusionState": {
+              "type": "string"
+            },
+            "occludedBy": {
+              "type": "string"
+            },
+            "occludedByViewId": {
+              "type": "string"
+            },
             "class": {
               "type": "string"
             },
@@ -460,6 +461,11 @@
             "ios"
           ]
         },
+        "appId": {
+          "description": "Android app package for locale changes",
+          "type": "string",
+          "minLength": 1
+        },
         "locale": {
           "description": "Locale tag (e.g., ar-SA, ja-JP)",
           "type": "string",
@@ -514,7 +520,23 @@
       "required": [
         "platform"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "if": {
+        "properties": {
+          "platform": {
+            "const": "android"
+          }
+        },
+        "required": [
+          "platform",
+          "locale"
+        ]
+      },
+      "then": {
+        "required": [
+          "appId"
+        ]
+      }
     }
   },
   {
@@ -968,14 +990,6 @@
         "ios": {
           "description": "Run iOS-specific checks only",
           "type": "boolean"
-        },
-        "installCmdlineTools": {
-          "description": "Install missing Android SDK cmdline tools",
-          "type": "boolean"
-        },
-        "installXcodeCommandLineTools": {
-          "description": "Install Xcode Command Line Tools if missing",
-          "type": "boolean"
         }
       },
       "additionalProperties": false
@@ -1734,6 +1748,64 @@
       "additionalProperties": false
     }
   },
+  {
+    "name": "getPreference",
+    "description": "Read an Android system property, Android SharedPreferences key, or iOS UserDefaults key.",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "scope": {
+          "type": "string",
+          "enum": [
+            "systemProperty",
+            "sharedPreferences",
+            "userDefaults"
+          ],
+          "description": "Preference scope"
+        },
+        "appId": {
+          "description": "App package or bundle id",
+          "type": "string"
+        },
+        "suite": {
+          "description": "SharedPreferences file name or UserDefaults suite/app group",
+          "type": "string"
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Preference key or Android system property name"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
+        },
+        "deviceId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "scope",
+        "key"
+      ],
+      "additionalProperties": false
+    }
+  },
   {
     "name": "highlight",
     "description": "Draw a visual highlight around a UI element.",
@@ -3078,9 +3150,109 @@
             {
               "type": "object",
               "properties": {
+                "textAny": {
+                  "minItems": 1,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "description": "Ordered text variants; first visible match wins"
+                },
                 "elementId": {
-                  "type": "string",
-                  "description": "Element resource ID / accessibility identifier"
+                  "not": {}
+                },
+                "text": {
+                  "not": {}
+                },
+                "className": {
+                  "not": {}
+                },
+                "contentDescription": {
+                  "not": {}
+                },
+                "matchType": {
+                  "not": {}
+                },
+                "textMatch": {
+                  "not": {}
+                },
+                "activeWindow": {
+                  "description": "Foreground app/window predicates",
+                  "allOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "appId": {
+                          "description": "Foreground app bundle ID / package name",
+                          "type": "string"
+                        },
+                        "packageName": {
+                          "type": "string"
+                        },
+                        "bundleId": {
+                          "type": "string"
+                        },
+                        "activityName": {
+                          "description": "Foreground Android activity name",
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "appId": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "appId"
+                          ],
+                          "additionalProperties": {}
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "packageName": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "packageName"
+                          ],
+                          "additionalProperties": {}
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "bundleId": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "bundleId"
+                          ],
+                          "additionalProperties": {}
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "activityName": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "activityName"
+                          ],
+                          "additionalProperties": {}
+                        }
+                      ]
+                    }
+                  ]
                 },
                 "timeout": {
                   "description": "Wait timeout ms (default: 5000)",
@@ -3119,57 +3291,304 @@
                 }
               },
               "required": [
-                "elementId"
+                "textAny"
               ],
               "additionalProperties": false
             },
             {
-              "type": "object",
-              "properties": {
-                "text": {
-                  "type": "string",
-                  "description": "Element text"
-                },
-                "timeout": {
-                  "description": "Wait timeout ms (default: 5000)",
-                  "type": "number"
+              "allOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "elementId": {
+                      "description": "Element resource ID / accessibility identifier",
+                      "type": "string"
+                    },
+                    "text": {
+                      "description": "Element text",
+                      "type": "string"
+                    },
+                    "textAny": {
+                      "not": {}
+                    },
+                    "className": {
+                      "description": "Element class name",
+                      "type": "string"
+                    },
+                    "contentDescription": {
+                      "description": "Element content description / accessibility label",
+                      "type": "string"
+                    },
+                    "matchType": {
+                      "description": "Whether element predicates must all match the same node or any one may match",
+                      "type": "string",
+                      "enum": [
+                        "all",
+                        "any"
+                      ]
+                    },
+                    "textMatch": {
+                      "description": "How to match waitFor.text; does not affect contentDescription",
+                      "type": "string",
+                      "enum": [
+                        "exact",
+                        "contains",
+                        "regex"
+                      ]
+                    },
+                    "activeWindow": {
+                      "description": "Foreground app/window predicates",
+                      "allOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "appId": {
+                              "description": "Foreground app bundle ID / package name",
+                              "type": "string"
+                            },
+                            "packageName": {
+                              "type": "string"
+                            },
+                            "bundleId": {
+                              "type": "string"
+                            },
+                            "activityName": {
+                              "description": "Foreground Android activity name",
+                              "type": "string"
+                            }
+                          },
+                          "additionalProperties": false
+                        },
+                        {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "appId": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "appId"
+                              ],
+                              "additionalProperties": {}
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "packageName": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "packageName"
+                              ],
+                              "additionalProperties": {}
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "bundleId": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "bundleId"
+                              ],
+                              "additionalProperties": {}
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "activityName": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "activityName"
+                              ],
+                              "additionalProperties": {}
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    "timeout": {
+                      "description": "Wait timeout ms (default: 5000)",
+                      "type": "number"
+                    },
+                    "container": {
+                      "description": "Scope match to a container",
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "elementId": {
+                              "type": "string",
+                              "description": "Container resource ID"
+                            }
+                          },
+                          "required": [
+                            "elementId"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "text": {
+                              "type": "string",
+                              "description": "Container text"
+                            }
+                          },
+                          "required": [
+                            "text"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  },
+                  "additionalProperties": false
                 },
-                "container": {
-                  "description": "Scope match to a container",
+                {
                   "anyOf": [
                     {
                       "type": "object",
                       "properties": {
                         "elementId": {
-                          "type": "string",
-                          "description": "Container resource ID"
+                          "type": "string"
                         }
                       },
                       "required": [
                         "elementId"
                       ],
-                      "additionalProperties": false
+                      "additionalProperties": {}
                     },
                     {
                       "type": "object",
                       "properties": {
                         "text": {
-                          "type": "string",
-                          "description": "Container text"
+                          "type": "string"
                         }
                       },
                       "required": [
                         "text"
                       ],
-                      "additionalProperties": false
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "text"
-              ],
-              "additionalProperties": false
+                      "additionalProperties": {}
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "className": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "className"
+                      ],
+                      "additionalProperties": {}
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "contentDescription": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "contentDescription"
+                      ],
+                      "additionalProperties": {}
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "activeWindow": {
+                          "allOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "appId": {
+                                  "description": "Foreground app bundle ID / package name",
+                                  "type": "string"
+                                },
+                                "packageName": {
+                                  "type": "string"
+                                },
+                                "bundleId": {
+                                  "type": "string"
+                                },
+                                "activityName": {
+                                  "description": "Foreground Android activity name",
+                                  "type": "string"
+                                }
+                              },
+                              "additionalProperties": false
+                            },
+                            {
+                              "anyOf": [
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "appId": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "appId"
+                                  ],
+                                  "additionalProperties": {}
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "packageName": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "packageName"
+                                  ],
+                                  "additionalProperties": {}
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "bundleId": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "bundleId"
+                                  ],
+                                  "additionalProperties": {}
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "activityName": {
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "activityName"
+                                  ],
+                                  "additionalProperties": {}
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "activeWindow"
+                      ],
+                      "additionalProperties": {}
+                    }
+                  ]
+                }
+              ]
             }
           ]
         },
@@ -3199,151 +3618,1473 @@
       "required": [
         "platform"
       ],
-      "additionalProperties": false
-    }
-  },
-  {
-    "name": "openLink",
-    "description": "Open URL in browser",
-    "inputSchema": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "properties": {
-        "url": {
-          "type": "string",
-          "description": "URL to open"
-        },
-        "platform": {
-          "type": "string",
-          "enum": [
-            "android",
-            "ios"
-          ]
-        },
-        "sessionUuid": {
-          "description": "Session",
-          "type": "string"
-        },
-        "keepScreenAwake": {
-          "type": "boolean"
-        },
-        "device": {
-          "description": "Device label",
-          "type": "string"
-        },
-        "deviceId": {
-          "type": "string"
+      "additionalProperties": false,
+      "if": {
+        "required": [
+          "platform",
+          "waitFor"
+        ],
+        "properties": {
+          "platform": {
+            "const": "ios"
+          },
+          "waitFor": {
+            "required": [
+              "activeWindow"
+            ],
+            "properties": {
+              "activeWindow": {
+                "required": [
+                  "activityName"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "appId"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "bundleId"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "packageName"
+                      ]
+                    }
+                  ]
+                }
+              }
+            }
+          }
         }
       },
-      "required": [
-        "url",
-        "platform"
-      ],
-      "additionalProperties": false
-    }
-  },
-  {
-    "name": "phoneCall",
-    "description": "Simulate Android emulator phone call via gsm commands.",
-    "inputSchema": {
+      "then": false
+    },
+    "outputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "call",
-            "accept",
-            "cancel",
-            "busy",
-            "hold"
+        "screenSize": {
+          "type": "object",
+          "properties": {
+            "width": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "height": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "width",
+            "height"
           ],
-          "description": "call/accept/cancel/busy/hold; hold needs no phoneNumber"
-        },
-        "phoneNumber": {
-          "description": "Phone number; required except for hold",
-          "type": "string"
-        },
-        "platform": {
-          "type": "string",
-          "enum": [
-            "android",
-            "ios"
-          ]
-        },
-        "sessionUuid": {
-          "description": "Session",
-          "type": "string"
-        },
-        "keepScreenAwake": {
-          "type": "boolean"
-        },
-        "device": {
-          "description": "Device label",
-          "type": "string"
+          "additionalProperties": false
         },
-        "deviceId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "action"
-      ],
-      "additionalProperties": false
-    }
-  },
-  {
-    "name": "pinchOn",
-    "description": "Pinch to zoom",
-    "inputSchema": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "properties": {
-        "direction": {
-          "type": "string",
-          "enum": [
-            "in",
-            "out"
+        "systemInsets": {
+          "type": "object",
+          "properties": {
+            "top": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "right": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "bottom": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "left": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "top",
+            "right",
+            "bottom",
+            "left"
           ],
-          "description": "Pinch direction"
-        },
-        "distanceStart": {
-          "description": "Initial finger distance (px, default: 400)",
-          "type": "number"
-        },
-        "distanceEnd": {
-          "description": "Final finger distance (px, default: 100)",
-          "type": "number"
-        },
-        "scale": {
-          "description": "Scale factor (overrides distances)",
-          "type": "number"
-        },
-        "duration": {
-          "description": "Gesture duration (ms)",
-          "type": "number"
-        },
-        "rotationDegrees": {
-          "description": "Rotation during pinch (degrees)",
-          "type": "number"
-        },
-        "includeSystemInsets": {
-          "description": "Use full screen including status/nav bars",
-          "type": "boolean"
+          "additionalProperties": false
         },
-        "container": {
-          "description": "Scope search to a container",
-          "anyOf": [
-            {
+        "viewHierarchy": {
+          "type": "object",
+          "properties": {
+            "hierarchy": {
               "type": "object",
               "properties": {
-                "elementId": {
-                  "type": "string",
-                  "description": "Container resource ID"
+                "error": {
+                  "type": "string"
+                },
+                "node": {
+                  "anyOf": [
+                    {
+                      "$ref": "#/$defs/__schema0"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/$defs/__schema0"
+                      }
+                    }
+                  ]
                 }
               },
-              "required": [
-                "elementId"
+              "additionalProperties": {}
+            },
+            "windows": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "bounds": {
+                        "type": "object",
+                        "properties": {
+                          "left": {
+                            "type": "number"
+                          },
+                          "top": {
+                            "type": "number"
+                          },
+                          "right": {
+                            "type": "number"
+                          },
+                          "bottom": {
+                            "type": "number"
+                          },
+                          "centerX": {
+                            "type": "number"
+                          },
+                          "centerY": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "left",
+                          "top",
+                          "right",
+                          "bottom"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+                      },
+                      "hierarchy": {
+                        "$ref": "#/$defs/__schema0"
+                      }
+                    },
+                    "additionalProperties": {}
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "contentHiddenRegions": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "bounds": {
+                        "type": "object",
+                        "properties": {
+                          "left": {
+                            "type": "number"
+                          },
+                          "top": {
+                            "type": "number"
+                          },
+                          "right": {
+                            "type": "number"
+                          },
+                          "bottom": {
+                            "type": "number"
+                          },
+                          "centerX": {
+                            "type": "number"
+                          },
+                          "centerY": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "left",
+                          "top",
+                          "right",
+                          "bottom"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+                      },
+                      "reason": {
+                        "type": "string"
+                      },
+                      "areaPercent": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "bounds",
+                      "reason",
+                      "areaPercent"
+                    ],
+                    "additionalProperties": {}
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "accessibility-focused-element": {
+              "$ref": "#/$defs/__schema0"
+            },
+            "systemInsets": {
+              "type": "object",
+              "properties": {
+                "top": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                },
+                "right": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                },
+                "bottom": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                },
+                "left": {
+                  "type": "integer",
+                  "minimum": -9007199254740991,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "top",
+                "right",
+                "bottom",
+                "left"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": {}
+        },
+        "activeWindow": {
+          "type": "object",
+          "properties": {
+            "appId": {
+              "type": "string"
+            },
+            "activityName": {
+              "type": "string"
+            },
+            "layoutSeqSum": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "type": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": {}
+        },
+        "screenIdentity": {
+          "type": "object",
+          "properties": {
+            "platform": {
+              "type": "string",
+              "enum": [
+                "ios",
+                "android"
+              ]
+            },
+            "source": {
+              "type": "string",
+              "enum": [
+                "heuristic",
+                "sdk"
+              ]
+            },
+            "confidence": {
+              "type": "string",
+              "enum": [
+                "high",
+                "medium",
+                "low"
+              ]
+            },
+            "key": {
+              "type": "string"
+            },
+            "components": {
+              "type": "object",
+              "properties": {
+                "bundleId": {
+                  "type": "string"
+                },
+                "navigationTitle": {
+                  "type": "string"
+                },
+                "selectedTab": {
+                  "type": "string"
+                },
+                "modalClass": {
+                  "type": "string"
+                },
+                "modalTitle": {
+                  "type": "string"
+                },
+                "focusedElementId": {
+                  "type": "string"
+                },
+                "keyboardVisible": {
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "platform",
+            "source",
+            "confidence",
+            "key",
+            "components"
+          ],
+          "additionalProperties": {}
+        },
+        "elements": {
+          "type": "object",
+          "properties": {
+            "clickable": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/__schema0"
+              }
+            },
+            "scrollable": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/__schema0"
+              }
+            },
+            "text": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/__schema0"
+              }
+            },
+            "media": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "bounds": {
+                    "type": "object",
+                    "properties": {
+                      "left": {
+                        "type": "number"
+                      },
+                      "top": {
+                        "type": "number"
+                      },
+                      "right": {
+                        "type": "number"
+                      },
+                      "bottom": {
+                        "type": "number"
+                      },
+                      "centerX": {
+                        "type": "number"
+                      },
+                      "centerY": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "left",
+                      "top",
+                      "right",
+                      "bottom"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+                  }
+                },
+                "additionalProperties": {}
+              }
+            }
+          },
+          "required": [
+            "clickable",
+            "scrollable",
+            "text",
+            "media"
+          ],
+          "additionalProperties": {}
+        },
+        "selectedElements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "text": {
+                "type": "string"
+              },
+              "resourceId": {
+                "type": "string"
+              },
+              "contentDesc": {
+                "type": "string"
+              },
+              "bounds": {
+                "type": "object",
+                "properties": {
+                  "left": {
+                    "type": "number"
+                  },
+                  "top": {
+                    "type": "number"
+                  },
+                  "right": {
+                    "type": "number"
+                  },
+                  "bottom": {
+                    "type": "number"
+                  },
+                  "centerX": {
+                    "type": "number"
+                  },
+                  "centerY": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "left",
+                  "top",
+                  "right",
+                  "bottom"
+                ],
+                "additionalProperties": false,
+                "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+              },
+              "indexInMatches": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              "totalMatches": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              "selectionStrategy": {
+                "type": "string"
+              },
+              "selectedState": {
+                "type": "object",
+                "properties": {
+                  "method": {
+                    "type": "string",
+                    "enum": [
+                      "accessibility",
+                      "visual"
+                    ]
+                  },
+                  "confidence": {
+                    "type": "number"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "method",
+                  "confidence"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": {}
+          }
+        },
+        "focusedElement": {
+          "type": "object",
+          "properties": {
+            "bounds": {
+              "type": "object",
+              "properties": {
+                "left": {
+                  "type": "number"
+                },
+                "top": {
+                  "type": "number"
+                },
+                "right": {
+                  "type": "number"
+                },
+                "bottom": {
+                  "type": "number"
+                },
+                "centerX": {
+                  "type": "number"
+                },
+                "centerY": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "left",
+                "top",
+                "right",
+                "bottom"
+              ],
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+            },
+            "text": {
+              "type": "string"
+            },
+            "resource-id": {
+              "type": "string"
+            },
+            "view-id": {
+              "type": "string"
+            },
+            "content-desc": {
+              "type": "string"
+            },
+            "occlusionState": {
+              "type": "string"
+            },
+            "occludedBy": {
+              "type": "string"
+            },
+            "occludedByViewId": {
+              "type": "string"
+            },
+            "class": {
+              "type": "string"
+            },
+            "package": {
+              "type": "string"
+            },
+            "checkable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "checked": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "clickable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "enabled": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focusable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "accessibility-focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "scrollable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "selected": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            }
+          },
+          "required": [
+            "bounds"
+          ],
+          "additionalProperties": {}
+        },
+        "accessibilityFocusedElement": {
+          "type": "object",
+          "properties": {
+            "bounds": {
+              "type": "object",
+              "properties": {
+                "left": {
+                  "type": "number"
+                },
+                "top": {
+                  "type": "number"
+                },
+                "right": {
+                  "type": "number"
+                },
+                "bottom": {
+                  "type": "number"
+                },
+                "centerX": {
+                  "type": "number"
+                },
+                "centerY": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "left",
+                "top",
+                "right",
+                "bottom"
+              ],
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+            },
+            "text": {
+              "type": "string"
+            },
+            "resource-id": {
+              "type": "string"
+            },
+            "view-id": {
+              "type": "string"
+            },
+            "content-desc": {
+              "type": "string"
+            },
+            "occlusionState": {
+              "type": "string"
+            },
+            "occludedBy": {
+              "type": "string"
+            },
+            "occludedByViewId": {
+              "type": "string"
+            },
+            "class": {
+              "type": "string"
+            },
+            "package": {
+              "type": "string"
+            },
+            "checkable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "checked": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "clickable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "enabled": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focusable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "accessibility-focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "scrollable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "selected": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            }
+          },
+          "required": [
+            "bounds"
+          ],
+          "additionalProperties": {}
+        },
+        "awaitedElement": {
+          "type": "object",
+          "properties": {
+            "bounds": {
+              "type": "object",
+              "properties": {
+                "left": {
+                  "type": "number"
+                },
+                "top": {
+                  "type": "number"
+                },
+                "right": {
+                  "type": "number"
+                },
+                "bottom": {
+                  "type": "number"
+                },
+                "centerX": {
+                  "type": "number"
+                },
+                "centerY": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "left",
+                "top",
+                "right",
+                "bottom"
+              ],
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+            },
+            "text": {
+              "type": "string"
+            },
+            "resource-id": {
+              "type": "string"
+            },
+            "view-id": {
+              "type": "string"
+            },
+            "content-desc": {
+              "type": "string"
+            },
+            "occlusionState": {
+              "type": "string"
+            },
+            "occludedBy": {
+              "type": "string"
+            },
+            "occludedByViewId": {
+              "type": "string"
+            },
+            "class": {
+              "type": "string"
+            },
+            "package": {
+              "type": "string"
+            },
+            "checkable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "checked": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "clickable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "enabled": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focusable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "accessibility-focused": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "scrollable": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            },
+            "selected": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string",
+                  "const": "true"
+                },
+                {
+                  "type": "string",
+                  "const": "false"
+                }
+              ]
+            }
+          },
+          "required": [
+            "bounds"
+          ],
+          "additionalProperties": {}
+        },
+        "freshness": {
+          "type": "object",
+          "properties": {
+            "requestedAfter": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "actualTimestamp": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "isFresh": {
+              "type": "boolean"
+            },
+            "staleDurationMs": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "warning": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "isFresh"
+          ],
+          "additionalProperties": {}
+        },
+        "predictions": {
+          "type": "object",
+          "properties": {
+            "likelyActions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string"
+                  },
+                  "target": {
+                    "type": "object",
+                    "properties": {
+                      "text": {
+                        "type": "string"
+                      },
+                      "elementId": {
+                        "type": "string"
+                      },
+                      "contentDesc": {
+                        "type": "string"
+                      },
+                      "container": {
+                        "type": "object",
+                        "properties": {
+                          "text": {
+                            "type": "string"
+                          },
+                          "elementId": {
+                            "type": "string"
+                          },
+                          "contentDesc": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": false
+                      },
+                      "lookFor": {
+                        "type": "object",
+                        "properties": {
+                          "text": {
+                            "type": "string"
+                          },
+                          "elementId": {
+                            "type": "string"
+                          },
+                          "contentDesc": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "additionalProperties": {}
+                  },
+                  "predictedScreen": {
+                    "type": "string"
+                  },
+                  "predictedElements": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "confidence": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "action",
+                  "target",
+                  "predictedScreen",
+                  "confidence"
+                ],
+                "additionalProperties": {}
+              }
+            },
+            "interactableElements": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "elementId": {
+                    "type": "string"
+                  },
+                  "elementText": {
+                    "type": "string"
+                  },
+                  "elementContentDesc": {
+                    "type": "string"
+                  },
+                  "predictedOutcome": {
+                    "type": "object",
+                    "properties": {
+                      "screenName": {
+                        "type": "string"
+                      },
+                      "basedOn": {
+                        "type": "string",
+                        "enum": [
+                          "navigation_graph"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "screenName",
+                      "basedOn"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "additionalProperties": {}
+              }
+            }
+          },
+          "required": [
+            "likelyActions",
+            "interactableElements"
+          ],
+          "additionalProperties": {}
+        },
+        "accessibilityState": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "service": {
+              "type": "string",
+              "enum": [
+                "talkback",
+                "voiceover",
+                "unknown"
+              ]
+            }
+          },
+          "required": [
+            "enabled",
+            "service"
+          ],
+          "additionalProperties": {}
+        },
+        "artifact": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "string"
+            },
+            "format": {
+              "type": "string",
+              "const": "json"
+            },
+            "payload": {
+              "type": "string"
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "tool": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "path",
+            "format",
+            "payload",
+            "bytes",
+            "tool"
+          ],
+          "additionalProperties": {}
+        }
+      }
+    }
+  },
+  {
+    "name": "openLink",
+    "description": "Open URL in browser",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "URL to open"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
+        },
+        "deviceId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "url",
+        "platform"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "phoneCall",
+    "description": "Simulate Android emulator phone call via gsm commands.",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "call",
+            "accept",
+            "cancel",
+            "busy",
+            "hold"
+          ],
+          "description": "call/accept/cancel/busy/hold; hold needs no phoneNumber"
+        },
+        "phoneNumber": {
+          "description": "Phone number; required except for hold",
+          "type": "string"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
+        },
+        "deviceId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "pinchOn",
+    "description": "Pinch to zoom",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "direction": {
+          "type": "string",
+          "enum": [
+            "in",
+            "out"
+          ],
+          "description": "Pinch direction"
+        },
+        "distanceStart": {
+          "description": "Initial finger distance (px, default: 400)",
+          "type": "number"
+        },
+        "distanceEnd": {
+          "description": "Final finger distance (px, default: 100)",
+          "type": "number"
+        },
+        "scale": {
+          "description": "Scale factor (overrides distances)",
+          "type": "number"
+        },
+        "duration": {
+          "description": "Gesture duration (ms)",
+          "type": "number"
+        },
+        "rotationDegrees": {
+          "description": "Degrees the two-finger axis rotates during the pinch (default: 0). The axis starts horizontal and ends rotated by this amount — a combined pinch+rotate, not a pinch along a fixed rotated axis. Same convention on Android and iOS.",
+          "type": "number"
+        },
+        "includeSystemInsets": {
+          "description": "Use full screen including status/nav bars",
+          "type": "boolean"
+        },
+        "container": {
+          "description": "Scope search to a container",
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "elementId": {
+                  "type": "string",
+                  "description": "Container resource ID"
+                }
+              },
+              "required": [
+                "elementId"
               ],
               "additionalProperties": false
             },
@@ -3455,7 +5196,7 @@
         "appId": {
           "type": "string",
           "minLength": 1,
-          "description": "iOS target bundle ID"
+          "description": "Android target package name or iOS target bundle ID; Android defaults to the live foreground app when omitted"
         },
         "platform": {
           "type": "string",
@@ -3935,7 +5676,7 @@
   },
   {
     "name": "setAppPermissions",
-    "description": "Grant, revoke, reset, or configure app permissions",
+    "description": "Grant, revoke, reset, or configure app permissions on Android devices, iOS simulators (grant/revoke/reset), and iOS physical devices (reset only, permissions=['all'] supported)",
     "inputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -3944,7 +5685,7 @@
           "type": "string"
         },
         "action": {
-          "description": "Permission action; defaults to grant",
+          "description": "Permission action; defaults to grant. Android supports grant; iOS simulators support grant/revoke/reset; iOS physical devices support reset only, including permissions=['all'].",
           "type": "string",
           "enum": [
             "grant",
@@ -3953,7 +5694,7 @@
           ]
         },
         "permissions": {
-          "description": "Runtime permissions or simulator privacy services to change",
+          "description": "Runtime permissions or simulator privacy services to change; iOS physical reset accepts 'all'",
           "type": "array",
           "items": {
             "type": "string",
@@ -4185,6 +5926,90 @@
       "additionalProperties": false
     }
   },
+  {
+    "name": "setPreference",
+    "description": "Write an Android system property, Android SharedPreferences key, or iOS UserDefaults key and return read-back verification.",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "scope": {
+          "type": "string",
+          "enum": [
+            "systemProperty",
+            "sharedPreferences",
+            "userDefaults"
+          ],
+          "description": "Preference scope"
+        },
+        "appId": {
+          "description": "App package or bundle id",
+          "type": "string"
+        },
+        "suite": {
+          "description": "SharedPreferences file name or UserDefaults suite/app group",
+          "type": "string"
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Preference key or Android system property name"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "Value to write"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "bool",
+            "int",
+            "float"
+          ],
+          "description": "Value type for typed preference stores"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
+        },
+        "deviceId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "scope",
+        "key",
+        "value",
+        "type"
+      ],
+      "additionalProperties": false
+    }
+  },
   {
     "name": "setUIState",
     "description": "Set multiple form fields by desired state.",
@@ -4904,12 +6729,30 @@
                 }
               },
               "required": [
-                "text"
+                "text"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "textAny": {
+                  "minItems": 1,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "description": "Ordered text variants; first visible match wins"
+                }
+              },
+              "required": [
+                "textAny"
               ],
               "additionalProperties": false
             }
           ],
-          "description": "Element to tap: elementId or text"
+          "description": "Element to tap: elementId, text, or ordered text variants"
         },
         "sibling": {
           "description": "Tap a clickable sibling of the match, e.g. checkbox beside label",
@@ -4965,6 +6808,12 @@
             "random"
           ]
         },
+        "index": {
+          "description": "0-based index to tap the Nth on-screen match (in hierarchy order, i.e. top-to-bottom for a vertical list) instead of applying selectionStrategy — for repeated controls with no unique text. Out of range → no match.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
         "duration": {
           "description": "Long press duration (ms)",
           "type": "number"
@@ -5043,34 +6892,22 @@
               "type": "object",
               "properties": {
                 "left": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "top": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "right": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "bottom": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerX": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerY": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 }
               },
               "required": [
@@ -5079,7 +6916,8 @@
                 "right",
                 "bottom"
               ],
-              "additionalProperties": false
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
             },
             "text": {
               "type": "string"
@@ -5087,9 +6925,21 @@
             "resource-id": {
               "type": "string"
             },
+            "view-id": {
+              "type": "string"
+            },
             "content-desc": {
               "type": "string"
             },
+            "occlusionState": {
+              "type": "string"
+            },
+            "occludedBy": {
+              "type": "string"
+            },
+            "occludedByViewId": {
+              "type": "string"
+            },
             "class": {
               "type": "string"
             },
@@ -5238,527 +7088,844 @@
           "additionalProperties": {}
         },
         "observation": {
-          "type": "object",
-          "properties": {
-            "selectedElements": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "text": {
-                    "type": "string"
-                  },
-                  "resourceId": {
-                    "type": "string"
-                  },
-                  "contentDesc": {
-                    "type": "string"
-                  },
-                  "bounds": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "selectedElements": {
+                  "type": "array",
+                  "items": {
                     "type": "object",
                     "properties": {
-                      "left": {
-                        "type": "integer",
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                      "text": {
+                        "type": "string"
                       },
-                      "top": {
-                        "type": "integer",
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                      "resourceId": {
+                        "type": "string"
                       },
-                      "right": {
-                        "type": "integer",
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                      "contentDesc": {
+                        "type": "string"
                       },
-                      "bottom": {
-                        "type": "integer",
-                        "minimum": -9007199254740991,
-                        "maximum": 9007199254740991
+                      "bounds": {
+                        "type": "object",
+                        "properties": {
+                          "left": {
+                            "type": "number"
+                          },
+                          "top": {
+                            "type": "number"
+                          },
+                          "right": {
+                            "type": "number"
+                          },
+                          "bottom": {
+                            "type": "number"
+                          },
+                          "centerX": {
+                            "type": "number"
+                          },
+                          "centerY": {
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "left",
+                          "top",
+                          "right",
+                          "bottom"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
                       },
-                      "centerX": {
+                      "indexInMatches": {
                         "type": "integer",
                         "minimum": -9007199254740991,
                         "maximum": 9007199254740991
                       },
-                      "centerY": {
+                      "totalMatches": {
                         "type": "integer",
                         "minimum": -9007199254740991,
                         "maximum": 9007199254740991
-                      }
-                    },
-                    "required": [
-                      "left",
-                      "top",
-                      "right",
-                      "bottom"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "indexInMatches": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
-                  },
-                  "totalMatches": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
-                  },
-                  "selectionStrategy": {
-                    "type": "string"
-                  },
-                  "selectedState": {
-                    "type": "object",
-                    "properties": {
-                      "method": {
-                        "type": "string",
-                        "enum": [
-                          "accessibility",
-                          "visual"
-                        ]
-                      },
-                      "confidence": {
-                        "type": "number"
                       },
-                      "reason": {
+                      "selectionStrategy": {
                         "type": "string"
+                      },
+                      "selectedState": {
+                        "type": "object",
+                        "properties": {
+                          "method": {
+                            "type": "string",
+                            "enum": [
+                              "accessibility",
+                              "visual"
+                            ]
+                          },
+                          "confidence": {
+                            "type": "number"
+                          },
+                          "reason": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "method",
+                          "confidence"
+                        ],
+                        "additionalProperties": false
                       }
                     },
-                    "required": [
-                      "method",
-                      "confidence"
-                    ],
-                    "additionalProperties": false
+                    "additionalProperties": {}
                   }
                 },
-                "additionalProperties": {}
-              }
-            },
-            "focusedElement": {
-              "type": "object",
-              "properties": {
-                "bounds": {
+                "focusedElement": {
+                  "type": "object",
+                  "properties": {
+                    "bounds": {
+                      "type": "object",
+                      "properties": {
+                        "left": {
+                          "type": "number"
+                        },
+                        "top": {
+                          "type": "number"
+                        },
+                        "right": {
+                          "type": "number"
+                        },
+                        "bottom": {
+                          "type": "number"
+                        },
+                        "centerX": {
+                          "type": "number"
+                        },
+                        "centerY": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "left",
+                        "top",
+                        "right",
+                        "bottom"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "resource-id": {
+                      "type": "string"
+                    },
+                    "view-id": {
+                      "type": "string"
+                    },
+                    "content-desc": {
+                      "type": "string"
+                    },
+                    "occlusionState": {
+                      "type": "string"
+                    },
+                    "occludedBy": {
+                      "type": "string"
+                    },
+                    "occludedByViewId": {
+                      "type": "string"
+                    },
+                    "class": {
+                      "type": "string"
+                    },
+                    "package": {
+                      "type": "string"
+                    },
+                    "checkable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "checked": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "clickable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "enabled": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "focusable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "focused": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "accessibility-focused": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "scrollable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "selected": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    }
+                  },
+                  "required": [
+                    "bounds"
+                  ],
+                  "additionalProperties": {}
+                },
+                "accessibilityFocusedElement": {
                   "type": "object",
                   "properties": {
-                    "left": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "bounds": {
+                      "type": "object",
+                      "properties": {
+                        "left": {
+                          "type": "number"
+                        },
+                        "top": {
+                          "type": "number"
+                        },
+                        "right": {
+                          "type": "number"
+                        },
+                        "bottom": {
+                          "type": "number"
+                        },
+                        "centerX": {
+                          "type": "number"
+                        },
+                        "centerY": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "left",
+                        "top",
+                        "right",
+                        "bottom"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
                     },
-                    "top": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "text": {
+                      "type": "string"
                     },
-                    "right": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "resource-id": {
+                      "type": "string"
                     },
-                    "bottom": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "view-id": {
+                      "type": "string"
                     },
-                    "centerX": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "content-desc": {
+                      "type": "string"
                     },
-                    "centerY": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
-                    }
-                  },
-                  "required": [
-                    "left",
-                    "top",
-                    "right",
-                    "bottom"
-                  ],
-                  "additionalProperties": false
-                },
-                "text": {
-                  "type": "string"
-                },
-                "resource-id": {
-                  "type": "string"
-                },
-                "content-desc": {
-                  "type": "string"
-                },
-                "class": {
-                  "type": "string"
-                },
-                "package": {
-                  "type": "string"
-                },
-                "checkable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "occlusionState": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "occludedBy": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "checked": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "occludedByViewId": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "class": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "clickable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "package": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "checkable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "enabled": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "checked": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "clickable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "focusable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "enabled": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "focusable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "focused": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "focused": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "accessibility-focused": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "scrollable": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
+                    },
+                    "selected": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "string",
+                          "const": "true"
+                        },
+                        {
+                          "type": "string",
+                          "const": "false"
+                        }
+                      ]
                     }
-                  ]
+                  },
+                  "required": [
+                    "bounds"
+                  ],
+                  "additionalProperties": {}
                 },
-                "accessibility-focused": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                "activeWindow": {
+                  "type": "object",
+                  "properties": {
+                    "appId": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "activityName": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "layoutSeqSum": {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
+                    },
+                    "type": {
+                      "type": "string"
                     }
-                  ]
+                  },
+                  "additionalProperties": {}
                 },
-                "scrollable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                "screenIdentity": {
+                  "type": "object",
+                  "properties": {
+                    "platform": {
+                      "type": "string",
+                      "enum": [
+                        "ios",
+                        "android"
+                      ]
                     },
-                    {
+                    "source": {
                       "type": "string",
-                      "const": "true"
+                      "enum": [
+                        "heuristic",
+                        "sdk"
+                      ]
                     },
-                    {
+                    "confidence": {
                       "type": "string",
-                      "const": "false"
+                      "enum": [
+                        "high",
+                        "medium",
+                        "low"
+                      ]
+                    },
+                    "key": {
+                      "type": "string"
+                    },
+                    "components": {
+                      "type": "object",
+                      "properties": {
+                        "bundleId": {
+                          "type": "string"
+                        },
+                        "navigationTitle": {
+                          "type": "string"
+                        },
+                        "selectedTab": {
+                          "type": "string"
+                        },
+                        "modalClass": {
+                          "type": "string"
+                        },
+                        "modalTitle": {
+                          "type": "string"
+                        },
+                        "focusedElementId": {
+                          "type": "string"
+                        },
+                        "keyboardVisible": {
+                          "type": "boolean"
+                        }
+                      },
+                      "additionalProperties": {}
                     }
-                  ]
-                },
-                "selected": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                  },
+                  "required": [
+                    "platform",
+                    "source",
+                    "confidence",
+                    "key",
+                    "components"
+                  ],
+                  "additionalProperties": {}
+                }
+              },
+              "additionalProperties": {}
+            },
+            {
+              "type": "object",
+              "properties": {
+                "artifact": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
                     },
-                    {
+                    "format": {
                       "type": "string",
-                      "const": "true"
+                      "const": "json"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "payload": {
+                      "type": "string"
+                    },
+                    "bytes": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "tool": {
+                      "type": "string"
                     }
-                  ]
+                  },
+                  "required": [
+                    "path",
+                    "format",
+                    "payload",
+                    "bytes",
+                    "tool"
+                  ],
+                  "additionalProperties": {}
                 }
               },
               "required": [
-                "bounds"
+                "artifact"
               ],
               "additionalProperties": {}
+            }
+          ]
+        },
+        "observationDiff": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "diff",
+                "full"
+              ]
+            },
+            "reason": {
+              "type": "string",
+              "enum": [
+                "diff_emitted",
+                "missing_baseline",
+                "screen_changed",
+                "missing_session",
+                "unrenderable_hierarchy",
+                "disabled",
+                "stripped_by_actions_no_observe"
+              ]
             },
-            "accessibilityFocusedElement": {
+            "fromScreen": {
               "type": "object",
               "properties": {
-                "bounds": {
+                "activeWindow": {
                   "type": "object",
                   "properties": {
-                    "left": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
-                    },
-                    "top": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
-                    },
-                    "right": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "appId": {
+                      "type": "string"
                     },
-                    "bottom": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "activityName": {
+                      "type": "string"
                     },
-                    "centerX": {
+                    "layoutSeqSum": {
                       "type": "integer",
                       "minimum": -9007199254740991,
                       "maximum": 9007199254740991
                     },
-                    "centerY": {
-                      "type": "integer",
-                      "minimum": -9007199254740991,
-                      "maximum": 9007199254740991
+                    "type": {
+                      "type": "string"
                     }
                   },
-                  "required": [
-                    "left",
-                    "top",
-                    "right",
-                    "bottom"
-                  ],
-                  "additionalProperties": false
-                },
-                "text": {
-                  "type": "string"
-                },
-                "resource-id": {
-                  "type": "string"
-                },
-                "content-desc": {
-                  "type": "string"
-                },
-                "class": {
-                  "type": "string"
+                  "additionalProperties": {}
                 },
-                "package": {
+                "hierarchyPackageName": {
                   "type": "string"
                 },
-                "checkable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string",
-                      "const": "true"
-                    },
-                    {
+                "screenIdentity": {
+                  "type": "object",
+                  "properties": {
+                    "platform": {
                       "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "checked": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                      "enum": [
+                        "ios",
+                        "android"
+                      ]
                     },
-                    {
+                    "source": {
                       "type": "string",
-                      "const": "true"
+                      "enum": [
+                        "heuristic",
+                        "sdk"
+                      ]
                     },
-                    {
+                    "confidence": {
                       "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "clickable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                      "enum": [
+                        "high",
+                        "medium",
+                        "low"
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "key": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "components": {
+                      "type": "object",
+                      "properties": {
+                        "bundleId": {
+                          "type": "string"
+                        },
+                        "navigationTitle": {
+                          "type": "string"
+                        },
+                        "selectedTab": {
+                          "type": "string"
+                        },
+                        "modalClass": {
+                          "type": "string"
+                        },
+                        "modalTitle": {
+                          "type": "string"
+                        },
+                        "focusedElementId": {
+                          "type": "string"
+                        },
+                        "keyboardVisible": {
+                          "type": "boolean"
+                        }
+                      },
+                      "additionalProperties": {}
                     }
-                  ]
-                },
-                "enabled": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string",
-                      "const": "true"
+                  },
+                  "required": [
+                    "platform",
+                    "source",
+                    "confidence",
+                    "key",
+                    "components"
+                  ],
+                  "additionalProperties": {}
+                }
+              },
+              "additionalProperties": {}
+            },
+            "toScreen": {
+              "type": "object",
+              "properties": {
+                "activeWindow": {
+                  "type": "object",
+                  "properties": {
+                    "appId": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "focusable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                    "activityName": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "layoutSeqSum": {
+                      "type": "integer",
+                      "minimum": -9007199254740991,
+                      "maximum": 9007199254740991
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "type": {
+                      "type": "string"
                     }
-                  ]
+                  },
+                  "additionalProperties": {}
                 },
-                "focused": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string",
-                      "const": "true"
-                    },
-                    {
-                      "type": "string",
-                      "const": "false"
-                    }
-                  ]
+                "hierarchyPackageName": {
+                  "type": "string"
                 },
-                "accessibility-focused": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string",
-                      "const": "true"
-                    },
-                    {
+                "screenIdentity": {
+                  "type": "object",
+                  "properties": {
+                    "platform": {
                       "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "scrollable": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                      "enum": [
+                        "ios",
+                        "android"
+                      ]
                     },
-                    {
+                    "source": {
                       "type": "string",
-                      "const": "true"
+                      "enum": [
+                        "heuristic",
+                        "sdk"
+                      ]
                     },
-                    {
+                    "confidence": {
                       "type": "string",
-                      "const": "false"
-                    }
-                  ]
-                },
-                "selected": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
+                      "enum": [
+                        "high",
+                        "medium",
+                        "low"
+                      ]
                     },
-                    {
-                      "type": "string",
-                      "const": "true"
+                    "key": {
+                      "type": "string"
                     },
-                    {
-                      "type": "string",
-                      "const": "false"
+                    "components": {
+                      "type": "object",
+                      "properties": {
+                        "bundleId": {
+                          "type": "string"
+                        },
+                        "navigationTitle": {
+                          "type": "string"
+                        },
+                        "selectedTab": {
+                          "type": "string"
+                        },
+                        "modalClass": {
+                          "type": "string"
+                        },
+                        "modalTitle": {
+                          "type": "string"
+                        },
+                        "focusedElementId": {
+                          "type": "string"
+                        },
+                        "keyboardVisible": {
+                          "type": "boolean"
+                        }
+                      },
+                      "additionalProperties": {}
                     }
-                  ]
-                }
-              },
-              "required": [
-                "bounds"
-              ],
-              "additionalProperties": {}
-            },
-            "activeWindow": {
-              "type": "object",
-              "properties": {
-                "appId": {
-                  "type": "string"
-                },
-                "activityName": {
-                  "type": "string"
-                },
-                "layoutSeqSum": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
-                },
-                "type": {
-                  "type": "string"
+                  },
+                  "required": [
+                    "platform",
+                    "source",
+                    "confidence",
+                    "key",
+                    "components"
+                  ],
+                  "additionalProperties": {}
                 }
               },
               "additionalProperties": {}
             }
           },
+          "required": [
+            "mode",
+            "reason"
+          ],
           "additionalProperties": {}
         },
         "selectedElement": {
@@ -5777,34 +7944,22 @@
               "type": "object",
               "properties": {
                 "left": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "top": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "right": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "bottom": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerX": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 },
                 "centerY": {
-                  "type": "integer",
-                  "minimum": -9007199254740991,
-                  "maximum": 9007199254740991
+                  "type": "number"
                 }
               },
               "required": [
@@ -5813,7 +7968,8 @@
                 "right",
                 "bottom"
               ],
-              "additionalProperties": false
+              "additionalProperties": false,
+              "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
             },
             "indexInMatches": {
               "type": "integer",
@@ -5872,34 +8028,22 @@
                 "type": "object",
                 "properties": {
                   "left": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   },
                   "top": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   },
                   "right": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   },
                   "bottom": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   },
                   "centerX": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   },
                   "centerY": {
-                    "type": "integer",
-                    "minimum": -9007199254740991,
-                    "maximum": 9007199254740991
+                    "type": "number"
                   }
                 },
                 "required": [
@@ -5908,7 +8052,8 @@
                   "right",
                   "bottom"
                 ],
-                "additionalProperties": false
+                "additionalProperties": false,
+                "description": "Element bounds. Default: object {left, top, right, bottom} (+ optional centerX/centerY). Under --observe-result-compact: positional tuple [left, top, right, bottom]."
               },
               "indexInMatches": {
                 "type": "integer",