Agent Observability
UI componentsComponents

Session Timeline

Scrollable per-turn timeline synchronized with the recording. Each turn is a band with STT, LLM, and TTS segments; hover to scrub, click to jump.

Preview

Loading session timeline preview…

Installation

pnpm dlx agent-observability-ui@latest add session-timeline
npx agent-observability-ui@latest add session-timeline
yarn dlx agent-observability-ui@latest add session-timeline
bunx --bun agent-observability-ui@latest add session-timeline

Usage

import { SessionTimeline } from '@/components/session-timeline/session-timeline'

<SessionTimeline />

// Custom turn-click handling (e.g. scroll a sibling panel)
<SessionTimeline onTurnClick={(n) => focusTurn(n)} />

Props

PropTypeDefaultDescription
metricsSessionMetrics | nullOverride per-turn metrics resolved from provider context.
recordUrlstring | nullRecording URL. Override only when your audio URL does not ship with the session detail response.
onTurnClick(turnNumber: number) => voidHandler for clicks on individual turn chips. Defaults to the provider’s setHighlightedTurn (which scrolls the transcript).
sessionCreatedAtstringISO timestamp used to align the recording playback cursor with turn timestamps. Defaults to the session’s created_at.

On this page