Checks whether the Portal device API is reachable and responding.

Returns the current UI accessibility tree (text, class names, bounds) plus phone state and screen dimensions. Call this first to understand what is on screen, then use tap / swipe / keyboard_input with coordinates taken from the returned bounds.

Returns only the accessibility element tree of the current screen as JSON.

Returns phone state: current app, screen on/off, battery, connectivity.

Takes a screenshot of the device screen and returns it as an image. Use this for visual verification of UI before/after actions.

Taps at the given screen coordinates (pixels, 0,0 = top-left). Read coordinates from get_screen_state bounds. Prefer tap_element when you have a node's bounds: it picks the point randomly inside the element.

Taps an element identified by its accessibility bounds. The tap point is chosen randomly inside the bounds after excluding margin pixels on each edge (center fallback for small elements), so repeated taps never land on identical pixels. Get bounds from get_screen_state.

Long-presses at (x, y) for duration_ms (default 600). Opens context menus, selects text, or grabs an icon before dragging. For element targets with humanized random points use long_press_element.

Long-presses an element identified by bounds (random point inside the bounds, edge margin excluded). For e.g. icon long-press menus.

Swipes (or drags) from one point to another over the given duration. A slow swipe (>400ms) reads as a drag in most apps.

Performs a system-level action. Valid actions: back, home, recents, notifications, quick_settings, power_dialog, toggle_split_screen, lock_screen, take_screenshot, headphone_button, dock_and_hold. Uses Android GLOBAL_ACTION_* semantics, requires the Portal accessibility service to be enabled.

Types text into the currently focused field using the Portal keyboard bridge. Set clear=false to append instead of replacing the field content.

Clears the currently focused text field.

Sends a key press. Use named keys: back, home, app_switch, menu, enter, del, tab, space, escape, search, volume_up, volume_down, arrow_up/down/left/right, or a raw Android keycode integer.

Reads the current clipboard content.

Writes text to the device clipboard.

Launches an app by package name (and optional activity). Use list_installed_apps to find package names.

Force-stops an app by package name.

Opens a deep link / URL (or intent). Use for URLs, market links, custom schemes.

Lists installed packages. Returns a large list; grep it for the app you want.

Lists files in a directory on the device.

Reads a file from the device and returns its content base64-encoded as data URI. Decode it if you need the raw bytes.

Writes base64-encoded bytes to a file on the device (max ~4MB decoded).

Deletes a file on the device.

Adjusts the Portal floating-offset (only meaningful when the overlay is enabled).

Returns whether the Portal overlay is currently visible.

Installs one or more APKs from URLs on the device (WebSocket required). Automatically accepts the install confirmation via the Portal.

Prevents the screen from sleeping while the connection is active (WebSocket required).

Returns whether screen keep-awake is currently active.

Returns the installed Portal app version.