@midscene/harmony 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, 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";
@@ -986,6 +987,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = getDebug('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -993,8 +1004,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.deviceId;
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1007,9 +1020,11 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1020,7 +1035,8 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1030,8 +1046,9 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1054,22 +1071,23 @@ class HarmonyMidsceneTools 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: 'harmony',
             shape: {
-                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    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, repeat } from
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 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";
 import { overrideAIConfig } from "@midscene/shared/env";
 import node_path from "node:path";
@@ -991,6 +992,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = getDebug('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -998,8 +1009,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.deviceId;
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1012,9 +1025,11 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1025,7 +1040,8 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1035,8 +1051,9 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1059,15 +1076,16 @@ class HarmonyMidsceneTools 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: 'harmony',
             shape: {
-                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }

package/dist/es/mcp-server.mjs

@@ -1,6 +1,7 @@
 import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { z } from "@midscene/core";
 import { getDebug } from "@midscene/shared/logger";
+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";
@@ -986,6 +987,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = getDebug('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -993,8 +1004,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.deviceId;
+        const nextSignature = getAgentInitArgsSignature(initArgs);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1007,9 +1020,11 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...extractAgentBehaviorInitArgs(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1020,7 +1035,8 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1030,8 +1046,9 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1054,15 +1071,16 @@ class HarmonyMidsceneTools 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: 'harmony',
             shape: {
-                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }
@@ -1073,7 +1091,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the HarmonyOS 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 utils_namespaceObject = require("@midscene/shared/utils");
@@ -1011,6 +1012,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_namespaceObject.getDebug)('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -1018,8 +1029,10 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.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) {
@@ -1032,9 +1045,11 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1045,7 +1060,8 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1055,8 +1071,9 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1079,22 +1096,23 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.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: 'harmony',
             shape: {
-                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    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

@@ -1018,6 +1018,7 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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, {
@@ -1030,6 +1031,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_namespaceObject.getDebug)('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -1037,8 +1048,10 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.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) {
@@ -1051,9 +1064,11 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1064,7 +1079,8 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1074,8 +1090,9 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1098,15 +1115,16 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.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: 'harmony',
             shape: {
-                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }

package/dist/lib/mcp-server.js

@@ -40,6 +40,7 @@ __webpack_require__.d(__webpack_exports__, {
 const mcp_namespaceObject = require("@midscene/shared/mcp");
 const core_namespaceObject = require("@midscene/core");
 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 utils_namespaceObject = require("@midscene/shared/utils");
@@ -1027,6 +1028,16 @@ function mcp_tools_define_property(obj, key, value) {
     return obj;
 }
 const debug = (0, logger_namespaceObject.getDebug)('mcp:harmony-tools');
+function adaptHarmonyInitArgs(extracted) {
+    if (!extracted) return;
+    const initArgs = {
+        ...'string' == typeof extracted.deviceId ? {
+            deviceId: extracted.deviceId
+        } : {},
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
+    };
+    return Object.keys(initArgs).length > 0 ? initArgs : void 0;
+}
 class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     getCliReportSessionName() {
         return 'midscene-harmony';
@@ -1034,8 +1045,10 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
-    async ensureAgent(deviceId) {
-        if (this.agent && deviceId) {
+    async ensureAgent(initArgs) {
+        const deviceId = initArgs?.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) {
@@ -1048,9 +1061,11 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         const reportOptions = this.readCliReportAgentOptions();
         const agent = await agentFromHdcDevice(deviceId, {
             autoDismissKeyboard: false,
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(initArgs) ?? {},
             ...reportOptions ?? {}
         });
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -1061,7 +1076,8 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 schema: this.getAgentInitArgSchema(),
                 cli: this.getAgentInitArgCliMetadata(),
                 handler: async (args)=>{
-                    const deviceId = this.extractAgentInitParam(args);
+                    const initArgs = this.extractAgentInitParam(args);
+                    const deviceId = initArgs?.deviceId;
                     const reportSession = this.createNewCliReportSession(deviceId ?? 'auto');
                     this.commitCliReportSession(reportSession);
                     if (this.agent) {
@@ -1071,8 +1087,9 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             debug('Failed to destroy agent during connect:', error);
                         }
                         this.agent = void 0;
+                        this.lastInitArgsSignature = void 0;
                     }
-                    const agent = await this.ensureAgent(deviceId);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
                         content: [
@@ -1095,15 +1112,16 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.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: 'harmony',
             shape: {
-                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)'),
+                ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
             },
             cli: {
                 preferBareKeys: true
             },
-            adapt: (extracted)=>extracted?.deviceId
+            adapt: adaptHarmonyInitArgs
         });
     }
 }
@@ -1114,7 +1132,7 @@ class HarmonyMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the HarmonyOS 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';
@@ -138,11 +139,16 @@ declare type HarmonyDeviceInputOpt = HarmonyDeviceInputOpt_2 & {
 
 declare type HarmonyDeviceOpt = HarmonyDeviceOpt_2 & HarmonyDeviceInputOpt;
 
-export declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, string> {
+declare type HarmonyInitArgs = AgentBehaviorInitArgs & {
+    deviceId?: string;
+};
+
+export declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, HarmonyInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
-    protected readonly initArgSpec: InitArgSpec<string>;
+    protected readonly initArgSpec: InitArgSpec<HarmonyInitArgs>;
     protected createTemporaryDevice(): HarmonyDevice;
-    protected ensureAgent(deviceId?: string): Promise<HarmonyAgent>;
+    protected ensureAgent(initArgs?: HarmonyInitArgs): Promise<HarmonyAgent>;
     protected preparePlatformTools(): ToolDefinition[];
 }
 

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';
@@ -128,16 +129,21 @@ declare type HarmonyDeviceInputOpt = HarmonyDeviceInputOpt_2 & {
 
 declare type HarmonyDeviceOpt = HarmonyDeviceOpt_2 & HarmonyDeviceInputOpt;
 
+declare type HarmonyInitArgs = AgentBehaviorInitArgs & {
+    deviceId?: string;
+};
+
 export declare class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager?: HarmonyMidsceneTools);
     protected createToolsManager(): HarmonyMidsceneTools;
 }
 
-declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, string> {
+declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, HarmonyInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
-    protected readonly initArgSpec: InitArgSpec<string>;
+    protected readonly initArgSpec: InitArgSpec<HarmonyInitArgs>;
     protected createTemporaryDevice(): HarmonyDevice;
-    protected ensureAgent(deviceId?: string): Promise<HarmonyAgent>;
+    protected ensureAgent(initArgs?: HarmonyInitArgs): Promise<HarmonyAgent>;
     protected preparePlatformTools(): ToolDefinition[];
 }
 

package/package.json

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