@midscene/harmony 1.10.13-beta-20260818094410.0 → 1.11.0

package/dist/es/bin.mjs

@@ -533,27 +533,31 @@ class device_HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = mergeAndNormalizeAppNameMapping({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = normalizeForComparison(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -564,16 +568,15 @@ class device_HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1050,9 +1053,9 @@ class HarmonyAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');

package/dist/es/cli.mjs

@@ -531,27 +531,31 @@ class HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = mergeAndNormalizeAppNameMapping({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = normalizeForComparison(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -562,16 +566,15 @@ class HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1048,9 +1051,9 @@ class HarmonyAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');
@@ -1178,7 +1181,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.10.13-beta-20260818094410.0",
+    version: "1.11.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -502,27 +502,31 @@ class HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = mergeAndNormalizeAppNameMapping({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = normalizeForComparison(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -533,16 +537,15 @@ class HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1053,9 +1056,9 @@ class HarmonyAgent extends Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = mergeAndNormalizeAppNameMapping(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');

package/dist/lib/bin.js

@@ -559,27 +559,31 @@ class device_HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = (0, utils_namespaceObject.normalizeForComparison)(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -590,16 +594,15 @@ class device_HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1076,9 +1079,9 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');

package/dist/lib/cli.js

@@ -556,27 +556,31 @@ class HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = (0, utils_namespaceObject.normalizeForComparison)(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -587,16 +591,15 @@ class HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1073,9 +1076,9 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = (0, utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');
@@ -1203,7 +1206,7 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.10.13-beta-20260818094410.0",
+    version: "1.11.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -538,27 +538,31 @@ class HarmonyDevice {
         return this.connecting;
     }
     setAppNameMapping(mapping) {
-        this.appNameMapping = mapping;
+        this.appNameMapping = (0, shared_utils_namespaceObject.mergeAndNormalizeAppNameMapping)({}, mapping);
     }
-    resolvePackageName(appName) {
+    resolveMappedAppTarget(appName) {
         const normalizedAppName = (0, shared_utils_namespaceObject.normalizeForComparison)(appName);
         return this.appNameMapping[normalizedAppName];
     }
+    resolveBundleNameForTerminate(target) {
+        const mappedTarget = this.resolveMappedAppTarget(target);
+        if (mappedTarget) return mappedTarget.split('/')[0];
+        const [bundleOrAppName] = target.split('/');
+        return (this.resolveMappedAppTarget(bundleOrAppName) ?? bundleOrAppName).split('/')[0];
+    }
     async launch(uri) {
         const hdc = await this.getHdc();
         this.uri = uri;
         try {
             debugDevice(`Launching app: ${uri}`);
-            if (uri.startsWith('http://') || uri.startsWith('https://') || uri.includes('://')) {
-                const sanitizedUri = uri.replace(/[`$\\;"'|&<>(){}]/g, '');
+            const target = uri.includes('://') ? uri : this.resolveMappedAppTarget(uri) ?? uri;
+            if (target.includes('://')) {
+                const sanitizedUri = target.replace(/[`$\\;"'|&<>(){}]/g, '');
                 await hdc.shell(`aa start -U ${sanitizedUri}`);
-            } else if (uri.includes('/')) {
-                const [bundleName, abilityName] = uri.split('/');
+            } else if (target.includes('/')) {
+                const [bundleName, abilityName] = target.split('/');
                 await hdc.startAbility(bundleName, abilityName);
-            } else {
-                const bundleName = this.resolvePackageName(uri) ?? uri;
-                await hdc.launchBundle(bundleName);
-            }
+            } else await hdc.launchBundle(target);
             debugDevice(`Successfully launched: ${uri}`);
         } catch (error) {
             debugDevice(`Error launching ${uri}: ${error}`);
@@ -569,16 +573,15 @@ class HarmonyDevice {
         return this;
     }
     async terminate(uri) {
-        const bundlePart = uri.includes('/') ? uri.split('/')[0] : uri;
-        const resolved = this.resolvePackageName(bundlePart) ?? bundlePart;
+        const bundleName = this.resolveBundleNameForTerminate(uri);
         const hdc = await this.getHdc();
         try {
-            debugDevice(`Terminating app: ${resolved}`);
-            await hdc.forceStop(resolved);
-            debugDevice(`Successfully terminated: ${resolved}`);
+            debugDevice(`Terminating app: ${bundleName}`);
+            await hdc.forceStop(bundleName);
+            debugDevice(`Successfully terminated: ${bundleName}`);
         } catch (error) {
-            debugDevice(`Error terminating ${resolved}: ${error}`);
-            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+            debugDevice(`Error terminating ${bundleName}: ${error}`);
+            throw new Error(`Failed to terminate ${bundleName}: ${error.message}`, {
                 cause: error
             });
         }
@@ -1090,9 +1093,9 @@ class HarmonyAgent extends agent_namespaceObject.Agent {
         return (...args)=>action(args[0]);
     }
     constructor(device, opts){
-        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0), agent_define_property(this, "appNameMapping", void 0);
-        this.appNameMapping = (0, shared_utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
-        device.setAppNameMapping(this.appNameMapping);
+        super(device, opts), agent_define_property(this, "back", void 0), agent_define_property(this, "home", void 0), agent_define_property(this, "recentApps", void 0);
+        const appNameMapping = (0, shared_utils_namespaceObject.mergeAndNormalizeAppNameMapping)(defaultAppNameMapping, opts?.appNameMapping);
+        device.setAppNameMapping(appNameMapping);
         this.back = this.createActionWrapper('HarmonyBackButton');
         this.home = this.createActionWrapper('HarmonyHomeButton');
         this.recentApps = this.createActionWrapper('HarmonyRecentAppsButton');

package/dist/types/index.d.ts

@@ -34,7 +34,6 @@ export declare class HarmonyAgent extends Agent<HarmonyDevice> {
     back: WrappedAction<DeviceActionHarmonyBackButton>;
     home: WrappedAction<DeviceActionHarmonyHomeButton>;
     recentApps: WrappedAction<DeviceActionHarmonyRecentAppsButton>;
-    private appNameMapping;
     constructor(device: HarmonyDevice, opts?: HarmonyAgentOpt);
     launch(uri: string): Promise<void>;
     terminate(uri: string): Promise<void>;
@@ -44,8 +43,9 @@ export declare class HarmonyAgent extends Agent<HarmonyDevice> {
 
 export declare type HarmonyAgentOpt = AgentOpt & {
     /**
-     * Custom mapping of app names to bundle names
-     * User-provided mappings will take precedence over default mappings
+     * Custom mapping of app names to bundle names or explicit bundle/ability
+     * targets. Bundle-only targets use bundle metadata to resolve their declared
+     * launch ability. User-provided mappings take precedence over defaults.
      */
     appNameMapping?: Record<string, string>;
 };
@@ -70,8 +70,14 @@ export declare class HarmonyDevice implements AbstractInterface {
     describe(): string;
     connect(): Promise<HdcClient>;
     getHdc(): Promise<HdcClient>;
+    /**
+     * Set app-name aliases used by launch and terminate.
+     * Keys are normalized here so callers do not need to know the internal
+     * comparison format.
+     */
     setAppNameMapping(mapping: Record<string, string>): void;
-    private resolvePackageName;
+    private resolveMappedAppTarget;
+    private resolveBundleNameForTerminate;
     launch(uri: string): Promise<HarmonyDevice>;
     /**
      * Terminate (force-stop) a HarmonyOS app by bundle name.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/harmony",
-  "version": "1.10.13-beta-20260818094410.0",
+  "version": "1.11.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -41,9 +41,9 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/playground": "1.10.13-beta-20260818094410.0",
-    "@midscene/shared": "1.10.13-beta-20260818094410.0",
-    "@midscene/core": "1.10.13-beta-20260818094410.0"
+    "@midscene/core": "1.11.0",
+    "@midscene/shared": "1.11.0",
+    "@midscene/playground": "1.11.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.8bb5dc6e.js"></script><script defer src="/static/js/226.e0976a0a.js"></script><script defer src="/static/js/index.d98790a5.js"></script><link href="/static/css/index.1e8e86da.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.8bb5dc6e.js"></script><script defer src="/static/js/226.e0976a0a.js"></script><script defer src="/static/js/index.4b0c684c.js"></script><link href="/static/css/index.1e8e86da.css" rel="stylesheet"></head><body><div id="root"></div></body></html>