Skip to content

recording.md

Latest commit

 

History

History
37 lines (25 loc) · 1.27 KB

recording.md

File metadata and controls

37 lines (25 loc) · 1.27 KB

Session Recording & Replay

Every CUA session is recorded by default using Playwright's built-in tracing. After a run completes, you get a trace.zip that you can open in Playwright Trace Viewer for frame-by-frame session replay with DOM snapshots, screenshots, network requests, and console logs at each action.

Local Runs

Recordings are saved to the output/ directory:

python scripts/run_local.py --directive "Cancel order #123" --playbook cancel_order
# After completion:
# output/trace.zip         — Playwright trace (open in trace viewer)
# output/action_log.json   — structured action log + session memory (LLM path only)

Replay the session:

npx playwright show-trace output/trace.zip

Or drag trace.zip into trace.playwright.dev in your browser.

Modal Runs

Recordings are persisted to a Modal Volume (cua-recordings) and accessible via the API:

# List recording artifacts
curl https://<workspace>--cua-serve.modal.run/runs/{run_id}/recording/manifest \
  -H "Authorization: Bearer your-secret-api-key"

# Download the trace
curl -o trace.zip https://<workspace>--cua-serve.modal.run/runs/{run_id}/recording/trace \
  -H "Authorization: Bearer your-secret-api-key"