@midscene/harmony 1.6.3-beta-20260403070857.0 → 1.6.3

package/dist/es/bin.mjs

@@ -37,7 +37,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -196,7 +197,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -476,6 +478,21 @@ class device_HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -783,6 +800,9 @@ const runHdcShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: defineAction({
             name: 'RunHdcShell',
@@ -811,6 +831,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -870,6 +900,12 @@ class HarmonyAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({

package/dist/es/cli.mjs

@@ -1,5 +1,5 @@
+import { createReportCliCommands, getMidsceneLocationSchema, z } from "@midscene/core";
 import { CLIError, runToolsCLI } from "@midscene/shared/cli";
-import { getMidsceneLocationSchema, z } from "@midscene/core";
 import { getDebug } from "@midscene/shared/logger";
 import { BaseMidsceneTools } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
@@ -34,7 +34,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -193,7 +194,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -473,6 +475,21 @@ class HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -780,6 +797,9 @@ const runHdcShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: defineAction({
             name: 'RunHdcShell',
@@ -808,6 +828,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -867,6 +897,12 @@ class HarmonyAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({
@@ -954,7 +990,8 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.6.3-beta-20260403070857.0"
+    version: "1.6.3",
+    extraCommands: createReportCliCommands()
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);
     process.exit(e instanceof CLIError ? e.exitCode : 1);

package/dist/es/index.mjs

@@ -165,7 +165,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -445,6 +446,21 @@ class HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -752,6 +768,9 @@ const runHdcShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: defineAction({
             name: 'RunHdcShell',
@@ -780,6 +799,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -825,7 +854,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -872,6 +902,12 @@ class HarmonyAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({

package/dist/es/mcp-server.mjs

@@ -33,7 +33,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -192,7 +193,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -472,6 +474,21 @@ class HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -779,6 +796,9 @@ const runHdcShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: defineAction({
             name: 'RunHdcShell',
@@ -807,6 +827,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: defineAction({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -866,6 +896,12 @@ class HarmonyAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({
@@ -957,7 +993,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.6.3-beta-20260403070857.0",
+            version: "1.6.3",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -53,7 +53,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -222,7 +223,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -502,6 +504,21 @@ class device_HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -809,6 +826,9 @@ const runHdcShellParamSchema = core_namespaceObject.z.object({
 const launchParamSchema = core_namespaceObject.z.object({
     uri: core_namespaceObject.z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = core_namespaceObject.z.object({
+    uri: core_namespaceObject.z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: (0, device_namespaceObject.defineAction)({
             name: 'RunHdcShell',
@@ -837,6 +857,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: (0, device_namespaceObject.defineAction)({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -896,6 +926,12 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({

package/dist/lib/cli.js

@@ -21,8 +21,8 @@ var __webpack_require__ = {};
     __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
 })();
 var __webpack_exports__ = {};
-const cli_namespaceObject = require("@midscene/shared/cli");
 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 agent_namespaceObject = require("@midscene/core/agent");
@@ -50,7 +50,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -218,7 +219,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -498,6 +500,21 @@ class HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -805,6 +822,9 @@ const runHdcShellParamSchema = core_namespaceObject.z.object({
 const launchParamSchema = core_namespaceObject.z.object({
     uri: core_namespaceObject.z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = core_namespaceObject.z.object({
+    uri: core_namespaceObject.z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: (0, device_namespaceObject.defineAction)({
             name: 'RunHdcShell',
@@ -833,6 +853,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: (0, device_namespaceObject.defineAction)({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -892,6 +922,12 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({
@@ -979,7 +1015,8 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.6.3-beta-20260403070857.0"
+    version: "1.6.3",
+    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);

package/dist/lib/index.js

@@ -202,7 +202,8 @@ class HdcClient {
         return names.find((n)=>n !== bundleName && n.endsWith('Ability') && !n.includes('Extension') && !n.includes('Service') && !n.includes('Form') && !n.includes('Dialog'));
     }
     async forceStop(bundleName) {
-        await this.shell(`aa force-stop ${bundleName}`);
+        const output = await this.shell(`aa force-stop ${bundleName}`);
+        if (output.includes('error:')) throw new Error(`Failed to force stop ${bundleName}: ${output.trim()}`);
     }
     async getScreenInfo() {
         const stdout = await this.shell('hidumper -s RenderService -a screen');
@@ -482,6 +483,21 @@ class HarmonyDevice {
         }
         return this;
     }
+    async terminate(uri) {
+        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const hdc = await this.getHdc();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await hdc.forceStop(resolved);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async getScreenSize() {
         if (this.cachedScreenSize) return this.cachedScreenSize;
         const hdc = await this.getHdc();
@@ -789,6 +805,9 @@ const runHdcShellParamSchema = core_namespaceObject.z.object({
 const launchParamSchema = core_namespaceObject.z.object({
     uri: core_namespaceObject.z.string().describe('App name, bundle name, or URL to launch. Prioritize using the exact bundle name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = core_namespaceObject.z.object({
+    uri: core_namespaceObject.z.string().describe('Bundle name or app name to terminate. Prioritize using the exact bundle name the user provided. If the bundle is unknown, use the accurate app name shown on screen, such as Settings or Music.')
+});
 const createPlatformActions = (device)=>({
         RunHdcShell: (0, device_namespaceObject.defineAction)({
             name: 'RunHdcShell',
@@ -817,6 +836,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: (0, device_namespaceObject.defineAction)({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) a HarmonyOS app by bundle name or mapped app name',
+            interfaceAlias: 'terminate',
+            paramSchema: terminateParamSchema,
+            call: async (param)=>{
+                if (!param.uri || '' === param.uri.trim()) throw new Error('Terminate requires a non-empty uri parameter');
+                await device.terminate(param.uri);
+            }
+        }),
         HarmonyBackButton: (0, device_namespaceObject.defineAction)({
             name: 'HarmonyBackButton',
             description: 'Trigger the system "back" operation on HarmonyOS devices',
@@ -863,7 +892,8 @@ const defaultAppNameMapping = {
     Browser: 'com.huawei.hmos.browser',
     应用市场: 'com.huawei.appmarket',
     AppGallery: 'com.huawei.appmarket',
-    华为音乐: 'com.huawei.hmos.music',
+    华为音乐: 'com.huawei.hmsapp.music',
+    Music: 'com.huawei.hmsapp.music',
     华为视频: 'com.huawei.hmos.video',
     天气: 'com.huawei.hmos.weather',
     Weather: 'com.huawei.hmos.weather',
@@ -910,6 +940,12 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runHdcShell(command) {
         const action = this.wrapActionInActionSpace('RunHdcShell');
         return action({