@midscene/ios 1.0.1-beta-20251103074550.0 → 1.0.1-beta-20251104101357.0

package/dist/es/bin.mjs

@@ -12283,22 +12283,6 @@ class device_IOSDevice {
             defineActionKeyboardPress(async (param)=>{
                 await this.pressKey(param.keyName);
             }),
-            defineAction({
-                name: 'IOSHomeButton',
-                description: 'Trigger the system "home" operation on iOS devices',
-                paramSchema: z.object({}),
-                call: async ()=>{
-                    await this.home();
-                }
-            }),
-            defineAction({
-                name: 'IOSAppSwitcher',
-                description: 'Trigger the system "app switcher" operation on iOS devices',
-                paramSchema: z.object({}),
-                call: async ()=>{
-                    await this.appSwitcher();
-                }
-            }),
             defineAction({
                 name: 'IOSLongPress',
                 description: 'Trigger a long press on the screen at specified coordinates on iOS devices',
@@ -12771,6 +12755,22 @@ const createPlatformActions = (device)=>({
             call: async (param)=>{
                 await device.launch(param);
             }
+        }),
+        IOSHomeButton: defineAction({
+            name: 'IOSHomeButton',
+            description: 'Trigger the system "home" operation on iOS devices',
+            paramSchema: z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.home();
+            }
+        }),
+        IOSAppSwitcher: defineAction({
+            name: 'IOSAppSwitcher',
+            description: 'Trigger the system "app switcher" operation on iOS devices',
+            paramSchema: z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.appSwitcher();
+            }
         })
     });
 promisify(exec);
@@ -12787,10 +12787,16 @@ function agent_define_property(obj, key, value) {
 }
 getDebug('ios:agent');
 class IOSAgent extends Agent {
+    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);
-        this.launch = this.wrapActionInActionSpace('Launch');
-        this.runWdaRequest = this.wrapActionInActionSpace('RunWdaRequest');
+        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);
+        this.launch = this.createActionWrapper('Launch');
+        this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.home = this.createActionWrapper('IOSHomeButton');
+        this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
 }
 async function isPortAvailable(port) {

package/dist/es/index.mjs

@@ -434,22 +434,6 @@ class IOSDevice {
             defineActionKeyboardPress(async (param)=>{
                 await this.pressKey(param.keyName);
             }),
-            defineAction({
-                name: 'IOSHomeButton',
-                description: 'Trigger the system "home" operation on iOS devices',
-                paramSchema: z.object({}),
-                call: async ()=>{
-                    await this.home();
-                }
-            }),
-            defineAction({
-                name: 'IOSAppSwitcher',
-                description: 'Trigger the system "app switcher" operation on iOS devices',
-                paramSchema: z.object({}),
-                call: async ()=>{
-                    await this.appSwitcher();
-                }
-            }),
             defineAction({
                 name: 'IOSLongPress',
                 description: 'Trigger a long press on the screen at specified coordinates on iOS devices',
@@ -922,6 +906,22 @@ const createPlatformActions = (device)=>({
             call: async (param)=>{
                 await device.launch(param);
             }
+        }),
+        IOSHomeButton: defineAction({
+            name: 'IOSHomeButton',
+            description: 'Trigger the system "home" operation on iOS devices',
+            paramSchema: z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.home();
+            }
+        }),
+        IOSAppSwitcher: defineAction({
+            name: 'IOSAppSwitcher',
+            description: 'Trigger the system "app switcher" operation on iOS devices',
+            paramSchema: z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.appSwitcher();
+            }
         })
     });
 const execAsync = promisify(exec);
@@ -982,10 +982,16 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    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);
-        this.launch = this.wrapActionInActionSpace('Launch');
-        this.runWdaRequest = this.wrapActionInActionSpace('RunWdaRequest');
+        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);
+        this.launch = this.createActionWrapper('Launch');
+        this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.home = this.createActionWrapper('IOSHomeButton');
+        this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
 }
 async function agentFromWebDriverAgent(opts) {

package/dist/lib/bin.js

@@ -12421,22 +12421,6 @@ var __webpack_exports__ = {};
                 (0, device_namespaceObject.defineActionKeyboardPress)(async (param)=>{
                     await this.pressKey(param.keyName);
                 }),
-                (0, device_namespaceObject.defineAction)({
-                    name: 'IOSHomeButton',
-                    description: 'Trigger the system "home" operation on iOS devices',
-                    paramSchema: core_namespaceObject.z.object({}),
-                    call: async ()=>{
-                        await this.home();
-                    }
-                }),
-                (0, device_namespaceObject.defineAction)({
-                    name: 'IOSAppSwitcher',
-                    description: 'Trigger the system "app switcher" operation on iOS devices',
-                    paramSchema: core_namespaceObject.z.object({}),
-                    call: async ()=>{
-                        await this.appSwitcher();
-                    }
-                }),
                 (0, device_namespaceObject.defineAction)({
                     name: 'IOSLongPress',
                     description: 'Trigger a long press on the screen at specified coordinates on iOS devices',
@@ -12909,6 +12893,22 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
                 call: async (param)=>{
                     await device.launch(param);
                 }
+            }),
+            IOSHomeButton: (0, device_namespaceObject.defineAction)({
+                name: 'IOSHomeButton',
+                description: 'Trigger the system "home" operation on iOS devices',
+                paramSchema: core_namespaceObject.z["void"]().describe('No parameters required'),
+                call: async ()=>{
+                    await device.home();
+                }
+            }),
+            IOSAppSwitcher: (0, device_namespaceObject.defineAction)({
+                name: 'IOSAppSwitcher',
+                description: 'Trigger the system "app switcher" operation on iOS devices',
+                paramSchema: core_namespaceObject.z["void"]().describe('No parameters required'),
+                call: async ()=>{
+                    await device.appSwitcher();
+                }
             })
         });
     require("node:os");
@@ -12927,10 +12927,16 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     }
     (0, logger_namespaceObject.getDebug)('ios:agent');
     class IOSAgent extends agent_namespaceObject.Agent {
+        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);
-            this.launch = this.wrapActionInActionSpace('Launch');
-            this.runWdaRequest = this.wrapActionInActionSpace('RunWdaRequest');
+            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);
+            this.launch = this.createActionWrapper('Launch');
+            this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+            this.home = this.createActionWrapper('IOSHomeButton');
+            this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
         }
     }
     async function isPortAvailable(port) {

package/dist/lib/index.js

@@ -472,22 +472,6 @@ class IOSDevice {
             (0, device_namespaceObject.defineActionKeyboardPress)(async (param)=>{
                 await this.pressKey(param.keyName);
             }),
-            (0, device_namespaceObject.defineAction)({
-                name: 'IOSHomeButton',
-                description: 'Trigger the system "home" operation on iOS devices',
-                paramSchema: core_namespaceObject.z.object({}),
-                call: async ()=>{
-                    await this.home();
-                }
-            }),
-            (0, device_namespaceObject.defineAction)({
-                name: 'IOSAppSwitcher',
-                description: 'Trigger the system "app switcher" operation on iOS devices',
-                paramSchema: core_namespaceObject.z.object({}),
-                call: async ()=>{
-                    await this.appSwitcher();
-                }
-            }),
             (0, device_namespaceObject.defineAction)({
                 name: 'IOSLongPress',
                 description: 'Trigger a long press on the screen at specified coordinates on iOS devices',
@@ -960,6 +944,22 @@ const createPlatformActions = (device)=>({
             call: async (param)=>{
                 await device.launch(param);
             }
+        }),
+        IOSHomeButton: (0, device_namespaceObject.defineAction)({
+            name: 'IOSHomeButton',
+            description: 'Trigger the system "home" operation on iOS devices',
+            paramSchema: core_namespaceObject.z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.home();
+            }
+        }),
+        IOSAppSwitcher: (0, device_namespaceObject.defineAction)({
+            name: 'IOSAppSwitcher',
+            description: 'Trigger the system "app switcher" operation on iOS devices',
+            paramSchema: core_namespaceObject.z["void"]().describe('No parameters required'),
+            call: async ()=>{
+                await device.appSwitcher();
+            }
         })
     });
 const agent_namespaceObject = require("@midscene/core/agent");
@@ -1024,10 +1024,16 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = (0, logger_namespaceObject.getDebug)('ios:agent');
 class IOSAgent extends agent_namespaceObject.Agent {
+    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);
-        this.launch = this.wrapActionInActionSpace('Launch');
-        this.runWdaRequest = this.wrapActionInActionSpace('RunWdaRequest');
+        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);
+        this.launch = this.createActionWrapper('Launch');
+        this.runWdaRequest = this.createActionWrapper('RunWdaRequest');
+        this.home = this.createActionWrapper('IOSHomeButton');
+        this.appSwitcher = this.createActionWrapper('IOSAppSwitcher');
     }
 }
 async function agentFromWebDriverAgent(opts) {

package/dist/types/index.d.ts

@@ -14,6 +14,8 @@ import { Size } from '@midscene/core';
 import { WebDriverClient } from '@midscene/webdriver';
 import { z } from '@midscene/core';
 
+declare type ActionArgs<T extends DeviceAction> = [ActionParam<T>] extends [undefined] ? [] : [ActionParam<T>];
+
 export declare function agentFromWebDriverAgent(opts?: IOSAgentOpt & IOSDeviceOpt): Promise<IOSAgent>;
 
 export declare function checkIOSEnvironment(): Promise<{
@@ -21,6 +23,10 @@ export declare function checkIOSEnvironment(): Promise<{
     error?: string;
 }>;
 
+declare type DeviceActionIOSAppSwitcher = DeviceAction<void, void>;
+
+declare type DeviceActionIOSHomeButton = DeviceAction<void, void>;
+
 declare type DeviceActionLaunch = DeviceAction<LaunchParam, void>;
 
 declare type DeviceActionRunWdaRequest = DeviceAction<RunWdaRequestParam, RunWdaRequestReturn>;
@@ -36,7 +42,16 @@ export declare class IOSAgent extends Agent<IOSDevice> {
      * Type-safe wrapper around the RunWdaRequest action from actionSpace
      */
     runWdaRequest: WrappedAction<DeviceActionRunWdaRequest>;
+    /**
+     * Trigger the system home operation on iOS devices
+     */
+    home: WrappedAction<DeviceActionIOSHomeButton>;
+    /**
+     * Trigger the system app switcher operation on iOS devices
+     */
+    appSwitcher: WrappedAction<DeviceActionIOSAppSwitcher>;
     constructor(device: IOSDevice, opts?: IOSAgentOpt);
+    private createActionWrapper;
 }
 
 declare type IOSAgentOpt = AgentOpt;
@@ -201,6 +216,6 @@ declare type WDAHttpMethod = (typeof WDA_HTTP_METHODS)[number];
 /**
  * Helper type to convert DeviceAction to wrapped method signature
  */
-declare type WrappedAction<T extends DeviceAction> = (param: ActionParam<T>) => Promise<ActionReturn<T>>;
+declare type WrappedAction<T extends DeviceAction> = (...args: ActionArgs<T>) => Promise<ActionReturn<T>>;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "1.0.1-beta-20251103074550.0",
+  "version": "1.0.1-beta-20251104101357.0",
   "description": "iOS automation library for Midscene",
   "keywords": [
     "iOS UI automation",
@@ -38,9 +38,9 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/core": "1.0.1-beta-20251103074550.0",
-    "@midscene/shared": "1.0.1-beta-20251103074550.0",
-    "@midscene/webdriver": "1.0.1-beta-20251103074550.0"
+    "@midscene/core": "1.0.1-beta-20251104101357.0",
+    "@midscene/webdriver": "1.0.1-beta-20251104101357.0",
+    "@midscene/shared": "1.0.1-beta-20251104101357.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.11.2",
@@ -50,7 +50,7 @@
     "tsx": "^4.19.2",
     "vitest": "3.0.5",
     "zod": "3.24.3",
-    "@midscene/playground": "1.0.1-beta-20251103074550.0"
+    "@midscene/playground": "1.0.1-beta-20251104101357.0"
   },
   "license": "MIT",
   "scripts": {

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.88bfef40.js"></script><script defer src="/static/js/63.b6f8c5e5.js"></script><script defer src="/static/js/index.44fb18ac.js"></script><link href="/static/css/index.07da784d.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.88bfef40.js"></script><script defer src="/static/js/63.b6f8c5e5.js"></script><script defer src="/static/js/index.84ebfe98.js"></script><link href="/static/css/index.07da784d.css" rel="stylesheet"></head><body><div id="root"></div></body></html>