@midscene/ios 1.7.5 → 1.7.6-beta-20260423130231.0

package/dist/es/bin.mjs

@@ -7,7 +7,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midscene/shared/utils";
 import node_assert from "node:assert";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionLongPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
@@ -744,24 +744,11 @@ class device_IOSDevice {
                     await sleep(100);
                 }
             }),
-            defineAction({
-                name: 'LongPress',
-                description: 'Trigger a long press on the screen at specified element',
-                paramSchema: z.object({
-                    duration: z.number().optional().describe('The duration of the long press in milliseconds'),
-                    locate: getMidsceneLocationSchema().describe('The element to be long pressed')
-                }),
-                sample: {
-                    locate: {
-                        prompt: 'the message bubble'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    node_assert(element, 'LongPress requires an element to be located');
-                    const [x, y] = element.center;
-                    await this.longPress(x, y, param?.duration);
-                }
+            defineActionLongPress(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'LongPress requires an element to be located');
+                const [x, y] = element.center;
+                await this.longPress(x, y, param?.duration);
             }),
             defineActionPinch(async (param)=>{
                 const { centerX, centerY, startDistance, endDistance, duration } = normalizePinchParam(param, await this.size());
@@ -1241,8 +1228,12 @@ const runWdaRequestParamSchema = z.object({
     endpoint: z.string().describe('WebDriver API endpoint'),
     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 launchParamSchema = z.object({
+    uri: 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.object({
+    uri: 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',
@@ -1260,8 +1251,12 @@ const createPlatformActions = (device)=>({
             description: 'Launch an iOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.launch(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
+                await device.launch(param.uri);
             }
         }),
         Terminate: defineAction({
@@ -1269,8 +1264,12 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (close) an iOS app by its bundle ID',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.terminate(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
             }
         }),
         IOSHomeButton: defineAction({
@@ -1300,17 +1299,27 @@ function agent_define_property(obj, key, value) {
 }
 getDebug('ios:agent');
 class IOSAgent extends Agent {
+    async launch(uri) {
+        const action = this.wrapActionInActionSpace('Launch');
+        return action({
+            uri
+        });
+    }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     createActionWrapper(name) {
         const action = this.wrapActionInActionSpace(name);
         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, "terminate", 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, "runWdaRequest", 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

@@ -5,7 +5,7 @@ import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midscene/shared/utils";
 import node_assert from "node:assert";
-import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionLongPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { DEFAULT_WDA_PORT } from "@midscene/shared/constants";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
@@ -743,24 +743,11 @@ class IOSDevice {
                     await sleep(100);
                 }
             }),
-            defineAction({
-                name: 'LongPress',
-                description: 'Trigger a long press on the screen at specified element',
-                paramSchema: z.object({
-                    duration: z.number().optional().describe('The duration of the long press in milliseconds'),
-                    locate: getMidsceneLocationSchema().describe('The element to be long pressed')
-                }),
-                sample: {
-                    locate: {
-                        prompt: 'the message bubble'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    node_assert(element, 'LongPress requires an element to be located');
-                    const [x, y] = element.center;
-                    await this.longPress(x, y, param?.duration);
-                }
+            defineActionLongPress(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'LongPress requires an element to be located');
+                const [x, y] = element.center;
+                await this.longPress(x, y, param?.duration);
             }),
             defineActionPinch(async (param)=>{
                 const { centerX, centerY, startDistance, endDistance, duration } = normalizePinchParam(param, await this.size());
@@ -1240,8 +1227,12 @@ const runWdaRequestParamSchema = z.object({
     endpoint: z.string().describe('WebDriver API endpoint'),
     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 launchParamSchema = z.object({
+    uri: 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.object({
+    uri: 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',
@@ -1259,8 +1250,12 @@ const createPlatformActions = (device)=>({
             description: 'Launch an iOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.launch(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
+                await device.launch(param.uri);
             }
         }),
         Terminate: defineAction({
@@ -1268,8 +1263,12 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (close) an iOS app by its bundle ID',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.terminate(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
             }
         }),
         IOSHomeButton: defineAction({
@@ -1299,17 +1298,27 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    async launch(uri) {
+        const action = this.wrapActionInActionSpace('Launch');
+        return action({
+            uri
+        });
+    }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     createActionWrapper(name) {
         const action = this.wrapActionInActionSpace(name);
         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, "terminate", 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, "runWdaRequest", 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');
     }
@@ -1407,7 +1416,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.7.5",
+    version: "1.7.6-beta-20260423130231.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -1,6 +1,6 @@
 import node_assert from "node:assert";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionLongPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { DEFAULT_WDA_PORT, PLAYGROUND_SERVER_PORT } from "@midscene/shared/constants";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
@@ -565,24 +565,11 @@ class IOSDevice {
                     await sleep(100);
                 }
             }),
-            defineAction({
-                name: 'LongPress',
-                description: 'Trigger a long press on the screen at specified element',
-                paramSchema: z.object({
-                    duration: z.number().optional().describe('The duration of the long press in milliseconds'),
-                    locate: getMidsceneLocationSchema().describe('The element to be long pressed')
-                }),
-                sample: {
-                    locate: {
-                        prompt: 'the message bubble'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    node_assert(element, 'LongPress requires an element to be located');
-                    const [x, y] = element.center;
-                    await this.longPress(x, y, param?.duration);
-                }
+            defineActionLongPress(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'LongPress requires an element to be located');
+                const [x, y] = element.center;
+                await this.longPress(x, y, param?.duration);
             }),
             defineActionPinch(async (param)=>{
                 const { centerX, centerY, startDistance, endDistance, duration } = normalizePinchParam(param, await this.size());
@@ -1062,8 +1049,12 @@ const runWdaRequestParamSchema = z.object({
     endpoint: z.string().describe('WebDriver API endpoint'),
     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 launchParamSchema = z.object({
+    uri: 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.object({
+    uri: 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',
@@ -1081,8 +1072,12 @@ const createPlatformActions = (device)=>({
             description: 'Launch an iOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.launch(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
+                await device.launch(param.uri);
             }
         }),
         Terminate: defineAction({
@@ -1090,8 +1085,12 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (close) an iOS app by its bundle ID',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.terminate(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
             }
         }),
         IOSHomeButton: defineAction({
@@ -1305,17 +1304,27 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    async launch(uri) {
+        const action = this.wrapActionInActionSpace('Launch');
+        return action({
+            uri
+        });
+    }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     createActionWrapper(name) {
         const action = this.wrapActionInActionSpace(name);
         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, "terminate", 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, "runWdaRequest", 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/mcp-server.mjs

@@ -4,7 +4,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midscene/shared/utils";
 import node_assert from "node:assert";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionCursorMove, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionLongPress, defineActionPinch, defineActionScroll, defineActionSwipe, defineActionTap, normalizeMobileSwipeParam, normalizePinchParam } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { DEFAULT_WDA_PORT } from "@midscene/shared/constants";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
@@ -743,24 +743,11 @@ class IOSDevice {
                     await sleep(100);
                 }
             }),
-            defineAction({
-                name: 'LongPress',
-                description: 'Trigger a long press on the screen at specified element',
-                paramSchema: z.object({
-                    duration: z.number().optional().describe('The duration of the long press in milliseconds'),
-                    locate: getMidsceneLocationSchema().describe('The element to be long pressed')
-                }),
-                sample: {
-                    locate: {
-                        prompt: 'the message bubble'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    node_assert(element, 'LongPress requires an element to be located');
-                    const [x, y] = element.center;
-                    await this.longPress(x, y, param?.duration);
-                }
+            defineActionLongPress(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'LongPress requires an element to be located');
+                const [x, y] = element.center;
+                await this.longPress(x, y, param?.duration);
             }),
             defineActionPinch(async (param)=>{
                 const { centerX, centerY, startDistance, endDistance, duration } = normalizePinchParam(param, await this.size());
@@ -1240,8 +1227,12 @@ const runWdaRequestParamSchema = z.object({
     endpoint: z.string().describe('WebDriver API endpoint'),
     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 launchParamSchema = z.object({
+    uri: 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.object({
+    uri: 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',
@@ -1259,8 +1250,12 @@ const createPlatformActions = (device)=>({
             description: 'Launch an iOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.launch(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
+                await device.launch(param.uri);
             }
         }),
         Terminate: defineAction({
@@ -1268,8 +1263,12 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (close) an iOS app by its bundle ID',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.terminate(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
             }
         }),
         IOSHomeButton: defineAction({
@@ -1299,17 +1298,27 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    async launch(uri) {
+        const action = this.wrapActionInActionSpace('Launch');
+        return action({
+            uri
+        });
+    }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     createActionWrapper(name) {
         const action = this.wrapActionInActionSpace(name);
         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, "terminate", 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, "runWdaRequest", 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');
     }
@@ -1411,7 +1420,7 @@ class IOSMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.7.5",
+            version: "1.7.6-beta-20260423130231.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -769,24 +769,11 @@ class device_IOSDevice {
                     await (0, core_utils_namespaceObject.sleep)(100);
                 }
             }),
-            (0, device_namespaceObject.defineAction)({
-                name: 'LongPress',
-                description: 'Trigger a long press on the screen at specified element',
-                paramSchema: core_namespaceObject.z.object({
-                    duration: core_namespaceObject.z.number().optional().describe('The duration of the long press in milliseconds'),
-                    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The element to be long pressed')
-                }),
-                sample: {
-                    locate: {
-                        prompt: 'the message bubble'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    external_node_assert_default()(element, 'LongPress requires an element to be located');
-                    const [x, y] = element.center;
-                    await this.longPress(x, y, param?.duration);
-                }
+            (0, device_namespaceObject.defineActionLongPress)(async (param)=>{
+                const element = param.locate;
+                external_node_assert_default()(element, 'LongPress requires an element to be located');
+                const [x, y] = element.center;
+                await this.longPress(x, y, param?.duration);
             }),
             (0, device_namespaceObject.defineActionPinch)(async (param)=>{
                 const { centerX, centerY, startDistance, endDistance, duration } = (0, device_namespaceObject.normalizePinchParam)(param, await this.size());
@@ -1266,8 +1253,12 @@ const runWdaRequestParamSchema = core_namespaceObject.z.object({
     endpoint: core_namespaceObject.z.string().describe('WebDriver API endpoint'),
     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 launchParamSchema = core_namespaceObject.z.object({
+    uri: 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.object({
+    uri: 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',
@@ -1285,8 +1276,12 @@ const createPlatformActions = (device)=>({
             description: 'Launch an iOS app or URL',
             interfaceAlias: 'launch',
             paramSchema: launchParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.launch(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Launch requires a non-empty uri parameter');
+                await device.launch(param.uri);
             }
         }),
         Terminate: (0, device_namespaceObject.defineAction)({
@@ -1294,8 +1289,12 @@ const createPlatformActions = (device)=>({
             description: 'Terminate (close) an iOS app by its bundle ID',
             interfaceAlias: 'terminate',
             paramSchema: terminateParamSchema,
+            sample: {
+                uri: 'com.apple.Preferences'
+            },
             call: async (param)=>{
-                await device.terminate(param);
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
             }
         }),
         IOSHomeButton: (0, device_namespaceObject.defineAction)({
@@ -1325,17 +1324,27 @@ function agent_define_property(obj, key, value) {
 }
 (0, logger_namespaceObject.getDebug)('ios:agent');
 class IOSAgent extends agent_namespaceObject.Agent {
+    async launch(uri) {
+        const action = this.wrapActionInActionSpace('Launch');
+        return action({
+            uri
+        });
+    }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     createActionWrapper(name) {
         const action = this.wrapActionInActionSpace(name);
         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, "terminate", 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, "runWdaRequest", 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');
     }