@midscene/android 1.7.5-beta-20260420031652.0 → 1.7.5-beta-20260420031920.0

package/dist/es/cli.mjs

@@ -1929,6 +1929,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await device.connect();
     return new AndroidAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -1956,10 +1966,10 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'android_connect',
                 description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('Android device ID (from adb devices)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -1982,11 +1992,23 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'android',
+            shape: {
+                deviceId: z.string().optional().describe('Android device ID (from adb devices)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.7.5-beta-20260420031652.0",
+    version: "1.7.5-beta-20260420031920.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);

package/dist/es/index.mjs

@@ -1995,6 +1995,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await device.connect();
     return new AndroidAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -2022,10 +2032,10 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'android_connect',
                 description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('Android device ID (from adb devices)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -2048,5 +2058,17 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'android',
+            shape: {
+                deviceId: z.string().optional().describe('Android device ID (from adb devices)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 export { AndroidAgent, AndroidDevice, AndroidMidsceneTools, ScrcpyDeviceAdapter, agentFromAdbDevice, getConnectedDevices, getConnectedDevicesWithDetails, overrideAIConfig };

package/dist/es/mcp-server.mjs

@@ -1928,6 +1928,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await device.connect();
     return new AndroidAgent(device, opts);
 }
+function mcp_tools_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 const debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -1955,10 +1965,10 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             {
                 name: 'android_connect',
                 description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                schema: {
-                    deviceId: z.string().optional().describe('Android device ID (from adb devices)')
-                },
-                handler: async ({ deviceId })=>{
+                schema: this.getAgentInitArgSchema(),
+                cli: this.getAgentInitArgCliMetadata(),
+                handler: async (args)=>{
+                    const deviceId = this.extractAgentInitParam(args);
                     const agent = await this.ensureAgent(deviceId);
                     const screenshot = await agent.page.screenshotBase64();
                     return {
@@ -1981,6 +1991,18 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "initArgSpec", {
+            namespace: 'android',
+            shape: {
+                deviceId: z.string().optional().describe('Android device ID (from adb devices)')
+            },
+            cli: {
+                preferBareKeys: true
+            },
+            adapt: (extracted)=>extracted?.deviceId
+        });
+    }
 }
 class AndroidMCPServer extends BaseMCPServer {
     createToolsManager() {
@@ -1989,7 +2011,7 @@ class AndroidMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/android-mcp',
-            version: "1.7.5-beta-20260420031652.0",
+            version: "1.7.5-beta-20260420031920.0",
             description: 'Control the Android device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -1944,6 +1944,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await device.connect();
         return new AndroidAgent(device, opts);
     }
+    function mcp_tools_define_property(obj, key, value) {
+        if (key in obj) Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+        else obj[key] = value;
+        return obj;
+    }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -1971,10 +1981,10 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 {
                     name: 'android_connect',
                     description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                    schema: {
-                        deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
-                    },
-                    handler: async ({ deviceId })=>{
+                    schema: this.getAgentInitArgSchema(),
+                    cli: this.getAgentInitArgCliMetadata(),
+                    handler: async (args)=>{
+                        const deviceId = this.extractAgentInitParam(args);
                         const agent = await this.ensureAgent(deviceId);
                         const screenshot = await agent.page.screenshotBase64();
                         return {
@@ -1997,11 +2007,23 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+                namespace: 'android',
+                shape: {
+                    deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
+                },
+                cli: {
+                    preferBareKeys: true
+                },
+                adapt: (extracted)=>extracted?.deviceId
+            });
+        }
     }
     const tools = new AndroidMidsceneTools();
     (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-android', {
         stripPrefix: 'android_',
-        version: "1.7.5-beta-20260420031652.0",
+        version: "1.7.5-beta-20260420031920.0",
         extraCommands: (0, core_namespaceObject.createReportCliCommands)()
     }).catch((e)=>{
         if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);

package/dist/lib/index.js

@@ -2031,6 +2031,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         return new AndroidAgent(device, opts);
     }
     const mcp_namespaceObject = require("@midscene/shared/mcp");
+    function mcp_tools_define_property(obj, key, value) {
+        if (key in obj) Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+        else obj[key] = value;
+        return obj;
+    }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -2058,10 +2068,10 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 {
                     name: 'android_connect',
                     description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                    schema: {
-                        deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
-                    },
-                    handler: async ({ deviceId })=>{
+                    schema: this.getAgentInitArgSchema(),
+                    cli: this.getAgentInitArgCliMetadata(),
+                    handler: async (args)=>{
+                        const deviceId = this.extractAgentInitParam(args);
                         const agent = await this.ensureAgent(deviceId);
                         const screenshot = await agent.page.screenshotBase64();
                         return {
@@ -2084,6 +2094,18 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+                namespace: 'android',
+                shape: {
+                    deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
+                },
+                cli: {
+                    preferBareKeys: true
+                },
+                adapt: (extracted)=>extracted?.deviceId
+            });
+        }
     }
 })();
 exports.AndroidAgent = __webpack_exports__.AndroidAgent;

package/dist/lib/mcp-server.js

@@ -1959,6 +1959,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await device.connect();
         return new AndroidAgent(device, opts);
     }
+    function mcp_tools_define_property(obj, key, value) {
+        if (key in obj) Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+        else obj[key] = value;
+        return obj;
+    }
     const debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -1986,10 +1996,10 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 {
                     name: 'android_connect',
                     description: 'Connect to Android device via ADB. If deviceId not provided, uses the first available device.',
-                    schema: {
-                        deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
-                    },
-                    handler: async ({ deviceId })=>{
+                    schema: this.getAgentInitArgSchema(),
+                    cli: this.getAgentInitArgCliMetadata(),
+                    handler: async (args)=>{
+                        const deviceId = this.extractAgentInitParam(args);
                         const agent = await this.ensureAgent(deviceId);
                         const screenshot = await agent.page.screenshotBase64();
                         return {
@@ -2012,6 +2022,18 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "initArgSpec", {
+                namespace: 'android',
+                shape: {
+                    deviceId: core_namespaceObject.z.string().optional().describe('Android device ID (from adb devices)')
+                },
+                cli: {
+                    preferBareKeys: true
+                },
+                adapt: (extracted)=>extracted?.deviceId
+            });
+        }
     }
     class AndroidMCPServer extends mcp_namespaceObject.BaseMCPServer {
         createToolsManager() {
@@ -2020,7 +2042,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         constructor(toolsManager){
             super({
                 name: '@midscene/android-mcp',
-                version: "1.7.5-beta-20260420031652.0",
+                version: "1.7.5-beta-20260420031920.0",
                 description: 'Control the Android device using natural language commands'
             }, toolsManager);
         }

package/dist/types/index.d.ts

@@ -11,6 +11,7 @@ import { BaseMidsceneTools } from '@midscene/shared/mcp';
 import { Device } from 'appium-adb';
 import { DeviceAction } from '@midscene/core';
 import type { ElementInfo } from '@midscene/shared/extractor';
+import { InitArgSpec } from '@midscene/shared/mcp';
 import { InterfaceType } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { Point } from '@midscene/core';
@@ -237,7 +238,8 @@ export declare class AndroidDevice implements AbstractInterface {
  * Android-specific tools manager
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
-export declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent> {
+export declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, string> {
+    protected readonly initArgSpec: InitArgSpec<string>;
     protected createTemporaryDevice(): AndroidDevice;
     protected ensureAgent(deviceId?: string): Promise<AndroidAgent>;
     /**

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

@@ -10,6 +10,7 @@ import { BaseMCPServer } from '@midscene/shared/mcp';
 import { BaseMidsceneTools } from '@midscene/shared/mcp';
 import { DeviceAction } from '@midscene/core';
 import type { ElementInfo } from '@midscene/shared/extractor';
+import { InitArgSpec } from '@midscene/shared/mcp';
 import { InterfaceType } from '@midscene/core';
 import { LaunchMCPServerOptions } from '@midscene/shared/mcp';
 import { LaunchMCPServerResult } from '@midscene/shared/mcp';
@@ -238,7 +239,8 @@ export declare class AndroidMCPServer extends BaseMCPServer {
  * Android-specific tools manager
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
-declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent> {
+declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent, string> {
+    protected readonly initArgSpec: InitArgSpec<string>;
     protected createTemporaryDevice(): AndroidDevice;
     protected ensureAgent(deviceId?: string): Promise<AndroidAgent>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.7.5-beta-20260420031652.0",
+  "version": "1.7.5-beta-20260420031920.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/core": "1.7.5-beta-20260420031652.0",
-    "@midscene/shared": "1.7.5-beta-20260420031652.0"
+    "@midscene/core": "1.7.5-beta-20260420031920.0",
+    "@midscene/shared": "1.7.5-beta-20260420031920.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.7.5-beta-20260420031652.0"
+    "@midscene/playground": "1.7.5-beta-20260420031920.0"
   },
   "license": "MIT",
   "scripts": {