Limrun Android: `fill` inserts at the cursor instead of replacing the field's text
Maintainers usually reply within 1 day
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 62/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- android, typescript
- Domain
- mobile
Research direction
Start in the Android fill path where agent-device returns after the provider-native provider.text call, since that call skips the adb clear, verify and retry steps (KEYCODE_MOVE_END and KEYCODE_DEL). The Limrun instance client's setText and pressKey calls are the relevant entry points. Done means fill on a field with existing text leaves exactly the new value, and a mismatch is reported rather than passing silently. Reproduce with the Settings search field commands in the issue.
Written by the indexing model from the issue text.
Description
Summary
On a Limrun Android instance, fill does not replace the existing contents of a text field. The new text is inserted wherever the tap leaves the cursor, so filling a field that already has a value produces a concatenation of the old and new text. The help text says fill <target> <text> replaces, and that is what happens on local emulators.
Environment
- agent-device: 0.21.15, and the same code path is present in 0.21.24 (latest at the time of writing)
- Provider: Limrun, Android instance (
agent-device connect limrun --platform android) - Keyboard on the instance:
com.android.inputmethod.latin(the agent-device test IME is not active) - App: the system Settings app (any
EditTextreproduces it)
Steps to reproduce
agent-device connect limrun --platform android --run-id fill-repro --session repro
agent-device open settings --platform android --session repro
agent-device snapshot -i --platform android --session repro # find "Search Settings"
agent-device click @e2 --platform android --session repro # opens the search field
agent-device fill @e7 "[email protected]" --platform android --session repro
agent-device fill @e7 "[email protected]" --platform android --session repro
agent-device snapshot -i --platform android --session repro
Expected
After the second fill, the field contains:
[email protected]
Actual
The second fill taps the field center, which puts the cursor inside the existing value, and inserts the text there:
[email protected][email protected]
Both fill calls exit successfully. A caller that does not re-read the field carries on with the wrong value.
Cause
On Android, fill first checks whether the device provider supplies its own text entry. Limrun does (provider.text → the Limrun instance client's setText({ x, y }, text)), so agent-device returns after that call. It never reaches the Android path that clears the field (KEYCODE_MOVE_END + KEYCODE_DEL), verifies the result and retries, or uses the test IME.
Calling the Limrun Android instance client directly on the same instance shows that setText never replaces:
| Call | Result |
|---|---|
setText({ x, y }, text) (what agent-device sends) |
inserted at the cursor |
setText({ selector: { focused: true } }, text) |
inserted at the cursor |
setText(undefined, text) |
inserted at the cursor |
setText({ selector: { focused: true } }, '') |
rejected: text is required |
So with the provider-native path there is currently no way to clear the field before typing.
Workaround that worked
Selecting all and deleting with hardware key events before setText, through the same Limrun instance client:
await client.pressKey('a', ['ctrl']);
await client.pressKey('del');
await client.setText(undefined, text);
This left the field holding exactly the requested text in 3 of 3 runs. The select and delete took about 350 ms together; setText took about 1 s.
Suggested fix
For a Limrun Android fill, clear the focused field before the provider-native setText (for example with the Ctrl+A / Delete key events above), then run the existing verification so a mismatch is reported instead of passing silently. Alternatively, route Limrun Android fill through the existing adb clear/verify/retry path or the test IME.
Possibly related (not reproduced)
In one run, a fill into a field that had just taken focus from another field lost its first character (jane… arrived as ane…). I could not reproduce it on a single field in 4 attempts, so it is mentioned only in case it shares the cause.
- Dominant language
- TypeScript
- Stars
- 4.9k
- Forks
- 328
- Avg merge
- 12h 16m
- Merged PRs (30d)
- 538
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from callstack/agent-device
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
callstack/agent-device#3353 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
callstack/agent-device#1869 ·
Maintainers usually reply within 1 day
-
Difficulty 3/5 Half a day Newbie friendliness 42/100
callstack/agent-device#3360 ·
Maintainers usually reply within 1 day
-
needs-triage
Difficulty 5/5 Over a week Newbie friendliness 15/100
callstack/agent-device#3359 ·
Maintainers usually reply within 1 day
-
iOS selector click taps a point resolved from a pre-tap capture, so a layout shift between capture and tap retargets it silentlyPossibly taken @thymikee claimed this 1 day ago. Open
Difficulty 4/5 3-5 days Newbie friendliness 25/100
callstack/agent-device#3354 ·
Maintainers usually reply within 1 day
All issues in callstack/agent-device
Similar issues
-
awaiting-response bug needs-triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
wildcard/caro#1562 · 1 comment ·
Maintainers usually reply within 3 days
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100
supadata-ai/mcp#27 ·
-
content
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
cosimochellini/one-piece-zero-spoiler#516 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
capricorn86/happy-dom#2485 ·
Maintainers usually reply within 2 days
-
lane: fast
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
unicef/adt-studio#946 ·
Maintainers usually reply within 2 days