@kaeawc/auto-mobile 0.0.45 → 0.0.46

package/dist/schemas/tool-definitions.json

@@ -790,6 +790,24 @@
         "__lockNamespace": {
           "description": "Internal plan-scoped lock namespace (injected)",
           "type": "string"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
         }
       },
       "required": [
@@ -985,25 +1003,6 @@
       }
     }
   },
-  {
-    "name": "doctor",
-    "description": "Run AutoMobile setup diagnostics",
-    "inputSchema": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "properties": {
-        "android": {
-          "description": "Run Android-specific checks only",
-          "type": "boolean"
-        },
-        "ios": {
-          "description": "Run iOS-specific checks only",
-          "type": "boolean"
-        }
-      },
-      "additionalProperties": false
-    }
-  },
   {
     "name": "dragAndDrop",
     "description": "Drag and drop element",
@@ -2615,12 +2614,13 @@
           "minLength": 1
         },
         "mode": {
-          "description": "Android text mode: a11y default; eventLast helps autocomplete; eventAll sends key events",
+          "description": "Android text mode: a11y default; eventLast and eventAll start with accessibility setText; eventOnly clears and types supported ASCII with key events only",
           "type": "string",
           "enum": [
             "a11y",
             "eventLast",
-            "eventAll"
+            "eventAll",
+            "eventOnly"
           ]
         },
         "imeAction": {
@@ -3091,38 +3091,54 @@
         "waitFor": {
           "type": "object",
           "additionalProperties": false,
-          "description": "Wait for a predicate before returning the observation. Provide at least one of: elementId, text, textAny, className, contentDescription, or activeWindow. textAny is mutually exclusive with the element predicates.",
+          "not": {
+            "required": [
+              "timeout",
+              "timeoutMs"
+            ]
+          },
           "properties": {
-            "elementId": {
+            "for": {
               "type": "string",
-              "description": "Element resource ID / accessibility identifier"
+              "enum": [
+                "appear",
+                "disappear",
+                "clickable",
+                "textEquals",
+                "countStable",
+                "stable"
+              ]
+            },
+            "pollMs": {
+              "type": "number"
+            },
+            "stableReads": {
+              "type": "number"
+            },
+            "elementId": {
+              "type": "string"
             },
             "text": {
-              "type": "string",
-              "description": "Element text"
+              "type": "string"
             },
             "textAny": {
               "type": "array",
               "items": {
                 "type": "string"
-              },
-              "description": "Ordered text variants; first visible match wins"
+              }
             },
             "className": {
-              "type": "string",
-              "description": "Element class name"
+              "type": "string"
             },
             "contentDescription": {
-              "type": "string",
-              "description": "Element content description / accessibility label"
+              "type": "string"
             },
             "matchType": {
               "type": "string",
               "enum": [
                 "all",
                 "any"
-              ],
-              "description": "Whether element predicates must all match one node, or any one may match"
+              ]
             },
             "textMatch": {
               "type": "string",
@@ -3136,23 +3152,18 @@
             "activeWindow": {
               "type": "object",
               "additionalProperties": false,
-              "description": "Foreground app/window predicates (provide an app id or activityName)",
               "properties": {
                 "appId": {
-                  "type": "string",
-                  "description": "Foreground app bundle ID / package name"
+                  "type": "string"
                 },
                 "packageName": {
-                  "type": "string",
-                  "description": "Alias for appId (Android package name)"
+                  "type": "string"
                 },
                 "bundleId": {
-                  "type": "string",
-                  "description": "Alias for appId (iOS bundle ID)"
+                  "type": "string"
                 },
                 "activityName": {
-                  "type": "string",
-                  "description": "Foreground Android activity name (Android-only)"
+                  "type": "string"
                 }
               },
               "anyOf": [
@@ -3178,9 +3189,49 @@
                 }
               ]
             },
+            "absent": {
+              "type": "object",
+              "additionalProperties": false,
+              "description": "Wait until an element matching these fields is absent (text uses contains match)",
+              "properties": {
+                "elementId": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                },
+                "className": {
+                  "type": "string"
+                },
+                "contentDescription": {
+                  "type": "string"
+                }
+              },
+              "anyOf": [
+                {
+                  "required": [
+                    "elementId"
+                  ]
+                },
+                {
+                  "required": [
+                    "text"
+                  ]
+                },
+                {
+                  "required": [
+                    "className"
+                  ]
+                },
+                {
+                  "required": [
+                    "contentDescription"
+                  ]
+                }
+              ]
+            },
             "container": {
               "type": "object",
-              "description": "Scope the match to a container element (by elementId or text)",
               "properties": {
                 "elementId": {
                   "type": "string"
@@ -3188,14 +3239,73 @@
                 "text": {
                   "type": "string"
                 }
-              }
+              },
+              "additionalProperties": false,
+              "oneOf": [
+                {
+                  "required": [
+                    "elementId"
+                  ]
+                },
+                {
+                  "required": [
+                    "text"
+                  ]
+                }
+              ]
             },
             "timeout": {
-              "type": "number",
-              "description": "Wait timeout ms (default 5000)"
+              "type": "number"
+            },
+            "timeoutMs": {
+              "type": "number"
             }
           },
           "anyOf": [
+            {
+              "properties": {
+                "for": {
+                  "const": "stable"
+                }
+              },
+              "required": [
+                "for"
+              ],
+              "not": {
+                "required": [
+                  "container"
+                ]
+              }
+            },
+            {
+              "properties": {
+                "for": {
+                  "not": {
+                    "enum": [
+                      "stable",
+                      "textEquals"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "for",
+                "elementId"
+              ]
+            },
+            {
+              "properties": {
+                "for": {
+                  "not": {
+                    "const": "stable"
+                  }
+                }
+              },
+              "required": [
+                "for",
+                "text"
+              ]
+            },
             {
               "required": [
                 "textAny"
@@ -3237,8 +3347,17 @@
             },
             {
               "not": {
-                "required": [
-                  "textAny"
+                "anyOf": [
+                  {
+                    "required": [
+                      "textAny"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "for"
+                    ]
+                  }
                 ]
               },
               "anyOf": [
@@ -3266,19 +3385,121 @@
                   "required": [
                     "activeWindow"
                   ]
+                },
+                {
+                  "required": [
+                    "absent"
+                  ]
                 }
               ]
             }
           ]
         },
+        "settled": {
+          "description": "After waitFor matches, wait for a quiet hierarchy period (requires waitFor)",
+          "type": "object",
+          "properties": {
+            "quietPeriodMs": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "description": "Quiet-period ms (no hierarchy change) required after waitFor matches"
+            }
+          },
+          "required": [
+            "quietPeriodMs"
+          ],
+          "additionalProperties": false
+        },
         "raw": {
           "description": "Include raw view hierarchy",
           "type": "boolean"
         },
+        "project": {
+          "description": "Output projection. 'full' (default) returns the whole view hierarchy; 'skeleton' returns a flat, actionable-only list (id/label/bounds/affordances) in place of viewHierarchy/elements. Each skeleton id/label is directly usable as a tapOn selector; re-request with raw/project:'full' to disambiguate.",
+          "type": "string",
+          "enum": [
+            "full",
+            "skeleton"
+          ]
+        },
         "skipBackStack": {
           "description": "Skip back stack during waitFor polling",
           "type": "boolean"
         },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "focus": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "resourceId": {
+                      "description": "Anchor by exact resource-id",
+                      "type": "string"
+                    },
+                    "text": {
+                      "description": "Anchor by substring text match",
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Scope to a subtree: true = foreground app; {resourceId|text} = anchor. Needs --observe-focus-scope."
+            },
+            "region": {
+              "description": "Crop to a normalized 0..1 box; true = inset content rect. Needs --observe-region.",
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "x1": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1
+                    },
+                    "y1": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1
+                    },
+                    "x2": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1
+                    },
+                    "y2": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1
+                    }
+                  },
+                  "required": [
+                    "x1",
+                    "y1",
+                    "x2",
+                    "y2"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "overview": {
+              "description": "Collapse to a container skeleton. Needs --observe-overview.",
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Experimental progressive-disclosure scoping of the returned hierarchy (issue #4344)"
+        },
         "sessionUuid": {
           "description": "Session",
           "type": "string"
@@ -3337,7 +3558,12 @@
           }
         }
       },
-      "then": false
+      "then": false,
+      "dependentRequired": {
+        "settled": [
+          "waitFor"
+        ]
+      }
     },
     "outputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -3683,35 +3909,95 @@
                 "left"
               ],
               "additionalProperties": false
-            }
-          },
-          "required": [
-            "available",
-            "source",
-            "units"
-          ],
-          "additionalProperties": false
-        },
-        "layoutWarnings": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "type": {
-                "type": "string",
-                "enum": [
-                  "important-content-under-inset",
-                  "interaction-in-system-gesture-region"
-                ]
-              },
-              "severity": {
-                "type": "string",
-                "enum": [
-                  "warning",
-                  "info"
-                ]
-              },
-              "element": {
+            },
+            "systemChrome": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "visibility": {
+                      "type": "string",
+                      "enum": [
+                        "visible",
+                        "hidden",
+                        "partial",
+                        "unknown"
+                      ]
+                    },
+                    "statusBar": {
+                      "type": "string",
+                      "enum": [
+                        "visible",
+                        "hidden",
+                        "unknown"
+                      ]
+                    },
+                    "navigationBar": {
+                      "type": "string",
+                      "enum": [
+                        "visible",
+                        "hidden",
+                        "unknown"
+                      ]
+                    },
+                    "homeIndicatorAutoHideRequested": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "source": {
+                      "type": "string",
+                      "enum": [
+                        "android-window-insets",
+                        "ios-status-bar-manager"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "visibility",
+                    "statusBar",
+                    "source"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "available",
+            "source",
+            "units"
+          ],
+          "additionalProperties": false
+        },
+        "layoutWarnings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "important-content-under-inset",
+                  "interaction-in-system-gesture-region"
+                ]
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "warning",
+                  "info"
+                ]
+              },
+              "element": {
                 "type": "object",
                 "properties": {
                   "viewId": {
@@ -3798,6 +4084,42 @@
                   ]
                 }
               },
+              "overflowPx": {
+                "type": "object",
+                "properties": {
+                  "top": {
+                    "type": "number"
+                  },
+                  "right": {
+                    "type": "number"
+                  },
+                  "bottom": {
+                    "type": "number"
+                  },
+                  "left": {
+                    "type": "number"
+                  }
+                },
+                "additionalProperties": false
+              },
+              "insetPx": {
+                "type": "object",
+                "properties": {
+                  "top": {
+                    "type": "number"
+                  },
+                  "right": {
+                    "type": "number"
+                  },
+                  "bottom": {
+                    "type": "number"
+                  },
+                  "left": {
+                    "type": "number"
+                  }
+                },
+                "additionalProperties": false
+              },
               "overlapPercent": {
                 "type": "integer",
                 "minimum": -9007199254740991,
@@ -3818,6 +4140,8 @@
               "categories",
               "insetTypes",
               "sides",
+              "overflowPx",
+              "insetPx",
               "overlapPercent",
               "confidence"
             ],
@@ -4219,6 +4543,66 @@
                     "left"
                   ],
                   "additionalProperties": false
+                },
+                "systemChrome": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "visibility": {
+                          "type": "string",
+                          "enum": [
+                            "visible",
+                            "hidden",
+                            "partial",
+                            "unknown"
+                          ]
+                        },
+                        "statusBar": {
+                          "type": "string",
+                          "enum": [
+                            "visible",
+                            "hidden",
+                            "unknown"
+                          ]
+                        },
+                        "navigationBar": {
+                          "type": "string",
+                          "enum": [
+                            "visible",
+                            "hidden",
+                            "unknown"
+                          ]
+                        },
+                        "homeIndicatorAutoHideRequested": {
+                          "anyOf": [
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ]
+                        },
+                        "source": {
+                          "type": "string",
+                          "enum": [
+                            "android-window-insets",
+                            "ios-status-bar-manager"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "visibility",
+                        "statusBar",
+                        "source"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 }
               },
               "required": [
@@ -4231,6 +4615,59 @@
           },
           "additionalProperties": {}
         },
+        "skeleton": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "bounds": {
+                "type": "array",
+                "prefixItems": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "number"
+                  }
+                ],
+                "description": "Bounds as the compact [left, top, right, bottom] tuple — always this shape for skeleton entries, independent of the --observe-result-compact flag."
+              },
+              "affordances": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "tap",
+                    "long-press",
+                    "input",
+                    "scroll",
+                    "toggle"
+                  ]
+                }
+              },
+              "checked": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "bounds",
+              "affordances"
+            ],
+            "additionalProperties": {}
+          }
+        },
         "activeWindow": {
           "type": "object",
           "properties": {
@@ -4285,12 +4722,18 @@
                 "bundleId": {
                   "type": "string"
                 },
+                "navigationRoute": {
+                  "type": "string"
+                },
                 "navigationTitle": {
                   "type": "string"
                 },
                 "selectedTab": {
                   "type": "string"
                 },
+                "presentation": {
+                  "type": "string"
+                },
                 "modalClass": {
                   "type": "string"
                 },
@@ -5077,125 +5520,550 @@
           ],
           "additionalProperties": {}
         },
-        "freshness": {
+        "matched": {
+          "type": "boolean"
+        },
+        "settled": {
+          "type": "boolean"
+        },
+        "timedOut": {
+          "type": "boolean"
+        },
+        "polls": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "waitMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "matchedElement": {
           "type": "object",
           "properties": {
-            "requestedAfter": {
-              "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]."
             },
-            "actualTimestamp": {
-              "type": "integer",
-              "minimum": -9007199254740991,
-              "maximum": 9007199254740991
+            "text": {
+              "type": "string"
             },
-            "isFresh": {
-              "type": "boolean"
+            "resource-id": {
+              "type": "string"
             },
-            "staleDurationMs": {
-              "type": "integer",
-              "minimum": -9007199254740991,
-              "maximum": 9007199254740991
+            "view-id": {
+              "type": "string"
             },
-            "warning": {
+            "content-desc": {
               "type": "string"
-            }
-          },
-          "required": [
-            "isFresh"
-          ],
-          "additionalProperties": {}
-        },
-        "predictions": {
-          "type": "object",
-          "properties": {
-            "likelyActions": {
-              "type": "array",
-              "items": {
+            },
+            "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": {}
+        },
+        "candidates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "bounds": {
                 "type": "object",
                 "properties": {
-                  "action": {
-                    "type": "string"
+                  "left": {
+                    "type": "number"
                   },
-                  "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": {}
+                  "top": {
+                    "type": "number"
                   },
-                  "predictedScreen": {
-                    "type": "string"
+                  "right": {
+                    "type": "number"
                   },
-                  "predictedElements": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
+                  "bottom": {
+                    "type": "number"
                   },
-                  "confidence": {
+                  "centerX": {
+                    "type": "number"
+                  },
+                  "centerY": {
                     "type": "number"
                   }
                 },
                 "required": [
-                  "action",
-                  "target",
-                  "predictedScreen",
-                  "confidence"
+                  "left",
+                  "top",
+                  "right",
+                  "bottom"
                 ],
-                "additionalProperties": {}
-              }
-            },
-            "interactableElements": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "elementId": {
-                    "type": "string"
-                  },
-                  "elementText": {
-                    "type": "string"
-                  },
+                "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"
                   },
@@ -5219,107 +6087,527 @@
                     "additionalProperties": false
                   }
                 },
-                "additionalProperties": {}
-              }
-            }
-          },
-          "required": [
-            "likelyActions",
-            "interactableElements"
-          ],
-          "additionalProperties": {}
-        },
-        "accessibilityState": {
-          "type": "object",
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "service": {
-              "type": "string",
-              "enum": [
-                "talkback",
-                "voiceover",
-                "unknown"
+                "additionalProperties": {}
+              }
+            }
+          },
+          "required": [
+            "likelyActions",
+            "interactableElements"
+          ],
+          "additionalProperties": {}
+        },
+        "accessibilityState": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "service": {
+              "type": "string",
+              "enum": [
+                "talkback",
+                "voiceover",
+                "unknown"
+              ]
+            }
+          },
+          "required": [
+            "enabled",
+            "service"
+          ],
+          "additionalProperties": {}
+        },
+        "deviceLock": {
+          "type": "object",
+          "properties": {
+            "locked": {
+              "type": "boolean"
+            },
+            "keyguardShowing": {
+              "type": "boolean"
+            },
+            "secure": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "locked",
+            "keyguardShowing"
+          ],
+          "additionalProperties": false
+        },
+        "observeScope": {
+          "type": "object",
+          "properties": {
+            "applied": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "focus",
+                  "region",
+                  "overview"
+                ]
+              }
+            },
+            "gatedOff": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "focus",
+                  "region",
+                  "overview"
+                ]
+              }
+            },
+            "nodesBefore": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "nodesAfter": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "regionPx": {
+              "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]."
+            },
+            "focus": {
+              "type": "object",
+              "properties": {
+                "by": {
+                  "type": "string",
+                  "enum": [
+                    "anchor",
+                    "foreground-app"
+                  ]
+                },
+                "matched": {
+                  "type": "boolean"
+                },
+                "packageName": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "by",
+                "matched"
+              ],
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "applied",
+            "nodesBefore",
+            "nodesAfter"
+          ],
+          "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"
+          ]
+        },
+        "waitFor": {
+          "type": "object",
+          "additionalProperties": false,
+          "not": {
+            "required": [
+              "timeout",
+              "timeoutMs"
+            ]
+          },
+          "properties": {
+            "for": {
+              "type": "string",
+              "enum": [
+                "appear",
+                "disappear",
+                "clickable",
+                "textEquals",
+                "countStable",
+                "stable"
+              ]
+            },
+            "pollMs": {
+              "type": "number"
+            },
+            "stableReads": {
+              "type": "number"
+            },
+            "elementId": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "textAny": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "className": {
+              "type": "string"
+            },
+            "contentDescription": {
+              "type": "string"
+            },
+            "matchType": {
+              "type": "string",
+              "enum": [
+                "all",
+                "any"
+              ]
+            },
+            "textMatch": {
+              "type": "string",
+              "enum": [
+                "exact",
+                "contains",
+                "regex"
+              ],
+              "description": "How to match waitFor.text; does not affect contentDescription"
+            },
+            "activeWindow": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "appId": {
+                  "type": "string"
+                },
+                "packageName": {
+                  "type": "string"
+                },
+                "bundleId": {
+                  "type": "string"
+                },
+                "activityName": {
+                  "type": "string"
+                }
+              },
+              "anyOf": [
+                {
+                  "required": [
+                    "appId"
+                  ]
+                },
+                {
+                  "required": [
+                    "packageName"
+                  ]
+                },
+                {
+                  "required": [
+                    "bundleId"
+                  ]
+                },
+                {
+                  "required": [
+                    "activityName"
+                  ]
+                }
+              ]
+            },
+            "absent": {
+              "type": "object",
+              "additionalProperties": false,
+              "description": "Wait until an element matching these fields is absent (text uses contains match)",
+              "properties": {
+                "elementId": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                },
+                "className": {
+                  "type": "string"
+                },
+                "contentDescription": {
+                  "type": "string"
+                }
+              },
+              "anyOf": [
+                {
+                  "required": [
+                    "elementId"
+                  ]
+                },
+                {
+                  "required": [
+                    "text"
+                  ]
+                },
+                {
+                  "required": [
+                    "className"
+                  ]
+                },
+                {
+                  "required": [
+                    "contentDescription"
+                  ]
+                }
+              ]
+            },
+            "container": {
+              "type": "object",
+              "properties": {
+                "elementId": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false,
+              "oneOf": [
+                {
+                  "required": [
+                    "elementId"
+                  ]
+                },
+                {
+                  "required": [
+                    "text"
+                  ]
+                }
+              ]
+            },
+            "timeout": {
+              "type": "number"
+            },
+            "timeoutMs": {
+              "type": "number"
+            }
+          },
+          "anyOf": [
+            {
+              "properties": {
+                "for": {
+                  "const": "stable"
+                }
+              },
+              "required": [
+                "for"
+              ],
+              "not": {
+                "required": [
+                  "container"
+                ]
+              }
+            },
+            {
+              "properties": {
+                "for": {
+                  "not": {
+                    "enum": [
+                      "stable",
+                      "textEquals"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "for",
+                "elementId"
+              ]
+            },
+            {
+              "properties": {
+                "for": {
+                  "not": {
+                    "const": "stable"
+                  }
+                }
+              },
+              "required": [
+                "for",
+                "text"
+              ]
+            },
+            {
+              "required": [
+                "textAny"
+              ],
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "elementId"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "text"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "className"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "contentDescription"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "matchType"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "textMatch"
+                    ]
+                  }
+                ]
+              }
+            },
+            {
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "textAny"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "for"
+                    ]
+                  }
+                ]
+              },
+              "anyOf": [
+                {
+                  "required": [
+                    "elementId"
+                  ]
+                },
+                {
+                  "required": [
+                    "text"
+                  ]
+                },
+                {
+                  "required": [
+                    "className"
+                  ]
+                },
+                {
+                  "required": [
+                    "contentDescription"
+                  ]
+                },
+                {
+                  "required": [
+                    "activeWindow"
+                  ]
+                },
+                {
+                  "required": [
+                    "absent"
+                  ]
+                }
               ]
             }
-          },
-          "required": [
-            "enabled",
-            "service"
-          ],
-          "additionalProperties": {}
-        },
-        "deviceLock": {
-          "type": "object",
-          "properties": {
-            "locked": {
-              "type": "boolean"
-            },
-            "keyguardShowing": {
-              "type": "boolean"
-            },
-            "secure": {
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "locked",
-            "keyguardShowing"
-          ],
-          "additionalProperties": false
+          ]
         },
-        "artifact": {
+        "settled": {
+          "description": "After waitFor matches, wait for a quiet hierarchy period (requires waitFor)",
           "type": "object",
           "properties": {
-            "path": {
-              "type": "string"
-            },
-            "format": {
-              "type": "string",
-              "const": "json"
-            },
-            "payload": {
-              "type": "string"
-            },
-            "bytes": {
+            "quietPeriodMs": {
               "type": "integer",
-              "minimum": 0,
-              "maximum": 9007199254740991
-            },
-            "tool": {
-              "type": "string"
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "description": "Quiet-period ms (no hierarchy change) required after waitFor matches"
             }
           },
           "required": [
-            "path",
-            "format",
-            "payload",
-            "bytes",
-            "tool"
+            "quietPeriodMs"
           ],
-          "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"
-          ]
+          "additionalProperties": false
         },
         "sessionUuid": {
           "description": "Session",
@@ -5337,7 +6625,55 @@
         "url",
         "platform"
       ],
-      "additionalProperties": false
+      "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"
+                      ]
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "then": false,
+      "dependentRequired": {
+        "settled": [
+          "waitFor"
+        ]
+      }
     }
   },
   {
@@ -5999,7 +7335,7 @@
   },
   {
     "name": "setAppPermissions",
-    "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)",
+    "description": "userId grant/revoke; device-wide reset ['all']; no POST_NOTIFICATIONS.",
     "inputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -6008,8 +7344,6 @@
           "type": "string"
         },
         "action": {
-          "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",
             "revoke",
@@ -6017,7 +7351,6 @@
           ]
         },
         "permissions": {
-          "description": "Runtime permissions or simulator privacy services to change; iOS physical reset accepts 'all'",
           "type": "array",
           "items": {
             "type": "string",
@@ -6025,18 +7358,17 @@
           }
         },
         "userId": {
-          "description": "Android user id",
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
         },
+        "notificationsEnabled": {
+          "type": "boolean"
+        },
         "notificationPolicyAccess": {
-          "description": "Android: set DND policy access",
           "type": "boolean"
         },
         "scheduleExactAlarm": {
-          "description": "Android: set SCHEDULE_EXACT_ALARM appop",
-          "type": "string",
           "enum": [
             "allow",
             "deny"
@@ -6050,21 +7382,60 @@
           ]
         },
         "sessionUuid": {
-          "description": "Session",
           "type": "string"
         },
         "keepScreenAwake": {
           "type": "boolean"
         },
         "device": {
-          "description": "Device label",
           "type": "string"
         }
       },
       "required": [
         "appId"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "if": {
+        "properties": {
+          "action": {
+            "const": "reset"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "then": {
+        "required": [
+          "permissions"
+        ],
+        "not": {
+          "required": [
+            "userId"
+          ]
+        },
+        "if": {
+          "properties": {
+            "platform": {
+              "const": "android"
+            }
+          },
+          "required": [
+            "platform"
+          ]
+        },
+        "then": {
+          "properties": {
+            "permissions": {
+              "minItems": 1,
+              "maxItems": 1,
+              "items": {
+                "const": "all"
+              }
+            }
+          }
+        }
+      }
     }
   },
   {
@@ -6980,7 +8351,7 @@
   },
   {
     "name": "tapOn",
-    "description": "Tap an element by text/content-desc or resource-id; use sibling for adjacent controls.",
+    "description": "Tap an element by text/content-desc, resource-id, or Android test tag; use sibling for adjacent controls.",
     "inputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -6994,6 +8365,11 @@
               "minLength": 1,
               "description": "Resource ID, e.g. com.app:id/btn_login"
             },
+            "testTag": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Android accessibility test tag"
+            },
             "text": {
               "type": "string",
               "minLength": 1,
@@ -7015,6 +8391,11 @@
                 "elementId"
               ]
             },
+            {
+              "required": [
+                "testTag"
+              ]
+            },
             {
               "required": [
                 "text"
@@ -7026,7 +8407,7 @@
               ]
             }
           ],
-          "description": "Element to tap: elementId, text, or ordered text variants"
+          "description": "Element to tap: elementId, Android testTag, text, or ordered text variants"
         },
         "sibling": {
           "description": "Tap a clickable sibling of the match, e.g. checkbox beside label",
@@ -7902,12 +9283,18 @@
                         "bundleId": {
                           "type": "string"
                         },
+                        "navigationRoute": {
+                          "type": "string"
+                        },
                         "navigationTitle": {
                           "type": "string"
                         },
                         "selectedTab": {
                           "type": "string"
                         },
+                        "presentation": {
+                          "type": "string"
+                        },
                         "modalClass": {
                           "type": "string"
                         },
@@ -8060,12 +9447,18 @@
                         "bundleId": {
                           "type": "string"
                         },
+                        "navigationRoute": {
+                          "type": "string"
+                        },
                         "navigationTitle": {
                           "type": "string"
                         },
                         "selectedTab": {
                           "type": "string"
                         },
+                        "presentation": {
+                          "type": "string"
+                        },
                         "modalClass": {
                           "type": "string"
                         },
@@ -8154,12 +9547,18 @@
                         "bundleId": {
                           "type": "string"
                         },
+                        "navigationRoute": {
+                          "type": "string"
+                        },
                         "navigationTitle": {
                           "type": "string"
                         },
                         "selectedTab": {
                           "type": "string"
                         },
+                        "presentation": {
+                          "type": "string"
+                        },
                         "modalClass": {
                           "type": "string"
                         },
@@ -9411,5 +10810,41 @@
       ],
       "additionalProperties": false
     }
+  },
+  {
+    "name": "wakeAndUnlock",
+    "description": "Wake a device and unlock its keyguard. Android: swipe lock or secure PIN via `pin`; iOS: wake + swipe-dismiss (pin ignored).",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "pin": {
+          "description": "Credential to unlock a secure Android device. Optional; logically required to unlock a secure lock unless a pin was already remembered this session. Ignored on iOS.",
+          "type": "string"
+        },
+        "platform": {
+          "type": "string",
+          "enum": [
+            "android",
+            "ios"
+          ]
+        },
+        "sessionUuid": {
+          "description": "Session",
+          "type": "string"
+        },
+        "keepScreenAwake": {
+          "type": "boolean"
+        },
+        "device": {
+          "description": "Device label",
+          "type": "string"
+        }
+      },
+      "required": [
+        "platform"
+      ],
+      "additionalProperties": false
+    }
   }
 ]