@midscene/ios 1.0.1-beta-20251030070226.0 → 1.0.1-beta-20251104075048.0

package/dist/es/bin.mjs

@@ -12189,6 +12189,10 @@ class IOSWebDriverClient extends WebDriverClient {
             debugIOS(`Failed to apply iOS session configuration: ${error}`);
         }
     }
+    async executeRequest(method, endpoint, data) {
+        this.ensureSession();
+        return this.makeRequest(method, endpoint, data);
+    }
 }
 function device_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -12201,6 +12205,12 @@ function device_define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
 class device_IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -12309,9 +12319,11 @@ class device_IOSDevice {
                 await this.clearInput(element);
             })
         ];
+        const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions || [];
         return [
             ...defaultActions,
+            ...platformSpecificActions,
             ...customActions
         ];
     }
@@ -12699,6 +12711,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
             throw new Error(`Failed to open URL via Safari: ${error}`);
         }
     }
+    async runWdaRequest(method, endpoint, data) {
+        return await this.wdaBackend.executeRequest(method, endpoint, data);
+    }
     async destroy() {
         if (this.destroyed) return;
         try {
@@ -12734,13 +12749,48 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         this.wdaManager = WDAManager.getInstance(wdaPort, wdaHost);
     }
 }
+const runWdaRequestParamSchema = z.object({
+    method: z["enum"](WDA_HTTP_METHODS).describe('HTTP method (GET, POST, DELETE, PUT)'),
+    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 bundle ID or URL to launch');
+const createPlatformActions = (device)=>({
+        RunWdaRequest: defineAction({
+            name: 'RunWdaRequest',
+            description: 'Execute WebDriverAgent API request directly on iOS device',
+            interfaceAlias: 'runWdaRequest',
+            paramSchema: runWdaRequestParamSchema,
+            call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
+        }),
+        Launch: defineAction({
+            name: 'Launch',
+            description: 'Launch an iOS app or URL',
+            interfaceAlias: 'launch',
+            paramSchema: launchParamSchema,
+            call: async (param)=>{
+                await device.launch(param);
+            }
+        })
+    });
 promisify(exec);
 getDebug('ios:utils');
+function agent_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 getDebug('ios:agent');
 class IOSAgent extends Agent {
-    async launch(uri) {
-        const device = this.page;
-        await device.launch(uri);
+    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');
     }
 }
 async function isPortAvailable(port) {

package/dist/es/index.mjs

@@ -340,6 +340,10 @@ class IOSWebDriverClient extends WebDriverClient {
             debugIOS(`Failed to apply iOS session configuration: ${error}`);
         }
     }
+    async executeRequest(method, endpoint, data) {
+        this.ensureSession();
+        return this.makeRequest(method, endpoint, data);
+    }
 }
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -352,6 +356,12 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
 class IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -460,9 +470,11 @@ class IOSDevice {
                 await this.clearInput(element);
             })
         ];
+        const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions || [];
         return [
             ...defaultActions,
+            ...platformSpecificActions,
             ...customActions
         ];
     }
@@ -850,6 +862,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
             throw new Error(`Failed to open URL via Safari: ${error}`);
         }
     }
+    async runWdaRequest(method, endpoint, data) {
+        return await this.wdaBackend.executeRequest(method, endpoint, data);
+    }
     async destroy() {
         if (this.destroyed) return;
         try {
@@ -885,6 +900,30 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         this.wdaManager = WDAManager.getInstance(wdaPort, wdaHost);
     }
 }
+const runWdaRequestParamSchema = z.object({
+    method: z["enum"](WDA_HTTP_METHODS).describe('HTTP method (GET, POST, DELETE, PUT)'),
+    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 bundle ID or URL to launch');
+const createPlatformActions = (device)=>({
+        RunWdaRequest: defineAction({
+            name: 'RunWdaRequest',
+            description: 'Execute WebDriverAgent API request directly on iOS device',
+            interfaceAlias: 'runWdaRequest',
+            paramSchema: runWdaRequestParamSchema,
+            call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
+        }),
+        Launch: defineAction({
+            name: 'Launch',
+            description: 'Launch an iOS app or URL',
+            interfaceAlias: 'launch',
+            paramSchema: launchParamSchema,
+            call: async (param)=>{
+                await device.launch(param);
+            }
+        })
+    });
 const execAsync = promisify(exec);
 const debugUtils = getDebug('ios:utils');
 function checkMacOSPlatform() {
@@ -931,11 +970,22 @@ async function checkIOSEnvironment() {
         };
     }
 }
+function agent_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
-    async launch(uri) {
-        const device = this.page;
-        await device.launch(uri);
+    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');
     }
 }
 async function agentFromWebDriverAgent(opts) {

package/dist/lib/bin.js

@@ -12327,6 +12327,10 @@ var __webpack_exports__ = {};
                 debugIOS(`Failed to apply iOS session configuration: ${error}`);
             }
         }
+        async executeRequest(method, endpoint, data) {
+            this.ensureSession();
+            return this.makeRequest(method, endpoint, data);
+        }
     }
     function device_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
@@ -12339,6 +12343,12 @@ var __webpack_exports__ = {};
         return obj;
     }
     const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+    const WDA_HTTP_METHODS = [
+        'GET',
+        'POST',
+        'DELETE',
+        'PUT'
+    ];
     class device_IOSDevice {
         actionSpace() {
             const defaultActions = [
@@ -12447,9 +12457,11 @@ var __webpack_exports__ = {};
                     await this.clearInput(element);
                 })
             ];
+            const platformSpecificActions = Object.values(createPlatformActions(this));
             const customActions = this.customActions || [];
             return [
                 ...defaultActions,
+                ...platformSpecificActions,
                 ...customActions
             ];
         }
@@ -12837,6 +12849,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
                 throw new Error(`Failed to open URL via Safari: ${error}`);
             }
         }
+        async runWdaRequest(method, endpoint, data) {
+            return await this.wdaBackend.executeRequest(method, endpoint, data);
+        }
         async destroy() {
             if (this.destroyed) return;
             try {
@@ -12872,15 +12887,50 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
             this.wdaManager = webdriver_namespaceObject.WDAManager.getInstance(wdaPort, wdaHost);
         }
     }
+    const runWdaRequestParamSchema = core_namespaceObject.z.object({
+        method: core_namespaceObject.z["enum"](WDA_HTTP_METHODS).describe('HTTP method (GET, POST, DELETE, PUT)'),
+        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 bundle ID or URL to launch');
+    const createPlatformActions = (device)=>({
+            RunWdaRequest: (0, device_namespaceObject.defineAction)({
+                name: 'RunWdaRequest',
+                description: 'Execute WebDriverAgent API request directly on iOS device',
+                interfaceAlias: 'runWdaRequest',
+                paramSchema: runWdaRequestParamSchema,
+                call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
+            }),
+            Launch: (0, device_namespaceObject.defineAction)({
+                name: 'Launch',
+                description: 'Launch an iOS app or URL',
+                interfaceAlias: 'launch',
+                paramSchema: launchParamSchema,
+                call: async (param)=>{
+                    await device.launch(param);
+                }
+            })
+        });
     require("node:os");
     const external_node_util_namespaceObject = require("node:util");
     (0, external_node_util_namespaceObject.promisify)(external_node_child_process_namespaceObject.exec);
     (0, logger_namespaceObject.getDebug)('ios:utils');
+    function agent_define_property(obj, key, value) {
+        if (key in obj) Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+        else obj[key] = value;
+        return obj;
+    }
     (0, logger_namespaceObject.getDebug)('ios:agent');
     class IOSAgent extends agent_namespaceObject.Agent {
-        async launch(uri) {
-            const device = this.page;
-            await device.launch(uri);
+        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');
         }
     }
     async function isPortAvailable(port) {

package/dist/lib/index.js

@@ -378,6 +378,10 @@ class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
             debugIOS(`Failed to apply iOS session configuration: ${error}`);
         }
     }
+    async executeRequest(method, endpoint, data) {
+        this.ensureSession();
+        return this.makeRequest(method, endpoint, data);
+    }
 }
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -390,6 +394,12 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
 class IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -498,9 +508,11 @@ class IOSDevice {
                 await this.clearInput(element);
             })
         ];
+        const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions || [];
         return [
             ...defaultActions,
+            ...platformSpecificActions,
             ...customActions
         ];
     }
@@ -888,6 +900,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
             throw new Error(`Failed to open URL via Safari: ${error}`);
         }
     }
+    async runWdaRequest(method, endpoint, data) {
+        return await this.wdaBackend.executeRequest(method, endpoint, data);
+    }
     async destroy() {
         if (this.destroyed) return;
         try {
@@ -923,6 +938,30 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         this.wdaManager = webdriver_namespaceObject.WDAManager.getInstance(wdaPort, wdaHost);
     }
 }
+const runWdaRequestParamSchema = core_namespaceObject.z.object({
+    method: core_namespaceObject.z["enum"](WDA_HTTP_METHODS).describe('HTTP method (GET, POST, DELETE, PUT)'),
+    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 bundle ID or URL to launch');
+const createPlatformActions = (device)=>({
+        RunWdaRequest: (0, device_namespaceObject.defineAction)({
+            name: 'RunWdaRequest',
+            description: 'Execute WebDriverAgent API request directly on iOS device',
+            interfaceAlias: 'runWdaRequest',
+            paramSchema: runWdaRequestParamSchema,
+            call: async (param)=>await device.runWdaRequest(param.method, param.endpoint, param.data)
+        }),
+        Launch: (0, device_namespaceObject.defineAction)({
+            name: 'Launch',
+            description: 'Launch an iOS app or URL',
+            interfaceAlias: 'launch',
+            paramSchema: launchParamSchema,
+            call: async (param)=>{
+                await device.launch(param);
+            }
+        })
+    });
 const agent_namespaceObject = require("@midscene/core/agent");
 const external_node_child_process_namespaceObject = require("node:child_process");
 const external_node_os_namespaceObject = require("node:os");
@@ -973,11 +1012,22 @@ async function checkIOSEnvironment() {
         };
     }
 }
+function agent_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debugAgent = (0, logger_namespaceObject.getDebug)('ios:agent');
 class IOSAgent extends agent_namespaceObject.Agent {
-    async launch(uri) {
-        const device = this.page;
-        await device.launch(uri);
+    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');
     }
 }
 async function agentFromWebDriverAgent(opts) {

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 import { AbstractInterface } from '@midscene/core/device';
+import type { ActionParam } from '@midscene/core';
+import type { ActionReturn } from '@midscene/core';
 import { Agent } from '@midscene/core/agent';
 import { AgentOpt } from '@midscene/core/agent';
 import { DeviceAction } from '@midscene/core';
@@ -10,6 +12,7 @@ import { overrideAIConfig } from '@midscene/shared/env';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
 import { WebDriverClient } from '@midscene/webdriver';
+import { z } from '@midscene/core';
 
 export declare function agentFromWebDriverAgent(opts?: IOSAgentOpt & IOSDeviceOpt): Promise<IOSAgent>;
 
@@ -18,8 +21,22 @@ export declare function checkIOSEnvironment(): Promise<{
     error?: string;
 }>;
 
+declare type DeviceActionLaunch = DeviceAction<LaunchParam, void>;
+
+declare type DeviceActionRunWdaRequest = DeviceAction<RunWdaRequestParam, RunWdaRequestReturn>;
+
 export declare class IOSAgent extends Agent<IOSDevice> {
-    launch(uri: string): Promise<void>;
+    /**
+     * Launch an iOS app or URL
+     * Type-safe wrapper around the Launch action from actionSpace
+     */
+    launch: WrappedAction<DeviceActionLaunch>;
+    /**
+     * Execute WebDriverAgent API request directly
+     * Type-safe wrapper around the RunWdaRequest action from actionSpace
+     */
+    runWdaRequest: WrappedAction<DeviceActionRunWdaRequest>;
+    constructor(device: IOSDevice, opts?: IOSAgentOpt);
 }
 
 declare type IOSAgentOpt = AgentOpt;
@@ -93,6 +110,15 @@ export declare class IOSDevice implements AbstractInterface {
      * @param url The URL to open
      */
     openUrlViaSafari(url: string): Promise<void>;
+    /**
+     * Execute a WebDriverAgent API request directly
+     * This is the iOS equivalent of Android's runAdbShell
+     * @param method HTTP method (GET, POST, DELETE, PUT)
+     * @param endpoint WebDriver API endpoint
+     * @param data Optional request body data
+     * @returns Response from the WebDriver API
+     */
+    runWdaRequest<TResult = any>(method: WDAHttpMethod, endpoint: string, data?: any): Promise<TResult>;
     destroy(): Promise<void>;
 }
 
@@ -130,8 +156,51 @@ export declare class IOSWebDriverClient extends WebDriverClient {
     getScreenScale(): Promise<number | null>;
     createSession(capabilities?: any): Promise<any>;
     private setupIOSSession;
+    /**
+     * Execute a WebDriverAgent API request directly
+     * This is the iOS equivalent of Android's runAdbShell
+     * @param method HTTP method (GET, POST, DELETE, etc.)
+     * @param endpoint WebDriver API endpoint
+     * @param data Optional request body data
+     * @returns Response from the WebDriver API
+     */
+    executeRequest<TResult = any>(method: string, endpoint: string, data?: any): Promise<TResult>;
 }
 
+declare type LaunchParam = z.infer<typeof launchParamSchema>;
+
+declare const launchParamSchema: z.ZodString;
+
 export { overrideAIConfig }
 
+declare type RunWdaRequestParam = z.infer<typeof runWdaRequestParamSchema>;
+
+declare const runWdaRequestParamSchema: z.ZodObject<{
+    method: z.ZodEnum<["GET", "POST", "DELETE", "PUT"]>;
+    endpoint: z.ZodString;
+    data: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    method: "POST" | "GET" | "DELETE" | "PUT";
+    endpoint: string;
+    data?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}, {
+    method: "POST" | "GET" | "DELETE" | "PUT";
+    endpoint: string;
+    data?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+}>;
+
+declare type RunWdaRequestReturn = Awaited<ReturnType<IOSDevice['runWdaRequest']>>;
+
+/**
+ * HTTP methods supported by WebDriverAgent API
+ */
+declare const WDA_HTTP_METHODS: readonly ["GET", "POST", "DELETE", "PUT"];
+
+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>>;
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "1.0.1-beta-20251030070226.0",
+  "version": "1.0.1-beta-20251104075048.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-20251030070226.0",
-    "@midscene/webdriver": "1.0.1-beta-20251030070226.0",
-    "@midscene/shared": "1.0.1-beta-20251030070226.0"
+    "@midscene/core": "1.0.1-beta-20251104075048.0",
+    "@midscene/shared": "1.0.1-beta-20251104075048.0",
+    "@midscene/webdriver": "1.0.1-beta-20251104075048.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.11.2",
@@ -49,7 +49,8 @@
     "typescript": "^5.8.3",
     "tsx": "^4.19.2",
     "vitest": "3.0.5",
-    "@midscene/playground": "1.0.1-beta-20251030070226.0"
+    "zod": "3.24.3",
+    "@midscene/playground": "1.0.1-beta-20251104075048.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.9dc611eb.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.8a368b59.js"></script><link href="/static/css/index.07da784d.css" rel="stylesheet"></head><body><div id="root"></div></body></html>