Skip to content

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

feat: added conclusive test suite (#93)

vinit-truefoundry6da501da0312
diff --git a/packages/trueforge-ui-sdk/eslint.config.js b/packages/trueforge-ui-sdk/eslint.config.js
index 218825190..e52bd005c 100644
--- a/packages/trueforge-ui-sdk/eslint.config.js
+++ b/packages/trueforge-ui-sdk/eslint.config.js
@@ -10,7 +10,7 @@ export default tseslint.config(
eslint.configs.recommended,
...tseslint.configs.recommended,
{
- files: ['src/**/*.{ts,tsx}'],
+ files: ['src/**/*.{ts,tsx}', 'test/**/*.{ts,tsx}'],
languageOptions: {
ecmaVersion: 2022,
globals: {
diff --git a/packages/trueforge-ui-sdk/package.json b/packages/trueforge-ui-sdk/package.json
index 00ba06fec..6ca3adb87 100644
--- a/packages/trueforge-ui-sdk/package.json
+++ b/packages/trueforge-ui-sdk/package.json
@@ -52,11 +52,12 @@
"build": "tsup && tailwindcss --input src/build-styles.css --output dist/styles.css --minify",
"dev:watch": "tsup --watch",
"pack:tgz": "pnpm build && pnpm pack",
- "test": "vitest run",
+ "test": "vitest run && pnpm test:package",
+ "test:package": "pnpm build && node test/packageExports.smoke.mjs",
"test:coverage": "vitest run --coverage",
- "typecheck": "tsc --noEmit",
- "lint": "eslint src --ext .ts,.tsx",
- "format": "prettier --write \"src/**/*.{ts,tsx,css,md}\" \"*.md\" \"docs/**/*.md\""
+ "typecheck": "tsc --noEmit && tsc --noEmit -p test/tsconfig.json",
+ "lint": "eslint src test --ext .ts,.tsx",
+ "format": "prettier --write \"src/**/*.{ts,tsx,css,md}\" \"test/**/*.{ts,tsx}\" \"*.md\" \"docs/**/*.md\" --config ../../.prettierrc"
},
"peerDependencies": {
"@assistant-ui/core": "^0.2.22",
diff --git a/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx b/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx
index e518cebbd..6aa9ccc3a 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/AttachmentCard.tsx
@@ -76,7 +76,11 @@ export function AttachmentCard({
type="button"
aria-label="Remove file"
title="Remove file"
- className={auiButtonClass({ variant: 'ghost', size: 'icon', className: 'size-6 shrink-0 rounded-full' })}
+ className={auiButtonClass({
+ variant: 'ghost',
+ size: 'icon',
+ className: 'size-6 shrink-0 rounded-full',
+ })}
onClick={onRemove}
>
<Icon name="xmark" />
diff --git a/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsx b/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsx
deleted file mode 100644
index 0b5616c9b..000000000
--- a/packages/trueforge-ui-sdk/src/atoms/primitives/BottomSheet.test.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-// @vitest-environment jsdom
-import { fireEvent, render, screen } from '@testing-library/react';
-import { describe, expect, it, vi } from 'vitest';
-
-import { BottomSheet } from './BottomSheet.js';
-
-HTMLDialogElement.prototype.showModal = function showModal() {
- this.setAttribute('open', '');
-};
-
-describe('BottomSheet', () => {
- it('handles Escape without closing a parent dialog', () => {
- const onOpenChange = vi.fn();
- const onParentCancel = vi.fn();
-
- render(
- <dialog open onCancel={onParentCancel}>
- <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">
- Content
- </BottomSheet>
- </dialog>,
- );
-
- fireEvent(screen.getByRole('dialog', { name: 'Picker' }), new Event('cancel', { bubbles: true }));
-
- expect(onOpenChange).toHaveBeenCalledWith(false);
- expect(onParentCancel).not.toHaveBeenCalled();
- });
-});
diff --git a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
index 9cc223a37..335622044 100644
--- a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
@@ -8,8 +8,7 @@ import { DraftCatalogProvider } from '../atoms/draft/DraftCatalogProvider.js';
import { useComposerBusyState } from '../hooks/useComposerBusyState.js';
import { useComposerPauseView } from '../hooks/useComposerPauseView.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
-import { defaultSlots } from '../theme/defaultSlots.js';
-import { SlotsProvider, useSlot } from '../theme/SlotsProvider.js';
+import { SlotsProvider, useSlot, useSlotIsDefault } from '../theme/SlotsProvider.js';
import { AskUserContainer } from './AskUserContainer.js';
import { ComposerAttachmentsContainer } from './AttachmentsContainer.js';
import { McpAuthContainer } from './McpAuthContainer.js';
@@ -18,14 +17,6 @@ export type ComposerContainerProps = {
placeholder?: string;
};
-/**
- * Use draft UI only when the host did not override the slot.
- * Example: host overrides LeftSection → keep host; else → DraftComposerLeftSection.
- */
-function preferHostSlotOverride<T>(parentSlot: T, stockDefault: T, draftDefault: T): T {
- return parentSlot === stockDefault ? draftDefault : parentSlot;
-}
-
function ComposerBody({ placeholder }: { placeholder: string }) {
const ComposerShell = useSlot('ComposerShell');
const aui = useAui();
@@ -101,6 +92,8 @@ export function ComposerContainer({
const shell = useOptionalShellMode();
const parentLeftSection = useSlot('ComposerLeftSection');
const parentRightSection = useSlot('ComposerRightSection');
+ const usesDefaultLeftSection = useSlotIsDefault('ComposerLeftSection');
+ const usesDefaultRightSection = useSlotIsDefault('ComposerRightSection');
const DraftComposerLeftSection = useSlot('DraftComposerLeftSection');
const DraftComposerRightSection = useSlot('DraftComposerRightSection');
const canMutateSpec = shell?.mode.status === 'active' && shell.mode.isMutable;
@@ -117,16 +110,8 @@ export function ComposerContainer({
<DraftCatalogProvider>
<SlotsProvider
overrides={{
- ComposerLeftSection: preferHostSlotOverride(
- parentLeftSection,
- defaultSlots.ComposerLeftSection,
- DraftComposerLeftSection,
- ),
- ComposerRightSection: preferHostSlotOverride(
- parentRightSection,
- defaultSlots.ComposerRightSection,
- DraftComposerRightSection,
- ),
+ ComposerLeftSection: usesDefaultLeftSection ? DraftComposerLeftSection : parentLeftSection,
+ ComposerRightSection: usesDefaultRightSection ? DraftComposerRightSection : parentRightSection,
}}
>
<ComposerBody placeholder={placeholder} />
diff --git a/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsx b/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsx
deleted file mode 100644
index d7d25eabd..000000000
--- a/packages/trueforge-ui-sdk/src/containers/ErrorToasterContainer.test.tsx
+++ /dev/null
@@ -1,83 +0,0 @@
-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-import { Toast } from '../atoms/Toast.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { ErrorToasterProvider, useErrorToaster } from './ErrorToasterContainer.js';
-
-function Trigger({ errors }: { errors: unknown[] }) {
- const { showError } = useErrorToaster();
- return (
- <button
- type="button"
- onClick={() => {
- for (const error of errors) showError(error);
- }}
- >
- boom
- </button>
- );
-}
-
-describe('ErrorToasterProvider', () => {
- beforeEach(() => {
- vi.spyOn(console, 'error').mockImplementation(() => {});
- });
-
- it('stacks multiple error toasts', async () => {
- render(
- <SlotsProvider>
- <ErrorToasterProvider>
- <Trigger errors={[new Error('first'), new Error('second')]} />
- </ErrorToasterProvider>
- </SlotsProvider>,
- );
-
- fireEvent.click(screen.getByRole('button', { name: 'boom' }));
-
- expect(await screen.findByText('first')).toBeTruthy();
- expect(screen.getByText('second')).toBeTruthy();
- expect(screen.getAllByRole('alert')).toHaveLength(2);
- });
-
- it('dismisses one toast without removing the other', async () => {
- render(
- <SlotsProvider>
- <ErrorToasterProvider>
- <Trigger errors={[new Error('keep-me'), new Error('drop-me')]} />
- </ErrorToasterProvider>
- </SlotsProvider>,
- );
-
- fireEvent.click(screen.getByRole('button', { name: 'boom' }));
- expect(await screen.findByText('drop-me')).toBeTruthy();
-
- const dropToast = screen.getByText('drop-me').closest("[role='alert']");
- expect(dropToast).toBeTruthy();
- fireEvent.click(dropToast!.querySelector('[aria-label="Close"]')!);
-
- await waitFor(() => {
- expect(screen.queryByText('drop-me')).toBeNull();
- });
- expect(screen.getByText('keep-me')).toBeTruthy();
- });
-});
-
-describe('Toast copy', () => {
- it('copies title and description', async () => {
- const writeText = vi.fn().mockResolvedValue(undefined);
- Object.assign(navigator, { clipboard: { writeText } });
-
- render(
- <SlotsProvider>
- <Toast title="Request failed" description="body detail" open onOpenChange={() => {}} />
- </SlotsProvider>,
- );
-
- await act(async () => {
- fireEvent.click(screen.getByRole('button', { name: 'Copy' }));
- });
-
- expect(writeText).toHaveBeenCalledWith('Request failed\nbody detail');
- });
-});
diff --git a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx b/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx
index c10796060..f10e8c946 100644
--- a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/ThreadContainer.tsx
@@ -17,7 +17,13 @@ import { UserMessageContainer } from './UserMessageContainer.js';
// `remoteId == null` keeps welcome off during first-turn edit/retry: the
// runtime briefly rewinds to an empty snapshot before applying pendingUser,
// and messages.length===0 alone would flash the welcome screen.
-export const isNewChatView = (s: AssistantState) =>
+type NewChatViewState = {
+ thread: Pick<AssistantState['thread'], 'messages' | 'isLoading'>;
+ threads: Pick<AssistantState['threads'], 'isLoading'>;
+ threadListItem: Pick<AssistantState['threadListItem'], 'remoteId'>;
+};
+
+export const isNewChatView = (s: NewChatViewState) =>
s.thread.messages.length === 0 && (!s.thread.isLoading || s.threads.isLoading) && s.threadListItem.remoteId == null;
/** Mount-only lift. Keyed by message.id via ThreadPrimitive.Messages — not content (streaming). */
diff --git a/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsx b/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsx
deleted file mode 100644
index 9ebe89fb3..000000000
--- a/packages/trueforge-ui-sdk/src/containers/TrueFoundryChatProvider.test.tsx
+++ /dev/null
@@ -1,50 +0,0 @@
-// @vitest-environment jsdom
-import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';
-import { render, screen } from '@testing-library/react';
-import { describe, expect, it, vi } from 'vitest';
-import type { AgentUIServer } from '../server/types.js';
-
-vi.mock('@truefoundry/assistant-ui-runtime', () => ({
- trueFoundryAttachmentAdapter: {},
- useTrueFoundryAgentRuntime: () =>
- // Called from ChatRuntimeScope (a React component), so hooks are valid here.
- useExternalStoreRuntime<ThreadMessageLike>({
- messages: [],
- isRunning: false,
- convertMessage: (message: ThreadMessageLike) => message,
- onNew: async () => {},
- }),
-}));
-
-import { TrueFoundryChatProvider } from './TrueFoundryChatProvider.js';
-
-function mockServer(): AgentUIServer {
- return {
- createSession: vi.fn(),
- listSessions: vi.fn(),
- getSession: vi.fn(),
- updateSession: vi.fn(),
- createTurn: vi.fn(),
- cancelSession: vi.fn(),
- listTurns: vi.fn(),
- getTurn: vi.fn(),
- listEvents: vi.fn(),
- getModels: vi.fn(async () => []),
- getSkills: vi.fn(async () => []),
- getMcp: vi.fn(async () => []),
- searchAgents: vi.fn(async () => []),
- saveAgent: vi.fn(async () => ({})),
- } as unknown as AgentUIServer;
-}
-
-describe('TrueFoundryChatProvider', () => {
- it('mounts children under the chat provider with a mock server', () => {
- render(
- <TrueFoundryChatProvider server={mockServer()} agentName="my-agent">
- <div>chat-child</div>
- </TrueFoundryChatProvider>,
- );
-
- expect(screen.getByText('chat-child')).toBeInTheDocument();
- });
-});
diff --git a/packages/trueforge-ui-sdk/src/icons/Icon.tsx b/packages/trueforge-ui-sdk/src/icons/Icon.tsx
index e177eb7d1..5ce00bda5 100644
--- a/packages/trueforge-ui-sdk/src/icons/Icon.tsx
+++ b/packages/trueforge-ui-sdk/src/icons/Icon.tsx
@@ -1,16 +1,9 @@
-import {
- createElement,
- isValidElement,
- useContext,
- type ComponentType,
- type CSSProperties,
- type ReactNode,
-} from 'react';
+import { createElement, isValidElement, useContext, type CSSProperties, type ReactNode } from 'react';
import { cn } from '../atoms/lib/cn.js';
import { ThemeContext } from '../theme/ThemeProvider.js';
-import type { IconProps as ThemeIconProps } from '../theme/types.js';
-import { lookupIcon, resolveIconName, type IconEntry } from './IconRegistry.js';
+import type { IconComponent, IconEntry, IconProps as ThemeIconProps } from '../theme/types.js';
+import { lookupIcon, resolveIconName } from './IconRegistry.js';
export type IconProps = ThemeIconProps & {
name: string | readonly string[];
@@ -23,9 +16,9 @@ type IconRenderProps = {
width?: string | number;
height?: string | number;
role?: string;
-} & Pick<IconProps, 'aria-hidden' | 'aria-label'>;
+} & Pick<IconProps, 'aria-hidden' | 'aria-label' | 'data-testid'>;
-function isComponent(entry: IconEntry): boolean {
+function isComponent(entry: IconEntry): entry is IconComponent {
if (typeof entry === 'function') return true;
// Lucide (and other) icons are forwardRef objects, not functions
return (
@@ -40,7 +33,7 @@ function isComponent(entry: IconEntry): boolean {
function renderEntry(entry: IconEntry, props: IconRenderProps): ReactNode {
if (isComponent(entry)) {
const { size, className, style, ...aria } = props;
- return createElement(entry as ComponentType<IconRenderProps>, {
+ return createElement(entry, {
className: cn('inline-block shrink-0', className),
style,
size,
@@ -48,10 +41,11 @@ function renderEntry(entry: IconEntry, props: IconRenderProps): ReactNode {
height: size,
'aria-hidden': aria['aria-label'] ? undefined : (aria['aria-hidden'] ?? true),
'aria-label': aria['aria-label'],
+ ...(aria['data-testid'] === undefined ? {} : { 'data-testid': aria['data-testid'] }),
role: aria['aria-label'] ? 'img' : undefined,
});
}
- return entry as ReactNode;
+ return entry;
}
export function Icon({ name, className, style, size = '1em', ...aria }: IconProps) {
diff --git a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
index ff5ceacdd..71f1d762a 100644
--- a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
+++ b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
@@ -50,11 +50,8 @@ import {
Wrench,
X,
} from 'lucide-react';
-import type { FC, ReactNode, SVGProps } from 'react';
-import type { IconMap, IconProps } from '../theme/types.js';
-
-export type IconEntry = LucideIcon | ReactNode | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>;
+import type { IconEntry, IconMap } from '../theme/types.js';
const registry = new Map<string, IconEntry>();
@@ -62,7 +59,7 @@ export function registerIcon(name: string, icon: IconEntry): void {
registry.set(name, icon);
}
-export function registerIcons(icons: Record<string, IconEntry>): void {
+export function registerIcons(icons: IconMap): void {
for (const [name, icon] of Object.entries(icons)) {
registry.set(name, icon);
}
@@ -142,7 +139,7 @@ for (const [name, icon] of Object.entries(defaults)) {
/** Merge host `theme.icons` over the registry for a single lookup (does not mutate). */
export function lookupIcon(name: string, themeIcons?: IconMap): IconEntry | undefined {
if (themeIcons && name in themeIcons) {
- return themeIcons[name] as IconEntry;
+ return themeIcons[name];
}
return registry.get(name);
}
diff --git a/packages/trueforge-ui-sdk/src/index.ts b/packages/trueforge-ui-sdk/src/index.ts
index c25a60a7a..8d7ddb79b 100644
--- a/packages/trueforge-ui-sdk/src/index.ts
+++ b/packages/trueforge-ui-sdk/src/index.ts
@@ -323,7 +323,7 @@ export type {
// Utils
export { computeAgentStepsSplit } from './utils/computeAgentStepsSplit.js';
-export type { AgentStepsSplitResult } from './utils/computeAgentStepsSplit.js';
+export type { AgentStepPart, AgentStepsSplitResult } from './utils/computeAgentStepsSplit.js';
export { AgentsLibrary } from './atoms/AgentsLibrary.js';
export type { AgentsLibraryProps } from './atoms/AgentsLibrary.js';
diff --git a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
index ff754ebac..09b3c4c72 100644
--- a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
+++ b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
@@ -77,6 +77,12 @@ export function useSlot<K extends keyof PublicAtomSlots>(name: K): PublicAtomSlo
return slots[name];
}
+/** Whether the currently resolved slot is the SDK's stock implementation. */
+export function useSlotIsDefault<K extends keyof PublicAtomSlots>(name: K): boolean {
+ const slots = useContext(SlotsContext);
+ return slots[name] === defaultSlots[name];
+}
+
/** Resolves the light or dark theme mode supplied by the SDK consumer. */
export function useThemeMode(): 'light' | 'dark' {
return useContext(ThemeModeContext) ?? 'light';
diff --git a/packages/trueforge-ui-sdk/src/theme/types.ts b/packages/trueforge-ui-sdk/src/theme/types.ts
index 53cc2c7c7..e64f6a723 100644
--- a/packages/trueforge-ui-sdk/src/theme/types.ts
+++ b/packages/trueforge-ui-sdk/src/theme/types.ts
@@ -46,12 +46,14 @@ export type IconProps = {
size?: string | number;
'aria-hidden'?: boolean | 'true' | 'false';
'aria-label'?: string;
+ 'data-testid'?: string;
};
-export type IconMap = Record<
- string,
- LucideIcon | ReactNode | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>
->;
+export type IconComponent = LucideIcon | ((props: IconProps) => ReactNode) | FC<SVGProps<SVGSVGElement>>;
+
+export type IconEntry = IconComponent | ReactNode;
+
+export type IconMap = Record<string, IconEntry>;
export type BrandImage = { src: string; alt?: string } | ReactNode | ((props: { className?: string }) => ReactNode);
diff --git a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts b/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts
index b5e82ea02..61802d1c3 100644
--- a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts
+++ b/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.ts
@@ -1,5 +1,10 @@
import type { PartState } from '@assistant-ui/core/react';
+export type AgentStepPart = {
+ type: PartState['type'];
+ text?: string;
+};
+
export interface AgentStepsSplitResult {
cutIndex: number;
hasFinal: boolean;
@@ -7,7 +12,7 @@ export interface AgentStepsSplitResult {
thinkingCount: number;
}
-export function computeAgentStepsSplit(parts: readonly PartState[], isRunning: boolean): AgentStepsSplitResult {
+export function computeAgentStepsSplit(parts: readonly AgentStepPart[], isRunning: boolean): AgentStepsSplitResult {
const finalTexts: Array<{ index: number; content: string }> = [];
let cutIdx = parts.length;
@@ -16,7 +21,7 @@ export function computeAgentStepsSplit(parts: readonly PartState[], isRunning: b
if (!part) continue;
if (part.type === 'text') {
- const text = (part as { text?: string }).text ?? '';
+ const text = part.text ?? '';
const trimmed = text.trim();
if (trimmed) {
diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsx
similarity index 61%
rename from packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsx
index 62860cd33..ba9b43b63 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AgentHistoryFilterButton.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/AgentHistoryFilterButton.test.tsx
@@ -1,27 +1,39 @@
// @vitest-environment jsdom
import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
import type { ReactNode } from 'react';
-import { describe, expect, it, vi } from 'vitest';
-
-import { ServerProvider } from '../server/ServerContext.js';
-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';
-import type { AgentUIServer } from '../server/types.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { AgentHistoryFilterButton } from './AgentHistoryFilterButton.js';
-
-HTMLDialogElement.prototype.showModal = function showModal() {
- this.setAttribute('open', '');
-};
-HTMLDialogElement.prototype.close = function close() {
- this.removeAttribute('open');
- this.dispatchEvent(new Event('close'));
-};
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { AgentHistoryFilterButton } from '@/atoms/AgentHistoryFilterButton.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
+import type { AgentUIServer } from '@/server/types.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
+
+const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');
+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');
+
+beforeEach(() => {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {
+ configurable: true,
+ value(this: HTMLDialogElement) {
+ this.open = true;
+ },
+ });
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {
+ configurable: true,
+ value(this: HTMLDialogElement) {
+ this.open = false;
+ this.dispatchEvent(new Event('close'));
+ },
+ });
+});
function mockServer(partial: Partial<AgentUIServer> = {}): AgentUIServer {
- return {
- searchAgents: vi.fn().mockResolvedValue([{ name: 'from-sdk' }, { name: 'other' }]),
+ return createMockAgentUIServer({
+ searchAgents: async () => [{ name: 'from-sdk' }, { name: 'other' }],
...partial,
- } as AgentUIServer;
+ });
}
function FilterProbe() {
@@ -50,6 +62,20 @@ function wrap({
};
}
+afterEach(() => {
+ vi.unstubAllGlobals();
+ if (originalShowModal === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);
+ }
+ if (originalClose === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);
+ }
+});
+
describe('AgentHistoryFilterButton', () => {
it('renders nothing when library is disabled', () => {
render(<AgentHistoryFilterButton />, {
@@ -59,7 +85,8 @@ describe('AgentHistoryFilterButton', () => {
});
it('opens popover and sets history filter on agent click', async () => {
- const server = mockServer();
+ const searchAgents = vi.fn(async () => [{ name: 'from-sdk' }, { name: 'other' }]);
+ const server = mockServer({ searchAgents });
render(<AgentHistoryFilterButton />, {
wrapper: wrap({ agentConfig: { mode: 'AgentLibraryWithComposer' }, server }),
});
@@ -74,7 +101,7 @@ describe('AgentHistoryFilterButton', () => {
});
expect(screen.getByTestId('filter-value')).toHaveTextContent('from-sdk');
- expect(server.searchAgents).toHaveBeenCalled();
+ expect(searchAgents).toHaveBeenCalled();
});
it('opens a bottom sheet on mobile', async () => {
@@ -100,7 +127,5 @@ describe('AgentHistoryFilterButton', () => {
expect(screen.getByRole('dialog', { name: /Filter agents/i })).toBeInTheDocument();
});
await waitFor(() => expect(screen.getByRole('menuitem', { name: /from-sdk/i })).toBeInTheDocument());
-
- vi.unstubAllGlobals();
});
});
diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
similarity index 91%
rename from packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
index 830898d9f..68949c338 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
@@ -2,13 +2,14 @@
import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { beforeAll, describe, expect, it, vi } from 'vitest';
-import { ServerProvider } from '../server/ServerContext.js';
-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';
-import type { AgentUIServer } from '../server/types.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { AgentsLibrary } from './AgentsLibrary.js';
-import { AgentsLibraryButton } from './AgentsLibraryButton.js';
-import { CenteredModal } from './primitives/CenteredModal.js';
+import { AgentsLibrary } from '@/atoms/AgentsLibrary.js';
+import { AgentsLibraryButton } from '@/atoms/AgentsLibraryButton.js';
+import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
+import type { AgentUIServer } from '@/server/types.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
beforeAll(() => {
// jsdom does not implement HTMLDialogElement showModal/close.
@@ -28,9 +29,9 @@ function mockServer(
agentSpec?: { model: { name: string }; skills?: Array<{ id: string; name: string }> };
}> = [{ name: 'alpha-agent' }],
): AgentUIServer {
- return {
+ return createMockAgentUIServer({
searchAgents: vi.fn(async () => agents),
- } as unknown as AgentUIServer;
+ });
}
describe('CenteredModal', () => {
diff --git a/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsx
new file mode 100644
index 000000000..b72bce163
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/AssistantMessageBubble.test.tsx
@@ -0,0 +1,32 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { AssistantMessageBubble } from '@/atoms/AssistantMessageBubble.js';
+
+describe('AssistantMessageBubble', () => {
+ it('renders message, error, and action content in their regions', () => {
+ const { container } = render(
+ <AssistantMessageBubble
+ error={<span>Generation failed</span>}
+ actionBar={<button type="button">Copy response</button>}
+ className="host-bubble"
+ >
+ <p>Assistant response</p>
+ </AssistantMessageBubble>,
+ );
+
+ const root = container.querySelector('[data-slot="aui_assistant-message-root"]');
+ expect(root).toHaveClass('host-bubble');
+ expect(root).toContainElement(screen.getByText('Assistant response'));
+ expect(screen.getByText('Generation failed').parentElement).toHaveClass('text-destructive');
+ expect(screen.getByRole('button', { name: 'Copy response' }).parentElement).toHaveClass('mt-1');
+ });
+
+ it('omits optional regions when their values are absent', () => {
+ const { container } = render(<AssistantMessageBubble>Only the message</AssistantMessageBubble>);
+
+ expect(screen.getByText('Only the message')).toBeInTheDocument();
+ expect(container.querySelector('.text-destructive')).not.toBeInTheDocument();
+ expect(container.querySelector('.mt-1')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsx
new file mode 100644
index 000000000..d4fd542af
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentCard.test.tsx
@@ -0,0 +1,56 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { AttachmentCard } from '@/atoms/AttachmentCard.js';
+
+describe('AttachmentCard', () => {
+ it('renders an image preview with accessible text and a configured size', () => {
+ const { container } = render(
+ <AttachmentCard
+ name="diagram.png"
+ previewSrc="/diagram.png"
+ isImage
+ size="preview"
+ previewRem={12}
+ className="consumer-class"
+ />,
+ );
+
+ const preview = container.querySelector('[data-slot="aui_attachment-preview"]');
+ expect(preview).toHaveClass('consumer-class');
+ expect(preview).toHaveStyle({ width: '12rem', height: '12rem' });
+ expect(screen.getByRole('img', { name: 'diagram.png' })).toHaveAttribute('src', '/diagram.png');
+ });
+
+ it('renders a removable image chip and invokes its removal callback', () => {
+ const onRemove = vi.fn();
+ const { container } = render(
+ <AttachmentCard
+ name="long-image-name.png"
+ previewSrc="/thumbnail.png"
+ isImage
+ previewRem={8}
+ onRemove={onRemove}
+ />,
+ );
+
+ const chip = container.querySelector('[data-slot="aui_attachment-chip"]');
+ expect(chip).toHaveStyle({ maxWidth: '8rem' });
+ expect(screen.getByRole('img', { name: 'long-image-name.png' })).toHaveAttribute('src', '/thumbnail.png');
+
+ const removeButton = screen.getByRole('button', { name: 'Remove file' });
+ expect(removeButton).toHaveAttribute('type', 'button');
+ expect(removeButton).toHaveAttribute('title', 'Remove file');
+ fireEvent.click(removeButton);
+ expect(onRemove).toHaveBeenCalledOnce();
+ });
+
+ it('falls back to a file chip when image preview data is unavailable', () => {
+ const { container } = render(<AttachmentCard name="report.pdf" contentType="application/pdf" isImage />);
+
+ expect(container.querySelector('[data-slot="aui_attachment-chip"]')).toBeInTheDocument();
+ expect(screen.getByText('report.pdf')).toBeInTheDocument();
+ expect(screen.queryByRole('img')).not.toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Remove file' })).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsx
new file mode 100644
index 000000000..806ce95ad
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentPickerButton.test.tsx
@@ -0,0 +1,30 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { AttachmentPickerButton } from '@/atoms/AttachmentPickerButton.js';
+
+describe('AttachmentPickerButton', () => {
+ it('provides an accessible button and forwards interaction props', () => {
+ const onClick = vi.fn();
+ render(<AttachmentPickerButton onClick={onClick} className="consumer-class" data-testid="picker" />);
+
+ const button = screen.getByRole('button', { name: 'Add Attachment' });
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveAttribute('title', 'Add Attachment');
+ expect(button).toHaveAttribute('data-testid', 'picker');
+ expect(button).toHaveClass('consumer-class');
+
+ fireEvent.click(button);
+ expect(onClick).toHaveBeenCalledOnce();
+ });
+
+ it('honors the native disabled state', () => {
+ const onClick = vi.fn();
+ render(<AttachmentPickerButton disabled onClick={onClick} />);
+
+ const button = screen.getByRole('button', { name: 'Add Attachment' });
+ expect(button).toBeDisabled();
+ fireEvent.click(button);
+ expect(onClick).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsx
new file mode 100644
index 000000000..4f041155c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/AttachmentPreviewDialog.test.tsx
@@ -0,0 +1,47 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { beforeAll, describe, expect, it } from 'vitest';
+
+import { AttachmentPreviewDialog } from '@/atoms/AttachmentPreviewDialog.js';
+
+beforeAll(() => {
+ HTMLDialogElement.prototype.showModal = function showModal() {
+ this.setAttribute('open', '');
+ };
+ HTMLDialogElement.prototype.close = function close() {
+ this.removeAttribute('open');
+ this.dispatchEvent(new Event('close'));
+ };
+});
+
+describe('AttachmentPreviewDialog', () => {
+ it('renders children directly when no preview source is available', () => {
+ render(
+ <AttachmentPreviewDialog>
+ <span>plain attachment</span>
+ </AttachmentPreviewDialog>,
+ );
+
+ expect(screen.getByText('plain attachment')).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Open attachment preview' })).not.toBeInTheDocument();
+ expect(screen.queryByRole('dialog')).not.toBeInTheDocument();
+ });
+
+ it('opens an accessible image dialog and closes it with its close control', () => {
+ render(
+ <AttachmentPreviewDialog previewSrc="/full-size.png">
+ <img src="/thumbnail.png" alt="diagram thumbnail" />
+ </AttachmentPreviewDialog>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Open attachment preview' });
+ expect(trigger).toHaveAttribute('type', 'button');
+ fireEvent.click(trigger);
+
+ const dialog = screen.getByRole('dialog', { name: 'Attachment preview' });
+ expect(dialog).toHaveAttribute('open');
+ expect(screen.getByRole('img', { name: 'Attachment preview' })).toHaveAttribute('src', '/full-size.png');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Close' }));
+ expect(dialog).not.toHaveAttribute('open');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsx
new file mode 100644
index 000000000..e0aa91908
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ChatFileDownload.test.tsx
@@ -0,0 +1,95 @@
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ChatFileDownload } from '@/atoms/ChatFileDownload.js';
+
+describe('ChatFileDownload', () => {
+ it('renders direct download links with singular and plural summaries', () => {
+ const { rerender } = render(
+ <ChatFileDownload
+ files={[{ name: 'report.pdf', path: '/report.pdf' }]}
+ fileDownloadBaseUrl="https://files.example.com"
+ />,
+ );
+
+ expect(screen.getByText('1 file generated')).toBeInTheDocument();
+ const reportLink = screen.getByRole('link', { name: 'Download report.pdf' });
+ expect(reportLink).toHaveAttribute('href', 'https://files.example.com/report.pdf');
+ expect(reportLink).toHaveAttribute('download', 'report.pdf');
+
+ rerender(
+ <ChatFileDownload
+ files={[
+ { name: 'report.pdf', path: '/report.pdf' },
+ { name: 'data.csv', path: '/data.csv' },
+ ]}
+ fileDownloadBaseUrl="/downloads"
+ />,
+ );
+ expect(screen.getByText('2 files generated')).toBeInTheDocument();
+ expect(screen.getByRole('link', { name: 'Download data.csv' })).toHaveAttribute('href', '/downloads/data.csv');
+ });
+
+ it('shows per-file progress and suppresses duplicate artifact downloads', async () => {
+ let resolveDownload: (() => void) | undefined;
+ const downloadPromise = new Promise<void>(resolve => {
+ resolveDownload = resolve;
+ });
+ const onDownloadArtifact = vi.fn(() => downloadPromise);
+ render(
+ <ChatFileDownload
+ files={[{ name: 'bundle.zip', path: '/bundle.zip' }]}
+ onDownloadArtifact={onDownloadArtifact}
+ />,
+ );
+
+ fireEvent.click(screen.getByRole('link', { name: 'Download bundle.zip' }));
+ expect(onDownloadArtifact).toHaveBeenCalledWith('/bundle.zip', 'bundle.zip');
+
+ const downloadingLink = screen.getByRole('link', { name: 'Downloading bundle.zip' });
+ expect(downloadingLink).toHaveAttribute('aria-busy', 'true');
+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();
+ fireEvent.click(downloadingLink);
+ expect(onDownloadArtifact).toHaveBeenCalledOnce();
+
+ if (resolveDownload === undefined) {
+ throw new Error('Expected the download resolver to be assigned');
+ }
+ const completeDownload = resolveDownload;
+ await act(async () => {
+ completeDownload();
+ await downloadPromise;
+ });
+
+ expect(screen.getByRole('link', { name: 'Download bundle.zip' })).not.toHaveAttribute('aria-busy');
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();
+ });
+
+ it('renders read-only filenames without interactive download controls', () => {
+ render(
+ <ChatFileDownload
+ readOnly
+ files={[
+ { name: 'one.txt', path: '/one.txt' },
+ { name: 'two.txt', path: '/two.txt' },
+ ]}
+ fileDownloadBaseUrl="/downloads"
+ onDownloadArtifact={vi.fn(async () => {})}
+ />,
+ );
+
+ expect(screen.getByText('one.txt')).toBeInTheDocument();
+ expect(screen.getByText('two.txt')).toBeInTheDocument();
+ expect(screen.queryAllByRole('link')).toHaveLength(0);
+ expect(screen.queryByLabelText(/Download /)).not.toBeInTheDocument();
+ });
+
+ it('marks files as unavailable when no download mechanism is configured', () => {
+ render(<ChatFileDownload files={[{ name: 'offline.txt', path: '/offline.txt' }]} />);
+
+ const unavailable = screen.getByLabelText('Download offline.txt');
+ expect(unavailable).not.toHaveAttribute('href');
+ expect(unavailable).toHaveClass('pointer-events-none', 'opacity-60');
+ expect(screen.queryByRole('link', { name: 'Download offline.txt' })).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsx
similarity index 80%
rename from packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsx
index 65191526d..3d08a4a48 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ClearChatButton.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/ClearChatButton.test.tsx
@@ -2,17 +2,17 @@
import { fireEvent, render, screen } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import { ServerProvider } from '../server/ServerContext.js';
-import { ShellModeProvider } from '../server/ShellModeContext.js';
-import type { AgentUIServer } from '../server/types.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { ClearChatButton } from './ClearChatButton.js';
-import { SelectAgentEmptyState } from './SelectAgentEmptyState.js';
+import { ClearChatButton } from '@/atoms/ClearChatButton.js';
+import { SelectAgentEmptyState } from '@/atoms/SelectAgentEmptyState.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider } from '@/server/ShellModeContext.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
-function mockServer(): AgentUIServer {
- return {
+function mockServer() {
+ return createMockAgentUIServer({
searchAgents: vi.fn(async () => [{ name: 'alpha' }]),
- } as unknown as AgentUIServer;
+ });
}
describe('ClearChatButton', () => {
diff --git a/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsx b/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsx
new file mode 100644
index 000000000..e9b8b4509
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/CodeEditor.test.tsx
@@ -0,0 +1,174 @@
+// @vitest-environment jsdom
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { CodeEditor } from '@/atoms/CodeEditor.js';
+
+vi.mock('@/atoms/MonacoEditorCore.js', () => ({
+ MonacoEditorCore: ({
+ value,
+ height,
+ options,
+ onChange,
+ onMount,
+ beforeMount,
+ }: {
+ value: string;
+ height?: string | number;
+ options?: Record<string, unknown>;
+ onChange?: (value: string) => void;
+ onMount?: (editor: unknown, monaco: unknown) => void;
+ beforeMount?: (monaco: unknown) => void;
+ }) => (
+ <div
+ data-testid="monaco-editor"
+ data-value={value}
+ data-height={String(height)}
+ data-line-numbers={String(options?.lineNumbers)}
+ >
+ <button type="button" onClick={() => onChange?.('edited')}>
+ Edit
+ </button>
+ <button type="button" onClick={() => beforeMount?.('monaco-api')}>
+ Before mount
+ </button>
+ <button type="button" onClick={() => onMount?.('editor-api', 'monaco-api')}>
+ Mount
+ </button>
+ </div>
+ ),
+}));
+
+const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
+const createObjectURLDescriptor = Object.getOwnPropertyDescriptor(URL, 'createObjectURL');
+const revokeObjectURLDescriptor = Object.getOwnPropertyDescriptor(URL, 'revokeObjectURL');
+
+describe('CodeEditor', () => {
+ const writeText = vi.fn(() => Promise.resolve());
+ const createObjectURL = vi.fn(() => 'blob:test-download');
+ const revokeObjectURL = vi.fn();
+
+ beforeEach(() => {
+ vi.clearAllMocks();
+ Object.defineProperty(navigator, 'clipboard', {
+ configurable: true,
+ value: { writeText },
+ });
+ Object.defineProperty(URL, 'createObjectURL', {
+ configurable: true,
+ value: createObjectURL,
+ });
+ Object.defineProperty(URL, 'revokeObjectURL', {
+ configurable: true,
+ value: revokeObjectURL,
+ });
+ });
+
+ afterEach(() => {
+ vi.useRealTimers();
+ if (clipboardDescriptor === undefined) {
+ Reflect.deleteProperty(navigator, 'clipboard');
+ } else {
+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);
+ }
+ if (createObjectURLDescriptor === undefined) {
+ Reflect.deleteProperty(URL, 'createObjectURL');
+ } else {
+ Object.defineProperty(URL, 'createObjectURL', createObjectURLDescriptor);
+ }
+ if (revokeObjectURLDescriptor === undefined) {
+ Reflect.deleteProperty(URL, 'revokeObjectURL');
+ } else {
+ Object.defineProperty(URL, 'revokeObjectURL', revokeObjectURLDescriptor);
+ }
+ vi.restoreAllMocks();
+ });
+
+ it('renders the toolbar, toggles line numbers, and forwards editor changes', () => {
+ const onChange = vi.fn();
+ const beforeMount = vi.fn();
+ const onMount = vi.fn();
+ render(
+ <CodeEditor
+ value="const answer = 42;"
+ filename="answer.ts"
+ language="typescript"
+ onChange={onChange}
+ beforeMount={beforeMount}
+ onMount={onMount}
+ />,
+ );
+
+ expect(screen.getByText('answer.ts')).toBeInTheDocument();
+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-line-numbers', 'off');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Show line numbers' }));
+ expect(screen.getByRole('button', { name: 'Hide line numbers' })).toBeInTheDocument();
+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-line-numbers', 'on');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Edit' }));
+ expect(onChange).toHaveBeenCalledWith('edited');
+ fireEvent.click(screen.getByRole('button', { name: 'Before mount' }));
+ expect(beforeMount).toHaveBeenCalledWith('monaco-api');
+ fireEvent.click(screen.getByRole('button', { name: 'Mount' }));
+ expect(onMount).toHaveBeenCalledWith('editor-api', 'monaco-api');
+ });
+
+ it('copies the current value and reports the copied state', async () => {
+ vi.useFakeTimers();
+ render(<CodeEditor value="copy me" />);
+
+ await act(async () => {
+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));
+ await Promise.resolve();
+ });
+
+ expect(writeText).toHaveBeenCalledWith('copy me');
+ expect(screen.getByRole('button', { name: 'Copied!' })).toBeInTheDocument();
+
+ act(() => {
+ vi.advanceTimersByTime(2000);
+ });
+ expect(screen.getByRole('button', { name: 'Copy' })).toBeInTheDocument();
+ });
+
+ it('expands and collapses the editor while keeping Monaco fill-height', () => {
+ const { container } = render(<CodeEditor value="code" height={240} />);
+ const root = container.querySelector('.aui-code-editor');
+
+ expect(root).not.toHaveClass('fixed');
+ expect(screen.getByTestId('monaco-editor')).toHaveAttribute('data-height', '100%');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand' }));
+ expect(root).toHaveClass('fixed');
+ expect(screen.getByRole('button', { name: 'Collapse' })).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Collapse' }));
+ expect(root).not.toHaveClass('fixed');
+ });
+
+ it('downloads the current value using the filename', () => {
+ let clickedDownload: string | undefined;
+ let clickedHref: string | undefined;
+ vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(function click(this: HTMLAnchorElement) {
+ clickedDownload = this.download;
+ clickedHref = this.href;
+ });
+ render(<CodeEditor value="download me" filename="result.ts" language="typescript" />);
+
+ fireEvent.click(screen.getByRole('button', { name: 'Download' }));
+
+ expect(createObjectURL).toHaveBeenCalledWith(expect.any(Blob));
+ expect(clickedDownload).toBe('result.ts');
+ expect(clickedHref).toBe('blob:test-download');
+ expect(revokeObjectURL).toHaveBeenCalledWith('blob:test-download');
+ });
+
+ it('hides all toolbar actions when requested', () => {
+ render(<CodeEditor value="code" filename="hidden.ts" showToolbar={false} />);
+
+ expect(screen.queryByText('hidden.ts')).not.toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Copy' })).not.toBeInTheDocument();
+ expect(screen.getByTestId('monaco-editor')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsx
new file mode 100644
index 000000000..275582750
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ComposerSections.test.tsx
@@ -0,0 +1,72 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ComposerLeftSection, ComposerRightSection, ComposerSendButton } from '@/atoms/ComposerSections.js';
+
+describe('ComposerLeftSection', () => {
+ it('renders an accessible attachment action when a handler is provided', () => {
+ const onAttach = vi.fn();
+ render(<ComposerLeftSection disabled={false} isRunning={false} onAttach={onAttach} />);
+
+ const button = screen.getByRole('button', { name: 'Attach' });
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveAttribute('title', 'Attach');
+ fireEvent.click(button);
+ expect(onAttach).toHaveBeenCalledOnce();
+ });
+
+ it('renders nothing when attachment handling is unavailable', () => {
+ const { container } = render(<ComposerLeftSection disabled isRunning />);
+ expect(container).toBeEmptyDOMElement();
+ });
+});
+
+describe('ComposerRightSection', () => {
+ it('reserves no default UI in either idle or running state', () => {
+ const { container, rerender } = render(<ComposerRightSection disabled={false} isRunning={false} />);
+ expect(container).toBeEmptyDOMElement();
+
+ rerender(<ComposerRightSection disabled isRunning />);
+ expect(container).toBeEmptyDOMElement();
+ });
+});
+
+describe('ComposerSendButton', () => {
+ it('disables submission until the composer can submit', () => {
+ const onSubmit = vi.fn();
+ const { rerender } = render(
+ <ComposerSendButton disabled={false} canSubmit={false} isRunning={false} onSubmit={onSubmit} />,
+ );
+
+ const unavailableButton = screen.getByRole('button', { name: 'Send message' });
+ expect(unavailableButton).toBeDisabled();
+ fireEvent.click(unavailableButton);
+ expect(onSubmit).not.toHaveBeenCalled();
+
+ rerender(<ComposerSendButton disabled={false} canSubmit isRunning={false} onSubmit={onSubmit} />);
+ const availableButton = screen.getByRole('button', { name: 'Send message' });
+ expect(availableButton).toBeEnabled();
+ expect(availableButton).toHaveAttribute('title', 'Send message');
+ fireEvent.click(availableButton);
+ expect(onSubmit).toHaveBeenCalledOnce();
+ });
+
+ it('switches to a cancel action while running', () => {
+ const onSubmit = vi.fn();
+ const onCancel = vi.fn();
+ render(<ComposerSendButton disabled={false} canSubmit isRunning onSubmit={onSubmit} onCancel={onCancel} />);
+
+ const cancelButton = screen.getByRole('button', { name: 'Cancel' });
+ expect(cancelButton).toHaveTextContent('Cancel');
+ expect(screen.queryByRole('button', { name: 'Send message' })).not.toBeInTheDocument();
+ fireEvent.click(cancelButton);
+ expect(onCancel).toHaveBeenCalledOnce();
+ expect(onSubmit).not.toHaveBeenCalled();
+ });
+
+ it('disables cancellation when no cancel handler is supplied', () => {
+ render(<ComposerSendButton disabled={false} canSubmit isRunning onSubmit={() => {}} />);
+
+ expect(screen.getByRole('button', { name: 'Cancel' })).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsx
new file mode 100644
index 000000000..25ba7ca9a
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ComposerShell.test.tsx
@@ -0,0 +1,70 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ComposerShell } from '@/atoms/ComposerShell.js';
+
+describe('ComposerShell', () => {
+ it('composes input, attachments, metadata, and idle actions', () => {
+ const onAttach = vi.fn();
+ const onSubmit = vi.fn();
+ const { container } = render(
+ <ComposerShell
+ input={<textarea aria-label="Message" defaultValue="Hello" />}
+ attachments={<div>design.png</div>}
+ disabled={false}
+ canSubmit
+ modelLabel="GPT 5"
+ modelIcon={<span aria-label="Model icon">M</span>}
+ connectorStatusLabel="Connected"
+ onAttach={onAttach}
+ onSubmit={onSubmit}
+ className="consumer-class"
+ />,
+ );
+
+ const shell = container.querySelector('[data-slot="aui_composer-shell"]');
+ expect(shell).toHaveClass('consumer-class');
+ expect(screen.getByRole('textbox', { name: 'Message' })).toHaveValue('Hello');
+ expect(screen.getByText('design.png')).toBeInTheDocument();
+ expect(screen.getByText('Connected')).toBeInTheDocument();
+ expect(screen.getByText('GPT 5')).toBeInTheDocument();
+ expect(screen.getByLabelText('Model icon')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Attach' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Send message' }));
+ expect(onAttach).toHaveBeenCalledOnce();
+ expect(onSubmit).toHaveBeenCalledOnce();
+ });
+
+ it('shows the running cancel action and delegates cancellation', () => {
+ const onSubmit = vi.fn();
+ const onCancel = vi.fn();
+ render(
+ <ComposerShell
+ input={<textarea aria-label="Message" />}
+ disabled
+ canSubmit={false}
+ isRunning
+ onSubmit={onSubmit}
+ onCancel={onCancel}
+ />,
+ );
+
+ expect(screen.queryByRole('button', { name: 'Send message' })).not.toBeInTheDocument();
+ const cancelButton = screen.getByRole('button', { name: 'Cancel' });
+ expect(cancelButton).toBeEnabled();
+ fireEvent.click(cancelButton);
+ expect(onCancel).toHaveBeenCalledOnce();
+ expect(onSubmit).not.toHaveBeenCalled();
+ });
+
+ it('omits optional composer chrome when labels and attachment handling are absent', () => {
+ render(
+ <ComposerShell input={<input aria-label="Message" />} disabled={false} canSubmit={false} onSubmit={() => {}} />,
+ );
+
+ expect(screen.queryByRole('button', { name: 'Attach' })).not.toBeInTheDocument();
+ expect(screen.queryByText('Connected')).not.toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Send message' })).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsx b/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsx
new file mode 100644
index 000000000..6876ed102
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/HistoryLoader.test.tsx
@@ -0,0 +1,26 @@
+import { render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it } from 'vitest';
+
+import { HistoryLoader } from '@/atoms/HistoryLoader.js';
+
+describe('HistoryLoader', () => {
+ it('describes the idle sentinel without showing a spinner', () => {
+ const ref = createRef<HTMLDivElement>();
+ render(<HistoryLoader ref={ref} className="host-loader" data-testid="history-loader" />);
+
+ const loader = screen.getByRole('status', { name: 'Scroll up to load older messages' });
+ expect(loader).toBe(ref.current);
+ expect(loader).toHaveAttribute('aria-live', 'polite');
+ expect(loader).toHaveAttribute('data-slot', 'aui_history-loader');
+ expect(loader).toHaveClass('host-loader');
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();
+ });
+
+ it('announces loading and displays a spinner', () => {
+ render(<HistoryLoader isLoading />);
+
+ expect(screen.getByRole('status', { name: 'Loading older messages' })).toBeInTheDocument();
+ expect(screen.getByRole('status', { name: 'Loading' })).toHaveAttribute('width', '14');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsx
similarity index 96%
rename from packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsx
index 9dc2e2b1d..da7540c73 100644
--- a/packages/trueforge-ui-sdk/src/atoms/Markdown.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/Markdown.test.tsx
@@ -2,7 +2,7 @@
import { render, screen, waitFor } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
-import { Markdown } from './Markdown.js';
+import { Markdown } from '@/atoms/Markdown.js';
// @openuidev mocks are in testSetup.ts; they make OpenUiFenceBlock render
// a simple div with data-testid="aui-openui-renderer" synchronously.
diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsx
new file mode 100644
index 000000000..100163270
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/MessageActionBar.test.tsx
@@ -0,0 +1,24 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { MessageActionBar } from '@/atoms/MessageActionBar.js';
+
+describe('MessageActionBar', () => {
+ it('invokes copy and switches from copy to confirmation state', () => {
+ const onCopy = vi.fn();
+ const { rerender } = render(
+ <MessageActionBar isCopied={false} onCopy={onCopy} createdAt="2026-04-05T14:03:02.000Z" className="host-bar" />,
+ );
+
+ const copyButton = screen.getByRole('button', { name: 'Copy' });
+ expect(copyButton).toHaveAttribute('title', 'Copy');
+ expect(copyButton.querySelector('svg')).toHaveClass('lucide-copy');
+ expect(copyButton.parentElement).toHaveClass('aui-assistant-action-bar-root', 'host-bar');
+
+ fireEvent.click(copyButton);
+ expect(onCopy).toHaveBeenCalledOnce();
+
+ rerender(<MessageActionBar isCopied onCopy={onCopy} />);
+ expect(screen.getByRole('button', { name: 'Copy' }).querySelector('svg')).toHaveClass('lucide-check');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsx
new file mode 100644
index 000000000..03fad057f
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/MessageErrorBanner.test.tsx
@@ -0,0 +1,15 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { MessageErrorBanner } from '@/atoms/MessageErrorBanner.js';
+
+describe('MessageErrorBanner', () => {
+ it('announces the supplied error and preserves host styling', () => {
+ render(<MessageErrorBanner message="The response could not be generated" className="host-error" />);
+
+ const alert = screen.getByRole('alert');
+ expect(alert).toHaveTextContent('The response could not be generated');
+ expect(alert).toHaveClass('aui-message-error-root', 'host-error');
+ expect(alert.firstElementChild).toHaveClass('aui-message-error-message', 'line-clamp-2');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsx
new file mode 100644
index 000000000..2ae551cfd
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/MessageIndicator.test.tsx
@@ -0,0 +1,15 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { MessageIndicator } from '@/atoms/MessageIndicator.js';
+
+describe('MessageIndicator', () => {
+ it('provides an accessible working state and preserves host styling', () => {
+ render(<MessageIndicator className="host-indicator" />);
+
+ const indicator = screen.getByLabelText('Assistant is working');
+ expect(indicator).toHaveTextContent('●');
+ expect(indicator).toHaveAttribute('data-slot', 'aui_assistant-message-indicator');
+ expect(indicator).toHaveClass('animate-pulse', 'host-indicator');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsx
new file mode 100644
index 000000000..e54d5af12
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/MessageTimestamp.test.tsx
@@ -0,0 +1,56 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { MessageTimestamp } from '@/atoms/MessageTimestamp.js';
+
+const createdAt = new Date('2026-04-05T14:03:02.000Z');
+
+function expectedTime(date: Date): string {
+ return new Intl.DateTimeFormat(undefined, {
+ hour: '2-digit',
+ minute: '2-digit',
+ second: '2-digit',
+ hour12: true,
+ }).format(date);
+}
+
+function expectedFullDate(date: Date): string {
+ return new Intl.DateTimeFormat(undefined, {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ hour: 'numeric',
+ minute: '2-digit',
+ hour12: true,
+ }).format(date);
+}
+
+describe('MessageTimestamp', () => {
+ it('renders Date and ISO string values using the local time format', () => {
+ const { rerender } = render(<MessageTimestamp createdAt={createdAt} className="host-timestamp" />);
+
+ expect(screen.getByText(expectedTime(createdAt))).toHaveClass('host-timestamp');
+
+ rerender(<MessageTimestamp createdAt={createdAt.toISOString()} />);
+ expect(screen.getByText(expectedTime(createdAt))).toBeInTheDocument();
+ });
+
+ it('shows the full date in a tooltip on focus', () => {
+ render(<MessageTimestamp createdAt={createdAt} />);
+ const timestamp = screen.getByText(expectedTime(createdAt));
+
+ fireEvent.focus(timestamp);
+
+ expect(screen.getByRole('tooltip')).toHaveTextContent(expectedFullDate(createdAt));
+ fireEvent.blur(timestamp);
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
+
+ it('renders nothing for missing or invalid dates', () => {
+ const { container, rerender } = render(<MessageTimestamp />);
+ expect(container).toBeEmptyDOMElement();
+
+ rerender(<MessageTimestamp createdAt="not-a-date" />);
+ expect(container).toBeEmptyDOMElement();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsx b/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsx
new file mode 100644
index 000000000..5bb9a4bc3
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/MonacoEditorCore.test.tsx
@@ -0,0 +1,130 @@
+// @vitest-environment jsdom
+import { act, render, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { MonacoEditorCore } from '@/atoms/MonacoEditorCore.js';
+
+const monacoMocks = vi.hoisted(() => {
+ let changeListener: (() => void) | undefined;
+ let sizeListener: (() => void) | undefined;
+
+ const changeDisposable = { dispose: vi.fn() };
+ const sizeDisposable = { dispose: vi.fn() };
+ const editor = {
+ getValue: vi.fn(() => 'initial value'),
+ setValue: vi.fn(),
+ getContentHeight: vi.fn(() => 72),
+ onDidChangeModelContent: vi.fn((listener: () => void) => {
+ changeListener = listener;
+ return changeDisposable;
+ }),
+ onDidContentSizeChange: vi.fn((listener: () => void) => {
+ sizeListener = listener;
+ return sizeDisposable;
+ }),
+ updateOptions: vi.fn(),
+ dispose: vi.fn(),
+ layout: vi.fn(),
+ };
+ const editorApi = {
+ create: vi.fn(() => editor),
+ defineTheme: vi.fn(),
+ setTheme: vi.fn(),
+ };
+
+ return {
+ module: { editor: editorApi },
+ editor,
+ editorApi,
+ changeDisposable,
+ sizeDisposable,
+ invokeChange: () => changeListener?.(),
+ invokeSizeChange: () => sizeListener?.(),
+ };
+});
+
+vi.mock('monaco-editor', () => monacoMocks.module);
+
+describe('MonacoEditorCore', () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ monacoMocks.editor.getValue.mockReturnValue('initial value');
+ monacoMocks.editor.getContentHeight.mockReturnValue(72);
+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {
+ callback(0);
+ return 1;
+ });
+ });
+
+ afterEach(() => vi.unstubAllGlobals());
+
+ it('creates Monaco with consumer options and forwards lifecycle and change callbacks', async () => {
+ const beforeMount = vi.fn();
+ const onMount = vi.fn();
+ const onChange = vi.fn();
+ const { unmount } = render(
+ <MonacoEditorCore
+ value="initial value"
+ language="typescript"
+ theme="custom-theme"
+ options={{ readOnly: true, lineNumbers: 'off' }}
+ beforeMount={beforeMount}
+ onMount={onMount}
+ onChange={onChange}
+ />,
+ );
+
+ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());
+ expect(monacoMocks.editorApi.defineTheme).toHaveBeenCalledTimes(2);
+ expect(beforeMount).toHaveBeenCalledWith(monacoMocks.module);
+ expect(monacoMocks.editorApi.create).toHaveBeenCalledWith(
+ expect.any(HTMLElement),
+ expect.objectContaining({
+ value: 'initial value',
+ language: 'typescript',
+ theme: 'custom-theme',
+ readOnly: true,
+ lineNumbers: 'off',
+ }),
+ );
+ expect(onMount).toHaveBeenCalledWith(monacoMocks.editor, monacoMocks.module);
+
+ monacoMocks.editor.getValue.mockReturnValue('edited value');
+ act(() => monacoMocks.invokeChange());
+ expect(onChange).toHaveBeenCalledWith('edited value');
+
+ unmount();
+ expect(monacoMocks.changeDisposable.dispose).toHaveBeenCalledOnce();
+ expect(monacoMocks.editor.dispose).toHaveBeenCalledOnce();
+ });
+
+ it('syncs external values without recreating the editor', async () => {
+ const { rerender } = render(<MonacoEditorCore value="first" />);
+ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());
+
+ monacoMocks.editor.getValue.mockReturnValue('first');
+ rerender(<MonacoEditorCore value="second" />);
+
+ await waitFor(() => expect(monacoMocks.editor.setValue).toHaveBeenCalledWith('second'));
+ expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce();
+ });
+
+ it('clamps auto-height and responds to Monaco content-size changes', async () => {
+ monacoMocks.editor.getContentHeight.mockReturnValue(500);
+ const { container, unmount } = render(
+ <MonacoEditorCore value={'one\ntwo'} autoHeight minHeight={30} maxHeight={100} />,
+ );
+
+ await waitFor(() => expect(monacoMocks.editorApi.create).toHaveBeenCalledOnce());
+ const editorContainer = container.querySelector('.aui-monaco');
+ expect(editorContainer).toHaveStyle({ height: '100px' });
+ expect(monacoMocks.editor.layout).toHaveBeenCalled();
+
+ monacoMocks.editor.getContentHeight.mockReturnValue(10);
+ act(() => monacoMocks.invokeSizeChange());
+ expect(editorContainer).toHaveStyle({ height: '30px' });
+
+ unmount();
+ expect(monacoMocks.sizeDisposable.dispose).toHaveBeenCalledOnce();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsx b/packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsx
similarity index 90%
rename from packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsx
index fc313cc7a..5f0bbbadb 100644
--- a/packages/trueforge-ui-sdk/src/atoms/NamedAgentHeaderLabel.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/NamedAgentHeaderLabel.test.tsx
@@ -2,8 +2,8 @@
import { act, render, screen } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';
-import { NamedAgentHeaderLabel } from './NamedAgentHeaderLabel.js';
+import { NamedAgentHeaderLabel } from '@/atoms/NamedAgentHeaderLabel.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
function SelectNamed() {
const shell = useShellMode();
diff --git a/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsx b/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsx
new file mode 100644
index 000000000..fd6589ab1
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/OpenUiFenceBlock.test.tsx
@@ -0,0 +1,53 @@
+// @vitest-environment jsdom
+import { render, screen } from '@testing-library/react';
+import type { ReactNode } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { OpenUiFenceBlock } from '@/atoms/OpenUiFenceBlock.js';
+
+const openUiMocks = vi.hoisted(() => ({
+ library: { name: 'test-openui-library' },
+ renderer: vi.fn(),
+}));
+
+vi.mock('@openuidev/react-lang', () => ({
+ Renderer: ({ response, library, isStreaming }: { response: string; library: unknown; isStreaming?: boolean }) => {
+ openUiMocks.renderer({ response, library, isStreaming });
+ return (
+ <div data-testid="openui-renderer" data-streaming={String(Boolean(isStreaming))}>
+ {response}
+ </div>
+ );
+ },
+}));
+
+vi.mock('@openuidev/react-ui', () => ({
+ ThemeProvider: ({ mode, children }: { mode: string; children: ReactNode }) => (
+ <div data-testid="openui-theme" data-mode={mode}>
+ {children}
+ </div>
+ ),
+ openuiLibrary: openUiMocks.library,
+}));
+
+describe('OpenUiFenceBlock', () => {
+ it('passes content, streaming state, and the OpenUI library to the renderer', () => {
+ render(<OpenUiFenceBlock content='{"type":"Text","text":"Working"}' isStreaming />);
+
+ expect(screen.getByTestId('openui-renderer')).toHaveTextContent('{"type":"Text","text":"Working"}');
+ expect(screen.getByTestId('openui-renderer')).toHaveAttribute('data-streaming', 'true');
+ expect(openUiMocks.renderer).toHaveBeenCalledWith({
+ response: '{"type":"Text","text":"Working"}',
+ library: openUiMocks.library,
+ isStreaming: true,
+ });
+ });
+
+ it('selects light and dark OpenUI themes from the public prop', () => {
+ const { rerender } = render(<OpenUiFenceBlock content="content" />);
+ expect(screen.getByTestId('openui-theme')).toHaveAttribute('data-mode', 'light');
+
+ rerender(<OpenUiFenceBlock content="content" darkTheme />);
+ expect(screen.getByTestId('openui-theme')).toHaveAttribute('data-mode', 'dark');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsx
similarity index 93%
rename from packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsx
index 48a20e49f..fe7fa8b78 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/SandboxArtifactDownload.test.tsx
@@ -2,10 +2,10 @@
import { act, render, screen } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { ThemeProvider } from '../theme/ThemeProvider.js';
-import { Markdown } from './Markdown.js';
-import { parseSandboxArtifacts, SandboxArtifactDownload } from './SandboxArtifactDownload.js';
+import { Markdown } from '@/atoms/Markdown.js';
+import { parseSandboxArtifacts, SandboxArtifactDownload } from '@/atoms/SandboxArtifactDownload.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { ThemeProvider } from '@/theme/ThemeProvider.js';
describe('parseSandboxArtifacts', () => {
it('parses tfy markdown-link pairs', () => {
diff --git a/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsx
new file mode 100644
index 000000000..19ad90c27
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/SandboxToolCallCard.test.tsx
@@ -0,0 +1,110 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { SandboxToolCallCard } from '@/atoms/SandboxToolCallCard.js';
+
+vi.mock('@/atoms/MonacoEditorCore.js', () => ({
+ MonacoEditorCore: ({ value, options }: { value: string; options?: Record<string, unknown> }) => (
+ <div data-testid="sandbox-json" data-read-only={String(options?.readOnly)}>
+ {value}
+ </div>
+ ),
+}));
+
+describe('SandboxToolCallCard', () => {
+ it('uses intent as the title, reports running duration, and toggles expansion', () => {
+ const onToggle = vi.fn();
+ render(
+ <SandboxToolCallCard
+ name="run_command"
+ intent="Install dependencies"
+ status="running"
+ expanded={false}
+ onToggle={onToggle}
+ durationText="3s"
+ hasContent
+ command="pnpm install"
+ />,
+ );
+
+ expect(screen.getByText('Install dependencies')).toBeInTheDocument();
+ expect(screen.getByText('3s')).toBeInTheDocument();
+ expect(screen.queryByText('pnpm install')).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+
+ it('renders terminal output, exit status, and controlled view-mode callbacks', () => {
+ const onViewModeChange = vi.fn();
+ render(
+ <SandboxToolCallCard
+ name="run_command"
+ status="success"
+ expanded
+ onToggle={() => {}}
+ command="echo hello"
+ resultText="hello"
+ exitCode={0}
+ hasContent
+ viewMode="terminal"
+ onViewModeChange={onViewModeChange}
+ dataTestPrefix="sandbox"
+ />,
+ );
+
+ expect(screen.getByText('echo hello')).toBeInTheDocument();
+ expect(screen.getByText('hello')).toBeInTheDocument();
+ expect(screen.getByTestId('sandbox-exit-code')).toHaveTextContent('exit: 0');
+ expect(screen.getByRole('button', { name: 'Terminal View' })).toHaveAttribute('aria-pressed', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Code View' }));
+ expect(onViewModeChange).toHaveBeenCalledWith('code');
+ });
+
+ it('renders read-only argument and result JSON in code view', () => {
+ const { container } = render(
+ <SandboxToolCallCard
+ name="run_command"
+ status="error"
+ expanded
+ onToggle={() => {}}
+ argsJson='{"command":"false"}'
+ resultJson='{"error":"failed"}'
+ exitCode={1}
+ hasContent
+ viewMode="code"
+ dataTestPrefix="sandbox"
+ />,
+ );
+
+ expect(screen.getByText('Arguments')).toBeInTheDocument();
+ expect(screen.getByText('Result')).toBeInTheDocument();
+ expect(screen.getAllByTestId('sandbox-json')).toHaveLength(2);
+ for (const editor of screen.getAllByTestId('sandbox-json')) {
+ expect(editor).toHaveAttribute('data-read-only', 'true');
+ }
+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();
+ expect(screen.getByTestId('sandbox-exit-code')).toHaveTextContent('exit: 1');
+ });
+
+ it('keeps the sandbox body empty when hasContent is false', () => {
+ render(
+ <SandboxToolCallCard
+ name="run_command"
+ status="success"
+ expanded
+ onToggle={() => {}}
+ command="hidden command"
+ resultText="hidden result"
+ hasContent={false}
+ dataTestPrefix="sandbox"
+ />,
+ );
+
+ expect(screen.getByTestId('sandbox-sandbox')).toBeInTheDocument();
+ expect(screen.queryByText('hidden command')).not.toBeInTheDocument();
+ expect(screen.queryByText('hidden result')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
similarity index 90%
rename from packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
index 626cea202..79a6d14e0 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/SaveAgentButton.test.tsx
@@ -3,11 +3,11 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { useEffect, useRef } from 'react';
import { beforeAll, describe, expect, it, vi } from 'vitest';
-import { ServerProvider } from '../server/ServerContext.js';
-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';
-import type { AgentUIServer } from '../server/types.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { SaveAgentButton } from './SaveAgentButton.js';
+import { SaveAgentButton } from '@/atoms/SaveAgentButton.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
vi.mock('@truefoundry/assistant-ui-runtime', () => ({
useTrueFoundryAgentSpec: () => ({
@@ -28,8 +28,16 @@ beforeAll(() => {
};
});
-function mockServer(saveAgent = vi.fn(async () => ({ ok: true }))): AgentUIServer {
- return { saveAgent } as unknown as AgentUIServer;
+function mockServer(saveAgent = vi.fn(async () => ({ ok: true }))) {
+ return createMockAgentUIServer({ saveAgent });
+}
+
+function getSubmitButton(dialog: HTMLElement): HTMLButtonElement {
+ const button = dialog.querySelector<HTMLButtonElement>('button[type="submit"]');
+ if (button === null) {
+ throw new Error('Expected submit button');
+ }
+ return button;
}
describe('SaveAgentButton', () => {
@@ -73,7 +81,7 @@ describe('SaveAgentButton', () => {
fireEvent.change(screen.getByLabelText('System instructions'), {
target: { value: ' You write release notes. ' },
});
- fireEvent.click(dialog.querySelector('button[type="submit"]')!);
+ fireEvent.click(getSubmitButton(dialog));
await waitFor(() => {
expect(saveAgent).toHaveBeenCalledWith({
@@ -164,7 +172,7 @@ describe('SaveAgentButton', () => {
fireEvent.click(screen.getByRole('button', { name: 'Save as agent' }));
const dialog = screen.getByRole('dialog', { name: 'Save as agent' });
fireEvent.change(screen.getByLabelText('Name'), { target: { value: 'dup' } });
- fireEvent.click(dialog.querySelector('button[type="submit"]')!);
+ fireEvent.click(getSubmitButton(dialog));
await waitFor(() => {
expect(screen.getByText('Name taken')).toBeInTheDocument();
diff --git a/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsx
new file mode 100644
index 000000000..5907f50f2
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ScrollToBottomButton.test.tsx
@@ -0,0 +1,33 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ScrollToBottomButton } from '@/atoms/ScrollToBottomButton.js';
+
+describe('ScrollToBottomButton', () => {
+ it('forwards button props, invokes clicks, and exposes its positioning wrapper ref', () => {
+ const onClick = vi.fn();
+ const ref = createRef<HTMLSpanElement>();
+ render(<ScrollToBottomButton ref={ref} onClick={onClick} className="host-scroll-button" data-track="scroll" />);
+
+ const button = screen.getByRole('button', { name: 'Scroll to bottom' });
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveAttribute('title', 'Scroll to bottom');
+ expect(button).toHaveAttribute('data-track', 'scroll');
+ expect(button).toHaveClass('aui-thread-scroll-to-bottom', 'host-scroll-button');
+ expect(button.querySelector('svg')).toHaveClass('lucide-arrow-down');
+ expect(ref.current).toBe(button.parentElement);
+
+ fireEvent.click(button);
+ expect(onClick).toHaveBeenCalledOnce();
+ });
+
+ it('does not render while disabled', () => {
+ const onClick = vi.fn();
+ const { container } = render(<ScrollToBottomButton disabled onClick={onClick} />);
+
+ expect(container).toBeEmptyDOMElement();
+ expect(screen.queryByRole('button', { name: 'Scroll to bottom' })).not.toBeInTheDocument();
+ expect(onClick).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsx
new file mode 100644
index 000000000..5a6ea7751
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/Skeletons.test.tsx
@@ -0,0 +1,17 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { MessageListSkeleton } from '@/atoms/Skeletons.js';
+
+describe('MessageListSkeleton', () => {
+ it('announces conversation loading and renders message-shaped placeholders', () => {
+ const { container } = render(<MessageListSkeleton className="host-skeleton" />);
+
+ const status = screen.getByRole('status', { name: 'Loading conversation' });
+ expect(status).toHaveAttribute('data-slot', 'aui_thread-history-skeleton');
+ expect(status).toHaveClass('host-skeleton');
+ expect(container.querySelectorAll('.animate-pulse')).toHaveLength(4);
+ expect(container.querySelector('.justify-end .h-10')).toBeInTheDocument();
+ expect(container.querySelectorAll('.px-2 .h-4')).toHaveLength(3);
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsx
new file mode 100644
index 000000000..2788d79b1
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/SubAgentCard.test.tsx
@@ -0,0 +1,96 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import type { ComponentProps } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { Markdown } from '@/atoms/Markdown.js';
+import { SubAgentCard } from '@/atoms/SubAgentCard.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function MarkdownStub({ content }: ComponentProps<typeof Markdown>) {
+ return <div data-testid="instruction-markdown">{content}</div>;
+}
+
+function renderCard(props: ComponentProps<typeof SubAgentCard>) {
+ return render(
+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>
+ <SubAgentCard {...props} />
+ </SlotsProvider>,
+ );
+}
+
+describe('SubAgentCard', () => {
+ it('hides collapsed details and invokes the expansion callback', () => {
+ const onToggle = vi.fn();
+ renderCard({
+ agentName: 'Researcher',
+ instruction: 'Find primary sources',
+ stepCount: 2,
+ status: 'running',
+ expanded: false,
+ onToggle,
+ durationText: '12s',
+ children: <div>nested steps</div>,
+ dataTestPrefix: 'sub',
+ });
+
+ expect(screen.getByText('Sub-agent: Researcher')).toBeInTheDocument();
+ expect(screen.getByText('12s')).toBeInTheDocument();
+ expect(screen.queryByText('Find primary sources')).not.toBeInTheDocument();
+ expect(screen.queryByText('nested steps')).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+
+ it('renders instructions and nested content when expanded', () => {
+ renderCard({
+ agentName: 'Coder',
+ instruction: 'Implement the fix',
+ stepCount: 3,
+ status: 'success',
+ expanded: true,
+ onToggle: () => {},
+ children: <div>child tool call</div>,
+ dataTestPrefix: 'sub',
+ });
+
+ expect(screen.getByTestId('instruction-markdown')).toHaveTextContent('Implement the fix');
+ expect(screen.getByTestId('sub-instructions')).toBeInTheDocument();
+ expect(screen.getByTestId('sub-nested-content')).toHaveTextContent('child tool call');
+ expect(screen.getByTestId('sub-success-icon')).toBeInTheDocument();
+ });
+
+ it('uses a custom instruction renderer and maps error status', () => {
+ const renderInstruction = vi.fn((instruction: string) => <strong>Custom: {instruction}</strong>);
+ const { container } = renderCard({
+ agentName: 'Reviewer',
+ instruction: 'Review changes',
+ stepCount: 1,
+ status: 'error',
+ expanded: true,
+ onToggle: () => {},
+ renderInstruction,
+ dataTestPrefix: 'sub',
+ });
+
+ expect(renderInstruction).toHaveBeenCalledWith('Review changes');
+ expect(screen.getByText('Custom: Review changes')).toBeInTheDocument();
+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();
+ });
+
+ it('omits the instruction section for whitespace-only instructions', () => {
+ renderCard({
+ agentName: 'Idle',
+ instruction: ' ',
+ stepCount: 0,
+ status: 'success',
+ expanded: true,
+ onToggle: () => {},
+ dataTestPrefix: 'sub',
+ });
+
+ expect(screen.queryByText('Instructions')).not.toBeInTheDocument();
+ expect(screen.queryByTestId('sub-instructions')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsx
new file mode 100644
index 000000000..2a9801917
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/SyntaxHighlighter.test.tsx
@@ -0,0 +1,73 @@
+// @vitest-environment jsdom
+import { render, screen } from '@testing-library/react';
+import type { ComponentType, ReactNode } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { SyntaxHighlighter } from '@/atoms/SyntaxHighlighter.js';
+
+const syntaxMocks = vi.hoisted(() => ({
+ dark: { name: 'dark' },
+ light: { name: 'light' },
+}));
+
+vi.mock('react-syntax-highlighter/dist/esm/styles/prism', () => ({
+ oneDark: syntaxMocks.dark,
+ oneLight: syntaxMocks.light,
+}));
+
+vi.mock('react-syntax-highlighter', () => ({
+ Prism: ({
+ children,
+ language,
+ style,
+ showLineNumbers,
+ PreTag,
+ CodeTag,
+ }: {
+ children?: ReactNode;
+ language?: string;
+ style?: unknown;
+ showLineNumbers?: boolean;
+ PreTag?: ComponentType<{ children?: ReactNode; className?: string }>;
+ CodeTag?: ComponentType<{ children?: ReactNode; className?: string }>;
+ }) => (
+ <div
+ data-testid="syntax-engine"
+ data-language={language}
+ data-theme={style === syntaxMocks.dark ? 'dark' : 'light'}
+ data-line-numbers={String(Boolean(showLineNumbers))}
+ >
+ {PreTag ? (
+ <PreTag className="engine-pre">
+ {CodeTag ? <CodeTag className="engine-code">{children}</CodeTag> : children}
+ </PreTag>
+ ) : (
+ children
+ )}
+ </div>
+ ),
+}));
+
+describe('SyntaxHighlighter', () => {
+ it('passes code, language, and line-number behavior to the highlighting engine', () => {
+ render(<SyntaxHighlighter code={'const x = 1;\nconsole.log(x);'} language="typescript" showLineNumbers />);
+
+ const highlighter = screen.getByTestId('syntax-engine');
+ expect(highlighter).toHaveAttribute('data-language', 'typescript');
+ expect(highlighter).toHaveAttribute('data-line-numbers', 'true');
+ expect(highlighter).toHaveTextContent('const x = 1;');
+ expect(highlighter).toHaveTextContent('console.log(x);');
+ expect(highlighter.querySelector('pre')).toHaveClass('engine-pre', 'max-w-full', 'overflow-x-auto');
+ expect(highlighter.querySelector('code')).toHaveClass('engine-code');
+ });
+
+ it('switches the highlighting theme and preserves consumer classes', () => {
+ const { container, rerender } = render(<SyntaxHighlighter code="value" className="consumer-class" />);
+
+ expect(screen.getByTestId('syntax-engine')).toHaveAttribute('data-theme', 'light');
+ expect(container.querySelector('.aui-syntax-highlighter')).toHaveClass('consumer-class');
+
+ rerender(<SyntaxHighlighter code="value" darkTheme className="consumer-class" />);
+ expect(screen.getByTestId('syntax-engine')).toHaveAttribute('data-theme', 'dark');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsx
new file mode 100644
index 000000000..955a864e1
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadListMisc.test.tsx
@@ -0,0 +1,86 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import {
+ ThreadListEmptyState,
+ ThreadListNewButton,
+ ThreadListRowSkeleton,
+ ThreadListShell,
+} from '@/atoms/ThreadListMisc.js';
+
+describe('ThreadListNewButton', () => {
+ it('renders the default accessible action and forwards button behavior', () => {
+ const onClick = vi.fn();
+ render(<ThreadListNewButton onClick={onClick} className="consumer-class" />);
+
+ const button = screen.getByRole('button', { name: 'Start new chat' });
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveTextContent('New Chat');
+ expect(button).toHaveClass('consumer-class');
+ expect(button).toHaveStyle({ borderRadius: 'var(--thread-list-item-radius, 0.5rem)' });
+ fireEvent.click(button);
+ expect(onClick).toHaveBeenCalledOnce();
+ });
+
+ it('accepts custom content and native disabled state while preserving consumer styles', () => {
+ const onClick = vi.fn();
+ render(
+ <ThreadListNewButton disabled onClick={onClick} style={{ borderRadius: '2rem', color: 'red' }}>
+ Start over
+ </ThreadListNewButton>,
+ );
+
+ const button = screen.getByRole('button', { name: 'Start new chat' });
+ expect(button).toHaveTextContent('Start over');
+ expect(button).toHaveStyle({ borderRadius: '2rem', color: 'rgb(255, 0, 0)' });
+ expect(button).toBeDisabled();
+ fireEvent.click(button);
+ expect(onClick).not.toHaveBeenCalled();
+ });
+});
+
+describe('ThreadListRowSkeleton', () => {
+ it('announces loading and renders the requested number of skeleton rows', () => {
+ const { rerender } = render(<ThreadListRowSkeleton count={3} className="consumer-class" />);
+
+ const status = screen.getByRole('status', { name: 'Loading threads' });
+ expect(status).toHaveClass('consumer-class');
+ expect(status.querySelectorAll('.animate-pulse')).toHaveLength(3);
+
+ rerender(<ThreadListRowSkeleton count={1} />);
+ expect(screen.getByRole('status', { name: 'Loading threads' }).querySelectorAll('.animate-pulse')).toHaveLength(1);
+ });
+
+ it('uses five rows by default', () => {
+ render(<ThreadListRowSkeleton />);
+ expect(screen.getByRole('status', { name: 'Loading threads' }).querySelectorAll('.animate-pulse')).toHaveLength(5);
+ });
+});
+
+describe('ThreadListEmptyState', () => {
+ it('renders the default and custom empty messages', () => {
+ const { rerender } = render(<ThreadListEmptyState className="consumer-class" />);
+ expect(screen.getByText('No threads yet')).toHaveClass('consumer-class');
+
+ rerender(<ThreadListEmptyState message="No matching conversations" />);
+ expect(screen.getByText('No matching conversations')).toBeInTheDocument();
+ expect(screen.queryByText('No threads yet')).not.toBeInTheDocument();
+ });
+});
+
+describe('ThreadListShell', () => {
+ it('keeps header and history-owned overflow in separate regions', () => {
+ const { container } = render(
+ <ThreadListShell header={<button type="button">Create thread</button>} className="consumer-class">
+ <a href="/threads/one">Thread one</a>
+ </ThreadListShell>,
+ );
+
+ const root = container.firstElementChild;
+ expect(root).toHaveClass('consumer-class');
+ expect(root?.children).toHaveLength(2);
+ expect(root?.children[0]).toContainElement(screen.getByRole('button', { name: 'Create thread' }));
+ expect(root?.children[1]).toContainElement(screen.getByRole('link', { name: 'Thread one' }));
+ expect(root?.children[1]).toHaveClass('overflow-hidden');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsx
similarity index 95%
rename from packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsx
rename to packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsx
index 3b3f8cf9d..e490e5ae1 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ThreadListRow.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadListRow.test.tsx
@@ -2,9 +2,9 @@
import { fireEvent, render, screen } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { ThreadListRow } from './ThreadListRow.js';
-import { DropdownMenuItem } from './primitives/DropdownMenu.js';
+import { ThreadListRow } from '@/atoms/ThreadListRow.js';
+import { DropdownMenuItem } from '@/atoms/primitives/DropdownMenu.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
describe('ThreadListRow', () => {
it('hides actions when omitted', () => {
diff --git a/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsx
new file mode 100644
index 000000000..d5543ff2d
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ThreadShell.test.tsx
@@ -0,0 +1,83 @@
+import { render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it } from 'vitest';
+
+import { MessageGroup, ThreadComposerAreaShell, ThreadRootShell, ThreadViewportShell } from '@/atoms/ThreadShell.js';
+
+describe('ThreadRootShell', () => {
+ it('merges host styles over defaults and forwards its ref and attributes', () => {
+ const ref = createRef<HTMLDivElement>();
+ const hostStyle = Object.assign({ color: 'red' }, { '--thread-max-width': '60rem' });
+ render(<ThreadRootShell ref={ref} data-testid="thread-root" className="host-thread" style={hostStyle} />);
+
+ const root = screen.getByTestId('thread-root');
+ expect(root).toBe(ref.current);
+ expect(root).toHaveClass('aui-thread-root', 'host-thread');
+ expect(root.style.getPropertyValue('--thread-max-width')).toBe('60rem');
+ expect(root.style.getPropertyValue('--composer-bg')).toBe('var(--card)');
+ expect(root.style.color).toBe('red');
+ });
+});
+
+describe('ThreadViewportShell', () => {
+ it('centers empty content and restores message-list spacing when populated', () => {
+ const { rerender } = render(
+ <ThreadViewportShell isEmpty data-testid="viewport">
+ <p>Welcome</p>
+ </ThreadViewportShell>,
+ );
+
+ const viewport = screen.getByTestId('viewport');
+ expect(viewport).toHaveAttribute('data-slot', 'aui_thread-viewport');
+ expect(viewport.firstElementChild).toHaveClass('min-h-full', 'justify-center', 'pb-4');
+ expect(viewport).toHaveTextContent('Welcome');
+
+ rerender(
+ <ThreadViewportShell isEmpty={false} data-testid="viewport">
+ <p>Messages</p>
+ </ThreadViewportShell>,
+ );
+ expect(viewport.firstElementChild).toHaveClass('pb-32');
+ expect(viewport.firstElementChild).not.toHaveClass('justify-center');
+ });
+});
+
+describe('ThreadComposerAreaShell', () => {
+ it('applies populated-state rounding while forwarding content and attributes', () => {
+ const { rerender } = render(
+ <ThreadComposerAreaShell isEmpty data-testid="composer" className="host-composer">
+ Empty composer
+ </ThreadComposerAreaShell>,
+ );
+
+ const composer = screen.getByTestId('composer');
+ expect(composer).toHaveAttribute('data-slot', 'aui_thread-composer');
+ expect(composer).toHaveClass('host-composer');
+ expect(composer).not.toHaveClass('rounded-t-(--composer-radius)');
+
+ rerender(
+ <ThreadComposerAreaShell isEmpty={false} data-testid="composer">
+ Populated composer
+ </ThreadComposerAreaShell>,
+ );
+ expect(composer).toHaveClass('rounded-t-(--composer-radius)');
+ expect(composer).toHaveTextContent('Populated composer');
+ });
+});
+
+describe('MessageGroup', () => {
+ it('forwards its ref, children, and host attributes', () => {
+ const ref = createRef<HTMLDivElement>();
+ render(
+ <MessageGroup ref={ref} data-testid="message-group" className="host-group">
+ <article>Message one</article>
+ </MessageGroup>,
+ );
+
+ const group = screen.getByTestId('message-group');
+ expect(group).toBe(ref.current);
+ expect(group).toHaveAttribute('data-slot', 'aui_message-group');
+ expect(group).toHaveClass('empty:hidden', 'host-group');
+ expect(group).toContainElement(screen.getByText('Message one'));
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsx b/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsx
new file mode 100644
index 000000000..79edcb42d
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/Toast.test.tsx
@@ -0,0 +1,91 @@
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { Toast, ToastStack } from '@/atoms/Toast.js';
+
+vi.mock('@/icons/Icon.js', () => ({
+ Icon: ({ name }: { name: string }) => <span data-testid={`icon-${name}`} />,
+}));
+
+const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
+
+describe('Toast', () => {
+ afterEach(() => {
+ vi.useRealTimers();
+ if (clipboardDescriptor === undefined) {
+ Reflect.deleteProperty(navigator, 'clipboard');
+ } else {
+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);
+ }
+ });
+
+ it('renders alert content while open and delegates dismissal', () => {
+ const onOpenChange = vi.fn();
+ render(
+ <Toast
+ title="Request failed"
+ description={'First detail\nSecond detail'}
+ open
+ onOpenChange={onOpenChange}
+ className="consumer-class"
+ />,
+ );
+
+ const alert = screen.getByRole('alert');
+ expect(alert).toHaveClass('consumer-class');
+ expect(alert).toHaveTextContent('Request failed');
+ expect(alert).toHaveTextContent('First detail Second detail');
+
+ const closeButton = screen.getByRole('button', { name: 'Close' });
+ expect(closeButton).toHaveAttribute('title', 'Close');
+ fireEvent.click(closeButton);
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('renders nothing when closed', () => {
+ render(<Toast title="Hidden" description="Not visible" open={false} onOpenChange={() => {}} />);
+ expect(screen.queryByRole('alert')).not.toBeInTheDocument();
+ expect(screen.queryByText('Hidden')).not.toBeInTheDocument();
+ });
+
+ it('copies the full error and temporarily exposes copied state', async () => {
+ vi.useFakeTimers();
+ const writeText = vi.fn(async () => {});
+ Object.defineProperty(navigator, 'clipboard', {
+ configurable: true,
+ value: { writeText },
+ });
+ render(<Toast title="Copy title" description="Copy body" open onOpenChange={() => {}} />);
+
+ expect(screen.getByTestId('icon-clone')).toBeInTheDocument();
+ await act(async () => {
+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));
+ await Promise.resolve();
+ });
+
+ expect(writeText).toHaveBeenCalledWith('Copy title\nCopy body');
+ expect(screen.getByTestId('icon-check')).toBeInTheDocument();
+
+ act(() => {
+ vi.advanceTimersByTime(1500);
+ });
+ expect(screen.getByTestId('icon-clone')).toBeInTheDocument();
+ });
+});
+
+describe('ToastStack', () => {
+ it('renders all children in the fixed non-interactive stack', () => {
+ const { container } = render(
+ <ToastStack>
+ <div>Older toast</div>
+ <div>Newer toast</div>
+ </ToastStack>,
+ );
+
+ const stack = container.firstElementChild;
+ expect(stack).toHaveClass('pointer-events-none', 'fixed', 'flex-col-reverse');
+ expect(stack?.children).toHaveLength(2);
+ expect(stack?.children[0]).toHaveTextContent('Older toast');
+ expect(stack?.children[1]).toHaveTextContent('Newer toast');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsx
new file mode 100644
index 000000000..1884c5c38
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ToolApprovalBar.test.tsx
@@ -0,0 +1,113 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ToolApprovalBar, type ApprovalOption } from '@/atoms/ToolApprovalBar.js';
+
+const reasonOption: ApprovalOption = {
+ id: 'deny-with-reason',
+ label: 'Deny',
+ requiresReason: true,
+ grants: ['filesystem:read'],
+ confirm: {
+ title: 'Explain the denial',
+ description: 'The agent will receive this reason.',
+ },
+};
+
+describe('ToolApprovalBar', () => {
+ it('submits immediate approve and deny options', () => {
+ const onSelect = vi.fn();
+ render(
+ <ToolApprovalBar
+ toolName="shell"
+ approveOptions={[{ id: 'allow-once', label: 'Allow once', variant: 'primary' }]}
+ denyOptions={[{ id: 'reject', label: 'Reject', variant: 'destructive' }]}
+ onSelect={onSelect}
+ />,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Allow once' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Reject' }));
+ expect(onSelect).toHaveBeenNthCalledWith(1, 'allow-once');
+ expect(onSelect).toHaveBeenNthCalledWith(2, 'reject');
+ });
+
+ it('drives the controlled denial-reason workflow and error state', () => {
+ const onDenyOptionChange = vi.fn();
+ const onDenialReasonChange = vi.fn();
+ const onReasonSubmit = vi.fn();
+ const { rerender } = render(
+ <ToolApprovalBar
+ toolName="filesystem"
+ denyOptions={[reasonOption]}
+ onSelect={() => {}}
+ onDenyOptionChange={onDenyOptionChange}
+ />,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Deny' }));
+ expect(onDenyOptionChange).toHaveBeenCalledWith('deny-with-reason');
+
+ rerender(
+ <ToolApprovalBar
+ toolName="filesystem"
+ denyOptions={[reasonOption]}
+ selectedDenyOption={reasonOption}
+ denialReason="unsafe"
+ showReasonError
+ onSelect={() => {}}
+ onDenyOptionChange={onDenyOptionChange}
+ onDenialReasonChange={onDenialReasonChange}
+ onReasonSubmit={onReasonSubmit}
+ />,
+ );
+
+ expect(screen.getByText('Explain the denial')).toBeInTheDocument();
+ expect(screen.getByText('filesystem:read')).toBeInTheDocument();
+ expect(screen.getByRole('alert')).toHaveTextContent('Reason is required');
+ const reasonInput = screen.getByRole('textbox', { name: 'Reason for denial' });
+ expect(reasonInput).toHaveAttribute('aria-invalid', 'true');
+
+ fireEvent.change(reasonInput, { target: { value: 'new reason' } });
+ expect(onDenialReasonChange).toHaveBeenCalledWith('new reason');
+ fireEvent.click(screen.getByRole('button', { name: 'Submit' }));
+ expect(onReasonSubmit).toHaveBeenCalledOnce();
+ fireEvent.click(screen.getByRole('button', { name: 'Back' }));
+ expect(onDenyOptionChange).toHaveBeenLastCalledWith(null);
+ });
+
+ it('locks disabled interactions and hides controls in read-only mode', () => {
+ const onSelect = vi.fn();
+ const { rerender } = render(<ToolApprovalBar toolName="shell" onSelect={onSelect} disabled />);
+
+ expect(screen.getByRole('button', { name: 'Approve' })).toBeDisabled();
+ expect(screen.getByRole('button', { name: 'Deny' })).toBeDisabled();
+ fireEvent.click(screen.getByRole('button', { name: 'Approve' }));
+ expect(onSelect).not.toHaveBeenCalled();
+
+ rerender(<ToolApprovalBar toolName="shell" onSelect={onSelect} readOnly />);
+ expect(screen.queryByRole('button', { name: 'Approve' })).not.toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Deny' })).not.toBeInTheDocument();
+ expect(screen.getByText('Tool Approval Required for')).toBeInTheDocument();
+ });
+
+ it('renders approved and denied decisions with an optional reason', () => {
+ const { rerender } = render(
+ <ToolApprovalBar toolName="shell" onSelect={() => {}} status={{ type: 'approved' }} dataTestPrefix="tool" />,
+ );
+ expect(screen.getByText('Tool Approved')).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Approve' })).not.toBeInTheDocument();
+
+ rerender(
+ <ToolApprovalBar
+ toolName="shell"
+ onSelect={() => {}}
+ status={{ type: 'denied', reason: 'Policy blocked it' }}
+ dataTestPrefix="tool"
+ />,
+ );
+ expect(screen.getByText('Tool Approval Denied')).toBeInTheDocument();
+ expect(screen.getByText('Reason: Policy blocked it')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsx
new file mode 100644
index 000000000..b2d671d59
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ToolCallCard.test.tsx
@@ -0,0 +1,78 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ToolCallCard } from '@/atoms/ToolCallCard.js';
+
+describe('ToolCallCard', () => {
+ it('toggles expandable request content and only shows response content when expanded', () => {
+ const onToggle = vi.fn();
+ const { rerender } = render(
+ <ToolCallCard
+ toolName="Search docs"
+ expanded={false}
+ onToggle={onToggle}
+ requestSlot={<div>request body</div>}
+ responseSlot={<div>response body</div>}
+ showResponseLine
+ dataTestPrefix="search"
+ />,
+ );
+
+ expect(screen.queryByText('request body')).not.toBeInTheDocument();
+ expect(screen.queryByText('response body')).not.toBeInTheDocument();
+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));
+ expect(onToggle).toHaveBeenCalledOnce();
+
+ rerender(
+ <ToolCallCard
+ toolName="Search docs"
+ expanded
+ onToggle={onToggle}
+ requestSlot={<div>request body</div>}
+ responseSlot={<div>response body</div>}
+ showResponseLine
+ dataTestPrefix="search"
+ />,
+ );
+ expect(screen.getByText('request body')).toBeInTheDocument();
+ expect(screen.getByText('response body')).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Collapse step' })).toHaveAttribute('aria-expanded', 'true');
+ });
+
+ it('derives running, success, and error presentation from awaiting and exit code', () => {
+ const { container, rerender } = render(
+ <ToolCallCard toolName="Run" awaiting awaitingText="Executing…" dataTestPrefix="run" />,
+ );
+ expect(screen.getByText('Executing…')).toBeInTheDocument();
+ expect(screen.queryByTestId('run-header-success-icon')).not.toBeInTheDocument();
+
+ rerender(<ToolCallCard toolName="Run" exitCode={0} dataTestPrefix="run" />);
+ expect(screen.getByTestId('run-header-success-icon')).toBeInTheDocument();
+
+ rerender(<ToolCallCard toolName="Run" exitCode={2} dataTestPrefix="run" />);
+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();
+ });
+
+ it('honors explicit status and suppresses expansion when no expandable content exists', () => {
+ const { container } = render(
+ <ToolCallCard toolName="Failed tool" status="error" onToggle={vi.fn()} dataTestPrefix="failed" />,
+ );
+
+ expect(container.querySelector('svg.text-destructive')).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Expand step' })).not.toBeInTheDocument();
+ });
+
+ it('keeps approval content visible while request content is collapsed', () => {
+ render(
+ <ToolCallCard
+ toolName="Protected tool"
+ approvalSlot={<div>approval controls</div>}
+ requestSlot={<div>private request</div>}
+ />,
+ );
+
+ expect(screen.getByText('approval controls')).toBeInTheDocument();
+ expect(screen.queryByText('private request')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsx
new file mode 100644
index 000000000..7e8c7972a
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ToolCallContentBlock.test.tsx
@@ -0,0 +1,157 @@
+// @vitest-environment jsdom
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import type { ComponentProps } from 'react';
+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { Markdown } from '@/atoms/Markdown.js';
+import { ToolCallContentBlock } from '@/atoms/ToolCallContentBlock.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+vi.mock('@/atoms/MonacoEditorCore.js', () => ({
+ MonacoEditorCore: ({
+ value,
+ language,
+ height,
+ autoHeight,
+ options,
+ }: {
+ value: string;
+ language?: string;
+ height?: string | number;
+ autoHeight?: boolean;
+ options?: Record<string, unknown>;
+ }) => (
+ <div
+ data-testid="json-editor"
+ data-language={language}
+ data-height={String(height)}
+ data-auto-height={String(Boolean(autoHeight))}
+ data-read-only={String(options?.readOnly)}
+ >
+ {value}
+ </div>
+ ),
+}));
+
+const clipboardDescriptor = Object.getOwnPropertyDescriptor(navigator, 'clipboard');
+
+function MarkdownStub({ content }: ComponentProps<typeof Markdown>) {
+ return <div data-testid="markdown-content">{content}</div>;
+}
+
+function renderBlock(props: ComponentProps<typeof ToolCallContentBlock>) {
+ return render(
+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>
+ <ToolCallContentBlock {...props} />
+ </SlotsProvider>,
+ );
+}
+
+describe('ToolCallContentBlock', () => {
+ const writeText = vi.fn(() => Promise.resolve());
+
+ beforeAll(() => {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {
+ configurable: true,
+ value: function showModal(this: HTMLDialogElement) {
+ this.open = true;
+ },
+ });
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {
+ configurable: true,
+ value: function close(this: HTMLDialogElement) {
+ this.open = false;
+ },
+ });
+ });
+
+ beforeEach(() => {
+ vi.clearAllMocks();
+ Object.defineProperty(navigator, 'clipboard', {
+ configurable: true,
+ value: { writeText },
+ });
+ });
+
+ afterEach(() => {
+ vi.useRealTimers();
+ if (clipboardDescriptor === undefined) {
+ Reflect.deleteProperty(navigator, 'clipboard');
+ } else {
+ Object.defineProperty(navigator, 'clipboard', clipboardDescriptor);
+ }
+ });
+
+ it('renders JSON read-only and copies the configured copy value', async () => {
+ vi.useFakeTimers();
+ renderBlock({
+ title: 'Arguments',
+ content: '{"token":"redacted"}',
+ copyValue: '{"token":"actual"}',
+ dataTestPrefix: 'args',
+ });
+
+ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-language', 'json');
+ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-read-only', 'true');
+ expect(screen.getByTestId('json-editor')).toHaveAttribute('data-auto-height', 'true');
+
+ await act(async () => {
+ fireEvent.click(screen.getByTestId('args-copy'));
+ await Promise.resolve();
+ });
+ expect(writeText).toHaveBeenCalledWith('{"token":"actual"}');
+ expect(writeText).toHaveBeenCalledOnce();
+
+ act(() => {
+ vi.advanceTimersByTime(1500);
+ });
+ });
+
+ it('renders markdown, clamps resizable height, and provides the content node', () => {
+ const contentRef = vi.fn();
+ renderBlock({
+ title: 'Response',
+ content: '**done**',
+ isJson: false,
+ resizable: true,
+ contentHeightRem: 25,
+ contentRef,
+ });
+
+ expect(screen.getByTestId('markdown-content')).toHaveTextContent('**done**');
+ expect(screen.queryByTestId('json-editor')).not.toBeInTheDocument();
+ const body = screen.getByTestId('markdown-content').parentElement?.parentElement;
+ expect(body).toHaveStyle({ height: '10rem', resize: 'vertical' });
+ expect(contentRef).toHaveBeenCalledWith(body);
+ });
+
+ it('requests fullscreen and closes the controlled fullscreen dialog', () => {
+ const onFullscreenChange = vi.fn();
+ const { rerender } = renderBlock({
+ title: 'Tool output',
+ content: '{"ok":true}',
+ onFullscreenChange,
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand' }));
+ expect(onFullscreenChange).toHaveBeenCalledWith(true);
+
+ rerender(
+ <SlotsProvider overrides={{ Markdown: MarkdownStub }}>
+ <ToolCallContentBlock
+ title="Tool output"
+ content='{"ok":true}'
+ fullscreen
+ onFullscreenChange={onFullscreenChange}
+ />
+ </SlotsProvider>,
+ );
+
+ expect(screen.getByRole('dialog')).toBeInTheDocument();
+ expect(screen.getAllByTestId('json-editor')).toHaveLength(2);
+ expect(screen.getAllByTestId('json-editor')[1]).toHaveAttribute('data-height', '100%');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Minimize' }));
+ expect(onFullscreenChange).toHaveBeenLastCalledWith(false);
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsx b/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsx
new file mode 100644
index 000000000..f1a98706b
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/ToolGroupCard.test.tsx
@@ -0,0 +1,48 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ToolGroupCard } from '@/atoms/ToolGroupCard.js';
+
+describe('ToolGroupCard', () => {
+ it('renders singular and plural tool-call labels', () => {
+ const { rerender } = render(
+ <ToolGroupCard toolCallCount={1} expanded={false} onToggle={() => {}}>
+ content
+ </ToolGroupCard>,
+ );
+ expect(screen.getByText('1 tool call')).toBeInTheDocument();
+
+ rerender(
+ <ToolGroupCard toolCallCount={3} expanded={false} onToggle={() => {}}>
+ content
+ </ToolGroupCard>,
+ );
+ expect(screen.getByText('3 tool calls')).toBeInTheDocument();
+ });
+
+ it('hides collapsed children and invokes the controlled toggle callback', () => {
+ const onToggle = vi.fn();
+ render(
+ <ToolGroupCard toolCallCount={2} expanded={false} onToggle={onToggle}>
+ <div>group content</div>
+ </ToolGroupCard>,
+ );
+
+ expect(screen.queryByText('group content')).not.toBeInTheDocument();
+ fireEvent.click(screen.getByRole('button', { name: /2 tool calls/i }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+
+ it('shows children and active progress when expanded', () => {
+ render(
+ <ToolGroupCard toolCallCount={2} expanded active onToggle={() => {}}>
+ <div>group content</div>
+ </ToolGroupCard>,
+ );
+
+ expect(screen.getByText('group content')).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: /2 tool calls/i })).toHaveAttribute('aria-expanded', 'true');
+ expect(document.querySelector('.animate-spin')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsx
new file mode 100644
index 000000000..b99f24dbb
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageActionBar.test.tsx
@@ -0,0 +1,43 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { UserMessageActionBar } from '@/atoms/UserMessageActionBar.js';
+
+describe('UserMessageActionBar', () => {
+ it('exposes and invokes retry, edit, and copy actions', () => {
+ const onRetry = vi.fn();
+ const onEdit = vi.fn();
+ const onCopy = vi.fn();
+ render(
+ <UserMessageActionBar isCopied={false} onRetry={onRetry} onEdit={onEdit} onCopy={onCopy} className="host-bar" />,
+ );
+
+ const retryButton = screen.getByRole('button', { name: 'Try again' });
+ const editButton = screen.getByRole('button', { name: 'Edit' });
+ const copyButton = screen.getByRole('button', { name: 'Copy' });
+
+ expect(retryButton).toHaveAttribute('title', 'Try again');
+ expect(editButton).toHaveAttribute('title', 'Edit');
+ expect(copyButton).toHaveAttribute('title', 'Copy');
+ expect(retryButton.parentElement).toHaveClass('aui-user-action-bar-root', 'host-bar');
+
+ fireEvent.click(retryButton);
+ fireEvent.click(editButton);
+ fireEvent.click(copyButton);
+
+ expect(onRetry).toHaveBeenCalledOnce();
+ expect(onEdit).toHaveBeenCalledOnce();
+ expect(onCopy).toHaveBeenCalledOnce();
+ });
+
+ it('disables editing and shows the copied confirmation icon', () => {
+ const onEdit = vi.fn();
+ render(<UserMessageActionBar isCopied editDisabled onRetry={vi.fn()} onEdit={onEdit} onCopy={vi.fn()} />);
+
+ const editButton = screen.getByRole('button', { name: 'Edit' });
+ expect(editButton).toBeDisabled();
+ fireEvent.click(editButton);
+ expect(onEdit).not.toHaveBeenCalled();
+ expect(screen.getByRole('button', { name: 'Copy' }).querySelector('svg')).toHaveClass('lucide-check');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsx
new file mode 100644
index 000000000..23a97322c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageBubble.test.tsx
@@ -0,0 +1,34 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { UserMessageBubble } from '@/atoms/UserMessageBubble.js';
+
+describe('UserMessageBubble', () => {
+ it('renders message content, attachments, and an edit action in their semantic slots', () => {
+ const { container } = render(
+ <UserMessageBubble
+ text={'First line\nSecond line'}
+ attachments={<a href="/brief.pdf">brief.pdf</a>}
+ editAction={<button type="button">Edit message</button>}
+ className="consumer-class"
+ />,
+ );
+
+ const root = container.querySelector('[data-slot="aui_user-message-root"]');
+ const content = container.querySelector('[data-slot="aui_user-message-content"]');
+
+ expect(root).toHaveClass('consumer-class');
+ expect(content).toHaveTextContent('First line Second line');
+ expect(content).toHaveStyle({ borderRadius: 'var(--composer-radius, 1.5rem)' });
+ expect(screen.getByRole('link', { name: 'brief.pdf' })).toHaveAttribute('href', '/brief.pdf');
+ expect(screen.getByRole('button', { name: 'Edit message' })).toBeInTheDocument();
+ });
+
+ it('omits optional attachment and edit-action content', () => {
+ render(<UserMessageBubble text="Just text" />);
+
+ expect(screen.getByText('Just text')).toBeInTheDocument();
+ expect(screen.queryByRole('button')).not.toBeInTheDocument();
+ expect(screen.queryByRole('link')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsx b/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsx
new file mode 100644
index 000000000..0013acd53
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/UserMessageEdit.test.tsx
@@ -0,0 +1,43 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { UserMessageEdit } from '@/atoms/UserMessageEdit.js';
+
+describe('UserMessageEdit', () => {
+ it('renders edit context and forwards root HTML attributes', () => {
+ render(
+ <UserMessageEdit
+ timestamp={<time dateTime="2026-08-06">Today</time>}
+ attachments={<span>notes.txt</span>}
+ input={<textarea aria-label="Edit message" defaultValue="Draft text" />}
+ footer={<button type="button">Save edit</button>}
+ className="consumer-class"
+ data-testid="edit-root"
+ aria-label="Message editor"
+ />,
+ );
+
+ const root = screen.getByTestId('edit-root');
+ expect(root).toHaveAttribute('data-slot', 'aui_user-message-edit');
+ expect(root).toHaveAttribute('aria-label', 'Message editor');
+ expect(root).toHaveClass('consumer-class');
+ expect(screen.getByText('User')).toBeInTheDocument();
+ expect(screen.getByText('Today')).toHaveAttribute('datetime', '2026-08-06');
+ expect(screen.getByText('notes.txt')).toBeInTheDocument();
+ expect(screen.getByRole('textbox', { name: 'Edit message' })).toHaveValue('Draft text');
+ expect(screen.getByRole('button', { name: 'Save edit' })).toBeInTheDocument();
+ });
+
+ it('does not add a user metadata row when timestamp and attachments are absent', () => {
+ render(
+ <UserMessageEdit
+ input={<input aria-label="Edit message" />}
+ footer={<button type="button">Cancel edit</button>}
+ />,
+ );
+
+ expect(screen.queryByText('User')).not.toBeInTheDocument();
+ expect(screen.getByRole('textbox', { name: 'Edit message' })).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Cancel edit' })).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx
new file mode 100644
index 000000000..3ec62e767
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx
@@ -0,0 +1,57 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';
+import { ThemeProvider } from '@/theme/ThemeProvider.js';
+
+describe('WelcomeScreen', () => {
+ it('renders the default heading and brand icon outside a provider', () => {
+ const { container } = render(<WelcomeScreen className="host-welcome" />);
+
+ const heading = screen.getByRole('heading', { level: 1, name: 'How can I help you today?' });
+ const root = container.querySelector('[data-preset="truefoundry"]');
+ expect(root).toHaveClass('aui-thread-welcome-root', 'host-welcome');
+ expect(root?.querySelector('svg[aria-hidden="true"]')).toBeInTheDocument();
+ expect(heading).toHaveClass('font-semibold', 'delay-75');
+ });
+
+ it('renders a custom heading and icon', () => {
+ render(<WelcomeScreen heading="Start a task" icon={<span aria-label="Custom welcome icon">★</span>} />);
+
+ expect(screen.getByRole('heading', { name: 'Start a task' })).toBeInTheDocument();
+ expect(screen.getByLabelText('Custom welcome icon')).toHaveTextContent('★');
+ });
+
+ it('allows callers to explicitly suppress the icon', () => {
+ const { container } = render(<WelcomeScreen icon={null} />);
+
+ const heading = screen.getByRole('heading');
+ expect(container.querySelector('svg')).not.toBeInTheDocument();
+ expect(heading).not.toHaveClass('delay-75');
+ });
+
+ it('uses preset-specific icon behavior', () => {
+ const { container, rerender } = render(
+ <ThemeProvider theme={{ preset: 'chatgpt', mode: 'light' }}>
+ <WelcomeScreen />
+ </ThemeProvider>,
+ );
+ expect(container.querySelector('.aui-thread-welcome-root svg')).not.toBeInTheDocument();
+ expect(screen.getByRole('heading')).toHaveClass('font-normal');
+
+ rerender(
+ <ThemeProvider theme={{ preset: 'claude', mode: 'light' }}>
+ <WelcomeScreen />
+ </ThemeProvider>,
+ );
+ expect(container.querySelector('.aui-thread-welcome-root svg')).toHaveClass('fill-current');
+
+ rerender(
+ <ThemeProvider theme={{ preset: 'gemini', mode: 'light' }}>
+ <WelcomeScreen />
+ </ThemeProvider>,
+ );
+ expect(container.querySelector('.aui-thread-welcome-root')).toHaveClass('py-8');
+ expect(container.querySelector('[aria-hidden].motion-safe\\:animate-pulse')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsx
new file mode 100644
index 000000000..dfd429e40
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/AgentStepsCardAdapter.test.tsx
@@ -0,0 +1,50 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { AgentStepsCard } from '@/atoms/adapters/AgentStepsCardAdapter.js';
+
+describe('AgentStepsCard', () => {
+ it('formats tool and thought counts and invokes the controlled toggle', () => {
+ const onToggle = vi.fn();
+ render(
+ <AgentStepsCard toolCount={1} thinkingCount={2} expanded={false} onToggle={onToggle} dataTestPrefix="agent">
+ <div>step details</div>
+ </AgentStepsCard>,
+ );
+
+ expect(screen.getByText(/1 tool call/)).toBeInTheDocument();
+ expect(screen.getByText(/2 thoughts/)).toBeInTheDocument();
+ expect(screen.queryByText('step details')).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: /Agent steps/i }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+
+ it('shows expanded content, singular thought text, and active progress', () => {
+ render(
+ <AgentStepsCard
+ toolCount={3}
+ thinkingCount={1}
+ expanded
+ active
+ onToggle={() => {}}
+ background="rgb(1, 2, 3)"
+ borderColor="rgb(4, 5, 6)"
+ dataTestPrefix="agent"
+ >
+ <div>step details</div>
+ </AgentStepsCard>,
+ );
+
+ expect(screen.getByText(/3 tool calls/)).toBeInTheDocument();
+ expect(screen.getByText(/1 thought/)).toBeInTheDocument();
+ expect(screen.getByTestId('agent-content')).toHaveTextContent('step details');
+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();
+ expect(screen.getByTestId('agent-agent-steps-card')).toHaveAttribute('data-expanded', 'true');
+ expect(screen.getByTestId('agent-agent-steps-card')).toHaveStyle({
+ background: 'rgb(1, 2, 3)',
+ borderColor: 'rgb(4, 5, 6)',
+ });
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsx
new file mode 100644
index 000000000..04c18cd9c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/AskUserPromptAdapter.test.tsx
@@ -0,0 +1,139 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { ASK_USER_CUSTOM_OPTION, AskUserPrompt, type Question } from '@/atoms/adapters/AskUserPromptAdapter.js';
+
+const firstQuestion: Question = {
+ id: 'deployment',
+ question: 'How should this deploy?',
+ options: ['Immediately', 'Schedule it'],
+};
+
+const secondQuestion: Question = {
+ id: 'region',
+ question: 'Which region?',
+ options: ['US', 'EU'],
+};
+
+describe('AskUserPrompt', () => {
+ it('renders nothing without questions or answers, then summarizes answered questions', () => {
+ const onSubmit = vi.fn();
+ const { container, rerender } = render(<AskUserPrompt questions={[]} onSubmit={onSubmit} />);
+
+ expect(container).toBeEmptyDOMElement();
+
+ rerender(
+ <AskUserPrompt
+ questions={[]}
+ answeredQuestions={[
+ { ...firstQuestion, answer: 'Immediately', isCustom: false },
+ { ...secondQuestion, answer: 'Near the users', isCustom: true },
+ ]}
+ onSubmit={onSubmit}
+ dataTestPrefix="ask"
+ />,
+ );
+
+ expect(screen.getByTestId('ask-answered-deployment')).toHaveTextContent('Immediately');
+ expect(screen.getByTestId('ask-answered-region')).toHaveTextContent('Other: Near the users');
+ expect(screen.getAllByText('Answered')).toHaveLength(2);
+ });
+
+ it('reports option and custom-answer edits and submits an enabled single question', () => {
+ const onCurrentAnswerChange = vi.fn();
+ const onSubmit = vi.fn();
+ render(
+ <AskUserPrompt
+ questions={[firstQuestion]}
+ currentQuestion={firstQuestion}
+ currentAnswer={{ radioValue: '', custom: '' }}
+ isSubmitAllDisabled={false}
+ onCurrentAnswerChange={onCurrentAnswerChange}
+ onSubmit={onSubmit}
+ />,
+ );
+
+ fireEvent.click(screen.getByRole('radio', { name: 'Immediately' }));
+ expect(onCurrentAnswerChange).toHaveBeenCalledWith('deployment', { radioValue: 'Immediately' });
+
+ const customAnswer = screen.getByRole('textbox', { name: 'Other (custom answer)' });
+ fireEvent.focus(customAnswer);
+ expect(onCurrentAnswerChange).toHaveBeenCalledWith('deployment', {
+ radioValue: ASK_USER_CUSTOM_OPTION,
+ });
+
+ fireEvent.change(customAnswer, { target: { value: 'After approval' } });
+ expect(onCurrentAnswerChange).toHaveBeenLastCalledWith('deployment', {
+ custom: 'After approval',
+ radioValue: ASK_USER_CUSTOM_OPTION,
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Submit' }));
+ expect(onSubmit).toHaveBeenCalledOnce();
+ });
+
+ it('derives multi-question navigation and prevents premature submission', () => {
+ const onCurrentQuestionIndexChange = vi.fn();
+ const { rerender } = render(
+ <AskUserPrompt
+ questions={[firstQuestion, secondQuestion]}
+ currentQuestion={secondQuestion}
+ currentQuestionIndex={1}
+ currentAnswer={{ radioValue: '', custom: '' }}
+ onCurrentQuestionIndexChange={onCurrentQuestionIndexChange}
+ onSubmit={() => {}}
+ />,
+ );
+
+ expect(screen.getByText('Questions')).toBeInTheDocument();
+ expect(screen.getByText('Which region?')).toBeInTheDocument();
+ expect(screen.getByText('Answer all questions to submit')).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Next question' })).toBeDisabled();
+ expect(screen.getByRole('button', { name: 'Submit' })).toBeDisabled();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Previous question' }));
+ expect(onCurrentQuestionIndexChange).toHaveBeenCalledWith(0);
+
+ rerender(
+ <AskUserPrompt
+ questions={[firstQuestion, secondQuestion]}
+ currentQuestion={firstQuestion}
+ currentQuestionIndex={0}
+ currentAnswer={{ radioValue: 'Immediately', custom: '' }}
+ isSubmitDisabled={false}
+ onCurrentQuestionIndexChange={onCurrentQuestionIndexChange}
+ onSubmit={() => {}}
+ />,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Next' }));
+ expect(onCurrentQuestionIndexChange).toHaveBeenLastCalledWith(1);
+ });
+
+ it('makes an unanswered read-only question non-interactive', () => {
+ const onCurrentAnswerChange = vi.fn();
+ const onSubmit = vi.fn();
+ render(
+ <AskUserPrompt
+ questions={[firstQuestion]}
+ currentQuestion={firstQuestion}
+ currentAnswer={{ radioValue: '', custom: '' }}
+ readOnly
+ onCurrentAnswerChange={onCurrentAnswerChange}
+ onSubmit={onSubmit}
+ />,
+ );
+
+ expect(screen.getByText('Unanswered')).toBeInTheDocument();
+ for (const radio of screen.getAllByRole('radio')) {
+ expect(radio).toBeDisabled();
+ }
+ expect(screen.getByRole('textbox', { name: 'Other (custom answer)' })).toBeDisabled();
+ expect(screen.queryByRole('button', { name: 'Submit' })).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('radio', { name: 'Immediately' }));
+ expect(onCurrentAnswerChange).not.toHaveBeenCalled();
+ expect(onSubmit).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsx b/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsx
new file mode 100644
index 000000000..4b26c11cc
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/adapters/ReasoningCardAdapter.test.tsx
@@ -0,0 +1,87 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import type { ComponentProps } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { Markdown } from '@/atoms/Markdown.js';
+import { ReasoningCard } from '@/atoms/adapters/ReasoningCardAdapter.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function MarkdownProbe({ content }: ComponentProps<typeof Markdown>) {
+ return <div data-testid="markdown-probe">{content}</div>;
+}
+
+function renderSubject(props: ComponentProps<typeof ReasoningCard>) {
+ return render(
+ <SlotsProvider overrides={{ Markdown: MarkdownProbe }}>
+ <ReasoningCard {...props} />
+ </SlotsProvider>,
+ );
+}
+
+describe('ReasoningCard', () => {
+ it('summarizes completed one-line reasoning and exposes its controlled toggle', () => {
+ const onToggle = vi.fn();
+ renderSubject({
+ content: 'Checked the deployment state.',
+ reasoningTimeText: 'Reasoned for 2s',
+ onToggle,
+ dataTestPrefix: 'reason',
+ });
+
+ expect(screen.getByTestId('reason-reasoning-inline')).toBeInTheDocument();
+ expect(screen.getByTestId('reason-title')).toHaveTextContent('Reasoned for 2s');
+ expect(screen.queryByTestId('reason-content')).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+
+ it('renders expanded multiline content through the Markdown slot and provides its content node', () => {
+ const contentRef = vi.fn();
+ renderSubject({
+ content: 'First line\nSecond line',
+ expanded: true,
+ isMultiLine: true,
+ contentRef,
+ onToggle: () => {},
+ dataTestPrefix: 'reason',
+ });
+
+ const content = screen.getByTestId('reason-content');
+ expect(screen.getByTestId('reason-reasoning-accordion')).toBeInTheDocument();
+ expect(screen.getByTestId('markdown-probe')).toHaveTextContent(/First line\s+Second line/);
+ expect(contentRef).toHaveBeenCalledWith(content);
+ expect(screen.getByRole('button', { name: 'Collapse step' })).toHaveAttribute('aria-expanded', 'true');
+ });
+
+ it('keeps empty completed reasoning idle and non-expandable', () => {
+ const onToggle = vi.fn();
+ renderSubject({
+ content: '',
+ onToggle,
+ dataTestPrefix: 'reason',
+ });
+
+ expect(screen.getByTestId('reason-title')).toHaveTextContent('Reasoning');
+ expect(screen.queryByRole('button', { name: /step/i })).not.toBeInTheDocument();
+ expect(screen.queryByTestId('markdown-probe')).not.toBeInTheDocument();
+ });
+
+ it('uses the streaming heading and remains expandable before content arrives', () => {
+ const onToggle = vi.fn();
+ renderSubject({
+ content: '',
+ isStreaming: true,
+ headingText: 'Thinking through changes',
+ onToggle,
+ dataTestPrefix: 'reason',
+ });
+
+ expect(screen.getByTestId('reason-title')).toHaveTextContent('Thinking through changes');
+ expect(screen.getByRole('button', { name: 'Expand step' })).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Expand step' }));
+ expect(onToggle).toHaveBeenCalledOnce();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsx b/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsx
new file mode 100644
index 000000000..fbe0c7218
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/agent-chat/AgentStepRow.test.tsx
@@ -0,0 +1,126 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import type { SVGProps } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { AgentStepRow, type AgentStepRowProps } from '@/atoms/agent-chat/AgentStepRow.js';
+import { ThemeProvider } from '@/theme/ThemeProvider.js';
+import type { ThemeConfig } from '@/theme/types.js';
+
+function StepIconProbe(props: SVGProps<SVGSVGElement>) {
+ return <svg {...props} data-testid="configured-step-icon" />;
+}
+
+const testTheme: ThemeConfig = {
+ mode: 'light',
+ icons: {
+ 'test-step': StepIconProbe,
+ },
+};
+
+function TestSubject(props: Omit<AgentStepRowProps, 'icon'>) {
+ return (
+ <ThemeProvider theme={testTheme}>
+ <AgentStepRow icon="test-step" {...props} />
+ </ThemeProvider>
+ );
+}
+
+describe('AgentStepRow', () => {
+ it('exposes its controlled expansion and propagates only intended row clicks', () => {
+ const onToggle = vi.fn();
+ const { rerender } = render(
+ <TestSubject
+ title="Fetch deployment"
+ body={<button type="button">Inspect response</button>}
+ expandable
+ expanded={false}
+ onToggle={onToggle}
+ dataTestPrefix="fetch"
+ />,
+ );
+
+ expect(screen.getByTestId('configured-step-icon')).toHaveAttribute('aria-hidden', 'true');
+
+ const expandButton = screen.getByRole('button', { name: 'Expand step' });
+ expect(expandButton).toHaveAttribute('aria-expanded', 'false');
+
+ fireEvent.click(expandButton);
+ fireEvent.click(screen.getByTestId('fetch-title'));
+ fireEvent.click(screen.getByRole('button', { name: 'Inspect response' }));
+ expect(onToggle).toHaveBeenCalledTimes(3);
+
+ rerender(
+ <TestSubject
+ title="Fetch deployment"
+ body={<button type="button">Inspect response</button>}
+ expandable
+ expanded
+ onToggle={onToggle}
+ dataTestPrefix="fetch"
+ />,
+ );
+
+ const collapseButton = screen.getByRole('button', { name: 'Collapse step' });
+ expect(collapseButton).toHaveAttribute('aria-expanded', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Inspect response' }));
+ expect(onToggle).toHaveBeenCalledTimes(3);
+
+ fireEvent.click(collapseButton);
+ expect(onToggle).toHaveBeenCalledTimes(4);
+ });
+
+ it('hides collapsible children while keeping persistent children mounted', () => {
+ const { rerender } = render(
+ <TestSubject
+ title="Process files"
+ expanded={false}
+ dataTestPrefix="process"
+ persistentChildren={<div>Always-visible progress</div>}
+ >
+ <div>Expanded details</div>
+ </TestSubject>,
+ );
+
+ expect(screen.queryByTestId('process-expanded-content')).not.toBeInTheDocument();
+ expect(screen.queryByText('Expanded details')).not.toBeInTheDocument();
+ expect(screen.getByTestId('process-persistent-content')).toHaveTextContent('Always-visible progress');
+
+ rerender(
+ <TestSubject
+ title="Process files"
+ expanded
+ dataTestPrefix="process"
+ persistentChildren={<div>Always-visible progress</div>}
+ >
+ <div>Expanded details</div>
+ </TestSubject>,
+ );
+
+ expect(screen.getByTestId('process-expanded-content')).toHaveTextContent('Expanded details');
+ expect(screen.getByTestId('process-persistent-content')).toHaveTextContent('Always-visible progress');
+ });
+
+ it('presents running, success, and error statuses with their intended indicators', () => {
+ const { rerender } = render(
+ <TestSubject title="Run command" status="running" statusText="Running" dataTestPrefix="command" />,
+ );
+
+ const runningText = screen.getByText('Running');
+ expect(runningText.previousElementSibling).toHaveAttribute('aria-hidden', 'true');
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();
+
+ rerender(<TestSubject title="Run command" status="running" showSpinner dataTestPrefix="command" />);
+ expect(screen.getByRole('status', { name: 'Loading' })).toBeInTheDocument();
+ expect(screen.queryByText('Running')).not.toBeInTheDocument();
+
+ rerender(<TestSubject title="Run command" status="success" dataTestPrefix="command" />);
+ expect(screen.getByTestId('command-success-icon')).toHaveAttribute('aria-hidden', 'true');
+ expect(screen.queryByRole('status', { name: 'Loading' })).not.toBeInTheDocument();
+ expect(screen.queryByTestId('command-error-icon')).not.toBeInTheDocument();
+
+ rerender(<TestSubject title="Run command" status="error" dataTestPrefix="command" />);
+ expect(screen.getByTestId('command-error-icon')).toHaveAttribute('aria-hidden', 'true');
+ expect(screen.queryByTestId('command-success-icon')).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsx
new file mode 100644
index 000000000..a1da58001
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCatalogProvider.test.tsx
@@ -0,0 +1,115 @@
+// @vitest-environment jsdom
+import { act, render, screen, waitFor } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { DraftCatalogProvider, useDraftCatalog } from '@/atoms/draft/DraftCatalogProvider.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { AgentSkill, ConnectorState, ModelSelection } from '@/server/types.js';
+import { createMockAgentUIServer } from '../../server/mockServer.js';
+
+function CatalogProbe() {
+ const catalog = useDraftCatalog();
+
+ return (
+ <div>
+ <output data-testid="models">{catalog.models.map(model => model.name).join(',')}</output>
+ <output data-testid="skills">{catalog.skills.map(skill => skill.name).join(',')}</output>
+ <output data-testid="connectors">{catalog.connectors.map(connector => connector.name).join(',')}</output>
+ <output data-testid="loading">{String(catalog.loading)}</output>
+ <output data-testid="error">{catalog.error ?? ''}</output>
+ </div>
+ );
+}
+
+function deferred<T>() {
+ let resolvePromise: ((value: T) => void) | undefined;
+ let rejectPromise: ((reason?: unknown) => void) | undefined;
+ const promise = new Promise<T>((resolve, reject) => {
+ resolvePromise = resolve;
+ rejectPromise = reject;
+ });
+
+ return {
+ promise,
+ resolve(value: T) {
+ if (resolvePromise === undefined) {
+ throw new Error('Deferred promise was not initialized');
+ }
+ resolvePromise(value);
+ },
+ reject(reason: unknown) {
+ if (rejectPromise === undefined) {
+ throw new Error('Deferred promise was not initialized');
+ }
+ rejectPromise(reason);
+ },
+ };
+}
+
+describe('DraftCatalogProvider', () => {
+ it('exposes an empty, idle catalog when used without a provider', () => {
+ render(<CatalogProbe />);
+
+ expect(screen.getByTestId('models')).toBeEmptyDOMElement();
+ expect(screen.getByTestId('skills')).toBeEmptyDOMElement();
+ expect(screen.getByTestId('connectors')).toBeEmptyDOMElement();
+ expect(screen.getByTestId('loading')).toHaveTextContent('false');
+ expect(screen.getByTestId('error')).toBeEmptyDOMElement();
+ });
+
+ it('loads all catalog collections and publishes them together', async () => {
+ const models = deferred<ModelSelection[]>();
+ const skills = deferred<AgentSkill[]>();
+ const connectors = deferred<ConnectorState[]>();
+ const getModels = vi.fn(() => models.promise);
+ const getSkills = vi.fn(() => skills.promise);
+ const getMcp = vi.fn(() => connectors.promise);
+ const server = createMockAgentUIServer({ getModels, getSkills, getMcp });
+
+ render(
+ <ServerProvider server={server}>
+ <DraftCatalogProvider>
+ <CatalogProbe />
+ </DraftCatalogProvider>
+ </ServerProvider>,
+ );
+
+ expect(screen.getByTestId('loading')).toHaveTextContent('true');
+ expect(getModels).toHaveBeenCalledTimes(1);
+ expect(getSkills).toHaveBeenCalledTimes(1);
+ expect(getMcp).toHaveBeenCalledTimes(1);
+
+ await act(async () => {
+ models.resolve([{ name: 'openai/gpt-4.1', provider: 'OpenAI' }]);
+ skills.resolve([{ id: 'skill-1', name: 'Release notes' }]);
+ connectors.resolve([{ id: 'mcp-1', name: 'GitHub' }]);
+ await Promise.all([models.promise, skills.promise, connectors.promise]);
+ });
+
+ await waitFor(() => expect(screen.getByTestId('loading')).toHaveTextContent('false'));
+ expect(screen.getByTestId('models')).toHaveTextContent('openai/gpt-4.1');
+ expect(screen.getByTestId('skills')).toHaveTextContent('Release notes');
+ expect(screen.getByTestId('connectors')).toHaveTextContent('GitHub');
+ expect(screen.getByTestId('error')).toBeEmptyDOMElement();
+ });
+
+ it('surfaces catalog failures and leaves loading state', async () => {
+ const server = createMockAgentUIServer({
+ getModels: async () => {
+ throw new Error('Catalog unavailable');
+ },
+ });
+
+ render(
+ <ServerProvider server={server}>
+ <DraftCatalogProvider>
+ <CatalogProbe />
+ </DraftCatalogProvider>
+ </ServerProvider>,
+ );
+
+ await waitFor(() => expect(screen.getByTestId('error')).toHaveTextContent('Catalog unavailable'));
+ expect(screen.getByTestId('loading')).toHaveTextContent('false');
+ expect(screen.getByTestId('models')).toBeEmptyDOMElement();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsx
new file mode 100644
index 000000000..df59af2a4
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftComposerSections.test.tsx
@@ -0,0 +1,94 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';
+import { DraftComposerLeftSection, DraftComposerRightSection } from '@/atoms/draft/DraftComposerSections.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { AgentSpec } from '@/server/types.js';
+import { createMockAgentUIServer } from '../../server/mockServer.js';
+
+let agentSpec: AgentSpec;
+const updateAgentSpec = vi.fn();
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryAgentSpec: () => ({ agentSpec }),
+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,
+}));
+
+function DraftSections({
+ onAttach,
+ disabled = false,
+ isRunning = false,
+}: {
+ onAttach?: () => void;
+ disabled?: boolean;
+ isRunning?: boolean;
+}) {
+ const server = createMockAgentUIServer({
+ getModels: async () => [
+ {
+ name: 'openai/gpt-4.1',
+ provider: 'OpenAI',
+ reasoningEfforts: ['low', 'high'],
+ },
+ ],
+ });
+
+ return (
+ <ServerProvider server={server}>
+ <DraftCatalogProvider>
+ <DraftComposerLeftSection disabled={disabled} isRunning={isRunning} onAttach={onAttach} />
+ <DraftComposerRightSection disabled={disabled} isRunning={isRunning} />
+ </DraftCatalogProvider>
+ </ServerProvider>
+ );
+}
+
+describe('draft composer sections', () => {
+ beforeEach(() => {
+ agentSpec = {
+ model: { name: 'openai/gpt-4.1', params: { reasoningEffort: 'high' } },
+ mcpServers: [{ id: 'github', name: 'GitHub' }],
+ skills: [
+ { id: 'research', name: 'Research' },
+ { id: 'writer', name: 'Writer' },
+ ],
+ };
+ updateAgentSpec.mockReset();
+ });
+
+ it('composes selection chips and forwards attachment behavior from the left section', () => {
+ const onAttach = vi.fn();
+ render(<DraftSections onAttach={onAttach} />);
+
+ expect(screen.getByText('1 Connector')).toBeInTheDocument();
+ expect(screen.getByText('2 Skills')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Attachment' }));
+ fireEvent.click(screen.getByRole('button', { name: /Add files or photos/ }));
+
+ expect(onAttach).toHaveBeenCalledTimes(1);
+ });
+
+ it('composes model and reasoning selectors in the right section', async () => {
+ render(<DraftSections />);
+
+ expect(await screen.findByTitle('Select model')).toHaveTextContent('gpt-4.1');
+ expect(await screen.findByTitle('Select reasoning effort')).toHaveTextContent('high');
+ });
+
+ it('propagates disabled and running state to composed controls', async () => {
+ const { rerender } = render(<DraftSections disabled />);
+
+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();
+ expect(await screen.findByTitle('Select model')).toBeDisabled();
+ expect(await screen.findByTitle('Select reasoning effort')).toBeDisabled();
+
+ rerender(<DraftSections isRunning />);
+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();
+ expect(await screen.findByTitle('Select model')).toBeDisabled();
+ expect(await screen.findByTitle('Select reasoning effort')).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx
new file mode 100644
index 000000000..5be288084
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx
@@ -0,0 +1,110 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen, within } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';
+import { DraftCompositeSelector, type DraftCompositeSelectorProps } from '@/atoms/draft/DraftCompositeSelector.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { AgentSpec } from '@/server/types.js';
+import { createMockAgentUIServer } from '../../server/mockServer.js';
+
+let agentSpec: AgentSpec;
+const updateAgentSpec = vi.fn();
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryAgentSpec: () => ({ agentSpec }),
+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,
+}));
+
+function renderSelector(props: DraftCompositeSelectorProps = {}) {
+ const server = createMockAgentUIServer({
+ getSkills: async () => [
+ { id: 'research', name: 'Research', description: 'Find relevant sources' },
+ { id: 'writer', name: 'Writer', description: 'Draft polished copy' },
+ ],
+ getMcp: async () => [
+ { id: 'github', name: 'GitHub', description: 'Code hosting' },
+ { id: 'slack', name: 'Slack', description: 'Team messages' },
+ ],
+ });
+
+ return render(
+ <ServerProvider server={server}>
+ <DraftCatalogProvider>
+ <DraftCompositeSelector {...props} />
+ </DraftCatalogProvider>
+ </ServerProvider>,
+ );
+}
+
+describe('DraftCompositeSelector', () => {
+ beforeEach(() => {
+ agentSpec = {
+ model: { name: 'openai/gpt-4.1' },
+ mcpServers: [{ id: 'slack', name: 'Slack' }],
+ skills: [{ id: 'research', name: 'Research' }],
+ };
+ updateAgentSpec.mockReset();
+ });
+
+ it('adds an available connector to the draft spec', async () => {
+ renderSelector();
+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));
+
+ const github = await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });
+ expect(github).toHaveAttribute('aria-checked', 'false');
+ fireEvent.click(github);
+
+ expect(updateAgentSpec).toHaveBeenCalledWith({
+ mcpServers: [
+ { id: 'slack', name: 'Slack' },
+ { id: 'github', name: 'GitHub' },
+ ],
+ });
+ });
+
+ it('switches tabs, resets search, and removes a selected skill', async () => {
+ renderSelector();
+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));
+ await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });
+
+ fireEvent.change(screen.getByRole('searchbox'), { target: { value: 'github' } });
+ expect(screen.queryByRole('menuitemcheckbox', { name: /Slack/ })).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: /Skills/ }));
+ const skillSearch = screen.getByRole('searchbox');
+ expect(skillSearch).toHaveValue('');
+ expect(skillSearch).toHaveAttribute('placeholder', 'Search skills...');
+
+ const dialog = screen.getByRole('dialog', { name: 'Add to composer' });
+ const research = within(dialog).getByRole('menuitemcheckbox', { name: /Research/ });
+ expect(research).toHaveAttribute('aria-checked', 'true');
+ expect(within(dialog).getByRole('menuitemcheckbox', { name: /Writer/ })).toBeInTheDocument();
+ fireEvent.click(research);
+
+ expect(updateAgentSpec).toHaveBeenCalledWith({ skills: [] });
+ });
+
+ it('forwards attachment requests and closes the picker', async () => {
+ const onAttach = vi.fn();
+ renderSelector({ onAttach });
+ const trigger = screen.getByRole('button', { name: 'Add connectors, skills, or attachments' });
+ fireEvent.click(trigger);
+ await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });
+ fireEvent.click(screen.getByRole('button', { name: 'Attachment' }));
+ fireEvent.click(screen.getByRole('button', { name: /Add files or photos/ }));
+
+ expect(onAttach).toHaveBeenCalledTimes(1);
+ expect(screen.queryByRole('dialog', { name: 'Add to composer' })).not.toBeInTheDocument();
+ expect(trigger).toHaveAttribute('aria-expanded', 'false');
+ });
+
+ it('cannot open while disabled or running', () => {
+ const { rerender } = render(<DraftCompositeSelector disabled />);
+
+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();
+
+ rerender(<DraftCompositeSelector isRunning />);
+ expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsx
new file mode 100644
index 000000000..b94664935
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftModelSelector.test.tsx
@@ -0,0 +1,92 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen, waitFor, within } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';
+import { DraftModelSelector, type DraftModelSelectorProps } from '@/atoms/draft/DraftModelSelector.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { AgentSpec, ModelSelection } from '@/server/types.js';
+import { createMockAgentUIServer } from '../../server/mockServer.js';
+
+let agentSpec: AgentSpec | undefined;
+const updateAgentSpec = vi.fn();
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryAgentSpec: () => ({ agentSpec }),
+ useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,
+}));
+
+const models: ModelSelection[] = [
+ { name: 'openai/gpt-4.1', provider: 'OpenAI' },
+ {
+ name: 'anthropic/claude-3.7-sonnet',
+ provider: 'Anthropic',
+ reasoningEfforts: ['low', 'high'],
+ },
+];
+
+function renderSelector(props: DraftModelSelectorProps = {}) {
+ const server = createMockAgentUIServer({ getModels: async () => models });
+
+ return render(
+ <ServerProvider server={server}>
+ <DraftCatalogProvider>
+ <DraftModelSelector {...props} />
+ </DraftCatalogProvider>
+ </ServerProvider>,
+ );
+}
+
+describe('DraftModelSelector', () => {
+ beforeEach(() => {
+ agentSpec = {
+ model: {
+ name: 'openai/gpt-4.1',
+ params: { maxTokens: 512, reasoningEffort: 'medium' },
+ },
+ };
+ updateAgentSpec.mockReset();
+ });
+
+ it('filters models and updates the agent spec when a model is selected', async () => {
+ renderSelector();
+
+ const trigger = await screen.findByTitle('Select model');
+ await waitFor(() => expect(trigger).toHaveTextContent('gpt-4.1'));
+ fireEvent.click(trigger);
+
+ const listbox = screen.getByRole('listbox', { name: 'Select model' });
+ expect(within(listbox).getAllByRole('option')).toHaveLength(2);
+
+ fireEvent.change(screen.getByRole('searchbox'), { target: { value: 'anthropic' } });
+ expect(within(listbox).getAllByRole('option')).toHaveLength(1);
+ expect(within(listbox).getByRole('option')).toHaveTextContent('claude-3.7-sonnet');
+
+ fireEvent.click(within(listbox).getByRole('option'));
+
+ expect(updateAgentSpec).toHaveBeenCalledWith({
+ model: {
+ name: 'anthropic/claude-3.7-sonnet',
+ params: { maxTokens: 512, reasoningEffort: 'low' },
+ },
+ });
+ expect(screen.queryByRole('listbox', { name: 'Select model' })).not.toBeInTheDocument();
+ expect(trigger).toHaveAttribute('aria-expanded', 'false');
+ });
+
+ it('uses the first catalog model when the runtime has no draft spec', async () => {
+ agentSpec = undefined;
+ renderSelector();
+
+ await waitFor(() => expect(screen.getByTitle('Select model')).toHaveTextContent('gpt-4.1'));
+ });
+
+ it('disables selection while disabled or running', () => {
+ const { rerender } = render(<DraftModelSelector disabled />);
+
+ expect(screen.getByTitle('Select model')).toBeDisabled();
+
+ rerender(<DraftModelSelector isRunning />);
+ expect(screen.getByTitle('Select model')).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.ts b/packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.ts
similarity index 92%
rename from packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.ts
rename to packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.ts
index 092e00522..bdbbcc739 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/reasoningEffort.test.ts
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/reasoningEffort.test.ts
@@ -1,6 +1,10 @@
import { describe, expect, it } from 'vitest';
-import { hasReasoningEfforts, modelPatchWithReasoningEffort, resolveReasoningEffort } from './reasoningEffort.js';
+import {
+ hasReasoningEfforts,
+ modelPatchWithReasoningEffort,
+ resolveReasoningEffort,
+} from '@/atoms/draft/reasoningEffort.js';
describe('hasReasoningEfforts', () => {
it('is false for nullish or empty', () => {
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsx
new file mode 100644
index 000000000..a86b00e6f
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Accordion.test.tsx
@@ -0,0 +1,108 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import {
+ Accordion,
+ AccordionContent,
+ AccordionDetails,
+ AccordionItem,
+ AccordionRoot,
+ AccordionSummary,
+ AccordionTrigger,
+} from '@/atoms/primitives/Accordion.js';
+
+describe('Accordion', () => {
+ it('reports controlled changes and keeps summary and details accessibility in sync', () => {
+ const onChange = vi.fn();
+ const { rerender } = render(
+ <Accordion expanded={false} onChange={onChange} className="host-accordion" data-testid="accordion">
+ <AccordionSummary>Account settings</AccordionSummary>
+ <AccordionDetails>Profile details</AccordionDetails>
+ </Accordion>,
+ );
+
+ const accordion = screen.getByTestId('accordion');
+ const summary = screen.getByRole('button', { name: 'Account settings' });
+ expect(accordion).toHaveClass('w-full', 'host-accordion');
+ expect(accordion).not.toHaveAttribute('data-expanded');
+ expect(summary).toHaveAttribute('aria-expanded', 'false');
+ expect(summary).toHaveAttribute('aria-controls');
+ expect(screen.queryByRole('region')).not.toBeInTheDocument();
+
+ fireEvent.click(summary);
+ expect(onChange).toHaveBeenCalledWith(expect.any(Object), true);
+
+ rerender(
+ <Accordion expanded onChange={onChange} className="host-accordion" data-testid="accordion">
+ <AccordionSummary>Account settings</AccordionSummary>
+ <AccordionDetails>Profile details</AccordionDetails>
+ </Accordion>,
+ );
+
+ const region = screen.getByRole('region');
+ expect(accordion).toHaveAttribute('data-expanded', 'true');
+ expect(summary).toHaveAttribute('aria-expanded', 'true');
+ expect(region).toHaveTextContent('Profile details');
+ expect(region).toHaveAttribute('id', summary.getAttribute('aria-controls'));
+
+ fireEvent.click(summary);
+ expect(onChange).toHaveBeenLastCalledWith(expect.any(Object), false);
+ });
+});
+
+describe('AccordionRoot', () => {
+ it('opens, switches, and closes items in single mode', () => {
+ render(
+ <AccordionRoot defaultValue="profile" className="host-root">
+ <AccordionItem value="profile">
+ <AccordionTrigger data-track="profile">Profile</AccordionTrigger>
+ <AccordionContent>Profile panel</AccordionContent>
+ </AccordionItem>
+ <AccordionItem value="security">
+ <AccordionTrigger>Security</AccordionTrigger>
+ <AccordionContent>Security panel</AccordionContent>
+ </AccordionItem>
+ </AccordionRoot>,
+ );
+
+ const profile = screen.getByRole('button', { name: 'Profile' });
+ const security = screen.getByRole('button', { name: 'Security' });
+ expect(profile).toHaveAttribute('data-track', 'profile');
+ expect(profile).toHaveAttribute('aria-expanded', 'true');
+ expect(screen.getByRole('region')).toHaveTextContent('Profile panel');
+
+ fireEvent.click(security);
+ expect(profile).toHaveAttribute('aria-expanded', 'false');
+ expect(security).toHaveAttribute('aria-expanded', 'true');
+ expect(screen.queryByText('Profile panel')).not.toBeInTheDocument();
+ expect(screen.getByRole('region')).toHaveTextContent('Security panel');
+ expect(screen.getByRole('region')).toHaveAttribute('id', security.getAttribute('aria-controls'));
+
+ fireEvent.click(security);
+ expect(security).toHaveAttribute('aria-expanded', 'false');
+ expect(screen.queryByRole('region')).not.toBeInTheDocument();
+ });
+
+ it('keeps independently toggled items open in multiple mode', () => {
+ render(
+ <AccordionRoot type="multiple">
+ <AccordionItem value="first">
+ <AccordionTrigger>First</AccordionTrigger>
+ <AccordionContent>First panel</AccordionContent>
+ </AccordionItem>
+ <AccordionItem value="second">
+ <AccordionTrigger>Second</AccordionTrigger>
+ <AccordionContent>Second panel</AccordionContent>
+ </AccordionItem>
+ </AccordionRoot>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'First' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Second' }));
+ expect(screen.getAllByRole('region')).toHaveLength(2);
+
+ fireEvent.click(screen.getByRole('button', { name: 'First' }));
+ expect(screen.queryByText('First panel')).not.toBeInTheDocument();
+ expect(screen.getByText('Second panel')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsx
new file mode 100644
index 000000000..ef367f1d0
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Avatar.test.tsx
@@ -0,0 +1,57 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { Avatar, AvatarFallback, AvatarImage } from '@/atoms/primitives/Avatar.js';
+
+describe('Avatar', () => {
+ it('applies the selected size and forwards host attributes', () => {
+ render(<Avatar size="lg" className="host-avatar" aria-label="Ada Lovelace" />);
+
+ const avatar = screen.getByLabelText('Ada Lovelace');
+ expect(avatar).toHaveAttribute('data-slot', 'avatar');
+ expect(avatar).toHaveAttribute('data-size', 'lg');
+ expect(avatar).toHaveClass('h-10', 'w-10', 'host-avatar');
+ });
+});
+
+describe('AvatarImage', () => {
+ it('renders its source and accessible alternative text', () => {
+ render(<AvatarImage src="/ada.png" alt="Ada Lovelace" className="host-image" />);
+
+ const image = screen.getByRole('img', { name: 'Ada Lovelace' });
+ expect(image).toHaveAttribute('src', '/ada.png');
+ expect(image).toHaveAttribute('data-slot', 'avatar-image');
+ expect(image).toHaveClass('object-cover', 'host-image');
+ });
+
+ it('calls the host error handler and removes a failed image', () => {
+ const onError = vi.fn();
+ render(<AvatarImage src="/missing.png" alt="Missing avatar" onError={onError} />);
+
+ fireEvent.error(screen.getByRole('img', { name: 'Missing avatar' }));
+
+ expect(onError).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('img', { name: 'Missing avatar' })).not.toBeInTheDocument();
+ });
+
+ it('does not render an image without a source', () => {
+ const { container } = render(<AvatarImage alt="No source" />);
+
+ expect(container).toBeEmptyDOMElement();
+ });
+});
+
+describe('AvatarFallback', () => {
+ it('renders fallback content and forwards host attributes', () => {
+ render(
+ <AvatarFallback className="host-fallback" aria-label="Ada initials">
+ AL
+ </AvatarFallback>,
+ );
+
+ const fallback = screen.getByLabelText('Ada initials');
+ expect(fallback).toHaveTextContent('AL');
+ expect(fallback).toHaveAttribute('data-slot', 'avatar-fallback');
+ expect(fallback).toHaveClass('host-fallback');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsx
new file mode 100644
index 000000000..0d5563c1c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/BottomSheet.test.tsx
@@ -0,0 +1,149 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { BottomSheet } from '@/atoms/primitives/BottomSheet.js';
+
+const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');
+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');
+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {
+ this.open = true;
+});
+const close = vi.fn(function close(this: HTMLDialogElement) {
+ this.open = false;
+ this.dispatchEvent(new Event('close'));
+});
+
+beforeEach(() => {
+ showModal.mockClear();
+ close.mockClear();
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {
+ configurable: true,
+ value: showModal,
+ });
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {
+ configurable: true,
+ value: close,
+ });
+});
+
+afterEach(() => {
+ if (originalShowModal === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);
+ }
+ if (originalClose === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);
+ }
+});
+
+function getNativeDialog(container: HTMLElement) {
+ const dialog = container.querySelector('dialog');
+ if (dialog === null) {
+ throw new Error('Expected a native dialog');
+ }
+ return dialog;
+}
+
+describe('BottomSheet', () => {
+ it('synchronizes the controlled open state with the native dialog', () => {
+ const onOpenChange = vi.fn();
+ const view = render(
+ <BottomSheet open={false} onOpenChange={onOpenChange} aria-label="Picker">
+ Content
+ </BottomSheet>,
+ );
+ const dialog = getNativeDialog(view.container);
+
+ expect(dialog).not.toHaveAttribute('open');
+ expect(showModal).not.toHaveBeenCalled();
+
+ view.rerender(
+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">
+ Content
+ </BottomSheet>,
+ );
+ expect(dialog).toHaveAttribute('open');
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">
+ Content
+ </BottomSheet>,
+ );
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <BottomSheet open={false} onOpenChange={onOpenChange} aria-label="Picker">
+ Content
+ </BottomSheet>,
+ );
+ expect(dialog).not.toHaveAttribute('open');
+ expect(close).toHaveBeenCalledOnce();
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('reports native close and backdrop requests but ignores child clicks', () => {
+ const onOpenChange = vi.fn();
+ const { container } = render(
+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">
+ <button type="button">Inside action</button>
+ </BottomSheet>,
+ );
+ const dialog = getNativeDialog(container);
+
+ fireEvent.click(screen.getByRole('button', { name: 'Inside action' }));
+ expect(onOpenChange).not.toHaveBeenCalled();
+
+ fireEvent.click(dialog);
+ expect(onOpenChange).toHaveBeenCalledOnce();
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+
+ onOpenChange.mockClear();
+ fireEvent(dialog, new Event('close'));
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('handles Escape without closing a parent dialog', () => {
+ const onOpenChange = vi.fn();
+ const onParentCancel = vi.fn();
+
+ render(
+ <dialog open onCancel={onParentCancel}>
+ <BottomSheet open onOpenChange={onOpenChange} aria-label="Picker">
+ Content
+ </BottomSheet>
+ </dialog>,
+ );
+
+ const cancelEvent = new Event('cancel', { bubbles: true, cancelable: true });
+ fireEvent(screen.getByRole('dialog', { name: 'Picker' }), cancelEvent);
+
+ expect(cancelEvent.defaultPrevented).toBe(true);
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ expect(onParentCancel).not.toHaveBeenCalled();
+ });
+
+ it('forwards its id, accessible label, custom class, and children', () => {
+ render(
+ <BottomSheet
+ open
+ onOpenChange={() => undefined}
+ id="attachment-picker"
+ aria-label="Choose an attachment"
+ className="custom-sheet"
+ >
+ <section>Sheet content</section>
+ </BottomSheet>,
+ );
+
+ const dialog = screen.getByRole('dialog', { name: 'Choose an attachment' });
+ expect(dialog).toHaveAttribute('id', 'attachment-picker');
+ expect(dialog).toHaveClass('custom-sheet');
+ expect(dialog).toHaveStyle({ height: 'min(70dvh, 30rem)', maxHeight: '85dvh' });
+ expect(screen.getByText('Sheet content')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsx
new file mode 100644
index 000000000..3cd5d83d6
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Button.test.tsx
@@ -0,0 +1,49 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { Button } from '@/atoms/primitives/Button.js';
+
+describe('Button', () => {
+ it('forwards its ref and host props while applying the requested presentation', () => {
+ const ref = createRef<HTMLButtonElement>();
+ const onClick = vi.fn();
+ render(
+ <Button
+ ref={ref}
+ type="button"
+ variant="outline"
+ size="lg"
+ className="host-button"
+ data-track="save"
+ onClick={onClick}
+ >
+ Save changes
+ </Button>,
+ );
+
+ const button = screen.getByRole('button', { name: 'Save changes' });
+ expect(button).toBe(ref.current);
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveAttribute('data-track', 'save');
+ expect(button).toHaveClass('border', 'h-10', 'host-button');
+
+ fireEvent.click(button);
+ expect(onClick).toHaveBeenCalledOnce();
+ });
+
+ it('preserves native disabled behavior', () => {
+ const onClick = vi.fn();
+ render(
+ <Button disabled onClick={onClick}>
+ Delete
+ </Button>,
+ );
+
+ const button = screen.getByRole('button', { name: 'Delete' });
+ expect(button).toBeDisabled();
+
+ fireEvent.click(button);
+ expect(onClick).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsx
new file mode 100644
index 000000000..07c1cabb7
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/CenteredModal.test.tsx
@@ -0,0 +1,162 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';
+
+const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');
+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');
+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {
+ this.open = true;
+});
+const close = vi.fn(function close(this: HTMLDialogElement) {
+ this.open = false;
+ this.dispatchEvent(new Event('close'));
+});
+
+beforeEach(() => {
+ showModal.mockClear();
+ close.mockClear();
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {
+ configurable: true,
+ value: showModal,
+ });
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {
+ configurable: true,
+ value: close,
+ });
+});
+
+afterEach(() => {
+ if (originalShowModal === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);
+ }
+ if (originalClose === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);
+ }
+});
+
+function getNativeDialog(container: HTMLElement) {
+ const dialog = container.querySelector('dialog');
+ if (dialog === null) {
+ throw new Error('Expected a native dialog');
+ }
+ return dialog;
+}
+
+describe('CenteredModal', () => {
+ it('synchronizes the controlled open state with the native dialog', () => {
+ const onOpenChange = vi.fn();
+ const view = render(
+ <CenteredModal open={false} onOpenChange={onOpenChange} title="Account">
+ Account body
+ </CenteredModal>,
+ );
+ const dialog = getNativeDialog(view.container);
+
+ expect(dialog).not.toHaveAttribute('open');
+ expect(showModal).not.toHaveBeenCalled();
+
+ view.rerender(
+ <CenteredModal open onOpenChange={onOpenChange} title="Account">
+ Account body
+ </CenteredModal>,
+ );
+ expect(dialog).toHaveAttribute('open');
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <CenteredModal open onOpenChange={onOpenChange} title="Account">
+ Account body
+ </CenteredModal>,
+ );
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <CenteredModal open={false} onOpenChange={onOpenChange} title="Account">
+ Account body
+ </CenteredModal>,
+ );
+ expect(dialog).not.toHaveAttribute('open');
+ expect(close).toHaveBeenCalledOnce();
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('reports native close, close-button, backdrop, and cancel requests', () => {
+ const onOpenChange = vi.fn();
+ const onParentCancel = vi.fn();
+ render(
+ <dialog open onCancel={onParentCancel}>
+ <CenteredModal open onOpenChange={onOpenChange} title="Account">
+ <button type="button">Inside action</button>
+ </CenteredModal>
+ </dialog>,
+ );
+ const dialog = screen.getByRole('dialog', { name: 'Account' });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Inside action' }));
+ expect(onOpenChange).not.toHaveBeenCalled();
+
+ fireEvent.click(dialog);
+ expect(onOpenChange).toHaveBeenLastCalledWith(false);
+
+ onOpenChange.mockClear();
+ fireEvent.click(screen.getByRole('button', { name: 'Close' }));
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+
+ onOpenChange.mockClear();
+ const cancelEvent = new Event('cancel', { bubbles: true, cancelable: true });
+ fireEvent(dialog, cancelEvent);
+ expect(cancelEvent.defaultPrevented).toBe(true);
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ expect(onParentCancel).not.toHaveBeenCalled();
+
+ onOpenChange.mockClear();
+ fireEvent(dialog, new Event('close'));
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('wires its title, optional description, icon, children, and accessible name', () => {
+ const { container } = render(
+ <CenteredModal
+ open
+ onOpenChange={() => undefined}
+ title="Account settings"
+ description="Manage your profile"
+ headerIcon={<span data-testid="header-icon">icon</span>}
+ aria-label="Account dialog"
+ contentSized
+ className="custom-modal"
+ >
+ <section>Modal content</section>
+ </CenteredModal>,
+ );
+ const dialog = getNativeDialog(container);
+ const title = screen.getByRole('heading', { name: 'Account settings' });
+ const description = screen.getByText('Manage your profile');
+
+ expect(dialog).toHaveAttribute('aria-label', 'Account dialog');
+ expect(dialog).toHaveAttribute('aria-labelledby', title.id);
+ expect(dialog).toHaveAttribute('aria-describedby', description.id);
+ expect(dialog).toHaveClass('custom-modal');
+ expect(dialog).toHaveStyle({ height: 'fit-content', maxHeight: '85dvh' });
+ expect(screen.getByTestId('header-icon')).toBeInTheDocument();
+ expect(screen.getByText('Modal content')).toBeInTheDocument();
+ });
+
+ it('uses the title as the label and omits description wiring when absent', () => {
+ render(
+ <CenteredModal open onOpenChange={() => undefined} title="Untitled description">
+ Body
+ </CenteredModal>,
+ );
+
+ const dialog = screen.getByRole('dialog', { name: 'Untitled description' });
+ expect(dialog).toHaveAttribute('aria-label', 'Untitled description');
+ expect(dialog).not.toHaveAttribute('aria-describedby');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsx
new file mode 100644
index 000000000..cd6ac5c61
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Dialog.test.tsx
@@ -0,0 +1,245 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle, Modal } from '@/atoms/primitives/Dialog.js';
+
+const originalShowModal = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'showModal');
+const originalClose = Object.getOwnPropertyDescriptor(HTMLDialogElement.prototype, 'close');
+const showModal = vi.fn(function showModal(this: HTMLDialogElement) {
+ this.open = true;
+});
+const close = vi.fn(function close(this: HTMLDialogElement) {
+ this.open = false;
+ this.dispatchEvent(new Event('close'));
+});
+
+beforeEach(() => {
+ showModal.mockClear();
+ close.mockClear();
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', {
+ configurable: true,
+ value: showModal,
+ });
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', {
+ configurable: true,
+ value: close,
+ });
+});
+
+afterEach(() => {
+ if (originalShowModal === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'showModal');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'showModal', originalShowModal);
+ }
+ if (originalClose === undefined) {
+ Reflect.deleteProperty(HTMLDialogElement.prototype, 'close');
+ } else {
+ Object.defineProperty(HTMLDialogElement.prototype, 'close', originalClose);
+ }
+});
+
+function getNativeDialog(container: HTMLElement) {
+ const dialog = container.querySelector('dialog');
+ if (dialog === null) {
+ throw new Error('Expected a native dialog');
+ }
+ return dialog;
+}
+
+describe('Dialog', () => {
+ it('synchronizes the controlled open state and reports native close events', () => {
+ const onOpenChange = vi.fn();
+ const view = render(
+ <Dialog open={false} onOpenChange={onOpenChange} aria-label="Settings">
+ Dialog body
+ </Dialog>,
+ );
+ const dialog = getNativeDialog(view.container);
+
+ expect(dialog).not.toHaveAttribute('open');
+ expect(showModal).not.toHaveBeenCalled();
+
+ view.rerender(
+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">
+ Dialog body
+ </Dialog>,
+ );
+ expect(dialog).toHaveAttribute('open');
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">
+ Dialog body
+ </Dialog>,
+ );
+ expect(showModal).toHaveBeenCalledOnce();
+
+ view.rerender(
+ <Dialog open={false} onOpenChange={onOpenChange} aria-label="Settings">
+ Dialog body
+ </Dialog>,
+ );
+ expect(dialog).not.toHaveAttribute('open');
+ expect(close).toHaveBeenCalledOnce();
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+
+ onOpenChange.mockClear();
+ fireEvent(dialog, new Event('close'));
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('requests closure only when the dialog backdrop itself is clicked', () => {
+ const onOpenChange = vi.fn();
+ const { container } = render(
+ <Dialog open onOpenChange={onOpenChange} aria-label="Settings">
+ <button type="button">Keep editing</button>
+ </Dialog>,
+ );
+ const dialog = getNativeDialog(container);
+
+ fireEvent.click(screen.getByRole('button', { name: 'Keep editing' }));
+ expect(onOpenChange).not.toHaveBeenCalled();
+
+ fireEvent.click(dialog);
+ expect(onOpenChange).toHaveBeenCalledOnce();
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ });
+
+ it('forwards accessibility attributes, custom classes, and children', () => {
+ render(
+ <>
+ <h1 id="settings-title">Workspace settings</h1>
+ <Dialog
+ open
+ onOpenChange={() => undefined}
+ aria-label="Settings fallback"
+ aria-labelledby="settings-title"
+ className="custom-dialog"
+ >
+ <span>Dialog child</span>
+ </Dialog>
+ </>,
+ );
+
+ const dialog = screen.getByRole('dialog', { name: 'Workspace settings' });
+ expect(dialog).toHaveAttribute('aria-label', 'Settings fallback');
+ expect(dialog).toHaveAttribute('aria-labelledby', 'settings-title');
+ expect(dialog).toHaveClass('custom-dialog');
+ expect(screen.getByText('Dialog child')).toBeInTheDocument();
+ });
+});
+
+describe('Dialog subcomponents', () => {
+ it('renders semantic children and forwards HTML attributes', () => {
+ render(
+ <DialogContent className="content-class" data-testid="content">
+ <DialogHeader className="header-class" data-testid="header">
+ <DialogTitle className="title-class" id="subcomponent-title" data-state="ready">
+ Confirm action
+ </DialogTitle>
+ </DialogHeader>
+ <DialogFooter className="footer-class" data-testid="footer">
+ <button type="button">Confirm</button>
+ </DialogFooter>
+ </DialogContent>,
+ );
+
+ expect(screen.getByTestId('content')).toHaveClass('content-class');
+ expect(screen.getByTestId('header')).toHaveClass('header-class');
+ expect(screen.getByRole('heading', { name: 'Confirm action', level: 2 })).toHaveClass('title-class');
+ expect(screen.getByRole('heading', { name: 'Confirm action' })).toHaveAttribute('data-state', 'ready');
+ expect(screen.getByTestId('footer')).toHaveClass('footer-class');
+ expect(screen.getByRole('button', { name: 'Confirm' })).toBeInTheDocument();
+ });
+});
+
+describe('Modal', () => {
+ it('renders accessible content and closes only from backdrop or Escape', () => {
+ const onClose = vi.fn();
+ const escapeEvent = new KeyboardEvent('keydown', {
+ key: 'Escape',
+ bubbles: true,
+ cancelable: true,
+ });
+ const { container } = render(
+ <Modal open onClose={onClose} aria-label="Legacy settings">
+ <button type="button">Inside legacy modal</button>
+ </Modal>,
+ );
+ const dialog = screen.getByRole('dialog', { name: 'Legacy settings' });
+ const backdrop = container.querySelector('[role="presentation"]');
+ if (backdrop === null) {
+ throw new Error('Expected the modal backdrop');
+ }
+
+ expect(dialog).toHaveAttribute('aria-modal', 'true');
+ fireEvent.click(dialog);
+ expect(onClose).not.toHaveBeenCalled();
+
+ fireEvent.click(backdrop);
+ expect(onClose).toHaveBeenCalledOnce();
+
+ onClose.mockClear();
+ fireEvent(document, escapeEvent);
+ expect(escapeEvent.defaultPrevented).toBe(true);
+ expect(onClose).toHaveBeenCalledOnce();
+ });
+
+ it('focuses the first control, traps Tab, and restores prior focus on close', () => {
+ const onClose = vi.fn();
+ const view = render(
+ <>
+ <button type="button">Open legacy modal</button>
+ <Modal open={false} onClose={onClose} aria-label="Legacy settings">
+ <button type="button">First control</button>
+ <button type="button" disabled>
+ Disabled control
+ </button>
+ <a href="#last">Last control</a>
+ </Modal>
+ </>,
+ );
+ const trigger = screen.getByRole('button', { name: 'Open legacy modal' });
+ trigger.focus();
+
+ view.rerender(
+ <>
+ <button type="button">Open legacy modal</button>
+ <Modal open onClose={onClose} aria-label="Legacy settings">
+ <button type="button">First control</button>
+ <button type="button" disabled>
+ Disabled control
+ </button>
+ <a href="#last">Last control</a>
+ </Modal>
+ </>,
+ );
+ const first = screen.getByRole('button', { name: 'First control' });
+ const last = screen.getByRole('link', { name: 'Last control' });
+ expect(first).toHaveFocus();
+
+ last.focus();
+ fireEvent.keyDown(document, { key: 'Tab' });
+ expect(first).toHaveFocus();
+
+ first.focus();
+ fireEvent.keyDown(document, { key: 'Tab', shiftKey: true });
+ expect(last).toHaveFocus();
+
+ view.rerender(
+ <>
+ <button type="button">Open legacy modal</button>
+ <Modal open={false} onClose={onClose} aria-label="Legacy settings">
+ <button type="button">First control</button>
+ <button type="button" disabled>
+ Disabled control
+ </button>
+ <a href="#last">Last control</a>
+ </Modal>
+ </>,
+ );
+ expect(trigger).toHaveFocus();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsx
new file mode 100644
index 000000000..99e580eb1
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/DropdownMenu.test.tsx
@@ -0,0 +1,118 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { DropdownMenu, DropdownMenuItem, DropdownMenuSeparator } from '@/atoms/primitives/DropdownMenu.js';
+
+describe('DropdownMenu', () => {
+ it('opens and closes from clicks, menu selection, and outside interaction', () => {
+ const onTriggerClick = vi.fn();
+ const onSelect = vi.fn();
+
+ render(
+ <div>
+ <DropdownMenu trigger={<button onClick={onTriggerClick}>Actions</button>} className="host-menu">
+ <DropdownMenuItem onClick={onSelect}>Rename</DropdownMenuItem>
+ </DropdownMenu>
+ <button>Outside</button>
+ </div>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Actions' });
+ expect(trigger).toHaveAttribute('aria-haspopup', 'menu');
+ expect(trigger).toHaveAttribute('aria-expanded', 'false');
+ expect(trigger).not.toHaveAttribute('aria-controls');
+
+ fireEvent.click(trigger);
+
+ const menu = screen.getByRole('menu');
+ expect(onTriggerClick).toHaveBeenCalledOnce();
+ expect(trigger).toHaveAttribute('aria-expanded', 'true');
+ expect(trigger).toHaveAttribute('aria-controls', menu.id);
+ expect(menu).toHaveClass('host-menu');
+
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Rename' }));
+
+ expect(onSelect).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();
+ expect(trigger).toHaveAttribute('aria-expanded', 'false');
+
+ fireEvent.click(trigger);
+ expect(screen.getByRole('menu')).toBeInTheDocument();
+
+ fireEvent.mouseDown(screen.getByRole('button', { name: 'Outside' }));
+
+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();
+ });
+
+ it('merges trigger keyboard handling and manages focus across enabled items', () => {
+ const onTriggerKeyDown = vi.fn();
+ const onDisabledClick = vi.fn();
+
+ render(
+ <DropdownMenu
+ trigger={
+ <button data-host-trigger="true" onKeyDown={onTriggerKeyDown}>
+ Actions
+ </button>
+ }
+ >
+ <DropdownMenuItem data-item-id="first">First</DropdownMenuItem>
+ <DropdownMenuItem disabled onClick={onDisabledClick}>
+ Disabled
+ </DropdownMenuItem>
+ <DropdownMenuItem data-item-id="last">Last</DropdownMenuItem>
+ </DropdownMenu>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Actions' });
+ expect(trigger).toHaveAttribute('data-host-trigger', 'true');
+
+ trigger.focus();
+ fireEvent.keyDown(trigger, { key: 'Enter' });
+
+ expect(onTriggerKeyDown).toHaveBeenCalledOnce();
+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();
+
+ const disabled = screen.getByRole('menuitem', { name: 'Disabled' });
+ expect(disabled).toBeDisabled();
+
+ fireEvent.keyDown(document, { key: 'ArrowDown' });
+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();
+
+ fireEvent.keyDown(document, { key: 'ArrowDown' });
+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();
+
+ fireEvent.keyDown(document, { key: 'End' });
+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();
+
+ fireEvent.keyDown(document, { key: 'Home' });
+ expect(screen.getByRole('menuitem', { name: 'First' })).toHaveFocus();
+
+ fireEvent.keyDown(document, { key: 'ArrowUp' });
+ expect(screen.getByRole('menuitem', { name: 'Last' })).toHaveFocus();
+
+ fireEvent.keyDown(document, { key: 'Escape' });
+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();
+ expect(trigger).toHaveFocus();
+
+ fireEvent.click(trigger);
+ fireEvent.click(screen.getByRole('menuitem', { name: 'Disabled' }));
+ expect(onDisabledClick).not.toHaveBeenCalled();
+ });
+
+ it('forwards item and separator host attributes', () => {
+ render(
+ <DropdownMenu trigger={<button>Actions</button>}>
+ <DropdownMenuItem name="rename" aria-label="Rename item">
+ Rename
+ </DropdownMenuItem>
+ <DropdownMenuSeparator data-divider="actions" aria-label="More actions" />
+ </DropdownMenu>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Actions' }));
+
+ expect(screen.getByRole('menuitem', { name: 'Rename item' })).toHaveAttribute('name', 'rename');
+ expect(screen.getByRole('separator', { name: 'More actions' })).toHaveAttribute('data-divider', 'actions');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsx
new file mode 100644
index 000000000..34fa6466a
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/IconButton.test.tsx
@@ -0,0 +1,46 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { IconButton } from '@/atoms/primitives/IconButton.js';
+
+describe('IconButton', () => {
+ it('uses its label and tooltip accessibly while forwarding button behavior and its ref', () => {
+ const ref = createRef<HTMLButtonElement>();
+ const onClick = vi.fn();
+ render(
+ <IconButton
+ ref={ref}
+ type="button"
+ aria-label="Open settings"
+ tooltip="Settings"
+ variant="ghost"
+ className="host-icon-button"
+ data-track="settings"
+ onClick={onClick}
+ >
+ <span aria-hidden="true">⚙</span>
+ </IconButton>,
+ );
+
+ const button = screen.getByRole('button', { name: 'Open settings' });
+ expect(button).toBe(ref.current);
+ expect(button).toHaveAttribute('title', 'Settings');
+ expect(button).toHaveAttribute('type', 'button');
+ expect(button).toHaveAttribute('data-track', 'settings');
+ expect(button).toHaveClass('h-8', 'w-8', 'host-icon-button');
+
+ fireEvent.click(button);
+ expect(onClick).toHaveBeenCalledOnce();
+ });
+
+ it('does not add an empty title when no tooltip is provided', () => {
+ render(
+ <IconButton aria-label="Close">
+ <span aria-hidden="true">×</span>
+ </IconButton>,
+ );
+
+ expect(screen.getByRole('button', { name: 'Close' })).not.toHaveAttribute('title');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsx
new file mode 100644
index 000000000..6d82cd3bf
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/SearchInput.test.tsx
@@ -0,0 +1,33 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import SearchInput from '@/atoms/primitives/SearchInput.js';
+
+describe('SearchInput', () => {
+ it('renders an accessible focused search control with its default placeholder', () => {
+ render(<SearchInput query="" setQuery={vi.fn()} />);
+
+ const input = screen.getByRole('searchbox');
+ expect(input).toHaveAttribute('type', 'search');
+ expect(input).toHaveAttribute('placeholder', 'Search');
+ expect(input).toHaveFocus();
+ });
+
+ it('reports user changes and reflects controlled query updates', () => {
+ const setQuery = vi.fn();
+ const { rerender } = render(<SearchInput query="initial" setQuery={setQuery} placeholder="Find agents" />);
+
+ const input = screen.getByRole('searchbox');
+ expect(input).toHaveValue('initial');
+ expect(input).toHaveAttribute('placeholder', 'Find agents');
+
+ fireEvent.change(input, { target: { value: 'updated' } });
+
+ expect(setQuery).toHaveBeenCalledOnce();
+ expect(setQuery).toHaveBeenCalledWith('updated');
+
+ rerender(<SearchInput query="updated" setQuery={setQuery} placeholder="Find agents" />);
+
+ expect(screen.getByRole('searchbox')).toHaveValue('updated');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsx
new file mode 100644
index 000000000..1219be303
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Skeleton.test.tsx
@@ -0,0 +1,30 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { Skeleton } from '@/atoms/primitives/Skeleton.js';
+
+describe('Skeleton', () => {
+ it('renders host content and forwards attributes, styles, classes, and callbacks', () => {
+ const onAnimationEnd = vi.fn();
+ render(
+ <Skeleton
+ aria-label="Loading profile"
+ className="host-skeleton"
+ data-track="profile"
+ style={{ width: 120 }}
+ onAnimationEnd={onAnimationEnd}
+ >
+ <span>Placeholder</span>
+ </Skeleton>,
+ );
+
+ const skeleton = screen.getByLabelText('Loading profile');
+ expect(skeleton).toHaveTextContent('Placeholder');
+ expect(skeleton).toHaveAttribute('data-track', 'profile');
+ expect(skeleton).toHaveStyle({ width: '120px' });
+ expect(skeleton).toHaveClass('animate-pulse', 'rounded-md', 'bg-muted', 'host-skeleton');
+
+ fireEvent.animationEnd(skeleton);
+ expect(onAnimationEnd).toHaveBeenCalledOnce();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsx
new file mode 100644
index 000000000..304bb3e25
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Spinner.test.tsx
@@ -0,0 +1,37 @@
+import { render, screen } from '@testing-library/react';
+import { createRef } from 'react';
+import { describe, expect, it } from 'vitest';
+
+import { Spinner } from '@/atoms/primitives/Spinner.js';
+
+describe('Spinner', () => {
+ it('provides an accessible default loading indicator', () => {
+ render(<Spinner />);
+
+ const spinner = screen.getByRole('status', { name: 'Loading' });
+ expect(spinner).toHaveAttribute('width', '16');
+ expect(spinner).toHaveAttribute('height', '16');
+ expect(spinner).toHaveAttribute('viewBox', '0 0 16 16');
+ expect(spinner).toHaveClass('animate-spin');
+ });
+
+ it('derives its geometry from size and forwards SVG props and its ref', () => {
+ const ref = createRef<SVGSVGElement>();
+ render(
+ <Spinner ref={ref} size={24} aria-label="Saving" className="host-spinner" data-track="save" strokeWidth={4} />,
+ );
+
+ const spinner = screen.getByRole('status', { name: 'Saving' });
+ const circle = spinner.querySelector('circle');
+ expect(spinner).toBe(ref.current);
+ expect(spinner).toHaveAttribute('width', '24');
+ expect(spinner).toHaveAttribute('height', '24');
+ expect(spinner).toHaveAttribute('viewBox', '0 0 24 24');
+ expect(spinner).toHaveAttribute('data-track', 'save');
+ expect(spinner).toHaveAttribute('stroke-width', '4');
+ expect(spinner).toHaveClass('animate-spin', 'host-spinner');
+ expect(circle).toHaveAttribute('cx', '12');
+ expect(circle).toHaveAttribute('cy', '12');
+ expect(circle).toHaveAttribute('r', '9');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx
new file mode 100644
index 000000000..1114c0a6b
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx
@@ -0,0 +1,94 @@
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { LightTooltip, Tooltip } from '@/atoms/primitives/Tooltip.js';
+
+describe('Tooltip', () => {
+ it('shows and hides on hover while merging the child callbacks', () => {
+ const onMouseEnter = vi.fn();
+ const onMouseLeave = vi.fn();
+
+ render(
+ <Tooltip content="Copy message" className="host-tooltip">
+ <button onMouseEnter={onMouseEnter} onMouseLeave={onMouseLeave}>
+ Copy
+ </button>
+ </Tooltip>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Copy' });
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+
+ fireEvent.mouseEnter(trigger);
+
+ expect(onMouseEnter).toHaveBeenCalledOnce();
+ expect(screen.getByRole('tooltip')).toHaveTextContent('Copy message');
+ expect(screen.getByRole('tooltip')).toHaveClass('host-tooltip');
+
+ fireEvent.mouseLeave(trigger);
+
+ expect(onMouseLeave).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
+
+ it('shows and hides on keyboard focus while merging the child callbacks', () => {
+ const onFocus = vi.fn();
+ const onBlur = vi.fn();
+
+ render(
+ <Tooltip content="Open settings">
+ <button onFocus={onFocus} onBlur={onBlur}>
+ Settings
+ </button>
+ </Tooltip>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Settings' });
+ act(() => trigger.focus());
+
+ expect(onFocus).toHaveBeenCalledOnce();
+ expect(trigger).toHaveFocus();
+ expect(screen.getByRole('tooltip')).toHaveAccessibleName('Open settings');
+
+ act(() => trigger.blur());
+
+ expect(onBlur).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
+
+ it('preserves child attributes and disabled behavior', () => {
+ const onClick = vi.fn();
+
+ render(
+ <Tooltip content="Unavailable">
+ <button disabled data-action="archive" onClick={onClick}>
+ Archive
+ </button>
+ </Tooltip>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Archive' });
+ expect(trigger).toBeDisabled();
+ expect(trigger).toHaveAttribute('data-action', 'archive');
+
+ fireEvent.click(trigger);
+
+ expect(onClick).not.toHaveBeenCalled();
+ });
+});
+
+describe('LightTooltip', () => {
+ it('forwards its title and tooltip attributes', () => {
+ render(
+ <LightTooltip title="Light help" className="host-light-tooltip" size="small">
+ <button>Help</button>
+ </LightTooltip>,
+ );
+
+ fireEvent.focus(screen.getByRole('button', { name: 'Help' }));
+
+ const tooltip = screen.getByRole('tooltip');
+ expect(tooltip).toHaveTextContent('Light help');
+ expect(tooltip).toHaveClass('host-light-tooltip');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsx
new file mode 100644
index 000000000..b5e02cdff
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/AgentStepsContainer.test.tsx
@@ -0,0 +1,66 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import type { AgentStepsCardProps } from '@/atoms/adapters/AgentStepsCardAdapter.js';
+import { AgentStepsContainer } from '@/containers/AgentStepsContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function AgentStepsCardProbe({ toolCount, thinkingCount, expanded, onToggle, children }: AgentStepsCardProps) {
+ return (
+ <section
+ data-testid="agent-steps-probe"
+ data-tool-count={toolCount}
+ data-thinking-count={thinkingCount}
+ data-expanded={String(expanded)}
+ >
+ <button type="button" onClick={onToggle}>
+ Toggle steps
+ </button>
+ {expanded ? children : null}
+ </section>
+ );
+}
+
+function TestSubject({ hasFinal }: { hasFinal: boolean }) {
+ return (
+ <SlotsProvider overrides={{ AgentStepsCard: AgentStepsCardProbe }}>
+ <AgentStepsContainer toolCount={2} thinkingCount={3} hasFinal={hasFinal}>
+ <div>step details</div>
+ </AgentStepsContainer>
+ </SlotsProvider>
+ );
+}
+
+describe('AgentStepsContainer', () => {
+ it('maps counts and toggles its initially expanded children', () => {
+ render(<TestSubject hasFinal={false} />);
+
+ const probe = screen.getByTestId('agent-steps-probe');
+ expect(probe).toHaveAttribute('data-tool-count', '2');
+ expect(probe).toHaveAttribute('data-thinking-count', '3');
+ expect(probe).toHaveAttribute('data-expanded', 'true');
+ expect(screen.getByText('step details')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Toggle steps' }));
+
+ expect(probe).toHaveAttribute('data-expanded', 'false');
+ expect(screen.queryByText('step details')).not.toBeInTheDocument();
+ });
+
+ it('auto-collapses once when a final answer appears and still allows manual expansion', async () => {
+ const { rerender } = render(<TestSubject hasFinal={false} />);
+
+ rerender(<TestSubject hasFinal />);
+
+ await waitFor(() => {
+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'false');
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Toggle steps' }));
+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'true');
+
+ rerender(<TestSubject hasFinal />);
+ expect(screen.getByTestId('agent-steps-probe')).toHaveAttribute('data-expanded', 'true');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsx
new file mode 100644
index 000000000..a7b84364c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/AskUserContainer.test.tsx
@@ -0,0 +1,159 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { ASK_USER_CUSTOM_OPTION, type AskUserPromptProps } from '@/atoms/adapters/AskUserPromptAdapter.js';
+import { AskUserContainer } from '@/containers/AskUserContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+const useToolResponses = vi.hoisted(() => vi.fn());
+const useThreadRunning = vi.hoisted(() => vi.fn());
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryToolResponses: () => useToolResponses(),
+}));
+
+vi.mock('@assistant-ui/core/react', () => ({
+ useThreadIsRunning: () => useThreadRunning(),
+}));
+
+function AskUserPromptProbe({
+ currentQuestion,
+ currentAnswer,
+ readOnly,
+ isSubmitDisabled,
+ isSubmitAllDisabled,
+ allQuestionsAnswered,
+ onCurrentAnswerChange,
+ onSubmit,
+}: AskUserPromptProps) {
+ return (
+ <section
+ data-testid="ask-user-probe"
+ data-question={currentQuestion?.question}
+ data-options={currentQuestion?.options.join('|')}
+ data-read-only={String(readOnly)}
+ data-answer={currentAnswer?.radioValue}
+ data-custom={currentAnswer?.custom}
+ data-all-answered={String(allQuestionsAnswered)}
+ >
+ <button
+ type="button"
+ disabled={readOnly}
+ onClick={() => {
+ if (currentQuestion !== undefined) {
+ onCurrentAnswerChange?.(currentQuestion.id, { radioValue: 'Proceed' });
+ }
+ }}
+ >
+ Choose Proceed
+ </button>
+ <input
+ aria-label="Custom response"
+ disabled={readOnly}
+ value={currentAnswer?.custom ?? ''}
+ onChange={event => {
+ if (currentQuestion !== undefined) {
+ onCurrentAnswerChange?.(currentQuestion.id, {
+ radioValue: ASK_USER_CUSTOM_OPTION,
+ custom: event.target.value,
+ });
+ }
+ }}
+ />
+ <button type="button" disabled={isSubmitDisabled || isSubmitAllDisabled} onClick={onSubmit}>
+ Submit response
+ </button>
+ </section>
+ );
+}
+
+function renderSubject() {
+ return render(
+ <SlotsProvider overrides={{ AskUserPrompt: AskUserPromptProbe }}>
+ <AskUserContainer />
+ </SlotsProvider>,
+ );
+}
+
+describe('AskUserContainer', () => {
+ const respond = vi.fn();
+
+ beforeEach(() => {
+ vi.clearAllMocks();
+ useThreadRunning.mockReturnValue(false);
+ useToolResponses.mockReturnValue({ pending: [], respond });
+ });
+
+ it('renders nothing while there is no pending question', () => {
+ renderSubject();
+
+ expect(screen.queryByTestId('ask-user-probe')).not.toBeInTheDocument();
+ });
+
+ it('maps the first pending question and submits the selected option', () => {
+ useToolResponses.mockReturnValue({
+ pending: [{ toolCallId: 'question-1', question: 'Continue?', options: ['Proceed', 'Stop'] }],
+ respond,
+ });
+ renderSubject();
+
+ const probe = screen.getByTestId('ask-user-probe');
+ expect(probe).toHaveAttribute('data-question', 'Continue?');
+ expect(probe).toHaveAttribute('data-options', 'Proceed|Stop');
+ expect(probe).toHaveAttribute('data-all-answered', 'false');
+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Choose Proceed' }));
+
+ expect(probe).toHaveAttribute('data-answer', 'Proceed');
+ expect(probe).toHaveAttribute('data-all-answered', 'true');
+ fireEvent.click(screen.getByRole('button', { name: 'Submit response' }));
+ expect(respond).toHaveBeenCalledWith({ toolCallId: 'question-1', content: 'Proceed' });
+ });
+
+ it('trims a custom response and resets draft state for the next pending tool call', () => {
+ useToolResponses.mockReturnValue({
+ pending: [{ toolCallId: 'question-1', question: 'Why?', options: [] }],
+ respond,
+ });
+ const { rerender } = renderSubject();
+
+ fireEvent.change(screen.getByRole('textbox', { name: 'Custom response' }), {
+ target: { value: ' because it is safer ' },
+ });
+ fireEvent.click(screen.getByRole('button', { name: 'Submit response' }));
+ expect(respond).toHaveBeenCalledWith({
+ toolCallId: 'question-1',
+ content: 'because it is safer',
+ });
+
+ useToolResponses.mockReturnValue({
+ pending: [{ toolCallId: 'question-2', question: undefined, options: undefined }],
+ respond,
+ });
+ rerender(
+ <SlotsProvider overrides={{ AskUserPrompt: AskUserPromptProbe }}>
+ <AskUserContainer />
+ </SlotsProvider>,
+ );
+
+ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-question', 'Answer required');
+ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-answer', '');
+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();
+ });
+
+ it('maps a running thread to read-only pending state', () => {
+ useThreadRunning.mockReturnValue(true);
+ useToolResponses.mockReturnValue({
+ pending: [{ toolCallId: 'question-1', question: 'Continue?', options: ['Proceed'] }],
+ respond,
+ });
+ renderSubject();
+
+ expect(screen.getByTestId('ask-user-probe')).toHaveAttribute('data-read-only', 'true');
+ expect(screen.getByRole('button', { name: 'Choose Proceed' })).toBeDisabled();
+ expect(screen.getByRole('textbox', { name: 'Custom response' })).toBeDisabled();
+ expect(screen.getByRole('button', { name: 'Submit response' })).toBeDisabled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsx
similarity index 96%
rename from packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsx
index ae2a66049..fa2744388 100644
--- a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/AssistantMessageContainer.test.tsx
@@ -3,7 +3,7 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
import { render, screen } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
-import { AssistantMessageContainer } from './AssistantMessageContainer.js';
+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';
import { RuntimeHarness } from './RuntimeHarness.js';
function renderAssistantMessage(messages: ThreadMessageLike[], options?: { isRunning?: boolean }) {
diff --git a/packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsx
similarity index 86%
rename from packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsx
index 04cb45d48..7f725e69a 100644
--- a/packages/trueforge-ui-sdk/src/containers/AssistantTextContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/AssistantTextContainer.test.tsx
@@ -9,9 +9,9 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { trueFoundryExtras } from '@truefoundry/assistant-ui-runtime';
import { describe, expect, it, vi } from 'vitest';
-import type { MarkdownProps } from '../atoms/Markdown.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { AssistantMessageContainer } from './AssistantMessageContainer.js';
+import type { MarkdownProps } from '@/atoms/Markdown.js';
+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
import { RuntimeHarness } from './RuntimeHarness.js';
function renderAssistantMessage(messages: ThreadMessageLike[]) {
@@ -67,6 +67,7 @@ describe('AssistantTextContainer', () => {
it('downloads an artifact through the turn that produced the message', async () => {
const downloadSandboxFile = vi.fn(async () => new Blob(['hello harness']));
+ const anchorClick = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => {});
function ExtrasHarness() {
const runtime = useExternalStoreRuntime({
@@ -106,12 +107,16 @@ describe('AssistantTextContainer', () => {
);
}
- render(<ExtrasHarness />);
+ try {
+ render(<ExtrasHarness />);
- fireEvent.click(await screen.findByText('report.txt'));
+ fireEvent.click(await screen.findByText('report.txt'));
- await waitFor(() => {
- expect(downloadSandboxFile).toHaveBeenCalledWith({ turnId: 'turn-42', path: '/tmp/report.txt' });
- });
+ await waitFor(() => {
+ expect(downloadSandboxFile).toHaveBeenCalledWith({ turnId: 'turn-42', path: '/tmp/report.txt' });
+ });
+ } finally {
+ anchorClick.mockRestore();
+ }
});
});
diff --git a/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsx
new file mode 100644
index 000000000..d58a46e6f
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/AttachmentsContainer.test.tsx
@@ -0,0 +1,187 @@
+// @vitest-environment jsdom
+import {
+ AssistantRuntimeProvider,
+ ThreadPrimitive,
+ useExternalStoreRuntime,
+ type AttachmentAdapter,
+ type PendingAttachment,
+ type ThreadMessageLike,
+} from '@assistant-ui/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import type { ReactNode } from 'react';
+import { beforeAll, describe, expect, it, vi } from 'vitest';
+
+import type { AttachmentPickerButtonProps } from '@/atoms/AttachmentPickerButton.js';
+import type { AttachmentPreviewDialogProps } from '@/atoms/AttachmentPreviewDialog.js';
+import {
+ ComposerAttachmentPickerContainer,
+ ComposerAttachmentsContainer,
+ MessageAttachmentsContainer,
+} from '@/containers/AttachmentsContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { RuntimeHarness } from './RuntimeHarness.js';
+
+beforeAll(() => {
+ Object.defineProperty(URL, 'createObjectURL', {
+ configurable: true,
+ value: vi.fn(() => 'blob:composer-preview'),
+ });
+ Object.defineProperty(URL, 'revokeObjectURL', {
+ configurable: true,
+ value: vi.fn(),
+ });
+ HTMLDialogElement.prototype.showModal = function showModal() {
+ this.setAttribute('open', '');
+ };
+ HTMLDialogElement.prototype.close = function close() {
+ this.removeAttribute('open');
+ this.dispatchEvent(new Event('close'));
+ };
+});
+
+function createAttachmentAdapter(remove: AttachmentAdapter['remove']): AttachmentAdapter {
+ return {
+ accept: 'image/*,.pdf',
+ add: async ({ file }) => ({
+ id: `pending-${file.name}`,
+ type: file.type.startsWith('image/') ? 'image' : 'file',
+ name: file.name,
+ contentType: file.type,
+ file,
+ status: { type: 'requires-action', reason: 'composer-send' },
+ }),
+ remove,
+ send: async (attachment: PendingAttachment) => ({
+ ...attachment,
+ status: { type: 'complete' },
+ content: [
+ {
+ type: 'file',
+ data: 'data:application/octet-stream;base64,AA==',
+ mimeType: attachment.contentType ?? 'application/octet-stream',
+ filename: attachment.name,
+ },
+ ],
+ }),
+ };
+}
+
+function AttachmentRuntimeHarness({ adapter, children }: { adapter: AttachmentAdapter; children: ReactNode }) {
+ const runtime = useExternalStoreRuntime<ThreadMessageLike>({
+ messages: [],
+ convertMessage: message => message,
+ onNew: async () => {},
+ adapters: { attachments: adapter },
+ });
+
+ return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;
+}
+
+function PickerOverride(props: AttachmentPickerButtonProps) {
+ return (
+ <button type="button" {...props}>
+ Choose attachment
+ </button>
+ );
+}
+
+function PreviewOverride({ previewSrc, children }: AttachmentPreviewDialogProps) {
+ return (
+ <div data-testid="attachment-preview-slot" data-preview-src={previewSrc}>
+ {children}
+ </div>
+ );
+}
+
+describe('attachment containers', () => {
+ it('uses the picker slot, stages a selected file, supplies its preview, and removes it', async () => {
+ const remove = vi.fn<AttachmentAdapter['remove']>(async () => {});
+ const adapter = createAttachmentAdapter(remove);
+
+ render(
+ <SlotsProvider
+ overrides={{
+ AttachmentPickerButton: PickerOverride,
+ AttachmentPreviewDialog: PreviewOverride,
+ }}
+ >
+ <AttachmentRuntimeHarness adapter={adapter}>
+ <ComposerAttachmentPickerContainer />
+ <ComposerAttachmentsContainer />
+ </AttachmentRuntimeHarness>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Choose attachment' }));
+ const input = document.querySelector<HTMLInputElement>('input[type="file"]');
+ expect(input).not.toBeNull();
+ if (input === null) {
+ throw new Error('Expected attachment file input');
+ }
+ expect(input).toHaveAttribute('accept', 'image/*,.pdf');
+
+ const file = new File(['image'], 'diagram.png', { type: 'image/png' });
+ fireEvent.change(input, { target: { files: [file] } });
+
+ expect(await screen.findByText('diagram.png')).toBeInTheDocument();
+ await waitFor(() => {
+ expect(screen.getByTestId('attachment-preview-slot')).toHaveAttribute(
+ 'data-preview-src',
+ 'blob:composer-preview',
+ );
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Remove file' }));
+
+ await waitFor(() => {
+ expect(screen.queryByText('diagram.png')).not.toBeInTheDocument();
+ });
+ expect(remove).toHaveBeenCalledTimes(1);
+ expect(remove.mock.calls[0]?.[0]).toMatchObject({
+ id: 'pending-diagram.png',
+ name: 'diagram.png',
+ contentType: 'image/png',
+ });
+ });
+
+ it('opens a full-size preview for a sent image attachment', () => {
+ render(
+ <RuntimeHarness
+ messages={[
+ {
+ role: 'user',
+ content: 'Please inspect this',
+ attachments: [
+ {
+ id: 'image-1',
+ type: 'image',
+ name: 'result.png',
+ contentType: 'image/png',
+ status: { type: 'complete' },
+ content: [
+ {
+ type: 'image',
+ image: 'data:image/png;base64,iVBORw0KGgo=',
+ filename: 'result.png',
+ },
+ ],
+ },
+ ],
+ },
+ ]}
+ >
+ <ThreadPrimitive.Messages>{() => <MessageAttachmentsContainer />}</ThreadPrimitive.Messages>
+ </RuntimeHarness>,
+ );
+
+ expect(screen.queryByRole('button', { name: 'Remove file' })).not.toBeInTheDocument();
+ fireEvent.click(screen.getByRole('button', { name: 'Open attachment preview' }));
+
+ const dialog = screen.getByRole('dialog', { name: 'Attachment preview' });
+ expect(dialog).toHaveAttribute('open');
+ expect(screen.getByRole('img', { name: 'Attachment preview' })).toHaveAttribute(
+ 'src',
+ 'data:image/png;base64,iVBORw0KGgo=',
+ );
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsx
similarity index 83%
rename from packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsx
index f5a569778..c54ba4c00 100644
--- a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/ComposerContainer.test.tsx
@@ -3,10 +3,10 @@ import type { AppendMessage } from '@assistant-ui/react';
import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import { ComposerBusyProvider } from '../hooks/useComposerBusyState.js';
-import { ShellModeProvider } from '../server/ShellModeContext.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
-import { ComposerContainer } from './ComposerContainer.js';
+import { ComposerContainer } from '@/containers/ComposerContainer.js';
+import { ComposerBusyProvider } from '@/hooks/useComposerBusyState.js';
+import { ShellModeProvider } from '@/server/ShellModeContext.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
import { RuntimeHarness } from './RuntimeHarness.js';
vi.mock('@truefoundry/assistant-ui-runtime', () => ({
@@ -36,13 +36,16 @@ describe('ComposerContainer', () => {
renderComposer();
const dropzone = document.querySelector('[data-slot="aui_composer-attachment-dropzone"]');
expect(dropzone).not.toBeNull();
- fireEvent.dragEnter(dropzone!);
+ if (dropzone === null) {
+ throw new Error('Expected attachment dropzone');
+ }
+ fireEvent.dragEnter(dropzone);
expect(dropzone).toHaveAttribute('data-dragging', 'true');
});
it('keeps the caret in place when text is inserted mid-string', () => {
renderComposer();
- const input = screen.getByRole('textbox', { name: 'Message input' }) as HTMLTextAreaElement;
+ const input = screen.getByRole<HTMLTextAreaElement>('textbox', { name: 'Message input' });
fireEvent.change(input, { target: { value: 'hello world' } });
fireEvent.change(input, {
@@ -56,7 +59,7 @@ describe('ComposerContainer', () => {
it('submits once on Enter and inserts a newline on Shift+Enter', async () => {
const onNew = vi.fn(async () => {});
renderComposer(onNew);
- const input = screen.getByRole('textbox', { name: 'Message input' }) as HTMLTextAreaElement;
+ const input = screen.getByRole<HTMLTextAreaElement>('textbox', { name: 'Message input' });
fireEvent.change(input, { target: { value: 'hi' } });
fireEvent.keyDown(input, { key: 'Enter', shiftKey: true });
diff --git a/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsx
new file mode 100644
index 000000000..ae23e897e
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/ErrorToasterContainer.test.tsx
@@ -0,0 +1,138 @@
+import { act, fireEvent, render, renderHook, screen, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { Toast } from '@/atoms/Toast.js';
+import { ErrorToasterProvider, useErrorToaster, useErrorToasterOptional } from '@/containers/ErrorToasterContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function Trigger({ errors }: { errors: unknown[] }) {
+ const { showError } = useErrorToaster();
+ return (
+ <button
+ type="button"
+ onClick={() => {
+ for (const error of errors) showError(error);
+ }}
+ >
+ boom
+ </button>
+ );
+}
+
+describe('ErrorToasterProvider', () => {
+ beforeEach(() => {
+ vi.spyOn(console, 'error').mockImplementation(() => {});
+ });
+
+ afterEach(() => {
+ vi.restoreAllMocks();
+ });
+
+ it('requires a provider for useErrorToaster while the optional hook returns null', () => {
+ expect(() => renderHook(() => useErrorToaster())).toThrow(
+ 'useErrorToaster must be used within ErrorToasterProvider',
+ );
+
+ const { result } = renderHook(() => useErrorToasterOptional());
+ expect(result.current).toBeNull();
+ });
+
+ it('stacks multiple error toasts', async () => {
+ render(
+ <SlotsProvider>
+ <ErrorToasterProvider>
+ <Trigger errors={[new Error('first'), new Error('second')]} />
+ </ErrorToasterProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'boom' }));
+
+ expect(await screen.findByText('first')).toBeTruthy();
+ expect(screen.getByText('second')).toBeTruthy();
+ expect(screen.getAllByRole('alert')).toHaveLength(2);
+ });
+
+ it('dismisses one toast without removing the other', async () => {
+ render(
+ <SlotsProvider>
+ <ErrorToasterProvider>
+ <Trigger errors={[new Error('keep-me'), new Error('drop-me')]} />
+ </ErrorToasterProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'boom' }));
+ expect(await screen.findByText('drop-me')).toBeTruthy();
+
+ const dropToast = screen.getByText('drop-me').closest("[role='alert']");
+ expect(dropToast).toBeTruthy();
+ const closeButton = dropToast?.querySelector('[aria-label="Close"]');
+ if (closeButton === null || closeButton === undefined) {
+ throw new Error('Expected close button');
+ }
+ fireEvent.click(closeButton);
+
+ await waitFor(() => {
+ expect(screen.queryByText('drop-me')).toBeNull();
+ });
+ expect(screen.getByText('keep-me')).toBeTruthy();
+ });
+
+ it('formats HTTP-like status and response body details', async () => {
+ const httpError = Object.assign(new Error('request failed'), {
+ statusCode: 422,
+ body: { detail: 'invalid agent' },
+ });
+
+ render(
+ <SlotsProvider>
+ <ErrorToasterProvider>
+ <Trigger errors={[httpError]} />
+ </ErrorToasterProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'boom' }));
+
+ expect(await screen.findByText('Request failed (422)')).toBeInTheDocument();
+ expect(screen.getByText(/"detail": "invalid agent"/)).toBeInTheDocument();
+ });
+
+ it('keeps only the five most recent errors visible', async () => {
+ const errors = Array.from({ length: 6 }, (_, index) => new Error(`error-${index + 1}`));
+
+ render(
+ <SlotsProvider>
+ <ErrorToasterProvider>
+ <Trigger errors={errors} />
+ </ErrorToasterProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'boom' }));
+
+ expect(await screen.findAllByRole('alert')).toHaveLength(5);
+ expect(screen.queryByText('error-1')).not.toBeInTheDocument();
+ expect(screen.getByText('error-6')).toBeInTheDocument();
+ });
+});
+
+describe('Toast copy', () => {
+ it('copies title and description', async () => {
+ const writeText = vi.fn().mockResolvedValue(undefined);
+ Object.assign(navigator, { clipboard: { writeText } });
+
+ render(
+ <SlotsProvider>
+ <Toast title="Request failed" description="body detail" open onOpenChange={() => {}} />
+ </SlotsProvider>,
+ );
+
+ await act(async () => {
+ fireEvent.click(screen.getByRole('button', { name: 'Copy' }));
+ });
+
+ expect(writeText).toHaveBeenCalledWith('Request failed\nbody detail');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsx
similarity index 92%
rename from packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsx
index 308dd1c0c..18e6bb94d 100644
--- a/packages/trueforge-ui-sdk/src/containers/HistoryLoaderContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/HistoryLoaderContainer.test.tsx
@@ -4,7 +4,7 @@ import { render, screen, waitFor } from '@testing-library/react';
import { trueFoundryExtras } from '@truefoundry/assistant-ui-runtime';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { HistoryLoaderContainer } from './HistoryLoaderContainer.js';
+import { HistoryLoaderContainer } from '@/containers/HistoryLoaderContainer.js';
type ObserverCallback = (entries: Array<{ isIntersecting: boolean }>) => void;
@@ -21,12 +21,11 @@ class IntersectionObserverStub {
beforeEach(() => {
observerCallbacks = [];
- globalThis.IntersectionObserver = IntersectionObserverStub as unknown as typeof IntersectionObserver;
+ vi.stubGlobal('IntersectionObserver', IntersectionObserverStub);
});
afterEach(() => {
- // @ts-expect-error jsdom has no IntersectionObserver; remove the stub.
- delete globalThis.IntersectionObserver;
+ vi.unstubAllGlobals();
});
function Harness({
diff --git a/packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsx
similarity index 91%
rename from packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsx
index 217cdadfd..007f18a20 100644
--- a/packages/trueforge-ui-sdk/src/containers/McpAuthContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/McpAuthContainer.test.tsx
@@ -4,7 +4,7 @@ import { fireEvent, render, screen } from '@testing-library/react';
import { trueFoundryExtras, type TrueFoundryRuntimeExtras } from '@truefoundry/assistant-ui-runtime';
import { describe, expect, it, vi } from 'vitest';
-import { McpAuthContainer } from './McpAuthContainer.js';
+import { McpAuthContainer } from '@/containers/McpAuthContainer.js';
const SERVERS = [
{ id: 'srv-1', name: 'github', authUrl: 'https://example.com/auth/github' },
@@ -68,8 +68,12 @@ describe('McpAuthContainer', () => {
const connectButtons = screen.getAllByRole('button', { name: /connect/i });
expect(connectButtons).toHaveLength(2);
- fireEvent.click(connectButtons[0]!);
- fireEvent.click(connectButtons[1]!);
+ const [githubButton, slackButton] = connectButtons;
+ if (githubButton === undefined || slackButton === undefined) {
+ throw new Error('Expected connector buttons');
+ }
+ fireEvent.click(githubButton);
+ fireEvent.click(slackButton);
expect(openSpy).toHaveBeenCalledWith('https://example.com/auth/github', '_blank', 'noopener,noreferrer');
expect(openSpy).toHaveBeenCalledWith('https://example.com/auth/slack', '_blank', 'noopener,noreferrer');
diff --git a/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsx b/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsx
new file mode 100644
index 000000000..8dcd5ae0d
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/McpOauthContainer/PostMcpOauthScreen.test.tsx
@@ -0,0 +1,110 @@
+// @vitest-environment jsdom
+import { act, cleanup, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import PostMcpOauthScreen from '@/containers/McpOauthContainer/PostMcpOauthScreen.js';
+import { MCP_AUTH_POPUP_CHANNEL } from '@/hooks/useMcpAuth.js';
+
+const channels: BroadcastChannelStub[] = [];
+
+class BroadcastChannelStub {
+ readonly name: string;
+ readonly postMessage = vi.fn();
+ readonly close = vi.fn();
+
+ constructor(name: string) {
+ this.name = name;
+ channels.push(this);
+ }
+}
+
+describe('PostMcpOauthScreen', () => {
+ beforeEach(() => {
+ vi.useFakeTimers();
+ channels.length = 0;
+ vi.stubGlobal('BroadcastChannel', BroadcastChannelStub);
+ vi.spyOn(window, 'close').mockImplementation(() => {});
+ window.history.replaceState({}, '', '/oauth/callback');
+ });
+
+ afterEach(() => {
+ cleanup();
+ vi.clearAllTimers();
+ vi.useRealTimers();
+ vi.restoreAllMocks();
+ vi.unstubAllGlobals();
+ });
+
+ it('reads a successful result from the URL and broadcasts it immediately and once more', () => {
+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-123&isSuccess=TrUe');
+
+ render(<PostMcpOauthScreen />);
+
+ expect(screen.getByRole('heading', { name: 'Authorization successful' })).toBeInTheDocument();
+ expect(channels).toHaveLength(1);
+ expect(channels[0]?.name).toBe(MCP_AUTH_POPUP_CHANNEL);
+ expect(channels[0]?.postMessage).toHaveBeenCalledWith({
+ popupUid: 'popup-123',
+ isSuccess: true,
+ });
+ expect(channels[0]?.close).toHaveBeenCalledOnce();
+
+ act(() => {
+ vi.advanceTimersByTime(1000);
+ });
+
+ expect(channels).toHaveLength(2);
+ expect(channels[1]?.postMessage).toHaveBeenCalledWith({
+ popupUid: 'popup-123',
+ isSuccess: true,
+ });
+ expect(channels[1]?.close).toHaveBeenCalledOnce();
+ });
+
+ it('renders and broadcasts a failed authorization result', () => {
+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-456&isSuccess=false');
+
+ render(<PostMcpOauthScreen />);
+
+ expect(screen.getByRole('heading', { name: 'Authorization failed' })).toBeInTheDocument();
+ expect(channels[0]?.postMessage).toHaveBeenCalledWith({
+ popupUid: 'popup-456',
+ isSuccess: false,
+ });
+ });
+
+ it('does not broadcast an invalid result but still closes the popup after two seconds', () => {
+ window.history.replaceState({}, '', '/oauth/callback?isSuccess=true');
+
+ render(<PostMcpOauthScreen />);
+
+ expect(screen.getByRole('heading', { name: 'Authorization failed' })).toBeInTheDocument();
+ expect(screen.getByText(/authorization result is invalid/i)).toBeInTheDocument();
+ expect(channels).toHaveLength(0);
+
+ act(() => {
+ vi.advanceTimersByTime(1999);
+ });
+ expect(window.close).not.toHaveBeenCalled();
+
+ act(() => {
+ vi.advanceTimersByTime(1);
+ });
+ expect(window.close).toHaveBeenCalledOnce();
+ });
+
+ it('clears the retry and close timers when unmounted', () => {
+ window.history.replaceState({}, '', '/oauth/callback?pUid=popup-cleanup&isSuccess=true');
+ const { unmount } = render(<PostMcpOauthScreen />);
+
+ expect(channels).toHaveLength(1);
+ unmount();
+
+ act(() => {
+ vi.advanceTimersByTime(3000);
+ });
+
+ expect(channels).toHaveLength(1);
+ expect(window.close).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsx
new file mode 100644
index 000000000..466768c6b
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/ReasoningContainer.test.tsx
@@ -0,0 +1,132 @@
+// @vitest-environment jsdom
+import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { useCallback } from 'react';
+import { describe, expect, it } from 'vitest';
+
+import type { AgentStepsCardProps } from '@/atoms/adapters/AgentStepsCardAdapter.js';
+import type { ReasoningCardProps } from '@/atoms/adapters/ReasoningCardAdapter.js';
+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { RuntimeHarness } from './RuntimeHarness.js';
+
+function AgentStepsCardProbe({ children }: AgentStepsCardProps) {
+ return <div>{children}</div>;
+}
+
+function ReasoningCardProbe({
+ content,
+ isStreaming,
+ expanded,
+ isMultiLine,
+ reasoningTimeText,
+ previewText,
+ headingText,
+ contentRef,
+ onToggle,
+}: ReasoningCardProps) {
+ const measuredContentRef = useCallback(
+ (node: HTMLDivElement | null) => {
+ if (node !== null) {
+ Object.defineProperty(node, 'scrollHeight', { configurable: true, value: 80 });
+ }
+ contentRef?.(node);
+ },
+ [contentRef],
+ );
+
+ return (
+ <section
+ data-testid="reasoning-probe"
+ data-content={content}
+ data-streaming={String(isStreaming)}
+ data-expanded={String(expanded)}
+ data-multiline={String(isMultiLine)}
+ data-reasoning-time={String(reasoningTimeText)}
+ data-preview={previewText}
+ data-heading={headingText}
+ >
+ <button type="button" onClick={onToggle}>
+ Toggle reasoning
+ </button>
+ <div ref={measuredContentRef}>measured reasoning</div>
+ </section>
+ );
+}
+
+function TestSubject({ message, isRunning = false }: { message: ThreadMessageLike; isRunning?: boolean }) {
+ return (
+ <RuntimeHarness messages={[message]} isRunning={isRunning}>
+ <SlotsProvider
+ overrides={{
+ AgentStepsCard: AgentStepsCardProbe,
+ ReasoningCard: ReasoningCardProbe,
+ }}
+ >
+ <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>
+ </SlotsProvider>
+ </RuntimeHarness>
+ );
+}
+
+describe('ReasoningContainer', () => {
+ it('joins grouped reasoning, normalizes its preview, and measures multiline content', async () => {
+ render(
+ <TestSubject
+ message={{
+ role: 'assistant',
+ content: [
+ { type: 'reasoning', text: 'First line\n' },
+ { type: 'reasoning', text: ' second line' },
+ ],
+ }}
+ />,
+ );
+
+ const probe = screen.getByTestId('reasoning-probe');
+ expect(probe).toHaveAttribute('data-content', 'First line\n second line');
+ expect(probe).toHaveAttribute('data-preview', 'First line second line');
+ expect(probe).toHaveAttribute('data-streaming', 'false');
+ expect(probe).toHaveAttribute('data-expanded', 'false');
+ expect(probe).toHaveAttribute('data-heading', 'Reasoning');
+ expect(probe).toHaveAttribute('data-reasoning-time', 'null');
+ await waitFor(() => {
+ expect(probe).toHaveAttribute('data-multiline', 'true');
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Toggle reasoning' }));
+ expect(probe).toHaveAttribute('data-expanded', 'true');
+ });
+
+ it('starts expanded while streaming and re-expands when streaming resumes', async () => {
+ const completedMessage: ThreadMessageLike = {
+ role: 'assistant',
+ content: [{ type: 'reasoning', text: 'Thinking' }],
+ };
+ const runningMessage: ThreadMessageLike = {
+ role: 'assistant',
+ content: [{ type: 'reasoning', text: 'Thinking further' }],
+ status: { type: 'running' },
+ };
+ const { rerender } = render(<TestSubject message={runningMessage} isRunning />);
+
+ const probe = screen.getByTestId('reasoning-probe');
+ expect(probe).toHaveAttribute('data-streaming', 'true');
+ expect(probe).toHaveAttribute('data-expanded', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Toggle reasoning' }));
+ expect(probe).toHaveAttribute('data-expanded', 'false');
+
+ rerender(<TestSubject message={completedMessage} />);
+ await waitFor(() => {
+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-streaming', 'false');
+ });
+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-expanded', 'false');
+
+ rerender(<TestSubject message={runningMessage} isRunning />);
+ await waitFor(() => {
+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-streaming', 'true');
+ expect(screen.getByTestId('reasoning-probe')).toHaveAttribute('data-expanded', 'true');
+ });
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/RuntimeHarness.tsx b/packages/trueforge-ui-sdk/test/containers/RuntimeHarness.tsx
similarity index 100%
rename from packages/trueforge-ui-sdk/src/containers/RuntimeHarness.tsx
rename to packages/trueforge-ui-sdk/test/containers/RuntimeHarness.tsx
diff --git a/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsx
new file mode 100644
index 000000000..1aecb9aec
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/SandboxToolCallContainer.test.tsx
@@ -0,0 +1,114 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import type { SandboxToolCallCardProps } from '@/atoms/SandboxToolCallCard.js';
+import { SandboxToolCallContainer } from '@/containers/SandboxToolCallContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function SandboxToolCallCardProbe({
+ name,
+ status,
+ expanded,
+ command,
+ argsJson,
+ resultText,
+ resultJson,
+ viewMode,
+ hasContent,
+ onViewModeChange,
+}: SandboxToolCallCardProps) {
+ return (
+ <section
+ data-testid="sandbox-probe"
+ data-name={name}
+ data-status={status}
+ data-expanded={String(expanded)}
+ data-command={command}
+ data-args={argsJson}
+ data-result-text={resultText}
+ data-result-json={resultJson}
+ data-view-mode={viewMode}
+ data-has-content={String(hasContent)}
+ >
+ <button type="button" onClick={() => onViewModeChange?.('terminal')}>
+ Show terminal
+ </button>
+ <button type="button" onClick={() => onViewModeChange?.('code')}>
+ Show code
+ </button>
+ </section>
+ );
+}
+
+function renderSubject(props: Omit<SandboxToolCallCardProps, 'viewMode' | 'hasContent' | 'onViewModeChange'>) {
+ return render(
+ <SlotsProvider overrides={{ SandboxToolCallCard: SandboxToolCallCardProbe }}>
+ <SandboxToolCallContainer {...props} />
+ </SlotsProvider>,
+ );
+}
+
+describe('SandboxToolCallContainer', () => {
+ it('starts in terminal mode, forwards card props, and reveals argument JSON in code mode', () => {
+ renderSubject({
+ name: 'run_command',
+ status: 'success',
+ expanded: true,
+ onToggle: () => {},
+ argsJson: '{"command":"pwd"}',
+ });
+
+ const probe = screen.getByTestId('sandbox-probe');
+ expect(probe).toHaveAttribute('data-name', 'run_command');
+ expect(probe).toHaveAttribute('data-status', 'success');
+ expect(probe).toHaveAttribute('data-expanded', 'true');
+ expect(probe).toHaveAttribute('data-args', '{"command":"pwd"}');
+ expect(probe).toHaveAttribute('data-view-mode', 'terminal');
+ expect(probe).toHaveAttribute('data-has-content', 'false');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));
+ expect(probe).toHaveAttribute('data-view-mode', 'code');
+ expect(probe).toHaveAttribute('data-has-content', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Show terminal' }));
+ expect(probe).toHaveAttribute('data-view-mode', 'terminal');
+ expect(probe).toHaveAttribute('data-has-content', 'false');
+ });
+
+ it('treats command and text output as terminal-only content', () => {
+ renderSubject({
+ name: 'run_command',
+ status: 'running',
+ expanded: false,
+ onToggle: () => {},
+ command: 'pnpm test',
+ resultText: 'passed',
+ });
+
+ const probe = screen.getByTestId('sandbox-probe');
+ expect(probe).toHaveAttribute('data-command', 'pnpm test');
+ expect(probe).toHaveAttribute('data-result-text', 'passed');
+ expect(probe).toHaveAttribute('data-has-content', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));
+ expect(probe).toHaveAttribute('data-has-content', 'false');
+ });
+
+ it('keeps structured result JSON available in both views', () => {
+ renderSubject({
+ name: 'run_command',
+ status: 'error',
+ expanded: true,
+ onToggle: () => {},
+ resultJson: '{"exit_code":1}',
+ });
+
+ const probe = screen.getByTestId('sandbox-probe');
+ expect(probe).toHaveAttribute('data-result-json', '{"exit_code":1}');
+ expect(probe).toHaveAttribute('data-has-content', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Show code' }));
+ expect(probe).toHaveAttribute('data-has-content', 'true');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx
similarity index 94%
rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx
index d4b819f39..49abc1633 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ImportGithubSkillForm.test.tsx
@@ -2,7 +2,7 @@
import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import { beforeAll, describe, expect, it, vi } from 'vitest';
-import ImportGithubSkillForm from './ImportGithubSkillForm.js';
+import ImportGithubSkillForm from '@/containers/SettingsBuilder/ImportGithubSkillForm.js';
beforeAll(() => {
HTMLDialogElement.prototype.showModal = function showModal() {
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
similarity index 95%
rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
index 38e50a4c7..62b946cbe 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
@@ -3,15 +3,15 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import type { ReactNode } from 'react';
import { beforeAll, describe, expect, it } from 'vitest';
-import { ServerProvider } from '../../server/ServerContext.js';
+import SandboxSettings from '@/containers/SettingsBuilder/SandboxSettings.js';
+import { ServerProvider } from '@/server/ServerContext.js';
import type {
- AgentUIServer,
CreateSandboxProviderRequest,
SandboxProviderBase,
SandboxProviderCatalogEntry,
UpdateSandboxProviderRequest,
-} from '../../server/types.js';
-import SandboxSettings from './SandboxSettings.js';
+} from '@/server/types.js';
+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';
beforeAll(() => {
HTMLDialogElement.prototype.showModal = function showModal() {
@@ -79,7 +79,9 @@ function createFakeHost(initial: SandboxProviderBase[] = []) {
},
};
- const server = { catalog: { sandboxCatalog } } as unknown as AgentUIServer;
+ const server = createMockAgentUIServer({
+ catalog: createMockCatalog({ sandboxCatalog }),
+ });
return {
created,
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsx
similarity index 92%
rename from packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsx
index d77e14aec..fa0d2fb0a 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SkillSettings.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SkillSettings.test.tsx
@@ -3,9 +3,10 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
import type { ReactNode } from 'react';
import { beforeAll, describe, expect, it } from 'vitest';
-import { ServerProvider } from '../../server/ServerContext.js';
-import type { AgentUIServer, CreateSkillRequest, DefinedSkill, SkillCatalogEntry } from '../../server/types.js';
-import SkillSettings from './SkillSettings.js';
+import SkillSettings from '@/containers/SettingsBuilder/SkillSettings.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { CreateSkillRequest, DefinedSkill, SkillCatalogEntry } from '@/server/types.js';
+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';
beforeAll(() => {
HTMLDialogElement.prototype.showModal = function showModal() {
@@ -56,7 +57,9 @@ function createFakeHost(initial: DefinedSkill[] = []) {
},
};
- const server = { catalog: { skillCatalog } } as unknown as AgentUIServer;
+ const server = createMockAgentUIServer({
+ catalog: createMockCatalog({ skillCatalog }),
+ });
return {
created,
diff --git a/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsx
new file mode 100644
index 000000000..0825e7767
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/index.test.tsx
@@ -0,0 +1,145 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import type { ReactNode } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import TruefoundrySettingsBuilder from '@/containers/SettingsBuilder/index.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
+import type { AgentUIServer, SandboxCatalogServer, SkillCatalogServer } from '@/server/types.js';
+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';
+
+vi.mock('@/containers/SettingsBuilder/ModelSettings.js', () => ({
+ default: () => <div>Model settings content</div>,
+}));
+
+vi.mock('@/containers/SettingsBuilder/ConnectorSettings.js', () => ({
+ default: () => <div>Connector settings content</div>,
+}));
+
+vi.mock('@/containers/SettingsBuilder/SkillSettings.js', () => ({
+ default: () => <div>Skill settings content</div>,
+}));
+
+vi.mock('@/containers/SettingsBuilder/SandboxSettings.js', () => ({
+ default: () => <div>Sandbox settings content</div>,
+}));
+
+async function unavailable(): Promise<never> {
+ throw new Error('Unexpected settings section call');
+}
+
+const skillCatalog: SkillCatalogServer = {
+ getSkillCatalog: async () => [],
+ listSkills: async () => [],
+ createSkill: unavailable,
+};
+
+const sandboxCatalog: SandboxCatalogServer = {
+ getSandboxProviderCatalog: async () => [],
+ listSandboxProviders: async () => [],
+ createSandboxProvider: unavailable,
+ updateSandboxProvider: unavailable,
+};
+
+function createServer(options: { catalog?: boolean; skills?: boolean; sandbox?: boolean } = {}): AgentUIServer {
+ if (options.catalog === false) {
+ return createMockAgentUIServer();
+ }
+ return createMockAgentUIServer({
+ catalog: createMockCatalog({
+ ...(options.skills ? { skillCatalog } : {}),
+ ...(options.sandbox ? { sandboxCatalog } : {}),
+ }),
+ });
+}
+
+function SettingsControls() {
+ const { setSettingsOpen } = useShellMode();
+ return (
+ <button type="button" onClick={() => setSettingsOpen(true)}>
+ Open settings
+ </button>
+ );
+}
+
+function TestShell({ server, children }: { server?: AgentUIServer; children?: ReactNode }) {
+ const content = (
+ <ShellModeProvider>
+ <SettingsControls />
+ <TruefoundrySettingsBuilder />
+ {children}
+ </ShellModeProvider>
+ );
+ return server === undefined ? content : <ServerProvider server={server}>{content}</ServerProvider>;
+}
+
+describe('TruefoundrySettingsBuilder', () => {
+ it('stays hidden while closed and when no settings catalog is available', () => {
+ const { rerender } = render(<TestShell server={createServer()} />);
+
+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));
+ expect(screen.getByRole('heading', { name: 'Settings' })).toBeInTheDocument();
+
+ rerender(<TestShell server={createServer({ catalog: false })} />);
+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();
+
+ rerender(<TestShell />);
+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();
+ });
+
+ it('only exposes optional sections backed by catalogs', () => {
+ const { rerender } = render(<TestShell server={createServer()} />);
+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));
+
+ expect(screen.getByRole('button', { name: 'Models' })).toHaveAttribute('aria-current', 'page');
+ expect(screen.getByRole('button', { name: 'Connectors' })).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Skills' })).not.toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Sandbox' })).not.toBeInTheDocument();
+ expect(screen.getByText('Model settings content')).toBeInTheDocument();
+
+ rerender(<TestShell server={createServer({ skills: true, sandbox: true })} />);
+
+ fireEvent.click(screen.getByRole('button', { name: 'Skills' }));
+ expect(screen.getByText('Skill settings content')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Sandbox providers' }));
+ expect(screen.getByText('Sandbox settings content')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Connectors' }));
+ expect(screen.getByText('Connector settings content')).toBeInTheDocument();
+ });
+
+ it('resets a stale optional section when its catalog disappears', async () => {
+ const { rerender } = render(<TestShell server={createServer({ skills: true })} />);
+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Skills' }));
+
+ expect(screen.getByText('Skill settings content')).toBeInTheDocument();
+
+ rerender(<TestShell server={createServer()} />);
+
+ await waitFor(() => {
+ expect(screen.getByRole('button', { name: 'Models' })).toHaveAttribute('aria-current', 'page');
+ });
+ expect(screen.getByText('Model settings content')).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Skills' })).not.toBeInTheDocument();
+ });
+
+ it('closes on Escape without leaking the event to a parent handler', () => {
+ const parentKeyDown = vi.fn();
+ render(
+ <div onKeyDown={parentKeyDown}>
+ <TestShell server={createServer()} />
+ </div>,
+ );
+ fireEvent.click(screen.getByRole('button', { name: 'Open settings' }));
+
+ fireEvent.keyDown(screen.getByRole('heading', { name: 'Settings' }), { key: 'Escape' });
+
+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();
+ expect(parentKeyDown).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/containers/Thread.test.tsx b/packages/trueforge-ui-sdk/test/containers/Thread.test.tsx
new file mode 100644
index 000000000..2731028af
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/Thread.test.tsx
@@ -0,0 +1,34 @@
+// @vitest-environment jsdom
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import type { WelcomeScreenProps } from '@/atoms/WelcomeScreen.js';
+import { Thread } from '@/containers/Thread.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { RuntimeHarness } from './RuntimeHarness.js';
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryCancel: () => vi.fn(),
+ useTrueFoundryToolResponses: () => ({ pending: [] }),
+}));
+
+function WelcomeOverride({ heading }: WelcomeScreenProps) {
+ return <div data-testid="welcome-slot">{heading ?? 'Custom welcome'}</div>;
+}
+
+describe('Thread', () => {
+ it('assembles the thread view and composer while honoring thread slots', () => {
+ render(
+ <SlotsProvider overrides={{ WelcomeScreen: WelcomeOverride }}>
+ <RuntimeHarness messages={[]}>
+ <Thread />
+ </RuntimeHarness>
+ </SlotsProvider>,
+ );
+
+ expect(screen.getByTestId('welcome-slot')).toHaveTextContent('Custom welcome');
+ expect(screen.getByRole('textbox', { name: 'Message input' })).toBeInTheDocument();
+ expect(document.querySelector('[data-slot="aui_thread-viewport"]')).toBeInTheDocument();
+ expect(document.querySelector('[data-slot="aui_composer-shell"]')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsx
similarity index 94%
rename from packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsx
index 7dbcd1682..07e00e2b0 100644
--- a/packages/trueforge-ui-sdk/src/containers/ThreadContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/ThreadContainer.test.tsx
@@ -1,12 +1,12 @@
// @vitest-environment jsdom
-import type { AssistantState, ThreadMessageLike } from '@assistant-ui/react';
+import type { ThreadMessageLike } from '@assistant-ui/react';
import { render, screen, waitFor } from '@testing-library/react';
import { useEffect, useRef, type ReactNode } from 'react';
import { describe, expect, it } from 'vitest';
-import { ShellModeProvider, useShellMode } from '../server/ShellModeContext.js';
+import { isNewChatView, ThreadContainer } from '@/containers/ThreadContainer.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
import { RuntimeHarness } from './RuntimeHarness.js';
-import { isNewChatView, ThreadContainer } from './ThreadContainer.js';
function EditAgentBootstrap({ children }: { children: ReactNode }) {
const shell = useShellMode();
@@ -55,7 +55,7 @@ function emptyThreadState(
threadsIsLoading?: boolean;
remoteId?: string | undefined;
} = {},
-): AssistantState {
+) {
return {
thread: {
messages: [],
@@ -67,7 +67,7 @@ function emptyThreadState(
threadListItem: {
remoteId: overrides.remoteId,
},
- } as unknown as AssistantState;
+ };
}
describe('isNewChatView', () => {
diff --git a/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsx
new file mode 100644
index 000000000..f38c6d4df
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/ThreadListContainer.test.tsx
@@ -0,0 +1,186 @@
+// @vitest-environment jsdom
+import {
+ AssistantRuntimeProvider,
+ useExternalStoreRuntime,
+ type ExternalStoreThreadListAdapter,
+ type ThreadMessageLike,
+} from '@assistant-ui/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import type { ReactNode } from 'react';
+import { beforeAll, describe, expect, it, vi } from 'vitest';
+
+import type { ThreadListRowProps } from '@/atoms/ThreadListRow.js';
+import { CompactLayoutProvider } from '@/atoms/lib/CompactLayoutContext.js';
+import { ThreadListContainer } from '@/containers/ThreadListContainer.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
+
+beforeAll(() => {
+ HTMLDialogElement.prototype.showModal = function showModal() {
+ this.setAttribute('open', '');
+ };
+ HTMLDialogElement.prototype.close = function close() {
+ this.removeAttribute('open');
+ this.dispatchEvent(new Event('close'));
+ };
+});
+
+function ThreadListRuntimeHarness({
+ threadList,
+ children,
+}: {
+ threadList: ExternalStoreThreadListAdapter;
+ children: ReactNode;
+}) {
+ const runtime = useExternalStoreRuntime<ThreadMessageLike>({
+ messages: [],
+ convertMessage: message => message,
+ onNew: async () => {},
+ adapters: { threadList },
+ });
+
+ return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;
+}
+
+function ThreadListRowOverride({ title, active, onSelect, actions }: ThreadListRowProps) {
+ return (
+ <div data-testid={`thread-row-${title}`} data-active={active ? 'true' : 'false'}>
+ <button type="button" onClick={onSelect}>
+ {title}
+ </button>
+ {actions}
+ </div>
+ );
+}
+
+function renderThreadList({
+ adapter,
+ onThreadOpen,
+ canDelete = false,
+}: {
+ adapter: ExternalStoreThreadListAdapter;
+ onThreadOpen?: () => void;
+ canDelete?: boolean;
+}) {
+ const list = (
+ <SlotsProvider overrides={{ ThreadListRow: ThreadListRowOverride }}>
+ <ThreadListRuntimeHarness threadList={adapter}>
+ <CompactLayoutProvider>
+ <ThreadListContainer onThreadOpen={onThreadOpen} />
+ </CompactLayoutProvider>
+ </ThreadListRuntimeHarness>
+ </SlotsProvider>
+ );
+
+ if (!canDelete) {
+ return render(list);
+ }
+
+ return render(
+ <ServerProvider server={createMockAgentUIServer({ deleteSession: async () => {} })}>{list}</ServerProvider>,
+ );
+}
+
+describe('ThreadListContainer', () => {
+ it('renders loading and empty list states from the runtime', () => {
+ const { unmount } = renderThreadList({
+ adapter: {
+ isLoading: true,
+ threads: [],
+ },
+ });
+
+ expect(screen.getByRole('status', { name: 'Loading threads' })).toBeInTheDocument();
+ unmount();
+
+ renderThreadList({
+ adapter: {
+ isLoading: false,
+ threads: [],
+ },
+ });
+
+ expect(screen.getByText('No threads yet')).toBeInTheDocument();
+ expect(screen.queryByRole('status', { name: 'Loading threads' })).not.toBeInTheDocument();
+ });
+
+ it('starts a new chat and selects a row through the thread-list API', async () => {
+ const onSwitchToNewThread = vi.fn(async () => {});
+ const onSwitchToThread = vi.fn(async () => {});
+ const onThreadOpen = vi.fn();
+
+ renderThreadList({
+ adapter: {
+ threadId: 'thread-1',
+ threads: [
+ {
+ status: 'regular',
+ id: 'thread-1',
+ title: 'Current session',
+ },
+ {
+ status: 'regular',
+ id: 'thread-2',
+ title: 'Previous session',
+ },
+ ],
+ onSwitchToNewThread,
+ onSwitchToThread,
+ },
+ onThreadOpen,
+ });
+
+ expect(screen.getByTestId('thread-row-Current session')).toHaveAttribute('data-active', 'true');
+ expect(screen.getByTestId('thread-row-Previous session')).toHaveAttribute('data-active', 'false');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Previous session' }));
+ await waitFor(() => {
+ expect(onSwitchToThread).toHaveBeenCalledWith('thread-2');
+ });
+
+ fireEvent.click(screen.getByRole('button', { name: 'Start new chat' }));
+ await waitFor(() => {
+ expect(onSwitchToNewThread).toHaveBeenCalledTimes(1);
+ });
+ expect(onThreadOpen).toHaveBeenCalledTimes(2);
+ });
+
+ it('exposes delete only for remote sessions and delegates deletion to the runtime', async () => {
+ const onDelete = vi.fn(async () => {});
+
+ renderThreadList({
+ adapter: {
+ threadId: 'thread-1',
+ threads: [
+ {
+ status: 'regular',
+ id: 'thread-1',
+ remoteId: 'session-1',
+ title: 'Remote session',
+ },
+ {
+ status: 'regular',
+ id: 'thread-local',
+ title: 'Local draft',
+ },
+ ],
+ onDelete,
+ },
+ canDelete: true,
+ });
+
+ const actionButtons = screen.getAllByRole('button', { name: 'Session actions' });
+ expect(actionButtons).toHaveLength(1);
+ const actionButton = actionButtons[0];
+ if (actionButton === undefined) {
+ throw new Error('Expected session actions button');
+ }
+ fireEvent.click(actionButton);
+ fireEvent.click(screen.getByRole('button', { name: 'Delete' }));
+
+ await waitFor(() => {
+ expect(onDelete).toHaveBeenCalledWith('thread-1');
+ });
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsx
new file mode 100644
index 000000000..b058221e8
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/ToolApprovalContainer.test.tsx
@@ -0,0 +1,134 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import type { ToolApprovalBarProps } from '@/atoms/ToolApprovalBar.js';
+import { ToolApprovalContainer, type ToolApprovalOption } from '@/containers/ToolApprovalContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function ToolApprovalBarProbe({
+ toolName,
+ approveOptions,
+ denyOptions,
+ selectedDenyOption,
+ denialReason,
+ showReasonError,
+ onSelect,
+ onDenyOptionChange,
+ onDenialReasonChange,
+ onReasonSubmit,
+}: ToolApprovalBarProps) {
+ return (
+ <section
+ data-testid="approval-probe"
+ data-tool-name={toolName}
+ data-approve-variants={approveOptions?.map(option => option.variant).join('|')}
+ data-deny-requires-reason={denyOptions?.map(option => String(option.requiresReason)).join('|')}
+ data-selected-deny={selectedDenyOption?.id ?? ''}
+ data-show-reason-error={String(showReasonError)}
+ >
+ {approveOptions?.map(option => (
+ <button key={option.id} type="button" onClick={() => onSelect(option.id)}>
+ {option.label}
+ </button>
+ ))}
+ {denyOptions?.map(option => (
+ <button
+ key={option.id}
+ type="button"
+ onClick={() => {
+ if (option.requiresReason) {
+ onDenyOptionChange?.(option.id);
+ } else {
+ onSelect(option.id);
+ }
+ }}
+ >
+ {option.label}
+ </button>
+ ))}
+ {selectedDenyOption !== undefined ? (
+ <>
+ <div>{selectedDenyOption.confirm?.title}</div>
+ <div>{selectedDenyOption.confirm?.description}</div>
+ <div>{selectedDenyOption.grants?.join(',')}</div>
+ <input
+ aria-label="Denial reason"
+ value={denialReason}
+ onChange={event => onDenialReasonChange?.(event.target.value)}
+ />
+ <button type="button" onClick={onReasonSubmit}>
+ Submit denial
+ </button>
+ </>
+ ) : null}
+ </section>
+ );
+}
+
+const options: ToolApprovalOption[] = [
+ { id: 'allow-once', label: 'Allow once', isAllow: true },
+ { id: 'allow-session', label: 'Allow session', isAllow: true },
+ { id: 'reject-now', label: 'Reject now', isAllow: false },
+ {
+ id: 'reject-with-reason',
+ label: 'Reject with reason',
+ isAllow: false,
+ grants: ['filesystem:write'],
+ confirm: {
+ title: 'Explain rejection',
+ description: 'The agent will receive this reason.',
+ },
+ },
+];
+
+function renderSubject(onSelectOption: (optionId: string, reason?: string) => void) {
+ return render(
+ <SlotsProvider overrides={{ ToolApprovalBar: ToolApprovalBarProbe }}>
+ <ToolApprovalContainer toolName="shell" options={options} onSelectOption={onSelectOption} />
+ </SlotsProvider>,
+ );
+}
+
+describe('ToolApprovalContainer', () => {
+ it('maps allow and deny options and forwards immediate selections', () => {
+ const onSelectOption = vi.fn();
+ renderSubject(onSelectOption);
+
+ const probe = screen.getByTestId('approval-probe');
+ expect(probe).toHaveAttribute('data-tool-name', 'shell');
+ expect(probe).toHaveAttribute('data-approve-variants', 'primary|secondary');
+ expect(probe).toHaveAttribute('data-deny-requires-reason', 'false|true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Allow once' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Reject now' }));
+ expect(onSelectOption).toHaveBeenNthCalledWith(1, 'allow-once');
+ expect(onSelectOption).toHaveBeenNthCalledWith(2, 'reject-now');
+ });
+
+ it('requires, trims, and submits a denial reason with confirmation metadata', () => {
+ const onSelectOption = vi.fn();
+ renderSubject(onSelectOption);
+
+ fireEvent.click(screen.getByRole('button', { name: 'Reject with reason' }));
+
+ const probe = screen.getByTestId('approval-probe');
+ expect(probe).toHaveAttribute('data-selected-deny', 'reject-with-reason');
+ expect(screen.getByText('Explain rejection')).toBeInTheDocument();
+ expect(screen.getByText('The agent will receive this reason.')).toBeInTheDocument();
+ expect(screen.getByText('filesystem:write')).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'Submit denial' }));
+ expect(onSelectOption).not.toHaveBeenCalled();
+ expect(probe).toHaveAttribute('data-show-reason-error', 'true');
+
+ fireEvent.change(screen.getByRole('textbox', { name: 'Denial reason' }), {
+ target: { value: ' policy blocked ' },
+ });
+ expect(probe).toHaveAttribute('data-show-reason-error', 'false');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Submit denial' }));
+ expect(onSelectOption).toHaveBeenCalledWith('reject-with-reason', 'policy blocked');
+ expect(probe).toHaveAttribute('data-selected-deny', '');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsx
similarity index 51%
rename from packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsx
index f35a13fe0..d592813b0 100644
--- a/packages/trueforge-ui-sdk/src/containers/ToolCallContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/ToolCallContainer.test.tsx
@@ -1,20 +1,50 @@
// @vitest-environment jsdom
-import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
+import { ThreadPrimitive, type ThreadMessage, type ThreadMessageLike } from '@assistant-ui/react';
import { fireEvent, render, screen } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import { AssistantMessageContainer } from './AssistantMessageContainer.js';
+import type { AskUserPromptProps } from '@/atoms/adapters/AskUserPromptAdapter.js';
+import type { SandboxToolCallCardProps } from '@/atoms/SandboxToolCallCard.js';
+import type { SubAgentCardProps } from '@/atoms/SubAgentCard.js';
+import type { ToolCallCardProps } from '@/atoms/ToolCallCard.js';
+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';
+import { SlotsProvider, type SlotOverrides } from '@/theme/SlotsProvider.js';
import { RuntimeHarness } from './RuntimeHarness.js';
-function renderToolCallMessage(content: ThreadMessageLike['content']) {
+function renderToolCallMessage(content: ThreadMessageLike['content'], overrides?: SlotOverrides) {
const message: ThreadMessageLike = { role: 'assistant', content };
return render(
- <RuntimeHarness messages={[message]}>
- <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>
- </RuntimeHarness>,
+ <SlotsProvider overrides={overrides}>
+ <RuntimeHarness messages={[message]}>
+ <ThreadPrimitive.Messages>{() => <AssistantMessageContainer />}</ThreadPrimitive.Messages>
+ </RuntimeHarness>
+ </SlotsProvider>,
);
}
+function createToolCallCardProbe() {
+ return vi.fn(({ toolName }: ToolCallCardProps) => <div>{toolName}</div>);
+}
+
+function createSandboxToolCallCardProbe() {
+ return vi.fn(({ name }: SandboxToolCallCardProps) => <div>{name}</div>);
+}
+
+function createAskUserPromptProbe() {
+ return vi.fn(({ answeredQuestions }: AskUserPromptProps) => (
+ <div>{answeredQuestions?.map(question => question.answer).join('|')}</div>
+ ));
+}
+
+function createSubAgentCardProbe() {
+ return vi.fn(({ agentName, children }: SubAgentCardProps) => (
+ <section>
+ <div>{agentName}</div>
+ {children}
+ </section>
+ ));
+}
+
/** Pending approvals only surface part-level "requires-action" when the whole message is flagged too. */
function renderPendingApprovalMessage(
content: ThreadMessageLike['content'],
@@ -72,6 +102,130 @@ describe('ToolCallContainer', () => {
expect(blocks[1]).toHaveTextContent('boom');
});
+ it('routes sandbox calls with parsed command and result details', () => {
+ const SandboxToolCallCard = createSandboxToolCallCardProbe();
+ const args = {
+ command: 'pnpm test',
+ intent: 'Run focused tests',
+ };
+ const result = {
+ response: {
+ exitCode: 0,
+ result: 'Tests passed',
+ },
+ };
+
+ renderToolCallMessage(
+ [
+ {
+ type: 'tool-call',
+ toolCallId: 'sandbox-1',
+ toolName: 'sandbox_exec',
+ args: {},
+ argsText: JSON.stringify(args),
+ result,
+ },
+ ],
+ { SandboxToolCallCard },
+ );
+
+ expect(SandboxToolCallCard.mock.calls[0]?.[0]).toEqual(
+ expect.objectContaining({
+ name: 'sandbox_exec',
+ intent: 'Run focused tests',
+ status: 'success',
+ command: 'pnpm test',
+ exitCode: 0,
+ argsJson: JSON.stringify(args, null, 2),
+ resultText: 'Tests passed',
+ resultJson: JSON.stringify(result, null, 2),
+ }),
+ );
+ });
+
+ it('replays a completed ask-user call with a custom answer', () => {
+ const AskUserPrompt = createAskUserPromptProbe();
+
+ renderToolCallMessage(
+ [
+ {
+ type: 'tool-call',
+ toolCallId: 'question-1',
+ toolName: 'ask_user_question',
+ args: {},
+ argsText: JSON.stringify({
+ question: 'Choose a report format',
+ options: ['Summary', 'Full report'],
+ }),
+ result: { content: 'Annotated report' },
+ },
+ ],
+ { AskUserPrompt },
+ );
+
+ expect(AskUserPrompt.mock.calls[0]?.[0]).toEqual(
+ expect.objectContaining({
+ questions: [],
+ answeredQuestions: [
+ {
+ id: 'question-1',
+ question: 'Choose a report format',
+ options: ['Summary', 'Full report'],
+ answer: 'Annotated report',
+ isCustom: true,
+ },
+ ],
+ readOnly: true,
+ }),
+ );
+ });
+
+ it('routes sub-agent metadata and renders its nested assistant content', () => {
+ const SubAgentCard = createSubAgentCardProbe();
+ const nestedMessage: ThreadMessage = {
+ id: 'nested-message-1',
+ role: 'assistant',
+ createdAt: new Date('2026-07-01T00:00:00Z'),
+ content: [{ type: 'text', text: 'Nested agent response' }],
+ status: { type: 'complete', reason: 'stop' },
+ metadata: {
+ unstable_state: null,
+ unstable_annotations: [],
+ unstable_data: [],
+ steps: [],
+ custom: {
+ subAgent: {
+ title: 'Research specialist',
+ input: 'Find primary sources',
+ },
+ },
+ },
+ };
+
+ renderToolCallMessage(
+ [
+ {
+ type: 'tool-call',
+ toolCallId: 'sub-agent-1',
+ toolName: 'create_sub_agent',
+ args: {},
+ messages: [nestedMessage],
+ },
+ ],
+ { SubAgentCard },
+ );
+
+ expect(SubAgentCard.mock.calls[0]?.[0]).toEqual(
+ expect.objectContaining({
+ agentName: 'Research specialist',
+ instruction: 'Find primary sources',
+ stepCount: 1,
+ status: 'success',
+ }),
+ );
+ expect(screen.getByText('Nested agent response')).toBeInTheDocument();
+ });
+
it('auto-expands and shows the approval bar while an approval is pending', () => {
renderPendingApprovalMessage([
{
@@ -191,56 +345,46 @@ describe('ToolCallContainer', () => {
expect(screen.getByText('database:write')).toBeInTheDocument();
});
- it('passes mcpServerName for list_tools', () => {
- renderToolCallMessage([
- {
- type: 'tool-call',
- toolCallId: '1',
- toolName: 'list_tools',
- args: {},
- argsText: '{"mcp_server":"github-team"}',
- },
- ]);
- // Verify the card is rendered (actual prop checking would require slot mocking)
- expect(screen.getByText(/Listing tools/)).toBeInTheDocument();
- });
-
- it('passes mcpServerName for call_tool', () => {
- renderToolCallMessage([
- {
- type: 'tool-call',
- toolCallId: '1',
- toolName: 'call_tool',
- args: {},
- argsText: '{"mcp_server":"slack-workspace","tool_name":"send_message","input":{}}',
- },
- ]);
- expect(screen.getByText(/call_tool: send_message/)).toBeInTheDocument();
- });
+ it.each([
+ ['list_tools', '{"mcp_server":"github-team"}', 'github-team'],
+ ['call_tool', '{"mcp_server":"slack-workspace","tool_name":"send_message","input":{}}', 'slack-workspace'],
+ ['get_tool_info', '{"mcp_server":"linear-integration","tool_name":"create_issue"}', 'linear-integration'],
+ ])('passes mcpServerName for %s', (toolName, argsText, mcpServerName) => {
+ const ToolCallCard = createToolCallCardProbe();
+ renderToolCallMessage(
+ [
+ {
+ type: 'tool-call',
+ toolCallId: '1',
+ toolName,
+ args: {},
+ argsText,
+ },
+ ],
+ { ToolCallCard },
+ );
- it('passes mcpServerName for get_tool_info', () => {
- renderToolCallMessage([
- {
- type: 'tool-call',
- toolCallId: '1',
- toolName: 'get_tool_info',
- args: {},
- argsText: '{"mcp_server":"linear-integration","tool_name":"create_issue"}',
- },
- ]);
- expect(screen.getByText(/get_tool_info: create_issue/)).toBeInTheDocument();
+ expect(ToolCallCard.mock.calls[0]?.[0]).toEqual(expect.objectContaining({ mcpServerName }));
});
it('does not pass mcpServerName for non-MCP tools', () => {
- renderToolCallMessage([
- {
- type: 'tool-call',
- toolCallId: '1',
- toolName: 'search_docs',
- args: {},
- argsText: '{"query":"example"}',
- },
- ]);
- expect(screen.getByText('search_docs')).toBeInTheDocument();
+ const ToolCallCard = createToolCallCardProbe();
+ renderToolCallMessage(
+ [
+ {
+ type: 'tool-call',
+ toolCallId: '1',
+ toolName: 'search_docs',
+ args: {},
+ argsText: '{"query":"example"}',
+ },
+ ],
+ { ToolCallCard },
+ );
+
+ expect(ToolCallCard).toHaveBeenCalledOnce();
+ const [call] = ToolCallCard.mock.calls;
+ if (!call) throw new Error('Expected ToolCallCard to render');
+ expect(call[0].mcpServerName).toBeUndefined();
});
});
diff --git a/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsx
new file mode 100644
index 000000000..6dd1a712f
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/ToolCallContentBlockContainer.test.tsx
@@ -0,0 +1,133 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { useCallback } from 'react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { ToolCallContentBlockProps } from '@/atoms/ToolCallContentBlock.js';
+import { ToolCallContentBlockContainer } from '@/containers/ToolCallContentBlockContainer.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+let observedNodes: Element[] = [];
+let disconnectCount = 0;
+
+class ResizeObserverProbe implements ResizeObserver {
+ readonly callback: ResizeObserverCallback;
+
+ constructor(callback: ResizeObserverCallback) {
+ this.callback = callback;
+ }
+
+ observe(target: Element) {
+ observedNodes.push(target);
+ this.callback([], this);
+ }
+
+ unobserve() {}
+
+ disconnect() {
+ disconnectCount += 1;
+ }
+}
+
+function ToolCallContentBlockProbe({
+ title,
+ content,
+ isJson,
+ copyValue,
+ maxHeight,
+ resizable,
+ fullscreen,
+ onFullscreenChange,
+ contentHeightRem,
+ contentRef,
+}: ToolCallContentBlockProps) {
+ const measuredContentRef = useCallback(
+ (node: HTMLDivElement | null) => {
+ if (node !== null) {
+ Object.defineProperty(node, 'scrollHeight', { configurable: true, value: 64 });
+ }
+ if (resizable) contentRef?.(node);
+ },
+ [contentRef, resizable],
+ );
+
+ return (
+ <section
+ data-testid="content-block-probe"
+ data-title={title}
+ data-content={content}
+ data-json={String(isJson)}
+ data-copy-value={copyValue}
+ data-max-height={maxHeight}
+ data-resizable={String(resizable)}
+ data-fullscreen={String(fullscreen)}
+ data-content-height={String(contentHeightRem)}
+ >
+ <div ref={measuredContentRef}>content node</div>
+ <button type="button" onClick={() => onFullscreenChange?.(true)}>
+ Enter fullscreen
+ </button>
+ <button type="button" onClick={() => onFullscreenChange?.(false)}>
+ Exit fullscreen
+ </button>
+ </section>
+ );
+}
+
+function TestSubject({ resizable = false }: { resizable?: boolean }) {
+ return (
+ <SlotsProvider overrides={{ ToolCallContentBlock: ToolCallContentBlockProbe }}>
+ <ToolCallContentBlockContainer
+ title="Tool result"
+ content='{"ok":true}'
+ isJson
+ copyValue="raw result"
+ maxHeight="20rem"
+ resizable={resizable}
+ />
+ </SlotsProvider>
+ );
+}
+
+describe('ToolCallContentBlockContainer', () => {
+ beforeEach(() => {
+ observedNodes = [];
+ disconnectCount = 0;
+ vi.stubGlobal('ResizeObserver', ResizeObserverProbe);
+ });
+
+ afterEach(() => {
+ vi.unstubAllGlobals();
+ });
+
+ it('forwards content configuration and owns fullscreen state', () => {
+ render(<TestSubject />);
+
+ const probe = screen.getByTestId('content-block-probe');
+ expect(probe).toHaveAttribute('data-title', 'Tool result');
+ expect(probe).toHaveAttribute('data-content', '{"ok":true}');
+ expect(probe).toHaveAttribute('data-json', 'true');
+ expect(probe).toHaveAttribute('data-copy-value', 'raw result');
+ expect(probe).toHaveAttribute('data-max-height', '20rem');
+ expect(probe).toHaveAttribute('data-fullscreen', 'false');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Enter fullscreen' }));
+ expect(probe).toHaveAttribute('data-fullscreen', 'true');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Exit fullscreen' }));
+ expect(probe).toHaveAttribute('data-fullscreen', 'false');
+ });
+
+ it('measures resizable content and disconnects its observer on unmount', async () => {
+ const { unmount } = render(<TestSubject resizable />);
+
+ await waitFor(() => {
+ expect(screen.getByTestId('content-block-probe')).toHaveAttribute('data-content-height', '4');
+ });
+ expect(observedNodes).toHaveLength(1);
+
+ const disconnectsBeforeUnmount = disconnectCount;
+ unmount();
+ expect(disconnectCount).toBeGreaterThan(disconnectsBeforeUnmount);
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsx
similarity index 97%
rename from packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsx
index e2441c4a3..cc7e25571 100644
--- a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/ToolGroupContainer.test.tsx
@@ -3,7 +3,7 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
import { fireEvent, render, screen } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
-import { AssistantMessageContainer } from './AssistantMessageContainer.js';
+import { AssistantMessageContainer } from '@/containers/AssistantMessageContainer.js';
import { RuntimeHarness } from './RuntimeHarness.js';
function renderMultiToolMessage(content: ThreadMessageLike['content'], isRunning = false) {
diff --git a/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsx
new file mode 100644
index 000000000..6b719cfe4
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/TrueFoundryChatProvider.test.tsx
@@ -0,0 +1,110 @@
+// @vitest-environment jsdom
+import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';
+import { act, render, screen } from '@testing-library/react';
+import {
+ trueFoundryAttachmentAdapter,
+ type TrueFoundryAgentConfig,
+ type UseTrueFoundryAgentRuntimeOptions,
+} from '@truefoundry/assistant-ui-runtime';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createMockAgentUIServer } from '../server/mockServer.js';
+
+const runtimeSpy = vi.hoisted(() => vi.fn<(options: UseTrueFoundryAgentRuntimeOptions) => void>());
+const defaultAttachmentAdapter = vi.hoisted(() => ({}));
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ trueFoundryAttachmentAdapter: defaultAttachmentAdapter,
+ useTrueFoundryAgentRuntime: (options: UseTrueFoundryAgentRuntimeOptions) => {
+ runtimeSpy(options);
+ // Called from ChatRuntimeScope (a React component), so hooks are valid here.
+ return useExternalStoreRuntime<ThreadMessageLike>({
+ messages: [],
+ isRunning: false,
+ convertMessage: (message: ThreadMessageLike) => message,
+ onNew: async () => {},
+ });
+ },
+}));
+
+import { TrueFoundryChatProvider } from '@/containers/TrueFoundryChatProvider.js';
+
+describe('TrueFoundryChatProvider', () => {
+ beforeEach(() => {
+ runtimeSpy.mockClear();
+ });
+
+ it('forwards legacy runtime options and supplies the default attachment adapter', () => {
+ const server = createMockAgentUIServer();
+ const onError = vi.fn();
+
+ render(
+ <TrueFoundryChatProvider server={server} agentName="my-agent" initialSessionId="session-123" onError={onError}>
+ <div>chat-child</div>
+ </TrueFoundryChatProvider>,
+ );
+
+ expect(screen.getByText('chat-child')).toBeInTheDocument();
+ expect(runtimeSpy).toHaveBeenCalledWith(
+ expect.objectContaining({
+ server,
+ agentName: 'my-agent',
+ initialSessionId: 'session-123',
+ onError,
+ adapters: { attachments: defaultAttachmentAdapter },
+ }),
+ );
+ });
+
+ it('forwards a discriminated agent configuration', () => {
+ const agent: TrueFoundryAgentConfig = {
+ mode: 'named',
+ agentName: 'configured-agent',
+ };
+
+ render(
+ <TrueFoundryChatProvider server={createMockAgentUIServer()} agent={agent}>
+ <div>chat-child</div>
+ </TrueFoundryChatProvider>,
+ );
+
+ expect(runtimeSpy).toHaveBeenCalledWith(expect.objectContaining({ agent }));
+ });
+
+ it('preserves a consumer-provided attachment adapter', () => {
+ const attachmentAdapter = { ...trueFoundryAttachmentAdapter };
+
+ render(
+ <TrueFoundryChatProvider
+ server={createMockAgentUIServer()}
+ agentName="my-agent"
+ adapters={{ attachments: attachmentAdapter }}
+ >
+ <div>chat-child</div>
+ </TrueFoundryChatProvider>,
+ );
+
+ expect(runtimeSpy).toHaveBeenCalledWith(
+ expect.objectContaining({
+ adapters: { attachments: attachmentAdapter },
+ }),
+ );
+ });
+
+ it('uses the toaster as the default runtime error handler', async () => {
+ render(
+ <TrueFoundryChatProvider server={createMockAgentUIServer()} agentName="my-agent">
+ <div>chat-child</div>
+ </TrueFoundryChatProvider>,
+ );
+ const options = runtimeSpy.mock.calls[0]?.[0];
+ if (options?.onError === undefined) {
+ throw new Error('Expected runtime onError handler');
+ }
+
+ act(() => {
+ options.onError?.(new Error('runtime failed'));
+ });
+
+ expect(await screen.findByText('runtime failed')).toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
similarity index 81%
rename from packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
index e53b29e66..783e7fe83 100644
--- a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx
@@ -1,8 +1,9 @@
// @vitest-environment jsdom
+import type { CatalogServer } from '@/server/types.js';
import { useExternalStoreRuntime, type ThreadMessageLike } from '@assistant-ui/react';
-import { fireEvent, render, screen, waitFor, within } from '@testing-library/react';
+import { act, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import type { AgentUIServer, CatalogServer } from '../server/types.js';
+import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';
vi.mock('@truefoundry/assistant-ui-runtime', () => ({
trueFoundryAttachmentAdapter: {},
@@ -37,38 +38,22 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap
),
}));
-import { DrawerLayout } from '../layouts/DrawerLayout.js';
-import { SidebarLayout } from '../layouts/SidebarLayout.js';
-import { StackChatPanel } from '../layouts/StackChatPanel.js';
-import { WidgetLayout } from '../layouts/WidgetLayout.js';
-import { ServerProvider } from '../server/ServerContext.js';
-import { ShellModeProvider } from '../server/ShellModeContext.js';
-import { SlotsProvider } from '../theme/SlotsProvider.js';
+import { TrueforgeUI, type ChatLayout } from '@/containers/TrueforgeUI.js';
+import { DrawerLayout } from '@/layouts/DrawerLayout.js';
+import { SidebarLayout } from '@/layouts/SidebarLayout.js';
+import { StackChatPanel } from '@/layouts/StackChatPanel.js';
+import { WidgetLayout } from '@/layouts/WidgetLayout.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import { ShellModeProvider } from '@/server/ShellModeContext.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
import { RuntimeHarness } from './RuntimeHarness.js';
-import { TrueforgeUI, type ChatLayout } from './TrueforgeUI.js';
-
-function mockServer(catalog?: CatalogServer): AgentUIServer {
- return {
- createSession: vi.fn(),
- listSessions: vi.fn(),
- getSession: vi.fn(),
- updateSession: vi.fn(),
- createTurn: vi.fn(),
- cancelSession: vi.fn(),
- listTurns: vi.fn(),
- getTurn: vi.fn(),
- listEvents: vi.fn(),
- getModels: vi.fn(async () => []),
- getSkills: vi.fn(async () => []),
- getMcp: vi.fn(async () => []),
- searchAgents: vi.fn(async () => []),
- saveAgent: vi.fn(async () => ({})),
- ...(catalog != null ? { catalog } : {}),
- } as unknown as AgentUIServer;
+
+function mockServer(catalog?: CatalogServer) {
+ return createMockAgentUIServer(catalog === undefined ? {} : { catalog });
}
/** Minimal catalog stub — ShellActions only checks presence. */
-const stubCatalog = {} as CatalogServer;
+const stubCatalog = createMockCatalog();
describe('TrueforgeUI', () => {
const server = mockServer();
@@ -83,9 +68,26 @@ describe('TrueforgeUI', () => {
className="h-96"
/>,
);
+ await act(async () => {
+ await vi.dynamicImportSettled();
+ });
await waitFor(() => {
- expect(container.querySelector('.h-96')).toBeTruthy();
+ switch (layout) {
+ case 'sidebar':
+ expect(screen.getByRole('button', { name: /^(Collapse|Expand) sidebar$/ })).toBeInTheDocument();
+ break;
+ case 'drawer':
+ expect(screen.getByRole('button', { name: 'New chat' })).toBeInTheDocument();
+ break;
+ case 'dock':
+ expect(container.querySelector('[data-aui-compact-layout]')).toBeInTheDocument();
+ break;
+ case 'widget':
+ expect(screen.getByRole('button', { name: 'Open chat' })).toBeInTheDocument();
+ break;
+ }
});
+ expect(container.querySelector('.h-96')).toBeInTheDocument();
});
it('mounts a custom layout component inside providers', async () => {
@@ -124,20 +126,24 @@ describe('TrueforgeUI', () => {
);
window.history.replaceState(null, '', '/?screenType=mcp-auth&pUid=popup-1&isSuccess=true');
- const { unmount } = render(
- <TrueforgeUI
- server={server}
- agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}
- layout={() => <div data-testid="regular-layout">regular chrome</div>}
- />,
- );
-
- expect(await screen.findByText('Authorization successful')).toBeInTheDocument();
- expect(screen.queryByTestId('regular-layout')).not.toBeInTheDocument();
-
- unmount();
- window.history.replaceState(null, '', originalUrl);
- vi.unstubAllGlobals();
+ let unmount: (() => void) | undefined;
+ try {
+ const view = render(
+ <TrueforgeUI
+ server={server}
+ agentConfig={{ mode: 'SingleAgent', name: 'my-agent' }}
+ layout={() => <div data-testid="regular-layout">regular chrome</div>}
+ />,
+ );
+ unmount = view.unmount;
+
+ expect(await screen.findByText('Authorization successful')).toBeInTheDocument();
+ expect(screen.queryByTestId('regular-layout')).not.toBeInTheDocument();
+ } finally {
+ unmount?.();
+ window.history.replaceState(null, '', originalUrl);
+ vi.unstubAllGlobals();
+ }
});
it('surfaces trueforge-not-implemented as an alert', async () => {
@@ -242,7 +248,7 @@ describe('SidebarLayout', () => {
expect(screen.getByRole('button', { name: 'Expand sidebar' })).toBeInTheDocument();
});
- it('toggles theme from the footer and shows settings only when catalog is provided', () => {
+ it('toggles theme from the footer and shows settings only when catalog is provided', async () => {
const { rerender } = render(
<SlotsProvider theme={{ brand: { name: 'Acme' } }}>
<ServerProvider server={mockServer(stubCatalog)}>
@@ -258,8 +264,16 @@ describe('SidebarLayout', () => {
);
expect(screen.getAllByRole('button', { name: 'Settings' })).toHaveLength(2);
- const themeBtn = screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ })[0]!;
- fireEvent.click(themeBtn);
+ const expandButton = screen.queryByRole('button', { name: 'Expand sidebar' });
+ if (expandButton != null) {
+ fireEvent.click(expandButton);
+ }
+ expect(await screen.findAllByRole('button', { name: 'Agents Library (0)' })).not.toHaveLength(0);
+ const [themeButton] = screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ });
+ if (themeButton === undefined) {
+ throw new Error('Expected theme toggle');
+ }
+ fireEvent.click(themeButton);
expect(screen.getAllByRole('button', { name: /Switch to (light|dark) theme/ })).toHaveLength(2);
// Settings stays available with a locked agentName when catalog is present.
diff --git a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsx
similarity index 84%
rename from packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsx
index ce2bf07cb..c918b4148 100644
--- a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/UserEditComposerContainer.test.tsx
@@ -3,8 +3,8 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
import { fireEvent, render, screen } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
+import { UserEditComposerContainer } from '@/containers/UserEditComposerContainer.js';
import { RuntimeHarness } from './RuntimeHarness.js';
-import { UserEditComposerContainer } from './UserEditComposerContainer.js';
function renderEditComposer(messages: ThreadMessageLike[]) {
return render(
@@ -28,12 +28,15 @@ describe('UserEditComposerContainer', () => {
const input = screen.getByRole('textbox');
const form = input.closest('form');
- expect(form).toBeTruthy();
- const requestSubmit = vi.spyOn(form!, 'requestSubmit');
+ if (!(form instanceof HTMLFormElement)) {
+ throw new Error('Expected edit input to be rendered inside a form');
+ }
+ const onSubmit = vi.fn((event: Event) => event.preventDefault());
+ form.addEventListener('submit', onSubmit);
fireEvent.keyDown(input, { key: 'Enter' });
- expect(requestSubmit).toHaveBeenCalled();
+ expect(onSubmit).toHaveBeenCalledOnce();
});
it('shows read-only attachments without remove controls', () => {
diff --git a/packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsx b/packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsx
similarity index 97%
rename from packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsx
index 758cdc77e..e61641669 100644
--- a/packages/trueforge-ui-sdk/src/containers/UserMessageContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/UserMessageContainer.test.tsx
@@ -3,8 +3,8 @@ import { ThreadPrimitive, type ThreadMessageLike } from '@assistant-ui/react';
import { render, screen } from '@testing-library/react';
import { describe, expect, it } from 'vitest';
+import { UserMessageContainer } from '@/containers/UserMessageContainer.js';
import { RuntimeHarness } from './RuntimeHarness.js';
-import { UserMessageContainer } from './UserMessageContainer.js';
function renderUserMessage(messages: ThreadMessageLike[], options?: { isRunning?: boolean }) {
return render(
diff --git a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsx b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
similarity index 87%
rename from packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsx
rename to packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
index e97938c66..f02ab694c 100644
--- a/packages/trueforge-ui-sdk/src/containers/useResolvedServer.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/useResolvedServer.test.tsx
@@ -2,8 +2,8 @@
import { renderHook, waitFor } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
-import type { AgentUIServer } from '../server/types.js';
-import { useResolvedServer } from './useResolvedServer.js';
+import { useResolvedServer } from '@/containers/useResolvedServer.js';
+import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';
vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adapter', () => ({
createTrueFoundryAgentUIServer: vi.fn(async () => ({
@@ -12,13 +12,9 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap
})),
}));
-function mockServer(): AgentUIServer {
- return { saveAgent: vi.fn() } as unknown as AgentUIServer;
-}
-
describe('useResolvedServer', () => {
it('passes through AgentUIServer synchronously', () => {
- const server = mockServer();
+ const server = createMockAgentUIServer({ saveAgent: vi.fn() });
const { result } = renderHook(() => useResolvedServer(server));
expect(result.current).toEqual({
status: 'ready',
@@ -61,7 +57,7 @@ describe('useResolvedServer', () => {
});
it('attaches an optional catalog onto the truefoundry server', async () => {
- const catalog = { skillCatalog: {} } as never;
+ const catalog = createMockCatalog();
const { result } = renderHook(() =>
useResolvedServer({
type: 'truefoundry',
diff --git a/packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.ts b/packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.ts
similarity index 68%
rename from packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.ts
rename to packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.ts
index 46f8b1fea..b7b3140aa 100644
--- a/packages/trueforge-ui-sdk/src/hooks/useComposerBusyState.test.ts
+++ b/packages/trueforge-ui-sdk/test/hooks/useComposerBusyState.test.ts
@@ -9,7 +9,7 @@ vi.mock('@assistant-ui/core/react', () => ({
useThreadIsRunning: () => useThreadIsRunning(),
}));
-import { ComposerBusyProvider, useComposerBusyState } from './useComposerBusyState.js';
+import { ComposerBusyProvider, useComposerBusyState } from '@/hooks/useComposerBusyState.js';
function wrapper({ children }: { children: ReactNode }) {
return createElement(ComposerBusyProvider, null, children);
@@ -20,6 +20,15 @@ describe('useComposerBusyState', () => {
useThreadIsRunning.mockReturnValue(false);
});
+ it('reflects a running thread without marking it as submitting', () => {
+ useThreadIsRunning.mockReturnValue(true);
+ const { result } = renderHook(() => useComposerBusyState(), { wrapper });
+
+ expect(result.current.isBusy).toBe(true);
+ expect(result.current.isRunning).toBe(true);
+ expect(result.current.isSubmitting).toBe(false);
+ });
+
it('starts busy immediately on send before the thread is running', () => {
const { result } = renderHook(() => useComposerBusyState(), { wrapper });
@@ -62,6 +71,19 @@ describe('useComposerBusyState', () => {
});
});
+ it('clears submitting when send throws synchronously', () => {
+ const { result } = renderHook(() => useComposerBusyState(), { wrapper });
+
+ act(() => {
+ result.current.send(() => {
+ throw new Error('send failed');
+ });
+ });
+
+ expect(result.current.isBusy).toBe(false);
+ expect(result.current.isSubmitting).toBe(false);
+ });
+
it('resetBusy clears optimistic submitting state', () => {
const { result } = renderHook(() => useComposerBusyState(), { wrapper });
@@ -75,4 +97,10 @@ describe('useComposerBusyState', () => {
});
expect(result.current.isBusy).toBe(false);
});
+
+ it('requires ComposerBusyProvider', () => {
+ expect(() => renderHook(() => useComposerBusyState())).toThrow(
+ 'useComposerBusyState must be used within ComposerBusyProvider',
+ );
+ });
});
diff --git a/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.ts b/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.ts
new file mode 100644
index 000000000..917080501
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/hooks/useComposerPauseView.test.ts
@@ -0,0 +1,104 @@
+// @vitest-environment jsdom
+import { renderHook } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const useAuiState = vi.hoisted(() => vi.fn());
+const useToolResponses = vi.hoisted(() => vi.fn());
+
+vi.mock('@assistant-ui/react', () => ({
+ useAuiState,
+}));
+
+vi.mock('@truefoundry/assistant-ui-runtime', () => ({
+ useTrueFoundryToolResponses: useToolResponses,
+}));
+
+import { threadHasPendingMcpAuth, type ThreadPauseState, useComposerPauseView } from '@/hooks/useComposerPauseView.js';
+
+describe('threadHasPendingMcpAuth', () => {
+ it('recognizes MCP authorization only on the latest requiring-action assistant message', () => {
+ const pendingState = {
+ thread: {
+ messages: [
+ { role: 'user' },
+ {
+ role: 'assistant',
+ status: { type: 'requires-action' },
+ metadata: { custom: { pendingMcpAuth: true } },
+ },
+ ],
+ },
+ } satisfies ThreadPauseState;
+
+ expect(threadHasPendingMcpAuth(pendingState)).toBe(true);
+ expect(
+ threadHasPendingMcpAuth({
+ thread: {
+ messages: [...pendingState.thread.messages, { role: 'user' }],
+ },
+ }),
+ ).toBe(false);
+ });
+
+ it('rejects assistant messages without both the required status and metadata flag', () => {
+ expect(
+ threadHasPendingMcpAuth({
+ thread: {
+ messages: [
+ {
+ role: 'assistant',
+ status: { type: 'running' },
+ metadata: { custom: { pendingMcpAuth: true } },
+ },
+ ],
+ },
+ }),
+ ).toBe(false);
+ expect(
+ threadHasPendingMcpAuth({
+ thread: {
+ messages: [
+ {
+ role: 'assistant',
+ status: { type: 'requires-action' },
+ metadata: { custom: { pendingMcpAuth: false } },
+ },
+ ],
+ },
+ }),
+ ).toBe(false);
+ expect(threadHasPendingMcpAuth({ thread: { messages: [] } })).toBe(false);
+ });
+});
+
+describe('useComposerPauseView', () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ useAuiState.mockReturnValue(false);
+ useToolResponses.mockReturnValue({ pending: [] });
+ });
+
+ it('returns the normal composer when no pause source is pending', () => {
+ const { result } = renderHook(() => useComposerPauseView());
+
+ expect(result.current).toEqual({ kind: 'compose' });
+ expect(useAuiState).toHaveBeenCalledWith(threadHasPendingMcpAuth);
+ });
+
+ it('shows the ask-user view while tool responses are pending', () => {
+ useToolResponses.mockReturnValue({ pending: [{ toolCallId: 'question-1' }] });
+
+ const { result } = renderHook(() => useComposerPauseView());
+
+ expect(result.current).toEqual({ kind: 'ask-user' });
+ });
+
+ it('gives MCP authorization precedence over pending tool responses', () => {
+ useAuiState.mockReturnValue(true);
+ useToolResponses.mockReturnValue({ pending: [{ toolCallId: 'question-1' }] });
+
+ const { result } = renderHook(() => useComposerPauseView());
+
+ expect(result.current).toEqual({ kind: 'mcp' });
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.ts b/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.ts
new file mode 100644
index 000000000..1e5b79afc
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/hooks/useMcpAuth.test.ts
@@ -0,0 +1,194 @@
+// @vitest-environment jsdom
+import { act, cleanup, renderHook } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { ConnectorCatalogServer } from '@/server/types.js';
+
+type CatalogHookValue = {
+ connectorCatalog: Pick<ConnectorCatalogServer, 'authenticateConnector'>;
+};
+
+type ErrorToasterValue = {
+ showError: (error: unknown) => void;
+};
+
+const useCatalogServer = vi.hoisted(() => vi.fn<() => CatalogHookValue>());
+const useErrorToasterOptional = vi.hoisted(() => vi.fn<() => ErrorToasterValue | null>());
+
+vi.mock('@/server/ServerContext.js', () => ({
+ useCatalogServer,
+}));
+
+vi.mock('@/containers/ErrorToasterContainer.js', () => ({
+ useErrorToasterOptional,
+}));
+
+import { MCP_AUTH_POPUP_CHANNEL, useMCPAuth } from '@/hooks/useMcpAuth.js';
+
+const channels: BroadcastChannelStub[] = [];
+
+class BroadcastChannelStub {
+ readonly name: string;
+ readonly close = vi.fn();
+ onmessage: ((event: MessageEvent<unknown>) => void) | null = null;
+
+ constructor(name: string) {
+ this.name = name;
+ channels.push(this);
+ }
+
+ emit(data: unknown) {
+ this.onmessage?.(new MessageEvent('message', { data }));
+ }
+}
+
+const authenticateConnector = vi.fn<ConnectorCatalogServer['authenticateConnector']>();
+const showError = vi.fn<(error: unknown) => void>();
+
+function getPopupUid(): string {
+ const call = authenticateConnector.mock.calls.at(-1);
+ if (!call) throw new Error('Expected authenticateConnector to be called');
+
+ const redirectURL = call[0].redirectURL;
+ if (!redirectURL) throw new Error('Expected authenticateConnector to receive a redirect URL');
+
+ const popupUid = new URL(redirectURL).searchParams.get('pUid');
+ if (!popupUid) throw new Error('Expected the redirect URL to contain a popup UID');
+ return popupUid;
+}
+
+describe('useMCPAuth', () => {
+ beforeEach(() => {
+ channels.length = 0;
+ authenticateConnector.mockReset();
+ showError.mockReset();
+ useCatalogServer.mockReset();
+ useErrorToasterOptional.mockReset();
+ useCatalogServer.mockReturnValue({
+ connectorCatalog: { authenticateConnector },
+ });
+ useErrorToasterOptional.mockReturnValue({ showError });
+ vi.stubGlobal('BroadcastChannel', BroadcastChannelStub);
+ window.history.replaceState({}, '', '/chat');
+ });
+
+ afterEach(() => {
+ cleanup();
+ vi.restoreAllMocks();
+ vi.unstubAllGlobals();
+ });
+
+ it('completes immediately when the connector is already authenticated', async () => {
+ authenticateConnector.mockResolvedValue({ status: 'AUTHENTICATED' });
+ const open = vi.spyOn(window, 'open');
+ const callback = vi.fn();
+ const { result } = renderHook(() => useMCPAuth());
+
+ await act(async () => {
+ await result.current.handleAuthorize('connector-1', callback);
+ });
+
+ expect(authenticateConnector).toHaveBeenCalledWith({
+ id: 'connector-1',
+ redirectURL: expect.any(String),
+ });
+ expect(callback).toHaveBeenCalledOnce();
+ expect(callback).toHaveBeenCalledWith(true);
+ expect(open).not.toHaveBeenCalled();
+ expect(channels).toHaveLength(0);
+ expect(showError).not.toHaveBeenCalled();
+ expect(result.current.isOAuthLoading).toBe(false);
+ });
+
+ it('opens the authorization endpoint and accepts only its matching channel result', async () => {
+ authenticateConnector.mockResolvedValue({
+ authorization_endpoint: 'https://auth.example.test/authorize',
+ });
+ const open = vi.spyOn(window, 'open').mockReturnValue(window);
+ const focus = vi.spyOn(window, 'focus').mockImplementation(() => {});
+ const close = vi.spyOn(window, 'close').mockImplementation(() => {});
+ const callback = vi.fn();
+ const { result } = renderHook(() => useMCPAuth({ callbackPath: '/oauth/callback' }));
+
+ await act(async () => {
+ await result.current.handleAuthorize('connector-2', callback);
+ });
+
+ expect(open).toHaveBeenCalledWith('https://auth.example.test/authorize', '_blank', 'popup=true');
+ expect(focus).toHaveBeenCalledOnce();
+ expect(channels).toHaveLength(1);
+ expect(channels[0]?.name).toBe(MCP_AUTH_POPUP_CHANNEL);
+
+ const redirectCall = authenticateConnector.mock.calls[0];
+ if (!redirectCall?.[0].redirectURL) throw new Error('Expected a redirect URL');
+ const redirectURL = new URL(redirectCall[0].redirectURL);
+ expect(redirectURL.pathname).toBe('/oauth/callback');
+ expect(redirectURL.searchParams.get('screenType')).toBe('mcp-auth');
+ expect(redirectURL.searchParams.get('integrationId')).toBe('connector-2');
+
+ const channel = channels[0];
+ if (!channel) throw new Error('Expected an authorization channel');
+ channel.emit(null);
+ channel.emit({ popupUid: getPopupUid() });
+ channel.emit({ popupUid: 'another-popup', isSuccess: true });
+
+ expect(callback).not.toHaveBeenCalled();
+ expect(channel.close).not.toHaveBeenCalled();
+ expect(close).not.toHaveBeenCalled();
+
+ channel.emit({ popupUid: getPopupUid(), isSuccess: true });
+
+ expect(callback).toHaveBeenCalledOnce();
+ expect(callback).toHaveBeenCalledWith(true);
+ expect(channel.close).toHaveBeenCalledOnce();
+ expect(close).toHaveBeenCalledOnce();
+ expect(showError).not.toHaveBeenCalled();
+ });
+
+ it('reports a blocked popup and completes authorization as failed', async () => {
+ authenticateConnector.mockResolvedValue({
+ authorization_endpoint: 'https://auth.example.test/authorize',
+ });
+ vi.spyOn(window, 'open').mockReturnValue(null);
+ const callback = vi.fn();
+ const { result } = renderHook(() => useMCPAuth());
+
+ await act(async () => {
+ await result.current.handleAuthorize('connector-3', callback);
+ });
+
+ expect(callback).toHaveBeenCalledOnce();
+ expect(callback).toHaveBeenCalledWith(false);
+ expect(showError).toHaveBeenCalledOnce();
+ expect(showError).toHaveBeenCalledWith(
+ new Error('Popup blocked. Please allow pop-ups to authorize the MCP server.'),
+ );
+ expect(channels[0]?.close).toHaveBeenCalledOnce();
+ expect(result.current.isOAuthLoading).toBe(false);
+ });
+
+ it('closes the channel and popup when the hook unmounts', async () => {
+ authenticateConnector.mockResolvedValue({
+ authorization_endpoint: 'https://auth.example.test/authorize',
+ });
+ vi.spyOn(window, 'open').mockReturnValue(window);
+ vi.spyOn(window, 'focus').mockImplementation(() => {});
+ const close = vi.spyOn(window, 'close').mockImplementation(() => {});
+ const callback = vi.fn();
+ const { result, unmount } = renderHook(() => useMCPAuth());
+
+ await act(async () => {
+ await result.current.handleAuthorize('connector-4', callback);
+ });
+
+ const channel = channels[0];
+ if (!channel) throw new Error('Expected an authorization channel');
+ expect(channel.close).not.toHaveBeenCalled();
+
+ unmount();
+
+ expect(channel.close).toHaveBeenCalledOnce();
+ expect(close).toHaveBeenCalledOnce();
+ expect(callback).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/icons/Icon.test.tsx b/packages/trueforge-ui-sdk/test/icons/Icon.test.tsx
new file mode 100644
index 000000000..a2a550494
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/icons/Icon.test.tsx
@@ -0,0 +1,52 @@
+import { render, screen } from '@testing-library/react';
+import type { SVGProps } from 'react';
+import { describe, expect, it } from 'vitest';
+
+import { Icon } from '@/icons/Icon.js';
+import { ThemeProvider } from '@/theme/ThemeProvider.js';
+
+function CustomIcon(props: SVGProps<SVGSVGElement>) {
+ return <svg data-testid="custom-icon" {...props} />;
+}
+
+describe('Icon', () => {
+ it('renders a named icon as decorative by default', () => {
+ const { container } = render(<Icon name="check" className="host-icon" size={20} style={{ color: 'red' }} />);
+ const icon = container.querySelector('svg');
+
+ expect(icon).toHaveAttribute('aria-hidden', 'true');
+ expect(icon).toHaveAttribute('width', '20');
+ expect(icon).toHaveAttribute('height', '20');
+ expect(icon).toHaveClass('inline-block', 'shrink-0', 'host-icon');
+ expect(icon?.style.color).toBe('red');
+ });
+
+ it('uses the last array entry and exposes labelled icons as images', () => {
+ render(<Icon name={['far', 'clone']} aria-label="Copy message" />);
+
+ const icon = screen.getByRole('img', { name: 'Copy message' });
+ expect(icon).toHaveClass('lucide-copy');
+ expect(icon).not.toHaveAttribute('aria-hidden');
+ });
+
+ it('prefers a theme icon override while preserving icon props', () => {
+ render(
+ <ThemeProvider theme={{ icons: { check: CustomIcon } }}>
+ <Icon name="check" aria-label="Custom check" className="override-class" size="2rem" />
+ </ThemeProvider>,
+ );
+
+ const icon = screen.getByRole('img', { name: 'Custom check' });
+ expect(icon).toBe(screen.getByTestId('custom-icon'));
+ expect(icon).toHaveClass('inline-block', 'override-class');
+ expect(icon).toHaveAttribute('width', '2rem');
+ expect(icon).toHaveAttribute('height', '2rem');
+ });
+
+ it('renders nothing for an unknown icon name', () => {
+ const { container } = render(<Icon name="not-registered" aria-label="Unknown" />);
+
+ expect(container).toBeEmptyDOMElement();
+ expect(screen.queryByRole('img', { name: 'Unknown' })).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs
new file mode 100644
index 000000000..1e0b03506
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/packageExports.smoke.mjs
@@ -0,0 +1,65 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { mkdir, mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { execPath } from 'node:process';
+import { fileURLToPath, URL } from 'node:url';
+
+// Create a temporary directory to test the package exports
+const packageRoot = fileURLToPath(new URL('..', import.meta.url));
+const tempDir = await mkdtemp(path.join(packageRoot, 'test', '.package-smoke-'));
+
+try {
+ // create a tarball of the package
+ execFileSync('pnpm', ['pack', '--pack-destination', tempDir], {
+ cwd: packageRoot,
+ stdio: 'inherit',
+ });
+
+ // confirm that the tarball was created
+ const tarballs = (await readdir(tempDir)).filter(file => file.endsWith('.tgz'));
+ assert.equal(tarballs.length, 1, 'Expected pnpm pack to create one tarball');
+ const [tarballName] = tarballs;
+ assert.ok(tarballName);
+
+ // extract the tarball into a temporary directory
+ const packageDir = path.join(tempDir, 'node_modules', '@truefoundry', 'trueforge-ui');
+ await mkdir(packageDir, { recursive: true });
+ execFileSync('tar', ['-xzf', path.join(tempDir, tarballName), '--strip-components=1', '-C', packageDir]);
+
+ // create a package.json for the consumer
+ await writeFile(
+ path.join(tempDir, 'package.json'),
+ `${JSON.stringify({ name: 'trueforge-ui-package-smoke', private: true, type: 'module' }, null, 2)}\n`,
+ );
+
+ // create a consumer.mjs file that imports the package and verifies that the package exports are valid
+ await writeFile(
+ path.join(tempDir, 'consumer.mjs'),
+ `import assert from 'node:assert/strict';
+import { access } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+
+const sdk = await import('@truefoundry/trueforge-ui');
+const assistantUi = await import('@truefoundry/trueforge-ui/assistant-ui');
+
+assert.equal(typeof sdk.TrueforgeUI, 'function');
+assert.equal(typeof sdk.createTrueFoundryServer, 'function');
+assert.equal(typeof sdk.useMCPAuth, 'function');
+assert.equal(typeof assistantUi.useAui, 'function');
+assert.equal(typeof assistantUi.useAuiState, 'function');
+
+const stylesPath = fileURLToPath(import.meta.resolve('@truefoundry/trueforge-ui/styles.css'));
+await access(stylesPath);
+`,
+ );
+
+ // execute the consumer.mjs file in the temporary directory
+ execFileSync(execPath, ['consumer.mjs'], {
+ cwd: tempDir,
+ stdio: 'inherit',
+ });
+} finally {
+ // clean up the temporary directory
+ await rm(tempDir, { recursive: true, force: true });
+}
diff --git a/packages/trueforge-ui-sdk/test/publicUiExports.test.ts b/packages/trueforge-ui-sdk/test/publicUiExports.test.ts
new file mode 100644
index 000000000..fe49ff683
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/publicUiExports.test.ts
@@ -0,0 +1,152 @@
+import { describe, expect, it } from 'vitest';
+
+import * as sdk from '@/index.js';
+
+const expectedRuntimeExports: Array<keyof typeof sdk> = [
+ 'AgentStepsCard',
+ 'AgentStepsContainer',
+ 'AgentsLibrary',
+ 'AgentsLibraryButton',
+ 'AskUserContainer',
+ 'AssistantMessageBubble',
+ 'AssistantMessageContainer',
+ 'AssistantTextContainer',
+ 'AttachmentCard',
+ 'AttachmentPickerButton',
+ 'AttachmentPreviewDialog',
+ 'Avatar',
+ 'AvatarFallback',
+ 'AvatarImage',
+ 'BottomSheet',
+ 'BrandIcon',
+ 'BrandLogo',
+ 'CenteredModal',
+ 'ChatFileDownload',
+ 'ClearChatButton',
+ 'CodeEditor',
+ 'ComposerAttachmentPickerContainer',
+ 'ComposerAttachmentsContainer',
+ 'ComposerBusyProvider',
+ 'ComposerContainer',
+ 'ComposerLeftSection',
+ 'ComposerRightSection',
+ 'ComposerSendButton',
+ 'ComposerShell',
+ 'DEFAULT_AGENT_CONFIG',
+ 'DraftCatalogProvider',
+ 'DraftComposerLeftSection',
+ 'DraftComposerRightSection',
+ 'DraftCompositeSelector',
+ 'DraftModelSelector',
+ 'ErrorToasterProvider',
+ 'HistoryLoader',
+ 'HistoryLoaderContainer',
+ 'Icon',
+ 'MCP_AUTH_POPUP_CHANNEL',
+ 'Markdown',
+ 'McpAuthContainer',
+ 'MessageActionBar',
+ 'MessageAttachmentsContainer',
+ 'MessageErrorBanner',
+ 'MessageGroup',
+ 'MessageIndicator',
+ 'MessageListSkeleton',
+ 'MessageTimestamp',
+ 'MonacoEditorCore',
+ 'OpenUiFenceBlock',
+ 'PRESETS',
+ 'PostMcpOauthScreen',
+ 'ReasoningContainer',
+ 'SandboxArtifactDownload',
+ 'SandboxToolCallCard',
+ 'SaveAgentButton',
+ 'ScrollToBottomButton',
+ 'SelectAgentEmptyState',
+ 'ServerProvider',
+ 'ShellModeProvider',
+ 'SlotsProvider',
+ 'SubAgentCard',
+ 'SyntaxHighlighter',
+ 'ThemeProvider',
+ 'Thread',
+ 'ThreadComposerAreaShell',
+ 'ThreadContainer',
+ 'ThreadListContainer',
+ 'ThreadListEmptyState',
+ 'ThreadListNewButton',
+ 'ThreadListRow',
+ 'ThreadListRowSkeleton',
+ 'ThreadListShell',
+ 'ThreadRootShell',
+ 'ThreadViewportShell',
+ 'Toast',
+ 'ToastStack',
+ 'ToolApprovalBar',
+ 'ToolApprovalContainer',
+ 'ToolCallCard',
+ 'ToolCallContainer',
+ 'ToolCallContentBlock',
+ 'ToolCallContentBlockContainer',
+ 'ToolGroupCard',
+ 'ToolGroupContainer',
+ 'TrueFoundryChatProvider',
+ 'TrueforgeUI',
+ 'USER_MESSAGE_ATTACHMENT_PREVIEW_REM',
+ 'UserEditComposerContainer',
+ 'UserMessageActionBar',
+ 'UserMessageBubble',
+ 'UserMessageContainer',
+ 'UserMessageEdit',
+ 'WelcomeScreen',
+ 'computeAgentStepsSplit',
+ 'createTrueFoundryServer',
+ 'defaultSlots',
+ 'libraryAgentId',
+ 'mergeAgentSpec',
+ 'preloadMarkdownOpenUI',
+ 'resolvePresetTokens',
+ 'shellIsMutable',
+ 'threadHasPendingMcpAuth',
+ 'trueFoundryAttachmentAdapter',
+ 'useAui',
+ 'useAuiState',
+ 'useBrand',
+ 'useCatalogServer',
+ 'useComposerBusyState',
+ 'useComposerPauseView',
+ 'useContentClassNames',
+ 'useDraftCatalog',
+ 'useErrorToaster',
+ 'useErrorToasterOptional',
+ 'useMCPAuth',
+ 'useOptionalCatalogServer',
+ 'useOptionalContentClassNames',
+ 'useOptionalServer',
+ 'useOptionalShellMode',
+ 'useServer',
+ 'useShellMode',
+ 'useSlot',
+ 'useTheme',
+ 'useThemeIcons',
+ 'useThemeMode',
+ 'useTrueFoundryAgentRuntime',
+ 'useTrueFoundryAgentSpec',
+ 'useTrueFoundryCancel',
+ 'useTrueFoundryDownloadSandboxFile',
+ 'useTrueFoundryHistoryPagination',
+ 'useTrueFoundryMcpAuth',
+ 'useTrueFoundryRespondToToolApproval',
+ 'useTrueFoundryToolResponses',
+ 'useTrueFoundryTurnId',
+ 'useTrueFoundryUpdateAgentSpec',
+];
+
+describe('public runtime exports', () => {
+ it('matches the complete package entrypoint contract', () => {
+ expect(Object.keys(sdk).sort()).toEqual([...expectedRuntimeExports].sort());
+ });
+
+ it.each(expectedRuntimeExports)('keeps %s defined', exportName => {
+ expect(sdk[exportName]).toBeDefined();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/src/server/ServerContext.test.tsx b/packages/trueforge-ui-sdk/test/server/ServerContext.test.tsx
similarity index 75%
rename from packages/trueforge-ui-sdk/src/server/ServerContext.test.tsx
rename to packages/trueforge-ui-sdk/test/server/ServerContext.test.tsx
index f04293f33..8ada6ffc5 100644
--- a/packages/trueforge-ui-sdk/src/server/ServerContext.test.tsx
+++ b/packages/trueforge-ui-sdk/test/server/ServerContext.test.tsx
@@ -3,8 +3,15 @@ import { renderHook } from '@testing-library/react';
import type { ReactNode } from 'react';
import { describe, expect, it, vi } from 'vitest';
-import { ServerProvider, useCatalogServer, useOptionalCatalogServer } from './ServerContext.js';
-import type { AgentUIServer, CatalogServer } from './types.js';
+import {
+ ServerProvider,
+ useCatalogServer,
+ useOptionalCatalogServer,
+ useOptionalServer,
+ useServer,
+} from '@/server/ServerContext.js';
+import type { AgentUIServer, CatalogServer } from '@/server/types.js';
+import { createMockAgentUIServer } from './mockServer.js';
const catalog: CatalogServer = {
modelCatalog: {
@@ -91,9 +98,28 @@ function wrap(server: AgentUIServer) {
};
}
+describe('ServerProvider', () => {
+ it('provides the configured server', () => {
+ const server = createMockAgentUIServer();
+ const { result } = renderHook(() => useServer(), { wrapper: wrap(server) });
+
+ expect(result.current).toBe(server);
+ });
+
+ it('requires a provider for useServer', () => {
+ expect(() => renderHook(() => useServer())).toThrow('useServer must be used within a ServerProvider.');
+ });
+
+ it('returns null from useOptionalServer outside a provider', () => {
+ const { result } = renderHook(() => useOptionalServer());
+
+ expect(result.current).toBeNull();
+ });
+});
+
describe('useCatalogServer', () => {
it('returns server.catalog when present', () => {
- const server = { catalog } as unknown as AgentUIServer;
+ const server = createMockAgentUIServer({ catalog });
const { result } = renderHook(() => useCatalogServer(), {
wrapper: wrap(server),
});
@@ -101,14 +127,14 @@ describe('useCatalogServer', () => {
});
it('throws when catalog is omitted', () => {
- const server = {} as unknown as AgentUIServer;
+ const server = createMockAgentUIServer();
expect(() => renderHook(() => useCatalogServer(), { wrapper: wrap(server) })).toThrow(
/requires AgentUIServer\.catalog/,
);
});
it('useOptionalCatalogServer returns null when omitted', () => {
- const server = {} as unknown as AgentUIServer;
+ const server = createMockAgentUIServer();
const { result } = renderHook(() => useOptionalCatalogServer(), {
wrapper: wrap(server),
});
diff --git a/packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsx b/packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsx
similarity index 96%
rename from packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsx
rename to packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsx
index 250c83568..279f3353b 100644
--- a/packages/trueforge-ui-sdk/src/server/ShellModeContext.test.tsx
+++ b/packages/trueforge-ui-sdk/test/server/ShellModeContext.test.tsx
@@ -3,7 +3,7 @@ import { act, renderHook } from '@testing-library/react';
import type { ReactNode } from 'react';
import { describe, expect, it } from 'vitest';
-import { ShellModeProvider, useShellMode, type AgentConfig } from './ShellModeContext.js';
+import { ShellModeProvider, useOptionalShellMode, useShellMode, type AgentConfig } from '@/server/ShellModeContext.js';
function wrap(agentConfig?: AgentConfig) {
return function Wrapper({ children }: { children: ReactNode }) {
@@ -12,6 +12,16 @@ function wrap(agentConfig?: AgentConfig) {
}
describe('ShellModeProvider', () => {
+ it('requires a provider for useShellMode', () => {
+ expect(() => renderHook(() => useShellMode())).toThrow('useShellMode must be used within a ShellModeProvider.');
+ });
+
+ it('returns null from useOptionalShellMode outside a provider', () => {
+ const { result } = renderHook(() => useOptionalShellMode());
+
+ expect(result.current).toBeNull();
+ });
+
it('defaults to AgentLibraryWithComposer (mutable + library)', () => {
const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });
expect(result.current.mode).toMatchObject({ status: 'active', isMutable: true, locked: false });
diff --git a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.ts b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts
similarity index 90%
rename from packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.ts
rename to packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts
index ea54acf45..b51deb678 100644
--- a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.test.ts
+++ b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts
@@ -1,11 +1,12 @@
+import type { CatalogServer } from '@/server/types.js';
import { describe, expect, it, vi } from 'vitest';
-import type { AgentChatServer, CatalogServer } from './types.js';
-import { createTrueFoundryServer } from './createTrueFoundryServer.js';
+import { createTrueFoundryServer } from '@/server/createTrueFoundryServer.js';
+import { createMockAgentUIServer } from './mockServer.js';
describe('createTrueFoundryServer', () => {
it('composes chat server with builder callbacks', async () => {
- const chatServer = {
+ const chatServer = createMockAgentUIServer({
createSession: vi.fn(),
listSessions: vi.fn(),
getSession: vi.fn(),
@@ -15,7 +16,7 @@ describe('createTrueFoundryServer', () => {
listTurns: vi.fn(),
getTurn: vi.fn(),
listEvents: vi.fn(),
- } as unknown as AgentChatServer;
+ });
const getModels = vi.fn(async () => [{ name: 'm', provider: 'p', apiModel: 'p/m', modelId: 'm' }]);
const getSkills = vi.fn(async () => []);
@@ -48,7 +49,7 @@ describe('createTrueFoundryServer', () => {
});
it('attaches optional catalog when provided', async () => {
- const chatServer = {
+ const chatServer = createMockAgentUIServer({
createSession: vi.fn(),
listSessions: vi.fn(),
getSession: vi.fn(),
@@ -58,7 +59,7 @@ describe('createTrueFoundryServer', () => {
listTurns: vi.fn(),
getTurn: vi.fn(),
listEvents: vi.fn(),
- } as unknown as AgentChatServer;
+ });
const catalog: CatalogServer = {
modelCatalog: {
@@ -150,7 +151,10 @@ describe('createTrueFoundryServer', () => {
});
expect(server.catalog).toBe(catalog);
- await expect(server.catalog!.modelCatalog.listModelProviders()).resolves.toEqual([
+ if (server.catalog === undefined) {
+ throw new Error('Expected catalog');
+ }
+ await expect(server.catalog.modelCatalog.listModelProviders()).resolves.toEqual([
{ id: 'openai', type: 'openai', name: 'OpenAI', models: [] },
]);
});
diff --git a/packages/trueforge-ui-sdk/test/server/mockServer.ts b/packages/trueforge-ui-sdk/test/server/mockServer.ts
new file mode 100644
index 000000000..ddc29933a
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/server/mockServer.ts
@@ -0,0 +1,49 @@
+import type { AgentUIServer, CatalogServer } from '@/server/types.js';
+
+async function unavailable(): Promise<never> {
+ throw new Error('Unexpected mock server call');
+}
+
+async function* emptyTurnStream() {}
+
+export function createMockCatalog(overrides: Partial<CatalogServer> = {}): CatalogServer {
+ return {
+ modelCatalog: {
+ getModelProviderCatalog: async () => [],
+ listModelProviders: async () => [],
+ createModelProvider: unavailable,
+ updateModelProvider: unavailable,
+ },
+ connectorCatalog: {
+ getConnectorCatalog: async () => [],
+ listConnectors: async () => [],
+ getConnector: unavailable,
+ getToolsByConnectorId: async () => [],
+ createConnector: unavailable,
+ updateConnector: unavailable,
+ authenticateConnector: unavailable,
+ disconnectConnector: unavailable,
+ },
+ ...overrides,
+ };
+}
+
+export function createMockAgentUIServer(overrides: Partial<AgentUIServer> = {}): AgentUIServer {
+ return {
+ createSession: unavailable,
+ listSessions: unavailable,
+ getSession: unavailable,
+ updateSession: unavailable,
+ createTurn: emptyTurnStream,
+ cancelSession: unavailable,
+ listTurns: unavailable,
+ getTurn: unavailable,
+ listEvents: unavailable,
+ getModels: async () => [],
+ getSkills: async () => [],
+ getMcp: async () => [],
+ searchAgents: async () => [],
+ saveAgent: unavailable,
+ ...overrides,
+ };
+}
diff --git a/packages/trueforge-ui-sdk/src/testSetup.ts b/packages/trueforge-ui-sdk/test/testSetup.ts
similarity index 91%
rename from packages/trueforge-ui-sdk/src/testSetup.ts
rename to packages/trueforge-ui-sdk/test/testSetup.ts
index 215b60636..40a9c21c0 100644
--- a/packages/trueforge-ui-sdk/src/testSetup.ts
+++ b/packages/trueforge-ui-sdk/test/testSetup.ts
@@ -48,5 +48,9 @@ class ResizeObserverStub {
}
if (typeof globalThis.ResizeObserver === 'undefined') {
- globalThis.ResizeObserver = ResizeObserverStub as unknown as typeof ResizeObserver;
+ Object.defineProperty(globalThis, 'ResizeObserver', {
+ configurable: true,
+ writable: true,
+ value: ResizeObserverStub,
+ });
}
diff --git a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsx b/packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsx
similarity index 73%
rename from packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsx
rename to packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsx
index c7e22958e..ae14de9c9 100644
--- a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.test.tsx
+++ b/packages/trueforge-ui-sdk/test/theme/SlotsProvider.test.tsx
@@ -1,10 +1,10 @@
// @vitest-environment jsdom
import { render, screen } from '@testing-library/react';
-import type { ComponentProps } from 'react';
+import type { ComponentProps, ReactNode } from 'react';
import { describe, expect, it } from 'vitest';
-import { WelcomeScreen } from '../atoms/WelcomeScreen.js';
-import { SlotsProvider, useSlot, useThemeMode } from './SlotsProvider.js';
+import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';
+import { SlotsProvider, useSlot, useThemeMode } from '@/theme/SlotsProvider.js';
function WelcomeConsumer() {
const SlotWelcome = useSlot('WelcomeScreen');
@@ -19,6 +19,10 @@ function CustomWelcome(_props: ComponentProps<typeof WelcomeScreen>) {
return <p data-testid="custom-welcome">custom</p>;
}
+function CustomAccordion({ children }: { children?: ReactNode }) {
+ return <section data-testid="custom-accordion">{children}</section>;
+}
+
describe('SlotsProvider', () => {
it('resolves the default WelcomeScreen when no override is provided', () => {
render(<WelcomeConsumer />);
@@ -66,10 +70,18 @@ describe('SlotsProvider', () => {
}
render(
- <SlotsProvider overrides={{ WelcomeScreen: CustomWelcome }}>
- <AccordionConsumer />
+ <SlotsProvider overrides={{ WelcomeScreen: CustomWelcome }} theme={{ mode: 'dark' }}>
+ <SlotsProvider overrides={{ Accordion: CustomAccordion }}>
+ <WelcomeConsumer />
+ <AccordionConsumer />
+ <ThemeModeConsumer />
+ </SlotsProvider>
</SlotsProvider>,
);
+
+ expect(screen.getByTestId('custom-welcome')).toBeInTheDocument();
+ expect(screen.getByTestId('custom-accordion')).toHaveTextContent('nested-ok');
expect(screen.getByText('nested-ok')).toBeInTheDocument();
+ expect(screen.getByText('dark')).toBeInTheDocument();
});
});
diff --git a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsx b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
similarity index 76%
rename from packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsx
rename to packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
index e13ba67bb..107d5e14f 100644
--- a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.test.tsx
+++ b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
@@ -1,10 +1,10 @@
// @vitest-environment jsdom
-import { act, render, screen } from '@testing-library/react';
-import { describe, expect, it } from 'vitest';
+import { act, render, renderHook, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { WelcomeScreen } from '../atoms/WelcomeScreen.js';
-import { BrandIcon, BrandLogo } from './brand.js';
-import { ThemeProvider, useBrand, useTheme } from './ThemeProvider.js';
+import { WelcomeScreen } from '@/atoms/WelcomeScreen.js';
+import { BrandIcon, BrandLogo } from '@/theme/brand.js';
+import { ThemeProvider, useBrand, useTheme } from '@/theme/ThemeProvider.js';
function ModeProbe() {
const { mode, preference, setTheme } = useTheme();
@@ -27,7 +27,29 @@ function BrandProbe() {
return <output data-testid="brand-name">{brand.name ?? 'none'}</output>;
}
+function getThemeRoot(container: HTMLElement): HTMLElement {
+ const root = container.querySelector<HTMLElement>('.aui-theme-root');
+ if (root === null) {
+ throw new Error('Expected theme root');
+ }
+ return root;
+}
+
describe('ThemeProvider', () => {
+ beforeEach(() => {
+ localStorage.clear();
+ document.documentElement.classList.remove('dark');
+ });
+
+ afterEach(() => {
+ vi.unstubAllGlobals();
+ document.documentElement.classList.remove('dark');
+ });
+
+ it('requires a provider for useTheme', () => {
+ expect(() => renderHook(() => useTheme())).toThrow('useTheme must be used within a ThemeProvider');
+ });
+
it('applies controlled mode and ignores setTheme', () => {
render(
<ThemeProvider theme={{ mode: 'dark' }}>
@@ -52,6 +74,49 @@ describe('ThemeProvider', () => {
});
expect(screen.getByTestId('mode')).toHaveTextContent('dark');
expect(document.documentElement.classList.contains('dark')).toBe(true);
+ expect(localStorage.getItem('aui-theme-preference')).toBe('dark');
+ });
+
+ it('follows system preference changes and removes the listener on unmount', () => {
+ let systemDark = false;
+ const listeners = new Set<() => void>();
+ const addEventListener = vi.fn((_type: string, listener: () => void) => {
+ listeners.add(listener);
+ });
+ const removeEventListener = vi.fn((_type: string, listener: () => void) => {
+ listeners.delete(listener);
+ });
+ vi.stubGlobal(
+ 'matchMedia',
+ vi.fn(() => ({
+ get matches() {
+ return systemDark;
+ },
+ addEventListener,
+ removeEventListener,
+ })),
+ );
+ localStorage.setItem('aui-theme-preference', 'system');
+
+ const { unmount } = render(
+ <ThemeProvider>
+ <ModeProbe />
+ </ThemeProvider>,
+ );
+
+ expect(screen.getByTestId('preference')).toHaveTextContent('system');
+ expect(screen.getByTestId('mode')).toHaveTextContent('light');
+
+ systemDark = true;
+ act(() => {
+ for (const listener of listeners) listener();
+ });
+
+ expect(screen.getByTestId('mode')).toHaveTextContent('dark');
+ expect(document.documentElement).toHaveClass('dark');
+
+ unmount();
+ expect(removeEventListener).toHaveBeenCalledWith('change', expect.any(Function));
});
it('exposes brand config and BrandLogo / BrandIcon', () => {
@@ -72,7 +137,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.classList.contains('host-chat')).toBe(true);
expect(root.style.getPropertyValue('--primary')).toBe('#e11d48');
});
@@ -83,7 +148,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.getAttribute('data-preset')).toBe('chatgpt');
expect(root.style.getPropertyValue('--primary')).toBe('#0d0d0d');
expect(root.style.getPropertyValue('--background')).toBe('#ffffff');
@@ -103,7 +168,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.style.getPropertyValue('--background')).toBe('#000000');
expect(root.style.getPropertyValue('--card')).toBe('#212121');
expect(root.style.getPropertyValue('--primary')).toBe('#ffffff');
@@ -118,7 +183,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.getAttribute('data-preset')).toBe('claude');
expect(root.style.getPropertyValue('--background')).toBe('#f0ece0');
expect(root.style.getPropertyValue('--foreground')).toBe('#1a1a18');
@@ -139,7 +204,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.style.getPropertyValue('--background')).toBe('#2b2a27');
expect(root.style.getPropertyValue('--foreground')).toBe('#eeeeee');
expect(root.style.getPropertyValue('--card')).toBe('#1f1e1b');
@@ -154,7 +219,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.style.getPropertyValue('--background')).toBe('#fdfcfc');
expect(root.style.getPropertyValue('--foreground')).toBe('#1f1f1f');
expect(root.style.getPropertyValue('--primary')).toBe('#1f3b9b');
@@ -172,7 +237,7 @@ describe('ThemeProvider', () => {
<span>child</span>
</ThemeProvider>,
);
- const root = container.querySelector('.aui-theme-root') as HTMLElement;
+ const root = getThemeRoot(container);
expect(root.style.getPropertyValue('--background')).toBe('#0c0c0c');
expect(root.style.getPropertyValue('--card')).toBe('#1e1f20');
expect(root.style.getPropertyValue('--primary')).toBe('#a8c7fa');
diff --git a/packages/trueforge-ui-sdk/test/theme/brand.test.tsx b/packages/trueforge-ui-sdk/test/theme/brand.test.tsx
new file mode 100644
index 000000000..48f7c795c
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/theme/brand.test.tsx
@@ -0,0 +1,61 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { BrandIcon, BrandLogo } from '@/theme/brand.js';
+import { ThemeProvider } from '@/theme/ThemeProvider.js';
+
+describe('BrandIcon and BrandLogo', () => {
+ it('renders accessible default branding without a provider', () => {
+ const { container } = render(
+ <>
+ <BrandLogo className="host-logo" />
+ <BrandIcon className="host-icon" />
+ </>,
+ );
+
+ expect(screen.getByText('TrueFoundry').parentElement).toHaveClass('host-logo');
+ const icons = container.querySelectorAll('svg[aria-hidden="true"]');
+ expect(icons).toHaveLength(2);
+ expect(icons[1]).toHaveClass('host-icon');
+ });
+
+ it('renders configured image descriptors with alt text and classes', () => {
+ render(
+ <ThemeProvider
+ theme={{
+ brand: {
+ logo: { src: '/acme-logo.svg', alt: 'Acme logo' },
+ icon: { src: '/acme-icon.svg', alt: 'Acme icon' },
+ },
+ }}
+ >
+ <BrandLogo className="logo-image" />
+ <BrandIcon className="icon-image" />
+ </ThemeProvider>,
+ );
+
+ expect(screen.getByRole('img', { name: 'Acme logo' })).toHaveAttribute('src', '/acme-logo.svg');
+ expect(screen.getByRole('img', { name: 'Acme logo' })).toHaveClass('logo-image');
+ expect(screen.getByRole('img', { name: 'Acme icon' })).toHaveAttribute('src', '/acme-icon.svg');
+ expect(screen.getByRole('img', { name: 'Acme icon' })).toHaveClass('icon-image');
+ });
+
+ it('supports render callbacks and passes through the requested class', () => {
+ render(
+ <ThemeProvider
+ theme={{
+ brand: {
+ logo: ({ className }) => <span className={className}>Callback logo</span>,
+ icon: ({ className }) => <span className={className}>Callback icon</span>,
+ },
+ }}
+ >
+ <BrandLogo className="custom-logo" />
+ <BrandIcon className="custom-icon" />
+ </ThemeProvider>,
+ );
+
+ expect(screen.getByText('Callback logo')).toHaveClass('custom-logo');
+ expect(screen.getByText('Callback icon')).toHaveClass('custom-icon');
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/tsconfig.json b/packages/trueforge-ui-sdk/test/tsconfig.json
new file mode 100644
index 000000000..ec978a7ae
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/tsconfig.json
@@ -0,0 +1,12 @@
+{
+ "extends": "../tsconfig.json",
+ "compilerOptions": {
+ "declaration": false,
+ "declarationMap": false,
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "rootDir": "..",
+ "types": ["node", "vitest/globals"]
+ },
+ "include": ["../src", ".", "../vitest.config.ts"]
+}
diff --git a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.ts b/packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.ts
similarity index 74%
rename from packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.ts
rename to packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.ts
index c30bff1b3..c7b353726 100644
--- a/packages/trueforge-ui-sdk/src/utils/computeAgentStepsSplit.test.ts
+++ b/packages/trueforge-ui-sdk/test/utils/computeAgentStepsSplit.test.ts
@@ -1,18 +1,17 @@
import { describe, expect, it } from 'vitest';
-import type { PartState } from '@assistant-ui/core/react';
-import { computeAgentStepsSplit } from './computeAgentStepsSplit.js';
+import { computeAgentStepsSplit, type AgentStepPart } from '@/index.js';
-function text(content: string): PartState {
- return { type: 'text', text: content } as PartState;
+function text(content: string): AgentStepPart {
+ return { type: 'text', text: content };
}
-function tool(): PartState {
- return { type: 'tool-call', toolCallId: '1', toolName: 't' } as PartState;
+function tool(): AgentStepPart {
+ return { type: 'tool-call' };
}
-function reasoning(): PartState {
- return { type: 'reasoning', text: 'thinking' } as PartState;
+function reasoning(): AgentStepPart {
+ return { type: 'reasoning', text: 'thinking' };
}
describe('computeAgentStepsSplit', () => {
diff --git a/packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.ts b/packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.ts
similarity index 98%
rename from packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.ts
rename to packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.ts
index 0e86636fd..539ed5e7d 100644
--- a/packages/trueforge-ui-sdk/src/utils/toolCallParsing.test.ts
+++ b/packages/trueforge-ui-sdk/test/utils/toolCallParsing.test.ts
@@ -12,7 +12,7 @@ import {
parseSandboxArgs,
parseSandboxResult,
toStatus,
-} from './toolCallParsing.js';
+} from '@/utils/toolCallParsing.js';
describe('toolCallParsing', () => {
it('parses ask-user args', () => {
diff --git a/packages/trueforge-ui-sdk/tsconfig.json b/packages/trueforge-ui-sdk/tsconfig.json
index 6ee628623..fdeae1883 100644
--- a/packages/trueforge-ui-sdk/tsconfig.json
+++ b/packages/trueforge-ui-sdk/tsconfig.json
@@ -12,9 +12,8 @@
"sourceMap": true,
"rootDir": "src",
"outDir": "dist",
- "baseUrl": ".",
"paths": {
- "@/*": ["src/*"]
+ "@/*": ["./src/*"]
},
"noEmit": true,
"isolatedModules": true,
diff --git a/packages/trueforge-ui-sdk/tsup.config.ts b/packages/trueforge-ui-sdk/tsup.config.ts
index 9a67fad28..0b7e9f528 100644
--- a/packages/trueforge-ui-sdk/tsup.config.ts
+++ b/packages/trueforge-ui-sdk/tsup.config.ts
@@ -22,6 +22,7 @@ export default defineConfig({
},
}),
],
+ noExternal: ['react-syntax-highlighter/dist/esm/styles/prism'],
external: [
'react',
'react-dom',
@@ -36,7 +37,6 @@ export default defineConfig({
'react-markdown',
'remark-gfm',
'react-syntax-highlighter',
- 'react-syntax-highlighter/dist/esm/styles/prism',
'monaco-editor',
],
});
diff --git a/packages/trueforge-ui-sdk/vitest.config.ts b/packages/trueforge-ui-sdk/vitest.config.ts
index e2b66ef79..b5b33e62f 100644
--- a/packages/trueforge-ui-sdk/vitest.config.ts
+++ b/packages/trueforge-ui-sdk/vitest.config.ts
@@ -12,18 +12,18 @@ export default defineConfig({
},
test: {
environment: 'jsdom',
- include: ['src/**/*.test.{ts,tsx}'],
+ include: ['test/**/*.test.{ts,tsx}'],
globals: true,
- setupFiles: ['./src/testSetup.ts'],
+ setupFiles: ['./test/testSetup.ts'],
coverage: {
provider: 'v8',
include: ['src/**/*.{ts,tsx}'],
- exclude: ['src/**/*.test.{ts,tsx}', 'src/testSetup.ts', 'src/svg.d.ts'],
+ exclude: ['test/**', 'src/svg.d.ts'],
thresholds: {
- // Floor just under measured baseline (~70/67/56) so CI stays green.
- lines: 65,
- functions: 60,
- branches: 50,
+ // Floors stay below the measured baseline (~82/76/75) while preventing large regressions.
+ lines: 78,
+ functions: 73,
+ branches: 72,
},
},
},