@midscene/android 1.6.3-beta-20260402103943.0 → 1.6.3

package/dist/es/cli.mjs

@@ -2,8 +2,8 @@ import * as __rspack_external__midscene_shared_logger_b1dc2426 from "@midscene/s
 import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
 import * as __rspack_external_node_module_ab9f2194 from "node:module";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
+import { createReportCliCommands, getMidsceneLocationSchema, z } from "@midscene/core";
 import { CLIError, runToolsCLI } from "@midscene/shared/cli";
-import { getMidsceneLocationSchema, z } from "@midscene/core";
 import { BaseMidsceneTools } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
@@ -973,6 +973,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         return this;
     }
+    async terminate(uri) {
+        const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+        const adb = await this.getAdb();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await adb.shell(`am force-stop ${resolved}`);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async execYadb(keyboardContent, options) {
         await this.ensureYadb();
         const adb = await this.getAdb();
@@ -1751,6 +1766,9 @@ const runAdbShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+});
 const createPlatformActions = (device)=>({
         RunAdbShell: defineAction({
             name: 'RunAdbShell',
@@ -1779,6 +1797,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) an Android app by package 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);
+            }
+        }),
         AndroidBackButton: defineAction({
             name: 'AndroidBackButton',
             description: 'Trigger the system "back" operation on Android devices',
@@ -1835,6 +1863,12 @@ class AndroidAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runAdbShell(command) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({
@@ -1922,7 +1956,8 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.6.3-beta-20260402103943.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

@@ -876,6 +876,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         return this;
     }
+    async terminate(uri) {
+        const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+        const adb = await this.getAdb();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await adb.shell(`am force-stop ${resolved}`);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async execYadb(keyboardContent, options) {
         await this.ensureYadb();
         const adb = await this.getAdb();
@@ -1654,6 +1669,9 @@ const runAdbShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+});
 const createPlatformActions = (device)=>({
         RunAdbShell: defineAction({
             name: 'RunAdbShell',
@@ -1682,6 +1700,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) an Android app by package 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);
+            }
+        }),
         AndroidBackButton: defineAction({
             name: 'AndroidBackButton',
             description: 'Trigger the system "back" operation on Android devices',
@@ -1901,6 +1929,12 @@ class AndroidAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runAdbShell(command) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({

package/dist/es/mcp-server.mjs

@@ -972,6 +972,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         }
         return this;
     }
+    async terminate(uri) {
+        const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+        const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+        const adb = await this.getAdb();
+        try {
+            debugDevice(`Terminating app: ${resolved}`);
+            await adb.shell(`am force-stop ${resolved}`);
+            debugDevice(`Successfully terminated: ${resolved}`);
+        } catch (error) {
+            debugDevice(`Error terminating ${resolved}: ${error}`);
+            throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                cause: error
+            });
+        }
+    }
     async execYadb(keyboardContent, options) {
         await this.ensureYadb();
         const adb = await this.getAdb();
@@ -1750,6 +1765,9 @@ const runAdbShellParamSchema = z.object({
 const launchParamSchema = z.object({
     uri: z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package name or URL the user has provided. If none provided, use the accurate app name.')
 });
+const terminateParamSchema = z.object({
+    uri: z.string().describe('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+});
 const createPlatformActions = (device)=>({
         RunAdbShell: defineAction({
             name: 'RunAdbShell',
@@ -1778,6 +1796,16 @@ const createPlatformActions = (device)=>({
                 await device.launch(param.uri);
             }
         }),
+        Terminate: defineAction({
+            name: 'Terminate',
+            description: 'Terminate (force-stop) an Android app by package 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);
+            }
+        }),
         AndroidBackButton: defineAction({
             name: 'AndroidBackButton',
             description: 'Trigger the system "back" operation on Android devices',
@@ -1834,6 +1862,12 @@ class AndroidAgent extends Agent {
             uri
         });
     }
+    async terminate(uri) {
+        const action = this.wrapActionInActionSpace('Terminate');
+        return action({
+            uri
+        });
+    }
     async runAdbShell(command) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({
@@ -1925,7 +1959,7 @@ class AndroidMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/android-mcp',
-            version: "1.6.3-beta-20260402103943.0",
+            version: "1.6.3",
             description: 'Control the Android device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -446,8 +446,8 @@ function __webpack_require__(moduleId) {
 })();
 var __webpack_exports__ = {};
 (()=>{
-    const cli_namespaceObject = require("@midscene/shared/cli");
     const core_namespaceObject = require("@midscene/core");
+    const cli_namespaceObject = require("@midscene/shared/cli");
     var logger_ = __webpack_require__("@midscene/shared/logger");
     const mcp_namespaceObject = require("@midscene/shared/mcp");
     const agent_namespaceObject = require("@midscene/core/agent");
@@ -988,6 +988,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             }
             return this;
         }
+        async terminate(uri) {
+            const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+            const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+            const adb = await this.getAdb();
+            try {
+                debugDevice(`Terminating app: ${resolved}`);
+                await adb.shell(`am force-stop ${resolved}`);
+                debugDevice(`Successfully terminated: ${resolved}`);
+            } catch (error) {
+                debugDevice(`Error terminating ${resolved}: ${error}`);
+                throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                    cause: error
+                });
+            }
+        }
         async execYadb(keyboardContent, options) {
             await this.ensureYadb();
             const adb = await this.getAdb();
@@ -1766,6 +1781,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     const launchParamSchema = core_namespaceObject.z.object({
         uri: core_namespaceObject.z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package 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('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+    });
     const createPlatformActions = (device)=>({
             RunAdbShell: (0, device_namespaceObject.defineAction)({
                 name: 'RunAdbShell',
@@ -1794,6 +1812,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                     await device.launch(param.uri);
                 }
             }),
+            Terminate: (0, device_namespaceObject.defineAction)({
+                name: 'Terminate',
+                description: 'Terminate (force-stop) an Android app by package 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);
+                }
+            }),
             AndroidBackButton: (0, device_namespaceObject.defineAction)({
                 name: 'AndroidBackButton',
                 description: 'Trigger the system "back" operation on Android devices',
@@ -1850,6 +1878,12 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
+        async terminate(uri) {
+            const action = this.wrapActionInActionSpace('Terminate');
+            return action({
+                uri
+            });
+        }
         async runAdbShell(command) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({
@@ -1937,7 +1971,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     const tools = new AndroidMidsceneTools();
     (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-android', {
         stripPrefix: 'android_',
-        version: "1.6.3-beta-20260402103943.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

@@ -910,6 +910,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             }
             return this;
         }
+        async terminate(uri) {
+            const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+            const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+            const adb = await this.getAdb();
+            try {
+                debugDevice(`Terminating app: ${resolved}`);
+                await adb.shell(`am force-stop ${resolved}`);
+                debugDevice(`Successfully terminated: ${resolved}`);
+            } catch (error) {
+                debugDevice(`Error terminating ${resolved}: ${error}`);
+                throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                    cause: error
+                });
+            }
+        }
         async execYadb(keyboardContent, options) {
             await this.ensureYadb();
             const adb = await this.getAdb();
@@ -1688,6 +1703,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     const launchParamSchema = core_namespaceObject.z.object({
         uri: core_namespaceObject.z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package 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('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+    });
     const createPlatformActions = (device)=>({
             RunAdbShell: (0, device_namespaceObject.defineAction)({
                 name: 'RunAdbShell',
@@ -1716,6 +1734,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                     await device.launch(param.uri);
                 }
             }),
+            Terminate: (0, device_namespaceObject.defineAction)({
+                name: 'Terminate',
+                description: 'Terminate (force-stop) an Android app by package 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);
+                }
+            }),
             AndroidBackButton: (0, device_namespaceObject.defineAction)({
                 name: 'AndroidBackButton',
                 description: 'Trigger the system "back" operation on Android devices',
@@ -1936,6 +1964,12 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
+        async terminate(uri) {
+            const action = this.wrapActionInActionSpace('Terminate');
+            return action({
+                uri
+            });
+        }
         async runAdbShell(command) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({

package/dist/lib/mcp-server.js

@@ -1003,6 +1003,21 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             }
             return this;
         }
+        async terminate(uri) {
+            const packagePart = uri.includes('/') ? uri.split('/')[0] : uri;
+            const resolved = this.resolvePackageName(packagePart) ?? packagePart;
+            const adb = await this.getAdb();
+            try {
+                debugDevice(`Terminating app: ${resolved}`);
+                await adb.shell(`am force-stop ${resolved}`);
+                debugDevice(`Successfully terminated: ${resolved}`);
+            } catch (error) {
+                debugDevice(`Error terminating ${resolved}: ${error}`);
+                throw new Error(`Failed to terminate ${resolved}: ${error.message}`, {
+                    cause: error
+                });
+            }
+        }
         async execYadb(keyboardContent, options) {
             await this.ensureYadb();
             const adb = await this.getAdb();
@@ -1781,6 +1796,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     const launchParamSchema = core_namespaceObject.z.object({
         uri: core_namespaceObject.z.string().describe('App name, package name, or URL to launch. Prioritize using the exact package 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('Package name or app name to terminate. Use the exact package name, e.g. com.android.settings.')
+    });
     const createPlatformActions = (device)=>({
             RunAdbShell: (0, device_namespaceObject.defineAction)({
                 name: 'RunAdbShell',
@@ -1809,6 +1827,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                     await device.launch(param.uri);
                 }
             }),
+            Terminate: (0, device_namespaceObject.defineAction)({
+                name: 'Terminate',
+                description: 'Terminate (force-stop) an Android app by package 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);
+                }
+            }),
             AndroidBackButton: (0, device_namespaceObject.defineAction)({
                 name: 'AndroidBackButton',
                 description: 'Trigger the system "back" operation on Android devices',
@@ -1865,6 +1893,12 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
+        async terminate(uri) {
+            const action = this.wrapActionInActionSpace('Terminate');
+            return action({
+                uri
+            });
+        }
         async runAdbShell(command) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({
@@ -1956,7 +1990,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         constructor(toolsManager){
             super({
                 name: '@midscene/android-mcp',
-                version: "1.6.3-beta-20260402103943.0",
+                version: "1.6.3",
                 description: 'Control the Android device using natural language commands'
             }, toolsManager);
         }

package/dist/types/index.d.ts

@@ -44,6 +44,11 @@ export declare class AndroidAgent extends Agent<AndroidDevice> {
      * @param uri - App package name, URL, or app name to launch
      */
     launch(uri: string): Promise<void>;
+    /**
+     * Terminate (force-stop) an Android app by package name
+     * @param uri - Package name or app name to terminate
+     */
+    terminate(uri: string): Promise<void>;
     /**
      * Execute ADB shell command on Android device
      * @param command - ADB shell command to execute
@@ -114,6 +119,12 @@ export declare class AndroidDevice implements AbstractInterface {
      */
     private resolvePackageName;
     launch(uri: string): Promise<AndroidDevice>;
+    /**
+     * Terminate (force-stop) an Android app by package name.
+     * Supports app name resolution via setAppNameMapping.
+     * If uri contains "/" (e.g. com.example.app/.MainActivity), only the package part is used.
+     */
+    terminate(uri: string): Promise<void>;
     execYadb(keyboardContent: string, options?: {
         overwrite?: boolean;
     }): Promise<void>;

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

@@ -43,6 +43,11 @@ declare class AndroidAgent extends Agent<AndroidDevice> {
      * @param uri - App package name, URL, or app name to launch
      */
     launch(uri: string): Promise<void>;
+    /**
+     * Terminate (force-stop) an Android app by package name
+     * @param uri - Package name or app name to terminate
+     */
+    terminate(uri: string): Promise<void>;
     /**
      * Execute ADB shell command on Android device
      * @param command - ADB shell command to execute
@@ -106,6 +111,12 @@ declare class AndroidDevice implements AbstractInterface {
      */
     private resolvePackageName;
     launch(uri: string): Promise<AndroidDevice>;
+    /**
+     * Terminate (force-stop) an Android app by package name.
+     * Supports app name resolution via setAppNameMapping.
+     * If uri contains "/" (e.g. com.example.app/.MainActivity), only the package part is used.
+     */
+    terminate(uri: string): Promise<void>;
     execYadb(keyboardContent: string, options?: {
         overwrite?: boolean;
     }): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.6.3-beta-20260402103943.0",
+  "version": "1.6.3",
   "description": "Android automation library for Midscene",
   "keywords": [
     "Android UI automation",
@@ -41,8 +41,8 @@
     "@yume-chan/stream-extra": "2.1.0",
     "appium-adb": "12.12.1",
     "sharp": "^0.34.3",
-    "@midscene/core": "1.6.3-beta-20260402103943.0",
-    "@midscene/shared": "1.6.3-beta-20260402103943.0"
+    "@midscene/core": "1.6.3",
+    "@midscene/shared": "1.6.3"
   },
   "optionalDependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0"
@@ -56,7 +56,7 @@
     "tsx": "^4.19.2",
     "vitest": "3.0.5",
     "zod": "3.24.3",
-    "@midscene/playground": "1.6.3-beta-20260402103943.0"
+    "@midscene/playground": "1.6.3"
   },
   "license": "MIT",
   "scripts": {