agent.actions.text

Actions

Keyboard input and clipboard operations.

Access these methods through agent.actions. Type text, manage clipboard, and handle keyboard interactions.

writeText()

TypeScript

writeText(text: string): Promise<void>

Types text using keyboard input. The keyboard must be visible.

Parameters

Name	Type	Description
`text`	string	Text to type.

Returns

Promise<void>Resolves when text is typed.

Examples

TypeScript

await agent.actions.writeText("Hello World");

copyText()

TypeScript

copyText(text: string): Promise<void>

Copies the specified text to the system clipboard.

Parameters

Name	Type	Description
`text`	string	Text to copy to clipboard.

Returns

Promise<void>Resolves when copy is complete.

Examples

TypeScript

await agent.actions.copyText("Text to copy");

paste()

TypeScript

paste(): Promise<void>

Pastes content from the clipboard at the current cursor position.

Returns

Promise<void>Resolves when paste is complete.

Examples

TypeScript

await agent.actions.paste();

reverseCopy()

TypeScript

reverseCopy(): Promise<{text: string, data?: any, files?: {uri: string, mimeType: string, name: string, dataBase64: string}[]}>

Gets the current clipboard content including text, data, and files.

Returns

{text, data?, files?}Clipboard content with text and optional binary data/files.

Examples

TypeScript

const clipboard = await agent.actions.reverseCopy();
console.log(clipboard.text);
if (clipboard.files) {
  console.log("Files:", clipboard.files.map(f => f.name));
}

hideKeyboard()

TypeScript

hideKeyboard(): Promise<void>

Hides the software keyboard if it's currently visible.

Returns

Promise<void>Resolves when keyboard is hidden.

Examples

TypeScript

await agent.actions.hideKeyboard();

inputKey()

TypeScript

inputKey(keyCode: number, duration?: number, state?: "down" | "up" | null): Promise<void>

Sends a raw key event by Android KeyEvent code. Requires Android 13+ (SDK level 33+) and only works when the on-screen keyboard is visible.

Parameters

Name	Type	Description
`keyCode`	number	Android KeyEvent code (e.g., 66 for ENTER).
`duration?`	number	Press duration in ms.
`state?`	"down" \| "up" \| null	"down" for press, "up" for release, null for full press.

Returns

Promise<void>Resolves when key event is sent.

Examples

Press Enter

TypeScript

await agent.actions.inputKey(66);

Press and hold

TypeScript

await agent.actions.inputKey(66, 500, "down");

Note: inputKey() requires Android 13+ (SDK level 33+) and will only work when the on-screen keyboard is visible. Tap on an input field first to show the keyboard.