Skip to content

cdp_run_action

Replay a learned action by id with end-to-end auto-repair. Loads the action from .rn-agent/actions/<actionId>.yaml, runs the Maestro flow, and on a SELECTOR_NOT_FOUND failure automatically invokes cdp_repair_action and retries once. Appends a RunRecord to the sidecar with full auto-repair telemetry (passed/failed/refused/skipped + diff). The repair attempt counts toward cdp_repair_action’s 24h budget. Pass autoRepair=false to opt out of auto-repair (returns the raw maestro_run failure verbatim). The orchestrated home for the L3 self-healing loop — prefer this over invoking maestro_run + cdp_repair_action manually for any flow you intend to re-run on schedule.

NameTypeRequiredDefaultConstraintsDescription
actionIdstringYesAction id matching <projectRoot>/.rn-agent/actions/<actionId>.yaml.
projectRootstringNoOverride project root (default: process.cwd()).
platform`enum: iosandroid`No
autoRepairbooleanNoAuto-repair on SELECTOR_NOT_FOUND failures. Default true. Pass false to disable (e.g. when investigating a failure manually).
timeoutMsnumberNoMaestro execution timeout per attempt (ms). Default 120_000.
trigger`enum: agentcihuman`No
cdp_run_action(actionId: <string>)