@midscene/harmony 1.5.3 → 1.5.4-beta-20260310030546.0

package/dist/es/index.mjs

@@ -9,6 +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 { overrideAIConfig } from "@midscene/shared/env";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -875,4 +876,58 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(device, opts);
 }
-export { HarmonyAgent, HarmonyDevice, agentFromHdcDevice, getConnectedDevices, overrideAIConfig };
+const debug = getDebug('mcp:harmony-tools');
+class HarmonyMidsceneTools extends BaseMidsceneTools {
+    createTemporaryDevice() {
+        return new HarmonyDevice('temp-for-action-space', {});
+    }
+    async ensureAgent(deviceId) {
+        if (this.agent && deviceId) {
+            try {
+                await this.agent.destroy?.();
+            } catch (error) {
+                debug('Failed to destroy agent during cleanup:', error);
+            }
+            this.agent = void 0;
+        }
+        if (this.agent) return this.agent;
+        debug('Creating Harmony agent with deviceId:', deviceId || 'auto-detect');
+        const agent = await agentFromHdcDevice(deviceId, {
+            autoDismissKeyboard: false
+        });
+        this.agent = agent;
+        return agent;
+    }
+    preparePlatformTools() {
+        return [
+            {
+                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 })=>{
+                    const agent = await this.ensureAgent(deviceId);
+                    const screenshot = await agent.page.screenshotBase64();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Connected to HarmonyOS device${deviceId ? `: ${deviceId}` : ' (auto-detected)'}`
+                            },
+                            ...this.buildScreenshotContent(screenshot)
+                        ],
+                        isError: false
+                    };
+                }
+            },
+            {
+                name: 'harmony_disconnect',
+                description: 'Disconnect from current HarmonyOS device and release HDC resources',
+                schema: {},
+                handler: this.createDisconnectHandler('HarmonyOS device')
+            }
+        ];
+    }
+}
+export { HarmonyAgent, HarmonyDevice, HarmonyMidsceneTools, agentFromHdcDevice, getConnectedDevices, overrideAIConfig };

package/dist/lib/index.js

@@ -34,6 +34,7 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     overrideAIConfig: ()=>env_namespaceObject.overrideAIConfig,
+    HarmonyMidsceneTools: ()=>HarmonyMidsceneTools,
     agentFromHdcDevice: ()=>agentFromHdcDevice,
     HarmonyAgent: ()=>HarmonyAgent,
     HarmonyDevice: ()=>HarmonyDevice,
@@ -917,15 +918,72 @@ async function agentFromHdcDevice(deviceId, opts) {
     await device.connect();
     return new HarmonyAgent(device, opts);
 }
+const mcp_namespaceObject = require("@midscene/shared/mcp");
+const debug = (0, logger_namespaceObject.getDebug)('mcp:harmony-tools');
+class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+    createTemporaryDevice() {
+        return new HarmonyDevice('temp-for-action-space', {});
+    }
+    async ensureAgent(deviceId) {
+        if (this.agent && deviceId) {
+            try {
+                await this.agent.destroy?.();
+            } catch (error) {
+                debug('Failed to destroy agent during cleanup:', error);
+            }
+            this.agent = void 0;
+        }
+        if (this.agent) return this.agent;
+        debug('Creating Harmony agent with deviceId:', deviceId || 'auto-detect');
+        const agent = await agentFromHdcDevice(deviceId, {
+            autoDismissKeyboard: false
+        });
+        this.agent = agent;
+        return agent;
+    }
+    preparePlatformTools() {
+        return [
+            {
+                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 })=>{
+                    const agent = await this.ensureAgent(deviceId);
+                    const screenshot = await agent.page.screenshotBase64();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Connected to HarmonyOS device${deviceId ? `: ${deviceId}` : ' (auto-detected)'}`
+                            },
+                            ...this.buildScreenshotContent(screenshot)
+                        ],
+                        isError: false
+                    };
+                }
+            },
+            {
+                name: 'harmony_disconnect',
+                description: 'Disconnect from current HarmonyOS device and release HDC resources',
+                schema: {},
+                handler: this.createDisconnectHandler('HarmonyOS device')
+            }
+        ];
+    }
+}
 const env_namespaceObject = require("@midscene/shared/env");
 exports.HarmonyAgent = __webpack_exports__.HarmonyAgent;
 exports.HarmonyDevice = __webpack_exports__.HarmonyDevice;
+exports.HarmonyMidsceneTools = __webpack_exports__.HarmonyMidsceneTools;
 exports.agentFromHdcDevice = __webpack_exports__.agentFromHdcDevice;
 exports.getConnectedDevices = __webpack_exports__.getConnectedDevices;
 exports.overrideAIConfig = __webpack_exports__.overrideAIConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "HarmonyAgent",
     "HarmonyDevice",
+    "HarmonyMidsceneTools",
     "agentFromHdcDevice",
     "getConnectedDevices",
     "overrideAIConfig"

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ 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 { DeviceAction } from '@midscene/core';
 import type { ElementInfo } from '@midscene/shared/extractor';
 import { HarmonyDeviceOpt } from '@midscene/core/device';
@@ -11,6 +12,7 @@ import { LocateResultElement } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
+import { ToolDefinition } from '@midscene/shared/mcp';
 
 declare type ActionArgs<T extends DeviceAction> = [ActionParam<T>] extends [undefined] ? [] : [ActionParam<T>];
 
@@ -101,6 +103,12 @@ declare interface HarmonyDeviceInfo {
     deviceId: string;
 }
 
+export declare class HarmonyMidsceneTools extends BaseMidsceneTools<HarmonyAgent> {
+    protected createTemporaryDevice(): HarmonyDevice;
+    protected ensureAgent(deviceId?: string): Promise<HarmonyAgent>;
+    protected preparePlatformTools(): ToolDefinition[];
+}
+
 declare class HdcClient {
     private hdcPath;
     private deviceId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/harmony",
-  "version": "1.5.3",
+  "version": "1.5.4-beta-20260310030546.0",
   "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/playground": "1.5.3",
-    "@midscene/core": "1.5.3",
-    "@midscene/shared": "1.5.3"
+    "@midscene/core": "1.5.4-beta-20260310030546.0",
+    "@midscene/shared": "1.5.4-beta-20260310030546.0",
+    "@midscene/playground": "1.5.4-beta-20260310030546.0"
   },
   "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/148.23cd9828.js"></script><script defer src="/static/js/index.3509da03.js"></script><link href="/static/css/index.b190a147.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/148.23cd9828.js"></script><script defer src="/static/js/index.5dd18cad.js"></script><link href="/static/css/index.b190a147.css" rel="stylesheet"></head><body><div id="root"></div></body></html>