@xiuchang-midscene/android 2.0.5 → 2.0.7

package/dist/es/cli.mjs

@@ -2111,6 +2111,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await agent.detectAndLoadAppKnowledge();
     return agent;
 }
+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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -2133,6 +2143,11 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false
         });
+        if (this.launchPackage) {
+            mcp_tools_debug('Launching package before act:', this.launchPackage);
+            await agent.launch(this.launchPackage);
+            await agent.detectAndLoadAppKnowledge();
+        }
         this.agent = agent;
         return agent;
     }
@@ -2167,8 +2182,16 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+    }
 }
 const tools = new AndroidMidsceneTools();
+const packageIdx = process.argv.indexOf('--package');
+if (-1 !== packageIdx && process.argv[packageIdx + 1]) {
+    tools.launchPackage = process.argv[packageIdx + 1];
+    process.argv.splice(packageIdx, 2);
+}
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
     version: "2.0.2"

package/dist/es/index.mjs

@@ -2177,6 +2177,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await agent.detectAndLoadAppKnowledge();
     return agent;
 }
+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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -2199,6 +2209,11 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false
         });
+        if (this.launchPackage) {
+            mcp_tools_debug('Launching package before act:', this.launchPackage);
+            await agent.launch(this.launchPackage);
+            await agent.detectAndLoadAppKnowledge();
+        }
         this.agent = agent;
         return agent;
     }
@@ -2233,5 +2248,8 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+    }
 }
 export { AndroidAgent, AndroidDevice, AndroidMidsceneTools, ScrcpyDeviceAdapter, agentFromAdbDevice, getConnectedDevices, getConnectedDevicesWithDetails, overrideAIConfig };

package/dist/es/mcp-server.mjs

@@ -2110,6 +2110,16 @@ async function agentFromAdbDevice(deviceId, opts) {
     await agent.detectAndLoadAppKnowledge();
     return agent;
 }
+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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
 class AndroidMidsceneTools extends BaseMidsceneTools {
     createTemporaryDevice() {
@@ -2132,6 +2142,11 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
         const agent = await agentFromAdbDevice(deviceId, {
             autoDismissKeyboard: false
         });
+        if (this.launchPackage) {
+            mcp_tools_debug('Launching package before act:', this.launchPackage);
+            await agent.launch(this.launchPackage);
+            await agent.detectAndLoadAppKnowledge();
+        }
         this.agent = agent;
         return agent;
     }
@@ -2166,6 +2181,9 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
+    constructor(...args){
+        super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+    }
 }
 class AndroidMCPServer extends BaseMCPServer {
     createToolsManager() {

package/dist/lib/cli.js

@@ -2126,6 +2126,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await agent.detectAndLoadAppKnowledge();
         return agent;
     }
+    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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -2148,6 +2158,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false
             });
+            if (this.launchPackage) {
+                mcp_tools_debug('Launching package before act:', this.launchPackage);
+                await agent.launch(this.launchPackage);
+                await agent.detectAndLoadAppKnowledge();
+            }
             this.agent = agent;
             return agent;
         }
@@ -2182,8 +2197,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+        }
     }
     const tools = new AndroidMidsceneTools();
+    const packageIdx = process.argv.indexOf('--package');
+    if (-1 !== packageIdx && process.argv[packageIdx + 1]) {
+        tools.launchPackage = process.argv[packageIdx + 1];
+        process.argv.splice(packageIdx, 2);
+    }
     (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-android', {
         stripPrefix: 'android_',
         version: "2.0.2"

package/dist/lib/index.js

@@ -2213,6 +2213,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         return agent;
     }
     const mcp_namespaceObject = require("@xiuchang-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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -2235,6 +2245,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false
             });
+            if (this.launchPackage) {
+                mcp_tools_debug('Launching package before act:', this.launchPackage);
+                await agent.launch(this.launchPackage);
+                await agent.detectAndLoadAppKnowledge();
+            }
             this.agent = agent;
             return agent;
         }
@@ -2269,6 +2284,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+        }
     }
 })();
 exports.AndroidAgent = __webpack_exports__.AndroidAgent;

package/dist/lib/mcp-server.js

@@ -2141,6 +2141,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await agent.detectAndLoadAppKnowledge();
         return agent;
     }
+    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 mcp_tools_debug = (0, logger_.getDebug)('mcp:android-tools');
     class AndroidMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
         createTemporaryDevice() {
@@ -2163,6 +2173,11 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             const agent = await agentFromAdbDevice(deviceId, {
                 autoDismissKeyboard: false
             });
+            if (this.launchPackage) {
+                mcp_tools_debug('Launching package before act:', this.launchPackage);
+                await agent.launch(this.launchPackage);
+                await agent.detectAndLoadAppKnowledge();
+            }
             this.agent = agent;
             return agent;
         }
@@ -2197,6 +2212,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
                 }
             ];
         }
+        constructor(...args){
+            super(...args), mcp_tools_define_property(this, "launchPackage", void 0);
+        }
     }
     class AndroidMCPServer extends mcp_namespaceObject.BaseMCPServer {
         createToolsManager() {

package/dist/types/index.d.ts

@@ -269,6 +269,8 @@ export declare class AndroidDevice implements AbstractInterface {
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
 export declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent> {
+    /** When set, ensureAgent will launch this package before detecting knowledge. */
+    launchPackage?: string;
     protected createTemporaryDevice(): AndroidDevice;
     protected ensureAgent(deviceId?: string): Promise<AndroidAgent>;
     /**

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

@@ -270,6 +270,8 @@ export declare class AndroidMCPServer extends BaseMCPServer {
  * Extends BaseMidsceneTools to provide Android ADB device connection tools
  */
 declare class AndroidMidsceneTools extends BaseMidsceneTools<AndroidAgent> {
+    /** When set, ensureAgent will launch this package before detecting knowledge. */
+    launchPackage?: string;
     protected createTemporaryDevice(): AndroidDevice;
     protected ensureAgent(deviceId?: string): Promise<AndroidAgent>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiuchang-midscene/android",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "Android automation library for Midscene",
   "keywords": [
     "Android UI automation",
@@ -42,8 +42,8 @@
     "@yume-chan/stream-extra": "2.1.0",
     "appium-adb": "12.12.1",
     "sharp": "^0.34.3",
-    "@xiuchang-midscene/shared": "^2.0.5",
-    "@xiuchang-midscene/core": "^2.0.5"
+    "@xiuchang-midscene/shared": "^2.0.7",
+    "@xiuchang-midscene/core": "^2.0.7"
   },
   "optionalDependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0"