perf: batch repeated iOS swipes in runner

Author: thymikee

ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift

@@ -288,6 +288,29 @@ final class RunnerTests: XCTestCase {
       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 .dragSeries:
+      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: "dragSeries requires x, y, x2, and y2"))
+      }
+      let count = max(Int(command.count ?? 1), 1)
+      let pauseMs = max(command.pauseMs ?? 0, 0)
+      let pattern = command.pattern ?? "one-way"
+      if pattern != "one-way" && pattern != "ping-pong" {
+        return Response(ok: false, error: ErrorPayload(message: "dragSeries pattern must be one-way or ping-pong"))
+      }
+      let holdDuration = min(max((command.durationMs ?? 60) / 1000.0, 0.016), 10.0)
+      for idx in 0..<count {
+        let reverse = pattern == "ping-pong" && (idx % 2 == 1)
+        if reverse {
+          dragAt(app: activeApp, x: x2, y: y2, x2: x, y2: y, holdDuration: holdDuration)
+        } else {
+          dragAt(app: activeApp, x: x, y: y, x2: x2, y2: y2, holdDuration: holdDuration)
+        }
+        if idx < count - 1 && pauseMs > 0 {
+          Thread.sleep(forTimeInterval: pauseMs / 1000.0)
+        }
+      }
+      return Response(ok: true, data: DataPayload(message: "drag series"))
     case .type:
       guard let text = command.text else {
         return Response(ok: false, error: ErrorPayload(message: "type requires text"))
@@ -1022,6 +1045,7 @@ enum CommandType: String, Codable {
   case tapSeries
   case longPress
   case drag
+  case dragSeries
   case type
   case swipe
   case findText
@@ -1053,6 +1077,8 @@ struct Command: Codable {
   let count: Double?
   let intervalMs: Double?
   let tapBatch: Bool?
+  let pauseMs: Double?
+  let pattern: String?
   let x2: Double?
   let y2: Double?
   let durationMs: Double?

src/core/__tests__/dispatch-press.test.ts

@@ -1,6 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
-import { shouldUseIosTapSeries } from '../dispatch.ts';
+import { shouldUseIosDragSeries, shouldUseIosTapSeries } from '../dispatch.ts';
 import type { DeviceInfo } from '../../utils/device.ts';
 
 const iosDevice: DeviceInfo = {
@@ -32,3 +32,12 @@ test('shouldUseIosTapSeries disables fast path for single press or modified gest
 test('shouldUseIosTapSeries disables fast path for non-iOS devices', () => {
   assert.equal(shouldUseIosTapSeries(androidDevice, 5, 0, 0), false);
 });
+
+test('shouldUseIosDragSeries enables fast path for repeated iOS swipes', () => {
+  assert.equal(shouldUseIosDragSeries(iosDevice, 3), true);
+});
+
+test('shouldUseIosDragSeries disables fast path for single swipe and non-iOS', () => {
+  assert.equal(shouldUseIosDragSeries(iosDevice, 1), false);
+  assert.equal(shouldUseIosDragSeries(androidDevice, 3), false);
+});

src/core/dispatch.ts

@@ -180,6 +180,37 @@ export async function dispatchCommand(
         throw new AppError('INVALID_ARGS', `Invalid pattern: ${pattern}`);
       }
 
+      if (shouldUseIosDragSeries(device, count)) {
+        await runIosRunnerCommand(
+          device,
+          {
+            command: 'dragSeries',
+            x: x1,
+            y: y1,
+            x2,
+            y2,
+            durationMs: effectiveDurationMs,
+            count,
+            pauseMs,
+            pattern,
+            appBundleId: context?.appBundleId,
+          },
+          { verbose: context?.verbose, logPath: context?.logPath, traceLogPath: context?.traceLogPath },
+        );
+        return {
+          x1,
+          y1,
+          x2,
+          y2,
+          durationMs,
+          effectiveDurationMs,
+          timingMode: 'runner-series',
+          count,
+          pauseMs,
+          pattern,
+        };
+      }
+
       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, effectiveDurationMs);
@@ -379,6 +410,10 @@ export function shouldUseIosTapSeries(device: DeviceInfo, count: number, holdMs:
   return device.platform === 'ios' && count > 1 && holdMs === 0 && jitterPx === 0;
 }
 
+export function shouldUseIosDragSeries(device: DeviceInfo, count: number): boolean {
+  return device.platform === 'ios' && count > 1;
+}
+
 function computeDeterministicJitter(index: number, jitterPx: number): [number, number] {
   if (jitterPx <= 0) return [0, 0];
   const [dx, dy] = DETERMINISTIC_JITTER_PATTERN[index % DETERMINISTIC_JITTER_PATTERN.length];

src/platforms/ios/runner-client.ts

@@ -18,6 +18,7 @@ export type RunnerCommand = {
     | 'tapSeries'
     | 'longPress'
     | 'drag'
+    | 'dragSeries'
     | 'type'
     | 'swipe'
     | 'findText'
@@ -37,6 +38,8 @@ export type RunnerCommand = {
   count?: number;
   intervalMs?: number;
   tapBatch?: boolean;
+  pauseMs?: number;
+  pattern?: 'one-way' | 'ping-pong';
   x2?: number;
   y2?: number;
   durationMs?: number;