Resources

Evidence and performance

Session replay needs a verified outcome.

A useful replay connects observable agent actions to timing, browser state and an independent final assertion without exposing sensitive data or hidden reasoning.

Aiscovery Research10 min readLast reviewed: August 25, 2026
A single green agent journey crossing six transparent evidence frames above a synchronized blue timing rail

What this helps you evaluate

  • Which capture level fits a hosted agent, controlled browser or performance investigation
  • How to measure time to a verified outcome without hiding retries or human intervention
  • How to connect CLS and target movement to exact agent actions while protecting sensitive data

Replay explains a result, but does not prove it

A session replay should reconstruct the observable path from an immutable goal to a terminal state. It records actions, navigations, tool calls, waits, policy events and visible agent messages. It does not expose hidden chain-of-thought, and the agent's own completion message is not a success criterion.

Each run therefore ends with deterministic assertions against the website or sandbox state. The replay helps a reviewer locate friction and root cause; the assertion report decides whether the expected outcome exists.

Declare the capture level before the run

Observability differs by executor. Use a small capability ladder and record the maximum level actually available, not the level the product wishes it had.

  • L0_METADATA: start, finish, profile, scenario, status and assertions.
  • L1_EVENTS: normalized actions, navigation, tool calls, policy events and monotonic timestamps.
  • L2_VISUAL: L1 plus screenshots, screencast or video when platform policy permits it.
  • L3_BROWSER: L2 plus DOM and accessibility snapshots, console and network evidence.
  • L4_PERFORMANCE: L3 plus browser performance data, CLS attribution and CPU trace.

Measure time to a verified outcome

The primary user-facing duration runs from goal delivery to independent terminal verification. A separate run duration includes queueing, evidence flush and cleanup. Monotonic clocks measure elapsed time; wall-clock timestamps only correlate systems.

Keep startup, navigation, network, DOM settling, tool waits, policy approval, retries and unexpected human intervention visible. Compare agents only across the same scenario, fixture, release, locale, viewport, network profile and capture overhead. Publish latency beside success rate so a fast failure cannot look efficient.

Connect layout shifts to the action window

Standard CLS describes unexpected visual movement during a document lifecycle. For an agent, the critical question is whether a control moved between perception and action. Record the nearest step, affected element, before and after rectangles, screenshots and the suspected trigger for each relevant shift.

Keep standards-based CLS separate from custom action-window shift sums, target displacement and misclick counts. A shift after recent input may be excluded from CLS while still disrupting the next agent action. Unsupported browser measurements must be labeled unsupported, never stored as zero.

Make the replay report-safe by design

Prefer synthetic fixtures and masked regions before capture. Remove credentials, tokens, cookies, payment data, financial or medical records and direct identifiers from screenshots, events, DOM snapshots, URLs and network payloads. A client report should link only to sanitized artifacts with verified hashes.

Set raw and sanitized retention periods, authorized viewers and deletion rules before testing. Evidence with pending or rejected redaction stays out of reports. Broad production recording with uncontrolled personal data is not an acceptable shortcut for a sandbox.

Package one reviewable evidence contract

A browser-neutral manifest should index the normalized event stream, step traces, screenshots, video, DOM and accessibility snapshots, console and network logs, performance trace, layout-shift log and final assertion report. Each artifact needs a stable ID, timestamp, source, hash, redaction state and retention rule.

Controlled Playwright traces are useful because one viewer aligns actions, screenshots, DOM snapshots, console, network and timing. Preserve a normalized event stream as well so historical results remain reviewable outside a single tool. Run standard scenarios three times and critical ones five times to separate a reproducible defect from a one-off event.

Session evidence checks for an agent-readiness audit

  • Verify every scored run has stable IDs, monotonic event timing and a final assertion report.
  • Record the actual capture level and explicit limitations for unavailable DOM, CDP or browser signals.
  • Separate task time, infrastructure time, retries, planned approval and unexpected human intervention.
  • Link CLS, action-window shifts and target displacement to exact steps and before or after evidence.
  • Validate redaction across images, events, URLs, DOM, console, network and tool payloads.
  • Verify artifact hashes, viewer authorization, retention and replay integrity before report delivery.

Primary sources

Test the signal in a real journey.

Technical presence matters only when it improves a verified outcome. Connect the signal to a task, evidence and final-state assertion.