@midscene/computer 1.9.7 → 1.9.8-beta-20260618014851.0

package/dist/es/cli.mjs

@@ -1,7 +1,8 @@
 import { createReportCliCommands, z } from "@midscene/core";
 import { reportCLIError, runToolsCLI } from "@midscene/shared/cli";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
+import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { getDebug } from "@midscene/shared/logger";
-import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
 import { chmodSync, existsSync, statSync } from "node:fs";
@@ -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-20260618014851.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1873,7 +1874,7 @@ async function agentForRDPComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1883,7 +1884,7 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const mcp_tools_debug = getDebug('mcp:computer-tools');
+const agent_tools_debug = getDebug('agent-tools:computer');
 const RDP_SECURITY_PROTOCOLS = [
     'auto',
     'tls',
@@ -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,29 +1947,31 @@ 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) {
-                mcp_tools_debug('Failed to destroy agent during cleanup:', error);
+                agent_tools_debug('Failed to destroy agent during cleanup:', error);
             }
             this.agent = void 0;
         }
         if (this.agent) return this.agent;
         const reportOptions = this.readCliReportAgentOptions();
         if (opts?.mode === 'rdp') {
-            mcp_tools_debug('Creating RDP Computer agent for host:', opts.host);
+            agent_tools_debug('Creating RDP Computer agent for host:', opts.host);
             const { mode: _mode, ...rdpFields } = opts;
             const agent = await agentForRDPComputer({
                 ...rdpFields,
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
         const headless = opts?.mode === 'local' ? opts.headless : void 0;
-        mcp_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
+        agent_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
         const agentOpts = {
             ...displayId ? {
                 displayId
@@ -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() {
@@ -2000,9 +2002,10 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                         try {
                             await this.agent.destroy?.();
                         } catch (error) {
-                            mcp_tools_debug('Failed to destroy agent during connect:', error);
+                            agent_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), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_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-20260618014851.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -13,7 +13,8 @@ import { Agent } from "@midscene/core/agent";
 import { once } from "node:events";
 import { createInterface } from "node:readline";
 import { z } from "@midscene/core";
-import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
+import { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
+import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { overrideAIConfig } from "@midscene/shared/env";
 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-20260618014851.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1916,7 +1917,7 @@ async function agentForRDPComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1926,7 +1927,7 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const mcp_tools_debug = getDebug('mcp:computer-tools');
+const agent_tools_debug = getDebug('agent-tools:computer');
 const RDP_SECURITY_PROTOCOLS = [
     'auto',
     'tls',
@@ -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,29 +1990,31 @@ 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) {
-                mcp_tools_debug('Failed to destroy agent during cleanup:', error);
+                agent_tools_debug('Failed to destroy agent during cleanup:', error);
             }
             this.agent = void 0;
         }
         if (this.agent) return this.agent;
         const reportOptions = this.readCliReportAgentOptions();
         if (opts?.mode === 'rdp') {
-            mcp_tools_debug('Creating RDP Computer agent for host:', opts.host);
+            agent_tools_debug('Creating RDP Computer agent for host:', opts.host);
             const { mode: _mode, ...rdpFields } = opts;
             const agent = await agentForRDPComputer({
                 ...rdpFields,
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
         const headless = opts?.mode === 'local' ? opts.headless : void 0;
-        mcp_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
+        agent_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
         const agentOpts = {
             ...displayId ? {
                 displayId
@@ -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() {
@@ -2043,9 +2045,10 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                         try {
                             await this.agent.destroy?.();
                         } catch (error) {
-                            mcp_tools_debug('Failed to destroy agent during connect:', error);
+                            agent_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), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_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-20260618014851.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/cli.js

@@ -26,8 +26,9 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 const core_namespaceObject = require("@midscene/core");
 const cli_namespaceObject = require("@midscene/shared/cli");
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/agent-tools/agent-behavior-init-args");
+const base_tools_namespaceObject = require("@midscene/shared/agent-tools/base-tools");
 const logger_namespaceObject = require("@midscene/shared/logger");
-const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const external_node_child_process_namespaceObject = require("node:child_process");
 const external_node_fs_namespaceObject = require("node:fs");
@@ -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-20260618014851.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1900,7 +1901,7 @@ async function agentForRDPComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
-function mcp_tools_define_property(obj, key, value) {
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1910,7 +1911,7 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const mcp_tools_debug = (0, logger_namespaceObject.getDebug)('mcp:computer-tools');
+const agent_tools_debug = (0, logger_namespaceObject.getDebug)('agent-tools:computer');
 const RDP_SECURITY_PROTOCOLS = [
     'auto',
     'tls',
@@ -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,29 +1974,31 @@ 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) {
-                mcp_tools_debug('Failed to destroy agent during cleanup:', error);
+                agent_tools_debug('Failed to destroy agent during cleanup:', error);
             }
             this.agent = void 0;
         }
         if (this.agent) return this.agent;
         const reportOptions = this.readCliReportAgentOptions();
         if (opts?.mode === 'rdp') {
-            mcp_tools_debug('Creating RDP Computer agent for host:', opts.host);
+            agent_tools_debug('Creating RDP Computer agent for host:', opts.host);
             const { mode: _mode, ...rdpFields } = opts;
             const agent = await agentForRDPComputer({
                 ...rdpFields,
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
         const headless = opts?.mode === 'local' ? opts.headless : void 0;
-        mcp_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
+        agent_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
         const agentOpts = {
             ...displayId ? {
                 displayId
@@ -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() {
@@ -2027,9 +2029,10 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                         try {
                             await this.agent.destroy?.();
                         } catch (error) {
-                            mcp_tools_debug('Failed to destroy agent during connect:', error);
+                            agent_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), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_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-20260618014851.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-20260618014851.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1972,8 +1972,9 @@ async function agentForRDPComputer(opts) {
     return new ComputerAgent(device, opts);
 }
 const core_namespaceObject = require("@midscene/core");
-const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
-function mcp_tools_define_property(obj, key, value) {
+const agent_behavior_init_args_namespaceObject = require("@midscene/shared/agent-tools/agent-behavior-init-args");
+const base_tools_namespaceObject = require("@midscene/shared/agent-tools/base-tools");
+function agent_tools_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -1983,7 +1984,7 @@ function mcp_tools_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const mcp_tools_debug = (0, logger_namespaceObject.getDebug)('mcp:computer-tools');
+const agent_tools_debug = (0, logger_namespaceObject.getDebug)('agent-tools:computer');
 const RDP_SECURITY_PROTOCOLS = [
     'auto',
     'tls',
@@ -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,29 +2047,31 @@ 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) {
-                mcp_tools_debug('Failed to destroy agent during cleanup:', error);
+                agent_tools_debug('Failed to destroy agent during cleanup:', error);
             }
             this.agent = void 0;
         }
         if (this.agent) return this.agent;
         const reportOptions = this.readCliReportAgentOptions();
         if (opts?.mode === 'rdp') {
-            mcp_tools_debug('Creating RDP Computer agent for host:', opts.host);
+            agent_tools_debug('Creating RDP Computer agent for host:', opts.host);
             const { mode: _mode, ...rdpFields } = opts;
             const agent = await agentForRDPComputer({
                 ...rdpFields,
                 ...reportOptions ?? {}
             });
             this.agent = agent;
+            this.lastInitArgsSignature = nextSignature;
             return agent;
         }
         const displayId = opts?.mode === 'local' ? opts.displayId : void 0;
         const headless = opts?.mode === 'local' ? opts.headless : void 0;
-        mcp_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
+        agent_tools_debug('Creating Computer agent with displayId:', displayId || 'primary');
         const agentOpts = {
             ...displayId ? {
                 displayId
@@ -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() {
@@ -2100,9 +2102,10 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
                         try {
                             await this.agent.destroy?.();
                         } catch (error) {
-                            mcp_tools_debug('Failed to destroy agent during connect:', error);
+                            agent_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), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_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-20260618014851.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/types/index.d.ts

@@ -1,16 +1,17 @@
 import { AbstractInterface } from '@midscene/core/device';
 import { Agent } from '@midscene/core/agent';
+import { AgentBehaviorInitArgs } from '@midscene/shared/agent-tools/agent-behavior-init-args';
 import { AgentOpt } from '@midscene/core/agent';
-import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
+import { BaseMidsceneTools } from '@midscene/shared/agent-tools/base-tools';
 import { ChildProcessWithoutNullStreams } from 'node:child_process';
 import { ComputerInputPrimitives } from '@midscene/core/device';
 import type { DeviceAction } from '@midscene/core';
-import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
+import { InitArgSpec } from '@midscene/shared/agent-tools/base-tools';
 import type { InterfaceType } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import type { Size } from '@midscene/core';
 import { SpawnOptionsWithoutStdio } from 'node:child_process';
-import type { ToolDefinition } from '@midscene/shared/mcp/types';
+import type { ToolDefinition } from '@midscene/shared/agent-tools/types';
 
 declare interface AccessibilityCheckResult {
     hasPermission: boolean;
@@ -152,7 +153,7 @@ export declare interface ComputerDeviceOpt {
 /**
  * Discriminated union describing the two ways `computer_*` tools can spawn an
  * agent. `mode` is filled in by `initArgSpec.adapt` based on whether `host` is
- * set, so callers (CLI/MCP/YAML) never have to provide it explicitly.
+ * set, so callers (CLI/YAML) never have to provide it explicitly.
  */
 declare type ComputerInitArgs = ComputerLocalInitArgs | ComputerRDPInitArgs;
 
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618014851.0",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -27,19 +27,14 @@
       "import": "./dist/es/index.mjs",
       "require": "./dist/lib/index.js"
     },
-    "./mcp-server": {
-      "types": "./dist/types/mcp-server.d.ts",
-      "import": "./dist/es/mcp-server.mjs",
-      "require": "./dist/lib/mcp-server.js"
-    },
     "./package.json": "./package.json"
   },
   "dependencies": {
     "@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-20260618014851.0",
+    "@midscene/shared": "1.9.8-beta-20260618014851.0"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"