feat(ui): add trace view types

ui/litellm-dashboard/src/components/view_logs/TraceView/traceTypes.ts

@@ -0,0 +1,110 @@
+/**
+ * Agent tracing types. Mirrors `litellm/tracing/types.py` exactly.
+ *
+ * A trace is one agent run made of spans (agent / llm / tool / chain / framework).
+ * LLM spans that went through LiteLLM carry a `LiteLLMRequest`: the spend-log row
+ * for that call, joined on the provider response id.
+ */
+
+export type SpanType = "agent" | "llm" | "tool" | "chain" | "framework";
+export type SpanStatus = "ok" | "error" | "unset";
+
+export interface LiteLLMRequest {
+  request_id: string;
+  model: string;
+  model_group: string;
+  provider: string;
+  key_alias: string;
+  team_alias: string;
+  spend: number;
+  prompt_tokens: number;
+  completion_tokens: number;
+  cache_read_tokens: number;
+  cache_write_tokens: number;
+  latency_ms: number;
+  ttft_ms: number | null;
+  status: string;
+}
+
+export interface Span {
+  span_id: string;
+  parent_span_id: string | null;
+  name: string;
+  type: SpanType;
+  /** The agent this span runs inside, e.g. "researcher". */
+  agent: string;
+  /** Relative to trace start. */
+  start_offset_ms: number;
+  duration_ms: number;
+  status: SpanStatus;
+  /** Exception message when status is "error". */
+  error?: string | null;
+  input_preview: string;
+  model: string | null;
+  input_tokens: number;
+  output_tokens: number;
+  litellm: LiteLLMRequest | null;
+}
+
+/** One distinct agent in a trace. 200 invocations of `researcher` = one node. */
+export interface AgentNode {
+  name: string;
+  parent_agent: string | null;
+  invocations: number;
+  llm_calls: number;
+  tool_calls: number;
+  spend: number;
+  duration_ms: number;
+}
+
+export interface TraceSummary {
+  trace_id: string;
+  name: string;
+  service: string;
+  input_preview: string;
+  /** ISO 8601 */
+  start_time: string;
+  duration_ms: number;
+  status: SpanStatus;
+  span_count: number;
+  agent_count: number;
+  llm_calls: number;
+  tool_calls: number;
+  /** Spans with an error status; > 0 means the run shows as failed. */
+  error_count: number;
+  input_tokens: number;
+  output_tokens: number;
+  spend: number;
+  models: string[];
+}
+
+export interface Trace {
+  summary: TraceSummary;
+  agents: AgentNode[];
+  spans: Span[];
+}
+
+export interface TracePage {
+  data: TraceSummary[];
+  next_cursor: string | null;
+}
+
+/** `input` / `output` are JSON strings (messages for llm spans, raw args / result for tools). */
+export interface SpanDetail {
+  span_id: string;
+  input: string;
+  output: string;
+  attributes: Record<string, string>;
+}
+
+export interface TraceToolCall {
+  name: string;
+  args: unknown;
+}
+
+export interface TraceMessage {
+  role: string;
+  content: string;
+  name?: string;
+  tool_calls?: TraceToolCall[];
+}