@midscene/android 1.0.1-beta-20251029093754.0 → 1.0.1-beta-20251103074550.0

package/dist/es/index.mjs

@@ -173,9 +173,11 @@ class AndroidDevice {
                 await this.clearInput(element);
             })
         ];
+        const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions || [];
         return [
             ...defaultActions,
+            ...platformSpecificActions,
             ...customActions
         ];
     }
@@ -945,6 +947,29 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         this.customActions = null == options ? void 0 : options.customActions;
     }
 }
+const runAdbShellParamSchema = z.string().describe('ADB shell command to execute');
+const launchParamSchema = z.string().describe('App package name or URL to launch');
+const createPlatformActions = (device)=>({
+        RunAdbShell: defineAction({
+            name: 'RunAdbShell',
+            description: 'Execute ADB shell command on Android device',
+            interfaceAlias: 'runAdbShell',
+            paramSchema: runAdbShellParamSchema,
+            call: async (param)=>{
+                const adb = await device.getAdb();
+                return await adb.shell(param);
+            }
+        }),
+        Launch: defineAction({
+            name: 'Launch',
+            description: 'Launch an Android app or URL',
+            interfaceAlias: 'launch',
+            paramSchema: launchParamSchema,
+            call: async (param)=>{
+                await device.launch(param);
+            }
+        })
+    });
 const debugUtils = getDebug('android:utils');
 async function getConnectedDevices() {
     try {
@@ -961,15 +986,22 @@ async function getConnectedDevices() {
         });
     }
 }
+function agent_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 debugAgent = getDebug('android:agent');
 class AndroidAgent extends Agent {
-    async launch(uri) {
-        const device = this.page;
-        await device.launch(uri);
-    }
-    async runAdbShell(command) {
-        const adb = await this.page.getAdb();
-        return await adb.shell(command);
+    constructor(device, opts){
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runAdbShell", void 0);
+        this.launch = this.wrapActionInActionSpace('Launch');
+        this.runAdbShell = this.wrapActionInActionSpace('RunAdbShell');
     }
 }
 async function agentFromAdbDevice(deviceId, opts) {

package/dist/lib/index.js

@@ -219,9 +219,11 @@ class AndroidDevice {
                 await this.clearInput(element);
             })
         ];
+        const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions || [];
         return [
             ...defaultActions,
+            ...platformSpecificActions,
             ...customActions
         ];
     }
@@ -991,6 +993,29 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         this.customActions = null == options ? void 0 : options.customActions;
     }
 }
+const runAdbShellParamSchema = core_namespaceObject.z.string().describe('ADB shell command to execute');
+const launchParamSchema = core_namespaceObject.z.string().describe('App package name or URL to launch');
+const createPlatformActions = (device)=>({
+        RunAdbShell: (0, device_namespaceObject.defineAction)({
+            name: 'RunAdbShell',
+            description: 'Execute ADB shell command on Android device',
+            interfaceAlias: 'runAdbShell',
+            paramSchema: runAdbShellParamSchema,
+            call: async (param)=>{
+                const adb = await device.getAdb();
+                return await adb.shell(param);
+            }
+        }),
+        Launch: (0, device_namespaceObject.defineAction)({
+            name: 'Launch',
+            description: 'Launch an Android app or URL',
+            interfaceAlias: 'launch',
+            paramSchema: launchParamSchema,
+            call: async (param)=>{
+                await device.launch(param);
+            }
+        })
+    });
 const agent_namespaceObject = require("@midscene/core/agent");
 const debugUtils = (0, logger_namespaceObject.getDebug)('android:utils');
 async function getConnectedDevices() {
@@ -1008,15 +1033,22 @@ async function getConnectedDevices() {
         });
     }
 }
+function agent_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 debugAgent = (0, logger_namespaceObject.getDebug)('android:agent');
 class AndroidAgent extends agent_namespaceObject.Agent {
-    async launch(uri) {
-        const device = this.page;
-        await device.launch(uri);
-    }
-    async runAdbShell(command) {
-        const adb = await this.page.getAdb();
-        return await adb.shell(command);
+    constructor(device, opts){
+        super(device, opts), agent_define_property(this, "launch", void 0), agent_define_property(this, "runAdbShell", void 0);
+        this.launch = this.wrapActionInActionSpace('Launch');
+        this.runAdbShell = this.wrapActionInActionSpace('RunAdbShell');
     }
 }
 async function agentFromAdbDevice(deviceId, opts) {

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 import { AbstractInterface } from '@midscene/core/device';
+import type { ActionParam } from '@midscene/core';
+import type { ActionReturn } from '@midscene/core';
 import { ADB } from 'appium-adb';
 import { Agent } from '@midscene/core/agent';
 import { AgentOpt } from '@midscene/core/agent';
@@ -11,12 +13,20 @@ import { InterfaceType } from '@midscene/core';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
+import { z } from '@midscene/core';
 
 export declare function agentFromAdbDevice(deviceId?: string, opts?: AndroidAgentOpt & AndroidDeviceOpt): Promise<AndroidAgent>;
 
 export declare class AndroidAgent extends Agent<AndroidDevice> {
-    launch(uri: string): Promise<void>;
-    runAdbShell(command: string): Promise<string>;
+    /**
+     * Launch an Android app or URL
+     */
+    launch: WrappedAction<DeviceActionLaunch>;
+    /**
+     * Execute ADB shell command on Android device
+     */
+    runAdbShell: WrappedAction<DeviceActionRunAdbShell>;
+    constructor(device: AndroidDevice, opts?: AndroidAgentOpt);
 }
 
 declare type AndroidAgentOpt = AgentOpt;
@@ -116,8 +126,29 @@ export declare class AndroidDevice implements AbstractInterface {
     hideKeyboard(options?: AndroidDeviceInputOpt, timeoutMs?: number): Promise<boolean>;
 }
 
+declare type DeviceActionLaunch = DeviceAction<LaunchParam, void>;
+
+declare type DeviceActionRunAdbShell = DeviceAction<RunAdbShellParam, string>;
+
 export declare function getConnectedDevices(): Promise<Device[]>;
 
+declare type LaunchParam = z.infer<typeof launchParamSchema>;
+
+declare const launchParamSchema: z.ZodString;
+
 export { overrideAIConfig }
 
+declare type RunAdbShellParam = z.infer<typeof runAdbShellParamSchema>;
+
+/**
+ * Platform-specific action definitions for Android
+ * Single source of truth for both runtime behavior and type definitions
+ */
+declare const runAdbShellParamSchema: z.ZodString;
+
+/**
+ * Helper type to convert DeviceAction to wrapped method signature
+ */
+declare type WrappedAction<T extends DeviceAction> = (param: ActionParam<T>) => Promise<ActionReturn<T>>;
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.0.1-beta-20251029093754.0",
+  "version": "1.0.1-beta-20251103074550.0",
   "description": "Android automation library for Midscene",
   "keywords": [
     "Android UI automation",
@@ -27,8 +27,8 @@
   },
   "dependencies": {
     "appium-adb": "12.12.1",
-    "@midscene/shared": "1.0.1-beta-20251029093754.0",
-    "@midscene/core": "1.0.1-beta-20251029093754.0"
+    "@midscene/core": "1.0.1-beta-20251103074550.0",
+    "@midscene/shared": "1.0.1-beta-20251103074550.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.11.2",
@@ -37,7 +37,8 @@
     "typescript": "^5.8.3",
     "tsx": "^4.19.2",
     "vitest": "3.0.5",
-    "@midscene/playground": "1.0.1-beta-20251029093754.0"
+    "zod": "3.24.3",
+    "@midscene/playground": "1.0.1-beta-20251103074550.0"
   },
   "license": "MIT",
   "scripts": {