@midscene/android 1.8.1 → 1.8.2-beta-20260515014559.0

package/dist/es/cli.mjs

@@ -1771,7 +1771,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
 device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
 device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
 const runAdbShellParamSchema = z.object({
-    command: z.string().describe('ADB shell command to execute')
+    command: z.string().describe('ADB shell command to execute'),
+    timeout: z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
 });
 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.')
@@ -1786,12 +1787,15 @@ const createPlatformActions = (device)=>({
             interfaceAlias: 'runAdbShell',
             paramSchema: runAdbShellParamSchema,
             sample: {
-                command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                timeout: 60000
             },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                 const adb = await device.getAdb();
-                return await adb.shell(param.command);
+                return void 0 !== param.timeout ? await adb.shell(param.command, {
+                    timeout: param.timeout
+                }) : await adb.shell(param.command);
             }
         }),
         Launch: defineAction({
@@ -1858,10 +1862,11 @@ class AndroidAgent extends Agent {
             uri
         });
     }
-    async runAdbShell(command) {
+    async runAdbShell(command, opt) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({
-            command
+            command,
+            ...opt
         });
     }
     createActionWrapper(name) {
@@ -1982,7 +1987,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.8.1",
+    version: "1.8.2-beta-20260515014559.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -1674,7 +1674,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
 device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
 device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
 const runAdbShellParamSchema = z.object({
-    command: z.string().describe('ADB shell command to execute')
+    command: z.string().describe('ADB shell command to execute'),
+    timeout: z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
 });
 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.')
@@ -1689,12 +1690,15 @@ const createPlatformActions = (device)=>({
             interfaceAlias: 'runAdbShell',
             paramSchema: runAdbShellParamSchema,
             sample: {
-                command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                timeout: 60000
             },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                 const adb = await device.getAdb();
-                return await adb.shell(param.command);
+                return void 0 !== param.timeout ? await adb.shell(param.command, {
+                    timeout: param.timeout
+                }) : await adb.shell(param.command);
             }
         }),
         Launch: defineAction({
@@ -1924,10 +1928,11 @@ class AndroidAgent extends Agent {
             uri
         });
     }
-    async runAdbShell(command) {
+    async runAdbShell(command, opt) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({
-            command
+            command,
+            ...opt
         });
     }
     createActionWrapper(name) {

package/dist/es/mcp-server.mjs

@@ -1771,7 +1771,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
 device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
 device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
 const runAdbShellParamSchema = z.object({
-    command: z.string().describe('ADB shell command to execute')
+    command: z.string().describe('ADB shell command to execute'),
+    timeout: z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
 });
 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.')
@@ -1786,12 +1787,15 @@ const createPlatformActions = (device)=>({
             interfaceAlias: 'runAdbShell',
             paramSchema: runAdbShellParamSchema,
             sample: {
-                command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                timeout: 60000
             },
             call: async (param)=>{
                 if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                 const adb = await device.getAdb();
-                return await adb.shell(param.command);
+                return void 0 !== param.timeout ? await adb.shell(param.command, {
+                    timeout: param.timeout
+                }) : await adb.shell(param.command);
             }
         }),
         Launch: defineAction({
@@ -1858,10 +1862,11 @@ class AndroidAgent extends Agent {
             uri
         });
     }
-    async runAdbShell(command) {
+    async runAdbShell(command, opt) {
         const action = this.wrapActionInActionSpace('RunAdbShell');
         return action({
-            command
+            command,
+            ...opt
         });
     }
     createActionWrapper(name) {
@@ -1986,7 +1991,7 @@ class AndroidMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/android-mcp',
-            version: "1.8.1",
+            version: "1.8.2-beta-20260515014559.0",
             description: 'Control the Android device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -1786,7 +1786,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
     device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
     const runAdbShellParamSchema = core_namespaceObject.z.object({
-        command: core_namespaceObject.z.string().describe('ADB shell command to execute')
+        command: core_namespaceObject.z.string().describe('ADB shell command to execute'),
+        timeout: core_namespaceObject.z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
     });
     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.')
@@ -1801,12 +1802,15 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 interfaceAlias: 'runAdbShell',
                 paramSchema: runAdbShellParamSchema,
                 sample: {
-                    command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                    command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                    timeout: 60000
                 },
                 call: async (param)=>{
                     if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                     const adb = await device.getAdb();
-                    return await adb.shell(param.command);
+                    return void 0 !== param.timeout ? await adb.shell(param.command, {
+                        timeout: param.timeout
+                    }) : await adb.shell(param.command);
                 }
             }),
             Launch: (0, device_namespaceObject.defineAction)({
@@ -1873,10 +1877,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
-        async runAdbShell(command) {
+        async runAdbShell(command, opt) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({
-                command
+                command,
+                ...opt
             });
         }
         createActionWrapper(name) {
@@ -1997,7 +2002,7 @@ ${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.8.1",
+        version: "1.8.2-beta-20260515014559.0",
         extraCommands: (0, core_namespaceObject.createReportCliCommands)()
     }).catch((e)=>{
         process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -1708,7 +1708,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
     device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
     const runAdbShellParamSchema = core_namespaceObject.z.object({
-        command: core_namespaceObject.z.string().describe('ADB shell command to execute')
+        command: core_namespaceObject.z.string().describe('ADB shell command to execute'),
+        timeout: core_namespaceObject.z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
     });
     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.')
@@ -1723,12 +1724,15 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 interfaceAlias: 'runAdbShell',
                 paramSchema: runAdbShellParamSchema,
                 sample: {
-                    command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                    command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                    timeout: 60000
                 },
                 call: async (param)=>{
                     if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                     const adb = await device.getAdb();
-                    return await adb.shell(param.command);
+                    return void 0 !== param.timeout ? await adb.shell(param.command, {
+                        timeout: param.timeout
+                    }) : await adb.shell(param.command);
                 }
             }),
             Launch: (0, device_namespaceObject.defineAction)({
@@ -1959,10 +1963,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
-        async runAdbShell(command) {
+        async runAdbShell(command, opt) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({
-                command
+                command,
+                ...opt
             });
         }
         createActionWrapper(name) {

package/dist/lib/mcp-server.js

@@ -1801,7 +1801,8 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     device_define_property(AndroidDevice, "TAKE_SCREENSHOT_FAIL_THRESHOLD", 3);
     device_define_property(AndroidDevice, "DEFAULT_MIN_SCREENSHOT_BUFFER_SIZE", 1024);
     const runAdbShellParamSchema = core_namespaceObject.z.object({
-        command: core_namespaceObject.z.string().describe('ADB shell command to execute')
+        command: core_namespaceObject.z.string().describe('ADB shell command to execute'),
+        timeout: core_namespaceObject.z.number().int().positive().optional().describe('ADB shell command execution timeout in milliseconds')
     });
     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.')
@@ -1816,12 +1817,15 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 interfaceAlias: 'runAdbShell',
                 paramSchema: runAdbShellParamSchema,
                 sample: {
-                    command: 'dumpsys window displays | grep -E "mCurrentFocus"'
+                    command: 'dumpsys window displays | grep -E "mCurrentFocus"',
+                    timeout: 60000
                 },
                 call: async (param)=>{
                     if (!param.command || '' === param.command.trim()) throw new Error('RunAdbShell requires a non-empty command parameter');
                     const adb = await device.getAdb();
-                    return await adb.shell(param.command);
+                    return void 0 !== param.timeout ? await adb.shell(param.command, {
+                        timeout: param.timeout
+                    }) : await adb.shell(param.command);
                 }
             }),
             Launch: (0, device_namespaceObject.defineAction)({
@@ -1888,10 +1892,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 uri
             });
         }
-        async runAdbShell(command) {
+        async runAdbShell(command, opt) {
             const action = this.wrapActionInActionSpace('RunAdbShell');
             return action({
-                command
+                command,
+                ...opt
             });
         }
         createActionWrapper(name) {
@@ -2017,7 +2022,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         constructor(toolsManager){
             super({
                 name: '@midscene/android-mcp',
-                version: "1.8.1",
+                version: "1.8.2-beta-20260515014559.0",
                 description: 'Control the Android device using natural language commands'
             }, toolsManager);
         }

package/dist/types/index.d.ts

@@ -54,8 +54,9 @@ export declare class AndroidAgent extends Agent<AndroidDevice> {
     /**
      * Execute ADB shell command on Android device
      * @param command - ADB shell command to execute
+     * @param opt - Optional ADB shell execution settings
      */
-    runAdbShell(command: string): Promise<string>;
+    runAdbShell(command: string, opt?: RunAdbShellOpt): Promise<string>;
     private createActionWrapper;
 }
 
@@ -275,6 +276,13 @@ declare interface ResolvedScrcpyConfig {
     idleTimeoutMs: number;
 }
 
+declare type RunAdbShellOpt = {
+    /**
+     * ADB shell command execution timeout in milliseconds.
+     */
+    timeout?: number;
+};
+
 declare interface ScrcpyConfig {
     enabled?: boolean;
     maxSize?: number;

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

@@ -53,8 +53,9 @@ declare class AndroidAgent extends Agent<AndroidDevice> {
     /**
      * Execute ADB shell command on Android device
      * @param command - ADB shell command to execute
+     * @param opt - Optional ADB shell execution settings
      */
-    runAdbShell(command: string): Promise<string>;
+    runAdbShell(command: string, opt?: RunAdbShellOpt): Promise<string>;
     private createActionWrapper;
 }
 
@@ -273,6 +274,13 @@ export declare function mcpServerForAgent(agent: Agent | AndroidAgent): {
     launchHttp(options: LaunchMCPServerOptions): Promise<LaunchMCPServerResult>;
 };
 
+declare type RunAdbShellOpt = {
+    /**
+     * ADB shell command execution timeout in milliseconds.
+     */
+    timeout?: number;
+};
+
 declare type ScrollDirection = 'up' | 'down' | 'left' | 'right';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.8.1",
+  "version": "1.8.2-beta-20260515014559.0",
   "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/shared": "1.8.1",
-    "@midscene/core": "1.8.1"
+    "@midscene/core": "1.8.2-beta-20260515014559.0",
+    "@midscene/shared": "1.8.2-beta-20260515014559.0"
   },
   "optionalDependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0"
@@ -56,7 +56,7 @@
     "undici": "^6.0.0",
     "vitest": "3.0.5",
     "zod": "^3.25.1",
-    "@midscene/playground": "1.8.1"
+    "@midscene/playground": "1.8.2-beta-20260515014559.0"
   },
   "license": "MIT",
   "scripts": {