@midscene/ios 1.9.7 → 1.9.8-beta-20260618091332.0

package/dist/es/cli.mjs

@@ -1,6 +1,7 @@
 import { createReportCliCommands, z } from "@midscene/core";
 import { reportCLIError, runToolsCLI } from "@midscene/shared/cli";
 import { getDebug } from "@midscene/shared/logger";
+import { agentBehaviorInitArgShape, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { MIDSCENE_IOS_DEVICE_CLASS_OVERRIDE } from "@midscene/shared/env";
@@ -1356,7 +1357,8 @@ const iosInitArgShape = {
     wdaPort: z.number().optional().describe('WebDriverAgent port'),
     sessionId: z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1376,9 +1378,8 @@ class IOSMidsceneTools extends BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1416,6 +1417,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -1453,7 +1455,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618091332.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -9,6 +9,7 @@ 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 { agentBehaviorInitArgShape, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { exec } from "node:child_process";
 import { platform } from "node:os";
@@ -1361,7 +1362,8 @@ const iosInitArgShape = {
     wdaPort: z.number().optional().describe('WebDriverAgent port'),
     sessionId: z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1381,9 +1383,8 @@ class IOSMidsceneTools extends BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1421,6 +1422,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();

package/dist/es/mcp-server.mjs

@@ -10,6 +10,7 @@ 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 { agentBehaviorInitArgShape, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 const defaultAppNameMapping = {
     微信: 'com.tencent.xin',
@@ -1356,7 +1357,8 @@ const iosInitArgShape = {
     wdaPort: z.number().optional().describe('WebDriverAgent port'),
     sessionId: z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1376,9 +1378,8 @@ class IOSMidsceneTools extends BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1416,6 +1417,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -1457,7 +1459,7 @@ class IOSMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -24,6 +24,7 @@ var __webpack_exports__ = {};
 const core_namespaceObject = require("@midscene/core");
 const cli_namespaceObject = require("@midscene/shared/cli");
 const logger_namespaceObject = require("@midscene/shared/logger");
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/mcp/agent-behavior-init-args");
 const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const env_namespaceObject = require("@midscene/shared/env");
@@ -1380,7 +1381,8 @@ const iosInitArgShape = {
     wdaPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent port'),
     sessionId: core_namespaceObject.z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: core_namespaceObject.z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1400,9 +1402,8 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1440,6 +1441,7 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -1477,7 +1479,7 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618091332.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -1382,6 +1382,7 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/mcp/agent-behavior-init-args");
 const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 function mcp_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -1400,7 +1401,8 @@ const iosInitArgShape = {
     wdaPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent port'),
     sessionId: core_namespaceObject.z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: core_namespaceObject.z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1420,9 +1422,8 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1460,6 +1461,7 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();

package/dist/lib/mcp-server.js

@@ -1378,6 +1378,7 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/mcp/agent-behavior-init-args");
 const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 function mcp_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -1396,7 +1397,8 @@ const iosInitArgShape = {
     wdaPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent port'),
     sessionId: core_namespaceObject.z.string().optional().describe('Existing WebDriverAgent session ID to reuse'),
     useWDA: core_namespaceObject.z.boolean().optional().describe('Whether to reuse an existing WebDriverAgent session'),
-    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port')
+    wdaMjpegPort: core_namespaceObject.z.number().optional().describe('WebDriverAgent MJPEG streaming port'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function getTargetIdentity(initArgs) {
     if (initArgs?.deviceId) return initArgs.sessionId ? `${initArgs.deviceId}-session-${initArgs.sessionId}` : initArgs.deviceId;
@@ -1416,9 +1418,8 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         return new IOSDevice({});
     }
     async ensureAgent(opts) {
-        const hasOpts = !!opts && Object.keys(opts).length > 0;
-        const nextSignature = hasOpts ? JSON.stringify(opts) : void 0;
-        if (this.agent && hasOpts && nextSignature !== this.lastOptsSignature) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastOptsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1456,6 +1457,7 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastOptsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -1497,7 +1499,7 @@ class IOSMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ 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 { AgentBehaviorInitArgs } from '@midscene/shared/mcp/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
 import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
 import { DeviceAction } from '@midscene/core';
@@ -178,7 +179,7 @@ export declare class IOSDevice implements AbstractInterface {
     destroy(): Promise<void>;
 }
 
-declare type IOSInitArgs = Pick<IOSDeviceOpt, 'deviceId' | 'wdaHost' | 'wdaPort' | 'sessionId' | 'useWDA' | 'wdaMjpegPort'>;
+declare type IOSInitArgs = AgentBehaviorInitArgs & Pick<IOSDeviceOpt, 'deviceId' | 'wdaHost' | 'wdaPort' | 'sessionId' | 'useWDA' | 'wdaMjpegPort'>;
 
 /**
  * iOS-specific tools manager

package/dist/types/mcp-server.d.ts

@@ -2,6 +2,7 @@ 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 { AgentBehaviorInitArgs } from '@midscene/shared/mcp/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
 import { BaseMCPServer } from '@midscene/shared/mcp';
 import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
@@ -172,7 +173,7 @@ declare class IOSDevice implements AbstractInterface {
     destroy(): Promise<void>;
 }
 
-declare type IOSInitArgs = Pick<IOSDeviceOpt, 'deviceId' | 'wdaHost' | 'wdaPort' | 'sessionId' | 'useWDA' | 'wdaMjpegPort'>;
+declare type IOSInitArgs = AgentBehaviorInitArgs & Pick<IOSDeviceOpt, 'deviceId' | 'wdaHost' | 'wdaPort' | 'sessionId' | 'useWDA' | 'wdaMjpegPort'>;
 
 /**
  * iOS MCP Server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618091332.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -48,10 +48,10 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/core": "1.9.7",
-    "@midscene/webdriver": "1.9.7",
-    "@midscene/shared": "1.9.7",
-    "@midscene/playground": "1.9.7"
+    "@midscene/core": "1.9.8-beta-20260618091332.0",
+    "@midscene/webdriver": "1.9.8-beta-20260618091332.0",
+    "@midscene/playground": "1.9.8-beta-20260618091332.0",
+    "@midscene/shared": "1.9.8-beta-20260618091332.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

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.7b1abe58.js"></script><script defer src="/static/js/905.8d12588e.js"></script><script defer src="/static/js/index.50e06ed5.js"></script><link href="/static/css/index.1293237f.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.7b1abe58.js"></script><script defer src="/static/js/905.8d12588e.js"></script><script defer src="/static/js/index.64bb287d.js"></script><link href="/static/css/index.1293237f.css" rel="stylesheet"></head><body><div id="root"></div></body></html>