feat(testmu): add @e2e-dev/testmu device provider

[amankansal-lt]

What and why

• Adds @e2e-dev/testmu, a DeviceProvider that runs mobile targets on TestMu AI (formerly LambdaTest) Android emulators, iOS simulators and real devices, through agent-device's testmu cloud provider (feat(provider-webdriver): add TestMu AI device cloud provider callstack/agent-device#3117).

  import { mobile } from '@e2e-dev/mobile';
  import { testmu } from '@e2e-dev/testmu';
  
  engine: mobile({
    platform: 'android',
    device: testmu({ device: 'Galaxy S22 Ultra 5G', osVersion: '14', app: 'lt://APP-id' }),
  }),

• Leases: each worker slot allocates an agent-device lease. The worker's first command starts the session and installs the app; release ends it. Release is idempotent and also runs when a lease arrives after an interrupt.

• Credentials: LT_USERNAME and LT_ACCESS_KEY come from the run's environment. If one is missing, the lease fails before anything starts.

• Options: deviceType: 'real' selects real devices. project, build, sessionName and stateDir are optional. Unknown options fail at config load.

• Lease keep-alive: agent-device leases expire after 60 s idle, and an iOS simulator's first command (upload, allocation, boot) takes about 70 s. The provider allocates with the daemon's maximum window (10 min) and heartbeats every 2 minutes until release.

• fix(mobile): XCUIElementType-prefixed iOS element types. agent-device's WebDriver runtime, used by every hosted Appium cloud including BrowserStack and AWS Device Farm, reports XCUIElementTypeButton where the native runner reports Button. Before this, getByRole('button', …) matched nothing on those iOS devices. Patch changeset for @e2e-dev/mobile.

• Requirement: an agent-device release with the testmu provider (feat(provider-webdriver): add TestMu AI device cloud provider callstack/agent-device#3117). agent-device is a peer (>0.21.18 <1) so the provider and the engine share one copy. Until @e2e-dev/mobile pins such a release, the docs page shows a package-manager override, with the version left as a placeholder to fill on release.

Verified

Ran it locally: yes

• @e2e-dev/testmu unit tests: 28 passed; @e2e-dev/mobile unit tests: 237 passed
• pnpm lint, pnpm -r run typecheck, pnpm docs:check, check-dist, check:peer-ranges: pass
• Live against TestMu AI production with the packed packages from this branch. Each test opens the app and checks it with getByRole / getByText; every device was released afterwards.

Target	Device	App	Engine ready	Test
Android emulator	Galaxy S22 Ultra 5G, 14	.apk by URL	54 s	passed
iOS simulator	iPhone 16, 18.0	local zipped .app	71 s	passed
Android real device	Pixel 6, 14	.apk by URL	27 s	passed
iOS real device	iPhone 16, 18	signed .ipa	29 s	passed

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). n/a, not breaking.
• 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. n/a
• Engine contract change (e2e/engine): changesets for e2e, @e2e-dev/web, and @e2e-dev/mobile. n/a

🤖 Generated with Claude Code

[amankansal-lt]

Superseded by #772, opened from the LambdaTest fork with the same commits.