@midscene/harmony 1.8.7 → 1.8.8-beta-20260601092817.0

package/dist/lib/bin.js

@@ -156,6 +156,13 @@ class HdcClient {
     async screenshot(remotePath) {
         return await this.shell(`snapshot_display -f ${remotePath}`);
     }
+    async dumpLayout() {
+        const remotePath = '/data/local/tmp/midscene_layout.json';
+        const output = await this.shell(`uitest dumpLayout -p ${remotePath} && cat ${remotePath}`);
+        const jsonStart = output.indexOf('{');
+        if (jsonStart < 0) throw new Error(`dumpLayout: no JSON body in output: ${output.slice(0, 200)}`);
+        return output.slice(jsonStart);
+    }
     async click(x, y) {
         await this.shell(`uitest uiInput click ${Math.round(x)} ${Math.round(y)}`);
     }
@@ -203,9 +210,17 @@ class HdcClient {
         await this.shell(`uitest uiInput keyEvent ${keys.join(' ')}`);
     }
     async clearTextField(length = 100) {
-        const keys = [];
-        for(let i = 0; i < length; i++)keys.push('2055', '2071');
-        await this.keyEvent(...keys);
+        if (length <= 0) return;
+        const MAX_KEYS_PER_CALL = 3;
+        const cmds = [];
+        let remaining = length;
+        while(remaining > 0){
+            const n = Math.min(MAX_KEYS_PER_CALL, remaining);
+            const codes = Array(n).fill('2055').join(' ');
+            cmds.push(`uitest uiInput keyEvent ${codes}`);
+            remaining -= n;
+        }
+        await this.shell(cmds.join(';'));
     }
     async startAbility(bundleName, abilityName) {
         const output = await this.shell(`aa start -a ${abilityName} -b ${bundleName}`);
@@ -286,6 +301,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
 let screenshotResizeScaleWarned = false;
+const INPUT_FIELD_TYPES = new Set([
+    'TextInput',
+    'TextArea',
+    'SearchField'
+]);
+function parseBounds(raw) {
+    if ('string' != typeof raw) return null;
+    const m = raw.match(/\[(-?\d+),(-?\d+)\]\[(-?\d+),(-?\d+)\]/);
+    if (!m) return null;
+    return {
+        x1: Number(m[1]),
+        y1: Number(m[2]),
+        x2: Number(m[3]),
+        y2: Number(m[4])
+    };
+}
+function collectInputFields(layout) {
+    const fields = [];
+    const visit = (node)=>{
+        if (!node || 'object' != typeof node) return;
+        const n = node;
+        const attrs = n.attributes ?? {};
+        if (INPUT_FIELD_TYPES.has(String(attrs.type))) {
+            const bounds = parseBounds(attrs.bounds);
+            if (bounds) fields.push({
+                text: String(attrs.text ?? ''),
+                bounds
+            });
+        }
+        for (const child of n.children ?? [])visit(child);
+    };
+    visit(layout);
+    return fields;
+}
+function pickFieldByPoint(fields, point) {
+    const [px, py] = point;
+    return fields.find(({ bounds: b })=>px >= b.x1 && px <= b.x2 && py >= b.y1 && py <= b.y2);
+}
+function pickLongestField(fields) {
+    return fields.reduce((a, b)=>b.text.length > a.text.length ? b : a);
+}
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -521,12 +577,13 @@ class device_HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await (0, core_utils_namespaceObject.sleep)(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
         await hdc.inputText(x, y, text);
-        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard;
-        if (shouldAutoDismissKeyboard) await this.hideKeyboard();
+        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
+        if (shouldAutoDismissKeyboard) await this.hideKeyboard(options);
     }
     async clearInput(element) {
         const hdc = await this.getHdc();
@@ -534,7 +591,24 @@ class device_HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
-        await hdc.clearTextField(100);
+        const length = await this.resolveClearLength(element);
+        if (length > 0) await hdc.clearTextField(length);
+    }
+    async resolveClearLength(element) {
+        const PADDING = 2;
+        const FALLBACK_LENGTH = 100;
+        try {
+            const hdc = await this.getHdc();
+            const layoutJson = await hdc.dumpLayout();
+            const layout = JSON.parse(layoutJson);
+            const fields = collectInputFields(layout);
+            if (0 === fields.length) return FALLBACK_LENGTH;
+            const target = element ? pickFieldByPoint(fields, element.center) ?? pickLongestField(fields) : pickLongestField(fields);
+            return target.text.length + PADDING;
+        } catch (e) {
+            debugDevice(`resolveClearLength: layout probe failed, falling back to ${FALLBACK_LENGTH}: ${e}`);
+            return FALLBACK_LENGTH;
+        }
     }
     async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
@@ -697,9 +771,11 @@ class device_HarmonyDevice {
         const hdc = await this.getHdc();
         await hdc.keyEvent('RecentApps');
     }
-    async hideKeyboard() {
+    async hideKeyboard(options) {
         const hdc = await this.getHdc();
-        await hdc.keyEvent('Back');
+        const keyboardDismissStrategy = options?.keyboardDismissStrategy ?? this.options?.keyboardDismissStrategy ?? 'esc-first';
+        const key = 'back-first' === keyboardDismissStrategy ? 'Back' : harmonyKeyCodeMap.Escape;
+        await hdc.keyEvent(key);
     }
     async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const hdc = await this.getHdc();
@@ -748,9 +824,13 @@ class device_HarmonyDevice {
             },
             keyboard: {
                 keyboardPress: (keyName)=>this.pressKey(keyName),
-                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true, {
-                        autoDismissKeyboard: opts?.autoDismissKeyboard
-                    }),
+                typeText: (value, opts)=>{
+                    const harmonyOpts = opts;
+                    return harmonyOpts?.focusOnly ? Promise.resolve() : this.typeText(value, harmonyOpts?.target, harmonyOpts?.replace ?? true, {
+                        autoDismissKeyboard: harmonyOpts?.autoDismissKeyboard,
+                        keyboardDismissStrategy: harmonyOpts?.keyboardDismissStrategy
+                    });
+                },
                 clearInput: (target)=>this.clearInput(target),
                 cursorMove: async (direction, times = 1)=>{
                     const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';

package/dist/lib/cli.js

@@ -152,6 +152,13 @@ class HdcClient {
     async screenshot(remotePath) {
         return await this.shell(`snapshot_display -f ${remotePath}`);
     }
+    async dumpLayout() {
+        const remotePath = '/data/local/tmp/midscene_layout.json';
+        const output = await this.shell(`uitest dumpLayout -p ${remotePath} && cat ${remotePath}`);
+        const jsonStart = output.indexOf('{');
+        if (jsonStart < 0) throw new Error(`dumpLayout: no JSON body in output: ${output.slice(0, 200)}`);
+        return output.slice(jsonStart);
+    }
     async click(x, y) {
         await this.shell(`uitest uiInput click ${Math.round(x)} ${Math.round(y)}`);
     }
@@ -199,9 +206,17 @@ class HdcClient {
         await this.shell(`uitest uiInput keyEvent ${keys.join(' ')}`);
     }
     async clearTextField(length = 100) {
-        const keys = [];
-        for(let i = 0; i < length; i++)keys.push('2055', '2071');
-        await this.keyEvent(...keys);
+        if (length <= 0) return;
+        const MAX_KEYS_PER_CALL = 3;
+        const cmds = [];
+        let remaining = length;
+        while(remaining > 0){
+            const n = Math.min(MAX_KEYS_PER_CALL, remaining);
+            const codes = Array(n).fill('2055').join(' ');
+            cmds.push(`uitest uiInput keyEvent ${codes}`);
+            remaining -= n;
+        }
+        await this.shell(cmds.join(';'));
     }
     async startAbility(bundleName, abilityName) {
         const output = await this.shell(`aa start -a ${abilityName} -b ${bundleName}`);
@@ -282,6 +297,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
 let screenshotResizeScaleWarned = false;
+const INPUT_FIELD_TYPES = new Set([
+    'TextInput',
+    'TextArea',
+    'SearchField'
+]);
+function parseBounds(raw) {
+    if ('string' != typeof raw) return null;
+    const m = raw.match(/\[(-?\d+),(-?\d+)\]\[(-?\d+),(-?\d+)\]/);
+    if (!m) return null;
+    return {
+        x1: Number(m[1]),
+        y1: Number(m[2]),
+        x2: Number(m[3]),
+        y2: Number(m[4])
+    };
+}
+function collectInputFields(layout) {
+    const fields = [];
+    const visit = (node)=>{
+        if (!node || 'object' != typeof node) return;
+        const n = node;
+        const attrs = n.attributes ?? {};
+        if (INPUT_FIELD_TYPES.has(String(attrs.type))) {
+            const bounds = parseBounds(attrs.bounds);
+            if (bounds) fields.push({
+                text: String(attrs.text ?? ''),
+                bounds
+            });
+        }
+        for (const child of n.children ?? [])visit(child);
+    };
+    visit(layout);
+    return fields;
+}
+function pickFieldByPoint(fields, point) {
+    const [px, py] = point;
+    return fields.find(({ bounds: b })=>px >= b.x1 && px <= b.x2 && py >= b.y1 && py <= b.y2);
+}
+function pickLongestField(fields) {
+    return fields.reduce((a, b)=>b.text.length > a.text.length ? b : a);
+}
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -517,12 +573,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await (0, core_utils_namespaceObject.sleep)(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
         await hdc.inputText(x, y, text);
-        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard;
-        if (shouldAutoDismissKeyboard) await this.hideKeyboard();
+        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
+        if (shouldAutoDismissKeyboard) await this.hideKeyboard(options);
     }
     async clearInput(element) {
         const hdc = await this.getHdc();
@@ -530,7 +587,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
-        await hdc.clearTextField(100);
+        const length = await this.resolveClearLength(element);
+        if (length > 0) await hdc.clearTextField(length);
+    }
+    async resolveClearLength(element) {
+        const PADDING = 2;
+        const FALLBACK_LENGTH = 100;
+        try {
+            const hdc = await this.getHdc();
+            const layoutJson = await hdc.dumpLayout();
+            const layout = JSON.parse(layoutJson);
+            const fields = collectInputFields(layout);
+            if (0 === fields.length) return FALLBACK_LENGTH;
+            const target = element ? pickFieldByPoint(fields, element.center) ?? pickLongestField(fields) : pickLongestField(fields);
+            return target.text.length + PADDING;
+        } catch (e) {
+            debugDevice(`resolveClearLength: layout probe failed, falling back to ${FALLBACK_LENGTH}: ${e}`);
+            return FALLBACK_LENGTH;
+        }
     }
     async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
@@ -693,9 +767,11 @@ class HarmonyDevice {
         const hdc = await this.getHdc();
         await hdc.keyEvent('RecentApps');
     }
-    async hideKeyboard() {
+    async hideKeyboard(options) {
         const hdc = await this.getHdc();
-        await hdc.keyEvent('Back');
+        const keyboardDismissStrategy = options?.keyboardDismissStrategy ?? this.options?.keyboardDismissStrategy ?? 'esc-first';
+        const key = 'back-first' === keyboardDismissStrategy ? 'Back' : harmonyKeyCodeMap.Escape;
+        await hdc.keyEvent(key);
     }
     async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const hdc = await this.getHdc();
@@ -744,9 +820,13 @@ class HarmonyDevice {
             },
             keyboard: {
                 keyboardPress: (keyName)=>this.pressKey(keyName),
-                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true, {
-                        autoDismissKeyboard: opts?.autoDismissKeyboard
-                    }),
+                typeText: (value, opts)=>{
+                    const harmonyOpts = opts;
+                    return harmonyOpts?.focusOnly ? Promise.resolve() : this.typeText(value, harmonyOpts?.target, harmonyOpts?.replace ?? true, {
+                        autoDismissKeyboard: harmonyOpts?.autoDismissKeyboard,
+                        keyboardDismissStrategy: harmonyOpts?.keyboardDismissStrategy
+                    });
+                },
                 clearInput: (target)=>this.clearInput(target),
                 cursorMove: async (direction, times = 1)=>{
                     const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';
@@ -1013,7 +1093,7 @@ class HarmonyMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.8.7",
+    version: "1.8.8-beta-20260601092817.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -135,6 +135,13 @@ class HdcClient {
     async screenshot(remotePath) {
         return await this.shell(`snapshot_display -f ${remotePath}`);
     }
+    async dumpLayout() {
+        const remotePath = '/data/local/tmp/midscene_layout.json';
+        const output = await this.shell(`uitest dumpLayout -p ${remotePath} && cat ${remotePath}`);
+        const jsonStart = output.indexOf('{');
+        if (jsonStart < 0) throw new Error(`dumpLayout: no JSON body in output: ${output.slice(0, 200)}`);
+        return output.slice(jsonStart);
+    }
     async click(x, y) {
         await this.shell(`uitest uiInput click ${Math.round(x)} ${Math.round(y)}`);
     }
@@ -182,9 +189,17 @@ class HdcClient {
         await this.shell(`uitest uiInput keyEvent ${keys.join(' ')}`);
     }
     async clearTextField(length = 100) {
-        const keys = [];
-        for(let i = 0; i < length; i++)keys.push('2055', '2071');
-        await this.keyEvent(...keys);
+        if (length <= 0) return;
+        const MAX_KEYS_PER_CALL = 3;
+        const cmds = [];
+        let remaining = length;
+        while(remaining > 0){
+            const n = Math.min(MAX_KEYS_PER_CALL, remaining);
+            const codes = Array(n).fill('2055').join(' ');
+            cmds.push(`uitest uiInput keyEvent ${codes}`);
+            remaining -= n;
+        }
+        await this.shell(cmds.join(';'));
     }
     async startAbility(bundleName, abilityName) {
         const output = await this.shell(`aa start -a ${abilityName} -b ${bundleName}`);
@@ -265,6 +280,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
 let screenshotResizeScaleWarned = false;
+const INPUT_FIELD_TYPES = new Set([
+    'TextInput',
+    'TextArea',
+    'SearchField'
+]);
+function parseBounds(raw) {
+    if ('string' != typeof raw) return null;
+    const m = raw.match(/\[(-?\d+),(-?\d+)\]\[(-?\d+),(-?\d+)\]/);
+    if (!m) return null;
+    return {
+        x1: Number(m[1]),
+        y1: Number(m[2]),
+        x2: Number(m[3]),
+        y2: Number(m[4])
+    };
+}
+function collectInputFields(layout) {
+    const fields = [];
+    const visit = (node)=>{
+        if (!node || 'object' != typeof node) return;
+        const n = node;
+        const attrs = n.attributes ?? {};
+        if (INPUT_FIELD_TYPES.has(String(attrs.type))) {
+            const bounds = parseBounds(attrs.bounds);
+            if (bounds) fields.push({
+                text: String(attrs.text ?? ''),
+                bounds
+            });
+        }
+        for (const child of n.children ?? [])visit(child);
+    };
+    visit(layout);
+    return fields;
+}
+function pickFieldByPoint(fields, point) {
+    const [px, py] = point;
+    return fields.find(({ bounds: b })=>px >= b.x1 && px <= b.x2 && py >= b.y1 && py <= b.y2);
+}
+function pickLongestField(fields) {
+    return fields.reduce((a, b)=>b.text.length > a.text.length ? b : a);
+}
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -500,12 +556,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await (0, utils_namespaceObject.sleep)(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await (0, utils_namespaceObject.sleep)(100);
         }
         await hdc.inputText(x, y, text);
-        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard;
-        if (shouldAutoDismissKeyboard) await this.hideKeyboard();
+        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
+        if (shouldAutoDismissKeyboard) await this.hideKeyboard(options);
     }
     async clearInput(element) {
         const hdc = await this.getHdc();
@@ -513,7 +570,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await (0, utils_namespaceObject.sleep)(100);
         }
-        await hdc.clearTextField(100);
+        const length = await this.resolveClearLength(element);
+        if (length > 0) await hdc.clearTextField(length);
+    }
+    async resolveClearLength(element) {
+        const PADDING = 2;
+        const FALLBACK_LENGTH = 100;
+        try {
+            const hdc = await this.getHdc();
+            const layoutJson = await hdc.dumpLayout();
+            const layout = JSON.parse(layoutJson);
+            const fields = collectInputFields(layout);
+            if (0 === fields.length) return FALLBACK_LENGTH;
+            const target = element ? pickFieldByPoint(fields, element.center) ?? pickLongestField(fields) : pickLongestField(fields);
+            return target.text.length + PADDING;
+        } catch (e) {
+            debugDevice(`resolveClearLength: layout probe failed, falling back to ${FALLBACK_LENGTH}: ${e}`);
+            return FALLBACK_LENGTH;
+        }
     }
     async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
@@ -676,9 +750,11 @@ class HarmonyDevice {
         const hdc = await this.getHdc();
         await hdc.keyEvent('RecentApps');
     }
-    async hideKeyboard() {
+    async hideKeyboard(options) {
         const hdc = await this.getHdc();
-        await hdc.keyEvent('Back');
+        const keyboardDismissStrategy = options?.keyboardDismissStrategy ?? this.options?.keyboardDismissStrategy ?? 'esc-first';
+        const key = 'back-first' === keyboardDismissStrategy ? 'Back' : harmonyKeyCodeMap.Escape;
+        await hdc.keyEvent(key);
     }
     async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const hdc = await this.getHdc();
@@ -727,9 +803,13 @@ class HarmonyDevice {
             },
             keyboard: {
                 keyboardPress: (keyName)=>this.pressKey(keyName),
-                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true, {
-                        autoDismissKeyboard: opts?.autoDismissKeyboard
-                    }),
+                typeText: (value, opts)=>{
+                    const harmonyOpts = opts;
+                    return harmonyOpts?.focusOnly ? Promise.resolve() : this.typeText(value, harmonyOpts?.target, harmonyOpts?.replace ?? true, {
+                        autoDismissKeyboard: harmonyOpts?.autoDismissKeyboard,
+                        keyboardDismissStrategy: harmonyOpts?.keyboardDismissStrategy
+                    });
+                },
                 clearInput: (target)=>this.clearInput(target),
                 cursorMove: async (direction, times = 1)=>{
                     const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';

package/dist/lib/mcp-server.js

@@ -168,6 +168,13 @@ class HdcClient {
     async screenshot(remotePath) {
         return await this.shell(`snapshot_display -f ${remotePath}`);
     }
+    async dumpLayout() {
+        const remotePath = '/data/local/tmp/midscene_layout.json';
+        const output = await this.shell(`uitest dumpLayout -p ${remotePath} && cat ${remotePath}`);
+        const jsonStart = output.indexOf('{');
+        if (jsonStart < 0) throw new Error(`dumpLayout: no JSON body in output: ${output.slice(0, 200)}`);
+        return output.slice(jsonStart);
+    }
     async click(x, y) {
         await this.shell(`uitest uiInput click ${Math.round(x)} ${Math.round(y)}`);
     }
@@ -215,9 +222,17 @@ class HdcClient {
         await this.shell(`uitest uiInput keyEvent ${keys.join(' ')}`);
     }
     async clearTextField(length = 100) {
-        const keys = [];
-        for(let i = 0; i < length; i++)keys.push('2055', '2071');
-        await this.keyEvent(...keys);
+        if (length <= 0) return;
+        const MAX_KEYS_PER_CALL = 3;
+        const cmds = [];
+        let remaining = length;
+        while(remaining > 0){
+            const n = Math.min(MAX_KEYS_PER_CALL, remaining);
+            const codes = Array(n).fill('2055').join(' ');
+            cmds.push(`uitest uiInput keyEvent ${codes}`);
+            remaining -= n;
+        }
+        await this.shell(cmds.join(';'));
     }
     async startAbility(bundleName, abilityName) {
         const output = await this.shell(`aa start -a ${abilityName} -b ${bundleName}`);
@@ -298,6 +313,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
 let screenshotResizeScaleWarned = false;
+const INPUT_FIELD_TYPES = new Set([
+    'TextInput',
+    'TextArea',
+    'SearchField'
+]);
+function parseBounds(raw) {
+    if ('string' != typeof raw) return null;
+    const m = raw.match(/\[(-?\d+),(-?\d+)\]\[(-?\d+),(-?\d+)\]/);
+    if (!m) return null;
+    return {
+        x1: Number(m[1]),
+        y1: Number(m[2]),
+        x2: Number(m[3]),
+        y2: Number(m[4])
+    };
+}
+function collectInputFields(layout) {
+    const fields = [];
+    const visit = (node)=>{
+        if (!node || 'object' != typeof node) return;
+        const n = node;
+        const attrs = n.attributes ?? {};
+        if (INPUT_FIELD_TYPES.has(String(attrs.type))) {
+            const bounds = parseBounds(attrs.bounds);
+            if (bounds) fields.push({
+                text: String(attrs.text ?? ''),
+                bounds
+            });
+        }
+        for (const child of n.children ?? [])visit(child);
+    };
+    visit(layout);
+    return fields;
+}
+function pickFieldByPoint(fields, point) {
+    const [px, py] = point;
+    return fields.find(({ bounds: b })=>px >= b.x1 && px <= b.x2 && py >= b.y1 && py <= b.y2);
+}
+function pickLongestField(fields) {
+    return fields.reduce((a, b)=>b.text.length > a.text.length ? b : a);
+}
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -533,12 +589,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await (0, core_utils_namespaceObject.sleep)(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
         await hdc.inputText(x, y, text);
-        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard;
-        if (shouldAutoDismissKeyboard) await this.hideKeyboard();
+        const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
+        if (shouldAutoDismissKeyboard) await this.hideKeyboard(options);
     }
     async clearInput(element) {
         const hdc = await this.getHdc();
@@ -546,7 +603,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await (0, core_utils_namespaceObject.sleep)(100);
         }
-        await hdc.clearTextField(100);
+        const length = await this.resolveClearLength(element);
+        if (length > 0) await hdc.clearTextField(length);
+    }
+    async resolveClearLength(element) {
+        const PADDING = 2;
+        const FALLBACK_LENGTH = 100;
+        try {
+            const hdc = await this.getHdc();
+            const layoutJson = await hdc.dumpLayout();
+            const layout = JSON.parse(layoutJson);
+            const fields = collectInputFields(layout);
+            if (0 === fields.length) return FALLBACK_LENGTH;
+            const target = element ? pickFieldByPoint(fields, element.center) ?? pickLongestField(fields) : pickLongestField(fields);
+            return target.text.length + PADDING;
+        } catch (e) {
+            debugDevice(`resolveClearLength: layout probe failed, falling back to ${FALLBACK_LENGTH}: ${e}`);
+            return FALLBACK_LENGTH;
+        }
     }
     async pressKey(key) {
         const normalizedKey = keyNameAliasMap[key.toLowerCase()] ?? key;
@@ -709,9 +783,11 @@ class HarmonyDevice {
         const hdc = await this.getHdc();
         await hdc.keyEvent('RecentApps');
     }
-    async hideKeyboard() {
+    async hideKeyboard(options) {
         const hdc = await this.getHdc();
-        await hdc.keyEvent('Back');
+        const keyboardDismissStrategy = options?.keyboardDismissStrategy ?? this.options?.keyboardDismissStrategy ?? 'esc-first';
+        const key = 'back-first' === keyboardDismissStrategy ? 'Back' : harmonyKeyCodeMap.Escape;
+        await hdc.keyEvent(key);
     }
     async getDeviceLocalTimeString(format = 'YYYY-MM-DD HH:mm:ss') {
         const hdc = await this.getHdc();
@@ -760,9 +836,13 @@ class HarmonyDevice {
             },
             keyboard: {
                 keyboardPress: (keyName)=>this.pressKey(keyName),
-                typeText: (value, opts)=>opts?.focusOnly ? Promise.resolve() : this.typeText(value, opts?.target, opts?.replace ?? true, {
-                        autoDismissKeyboard: opts?.autoDismissKeyboard
-                    }),
+                typeText: (value, opts)=>{
+                    const harmonyOpts = opts;
+                    return harmonyOpts?.focusOnly ? Promise.resolve() : this.typeText(value, harmonyOpts?.target, harmonyOpts?.replace ?? true, {
+                        autoDismissKeyboard: harmonyOpts?.autoDismissKeyboard,
+                        keyboardDismissStrategy: harmonyOpts?.keyboardDismissStrategy
+                    });
+                },
                 clearInput: (target)=>this.clearInput(target),
                 cursorMove: async (direction, times = 1)=>{
                     const arrowKey = 'left' === direction ? 'ArrowLeft' : 'ArrowRight';
@@ -1033,7 +1113,7 @@ class HarmonyMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.8.7",
+            version: "1.8.8-beta-20260601092817.0",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }