@midscene/computer 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 { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
@@ -694,7 +695,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1903,7 +1904,8 @@ const computerInitArgShape = {
     ignoreCertificate: z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -1919,14 +1921,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -1949,7 +1947,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1967,6 +1966,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -1979,10 +1979,12 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...extractAgentBehaviorInitArgs(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2003,6 +2005,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                             mcp_tools_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.interface.screenshotBase64();
@@ -2042,7 +2045,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2055,7 +2058,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.7",
+    version: "1.9.8-beta-20260618091332.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -13,6 +13,7 @@ import { Agent } from "@midscene/core/agent";
 import { once } from "node:events";
 import { createInterface } from "node:readline";
 import { z } from "@midscene/core";
+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";
 function _define_property(obj, key, value) {
@@ -694,7 +695,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1946,7 +1947,8 @@ const computerInitArgShape = {
     ignoreCertificate: z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -1962,14 +1964,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -1992,7 +1990,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -2010,6 +2009,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -2022,10 +2022,12 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...extractAgentBehaviorInitArgs(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2046,6 +2048,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                             mcp_tools_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.interface.screenshotBase64();
@@ -2085,7 +2088,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2096,7 +2099,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.7";
+    const currentVersion = "1.9.8-beta-20260618091332.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -14,6 +14,7 @@ import node_assert from "node:assert";
 import { once } from "node:events";
 import { createInterface } from "node:readline";
 import { z } from "@midscene/core";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/mcp/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -694,7 +695,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1903,7 +1904,8 @@ const computerInitArgShape = {
     ignoreCertificate: z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -1919,14 +1921,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...extractAgentBehaviorInitArgs(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -1949,7 +1947,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && shouldRebuildAgentForInitArgs(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1967,6 +1966,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -1979,10 +1979,12 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...extractAgentBehaviorInitArgs(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2003,6 +2005,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                             mcp_tools_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.interface.screenshotBase64();
@@ -2042,7 +2045,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2059,7 +2062,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -27,6 +27,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 external_node_child_process_namespaceObject = require("node:child_process");
@@ -720,7 +721,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1930,7 +1931,8 @@ const computerInitArgShape = {
     ignoreCertificate: core_namespaceObject.z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: core_namespaceObject.z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: core_namespaceObject.z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -1946,14 +1948,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -1976,7 +1974,8 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1994,6 +1993,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -2006,10 +2006,12 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2030,6 +2032,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             mcp_tools_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.interface.screenshotBase64();
@@ -2069,7 +2072,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2082,7 +2085,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 const tools = new ComputerMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    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

@@ -747,7 +747,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1972,6 +1972,7 @@ async function agentForRDPComputer(opts) {
     return new ComputerAgent(device, opts);
 }
 const core_namespaceObject = require("@midscene/core");
+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, {
@@ -2003,7 +2004,8 @@ const computerInitArgShape = {
     ignoreCertificate: core_namespaceObject.z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: core_namespaceObject.z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: core_namespaceObject.z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -2019,14 +2021,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -2049,7 +2047,8 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -2067,6 +2066,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -2079,10 +2079,12 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2103,6 +2105,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             mcp_tools_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.interface.screenshotBase64();
@@ -2142,7 +2145,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2154,7 +2157,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.9.7";
+    const currentVersion = "1.9.8-beta-20260618091332.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -734,7 +734,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.7");
+        console.log("[HealthCheck] @midscene/computer v1.9.8-beta-20260618091332.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1915,6 +1915,7 @@ async function agentForRDPComputer(opts) {
     return new ComputerAgent(device, opts);
 }
 const core_namespaceObject = require("@midscene/core");
+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, {
@@ -1946,7 +1947,8 @@ const computerInitArgShape = {
     ignoreCertificate: core_namespaceObject.z.boolean().optional().describe('Skip TLS certificate validation. Requires host.'),
     securityProtocol: core_namespaceObject.z["enum"](RDP_SECURITY_PROTOCOLS).optional().describe('RDP security protocol negotiation (default auto). Requires host.'),
     desktopWidth: core_namespaceObject.z.number().optional().describe('Remote desktop width in pixels. Requires host.'),
-    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.')
+    desktopHeight: core_namespaceObject.z.number().optional().describe('Remote desktop height in pixels. Requires host.'),
+    ...agent_behavior_init_args_namespaceObject.agentBehaviorInitArgShape
 };
 function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
@@ -1962,14 +1964,10 @@ function adaptComputerInitArgs(extracted) {
     return {
         mode: 'local',
         displayId: extracted.displayId,
-        headless: extracted.headless
+        headless: extracted.headless,
+        ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(extracted) ?? {}
     };
 }
-function shouldRetargetAgent(opts) {
-    if (!opts) return false;
-    if ('rdp' === opts.mode) return true;
-    return void 0 !== opts.displayId || void 0 !== opts.headless;
-}
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
         const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
@@ -1992,7 +1990,8 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = (0, agent_behavior_init_args_namespaceObject.getAgentInitArgsSignature)(opts);
+        if (this.agent && (0, agent_behavior_init_args_namespaceObject.shouldRebuildAgentForInitArgs)(this.lastInitArgsSignature, nextSignature)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -2010,6 +2009,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -2022,10 +2022,12 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             ...void 0 !== headless ? {
                 headless
             } : {},
+            ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(opts) ?? {},
             ...reportOptions ?? {}
         };
         const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
+        this.lastInitArgsSignature = nextSignature;
         return agent;
     }
     preparePlatformTools() {
@@ -2046,6 +2048,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                             mcp_tools_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.interface.screenshotBase64();
@@ -2085,7 +2088,7 @@ class ComputerMidsceneTools 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: 'computer',
             shape: computerInitArgShape,
             cli: {
@@ -2102,7 +2105,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.7",
+            version: "1.9.8-beta-20260618091332.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 import { AbstractInterface } from '@midscene/core/device';
 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 { ChildProcessWithoutNullStreams } from 'node:child_process';
@@ -161,13 +162,14 @@ export declare type ComputerInterface = ComputerDevice | RDPDevice;
 /** Init args for the local desktop agent (macOS/Windows/Linux). */
 declare type ComputerLocalInitArgs = {
     mode: 'local';
-} & Pick<ComputerDeviceOpt, 'displayId' | 'headless'>;
+} & Pick<ComputerDeviceOpt, 'displayId' | 'headless'> & AgentBehaviorInitArgs;
 
 /**
  * Computer-specific tools manager
  * Extends BaseMidsceneTools to provide desktop automation tools
  */
 export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, ComputerInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
     protected readonly initArgSpec: InitArgSpec<ComputerInitArgs>;
     protected createTemporaryDevice(): ComputerDevice;
@@ -181,7 +183,7 @@ export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAge
 /** Init args for the RDP remote-desktop agent. */
 declare type ComputerRDPInitArgs = {
     mode: 'rdp';
-} & RDPConnectionConfig;
+} & RDPConnectionConfig & AgentBehaviorInitArgs;
 
 export declare function createDefaultRDPBackendClient(): RDPBackendClient;
 

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

@@ -1,5 +1,6 @@
 import { AbstractInterface } from '@midscene/core/device';
 import { Agent } from '@midscene/core/agent';
+import { AgentBehaviorInitArgs } from '@midscene/shared/mcp/agent-behavior-init-args';
 import { BaseMCPServer } from '@midscene/shared/mcp';
 import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
 import { ComputerInputPrimitives } from '@midscene/core/device';
@@ -113,7 +114,7 @@ declare type ComputerInterface = ComputerDevice | RDPDevice;
 /** Init args for the local desktop agent (macOS/Windows/Linux). */
 declare type ComputerLocalInitArgs = {
     mode: 'local';
-} & Pick<ComputerDeviceOpt, 'displayId' | 'headless'>;
+} & Pick<ComputerDeviceOpt, 'displayId' | 'headless'> & AgentBehaviorInitArgs;
 
 /**
  * Computer MCP Server
@@ -129,6 +130,7 @@ export declare class ComputerMCPServer extends BaseMCPServer {
  * Extends BaseMidsceneTools to provide desktop automation tools
  */
 declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, ComputerInitArgs> {
+    private lastInitArgsSignature?;
     protected getCliReportSessionName(): string;
     protected readonly initArgSpec: InitArgSpec<ComputerInitArgs>;
     protected createTemporaryDevice(): ComputerDevice;
@@ -142,7 +144,7 @@ declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, Com
 /** Init args for the RDP remote-desktop agent. */
 declare type ComputerRDPInitArgs = {
     mode: 'rdp';
-} & RDPConnectionConfig;
+} & RDPConnectionConfig & AgentBehaviorInitArgs;
 
 declare interface DisplayInfo {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618091332.0",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "@computer-use/libnut": "^4.2.0",
     "clipboardy": "^4.0.0",
     "screenshot-desktop": "^1.15.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": {
     "node-mac-permissions": "2.5.0"