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.mdxindex 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```tstype 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.mdxindex 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.mdxindex 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.yamlindex 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: remotename: sentry- logo: https://assets.production.truefoundry.com/sentry-dark.svg+ logo: https://assets.production.truefoundry.com/sentry.svgurl: https://mcp.sentry.dev/mcpauth:type: dcr@@ -34,7 +34,7 @@ mcp_servers:url: https://search.parallel.ai/mcp- type: remotename: github- logo: https://assets.production.truefoundry.com/github-dark.svg+ logo: https://assets.production.truefoundry.com/github.svgurl: https://api.githubcopilot.com/mcp/auth:type: headerdiff --git a/packages/trueforge-ui-sdk/CHANGELOG.md b/packages/trueforge-ui-sdk/CHANGELOG.mdindex 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'` (exportkept 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.mdindex 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.mdindex 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` — stylistichomages, 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.mdindex 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```tstype 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 arestylistic 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.tsxindex 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<h1className={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.tsxindex 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 }: Compreturn (<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.tsxindex 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 }: DraftCscheduleFlush();};- 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"><buttontype="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.tsxindex 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 (<buttonkey={value || model.modelId || model.name}@@ -199,7 +202,7 @@ export function DraftModelSelector({ disabled, isRunning }: DraftModelSelectorPrclassName={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.tsxnew file mode 100644index 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.tsxindex 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.tsxindex 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.tsxindex 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 = (<><spanclassName="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.tsxindex 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.tsxindex 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; childrconst 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<divclassName={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.tsindex 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.tsindex 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 'reacexport 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.tsnew file mode 100644index 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.tsxindex 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.tsxindex 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.tsxnew file mode 100644index 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.tsxindex 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.tsxnew file mode 100644index 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.tsxindex 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.tsnew file mode 100644index 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',+ );+ });+});