type_text
Type text into the currently focused Android input field. Optionally specify device ID and platform for targeted input.
Instructions
Purpose: Type text into the currently focused Android input field.
Inputs:
text
platform/deviceId (optional)
Output Structure:
action_id, timestamp (ISO 8601), action_type
lifecycle_state: post-dispatch lifecycle state (pending_verification or failed)
source_module: runtime source of the action envelope
target.selector = { text }
success = true when text input was dispatched
failure_code/retryable when dispatch fails
ui_fingerprint_before/ui_fingerprint_after when available
Recommended Usage:
Resolve or focus the target input first
Call type_text
If needed, wait for UI stabilization using wait_for_*
Verify with expect_element_visible or expect_screen, depending on the intended outcome
Verification Guidance:
Prefer verifying the next expected element or screen state instead of inferring success from the text action alone
Follow RESOLVE → ACT → WAIT (if needed) → EXPECT
Do not use wait_for_* alone as final verification when an applicable expect_* tool exists
Failure Handling:
TIMEOUT → retry once
UNKNOWN → re-focus the input or capture a snapshot
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The text to type | |
| deviceId | No | Device Serial/UDID. Defaults to connected/booted device. | |
| platform | No | Platform to type on (currently only android supported) |