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 | null—Override per-turn metrics resolved from provider context.
recordUrlstring | null—Recording URL. Override only when your audio URL does not ship with the session detail response.
onTurnClick(turnNumber: number) => void—Handler for clicks on individual turn chips. Defaults to the provider’s setHighlightedTurn (which scrolls the transcript).
sessionCreatedAtstring—ISO timestamp used to align the recording playback cursor with turn timestamps. Defaults to the session’s created_at.

On this page