@midscene/harmony 1.7.5-beta-20260421030751.0 → 1.7.5

package/dist/es/cli.mjs

@@ -1,7 +1,7 @@
 import { createReportCliCommands, getMidsceneLocationSchema, z } from "@midscene/core";
-import { CLIError, runToolsCLI } from "@midscene/shared/cli";
+import { reportCLIError, 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 { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
 import node_assert from "node:assert";
@@ -933,6 +933,16 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -960,10 +970,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -986,13 +996,24 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.7.5-beta-20260421030751.0",
+    version: "1.7.5",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
-    if (!(e instanceof CLIError)) console.error(e);
-    process.exit(e instanceof CLIError ? e.exitCode : 1);
+    process.exit(reportCLIError(e));
 });

package/dist/es/index.mjs

@@ -9,7 +9,7 @@ import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { Agent } from "@midscene/core/agent";
-import { BaseMidsceneTools } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { overrideAIConfig } from "@midscene/shared/env";
 import node_path from "node:path";
 import { select as prompts_select } from "@inquirer/prompts";
@@ -938,6 +938,16 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -965,10 +975,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -991,6 +1001,18 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 async function selectDevice() {
     console.log('🔍 Scanning for HarmonyOS devices...');

package/dist/es/mcp-server.mjs

@@ -1,6 +1,7 @@
-import { BaseMCPServer, BaseMidsceneTools, createMCPServerLauncher } from "@midscene/shared/mcp";
+import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
 import { getDebug } from "@midscene/shared/logger";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
 import node_assert from "node:assert";
@@ -932,6 +933,16 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
 class HarmonyMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -959,10 +970,10 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -985,6 +996,18 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 class HarmonyMCPServer extends BaseMCPServer {
     createToolsManager() {
@@ -993,7 +1016,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.7.5-beta-20260421030751.0",
+            version: "1.7.5",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -24,7 +24,7 @@ var __webpack_exports__ = {};
 const core_namespaceObject = require("@midscene/core");
 const cli_namespaceObject = require("@midscene/shared/cli");
 const logger_namespaceObject = require("@midscene/shared/logger");
-const mcp_namespaceObject = require("@midscene/shared/mcp");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const utils_namespaceObject = require("@midscene/shared/utils");
 const defaultAppNameMapping = {
@@ -958,8 +958,18 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
-class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
@@ -985,10 +995,10 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -1011,15 +1021,26 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.7.5-beta-20260421030751.0",
+    version: "1.7.5",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
-    if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);
-    process.exit(e instanceof cli_namespaceObject.CLIError ? e.exitCode : 1);
+    process.exit((0, cli_namespaceObject.reportCLIError)(e));
 });
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/index.js

@@ -976,9 +976,19 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
-class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
@@ -1004,10 +1014,10 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -1030,6 +1040,18 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 const env_namespaceObject = require("@midscene/shared/env");
 const external_node_path_namespaceObject = require("node:path");

package/dist/lib/mcp-server.js

@@ -40,6 +40,7 @@ __webpack_require__.d(__webpack_exports__, {
 const mcp_namespaceObject = require("@midscene/shared/mcp");
 const core_namespaceObject = require("@midscene/core");
 const logger_namespaceObject = require("@midscene/shared/logger");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const agent_namespaceObject = require("@midscene/core/agent");
 const utils_namespaceObject = require("@midscene/shared/utils");
 const defaultAppNameMapping = {
@@ -973,8 +974,18 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(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:harmony-tools');
-class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new HarmonyDevice('temp-for-action-space', {});
     }
@@ -1000,10 +1011,10 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             {
                 name: 'harmony_connect',
                 description: 'Connect to HarmonyOS device via HDC. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -1026,6 +1037,18 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'harmony',
+            shape: {
+                deviceId: core_namespaceObject.z.string().optional().describe('HarmonyOS device ID (from hdc list targets)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 class HarmonyMCPServer extends mcp_namespaceObject.BaseMCPServer {
     createToolsManager() {
@@ -1034,7 +1057,7 @@ class HarmonyMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.7.5-beta-20260421030751.0",
+            version: "1.7.5",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -3,17 +3,18 @@ import type { ActionParam } from '@midscene/core';
 import type { ActionReturn } from '@midscene/core';
 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 type { ElementInfo } from '@midscene/shared/extractor';
 import { HarmonyDeviceOpt } from '@midscene/core/device';
+import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
 import { InterfaceType } from '@midscene/core';
 import { LocateResultElement } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { PlaygroundPlatformDescriptor } from '@midscene/playground';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
-import { ToolDefinition } from '@midscene/shared/mcp';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 
 declare type ActionArgs<T extends DeviceAction> = [ActionParam<T>] extends [undefined] ? [] : [ActionParam<T>];
 
@@ -111,7 +112,8 @@ declare interface HarmonyDeviceInfo {
     deviceId: string;
 }
 
-export declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent> {
+export declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, string> {
+    protected readonly initArgSpec: InitArgSpec<string>;
     protected createTemporaryDevice(): HarmonyDevice;
     protected ensureAgent(deviceId?: string): Promise<HarmonyAgent>;
     protected preparePlatformTools(): ToolDefinition[];

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

@@ -4,10 +4,11 @@ import type { ActionReturn } from '@midscene/core';
 import { Agent } from '@midscene/core/agent';
 import { AgentOpt } 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 type { ElementInfo } from '@midscene/shared/extractor';
 import { HarmonyDeviceOpt } from '@midscene/core/device';
+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';
@@ -15,7 +16,7 @@ import { LocateResultElement } from '@midscene/core';
 import { Point } from '@midscene/core';
 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 type ActionArgs<T extends DeviceAction> = [ActionParam<T>] extends [undefined] ? [] : [ActionParam<T>];
 
@@ -110,7 +111,8 @@ export declare class HarmonyMCPServer extends BaseMCPServer {
     protected createToolsManager(): HarmonyMidsceneTools;
 }
 
-declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent> {
+declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent, string> {
+    protected readonly initArgSpec: InitArgSpec<string>;
     protected createTemporaryDevice(): HarmonyDevice;
     protected ensureAgent(deviceId?: string): Promise<HarmonyAgent>;
     protected preparePlatformTools(): ToolDefinition[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/harmony",
-  "version": "1.7.5-beta-20260421030751.0",
+  "version": "1.7.5",
   "description": "HarmonyOS automation library for Midscene",
   "keywords": [
     "HarmonyOS UI automation",
@@ -41,9 +41,9 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/core": "1.7.5-beta-20260421030751.0",
-    "@midscene/playground": "1.7.5-beta-20260421030751.0",
-    "@midscene/shared": "1.7.5-beta-20260421030751.0"
+    "@midscene/playground": "1.7.5",
+    "@midscene/core": "1.7.5",
+    "@midscene/shared": "1.7.5"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/263.25db3a75.js"></script><script defer src="/static/js/index.b24f9a87.js"></script><link href="/static/css/index.1946f9fa.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/883.516361ae.js"></script><script defer src="/static/js/index.3bea1f00.js"></script><link href="/static/css/index.dc500f18.css" rel="stylesheet"></head><body><div id="root"></div></body></html>