appium-mcp 1.60.2 → 1.62.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.62.0](https://github.com/appium/appium-mcp/compare/v1.61.0...v1.62.0) (2026-04-22)
+
+### Features
+
+* **app-management:** export permissions to server and add name parameter ([#270](https://github.com/appium/appium-mcp/issues/270)) ([a6d8e1e](https://github.com/appium/appium-mcp/commit/a6d8e1e95b3374cb33237168dfb2b5d761563acc))
+
+## [1.61.0](https://github.com/appium/appium-mcp/compare/v1.60.2...v1.61.0) (2026-04-21)
+
+### Features
+
+* consolidate gesture tools ([#278](https://github.com/appium/appium-mcp/issues/278)) ([17faac6](https://github.com/appium/appium-mcp/commit/17faac696cf4d096250fcc182d4d68af73ed1a92))
+
 ## [1.60.2](https://github.com/appium/appium-mcp/compare/v1.60.1...v1.60.2) (2026-04-21)
 
 ### Miscellaneous Chores

package/README.md

@@ -322,12 +322,9 @@ The default regex pattern allows any URL that starts with `http://` or `https://
 | Tool                  | Description                                                                                  |
 | --------------------- | -------------------------------------------------------------------------------------------- |
 | `appium_find_element` | Find a specific element using traditional locator strategies (xpath, id, accessibility id, etc.) **OR** AI-powered natural language descriptions (e.g., "yellow search button at bottom"). Supports both traditional and AI modes. |
-| `appium_tap_by_coordinates` | Tap at specific screen coordinates (x, y). On iOS, coordinates are in points. On Android, coordinates are in device pixels. Use `appium_get_page_source` for accurate coordinates. |
-| `appium_click`        | Click on an element                                                                          |
-| `appium_double_tap`   | Perform double tap on an element                                                             |
-| `appium_long_press`   | Perform a long press (press and hold) gesture on an element                                  |
+| `appium_gesture`      | Perform a touch gesture. `action` = `tap`, `double_tap`, `long_press`, `scroll`, `swipe`, `pinch_zoom`, or `scroll_to_element`. Supports element UUIDs (including AI-found `ai-element:` UUIDs) and raw coordinates. For swipe, use `speed` = `slow` \| `normal` \| `fast` (fast for pull-to-refresh). |
 | `appium_drag_and_drop` | Perform a drag and drop gesture from a source location to a target location (supports element-to-element, element-to-coordinates, coordinates-to-element, and coordinates-to-coordinates) |
-| `appium_pinch`        | Perform a pinch gesture to zoom in (scale > 1) or zoom out (scale < 1) on an element or the whole screen. Works on both iOS and Android. |
+| `appium_perform_actions` | Execute raw W3C Actions API sequences for custom multi-touch gestures (rotate, three-finger swipe, edge swipes, precise timing). Prefer `appium_gesture` for standard gestures. |
 | `appium_set_value`    | Enter text into an input field                                                               |
 | `appium_mobile_hide_keyboard` | Dismiss the on-screen keyboard (`mobile: hideKeyboard`) |
 | `appium_mobile_is_keyboard_shown` | Whether the on-screen keyboard is visible (`mobile: isKeyboardShown`) |
@@ -342,9 +339,6 @@ The default regex pattern allows any URL that starts with `http://` or `https://
 | -------------------------- | ------------------------------------------------------- |
 | `appium_screenshot`        | Take a screenshot and save as PNG. Optionally provide `elementUUID` to capture a specific element. |
 | `appium_get_window_size`   | Get the width and height of the device screen in pixels |
-| `appium_scroll`            | Scroll the screen vertically (up or down)               |
-| `appium_scroll_to_element` | Scroll until a specific element becomes visible         |
-| `appium_swipe`             | Swipe the screen in a direction (left, right, up, down) or between custom coordinates |
 | `appium_get_page_source`   | Get the page source (XML) from the current screen       |
 | `appium_orientation`   | Get or set device/screen orientation with `action` = `get` or `set` (requires `orientation` for set). |
 | `appium_geolocation`       | Get, set, or reset the device GPS coordinates with `action` = `get`, `set`, or `reset`. For `set`, provide `latitude` and `longitude` (and optional `altitude` on Android). Not supported on Android emulators for `reset`. |

package/dist/tools/app-management/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAatD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+K/D"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AActD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA2L/D"}

package/dist/tools/app-management/permissions.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { getPlatformName, PLATFORM } from '../../session-store.js';
 import { execute } from '../../command.js';
+import { resolveAppId } from './resolve-app-id.js';
 import { resolveDriver, textResult, errorResult, toolErrorMessage, } from '../tool-response.js';
 const iosPermissionStateSchema = z.enum(['yes', 'no', 'unset', 'limited']);
 export default function mobilePermissions(server) {
@@ -10,6 +11,16 @@ export default function mobilePermissions(server) {
             .describe('get: list (Android) or read one privacy state (iOS Simulator). ' +
             'update: grant/revoke (Android) or set privacy map (iOS Simulator). ' +
             'reset: restore a privacy prompt for the app under test (iOS only).'),
+        id: z
+            .string()
+            .optional()
+            .describe('App identifier (package name for Android, bundle ID for iOS). Takes precedence over name. ' +
+            'Optional for Android (defaults to the app under test). Required for iOS get and update.'),
+        name: z
+            .string()
+            .optional()
+            .describe('Human-readable app name (e.g. "Spotify"). Used to resolve the app id. ' +
+            'Optional for Android (defaults to the app under test). Required (as alternative to id) for iOS get and update.'),
         sessionId: z
             .string()
             .optional()
@@ -18,14 +29,6 @@ export default function mobilePermissions(server) {
             .enum(['denied', 'granted', 'requested'])
             .optional()
             .describe('Android get only: which bucket to return. Defaults to requested per UiAutomator2.'),
-        appPackage: z
-            .string()
-            .optional()
-            .describe('Android get/update: package to target. Defaults to the app under test.'),
-        bundleId: z
-            .string()
-            .optional()
-            .describe('iOS get/update: bundle id of the app. Required for iOS get and update.'),
         service: z
             .union([z.string(), z.number()])
             .optional()
@@ -50,7 +53,7 @@ export default function mobilePermissions(server) {
     });
     server.addTool({
         name: 'appium_mobile_permissions',
-        description: 'Manage mobile app permissions in one place. action=get: Android lists runtime permissions for a package; iOS Simulator reads one service state for a bundle id (needs bundleId + service). action=update: Android changes permissions (grant/revoke or AppOps); iOS Simulator sets privacy via access map (needs bundleId + access). action=reset: iOS only — resets one privacy service for the AUT (needs service).',
+        description: 'Manage mobile app permissions in one place. action=get: Android lists runtime permissions for a package; iOS Simulator reads one service state for an app (needs id or name + service). action=update: Android changes permissions (grant/revoke or AppOps); iOS Simulator sets privacy via access map (needs id or name + access). action=reset: iOS only — resets one privacy service for the AUT (needs service).',
         parameters: schema,
         annotations: {
             readOnlyHint: false,
@@ -64,44 +67,48 @@ export default function mobilePermissions(server) {
             const { driver } = resolved;
             try {
                 const platform = getPlatformName(driver);
+                const appId = args.id ??
+                    (args.name
+                        ? await resolveAppId(args.name, args.sessionId)
+                        : undefined);
                 if (args.action === 'get') {
                     if (platform === PLATFORM.android) {
                         const params = {};
                         if (args.permissionFilter != null) {
                             params.type = args.permissionFilter;
                         }
-                        if (args.appPackage != null) {
-                            params.appPackage = args.appPackage;
+                        if (appId != null) {
+                            params.appPackage = appId;
                         }
                         const raw = await execute(driver, 'mobile: getPermissions', params);
                         return textResult(JSON.stringify(raw, null, 2));
                     }
                     if (platform === PLATFORM.ios) {
-                        if (!args.bundleId) {
-                            throw new Error('iOS get requires bundleId and service (string).');
+                        if (!appId) {
+                            return errorResult('iOS get requires id or name and service (string).');
                         }
                         if (args.service === undefined ||
                             typeof args.service === 'number') {
-                            throw new Error('iOS get requires service as a string name (e.g. camera, photos).');
+                            return errorResult('iOS get requires service as a string name (e.g. camera, photos).');
                         }
                         const raw = await execute(driver, 'mobile: getPermission', {
-                            bundleId: args.bundleId,
+                            bundleId: appId,
                             service: args.service,
                         });
                         return textResult(String(raw));
                     }
-                    throw new Error(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
+                    return errorResult(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
                 }
                 if (args.action === 'update') {
                     if (platform === PLATFORM.android) {
                         if (args.permissions === undefined) {
-                            throw new Error('Android update requires permissions.');
+                            return errorResult('Android update requires permissions.');
                         }
                         const params = {
                             permissions: args.permissions,
                         };
-                        if (args.appPackage != null) {
-                            params.appPackage = args.appPackage;
+                        if (appId != null) {
+                            params.appPackage = appId;
                         }
                         if (args.permissionChangeAction != null) {
                             params.action = args.permissionChangeAction;
@@ -113,22 +120,23 @@ export default function mobilePermissions(server) {
                         return textResult('Permissions updated successfully.');
                     }
                     if (platform === PLATFORM.ios) {
-                        if (!args.bundleId || !args.access) {
-                            throw new Error('iOS update requires bundleId and access map.');
+                        if (!appId || !args.access) {
+                            return errorResult('iOS update requires id or name and access map.');
                         }
                         await execute(driver, 'mobile: setPermission', {
-                            bundleId: args.bundleId,
+                            bundleId: appId,
                             access: args.access,
                         });
                         return textResult('Permission settings updated successfully.');
                     }
-                    throw new Error(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
+                    return errorResult(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
                 }
+                // action === 'reset'
                 if (platform !== PLATFORM.ios) {
-                    throw new Error('action=reset is only supported on iOS (mobile: resetPermission for the AUT).');
+                    return errorResult('action=reset is only supported on iOS (mobile: resetPermission for the AUT).');
                 }
                 if (args.service === undefined) {
-                    throw new Error('iOS reset requires service (name or numeric id).');
+                    return errorResult('iOS reset requires service (name or numeric id).');
                 }
                 await execute(driver, 'mobile: resetPermission', {
                     service: args.service,
@@ -136,7 +144,7 @@ export default function mobilePermissions(server) {
                 return textResult('Permission reset successfully.');
             }
             catch (err) {
-                return errorResult(`Failed permissions action ${args.action}. err: ${toolErrorMessage(err)}`);
+                return errorResult(`Failed permissions action ${args.action}: ${toolErrorMessage(err)}`);
             }
         },
     });

package/dist/tools/app-management/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/tools/app-management/permissions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/tools/app-management/permissions.ts"],"names":[],"mappings":"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"}

package/dist/tools/gestures/drag-and-drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-and-drop.d.ts","sourceRoot":"","sources":["../../../src/tools/gestures/drag-and-drop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAwGtD,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwGzD"}

package/dist/tools/gestures/drag-and-drop.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { elementUUIDScheme } from '../../schema.js';
+import { getElementRect, getWindowRect, performActions, } from '../../command.js';
+import { errorResult, resolveDriver, textResult, toolErrorMessage, } from '../tool-response.js';
+const DROP_PAUSE_DURATION_MS = 150;
+const dragAndDropSchema = z.object({
+    sourceElementUUID: elementUUIDScheme
+        .optional()
+        .describe('UUID of source element to drag from. Either sourceElementUUID or sourceX+sourceY must be provided.'),
+    sourceX: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Source X coordinate. Required if sourceElementUUID is not provided.'),
+    sourceY: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Source Y coordinate. Required if sourceElementUUID is not provided.'),
+    targetElementUUID: elementUUIDScheme
+        .optional()
+        .describe('UUID of target element to drop on. Either targetElementUUID or targetX+targetY must be provided.'),
+    targetX: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Target X coordinate. Required if targetElementUUID is not provided.'),
+    targetY: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Target Y coordinate. Required if targetElementUUID is not provided.'),
+    duration: z
+        .number()
+        .int()
+        .min(100)
+        .max(5000)
+        .optional()
+        .describe('Duration of the drag movement in milliseconds. Default 1200.'),
+    longPressDuration: z
+        .number()
+        .int()
+        .min(400)
+        .max(2000)
+        .optional()
+        .describe('Duration of the long press before dragging in milliseconds. Default 600.'),
+    sessionId: z
+        .string()
+        .optional()
+        .describe('Session ID to target. If omitted, uses the active session.'),
+});
+async function resolvePoint(driver, uuid, x, y) {
+    if (uuid) {
+        const rect = await getElementRect(driver, uuid);
+        return {
+            x: Math.floor(rect.x + rect.width / 2),
+            y: Math.floor(rect.y + rect.height / 2),
+        };
+    }
+    if (x === undefined || y === undefined) {
+        return { error: 'missing element UUID or coordinates' };
+    }
+    return { x, y };
+}
+export default function dragAndDrop(server) {
+    server.addTool({
+        name: 'appium_drag_and_drop',
+        description: 'Perform a drag-and-drop gesture from a source location to a target location. ' +
+            'The gesture: long press the source (default 600ms), drag to the target (default 1200ms), then release. ' +
+            'Source and target can each be specified as either an element UUID or coordinates. ' +
+            'Useful for reordering lists, moving items, drag-to-delete.',
+        parameters: dragAndDropSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, _context) => {
+            const resolved = resolveDriver(args.sessionId);
+            if (!resolved.ok) {
+                return resolved.result;
+            }
+            const { driver } = resolved;
+            try {
+                const source = await resolvePoint(driver, args.sourceElementUUID, args.sourceX, args.sourceY);
+                if ('error' in source) {
+                    return errorResult('drag_and_drop requires either sourceElementUUID, or both sourceX and sourceY.');
+                }
+                const target = await resolvePoint(driver, args.targetElementUUID, args.targetX, args.targetY);
+                if ('error' in target) {
+                    return errorResult('drag_and_drop requires either targetElementUUID, or both targetX and targetY.');
+                }
+                const { width, height } = await getWindowRect(driver);
+                if (source.x < 0 ||
+                    source.x >= width ||
+                    source.y < 0 ||
+                    source.y >= height) {
+                    return errorResult(`Source coordinates (${source.x}, ${source.y}) are out of screen bounds (${width}x${height}).`);
+                }
+                if (target.x < 0 ||
+                    target.x >= width ||
+                    target.y < 0 ||
+                    target.y >= height) {
+                    return errorResult(`Target coordinates (${target.x}, ${target.y}) are out of screen bounds (${width}x${height}).`);
+                }
+                const duration = args.duration ?? 1200;
+                const longPressDuration = args.longPressDuration ?? 600;
+                await performActions(driver, [
+                    {
+                        type: 'pointer',
+                        id: 'finger1',
+                        parameters: { pointerType: 'touch' },
+                        actions: [
+                            { type: 'pointerMove', duration: 0, x: source.x, y: source.y },
+                            { type: 'pointerDown', button: 0 },
+                            { type: 'pause', duration: longPressDuration },
+                            { type: 'pointerMove', duration, x: target.x, y: target.y },
+                            { type: 'pause', duration: DROP_PAUSE_DURATION_MS },
+                            { type: 'pointerUp', button: 0 },
+                        ],
+                    },
+                ]);
+                const sourceDesc = args.sourceElementUUID
+                    ? `element ${args.sourceElementUUID}`
+                    : `(${source.x}, ${source.y})`;
+                const targetDesc = args.targetElementUUID
+                    ? `element ${args.targetElementUUID}`
+                    : `(${target.x}, ${target.y})`;
+                return textResult(`Successfully dragged from ${sourceDesc} to ${targetDesc}.`);
+            }
+            catch (err) {
+                return errorResult(`Failed to perform drag_and_drop. ${toolErrorMessage(err)}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=drag-and-drop.js.map

package/dist/tools/gestures/drag-and-drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-and-drop.js","sourceRoot":"","sources":["../../../src/tools/gestures/drag-and-drop.ts"],"names":[],"mappings":"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"}

package/dist/tools/gestures/gesture.d.ts

@@ -0,0 +1,3 @@
+import type { FastMCP } from 'fastmcp';
+export default function gesture(server: FastMCP): void;
+//# sourceMappingURL=gesture.d.ts.map

package/dist/tools/gestures/gesture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAQtD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAyCrD"}

package/dist/tools/gestures/gesture.js

@@ -0,0 +1,44 @@
+import { resolveDriver } from '../tool-response.js';
+import { GESTURE_ACTIONS, gestureSchema } from './schema.js';
+import { handleTap, handleDoubleTap, handleLongPress } from './handlers/tap.js';
+import { handleScroll, handleSwipe } from './handlers/swipe-scroll.js';
+import { handlePinchZoom } from './handlers/pinch.js';
+import { handleScrollToElement } from './handlers/scroll-to-element.js';
+export default function gesture(server) {
+    server.addTool({
+        name: 'appium_gesture',
+        description: `Perform a touch gesture. Use 'action' to choose: ${GESTURE_ACTIONS.join(', ')}. ` +
+            `Choose scroll vs swipe by intent: scroll to browse content in a list or feed; ` +
+            `swipe to dismiss, switch screens, navigate carousels, or pull-to-refresh (speed=fast). ` +
+            `For drag-and-drop use appium_drag_and_drop. For custom multi-touch use appium_perform_actions.`,
+        parameters: gestureSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, _context) => {
+            const resolved = resolveDriver(args.sessionId);
+            if (!resolved.ok) {
+                return resolved.result;
+            }
+            const { driver } = resolved;
+            switch (args.action) {
+                case 'tap':
+                    return handleTap(driver, args);
+                case 'double_tap':
+                    return handleDoubleTap(driver, args);
+                case 'long_press':
+                    return handleLongPress(driver, args);
+                case 'scroll':
+                    return handleScroll(driver, args);
+                case 'swipe':
+                    return handleSwipe(driver, args);
+                case 'pinch_zoom':
+                    return handlePinchZoom(driver, args);
+                case 'scroll_to_element':
+                    return handleScrollToElement(driver, args);
+            }
+        },
+    });
+}
+//# sourceMappingURL=gesture.js.map

package/dist/tools/gestures/gesture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../../src/tools/gestures/gesture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,MAAe;IAC7C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,oDAAoD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAClF,gFAAgF;YAChF,yFAAyF;YACzF,gGAAgG;QAClG,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAiB,EACjB,QAA6C,EACrB,EAAE;YAC1B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;YAE5B,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,KAAK;oBACR,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,QAAQ;oBACX,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpC,KAAK,OAAO;oBACV,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnC,KAAK,YAAY;oBACf,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,KAAK,mBAAmB;oBACtB,OAAO,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/gestures/handlers/pinch.d.ts

@@ -0,0 +1,5 @@
+import type { ContentResult } from 'fastmcp';
+import type { DriverInstance } from '../../../session-store.js';
+import type { GestureArgs } from '../schema.js';
+export declare function handlePinchZoom(driver: DriverInstance, args: GestureArgs): Promise<ContentResult>;
+//# sourceMappingURL=pinch.d.ts.map

package/dist/tools/gestures/handlers/pinch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinch.d.ts","sourceRoot":"","sources":["../../../../src/tools/gestures/handlers/pinch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAahE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAmGxB"}

package/dist/tools/gestures/handlers/pinch.js

@@ -0,0 +1,97 @@
+import { getPlatformName, PLATFORM } from '../../../session-store.js';
+import { execute, getElementRect, getWindowRect, performActions, } from '../../../command.js';
+import { errorResult, textResult, toolErrorMessage, } from '../../tool-response.js';
+const DEFAULT_VELOCITY = 2.2;
+export async function handlePinchZoom(driver, args) {
+    if (args.scale === undefined) {
+        return errorResult('pinch_zoom requires a scale value (e.g. 0.5 to zoom out, 2.0 to zoom in).');
+    }
+    const scale = args.scale;
+    const velocity = args.velocity ?? DEFAULT_VELOCITY;
+    try {
+        const platform = getPlatformName(driver);
+        let cx;
+        let cy;
+        let spread;
+        let windowRect = null;
+        if (args.elementUUID) {
+            const rect = await getElementRect(driver, args.elementUUID);
+            cx = Math.floor(rect.x + rect.width / 2);
+            cy = Math.floor(rect.y + rect.height / 2);
+            spread = Math.floor(Math.min(rect.width, rect.height) * 0.3);
+        }
+        else {
+            windowRect = await getWindowRect(driver);
+            cx = Math.floor(windowRect.width / 2);
+            cy = Math.floor(windowRect.height / 2);
+            spread = Math.floor(Math.min(windowRect.width, windowRect.height) * 0.3);
+        }
+        if (scale < 1) {
+            // Zoom out: two fingers move from spread apart to close together. W3C Actions on both platforms.
+            const startSpread = spread;
+            const endSpread = Math.max(1, Math.floor(spread * scale));
+            const duration = Math.floor((1 / Math.abs(velocity)) * 1000);
+            await performActions(driver, [
+                {
+                    type: 'pointer',
+                    id: 'finger1',
+                    parameters: { pointerType: 'touch' },
+                    actions: [
+                        { type: 'pointerMove', duration: 0, x: cx - startSpread, y: cy },
+                        { type: 'pointerDown', button: 0 },
+                        { type: 'pointerMove', duration, x: cx - endSpread, y: cy },
+                        { type: 'pointerUp', button: 0 },
+                    ],
+                },
+                {
+                    type: 'pointer',
+                    id: 'finger2',
+                    parameters: { pointerType: 'touch' },
+                    actions: [
+                        { type: 'pointerMove', duration: 0, x: cx + startSpread, y: cy },
+                        { type: 'pointerDown', button: 0 },
+                        { type: 'pointerMove', duration, x: cx + endSpread, y: cy },
+                        { type: 'pointerUp', button: 0 },
+                    ],
+                },
+            ]);
+        }
+        else if (platform === PLATFORM.ios) {
+            const params = {
+                scale,
+                velocity: Math.abs(velocity),
+            };
+            if (args.elementUUID) {
+                params.elementId = args.elementUUID;
+            }
+            await execute(driver, 'mobile: pinch', params);
+        }
+        else if (platform === PLATFORM.android) {
+            // Convert scale factor to percent (0–1) for pinchOpenGesture.
+            // scale=2 → 0.5, scale=4 → 0.75, scale=10 → 0.9. Capped at 0.99.
+            const percent = Math.min(0.99, 1 - 1 / scale);
+            const params = { percent };
+            if (args.elementUUID) {
+                params.elementId = args.elementUUID;
+            }
+            else {
+                const rect = windowRect;
+                params.left = rect.x ?? 0;
+                params.top = rect.y ?? 0;
+                params.width = rect.width;
+                params.height = rect.height;
+            }
+            await execute(driver, 'mobile: pinchOpenGesture', params);
+        }
+        else {
+            return errorResult(`pinch_zoom is not supported on platform '${platform}'. Supported: iOS, Android.`);
+        }
+        const direction = scale < 1 ? 'out' : 'in';
+        const target = args.elementUUID ? `element ${args.elementUUID}` : 'screen';
+        return textResult(`Successfully pinched ${direction} (scale=${scale}) on ${target}.`);
+    }
+    catch (err) {
+        return errorResult(`Failed to perform pinch_zoom. ${toolErrorMessage(err)}`);
+    }
+}
+//# sourceMappingURL=pinch.js.map

package/dist/tools/gestures/handlers/pinch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinch.js","sourceRoot":"","sources":["../../../../src/tools/gestures/handlers/pinch.ts"],"names":[],"mappings":"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"}

package/dist/tools/gestures/handlers/scroll-to-element.d.ts

@@ -0,0 +1,5 @@
+import type { ContentResult } from 'fastmcp';
+import type { DriverInstance } from '../../../session-store.js';
+import type { GestureArgs } from '../schema.js';
+export declare function handleScrollToElement(driver: DriverInstance, args: GestureArgs): Promise<ContentResult>;
+//# sourceMappingURL=scroll-to-element.d.ts.map

package/dist/tools/gestures/handlers/scroll-to-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-to-element.d.ts","sourceRoot":"","sources":["../../../../src/tools/gestures/handlers/scroll-to-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwDhD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAiCxB"}

package/dist/tools/gestures/handlers/scroll-to-element.js

@@ -0,0 +1,65 @@
+import { getPlatformName, PLATFORM } from '../../../session-store.js';
+import { execute, getWindowRect, performActions } from '../../../command.js';
+import { errorResult, textResult, toolErrorMessage, } from '../../tool-response.js';
+const MAX_SCROLL_ATTEMPTS = 10;
+async function tryFindElement(driver, strategy, selector) {
+    try {
+        await driver.findElement(strategy, selector);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function performW3CScroll(driver, direction) {
+    const { width, height } = await getWindowRect(driver);
+    const startX = Math.floor(width / 2);
+    const startY = direction === 'down' ? Math.floor(height * 0.8) : Math.floor(height * 0.2);
+    const endY = direction === 'down' ? Math.floor(height * 0.2) : Math.floor(height * 0.8);
+    await performActions(driver, [
+        {
+            type: 'pointer',
+            id: 'finger1',
+            parameters: { pointerType: 'touch' },
+            actions: [
+                { type: 'pointerMove', duration: 0, x: startX, y: startY },
+                { type: 'pointerDown', button: 0 },
+                { type: 'pause', duration: 250 },
+                { type: 'pointerMove', duration: 600, x: startX, y: endY },
+                { type: 'pointerUp', button: 0 },
+            ],
+        },
+    ]);
+}
+async function scrollOnce(driver, direction) {
+    const platform = getPlatformName(driver);
+    if (platform === PLATFORM.ios) {
+        await execute(driver, 'mobile: scroll', { direction });
+        return;
+    }
+    await performW3CScroll(driver, direction);
+}
+export async function handleScrollToElement(driver, args) {
+    if (!args.strategy || !args.selector) {
+        return errorResult('scroll_to_element requires both strategy and selector.');
+    }
+    const direction = args.direction === 'up' || args.direction === 'down'
+        ? args.direction
+        : 'down';
+    try {
+        if (await tryFindElement(driver, args.strategy, args.selector)) {
+            return textResult(`Element ${args.selector} is already visible on screen.`);
+        }
+        for (let attempt = 1; attempt <= MAX_SCROLL_ATTEMPTS; attempt++) {
+            await scrollOnce(driver, direction);
+            if (await tryFindElement(driver, args.strategy, args.selector)) {
+                return textResult(`Successfully scrolled to element ${args.selector} after ${attempt} scroll(s).`);
+            }
+        }
+        return errorResult(`Element ${args.selector} not found after ${MAX_SCROLL_ATTEMPTS} scrolls in direction '${direction}'.`);
+    }
+    catch (err) {
+        return errorResult(`Failed to scroll_to_element. ${toolErrorMessage(err)}`);
+    }
+}
+//# sourceMappingURL=scroll-to-element.js.map