Skip to content

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

feat: updated slots support, docs and theme (#75)

vinit-truefoundrye73dbd82d66b
diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsx
index a8648f799..394579627 100644
--- a/packages/frontend/src/App.tsx
+++ b/packages/frontend/src/App.tsx
@@ -7,7 +7,6 @@ import {
type WelcomeScreenProps,
} from '@truefoundry/trueforge-ui';
import { useEffect, useMemo, useRef, useState } from 'react';
-import './agentUiSlots';
import { getCapabilities, listModels } from './composerLists';
import { createConnectorCatalog } from './connectorCatalog';
import { createHarnessBuilderServer } from './harnessBuilderServer';
diff --git a/packages/frontend/src/agentUiSlots.ts b/packages/frontend/src/agentUiSlots.ts
deleted file mode 100644
index 2dbc20b29..000000000
--- a/packages/frontend/src/agentUiSlots.ts
+++ /dev/null
@@ -1,13 +0,0 @@
-/**
- * The SDK augments AtomSlots via an internal `../theme/SlotsProvider.js` path
- * that does not merge for package consumers. Re-declare the slots we override.
- */
-import type { WelcomeScreen } from '@truefoundry/trueforge-ui';
-
-declare module '@truefoundry/trueforge-ui' {
- interface AtomSlots {
- WelcomeScreen: typeof WelcomeScreen;
- }
-}
-
-export {};
diff --git a/packages/trueforge-ui-sdk/CHANGELOG.md b/packages/trueforge-ui-sdk/CHANGELOG.md
index d5fd5071e..f8617846f 100644
--- a/packages/trueforge-ui-sdk/CHANGELOG.md
+++ b/packages/trueforge-ui-sdk/CHANGELOG.md
@@ -38,8 +38,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
theme, Markdown, and agent-chat molecules are owned by this SDK.
- `theme` prop is now `ThemeConfig` (object), not `"light" | "dark"`. Mode
lives at `theme.mode`. Example: `theme={{ mode: "dark", preset: "claude" }}`.
-- Slot `Button` / `IconButton` use shadcn-aligned props (`variant`, `size`,
- children). Compound APIs (`Button.Primary`, `icon=` string props) are gone.
+- `AtomSlots` and `SlotOverrides` are derived from `defaultSlots`; consumer
+ module augmentation of `AtomSlots` no longer adds override keys.
+- `theme.classNames.openui` accepts only `root` and `scope`; arbitrary extra
+ keys are no longer supported.
+- Complete `SemanticTokens` objects must include `success`,
+ `successForeground`, `warning`, and `warningForeground`.
+- `Button`, `IconButton`, dialogs, sheets, avatars, and other low-level
+ primitives are customized through tokens/CSS rather than slots. Compound
+ APIs (`Button.Primary`, `icon=` string props) are gone.
- Import styles with only `@import "@truefoundry/trueforge-ui/styles.css"`
(no `tfy-web-components/theme.css`).
- `layout` accepts a built-in string **or** a host `React.ComponentType`.
@@ -89,10 +96,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
`DEFAULT_AGENT_CONFIG` exported from the main barrel.
- Owned `ThemeProvider` with light / dark / system, CSS token injection,
`theme.brand`, `theme.icons`, `theme.classNames`, `theme.className`.
+- Semantic success/warning and assistant-bubble tokens, plus complete Markdown,
+ syntax-highlighter, OpenUI, and Monaco class-name hooks.
- Presets: `truefoundry`, `claude`, `chatgpt`, `gemini`.
- `BrandLogo` / `BrandIcon` / `useBrand`; `Icon` / `IconRegistry`.
+- Registry-backed robot brand fallback and overridable welcome/OAuth state
+ icons. The standalone OAuth callback now inherits the shell theme and slots.
- In-repo Markdown (OpenUI fences + syntax-highlighter), `MonacoEditorCore`,
`CodeEditor`.
+- Public slots for agent-library/save/select controls, draft composer
+ selectors, code/content renderers, and file-download UI; nested SDK
+ composition now honors those overrides.
- Example app: preset switcher + custom layout demo; `VITE_TFY_AGENT_MODE` to
try shell modes.
@@ -158,6 +172,11 @@ import { TrueforgeUI } from '@truefoundry/trueforge-ui';
5. Optionally set `layout={MyLayout}` and style content via
`theme.classNames` or `.aui-markdown` / `.aui-syntax-highlighter` /
`.aui-openui` / `.aui-monaco`.
+6. Remove consumer `AtomSlots` module augmentations and use the documented
+ `SlotOverrides` keys.
+7. Replace custom `theme.classNames.openui` keys with `root`, `scope`, or host
+ CSS targeting `.aui-openui`.
+8. Add success/warning pairs to any complete custom `SemanticTokens` maps.
## [0.1.0]
diff --git a/packages/trueforge-ui-sdk/README.md b/packages/trueforge-ui-sdk/README.md
index 5ec8530e2..0ba094027 100644
--- a/packages/trueforge-ui-sdk/README.md
+++ b/packages/trueforge-ui-sdk/README.md
@@ -167,7 +167,7 @@ export default function App() {
| `layout` | `LayoutProp` | ✅ | Built-in layout string **or** a custom React component. |
| `agentConfig` | `AgentConfig` | — | Shell mode: SingleAgent / AgentLibrary / AgentComposer / AgentLibraryWithComposer. Defaults to library + composer. |
| `theme` | `ThemeConfig` | — | Preset, mode, tokens, brand, icons (see [Theming](#theming)). |
-| `overrides` | `Partial<SlotOverrides>` | — | Map of slot overrides (see [Overriding components](#overriding-components)). |
+| `overrides` | `SlotOverrides` | — | Map of slot overrides (see [Overriding components](#overriding-components)). |
| `className` | `string` | — | Applied to the layout root. |
| `initialSessionId` | `string` | — | Resume a specific session. |
| `onError` | `(error: unknown) => void` | — | Host error hook (runtime + server init). |
@@ -347,8 +347,16 @@ Every curated feature atom is overridable. Provide an `overrides` map to swap an
```tsx
import { TrueforgeUI, type AssistantMessageBubbleProps } from '@truefoundry/trueforge-ui';
-function MyBubble(props: AssistantMessageBubbleProps) {
- return <div className="mr-auto max-w-[75%] rounded-2xl bg-muted px-4 py-2">{props.children}</div>;
+function MyBubble({ children, error, actionBar, className }: AssistantMessageBubbleProps) {
+ return (
+ <div className={`flex flex-col gap-2 border-l-2 border-primary pl-3.5 ${className ?? ''}`}>
+ {error ? (
+ <div className="rounded-lg bg-destructive/10 px-2.5 py-2 text-[13px] text-destructive">{error}</div>
+ ) : null}
+ <div>{children}</div>
+ {actionBar}
+ </div>
+ );
}
<TrueforgeUI
diff --git a/packages/trueforge-ui-sdk/docs/architecture.md b/packages/trueforge-ui-sdk/docs/architecture.md
index 2b6d97b29..5a27825af 100644
--- a/packages/trueforge-ui-sdk/docs/architecture.md
+++ b/packages/trueforge-ui-sdk/docs/architecture.md
@@ -9,8 +9,11 @@ Presentational components. An atom:
- Does **not** import `@assistant-ui/*` or TrueFoundry runtime hooks.
- Receives data and callbacks as props.
- Owns Tailwind classes / markup for what it renders.
-- Curated atoms register on `AtomSlots` via `declare module` augmentation;
- chrome / primitives are direct imports (not slots).
+- Curated defaults live in `defaultSlots`; its keys define the public
+ `SlotOverrides` contract.
+- Per-atom `AtomSlots` augmentations verify internally that `defaultSlots`
+ includes every registered atom.
+- Low-level primitives and dedicated chrome APIs remain direct imports.
Defaults are registered in [`src/theme/defaultSlots.ts`](../src/theme/defaultSlots.ts).
@@ -20,16 +23,20 @@ Stateful glue. A container:
- Reads assistant-ui / TrueFoundry runtime hooks and primitives.
- Derives plain props and callbacks.
-- Resolves curated atoms with `useSlot("Name")`; other atoms are imported
- directly.
+- Resolves public visual atoms with `useSlot("Name")`; low-level primitives,
+ providers, and dedicated brand/layout APIs are imported directly.
- Avoids decorative styling beyond layout glue.
## Slots (`SlotsProvider`)
```tsx
+function MyWelcome({ heading = 'Welcome' }: WelcomeScreenProps) {
+ return <h1>{heading}</h1>;
+}
+
<SlotsProvider overrides={{ WelcomeScreen: MyWelcome }}>
<Thread />
-</SlotsProvider>
+</SlotsProvider>;
```
Nested providers fall through to parent overrides, then `defaultSlots`.
diff --git a/packages/trueforge-ui-sdk/docs/customization.md b/packages/trueforge-ui-sdk/docs/customization.md
index 400e99389..af2f8fe58 100644
--- a/packages/trueforge-ui-sdk/docs/customization.md
+++ b/packages/trueforge-ui-sdk/docs/customization.md
@@ -33,9 +33,10 @@ over hacking third-party CSS:
icons: { send: MySendSvg },
classNames: {
markdown: 'prose max-w-none',
- syntaxHighlighter: { root: 'rounded-lg' },
- openui: { root: 'my-openui' },
- monaco: { root: 'h-64', monacoTheme: 'vs-dark' },
+ inlineCode: 'font-semibold',
+ syntaxHighlighter: { root: 'rounded-lg', lineNumber: 'opacity-60' },
+ openui: { root: 'my-openui', scope: 'p-2' },
+ monaco: { root: 'h-64', editor: 'rounded-lg', monacoTheme: 'vs-dark' },
},
}}
/>
@@ -51,15 +52,20 @@ Public override surface (primitives stay theme/CSS — not slots):
- **Layout / composer:** `Accordion`, `AccordionSummary`, `AccordionDetails`,
`ComposerShell`, `ComposerLeftSection`, `ComposerRightSection`,
- `ComposerSendButton`, `ThreadRootShell`, `ThreadViewportShell`,
+ `ComposerSendButton`, `DraftComposerLeftSection`,
+ `DraftComposerRightSection`, `DraftCompositeSelector`, `DraftModelSelector`,
+ `ThreadRootShell`, `ThreadViewportShell`,
`ThreadComposerAreaShell`, `MessageGroup`, `ScrollToBottomButton`,
`MessageListSkeleton`, `WelcomeScreen`
- **Messages / content:** `AssistantMessageBubble`, `UserMessageBubble`,
`UserMessageEdit`, `UserMessageActionBar`, `MessageActionBar`,
`MessageErrorBanner`, `MessageIndicator`, `MessageTimestamp`, `Markdown`,
- `OpenUiFenceBlock`, `SandboxArtifactDownload`
+ `SyntaxHighlighter`, `OpenUiFenceBlock`, `SandboxArtifactDownload`,
+ `ChatFileDownload`, `MonacoEditorCore`, `CodeEditor`
- **Thread list:** `ThreadListShell`, `ThreadListNewButton`, `ThreadListRow`,
- `ThreadListRowSkeleton`, `ThreadListEmptyState`, `HistoryLoader`
+ `ThreadListRowSkeleton`, `ThreadListEmptyState`, `HistoryLoader`,
+ `AgentsLibrary`, `AgentsLibraryButton`, `SaveAgentButton`,
+ `SelectAgentEmptyState`, `ClearChatButton`
- **Attachments / toasts:** `AttachmentCard`, `AttachmentPreviewDialog`,
`AttachmentPickerButton`, `Toast`, `ToastStack`
- **Tools / prompts:** `ToolCallCard`, `ToolCallContentBlock`,
diff --git a/packages/trueforge-ui-sdk/docs/theming.md b/packages/trueforge-ui-sdk/docs/theming.md
index c4eeb4b1d..de6cf4981 100644
--- a/packages/trueforge-ui-sdk/docs/theming.md
+++ b/packages/trueforge-ui-sdk/docs/theming.md
@@ -131,11 +131,15 @@ type SemanticTokens = {
accentForeground: string;
destructive: string;
destructiveForeground: string;
+ success: string;
+ successForeground: string;
+ warning: string;
+ warningForeground: string;
border: string;
input: string;
ring: string;
radius: string;
- fontSans: string; // maps to --font-agent-ui
+ fontFamily: string; // maps to --font-agent-ui
// optional chat-specific:
userBubble?: string;
userBubbleForeground?: string;
@@ -189,6 +193,7 @@ type ThemeConfig = {
type ContentClassNames = {
/** Wrapper / prose root for rendered markdown */
markdown?: string;
+ inlineCode?: string; // Inline code rendered by Markdown
/** Non-openui fenced code blocks (syntax-highlighter root / pre / code) */
syntaxHighlighter?: {
root?: string;
@@ -199,8 +204,7 @@ type ContentClassNames = {
/** OpenUI fenced-block host + common child hooks */
openui?: {
root?: string;
- /** Extra classes forwarded into OpenUI theme/host if supported */
- [key: string]: string | undefined;
+ scope?: string;
};
/** Monaco editor / diff surfaces */
monaco?: {
@@ -234,36 +238,42 @@ function MyLayout({ className }: { className?: string }) {
}
<TrueforgeUI
- layout={MyLayout} // or "sidebar" | "drawer" | "dock" | "widget"
+ layout={MyLayout} // or 'sidebar' | 'drawer' | 'dock' | 'widget'
theme={{
- preset: "claude",
- mode: "dark",
- tokens: { primary: "#…", fontSans: '"My Font", system-ui' },
+ preset: 'claude',
+ mode: 'dark',
+ tokens: { primary: '#…', fontFamily: '"My Font", system-ui' },
brand: {
- name: "Acme Agent",
- logo: { src: "/acme-wordmark.svg", alt: "Acme" },
+ name: 'Acme Agent',
+ logo: { src: '/acme-wordmark.svg', alt: 'Acme' },
icon: MyAcmeMark,
},
- className: "my-chat",
+ className: 'my-chat',
icons: { send: MySendSvg, paperclip: MyAttachSvg },
classNames: {
- markdown: "prose prose-neutral dark:prose-invert max-w-none",
+ markdown: 'prose prose-neutral dark:prose-invert max-w-none',
+ inlineCode: 'font-semibold',
syntaxHighlighter: {
- root: "my-code-block rounded-lg",
- pre: "bg-zinc-950 p-4",
- code: "text-sm font-mono",
+ root: 'my-code-block rounded-lg',
+ pre: 'bg-zinc-950 p-4',
+ code: 'text-sm font-mono',
+ lineNumber: 'opacity-60',
},
- openui: { root: "my-openui-host" },
- monaco: { root: "my-monaco h-64", monacoTheme: "vs-dark" },
+ openui: { root: 'my-openui-host', scope: 'p-2' },
+ monaco: { root: 'my-monaco h-64', editor: 'rounded-lg', monacoTheme: 'vs-dark' },
},
}}
- overrides={{ WelcomeScreen: MyWelcome }}
/>
```
**Resolution order:** preset defaults → `tokens` → `brand` / `icons` →
`classNames` → host CSS variables (documented) → `className` utilities.
+Component resolution is separate: the nearest `SlotsProvider` override wins,
+then a parent override, then `defaultSlots`. An override receives the exact
+props object for that atom; do not assume container-composed content is passed
+as `children`.
+
**Custom styles without the object:** host CSS still works:
```css
@@ -291,12 +301,13 @@ function MyLayout({ className }: { className?: string }) {
1. All product marks render through `useBrand()` / `<BrandLogo />` /
`<BrandIcon />` — never hard-coded TFY assets in layouts or atoms.
-2. `theme.brand.logo` → headers, welcome, wide chrome.
-3. `theme.brand.icon` → widget FAB, compact headers, assistant avatar fallback
- when no user avatar is set.
+2. `BrandLogo` resolves `theme.brand.logo` first. Its default wordmark combines
+ the configured name with the resolved `BrandIcon`.
+3. `BrandIcon` resolves `theme.brand.icon`, then `theme.icons.robot`, then the
+ registry's Lucide robot fallback.
4. `theme.brand.name` → accessible labels / text next to logo when provided.
-5. Omitting `brand` keeps the default TrueFoundry (or preset) mark; hosts
- replace either or both logo and icon independently.
+5. Omitting `brand` keeps the default `TrueFoundry` name and robot mark; hosts
+ replace the logo and icon independently.
## Icon system
@@ -309,6 +320,12 @@ function MyLayout({ className }: { className?: string }) {
6. Brand marks are **not** mixed into `icons` — use `theme.brand` so product
identity stays separate from action icons.
+For named UI icons the order is `theme.icons[name]` → registry default. The
+robot is also the final brand fallback, so `theme.brand.icon` still takes
+precedence over `theme.icons.robot`. Preset-specific icons such as
+`welcome-sparkle` and OAuth state icons (`oauth-loading`, `oauth-success`,
+`oauth-error`) use the same lookup order.
+
## Layout override
`TrueforgeUI` / chat shell `layout` prop:
@@ -378,6 +395,14 @@ stylistic homages, not product replicas.
6. Preload path: replace `preloadMarkdownOpenUI` with local equivalent.
7. Pass `theme.classNames.markdown` / `openui` into the Markdown/OpenUI hosts.
+Supported hooks are `markdown`, `inlineCode`,
+`syntaxHighlighter.{root,pre,code,lineNumber}`,
+`openui.{root,scope}`, and `monaco.{root,editor,monacoTheme}`.
+
+The standalone MCP OAuth callback selected by `TrueforgeUI` skips server
+resolution, but remains inside the same theme and slot provider boundary as the
+main shell.
+
## Call flow
```
diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx b/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
index 858fe5b45..7f330fb4d 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
@@ -202,3 +202,9 @@ export function AgentsLibrary({ open, onOpenChange, onSelectAgent }: AgentsLibra
</CenteredModal>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ AgentsLibrary: typeof AgentsLibrary;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentsLibraryButton.tsx b/packages/trueforge-ui-sdk/src/atoms/AgentsLibraryButton.tsx
index 752b99a0b..29d73ba13 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AgentsLibraryButton.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/AgentsLibraryButton.tsx
@@ -5,7 +5,7 @@ import { useEffect, useState } from 'react';
import { Icon } from '../icons/Icon.js';
import { useOptionalServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
-import { AgentsLibrary } from './AgentsLibrary.js';
+import { useSlot } from '../theme/SlotsProvider.js';
import { auiButtonClass } from './lib/buttonClasses.js';
import { cn } from './lib/cn.js';
@@ -16,6 +16,7 @@ export type AgentsLibraryButtonProps = {
};
export function AgentsLibraryButton({ className, compact = false, onSelectAgent }: AgentsLibraryButtonProps) {
+ const AgentsLibrary = useSlot('AgentsLibrary');
const server = useOptionalServer();
const shell = useOptionalShellMode();
const [open, setOpen] = useState(false);
diff --git a/packages/trueforge-ui-sdk/src/atoms/AssistantMessageBubble.tsx b/packages/trueforge-ui-sdk/src/atoms/AssistantMessageBubble.tsx
index 5e588ae29..8e6904858 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AssistantMessageBubble.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/AssistantMessageBubble.tsx
@@ -13,7 +13,10 @@ export function AssistantMessageBubble({ children, error, actionBar, className }
return (
<div
data-slot="aui_assistant-message-root"
- className={cn('group/assistant relative min-w-0 max-w-full', className)}
+ className={cn(
+ 'group/assistant relative min-w-0 max-w-full bg-[var(--assistant-bubble,transparent)] text-[var(--assistant-bubble-foreground,var(--foreground))]',
+ className,
+ )}
>
<div className="min-w-0 max-w-full">
{children}
diff --git a/packages/trueforge-ui-sdk/src/atoms/ChatFileDownload.tsx b/packages/trueforge-ui-sdk/src/atoms/ChatFileDownload.tsx
index 212e7d69a..3af7a259a 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ChatFileDownload.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/ChatFileDownload.tsx
@@ -93,3 +93,9 @@ export function ChatFileDownload({ files, fileDownloadBaseUrl, onDownloadArtifac
</details>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ ChatFileDownload: typeof ChatFileDownload;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/CodeEditor.tsx b/packages/trueforge-ui-sdk/src/atoms/CodeEditor.tsx
index 8aec7c61d..a3de9fa4b 100644
--- a/packages/trueforge-ui-sdk/src/atoms/CodeEditor.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/CodeEditor.tsx
@@ -3,8 +3,9 @@
import { useCallback, useState } from 'react';
import { Icon } from '../icons/Icon.js';
+import { useSlot } from '../theme/SlotsProvider.js';
import { cn } from './lib/cn.js';
-import { MonacoEditorCore, type MonacoEditorCoreProps } from './MonacoEditorCore.js';
+import type { MonacoEditorCoreProps } from './MonacoEditorCore.js';
export type CodeEditorProps = Omit<MonacoEditorCoreProps, 'options'> & {
filename?: string;
@@ -51,6 +52,7 @@ export function CodeEditor({
height,
showToolbar = true,
}: CodeEditorProps) {
+ const MonacoEditorCore = useSlot('MonacoEditorCore');
const [showLineNumbers, setShowLineNumbers] = useState(false);
const [expanded, setExpanded] = useState(false);
const [copied, setCopied] = useState(false);
@@ -129,3 +131,9 @@ export function CodeEditor({
</div>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ CodeEditor: typeof CodeEditor;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/ComposerSections.tsx b/packages/trueforge-ui-sdk/src/atoms/ComposerSections.tsx
index 2df32378c..f4946c349 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ComposerSections.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/ComposerSections.tsx
@@ -1,5 +1,7 @@
'use client';
+import type { ReactNode } from 'react';
+
import { Spinner } from '../atoms/primitives/Spinner.js';
import { Icon } from '../icons/Icon.js';
import { auiButtonClass } from './lib/buttonClasses.js';
@@ -23,6 +25,10 @@ export type ComposerSendButtonProps = {
onCancel?: () => void;
};
+export type ComposerLeftSectionSlot = (props: ComposerLeftSectionProps) => ReactNode;
+export type ComposerRightSectionSlot = (props: ComposerRightSectionProps) => ReactNode;
+export type ComposerSendButtonSlot = (props: ComposerSendButtonProps) => ReactNode;
+
export function ComposerLeftSection({ onAttach }: ComposerLeftSectionProps) {
if (!onAttach) return null;
@@ -39,7 +45,7 @@ export function ComposerLeftSection({ onAttach }: ComposerLeftSectionProps) {
);
}
-export function ComposerRightSection(_: ComposerRightSectionProps) {
+export function ComposerRightSection(_: ComposerRightSectionProps): ReactNode {
return null;
}
@@ -72,3 +78,11 @@ export function ComposerSendButton({ canSubmit, isRunning, onSubmit, onCancel }:
</button>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ ComposerLeftSection: ComposerLeftSectionSlot;
+ ComposerRightSection: ComposerRightSectionSlot;
+ ComposerSendButton: ComposerSendButtonSlot;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/Markdown.tsx b/packages/trueforge-ui-sdk/src/atoms/Markdown.tsx
index bc093d672..d4fedbc6f 100644
--- a/packages/trueforge-ui-sdk/src/atoms/Markdown.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/Markdown.tsx
@@ -9,7 +9,7 @@ import { useOptionalContentClassNames } from '../theme/ThemeProvider.js';
import { cn } from './lib/cn.js';
import type { OpenUiFenceBlockProps } from './OpenUiFenceBlock.js';
import type { SandboxArtifactDownloadProps } from './SandboxArtifactDownload.js';
-import { SyntaxHighlighter } from './SyntaxHighlighter.js';
+import type { SyntaxHighlighterProps } from './SyntaxHighlighter.js';
/** Preloads OpenUiFenceBlock so it's ready before the user sees openui content. */
export function preloadMarkdownOpenUI(): Promise<unknown> {
@@ -36,6 +36,8 @@ function makeComponents(opts: {
readOnly?: boolean;
OpenUiFenceBlock: ComponentType<OpenUiFenceBlockProps>;
SandboxArtifactDownload: ComponentType<SandboxArtifactDownloadProps>;
+ SyntaxHighlighter: ComponentType<SyntaxHighlighterProps>;
+ inlineCodeClassName?: string;
}): Components {
const {
isStreaming,
@@ -45,6 +47,8 @@ function makeComponents(opts: {
readOnly,
OpenUiFenceBlock,
SandboxArtifactDownload,
+ SyntaxHighlighter,
+ inlineCodeClassName,
} = opts;
return {
@@ -58,7 +62,11 @@ function makeComponents(opts: {
// Inline code: no language class
if (!className) {
- return <code className="aui-inline-code rounded px-1 py-0.5 font-mono text-sm bg-muted">{children}</code>;
+ return (
+ <code className={cn('aui-inline-code rounded bg-muted px-1 py-0.5 font-mono text-sm', inlineCodeClassName)}>
+ {children}
+ </code>
+ );
}
if (language === 'openui') {
@@ -94,6 +102,7 @@ export function Markdown({
const darkTheme = mode === 'dark';
const OpenUiFenceBlock = useSlot('OpenUiFenceBlock');
const SandboxArtifactDownload = useSlot('SandboxArtifactDownload');
+ const SyntaxHighlighter = useSlot('SyntaxHighlighter');
const components = makeComponents({
isStreaming,
@@ -103,6 +112,8 @@ export function Markdown({
readOnly,
OpenUiFenceBlock,
SandboxArtifactDownload,
+ SyntaxHighlighter,
+ inlineCodeClassName: classNames.inlineCode,
});
return (
diff --git a/packages/trueforge-ui-sdk/src/atoms/MessageErrorBanner.tsx b/packages/trueforge-ui-sdk/src/atoms/MessageErrorBanner.tsx
index a6ff4969d..903468b7c 100644
--- a/packages/trueforge-ui-sdk/src/atoms/MessageErrorBanner.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/MessageErrorBanner.tsx
@@ -10,7 +10,7 @@ export function MessageErrorBanner({ message, className }: MessageErrorBannerPro
<div
role="alert"
className={cn(
- 'aui-message-error-root border-destructive bg-destructive/10 text-destructive dark:bg-destructive/5 mt-2 rounded-md border p-3 text-sm dark:text-red-200',
+ 'aui-message-error-root border-destructive bg-destructive/10 text-destructive dark:bg-destructive/5 mt-2 rounded-md border p-3 text-sm',
className,
)}
>
diff --git a/packages/trueforge-ui-sdk/src/atoms/MonacoEditorCore.tsx b/packages/trueforge-ui-sdk/src/atoms/MonacoEditorCore.tsx
index a88f27174..edcd74592 100644
--- a/packages/trueforge-ui-sdk/src/atoms/MonacoEditorCore.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/MonacoEditorCore.tsx
@@ -164,6 +164,7 @@ export function MonacoEditorCore({
}: MonacoEditorCoreProps) {
const mode = useOptionalThemeMode();
const classNames = useOptionalContentClassNames();
+ const wrapperRef = useRef<HTMLDivElement>(null);
const containerRef = useRef<HTMLDivElement>(null);
const editorRef = useRef<MonacoEditor | null>(null);
const monacoRef = useRef<MonacoModule | null>(null);
@@ -185,12 +186,12 @@ export function MonacoEditorCore({
const syncAutoHeight = () => {
const editor = editorRef.current;
- const el = containerRef.current;
+ const wrapper = wrapperRef.current;
const { minPx: min, maxPx: max, autoHeight: enabled } = clampRef.current;
- if (!editor || !el || !enabled) return;
+ if (!editor || !wrapper || !enabled) return;
const next = Math.min(max, Math.max(min, editor.getContentHeight()));
setAutoPx(next);
- el.style.height = `${next}px`;
+ wrapper.style.height = `${next}px`;
editor.layout();
};
@@ -210,8 +211,6 @@ export function MonacoEditorCore({
defineAuiThemes(monaco);
beforeMountRef.current?.(monaco);
- const initialHeight = autoHeight ? estimateHeightFromValue(value, minPx, maxPx) : height;
-
editor = monaco.editor.create(containerRef.current, {
value,
language,
@@ -221,10 +220,6 @@ export function MonacoEditorCore({
});
editorRef.current = editor;
- if (autoHeight) {
- containerRef.current.style.height =
- typeof initialHeight === 'number' ? `${initialHeight}px` : String(initialHeight);
- }
changeDisposable = editor.onDidChangeModelContent(() => {
onChangeRef.current?.(editor!.getValue());
@@ -279,9 +274,17 @@ export function MonacoEditorCore({
return (
<div
- ref={containerRef}
+ ref={wrapperRef}
className={cn('aui-monaco overflow-hidden', classNames.monaco?.root, className)}
style={{ height: styleHeight }}
- />
+ >
+ <div ref={containerRef} className={cn('h-full w-full overflow-hidden', classNames.monaco?.editor)} />
+ </div>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ MonacoEditorCore: typeof MonacoEditorCore;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/OpenUiFenceBlock.tsx b/packages/trueforge-ui-sdk/src/atoms/OpenUiFenceBlock.tsx
index 7a1c01fe3..d6aa949b9 100644
--- a/packages/trueforge-ui-sdk/src/atoms/OpenUiFenceBlock.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/OpenUiFenceBlock.tsx
@@ -18,10 +18,18 @@ export function OpenUiFenceBlock({ content, isStreaming, darkTheme }: OpenUiFenc
return (
<div className={cn('aui-openui mb-2 w-full min-w-0 max-w-full', classNames.openui?.root)}>
<ThemeProvider mode={darkTheme ? 'dark' : 'light'} cssSelector=".markdown-openui-scope">
- <div className="markdown-openui-scope min-w-0 w-full max-w-full overflow-x-auto">
+ <div
+ className={cn('markdown-openui-scope min-w-0 w-full max-w-full overflow-x-auto', classNames.openui?.scope)}
+ >
<Renderer response={content} library={openuiLibrary} isStreaming={isStreaming} />
</div>
</ThemeProvider>
</div>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ OpenUiFenceBlock: typeof OpenUiFenceBlock;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.tsx b/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.tsx
index d40449839..4eda1db33 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SandboxArtifactDownload.tsx
@@ -2,7 +2,8 @@
import { useMemo } from 'react';
-import { ChatFileDownload, type ChatFileDownloadFile } from './ChatFileDownload.js';
+import { useSlot } from '../theme/SlotsProvider.js';
+import type { ChatFileDownloadFile } from './ChatFileDownload.js';
export type SandboxArtifactDownloadProps = {
code: string;
@@ -56,6 +57,7 @@ export function SandboxArtifactDownload({
onDownloadArtifact,
readOnly,
}: SandboxArtifactDownloadProps) {
+ const ChatFileDownload = useSlot('ChatFileDownload');
const artifacts = useMemo(() => parseSandboxArtifacts(code), [code]);
if (artifacts.length === 0) return null;
diff --git a/packages/trueforge-ui-sdk/src/atoms/SandboxToolCallCard.tsx b/packages/trueforge-ui-sdk/src/atoms/SandboxToolCallCard.tsx
index 4c19e56a5..2f870a48c 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SandboxToolCallCard.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SandboxToolCallCard.tsx
@@ -1,9 +1,9 @@
'use client';
import { Icon } from '../icons/Icon.js';
+import { useSlot } from '../theme/SlotsProvider.js';
import { cn } from './lib/cn.js';
-import { MonacoEditorCore } from './MonacoEditorCore.js';
-import { ToolCallCard, type ToolCallStatus } from './ToolCallCard.js';
+import type { ToolCallStatus } from './ToolCallCard.js';
export type SandboxToolCallCardProps = {
name: string;
@@ -25,6 +25,8 @@ export type SandboxToolCallCardProps = {
};
function JsonPane({ value, className }: { value: string; className?: string }) {
+ const MonacoEditorCore = useSlot('MonacoEditorCore');
+
return (
<MonacoEditorCore
language="json"
@@ -84,9 +86,7 @@ function SandboxBody({
<span
className={cn(
'inline-flex h-6 items-center gap-1 rounded px-1.5 text-xs lowercase',
- exitCode === 0
- ? 'bg-green-500/10 text-green-700 dark:text-green-400'
- : 'bg-destructive/10 text-destructive',
+ exitCode === 0 ? 'bg-success/10 text-success' : 'bg-destructive/10 text-destructive',
)}
data-testid={dataTestPrefix ? `${dataTestPrefix}-exit-code` : undefined}
>
@@ -142,7 +142,7 @@ function SandboxBody({
</div>
)}
{resultJson && (
- <div className="my-1 border-l-4 border-purple-400 px-3">
+ <div className="my-1 border-l-4 border-primary/60 px-3">
<div className="mb-1 mt-2 font-sans text-xs font-medium leading-4">Result</div>
<JsonPane value={resultJson} className="pl-2" />
</div>
@@ -154,14 +154,14 @@ function SandboxBody({
<div className="my-1 break-all border-l-4 border-primary px-3">
<div className="mb-1 text-[12px] font-medium leading-4 text-muted-foreground">COMMAND</div>
<div>
- <span className="text-teal-500">$</span> {command}
+ <span className="text-primary">$</span> {command}
</div>
</div>
)}
{resultText ? (
<>
<div className="mx-3 my-1 border-t border-border" />
- <div className="my-1 break-all border-l-4 border-purple-400 px-3">
+ <div className="my-1 break-all border-l-4 border-primary/60 px-3">
<div className="mb-1 text-[12px] font-medium leading-4 text-muted-foreground">OUTPUT</div>
<div>{resultText}</div>
</div>
@@ -170,7 +170,7 @@ function SandboxBody({
resultJson && (
<>
<div className="mx-3 my-1 border-t border-border" />
- <div className="my-1 border-l-4 border-purple-400 px-3">
+ <div className="my-1 border-l-4 border-primary/60 px-3">
<div className="mb-1 text-[12px] font-medium leading-4 text-muted-foreground">OUTPUT</div>
<JsonPane value={resultJson} className="pl-2" />
</div>
@@ -204,6 +204,7 @@ export function SandboxToolCallCard({
dataTestPrefix,
className,
}: SandboxToolCallCardProps) {
+ const ToolCallCard = useSlot('ToolCallCard');
const awaiting = status === 'running';
return (
diff --git a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx b/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
index 9fae011fa..eff4cdc7d 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SaveAgentButton.tsx
@@ -149,3 +149,9 @@ export function SaveAgentButton() {
</>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ SaveAgentButton: typeof SaveAgentButton;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/SelectAgentEmptyState.tsx b/packages/trueforge-ui-sdk/src/atoms/SelectAgentEmptyState.tsx
index d8fc4f1c9..7731eac98 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SelectAgentEmptyState.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SelectAgentEmptyState.tsx
@@ -20,3 +20,9 @@ export function SelectAgentEmptyState() {
</div>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ SelectAgentEmptyState: typeof SelectAgentEmptyState;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/SyntaxHighlighter.tsx b/packages/trueforge-ui-sdk/src/atoms/SyntaxHighlighter.tsx
index 72cf483cc..12e31112c 100644
--- a/packages/trueforge-ui-sdk/src/atoms/SyntaxHighlighter.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/SyntaxHighlighter.tsx
@@ -1,5 +1,6 @@
'use client';
+import { Children, cloneElement, isValidElement, type ReactNode } from 'react';
import { Prism as PrismHighlighter } from 'react-syntax-highlighter';
import { oneDark, oneLight } from 'react-syntax-highlighter/dist/esm/styles/prism';
@@ -14,6 +15,21 @@ export type SyntaxHighlighterProps = {
showLineNumbers?: boolean;
};
+function applyLineNumberClassName(children: ReactNode, className: string | undefined): ReactNode {
+ if (!className) return children;
+
+ return Children.map(children, child => {
+ if (
+ !isValidElement<{ className?: string }>(child) ||
+ !child.props.className?.includes('react-syntax-highlighter-line-number')
+ ) {
+ return child;
+ }
+
+ return cloneElement(child, { className: cn(child.props.className, className) });
+ });
+}
+
export function SyntaxHighlighter({ code, language, darkTheme, className, showLineNumbers }: SyntaxHighlighterProps) {
const classNames = useOptionalContentClassNames();
const style = darkTheme ? oneDark : oneLight;
@@ -29,8 +45,8 @@ export function SyntaxHighlighter({ code, language, darkTheme, className, showLi
<PrismHighlighter
language={language}
style={style}
- showLineNumbers={showLineNumbers}
customStyle={{ margin: 0, maxWidth: '100%' }}
+ showLineNumbers={showLineNumbers}
PreTag={({ children, className: preClass, ...rest }) => (
<pre {...rest} className={cn('max-w-full overflow-x-auto', classNames.syntaxHighlighter?.pre, preClass)}>
{children}
@@ -38,7 +54,7 @@ export function SyntaxHighlighter({ code, language, darkTheme, className, showLi
)}
CodeTag={({ children, className: codeClass, ...rest }) => (
<code {...rest} className={cn(classNames.syntaxHighlighter?.code, codeClass)}>
- {children}
+ {applyLineNumberClassName(children, classNames.syntaxHighlighter?.lineNumber)}
</code>
)}
>
@@ -47,3 +63,9 @@ export function SyntaxHighlighter({ code, language, darkTheme, className, showLi
</div>
);
}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ SyntaxHighlighter: typeof SyntaxHighlighter;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/Toast.tsx b/packages/trueforge-ui-sdk/src/atoms/Toast.tsx
index f511e38af..e21a26d85 100644
--- a/packages/trueforge-ui-sdk/src/atoms/Toast.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/Toast.tsx
@@ -34,7 +34,7 @@ export function Toast({ title, description, open, onOpenChange, className }: Toa
<div
role="alert"
className={cn(
- 'font-sans-flex bg-background text-foreground pointer-events-auto flex w-full items-start gap-3 rounded-xl border border-gray-200 px-4 py-4 shadow-md dark:bg-card',
+ 'font-sans-flex bg-background text-foreground pointer-events-auto flex w-full items-start gap-3 rounded-xl border border-border px-4 py-4 shadow-md dark:bg-card',
'animate-in fade-in-0 slide-in-from-bottom-4',
className,
)}
@@ -43,7 +43,7 @@ export function Toast({ title, description, open, onOpenChange, className }: Toa
<div className="min-w-0 flex-1">
<div className="flex items-start justify-between gap-2">
- <div className="text-destructive text-sm leading-none font-semibold dark:text-red-200">{title}</div>
+ <div className="text-destructive text-sm leading-none font-semibold">{title}</div>
<div className="flex shrink-0 items-center gap-1">
<button
type="button"
diff --git a/packages/trueforge-ui-sdk/src/atoms/ToolApprovalBar.tsx b/packages/trueforge-ui-sdk/src/atoms/ToolApprovalBar.tsx
index 4d68a7bd9..d4d07a00a 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ToolApprovalBar.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/ToolApprovalBar.tsx
@@ -100,7 +100,7 @@ export function ToolApprovalBar({
<Icon
name={isDenied ? 'circle-xmark' : 'circle-check'}
size="0.875em"
- className={cn('shrink-0', isDenied ? 'text-destructive' : 'text-green-600')}
+ className={cn('shrink-0', isDenied ? 'text-destructive' : 'text-success')}
/>
)}
</div>
diff --git a/packages/trueforge-ui-sdk/src/atoms/ToolCallContentBlock.tsx b/packages/trueforge-ui-sdk/src/atoms/ToolCallContentBlock.tsx
index b6d0c049f..29292a503 100644
--- a/packages/trueforge-ui-sdk/src/atoms/ToolCallContentBlock.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/ToolCallContentBlock.tsx
@@ -5,7 +5,6 @@ import { useState } from 'react';
import { Icon } from '../icons/Icon.js';
import { useSlot } from '../theme/SlotsProvider.js';
import { cn } from './lib/cn.js';
-import { MonacoEditorCore } from './MonacoEditorCore.js';
import { Dialog, DialogContent, DialogHeader, DialogTitle } from './primitives/Dialog.js';
import { IconButton } from './primitives/IconButton.js';
@@ -35,6 +34,8 @@ function JsonEditor({
autoHeight?: boolean;
maxHeight?: string | number;
}) {
+ const MonacoEditorCore = useSlot('MonacoEditorCore');
+
return (
<MonacoEditorCore
language="json"
diff --git a/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx b/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
index bb9a9e555..dc2a46d5f 100644
--- a/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
@@ -1,6 +1,6 @@
-import { Sparkle } from 'lucide-react';
import type { ReactNode } from 'react';
+import { Icon } from '../icons/Icon.js';
import { BrandIcon } from '../theme/brand.js';
import { useOptionalThemePreset } from '../theme/ThemeProvider.js';
import { cn } from './lib/cn.js';
@@ -17,7 +17,7 @@ export function WelcomeScreen({ heading = 'How can I help you today?', icon, cla
icon !== undefined ? (
icon
) : preset === 'chatgpt' ? null : preset === 'claude' ? (
- <Sparkle aria-hidden className="size-5 fill-current text-primary" />
+ <Icon name="welcome-sparkle" className="size-5 fill-current text-primary" />
) : (
<BrandIcon className={preset === 'gemini' ? 'size-5' : 'size-10'} />
);
diff --git a/packages/trueforge-ui-sdk/src/atoms/agent-chat/AgentStepRow.tsx b/packages/trueforge-ui-sdk/src/atoms/agent-chat/AgentStepRow.tsx
index 02d71ff7c..fa87d4da0 100644
--- a/packages/trueforge-ui-sdk/src/atoms/agent-chat/AgentStepRow.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/agent-chat/AgentStepRow.tsx
@@ -122,7 +122,7 @@ export function AgentStepRow({
<Icon
name="circle-check"
size="0.875rem"
- className="shrink-0 text-green-600"
+ className="shrink-0 text-success"
data-testid={dataTestPrefix ? `${dataTestPrefix}-success-icon` : undefined}
/>
)}
@@ -144,7 +144,7 @@ export function AgentStepRow({
<div className={cn('flex shrink-0 items-center gap-2', alignStart ? 'self-start' : 'self-center')}>
{statusText && (
<span className="flex items-center gap-1">
- {isRunning && <StatusDot colorClassName="bg-orange-500" />}
+ {isRunning && <StatusDot />}
<span className="font-sans text-xs font-medium leading-4 text-muted-foreground">{statusText}</span>
</span>
)}
@@ -155,7 +155,7 @@ export function AgentStepRow({
<Spinner size={12} />
</div>
) : (
- <StatusDot colorClassName="bg-orange-500" />
+ <StatusDot />
)}
</>
)}
diff --git a/packages/trueforge-ui-sdk/src/atoms/agent-chat/StatusDot.tsx b/packages/trueforge-ui-sdk/src/atoms/agent-chat/StatusDot.tsx
index 004f21b38..bb52600a5 100644
--- a/packages/trueforge-ui-sdk/src/atoms/agent-chat/StatusDot.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/agent-chat/StatusDot.tsx
@@ -5,7 +5,7 @@ export type StatusDotProps = {
colorClassName?: string;
};
-export function StatusDot({ className, colorClassName = 'bg-orange-500' }: StatusDotProps) {
+export function StatusDot({ className, colorClassName = 'bg-warning' }: StatusDotProps) {
return (
<span aria-hidden className={cn('relative inline-flex h-2 w-2 shrink-0', className)}>
<span
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
index 7c1656f29..ab4f38c88 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
@@ -1,11 +1,13 @@
'use client';
+import { useSlot } from '../../theme/SlotsProvider.js';
import type { ComposerLeftSectionProps, ComposerRightSectionProps } from '../ComposerSections.js';
-import { DraftCompositeSelector, DraftSelectionChips } from './DraftCompositeSelector.js';
-import { DraftModelSelector } from './DraftModelSelector.js';
+import { DraftSelectionChips } from './DraftCompositeSelector.js';
import { DraftReasoningEffortSelector } from './DraftReasoningEffortSelector.js';
export function DraftComposerLeftSection({ disabled, isRunning, onAttach }: ComposerLeftSectionProps) {
+ const DraftCompositeSelector = useSlot('DraftCompositeSelector');
+
return (
<div className="flex min-w-0 flex-wrap items-center gap-1.5">
<DraftCompositeSelector disabled={disabled} isRunning={isRunning} onAttach={onAttach} />
@@ -15,6 +17,8 @@ export function DraftComposerLeftSection({ disabled, isRunning, onAttach }: Comp
}
export function DraftComposerRightSection({ disabled, isRunning }: ComposerRightSectionProps) {
+ const DraftModelSelector = useSlot('DraftModelSelector');
+
return (
<div className="flex min-w-0 items-center gap-1">
<DraftModelSelector disabled={disabled} isRunning={isRunning} />
@@ -22,3 +26,10 @@ export function DraftComposerRightSection({ disabled, isRunning }: ComposerRight
</div>
);
}
+
+declare module '../../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ DraftComposerLeftSection: typeof DraftComposerLeftSection;
+ DraftComposerRightSection: typeof DraftComposerRightSection;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
index 5ecc82099..087e3a986 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
@@ -387,3 +387,9 @@ export function DraftSelectionChips() {
</div>
);
}
+
+declare module '../../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ DraftCompositeSelector: typeof DraftCompositeSelector;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
index c1b7c946e..8e303c47b 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
@@ -196,3 +196,9 @@ export function DraftModelSelector({ disabled, isRunning }: DraftModelSelectorPr
</div>
);
}
+
+declare module '../../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ DraftModelSelector: typeof DraftModelSelector;
+ }
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/primitives/Accordion.tsx b/packages/trueforge-ui-sdk/src/atoms/primitives/Accordion.tsx
index 4c5138184..1ec122ed9 100644
--- a/packages/trueforge-ui-sdk/src/atoms/primitives/Accordion.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/primitives/Accordion.tsx
@@ -139,6 +139,14 @@ export function AccordionItem({
);
}
+declare module '../../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ Accordion: typeof Accordion;
+ AccordionSummary: typeof AccordionSummary;
+ AccordionDetails: typeof AccordionDetails;
+ }
+}
+
export function AccordionTrigger({
className,
children,
diff --git a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.tsx b/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.tsx
index 42f967d41..16221e8ea 100644
--- a/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/AssistantMessageContainer.tsx
@@ -89,7 +89,7 @@ export function AssistantMessageContainer() {
// Intermediate text inside Agent steps: muted + indented vs final answer
if (index >= 0 && index < cutIndex) {
return (
- <div className="mb-2 ml-[1.75rem] text-xs text-gray-600 dark:text-gray-400 [&_.markdown-body]:text-inherit">
+ <div className="mb-2 ml-[1.75rem] text-xs text-muted-foreground [&_.markdown-body]:text-inherit">
<AssistantTextContainer />
</div>
);
diff --git a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
index 0fa47c0e2..9cc223a37 100644
--- a/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/ComposerContainer.tsx
@@ -4,15 +4,11 @@ import { ComposerPrimitive, useAui, useAuiState } from '@assistant-ui/react';
import { useTrueFoundryCancel } from '@truefoundry/assistant-ui-runtime';
import { useRef } from 'react';
-import {
- ComposerLeftSection as DefaultComposerLeftSection,
- ComposerRightSection as DefaultComposerRightSection,
-} from '../atoms/ComposerSections.js';
import { DraftCatalogProvider } from '../atoms/draft/DraftCatalogProvider.js';
-import { DraftComposerLeftSection, DraftComposerRightSection } from '../atoms/draft/DraftComposerSections.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 { AskUserContainer } from './AskUserContainer.js';
import { ComposerAttachmentsContainer } from './AttachmentsContainer.js';
@@ -105,6 +101,8 @@ export function ComposerContainer({
const shell = useOptionalShellMode();
const parentLeftSection = useSlot('ComposerLeftSection');
const parentRightSection = useSlot('ComposerRightSection');
+ const DraftComposerLeftSection = useSlot('DraftComposerLeftSection');
+ const DraftComposerRightSection = useSlot('DraftComposerRightSection');
const canMutateSpec = shell?.mode.status === 'active' && shell.mode.isMutable;
if (pauseView.kind === 'mcp') {
@@ -121,12 +119,12 @@ export function ComposerContainer({
overrides={{
ComposerLeftSection: preferHostSlotOverride(
parentLeftSection,
- DefaultComposerLeftSection,
+ defaultSlots.ComposerLeftSection,
DraftComposerLeftSection,
),
ComposerRightSection: preferHostSlotOverride(
parentRightSection,
- DefaultComposerRightSection,
+ defaultSlots.ComposerRightSection,
DraftComposerRightSection,
),
}}
diff --git a/packages/trueforge-ui-sdk/src/containers/McpOauthContainer/PostMcpOauthScreen.tsx b/packages/trueforge-ui-sdk/src/containers/McpOauthContainer/PostMcpOauthScreen.tsx
index b7ba363fa..e4e84f739 100644
--- a/packages/trueforge-ui-sdk/src/containers/McpOauthContainer/PostMcpOauthScreen.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/McpOauthContainer/PostMcpOauthScreen.tsx
@@ -1,9 +1,9 @@
'use client';
-import { CheckCircle2, LoaderCircle, XCircle } from 'lucide-react';
import { useEffect, useState } from 'react';
import { MCP_AUTH_POPUP_CHANNEL, type McpAuthPopupMessage } from '../../hooks/useMcpAuth.js';
+import { Icon } from '../../icons/Icon.js';
const BROADCAST_RETRY_DELAY_MS = 1000;
const WINDOW_CLOSE_DELAY_MS = 2000;
@@ -54,11 +54,11 @@ const PostMcpOauthScreen = () => {
<main className="flex min-h-screen items-center justify-center bg-background p-6">
<div className="flex w-full max-w-md flex-col items-center gap-3 rounded-2xl border border-border bg-card p-8 text-center shadow-sm">
{result === undefined ? (
- <LoaderCircle className="size-16 animate-spin text-muted-foreground" aria-hidden />
+ <Icon name="oauth-loading" className="size-16 animate-spin text-muted-foreground" />
) : isSuccess ? (
- <CheckCircle2 className="size-16 text-green-600" aria-hidden />
+ <Icon name="oauth-success" className="size-16 text-success" />
) : (
- <XCircle className="size-16 text-destructive" aria-hidden />
+ <Icon name="oauth-error" className="size-16 text-destructive" />
)}
<h1 className="text-2xl font-semibold text-foreground">{title}</h1>
<p className="text-sm leading-6 text-muted-foreground">{description}</p>
diff --git a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx b/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx
index 9bd1b0432..e2441c4a3 100644
--- a/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/ToolGroupContainer.test.tsx
@@ -60,7 +60,7 @@ describe('AgentSteps grouping', () => {
fireEvent.click(screen.getByText('Agent steps'));
const intermediate = screen.getByText("I'll delegate this to a sub-agent.");
const stepTextWrap = intermediate.closest("[class*='ml-[1.75rem]']");
- expect(stepTextWrap).toHaveClass('mb-2', 'text-gray-600', 'dark:text-gray-400');
+ expect(stepTextWrap).toHaveClass('mb-2', 'text-muted-foreground');
const finalAnswer = screen.getByText('Here is the final answer.');
expect(finalAnswer.closest("[class*='ml-[1.75rem]']")).toBeNull();
});
diff --git a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.tsx b/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.tsx
index 4ee6ba7e9..d55551a8e 100644
--- a/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/TrueforgeUI.tsx
@@ -189,8 +189,14 @@ export function TrueforgeUI(props: TrueforgeUIProps) {
const isMcpAuthScreen =
typeof window !== 'undefined' && new URLSearchParams(window.location.search).get('screenType') === 'mcp-auth';
- // Kept in a wrapper so the OAuth callback screen renders without resolving a server.
- return isMcpAuthScreen ? <PostMcpOauthScreen /> : <TrueforgeUIShell {...props} />;
+ // The callback skips server resolution but still inherits host theme and slots.
+ return isMcpAuthScreen ? (
+ <SlotsProvider overrides={props.overrides} theme={props.theme}>
+ <PostMcpOauthScreen />
+ </SlotsProvider>
+ ) : (
+ <TrueforgeUIShell {...props} />
+ );
}
function TrueforgeUIShell(props: TrueforgeUIProps) {
diff --git a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.tsx b/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.tsx
index c757429e1..d1631a791 100644
--- a/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/UserEditComposerContainer.tsx
@@ -34,10 +34,10 @@ export function UserEditComposerContainer() {
className="fade-in slide-in-from-bottom-1 animate-in flex w-full justify-end px-2 duration-150"
>
<UserMessageEdit
- timestamp={<MessageTimestamp createdAt={createdAt} className="text-gray-500" />}
+ timestamp={<MessageTimestamp createdAt={createdAt} />}
attachments={<ReadOnlyMessageAttachments />}
input={
- <div className="mt-1 rounded border border-gray-250 bg-gray-100 p-2 text-gray-750 dark:border-gray-275 dark:bg-gray-275">
+ <div className="mt-1 rounded border border-border bg-muted p-2 text-foreground">
<ComposerPrimitive.Input
data-slot="aui_user-edit-input"
disabled={isRunning}
diff --git a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
index 52abfb677..ff5ceacdd 100644
--- a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
+++ b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx
@@ -43,6 +43,7 @@ import {
RotateCw,
Search,
Settings,
+ Sparkle,
Sun,
Terminal,
Trash2,
@@ -110,6 +111,10 @@ const defaults: Record<string, LucideIcon> = {
clock: Clock,
'circle-check': CircleCheck,
'circle-xmark': CircleX,
+ 'oauth-success': CircleCheck,
+ 'oauth-error': CircleX,
+ 'oauth-loading': Loader2,
+ 'welcome-sparkle': Sparkle,
robot: Bot,
funnel: ListFilter,
plug: Plug,
diff --git a/packages/trueforge-ui-sdk/src/index.ts b/packages/trueforge-ui-sdk/src/index.ts
index 539e24afa..c25a60a7a 100644
--- a/packages/trueforge-ui-sdk/src/index.ts
+++ b/packages/trueforge-ui-sdk/src/index.ts
@@ -5,8 +5,9 @@ import './icons/registerAgentIcons.js';
export { BrandIcon, BrandLogo } from './theme/brand.js';
export { defaultSlots } from './theme/defaultSlots.js';
export { PRESETS, resolvePresetTokens } from './theme/presets/index.js';
+export type { PublicAtomSlots as AtomSlots, SlotOverrides } from './theme/publicSlots.js';
export { SlotsProvider, useSlot, useThemeMode } from './theme/SlotsProvider.js';
-export type { AtomSlots, SlotOverrides, ThemeMode } from './theme/SlotsProvider.js';
+export type { ThemeMode } from './theme/SlotsProvider.js';
export {
ThemeProvider,
useBrand,
diff --git a/packages/trueforge-ui-sdk/src/layouts/DrawerLayout.tsx b/packages/trueforge-ui-sdk/src/layouts/DrawerLayout.tsx
index 613069bfd..0683dcb64 100644
--- a/packages/trueforge-ui-sdk/src/layouts/DrawerLayout.tsx
+++ b/packages/trueforge-ui-sdk/src/layouts/DrawerLayout.tsx
@@ -4,8 +4,6 @@ import { useEffect, useRef, useState } from 'react';
import { useAui } from '../assistant-ui.js';
import { NamedAgentHeaderLabel } from '../atoms/NamedAgentHeaderLabel.js';
-import { SaveAgentButton } from '../atoms/SaveAgentButton.js';
-import { SelectAgentEmptyState } from '../atoms/SelectAgentEmptyState.js';
import { ShellActions } from '../atoms/ShellActions.js';
import { auiButtonClass } from '../atoms/lib/buttonClasses.js';
import { cn } from '../atoms/lib/cn.js';
@@ -20,6 +18,8 @@ export function DrawerLayout({ className }: { className?: string }) {
const aui = useAui();
const shell = useOptionalShellMode();
const ClearChatButton = useSlot('ClearChatButton');
+ const SaveAgentButton = useSlot('SaveAgentButton');
+ const SelectAgentEmptyState = useSlot('SelectAgentEmptyState');
const [threadsOpen, setThreadsOpen] = useState(false);
const threadsBtnRef = useRef<HTMLButtonElement>(null);
const dialogRef = useRef<HTMLDivElement>(null);
diff --git a/packages/trueforge-ui-sdk/src/layouts/SidebarLayout.tsx b/packages/trueforge-ui-sdk/src/layouts/SidebarLayout.tsx
index dee8dd571..8427a9a5f 100644
--- a/packages/trueforge-ui-sdk/src/layouts/SidebarLayout.tsx
+++ b/packages/trueforge-ui-sdk/src/layouts/SidebarLayout.tsx
@@ -6,8 +6,6 @@ import { useAui } from '../assistant-ui.js';
import { auiButtonClass } from '../atoms/lib/buttonClasses.js';
import { cn } from '../atoms/lib/cn.js';
import { NamedAgentHeaderLabel } from '../atoms/NamedAgentHeaderLabel.js';
-import { SaveAgentButton } from '../atoms/SaveAgentButton.js';
-import { SelectAgentEmptyState } from '../atoms/SelectAgentEmptyState.js';
import { ShellActions } from '../atoms/ShellActions.js';
import TruefoundrySettingsBuilder from '../containers/SettingsBuilder/index.js';
import { Thread } from '../containers/Thread.js';
@@ -27,6 +25,8 @@ export function SidebarLayout({ className }: { className?: string }) {
const brand = useBrand();
const AgentsLibraryButton = useSlot('AgentsLibraryButton');
const ClearChatButton = useSlot('ClearChatButton');
+ const SaveAgentButton = useSlot('SaveAgentButton');
+ const SelectAgentEmptyState = useSlot('SelectAgentEmptyState');
const [collapsed, setCollapsed] = useState(desktopCollapsed);
const setDesktopCollapsed = (value: boolean | ((prev: boolean) => boolean)) => {
setCollapsed(prev => {
diff --git a/packages/trueforge-ui-sdk/src/layouts/StackChatPanel.tsx b/packages/trueforge-ui-sdk/src/layouts/StackChatPanel.tsx
index 548dd1c24..bd9cb1b92 100644
--- a/packages/trueforge-ui-sdk/src/layouts/StackChatPanel.tsx
+++ b/packages/trueforge-ui-sdk/src/layouts/StackChatPanel.tsx
@@ -4,8 +4,6 @@ import { useEffect, useState, type ReactNode } from 'react';
import { useAui } from '../assistant-ui.js';
import { NamedAgentHeaderLabel } from '../atoms/NamedAgentHeaderLabel.js';
-import { SaveAgentButton } from '../atoms/SaveAgentButton.js';
-import { SelectAgentEmptyState } from '../atoms/SelectAgentEmptyState.js';
import { ShellActions } from '../atoms/ShellActions.js';
import { auiButtonClass } from '../atoms/lib/buttonClasses.js';
import { cn } from '../atoms/lib/cn.js';
@@ -31,6 +29,8 @@ export function StackChatPanel({ className, threadHeaderEnd }: StackChatPanelPro
const aui = useAui();
const shell = useOptionalShellMode();
const ClearChatButton = useSlot('ClearChatButton');
+ const SaveAgentButton = useSlot('SaveAgentButton');
+ const SelectAgentEmptyState = useSlot('SelectAgentEmptyState');
const isIdle = shell?.mode.status === 'idle';
const settingsOpen = shell?.settingsOpen === true;
diff --git a/packages/trueforge-ui-sdk/src/styles.css b/packages/trueforge-ui-sdk/src/styles.css
index bcc1a370d..9f470a225 100644
--- a/packages/trueforge-ui-sdk/src/styles.css
+++ b/packages/trueforge-ui-sdk/src/styles.css
@@ -90,6 +90,10 @@
--accent-foreground: var(--color-gray-1000);
--destructive: var(--color-red-500);
--destructive-foreground: var(--color-white);
+ --success: #16a34a;
+ --success-foreground: var(--color-white);
+ --warning: #d97706;
+ --warning-foreground: var(--color-white);
--border: var(--color-gray-250);
--input: var(--color-gray-250);
--ring: var(--color-black);
@@ -135,6 +139,10 @@
--accent-foreground: var(--color-gray-1000);
--destructive: var(--color-red-500);
--destructive-foreground: var(--color-white);
+ --success: #4ade80;
+ --success-foreground: #052e16;
+ --warning: #fbbf24;
+ --warning-foreground: #422006;
--border: var(--color-gray-275);
--input: var(--color-gray-275);
--ring: var(--color-indigo-500);
@@ -267,6 +275,10 @@
--color-accent-foreground: var(--accent-foreground);
--color-destructive: var(--destructive);
--color-destructive-foreground: var(--destructive-foreground);
+ --color-success: var(--success);
+ --color-success-foreground: var(--success-foreground);
+ --color-warning: var(--warning);
+ --color-warning-foreground: var(--warning-foreground);
--color-border: var(--border);
--color-input: var(--input);
--color-ring: var(--ring);
diff --git a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
index 8921b0657..ff754ebac 100644
--- a/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
+++ b/packages/trueforge-ui-sdk/src/theme/SlotsProvider.tsx
@@ -1,34 +1,21 @@
import { createContext, useContext, useMemo, type ReactNode } from 'react';
-import type {
- ComposerLeftSectionProps,
- ComposerRightSectionProps,
- ComposerSendButtonProps,
-} from '../atoms/ComposerSections.js';
import { defaultSlots } from './defaultSlots.js';
+import type { PublicAtomSlots, SlotOverrides } from './publicSlots.js';
import { ThemeProvider, useOptionalThemeMode } from './ThemeProvider.js';
import type { ThemeConfig } from './types.js';
export type { ThemeConfig, ThemeMode } from './types.js';
/**
- * Registry of atom-name -> atom-implementation. Empty by default; each atom module
- * augments this interface via `declare module "../theme/SlotsProvider"` when it is
- * introduced, so adding an atom never requires editing this file or any container.
+ * Internal completeness contract augmented by each slotted atom.
+ * `defaultSlots` satisfies this interface and owns the public slot keys.
*/
-export interface AtomSlots {
- ComposerLeftSection: ComposerLeftSectionSlot;
- ComposerRightSection: ComposerRightSectionSlot;
- ComposerSendButton: ComposerSendButtonSlot;
-}
-
-export type ComposerLeftSectionSlot = (props: ComposerLeftSectionProps) => ReactNode;
-export type ComposerRightSectionSlot = (props: ComposerRightSectionProps) => ReactNode;
-export type ComposerSendButtonSlot = (props: ComposerSendButtonProps) => ReactNode;
+export interface AtomSlots {}
-export type SlotOverrides = Partial<AtomSlots>;
+export type { SlotOverrides } from './publicSlots.js';
-const SlotsContext = createContext<AtomSlots>(defaultSlots);
+const SlotsContext = createContext<PublicAtomSlots>(defaultSlots);
const ThemeModeContext = createContext<'light' | 'dark' | undefined>(undefined);
/** Merges `overrides` over parent/default slots. Containers resolve atoms via `useSlot`. */
@@ -44,7 +31,7 @@ export function SlotsProvider({
}) {
const parentSlots = useContext(SlotsContext);
const inheritedTheme = useContext(ThemeModeContext);
- const resolved = useMemo(() => ({ ...parentSlots, ...overrides }) as AtomSlots, [parentSlots, overrides]);
+ const resolved = useMemo(() => ({ ...parentSlots, ...overrides }), [parentSlots, overrides]);
const slotsTree = (
<SlotsProviderContents slots={resolved} inheritedTheme={inheritedTheme} theme={theme}>
@@ -68,7 +55,7 @@ function SlotsProviderContents({
inheritedTheme,
theme,
}: {
- slots: AtomSlots;
+ slots: PublicAtomSlots;
children: ReactNode;
inheritedTheme: 'light' | 'dark' | undefined;
theme?: ThemeConfig;
@@ -85,7 +72,7 @@ function SlotsProviderContents({
}
/** Resolves the atom implementation registered for `name` -- default unless overridden. */
-export function useSlot<K extends keyof AtomSlots>(name: K): AtomSlots[K] {
+export function useSlot<K extends keyof PublicAtomSlots>(name: K): PublicAtomSlots[K] {
const slots = useContext(SlotsContext);
return slots[name];
}
diff --git a/packages/trueforge-ui-sdk/src/theme/brand.tsx b/packages/trueforge-ui-sdk/src/theme/brand.tsx
index 6b9f1060e..35f144a08 100644
--- a/packages/trueforge-ui-sdk/src/theme/brand.tsx
+++ b/packages/trueforge-ui-sdk/src/theme/brand.tsx
@@ -5,28 +5,18 @@ import type { ReactNode } from 'react';
import { useContext } from 'react';
import { cn } from '../atoms/lib/cn.js';
+import { Icon } from '../icons/Icon.js';
import { ThemeContext } from './ThemeProvider.js';
import type { BrandConfig, BrandImage } from './types.js';
function DefaultBrandIcon({ className }: { className?: string }) {
- return (
- <svg className={className} viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden>
- <rect width="24" height="24" rx="6" fill="currentColor" opacity="0.12" />
- <path
- d="M7 12.5 10.2 16 17 8"
- stroke="currentColor"
- strokeWidth="2"
- strokeLinecap="round"
- strokeLinejoin="round"
- />
- </svg>
- );
+ return <Icon name="robot" className={className} />;
}
function DefaultBrandLogo({ className, name }: { className?: string; name: string }) {
return (
<span className={cn('inline-flex items-center gap-2 font-semibold tracking-tight', className)}>
- <DefaultBrandIcon className="size-5" />
+ <BrandIcon className="size-5" />
<span>{name}</span>
</span>
);
diff --git a/packages/trueforge-ui-sdk/src/theme/defaultSlots.ts b/packages/trueforge-ui-sdk/src/theme/defaultSlots.ts
index 48c12c11d..1e2b585aa 100644
--- a/packages/trueforge-ui-sdk/src/theme/defaultSlots.ts
+++ b/packages/trueforge-ui-sdk/src/theme/defaultSlots.ts
@@ -5,26 +5,36 @@ import { AskUserPrompt } from '../atoms/adapters/AskUserPromptAdapter.js';
import { McpAuthPrompt } from '../atoms/adapters/McpAuthPromptAdapter.js';
import { ReasoningCard } from '../atoms/adapters/ReasoningCardAdapter.js';
+import { AgentsLibrary } from '../atoms/AgentsLibrary.js';
import { AgentsLibraryButton } from '../atoms/AgentsLibraryButton.js';
import { AssistantMessageBubble } from '../atoms/AssistantMessageBubble.js';
import { AttachmentCard } from '../atoms/AttachmentCard.js';
import { AttachmentPickerButton } from '../atoms/AttachmentPickerButton.js';
import { AttachmentPreviewDialog } from '../atoms/AttachmentPreviewDialog.js';
+import { ChatFileDownload } from '../atoms/ChatFileDownload.js';
import { ClearChatButton } from '../atoms/ClearChatButton.js';
+import { CodeEditor } from '../atoms/CodeEditor.js';
import { ComposerLeftSection, ComposerRightSection, ComposerSendButton } from '../atoms/ComposerSections.js';
import { ComposerShell } from '../atoms/ComposerShell.js';
+import { DraftComposerLeftSection, DraftComposerRightSection } from '../atoms/draft/DraftComposerSections.js';
+import { DraftCompositeSelector } from '../atoms/draft/DraftCompositeSelector.js';
+import { DraftModelSelector } from '../atoms/draft/DraftModelSelector.js';
import { HistoryLoader } from '../atoms/HistoryLoader.js';
import { Markdown } from '../atoms/Markdown.js';
import { MessageActionBar } from '../atoms/MessageActionBar.js';
import { MessageErrorBanner } from '../atoms/MessageErrorBanner.js';
import { MessageIndicator } from '../atoms/MessageIndicator.js';
import { MessageTimestamp } from '../atoms/MessageTimestamp.js';
+import { MonacoEditorCore } from '../atoms/MonacoEditorCore.js';
import { OpenUiFenceBlock } from '../atoms/OpenUiFenceBlock.js';
import { SandboxArtifactDownload } from '../atoms/SandboxArtifactDownload.js';
import { SandboxToolCallCard } from '../atoms/SandboxToolCallCard.js';
+import { SaveAgentButton } from '../atoms/SaveAgentButton.js';
import { ScrollToBottomButton } from '../atoms/ScrollToBottomButton.js';
+import { SelectAgentEmptyState } from '../atoms/SelectAgentEmptyState.js';
import { MessageListSkeleton } from '../atoms/Skeletons.js';
import { SubAgentCard } from '../atoms/SubAgentCard.js';
+import { SyntaxHighlighter } from '../atoms/SyntaxHighlighter.js';
import {
ThreadListEmptyState,
ThreadListNewButton,
@@ -53,7 +63,7 @@ import type { AtomSlots } from './SlotsProvider.js';
// import { Avatar, AvatarFallback, AvatarImage } from "../atoms/primitives/Avatar.js";
/** Default slot implementations. Feature atoms + chrome; primitives via theme/CSS. */
-export const defaultSlots: AtomSlots = {
+export const defaultSlots = {
Accordion,
AccordionSummary,
AccordionDetails,
@@ -61,6 +71,10 @@ export const defaultSlots: AtomSlots = {
ComposerLeftSection,
ComposerRightSection,
ComposerSendButton,
+ DraftComposerLeftSection,
+ DraftComposerRightSection,
+ DraftCompositeSelector,
+ DraftModelSelector,
AssistantMessageBubble,
UserMessageBubble,
UserMessageEdit,
@@ -70,8 +84,12 @@ export const defaultSlots: AtomSlots = {
MessageIndicator,
MessageTimestamp,
Markdown,
+ SyntaxHighlighter,
OpenUiFenceBlock,
SandboxArtifactDownload,
+ ChatFileDownload,
+ MonacoEditorCore,
+ CodeEditor,
WelcomeScreen,
ToolCallCard,
ToolCallContentBlock,
@@ -89,7 +107,10 @@ export const defaultSlots: AtomSlots = {
ScrollToBottomButton,
ThreadListRow,
ThreadListNewButton,
+ AgentsLibrary,
AgentsLibraryButton,
+ SaveAgentButton,
+ SelectAgentEmptyState,
ClearChatButton,
ThreadListRowSkeleton,
ThreadListEmptyState,
@@ -102,13 +123,4 @@ export const defaultSlots: AtomSlots = {
MessageGroup,
Toast,
ToastStack,
-};
-
-declare module './SlotsProvider.js' {
- interface AtomSlots {
- Accordion: typeof Accordion;
- AccordionSummary: typeof AccordionSummary;
- AccordionDetails: typeof AccordionDetails;
- OpenUiFenceBlock: typeof OpenUiFenceBlock;
- }
-}
+} satisfies AtomSlots;
diff --git a/packages/trueforge-ui-sdk/src/theme/presets/index.ts b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
index 9a3fde439..264179a89 100644
--- a/packages/trueforge-ui-sdk/src/theme/presets/index.ts
+++ b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
@@ -23,11 +23,15 @@ const truefoundry: PresetTokens = {
accentForeground: '#09090b',
destructive: '#ef4444',
destructiveForeground: '#ffffff',
+ success: '#16a34a',
+ successForeground: '#ffffff',
+ warning: '#d97706',
+ warningForeground: '#ffffff',
border: '#e4e4e7',
input: '#e4e4e7',
ring: '#09090b',
radius: '0.5rem',
- fontSans: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+ fontFamily: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
composerRadius: '1.5rem',
userBubble: '#09090b',
userBubbleForeground: '#ffffff',
@@ -49,11 +53,15 @@ const truefoundry: PresetTokens = {
accentForeground: '#fdfdfd',
destructive: '#ef4444',
destructiveForeground: '#ffffff',
+ success: '#4ade80',
+ successForeground: '#052e16',
+ warning: '#fbbf24',
+ warningForeground: '#422006',
border: '#343439',
input: '#343439',
ring: '#6366f1',
radius: '0.5rem',
- fontSans: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+ fontFamily: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
composerRadius: '1.5rem',
userBubble: '#6366f1',
userBubbleForeground: '#ffffff',
@@ -79,11 +87,15 @@ const claude: PresetTokens = {
accentForeground: '#1a1a18',
destructive: '#d03b3b',
destructiveForeground: '#ffffff',
+ success: '#15803d',
+ successForeground: '#ffffff',
+ warning: '#b45309',
+ warningForeground: '#ffffff',
border: '#e5e0d6',
input: '#e5e0d6',
ring: '#c96442',
radius: '1rem',
- fontSans: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
+ fontFamily: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
composerRadius: '1rem',
userBubble: '#e5e0d6',
userBubbleForeground: '#1a1a18',
@@ -105,11 +117,15 @@ const claude: PresetTokens = {
accentForeground: '#eeeeee',
destructive: '#d03b3b',
destructiveForeground: '#ffffff',
+ success: '#4ade80',
+ successForeground: '#052e16',
+ warning: '#fbbf24',
+ warningForeground: '#422006',
border: '#3d3a35',
input: '#3d3a35',
ring: '#c96442',
radius: '1rem',
- fontSans: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
+ fontFamily: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
composerRadius: '1rem',
userBubble: '#3d3a35',
userBubbleForeground: '#eeeeee',
@@ -135,11 +151,15 @@ const chatgpt: PresetTokens = {
accentForeground: '#0d0d0d',
destructive: '#ff002a',
destructiveForeground: '#ffffff',
+ success: '#16a34a',
+ successForeground: '#ffffff',
+ warning: '#d97706',
+ warningForeground: '#ffffff',
border: '#e5e5e5',
input: '#e5e5e5',
ring: '#0d0d0d',
radius: '1.5rem',
- fontSans: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+ fontFamily: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
composerRadius: '1.75rem',
userBubble: '#e9e9e980',
userBubbleForeground: '#0d0d0d',
@@ -161,11 +181,15 @@ const chatgpt: PresetTokens = {
accentForeground: '#ffffff',
destructive: '#ff002a',
destructiveForeground: '#ffffff',
+ success: '#4ade80',
+ successForeground: '#052e16',
+ warning: '#fbbf24',
+ warningForeground: '#422006',
border: '#ffffff26',
input: '#ffffff26',
ring: '#ffffff',
radius: '1.5rem',
- fontSans: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+ fontFamily: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
composerRadius: '1.75rem',
userBubble: '#323232',
userBubbleForeground: '#ffffff',
@@ -191,11 +215,15 @@ const gemini: PresetTokens = {
accentForeground: '#1f1f1f',
destructive: '#b3261e',
destructiveForeground: '#ffffff',
+ success: '#188038',
+ successForeground: '#ffffff',
+ warning: '#b06000',
+ warningForeground: '#ffffff',
border: '#dadce0',
input: '#dadce0',
ring: '#1f3b9b',
radius: '1rem',
- fontSans: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+ fontFamily: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
composerRadius: '2rem',
userBubble: '#f3f6fc',
userBubbleForeground: '#1f1f1f',
@@ -217,11 +245,15 @@ const gemini: PresetTokens = {
accentForeground: '#e3e3e3',
destructive: '#f2b8b5',
destructiveForeground: '#601410',
+ success: '#81c995',
+ successForeground: '#0d3b1e',
+ warning: '#fdd663',
+ warningForeground: '#4a3000',
border: '#3c4043',
input: '#3c4043',
ring: '#a8c7fa',
radius: '1rem',
- fontSans: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+ fontFamily: '"GeistSans", "GeistSans Fallback", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
composerRadius: '2rem',
userBubble: '#222327',
userBubbleForeground: '#e3e3e3',
diff --git a/packages/trueforge-ui-sdk/src/theme/publicSlots.ts b/packages/trueforge-ui-sdk/src/theme/publicSlots.ts
new file mode 100644
index 000000000..7275fc4bf
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/theme/publicSlots.ts
@@ -0,0 +1,5 @@
+import type { defaultSlots } from './defaultSlots.js';
+
+export type PublicAtomSlots = typeof defaultSlots;
+
+export type SlotOverrides = Partial<PublicAtomSlots>;
diff --git a/packages/trueforge-ui-sdk/src/theme/types.ts b/packages/trueforge-ui-sdk/src/theme/types.ts
index 37bdc7e7f..53cc2c7c7 100644
--- a/packages/trueforge-ui-sdk/src/theme/types.ts
+++ b/packages/trueforge-ui-sdk/src/theme/types.ts
@@ -22,11 +22,15 @@ export type SemanticTokens = {
accentForeground: string;
destructive: string;
destructiveForeground: string;
+ success: string;
+ successForeground: string;
+ warning: string;
+ warningForeground: string;
border: string;
input: string;
ring: string;
radius: string;
- fontSans: string;
+ fontFamily: string;
composerRadius?: string;
userBubble?: string;
userBubbleForeground?: string;
@@ -59,6 +63,7 @@ export type BrandConfig = {
export type ContentClassNames = {
markdown?: string;
+ inlineCode?: string;
syntaxHighlighter?: {
root?: string;
pre?: string;
@@ -67,7 +72,7 @@ export type ContentClassNames = {
};
openui?: {
root?: string;
- [key: string]: string | undefined;
+ scope?: string;
};
monaco?: {
root?: string;
@@ -108,11 +113,15 @@ export const TOKEN_CSS_VARS: Record<keyof SemanticTokens, string> = {
accentForeground: '--accent-foreground',
destructive: '--destructive',
destructiveForeground: '--destructive-foreground',
+ success: '--success',
+ successForeground: '--success-foreground',
+ warning: '--warning',
+ warningForeground: '--warning-foreground',
border: '--border',
input: '--input',
ring: '--ring',
radius: '--radius',
- fontSans: '--font-agent-ui',
+ fontFamily: '--font-agent-ui',
composerRadius: '--composer-radius',
userBubble: '--user-bubble',
userBubbleForeground: '--user-bubble-foreground',