@devicelab/maestro-runner-darwin-arm64 1.1.27 → 1.1.29

package/README.md

@@ -10,13 +10,14 @@
 <br>
 *Supports real iOS devices, simulators, emulators, desktop browsers, and cloud providers.*
 
-![3.6x faster](https://img.shields.io/badge/3.6x_faster-3a9d5c?style=for-the-badge) ![14x less memory](https://img.shields.io/badge/14x_less_memory-3a9d5c?style=for-the-badge)
+![~5x faster vs Maestro CLI](https://img.shields.io/badge/~5x_faster_vs_Maestro_CLI-3a9d5c?style=for-the-badge) ![14x less memory](https://img.shields.io/badge/14x_less_memory-3a9d5c?style=for-the-badge)
+
+[![npm installs/mo](https://img.shields.io/npm/dm/maestro-runner?label=npm%20installs%2Fmo&color=cb3837&style=for-the-badge)](https://www.npmjs.com/package/maestro-runner) [![GitHub downloads](https://img.shields.io/github/downloads/devicelab-dev/maestro-runner/total?label=github%20downloads&color=17a2b8&style=for-the-badge)](https://github.com/devicelab-dev/maestro-runner/releases) [![CI runs](https://img.shields.io/endpoint?url=https://open.devicelab.dev/api/maestro-runner/shield&style=for-the-badge)](https://www.npmjs.com/package/maestro-runner)
 
 [![license](https://img.shields.io/badge/license-Apache_2.0-blue.svg?style=for-the-badge)](LICENSE)
 [![by](https://img.shields.io/badge/by-DeviceLab.dev-17a2b8.svg?style=for-the-badge)](https://devicelab.dev)
 
 [![npm](https://img.shields.io/npm/v/maestro-runner?label=npm&color=cb3837)](https://www.npmjs.com/package/maestro-runner)
-[![npm downloads](https://img.shields.io/npm/dm/maestro-runner)](https://www.npmjs.com/package/maestro-runner)
 [![CI](https://github.com/devicelab-dev/maestro-runner/actions/workflows/ci.yml/badge.svg)](https://github.com/devicelab-dev/maestro-runner/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/devicelab-dev/maestro-runner/branch/main/graph/badge.svg)](https://codecov.io/gh/devicelab-dev/maestro-runner)
 [![Go Report Card](https://goreportcard.com/badge/github.com/devicelab-dev/maestro-runner?v=2)](https://goreportcard.com/report/github.com/devicelab-dev/maestro-runner)
@@ -36,6 +37,15 @@
 
 ## Install
 
+**Shell** — macOS and Linux:
+
+```bash
+curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash
+
+# A specific version
+curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash -s -- --version 1.1.28
+```
+
 **npm** — for React Native, Expo, or any project that already has a `package.json`:
 
 ```bash
@@ -45,15 +55,6 @@ npm install --save-dev maestro-runner   # or pin it in the project
 
 Pinning it means every machine and every CI job runs the same version with no separate bootstrap. There is no postinstall and nothing is downloaded at install time: the binary for your platform arrives as an ordinary optional dependency npm selects by `os` and `cpu`, so installs work offline, behind a proxy, and in CI that blocks postinstall network access.
 
-**Shell** — everywhere else:
-
-```bash
-curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash
-
-# A specific version
-curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash -s -- --version 1.1.25
-```
-
 Both give you the same binary. macOS and Linux, arm64 and x64; on Windows, use WSL.
 
 ## First run
@@ -81,10 +82,10 @@ maestro-runner test --parallel 3 flows/                                 # Parall
 - **Cloud testing** — BrowserStack, Sauce Labs, LambdaTest, TestingBot via Appium driver [Guide →](https://devicelab.dev/blog/run-maestro-flows-any-cloud)
 - **Desktop browser testing** — Run Maestro flows on Chrome/Chromium via CDP. Supports `css`, `xpath`, `id`, and `text` selectors with `--platform web` [Guide →](https://devicelab.dev/open-source/maestro-runner/docs/web-testing)
 - **React Native & Flutter** — Smart element finding for RN testIDs and Flutter semantics [Guide →](https://devicelab.dev/blog/flutter-testing-maestro-patrol-appium)
-- **DeviceLab driver** — Optional on-device Android driver via WebSocket, ~2x faster than UIAutomator2 and ~5x faster than Maestro CLI. Just add `--driver devicelab`
+- **DeviceLab driver** — The default driver on Android and iOS. On Android an on-device agent over WebSocket, ~2x faster than UIAutomator2 and ~5x faster than Maestro CLI; on iOS a prebuilt XCUITest agent, on simulators and real iPhones
 - **Parallel execution** — Dynamic work distribution across devices, not static sharding. Faster devices pick up more tests automatically, so no device sits idle
 - **App install built-in** — `--app-file app.apk` installs the app before testing, so you always test the right build
-- **Wide OS compatibility** — Android 5.0+ (API 21+) and iOS 12.0+, no version restrictions
+- **Wide OS compatibility** — Android 5.0+ (API 21+) and iOS 15.0+, no version restrictions
 - **Reports** — HTML, JUnit XML, and Allure-compatible reports out of the box
 - **Clear error messages** — `element not found: text="Login"` instead of `io.grpc.StatusRuntimeException: UNKNOWN`
 - **Pre-flight validation** — Catches flow errors, circular dependencies, and missing files before execution starts
@@ -100,15 +101,16 @@ maestro-runner test --parallel 3 flows/                                 # Parall
 
 | Driver | Platform | Description |
 |--------|----------|-------------|
-| **UIAutomator2** | Android | Direct connection to device. Default driver, no external server needed. |
-| **DeviceLab** | Android | `--driver devicelab`. On-device WebSocket driver, ~2x faster than UIAutomator2. |
-| **WDA (WebDriverAgent)** | iOS | Auto-selected with `--platform ios`. Supports simulators and physical devices. |
+| **DeviceLab** | Android | Default since v1.1.28. On-device WebSocket driver, ~2x faster than UIAutomator2. |
+| **UIAutomator2** | Android | `--driver uiautomator2`. Direct connection to the device, no external server needed. |
+| **DeviceLab** | iOS | Default since v1.1.28. The DeviceLab iOS agent, on simulators and real iPhones (real iPhones need `--team-id`). `--driver devicelab-legacy` keeps the previous runner. |
+| **WDA (WebDriverAgent)** | iOS | `--driver wda`. Supports simulators and physical devices. |
 | **Browser (CDP)** | Web | `--platform web`. Chrome/Chromium automation via Chrome DevTools Protocol. |
 | **Appium** | Android & iOS | `--driver appium`. For cloud testing providers and existing Appium infrastructure. |
 
 ### DeviceLab Driver (Android)
 
-The DeviceLab driver is an alternative Android driver that runs automation directly on the device via WebSocket. It skips the UIAutomator2 HTTP layer, resulting in ~2x faster test execution compared to the default driver — and ~5x faster than Maestro CLI.
+The DeviceLab driver is the default Android driver (since v1.1.28). It runs automation directly on the device via WebSocket, skipping the UIAutomator2 HTTP layer, for ~2x faster test execution than UIAutomator2 — and ~5x faster than Maestro CLI. `--driver uiautomator2` selects the previous default.
 
 ```
 Benchmark: 9 flows, 163 steps on Pixel 4a (Android 13)
@@ -119,7 +121,8 @@ Benchmark: 9 flows, 163 steps on Pixel 4a (Android 13)
 ```
 
 ```bash
-maestro-runner --driver devicelab --platform android test flows/
+maestro-runner --platform android test flows/          # DeviceLab
+maestro-runner --driver uiautomator2 test flows/        # UIAutomator2
 ```
 
 All existing Maestro YAML flows work as-is — no changes needed. The driver also includes bounds stabilization for animated elements and improved special character handling in text selectors.
@@ -178,11 +181,36 @@ maestro-runner --driver appium --appium-url <HUB_URL> --caps caps.json test flow
 - **[TestingBot](docs/cloud-providers/testingbot.md)** — Setup guide for running on TestingBot's real device cloud
 - **[Sauce Labs](docs/cloud-providers/saucelabs.md)** — Setup guide for running on Sauce Labs Appium cloud
 
+## Telemetry
+
+maestro-runner sends one anonymous usage event at the end of each `test` run:
+counts and versions only, such as runner version, platform, driver, device
+kind, flow and step counts, failure kinds and duration. It holds no machine or
+user id, no flow or file names, selectors, app ids, URLs, environment values or
+error messages, and nothing is written on your machine. Projects are told
+apart by a one-way hash of the list of flow files you run; the names
+themselves are never sent.
+
+Turn it off with `MAESTRO_RUNNER_NO_TELEMETRY=1` or `DO_NOT_TRACK=1`. Set
+`MAESTRO_RUNNER_TELEMETRY_DEBUG=1` to print the event instead of sending it.
+[Telemetry](https://open.devicelab.dev/maestro-runner/docs/telemetry) lists every field.
+
+The update check is separate and unchanged.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## License
 
-Apache License 2.0 — see [LICENSE](LICENSE).
+maestro-runner is licensed under the Apache License 2.0 — see [LICENSE](LICENSE).
+
+### DeviceLab driver binaries
+
+The prebuilt on-device agents behind `--driver devicelab` (the Android agent APKs and the iOS agent in
+`drivers/ios/devicelab-ios-agent/`) are free to use with maestro-runner, including commercially, but they
+are not open source. You may redistribute them unmodified as part of maestro-runner (forks, Docker images,
+CI caches); you may not modify them, ship them separately, or reverse-engineer them, except as permitted by
+applicable law. See [drivers/LICENSE-BINARIES.md](drivers/LICENSE-BINARIES.md) for the full terms.
+Everything else in this repository, including the other drivers, keeps its open-source license.
 

package/drivers/LICENSE-BINARIES.md

@@ -0,0 +1,38 @@
+# DeviceLab driver binaries license
+
+maestro-runner's source code is licensed under the Apache License 2.0 (see [../LICENSE](../LICENSE)).
+The prebuilt on-device agents listed below are **not** open source. They are proprietary software
+of DeviceLab, shipped as binaries only, and are covered by this license instead of the Apache License.
+
+## What this covers
+
+- `drivers/android/devicelab-android-driver.apk` and `drivers/android/devicelab-android-driver-test.apk`:
+  the DeviceLab Android agent (`--driver devicelab` on Android).
+- `drivers/ios/devicelab-ios-agent/simulator/` and `drivers/ios/devicelab-ios-agent/device/`:
+  the DeviceLab iOS agent (`--driver devicelab` on iOS simulators and real iPhones).
+
+Everything else in `drivers/` keeps its own license. In particular, `drivers/ios/devicelab-ios-agent/signing-stub/`
+and `drivers/ios/DevicelabIOSRunner/` are source code under the Apache License 2.0, and
+`drivers/ios/WebDriverAgent/` and the Appium UiAutomator2 server APKs are under their upstream licenses.
+
+## What you may do
+
+- **Use** the agents, free of charge, with maestro-runner, for any purpose, including commercial testing,
+  on your own devices, simulators, emulators, CI machines and device clouds.
+- **Redistribute** the agents **unmodified and only as part of maestro-runner**, for example in a fork of
+  maestro-runner, a Docker image, a CI cache or a package mirror, as long as this license file goes with them.
+
+## What you may not do
+
+- Modify the agents, or distribute modified copies.
+- Distribute the agents separately from maestro-runner, or use them with other software.
+- Reverse-engineer, decompile or disassemble the agents, **except as permitted by applicable law**
+  (for example, where the law allows decompilation to achieve interoperability) and then only to that extent.
+- Remove or change any notices in them.
+
+## No warranty
+
+The agents are provided "as is", without warranty of any kind, express or implied, including fitness for a
+particular purpose. In no event is DeviceLab liable for any claim or damages arising from their use.
+
+Copyright © DeviceLab. All rights not expressly granted here are reserved.

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunner.xcodeproj/project.pbxproj

@@ -7,22 +7,27 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		0E98ADDBC272C50738DC8CD0 /* RunnerTests+AXSnapshotFallback.swift in Sources */ = {isa = PBXBuildFile; fileRef = 155BA71440123190E29851CA /* RunnerTests+AXSnapshotFallback.swift */; };
 		185FD4F00E4669AEA940FBE7 /* SyntheticTyping.m in Sources */ = {isa = PBXBuildFile; fileRef = 2DDAC8B41684AB39CF12AB26 /* SyntheticTyping.m */; };
-		5AA0000000000000000000A0 /* SnapshotParams.m in Sources */ = {isa = PBXBuildFile; fileRef = 5AA0000000000000000000B0 /* SnapshotParams.m */; };
 		1934AC9AF1E68AFB58165881 /* RunnerTests+Transport.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0F2F4CA6FCF47D767563E5B /* RunnerTests+Transport.swift */; };
 		1EBCEDDEE576BAC031B5F650 /* RunnerTests+TvRemote.swift in Sources */ = {isa = PBXBuildFile; fileRef = 052AE177317DC11EE9E6FA7E /* RunnerTests+TvRemote.swift */; };
 		3A438251A66B70243B49C363 /* RunnerObjCExceptionCatcher.m in Sources */ = {isa = PBXBuildFile; fileRef = 2F3D4FD2D89EB2902E04F5E7 /* RunnerObjCExceptionCatcher.m */; };
+		4659D9413345418ED423099D /* SnapshotParams.m in Sources */ = {isa = PBXBuildFile; fileRef = 55858AF44FEAC9673F1E0576 /* SnapshotParams.m */; };
 		5C60ADDEFA796950D2D9B2E4 /* App.swift in Sources */ = {isa = PBXBuildFile; fileRef = FF45EB7E8079FDDBBBD08BB1 /* App.swift */; };
 		6685298D4A7C6D1E5ADF44F2 /* RunnerTests+Environment.swift in Sources */ = {isa = PBXBuildFile; fileRef = 16BC8ADD3E7C4A137D1A2546 /* RunnerTests+Environment.swift */; };
 		6C7B733A9DB7FBBC0892582E /* RunnerTests+Models.swift in Sources */ = {isa = PBXBuildFile; fileRef = 20458AB5D7605E7B24151715 /* RunnerTests+Models.swift */; };
 		6EA61DBF3C1AEF63B4AABAD3 /* RunnerTests+Interaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 468BFB67EE69287E9AA8C512 /* RunnerTests+Interaction.swift */; };
 		753D50338AB047FE4BDA92DE /* RunnerTests+SystemModal.swift in Sources */ = {isa = PBXBuildFile; fileRef = D2D00808BC0A6635CC9AEFD7 /* RunnerTests+SystemModal.swift */; };
+		7CBD677BC0DA6D2E155FFED7 /* RunnerXCTestTimeouts.m in Sources */ = {isa = PBXBuildFile; fileRef = 2EF9BCC5D11121DD792F8416 /* RunnerXCTestTimeouts.m */; };
 		883D9C64B55EABF9DD286026 /* RunnerTests+ScreenRecorder.swift in Sources */ = {isa = PBXBuildFile; fileRef = 486553A4A4966C42E0BA3314 /* RunnerTests+ScreenRecorder.swift */; };
+		935DFF9FD90A1CC730FB01BD /* RunnerTests+Media.swift in Sources */ = {isa = PBXBuildFile; fileRef = E54CF5C60340EA7867252AE1 /* RunnerTests+Media.swift */; };
 		BBE1C2487D218AF14EB8F127 /* RunnerTests+Snapshot.swift in Sources */ = {isa = PBXBuildFile; fileRef = CBA37358B6FEEE7B17DE26C9 /* RunnerTests+Snapshot.swift */; };
-		5AA0000000000000000000D0 /* RunnerTests+Media.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5AA0000000000000000000E0 /* RunnerTests+Media.swift */; };
 		C44D44B56B95EEDD2E2C78BF /* ATTRIBUTION.md in Resources */ = {isa = PBXBuildFile; fileRef = 20D2D6E64928481F1F3AC354 /* ATTRIBUTION.md */; };
+		C61B79F30D27A451B927E289 /* RunnerTests+Settle.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8A0E64F07949C3F6C2CD10A9 /* RunnerTests+Settle.swift */; };
+		C8F6372DED85BBDB4687E99F /* RunnerAXSnapshotBridge.m in Sources */ = {isa = PBXBuildFile; fileRef = C42BBDB1257C3A74D4567CEC /* RunnerAXSnapshotBridge.m */; };
 		CF03E8165BEF555C3066F91A /* RunnerTests+CommandExecution.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8219A88A3A382A1DCC1CD098 /* RunnerTests+CommandExecution.swift */; };
 		D2B5963E6A06D33E24818A5B /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 76DCB825707F4A9C7A7E52CD /* RunnerTests.swift */; };
+		DDA1839481EFE1A55737E6FF /* RunnerDefaults.m in Sources */ = {isa = PBXBuildFile; fileRef = 85D1B6DFA2AF5D1C3F7F27CA /* RunnerDefaults.m */; };
 		EA43358836154F8D4F9FE578 /* RunnerTests+Lifecycle.swift in Sources */ = {isa = PBXBuildFile; fileRef = B637C3282A1017BA1768285E /* RunnerTests+Lifecycle.swift */; };
 		EEB7DF86007CC0A16163735F /* PixelDiff.swift in Sources */ = {isa = PBXBuildFile; fileRef = EF627B1D914552B1489154FE /* PixelDiff.swift */; };
 		F7A75F36B53A883D3CC01192 /* RunnerTests+Alert.swift in Sources */ = {isa = PBXBuildFile; fileRef = 58840AA09B61534F808615A5 /* RunnerTests+Alert.swift */; };
@@ -41,29 +46,38 @@
 /* Begin PBXFileReference section */
 		0023C503084D2BC94E22737C /* XCSynthesizedEventRecord.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = XCSynthesizedEventRecord.h; sourceTree = "<group>"; };
 		052AE177317DC11EE9E6FA7E /* RunnerTests+TvRemote.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+TvRemote.swift"; sourceTree = "<group>"; };
+		155BA71440123190E29851CA /* RunnerTests+AXSnapshotFallback.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+AXSnapshotFallback.swift"; sourceTree = "<group>"; };
 		16BC8ADD3E7C4A137D1A2546 /* RunnerTests+Environment.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Environment.swift"; sourceTree = "<group>"; };
 		20458AB5D7605E7B24151715 /* RunnerTests+Models.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Models.swift"; sourceTree = "<group>"; };
 		20D2D6E64928481F1F3AC354 /* ATTRIBUTION.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = ATTRIBUTION.md; sourceTree = "<group>"; };
 		2DDAC8B41684AB39CF12AB26 /* SyntheticTyping.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SyntheticTyping.m; sourceTree = "<group>"; };
-		5AA0000000000000000000B0 /* SnapshotParams.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SnapshotParams.m; sourceTree = "<group>"; };
 		2DE81DFDC1470520344A831F /* XCPointerEventPath.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = XCPointerEventPath.h; sourceTree = "<group>"; };
+		2EF9BCC5D11121DD792F8416 /* RunnerXCTestTimeouts.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = RunnerXCTestTimeouts.m; sourceTree = "<group>"; };
 		2F3D4FD2D89EB2902E04F5E7 /* RunnerObjCExceptionCatcher.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = RunnerObjCExceptionCatcher.m; sourceTree = "<group>"; };
+		326F3161DCA93EC852BC41A8 /* RunnerDefaults.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = RunnerDefaults.h; sourceTree = "<group>"; };
 		468BFB67EE69287E9AA8C512 /* RunnerTests+Interaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Interaction.swift"; sourceTree = "<group>"; };
 		486553A4A4966C42E0BA3314 /* RunnerTests+ScreenRecorder.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+ScreenRecorder.swift"; sourceTree = "<group>"; };
+		4BAEAD240640D6B0466D99C1 /* RunnerAXSnapshotBridge.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = RunnerAXSnapshotBridge.h; sourceTree = "<group>"; };
 		4EA586454B489DC2D5371256 /* SyntheticTyping.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SyntheticTyping.h; sourceTree = "<group>"; };
-		5AA0000000000000000000C0 /* SnapshotParams.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SnapshotParams.h; sourceTree = "<group>"; };
+		55858AF44FEAC9673F1E0576 /* SnapshotParams.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SnapshotParams.m; sourceTree = "<group>"; };
 		58840AA09B61534F808615A5 /* RunnerTests+Alert.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Alert.swift"; sourceTree = "<group>"; };
 		65C8657B8B10860BC0657028 /* DevicelabIOSRunnerUITests.xctest */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = wrapper.cfbundle; path = DevicelabIOSRunnerUITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 		76DCB825707F4A9C7A7E52CD /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = "<group>"; };
 		8219A88A3A382A1DCC1CD098 /* RunnerTests+CommandExecution.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+CommandExecution.swift"; sourceTree = "<group>"; };
+		85D1B6DFA2AF5D1C3F7F27CA /* RunnerDefaults.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = RunnerDefaults.m; sourceTree = "<group>"; };
+		8A0E64F07949C3F6C2CD10A9 /* RunnerTests+Settle.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Settle.swift"; sourceTree = "<group>"; };
 		A3D90D95AF12963DDAB4224A /* DevicelabIOSRunner.app */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = wrapper.application; path = DevicelabIOSRunner.app; sourceTree = BUILT_PRODUCTS_DIR; };
 		A5CA5322A108B2F5446CEFB6 /* Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Bridging-Header.h"; sourceTree = "<group>"; };
 		B637C3282A1017BA1768285E /* RunnerTests+Lifecycle.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Lifecycle.swift"; sourceTree = "<group>"; };
+		B7B99A3A80CD9FE6EEF0DDF6 /* RunnerXCTestTimeouts.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = RunnerXCTestTimeouts.h; sourceTree = "<group>"; };
 		C02DA55AE87DB0515133E2A5 /* XCUIDevice.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = XCUIDevice.h; sourceTree = "<group>"; };
 		C0F2F4CA6FCF47D767563E5B /* RunnerTests+Transport.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Transport.swift"; sourceTree = "<group>"; };
+		C42BBDB1257C3A74D4567CEC /* RunnerAXSnapshotBridge.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = RunnerAXSnapshotBridge.m; sourceTree = "<group>"; };
 		CBA37358B6FEEE7B17DE26C9 /* RunnerTests+Snapshot.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Snapshot.swift"; sourceTree = "<group>"; };
-		5AA0000000000000000000E0 /* RunnerTests+Media.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Media.swift"; sourceTree = "<group>"; };
+		CE81FB088CEC61A625A26C7D /* SnapshotParams.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SnapshotParams.h; sourceTree = "<group>"; };
 		D2D00808BC0A6635CC9AEFD7 /* RunnerTests+SystemModal.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+SystemModal.swift"; sourceTree = "<group>"; };
+		D79A1579F140D75C4D32F507 /* XCUIApplication+ActiveApp.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "XCUIApplication+ActiveApp.h"; sourceTree = "<group>"; };
+		E54CF5C60340EA7867252AE1 /* RunnerTests+Media.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "RunnerTests+Media.swift"; sourceTree = "<group>"; };
 		E85CEE007A7264B73B702B66 /* RunnerObjCExceptionCatcher.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = RunnerObjCExceptionCatcher.h; sourceTree = "<group>"; };
 		EF627B1D914552B1489154FE /* PixelDiff.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PixelDiff.swift; sourceTree = "<group>"; };
 		FF45EB7E8079FDDBBBD08BB1 /* App.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = App.swift; sourceTree = "<group>"; };
@@ -94,25 +108,33 @@
 				20D2D6E64928481F1F3AC354 /* ATTRIBUTION.md */,
 				A5CA5322A108B2F5446CEFB6 /* Bridging-Header.h */,
 				EF627B1D914552B1489154FE /* PixelDiff.swift */,
+				4BAEAD240640D6B0466D99C1 /* RunnerAXSnapshotBridge.h */,
+				C42BBDB1257C3A74D4567CEC /* RunnerAXSnapshotBridge.m */,
+				326F3161DCA93EC852BC41A8 /* RunnerDefaults.h */,
+				85D1B6DFA2AF5D1C3F7F27CA /* RunnerDefaults.m */,
 				E85CEE007A7264B73B702B66 /* RunnerObjCExceptionCatcher.h */,
 				2F3D4FD2D89EB2902E04F5E7 /* RunnerObjCExceptionCatcher.m */,
 				76DCB825707F4A9C7A7E52CD /* RunnerTests.swift */,
 				58840AA09B61534F808615A5 /* RunnerTests+Alert.swift */,
+				155BA71440123190E29851CA /* RunnerTests+AXSnapshotFallback.swift */,
 				8219A88A3A382A1DCC1CD098 /* RunnerTests+CommandExecution.swift */,
 				16BC8ADD3E7C4A137D1A2546 /* RunnerTests+Environment.swift */,
 				468BFB67EE69287E9AA8C512 /* RunnerTests+Interaction.swift */,
 				B637C3282A1017BA1768285E /* RunnerTests+Lifecycle.swift */,
+				E54CF5C60340EA7867252AE1 /* RunnerTests+Media.swift */,
 				20458AB5D7605E7B24151715 /* RunnerTests+Models.swift */,
 				486553A4A4966C42E0BA3314 /* RunnerTests+ScreenRecorder.swift */,
+				8A0E64F07949C3F6C2CD10A9 /* RunnerTests+Settle.swift */,
 				CBA37358B6FEEE7B17DE26C9 /* RunnerTests+Snapshot.swift */,
-				5AA0000000000000000000E0 /* RunnerTests+Media.swift */,
 				D2D00808BC0A6635CC9AEFD7 /* RunnerTests+SystemModal.swift */,
 				C0F2F4CA6FCF47D767563E5B /* RunnerTests+Transport.swift */,
 				052AE177317DC11EE9E6FA7E /* RunnerTests+TvRemote.swift */,
+				B7B99A3A80CD9FE6EEF0DDF6 /* RunnerXCTestTimeouts.h */,
+				2EF9BCC5D11121DD792F8416 /* RunnerXCTestTimeouts.m */,
+				CE81FB088CEC61A625A26C7D /* SnapshotParams.h */,
+				55858AF44FEAC9673F1E0576 /* SnapshotParams.m */,
 				4EA586454B489DC2D5371256 /* SyntheticTyping.h */,
 				2DDAC8B41684AB39CF12AB26 /* SyntheticTyping.m */,
-				5AA0000000000000000000B0 /* SnapshotParams.m */,
-				5AA0000000000000000000C0 /* SnapshotParams.h */,
 			);
 			path = DevicelabIOSRunnerUITests;
 			sourceTree = "<group>";
@@ -139,6 +161,7 @@
 			children = (
 				2DE81DFDC1470520344A831F /* XCPointerEventPath.h */,
 				0023C503084D2BC94E22737C /* XCSynthesizedEventRecord.h */,
+				D79A1579F140D75C4D32F507 /* XCUIApplication+ActiveApp.h */,
 				C02DA55AE87DB0515133E2A5 /* XCUIDevice.h */,
 			);
 			path = XCTest;
@@ -246,22 +269,27 @@
 			buildActionMask = 2147483647;
 			files = (
 				EEB7DF86007CC0A16163735F /* PixelDiff.swift in Sources */,
+				C8F6372DED85BBDB4687E99F /* RunnerAXSnapshotBridge.m in Sources */,
+				DDA1839481EFE1A55737E6FF /* RunnerDefaults.m in Sources */,
 				3A438251A66B70243B49C363 /* RunnerObjCExceptionCatcher.m in Sources */,
+				0E98ADDBC272C50738DC8CD0 /* RunnerTests+AXSnapshotFallback.swift in Sources */,
 				F7A75F36B53A883D3CC01192 /* RunnerTests+Alert.swift in Sources */,
 				CF03E8165BEF555C3066F91A /* RunnerTests+CommandExecution.swift in Sources */,
 				6685298D4A7C6D1E5ADF44F2 /* RunnerTests+Environment.swift in Sources */,
 				6EA61DBF3C1AEF63B4AABAD3 /* RunnerTests+Interaction.swift in Sources */,
 				EA43358836154F8D4F9FE578 /* RunnerTests+Lifecycle.swift in Sources */,
+				935DFF9FD90A1CC730FB01BD /* RunnerTests+Media.swift in Sources */,
 				6C7B733A9DB7FBBC0892582E /* RunnerTests+Models.swift in Sources */,
 				883D9C64B55EABF9DD286026 /* RunnerTests+ScreenRecorder.swift in Sources */,
+				C61B79F30D27A451B927E289 /* RunnerTests+Settle.swift in Sources */,
 				BBE1C2487D218AF14EB8F127 /* RunnerTests+Snapshot.swift in Sources */,
-				5AA0000000000000000000D0 /* RunnerTests+Media.swift in Sources */,
 				753D50338AB047FE4BDA92DE /* RunnerTests+SystemModal.swift in Sources */,
 				1934AC9AF1E68AFB58165881 /* RunnerTests+Transport.swift in Sources */,
 				1EBCEDDEE576BAC031B5F650 /* RunnerTests+TvRemote.swift in Sources */,
 				D2B5963E6A06D33E24818A5B /* RunnerTests.swift in Sources */,
+				7CBD677BC0DA6D2E155FFED7 /* RunnerXCTestTimeouts.m in Sources */,
+				4659D9413345418ED423099D /* SnapshotParams.m in Sources */,
 				185FD4F00E4669AEA940FBE7 /* SyntheticTyping.m in Sources */,
-				5AA0000000000000000000A0 /* SnapshotParams.m in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -348,7 +376,6 @@
 				BUNDLE_LOADER = "$(TEST_HOST)";
 				CODE_SIGN_STYLE = Automatic;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_NSPhotoLibraryAddUsageDescription = "Add test media to the photo library.";
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -370,7 +397,6 @@
 				CODE_SIGN_IDENTITY = "iPhone Developer";
 				CODE_SIGN_STYLE = Automatic;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_NSPhotoLibraryAddUsageDescription = "Add test media to the photo library.";
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
@@ -391,7 +417,6 @@
 				BUNDLE_LOADER = "$(TEST_HOST)";
 				CODE_SIGN_STYLE = Automatic;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_NSPhotoLibraryAddUsageDescription = "Add test media to the photo library.";
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
@@ -413,7 +438,6 @@
 				CODE_SIGN_IDENTITY = "iPhone Developer";
 				CODE_SIGN_STYLE = Automatic;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_NSPhotoLibraryAddUsageDescription = "Add test media to the photo library.";
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/Bridging-Header.h

@@ -1,4 +1,7 @@
 #import "RunnerObjCExceptionCatcher.h"
 #import "SyntheticTyping.h"
 #import "SnapshotParams.h"
+#import "RunnerAXSnapshotBridge.h"
+#import "RunnerXCTestTimeouts.h"
 #import "PrivateHeaders/XCTest/XCUIApplication+ActiveApp.h"
+#import "RunnerDefaults.h"

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/RunnerAXSnapshotBridge.h

@@ -0,0 +1,51 @@
+#ifndef RunnerAXSnapshotBridge_h
+#define RunnerAXSnapshotBridge_h
+
+#import <Foundation/Foundation.h>
+#import <XCTest/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Private-accessibility snapshot fallback for deep React Native trees.
+ *
+ * The public `XCUIElement.snapshot()` serializer throws `kAXErrorIllegalArgument`
+ * (or returns a childless root) once a React Navigation screen's tree crosses a
+ * size-dependent limit, and the runner's traversal then returns an EMPTY tree —
+ * this is the whole devicelab-vs-WDA React Native gap (native-* flows failing
+ * `assertVisible` on content that is really on screen).
+ *
+ * This bridge asks XCTest's private `XCAXClient_iOS` for the tree directly, and
+ * re-roots the request from depth-capped frontier nodes: the AX server's depth
+ * limit is PER REQUEST, so re-rooting at a frontier element's live accessibility
+ * element reaches content the app-rooted request could not, without ever passing
+ * a larger depth. Adapted from callstack/agent-device's `RunnerAXSnapshotBridge`,
+ * trimmed to the capture mechanism (no custom-action reads).
+ *
+ * Simulator-and-device safe: every private call is guarded, and any failure
+ * returns `{ok: NO, error: ...}` so the caller falls back to the empty payload
+ * it would have produced anyway. Never throws.
+ *
+ * Response: `{ok: YES, root: <nested node dict>, truncated: <bool>}` on success,
+ * `{ok: NO, error: <string>}` on failure. A node dict is
+ * `{type: <int elementType>, identifier, label, value, frame: {x,y,width,height},
+ *   enabled, selected, focused, children: [<node dict>...]}`.
+ */
+@interface RunnerAXSnapshotBridge : NSObject
+
+/// Captures @c application's accessibility tree via the private AX client and
+/// chains element-rooted follow-up requests from depth-capped frontier nodes.
+/// @c maxDepth bounds each request; @c maxNodes bounds the whole capture;
+/// @c deepExtensionCallLimit bounds re-root requests (0 disables extension);
+/// @c timeout seconds bounds the whole capture (<= 0 means no wall-clock bound).
++ (NSDictionary<NSString *, id> *)snapshotTreeForApplication:(XCUIApplication *)application
+                                                    maxDepth:(NSInteger)maxDepth
+                                                    maxNodes:(NSInteger)maxNodes
+                                      deepExtensionCallLimit:(NSInteger)deepExtensionCallLimit
+                                                     timeout:(NSTimeInterval)timeout;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* RunnerAXSnapshotBridge_h */