@devicelab/maestro-runner-darwin-arm64 1.1.25 → 1.1.28

package/README.md

@@ -10,11 +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)
 [![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)
@@ -34,11 +37,31 @@
 
 ## Install
 
+**Shell** — macOS and Linux:
+
 ```bash
 curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash
 
-# Install a specific version
-curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash -s -- --version 1.0.9
+# 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
+npx maestro-runner test flows/          # no install step
+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.
+
+Both give you the same binary. macOS and Linux, arm64 and x64; on Windows, use WSL.
+
+## First run
+
+```bash
+maestro-runner doctor     # check the toolchain and hear exactly what is missing
+maestro-runner devices    # what this machine can drive right now
 ```
 
 ## Run Tests
@@ -59,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
@@ -78,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)
@@ -97,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.
@@ -162,5 +187,14 @@ 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/THIRD_PARTY_LICENSES

@@ -1,186 +0,0 @@
-================================================================================
-Package: github.com/google/pprof/profile
-License: Apache-2.0
-Source:  https://github.com/google/pprof/blob/798e818bf904/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/go-sourcemap/sourcemap
-License: BSD-2-Clause
-Source:  https://github.com/go-sourcemap/sourcemap/blob/v2.1.3/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/russross/blackfriday/v2
-License: BSD-2-Clause
-Source:  https://github.com/russross/blackfriday/blob/v2.1.0/LICENSE.txt
-================================================================================
-
-================================================================================
-Package: howett.net/plist
-License: BSD-2-Clause
-Source:  https://github.com/DHowett/go-plist.git/blob/3b63eb3a43b5/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/dop251/goja/ftoa/internal/fast
-License: BSD-3-Clause
-Source:  https://github.com/dop251/goja/blob/2bb4c724c0f9/ftoa/internal/fast/LICENSE_V8
-================================================================================
-
-================================================================================
-Package: github.com/google/uuid
-License: BSD-3-Clause
-Source:  https://github.com/google/uuid/blob/v1.1.2/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/miekg/dns
-License: BSD-3-Clause
-Source:  https://github.com/miekg/dns/blob/v1.1.57/LICENSE
-================================================================================
-
-================================================================================
-Package: golang.org/x/crypto/pbkdf2
-License: BSD-3-Clause
-Source:  https://cs.opensource.google/go/x/crypto/+/v0.24.0:LICENSE
-================================================================================
-
-================================================================================
-Package: golang.org/x/net
-License: BSD-3-Clause
-Source:  https://cs.opensource.google/go/x/net/+/v0.26.0:LICENSE
-================================================================================
-
-================================================================================
-Package: golang.org/x/sys/unix
-License: BSD-3-Clause
-Source:  https://cs.opensource.google/go/x/sys/+/v0.21.0:LICENSE
-================================================================================
-
-================================================================================
-Package: golang.org/x/text
-License: BSD-3-Clause
-Source:  https://cs.opensource.google/go/x/text/+/v0.16.0:LICENSE
-================================================================================
-
-================================================================================
-Package: software.sslmate.com/src/go-pkcs12
-License: BSD-3-Clause
-Source:  https://github.com/SSLMate/go-pkcs12/blob/v0.2.0/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/coder/websocket
-License: ISC
-Source:  https://github.com/coder/websocket/blob/v1.8.15/LICENSE.txt
-================================================================================
-
-================================================================================
-Package: github.com/cenkalti/backoff
-License: MIT
-Source:  https://github.com/cenkalti/backoff/blob/v2.2.1/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/cpuguy83/go-md2man/v2/md2man
-License: MIT
-Source:  https://github.com/cpuguy83/go-md2man/blob/v2.0.7/LICENSE.md
-================================================================================
-
-================================================================================
-Package: github.com/danielpaulus/go-ios/ios
-License: MIT
-Source:  https://github.com/danielpaulus/go-ios/blob/v1.0.131/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/dlclark/regexp2
-License: MIT
-Source:  https://github.com/dlclark/regexp2/blob/v1.11.4/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/dop251/goja
-License: MIT
-Source:  https://github.com/dop251/goja/blob/2bb4c724c0f9/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/go-rod/rod
-License: MIT
-Source:  https://github.com/go-rod/rod/blob/v0.116.2/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/grandcat/zeroconf
-License: MIT
-Source:  https://github.com/grandcat/zeroconf/blob/v1.0.0/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/Masterminds/semver
-License: MIT
-Source:  https://github.com/Masterminds/semver/blob/v1.5.0/LICENSE.txt
-================================================================================
-
-================================================================================
-Package: github.com/sirupsen/logrus
-License: MIT
-Source:  https://github.com/sirupsen/logrus/blob/v1.9.3/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/urfave/cli/v2
-License: MIT
-Source:  https://github.com/urfave/cli/blob/v2.27.7/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/xrash/smetrics
-License: MIT
-Source:  https://github.com/xrash/smetrics/blob/686a1a2994c1/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/ysmood/fetchup
-License: MIT
-Source:  https://github.com/ysmood/fetchup/blob/v0.2.3/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/ysmood/goob
-License: MIT
-Source:  https://github.com/ysmood/goob/blob/v0.4.0/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/ysmood/got/lib/lcs
-License: MIT
-Source:  https://github.com/ysmood/got/blob/v0.40.0/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/ysmood/gson
-License: MIT
-Source:  https://github.com/ysmood/gson/blob/v0.7.3/LICENSE
-================================================================================
-
-================================================================================
-Package: github.com/ysmood/leakless
-License: MIT
-Source:  https://github.com/ysmood/leakless/blob/v0.9.0/LICENSE
-================================================================================
-
-================================================================================
-Package: go.mozilla.org/pkcs7
-License: MIT
-Source:  https://github.com/mozilla-services/pkcs7/blob/33d05740a352/LICENSE
-================================================================================
-
-================================================================================
-Package: gopkg.in/yaml.v3
-License: MIT
-Source:  https://github.com/go-yaml/yaml/blob/v3.0.1/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 */