🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
/* eslint-disable react/no-unstable-nested-components */
import {
type PointerEvent,
type RefObject,
type UIEvent,
useState,
} from "react";
import { ExternalLink } from "@langfuse/icons";
import { DataTable } from "@/src/components/table/data-table";
import { type LangfuseColumnDef } from "@/src/components/table/types";
import { type DataTablePeekViewProps } from "@/src/components/table/peek";
import { Button } from "@/src/components/design-system/Button/Button";
import { cn } from "@/src/utils/tailwind";
import { useReadPath } from "@/src/features/events/hooks/useReadPath";
import { type FacetRow, topicTracesHref } from "./facet-topics";
/** With the table's own 4px (8px on the first column), cells end up 16px from each edge. */
const CELL = "block px-3";
/** Rows drawn at once; more load as the list nears its end. */
const ROW_CHUNK = 100;
const LOAD_MORE_THRESHOLD_PX = 400;
const FIRST_CELL = "block pr-3 pl-2";
/**
* `truncate` compares unrounded widths: whole-pixel `scrollWidth` misses
* sub-pixel overflows that still get an ellipsis, and tight leading overflows
* the height of text that fits. Assumes no horizontal padding.
*/
function clipsText(element: HTMLElement, clip: "truncate" | "line-clamp") {
if (clip === "line-clamp") return element.scrollHeight > element.clientHeight;
const text = document.createRange();
text.selectNodeContents(element);
return (
text.getBoundingClientRect().width > element.getBoundingClientRect().width
);
}
/**
* Native tooltip with the full text, only while the element clips it. The list
* can stay mounted across topics, so a measurement only counts for its text.
*/
function useTruncatedTitle(text: string, clip: "truncate" | "line-clamp") {
const [clippedText, setClippedText] = useState<string | null>(null);
return {
title: clippedText === text ? text : undefined,
onPointerMove: (event: PointerEvent<HTMLElement>) =>
setClippedText(clipsText(event.currentTarget, clip) ? text : null),
};
}
export function TopicTraceList({
projectId,
title,
description,
swatchColor,
rows,
peekView,
tracePanelRef,
headerRef,
divider,
}: TopicTraceListProps) {
const [shown, setShown] = useState({ rows, count: ROW_CHUNK });
// A new topic or facet starts again from the first chunk.
const visibleCount = shown.rows === rows ? shown.count : ROW_CHUNK;
const onScrollCapture = (event: UIEvent<HTMLElement>) => {
const target = event.target as HTMLElement;
const nearBottom =
target.scrollTop + target.clientHeight >=
target.scrollHeight - LOAD_MORE_THRESHOLD_PX;
if (nearBottom && visibleCount < rows.length)
setShown({ rows, count: visibleCount + ROW_CHUNK });
};
const titleTooltip = useTruncatedTitle(title, "truncate");
const descriptionTooltip = useTruncatedTitle(description ?? "", "line-clamp");
const { isV4 } = useReadPath();
const tracingHref = topicTracesHref(projectId, rows, isV4);
const columns: LangfuseColumnDef<FacetRow>[] = [
{
accessorKey: "traceId",
header: () => <span className={FIRST_CELL}>Trace ID</span>,
size: 208,
minSize: 128,
cell: ({ row }) => (
<span
className={cn(
"text-link block truncate font-mono text-xs",
FIRST_CELL,
)}
title={row.original.traceId}
>
{row.original.traceId}
</span>
),
},
{
accessorKey: "summary",
header: () => <span className={CELL}>Summary</span>,
size: 300,
minSize: 180,
isFlexWidth: true,
cell: ({ row }) => {
const summary = row.original.summary || "No applicable summary.";
return (
<p className={cn("truncate", CELL)} title={summary}>
{summary}
</p>
);
},
},
];
return (
<section
aria-label="Topic traces"
ref={tracePanelRef}
onScrollCapture={onScrollCapture}
className={cn(
"flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden",
divider === "side" && "border-t lg:border-t-0 lg:border-l",
divider === "top" && "border-t",
!divider && "rounded-md border",
)}
>
<div ref={headerRef} className="flex shrink-0 flex-col gap-1 px-4 py-3">
<div className="flex h-7 items-center justify-between gap-4">
<p className="text-muted-foreground flex min-w-0 items-center gap-2">
{swatchColor && (
<span
aria-hidden
className="size-3 shrink-0 rounded-xs"
style={{ backgroundColor: swatchColor }}
/>
)}
<span
className="truncate font-mono text-xs"
title={`${rows.length.toLocaleString()} traces`}
>
{`${rows.length.toLocaleString()} traces`}
</span>
</p>
{tracingHref && (
<Button
href={tracingHref}
text="Open in Tracing"
variant="ghost"
size="sm"
icon={ExternalLink}
/>
)}
</div>
<h3
className="truncate text-lg font-bold"
title={titleTooltip.title}
onPointerMove={titleTooltip.onPointerMove}
>
{title}
</h3>
{description && (
<p
className="text-muted-foreground line-clamp-2 text-sm"
title={descriptionTooltip.title}
onPointerMove={descriptionTooltip.onPointerMove}
>
{description}
</p>
)}
</div>
<DataTable
tableName="topics-topic-traces"
columns={columns}
data={{
isLoading: false,
isError: false,
data: rows
.slice(0, visibleCount)
.map((row) => ({ ...row, id: row.traceId })),
}}
className="min-h-0 overscroll-contain"
cellPadding="relaxed"
noResultsMessage="No trace summaries."
peekView={peekView}
/>
</section>
);
}
type TopicTraceListProps = {
projectId: string;
title: string;
description?: string;
swatchColor?: string;
rows: FacetRow[];
peekView: DataTablePeekViewProps;
tracePanelRef?: (element: HTMLElement | null) => void;
/** Lets a neighbouring panel match this header's height. */
headerRef?: RefObject<HTMLDivElement | null>;
divider?: "top" | "side";
};