@midscene/ios 1.9.7 → 1.9.8-beta-20260618014851.0

package/dist/es/cli.mjs

@@ -1,7 +1,8 @@
 import { createReportCliCommands, z } from "@midscene/core";
 import { reportCLIError, runToolsCLI } from "@midscene/shared/cli";
+import { agentBehaviorInitArgShape, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
+import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { getDebug } from "@midscene/shared/logger";
-import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { MIDSCENE_IOS_DEVICE_CLASS_OVERRIDE } from "@midscene/shared/env";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison } from "@midscene/shared/utils";
@@ -1339,7 +1340,7 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1349,14 +1350,15 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = getDebug('mcp:ios-tools');
+const debug = getDebug('agent-tools:ios');
 const iosInitArgShape = {
     deviceId: z.string().optional().describe('iOS device UDID (optional when WDA auto-detect is sufficient)'),
     wdaHost: z.string().optional().describe('WebDriverAgent host, defaults to localhost'),
     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();
@@ -1440,20 +1442,20 @@ class IOSMidsceneTools extends BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), agent_tools_define_property(this, "initArgSpec", {
             namespace: 'ios',
             shape: iosInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>extracted
-        }), mcp_tools_define_property(this, "lastOptsSignature", void 0);
+        }), agent_tools_define_property(this, "lastOptsSignature", void 0);
     }
 }
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618014851.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -9,7 +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 { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
+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";
 import { platform } from "node:os";
 import { promisify } from "node:util";
@@ -1344,7 +1345,7 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1354,14 +1355,15 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = getDebug('mcp:ios-tools');
+const debug = getDebug('agent-tools:ios');
 const iosInitArgShape = {
     deviceId: z.string().optional().describe('iOS device UDID (optional when WDA auto-detect is sufficient)'),
     wdaHost: z.string().optional().describe('WebDriverAgent host, defaults to localhost'),
     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();
@@ -1445,14 +1447,14 @@ class IOSMidsceneTools extends BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), agent_tools_define_property(this, "initArgSpec", {
             namespace: 'ios',
             shape: iosInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>extracted
-        }), mcp_tools_define_property(this, "lastOptsSignature", void 0);
+        }), agent_tools_define_property(this, "lastOptsSignature", void 0);
     }
 }
 const execAsync = promisify(exec);

package/dist/lib/cli.js

@@ -23,8 +23,9 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 const core_namespaceObject = require("@midscene/core");
 const cli_namespaceObject = require("@midscene/shared/cli");
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/agent-tools/agent-behavior-init-args");
+const base_tools_namespaceObject = require("@midscene/shared/agent-tools/base-tools");
 const logger_namespaceObject = require("@midscene/shared/logger");
-const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const env_namespaceObject = require("@midscene/shared/env");
 const utils_namespaceObject = require("@midscene/shared/utils");
@@ -1363,7 +1364,7 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1373,14 +1374,15 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = (0, logger_namespaceObject.getDebug)('mcp:ios-tools');
+const debug = (0, logger_namespaceObject.getDebug)('agent-tools:ios');
 const iosInitArgShape = {
     deviceId: core_namespaceObject.z.string().optional().describe('iOS device UDID (optional when WDA auto-detect is sufficient)'),
     wdaHost: core_namespaceObject.z.string().optional().describe('WebDriverAgent host, defaults to localhost'),
     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();
@@ -1464,20 +1466,20 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), agent_tools_define_property(this, "initArgSpec", {
             namespace: 'ios',
             shape: iosInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>extracted
-        }), mcp_tools_define_property(this, "lastOptsSignature", void 0);
+        }), agent_tools_define_property(this, "lastOptsSignature", void 0);
     }
 }
 const tools = new IOSMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618014851.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -1382,8 +1382,9 @@ async function agentFromWebDriverAgent(opts) {
     await device.connect();
     return new IOSAgent(device, opts);
 }
-const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
-function mcp_tools_define_property(obj, key, value) {
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/agent-tools/agent-behavior-init-args");
+const base_tools_namespaceObject = require("@midscene/shared/agent-tools/base-tools");
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1393,14 +1394,15 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = (0, logger_namespaceObject.getDebug)('mcp:ios-tools');
+const debug = (0, logger_namespaceObject.getDebug)('agent-tools:ios');
 const iosInitArgShape = {
     deviceId: core_namespaceObject.z.string().optional().describe('iOS device UDID (optional when WDA auto-detect is sufficient)'),
     wdaHost: core_namespaceObject.z.string().optional().describe('WebDriverAgent host, defaults to localhost'),
     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();
@@ -1484,14 +1486,14 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), agent_tools_define_property(this, "initArgSpec", {
             namespace: 'ios',
             shape: iosInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>extracted
-        }), mcp_tools_define_property(this, "lastOptsSignature", void 0);
+        }), agent_tools_define_property(this, "lastOptsSignature", void 0);
     }
 }
 const external_node_child_process_namespaceObject = require("node:child_process");

package/dist/types/index.d.ts

@@ -2,11 +2,12 @@ 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/agent-tools/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
-import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
+import { BaseMidsceneTools } from '@midscene/shared/agent-tools/base-tools';
 import { DeviceAction } from '@midscene/core';
 import type { ElementInfo } from '@midscene/shared/extractor';
-import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
+import { InitArgSpec } from '@midscene/shared/agent-tools/base-tools';
 import { InterfaceType } from '@midscene/core';
 import { IOSDeviceOpt } from '@midscene/core/device';
 import { MobileInputPrimitives } from '@midscene/core/device';
@@ -14,7 +15,7 @@ import { overrideAIConfig } from '@midscene/shared/env';
 import { PlaygroundPlatformDescriptor } from '@midscene/playground';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
-import type { ToolDefinition } from '@midscene/shared/mcp/types';
+import type { ToolDefinition } from '@midscene/shared/agent-tools/types';
 import { WebDriverClient } from '@midscene/webdriver';
 import { z } 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618014851.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -38,20 +38,15 @@
       "import": "./dist/es/bin.mjs",
       "require": "./dist/lib/bin.js"
     },
-    "./mcp-server": {
-      "types": "./dist/types/mcp-server.d.ts",
-      "import": "./dist/es/mcp-server.mjs",
-      "require": "./dist/lib/mcp-server.js"
-    },
     "./package.json": "./package.json"
   },
   "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/webdriver": "1.9.8-beta-20260618014851.0",
+    "@midscene/shared": "1.9.8-beta-20260618014851.0",
+    "@midscene/playground": "1.9.8-beta-20260618014851.0",
+    "@midscene/core": "1.9.8-beta-20260618014851.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.b4cb2178.js"></script><link href="/static/css/index.1293237f.css" rel="stylesheet"></head><body><div id="root"></div></body></html>