@midscene/ios 1.5.3 → 1.5.4-beta-20260310030546.0

package/dist/es/bin.mjs

@@ -741,6 +741,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1139,6 +1150,7 @@ const runWdaRequestParamSchema = z.object({
     data: z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: defineAction({
             name: 'RunWdaRequest',
@@ -1156,6 +1168,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: defineAction({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1188,11 +1209,12 @@ class IOSAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }

package/dist/es/cli.mjs

@@ -739,6 +739,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1137,6 +1148,7 @@ const runWdaRequestParamSchema = z.object({
     data: z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: defineAction({
             name: 'RunWdaRequest',
@@ -1154,6 +1166,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: defineAction({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1186,11 +1207,12 @@ class IOSAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }

package/dist/es/index.mjs

@@ -8,6 +8,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midscene/shared/utils";
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
 import { Agent } from "@midscene/core/agent";
+import { BaseMidsceneTools } from "@midscene/shared/mcp";
 import { overrideAIConfig } from "@midscene/shared/env";
 import { exec } from "node:child_process";
 import { platform } from "node:os";
@@ -557,6 +558,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -955,6 +967,7 @@ const runWdaRequestParamSchema = z.object({
     data: z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: defineAction({
             name: 'RunWdaRequest',
@@ -972,6 +985,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: defineAction({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1188,11 +1210,12 @@ class IOSAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
@@ -1203,6 +1226,49 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
+const debug = getDebug('mcp:ios-tools');
+class IOSMidsceneTools extends BaseMidsceneTools {
+    createTemporaryDevice() {
+        return new IOSDevice({});
+    }
+    async ensureAgent() {
+        if (this.agent) return this.agent;
+        debug('Creating iOS agent with WebDriverAgent');
+        this.agent = await agentFromWebDriverAgent({
+            autoDismissKeyboard: false
+        });
+        return this.agent;
+    }
+    preparePlatformTools() {
+        return [
+            {
+                name: 'ios_connect',
+                description: 'Connect to iOS device or simulator via WebDriverAgent',
+                schema: {},
+                handler: async ()=>{
+                    const agent = await this.ensureAgent();
+                    const screenshot = await agent.page.screenshotBase64();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Connected to iOS device'
+                            },
+                            ...this.buildScreenshotContent(screenshot)
+                        ],
+                        isError: false
+                    };
+                }
+            },
+            {
+                name: 'ios_disconnect',
+                description: 'Disconnect from current iOS device and release WebDriverAgent resources',
+                schema: {},
+                handler: this.createDisconnectHandler('iOS device')
+            }
+        ];
+    }
+}
 const execAsync = promisify(exec);
 const debugUtils = getDebug('ios:utils');
 function checkMacOSPlatform() {
@@ -1249,4 +1315,4 @@ async function checkIOSEnvironment() {
         };
     }
 }
-export { IOSAgent, IOSDevice, IOSWebDriverClient, agentFromWebDriverAgent, checkIOSEnvironment, overrideAIConfig };
+export { IOSAgent, IOSDevice, IOSMidsceneTools, IOSWebDriverClient, agentFromWebDriverAgent, checkIOSEnvironment, overrideAIConfig };

package/dist/es/mcp-server.mjs

@@ -738,6 +738,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1136,6 +1147,7 @@ const runWdaRequestParamSchema = z.object({
     data: z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: defineAction({
             name: 'RunWdaRequest',
@@ -1153,6 +1165,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: defineAction({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1185,11 +1206,12 @@ class IOSAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
@@ -1250,7 +1272,7 @@ class IOSMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.5.3",
+            version: "1.5.4-beta-20260310030546.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -766,6 +766,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1164,6 +1175,7 @@ const runWdaRequestParamSchema = core_namespaceObject.z.object({
     data: core_namespaceObject.z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = core_namespaceObject.z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = core_namespaceObject.z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: (0, device_namespaceObject.defineAction)({
             name: 'RunWdaRequest',
@@ -1181,6 +1193,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: (0, device_namespaceObject.defineAction)({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1213,11 +1234,12 @@ class IOSAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }

package/dist/lib/cli.js

@@ -763,6 +763,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1161,6 +1172,7 @@ const runWdaRequestParamSchema = core_namespaceObject.z.object({
     data: core_namespaceObject.z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = core_namespaceObject.z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = core_namespaceObject.z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: (0, device_namespaceObject.defineAction)({
             name: 'RunWdaRequest',
@@ -1178,6 +1190,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: (0, device_namespaceObject.defineAction)({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1210,11 +1231,12 @@ class IOSAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }

package/dist/lib/index.js

@@ -33,9 +33,10 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    overrideAIConfig: ()=>env_namespaceObject.overrideAIConfig,
+    IOSMidsceneTools: ()=>IOSMidsceneTools,
     IOSAgent: ()=>IOSAgent,
     checkIOSEnvironment: ()=>checkIOSEnvironment,
+    overrideAIConfig: ()=>env_namespaceObject.overrideAIConfig,
     IOSDevice: ()=>IOSDevice,
     IOSWebDriverClient: ()=>IOSWebDriverClient,
     agentFromWebDriverAgent: ()=>agentFromWebDriverAgent
@@ -595,6 +596,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -993,6 +1005,7 @@ const runWdaRequestParamSchema = core_namespaceObject.z.object({
     data: core_namespaceObject.z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = core_namespaceObject.z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = core_namespaceObject.z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: (0, device_namespaceObject.defineAction)({
             name: 'RunWdaRequest',
@@ -1010,6 +1023,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: (0, device_namespaceObject.defineAction)({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1227,11 +1249,12 @@ class IOSAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = (0, shared_utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
@@ -1242,6 +1265,50 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
+const mcp_namespaceObject = require("@midscene/shared/mcp");
+const debug = (0, logger_namespaceObject.getDebug)('mcp:ios-tools');
+class IOSMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+    createTemporaryDevice() {
+        return new IOSDevice({});
+    }
+    async ensureAgent() {
+        if (this.agent) return this.agent;
+        debug('Creating iOS agent with WebDriverAgent');
+        this.agent = await agentFromWebDriverAgent({
+            autoDismissKeyboard: false
+        });
+        return this.agent;
+    }
+    preparePlatformTools() {
+        return [
+            {
+                name: 'ios_connect',
+                description: 'Connect to iOS device or simulator via WebDriverAgent',
+                schema: {},
+                handler: async ()=>{
+                    const agent = await this.ensureAgent();
+                    const screenshot = await agent.page.screenshotBase64();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Connected to iOS device'
+                            },
+                            ...this.buildScreenshotContent(screenshot)
+                        ],
+                        isError: false
+                    };
+                }
+            },
+            {
+                name: 'ios_disconnect',
+                description: 'Disconnect from current iOS device and release WebDriverAgent resources',
+                schema: {},
+                handler: this.createDisconnectHandler('iOS device')
+            }
+        ];
+    }
+}
 const env_namespaceObject = require("@midscene/shared/env");
 const external_node_child_process_namespaceObject = require("node:child_process");
 const external_node_os_namespaceObject = require("node:os");
@@ -1294,6 +1361,7 @@ async function checkIOSEnvironment() {
 }
 exports.IOSAgent = __webpack_exports__.IOSAgent;
 exports.IOSDevice = __webpack_exports__.IOSDevice;
+exports.IOSMidsceneTools = __webpack_exports__.IOSMidsceneTools;
 exports.IOSWebDriverClient = __webpack_exports__.IOSWebDriverClient;
 exports.agentFromWebDriverAgent = __webpack_exports__.agentFromWebDriverAgent;
 exports.checkIOSEnvironment = __webpack_exports__.checkIOSEnvironment;
@@ -1301,6 +1369,7 @@ exports.overrideAIConfig = __webpack_exports__.overrideAIConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "IOSAgent",
     "IOSDevice",
+    "IOSMidsceneTools",
     "IOSWebDriverClient",
     "agentFromWebDriverAgent",
     "checkIOSEnvironment",

package/dist/lib/mcp-server.js

@@ -778,6 +778,17 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         }
         return this;
     }
+    async terminate(bundleId) {
+        const resolved = this.resolveBundleId(bundleId) ?? bundleId;
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await this.wdaBackend.terminateApp(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`);
+        }
+    }
     async getElementsInfo() {
         return [];
     }
@@ -1176,6 +1187,7 @@ const runWdaRequestParamSchema = core_namespaceObject.z.object({
     data: core_namespaceObject.z.object({}).passthrough().optional().describe('Optional request body data as JSON object')
 });
 const launchParamSchema = core_namespaceObject.z.string().describe('App name, bundle ID, or URL to launch. Prioritize using the exact bundle ID or URL the user has provided. If none provided, use the accurate app name.');
+const terminateParamSchema = core_namespaceObject.z.string().describe('Bundle ID of the app to terminate (close). Use the exact bundle ID, e.g. com.apple.Preferences.');
 const createPlatformActions = (device)=>({
         RunWdaRequest: (0, device_namespaceObject.defineAction)({
             name: 'RunWdaRequest',
@@ -1193,6 +1205,15 @@ const createPlatformActions = (device)=>({
                 await device.launch(param);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (close) an iOS app by its bundle ID',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                await device.terminate(param);
+            }
+        }),
         IOSHomeButton: (0, device_namespaceObject.defineAction)({
             name: 'IOSHomeButton',
             description: 'Trigger the system "home" operation on iOS devices',
@@ -1225,11 +1246,12 @@ class IOSAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runWdaRequest", void 0), agent_define_property(this, "terminate", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "appSwitcher", void 0), agent_define_property(this, "appNameMapping", void 0);
         this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
         device.setAppNameMapping(this.appNameMapping);
         this.launch = this.createActionWrapper('Launch');
         this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.terminate = this.createActionWrapper('Terminate');
         this.home = this.createActionWrapper('IOSHomeButton');
         this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
@@ -1290,7 +1312,7 @@ class IOSMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.5.3",
+            version: "1.5.4-beta-20260310030546.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }