Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

chore: update agent metric meters ui (#665)

harshil-2096b482cdd3ed36
diff --git a/.changeset/feature-agent-metric-cards.md b/.changeset/feature-agent-metric-cards.md
new file mode 100644
index 000000000..d7dccaa0e
--- /dev/null
+++ b/.changeset/feature-agent-metric-cards.md
@@ -0,0 +1,5 @@
+---
+"@truefoundry/trueforge-ui": patch
+---
+
+Show the four primary agent metrics in a compact summary-card layout.
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentMetricCard.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentMetricCard.tsx
index bdba97e8f..0e9430be1 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentMetricCard.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentMetricCard.tsx
@@ -1,6 +1,8 @@
import type { ComponentType } from 'react';
+import { Icon } from '../../icons/Icon.js';
import { formatCostUsd, formatDurationMs } from '../../utils/sessionDisplayFormat.js';
+import { cn } from '../lib/cn.js';
import type { AgentMetricCardProps } from './types.js';
const numberFormatter = new Intl.NumberFormat(undefined, { maximumFractionDigits: 4 });
@@ -12,12 +14,31 @@ function formatMeterValue(value: number, unit: string): string {
}
export function AgentMetricCard({ meter }: AgentMetricCardProps) {
+ const isCost = meter.unit === '$';
+
return (
- <section className="min-w-0 rounded-lg border border-border bg-card-bg p-3" data-slot="agent-metric-card">
- <h3 className="truncate text-xs font-medium text-text-secondary" title={meter.description}>
- {meter.description}
- </h3>
- <p className="mt-2 text-xl font-semibold tabular-nums text-text-primary">
+ <section
+ className={cn(
+ 'flex min-w-0 flex-col rounded-xl border border-l-4 border-border bg-card-bg p-3 shadow-sm',
+ isCost ? 'border-l-success-bg' : 'border-l-primary-button-bg',
+ )}
+ data-slot="agent-metric-card"
+ >
+ <div className="flex w-full min-w-0 items-start justify-between gap-3">
+ <h3 className="truncate text-sm font-medium text-text-secondary" title={meter.description}>
+ {meter.description}
+ </h3>
+ <span
+ className={cn(
+ 'flex size-9 shrink-0 items-center justify-center rounded-lg text-sm font-semibold',
+ isCost ? 'bg-success-bg/10 text-success-bg' : 'bg-primary-button-bg/10 text-primary-button-bg',
+ )}
+ aria-hidden
+ >
+ <Icon name={isCost ? 'dollar-sign' : 'message-square-text'} className="size-6" />
+ </span>
+ </div>
+ <p className="text-4xl font-bold tabular-nums text-text-primary">
{formatMeterValue(meter.aggregateValue, meter.unit)}
</p>
</section>
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentMetricsView.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentMetricsView.tsx
index 37b8efe5e..922aea694 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentMetricsView.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentMetricsView.tsx
@@ -6,6 +6,8 @@ import { useSlot } from '../../theme/SlotsProvider.js';
import { Skeleton } from '../primitives/Skeleton.js';
import type { AgentMetricChartProps, AgentMetricsViewProps } from './types.js';
+const featuredMetricNames = ['total_cost_in_usd', 'cost_per_session_in_usd', 'total_sessions', 'avg_turns_per_session'];
+
export function AgentMetricsView({
meters,
meterError,
@@ -18,6 +20,13 @@ export function AgentMetricsView({
const AgentMetricCard = useSlot('AgentMetricCard');
const AgentMetricChart = useSlot('AgentMetricChart');
const AgentMetricsTimeRangeFilter = useSlot('AgentMetricsTimeRangeFilter');
+ const featuredMeters =
+ meters == null
+ ? undefined
+ : featuredMetricNames.flatMap(name => {
+ const meter = meters.find(candidate => candidate.name === name);
+ return meter == null ? [] : [meter];
+ });
return (
<div className="min-h-0 flex-1 overflow-auto bg-secondary-bg/40 p-4" data-slot="agent-metrics-view">
@@ -30,18 +39,18 @@ export function AgentMetricsView({
{meterError}
</div>
) : meters == null ? (
- <div className="mb-4 grid grid-cols-2 gap-3 md:grid-cols-3 xl:grid-cols-4" aria-label="Loading metrics">
+ <div className="mb-4 grid grid-cols-2 gap-3 md:grid-cols-4" aria-label="Loading metrics">
{Array.from({ length: 4 }, (_, index) => (
<Skeleton key={index} className="h-20 rounded-lg" />
))}
</div>
- ) : meters.length === 0 ? (
+ ) : featuredMeters?.length === 0 ? (
<div className="mb-4 rounded-lg border border-border bg-card-bg p-6 text-center text-sm text-text-secondary">
No aggregate metrics
</div>
) : (
- <div className="mb-4 grid grid-cols-2 gap-3 md:grid-cols-3 xl:grid-cols-4">
- {meters.map(meter => (
+ <div className="mb-4 grid grid-cols-2 gap-3 md:grid-cols-4">
+ {featuredMeters?.map(meter => (
<AgentMetricCard key={meter.name} meter={meter} />
))}
</div>
diff --git a/packages/trueforge-ui/src/icons/IconRegistry.tsx b/packages/trueforge-ui/src/icons/IconRegistry.tsx
index ee3ce4972..20f3be1a3 100644
--- a/packages/trueforge-ui/src/icons/IconRegistry.tsx
+++ b/packages/trueforge-ui/src/icons/IconRegistry.tsx
@@ -22,6 +22,7 @@ import {
Code2,
Copy,
Cpu,
+ DollarSign,
Download,
Ellipsis,
EllipsisVertical,
@@ -151,6 +152,7 @@ const defaults: Record<string, IconEntry> = {
file: File,
clone: Copy,
copy: Copy,
+ 'dollar-sign': DollarSign,
bars: Menu,
'panel-left-close': PanelLeftClose,
'panel-left-open': PanelLeftOpen,
diff --git a/packages/trueforge-ui/test/atoms/AgentMetricsContainer.test.tsx b/packages/trueforge-ui/test/atoms/AgentMetricsContainer.test.tsx
index 46fc8b44d..d9d3331a5 100644
--- a/packages/trueforge-ui/test/atoms/AgentMetricsContainer.test.tsx
+++ b/packages/trueforge-ui/test/atoms/AgentMetricsContainer.test.tsx
@@ -66,8 +66,16 @@ describe('AgentMetricsContainer', () => {
it('loads the default 24-hour range and reloads a custom range', async () => {
const getMeters = vi.fn(async (_request: AgentMetricRangeRequest) => [
+ { name: 'total_turns', aggregateValue: 30, description: 'Total turns', unit: 'count' },
+ { name: 'avg_turns_per_session', aggregateValue: 2.5, description: 'Avg turns / session', unit: 'count' },
{ name: 'total_sessions', aggregateValue: 12, description: 'Total sessions', unit: 'count' },
- { name: 'total_cost', aggregateValue: 1.248, description: 'Total cost', unit: '$' },
+ {
+ name: 'cost_per_session_in_usd',
+ aggregateValue: 0.104,
+ description: 'Total cost / total sessions',
+ unit: '$',
+ },
+ { name: 'total_cost_in_usd', aggregateValue: 1.248, description: 'Total cost', unit: '$' },
]);
const getChartData = vi.fn(async (_request: AgentMetricChartDataRequest): Promise<AgentMetricChartData> => ({
step: '3600',
@@ -93,7 +101,14 @@ describe('AgentMetricsContainer', () => {
getChartData,
});
- expect(await screen.findByText('Total sessions')).toBeInTheDocument();
+ expect(await screen.findAllByRole('heading', { level: 3 })).toHaveLength(4);
+ expect(screen.getAllByRole('heading', { level: 3 }).map(heading => heading.textContent)).toEqual([
+ 'Total cost',
+ 'Total cost / total sessions',
+ 'Total sessions',
+ 'Avg turns / session',
+ ]);
+ expect(screen.queryByText('Total turns')).not.toBeInTheDocument();
expect(screen.getByText('12')).toBeInTheDocument();
expect(screen.getByText('$1.2480')).toBeInTheDocument();
expect(await screen.findByText('Sessions: 4')).toBeInTheDocument();