test: cover android swipe helper fallback

Author: thymikee

src/platforms/android/__tests__/multitouch-helper.test.ts

@@ -166,7 +166,7 @@ test('runAndroidMultiTouchHelperGesture preserves helper failure messages', asyn
   );
 });
 
-test('swipeAndroid and multi-touch gestures prefer provider-native touch injection', async () => {
+test('swipeGestureAndroid and multi-touch gestures prefer provider-native touch injection', async () => {
   const calls: unknown[] = [];
   await withAndroidAdbProvider(
     {
@@ -226,6 +226,55 @@ test('swipeAndroid and multi-touch gestures prefer provider-native touch injecti
   ]);
 });
 
+test('swipeGestureAndroid falls back to adb input swipe when helper injection fails', async () => {
+  const adbCalls: string[][] = [];
+  const result = await withAndroidAdbProvider(
+    {
+      exec: async (args) => {
+        adbCalls.push(args);
+        if (args.includes('--show-versioncode')) {
+          return {
+            exitCode: 0,
+            stdout: `package:${manifest.packageName} versionCode:999999`,
+            stderr: '',
+          };
+        }
+        if (args.includes('instrument')) {
+          return {
+            exitCode: 1,
+            stdout: [
+              resultRecord({
+                ok: 'false',
+                errorType: 'java.lang.IllegalStateException',
+                message: 'injectInputEvent returned false',
+              }),
+              'INSTRUMENTATION_CODE: 1',
+            ].join('\n'),
+            stderr: '',
+          };
+        }
+        if (args.join(' ') === 'shell input swipe 340 400 60 400 300') {
+          return { exitCode: 0, stdout: '', stderr: '' };
+        }
+        throw new Error(`unexpected adb call: ${args.join(' ')}`);
+      },
+    },
+    { serial: ANDROID_EMULATOR.id },
+    async () =>
+      await swipeGestureAndroid(ANDROID_EMULATOR, {
+        x1: 340,
+        y1: 400,
+        x2: 60,
+        y2: 400,
+        durationMs: 300,
+      }),
+  );
+
+  assert.deepEqual(result, { backend: 'adb-input-swipe-fallback' });
+  assert.ok(adbCalls.some((args) => args.join(' ').includes('am instrument')));
+  assert.ok(adbCalls.some((args) => args.join(' ') === 'shell input swipe 340 400 60 400 300'));
+});
+
 test('rotateGestureAndroid rejects zero velocity before provider dispatch', async () => {
   await withAndroidAdbProvider(
     {

src/platforms/android/multitouch-helper.ts

@@ -473,7 +473,7 @@ async function resolveAndroidMultiTouchHelperArtifact(): Promise<AndroidMultiTou
   } catch (error) {
     throw new AppError(
       'UNSUPPORTED_OPERATION',
-      'gesture pinch/rotate/transform on Android requires the bundled Android multi-touch helper artifact, but it was not found or could not be read',
+      'Android touch gestures require the bundled Android touch helper artifact, but it was not found or could not be read',
       { manifestPath, error: normalizeError(error).message },
       error,
     );

src/utils/cli-help.ts

@@ -108,7 +108,7 @@ Command shape:
   Snapshot refs look like @e12. After snapshot -i, use the exact @eN ref from that output.
   If the exact ref is not known yet, first output snapshot -i, then use a concrete example shape like press @e12 in the next command; do not write @<ref>, @ref, @Label_Name, or @eN placeholders.
   Close means agent-device close. App-owned back means back; system back means back --system.
-  Taps are press or click. Gestures use swipe, longpress, or gesture <pan|fling|swipe|pinch|rotate|transform>. Use gesture swipe left|right for reliable in-page horizontal swipes, and gesture swipe right-edge for left-edge navigation/back gestures. Android pinch, rotate, and transform use provider-native touch injection when available, then the bundled multi-touch helper. iOS simulator transform uses private XCTest synthesis for a continuous two-finger pan/scale/rotation path; otherwise it reports UNSUPPORTED_OPERATION.
+  Taps are press or click. Gestures use swipe, longpress, or gesture <pan|fling|swipe|pinch|rotate|transform>. Use gesture swipe left|right for reliable in-page horizontal swipes, and gesture swipe right-edge for left-edge navigation/back gestures. Android swipe, pinch, rotate, and transform use provider-native touch injection when available, then the bundled touch helper. iOS simulator transform uses private XCTest synthesis for a continuous two-finger pan/scale/rotation path; otherwise it reports UNSUPPORTED_OPERATION.
 
 Bootstrap:
   agent-device devices --platform ios