Reference
cdp_run_action
Replay a learned action by id with end-to-end auto-repair. Loads the action from .rn-agent/actions/<actionId>.yaml or .yml, forwards the matching active session’s exact device ID to Maestro, rejects mismatched direct runner/WDA evidence, 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); its Maestro deviceId comes from direct runner evidence, never requested metadata. 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). forceReload defaults true: any human edit to the YAML since the agent’s last write is acknowledged as the new baseline so downstream repair does not abort with STALE_TARGET (the right default for active composition). Pass forceReload=false for the strict “respect offline human edits” behavior: a successful replay still appends its RunRecord to the sidecar when only the tracked YAML mtime baseline is stale, while YAML-mutating promotion and repair stay refused. proofReplay=true is reserved for proof_capture rehearsal and requires autoRepair=false plus forceReload=false; it executes without RunRecord, promotion, YAML, sidecar, or DB persistence. 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. blindProbeMode provides per-call control of the proactive CDP/JS compatibility path: inherit (default) honors RN_BLIND_PROBE, allow explicitly enables it for this call, and forbid forces maestro-first for this call.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
actionId | string | Yes | Owned action id; resolves one .yaml or .yml file. | ||
projectRoot | string | No | Override project root (default: process.cwd()). | ||
platform | unknown | No | |||
appFile | unknown | No | |||
autoRepair | unknown | No | |||
timeoutMs | unknown | No | Maestro execution timeout per attempt (ms). Default 120_000. | ||
trigger | unknown | No | RunRecord trigger annotation. Default “agent”. CI calls should pass “ci”. | ||
forceReload | unknown | No | |||
proofReplay | unknown | No | |||
blindProbeMode | unknown | No | |||
params | unknown | No |
cdp_run_action(actionId: <string>)