Start Recording Session
start_recording_sessionRecord a mobile interaction session by initializing session memory, monitoring UI hierarchy, and capturing network events. Returns a session ID for further actions.
Instructions
Begin recording a mobile interaction session. Initializes session memory, monitors the UI hierarchy, and starts capturing network events. Returns a session ID to use with subsequent tool calls. During the session, drive the app via execute_ui_action (single steps) or start_flow (stored Maestro yaml). Both update the recording timeline.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| platform | Yes | The target mobile platform | |
| timeouts | No | Optional timeout overrides. All values merge with defaults — only override what you need. | |
| appBundleId | Yes | The bundle identifier of the app to record (e.g., com.example.MyApp) | |
| captureMode | No | Hierarchy capture fidelity. "event-triggered" (default) captures pre/post-action snapshots with settle detection. "polling" captures at a fixed interval for high-fidelity transient state recording. | |
| sessionName | No | Optional human-readable name for this session | |
| filterDomains | No | Optional domain list for Proxyman traffic isolation (e.g., ["localhost.proxyman.io:3031"]). Enables concurrent sessions on different ports. | |
| settleTimeoutMs | No | How long to wait for the UI to stabilize after an action, in ms (default: 3000) | |
| trackEventPaths | No | URL path patterns for network-based interaction tracking (e.g., ["/__track"]). When the app POSTs to matching paths, the events are extracted as user interactions during compilation. | |
| pollingIntervalMs | No | Polling interval in ms when captureMode is "polling" (default: 500) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Human-readable status message | |
| readiness | No | Readiness checkpoint — indicates whether the session is fully armed for recording. Wait for all fields to be true before interacting with the app for best results. | |
| sessionId | Yes | Unique ID for the recording session |