From 41a17ccd58d4126d55628e669439de8a0f0344b9 Mon Sep 17 00:00:00 2001 From: Karol Kulesza Date: Thu, 12 Nov 2026 19:53:15 +0100 Subject: [PATCH 1/4] docs(mobile): say which device runs when no device is named A paired iPhone or iPad counts as booted and joins the pool; with none booted, agent-device boots an iPhone simulator over an iPad, then the newest OS, then name order. --- .changeset/which-device-boots.md | 5 +++++ docs/mobile.mdx | 5 +++-- docs/reference/mobile.mdx | 10 ++++++---- packages/mobile/README.md | 2 +- packages/mobile/src/options.ts | 10 ++++++---- plugins/e2e/skills/e2e/references/setup.md | 2 +- skills/e2e/references/setup.md | 2 +- 7 files changed, 23 insertions(+), 13 deletions(-) create mode 100644 .changeset/which-device-boots.md diff --git a/.changeset/which-device-boots.md b/.changeset/which-device-boots.md new file mode 100644 index 0000000000..1f21645075 --- /dev/null +++ b/.changeset/which-device-boots.md @@ -0,0 +1,5 @@ +--- +"@e2e-dev/mobile": patch +--- + +The `device` option's documentation now says a connected iPhone or iPad counts as booted, and that on iOS a shut-down iPhone simulator boots before an iPad. diff --git a/docs/mobile.mdx b/docs/mobile.mdx index f01025fae3..cd0bc3cf9b 100644 --- a/docs/mobile.mdx +++ b/docs/mobile.mdx @@ -465,8 +465,9 @@ mobile({ platform: 'ios', device: ['iPhone 17', 'iPhone 17 Pro'] }) ``` Without `device`, the engine uses booted devices, up to the worker limit. -If none are booted, it boots a shut-down one: newest OS first, then name -order. Two workers never drive the same device. +A connected iPhone or iPad counts as booted. If none are booted, it boots +a shut-down one: on iOS an iPhone before an iPad, then the newest OS, then +name order. Two workers never drive the same device. ## Agent tools diff --git a/docs/reference/mobile.mdx b/docs/reference/mobile.mdx index f1928a792a..51064443d4 100644 --- a/docs/reference/mobile.mdx +++ b/docs/reference/mobile.mdx @@ -122,10 +122,12 @@ mobile({ platform: 'android' }); * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots; with none booted, agent-device boots a shut-down - * one: a phone or tablet over a TV, then the newest OS, then name order (a - * stopped Android emulator reports no OS version, so the name decides). With - * every booted one held, `prepare` fails. A `DeviceProvider` leases hosted devices + * many as the run has slots. A connected iPhone or iPad counts as booted and + * joins the pool. With none booted, agent-device boots a shut-down one: on + * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet + * over a TV, then the newest OS, then name order (a stopped Android emulator + * reports no OS version, so the name decides). With every booted one held, + * `prepare` fails. A `DeviceProvider` leases hosted devices * instead: one per worker slot at `prepare`, each driven through the daemon * and client configuration the lease names. A replacement worker resumes a * healthy agent-device session on the same lease. Forced worker shutdown diff --git a/packages/mobile/README.md b/packages/mobile/README.md index baca8918c4..870c6ac827 100644 --- a/packages/mobile/README.md +++ b/packages/mobile/README.md @@ -69,7 +69,7 @@ the other old app options are `INVALID_CONFIG` naming their key under `app`. | Option | Meaning | | --- | --- | | `platform` | `'ios'` or `'android'`. | -| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots. | +| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a connected iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad, then the newest OS, then name order). | | `session` | agent-device session name, before the worker slot: slot `n` drives its device under `-`, `e2e--` by default. One run per session at a time. | | `snapshot` | `'full'` (default, includes static text) or `'interactive'` (actionable nodes only). | | `settle` | Milliseconds the UI must hold still after an agent action before the agent observes again, default `150`; `false` skips the wait. A test's steps do not settle, except `device.back()`; `expect` verifies their outcome. | diff --git a/packages/mobile/src/options.ts b/packages/mobile/src/options.ts index 26442afe4b..f0e8711c21 100644 --- a/packages/mobile/src/options.ts +++ b/packages/mobile/src/options.ts @@ -60,10 +60,12 @@ export interface MobileOptions { * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots; with none booted, agent-device boots a shut-down - * one: a phone or tablet over a TV, then the newest OS, then name order (a - * stopped Android emulator reports no OS version, so the name decides). With - * every booted one held, `prepare` fails. A `DeviceProvider` leases hosted devices + * many as the run has slots. A connected iPhone or iPad counts as booted and + * joins the pool. With none booted, agent-device boots a shut-down one: on + * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet + * over a TV, then the newest OS, then name order (a stopped Android emulator + * reports no OS version, so the name decides). With every booted one held, + * `prepare` fails. A `DeviceProvider` leases hosted devices * instead: one per worker slot at `prepare`, each driven through the daemon * and client configuration the lease names. A replacement worker resumes a * healthy agent-device session on the same lease. Forced worker shutdown diff --git a/plugins/e2e/skills/e2e/references/setup.md b/plugins/e2e/skills/e2e/references/setup.md index 51e935660a..ae95c02719 100644 --- a/plugins/e2e/skills/e2e/references/setup.md +++ b/plugins/e2e/skills/e2e/references/setup.md @@ -368,7 +368,7 @@ export default { - One worker per device. No `device`: every booted simulator or emulator of the platform, and every connected phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots - a shut-down one, newest OS first, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: + a shut-down one, on iOS an iPhone over an iPad, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in `prepare`, before the run's clock. Two sessions on one device fight over it: for parallel MCP sessions or bug-bash explorers, declare one target per diff --git a/skills/e2e/references/setup.md b/skills/e2e/references/setup.md index 51e935660a..ae95c02719 100644 --- a/skills/e2e/references/setup.md +++ b/skills/e2e/references/setup.md @@ -368,7 +368,7 @@ export default { - One worker per device. No `device`: every booted simulator or emulator of the platform, and every connected phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots - a shut-down one, newest OS first, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: + a shut-down one, on iOS an iPhone over an iPad, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in `prepare`, before the run's clock. Two sessions on one device fight over it: for parallel MCP sessions or bug-bash explorers, declare one target per From 3df630fc38eaaed8e9596bb34ae94acfbad219a7 Mon Sep 17 00:00:00 2001 From: Karol Kulesza Date: Thu, 12 Nov 2026 23:32:53 +0100 Subject: [PATCH 2/4] docs(mobile): name paired devices and the Apple TV and Android TV tiers in the cold-pick order --- docs/mobile.mdx | 7 ++++--- docs/reference/mobile.mdx | 2 +- packages/mobile/README.md | 2 +- packages/mobile/src/options.ts | 2 +- packages/mobile/src/pool.ts | 2 +- plugins/e2e/skills/e2e/references/setup.md | 4 ++-- skills/e2e/references/setup.md | 4 ++-- 7 files changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/mobile.mdx b/docs/mobile.mdx index cd0bc3cf9b..69f4c39a3f 100644 --- a/docs/mobile.mdx +++ b/docs/mobile.mdx @@ -465,8 +465,9 @@ mobile({ platform: 'ios', device: ['iPhone 17', 'iPhone 17 Pro'] }) ``` Without `device`, the engine uses booted devices, up to the worker limit. -A connected iPhone or iPad counts as booted. If none are booted, it boots -a shut-down one: on iOS an iPhone before an iPad, then the newest OS, then +A paired iPhone or iPad counts as booted. If none are booted, it boots +a shut-down one: on iOS an iPhone before an iPad before an Apple TV, on Android a phone or +tablet before a TV, then the newest OS, then name order. Two workers never drive the same device. ## Agent tools @@ -528,7 +529,7 @@ mobile({ platform: 'ios', device: 'QA iPhone' }) Use the name, not the id. The engine reads a `device` string as an id only for a simulator UDID or an `emulator-` serial. The first device with a matching name wins, so give each phone a unique name. Without `device`, a -connected phone counts as booted and joins the pool beside booted +paired phone counts as booted and joins the pool beside booted simulators. Set the phone up one time: diff --git a/docs/reference/mobile.mdx b/docs/reference/mobile.mdx index 51064443d4..7c912ca4a4 100644 --- a/docs/reference/mobile.mdx +++ b/docs/reference/mobile.mdx @@ -122,7 +122,7 @@ mobile({ platform: 'android' }); * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots. A connected iPhone or iPad counts as booted and + * many as the run has slots. A paired iPhone or iPad counts as booted and * joins the pool. With none booted, agent-device boots a shut-down one: on * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet * over a TV, then the newest OS, then name order (a stopped Android emulator diff --git a/packages/mobile/README.md b/packages/mobile/README.md index 870c6ac827..6d9d1a7d2a 100644 --- a/packages/mobile/README.md +++ b/packages/mobile/README.md @@ -69,7 +69,7 @@ the other old app options are `INVALID_CONFIG` naming their key under `app`. | Option | Meaning | | --- | --- | | `platform` | `'ios'` or `'android'`. | -| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a connected iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad, then the newest OS, then name order). | +| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a paired iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order). | | `session` | agent-device session name, before the worker slot: slot `n` drives its device under `-`, `e2e--` by default. One run per session at a time. | | `snapshot` | `'full'` (default, includes static text) or `'interactive'` (actionable nodes only). | | `settle` | Milliseconds the UI must hold still after an agent action before the agent observes again, default `150`; `false` skips the wait. A test's steps do not settle, except `device.back()`; `expect` verifies their outcome. | diff --git a/packages/mobile/src/options.ts b/packages/mobile/src/options.ts index f0e8711c21..17cb59ec31 100644 --- a/packages/mobile/src/options.ts +++ b/packages/mobile/src/options.ts @@ -60,7 +60,7 @@ export interface MobileOptions { * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots. A connected iPhone or iPad counts as booted and + * many as the run has slots. A paired iPhone or iPad counts as booted and * joins the pool. With none booted, agent-device boots a shut-down one: on * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet * over a TV, then the newest OS, then name order (a stopped Android emulator diff --git a/packages/mobile/src/pool.ts b/packages/mobile/src/pool.ts index 64b7271282..55c31a936e 100644 --- a/packages/mobile/src/pool.ts +++ b/packages/mobile/src/pool.ts @@ -148,7 +148,7 @@ class BootedDevices implements DeviceSource { ); } if (chosen.length === 0) { - info.log(`no booted ${this.platform} device; agent-device boots a shut-down one (newest OS, then name)`); + info.log(`no booted ${this.platform} device; agent-device boots a shut-down one (iPhone over iPad over Apple TV on iOS, phone or tablet over TV on Android, then newest OS, then name)`); return [{}]; } const skipped = held.length === 0 ? '' : `, skipping ${held.length} held by another agent-device session (${heldBy})`; diff --git a/plugins/e2e/skills/e2e/references/setup.md b/plugins/e2e/skills/e2e/references/setup.md index ae95c02719..0da7b671cd 100644 --- a/plugins/e2e/skills/e2e/references/setup.md +++ b/plugins/e2e/skills/e2e/references/setup.md @@ -366,9 +366,9 @@ export default { `locale` on `browserstack()` or `testmu()`, on a local one set the device's language. - One worker per device. No `device`: every booted simulator or emulator of - the platform, and every connected phone, is the pool, up to `workers`, + the platform, and every paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots - a shut-down one, on iOS an iPhone over an iPad, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: + a shut-down one, on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in `prepare`, before the run's clock. Two sessions on one device fight over it: for parallel MCP sessions or bug-bash explorers, declare one target per diff --git a/skills/e2e/references/setup.md b/skills/e2e/references/setup.md index ae95c02719..0da7b671cd 100644 --- a/skills/e2e/references/setup.md +++ b/skills/e2e/references/setup.md @@ -366,9 +366,9 @@ export default { `locale` on `browserstack()` or `testmu()`, on a local one set the device's language. - One worker per device. No `device`: every booted simulator or emulator of - the platform, and every connected phone, is the pool, up to `workers`, + the platform, and every paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots - a shut-down one, on iOS an iPhone over an iPad, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: + a shut-down one, on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in `prepare`, before the run's clock. Two sessions on one device fight over it: for parallel MCP sessions or bug-bash explorers, declare one target per From 7b34c8fbdb0fc9285a50740d998d4a0434b33a22 Mon Sep 17 00:00:00 2001 From: Karol Kulesza Date: Fri, 13 Nov 2026 18:15:58 +0100 Subject: [PATCH 3/4] docs(mobile): say a reachable paired device counts as booted, fix changeset and wording --- .changeset/which-device-boots.md | 2 +- docs/mobile.mdx | 10 +++++----- docs/reference/mobile.mdx | 2 +- packages/mobile/README.md | 2 +- packages/mobile/src/options.ts | 2 +- plugins/e2e/skills/e2e/references/setup.md | 2 +- skills/e2e/references/setup.md | 2 +- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/.changeset/which-device-boots.md b/.changeset/which-device-boots.md index 1f21645075..b6e1219445 100644 --- a/.changeset/which-device-boots.md +++ b/.changeset/which-device-boots.md @@ -2,4 +2,4 @@ "@e2e-dev/mobile": patch --- -The `device` option's documentation now says a connected iPhone or iPad counts as booted, and that on iOS a shut-down iPhone simulator boots before an iPad. +The `device` option's documentation now says a paired iPhone or iPad that is reachable counts as booted, and that a shut-down device boots in tiers: on iOS an iPhone, then an iPad, then an Apple TV; on Android a phone or tablet, then a TV. diff --git a/docs/mobile.mdx b/docs/mobile.mdx index ce29f82da4..6a4e39c960 100644 --- a/docs/mobile.mdx +++ b/docs/mobile.mdx @@ -465,10 +465,10 @@ mobile({ platform: 'ios', device: ['iPhone 17', 'iPhone 17 Pro'] }) ``` Without `device`, the engine uses booted devices, up to the worker limit. -A paired iPhone or iPad counts as booted. If none are booted, it boots -a shut-down one: on iOS an iPhone before an iPad before an Apple TV, on Android a phone or -tablet before a TV, then the newest OS, then -name order. Two workers never drive the same device. +A paired iPhone or iPad that is reachable (USB or network) counts as booted. +If none are booted, it boots a shut-down one: on iOS an iPhone before an iPad +before an Apple TV, on Android a phone or tablet before a TV, then the newest +OS, then name order. Two workers never drive the same device. ## Agent tools @@ -529,7 +529,7 @@ mobile({ platform: 'ios', device: 'QA iPhone' }) Use the name, not the id. The engine reads a `device` string as an id only for a simulator UDID or an `emulator-` serial. The first device with a matching name wins, so give each phone a unique name. Without `device`, a -paired phone counts as booted and joins the pool beside booted +paired iPhone or connected Android phone counts as booted and joins the pool beside booted simulators. Set the phone up one time: diff --git a/docs/reference/mobile.mdx b/docs/reference/mobile.mdx index fd03c84024..ddfff62792 100644 --- a/docs/reference/mobile.mdx +++ b/docs/reference/mobile.mdx @@ -122,7 +122,7 @@ mobile({ platform: 'android' }); * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots. A paired iPhone or iPad counts as booted and + * many as the run has slots. A paired iPhone or iPad that is reachable (USB or network) counts as booted and * joins the pool. With none booted, agent-device boots a shut-down one: on * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet * over a TV, then the newest OS, then name order (a stopped Android emulator diff --git a/packages/mobile/README.md b/packages/mobile/README.md index 6d9d1a7d2a..66559debdf 100644 --- a/packages/mobile/README.md +++ b/packages/mobile/README.md @@ -69,7 +69,7 @@ the other old app options are `INVALID_CONFIG` naming their key under `app`. | Option | Meaning | | --- | --- | | `platform` | `'ios'` or `'android'`. | -| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a paired iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order). | +| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a reachable paired iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order). | | `session` | agent-device session name, before the worker slot: slot `n` drives its device under `-`, `e2e--` by default. One run per session at a time. | | `snapshot` | `'full'` (default, includes static text) or `'interactive'` (actionable nodes only). | | `settle` | Milliseconds the UI must hold still after an agent action before the agent observes again, default `150`; `false` skips the wait. A test's steps do not settle, except `device.back()`; `expect` verifies their outcome. | diff --git a/packages/mobile/src/options.ts b/packages/mobile/src/options.ts index 17cb59ec31..4b497e8a7a 100644 --- a/packages/mobile/src/options.ts +++ b/packages/mobile/src/options.ts @@ -60,7 +60,7 @@ export interface MobileOptions { * drives the `n`th, so `workers` at or above the pool size runs the target's * files across every device at once. Omitted, the pool is every booted device * of the platform at `prepare` that no other agent-device session holds, as - * many as the run has slots. A paired iPhone or iPad counts as booted and + * many as the run has slots. A paired iPhone or iPad that is reachable (USB or network) counts as booted and * joins the pool. With none booted, agent-device boots a shut-down one: on * iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet * over a TV, then the newest OS, then name order (a stopped Android emulator diff --git a/plugins/e2e/skills/e2e/references/setup.md b/plugins/e2e/skills/e2e/references/setup.md index d31b0b60de..0afc20fb9a 100644 --- a/plugins/e2e/skills/e2e/references/setup.md +++ b/plugins/e2e/skills/e2e/references/setup.md @@ -366,7 +366,7 @@ export default { `locale` on `browserstack()` or `testmu()`, on a local one set the device's language. - One worker per device. No `device`: every booted simulator or emulator of - the platform, and every paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, + the platform, and every reachable paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots a shut-down one, on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in diff --git a/skills/e2e/references/setup.md b/skills/e2e/references/setup.md index d31b0b60de..0afc20fb9a 100644 --- a/skills/e2e/references/setup.md +++ b/skills/e2e/references/setup.md @@ -366,7 +366,7 @@ export default { `locale` on `browserstack()` or `testmu()`, on a local one set the device's language. - One worker per device. No `device`: every booted simulator or emulator of - the platform, and every paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, + the platform, and every reachable paired iPhone or iPad or connected Android phone, is the pool, up to `workers`, minus devices another agent-device session holds (none booted: agent-device boots a shut-down one, on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order; all held: `prepare` fails); one `device`: one worker whatever `workers` says; a list (`device: ['iPhone 17', 'iPhone 17 Pro']`): an explicit pool. Devices boot in From 6d2ec0b58a263a46d410e707bd2ebea8383c367e Mon Sep 17 00:00:00 2001 From: Karol Kulesza Date: Fri, 13 Nov 2026 18:25:43 +0100 Subject: [PATCH 4/4] docs(mobile): name reachable paired iPhones and iPads in the device pool --- docs/mobile.mdx | 4 ++-- packages/mobile/README.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/mobile.mdx b/docs/mobile.mdx index 6a4e39c960..427348338e 100644 --- a/docs/mobile.mdx +++ b/docs/mobile.mdx @@ -529,8 +529,8 @@ mobile({ platform: 'ios', device: 'QA iPhone' }) Use the name, not the id. The engine reads a `device` string as an id only for a simulator UDID or an `emulator-` serial. The first device with a matching name wins, so give each phone a unique name. Without `device`, a -paired iPhone or connected Android phone counts as booted and joins the pool beside booted -simulators. +paired iPhone or iPad that is reachable (USB or network), or a connected +Android phone, counts as booted and joins the pool beside booted simulators. Set the phone up one time: diff --git a/packages/mobile/README.md b/packages/mobile/README.md index 66559debdf..ddc3cb12d5 100644 --- a/packages/mobile/README.md +++ b/packages/mobile/README.md @@ -69,7 +69,7 @@ the other old app options are `INVALID_CONFIG` naming their key under `app`. | Option | Meaning | | --- | --- | | `platform` | `'ios'` or `'android'`. | -| `device` | Simulator or emulator name or UDID, or a connected phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a reachable paired iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order). | +| `device` | Simulator or emulator name or UDID, or a paired iPhone or iPad's name or a connected Android phone's name. A list is a pool: one worker per entry, worker slot `n` driving the `n`th. Omitted, every booted device of the platform is the pool, as many as the run has slots, a reachable paired iPhone or iPad included; with none booted, agent-device boots one (on iOS an iPhone over an iPad over an Apple TV, on Android a phone or tablet over a TV, then the newest OS, then name order). | | `session` | agent-device session name, before the worker slot: slot `n` drives its device under `-`, `e2e--` by default. One run per session at a time. | | `snapshot` | `'full'` (default, includes static text) or `'interactive'` (actionable nodes only). | | `settle` | Milliseconds the UI must hold still after an agent action before the agent observes again, default `150`; `false` skips the wait. A test's steps do not settle, except `device.back()`; `expect` verifies their outcome. |