appium-mcp 1.55.0 → 1.56.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.56.0](https://github.com/appium/appium-mcp/compare/v1.55.0...v1.56.0) (2026-04-13)
+
+### Features
+
+* **app:** consolidate app commands  ([#255](https://github.com/appium/appium-mcp/issues/255)) ([bad8cdc](https://github.com/appium/appium-mcp/commit/bad8cdc266b1646f8748bd73e5a6102689e03b7b))
+
 ## [1.55.0](https://github.com/appium/appium-mcp/compare/v1.54.0...v1.55.0) (2026-04-13)
 
 ### Features

package/README.md

@@ -274,7 +274,7 @@ The following tools return lightweight text-only responses when NO_UI is enabled
 - `select_device` - Returns device list as text without picker UI
 - `create_session` - Returns session info as text without dashboard UI
 - `appium_context` - Returns context list as text with `action=list` without switcher UI
-- `appium_list_apps` - Returns app list as JSON without interactive UI
+- `appium_app` (action=`list`) - Returns app list as JSON without interactive UI
 
 **When to Enable NO_UI:**
 
@@ -353,18 +353,19 @@ The default regex pattern allows any URL that starts with `http://` or `https://
 
 ### App Management
 
-| Tool                           | Description                                                                     |
-|--------------------------------|---------------------------------------------------------------------------------|
-| `appium_activate_app`          | Activate (launch/bring to foreground) a specified app by bundle ID              |
-| `appium_mobile_background_app` | Background the current app for a duration (optional; defaults to 5 seconds)     |
-| `appium_installApp`            | Install an app on the device from a file path                                   |
-| `appium_uninstallApp`          | Uninstall an app from the device by bundle ID                                   |
-| `appium_terminateApp`          | Terminate (close) a specified app                                               |
-| `appium_list_apps`             | List all installed apps on the device (Android and iOS)                         |
-| `appium_is_app_installed`      | Check whether an app is installed. Package name for Android, bundle ID for iOS. |
-| `appium_query_app_state`       | Query the current state of an app. Package name for Android, bundle ID for iOS. |
-| `appium_mobile_clear_app`      | Clear app data and cache without uninstalling (`mobile: clearApp`). Android: package name; stop the app first when possible. iOS: **Simulator only** (bundle ID); not supported for app data reset on real devices without uninstall. |
-| `appium_mobile_permissions`    | Get, update, or reset app permissions in one tool (`action`: get / update / reset). Android: list or change runtime permissions. iOS Simulator: get/set privacy via bundle id; reset (`action=reset`) applies to the AUT on sim and device. |
+| Tool          | Action           | Description                                                                                                                                                                                |
+|---------------|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `appium_app`  | `activate`       | Activate (launch/bring to foreground) a specified app by bundle ID or name                                                                                                                 |
+| `appium_app`  | `terminate`      | Terminate (close) a specified app                                                                                                                                                          |
+| `appium_app`  | `install`        | Install an app on the device from a file path                                                                                                                                              |
+| `appium_app`  | `uninstall`      | Uninstall an app from the device by bundle ID or name                                                                                                                                      |
+| `appium_app`  | `list`           | List all installed apps on the device (Android and iOS)                                                                                                                                    |
+| `appium_app`  | `is_installed`   | Check whether an app is installed. Package name for Android, bundle ID for iOS.                                                                                                            |
+| `appium_app`  | `query_state`    | Query the current state of an app: 0=not installed, 1=not running, 2=background suspended, 3=background, 4=foreground                                                                      |
+| `appium_app`  | `background`     | Background the current app for a duration (optional; defaults to 5 seconds)                                                                                                                |
+| `appium_app`  | `clear`          | Clear app data and cache without uninstalling (`mobile: clearApp`). Android: stop the app first when possible. iOS: **Simulator only**; not supported on real devices.                     |
+| `appium_app`  | `deep_link`      | Open a deep link URL with the default or a specified app
+| `appium_mobile_permissions`| Get, update, or reset app permissions in one tool (`action`: get / update / reset) |  Android: list or change runtime permissions. iOS Simulator: get/set privacy via bundle id; reset (`action=reset`) applies to the AUT on sim and device. |
 
 ### Test Generation & Documentation
 

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

@@ -1,3 +1,3 @@
-import { FastMCP } from 'fastmcp';
-export default function activateApp(server: FastMCP): void;
+import type { ContentResult } from 'fastmcp';
+export declare function activate(id: string, sessionId?: string): Promise<ContentResult>;
 //# sourceMappingURL=activate-app.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"activate-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/activate-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlC,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkEzD"}
+{"version":3,"file":"activate-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/activate-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAoBxB"}

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

@@ -1,62 +1,25 @@
 import { getDriver } from '../../session-store.js';
-import { z } from 'zod';
 import { activateApp as _activateApp } from '../../command.js';
-import { resolveId } from './resolve-app-id.js';
-export default function activateApp(server) {
-    const activateAppSchema = z
-        .object({
-        id: z
-            .string()
-            .optional()
-            .describe('The app id (package name for Android, bundle ID for iOS). Takes precedence over name. Required if name is not provided.'),
-        name: z
-            .string()
-            .optional()
-            .describe('Human-readable app name (e.g. "Spotify"). Used to resolve the app id when id is not provided. Required if id is not provided.'),
-        sessionId: z
-            .string()
-            .optional()
-            .describe('Session ID to target. If omitted, uses the active session.'),
-    })
-        .refine((args) => args.id || args.name, {
-        message: 'Either id or name must be provided',
-    });
-    server.addTool({
-        name: 'appium_activate_app',
-        description: 'Activate app by id or human-readable name. Either id or name must be provided.',
-        parameters: activateAppSchema,
-        annotations: {
-            readOnlyHint: false,
-            openWorldHint: false,
-        },
-        execute: async (args, _context) => {
-            const driver = getDriver(args.sessionId);
-            if (!driver) {
-                throw new Error('No driver found');
-            }
-            const appId = await resolveId(args.id, args.name, args.sessionId);
-            try {
-                await _activateApp(driver, appId);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `App ${appId} activated correctly.`,
-                        },
-                    ],
-                };
-            }
-            catch (err) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error activating the app ${appId}: ${err.toString()}`,
-                        },
-                    ],
-                };
-            }
-        },
-    });
+export async function activate(id, sessionId) {
+    try {
+        const driver = getDriver(sessionId);
+        if (!driver) {
+            return { content: [{ type: 'text', text: 'No driver found' }] };
+        }
+        await _activateApp(driver, id);
+        return {
+            content: [{ type: 'text', text: `App ${id} activated correctly.` }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error activating the app ${id}: ${err.toString()}`,
+                },
+            ],
+        };
+    }
 }
 //# sourceMappingURL=activate-app.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"activate-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/activate-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,MAAe;IACjD,MAAM,iBAAiB,GAAG,CAAC;SACxB,MAAM,CAAC;QACN,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,yHAAyH,CAC1H;QACH,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,+HAA+H,CAChI;QACH,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;QACtC,OAAO,EAAE,oCAAoC;KAC9C,CAAC,CAAC;IAEL,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,gFAAgF;QAClF,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAAuC,EACvC,QAAa,EACC,EAAE;YAChB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAElE,IAAI,CAAC;gBACH,MAAM,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,OAAO,KAAK,uBAAuB;yBAC1C;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,4BAA4B,KAAK,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE;yBAC7D;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"activate-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/activate-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAU,EACV,SAAkB;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4BAA4B,EAAE,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { FastMCP } from 'fastmcp';
+declare const APP_ACTIONS: readonly ["activate", "terminate", "install", "uninstall", "list", "is_installed", "query_state", "background", "clear", "deep_link"];
+export type AppAction = (typeof APP_ACTIONS)[number];
+export default function app(server: FastMCP): void;
+export {};
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AActD,QAAA,MAAM,WAAW,uIAWP,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAwErD,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAuEjD"}

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

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+import { resolveAppId, resolveId } from './resolve-app-id.js';
+import { activate } from './activate-app.js';
+import { terminate } from './terminate-app.js';
+import { install } from './install-app.js';
+import { uninstall } from './uninstall-app.js';
+import { list } from './list-apps.js';
+import { isInstalled } from './is-app-installed.js';
+import { queryState } from './query-app-state.js';
+import { background, DEFAULT_BACKGROUND_SECONDS } from './background-app.js';
+import { clear } from './clear-app.js';
+import { deepLink } from './deep-link.js';
+const APP_ACTIONS = [
+    'activate',
+    'terminate',
+    'install',
+    'uninstall',
+    'list',
+    'is_installed',
+    'query_state',
+    'background',
+    'clear',
+    'deep_link',
+];
+const schema = z.object({
+    action: z
+        .enum(APP_ACTIONS)
+        .describe('Action to perform. ' +
+        'activate: bring app to foreground (requires id or name). ' +
+        'terminate: stop a running app (requires id or name). ' +
+        'install: install from file path (requires path). ' +
+        'uninstall: remove from device (requires id or name; optional keepData for Android). ' +
+        'list: list installed apps (optional applicationType for iOS). ' +
+        'is_installed: check if app is installed (requires id or name). ' +
+        'query_state: get state 0=not installed,1=not running,2=background suspended,3=background,4=foreground (requires id or name). ' +
+        'background: send foreground app to background (optional seconds, default 5). ' +
+        'clear: clear app data without uninstalling (requires id or name). ' +
+        'deep_link: open a URL with an app (requires url; optional id or name).'),
+    id: z
+        .string()
+        .optional()
+        .describe('App identifier (package name for Android, bundle ID for iOS). Takes precedence over name. Required for: activate, terminate, uninstall, is_installed, query_state, clear.'),
+    name: z
+        .string()
+        .optional()
+        .describe('Human-readable app name (e.g. "Spotify"). Used to resolve the app id. Required (as alternative to id) for: activate, terminate, uninstall, is_installed, query_state, clear.'),
+    path: z
+        .string()
+        .optional()
+        .describe('Path to the app file to install. Required for: install.'),
+    keepData: z
+        .boolean()
+        .optional()
+        .describe('Keep app data and cache after uninstall. Android only. Used with: uninstall.'),
+    applicationType: z
+        .enum(['User', 'System'])
+        .optional()
+        .describe('iOS only: filter by "User" (default) or "System" apps. Used with: list.'),
+    seconds: z
+        .number()
+        .min(-1)
+        .max(86400)
+        .optional()
+        .describe(`Seconds to keep the app in the background. Defaults to ${DEFAULT_BACKGROUND_SECONDS}. Use -1 to stay in background without auto-resuming. Used with: background.`),
+    url: z
+        .string()
+        .optional()
+        .describe('Deep link URL to open (e.g. https://example.com, myapp://path). Required for: deep_link.'),
+    waitForLaunch: z
+        .boolean()
+        .optional()
+        .describe('Android only. If false, ADB does not wait for the activity to return. Defaults to true. Used with: deep_link.'),
+    sessionId: z
+        .string()
+        .optional()
+        .describe('Session ID to target. If omitted, uses the active session.'),
+});
+export default function app(server) {
+    server.addTool({
+        name: 'appium_app',
+        description: `Manage apps on the device. Use the action parameter to choose what to do: ${APP_ACTIONS.join(', ')}.`,
+        parameters: schema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, _context) => {
+            const { action, sessionId } = args;
+            if (action === 'list') {
+                return list(args.applicationType, sessionId);
+            }
+            if (action === 'background') {
+                return background(args.seconds ?? DEFAULT_BACKGROUND_SECONDS, sessionId);
+            }
+            if (action === 'install') {
+                if (!args.path) {
+                    return {
+                        content: [{ type: 'text', text: 'path is required for install' }],
+                    };
+                }
+                return install(args.path, sessionId);
+            }
+            if (action === 'deep_link') {
+                if (!args.url) {
+                    return {
+                        content: [{ type: 'text', text: 'url is required for deep_link' }],
+                    };
+                }
+                const appId = args.id ??
+                    (args.name ? await resolveAppId(args.name, sessionId) : undefined);
+                return deepLink(args.url, appId, args.waitForLaunch, sessionId);
+            }
+            // activate, terminate, uninstall, is_installed, query_state, clear — all require id or name
+            const id = await resolveId(args.id, args.name, sessionId);
+            if (action === 'activate') {
+                return activate(id, sessionId);
+            }
+            if (action === 'terminate') {
+                return terminate(id, sessionId);
+            }
+            if (action === 'uninstall') {
+                return uninstall(id, args.keepData, sessionId);
+            }
+            if (action === 'is_installed') {
+                return isInstalled(id, sessionId);
+            }
+            if (action === 'query_state') {
+                return queryState(id, sessionId);
+            }
+            if (action === 'clear') {
+                return clear(id, sessionId);
+            }
+            return {
+                content: [{ type: 'text', text: `Unknown action: ${action}` }],
+            };
+        },
+    });
+}
+//# sourceMappingURL=app.js.map

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

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

package/dist/tools/app-management/background-app.d.ts

@@ -1,5 +1,4 @@
-import type { FastMCP } from 'fastmcp';
-/** When `seconds` is omitted, MCP clients often send `{}` — a middle ground so the transition is visible without a long wait. */
+import type { ContentResult } from 'fastmcp';
 export declare const DEFAULT_BACKGROUND_SECONDS = 5;
-export default function backgroundApp(server: FastMCP): void;
+export declare function background(seconds: number, sessionId?: string): Promise<ContentResult>;
 //# sourceMappingURL=background-app.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"background-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/background-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAKtD,iIAAiI;AACjI,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAmE3D"}
+{"version":3,"file":"background-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/background-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAiCxB"}

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

@@ -1,66 +1,37 @@
-import { z } from 'zod';
 import { getDriver } from '../../session-store.js';
 import { execute } from '../../command.js';
-/** When `seconds` is omitted, MCP clients often send `{}` — a middle ground so the transition is visible without a long wait. */
 export const DEFAULT_BACKGROUND_SECONDS = 5;
-export default function backgroundApp(server) {
-    const schema = z.object({
-        seconds: z
-            .number()
-            .min(-1)
-            .max(86400)
-            .default(DEFAULT_BACKGROUND_SECONDS)
-            .describe(`Optional. How long to keep the current app in the background before returning it to the foreground (whole seconds). ` +
-            `Defaults to ${DEFAULT_BACKGROUND_SECONDS} if omitted. ` +
-            `Larger values make the transition easier to see. Use -1 to leave the app in the background without auto-resuming (driver-specific).`),
-        sessionId: z
-            .string()
-            .optional()
-            .describe('Session ID to target. If omitted, uses the active session.'),
-    });
-    server.addTool({
-        name: 'appium_mobile_background_app',
-        description: `Send the current foreground app to the background for a duration (default ${DEFAULT_BACKGROUND_SECONDS}s if not specified), then return to the foreground unless using driver-specific stay-in-background behavior. Uses the Appium mobile: backgroundApp execute method (UiAutomator2 and XCUITest).`,
-        parameters: schema,
-        annotations: {
-            readOnlyHint: false,
-            openWorldHint: false,
-        },
-        execute: async (args, _context) => {
-            const { seconds } = args;
-            const driver = getDriver(args.sessionId);
-            if (!driver) {
-                throw new Error('No driver found');
-            }
-            try {
-                await execute(driver, 'mobile: backgroundApp', { seconds });
-                const resumeHint = seconds < 0
-                    ? 'The app should stay in the background until you bring it back (e.g. appium_activate_app).'
-                    : 'The app is sent to the background, then brought back automatically after the wait.';
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Background completed (${seconds}s). ${resumeHint}\n\n` +
-                                `Tips if you saw little or no change: (1) Short positive durations (e.g. 2s) are easy to miss—try 8–15 seconds to see the home/recents screen clearly. ` +
-                                `(2) The foreground app must be the one you expect—use appium_activate_app with the package/bundle id first if needed. ` +
-                                `(3) Some OEMs minimize animation; use appium_screenshot before and after to verify.`,
-                        },
-                    ],
-                };
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Failed to background app. Error: ${message}`,
-                        },
-                    ],
-                };
-            }
-        },
-    });
+export async function background(seconds, sessionId) {
+    try {
+        const driver = getDriver(sessionId);
+        if (!driver) {
+            return { content: [{ type: 'text', text: 'No driver found' }] };
+        }
+        await execute(driver, 'mobile: backgroundApp', { seconds });
+        const resumeHint = seconds < 0
+            ? 'The app should stay in the background until you bring it back (e.g. action=activate).'
+            : 'The app is sent to the background, then brought back automatically after the wait.';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Background completed (${seconds}s). ${resumeHint}\n\n` +
+                        `Tips if you saw little or no change: (1) Short positive durations (e.g. 2s) are easy to miss—try 8–15 seconds to see the home/recents screen clearly. ` +
+                        `(2) The foreground app must be the one you expect—use action=activate with the package/bundle id first if needed. ` +
+                        `(3) Some OEMs minimize animation; use appium_screenshot before and after to verify.`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to background app. Error: ${err.toString()}`,
+                },
+            ],
+        };
+    }
 }
 //# sourceMappingURL=background-app.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"background-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/background-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,iIAAiI;AACjI,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAe;IACnD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC,CAAC;aACP,GAAG,CAAC,KAAK,CAAC;aACV,OAAO,CAAC,0BAA0B,CAAC;aACnC,QAAQ,CACP,sHAAsH;YACpH,eAAe,0BAA0B,eAAe;YACxD,qIAAqI,CACxI;QACH,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,6EAA6E,0BAA0B,gMAAgM;QACpT,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EACZ,IAA4B,EAC5B,QAA6C,EACrB,EAAE;YAC1B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;YACzB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5D,MAAM,UAAU,GACd,OAAO,GAAG,CAAC;oBACT,CAAC,CAAC,2FAA2F;oBAC7F,CAAC,CAAC,oFAAoF,CAAC;gBAC3F,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EACF,yBAAyB,OAAO,OAAO,UAAU,MAAM;gCACvD,wJAAwJ;gCACxJ,wHAAwH;gCACxH,qFAAqF;yBACxF;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,oCAAoC,OAAO,EAAE;yBACpD;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"background-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/background-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,SAAkB;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,MAAM,UAAU,GACd,OAAO,GAAG,CAAC;YACT,CAAC,CAAC,uFAAuF;YACzF,CAAC,CAAC,oFAAoF,CAAC;QAC3F,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,yBAAyB,OAAO,OAAO,UAAU,MAAM;wBACvD,wJAAwJ;wBACxJ,oHAAoH;wBACpH,qFAAqF;iBACxF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oCAAoC,GAAG,CAAC,QAAQ,EAAE,EAAE;iBAC3D;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/app-management/clear-app.d.ts

@@ -1,3 +1,3 @@
-import { FastMCP } from 'fastmcp';
-export default function clearApp(server: FastMCP): void;
+import type { ContentResult } from 'fastmcp';
+export declare function clear(id: string, sessionId?: string): Promise<ContentResult>;
 //# sourceMappingURL=clear-app.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clear-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/clear-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlC,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA8DtD"}
+{"version":3,"file":"clear-app.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/clear-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAsB,KAAK,CACzB,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAuBxB"}

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

@@ -1,62 +1,27 @@
-import { z } from 'zod';
 import { getDriver, getPlatformName, PLATFORM } from '../../session-store.js';
 import { execute } from '../../command.js';
-import { resolveId } from './resolve-app-id.js';
-export default function clearApp(server) {
-    const schema = z
-        .object({
-        id: z
-            .string()
-            .optional()
-            .describe('App identifier (package name for Android, bundle ID for iOS). Takes precedence over name. Required if name is not provided.'),
-        name: z
-            .string()
-            .optional()
-            .describe('Human-readable app name (e.g. "Spotify"). Used to resolve the app id when id is not provided. Required if id is not provided.'),
-        sessionId: z
-            .string()
-            .optional()
-            .describe('Session ID to target. If omitted, uses the active session.'),
-    })
-        .refine((args) => args.id || args.name, {
-        message: 'Either id or name must be provided',
-    });
-    server.addTool({
-        name: 'appium_mobile_clear_app',
-        description: 'Clear all user data and cache for an installed app without uninstalling it (Appium `mobile: clearApp`). Either id or name must be provided. ' +
-            'Android: uses `pm clear` (package name); stop the app first for reliable results on devices and emulators. ' +
-            'iOS: Simulator only (bundle ID); `mobile: clearApp` is not supported on real devices.',
-        parameters: schema,
-        execute: async (args) => {
-            const driver = getDriver(args.sessionId);
-            if (!driver) {
-                throw new Error('No driver found');
-            }
-            const id = await resolveId(args.id, args.name, args.sessionId);
-            try {
-                const platform = getPlatformName(driver);
-                const params = platform === PLATFORM.android ? { appId: id } : { bundleId: id };
-                await execute(driver, 'mobile: clearApp', params);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: 'App data cleared successfully',
-                        },
-                    ],
-                };
-            }
-            catch (err) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Failed to clear app data. err: ${err.toString()}`,
-                        },
-                    ],
-                };
-            }
-        },
-    });
+export async function clear(id, sessionId) {
+    try {
+        const driver = getDriver(sessionId);
+        if (!driver) {
+            return { content: [{ type: 'text', text: 'No driver found' }] };
+        }
+        const platform = getPlatformName(driver);
+        const params = platform === PLATFORM.android ? { appId: id } : { bundleId: id };
+        await execute(driver, 'mobile: clearApp', params);
+        return {
+            content: [{ type: 'text', text: 'App data cleared successfully' }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to clear app data. err: ${err.toString()}`,
+                },
+            ],
+        };
+    }
 }
 //# sourceMappingURL=clear-app.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"clear-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/clear-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAe;IAC9C,MAAM,MAAM,GAAG,CAAC;SACb,MAAM,CAAC;QACN,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6HAA6H,CAC9H;QACH,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,+HAA+H,CAChI;QACH,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;QACtC,OAAO,EAAE,oCAAoC;KAC9C,CAAC,CAAC;IAEL,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,8IAA8I;YAC9I,6GAA6G;YAC7G,uFAAuF;QACzF,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,KAAK,EAAE,IAA4B,EAAE,EAAE;YAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBACzC,MAAM,MAAM,GACV,QAAQ,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;gBACnE,MAAM,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;gBAClD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,+BAA+B;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,kCAAkC,GAAG,CAAC,QAAQ,EAAE,EAAE;yBACzD;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"clear-app.js","sourceRoot":"","sources":["../../../src/tools/app-management/clear-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAU,EACV,SAAkB;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GACV,QAAQ,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACnE,MAAM,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,GAAG,CAAC,QAAQ,EAAE,EAAE;iBACzD;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/app-management/deep-link.d.ts

@@ -1,3 +1,3 @@
-import { FastMCP } from 'fastmcp';
-export default function deepLink(server: FastMCP): void;
+import type { ContentResult } from 'fastmcp';
+export declare function deepLink(url: string, appId?: string, waitForLaunch?: boolean, sessionId?: string): Promise<ContentResult>;
 //# sourceMappingURL=deep-link.d.ts.map

package/dist/tools/app-management/deep-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-link.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/deep-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAelC,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwGtD"}
+{"version":3,"file":"deep-link.d.ts","sourceRoot":"","sources":["../../../src/tools/app-management/deep-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa7C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,OAAO,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CA2DxB"}