List available simulator devices (udid, name, state, runtime).

Boot a simulator. Defaults to the already-booted sim, else the first available iPhone.

Install a built .app bundle onto the simulator.

Launch an installed app by bundle id. Returns the launch output (pid).

Terminate a running app by bundle id.

Uninstall then reinstall an app for a clean state.

Open a URL / universal link in the simulator (jump straight to a screen).

Grant/revoke/reset a privacy permission for an app (e.g. photos, camera, location, notifications).

PRIMARY PERCEPTION. Return the accessibility tree of the current screen as a list of elements (label, type, value, enabled, frame). Reason over this and tap by label.

Capture a PNG screenshot of the current screen. Use as the vision fallback when an element is not exposed in the accessibility tree, or to verify state.

Tap an element by accessibility label (preferred) or by raw x,y coordinate (fallback). Provide either label or both x and y.

Type text into the currently focused field. Tap the field first to focus it.

Swipe/scroll from one point to another. Either give a direction (auto-computed from screen center) or explicit from/to coordinates.

Press a hardware button (HOME backgrounds the app; LOCK locks the screen).