[vijaysharm]

Depends on mobile-next/devicekit-ios#110, which adds start to the agent's device.io.gesture. Draft until that ships and agentVersionIOS is bumped.

Summary

device.io.gesture could tap only once per gesture, because every finger touched down at t=0. With VoiceOver on (#552) that means nothing can be activated: VoiceOver's double tap, split tap and Magic Tap all need a second touch that starts later.

A pause before a finger's pointerDown now delays that finger's touch-down, the W3C meaning of a pause in a pointer's sequence. It is sent to the agent as the finger's start. A double tap is a second finger that pauses until the first has lifted; skills/mobilecli/reference.md has the example.

Risk surface

• A pause anywhere else behaves as before. A pause after a finger's pointerDown, or after its pointerUp, still extends the previous action, so pinch and drag-and-drop sequences are unchanged.
• Android refuses a delayed finger with "not supported on Android yet". The device server presses every finger at time zero, and would otherwise turn a double tap into a two-finger tap. Supporting it there means reworking Gestures.replay, which I couldn't test without an Android device.
• start is omitted from the agent request when unset, so existing gestures send the same JSON as before.

Test plan

• go test ./... -race (new tests: a pre-down pause becomes start, a post-up pause still extends the release, start stays out of the JSON when unset, Android refuses a delayed finger)
• go fmt ./... leaves no diff; golangci-lint v2.13.1 adds no new findings

Behavior verification (real iPhone 13, iOS 27.0.1, with the mobile-next/devicekit-ios#110 agent)

Sent as device.io.gesture through mobilecli server start.

• VoiceOver off. Double tap on Calculator's 7 → 77
• VoiceOver on. Double tap activates the focused 7; split tap enters 8; Magic Tap starts and stops the stopwatch; triple tap opens a home screen icon's context menu
• device.io.pinch and device.io.swipe still work
• Android: not run (no device); covered by the unit test for the refusal

🤖 Generated with Claude Code

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true