Reference
maestro_run
Execute a validated flow using semantic proof-domain routing. On iOS, exact-testID React commands execute through the authority-bound React tree before WDA can claim selector truth; text/system/native-only commands remain XCTest, and mixed flows are partitioned before execution without React-to-XCTest correlation. Results label react-tree and xctest-native proof domains explicitly; a React-tree pass is never Maestro certification or proof of IME, AutoFill, keyboard occlusion, or native interaction fidelity. Android and native-only iOS flows use the pin-cache maestro-runner >= 1.1.24. A ledger-proven trailing-verification-only failure remains failed with meta.trailingVerification; verify the unproven goal state before retrying or rebooting. Pass flowPath for an existing .yaml file or inlineYaml for an ephemeral flow.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
flowPath | string | No | Path to a .yaml flow file to execute | ||
inlineYaml | string | No | Inline YAML flow content (written to /tmp and executed) | ||
platform | enum: ios | android | No | Target platform (auto-detected from session) | ||
appId | string | No | App bundle ID (auto-detected from app.json) | ||
appFile | string | No | iOS only — path to a built .app/.ipa for maestro-runner to reinstall on clearState. Auto-resolved from the flow appId when omitted (GH#201). | ||
deviceId | string | No | min: 1, max: 256 | Exact UDID or serial; defaults from session or Android ANDROID_SERIAL. | |
timeoutMs | number | No | 120000 | min: 5000, max: 300000, integer | Execution timeout in ms |
params | Record<string, unknown> | No | GH #116: parameter bindings forwarded as -e KEY=VALUE for ${KEY} placeholders in the flow. Keys must match /^[A-Z_][A-Z0-9_]*$/ (validated in the handler). |
maestro_run()