@midscene/harmony 1.8.7 → 1.8.8-beta-20260601092817.0

package/dist/es/bin.mjs

@@ -130,6 +130,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)}`);
     }
@@ -177,9 +184,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}`);
@@ -260,6 +275,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = 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',
@@ -495,12 +551,13 @@ class device_HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await sleep(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await 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();
@@ -508,7 +565,24 @@ class device_HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await 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;
@@ -671,9 +745,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();
@@ -722,9 +798,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/es/cli.mjs

@@ -127,6 +127,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)}`);
     }
@@ -174,9 +181,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}`);
@@ -257,6 +272,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = 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',
@@ -492,12 +548,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await sleep(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await 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();
@@ -505,7 +562,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await 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;
@@ -668,9 +742,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();
@@ -719,9 +795,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';
@@ -988,7 +1068,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.8.7",
+    version: "1.8.8-beta-20260601092817.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -98,6 +98,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)}`);
     }
@@ -145,9 +152,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}`);
@@ -228,6 +243,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = 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',
@@ -463,12 +519,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await sleep(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await 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();
@@ -476,7 +533,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await 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;
@@ -639,9 +713,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();
@@ -690,9 +766,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/es/mcp-server.mjs

@@ -127,6 +127,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)}`);
     }
@@ -174,9 +181,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}`);
@@ -257,6 +272,47 @@ const scrollQuadrantDivisions = 4;
 const screenEdgeMargin = 50;
 const debugDevice = 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',
@@ -492,12 +548,13 @@ class HarmonyDevice {
         if (shouldReplace) {
             await hdc.click(x, y);
             await sleep(100);
-            await hdc.clearTextField(100);
+            const length = await this.resolveClearLength(element);
+            if (length > 0) await hdc.clearTextField(length);
             await 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();
@@ -505,7 +562,24 @@ class HarmonyDevice {
             await hdc.click(element.center[0], element.center[1]);
             await 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;
@@ -668,9 +742,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();
@@ -719,9 +795,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';
@@ -992,7 +1072,7 @@ class HarmonyMCPServer extends 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);
     }