agent.actions.text

writeText(text: string): Promise<void>

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

Returns Promise<void> — Resolves when text is typed.

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

copyText(text: string): Promise<void>

Copies the specified text to the system clipboard.

Returns Promise<void> — Resolves when copy is complete.

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

paste(): Promise<void>

Pastes content from the clipboard at the current cursor position.

Returns Promise<void> — Resolves when paste is complete.

await agent.actions.paste();

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.

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

hideKeyboard(): Promise<void>

Hides the software keyboard if it's currently visible.

Returns Promise<void> — Resolves when keyboard is hidden.

await agent.actions.hideKeyboard();

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.

Returns Promise<void> — Resolves when key event is sent.

await agent.actions.inputKey(66);

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