Skip to content

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.md
new file mode 100644
index 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.ts
index 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.tsx
index 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.tsx
index 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)}
{...(canDeleteSession
diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.ts
index 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.ts
index 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.tsx
new file mode 100644
index 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.ts
index 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',