feat: LangChain auto-instrumentation + dashboard UI

- LangChain: AgentLensCallbackHandler with auto-span creation for
  LLM calls, tool calls, chains, and agent decision logging
- Dashboard: trace list with search, status filters, pagination
- Dashboard: trace detail with Decision/Span/Event tabs
- Dashboard: sidebar layout, responsive design, dark theme
This commit is contained in:
Vectry
2026-02-09 23:36:28 +00:00
parent 3fe9013838
commit 21b4f9f316
7 changed files with 1677 additions and 23 deletions

View File

@@ -0,0 +1,155 @@
"use client";
import { ReactNode, useState } from "react";
import Link from "next/link";
import { usePathname } from "next/navigation";
import {
Activity,
GitBranch,
Settings,
Menu,
X,
ChevronRight,
} from "lucide-react";
import { cn } from "@/lib/utils";
interface NavItem {
href: string;
label: string;
icon: React.ComponentType<{ className?: string }>;
comingSoon?: boolean;
}
const navItems: NavItem[] = [
{ href: "/dashboard", label: "Traces", icon: Activity },
{ href: "/dashboard/decisions", label: "Decisions", icon: GitBranch, comingSoon: true },
{ href: "/dashboard/settings", label: "Settings", icon: Settings, comingSoon: true },
];
function Sidebar({ onNavigate }: { onNavigate?: () => void }) {
const pathname = usePathname();
return (
<div className="flex flex-col h-full bg-neutral-900 border-r border-neutral-800">
{/* Logo */}
<div className="p-6 border-b border-neutral-800">
<Link
href="/"
className="flex items-center gap-3 group"
onClick={onNavigate}
>
<div className="w-10 h-10 rounded-xl bg-gradient-to-br from-emerald-400 to-emerald-600 flex items-center justify-center shadow-lg shadow-emerald-500/20 group-hover:shadow-emerald-500/30 transition-shadow">
<Activity className="w-5 h-5 text-white" />
</div>
<div className="flex flex-col">
<span className="font-bold text-lg text-neutral-100">AgentLens</span>
<span className="text-xs text-neutral-500">Dashboard</span>
</div>
</Link>
</div>
{/* Navigation */}
<nav className="flex-1 p-4 space-y-1">
{navItems.map((item) => {
const Icon = item.icon;
const isActive = pathname === item.href || pathname.startsWith(`${item.href}/`);
return (
<Link
key={item.href}
href={item.comingSoon ? "#" : item.href}
onClick={(e) => {
if (item.comingSoon) {
e.preventDefault();
return;
}
onNavigate?.();
}}
className={cn(
"flex items-center gap-3 px-4 py-3 rounded-lg text-sm font-medium transition-all duration-200",
isActive
? "bg-emerald-500/10 text-emerald-400 border border-emerald-500/20"
: "text-neutral-400 hover:text-neutral-100 hover:bg-neutral-800/50",
item.comingSoon && "opacity-50 cursor-not-allowed"
)}
>
<Icon className="w-5 h-5" />
<span className="flex-1">{item.label}</span>
{item.comingSoon && (
<span className="text-xs px-2 py-0.5 rounded-full bg-neutral-800 text-neutral-500">
Soon
</span>
)}
{isActive && <ChevronRight className="w-4 h-4" />}
</Link>
);
})}
</nav>
{/* Footer */}
<div className="p-4 border-t border-neutral-800">
<div className="px-4 py-3 rounded-lg bg-neutral-800/50 border border-neutral-700/50">
<p className="text-xs text-neutral-500">AgentLens v0.1.0</p>
</div>
</div>
</div>
);
}
export default function DashboardLayout({ children }: { children: ReactNode }) {
const [sidebarOpen, setSidebarOpen] = useState(false);
return (
<div className="min-h-screen bg-neutral-950 flex">
{/* Desktop Sidebar */}
<aside className="hidden lg:block w-64 h-screen sticky top-0">
<Sidebar />
</aside>
{/* Mobile Sidebar Overlay */}
{sidebarOpen && (
<div
className="fixed inset-0 bg-black/50 z-40 lg:hidden"
onClick={() => setSidebarOpen(false)}
/>
)}
{/* Mobile Sidebar */}
<aside
className={cn(
"fixed inset-y-0 left-0 w-72 z-50 transform transition-transform duration-300 ease-in-out lg:hidden",
sidebarOpen ? "translate-x-0" : "-translate-x-full"
)}
>
<Sidebar onNavigate={() => setSidebarOpen(false)} />
</aside>
{/* Main Content */}
<main className="flex-1 min-w-0">
{/* Mobile Header */}
<header className="lg:hidden sticky top-0 z-30 bg-neutral-950/80 backdrop-blur-md border-b border-neutral-800 px-4 py-3">
<div className="flex items-center justify-between">
<button
onClick={() => setSidebarOpen(true)}
className="p-2 rounded-lg bg-neutral-900 border border-neutral-800 text-neutral-400 hover:text-neutral-100 transition-colors"
>
<Menu className="w-5 h-5" />
</button>
<Link href="/" className="flex items-center gap-2">
<div className="w-8 h-8 rounded-lg bg-gradient-to-br from-emerald-400 to-emerald-600 flex items-center justify-center">
<Activity className="w-4 h-4 text-white" />
</div>
<span className="font-bold text-neutral-100">AgentLens</span>
</Link>
<div className="w-9" />
</div>
</header>
{/* Page Content */}
<div className="p-4 sm:p-6 lg:p-8">
{children}
</div>
</main>
</div>
);
}

View File

@@ -0,0 +1,63 @@
import { TraceList } from "@/components/trace-list";
interface TracesResponse {
traces: Array<{
id: string;
name: string;
status: "RUNNING" | "COMPLETED" | "ERROR";
startedAt: string;
endedAt: string | null;
durationMs: number | null;
tags: string[];
metadata: Record<string, unknown>;
_count: {
decisionPoints: number;
spans: number;
events: number;
};
}>;
total: number;
page: number;
limit: number;
totalPages: number;
}
async function getTraces(
limit = 50,
page = 1
): Promise<TracesResponse> {
try {
const res = await fetch(
`http://localhost:3000/api/traces?limit=${limit}&page=${page}`,
{ cache: "no-store" }
);
if (!res.ok) {
throw new Error(`Failed to fetch traces: ${res.status}`);
}
return res.json();
} catch (error) {
console.error("Error fetching traces:", error);
return {
traces: [],
total: 0,
page: 1,
limit,
totalPages: 0,
};
}
}
export default async function DashboardPage() {
const data = await getTraces(50, 1);
return (
<TraceList
initialTraces={data.traces}
initialTotal={data.total}
initialTotalPages={data.totalPages}
initialPage={data.page}
/>
);
}

View File

@@ -0,0 +1,87 @@
import { notFound } from "next/navigation";
import { TraceDetail } from "@/components/trace-detail";
interface TraceResponse {
trace: {
id: string;
name: string;
status: "RUNNING" | "COMPLETED" | "ERROR";
startedAt: string;
endedAt: string | null;
durationMs: number | null;
tags: string[];
metadata: Record<string, unknown>;
costUsd: number | null;
};
decisionPoints: Array<{
id: string;
type: string;
chosenAction: string;
alternatives: string[];
reasoning: string | null;
contextSnapshot: Record<string, unknown> | null;
confidence: number | null;
timestamp: string;
}>;
spans: Array<{
id: string;
name: string;
type: string;
status: "OK" | "ERROR" | "CANCELLED";
startedAt: string;
endedAt: string | null;
durationMs: number | null;
input: unknown;
output: unknown;
metadata: Record<string, unknown>;
}>;
events: Array<{
id: string;
type: string;
name: string;
timestamp: string;
metadata: Record<string, unknown>;
}>;
}
async function getTrace(id: string): Promise<TraceResponse | null> {
try {
const res = await fetch(`http://localhost:3000/api/traces/${id}`, {
cache: "no-store",
});
if (!res.ok) {
if (res.status === 404) {
return null;
}
throw new Error(`Failed to fetch trace: ${res.status}`);
}
return res.json();
} catch (error) {
console.error("Error fetching trace:", error);
return null;
}
}
interface TraceDetailPageProps {
params: Promise<{ id: string }>;
}
export default async function TraceDetailPage({ params }: TraceDetailPageProps) {
const { id } = await params;
const data = await getTrace(id);
if (!data) {
notFound();
}
return (
<TraceDetail
trace={data.trace}
decisionPoints={data.decisionPoints}
spans={data.spans}
events={data.events}
/>
);
}