@midscene/ios 1.12.4-beta-20260903111111.0 → 1.12.4

package/dist/es/bin.mjs

@@ -12,6 +12,8 @@ import { createDefaultMobileActions, defineAction, resolveTextInputOptions, send
 import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 const defaultAppNameMapping = {
     微信: 'com.tencent.xin',
     企业微信: 'com.tencent.ww',
@@ -1724,6 +1726,102 @@ const createPlatformActions = (device)=>({
             }
         })
     });
+const defineIOSAgentNode = createAgentTestRunnerNodeDefinition('an iOS Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, or bundle identifier to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle identifier or app name to terminate.')
+});
+const test_runner_nodes_WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
+const wdaRequestInputSchema = v4_z.strictObject({
+    method: v4_z["enum"](test_runner_nodes_WDA_HTTP_METHODS).describe('The WebDriverAgent HTTP method.'),
+    endpoint: v4_z.string().regex(/^\/\S*$/, 'endpoint must start with / and contain no whitespace').describe('The WebDriverAgent API endpoint.'),
+    data: v4_z.record(v4_z.string(), v4_z.unknown()).optional().describe('An optional JSON request body.')
+});
+const runWdaRequestInputSchema = v4_z.strictObject({
+    request: wdaRequestInputSchema
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineIOSAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineIOSAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runWdaRequestNode = defineIOSAgentNode({
+    method: 'runWdaRequest',
+    title: 'Run a WebDriverAgent request',
+    description: 'Execute a WebDriverAgent HTTP request through the current iOS Agent and return its JSON-serializable response.',
+    stringInputKey: false,
+    inputSchema: runWdaRequestInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        return [
+            input.request
+        ];
+    },
+    toResult (response, input) {
+        const summary = `Executed WDA ${input.request.method} ${input.request.endpoint}`;
+        return void 0 === response ? {
+            summary
+        } : {
+            summary,
+            data: response
+        };
+    }
+});
+const homeNode = defineIOSAgentNode({
+    method: 'home',
+    description: 'Trigger the iOS system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS home'
+        })
+});
+const appSwitcherNode = defineIOSAgentNode({
+    method: 'appSwitcher',
+    description: 'Trigger the iOS system app switcher operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS appSwitcher'
+        })
+});
+const iosAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runWdaRequestNode,
+    homeNode,
+    appSwitcherNode
+];
 function agent_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -1736,6 +1834,12 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...iosAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({

package/dist/es/cli.mjs

@@ -12,6 +12,8 @@ import { sleep } from "@midscene/core/utils";
 import { DEFAULT_WDA_PORT } from "@midscene/shared/constants";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 const defaultAppNameMapping = {
     微信: 'com.tencent.xin',
     企业微信: 'com.tencent.ww',
@@ -1724,6 +1726,102 @@ const createPlatformActions = (device)=>({
             }
         })
     });
+const defineIOSAgentNode = createAgentTestRunnerNodeDefinition('an iOS Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, or bundle identifier to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle identifier or app name to terminate.')
+});
+const test_runner_nodes_WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
+const wdaRequestInputSchema = v4_z.strictObject({
+    method: v4_z["enum"](test_runner_nodes_WDA_HTTP_METHODS).describe('The WebDriverAgent HTTP method.'),
+    endpoint: v4_z.string().regex(/^\/\S*$/, 'endpoint must start with / and contain no whitespace').describe('The WebDriverAgent API endpoint.'),
+    data: v4_z.record(v4_z.string(), v4_z.unknown()).optional().describe('An optional JSON request body.')
+});
+const runWdaRequestInputSchema = v4_z.strictObject({
+    request: wdaRequestInputSchema
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineIOSAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineIOSAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runWdaRequestNode = defineIOSAgentNode({
+    method: 'runWdaRequest',
+    title: 'Run a WebDriverAgent request',
+    description: 'Execute a WebDriverAgent HTTP request through the current iOS Agent and return its JSON-serializable response.',
+    stringInputKey: false,
+    inputSchema: runWdaRequestInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        return [
+            input.request
+        ];
+    },
+    toResult (response, input) {
+        const summary = `Executed WDA ${input.request.method} ${input.request.endpoint}`;
+        return void 0 === response ? {
+            summary
+        } : {
+            summary,
+            data: response
+        };
+    }
+});
+const homeNode = defineIOSAgentNode({
+    method: 'home',
+    description: 'Trigger the iOS system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS home'
+        })
+});
+const appSwitcherNode = defineIOSAgentNode({
+    method: 'appSwitcher',
+    description: 'Trigger the iOS system app switcher operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS appSwitcher'
+        })
+});
+const iosAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runWdaRequestNode,
+    homeNode,
+    appSwitcherNode
+];
 function agent_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -1736,6 +1834,12 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...iosAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({
@@ -1892,7 +1996,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.12.4-beta-20260903111111.0",
+    version: "1.12.4",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -9,6 +9,8 @@ import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midsce
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
 import { Agent } from "@midscene/core/agent";
 import { MIDSCENE_IOS_DEVICE_CLASS_OVERRIDE, overrideAIConfig } from "@midscene/shared/env";
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z as v4_z } from "zod/v4";
 import { agentBehaviorInitArgShape, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { exec } from "node:child_process";
@@ -1729,6 +1731,102 @@ const defaultAppNameMapping = {
     Keynote: 'com.apple.Keynote',
     'Keynote 讲演': 'com.apple.Keynote'
 };
+const defineIOSAgentNode = createAgentTestRunnerNodeDefinition('an iOS Agent');
+const nonBlankText = (description)=>v4_z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The app, URL, URI, or bundle identifier to launch.')
+});
+const terminateInputSchema = v4_z.strictObject({
+    uri: nonBlankText('The bundle identifier or app name to terminate.')
+});
+const test_runner_nodes_WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
+const wdaRequestInputSchema = v4_z.strictObject({
+    method: v4_z["enum"](test_runner_nodes_WDA_HTTP_METHODS).describe('The WebDriverAgent HTTP method.'),
+    endpoint: v4_z.string().regex(/^\/\S*$/, 'endpoint must start with / and contain no whitespace').describe('The WebDriverAgent API endpoint.'),
+    data: v4_z.record(v4_z.string(), v4_z.unknown()).optional().describe('An optional JSON request body.')
+});
+const runWdaRequestInputSchema = v4_z.strictObject({
+    request: wdaRequestInputSchema
+});
+const emptyInputSchema = v4_z.strictObject({});
+const launchNode = defineIOSAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineIOSAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runWdaRequestNode = defineIOSAgentNode({
+    method: 'runWdaRequest',
+    title: 'Run a WebDriverAgent request',
+    description: 'Execute a WebDriverAgent HTTP request through the current iOS Agent and return its JSON-serializable response.',
+    stringInputKey: false,
+    inputSchema: runWdaRequestInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        return [
+            input.request
+        ];
+    },
+    toResult (response, input) {
+        const summary = `Executed WDA ${input.request.method} ${input.request.endpoint}`;
+        return void 0 === response ? {
+            summary
+        } : {
+            summary,
+            data: response
+        };
+    }
+});
+const homeNode = defineIOSAgentNode({
+    method: 'home',
+    description: 'Trigger the iOS system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS home'
+        })
+});
+const appSwitcherNode = defineIOSAgentNode({
+    method: 'appSwitcher',
+    description: 'Trigger the iOS system app switcher operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS appSwitcher'
+        })
+});
+const iosAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runWdaRequestNode,
+    homeNode,
+    appSwitcherNode
+];
 function agent_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -1741,6 +1839,12 @@ function agent_define_property(obj, key, value) {
 }
 const debugAgent = getDebug('ios:agent');
 class IOSAgent extends Agent {
+    static getTestRunnerNodeDefinitions() {
+        return [
+            ...Agent.getTestRunnerNodeDefinitions(),
+            ...iosAgentTestRunnerNodeDefinitions
+        ];
+    }
     async launch(uri) {
         const action = this.wrapActionInActionSpace('Launch');
         return action({
@@ -2055,4 +2159,4 @@ const iosPlaygroundPlatform = definePlaygroundPlatform({
         };
     }
 });
-export { IOSAgent, IOSDevice, IOSMidsceneTools, IOSWebDriverClient, agentFromWebDriverAgent, checkIOSEnvironment, iosPlaygroundPlatform, overrideAIConfig };
+export { IOSAgent, IOSDevice, IOSMidsceneTools, IOSWebDriverClient, agentFromWebDriverAgent, checkIOSEnvironment, iosAgentTestRunnerNodeDefinitions, iosPlaygroundPlatform, launchInputSchema, overrideAIConfig, runWdaRequestInputSchema, terminateInputSchema, wdaRequestInputSchema };

package/dist/es/test-runner.mjs

@@ -0,0 +1,99 @@
+import { createAgentTestRunnerNodeDefinition } from "@midscene/core/agent/test-runner";
+import { z } from "zod/v4";
+const defineIOSAgentNode = createAgentTestRunnerNodeDefinition('an iOS Agent');
+const nonBlankText = (description)=>z.string().regex(/\S/, 'value must contain a non-whitespace character').describe(description);
+const launchInputSchema = z.strictObject({
+    uri: nonBlankText('The app, URL, URI, or bundle identifier to launch.')
+});
+const terminateInputSchema = z.strictObject({
+    uri: nonBlankText('The bundle identifier or app name to terminate.')
+});
+const WDA_HTTP_METHODS = [
+    'GET',
+    'POST',
+    'DELETE',
+    'PUT'
+];
+const wdaRequestInputSchema = z.strictObject({
+    method: z["enum"](WDA_HTTP_METHODS).describe('The WebDriverAgent HTTP method.'),
+    endpoint: z.string().regex(/^\/\S*$/, 'endpoint must start with / and contain no whitespace').describe('The WebDriverAgent API endpoint.'),
+    data: z.record(z.string(), z.unknown()).optional().describe('An optional JSON request body.')
+});
+const runWdaRequestInputSchema = z.strictObject({
+    request: wdaRequestInputSchema
+});
+const emptyInputSchema = z.strictObject({});
+const launchNode = defineIOSAgentNode({
+    method: 'launch',
+    description: 'Launch an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: launchInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Launched ${input.uri}`
+        })
+});
+const terminateNode = defineIOSAgentNode({
+    method: 'terminate',
+    description: 'Terminate an application through the current iOS Agent.',
+    stringInputKey: 'uri',
+    inputSchema: terminateInputSchema,
+    toArgs: (input)=>[
+            input.uri
+        ],
+    toResult: (_output, input)=>({
+            summary: `Terminated ${input.uri}`
+        })
+});
+const runWdaRequestNode = defineIOSAgentNode({
+    method: 'runWdaRequest',
+    title: 'Run a WebDriverAgent request',
+    description: 'Execute a WebDriverAgent HTTP request through the current iOS Agent and return its JSON-serializable response.',
+    stringInputKey: false,
+    inputSchema: runWdaRequestInputSchema,
+    toArgs (input, context) {
+        context.signal.throwIfAborted();
+        return [
+            input.request
+        ];
+    },
+    toResult (response, input) {
+        const summary = `Executed WDA ${input.request.method} ${input.request.endpoint}`;
+        return void 0 === response ? {
+            summary
+        } : {
+            summary,
+            data: response
+        };
+    }
+});
+const homeNode = defineIOSAgentNode({
+    method: 'home',
+    description: 'Trigger the iOS system home operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS home'
+        })
+});
+const appSwitcherNode = defineIOSAgentNode({
+    method: 'appSwitcher',
+    description: 'Trigger the iOS system app switcher operation.',
+    stringInputKey: false,
+    inputSchema: emptyInputSchema,
+    toArgs: ()=>[],
+    toResult: ()=>({
+            summary: 'Triggered iOS appSwitcher'
+        })
+});
+const iosAgentTestRunnerNodeDefinitions = [
+    launchNode,
+    terminateNode,
+    runWdaRequestNode,
+    homeNode,
+    appSwitcherNode
+];
+export { iosAgentTestRunnerNodeDefinitions, launchInputSchema, runWdaRequestInputSchema, terminateInputSchema, wdaRequestInputSchema };