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.mdnew file mode 100644index 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.tsindex 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.tsxindex 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.tsindex 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.tsxindex 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.tsindex 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[]): SessionTurnconst 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.tsxindex 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.tsnew file mode 100644index 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);+ });+});