@midscene/android 1.7.7 → 1.7.10-beta-20260507030203.0

package/dist/es/cli.mjs

@@ -1618,17 +1618,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         this.connectingAdb = null;
         this.yadbPushed = false;
     }
-    async getTimestamp() {
+    async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const adb = await this.getAdb();
         try {
-            const stdout = await adb.shell('date +%s%3N');
-            const timestamp = Number.parseInt(stdout.trim(), 10);
-            if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-            debugDevice(`Got device time: ${timestamp}`);
-            return timestamp;
+            const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+            const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+            if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+            const [, year, month, day, hours, minutes, seconds] = match;
+            const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+            debugDevice(`Got device local time: ${timeString}`);
+            return `${timeString} (${format})`;
         } catch (error) {
-            debugDevice(`Failed to get device time: ${error}`);
-            throw new Error(`Failed to get device time: ${error}`);
+            debugDevice(`Failed to get device local time: ${error}`);
+            throw new Error(`Failed to get device local time: ${error}`);
         }
     }
     async back() {
@@ -2016,7 +2018,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.7.7",
+    version: "1.7.10-beta-20260507030203.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -1521,17 +1521,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         this.connectingAdb = null;
         this.yadbPushed = false;
     }
-    async getTimestamp() {
+    async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const adb = await this.getAdb();
         try {
-            const stdout = await adb.shell('date +%s%3N');
-            const timestamp = Number.parseInt(stdout.trim(), 10);
-            if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-            debugDevice(`Got device time: ${timestamp}`);
-            return timestamp;
+            const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+            const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+            if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+            const [, year, month, day, hours, minutes, seconds] = match;
+            const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+            debugDevice(`Got device local time: ${timeString}`);
+            return `${timeString} (${format})`;
         } catch (error) {
-            debugDevice(`Failed to get device time: ${error}`);
-            throw new Error(`Failed to get device time: ${error}`);
+            debugDevice(`Failed to get device local time: ${error}`);
+            throw new Error(`Failed to get device local time: ${error}`);
         }
     }
     async back() {

package/dist/es/mcp-server.mjs

@@ -1618,17 +1618,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         this.connectingAdb = null;
         this.yadbPushed = false;
     }
-    async getTimestamp() {
+    async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const adb = await this.getAdb();
         try {
-            const stdout = await adb.shell('date +%s%3N');
-            const timestamp = Number.parseInt(stdout.trim(), 10);
-            if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-            debugDevice(`Got device time: ${timestamp}`);
-            return timestamp;
+            const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+            const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+            if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+            const [, year, month, day, hours, minutes, seconds] = match;
+            const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+            debugDevice(`Got device local time: ${timeString}`);
+            return `${timeString} (${format})`;
         } catch (error) {
-            debugDevice(`Failed to get device time: ${error}`);
-            throw new Error(`Failed to get device time: ${error}`);
+            debugDevice(`Failed to get device local time: ${error}`);
+            throw new Error(`Failed to get device local time: ${error}`);
         }
     }
     async back() {
@@ -2020,7 +2022,7 @@ class AndroidMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/android-mcp',
-            version: "1.7.7",
+            version: "1.7.10-beta-20260507030203.0",
             description: 'Control the Android device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -1633,17 +1633,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             this.connectingAdb = null;
             this.yadbPushed = false;
         }
-        async getTimestamp() {
+        async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
             const adb = await this.getAdb();
             try {
-                const stdout = await adb.shell('date +%s%3N');
-                const timestamp = Number.parseInt(stdout.trim(), 10);
-                if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-                debugDevice(`Got device time: ${timestamp}`);
-                return timestamp;
+                const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+                const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+                if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+                const [, year, month, day, hours, minutes, seconds] = match;
+                const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+                debugDevice(`Got device local time: ${timeString}`);
+                return `${timeString} (${format})`;
             } catch (error) {
-                debugDevice(`Failed to get device time: ${error}`);
-                throw new Error(`Failed to get device time: ${error}`);
+                debugDevice(`Failed to get device local time: ${error}`);
+                throw new Error(`Failed to get device local time: ${error}`);
             }
         }
         async back() {
@@ -2031,7 +2033,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.7.7",
+        version: "1.7.10-beta-20260507030203.0",
         extraCommands: (0, core_namespaceObject.createReportCliCommands)()
     }).catch((e)=>{
         process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -1555,17 +1555,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             this.connectingAdb = null;
             this.yadbPushed = false;
         }
-        async getTimestamp() {
+        async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
             const adb = await this.getAdb();
             try {
-                const stdout = await adb.shell('date +%s%3N');
-                const timestamp = Number.parseInt(stdout.trim(), 10);
-                if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-                debugDevice(`Got device time: ${timestamp}`);
-                return timestamp;
+                const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+                const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+                if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+                const [, year, month, day, hours, minutes, seconds] = match;
+                const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+                debugDevice(`Got device local time: ${timeString}`);
+                return `${timeString} (${format})`;
             } catch (error) {
-                debugDevice(`Failed to get device time: ${error}`);
-                throw new Error(`Failed to get device time: ${error}`);
+                debugDevice(`Failed to get device local time: ${error}`);
+                throw new Error(`Failed to get device local time: ${error}`);
             }
         }
         async back() {

package/dist/lib/mcp-server.js

@@ -1648,17 +1648,19 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             this.connectingAdb = null;
             this.yadbPushed = false;
         }
-        async getTimestamp() {
+        async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
             const adb = await this.getAdb();
             try {
-                const stdout = await adb.shell('date +%s%3N');
-                const timestamp = Number.parseInt(stdout.trim(), 10);
-                if (Number.isNaN(timestamp)) throw new Error(`Invalid timestamp format: ${stdout}`);
-                debugDevice(`Got device time: ${timestamp}`);
-                return timestamp;
+                const stdout = await adb.shell('date +%Y-%m-%dT%H:%M:%S');
+                const match = stdout.trim().match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/);
+                if (!match) throw new Error(`Invalid device time format: ${stdout}`);
+                const [, year, month, day, hours, minutes, seconds] = match;
+                const timeString = format.replace('YYYY', year).replace('MM', month).replace('DD', day).replace('HH', hours).replace('mm', minutes).replace('ss', seconds);
+                debugDevice(`Got device local time: ${timeString}`);
+                return `${timeString} (${format})`;
             } catch (error) {
-                debugDevice(`Failed to get device time: ${error}`);
-                throw new Error(`Failed to get device time: ${error}`);
+                debugDevice(`Failed to get device local time: ${error}`);
+                throw new Error(`Failed to get device local time: ${error}`);
             }
         }
         async back() {
@@ -2051,7 +2053,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         constructor(toolsManager){
             super({
                 name: '@midscene/android-mcp',
-                version: "1.7.7",
+                version: "1.7.10-beta-20260507030203.0",
                 description: 'Control the Android device using natural language commands'
             }, toolsManager);
         }

package/dist/types/index.d.ts

@@ -211,11 +211,11 @@ export declare class AndroidDevice implements AbstractInterface {
     scroll(deltaX: number, deltaY: number, duration?: number, warnOnClamp?: boolean, direction?: ScrollDirection): Promise<void>;
     destroy(): Promise<void>;
     /**
-     * Get the current time from the Android device.
-     * Returns the device's current timestamp in milliseconds.
-     * This is useful when the system time and device time are not synchronized.
+     * Get the current device-local time as a formatted string.
+     * This avoids formatting an Android epoch timestamp in the host machine's
+     * timezone, which can disagree with the device status bar.
      */
-    getTimestamp(): Promise<number>;
+    getDeviceLocalTimeString(format?: string): Promise<string>;
     back(): Promise<void>;
     home(): Promise<void>;
     recentApps(): Promise<void>;

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

@@ -203,11 +203,11 @@ declare class AndroidDevice implements AbstractInterface {
     scroll(deltaX: number, deltaY: number, duration?: number, warnOnClamp?: boolean, direction?: ScrollDirection): Promise<void>;
     destroy(): Promise<void>;
     /**
-     * Get the current time from the Android device.
-     * Returns the device's current timestamp in milliseconds.
-     * This is useful when the system time and device time are not synchronized.
+     * Get the current device-local time as a formatted string.
+     * This avoids formatting an Android epoch timestamp in the host machine's
+     * timezone, which can disagree with the device status bar.
      */
-    getTimestamp(): Promise<number>;
+    getDeviceLocalTimeString(format?: string): Promise<string>;
     back(): Promise<void>;
     home(): Promise<void>;
     recentApps(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.7.7",
+  "version": "1.7.10-beta-20260507030203.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.7.7",
-    "@midscene/core": "1.7.7"
+    "@midscene/core": "1.7.10-beta-20260507030203.0",
+    "@midscene/shared": "1.7.10-beta-20260507030203.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.7"
+    "@midscene/playground": "1.7.10-beta-20260507030203.0"
   },
   "license": "MIT",
   "scripts": {