docs(mobile): say which device runs when no device is named
Merged
KA
3d ago+29+29+01234567890123456789-18-18-01234567890123456789
What and why
- With no
deviceand nothing booted, agent-device's pick ranks an iPhone simulator above an iPad, then the newest OS, then name order. The docs said only "newest OS, then name". - A paired iPhone or iPad is listed as booted, so it joins the pool. Without
device, a run on a Mac with a paired phone drives the phone. - Same wording in the
deviceJSDoc, its reference copy, the mobile guide, the package README and the setup skill.
Issue
None (docs change).
Verified
Ran it locally: yes
- All simulators shut down,
agent-device boot --platform ios --pick newest(the requestbootRequestsends): booted iPhone 16e (iOS 26.3) over the shut-down iPad (A16) on iOS 26.3, whose name sorts first. - Built CLI, scratch project with
mobile({ platform: 'ios' }), no simulator booted, three paired devices: the run drove the paired iPhone (Ran on: device 00008140-…). pnpm checkand@e2e-dev/mobiletests green.
Checklist
- Changeset added (
pnpm changeset) for any change to a published package, or the change is testbed, docs, or CI only. - Breaking change: title carries
!, the changeset body names what breaks and what replaces it, and the deprecation warning landed a window earlier (stability policy in CONTRIBUTING.md). - Docs updated in the same PR: the
docs/**/*.mdxpage for the behavior, andskills/e2e/if the skill describes it. - Contract change: emitted
.d.tsreviewed,tests/types/sdk-types.tsupdated; wire change edits the schema and both fixtures. - Engine contract change (
e2e/engine): changesets fore2e,@e2e-dev/web, and@e2e-dev/mobile.