@midscene/computer 1.7.5-beta-20260420032657.0 → 1.7.5-beta-20260420052829.0

package/dist/es/cli.mjs

@@ -1,7 +1,7 @@
 import { createReportCliCommands, getMidsceneLocationSchema, z } from "@midscene/core";
 import { CLIError, runToolsCLI } from "@midscene/shared/cli";
 import { getDebug } from "@midscene/shared/logger";
-import { BaseMidsceneTools } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import node_assert from "node:assert";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
@@ -409,7 +409,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -815,13 +815,29 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = getDebug('mcp:computer-tools');
+const computerInitArgShape = {
+    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
 class ComputerMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -831,7 +847,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -839,7 +855,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -848,18 +864,17 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -890,11 +905,21 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.7.5-beta-20260420032657.0",
+    version: "1.7.5-beta-20260420052829.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);

package/dist/es/index.mjs

@@ -11,7 +11,7 @@ import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { getDebug } from "@midscene/shared/logger";
 import screenshot_desktop from "screenshot-desktop";
 import { Agent } from "@midscene/core/agent";
-import { BaseMidsceneTools } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { overrideAIConfig } from "@midscene/shared/env";
 const debugXvfb = getDebug('computer:xvfb');
 function checkXvfbInstalled() {
@@ -409,7 +409,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -815,13 +815,29 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = getDebug('mcp:computer-tools');
+const computerInitArgShape = {
+    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
 class ComputerMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -831,7 +847,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -839,7 +855,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -848,18 +864,17 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -890,9 +905,19 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 function version() {
-    const currentVersion = "1.7.5-beta-20260420032657.0";
+    const currentVersion = "1.7.5-beta-20260420052829.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -1,4 +1,4 @@
-import { BaseMCPServer, BaseMidsceneTools, createMCPServerLauncher } from "@midscene/shared/mcp";
+import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import node_assert from "node:assert";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
@@ -12,6 +12,7 @@ import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { getDebug } from "@midscene/shared/logger";
 import screenshot_desktop from "screenshot-desktop";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 const debugXvfb = getDebug('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -408,7 +409,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -814,13 +815,29 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = getDebug('mcp:computer-tools');
+const computerInitArgShape = {
+    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
 class ComputerMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -830,7 +847,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -838,7 +855,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -847,18 +864,17 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -889,6 +905,16 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 class ComputerMCPServer extends BaseMCPServer {
     createToolsManager() {
@@ -897,7 +923,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.7.5-beta-20260420032657.0",
+            version: "1.7.5-beta-20260420052829.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -27,7 +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 mcp_namespaceObject = require("@midscene/shared/mcp");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
@@ -437,7 +437,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -843,13 +843,29 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_namespaceObject.getDebug)('mcp:computer-tools');
-class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+const computerInitArgShape = {
+    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
+class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -859,7 +875,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -867,7 +883,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -876,18 +892,17 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -918,11 +933,21 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 const tools = new ComputerMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.7.5-beta-20260420032657.0",
+    version: "1.7.5-beta-20260420052829.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);

package/dist/lib/index.js

@@ -458,7 +458,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -865,14 +865,30 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
-const mcp_namespaceObject = require("@midscene/shared/mcp");
+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, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_namespaceObject.getDebug)('mcp:computer-tools');
-class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+const computerInitArgShape = {
+    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
+class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -882,7 +898,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -890,7 +906,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -899,18 +915,17 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -941,10 +956,20 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.7.5-beta-20260420032657.0";
+    const currentVersion = "1.7.5-beta-20260420052829.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -452,7 +452,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.7.5-beta-20260420032657.0");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260420052829.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -858,13 +858,30 @@ async function agentFromComputer(opts) {
     await device.connect();
     return new ComputerAgent(device, opts);
 }
+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, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_namespaceObject.getDebug)('mcp:computer-tools');
-class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+const computerInitArgShape = {
+    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
+    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
+};
+class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new ComputerDevice({});
     }
-    async ensureAgent(displayId, headless) {
-        if (this.agent && displayId) {
+    async ensureAgent(opts) {
+        const displayId = opts?.displayId;
+        const headless = opts?.headless;
+        if (this.agent && (void 0 !== displayId || void 0 !== headless)) {
             try {
                 await this.agent.destroy?.();
             } catch (error) {
@@ -874,7 +891,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         }
         if (this.agent) return this.agent;
         debug('Creating Computer agent with displayId:', displayId || 'primary');
-        const opts = {
+        const agentOpts = {
             ...displayId ? {
                 displayId
             } : {},
@@ -882,7 +899,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
                 headless
             } : {}
         };
-        const agent = await agentFromComputer(Object.keys(opts).length > 0 ? opts : void 0);
+        const agent = await agentFromComputer(Object.keys(agentOpts).length > 0 ? agentOpts : void 0);
         this.agent = agent;
         return agent;
     }
@@ -891,18 +908,17 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'computer_connect',
                 description: 'Connect to computer desktop. Provide displayId to connect to a specific display (use computer_list_displays to get available IDs). If not provided, uses the primary display.',
-                schema: {
-                    displayId: core_namespaceObject.z.string().optional().describe('Display ID (from computer_list_displays)'),
-                    headless: core_namespaceObject.z.boolean().optional().describe('Start virtual display via Xvfb (Linux only)')
-                },
-                handler: async ({ displayId, headless })=>{
-                    const agent = await this.ensureAgent(displayId, headless);
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const initArgs = this.extractAgentInitParam(args);
+                    const agent = await this.ensureAgent(initArgs);
                     const screenshot = await agent.interface.screenshotBase64();
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Connected to computer${displayId ? ` (Display: ${displayId})` : ' (Primary display)'}`
+                                text: `Connected to computer${initArgs?.displayId ? ` (Display: ${initArgs.displayId})` : ' (Primary display)'}`
                             },
                             ...this.buildScreenshotContent(screenshot)
                         ]
@@ -933,6 +949,16 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'computer',
+            shape: computerInitArgShape,
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted
+        });
+    }
 }
 class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     createToolsManager() {
@@ -941,7 +967,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.7.5-beta-20260420032657.0",
+            version: "1.7.5-beta-20260420052829.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -1,12 +1,13 @@
 import { AbstractInterface } from '@midscene/core/device';
 import { Agent } from '@midscene/core/agent';
 import { AgentOpt } from '@midscene/core/agent';
-import { BaseMidsceneTools } from '@midscene/shared/mcp';
+import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
 import { DeviceAction } from '@midscene/core';
+import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
 import { InterfaceType } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { Size } from '@midscene/core';
-import { ToolDefinition } from '@midscene/shared/mcp';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 
 declare interface AccessibilityCheckResult {
     hasPermission: boolean;
@@ -113,13 +114,16 @@ export declare interface ComputerDeviceOpt {
     xvfbResolution?: string;
 }
 
+declare type ComputerInitArgs = Pick<ComputerDeviceOpt, 'displayId' | 'headless'>;
+
 /**
  * Computer-specific tools manager
  * Extends BaseMidsceneTools to provide desktop automation tools
  */
-export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent> {
+export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, ComputerInitArgs> {
+    protected readonly initArgSpec: InitArgSpec<ComputerInitArgs>;
     protected createTemporaryDevice(): ComputerDevice;
-    protected ensureAgent(displayId?: string, headless?: boolean): Promise<ComputerAgent>;
+    protected ensureAgent(opts?: ComputerInitArgs): Promise<ComputerAgent>;
     /**
      * Provide Computer-specific platform tools
      */

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

@@ -1,14 +1,15 @@
 import { AbstractInterface } from '@midscene/core/device';
 import { Agent } from '@midscene/core/agent';
 import { BaseMCPServer } from '@midscene/shared/mcp';
-import { BaseMidsceneTools } from '@midscene/shared/mcp';
+import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
 import { DeviceAction } from '@midscene/core';
+import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
 import { InterfaceType } from '@midscene/core';
 import { LaunchMCPServerOptions } from '@midscene/shared/mcp';
 import { LaunchMCPServerResult } from '@midscene/shared/mcp';
 import { Size } from '@midscene/core';
 import { Tool } from '@midscene/shared/mcp';
-import { ToolDefinition } from '@midscene/shared/mcp';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 
 declare class ComputerAgent extends Agent<ComputerDevice> {
 }
@@ -84,6 +85,8 @@ declare interface ComputerDeviceOpt {
     xvfbResolution?: string;
 }
 
+declare type ComputerInitArgs = Pick<ComputerDeviceOpt, 'displayId' | 'headless'>;
+
 /**
  * Computer MCP Server
  * Provides MCP tools for computer desktop automation
@@ -97,9 +100,10 @@ export declare class ComputerMCPServer extends BaseMCPServer {
  * Computer-specific tools manager
  * Extends BaseMidsceneTools to provide desktop automation tools
  */
-declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent> {
+declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, ComputerInitArgs> {
+    protected readonly initArgSpec: InitArgSpec<ComputerInitArgs>;
     protected createTemporaryDevice(): ComputerDevice;
-    protected ensureAgent(displayId?: string, headless?: boolean): Promise<ComputerAgent>;
+    protected ensureAgent(opts?: ComputerInitArgs): Promise<ComputerAgent>;
     /**
      * Provide Computer-specific platform tools
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.7.5-beta-20260420032657.0",
+  "version": "1.7.5-beta-20260420052829.0",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -36,8 +36,8 @@
     "@computer-use/libnut": "^4.2.0",
     "clipboardy": "^4.0.0",
     "screenshot-desktop": "^1.15.3",
-    "@midscene/shared": "1.7.5-beta-20260420032657.0",
-    "@midscene/core": "1.7.5-beta-20260420032657.0"
+    "@midscene/core": "1.7.5-beta-20260420052829.0",
+    "@midscene/shared": "1.7.5-beta-20260420052829.0"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"