Normalize iOS swipe timing to safe duration

Author: thymikee

README.md

@@ -125,6 +125,11 @@ Pinch:
 - `pinch` is supported on iOS simulators.
 - On Android, `pinch` currently returns `UNSUPPORTED_OPERATION` in the adb backend.
 
+Swipe timing:
+- `swipe` accepts optional `durationMs` (default `250`, range `16..10000`).
+- Android uses requested swipe duration directly.
+- iOS uses a safe normalized duration to avoid long-press side effects.
+
 ## Skills
 Install the automation skills listed in [SKILL.md](skills/agent-device/SKILL.md).
 

ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift

@@ -255,7 +255,7 @@ final class RunnerTests: XCTestCase {
       guard let x = command.x, let y = command.y, let x2 = command.x2, let y2 = command.y2 else {
         return Response(ok: false, error: ErrorPayload(message: "drag requires x, y, x2, and y2"))
       }
-      let holdDuration = min(max((command.durationMs ?? 250) / 1000.0, 0.016), 10.0)
+      let holdDuration = min(max((command.durationMs ?? 60) / 1000.0, 0.016), 10.0)
       dragAt(app: activeApp, x: x, y: y, x2: x2, y2: y2, holdDuration: holdDuration)
       return Response(ok: true, data: DataPayload(message: "dragged"))
     case .type:

skills/agent-device/SKILL.md

@@ -173,6 +173,7 @@ agent-device apps --platform android --user-installed
 
 - `press` supports gesture series controls: `--count`, `--interval-ms`, `--hold-ms`, `--jitter-px`.
 - `swipe` supports coordinate + timing controls and repeat patterns: `swipe x1 y1 x2 y2 [durationMs] --count --pause-ms --pattern`.
+- `swipe` timing is platform-safe: Android uses requested duration; iOS uses normalized safe timing to avoid long-press side effects.
 - Pinch (`pinch <scale> [x y]`) is currently supported on iOS simulators only.
 - Snapshot refs are the core mechanism for interactive agent flows.
 - Use selectors for deterministic replay artifacts and assertions (e.g. in e2e test workflows).

src/core/dispatch.ts

@@ -158,8 +158,9 @@ export async function dispatchCommand(
         throw new AppError('INVALID_ARGS', 'swipe requires x1 y1 x2 y2 [durationMs]');
       }
 
-      const rawDurationMs = positionals[4] ? Number(positionals[4]) : 250;
-      const durationMs = requireIntInRange(rawDurationMs, 'durationMs', 16, 10_000);
+      const requestedDurationMs = positionals[4] ? Number(positionals[4]) : 250;
+      const durationMs = requireIntInRange(requestedDurationMs, 'durationMs', 16, 10_000);
+      const effectiveDurationMs = device.platform === 'ios' ? 60 : durationMs;
       const count = requireIntInRange(context?.count ?? 1, 'count', 1, 200);
       const pauseMs = requireIntInRange(context?.pauseMs ?? 0, 'pause-ms', 0, 10_000);
       const pattern = context?.pattern ?? 'one-way';
@@ -169,12 +170,23 @@ export async function dispatchCommand(
 
       for (let index = 0; index < count; index += 1) {
         const reverse = pattern === 'ping-pong' && index % 2 === 1;
-        if (reverse) await interactor.swipe(x2, y2, x1, y1, durationMs);
-        else await interactor.swipe(x1, y1, x2, y2, durationMs);
+        if (reverse) await interactor.swipe(x2, y2, x1, y1, effectiveDurationMs);
+        else await interactor.swipe(x1, y1, x2, y2, effectiveDurationMs);
         if (index < count - 1 && pauseMs > 0) await sleep(pauseMs);
       }
 
-      return { x1, y1, x2, y2, durationMs, count, pauseMs, pattern };
+      return {
+        x1,
+        y1,
+        x2,
+        y2,
+        durationMs,
+        effectiveDurationMs,
+        timingMode: device.platform === 'ios' ? 'safe-normalized' : 'direct',
+        count,
+        pauseMs,
+        pattern,
+      };
     }
     case 'long-press': {
       const x = Number(positionals[0]);

website/docs/docs/commands.md

@@ -53,6 +53,7 @@ agent-device pinch 0.5 200 400 # zoom out at coordinates (iOS simulator)
 `fill` clears then types. `type` does not clear.
 On Android, `fill` also verifies text and performs one clear-and-retry pass on mismatch.
 `swipe` accepts an optional `durationMs` argument (default `250ms`, range `16..10000`).
+On iOS, swipe timing uses a safe normalized duration to avoid long-press side effects.
 `pinch` is iOS-simulator-only in the current adb-backed Android implementation.
 
 ## Find (semantic)