Record + Replay
record_start
Section titled “record_start”Begin recording. Every subsequent act tool gets a screenshot + YAML step appended to the recording bundle.
record_start(name="ENG-1247-repro", tags=["smoke", "auth"])record_stop
Section titled “record_stop”Flush + finalize the recording. Writes recording.yaml and
recording.summary.json.
record_stop(name="ENG-1247-repro")replay
Section titled “replay”Re-execute a recording deterministically. Free — no AI tokens consumed.
replay(name="ENG-1247-repro", drift="halt") # or "warn" or "force"validate_replay
Section titled “validate_replay”Dry-run a replay: verify state contract, schema, and per-step prerequisites without dispatching actions.
validate_replay(name="ENG-1247-repro")list_replays
Section titled “list_replays”List recordings in the recordings root.
list_replays() # alllist_replays(tag="smoke") # filteredlint_recordings
Section titled “lint_recordings”Static lint pass: schema, state contract completeness, dead steps, redaction gaps.
lint_recordings(name="ENG-1247-repro")migrate_recording
Section titled “migrate_recording”Forward-migrate a recording to the current schema version.
migrate_recording(name="ENG-1247-repro")