Containers

Containers are connected to the chat runtime and take most of their data from context, so they need few props. Use them to build a custom layout.

Primary

Export	Props	Purpose
`Thread`	none	Convenience wrapper: `<ThreadContainer composer={<ComposerContainer />} />`.
`ThreadContainer`	`{ composer?: ReactNode }`	The message transcript with an optional composer slot beneath it.
`ComposerContainer`	`{ placeholder?: string }`	Input, attachments, model label, send/cancel.
`ThreadListContainer`	`{ onThreadOpen?: () => void }`	Session list with new-chat affordance.
`TrueForgeChatProvider`	see below	Mounts the chat runtime.

type TrueForgeChatProviderProps = {
  server: AgentUIServer;
  initialSessionId?: string;
  adapters?: UseTrueForgeAgentRuntimeOptions["adapters"];
  onError?: (error: unknown) => void;
  children: ReactNode;
  agent?: TrueForgeAgentConfig;
  agentName?: string;
  listSessionsAgentId?: string;
};

Use agent to select which agent the provider runs; agentName is a string-only shorthand kept for compatibility. listSessionsAgentId is forwarded to listSessions to filter the history list to a single agent — that is how TrueForgeUI scopes the thread list.

Message and content wiring

AssistantMessageContainer, AssistantTextContainer, UserMessageContainer, UserEditComposerContainer, MessageAttachmentsContainer, HistoryLoaderContainer, ReasoningContainer.

Tools

ToolCallContainer, ToolCallContentBlockContainer, ToolGroupContainer, ToolApprovalContainer, AgentStepsContainer, AskUserContainer.

Composer attachments

ComposerAttachmentsContainer, ComposerAttachmentPickerContainer.

MCP OAuth

McpAuthContainer, PostMcpOauthScreen.

Notifications

ToasterProvider, useToaster(), useToasterOptional().

The settings panel is part of the built-in layouts and has no standalone container. Custom layouts supply their own, built against the catalog server.

Getting Started

TrueForge Harness

SDK

UI Chat

Project

Primary

Message and content wiring

Tools

Composer attachments

MCP OAuth

Notifications

​Primary

​Message and content wiring

​Tools

​Composer attachments

​MCP OAuth

​Notifications

Primary

Message and content wiring

Tools

Composer attachments

MCP OAuth

Notifications