Skip to content

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

feat: added user avatar (#630)

Vinit1b5b67470ef3
diff --git a/.changeset/pre/user-avatar-slot.md b/.changeset/pre/user-avatar-slot.md
new file mode 100644
index 000000000..3eccbc061
--- /dev/null
+++ b/.changeset/pre/user-avatar-slot.md
@@ -0,0 +1,6 @@
+---
+"@truefoundry/trueforge-ui": patch
+"@truefoundry/trueforge": patch
+---
+
+Add a host-overridable user avatar slot with initials and display-name chrome across every built-in layout, wired to the current authenticated frontend user.
diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsx
index 14f3e876d..e5afd4001 100644
--- a/packages/frontend/src/App.tsx
+++ b/packages/frontend/src/App.tsx
@@ -43,7 +43,7 @@ type BootState =
export function App() {
const authError = parseAuthErrorReason(window.location.search);
- const [session, setSession] = useState<SessionState | 'checking'>('checking');
+ const [session, setSession] = useState<SessionState | { status: 'checking' }>({ status: 'checking' });
const [boot, setBoot] = useState<BootState>({ status: 'loading' });
// Gate boot on a non-redirecting `/me` probe: unauthenticated users see the
@@ -63,7 +63,7 @@ export function App() {
}, []);
useEffect(() => {
- if (session !== 'authenticated') {
+ if (session.status !== 'authenticated') {
return;
}
if (parseAuthErrorReason(window.location.search) == null) {
@@ -81,7 +81,7 @@ export function App() {
}, [session]);
useEffect(() => {
- if (session !== 'authenticated') {
+ if (session.status !== 'authenticated') {
return;
}
const state = { cancelled: false };
@@ -146,7 +146,7 @@ export function App() {
);
}
- if (session === 'checking') {
+ if (session.status === 'checking') {
return (
<ThemeProvider theme={appTheme}>
<div className="boot-screen" role="status" aria-live="polite" aria-busy="true">
@@ -157,7 +157,7 @@ export function App() {
);
}
- if (session === 'unauthenticated') {
+ if (session.status === 'unauthenticated') {
return (
<ThemeProvider theme={appTheme}>
<GetStartedScreen />
@@ -198,6 +198,7 @@ export function App() {
defaultAgentSpec: boot.defaultAgentSpec,
}}
initialSettingsOpen={boot.openSettings}
+ currentUser={{ displayName: session.displayName }}
overrides={overrides}
theme={appTheme}
className="app-assistant"
diff --git a/packages/frontend/src/authSession.ts b/packages/frontend/src/authSession.ts
index 4d9f73d4c..2cb4c9b25 100644
--- a/packages/frontend/src/authSession.ts
+++ b/packages/frontend/src/authSession.ts
@@ -22,7 +22,7 @@ const probeClient = new TrueForgeClient({
});
/** Result of the pre-boot session probe. */
-export type SessionState = 'authenticated' | 'unauthenticated';
+export type SessionState = { status: 'authenticated'; displayName: string } | { status: 'unauthenticated' };
/** Last successful me() OIDC check — survives remounts of host chrome. */
let cachedIsOidcConnected: boolean | undefined;
@@ -62,9 +62,9 @@ export async function logout(post: typeof fetch = globalThis.fetch.bind(globalTh
*/
export async function probeSession(client: TrueForge = probeClient): Promise<SessionState> {
try {
- await client.auth.me();
- return 'authenticated';
+ const { data } = await client.auth.me();
+ return { status: 'authenticated', displayName: data.subject.displayName };
} catch {
- return 'unauthenticated';
+ return { status: 'unauthenticated' };
}
}
diff --git a/packages/frontend/src/authStatusSearch.ts b/packages/frontend/src/authStatusSearch.ts
index ae7831535..fc8a13935 100644
--- a/packages/frontend/src/authStatusSearch.ts
+++ b/packages/frontend/src/authStatusSearch.ts
@@ -15,9 +15,9 @@ export function shouldShowAuthErrorScreen({
session,
}: {
authError: string | null;
- session: SessionState | 'checking';
+ session: SessionState | { status: 'checking' };
}): string | null {
- if (authError == null || session !== 'unauthenticated') {
+ if (authError == null || session.status !== 'unauthenticated') {
return null;
}
return authError;
diff --git a/packages/frontend/tests/authSession.test.ts b/packages/frontend/tests/authSession.test.ts
index 7d068e229..c1cb7574c 100644
--- a/packages/frontend/tests/authSession.test.ts
+++ b/packages/frontend/tests/authSession.test.ts
@@ -58,11 +58,19 @@ describe('authSession', () => {
});
it('probeSession reports authenticated when me() resolves', async () => {
- assert.equal(await probeSession(createClient({ type: 'default' })), 'authenticated');
- assert.equal(await probeSession(createClient({ type: 'oidc-connected' })), 'authenticated');
+ assert.deepEqual(await probeSession(createClient({ type: 'default' })), {
+ status: 'authenticated',
+ displayName: 'user-1',
+ });
+ assert.deepEqual(await probeSession(createClient({ type: 'oidc-connected' })), {
+ status: 'authenticated',
+ displayName: 'user-1',
+ });
});
it('probeSession reports unauthenticated when me() throws', async () => {
- assert.equal(await probeSession(createClient({ meError: new Error('401') })), 'unauthenticated');
+ assert.deepEqual(await probeSession(createClient({ meError: new Error('401') })), {
+ status: 'unauthenticated',
+ });
});
});
diff --git a/packages/frontend/tests/authStatusSearch.test.ts b/packages/frontend/tests/authStatusSearch.test.ts
index 4d3754935..e8ada9342 100644
--- a/packages/frontend/tests/authStatusSearch.test.ts
+++ b/packages/frontend/tests/authStatusSearch.test.ts
@@ -10,10 +10,19 @@ describe('authStatusSearch', () => {
});
it('shouldShowAuthErrorScreen only for unauthenticated error landings', () => {
- assert.equal(shouldShowAuthErrorScreen({ authError: 'login_failed', session: 'unauthenticated' }), 'login_failed');
- assert.equal(shouldShowAuthErrorScreen({ authError: 'login_failed', session: 'checking' }), null);
- assert.equal(shouldShowAuthErrorScreen({ authError: 'login_failed', session: 'authenticated' }), null);
- assert.equal(shouldShowAuthErrorScreen({ authError: null, session: 'unauthenticated' }), null);
+ assert.equal(
+ shouldShowAuthErrorScreen({ authError: 'login_failed', session: { status: 'unauthenticated' } }),
+ 'login_failed',
+ );
+ assert.equal(shouldShowAuthErrorScreen({ authError: 'login_failed', session: { status: 'checking' } }), null);
+ assert.equal(
+ shouldShowAuthErrorScreen({
+ authError: 'login_failed',
+ session: { status: 'authenticated', displayName: 'Ada Lovelace' },
+ }),
+ null,
+ );
+ assert.equal(shouldShowAuthErrorScreen({ authError: null, session: { status: 'unauthenticated' } }), null);
});
it('stripAuthErrorSearch drops error and keeps other query and hash', () => {
diff --git a/packages/trueforge-ui/src/atoms/UserAvatar.tsx b/packages/trueforge-ui/src/atoms/UserAvatar.tsx
new file mode 100644
index 000000000..1dfc85f4f
--- /dev/null
+++ b/packages/trueforge-ui/src/atoms/UserAvatar.tsx
@@ -0,0 +1,62 @@
+'use client';
+
+import { useOptionalCurrentUser } from '../contexts/CurrentUserContext.js';
+import { cn } from './lib/cn.js';
+import { Avatar, AvatarFallback } from './primitives/Avatar.js';
+
+export type UserAvatarProps = {
+ labeled?: boolean; // Uses the sidebar rail width instead of the compact chrome width
+ className?: string;
+};
+
+export function getUserInitials(displayName: string): string {
+ // split by spaces and filter out empty strings
+ const parts = displayName.trim().split(/\s+/).filter(Boolean);
+ const first = parts[0];
+ if (first === undefined) {
+ return '';
+ }
+ const last = parts.at(-1);
+ const characters =
+ parts.length === 1 ? Array.from(first).slice(0, 2) : [Array.from(first)[0], Array.from(last ?? '')[0]];
+
+ return characters
+ .filter(character => character !== undefined)
+ .join('')
+ .toLocaleUpperCase();
+}
+
+// Default current-user chrome; hosts can replace it through `overrides.UserAvatar`.
+export function UserAvatar({ labeled = false, className }: UserAvatarProps) {
+ const currentUser = useOptionalCurrentUser();
+ const displayName = currentUser?.displayName.trim();
+ if (!displayName) {
+ return null;
+ }
+
+ return (
+ <div
+ data-slot="user-avatar"
+ aria-label={displayName}
+ title={displayName}
+ className={cn(
+ 'flex min-w-0 shrink-0 flex-col items-center justify-center gap-0.5 text-text-secondary',
+ labeled ? 'w-14.5' : 'max-w-20',
+ className,
+ )}
+ >
+ <Avatar size="sm">
+ <AvatarFallback className="bg-primary-button-bg text-primary-button-text">
+ {getUserInitials(displayName)}
+ </AvatarFallback>
+ </Avatar>
+ <span className="w-full truncate text-center text-[0.625rem] leading-tight">{displayName}</span>
+ </div>
+ );
+}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ UserAvatar: typeof UserAvatar;
+ }
+}
diff --git a/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx b/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx
index 07edaca5a..1521ef457 100644
--- a/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx
+++ b/packages/trueforge-ui/src/containers/TrueForgeUIShell.tsx
@@ -9,6 +9,7 @@ import { DraftSpecPreferenceBridge } from '../atoms/draft/DraftSpecPreferenceBri
import { cn } from '../atoms/lib/cn.js';
import { IS_CREATE_AGENT_METADATA_KEY, isCreateAgentMetadataValue } from '../atoms/lib/sessionCreateAgent.js';
import { Spinner } from '../atoms/primitives/Spinner.js';
+import { CurrentUserProvider, type CurrentUser } from '../contexts/CurrentUserContext.js';
import { WidgetVisibilityProvider } from '../layouts/WidgetVisibilityContext.js';
import { HistorySessionSwitchBridge } from '../routing/HistorySessionSwitchBridge.js';
import { LibrarySessionShareBoot } from '../routing/LibrarySessionShareBoot.js';
@@ -67,6 +68,8 @@ export type TrueForgeUIProps = {
withRouter?: boolean;
/** URL path customization; only honored when `withRouter`. */
routes?: RoutesConfig;
+ /** Optional identity rendered by the default `UserAvatar` slot. */
+ currentUser?: CurrentUser;
};
export type TrueForgeUIShellProps = Omit<TrueForgeUIProps, 'withRouter'> & { resolvedRoutes?: ResolvedRoutes };
@@ -267,6 +270,7 @@ export function TrueForgeUIShell(props: TrueForgeUIShellProps) {
server: serverConfig,
onError,
customActionRenderers,
+ currentUser,
resolvedRoutes,
routes: _routes,
...providerRest
@@ -323,15 +327,17 @@ export function TrueForgeUIShell(props: TrueForgeUIShellProps) {
return (
<SlotsProvider overrides={overrides} theme={theme}>
- <CustomActionRenderersProvider renderers={customActionRenderers}>
- <ServerProvider server={server}>
- {resolvedRoutes != null ? (
- <ResolvedRoutesProvider routes={resolvedRoutes}>{visibilityTree}</ResolvedRoutesProvider>
- ) : (
- visibilityTree
- )}
- </ServerProvider>
- </CustomActionRenderersProvider>
+ <CurrentUserProvider currentUser={currentUser}>
+ <CustomActionRenderersProvider renderers={customActionRenderers}>
+ <ServerProvider server={server}>
+ {resolvedRoutes != null ? (
+ <ResolvedRoutesProvider routes={resolvedRoutes}>{visibilityTree}</ResolvedRoutesProvider>
+ ) : (
+ visibilityTree
+ )}
+ </ServerProvider>
+ </CustomActionRenderersProvider>
+ </CurrentUserProvider>
</SlotsProvider>
);
}
diff --git a/packages/trueforge-ui/src/contexts/CurrentUserContext.tsx b/packages/trueforge-ui/src/contexts/CurrentUserContext.tsx
new file mode 100644
index 000000000..25da6e642
--- /dev/null
+++ b/packages/trueforge-ui/src/contexts/CurrentUserContext.tsx
@@ -0,0 +1,21 @@
+import { createContext, useContext, type ReactNode } from 'react';
+
+export type CurrentUser = {
+ displayName: string;
+};
+
+const CurrentUserContext = createContext<CurrentUser | undefined>(undefined);
+
+export function CurrentUserProvider({
+ currentUser,
+ children,
+}: {
+ currentUser: CurrentUser | undefined;
+ children: ReactNode;
+}) {
+ return <CurrentUserContext.Provider value={currentUser}>{children}</CurrentUserContext.Provider>;
+}
+
+export function useOptionalCurrentUser(): CurrentUser | undefined {
+ return useContext(CurrentUserContext);
+}
diff --git a/packages/trueforge-ui/src/index.ts b/packages/trueforge-ui/src/index.ts
index 7cd219ec9..46cbd05f6 100644
--- a/packages/trueforge-ui/src/index.ts
+++ b/packages/trueforge-ui/src/index.ts
@@ -125,6 +125,8 @@ export type {
ThreadRootShellProps,
ThreadViewportShellProps,
} from './atoms/ThreadShell.js';
+export { UserAvatar } from './atoms/UserAvatar.js';
+export type { UserAvatarProps } from './atoms/UserAvatar.js';
export { UserMessageActionBar } from './atoms/UserMessageActionBar.js';
export type { UserMessageActionBarProps } from './atoms/UserMessageActionBar.js';
export { UserMessageBubble } from './atoms/UserMessageBubble.js';
@@ -251,6 +253,8 @@ export type { UseResourcePermissionsOptions, UseResourcePermissionsResult } from
// Curated chrome hooks (same instance as the SDK runtime). Deep primitives: install @assistant-ui/react.
export { useAui, useAuiState } from './assistant-ui.js';
export type { AssistantState } from './assistant-ui.js';
+export { useOptionalCurrentUser } from './contexts/CurrentUserContext.js';
+export type { CurrentUser } from './contexts/CurrentUserContext.js';
export { useTheme } from './theme/useTheme.js';
// Runtime / server — consumer surface.
diff --git a/packages/trueforge-ui/src/layouts/DrawerLayout.tsx b/packages/trueforge-ui/src/layouts/DrawerLayout.tsx
index cace27f98..0eed6f105 100644
--- a/packages/trueforge-ui/src/layouts/DrawerLayout.tsx
+++ b/packages/trueforge-ui/src/layouts/DrawerLayout.tsx
@@ -31,6 +31,7 @@ export function DrawerLayout({ className }: { className?: string }) {
const SessionsPage = useSlot('SessionsPage');
const SaveAgentButton = useSlot('SaveAgentButton');
const SelectAgentEmptyState = useSlot('SelectAgentEmptyState');
+ const UserAvatar = useSlot('UserAvatar');
const mainRef = useRef<HTMLDivElement>(null);
const isIdle = shell?.mode.status === 'idle';
const settingsOpen = shell?.settingsOpen === true;
@@ -104,6 +105,7 @@ export function DrawerLayout({ className }: { className?: string }) {
</>
) : null}
<ShellActions key="shell-actions" />
+ <UserAvatar />
{!overlayOpen ? (
<>
{showNewActions ? (
diff --git a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx b/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
index 934ad262d..d23c9d68a 100644
--- a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
+++ b/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
@@ -137,6 +137,7 @@ function SidebarRail({
const brand = useBrand();
const chrome = resolveBrandChrome(brand);
const BrandLogo = useSlot('BrandLogo');
+ const UserAvatar = useSlot('UserAvatar');
return (
<aside
@@ -160,6 +161,7 @@ function SidebarRail({
<SidebarNav />
<footer className="flex shrink-0 flex-col items-center border-border p-2">
<ShellActions labeled className="flex-col" />
+ <UserAvatar labeled className="mt-1" />
</footer>
</aside>
);
diff --git a/packages/trueforge-ui/src/layouts/StackChatPanel.tsx b/packages/trueforge-ui/src/layouts/StackChatPanel.tsx
index bd18994ab..86a4276e5 100644
--- a/packages/trueforge-ui/src/layouts/StackChatPanel.tsx
+++ b/packages/trueforge-ui/src/layouts/StackChatPanel.tsx
@@ -39,6 +39,7 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro
const SessionsPage = useSlot('SessionsPage');
const SaveAgentButton = useSlot('SaveAgentButton');
const SelectAgentEmptyState = useSlot('SelectAgentEmptyState');
+ const UserAvatar = useSlot('UserAvatar');
const isIdle = shell?.mode.status === 'idle';
const settingsOpen = shell?.settingsOpen === true;
const libraryOpen = shell?.libraryOpen === true;
@@ -164,21 +165,22 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro
)}
{/* Stable mount: only ShellActions needs to survive Settings / list / thread; host end chrome stays in the thread header. */}
<footer className="flex shrink-0 items-center justify-between border-t border-border px-2 py-1.5">
- {libraryOpen || schedulesOpen ? (
- <button
- type="button"
- className={auiButtonClass({ variant: 'ghost', size: 'small' })}
- onClick={() => {
- shell?.setLibraryOpen(false);
- shell?.setSchedulesOpen(false);
- }}
- >
- <Icon name="arrow-left" />
- Back to chat
- </button>
- ) : (
- <span />
- )}
+ <div className="flex min-w-0 items-center gap-1">
+ {libraryOpen || schedulesOpen ? (
+ <button
+ type="button"
+ className={auiButtonClass({ variant: 'ghost', size: 'small' })}
+ onClick={() => {
+ shell?.setLibraryOpen(false);
+ shell?.setSchedulesOpen(false);
+ }}
+ >
+ <Icon name="arrow-left" />
+ Back to chat
+ </button>
+ ) : null}
+ <UserAvatar />
+ </div>
<ShellActions key="shell-actions" />
</footer>
{shell?.agentConfigOpen ? (
diff --git a/packages/trueforge-ui/src/theme/defaultSlots.ts b/packages/trueforge-ui/src/theme/defaultSlots.ts
index 8f6b77dc9..326e00cec 100644
--- a/packages/trueforge-ui/src/theme/defaultSlots.ts
+++ b/packages/trueforge-ui/src/theme/defaultSlots.ts
@@ -97,6 +97,7 @@ import { ToolApprovalBar } from '../atoms/ToolApprovalBar.js';
import { ToolCallCard } from '../atoms/ToolCallCard.js';
import { ToolCallContentBlock } from '../atoms/ToolCallContentBlock.js';
import { ToolGroupCard } from '../atoms/ToolGroupCard.js';
+import { UserAvatar } from '../atoms/UserAvatar.js';
import { UserMessageActionBar } from '../atoms/UserMessageActionBar.js';
import { UserMessageBubble } from '../atoms/UserMessageBubble.js';
import { UserMessageEdit } from '../atoms/UserMessageEdit.js';
@@ -253,4 +254,5 @@ export const defaultSlots = {
Toast,
ToastStack,
ShellActionsActionSlot,
+ UserAvatar,
} satisfies AtomSlots;
diff --git a/packages/trueforge-ui/test/atoms/UserAvatar.test.tsx b/packages/trueforge-ui/test/atoms/UserAvatar.test.tsx
new file mode 100644
index 000000000..00e779afc
--- /dev/null
+++ b/packages/trueforge-ui/test/atoms/UserAvatar.test.tsx
@@ -0,0 +1,47 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { getUserInitials, UserAvatar } from '@/atoms/UserAvatar.js';
+import { CurrentUserProvider } from '@/contexts/CurrentUserContext.js';
+
+describe('getUserInitials', () => {
+ it.each([
+ ['Ada Lovelace', 'AL'],
+ ['Ada King Lovelace', 'AL'],
+ ['Ada', 'AD'],
+ ['Ada Ada', 'AA'],
+ [' ada lovelace ', 'AL'],
+ ['', ''],
+ [' ', ''],
+ ])('returns initials for %j', (displayName, expected) => {
+ expect(getUserInitials(displayName)).toBe(expected);
+ });
+});
+
+describe('UserAvatar', () => {
+ it('shows initials with the full display name underneath', () => {
+ render(
+ <CurrentUserProvider currentUser={{ displayName: 'Ada Lovelace' }}>
+ <UserAvatar labeled />
+ </CurrentUserProvider>,
+ );
+
+ const avatar = screen.getByLabelText('Ada Lovelace');
+ expect(avatar).toHaveTextContent('AL');
+ expect(avatar).toHaveTextContent('Ada Lovelace');
+ expect(avatar).toHaveAttribute('title', 'Ada Lovelace');
+ expect(avatar).toHaveClass('w-14.5');
+ });
+
+ it('renders nothing without a non-empty display name', () => {
+ const { container, rerender } = render(<UserAvatar />);
+ expect(container).toBeEmptyDOMElement();
+
+ rerender(
+ <CurrentUserProvider currentUser={{ displayName: ' ' }}>
+ <UserAvatar />
+ </CurrentUserProvider>,
+ );
+ expect(container).toBeEmptyDOMElement();
+ });
+});
diff --git a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
index 42ff9f52d..d1380cf1c 100644
--- a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
+++ b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
@@ -56,6 +56,7 @@ vi.mock('@/plugins/trueforge-agent-server-adapter/index.js', () => ({
}));
import { AgentConfigInstructionsProvider } from '@/atoms/draft/AgentConfigInstructionsContext.js';
+import type { UserAvatarProps } from '@/atoms/UserAvatar.js';
import { TrueForgeUI, type ChatLayout } from '@/containers/TrueForgeUI.js';
import { DrawerLayout } from '@/layouts/DrawerLayout.js';
import { SidebarLayout } from '@/layouts/SidebarLayout.js';
@@ -71,6 +72,10 @@ function mockServer(catalog?: CatalogServer) {
return createMockAgentUIServer(catalog === undefined ? {} : { catalog });
}
+function CustomUserAvatar({ labeled = false }: UserAvatarProps) {
+ return <div data-testid="custom-user-avatar">{labeled ? 'labeled user' : 'compact user'}</div>;
+}
+
/** Minimal catalog stub — ShellActions only checks presence. */
const stubCatalog = createMockCatalog();
@@ -135,6 +140,54 @@ describe('TrueForgeUI', () => {
expect(container.querySelector('.h-96')).toBeInTheDocument();
});
+ it.each(layouts)('renders the current user in layout=%s chrome', async layout => {
+ render(
+ <TrueForgeUI
+ server={server}
+ agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}
+ layout={layout}
+ currentUser={{ displayName: 'Ada Lovelace' }}
+ className="h-96"
+ />,
+ );
+
+ if (layout === 'widget') {
+ fireEvent.click(await screen.findByRole('button', { name: 'Open chat' }));
+ }
+
+ const avatar = await screen.findByLabelText('Ada Lovelace');
+ expect(avatar).toHaveTextContent('AL');
+ expect(avatar).toHaveTextContent('Ada Lovelace');
+ if (layout === 'sidebar') {
+ expect(avatar.closest('aside')).not.toBeNull();
+ expect(avatar).toHaveClass('w-14.5');
+ } else if (layout === 'drawer') {
+ expect(avatar.closest('header')).not.toBeNull();
+ } else {
+ expect(avatar.closest('footer')).not.toBeNull();
+ }
+ });
+
+ it.each(layouts)('honors overrides.UserAvatar in layout=%s', async layout => {
+ render(
+ <TrueForgeUI
+ server={server}
+ agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}
+ layout={layout}
+ overrides={{ UserAvatar: CustomUserAvatar }}
+ className="h-96"
+ />,
+ );
+
+ if (layout === 'widget') {
+ fireEvent.click(await screen.findByRole('button', { name: 'Open chat' }));
+ }
+
+ expect(await screen.findByTestId('custom-user-avatar')).toHaveTextContent(
+ layout === 'sidebar' ? 'labeled user' : 'compact user',
+ );
+ });
+
it('keeps the widget open across mutable runtime remounts', async () => {
render(
<TrueForgeUI server={mockServer()} agentConfig={{ mode: 'AgentComposer' }} layout="widget" className="h-96" />,
diff --git a/packages/trueforge-ui/test/publicUiExports.test.ts b/packages/trueforge-ui/test/publicUiExports.test.ts
index b16eaa438..a83da2e58 100644
--- a/packages/trueforge-ui/test/publicUiExports.test.ts
+++ b/packages/trueforge-ui/test/publicUiExports.test.ts
@@ -156,6 +156,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = [
'TrueFoundryChatProvider',
'TrueForgeUI',
'USER_MESSAGE_ATTACHMENT_PREVIEW_REM',
+ 'UserAvatar',
'UserEditComposerContainer',
'UserMessageActionBar',
'UserMessageBubble',
@@ -198,6 +199,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = [
'useOptionalAgentSessionsServer',
'useOptionalCatalogServer',
'useOptionalContentClassNames',
+ 'useOptionalCurrentUser',
'useOptionalCustomActionRenderers',
'useOptionalPermissionsServer',
'useOptionalScheduleServer',