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). 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. 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
actionIdunknownYesAction id matching <projectRoot>/.rn-agent/actions/<actionId>.yaml.
projectRootstringNoOverride project root (default: process.cwd()).
platformunknownNo
autoRepairunknownNo
timeoutMsunknownNoMaestro execution timeout per attempt (ms). Default 120_000.
triggerunknownNoRunRecord trigger annotation. Default “agent”. CI calls should pass “ci”.
forceReloadunknownNo
paramsunknownNo
cdp_run_action(actionId: <unknown>)