appium-mcp 0.0.1 → 1.1.5

package/dist/tools/generate-tests.d.ts

@@ -0,0 +1,2 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function generateTest(server: FastMCP): void;

package/dist/tools/generate-tests.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export default function generateTest(server) {
+    const generateTestSchema = z.object({
+        steps: z.array(z.string()).describe('The steps of the test'),
+    });
+    const instructions = (params) => [
+        `## Instructions`,
+        `- You are an Appium test generator.`,
+        `- You are given a scenario and you need to generate a appium test for it.`,
+        `- Request user to select the platform first using select_platform tool and create a session`,
+        `- Use generate_locators tool to fetch all interactable elements from the current screen and use it to generate the tests`,
+        `- Element can only be clicked only if it is clickable.`,
+        `- Text can entered in the element only if it is focusable`,
+        `- If any interaction on element is failed, retry again with a differnt possible locator in the hierrarchy`,
+        `- Interact with the app using the tools provided and generate the test`,
+        '- DO NOT generate test code based on the scenario alone. DO run steps one by one using the tools provided instead.',
+        '- Only after all steps are completed, emit a Appium test based on message history',
+        '- Save generated test file in the tests directory',
+        `- Use generate://code-with-locators resource as reference for code generation`,
+        `- Always call find_element_tool to retrieve the element UUID before interacting with the element`,
+        `Steps:`,
+        ...params.steps.map((step, index) => `- ${index + 1}. ${step}`),
+    ].join('\n');
+    server.addTool({
+        name: 'appium_generate_tests',
+        description: 'Generate tests for a given mobile app',
+        parameters: generateTestSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: instructions({
+                            steps: args.steps,
+                        }),
+                    },
+                ],
+            };
+        },
+    });
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/tools/generate-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.js","sourceRoot":"","sources":["../../src/tools/generate-tests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,MAAe;IAClD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KAC7D,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,CAAC,MAA2B,EAAE,EAAE,CACnD;QACE,iBAAiB;QACjB,qCAAqC;QACrC,2EAA2E;QAC3E,6FAA6F;QAC7F,0HAA0H;QAC1H,wDAAwD;QACxD,2DAA2D;QAC3D,2GAA2G;QAC3G,wEAAwE;QACxE,oHAAoH;QACpH,mFAAmF;QACnF,mDAAmD;QACnD,+EAA+E;QAC/E,kGAAkG;QAClG,QAAQ;QACR,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;KAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEf,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,uCAAuC;QACpD,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,CAAC;4BACjB,KAAK,EAAE,IAAI,CAAC,KAAK;yBAClB,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tools Registration Module
+ *
+ * This file registers all available MCP tools with the server.
+ *
+ * ADDING A NEW TOOL:
+ * 1. Create your tool file in src/tools/
+ * 2. Import it at the top of this file
+ * 3. Call it in the registerTools function below
+ *
+ * See docs/CONTRIBUTING.md for detailed instructions.
+ * See src/tools/README.md for tool organization.
+ * See src/tools/metadata/README.md for YAML metadata approach.
+ */
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function registerTools(server: FastMCP): void;

package/dist/tools/index.js

@@ -0,0 +1,114 @@
+import log from '../locators/logger.js';
+import answerAppium from './answer-appium.js';
+import createSession from './create-session.js';
+import deleteSession from './delete-session.js';
+import generateLocators from './locators.js';
+import selectPlatform from './select-platform.js';
+import selectDevice from './select-device.js';
+import bootSimulator from './boot-simulator.js';
+import setupWDA from './setup-wda.js';
+import installWDA from './install-wda.js';
+import generateTest from './generate-tests.js';
+import scroll from './scroll.js';
+import scrollToElement from './scroll-to-element.js';
+import findElement from './interactions/find.js';
+import clickElement from './interactions/click.js';
+import doubleTap from './interactions/double-tap.js';
+import setValue from './interactions/set-value.js';
+import getText from './interactions/get-text.js';
+import getPageSource from './interactions/get-page-source.js';
+import screenshot from './interactions/screenshot.js';
+import activateApp from './interactions/activate-app.js';
+import installApp from './interactions/install-app.js';
+import uninstallApp from './interactions/uninstall-app.js';
+import terminateApp from './interactions/terminate-app.js';
+import listApps from './interactions/list-apps.js';
+export default function registerTools(server) {
+    // Wrap addTool to inject logging around tool execution
+    const originalAddTool = server.addTool.bind(server);
+    server.addTool = (toolDef) => {
+        const toolName = toolDef?.name ?? 'unknown_tool';
+        const originalExecute = toolDef?.execute;
+        if (typeof originalExecute !== 'function') {
+            return originalAddTool(toolDef);
+        }
+        const SENSITIVE_KEYS = [
+            'password',
+            'token',
+            'accessToken',
+            'authorization',
+            'apiKey',
+            'apikey',
+            'secret',
+            'clientSecret',
+        ];
+        const redactArgs = (obj) => {
+            try {
+                return JSON.parse(JSON.stringify(obj, (key, value) => {
+                    if (key &&
+                        SENSITIVE_KEYS.some(k => key.toLowerCase().includes(k))) {
+                        return '[REDACTED]';
+                    }
+                    // Avoid logging extremely large buffers/strings
+                    if (value && typeof value === 'string' && value.length > 2000) {
+                        return `[string:${value.length}]`;
+                    }
+                    if (value &&
+                        typeof Buffer !== 'undefined' &&
+                        Buffer.isBuffer(value)) {
+                        return `[buffer:${value.length}]`;
+                    }
+                    return value;
+                }));
+            }
+            catch {
+                return '[Unserializable args]';
+            }
+        };
+        return originalAddTool({
+            ...toolDef,
+            execute: async (args, context) => {
+                const start = Date.now();
+                log.info(`[TOOL START] ${toolName}`, redactArgs(args));
+                try {
+                    const result = await originalExecute(args, context);
+                    const duration = Date.now() - start;
+                    log.info(`[TOOL END] ${toolName} (${duration}ms)`);
+                    return result;
+                }
+                catch (err) {
+                    const duration = Date.now() - start;
+                    const msg = err?.stack || err?.message || String(err);
+                    log.error(`[TOOL ERROR] ${toolName} (${duration}ms): ${msg}`);
+                    throw err;
+                }
+            },
+        });
+    };
+    selectPlatform(server);
+    selectDevice(server);
+    bootSimulator(server);
+    setupWDA(server);
+    installWDA(server);
+    createSession(server);
+    deleteSession(server);
+    generateLocators(server);
+    answerAppium(server);
+    scroll(server);
+    scrollToElement(server);
+    activateApp(server);
+    installApp(server);
+    uninstallApp(server);
+    terminateApp(server);
+    listApps(server);
+    findElement(server);
+    clickElement(server);
+    doubleTap(server);
+    setValue(server);
+    getText(server);
+    getPageSource(server);
+    screenshot(server);
+    generateTest(server);
+    log.info('All tools registered');
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/install-wda.d.ts

@@ -0,0 +1 @@
+export default function installWDA(server: any): void;

package/dist/tools/install-wda.js

@@ -0,0 +1,219 @@
+/**
+ * Tool to install and launch WebDriverAgent (WDA) on a booted iOS simulator
+ */
+import { z } from 'zod';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+import { access, readdir, stat } from 'fs/promises';
+import { constants } from 'fs';
+import os from 'os';
+const execAsync = promisify(exec);
+function cachePath(folder) {
+    return path.join(os.homedir(), '.cache', 'appium-mcp', folder);
+}
+async function getLatestWDAVersion() {
+    // Scan the cache directory to find the latest version
+    const wdaCacheDir = cachePath('wda');
+    try {
+        await access(wdaCacheDir, constants.F_OK);
+    }
+    catch {
+        throw new Error('No WDA cache found. Please run setup_wda first.');
+    }
+    const entries = await readdir(wdaCacheDir);
+    const versions = await Promise.all(entries.map(async (dir) => {
+        const dirPath = path.join(wdaCacheDir, dir);
+        const stats = await stat(dirPath);
+        return stats.isDirectory() ? dir : null;
+    }));
+    const filteredVersions = versions
+        .filter((v) => v !== null)
+        .sort((a, b) => {
+        // Simple version comparison - you might want to use semver for more complex versions
+        return b.localeCompare(a, undefined, { numeric: true });
+    });
+    if (filteredVersions.length === 0) {
+        throw new Error('No WDA versions found in cache. Please run setup_wda first.');
+    }
+    return filteredVersions[0];
+}
+async function getBootedSimulators() {
+    try {
+        const { stdout } = await execAsync('xcrun simctl list devices --json');
+        const data = JSON.parse(stdout);
+        const bootedSimulators = [];
+        for (const [runtime, devices] of Object.entries(data.devices)) {
+            if (Array.isArray(devices)) {
+                for (const device of devices) {
+                    if (device.state === 'Booted') {
+                        bootedSimulators.push(device.udid);
+                    }
+                }
+            }
+        }
+        return bootedSimulators;
+    }
+    catch (error) {
+        throw new Error(`Failed to list simulators: ${error}`);
+    }
+}
+async function installAppOnSimulator(appPath, simulatorUdid) {
+    try {
+        await execAsync(`xcrun simctl install "${simulatorUdid}" "${appPath}"`);
+    }
+    catch (error) {
+        throw new Error(`Failed to install app on simulator ${simulatorUdid}: ${error}`);
+    }
+}
+async function launchAppOnSimulator(bundleId, simulatorUdid) {
+    try {
+        await execAsync(`xcrun simctl launch "${simulatorUdid}" "${bundleId}"`);
+    }
+    catch (error) {
+        throw new Error(`Failed to launch app on simulator ${simulatorUdid}: ${error}`);
+    }
+}
+async function getAppBundleId(appPath) {
+    try {
+        const { stdout } = await execAsync(`/usr/libexec/PlistBuddy -c "Print CFBundleIdentifier" "${path.join(appPath, 'Info.plist')}"`);
+        return stdout.trim();
+    }
+    catch (error) {
+        throw new Error(`Failed to get bundle ID for app at ${appPath}: ${error}`);
+    }
+}
+async function isWDAInstalled(simulatorUdid) {
+    try {
+        const { stdout } = await execAsync(`xcrun simctl listapps "${simulatorUdid}" --json`);
+        const data = JSON.parse(stdout);
+        // Check if any app has a bundle ID that looks like WDA
+        for (const [bundleId, appInfo] of Object.entries(data)) {
+            if (bundleId.includes('WebDriverAgentRunner') ||
+                appInfo?.CFBundleName?.includes('WebDriverAgent')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        // If we can't check, assume it's not installed
+        return false;
+    }
+}
+async function isWDARunning(simulatorUdid) {
+    try {
+        const { stdout } = await execAsync(`xcrun simctl listapps "${simulatorUdid}" --json`);
+        const data = JSON.parse(stdout);
+        // Check if WDA is running
+        for (const [bundleId, appInfo] of Object.entries(data)) {
+            if (bundleId.includes('WebDriverAgentRunner') &&
+                appInfo?.ApplicationType === 'User') {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        return false;
+    }
+}
+export default function installWDA(server) {
+    server.addTool({
+        name: 'install_wda',
+        description: `Install and launch the WebDriverAgent (WDA) app on a booted iOS simulator using the app path from setup_wda.
+      This tool requires WDA to be already set up using setup_wda and at least one simulator to be booted.
+      `,
+        parameters: z.object({
+            simulatorUdid: z
+                .string()
+                .optional()
+                .describe('The UDID of the simulator to install WDA on. If not provided, will use the first booted simulator found.'),
+            appPath: z
+                .string()
+                .optional()
+                .describe(`The path to the WDA app bundle (.app file) that be generated by setup_wda tool.
+          If not provided, will try to find the latest cached WDA app.`),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                const { simulatorUdid, appPath: providedAppPath } = args;
+                // Verify it's a macOS system
+                if (process.platform !== 'darwin') {
+                    throw new Error('WDA installation is only supported on macOS systems');
+                }
+                // Determine WDA app path
+                let appPath;
+                if (providedAppPath) {
+                    appPath = providedAppPath;
+                }
+                else {
+                    // Try to find the latest cached WDA app
+                    const version = await getLatestWDAVersion();
+                    const extractDir = cachePath(`wda/${version}/extracted`);
+                    appPath = path.join(extractDir, 'WebDriverAgentRunner-Runner.app');
+                }
+                // Verify WDA app exists
+                try {
+                    await access(appPath, constants.F_OK);
+                }
+                catch {
+                    throw new Error(`WDA app not found at ${appPath}. Please run setup_wda first to download and cache WDA, or provide a valid appPath.`);
+                }
+                // Get booted simulators
+                const bootedSimulators = await getBootedSimulators();
+                if (bootedSimulators.length === 0) {
+                    throw new Error('No booted simulators found. Please boot a simulator first using boot_simulator tool.');
+                }
+                // Determine target simulator
+                const targetSimulator = simulatorUdid || bootedSimulators[0];
+                if (!bootedSimulators.includes(targetSimulator)) {
+                    throw new Error(`Simulator ${targetSimulator} is not booted. Available booted simulators: ${bootedSimulators.join(', ')}`);
+                }
+                console.log(`Installing WDA from ${appPath} on simulator ${targetSimulator}...`);
+                // Check if WDA is already installed and running
+                const isInstalled = await isWDAInstalled(targetSimulator);
+                const isRunning = await isWDARunning(targetSimulator);
+                if (isRunning) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `✅ WebDriverAgent is already running on simulator ${targetSimulator}!\n\nSimulator: ${targetSimulator}\nApp Path: ${appPath}\nStatus: Running\n\n🚀 WDA is ready to accept connections from Appium.`,
+                            },
+                        ],
+                    };
+                }
+                // Install the app (only if not already installed)
+                if (!isInstalled) {
+                    await installAppOnSimulator(appPath, targetSimulator);
+                    console.log('WDA app installed successfully');
+                }
+                else {
+                    console.log('WDA app already installed, skipping installation');
+                }
+                // Get bundle ID and launch the app
+                const bundleId = await getAppBundleId(appPath);
+                console.log(`Launching WDA with bundle ID: ${bundleId}`);
+                await launchAppOnSimulator(bundleId, targetSimulator);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `✅ WebDriverAgent installed and launched successfully!\n\nSimulator: ${targetSimulator}\nBundle ID: ${bundleId}\nApp Path: ${appPath}\nInstallation: ${isInstalled ? 'Skipped (already installed)' : 'Completed'}\n\n🚀 WDA is now running on the simulator and ready to accept connections from Appium.\n\nNote: The WDA app should be visible on the simulator screen. You can now create an Appium session.`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                console.error('Error installing WDA:', error);
+                throw new Error(`Failed to install WebDriverAgent: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=install-wda.js.map

package/dist/tools/install-wda.js.map

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

package/dist/tools/interactions/activate-app.d.ts

@@ -0,0 +1,2 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function activateApp(server: FastMCP): void;

package/dist/tools/interactions/activate-app.js

@@ -0,0 +1,44 @@
+import { getDriver } from '../session-store.js';
+import { z } from 'zod';
+export default function activateApp(server) {
+    const activateAppSchema = z.object({
+        id: z.string().describe('The app id'),
+    });
+    server.addTool({
+        name: 'appium_activate_app',
+        description: 'Activate app by id',
+        parameters: activateAppSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No driver found');
+            }
+            try {
+                await driver.activateApp(args.id);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `App ${args.id} activated correctly.`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error activating the app ${args.id}: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=activate-app.js.map

package/dist/tools/interactions/activate-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate-app.js","sourceRoot":"","sources":["../../../src/tools/interactions/activate-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAe;IACjD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;QACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACtC,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,oBAAoB;QACjC,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAoB,EAAE,OAAY,EAAgB,EAAE;YAClE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,OAAO,IAAI,CAAC,EAAE,uBAAuB;yBAC5C;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,4BAA4B,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE;yBAC/D;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/interactions/click.d.ts

@@ -0,0 +1,2 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function generateTest(server: FastMCP): void;

package/dist/tools/interactions/click.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { getDriver } from '../session-store.js';
+import { elementUUIDScheme } from '../../schema.js';
+export default function generateTest(server) {
+    const clickActionSchema = z.object({
+        elementUUID: elementUUIDScheme,
+    });
+    server.addTool({
+        name: 'appium_click',
+        description: 'Click on an element',
+        parameters: clickActionSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No driver found');
+            }
+            try {
+                await driver.click(args.elementUUID);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Successfully clicked on element ${args.elementUUID}`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to click on element ${args.elementUUID}. err: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=click.js.map

package/dist/tools/interactions/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../../src/tools/interactions/click.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,MAAe;IAClD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;QACjC,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,qBAAqB;QAClC,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACrC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mCAAmC,IAAI,CAAC,WAAW,EAAE;yBAC5D;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,8BAA8B,IAAI,CAAC,WAAW,UAAU,GAAG,CAAC,QAAQ,EAAE,EAAE;yBAC/E;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/interactions/double-tap.d.ts

@@ -0,0 +1,2 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+export default function doubleTap(server: FastMCP): void;

package/dist/tools/interactions/double-tap.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { getDriver, getPlatformName } from '../session-store.js';
+import { elementUUIDScheme } from '../../schema.js';
+export default function doubleTap(server) {
+    const doubleTapActionSchema = z.object({
+        elementUUID: elementUUIDScheme,
+    });
+    server.addTool({
+        name: 'appium_double_tap',
+        description: 'Perform double tap on an element',
+        parameters: doubleTapActionSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No driver found');
+            }
+            try {
+                const platform = getPlatformName(driver);
+                if (platform === 'Android') {
+                    // Get element location for Android double tap
+                    const element = await driver.findElement('id', args.elementUUID);
+                    const location = await element.getLocation();
+                    const size = await element.getSize();
+                    // Calculate center coordinates
+                    const x = location.x + size.width / 2;
+                    const y = location.y + size.height / 2;
+                    // Perform double tap using performActions
+                    await driver.performActions([
+                        {
+                            type: 'pointer',
+                            id: 'finger1',
+                            parameters: { pointerType: 'touch' },
+                            actions: [
+                                { type: 'pointerMove', duration: 0, x, y },
+                                { type: 'pointerDown', button: 0 },
+                                { type: 'pause', duration: 50 },
+                                { type: 'pointerUp', button: 0 },
+                                { type: 'pause', duration: 100 },
+                                { type: 'pointerDown', button: 0 },
+                                { type: 'pause', duration: 50 },
+                                { type: 'pointerUp', button: 0 },
+                            ],
+                        },
+                    ]);
+                }
+                else if (platform === 'iOS') {
+                    // Use iOS mobile: doubleTap execute method
+                    await driver.execute('mobile: doubleTap', [
+                        { elementId: args.elementUUID },
+                    ]);
+                }
+                else {
+                    throw new Error(`Unsupported platform: ${platform}. Only Android and iOS are supported.`);
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Successfully performed double tap on element ${args.elementUUID}`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to perform double tap on element ${args.elementUUID}. Error: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=double-tap.js.map

package/dist/tools/interactions/double-tap.js.map

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

package/dist/tools/interactions/find.d.ts

@@ -0,0 +1,13 @@
+import { FastMCP } from 'fastmcp/dist/FastMCP.js';
+import { z } from 'zod';
+export declare const findElementSchema: z.ZodObject<{
+    strategy: z.ZodEnum<["xpath", "id", "name", "class name", "accessibility id", "css selector", "-android uiautomator", "-ios predicate string", "-ios class chain"]>;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    strategy: "name" | "id" | "accessibility id" | "class name" | "-ios class chain" | "-ios predicate string" | "-android uiautomator" | "xpath" | "css selector";
+    selector: string;
+}, {
+    strategy: "name" | "id" | "accessibility id" | "class name" | "-ios class chain" | "-ios predicate string" | "-android uiautomator" | "xpath" | "css selector";
+    selector: string;
+}>;
+export default function findElement(server: FastMCP): void;