Skip to content

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

fix(ui): update logos and improve tooltip functionality and connector (#183)

Vinit17dedf9a27b7
diff --git a/docs/ui-sdk/guides/layouts-and-theme.mdx b/docs/ui-sdk/guides/layouts-and-theme.mdx
index ae6161f4d..b145fa757 100644
--- a/docs/ui-sdk/guides/layouts-and-theme.mdx
+++ b/docs/ui-sdk/guides/layouts-and-theme.mdx
@@ -64,7 +64,7 @@ You can choose from four preset themes - Claude, ChaptGPT, Gemini, TrueFoundry o
```ts
type ThemeConfig = {
- preset?: "truefoundry" | "claude" | "chatgpt" | "gemini"; // default "truefoundry"
+ preset?: "trueforge" | "claude" | "chatgpt" | "gemini"; // default "trueforge"
mode?: "light" | "dark" | "system";
brand?: {
name: string; // required when `brand` is set
@@ -88,7 +88,7 @@ type ThemeConfig = {
/>
```
-The `chatgpt`, `claude`, and `gemini` presets (the default is `truefoundry`):
+The `chatgpt`, `claude`, and `gemini` presets (the default is `trueforge`):
<Columns cols={3}>
<Frame caption="chatgpt">
diff --git a/docs/ui-sdk/reference/theme.mdx b/docs/ui-sdk/reference/theme.mdx
index fdcc4bfba..fb55845fd 100644
--- a/docs/ui-sdk/reference/theme.mdx
+++ b/docs/ui-sdk/reference/theme.mdx
@@ -40,7 +40,7 @@ description: "Theme provider, hooks, presets, brand, and slots."
`SlotOverrides`.
```ts
-type ThemePreset = "truefoundry" | "claude" | "chatgpt" | "gemini";
+type ThemePreset = "trueforge" | "claude" | "chatgpt" | "gemini";
type ThemeMode = "light" | "dark" | "system";
type SlotOverrides = Partial<AtomSlots>;
```
diff --git a/docs/ui-sdk/reference/trueforge-ui.mdx b/docs/ui-sdk/reference/trueforge-ui.mdx
index 419f83c0c..a8bc56643 100644
--- a/docs/ui-sdk/reference/trueforge-ui.mdx
+++ b/docs/ui-sdk/reference/trueforge-ui.mdx
@@ -85,7 +85,7 @@ import { TrueforgeUI } from "@truefoundry/trueforge-ui";
Preset, color mode, tokens, branding, and content class names.
<Expandable title="ThemeConfig">
- <ParamField path="preset" type='"truefoundry" | "claude" | "chatgpt" | "gemini"' default='"truefoundry"'>
+ <ParamField path="preset" type='"trueforge" | "claude" | "chatgpt" | "gemini"' default='"trueforge"'>
Base token palette.
</ParamField>
<ParamField path="mode" type='"light" | "dark" | "system"'>
diff --git a/packages/server/catalog/mcp-catalog.yaml b/packages/server/catalog/mcp-catalog.yaml
index 9b782a32d..c4c0d5544 100644
--- a/packages/server/catalog/mcp-catalog.yaml
+++ b/packages/server/catalog/mcp-catalog.yaml
@@ -16,7 +16,7 @@ mcp_servers:
type: dcr
- type: remote
name: sentry
- logo: https://assets.production.truefoundry.com/sentry-dark.svg
+ logo: https://assets.production.truefoundry.com/sentry.svg
url: https://mcp.sentry.dev/mcp
auth:
type: dcr
@@ -34,7 +34,7 @@ mcp_servers:
url: https://search.parallel.ai/mcp
- type: remote
name: github
- logo: https://assets.production.truefoundry.com/github-dark.svg
+ logo: https://assets.production.truefoundry.com/github.svg
url: https://api.githubcopilot.com/mcp/
auth:
type: header
diff --git a/packages/trueforge-ui-sdk/CHANGELOG.md b/packages/trueforge-ui-sdk/CHANGELOG.md
index eda612b8e..b53cb552b 100644
--- a/packages/trueforge-ui-sdk/CHANGELOG.md
+++ b/packages/trueforge-ui-sdk/CHANGELOG.md
@@ -24,6 +24,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Changed
+- **Theme preset rename** — default preset id `truefoundry` → `trueforge`
+ (`ThemePreset`, `PRESETS`, `data-preset`, docs).
- **Styles auto-inject** — `ThemeProvider` injects the SDK stylesheet at runtime.
Hosts no longer need `@import '@truefoundry/trueforge-ui/styles.css'` (export
kept for SSR). Semantic tokens and dark mode are scoped to `.aui-theme-root`
diff --git a/packages/trueforge-ui-sdk/README.md b/packages/trueforge-ui-sdk/README.md
index 7a4e8be39..fbf817f47 100644
--- a/packages/trueforge-ui-sdk/README.md
+++ b/packages/trueforge-ui-sdk/README.md
@@ -203,7 +203,7 @@ const server = {
server={server}
layout="sidebar"
theme={{
- preset: 'claude', // 'truefoundry' | 'claude' | 'chatgpt' | 'gemini'
+ preset: 'claude', // 'trueforge' | 'claude' | 'chatgpt' | 'gemini'
mode: 'dark', // omit for uncontrolled (useTheme().setTheme works)
tokens: {
primary: 'oklch(0.55 0.2 275)',
diff --git a/packages/trueforge-ui-sdk/docs/customization.md b/packages/trueforge-ui-sdk/docs/customization.md
index c91503e10..9a2bdd5ee 100644
--- a/packages/trueforge-ui-sdk/docs/customization.md
+++ b/packages/trueforge-ui-sdk/docs/customization.md
@@ -42,7 +42,7 @@ over hacking third-party CSS:
/>
```
-Presets: `truefoundry` (default), `claude`, `chatgpt`, `gemini` — stylistic
+Presets: `trueforge` (default), `claude`, `chatgpt`, `gemini` — stylistic
homages, not product replicas. Host CSS still works on `.aui-root` /
`.aui-markdown` / `.aui-syntax-highlighter` / `.aui-openui` / `.aui-monaco`.
diff --git a/packages/trueforge-ui-sdk/docs/theming.md b/packages/trueforge-ui-sdk/docs/theming.md
index ba0683814..6e83340e6 100644
--- a/packages/trueforge-ui-sdk/docs/theming.md
+++ b/packages/trueforge-ui-sdk/docs/theming.md
@@ -3,7 +3,7 @@
Hard-cut `tfy-web-components`. Own primitives (shadcn-style, in-repo),
Markdown/OpenUI/syntax-highlighter/Monaco, Lucide icons (swappable map +
SVG transform), and a **theme object** with presets
-(`truefoundry` | `claude` | `chatgpt` | `gemini`) plus full token / className /
+(`trueforge` | `claude` | `chatgpt` | `gemini`) plus full token / className /
icon / **brand** / **content classNames** customization. Shell also accepts a
**custom layout** React component built from `Thread`, thread list, etc.
@@ -43,7 +43,7 @@ track (orthogonal to [`docs/server.md`](./server.md)).
| Icons | Lucide defaults; host can replace map + supply SVG transforms |
| Brand | Logo URL (per-mode) via `theme.brand`; component marks via the `BrandLogo` slot |
| Theme API | Object (not string-only); every look aspect customizable |
-| Presets | Inspired-by packs: `truefoundry` (default), `claude`, `chatgpt`, `gemini` |
+| Presets | Inspired-by packs: `trueforge` (default), `claude`, `chatgpt`, `gemini` |
| Custom styles | CSS tokens + `className`; host may also import CSS (documented). No “load CSS file” prop |
| Light / dark | Controlled `mode` on the theme object **or** omit → uncontrolled `useTheme().setTheme` |
| React overrides | Structural pieces via **`overrides` / slots**; full chrome via **`layout` component** |
@@ -112,7 +112,7 @@ New direct dependencies this implies: `monaco-editor`, `react-syntax-highlighter
```ts
type ThemeMode = "light" | "dark" | "system";
-type ThemePreset = "truefoundry" | "claude" | "chatgpt" | "gemini";
+type ThemePreset = "trueforge" | "claude" | "chatgpt" | "gemini";
type SemanticTokens = {
background: string;
@@ -187,7 +187,7 @@ type BrandConfig = {
};
type ThemeConfig = {
- preset?: ThemePreset; // default: "truefoundry"
+ preset?: ThemePreset; // default: "trueforge"
mode?: ThemeMode; // omit = uncontrolled (useTheme().setTheme)
tokens?: Partial<SemanticTokens>;
brand?: BrandConfig; // logo image + display name
@@ -390,12 +390,12 @@ function CenteredLayout() {
Ship as CSS variable maps under e.g. `src/theme/presets/`:
-| Preset | Intent (not a clone) |
-| ------------- | ------------------------------------------------------- |
-| `truefoundry` | Current indigo semantic look |
-| `claude` | Warm paper bg, soft borders, restrained accent |
-| `chatgpt` | Cool gray chrome, green/teal send accent, flat bubbles |
-| `gemini` | Light airy surface, blue accent, slightly larger radius |
+| Preset | Intent (not a clone) |
+| ----------- | ------------------------------------------------------- |
+| `trueforge` | Current indigo semantic look |
+| `claude` | Warm paper bg, soft borders, restrained accent |
+| `chatgpt` | Cool gray chrome, green/teal send accent, flat bubbles |
+| `gemini` | Light airy surface, blue accent, slightly larger radius |
Each preset defines **light + dark** token sets. Document that these are
stylistic homages, not product replicas.
@@ -501,7 +501,7 @@ overrides apply in the example app.
### Phase 5 — Presets + polish
-1. Ship `claude` / `chatgpt` / `gemini` / `truefoundry` packs.
+1. Ship `claude` / `chatgpt` / `gemini` / `trueforge` packs.
2. Example app: theme switcher + custom layout demo + content classNames demo.
3. Drop `tfy-web-components` from `dependencies` / `peerDependencies`.
4. CHANGELOG + migration guide (slot props, styles, brand, layout, classNames).
diff --git a/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx b/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
index dff6a20a5..3c2326e5a 100644
--- a/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/WelcomeScreen.tsx
@@ -51,7 +51,7 @@ export function WelcomeScreen({ heading = 'How can I help you today?', icon, cla
<h1
className={cn(
'aui-thread-welcome-message-inner fill-mode-both text-2xl motion-safe:animate-in motion-safe:fade-in motion-safe:slide-in-from-bottom-1 motion-reduce:animate-none',
- preset === 'truefoundry' ? 'font-semibold' : 'font-normal',
+ preset === 'trueforge' ? 'font-semibold' : 'font-normal',
resolvedIcon !== null && 'delay-75',
preset === 'gemini' ? 'text-[1.75rem] leading-tight duration-300' : 'duration-200',
)}
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
index ab4f38c88..fa01ab755 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftComposerSections.tsx
@@ -2,7 +2,6 @@
import { useSlot } from '../../theme/SlotsProvider.js';
import type { ComposerLeftSectionProps, ComposerRightSectionProps } from '../ComposerSections.js';
-import { DraftSelectionChips } from './DraftCompositeSelector.js';
import { DraftReasoningEffortSelector } from './DraftReasoningEffortSelector.js';
export function DraftComposerLeftSection({ disabled, isRunning, onAttach }: ComposerLeftSectionProps) {
@@ -11,7 +10,6 @@ export function DraftComposerLeftSection({ disabled, isRunning, onAttach }: Comp
return (
<div className="flex min-w-0 flex-wrap items-center gap-1.5">
<DraftCompositeSelector disabled={disabled} isRunning={isRunning} onAttach={onAttach} />
- <DraftSelectionChips />
</div>
);
}
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
index 78734f177..3439d40c5 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx
@@ -11,6 +11,7 @@ import { cn } from '../lib/cn.js';
import { useCompactLayout } from '../lib/CompactLayoutContext.js';
import { useIsMobile } from '../lib/useIsMobile.js';
import { BottomSheet } from '../primitives/BottomSheet.js';
+import { Tooltip } from '../primitives/Tooltip.js';
import { useDraftCatalog } from './DraftCatalogProvider.js';
/** Catalog-backed mount shape used by the draft picker (runtime mounts stay opaque). */
@@ -37,7 +38,7 @@ type AttachTab = 'connectors' | 'skills' | 'files';
const TABS: { id: AttachTab; label: string; icon: string }[] = [
{ id: 'connectors', label: 'Connectors', icon: 'plug' },
- { id: 'skills', label: 'Skills', icon: 'list-check' },
+ { id: 'skills', label: 'Skills', icon: 'lightbulb' },
{ id: 'files', label: 'Attachment', icon: 'paperclip' },
];
@@ -277,7 +278,12 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC
scheduleFlush();
};
- const openPicker = () => {
+ const openPicker = (nextTab?: AttachTab) => {
+ if (nextTab != null) {
+ setTab(nextTab);
+ setQuery('');
+ }
+ if (open) return;
setLocalMcp(specMcp);
setLocalSkills(specSkills);
dirtyRef.current = false;
@@ -421,7 +427,7 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC
);
return (
- <div ref={containerRef} className="relative">
+ <div ref={containerRef} className="relative flex flex-wrap items-center gap-1.5">
<button
type="button"
disabled={disabled || isRunning}
@@ -441,6 +447,13 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC
<Icon name="plus" className="text-primary" />
</button>
+ <DraftSelectionChips
+ disabled={disabled || isRunning}
+ onOpenTab={tabId => {
+ openPicker(tabId);
+ }}
+ />
+
{open ? (
isMobile || compactLayout ? (
<BottomSheet id={menuId} open onOpenChange={setOpenAndFlush} aria-label="Add to composer">
@@ -461,26 +474,65 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftC
);
}
-export function DraftSelectionChips() {
+export type DraftSelectionChipsProps = {
+ disabled?: boolean;
+ onOpenTab?: (tab: 'connectors' | 'skills') => void;
+};
+
+function SelectionChipTooltipList({ mounts }: { mounts: DraftMount[] }) {
+ return (
+ <ul className="m-0 flex max-w-48 list-none flex-col gap-0.5 p-0 text-left">
+ {mounts.map(mount => (
+ <li key={mount.id} className="truncate" title={mount.name}>
+ {mount.name}
+ </li>
+ ))}
+ </ul>
+ );
+}
+
+export function DraftSelectionChips({ disabled, onOpenTab }: DraftSelectionChipsProps = {}) {
const { agentSpec } = useTrueFoundryAgentSpec();
- const mcpCount = agentSpec?.mcpServers?.length ?? 0;
- const skillCount = agentSpec?.skills?.length ?? 0;
+ const mcpMounts = useMemo(() => draftMountsFromSpec(agentSpec?.mcpServers), [agentSpec?.mcpServers]);
+ const skillMounts = useMemo(() => draftMountsFromSpec(agentSpec?.skills), [agentSpec?.skills]);
- if (mcpCount === 0 && skillCount === 0) return null;
+ if (mcpMounts.length === 0 && skillMounts.length === 0) return null;
+
+ const chipClassName = cn(
+ 'bg-muted text-muted-foreground inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs outline-none',
+ 'focus-visible:ring-1 focus-visible:ring-ring',
+ disabled ? 'cursor-not-allowed opacity-50' : 'hover:bg-accent cursor-pointer',
+ );
return (
<div className="flex flex-wrap items-center gap-1.5">
- {mcpCount > 0 ? (
- <span className="bg-muted text-muted-foreground inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs">
- <Icon name="plug" className="size-3" />
- {mcpCount} Connector{mcpCount === 1 ? '' : 's'}
- </span>
+ {mcpMounts.length > 0 ? (
+ <Tooltip content={<SelectionChipTooltipList mounts={mcpMounts} />} className="max-w-48 whitespace-normal">
+ <button
+ type="button"
+ disabled={disabled}
+ aria-label={`View ${mcpMounts.length} selected connector${mcpMounts.length === 1 ? '' : 's'}`}
+ className={chipClassName}
+ onClick={() => onOpenTab?.('connectors')}
+ >
+ <Icon name="plug" className="size-3" />
+ {mcpMounts.length} Connector{mcpMounts.length === 1 ? '' : 's'}
+ </button>
+ </Tooltip>
) : null}
- {skillCount > 0 ? (
- <span className="bg-muted text-muted-foreground inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs">
- <Icon name="list-check" className="size-3" />
- {skillCount} Skill{skillCount === 1 ? '' : 's'}
- </span>
+ {skillMounts.length > 0 ? (
+ <Tooltip content={<SelectionChipTooltipList mounts={skillMounts} />} className="max-w-48 whitespace-normal">
+ <button
+ type="button"
+ disabled={disabled}
+ aria-label={`View ${skillMounts.length} selected skill${skillMounts.length === 1 ? '' : 's'}`}
+ className={chipClassName}
+ onClick={() => onOpenTab?.('skills')}
+ >
+ <Icon name="lightbulb" className="size-3" />
+ {skillMounts.length} Skill{skillMounts.length === 1 ? '' : 's'}
+ </button>
+ </Tooltip>
) : null}
</div>
);
diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
index 7b55376ae..42b772392 100644
--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftModelSelector.tsx
@@ -12,6 +12,7 @@ import { cn } from '../lib/cn.js';
import { useCompactLayout } from '../lib/CompactLayoutContext.js';
import { useIsMobile } from '../lib/useIsMobile.js';
import { BottomSheet } from '../primitives/BottomSheet.js';
+import { CatalogLogo } from '../primitives/CatalogLogo.js';
import { useDraftCatalog } from './DraftCatalogProvider.js';
import { modelPatchWithReasoningEffort } from './reasoningEffort.js';
@@ -24,7 +25,7 @@ function monogram(value: string): string {
function ProviderMark({ logo, label, className }: { logo?: string; label: string; className?: string }) {
if (logo) {
- return <img src={logo} alt="" className={cn('shrink-0 rounded object-contain', className)} aria-hidden />;
+ return <CatalogLogo src={logo} alt="" className={cn('shrink-0 rounded object-contain', className)} aria-hidden />;
}
return (
<span
@@ -154,7 +155,9 @@ export function DraftModelSelector({ disabled, isRunning }: DraftModelSelectorPr
) : (
filtered.map(model => {
const value = modelValue(model);
- const active = value === selectedName || model.name === selectedName;
+ // If there is no selected model, consider the first in the filtered list as active
+ const active = selectedName ? value === selectedName || model.name === selectedName : filtered[0] === model;
+
return (
<button
key={value || model.modelId || model.name}
@@ -199,7 +202,7 @@ export function DraftModelSelector({ disabled, isRunning }: DraftModelSelectorPr
className={auiButtonClass({
variant: 'ghost',
size: 'sm',
- className: cn('h-8 max-w-[12rem] gap-1.5 rounded-full px-2 text-xs font-medium', 'hover:bg-accent'),
+ className: cn('h-8 max-w-48 gap-1.5 rounded-full px-2 text-xs font-medium', 'hover:bg-accent'),
})}
onClick={() => setOpen(v => !v)}
>
diff --git a/packages/trueforge-ui-sdk/src/atoms/primitives/CatalogLogo.tsx b/packages/trueforge-ui-sdk/src/atoms/primitives/CatalogLogo.tsx
new file mode 100644
index 000000000..ca475f95e
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/atoms/primitives/CatalogLogo.tsx
@@ -0,0 +1,44 @@
+'use client';
+
+import { useEffect, useState, type ImgHTMLAttributes } from 'react';
+
+import { useThemeMode } from '../../theme/SlotsProvider.js';
+import { resolveCatalogLogoSrc } from '../../utils/catalogLogo.js';
+
+export type CatalogLogoProps = Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> & {
+ src: string;
+};
+
+/**
+ * Catalog logo with mode-matched siblings:
+ * - `…/icon.png` in dark mode → try `…/icon-dark.png`, else catalog URL
+ * - `…/icon-dark.png` in light mode → try `…/icon.png`, else catalog URL
+ */
+export function CatalogLogo({ src, alt = '', onError, ...props }: CatalogLogoProps) {
+ const mode = useThemeMode();
+ const preferred = resolveCatalogLogoSrc({ src, mode });
+ const [failedPreferred, setFailedPreferred] = useState(false);
+
+ useEffect(() => {
+ setFailedPreferred(false);
+ }, [src, mode, preferred]);
+
+ const canFallback = preferred !== src;
+ const resolved = failedPreferred && canFallback ? src : preferred;
+
+ return (
+ <img
+ {...props}
+ key={resolved}
+ src={resolved}
+ alt={alt}
+ onError={event => {
+ if (canFallback && !failedPreferred) {
+ setFailedPreferred(true);
+ return;
+ }
+ onError?.(event);
+ }}
+ />
+ );
+}
diff --git a/packages/trueforge-ui-sdk/src/atoms/primitives/Tooltip.tsx b/packages/trueforge-ui-sdk/src/atoms/primitives/Tooltip.tsx
index c7f146ba0..c4fca1d8a 100644
--- a/packages/trueforge-ui-sdk/src/atoms/primitives/Tooltip.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/primitives/Tooltip.tsx
@@ -1,16 +1,51 @@
-import React, { cloneElement, isValidElement, useRef, useState } from 'react';
+'use client';
+
+import React, { cloneElement, isValidElement, useLayoutEffect, useRef, useState } from 'react';
+import { createPortal } from 'react-dom';
import { cn } from '../lib/cn.js';
+// Keep portaled chrome under ThemeProvider so preset/custom CSS vars still apply.
+function themePortalRoot(from: HTMLElement | null): HTMLElement {
+ return from?.closest('.aui-theme-root') ?? document.body;
+}
+
export type TooltipProps = {
content: React.ReactNode;
children: React.ReactElement;
className?: string;
+ side?: 'top' | 'bottom';
};
-export function Tooltip({ content, children, className }: TooltipProps) {
+export function Tooltip({ content, children, className, side = 'top' }: TooltipProps) {
const [visible, setVisible] = useState(false);
- const ref = useRef<HTMLSpanElement>(null);
+ const [pos, setPos] = useState<{ top: number; left: number } | null>(null);
+ const triggerWrapRef = useRef<HTMLSpanElement>(null);
+
+ useLayoutEffect(() => {
+ if (!visible) {
+ setPos(null);
+ return;
+ }
+
+ const update = () => {
+ const el = triggerWrapRef.current;
+ if (!el) return;
+ const rect = el.getBoundingClientRect();
+ setPos({
+ top: side === 'bottom' ? rect.bottom + 6 : rect.top - 6,
+ left: rect.left + rect.width / 2,
+ });
+ };
+
+ update();
+ window.addEventListener('scroll', update, true);
+ window.addEventListener('resize', update);
+ return () => {
+ window.removeEventListener('scroll', update, true);
+ window.removeEventListener('resize', update);
+ };
+ }, [visible, side]);
if (!isValidElement(children)) return children;
@@ -33,23 +68,38 @@ export function Tooltip({ content, children, className }: TooltipProps) {
setVisible(false);
(p.onBlur as ((e: React.FocusEvent<Element>) => void) | undefined)?.(e);
},
+ onClick(e: React.MouseEvent<Element>) {
+ setVisible(false);
+ (p.onClick as ((e: React.MouseEvent<Element>) => void) | undefined)?.(e);
+ },
});
+ const tooltip =
+ visible && content != null && pos != null
+ ? createPortal(
+ <span
+ role="tooltip"
+ style={{
+ top: pos.top,
+ left: pos.left,
+ transform: side === 'bottom' ? 'translate(-50%, 0)' : 'translate(-50%, -100%)',
+ }}
+ className={cn(
+ 'pointer-events-none fixed z-[200]',
+ 'whitespace-nowrap rounded bg-foreground px-2 py-1 text-xs text-background shadow-md',
+ className,
+ )}
+ >
+ {content}
+ </span>,
+ themePortalRoot(triggerWrapRef.current),
+ )
+ : null;
+
return (
- <span ref={ref} className="relative inline-flex">
+ <span ref={triggerWrapRef} className="relative inline-flex">
{child}
- {visible && content != null && (
- <span
- role="tooltip"
- className={cn(
- 'pointer-events-none absolute bottom-full left-1/2 z-50 mb-1.5 -translate-x-1/2',
- 'whitespace-nowrap rounded bg-foreground px-2 py-1 text-xs text-background shadow-md',
- className,
- )}
- >
- {content}
- </span>
- )}
+ {tooltip}
</span>
);
}
@@ -59,11 +109,12 @@ export type LightTooltipProps = {
children: React.ReactElement;
className?: string;
size?: string;
+ side?: 'top' | 'bottom';
};
-export function LightTooltip({ title, children, className, size: _size }: LightTooltipProps) {
+export function LightTooltip({ title, children, className, size: _size, side }: LightTooltipProps) {
return (
- <Tooltip content={title} className={className}>
+ <Tooltip content={title} className={className} side={side}>
{children}
</Tooltip>
);
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorDetails.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorDetails.tsx
index e1478e3b0..293da1416 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorDetails.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorDetails.tsx
@@ -1,7 +1,8 @@
'use client';
-import { useEffect, useState } from 'react';
+import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { cn } from '../../atoms/lib/cn.js';
import { Button } from '../../atoms/primitives/Button.js';
import { Icon } from '../../icons/Icon.js';
import { useCatalogServer } from '../../server/ServerContext.js';
@@ -16,6 +17,81 @@ type ConnectorDetailsProps = {
busy?: boolean;
};
+/** One-line clamp with animated expand; toggle only when content actually overflows. */
+function ExpandableDescription({ text }: { text: string }) {
+ const contentRef = useRef<HTMLParagraphElement>(null);
+ const [expanded, setExpanded] = useState(false);
+ const [canExpand, setCanExpand] = useState(false);
+ const [maxHeight, setMaxHeight] = useState(16);
+
+ useLayoutEffect(() => {
+ setExpanded(false);
+ setMaxHeight(16);
+ }, [text]);
+
+ useLayoutEffect(() => {
+ const el = contentRef.current;
+ if (!el) return;
+
+ if (!expanded) {
+ setMaxHeight(16);
+ setCanExpand(el.scrollWidth > el.clientWidth + 1);
+ return;
+ }
+
+ // Keep collapsed height for one frame (wrap enabled), then grow so max-height can transition.
+ setMaxHeight(16);
+ const frame = requestAnimationFrame(() => {
+ setMaxHeight(el.scrollHeight);
+ });
+ return () => cancelAnimationFrame(frame);
+ }, [text, expanded]);
+
+ if (!text) return null;
+
+ return (
+ <div className="relative min-w-0">
+ <p
+ ref={contentRef}
+ style={{ maxHeight }}
+ className={cn(
+ 'mt-0.5 overflow-hidden font-mono text-xs leading-4 text-muted-foreground transition-[max-height] duration-300 ease-in-out',
+ !expanded && 'whitespace-nowrap',
+ !expanded && canExpand && 'pr-[5.75rem]',
+ )}
+ >
+ {text}
+ {expanded && canExpand ? (
+ <>
+ {' '}
+ <button
+ type="button"
+ className="cursor-pointer font-mono text-xs font-medium text-foreground/80 hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
+ aria-expanded
+ onClick={() => setExpanded(false)}
+ >
+ Show less
+ </button>
+ </>
+ ) : null}
+ </p>
+ {!expanded && canExpand ? (
+ <button
+ type="button"
+ className="absolute top-0.5 right-0 cursor-pointer bg-card pl-1.5 font-mono text-xs font-medium leading-4 text-foreground/80 hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
+ aria-expanded={false}
+ onClick={() => setExpanded(true)}
+ >
+ <span aria-hidden className="text-muted-foreground">
+ …
+ </span>
+ <span className="ml-1">Read more</span>
+ </button>
+ ) : null}
+ </div>
+ );
+}
+
const ConnectorDetails = ({ connector, onBack, onDisconnect, busy = false }: ConnectorDetailsProps) => {
const { connectorCatalog } = useCatalogServer();
const [tools, setTools] = useState<ToolBase[]>([]);
@@ -70,13 +146,19 @@ const ConnectorDetails = ({ connector, onBack, onDisconnect, busy = false }: Con
<div className="min-w-0 flex-1">
<h4 className="text-lg font-semibold text-foreground">{connector.name}</h4>
<div className="mt-0.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-sm">
- <span className="flex items-center gap-1.5 text-xs font-medium text-foreground">
- <span className="h-1.5 w-1.5 rounded-full bg-primary"></span>
+ <span
+ className={cn(
+ 'flex items-center gap-1.5 text-xs font-medium',
+ connector.authenticated ? 'text-success' : 'text-foreground',
+ )}
+ >
+ <span
+ className={cn('h-1.5 w-1.5 rounded-full', connector.authenticated ? 'bg-success' : 'bg-primary')}
+ ></span>
{connector.authenticated ? 'Connected' : 'Not authenticated'}
</span>
<span className="text-muted-foreground">· {connector.description}</span>
</div>
- <p className="mt-1 break-all font-mono text-xs text-muted-foreground">{connector.url}</p>
<span className="mt-2 inline-flex items-center rounded-full border border-border bg-muted/40 px-2 py-0.5 text-xs font-medium text-muted-foreground">
{AUTH_TYPE_LABELS[connector.auth.type] ?? AUTH_TYPE_LABELS.none}
</span>
@@ -111,7 +193,7 @@ const ConnectorDetails = ({ connector, onBack, onDisconnect, busy = false }: Con
>
<div className="min-w-0 flex-1">
<h6 className="text-sm font-medium text-foreground">{tool.name}</h6>
- <p className="mt-0.5 font-mono text-xs text-muted-foreground">{tool.id}</p>
+ <ExpandableDescription text={tool.description} />
</div>
</article>
))}
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
index be279bd06..1c7a8072e 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
@@ -2,7 +2,9 @@
import { useCallback, useEffect, useMemo, useState, type FormEvent } from 'react';
+import { cn } from '@/atoms/lib/cn.js';
import { Button } from '@/atoms/primitives/Button.js';
+import { CatalogLogo } from '@/atoms/primitives/CatalogLogo.js';
import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';
import SearchInput from '@/atoms/primitives/SearchInput.js';
import { useMCPAuth } from '@/hooks/useMcpAuth.js';
@@ -246,14 +248,15 @@ const ConnectorSettings = () => {
};
const renderConnector = (connector: ConnectorBase, isConnected: boolean) => {
+ const logoSrc = connectorIconMap[connector.name];
const content = (
<>
<span
className="flex size-9 shrink-0 items-center justify-center overflow-hidden rounded-lg border border-border bg-muted"
aria-hidden
>
- {connectorIconMap[connector.name] ? (
- <img src={connectorIconMap[connector.name]} alt={connector.name} className="size-4.5" />
+ {logoSrc ? (
+ <CatalogLogo src={logoSrc} alt={connector.name} className="size-4.5" />
) : (
<Icon name="mcp-server" className="size-4.5 text-foreground" />
)}
@@ -281,8 +284,15 @@ const ConnectorSettings = () => {
<div className="flex items-center gap-2">
<div className="flex items-center gap-2">
- <span className="flex items-center gap-1.5 rounded-full border border-border bg-muted/40 px-2 py-0.5 text-xs font-medium text-foreground">
- <span className="h-1.5 w-1.5 rounded-full bg-primary"></span>
+ <span
+ className={cn(
+ 'flex items-center gap-1.5 rounded-full border border-border bg-muted/40 px-2 py-0.5 text-xs font-medium',
+ connector.authenticated ? 'text-success' : 'text-foreground',
+ )}
+ >
+ <span
+ className={cn('h-1.5 w-1.5 rounded-full', connector.authenticated ? 'bg-success' : 'bg-primary')}
+ ></span>
{connector.authenticated ? 'Connected' : 'Added'}
</span>
<Icon name="chevron-right" className="size-4" />
@@ -315,47 +325,51 @@ const ConnectorSettings = () => {
);
};
- const renderCatalogEntry = (entry: ConnectorCatalogEntry) => (
- <article
- key={entry.id}
- className="flex min-h-16 w-full items-center gap-3 border-b border-border p-3 text-left last:border-b-0"
- >
- <span
- className="flex size-9 shrink-0 items-center justify-center overflow-hidden rounded-lg border border-border bg-muted"
- aria-hidden
+ const renderCatalogEntry = (entry: ConnectorCatalogEntry) => {
+ const logoSrc = connectorIconMap[entry.name];
+ return (
+ <article
+ key={entry.id}
+ className="flex min-h-16 w-full items-center gap-3 border-b border-border p-3 text-left last:border-b-0"
>
- {connectorIconMap[entry.name] ? (
- <img src={connectorIconMap[entry.name]} alt={entry.name} className="size-4.5" />
- ) : (
- <Icon name="mcp-server" className="size-4.5 text-foreground" />
- )}
- </span>
-
- <div className="min-w-0 flex-1">
- <h5 className="truncate text-sm font-medium text-foreground">{entry.name}</h5>
- <p className="mt-0.5 line-clamp-2 text-sm text-muted-foreground sm:truncate">
- {entry.description ?? entry.url}
- </p>
- </div>
-
- <div className="flex shrink-0 items-center gap-2">
- <span className="hidden text-xs text-muted-foreground sm:inline">
- {AUTH_TYPE_LABELS[entry.auth.type] ?? AUTH_TYPE_LABELS.none}
- </span>
- <Button
- variant="secondary"
- size="sm"
- type="button"
- disabled={busy || isOAuthLoading}
- onClick={() => {
- handleConnect(entry);
- }}
+ <span
+ className="flex size-9 shrink-0 items-center justify-center overflow-hidden rounded-lg border border-border bg-muted"
+ aria-hidden
>
- Connect
- </Button>
- </div>
- </article>
- );
+ {logoSrc ? (
+ <CatalogLogo src={logoSrc} alt={entry.name} className="size-4.5" />
+ ) : (
+ <Icon name="mcp-server" className="size-4.5 text-foreground" />
+ )}
+ </span>
+
+ <div className="min-w-0 flex-1">
+ <h5 className="truncate text-sm font-medium text-foreground">{entry.name}</h5>
+ <p className="mt-0.5 line-clamp-2 text-sm text-muted-foreground sm:truncate">
+ {entry.description ?? entry.url}
+ </p>
+ </div>
+
+ <div className="flex shrink-0 items-center gap-2">
+ <span className="hidden text-xs text-muted-foreground sm:inline">
+ {AUTH_TYPE_LABELS[entry.auth.type] ?? AUTH_TYPE_LABELS.none}
+ </span>
+ <Button
+ variant="secondary"
+ size="sm"
+ type="button"
+ disabled={busy || isOAuthLoading}
+ onClick={() => {
+ handleConnect(entry);
+ }}
+ >
+ Connect
+ </Button>
+ </div>
+ </article>
+ );
+ };
+
const isReplacingKey = useMemo(() => {
return (
connectorAwaitingKey !== null &&
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ModelSettings.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ModelSettings.tsx
index 7bd8b6ffa..3eb5255bc 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ModelSettings.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ModelSettings.tsx
@@ -3,6 +3,7 @@
import { useCallback, useEffect, useMemo, useState } from 'react';
import { Button } from '../../atoms/primitives/Button.js';
+import { CatalogLogo } from '../../atoms/primitives/CatalogLogo.js';
import SearchInput from '../../atoms/primitives/SearchInput.js';
import { Icon } from '../../icons/Icon.js';
import { useCatalogServer } from '../../server/ServerContext.js';
@@ -272,6 +273,7 @@ const ModelSettings = () => {
const catalogModels = catalogModelsByType.get(provider.type) ?? [];
const configuredIds = new Set(provider.models.map(model => model.id));
const availableModels = catalogModels.filter(model => !configuredIds.has(model.id));
+ const logoSrc = modelProviderIconMap[provider.name];
return (
<article key={provider.id} className="border-b border-border p-3 last:border-b-0">
@@ -281,12 +283,8 @@ const ModelSettings = () => {
className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg border border-border bg-muted text-foreground"
aria-hidden
>
- {modelProviderIconMap[provider.name] ? (
- <img
- src={modelProviderIconMap[provider.name]}
- alt={provider.name}
- className="size-4.5"
- />
+ {logoSrc ? (
+ <CatalogLogo src={logoSrc} alt={provider.name} className="size-4.5" />
) : (
<Icon name="cpu" className="size-4.5" />
)}
@@ -295,8 +293,8 @@ const ModelSettings = () => {
</div>
<div className="flex flex-wrap items-center gap-2.5 sm:justify-end">
- <span className="flex items-center gap-1.5 text-[13px] font-medium text-foreground">
- <span className="h-1.5 w-1.5 rounded-full bg-primary"></span>
+ <span className="flex items-center gap-1.5 text-[13px] font-medium text-success">
+ <span className="h-1.5 w-1.5 rounded-full bg-success"></span>
Connected
</span>
<Button
@@ -409,52 +407,55 @@ const ModelSettings = () => {
</div>
<div className="overflow-hidden rounded-xl border border-border bg-card">
- {matchingAvailable.map(provider => (
- <article key={provider.type} className="border-b border-border p-3 last:border-b-0">
- <header className="flex flex-col gap-3 sm:flex-row sm:items-center">
- <div className="flex min-w-0 flex-1 items-center gap-3">
- <span
- className="flex size-9 shrink-0 items-center justify-center rounded-lg border border-border bg-muted text-foreground"
- aria-hidden
- >
- {modelProviderIconMap[provider.name] ? (
- <img src={modelProviderIconMap[provider.name]} alt={provider.name} className="size-4.5" />
- ) : (
- <Icon name="cpu" className="size-4.5" />
- )}
- </span>
- <div className="min-w-0">
- <h5 className="truncate text-base font-medium text-foreground">{provider.name}</h5>
- <p className="truncate text-sm text-muted-foreground">
- {provider.models.map(model => model.name).join(' · ')}
- </p>
+ {matchingAvailable.map(provider => {
+ const logoSrc = modelProviderIconMap[provider.name];
+ return (
+ <article key={provider.type} className="border-b border-border p-3 last:border-b-0">
+ <header className="flex flex-col gap-3 sm:flex-row sm:items-center">
+ <div className="flex min-w-0 flex-1 items-center gap-3">
+ <span
+ className="flex size-9 shrink-0 items-center justify-center rounded-lg border border-border bg-muted text-foreground"
+ aria-hidden
+ >
+ {logoSrc ? (
+ <CatalogLogo src={logoSrc} alt={provider.name} className="size-4.5" />
+ ) : (
+ <Icon name="cpu" className="size-4.5" />
+ )}
+ </span>
+ <div className="min-w-0">
+ <h5 className="truncate text-base font-medium text-foreground">{provider.name}</h5>
+ <p className="truncate text-sm text-muted-foreground">
+ {provider.models.map(model => model.name).join(' · ')}
+ </p>
+ </div>
</div>
- </div>
- <Button
- variant="secondary"
- type="button"
- disabled={busy}
- onClick={() => {
- setEditingProviderId(null);
- setEditingCatalogType(provider.type);
- setApiKey('');
- }}
- >
- <Icon name="wrench" className="size-4" />
- Configure
- </Button>
- </header>
- {editingCatalogType === provider.type
- ? renderKeyEditor({
- id: provider.type,
- submitLabel: 'Create',
- onSave: () => {
- handleCreateFromCatalog(provider.type);
- },
- })
- : null}
- </article>
- ))}
+ <Button
+ variant="secondary"
+ type="button"
+ disabled={busy}
+ onClick={() => {
+ setEditingProviderId(null);
+ setEditingCatalogType(provider.type);
+ setApiKey('');
+ }}
+ >
+ <Icon name="wrench" className="size-4" />
+ Configure
+ </Button>
+ </header>
+ {editingCatalogType === provider.type
+ ? renderKeyEditor({
+ id: provider.type,
+ submitLabel: 'Create',
+ onSave: () => {
+ handleCreateFromCatalog(provider.type);
+ },
+ })
+ : null}
+ </article>
+ );
+ })}
</div>
</section>
) : null}
diff --git a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.tsx b/packages/trueforge-ui-sdk/src/theme/ThemeProvider.tsx
index 2e8e60bfd..484698aa1 100644
--- a/packages/trueforge-ui-sdk/src/theme/ThemeProvider.tsx
+++ b/packages/trueforge-ui-sdk/src/theme/ThemeProvider.tsx
@@ -130,7 +130,7 @@ export function ThemeProvider({ theme, children }: { theme?: ThemeConfig; childr
const value = useMemo<ThemeContextValue>(
() => ({
- preset: theme?.preset ?? 'truefoundry',
+ preset: theme?.preset ?? 'trueforge',
mode,
preference,
isDark: mode === 'dark',
@@ -153,7 +153,7 @@ export function ThemeProvider({ theme, children }: { theme?: ThemeConfig; childr
<div
className={cn('aui-theme-root h-full min-h-0', mode === 'dark' && 'dark', theme?.className)}
data-theme={mode}
- data-preset={theme?.preset ?? 'truefoundry'}
+ data-preset={theme?.preset ?? 'trueforge'}
style={rootStyle}
>
{children}
@@ -193,9 +193,9 @@ export function useOptionalThemeMode(): 'light' | 'dark' {
return useContext(ThemeContext)?.mode ?? 'light';
}
-/** Safe for trees that may sit outside ThemeProvider (falls back to truefoundry). */
+/** Safe for trees that may sit outside ThemeProvider (falls back to trueforge). */
export function useOptionalThemePreset(): ThemePreset {
- return useContext(ThemeContext)?.preset ?? 'truefoundry';
+ return useContext(ThemeContext)?.preset ?? 'trueforge';
}
/** Safe for trees that may sit outside ThemeProvider (falls back to {}). */
diff --git a/packages/trueforge-ui-sdk/src/theme/presets/index.ts b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
index 264179a89..3a884aac1 100644
--- a/packages/trueforge-ui-sdk/src/theme/presets/index.ts
+++ b/packages/trueforge-ui-sdk/src/theme/presets/index.ts
@@ -5,7 +5,7 @@ export type PresetTokens = {
dark: SemanticTokens;
};
-const truefoundry: PresetTokens = {
+const trueforge: PresetTokens = {
light: {
background: '#ffffff',
foreground: '#09090b',
@@ -261,12 +261,12 @@ const gemini: PresetTokens = {
};
export const PRESETS: Record<ThemePreset, PresetTokens> = {
- truefoundry,
+ trueforge,
claude,
chatgpt,
gemini,
};
export function resolvePresetTokens(preset: ThemePreset | undefined, mode: 'light' | 'dark'): SemanticTokens {
- return PRESETS[preset ?? 'truefoundry'][mode];
+ return PRESETS[preset ?? 'trueforge'][mode];
}
diff --git a/packages/trueforge-ui-sdk/src/theme/types.ts b/packages/trueforge-ui-sdk/src/theme/types.ts
index cfd4339f7..7ad7870c1 100644
--- a/packages/trueforge-ui-sdk/src/theme/types.ts
+++ b/packages/trueforge-ui-sdk/src/theme/types.ts
@@ -3,7 +3,7 @@ import type { ComponentType, CSSProperties, FC, ReactNode, SVGProps } from 'reac
export type ThemeMode = 'light' | 'dark' | 'system';
-export type ThemePreset = 'truefoundry' | 'claude' | 'chatgpt' | 'gemini';
+export type ThemePreset = 'trueforge' | 'claude' | 'chatgpt' | 'gemini';
export type SemanticTokens = {
background: string;
diff --git a/packages/trueforge-ui-sdk/src/utils/catalogLogo.ts b/packages/trueforge-ui-sdk/src/utils/catalogLogo.ts
new file mode 100644
index 000000000..5f938e5c1
--- /dev/null
+++ b/packages/trueforge-ui-sdk/src/utils/catalogLogo.ts
@@ -0,0 +1,34 @@
+function splitCatalogLogoUrl(src: string): { dir: string; base: string; ext: string; suffix: string } | undefined {
+ const match = /^(.*\/)?([^/?#]+?)(\.[^./?#]+)([?#].*)?$/.exec(src);
+ if (match == null) return undefined;
+ const dir = match[1] ?? '';
+ const base = match[2];
+ const ext = match[3];
+ const suffix = match[4] ?? '';
+ if (base == null || ext == null) return undefined;
+ return { dir, base, ext, suffix };
+}
+
+/** Insert `-dark` before the file extension. Undefined when already dark-suffixed or unparseable. */
+export function toDarkCatalogLogoUrl(src: string): string | undefined {
+ const parts = splitCatalogLogoUrl(src);
+ if (parts == null || /-dark$/i.test(parts.base)) return undefined;
+ return `${parts.dir}${parts.base}-dark${parts.ext}${parts.suffix}`;
+}
+
+/** Strip a trailing `-dark` before the file extension. Undefined when not dark-suffixed or unparseable. */
+export function toLightCatalogLogoUrl(src: string): string | undefined {
+ const parts = splitCatalogLogoUrl(src);
+ if (parts == null || !/-dark$/i.test(parts.base)) return undefined;
+ return `${parts.dir}${parts.base.replace(/-dark$/i, '')}${parts.ext}${parts.suffix}`;
+}
+
+/**
+ * Mode-matched logo URL:
+ * - dark → prefer icon-dark.ext (derived from icon.ext, or keep if already dark)
+ * - light → prefer icon.ext (derived from icon-dark.ext, or keep if already light)
+ */
+export function resolveCatalogLogoSrc({ src, mode }: { src: string; mode: 'light' | 'dark' }): string {
+ if (mode === 'dark') return toDarkCatalogLogoUrl(src) ?? src;
+ return toLightCatalogLogoUrl(src) ?? src;
+}
diff --git a/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx
index 3ec62e767..05afb601c 100644
--- a/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/WelcomeScreen.test.tsx
@@ -9,7 +9,7 @@ describe('WelcomeScreen', () => {
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"]');
+ const root = container.querySelector('[data-preset="trueforge"]');
expect(root).toHaveClass('aui-thread-welcome-root', 'host-welcome');
expect(root?.querySelector('svg[aria-hidden="true"]')).toBeInTheDocument();
expect(heading).toHaveClass('font-semibold', 'delay-75');
diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx
index 3736d2b84..13ac310ee 100644
--- a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx
@@ -3,7 +3,11 @@ import { act, fireEvent, render, screen, within } from '@testing-library/react';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';
-import { DraftCompositeSelector, type DraftCompositeSelectorProps } from '@/atoms/draft/DraftCompositeSelector.js';
+import {
+ DraftCompositeSelector,
+ DraftSelectionChips,
+ type DraftCompositeSelectorProps,
+} from '@/atoms/draft/DraftCompositeSelector.js';
import { ServerProvider } from '@/server/ServerContext.js';
import type { AgentBuilderCapabilitiesResponse, AgentSpec, AgentUIServer } from '@/server/types.js';
import { createMockAgentUIServer } from '../../server/mockServer.js';
@@ -212,3 +216,55 @@ describe('DraftCompositeSelector', () => {
expect(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' })).toBeDisabled();
});
});
+
+describe('DraftSelectionChips', () => {
+ beforeEach(() => {
+ agentSpec = {
+ model: { name: 'openai/gpt-4.1' },
+ mcpServers: [
+ { id: 'slack', name: 'Slack' },
+ { id: 'github', name: 'GitHub' },
+ ],
+ skills: [{ id: 'research', name: 'Research' }],
+ };
+ });
+
+ it('shows selected entity names in tooltips on hover', () => {
+ render(<DraftSelectionChips />);
+
+ const connectorsChip = screen.getByRole('button', { name: 'View 2 selected connectors' });
+ fireEvent.mouseEnter(connectorsChip);
+ expect(screen.getByRole('tooltip')).toHaveTextContent('Slack');
+ expect(screen.getByRole('tooltip')).toHaveTextContent('GitHub');
+ fireEvent.mouseLeave(connectorsChip);
+
+ const skillsChip = screen.getByRole('button', { name: 'View 1 selected skill' });
+ fireEvent.mouseEnter(skillsChip);
+ expect(screen.getByRole('tooltip')).toHaveTextContent('Research');
+ });
+
+ it('opens the composite selector on the matching tab when a chip is clicked', async () => {
+ renderSelector();
+
+ const skillsChip = screen.getByRole('button', { name: 'View 1 selected skill' });
+ fireEvent.mouseEnter(skillsChip);
+ expect(screen.getByRole('tooltip')).toBeInTheDocument();
+
+ fireEvent.click(skillsChip);
+
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ expect(await screen.findByRole('dialog', { name: 'Add to composer' })).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: /Skills/ })).toHaveClass('text-foreground');
+ expect(await screen.findByRole('menuitemcheckbox', { name: /Research/ })).toBeInTheDocument();
+
+ fireEvent.click(screen.getByRole('button', { name: 'View 2 selected connectors' }));
+ expect(screen.getByRole('button', { name: /Connectors/ })).toHaveClass('text-foreground');
+ expect(await screen.findByRole('menuitemcheckbox', { name: /Slack/ })).toBeInTheDocument();
+ });
+
+ it('renders nothing when nothing is selected', () => {
+ agentSpec = { model: { name: 'openai/gpt-4.1' }, mcpServers: [], skills: [] };
+ const { container } = render(<DraftSelectionChips />);
+ expect(container).toBeEmptyDOMElement();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/CatalogLogo.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/CatalogLogo.test.tsx
new file mode 100644
index 000000000..a9d65b769
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/CatalogLogo.test.tsx
@@ -0,0 +1,60 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+
+import { CatalogLogo } from '@/atoms/primitives/CatalogLogo.js';
+import { SlotsProvider } from '@/theme/SlotsProvider.js';
+
+function renderLogo({ mode, src }: { mode: 'light' | 'dark'; src: string }) {
+ return render(
+ <SlotsProvider theme={{ mode }}>
+ <CatalogLogo src={src} alt="Provider" />
+ </SlotsProvider>,
+ );
+}
+
+describe('CatalogLogo', () => {
+ it('renders the catalog URL in light mode', () => {
+ renderLogo({ mode: 'light', src: 'https://assets.example/icon.png' });
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute('src', 'https://assets.example/icon.png');
+ });
+
+ it('strips -dark in light mode when the catalog URL is dark-suffixed', () => {
+ renderLogo({ mode: 'light', src: 'https://assets.example/icon-dark.png' });
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute('src', 'https://assets.example/icon.png');
+ });
+
+ it('falls back to the dark catalog URL when the light sibling fails in light mode', () => {
+ renderLogo({ mode: 'light', src: 'https://assets.example/icon-dark.png' });
+
+ fireEvent.error(screen.getByRole('img', { name: 'Provider' }));
+
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute(
+ 'src',
+ 'https://assets.example/icon-dark.png',
+ );
+ });
+
+ it('prefers the dark sibling in dark mode', () => {
+ renderLogo({ mode: 'dark', src: 'https://assets.example/icon.png' });
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute(
+ 'src',
+ 'https://assets.example/icon-dark.png',
+ );
+ });
+
+ it('falls back to the light URL when the dark sibling fails to load', () => {
+ renderLogo({ mode: 'dark', src: 'https://assets.example/icon.png' });
+
+ fireEvent.error(screen.getByRole('img', { name: 'Provider' }));
+
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute('src', 'https://assets.example/icon.png');
+ });
+
+ it('keeps an already-dark catalog URL in dark mode', () => {
+ renderLogo({ mode: 'dark', src: 'https://assets.example/github-dark.svg' });
+ expect(screen.getByRole('img', { name: 'Provider' })).toHaveAttribute(
+ 'src',
+ 'https://assets.example/github-dark.svg',
+ );
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx
index 1114c0a6b..6c45ddc8e 100644
--- a/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/primitives/Tooltip.test.tsx
@@ -75,6 +75,40 @@ describe('Tooltip', () => {
expect(onClick).not.toHaveBeenCalled();
});
+
+ it('opens below the trigger when side is bottom', () => {
+ render(
+ <Tooltip content="Below tip" side="bottom">
+ <button>Anchor</button>
+ </Tooltip>,
+ );
+
+ fireEvent.mouseEnter(screen.getByRole('button', { name: 'Anchor' }));
+
+ const tooltip = screen.getByRole('tooltip');
+ expect(tooltip).toHaveTextContent('Below tip');
+ expect(tooltip).toHaveStyle({ transform: 'translate(-50%, 0)' });
+ expect(tooltip.className).toMatch(/fixed/);
+ });
+
+ it('dismisses on click while still invoking the child handler', () => {
+ const onClick = vi.fn();
+
+ render(
+ <Tooltip content="Open picker">
+ <button onClick={onClick}>Chip</button>
+ </Tooltip>,
+ );
+
+ const trigger = screen.getByRole('button', { name: 'Chip' });
+ fireEvent.mouseEnter(trigger);
+ expect(screen.getByRole('tooltip')).toBeInTheDocument();
+
+ fireEvent.click(trigger);
+
+ expect(onClick).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('tooltip')).not.toBeInTheDocument();
+ });
});
describe('LightTooltip', () => {
diff --git a/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ConnectorDetails.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ConnectorDetails.test.tsx
new file mode 100644
index 000000000..2f6a5424f
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/ConnectorDetails.test.tsx
@@ -0,0 +1,94 @@
+// @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 ConnectorDetails from '@/containers/SettingsBuilder/ConnectorDetails.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { ConnectorBase, ToolBase } from '@/server/types.js';
+import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';
+
+const connector: ConnectorBase = {
+ id: 'conn-1',
+ name: 'Linear',
+ description: 'Issue tracker',
+ url: 'https://mcp.linear.app/mcp',
+ authenticated: true,
+ requiresAuth: false,
+ auth: { type: 'dcr' },
+};
+
+function wrapperFor(tools: ToolBase[]) {
+ const server = createMockAgentUIServer({
+ catalog: createMockCatalog({
+ connectorCatalog: {
+ getConnectorCatalog: async () => [],
+ listConnectors: async () => [],
+ getConnector: async () => connector,
+ getToolsByConnectorId: async () => tools,
+ createConnector: async () => connector,
+ updateConnector: async () => connector,
+ authenticateConnector: async () => ({ redirectUrl: '' }),
+ disconnectConnector: async () => undefined,
+ },
+ }),
+ });
+
+ return ({ children }: { children: ReactNode }) => <ServerProvider server={server}>{children}</ServerProvider>;
+}
+
+describe('ConnectorDetails tool descriptions', () => {
+ it('clamps long tool descriptions to one line and expands on Read more', async () => {
+ const longDescription =
+ 'First line of the tool description that should wrap. Second line continues with more detail. Third line must stay hidden until the reader expands the description fully.';
+
+ // jsdom does not layout text overflow; stub horizontal overflow detection.
+ vi.spyOn(HTMLElement.prototype, 'scrollWidth', 'get').mockReturnValue(400);
+ vi.spyOn(HTMLElement.prototype, 'clientWidth', 'get').mockReturnValue(200);
+
+ const Wrapper = wrapperFor([{ id: 'tool-1', name: 'create_issue', description: longDescription }]);
+
+ render(
+ <Wrapper>
+ <ConnectorDetails connector={connector} onBack={() => {}} onDisconnect={() => {}} />
+ </Wrapper>,
+ );
+
+ await waitFor(() => {
+ expect(screen.getByText('create_issue')).toBeInTheDocument();
+ });
+
+ const description = screen.getByText(longDescription);
+ expect(description).toHaveClass('whitespace-nowrap');
+
+ const readMore = await screen.findByRole('button', { name: 'Read more' });
+ expect(readMore).toHaveAttribute('aria-expanded', 'false');
+ expect(readMore).toHaveClass('absolute', 'right-0');
+ expect(readMore).toHaveTextContent('…Read more');
+
+ fireEvent.click(readMore);
+
+ expect(screen.getByRole('button', { name: 'Show less' })).toHaveAttribute('aria-expanded', 'true');
+ expect(description).not.toHaveClass('whitespace-nowrap');
+ expect(screen.queryByRole('button', { name: 'Read more' })).not.toBeInTheDocument();
+ });
+
+ it('hides Read more when the description fits in one line', async () => {
+ vi.spyOn(HTMLElement.prototype, 'scrollWidth', 'get').mockReturnValue(120);
+ vi.spyOn(HTMLElement.prototype, 'clientWidth', 'get').mockReturnValue(200);
+
+ const Wrapper = wrapperFor([{ id: 'tool-2', name: 'list_issues', description: 'Short description' }]);
+
+ render(
+ <Wrapper>
+ <ConnectorDetails connector={connector} onBack={() => {}} onDisconnect={() => {}} />
+ </Wrapper>,
+ );
+
+ await waitFor(() => {
+ expect(screen.getByText('list_issues')).toBeInTheDocument();
+ });
+
+ expect(screen.queryByRole('button', { name: 'Read more' })).not.toBeInTheDocument();
+ });
+});
diff --git a/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
index dad4f5f9d..3c36e6715 100644
--- a/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
+++ b/packages/trueforge-ui-sdk/test/theme/ThemeProvider.test.tsx
@@ -264,7 +264,7 @@ describe('ThemeProvider', () => {
it('preserves the semibold TrueFoundry welcome heading', () => {
render(
- <ThemeProvider theme={{ preset: 'truefoundry', mode: 'light' }}>
+ <ThemeProvider theme={{ preset: 'trueforge', mode: 'light' }}>
<WelcomeScreen />
</ThemeProvider>,
);
diff --git a/packages/trueforge-ui-sdk/test/utils/catalogLogo.test.ts b/packages/trueforge-ui-sdk/test/utils/catalogLogo.test.ts
new file mode 100644
index 000000000..91d1223c9
--- /dev/null
+++ b/packages/trueforge-ui-sdk/test/utils/catalogLogo.test.ts
@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveCatalogLogoSrc, toDarkCatalogLogoUrl, toLightCatalogLogoUrl } from '@/utils/catalogLogo.js';
+
+describe('toDarkCatalogLogoUrl', () => {
+ it('inserts -dark before the file extension', () => {
+ expect(toDarkCatalogLogoUrl('https://assets.example/icon.png')).toBe('https://assets.example/icon-dark.png');
+ expect(toDarkCatalogLogoUrl('https://assets.production.truefoundry.com/openai.svg')).toBe(
+ 'https://assets.production.truefoundry.com/openai-dark.svg',
+ );
+ });
+
+ it('preserves query and hash suffixes', () => {
+ expect(toDarkCatalogLogoUrl('https://assets.example/icon.png?v=2#mark')).toBe(
+ 'https://assets.example/icon-dark.png?v=2#mark',
+ );
+ });
+
+ it('returns undefined when the URL is already dark-suffixed', () => {
+ expect(toDarkCatalogLogoUrl('https://assets.example/icon-dark.png')).toBeUndefined();
+ expect(toDarkCatalogLogoUrl('https://assets.example/Sentry-Dark.svg')).toBeUndefined();
+ });
+
+ it('returns undefined for paths without a file extension', () => {
+ expect(toDarkCatalogLogoUrl('https://assets.example/icon')).toBeUndefined();
+ });
+});
+
+describe('toLightCatalogLogoUrl', () => {
+ it('strips -dark before the file extension', () => {
+ expect(toLightCatalogLogoUrl('https://assets.example/icon-dark.png')).toBe('https://assets.example/icon.png');
+ expect(toLightCatalogLogoUrl('https://assets.production.truefoundry.com/github-dark.svg')).toBe(
+ 'https://assets.production.truefoundry.com/github.svg',
+ );
+ });
+
+ it('preserves query and hash suffixes', () => {
+ expect(toLightCatalogLogoUrl('https://assets.example/icon-dark.png?v=2#mark')).toBe(
+ 'https://assets.example/icon.png?v=2#mark',
+ );
+ });
+
+ it('returns undefined when the URL is not dark-suffixed', () => {
+ expect(toLightCatalogLogoUrl('https://assets.example/icon.png')).toBeUndefined();
+ expect(toLightCatalogLogoUrl('https://assets.example/icon-darkmode.png')).toBeUndefined();
+ });
+});
+
+describe('resolveCatalogLogoSrc', () => {
+ it('keeps a light catalog URL in light mode', () => {
+ expect(resolveCatalogLogoSrc({ src: 'https://assets.example/icon.png', mode: 'light' })).toBe(
+ 'https://assets.example/icon.png',
+ );
+ });
+
+ it('strips -dark in light mode when the catalog URL is dark-suffixed', () => {
+ expect(resolveCatalogLogoSrc({ src: 'https://assets.example/github-dark.svg', mode: 'light' })).toBe(
+ 'https://assets.example/github.svg',
+ );
+ });
+
+ it('prefers the dark sibling in dark mode', () => {
+ expect(resolveCatalogLogoSrc({ src: 'https://assets.example/icon.png', mode: 'dark' })).toBe(
+ 'https://assets.example/icon-dark.png',
+ );
+ });
+
+ it('keeps a dark-suffixed catalog URL in dark mode', () => {
+ expect(resolveCatalogLogoSrc({ src: 'https://assets.example/icon-dark.png', mode: 'dark' })).toBe(
+ 'https://assets.example/icon-dark.png',
+ );
+ });
+});