Recording

Every run is recorded. After it finishes, mint a viewer URL to replay the full session - useful for debugging agent behaviour, audits, and support.

Get a recording

1
const recording = await bctrl.runs.recording(runId);
2
3
console.log(recording.url);    // embed to replay
4
console.log(recording.status);       // recording availability
5
console.log(recording.durationMs);   // length of the session
6
console.log(recording.expiresAt);    // lease expiry

Like live view, the recording URL is a time-limited lease. Mint a fresh one when it expires.

Next

• Live View - watch in real time instead
• Events & Activity - the structured timeline
• Run Files - artifacts a run produced