docs(mobile): say which device runs when no device is named

Merged
KA
3d ago
+29-18

What and why

  • With no device and 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 device JSDoc, 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 request bootRequest sends): 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 check and @e2e-dev/mobile tests 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/**/*.mdx page for the behavior, and skills/e2e/ if the skill describes it.
  • Contract change: emitted .d.ts reviewed, tests/types/sdk-types.ts updated; wire change edits the schema and both fixtures.
  • Engine contract change (e2e/engine): changesets for e2e, @e2e-dev/web, and @e2e-dev/mobile.