@midscene/ios 1.9.2 → 1.9.3-beta-20260608113104.0

package/dist/es/bin.mjs

@@ -200,6 +200,7 @@ const debugIOS = getDebug('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -398,14 +399,57 @@ class IOSWebDriverClient extends WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await sleep(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -868,13 +912,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await sleep(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await sleep(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();

package/dist/es/cli.mjs

@@ -199,6 +199,7 @@ const debugIOS = getDebug('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -397,14 +398,57 @@ class IOSWebDriverClient extends WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await sleep(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -867,13 +911,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await sleep(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await sleep(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();
@@ -1453,7 +1509,7 @@ class IOSMidsceneTools extends BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 runToolsCLI(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.2",
+    version: "1.9.3-beta-20260608113104.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -20,6 +20,7 @@ const debugIOS = getDebug('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -218,14 +219,57 @@ class IOSWebDriverClient extends WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await sleep(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -688,13 +732,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await sleep(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await sleep(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();

package/dist/es/mcp-server.mjs

@@ -199,6 +199,7 @@ const debugIOS = getDebug('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -397,14 +398,57 @@ class IOSWebDriverClient extends WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await sleep(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -867,13 +911,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await sleep(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await sleep(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();
@@ -1457,7 +1513,7 @@ class IOSMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/ios-mcp',
-            version: "1.9.2",
+            version: "1.9.3-beta-20260608113104.0",
             description: 'Control the iOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -225,6 +225,7 @@ const debugIOS = (0, logger_namespaceObject.getDebug)('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -423,14 +424,57 @@ class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await (0, core_utils_namespaceObject.sleep)(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -893,13 +937,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await (0, core_utils_namespaceObject.sleep)(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await (0, core_utils_namespaceObject.sleep)(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();

package/dist/lib/cli.js

@@ -223,6 +223,7 @@ const debugIOS = (0, logger_namespaceObject.getDebug)('webdriver:ios');
 const WDA_MJPEG_SCREENSHOT_QUALITY = 50;
 const WDA_MJPEG_FRAMERATE = 30;
 const WDA_MJPEG_SCALING_FACTOR = 50;
+const XCUI_KEY_MODIFIER_COMMAND = 16;
 class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
     async launchApp(bundleId) {
         this.ensureSession();
@@ -421,14 +422,57 @@ class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
             return false;
         }
     }
-    async typeText(text) {
+    async pasteText(text) {
         this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
         try {
-            const cleanText = text.trim();
-            await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
-                value: cleanText.split('')
+            await this.setPasteboardText(cleanText);
+            await this.sendPasteShortcut();
+            debugIOS(`Pasted text: "${text}"`);
+        } catch (error) {
+            debugIOS(`Failed to paste text "${text}": ${error}`);
+            throw new Error(`Failed to paste text: ${error}`);
+        }
+    }
+    async setPasteboardText(text) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/setPasteboard`, {
+            content: Buffer.from(text, 'utf8').toString('base64'),
+            contentType: 'plaintext'
+        });
+    }
+    async sendPasteShortcut() {
+        this.ensureSession();
+        const elementId = await this.getActiveElement() ?? '0';
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/element/${elementId}/keyboardInput`, {
+            keys: [
+                {
+                    key: 'v',
+                    modifierFlags: XCUI_KEY_MODIFIER_COMMAND
+                }
+            ]
+        });
+    }
+    async typeText(text, options) {
+        this.ensureSession();
+        const cleanText = text.trim();
+        if (!cleanText) return;
+        const chars = Array.from(cleanText);
+        const delayMs = options?.delayMs ?? 0;
+        try {
+            if (delayMs > 0) for(let i = 0; i < chars.length; i++){
+                await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                    value: [
+                        chars[i]
+                    ]
+                });
+                if (i < chars.length - 1) await (0, core_utils_namespaceObject.sleep)(delayMs);
+            }
+            else await this.makeRequest('POST', `/session/${this.sessionId}/wda/keys`, {
+                value: chars
             });
-            debugIOS(`Typed text: "${text}"`);
+            debugIOS(`Typed text: "${text}" (delayMs=${delayMs})`);
         } catch (error) {
             debugIOS(`Failed to type text "${text}": ${error}`);
             throw new Error(`Failed to type text: ${error}`);
@@ -891,13 +935,25 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async typeText(text, options) {
         if (!text) return;
         const shouldAutoDismissKeyboard = options?.autoDismissKeyboard ?? this.options?.autoDismissKeyboard ?? true;
-        debugDevice(`Typing text: "${text}"`);
+        const delayMs = options?.keyboardTypeDelay ?? this.options?.keyboardTypeDelay ?? 80;
+        const keyboardInputStrategy = options?.keyboardInputStrategy ?? this.options?.keyboardInputStrategy ?? 'paste';
+        debugDevice(`Input text: "${text}" (strategy=${keyboardInputStrategy}, delayMs=${delayMs})`);
         try {
             await (0, core_utils_namespaceObject.sleep)(200);
-            await this.wdaBackend.typeText(text);
+            if ('type' === keyboardInputStrategy) await this.wdaBackend.typeText(text, {
+                delayMs
+            });
+            else try {
+                await this.wdaBackend.pasteText(text);
+            } catch (pasteError) {
+                debugDevice(`Failed to paste text with WDA, falling back to typing: ${pasteError}`);
+                await this.wdaBackend.typeText(text, {
+                    delayMs
+                });
+            }
             await (0, core_utils_namespaceObject.sleep)(300);
         } catch (error) {
-            debugDevice(`Failed to type text with WDA: ${error}`);
+            debugDevice(`Failed to input text with WDA: ${error}`);
             throw error;
         }
         if (shouldAutoDismissKeyboard) await this.hideKeyboard();
@@ -1477,7 +1533,7 @@ class IOSMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
 const tools = new IOSMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-ios', {
     stripPrefix: 'ios_',
-    version: "1.9.2",
+    version: "1.9.3-beta-20260608113104.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));