@midscene/android 1.9.7 → 1.9.8-beta-20260618091332.0

package/dist/es/cli.mjs

@@ -4,6 +4,7 @@ import * as __rspack_external_node_module_ab9f2194 from "node:module";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import { createReportCliCommands, getMidsceneLocationSchema, z } from "@midscene/core";
 import { reportCLIError, runToolsCLI } from "@midscene/shared/cli";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, 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 { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
@@ -1950,6 +1951,19 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_.getDebug)('mcp:android-tools');
+function adaptAndroidInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...'boolean' == typeof extracted.useScrcpy ? {
+            useScrcpy: extracted.useScrcpy
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class AndroidMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-android';
@@ -1959,7 +1973,8 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
     }
     async ensureAgent(initArgs) {
         const deviceId = initArgs?.deviceId;
-        if (this.agent && deviceId) {
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1972,6 +1987,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...initArgs?.useScrcpy ? {
                 scrcpyConfig: {
                     enabled: true
@@ -1980,6 +1996,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2001,6 +2018,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -2025,26 +2043,24 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
             namespace: 'android',
             shape: {
                 deviceId: z.string().optional().describe('Android device ID (from adb devices)'),
-                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>({
-                    deviceId: extracted?.deviceId,
-                    useScrcpy: extracted?.useScrcpy
-                })
+            adapt: adaptAndroidInitArgs
         });
     }
 }
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618091332.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -12,6 +12,7 @@ import { createImgBase64ByFormat, validateScreenshotBuffer } from "@midscene/sha
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
 import { ADB } from "appium-adb";
 import { Agent } from "@midscene/core/agent";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 var __webpack_modules__ = {
     "./src/scrcpy-manager.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -2016,6 +2017,19 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_.getDebug)('mcp:android-tools');
+function adaptAndroidInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...'boolean' == typeof extracted.useScrcpy ? {
+            useScrcpy: extracted.useScrcpy
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class AndroidMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-android';
@@ -2025,7 +2039,8 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
     }
     async ensureAgent(initArgs) {
         const deviceId = initArgs?.deviceId;
-        if (this.agent && deviceId) {
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -2038,6 +2053,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...initArgs?.useScrcpy ? {
                 scrcpyConfig: {
                     enabled: true
@@ -2046,6 +2062,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2067,6 +2084,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -2091,19 +2109,17 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
             namespace: 'android',
             shape: {
                 deviceId: z.string().optional().describe('Android device ID (from adb devices)'),
-                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>({
-                    deviceId: extracted?.deviceId,
-                    useScrcpy: extracted?.useScrcpy
-                })
+            adapt: adaptAndroidInitArgs
         });
     }
 }

package/dist/es/mcp-server.mjs

@@ -13,6 +13,7 @@ import { getTmpFile, sleep } from "@midscene/core/utils";
 import { MIDSCENE_ADB_PATH, MIDSCENE_ADB_REMOTE_HOST, MIDSCENE_ADB_REMOTE_PORT, MIDSCENE_ANDROID_IME_STRATEGY, globalConfigManager } from "@midscene/shared/env";
 import { createImgBase64ByFormat, validateScreenshotBuffer } from "@midscene/shared/img";
 import { ADB as external_appium_adb_ADB } from "appium-adb";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 var __webpack_modules__ = {
     "./src/scrcpy-manager.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -1950,6 +1951,19 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_.getDebug)('mcp:android-tools');
+function adaptAndroidInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...'boolean' == typeof extracted.useScrcpy ? {
+            useScrcpy: extracted.useScrcpy
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class AndroidMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-android';
@@ -1959,7 +1973,8 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
     }
     async ensureAgent(initArgs) {
         const deviceId = initArgs?.deviceId;
-        if (this.agent && deviceId) {
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1972,6 +1987,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...initArgs?.useScrcpy ? {
                 scrcpyConfig: {
                     enabled: true
@@ -1980,6 +1996,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2001,6 +2018,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
                     const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
@@ -2025,19 +2043,17 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         ];
     }
     constructor(...args){
-        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+        super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
             namespace: 'android',
             shape: {
                 deviceId: z.string().optional().describe('Android device ID (from adb devices)'),
-                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                useScrcpy: z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>({
-                    deviceId: extracted?.deviceId,
-                    useScrcpy: extracted?.useScrcpy
-                })
+            adapt: adaptAndroidInitArgs
         });
     }
 }
@@ -2048,7 +2064,7 @@ class AndroidMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/android-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the Android device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -449,6 +449,7 @@ var __webpack_exports__ = {};
     const core_namespaceObject = require("@midscene/core");
     const cli_namespaceObject = require("@midscene/shared/cli");
     var logger_ = __webpack_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 utils_namespaceObject = require("@midscene/shared/utils");
@@ -1965,6 +1966,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         return obj;
     }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
+    function adaptAndroidInitArgs(extracted) {
+        if (!extracted) return;
+        const initArgs = {
+            ...'string' == typeof extracted.deviceId ? {
+                deviceId: extracted.deviceId
+            } : {},
+            ...'boolean' == typeof extracted.useScrcpy ? {
+                useScrcpy: extracted.useScrcpy
+            } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+        };
+        return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+    }
     class AndroidMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         getCliReportSessionName() {
             return 'midscene-android';
@@ -1974,7 +1988,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         async ensureAgent(initArgs) {
             const deviceId = initArgs?.deviceId;
-            if (this.agent && deviceId) {
+            const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(initArgs);
+            if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
                 try {
                     await this.agent.destroy?.();
                 } catch (error) {
@@ -1987,6 +2002,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const reportOptions = this.readCliReportAgentOptions();
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false,
+                ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
                 ...initArgs?.useScrcpy ? {
                     scrcpyConfig: {
                         enabled: true
@@ -1995,6 +2011,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         preparePlatformTools() {
@@ -2016,6 +2033,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                                 debug('Failed to destroy agent during connect:', error);
                             }
                             this.agent = void 0;
+                            this.lastInitArgsSignature = void 0;
                         }
                         const agent = await this.ensureAgent(initArgs);
                         const screenshot = await agent.page.screenshotBase64();
@@ -2040,26 +2058,24 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             ];
         }
         constructor(...args){
-            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
                 namespace: 'android',
                 shape: {
                     deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)'),
-                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
                 },
                 cli: {
                     preferBareKeys: true
                 },
-                adapt: (extracted)=>({
-                        deviceId: extracted?.deviceId,
-                        useScrcpy: extracted?.useScrcpy
-                    })
+                adapt: adaptAndroidInitArgs
             });
         }
     }
     const tools = new AndroidMidsceneTools();
     (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-android', {
         stripPrefix: 'android_',
-        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

@@ -2040,6 +2040,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await device.connect();
         return new AndroidAgent(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, {
@@ -2052,6 +2053,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         return obj;
     }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
+    function adaptAndroidInitArgs(extracted) {
+        if (!extracted) return;
+        const initArgs = {
+            ...'string' == typeof extracted.deviceId ? {
+                deviceId: extracted.deviceId
+            } : {},
+            ...'boolean' == typeof extracted.useScrcpy ? {
+                useScrcpy: extracted.useScrcpy
+            } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+        };
+        return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+    }
     class AndroidMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         getCliReportSessionName() {
             return 'midscene-android';
@@ -2061,7 +2075,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         async ensureAgent(initArgs) {
             const deviceId = initArgs?.deviceId;
-            if (this.agent && deviceId) {
+            const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(initArgs);
+            if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
                 try {
                     await this.agent.destroy?.();
                 } catch (error) {
@@ -2074,6 +2089,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const reportOptions = this.readCliReportAgentOptions();
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false,
+                ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
                 ...initArgs?.useScrcpy ? {
                     scrcpyConfig: {
                         enabled: true
@@ -2082,6 +2098,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         preparePlatformTools() {
@@ -2103,6 +2120,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                                 debug('Failed to destroy agent during connect:', error);
                             }
                             this.agent = void 0;
+                            this.lastInitArgsSignature = void 0;
                         }
                         const agent = await this.ensureAgent(initArgs);
                         const screenshot = await agent.page.screenshotBase64();
@@ -2127,19 +2145,17 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             ];
         }
         constructor(...args){
-            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
                 namespace: 'android',
                 shape: {
                     deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)'),
-                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
                 },
                 cli: {
                     preferBareKeys: true
                 },
-                adapt: (extracted)=>({
-                        deviceId: extracted?.deviceId,
-                        useScrcpy: extracted?.useScrcpy
-                    })
+                adapt: adaptAndroidInitArgs
             });
         }
     }

package/dist/lib/mcp-server.js

@@ -1969,6 +1969,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await device.connect();
         return new AndroidAgent(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, {
@@ -1981,6 +1982,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         return obj;
     }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
+    function adaptAndroidInitArgs(extracted) {
+        if (!extracted) return;
+        const initArgs = {
+            ...'string' == typeof extracted.deviceId ? {
+                deviceId: extracted.deviceId
+            } : {},
+            ...'boolean' == typeof extracted.useScrcpy ? {
+                useScrcpy: extracted.useScrcpy
+            } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+        };
+        return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+    }
     class AndroidMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
         getCliReportSessionName() {
             return 'midscene-android';
@@ -1990,7 +2004,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         async ensureAgent(initArgs) {
             const deviceId = initArgs?.deviceId;
-            if (this.agent && deviceId) {
+            const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(initArgs);
+            if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
                 try {
                     await this.agent.destroy?.();
                 } catch (error) {
@@ -2003,6 +2018,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const reportOptions = this.readCliReportAgentOptions();
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false,
+                ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
                 ...initArgs?.useScrcpy ? {
                     scrcpyConfig: {
                         enabled: true
@@ -2011,6 +2027,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         preparePlatformTools() {
@@ -2032,6 +2049,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                                 debug('Failed to destroy agent during connect:', error);
                             }
                             this.agent = void 0;
+                            this.lastInitArgsSignature = void 0;
                         }
                         const agent = await this.ensureAgent(initArgs);
                         const screenshot = await agent.page.screenshotBase64();
@@ -2056,19 +2074,17 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             ];
         }
         constructor(...args){
-            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            super(...args), mcp_tools_define_property(this, "lastInitArgsSignature", void 0), mcp_tools_define_property(this, "initArgSpec", {
                 namespace: 'android',
                 shape: {
                     deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)'),
-                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots')
+                    useScrcpy: core_namespaceObject.z.boolean().optional().describe('Enable scrcpy accelerated screenshots'),
+                    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
                 },
                 cli: {
                     preferBareKeys: true
                 },
-                adapt: (extracted)=>({
-                        deviceId: extracted?.deviceId,
-                        useScrcpy: extracted?.useScrcpy
-                    })
+                adapt: adaptAndroidInitArgs
             });
         }
     }
@@ -2079,7 +2095,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         constructor(toolsManager){
             super({
                 name: '@midscene/android-mcp',
-                version: "1.9.7",
+                version: "1.9.8-beta-20260618091332.0",
                 description: 'Control the Android device using natural language commands'
             }, toolsManager);
         }

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ import type { ActionReturn } from '@midscene/core';
 import { ADB } from 'appium-adb';
 import type { Adb } from '@yume-chan/adb';
 import { Agent } from '@midscene/core/agent';
+import { AgentBehaviorInitArgs } from '@midscene/shared/mcp/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
 import { AndroidDeviceInputOpt } from '@midscene/core/device';
 import { AndroidDeviceOpt } from '@midscene/core/device';
@@ -234,24 +235,21 @@ export declare class AndroidDevice implements AbstractInterface {
     hideKeyboard(options?: AndroidDeviceInputOpt, timeoutMs?: number): Promise<boolean>;
 }
 
+declare type AndroidInitArgs = AgentBehaviorInitArgs & {
+    deviceId?: string;
+    useScrcpy?: boolean;
+};
+
 /**
  * Android-specific tools manager
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
-export declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, {
-    deviceId?: string;
-    useScrcpy?: boolean;
-}> {
+export declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, AndroidInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
-    protected readonly initArgSpec: InitArgSpec<{
-        deviceId?: string;
-        useScrcpy?: boolean;
-    }>;
+    protected readonly initArgSpec: InitArgSpec<AndroidInitArgs>;
     protected createTemporaryDevice(): AndroidDevice;
-    protected ensureAgent(initArgs?: {
-        deviceId?: string;
-        useScrcpy?: boolean;
-    }): Promise<AndroidAgent>;
+    protected ensureAgent(initArgs?: AndroidInitArgs): Promise<AndroidAgent>;
     /**
      * Provide Android-specific platform tools
      */

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

@@ -3,6 +3,7 @@ import type { ActionParam } from '@midscene/core';
 import type { ActionReturn } from '@midscene/core';
 import { ADB } from 'appium-adb';
 import { Agent } from '@midscene/core/agent';
+import { AgentBehaviorInitArgs } from '@midscene/shared/mcp/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
 import { AndroidDeviceInputOpt } from '@midscene/core/device';
 import { AndroidDeviceOpt } from '@midscene/core/device';
@@ -226,6 +227,11 @@ declare class AndroidDevice implements AbstractInterface {
     hideKeyboard(options?: AndroidDeviceInputOpt, timeoutMs?: number): Promise<boolean>;
 }
 
+declare type AndroidInitArgs = AgentBehaviorInitArgs & {
+    deviceId?: string;
+    useScrcpy?: boolean;
+};
+
 /**
  * Android MCP Server
  * Provides MCP tools for Android automation through ADB
@@ -239,20 +245,12 @@ export declare class AndroidMCPServer extends BaseMCPServer {
  * Android-specific tools manager
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
-declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, {
-    deviceId?: string;
-    useScrcpy?: boolean;
-}> {
+declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, AndroidInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
-    protected readonly initArgSpec: InitArgSpec<{
-        deviceId?: string;
-        useScrcpy?: boolean;
-    }>;
+    protected readonly initArgSpec: InitArgSpec<AndroidInitArgs>;
     protected createTemporaryDevice(): AndroidDevice;
-    protected ensureAgent(initArgs?: {
-        deviceId?: string;
-        useScrcpy?: boolean;
-    }): Promise<AndroidAgent>;
+    protected ensureAgent(initArgs?: AndroidInitArgs): Promise<AndroidAgent>;
     /**
      * Provide Android-specific platform tools
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618091332.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -46,8 +46,8 @@
     "@yume-chan/stream-extra": "2.1.0",
     "appium-adb": "12.12.1",
     "sharp": "^0.34.3",
-    "@midscene/core": "1.9.7",
-    "@midscene/shared": "1.9.7"
+    "@midscene/core": "1.9.8-beta-20260618091332.0",
+    "@midscene/shared": "1.9.8-beta-20260618091332.0"
   },
   "optionalDependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0"
@@ -61,7 +61,7 @@
     "undici": "^6.0.0",
     "vitest": "3.0.5",
     "zod": "^3.25.1",
-    "@midscene/playground": "1.9.7"
+    "@midscene/playground": "1.9.8-beta-20260618091332.0"
   },
   "license": "MIT",
   "scripts": {