@midscene/harmony 1.8.0 → 1.8.1

package/dist/lib/index.js

@@ -258,15 +258,6 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const harmonyInputParamSchema = core_namespaceObject.z.object({
-    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
-        'replace',
-        'clear',
-        'typeOnly'
-    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-});
 const defaultScrollUntilTimes = 10;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
@@ -307,89 +298,15 @@ const keyNameAliasMap = {
 };
 class HarmonyDevice {
     actionSpace() {
+        const mobileActionContext = {
+            input: this.inputPrimitives,
+            size: ()=>this.size(),
+            sleep: async (timeMs)=>{
+                await (0, utils_namespaceObject.sleep)(timeMs);
+            }
+        };
         const defaultActions = [
-            (0, device_namespaceObject.defineActionTap)(async (param)=>{
-                const element = param.locate;
-                external_node_assert_default()(element, 'Element not found, cannot tap');
-                await this.tap(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionDoubleClick)(async (param)=>{
-                const element = param.locate;
-                external_node_assert_default()(element, 'Element not found, cannot double click');
-                await this.doubleTap(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineAction)({
-                name: 'Input',
-                description: 'Input text into the input field',
-                interfaceAlias: 'aiInput',
-                paramSchema: harmonyInputParamSchema,
-                sample: {
-                    value: 'test@example.com',
-                    locate: {
-                        prompt: 'the email input field'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    if ('clear' === param.mode) return void await this.clearInput(element);
-                    if (!param || !param.value) return;
-                    const shouldReplace = 'typeOnly' !== param.mode;
-                    await this.inputText(param.value, element, shouldReplace);
-                }
-            }),
-            (0, device_namespaceObject.defineActionScroll)(async (param)=>{
-                const element = param.locate;
-                const startingPoint = element ? {
-                    left: element.center[0],
-                    top: element.center[1]
-                } : void 0;
-                const scrollToEventName = param?.scrollType;
-                if ('scrollToTop' === scrollToEventName) await this.scrollUntilTop(startingPoint);
-                else if ('scrollToBottom' === scrollToEventName) await this.scrollUntilBottom(startingPoint);
-                else if ('scrollToRight' === scrollToEventName) await this.scrollUntilRight(startingPoint);
-                else if ('scrollToLeft' === scrollToEventName) await this.scrollUntilLeft(startingPoint);
-                else if ('singleAction' !== scrollToEventName && scrollToEventName) throw new Error(`Unknown scroll event type: ${scrollToEventName}, param: ${JSON.stringify(param)}`);
-                else {
-                    if (param?.direction !== 'down' && param && param.direction) if ('up' === param.direction) await this.scrollUp(param.distance ?? void 0, startingPoint);
-                    else if ('left' === param.direction) await this.scrollLeft(param.distance ?? void 0, startingPoint);
-                    else if ('right' === param.direction) await this.scrollRight(param.distance ?? void 0, startingPoint);
-                    else throw new Error(`Unknown scroll direction: ${param.direction}`);
-                    else await this.scrollDown(param?.distance ?? void 0, startingPoint);
-                    await (0, utils_namespaceObject.sleep)(500);
-                }
-            }),
-            (0, device_namespaceObject.defineActionDragAndDrop)(async (param)=>{
-                const from = param.from;
-                const to = param.to;
-                external_node_assert_default()(from, 'missing "from" param for drag and drop');
-                external_node_assert_default()(to, 'missing "to" param for drag and drop');
-                const hdc = await this.getHdc();
-                await hdc.drag(from.center[0], from.center[1], to.center[0], to.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionSwipe)(async (param)=>{
-                const { startPoint, endPoint, duration, repeatCount } = (0, device_namespaceObject.normalizeMobileSwipeParam)(param, await this.size());
-                const hdc = await this.getHdc();
-                for(let i = 0; i < repeatCount; i++)await hdc.swipe(startPoint.x, startPoint.y, endPoint.x, endPoint.y, duration ? Math.round(duration) : void 0);
-            }),
-            (0, device_namespaceObject.defineActionKeyboardPress)(async (param)=>{
-                await this.keyboardPress(param.keyName);
-            }),
-            (0, device_namespaceObject.defineActionCursorMove)(async (param)=>{
-                const arrowKey = 'left' === param.direction ? 'ArrowLeft' : 'ArrowRight';
-                const times = param.times ?? 1;
-                for(let i = 0; i < times; i++){
-                    await this.keyboardPress(arrowKey);
-                    await (0, utils_namespaceObject.sleep)(100);
-                }
-            }),
-            (0, device_namespaceObject.defineActionLongPress)(async (param)=>{
-                const element = param.locate;
-                if (!element) throw new Error('LongPress requires an element to be located');
-                await this.longPress(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionClearInput)(async (param)=>{
-                await this.clearInput(param.locate);
-            })
+            ...(0, device_namespaceObject.createDefaultMobileActions)(mobileActionContext)
         ];
         const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions ?? [];
@@ -399,6 +316,27 @@ class HarmonyDevice {
             ...customActions
         ];
     }
+    async performActionScroll(param) {
+        const element = param.locate;
+        const startingPoint = element ? {
+            left: element.center[0],
+            top: element.center[1]
+        } : void 0;
+        const scrollToEventName = param?.scrollType;
+        if ('scrollToTop' === scrollToEventName) await this.scrollUntilTop(startingPoint);
+        else if ('scrollToBottom' === scrollToEventName) await this.scrollUntilBottom(startingPoint);
+        else if ('scrollToRight' === scrollToEventName) await this.scrollUntilRight(startingPoint);
+        else if ('scrollToLeft' === scrollToEventName) await this.scrollUntilLeft(startingPoint);
+        else if ('singleAction' !== scrollToEventName && scrollToEventName) throw new Error(`Unknown scroll event type: ${scrollToEventName}, param: ${JSON.stringify(param)}`);
+        else {
+            if (param?.direction !== 'down' && param && param.direction) if ('up' === param.direction) await this.scrollUp(param.distance ?? void 0, startingPoint);
+            else if ('left' === param.direction) await this.scrollLeft(param.distance ?? void 0, startingPoint);
+            else if ('right' === param.direction) await this.scrollRight(param.distance ?? void 0, startingPoint);
+            else throw new Error(`Unknown scroll direction: ${param.direction}`);
+            else await this.scrollDown(param?.distance ?? void 0, startingPoint);
+            await (0, utils_namespaceObject.sleep)(500);
+        }
+    }
     describe() {
         return this.descriptionText || `DeviceId: ${this.deviceId}`;
     }
@@ -529,23 +467,23 @@ class HarmonyDevice {
         }
         throw new Error('Screenshot buffer is empty after retries');
     }
-    async tap(x, y) {
+    async tapPoint(point) {
         this.lastTapPosition = {
-            x,
-            y
+            x: point.x,
+            y: point.y
         };
         const hdc = await this.getHdc();
-        await hdc.click(x, y);
+        await hdc.click(point.x, point.y);
     }
-    async doubleTap(x, y) {
+    async doubleTapPoint(point) {
         const hdc = await this.getHdc();
-        await hdc.doubleClick(x, y);
+        await hdc.doubleClick(point.x, point.y);
     }
-    async longPress(x, y) {
+    async longPressPoint(point) {
         const hdc = await this.getHdc();
-        await hdc.longClick(x, y);
+        await hdc.longClick(point.x, point.y);
     }
-    async inputText(text, element, shouldReplace) {
+    async typeText(text, element, shouldReplace) {
         if (!text) return;
         const hdc = await this.getHdc();
         let x;
@@ -576,7 +514,7 @@ class HarmonyDevice {
         }
         await hdc.clearTextField(100);
     }
-    async keyboardPress(key) {
+    async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
         const harmonyKey = harmonyKeyCodeMap[normalizedKey] ?? key;
         const hdc = await this.getHdc();
@@ -776,6 +714,37 @@ class HarmonyDevice {
         device_define_property(this, "interfaceType", 'harmony');
         device_define_property(this, "uri", void 0);
         device_define_property(this, "options", void 0);
+        device_define_property(this, "inputPrimitives", {
+            pointer: {
+                tap: (point)=>this.tapPoint(point),
+                doubleClick: (point)=>this.doubleTapPoint(point),
+                longPress: (point)=>this.longPressPoint(point),
+                dragAndDrop: async (from, to)=>{
+                    const hdc = await this.getHdc();
+                    await hdc.drag(from.x, from.y, to.x, to.y);
+                }
+            },
+            keyboard: {
+                keyboardPress: (keyName)=>this.pressKey(keyName),
+                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true),
+                clearInput: (target)=>this.clearInput(target),
+                cursorMove: async (direction, times = 1)=>{
+                    const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';
+                    for(let i = 0; i < times; i++)await this.pressKey(arrowKey);
+                }
+            },
+            touch: {
+                swipe: async (start, end, opts)=>{
+                    const duration = opts?.duration;
+                    const repeatCount = opts?.repeat ?? 1;
+                    const hdc = await this.getHdc();
+                    for(let i = 0; i < repeatCount; i++)await hdc.swipe(start.x, start.y, end.x, end.y, duration ? Math.round(duration) : void 0);
+                }
+            },
+            scroll: {
+                scroll: (param)=>this.performActionScroll(param)
+            }
+        });
         device_define_property(this, "remoteScreenshotPath", '/data/local/tmp/ms_screen.jpeg');
         device_define_property(this, "localScreenshotPath", null);
         external_node_assert_default()(deviceId, 'deviceId is required for HarmonyDevice');

package/dist/lib/mcp-server.js

@@ -291,15 +291,6 @@ function device_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const harmonyInputParamSchema = core_namespaceObject.z.object({
-    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
-    mode: core_namespaceObject.z.preprocess((val)=>'append' === val ? 'typeOnly' : val, core_namespaceObject.z["enum"]([
-        'replace',
-        'clear',
-        'typeOnly'
-    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "typeOnly" - type the value directly without clearing the field first; "clear" - attempt to clear the field (limited support on HarmonyOS).')),
-    locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
-});
 const defaultScrollUntilTimes = 10;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
@@ -340,89 +331,15 @@ const keyNameAliasMap = {
 };
 class HarmonyDevice {
     actionSpace() {
+        const mobileActionContext = {
+            input: this.inputPrimitives,
+            size: ()=>this.size(),
+            sleep: async (timeMs)=>{
+                await (0, core_utils_namespaceObject.sleep)(timeMs);
+            }
+        };
         const defaultActions = [
-            (0, device_namespaceObject.defineActionTap)(async (param)=>{
-                const element = param.locate;
-                external_node_assert_default()(element, 'Element not found, cannot tap');
-                await this.tap(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionDoubleClick)(async (param)=>{
-                const element = param.locate;
-                external_node_assert_default()(element, 'Element not found, cannot double click');
-                await this.doubleTap(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineAction)({
-                name: 'Input',
-                description: 'Input text into the input field',
-                interfaceAlias: 'aiInput',
-                paramSchema: harmonyInputParamSchema,
-                sample: {
-                    value: 'test@example.com',
-                    locate: {
-                        prompt: 'the email input field'
-                    }
-                },
-                call: async (param)=>{
-                    const element = param.locate;
-                    if ('clear' === param.mode) return void await this.clearInput(element);
-                    if (!param || !param.value) return;
-                    const shouldReplace = 'typeOnly' !== param.mode;
-                    await this.inputText(param.value, element, shouldReplace);
-                }
-            }),
-            (0, device_namespaceObject.defineActionScroll)(async (param)=>{
-                const element = param.locate;
-                const startingPoint = element ? {
-                    left: element.center[0],
-                    top: element.center[1]
-                } : void 0;
-                const scrollToEventName = param?.scrollType;
-                if ('scrollToTop' === scrollToEventName) await this.scrollUntilTop(startingPoint);
-                else if ('scrollToBottom' === scrollToEventName) await this.scrollUntilBottom(startingPoint);
-                else if ('scrollToRight' === scrollToEventName) await this.scrollUntilRight(startingPoint);
-                else if ('scrollToLeft' === scrollToEventName) await this.scrollUntilLeft(startingPoint);
-                else if ('singleAction' !== scrollToEventName && scrollToEventName) throw new Error(`Unknown scroll event type: ${scrollToEventName}, param: ${JSON.stringify(param)}`);
-                else {
-                    if (param?.direction !== 'down' && param && param.direction) if ('up' === param.direction) await this.scrollUp(param.distance ?? void 0, startingPoint);
-                    else if ('left' === param.direction) await this.scrollLeft(param.distance ?? void 0, startingPoint);
-                    else if ('right' === param.direction) await this.scrollRight(param.distance ?? void 0, startingPoint);
-                    else throw new Error(`Unknown scroll direction: ${param.direction}`);
-                    else await this.scrollDown(param?.distance ?? void 0, startingPoint);
-                    await (0, core_utils_namespaceObject.sleep)(500);
-                }
-            }),
-            (0, device_namespaceObject.defineActionDragAndDrop)(async (param)=>{
-                const from = param.from;
-                const to = param.to;
-                external_node_assert_default()(from, 'missing "from" param for drag and drop');
-                external_node_assert_default()(to, 'missing "to" param for drag and drop');
-                const hdc = await this.getHdc();
-                await hdc.drag(from.center[0], from.center[1], to.center[0], to.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionSwipe)(async (param)=>{
-                const { startPoint, endPoint, duration, repeatCount } = (0, device_namespaceObject.normalizeMobileSwipeParam)(param, await this.size());
-                const hdc = await this.getHdc();
-                for(let i = 0; i < repeatCount; i++)await hdc.swipe(startPoint.x, startPoint.y, endPoint.x, endPoint.y, duration ? Math.round(duration) : void 0);
-            }),
-            (0, device_namespaceObject.defineActionKeyboardPress)(async (param)=>{
-                await this.keyboardPress(param.keyName);
-            }),
-            (0, device_namespaceObject.defineActionCursorMove)(async (param)=>{
-                const arrowKey = 'left' === param.direction ? 'ArrowLeft' : 'ArrowRight';
-                const times = param.times ?? 1;
-                for(let i = 0; i < times; i++){
-                    await this.keyboardPress(arrowKey);
-                    await (0, core_utils_namespaceObject.sleep)(100);
-                }
-            }),
-            (0, device_namespaceObject.defineActionLongPress)(async (param)=>{
-                const element = param.locate;
-                if (!element) throw new Error('LongPress requires an element to be located');
-                await this.longPress(element.center[0], element.center[1]);
-            }),
-            (0, device_namespaceObject.defineActionClearInput)(async (param)=>{
-                await this.clearInput(param.locate);
-            })
+            ...(0, device_namespaceObject.createDefaultMobileActions)(mobileActionContext)
         ];
         const platformSpecificActions = Object.values(createPlatformActions(this));
         const customActions = this.customActions ?? [];
@@ -432,6 +349,27 @@ class HarmonyDevice {
             ...customActions
         ];
     }
+    async performActionScroll(param) {
+        const element = param.locate;
+        const startingPoint = element ? {
+            left: element.center[0],
+            top: element.center[1]
+        } : void 0;
+        const scrollToEventName = param?.scrollType;
+        if ('scrollToTop' === scrollToEventName) await this.scrollUntilTop(startingPoint);
+        else if ('scrollToBottom' === scrollToEventName) await this.scrollUntilBottom(startingPoint);
+        else if ('scrollToRight' === scrollToEventName) await this.scrollUntilRight(startingPoint);
+        else if ('scrollToLeft' === scrollToEventName) await this.scrollUntilLeft(startingPoint);
+        else if ('singleAction' !== scrollToEventName && scrollToEventName) throw new Error(`Unknown scroll event type: ${scrollToEventName}, param: ${JSON.stringify(param)}`);
+        else {
+            if (param?.direction !== 'down' && param && param.direction) if ('up' === param.direction) await this.scrollUp(param.distance ?? void 0, startingPoint);
+            else if ('left' === param.direction) await this.scrollLeft(param.distance ?? void 0, startingPoint);
+            else if ('right' === param.direction) await this.scrollRight(param.distance ?? void 0, startingPoint);
+            else throw new Error(`Unknown scroll direction: ${param.direction}`);
+            else await this.scrollDown(param?.distance ?? void 0, startingPoint);
+            await (0, core_utils_namespaceObject.sleep)(500);
+        }
+    }
     describe() {
         return this.descriptionText || `DeviceId: ${this.deviceId}`;
     }
@@ -562,23 +500,23 @@ class HarmonyDevice {
         }
         throw new Error('Screenshot buffer is empty after retries');
     }
-    async tap(x, y) {
+    async tapPoint(point) {
         this.lastTapPosition = {
-            x,
-            y
+            x: point.x,
+            y: point.y
         };
         const hdc = await this.getHdc();
-        await hdc.click(x, y);
+        await hdc.click(point.x, point.y);
     }
-    async doubleTap(x, y) {
+    async doubleTapPoint(point) {
         const hdc = await this.getHdc();
-        await hdc.doubleClick(x, y);
+        await hdc.doubleClick(point.x, point.y);
     }
-    async longPress(x, y) {
+    async longPressPoint(point) {
         const hdc = await this.getHdc();
-        await hdc.longClick(x, y);
+        await hdc.longClick(point.x, point.y);
     }
-    async inputText(text, element, shouldReplace) {
+    async typeText(text, element, shouldReplace) {
         if (!text) return;
         const hdc = await this.getHdc();
         let x;
@@ -609,7 +547,7 @@ class HarmonyDevice {
         }
         await hdc.clearTextField(100);
     }
-    async keyboardPress(key) {
+    async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
         const harmonyKey = harmonyKeyCodeMap[normalizedKey] ?? key;
         const hdc = await this.getHdc();
@@ -809,6 +747,37 @@ class HarmonyDevice {
         device_define_property(this, "interfaceType", 'harmony');
         device_define_property(this, "uri", void 0);
         device_define_property(this, "options", void 0);
+        device_define_property(this, "inputPrimitives", {
+            pointer: {
+                tap: (point)=>this.tapPoint(point),
+                doubleClick: (point)=>this.doubleTapPoint(point),
+                longPress: (point)=>this.longPressPoint(point),
+                dragAndDrop: async (from, to)=>{
+                    const hdc = await this.getHdc();
+                    await hdc.drag(from.x, from.y, to.x, to.y);
+                }
+            },
+            keyboard: {
+                keyboardPress: (keyName)=>this.pressKey(keyName),
+                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true),
+                clearInput: (target)=>this.clearInput(target),
+                cursorMove: async (direction, times = 1)=>{
+                    const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';
+                    for(let i = 0; i < times; i++)await this.pressKey(arrowKey);
+                }
+            },
+            touch: {
+                swipe: async (start, end, opts)=>{
+                    const duration = opts?.duration;
+                    const repeatCount = opts?.repeat ?? 1;
+                    const hdc = await this.getHdc();
+                    for(let i = 0; i < repeatCount; i++)await hdc.swipe(start.x, start.y, end.x, end.y, duration ? Math.round(duration) : void 0);
+                }
+            },
+            scroll: {
+                scroll: (param)=>this.performActionScroll(param)
+            }
+        });
         device_define_property(this, "remoteScreenshotPath", '/data/local/tmp/ms_screen.jpeg');
         device_define_property(this, "localScreenshotPath", null);
         external_node_assert_default()(deviceId, 'deviceId is required for HarmonyDevice');
@@ -1067,7 +1036,7 @@ class HarmonyMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.8.0",
+            version: "1.8.1",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ import type { ElementInfo } from '@midscene/shared/extractor';
 import { HarmonyDeviceOpt } from '@midscene/core/device';
 import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
 import { InterfaceType } from '@midscene/core';
-import { LocateResultElement } from '@midscene/core';
+import { MobileInputPrimitives } from '@midscene/core/device';
 import { overrideAIConfig } from '@midscene/shared/env';
 import { PlaygroundPlatformDescriptor } from '@midscene/playground';
 import { Point } from '@midscene/core';
@@ -61,7 +61,9 @@ export declare class HarmonyDevice implements AbstractInterface {
     interfaceType: InterfaceType;
     uri: string | undefined;
     options?: HarmonyDeviceOpt;
+    readonly inputPrimitives: MobileInputPrimitives;
     actionSpace(): DeviceAction<any>[];
+    private performActionScroll;
     constructor(deviceId: string, options?: HarmonyDeviceOpt);
     describe(): string;
     connect(): Promise<HdcClient>;
@@ -83,12 +85,12 @@ export declare class HarmonyDevice implements AbstractInterface {
     private remoteScreenshotPath;
     private localScreenshotPath;
     screenshotBase64(): Promise<string>;
-    tap(x: number, y: number): Promise<void>;
-    doubleTap(x: number, y: number): Promise<void>;
-    longPress(x: number, y: number): Promise<void>;
-    inputText(text: string, element?: LocateResultElement, shouldReplace?: boolean): Promise<void>;
+    private tapPoint;
+    private doubleTapPoint;
+    private longPressPoint;
+    private typeText;
     clearInput(element?: ElementInfo): Promise<void>;
-    keyboardPress(key: string): Promise<void>;
+    private pressKey;
     scroll(deltaX: number, deltaY: number, speed?: number): Promise<void>;
     private scrollInDirection;
     scrollDown(distance?: number, startPoint?: Point): Promise<void>;

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

@@ -12,7 +12,7 @@ import { InitArgSpec } from '@midscene/shared/mcp/base-tools';
 import { InterfaceType } from '@midscene/core';
 import { LaunchMCPServerOptions } from '@midscene/shared/mcp';
 import { LaunchMCPServerResult } from '@midscene/shared/mcp';
-import { LocateResultElement } from '@midscene/core';
+import { MobileInputPrimitives } from '@midscene/core/device';
 import { Point } from '@midscene/core';
 import { Size } from '@midscene/core';
 import { Tool } from '@midscene/shared/mcp';
@@ -59,7 +59,9 @@ declare class HarmonyDevice implements AbstractInterface {
     interfaceType: InterfaceType;
     uri: string | undefined;
     options?: HarmonyDeviceOpt;
+    readonly inputPrimitives: MobileInputPrimitives;
     actionSpace(): DeviceAction<any>[];
+    private performActionScroll;
     constructor(deviceId: string, options?: HarmonyDeviceOpt);
     describe(): string;
     connect(): Promise<HdcClient>;
@@ -81,12 +83,12 @@ declare class HarmonyDevice implements AbstractInterface {
     private remoteScreenshotPath;
     private localScreenshotPath;
     screenshotBase64(): Promise<string>;
-    tap(x: number, y: number): Promise<void>;
-    doubleTap(x: number, y: number): Promise<void>;
-    longPress(x: number, y: number): Promise<void>;
-    inputText(text: string, element?: LocateResultElement, shouldReplace?: boolean): Promise<void>;
+    private tapPoint;
+    private doubleTapPoint;
+    private longPressPoint;
+    private typeText;
     clearInput(element?: ElementInfo): Promise<void>;
-    keyboardPress(key: string): Promise<void>;
+    private pressKey;
     scroll(deltaX: number, deltaY: number, speed?: number): Promise<void>;
     private scrollInDirection;
     scrollDown(distance?: number, startPoint?: Point): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/harmony",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "HarmonyOS automation library for Midscene",
   "keywords": [
     "HarmonyOS UI automation",
@@ -41,9 +41,9 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/playground": "1.8.0",
-    "@midscene/shared": "1.8.0",
-    "@midscene/core": "1.8.0"
+    "@midscene/shared": "1.8.1",
+    "@midscene/playground": "1.8.1",
+    "@midscene/core": "1.8.1"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/889.c8e2e995.js"></script><script defer src="/static/js/index.7d3d953d.js"></script><link href="/static/css/index.63b028da.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.7b1abe58.js"></script><script defer src="/static/js/596.5426be9e.js"></script><script defer src="/static/js/index.acaa5ec1.js"></script><link href="/static/css/index.26c9c911.css" rel="stylesheet"></head><body><div id="root"></div></body></html>