feat(perception): expose active app metadata in UI tree

2026-07-16 08:13:04 +08:00
parent 059fb272bb
commit 9a17297f1e
13 changed files with 246 additions and 17 deletions
@@ -10,6 +10,11 @@ list of UI elements with id, type, text, and pixel bounds), and — when
 available — a screenshot of the same screen and a short history of recent
 actions and their outcomes.

+The Scene may include an `app` object with the live foreground application's
+native identifier. On iOS, use `bundle_id`; on Android, use `package` and
+`activity`. This metadata may be omitted when the current driver cannot query
+it.
+
 Some elements also carry accessibility state fields when the platform
 reports them: `enabled`, `clickable`, `selected`, `checked`, `focused`.
 A field is omitted entirely when the platform does not report it for that