Skip to content

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

chore: display model name in session turn headers (#1141)

harshil-2096457d16ee12f9
diff --git a/.changeset/session-turn-model-name.md b/.changeset/session-turn-model-name.md
new file mode 100644
index 000000000..20255972b
--- /dev/null
+++ b/.changeset/session-turn-model-name.md
@@ -0,0 +1,6 @@
+---
+'@truefoundry/trueforge-ui': patch
+'@truefoundry/trueforge-assistant-ui-runtime': patch
+---
+
+Show the model name in each turn header of the session view.
diff --git a/packages/assistant-ui-runtime/src/server/events.ts b/packages/assistant-ui-runtime/src/server/events.ts
index 05f07edc2..4fa3acd84 100644
--- a/packages/assistant-ui-runtime/src/server/events.ts
+++ b/packages/assistant-ui-runtime/src/server/events.ts
@@ -64,6 +64,7 @@ export interface ModelMessageEvent {
finishReason?: string | null;
createdAt: string;
usage?: unknown;
+ model?: { name: string };
}
export interface ModelMessageDeltaEvent {
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionTurnHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionTurnHeader.tsx
index fff88699a..d5129004c 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionTurnHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionTurnHeader.tsx
@@ -41,8 +41,9 @@ export function AgentSessionTurnHeader({
cachedTokens,
durationMs,
totalCostInUsd,
+ modelName,
}: AgentSessionTurnHeaderProps) {
- const hasMetrics = totalTokens != null || durationMs != null || totalCostInUsd != null;
+ const hasMetrics = totalTokens != null || durationMs != null || totalCostInUsd != null || modelName != null;
const hasTokenBreakdown = inputTokens != null || outputTokens != null || cachedTokens != null;
const breakdownInput = inputTokens ?? 0;
const breakdownOutput = outputTokens ?? 0;
@@ -60,16 +61,24 @@ export function AgentSessionTurnHeader({
}
>
<Icon name="link" className="size-3.5 shrink-0" aria-hidden />
- {`Tokens ${formatTokenCount(totalTokens)}`}
+ Tokens <span className="font-semibold">{formatTokenCount(totalTokens)}</span>
</button>
) : null;
return (
- <div className="flex items-center gap-3 py-1 text-xs text-text-secondary">
- <span className="shrink-0 font-semibold text-text-primary">{`Turn ${turnNumber}`}</span>
- <div className="h-px min-w-4 flex-1 bg-border" aria-hidden="true" />
+ <div className="flex flex-col gap-2 text-xs text-text-secondary">
+ <span className="font-semibold text-text-primary">{`Turn ${turnNumber}`}</span>
{hasMetrics ? (
- <div className="flex shrink-0 items-center gap-3 tabular-nums">
+ <div className="flex min-w-0 flex-wrap items-center gap-x-3 gap-y-1 tabular-nums">
+ {modelName != null ? (
+ <LightTooltip title={modelName} side="bottom">
+ <span className="inline-flex min-w-0 items-center gap-1">
+ <Icon name="cube" className="size-3.5 shrink-0" aria-hidden />
+ <span className="shrink-0">Model</span>
+ <span className="max-w-64 truncate font-semibold">{modelName}</span>
+ </span>
+ </LightTooltip>
+ ) : null}
{tokensTrigger != null ? (
hasTokenBreakdown ? (
<LightTooltip
@@ -91,12 +100,17 @@ export function AgentSessionTurnHeader({
{durationMs != null ? (
<span className="inline-flex items-center gap-1">
<Icon name="clock" className="size-3.5 shrink-0" />
- {`Duration ${formatDurationMs(durationMs)}`}
+ Duration <span className="font-semibold">{formatDurationMs(durationMs)}</span>
+ </span>
+ ) : null}
+ {totalCostInUsd != null ? (
+ <span>
+ Cost <span className="font-semibold">{formatCostUsd(totalCostInUsd)}</span>
</span>
) : null}
- {totalCostInUsd != null ? <span>{`Cost ${formatCostUsd(totalCostInUsd)}`}</span> : null}
</div>
) : null}
+ <div className="h-px w-full bg-border" aria-hidden="true" />
</div>
);
}
diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.ts
index f0ecfe9dd..8d6bbfe5a 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts
+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts
@@ -80,6 +80,7 @@ export type AgentSessionTurnHeaderProps = {
cachedTokens?: number;
durationMs?: number;
totalCostInUsd?: number;
+ modelName?: string;
};
export type AgentSessionMetricsStripProps = {
diff --git a/packages/trueforge-ui/src/containers/AgentSessionTimelineContainer.tsx b/packages/trueforge-ui/src/containers/AgentSessionTimelineContainer.tsx
index b767e2fe4..b207dd02b 100644
--- a/packages/trueforge-ui/src/containers/AgentSessionTimelineContainer.tsx
+++ b/packages/trueforge-ui/src/containers/AgentSessionTimelineContainer.tsx
@@ -324,6 +324,7 @@ function SessionTurnSection({
cachedTokens?: number;
durationMs?: number;
totalCostInUsd?: number;
+ modelName?: string;
}>;
onMount: (node: HTMLElement | null) => void;
}) {
@@ -342,6 +343,7 @@ function SessionTurnSection({
cachedTokens={turn.cachedTokens}
durationMs={turn.durationMs}
totalCostInUsd={turn.totalCostInUsd}
+ modelName={turn.modelName}
/>
) : null}
{messages.length > 0 ? (
diff --git a/packages/trueforge-ui/src/utils/sessionTurnViews.ts b/packages/trueforge-ui/src/utils/sessionTurnViews.ts
index 26453060e..2ce2c7fd5 100644
--- a/packages/trueforge-ui/src/utils/sessionTurnViews.ts
+++ b/packages/trueforge-ui/src/utils/sessionTurnViews.ts
@@ -1,4 +1,5 @@
import type { SessionEventItem } from '../server/types.js';
+import { MAIN_THREAD_ID } from './sessionEventTimeline.js';
type TurnCreatedEvent = Extract<SessionEventItem['event'], { type: 'turn.created' }>;
type TurnDoneEvent = Extract<SessionEventItem['event'], { type: 'turn.done' }>;
@@ -24,6 +25,8 @@ export type SessionTurnView = {
cachedTokens?: number;
totalCostInUsd?: number;
durationMs?: number;
+ /** Model FQN of the last root-thread model call in the turn. */
+ modelName?: string;
};
type TurnGroup = {
@@ -117,6 +120,16 @@ function metricsFromTerminalState(state: unknown): {
};
}
+function rootModelName(events: readonly TurnEvent[]): string | undefined {
+ for (let index = events.length - 1; index >= 0; index -= 1) {
+ const event = events[index];
+ if (event?.type === 'model.message' && event.threadId === MAIN_THREAD_ID && event.model?.name) {
+ return event.model.name;
+ }
+ }
+ return undefined;
+}
+
/**
* Build canonical ascending turn groups from durable session events.
* Pair by turnId so interleaved turn.created / turn.done still match; ignore
@@ -154,6 +167,7 @@ export function buildSessionTurnViews(itemsAsc: SessionEventItem[]): SessionTurn
const renderable = isRenderableTurn(viewCreated);
if (renderable) renderableTurnNumber += 1;
group.events.sort((left, right) => timestampMs(left.createdAt) - timestampMs(right.createdAt));
+ const modelName = rootModelName(group.events);
return {
turnId,
@@ -170,6 +184,7 @@ export function buildSessionTurnViews(itemsAsc: SessionEventItem[]): SessionTurn
...metricsFromTerminalState(done.state),
}),
events: group.events,
+ ...(modelName === undefined ? {} : { modelName }),
};
});
}
@@ -195,8 +210,10 @@ export function aggregateSessionTurnBand(
let hasCached = false;
let hasCost = false;
let hasDuration = false;
+ let modelName: string | undefined;
for (const turn of band) {
+ if (turn.modelName != null) modelName = turn.modelName;
if (turn.totalTokens != null) {
totalTokens += turn.totalTokens;
hasTokens = true;
@@ -231,5 +248,6 @@ export function aggregateSessionTurnBand(
...(hasCached ? { cachedTokens } : {}),
...(hasCost ? { totalCostInUsd } : {}),
...(hasDuration ? { durationMs } : {}),
+ ...(modelName === undefined ? {} : { modelName }),
};
}
diff --git a/packages/trueforge-ui/test/containers/AgentSessionTimelineContainer.test.tsx b/packages/trueforge-ui/test/containers/AgentSessionTimelineContainer.test.tsx
index 678a1b1cc..1db0fdb5b 100644
--- a/packages/trueforge-ui/test/containers/AgentSessionTimelineContainer.test.tsx
+++ b/packages/trueforge-ui/test/containers/AgentSessionTimelineContainer.test.tsx
@@ -177,7 +177,8 @@ describe('AgentSessionTimelineContainer', () => {
expect(await screen.findByText('timeline turns=1')).toBeInTheDocument();
expect(await screen.findByText('Turn 1')).toBeInTheDocument();
expect(screen.getByText('Turn')).toBeInTheDocument();
- expect(screen.getByText('Duration')).toBeInTheDocument();
+ const metricsStrip = container.querySelector('[data-slot="agent-session-metrics-sticky"]');
+ expect(metricsStrip).toHaveTextContent('Duration');
expect(await screen.findAllByRole('button', { name: 'Copy' })).not.toHaveLength(0);
expect(container.querySelector('[data-slot="agent-session-scroll"]')).toHaveClass('overflow-y-auto');
expect(container.querySelector('[data-slot="agent-session-metrics-sticky"]')).toHaveClass(
diff --git a/packages/trueforge-ui/test/utils/sessionTurnViews.test.ts b/packages/trueforge-ui/test/utils/sessionTurnViews.test.ts
new file mode 100644
index 000000000..9568fbb13
--- /dev/null
+++ b/packages/trueforge-ui/test/utils/sessionTurnViews.test.ts
@@ -0,0 +1,59 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'vitest';
+
+import type { SessionEventItem } from '@/server/types.js';
+import { aggregateSessionTurnBand, buildSessionTurnViews } from '@/utils/sessionTurnViews.js';
+
+const at = (second: number) => `2026-10-21T01:00:0${second}.000Z`;
+
+function modelMessage({
+ id,
+ threadId,
+ model,
+ second,
+}: {
+ id: string;
+ threadId: string;
+ model?: string;
+ second: number;
+}): SessionEventItem {
+ return {
+ turnId: 't1',
+ event: {
+ type: 'model.message',
+ id,
+ threadId,
+ createdAt: at(second),
+ ...(model === undefined ? {} : { model: { name: model } }),
+ },
+ };
+}
+
+describe('turn model name', () => {
+ const created: SessionEventItem = {
+ turnId: 't1',
+ event: {
+ type: 'turn.created',
+ id: 'c',
+ turnId: 't1',
+ createdAt: at(0),
+ input: [{ type: 'user.message', content: 'hi' }],
+ },
+ };
+
+ it('uses the last root-thread model and ignores sub-agent threads', () => {
+ const turns = buildSessionTurnViews([
+ created,
+ modelMessage({ id: 'a', threadId: 'main', model: 'p/first', second: 1 }),
+ modelMessage({ id: 'b', threadId: 'main', model: 'p/second', second: 2 }),
+ modelMessage({ id: 'c', threadId: 'sub', model: 'p/sub', second: 3 }),
+ ]);
+ assert.equal(turns[0]?.modelName, 'p/second');
+ assert.equal(aggregateSessionTurnBand(turns, 1)?.modelName, 'p/second');
+ });
+
+ it('leaves modelName unset when events carry no model', () => {
+ const [turn] = buildSessionTurnViews([created, modelMessage({ id: 'a', threadId: 'main', second: 1 })]);
+ assert.equal(turn?.modelName, undefined);
+ });
+});