@midscene/computer 1.9.5 → 1.9.6-beta-20260612050456.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 } 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";
@@ -656,7 +657,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1846,7 +1847,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;
@@ -1862,14 +1864,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);
@@ -1892,7 +1890,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1910,6 +1909,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -1922,10 +1922,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() {
@@ -1946,6 +1948,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();
@@ -1985,7 +1988,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: {
@@ -1998,7 +2001,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.5",
+    version: "1.9.6-beta-20260612050456.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 } 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) {
@@ -656,7 +657,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1889,7 +1890,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;
@@ -1905,14 +1907,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);
@@ -1935,7 +1933,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1953,6 +1952,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -1965,10 +1965,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() {
@@ -1989,6 +1991,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();
@@ -2028,7 +2031,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: {
@@ -2039,7 +2042,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.5";
+    const currentVersion = "1.9.6-beta-20260612050456.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 } 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, {
@@ -656,7 +657,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1846,7 +1847,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;
@@ -1862,14 +1864,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);
@@ -1892,7 +1890,8 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         return new ComputerDevice({});
     }
     async ensureAgent(opts) {
-        if (this.agent && shouldRetargetAgent(opts)) {
+        const nextSignature = getAgentInitArgsSignature(opts);
+        if (this.agent && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1910,6 +1909,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
@@ -1922,10 +1922,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() {
@@ -1946,6 +1948,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();
@@ -1985,7 +1988,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: {
@@ -2002,7 +2005,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.5",
+            version: "1.9.6-beta-20260612050456.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");
@@ -682,7 +683,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1873,7 +1874,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;
@@ -1889,14 +1891,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);
@@ -1919,7 +1917,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 && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1937,6 +1936,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;
@@ -1949,10 +1949,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() {
@@ -1973,6 +1975,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();
@@ -2012,7 +2015,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: {
@@ -2025,7 +2028,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 const tools = new ComputerMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.5",
+    version: "1.9.6-beta-20260612050456.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -709,7 +709,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.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 && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             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: {
@@ -2097,7 +2100,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.9.5";
+    const currentVersion = "1.9.6-beta-20260612050456.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -696,7 +696,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.5");
+        console.log("[HealthCheck] @midscene/computer v1.9.6-beta-20260612050456.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1858,6 +1858,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, {
@@ -1889,7 +1890,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;
@@ -1905,14 +1907,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);
@@ -1935,7 +1933,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 && nextSignature && nextSignature !== this.lastInitArgsSignature) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -1953,6 +1952,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;
@@ -1965,10 +1965,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() {
@@ -1989,6 +1991,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();
@@ -2028,7 +2031,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: {
@@ -2045,7 +2048,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.5",
+            version: "1.9.6-beta-20260612050456.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';
@@ -159,13 +160,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;
@@ -179,7 +181,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';
@@ -111,7 +112,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
@@ -127,6 +128,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;
@@ -140,7 +142,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.5",
+  "version": "1.9.6-beta-20260612050456.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.5",
-    "@midscene/shared": "1.9.5"
+    "@midscene/core": "1.9.6-beta-20260612050456.0",
+    "@midscene/shared": "1.9.6-beta-20260612050456.0"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"