The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat: Display session creator avatar in sessions list (#892)
Govinda Vashishtha5c22006369f8
diff --git a/.changeset/session-list-subject-avatar.md b/.changeset/session-list-subject-avatar.mdnew file mode 100644index 000000000..3a4bbb104--- /dev/null+++ b/.changeset/session-list-subject-avatar.md@@ -0,0 +1,6 @@+---+'@truefoundry/trueforge-assistant-ui-runtime': patch+'@truefoundry/trueforge-ui': patch+---++Show the session creator avatar in the sessions list meta row, with the subject name on hover.diff --git a/packages/assistant-ui-runtime/src/server/types.ts b/packages/assistant-ui-runtime/src/server/types.tsindex 6d194b78d..da9a88f71 100644--- a/packages/assistant-ui-runtime/src/server/types.ts+++ b/packages/assistant-ui-runtime/src/server/types.ts@@ -941,6 +941,8 @@ export interface SessionListEntry<TSpec extends AgentSpec = AgentSpec> {agentName?: string | null;/** Present when bound to a mutable / draft agent spec. */agentSpec?: TSpec;+ /** Session creator; omitted when the host does not track creators. */+ createdBySubject?: CreatedBySubject;/** Arbitrary caller key-value metadata strings. */metadata?: Record<string, string>;}diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsxindex ddf37d810..264fe3274 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx@@ -2,11 +2,14 @@import { Icon } from '../../icons/Icon.js';import { useSlot } from '../../theme/SlotsProvider.js';+import { createdByLabel } from '../../utils/createdBySubject.js';import { formatSessionListMetrics } from '../../utils/sessionDisplayFormat.js';+import { getUserInitials } from '../UserAvatar.js';import { auiButtonClass } from '../lib/buttonClasses.js';import { cn } from '../lib/cn.js';import { formatAbsoluteDateTime } from '../lib/dateFormat.js';import { formatRelativeShort } from '../lib/threadListMeta.js';+import { Avatar, AvatarFallback } from '../primitives/Avatar.js';import { DropdownMenu, DropdownMenuItem } from '../primitives/DropdownMenu.js';import { Tooltip } from '../primitives/Tooltip.js';import type { AgentSessionListRowProps } from './types.js';@@ -17,6 +20,7 @@ export function AgentSessionListRow({sourceType,lastActivityAt,metrics,+ createdBySubject,active,onSelect,onRequestDelete,@@ -26,6 +30,8 @@ export function AgentSessionListRow({const activityAt = new Date(lastActivityAt);const relative = formatRelativeShort(activityAt);const absolute = formatAbsoluteDateTime(activityAt);+ const subjectLabel = createdBySubject != null ? createdByLabel(createdBySubject) : null;+ const subjectInitials = subjectLabel != null ? getUserInitials(subjectLabel) || '?' : null;return (<div@@ -91,7 +97,16 @@ export function AgentSessionListRow({onClick={onSelect}className="flex w-full items-end justify-between gap-2 px-4 pt-2 pb-3 text-left text-xs text-text-secondary">- <span className="flex min-w-0 items-center gap-1">+ <span className="flex min-w-0 items-center gap-1.5">+ {subjectLabel != null && subjectInitials != null ? (+ <Tooltip content={subjectLabel}>+ <span aria-label={subjectLabel} className="inline-flex shrink-0">+ <Avatar size="sm" aria-hidden>+ <AvatarFallback>{subjectInitials}</AvatarFallback>+ </Avatar>+ </span>+ </Tooltip>+ ) : null}{agentName != null ? (<><Icon name="agent-2" className="size-3 shrink-0" />diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsxindex 782b3b34e..b1797e46e 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx@@ -408,6 +408,7 @@ export function AgentSessions({sourceType={entrySourceType(entry)}lastActivityAt={entry.lastActivityAt}metrics={entry.metrics}+ {...(entry.createdBySubject == null ? {} : { createdBySubject: entry.createdBySubject })}active={entry.id === selectedSessionId}onSelect={() => selectSession(entry)}{...(canDeleteSessiondiff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.tsindex 768801438..f0ecfe9dd 100644--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts@@ -5,6 +5,7 @@ import type {AgentMetricGraph,AgentMetricMeter,CodeSnippet,+ CreatedBySubject,} from '../../server/types.js';import type { SessionMetrics } from '../../utils/buildSessionMetrics.js';import type { SessionEventTimelineSegment, SessionEventType } from '../../utils/sessionEventTimeline.js';@@ -40,6 +41,8 @@ export type AgentSessionListRowProps = {totalCostInUsd?: number;totalDurationMs: number;};+ /** Session creator; avatar shown in the meta row when present. */+ createdBySubject?: CreatedBySubject;active: boolean;onSelect: () => void;/** Opens delete confirmation; does not call the API. */diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.tsindex 91e0f083f..2175d0124 100644--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts@@ -38,6 +38,7 @@ function toSessionListEntry(session: TrueForgeApi.Session): HarnessSessionListEn...(session.agent.type === 'reference' && session.agent.name !== null ? { agentName: session.agent.name } : {}),...(session.agent.type === 'inline' ? { agentSpec: toUiAgentSpec(session.agent.spec) } : {}),...(session.source?.type === 'schedule' ? { sourceType: session.source.type } : {}),+ ...(session.createdBySubject == null ? {} : { createdBySubject: session.createdBySubject }),...(session.metadata != null && Object.keys(session.metadata).length > 0 ? { metadata: session.metadata } : {}),};}diff --git a/packages/trueforge-ui/test/atoms/AgentSessionListRow.test.tsx b/packages/trueforge-ui/test/atoms/AgentSessionListRow.test.tsxnew file mode 100644index 000000000..cbe7db7cc--- /dev/null+++ b/packages/trueforge-ui/test/atoms/AgentSessionListRow.test.tsx@@ -0,0 +1,51 @@+// @vitest-environment jsdom+import { fireEvent, render, screen } from '@testing-library/react';+import { describe, expect, it, vi } from 'vitest';++import { AgentSessionListRow } from '@/atoms/agent-details/AgentSessionListRow.js';++const baseProps = {+ title: 'Hello session',+ lastActivityAt: '2026-01-02T00:00:00.000Z',+ metrics: { totalTurns: 1, totalDurationMs: 1000 },+ active: false,+ onSelect: () => undefined,+};++describe('AgentSessionListRow', () => {+ it('shows a subject avatar with name tooltip in the meta row', () => {+ const { container } = render(+ <AgentSessionListRow+ {...baseProps}+ agentName="writer"+ createdBySubject={{+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ }}+ />,+ );++ const avatar = screen.getByLabelText('[email protected]');+ expect(avatar).toBeInTheDocument();+ expect(container.querySelector('[data-slot="avatar-fallback"]')).toHaveTextContent('A');+ expect(screen.queryByText('[email protected]')).not.toBeInTheDocument();++ fireEvent.mouseEnter(avatar);+ expect(screen.getByRole('tooltip')).toHaveTextContent('[email protected]');+ });++ it('hides the subject avatar when createdBySubject is omitted', () => {+ const { container } = render(<AgentSessionListRow {...baseProps} agentName="writer" />);++ expect(container.querySelector('[data-slot="avatar"]')).not.toBeInTheDocument();+ });++ it('invokes onSelect when the meta row is clicked', () => {+ const onSelect = vi.fn();+ render(<AgentSessionListRow {...baseProps} onSelect={onSelect} agentName="writer" />);++ fireEvent.click(screen.getByText('writer'));+ expect(onSelect).toHaveBeenCalledOnce();+ });+});diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.tsindex 3e8059b9b..bbad9596b 100644--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts@@ -73,6 +73,11 @@ describe('createHarnessAgentSessionsServer', () => {name: 'writer',},createdBy: 'user-1',+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ },metrics: {totalTurns: 3,totalCostInUsd: 0.25,@@ -116,6 +121,11 @@ describe('createHarnessAgentSessionsServer', () => {metrics: { totalTurns: 3, totalCostInUsd: 0.25, totalDurationMs: 29_711 },agentName: 'writer',sourceType: 'schedule',+ createdBySubject: {+ subjectId: 'user-1',+ subjectType: 'user',+ subjectDisplayName: '[email protected]',+ },},],nextPageToken: 'next-1',