The open-source agent harness - the runtime layer that turns an LLM into a working agent.
feat: updated harnessBuilderServer to include capabilities retrieval and update skills handling (#101)
vinit-truefoundryda016d0a9098
diff --git a/packages/frontend/src/harnessBuilderServer.ts b/packages/frontend/src/harnessBuilderServer.tsindex 8b7711e8d..1e4c76cfb 100644--- a/packages/frontend/src/harnessBuilderServer.ts+++ b/packages/frontend/src/harnessBuilderServer.ts@@ -9,7 +9,7 @@ import type {SearchAgentsParams,} from '@truefoundry/trueforge-ui';import type { TrueForgeApi as Harness } from 'trueforge';-import { getCapabilities, listConfiguredMcpServers, listModels, listSkills } from './composerLists';+import { listConfiguredMcpServers, listModels, listSkills } from './composerLists';import { toUiConnector } from './connectorCatalog';import { createHarnessClient, harnessClient, type CreateHarnessClientOptions } from './harnessClient';import { agentManifest, toHarnessAgentSpec, toUiAgentSpec, type HarnessAgentSpec } from './harnessServer';@@ -44,13 +44,11 @@ export function createHarnessBuilderServer(options.baseUrl === undefined && options.fetch === undefined ? harnessClient : createHarnessClient(options);return {+ getCapabilities: () => client.server.getCapabilities(),getModels: async () => (await listModels()).map(toModelSelection),- // Skills require a configured sandbox provider; keep the picker empty when skill capability is off.getSkills: async () => {- const [capabilities, skills] = await Promise.all([getCapabilities(), listSkills()]);- return capabilities.skill.enabled- ? skills.map(skill => ({ id: skill.name, name: skill.name, description: skill.description }))- : [];+ const skills = await listSkills();+ return skills.map(skill => ({ id: skill.name, name: skill.name, description: skill.description }));},getMcp: async () => (await listConfiguredMcpServers()).map(toUiConnector),diff --git a/packages/frontend/tests/harnessBuilderServer.test.ts b/packages/frontend/tests/harnessBuilderServer.test.tsindex 275a3fbc2..ee47ba54e 100644--- a/packages/frontend/tests/harnessBuilderServer.test.ts+++ b/packages/frontend/tests/harnessBuilderServer.test.ts@@ -30,6 +30,32 @@ describe('harnessBuilderServer', () => {});});+ it('gets capabilities through the configured harness client', async () => {+ const fetchMock: typeof fetch = async input => {+ const url = input instanceof Request ? input.url : String(input);+ if (url.endsWith('/api/v1/capabilities')) {+ return Response.json({+ data: {+ sandbox: { enabled: false },+ skill: { enabled: false, reason: 'Configure a sandbox provider' },+ settings: { enabled: true },+ },+ });+ }+ return new Response(`Unexpected request: ${url}`, { status: 500 });+ };++ const builder = createHarnessBuilderServer({ fetch: fetchMock });++ assert.deepEqual(await builder.getCapabilities(), {+ data: {+ sandbox: { enabled: false },+ skill: { enabled: false, reason: 'Configure a sandbox provider' },+ settings: { enabled: true },+ },+ });+ });+it('searchAgents maps registry rows to library entries with agentId + agentSpec', async () => {const fetchMock: typeof fetch = async input => {const url = input instanceof Request ? input.url : String(input);diff --git a/packages/trueforge-ui-sdk/src/atoms/ShellActions.tsx b/packages/trueforge-ui-sdk/src/atoms/ShellActions.tsxindex f761a2ab0..be62df9a0 100644--- a/packages/trueforge-ui-sdk/src/atoms/ShellActions.tsx+++ b/packages/trueforge-ui-sdk/src/atoms/ShellActions.tsx@@ -1,7 +1,7 @@'use client';import { Icon } from '../icons/Icon.js';-import { useOptionalCatalogServer } from '../server/ServerContext.js';+import { useOptionalCatalogServer, useServerCapabilities } from '../server/ServerContext.js';import { useOptionalShellMode } from '../server/ShellModeContext.js';import { useTheme } from '../theme/ThemeProvider.js';import { auiButtonClass } from './lib/buttonClasses.js';@@ -10,6 +10,7 @@ import { cn } from './lib/cn.js';export function ShellActions({ className }: { className?: string }) {const shell = useOptionalShellMode();const catalog = useOptionalCatalogServer();+ const capabilities = useServerCapabilities();const { mode, setTheme } = useTheme();return (@@ -23,7 +24,7 @@ export function ShellActions({ className }: { className?: string }) {><Icon name={mode === 'dark' ? 'sun' : 'moon'} /></button>- {shell != null && catalog != null ? (+ {shell != null && catalog != null && capabilities?.settings?.enabled !== false ? (<buttontype="button"aria-label="Settings"diff --git a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsxindex 087e3a986..0f0f76901 100644--- a/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx+++ b/packages/trueforge-ui-sdk/src/atoms/draft/DraftCompositeSelector.tsx@@ -4,6 +4,7 @@ import { useTrueFoundryAgentSpec, useTrueFoundryUpdateAgentSpec } from '@truefouimport { useEffect, useId, useMemo, useRef, useState } from 'react';import { Icon } from '../../icons/Icon.js';+import { useServerCapabilities } from '../../server/ServerContext.js';import type { AgentSkill, ConnectorState, McpServerMount, SkillMount } from '../../server/types.js';import { auiButtonClass } from '../lib/buttonClasses.js';import { cn } from '../lib/cn.js';@@ -38,11 +39,13 @@ function CatalogRow({title,description,checked,+ disabled = false,onToggle,}: {title: string;description?: string;checked: boolean;+ disabled?: boolean;onToggle: () => void;}) {return (@@ -50,7 +53,8 @@ function CatalogRow({type="button"role="menuitemcheckbox"aria-checked={checked}- className="hover:bg-accent flex w-full items-start gap-2 rounded-md px-2 py-2 text-left"+ disabled={disabled}+ className="hover:bg-accent flex w-full items-start gap-2 rounded-md px-2 py-2 text-left disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent"onClick={onToggle}><span className="bg-muted text-muted-foreground mt-0.5 flex size-7 shrink-0 items-center justify-center rounded text-xs font-semibold">@@ -60,7 +64,7 @@ function CatalogRow({<span className="text-foreground block truncate text-sm font-medium">{title}</span>{description ? <span className="text-muted-foreground line-clamp-1 text-xs">{description}</span> : null}</span>- <Checkbox checked={checked} />+ {disabled ? <Icon name="lock" className="text-muted-foreground mt-1 size-3" /> : <Checkbox checked={checked} />}</button>);}@@ -107,6 +111,7 @@ function SectionHeading({ label, count }: { label: string; count: number }) {export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCompositeSelectorProps) {const { skills, connectors } = useDraftCatalog();+ const capabilities = useServerCapabilities();const { agentSpec } = useTrueFoundryAgentSpec();const updateAgentSpec = useTrueFoundryUpdateAgentSpec();const [open, setOpen] = useState(false);@@ -119,6 +124,8 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCconst menuId = useId();const isMobile = useIsMobile();const compactLayout = useCompactLayout();+ const skillsDisabled = capabilities?.skill.enabled !== true;+ const skillsDisabledReason = capabilities?.skill.reason;const selectedMcp = useMemo(() => (agentSpec?.mcpServers as McpServerMount[] | undefined) ?? [],@@ -252,6 +259,15 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftConChange={setQuery}placeholder={tab === 'connectors' ? 'Search connectors...' : 'Search skills...'}/>+ {tab === 'skills' && skillsDisabled && skillsDisabledReason ? (+ <div+ role="status"+ className="border-primary/30 bg-primary/5 text-foreground mx-3 mb-2 flex items-center gap-2 rounded-lg border p-3"+ >+ <Icon name="lock" className="text-primary size-3 shrink-0" />+ <span className="text-xs leading-none">{skillsDisabledReason}</span>+ </div>+ ) : null}<div className="min-h-0 flex-1 overflow-y-auto px-1 pb-2">{tab === 'connectors' ? (<>@@ -295,6 +311,7 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCtitle={s.name}description={s.description}checked={selectedSkillIds.has(s.id)}+ disabled={skillsDisabled && !selectedSkillIds.has(s.id)}onToggle={() => toggleSkill(s)}/>))}@@ -309,6 +326,7 @@ export function DraftCompositeSelector({ disabled, isRunning, onAttach }: DraftCtitle={s.name}description={s.description}checked={selectedSkillIds.has(s.id)}+ disabled={skillsDisabled && !selectedSkillIds.has(s.id)}onToggle={() => toggleSkill(s)}/>))}diff --git a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsxindex 71f1d762a..d532f7216 100644--- a/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx+++ b/packages/trueforge-ui-sdk/src/icons/IconRegistry.tsx@@ -30,6 +30,7 @@ import {ListFilter,ListOrdered,Loader2,+ Lock,Maximize2,Menu,Minimize2,@@ -116,6 +117,7 @@ const defaults: Record<string, LucideIcon> = {funnel: ListFilter,plug: Plug,'list-check': ListChecks,+ lock: Lock,lightbulb: Lightbulb,wrench: Wrench,cpu: Cpu,diff --git a/packages/trueforge-ui-sdk/src/index.ts b/packages/trueforge-ui-sdk/src/index.tsindex 8d7ddb79b..ae576d7f2 100644--- a/packages/trueforge-ui-sdk/src/index.ts+++ b/packages/trueforge-ui-sdk/src/index.ts@@ -226,6 +226,7 @@ export {useOptionalCatalogServer,useOptionalServer,useServer,+ useServerCapabilities,} from './server/ServerContext.js';export {DEFAULT_AGENT_CONFIG,@@ -237,6 +238,7 @@ export {} from './server/ShellModeContext.js';export type { AgentConfig, SelectLibraryAgentRequest, ShellMode } from './server/ShellModeContext.js';export type {+ AgentBuilderCapabilitiesResponse,AgentBuilderServer,AgentChatServer,AgentLibraryEntry,diff --git a/packages/trueforge-ui-sdk/src/server/ServerContext.tsx b/packages/trueforge-ui-sdk/src/server/ServerContext.tsxindex 017674593..d3c76a936 100644--- a/packages/trueforge-ui-sdk/src/server/ServerContext.tsx+++ b/packages/trueforge-ui-sdk/src/server/ServerContext.tsx@@ -1,13 +1,36 @@'use client';-import { createContext, useContext, type ReactNode } from 'react';+import { createContext, useContext, useEffect, useState, type ReactNode } from 'react';-import type { AgentUIServer, CatalogServer } from './types.js';+import type { AgentBuilderCapabilitiesResponse, AgentUIServer, CatalogServer } from './types.js';const ServerContext = createContext<AgentUIServer | null>(null);+const ServerCapabilitiesContext = createContext<AgentBuilderCapabilitiesResponse['data'] | null>(null);export function ServerProvider({ server, children }: { server: AgentUIServer; children: ReactNode }) {- return <ServerContext.Provider value={server}>{children}</ServerContext.Provider>;+ const [capabilities, setCapabilities] = useState<AgentBuilderCapabilitiesResponse['data'] | null>(null);++ useEffect(() => {+ let cancelled = false;+ setCapabilities(null);+ void server.getCapabilities().then(+ response => {+ if (!cancelled) setCapabilities(response.data);+ },+ () => {+ if (!cancelled) setCapabilities(null);+ },+ );+ return () => {+ cancelled = true;+ };+ }, [server]);++ return (+ <ServerContext.Provider value={server}>+ <ServerCapabilitiesContext.Provider value={capabilities}>{children}</ServerCapabilitiesContext.Provider>+ </ServerContext.Provider>+ );}export function useServer(): AgentUIServer {@@ -22,6 +45,10 @@ export function useOptionalServer(): AgentUIServer | null {return useContext(ServerContext);}+export function useServerCapabilities(): AgentBuilderCapabilitiesResponse['data'] | null {+ return useContext(ServerCapabilitiesContext);+}+export function useCatalogServer(): CatalogServer {const server = useServer();if (server.catalog == null) {diff --git a/packages/trueforge-ui-sdk/src/server/ShellModeContext.tsx b/packages/trueforge-ui-sdk/src/server/ShellModeContext.tsxindex b27282f55..41f94887c 100644--- a/packages/trueforge-ui-sdk/src/server/ShellModeContext.tsx+++ b/packages/trueforge-ui-sdk/src/server/ShellModeContext.tsx@@ -1,7 +1,8 @@'use client';-import { createContext, useCallback, useContext, useMemo, useRef, useState, type ReactNode } from 'react';+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';+import { useServerCapabilities } from './ServerContext.js';import type { AgentLibraryEntry, AgentSpec } from './types.js';/** Host-facing shell configuration for agent / library / composer chrome. */@@ -143,6 +144,7 @@ export function ShellModeProvider({agentConfig?: AgentConfig;children: ReactNode;}) {+ const capabilities = useServerCapabilities();const mutableSeedRef = useRef(mutableSeedFromConfig(agentConfig));if ((agentConfig.mode === 'AgentComposer' || agentConfig.mode === 'AgentLibraryWithComposer') &&@@ -161,9 +163,23 @@ export function ShellModeProvider({const [mutableEpoch, setMutableEpoch] = useState(0);const [clearEpoch, setClearEpoch] = useState(0);const [agentsListEpoch, setAgentsListEpoch] = useState(0);- const [settingsOpen, setSettingsOpen] = useState(false);+ const [settingsOpenState, setSettingsOpenState] = useState(false);const [historyAgentFilter, setHistoryAgentFilter] = useState<string | null>(null);const [pendingSessionId, setPendingSessionId] = useState<string | undefined>(undefined);+ const settingsEnabled = capabilities?.settings?.enabled !== false;+ const settingsOpen = settingsEnabled && settingsOpenState;+ const setSettingsOpen = useCallback(+ (open: boolean) => {+ setSettingsOpenState(settingsEnabled && open);+ },+ [settingsEnabled],+ );++ useEffect(() => {+ if (!settingsEnabled) {+ setSettingsOpenState(false);+ }+ }, [settingsEnabled]);const invalidateAgentsList = useCallback(() => {setAgentsListEpoch(n => n + 1);@@ -223,7 +239,7 @@ export function ShellModeProvider({});bumpEpoch(false);},- [isComposerEnabled, isLibraryEnabled, bumpEpoch],+ [isComposerEnabled, isLibraryEnabled, bumpEpoch, setSettingsOpen],);const bindMutableAgent = useCallback(@@ -293,7 +309,7 @@ export function ShellModeProvider({});bumpEpoch(false);},- [isLibraryEnabled, isComposerEnabled, locked, lockedAgentName, bumpEpoch],+ [isLibraryEnabled, isComposerEnabled, locked, lockedAgentName, bumpEpoch, setSettingsOpen],);const clearChat = useCallback(() => {@@ -356,6 +372,7 @@ export function ShellModeProvider({isComposerEnabled,isNewChatEnabled,settingsOpen,+ setSettingsOpen,selectLibraryAgent,bindMutableAgent,selectAgent,diff --git a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.ts b/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.tsindex 61c6cdf17..f53daf8f9 100644--- a/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.ts+++ b/packages/trueforge-ui-sdk/src/server/createTrueFoundryServer.ts@@ -1,4 +1,5 @@import type {+ AgentBuilderCapabilitiesResponse,AgentBuilderServer,AgentChatServer,AgentLibraryEntry,@@ -27,9 +28,11 @@ export type CreateTrueFoundryServerOptions<TAgent extends AgentLibraryEntry = AgentLibraryEntry,TSave = unknown,TCatalog extends CatalogServer = CatalogServer,+ TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,> = {/** Chat port — e.g. from `@truefoundry/agent-server-adapter`. */chatServer: AgentChatServer<TSpec>;+ getCapabilities: () => Promise<TCapabilities>;getModels: () => Promise<TModel[]>;getSkills: () => Promise<TSkill[]>;getMcp: () => Promise<TMcp[]>;@@ -48,6 +51,7 @@ export type TrueFoundryServer<TAgent extends AgentLibraryEntry = AgentLibraryEntry,TSave = unknown,TCatalog extends CatalogServer = CatalogServer,+ TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,> = AgentUIServer<TSpec,Session<TSpec>,@@ -62,7 +66,8 @@ export type TrueFoundryServer<TMcp,TAgent,TSave,- TCatalog+ TCatalog,+ TCapabilities>;/**@@ -78,10 +83,12 @@ export function createTrueFoundryServer<TAgent extends AgentLibraryEntry = AgentLibraryEntry,TSave = unknown,TCatalog extends CatalogServer = CatalogServer,+ TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,>(- opts: CreateTrueFoundryServerOptions<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog>,-): TrueFoundryServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog> {- const builder: AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave> = {+ opts: CreateTrueFoundryServerOptions<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog, TCapabilities>,+): TrueFoundryServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog, TCapabilities> {+ const builder: AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> = {+ getCapabilities: opts.getCapabilities,getModels: opts.getModels,getSkills: opts.getSkills,getMcp: opts.getMcp,@@ -96,9 +103,10 @@ export function createTrueFoundryServer<},};- return {+ const server: TrueFoundryServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog, TCapabilities> = {...opts.chatServer,...builder,...(opts.catalog != null ? { catalog: opts.catalog } : {}),- } as TrueFoundryServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCatalog>;+ };+ return server;}diff --git a/packages/trueforge-ui-sdk/src/server/types.ts b/packages/trueforge-ui-sdk/src/server/types.tsindex de7342a01..6fdb0ebb6 100644--- a/packages/trueforge-ui-sdk/src/server/types.ts+++ b/packages/trueforge-ui-sdk/src/server/types.ts@@ -341,6 +341,14 @@ export interface AgentChatServer<** Generics let hosts type their catalog rows richer than SDK base.*/+export interface AgentBuilderCapabilitiesResponse {+ data: {+ sandbox: { enabled: boolean };+ skill: { enabled: boolean; reason?: string };+ settings?: { enabled: boolean };+ };+}+export interface AgentBuilderServer<TSpec extends AgentSpec = AgentSpec,TModel extends ModelSelection = ModelSelection,@@ -348,7 +356,9 @@ export interface AgentBuilderServer<TMcp extends ConnectorState = ConnectorState,TAgent extends AgentLibraryEntry = AgentLibraryEntry,TSave = unknown,+ TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,> {+ getCapabilities(): Promise<TCapabilities>;getModels(): Promise<TModel[]>;getSkills(): Promise<TSkill[]>;getMcp(): Promise<TMcp[]>;@@ -710,7 +720,8 @@ export type AgentUIServer<TAgent extends AgentLibraryEntry = AgentLibraryEntry,TSave = unknown,TCatalog extends CatalogServer = CatalogServer,+ TCapabilities extends AgentBuilderCapabilitiesResponse = AgentBuilderCapabilitiesResponse,> = AgentChatServer<TSpec, TSession, TCreate, TList, TUpdate, TTurn, TEvent, TStreamEvent> &- AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave> & {+ AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> & {catalog?: TCatalog;};diff --git a/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsxindex 44291e3d7..19706ec44 100644--- a/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx@@ -210,12 +210,9 @@ describe('AgentsLibraryButton', () => {it('re-fetches the agent count when agentsListEpoch bumps', async () => {const searchAgents = vi.fn()- .mockResolvedValueOnce([{ name: 'alpha', agentId: 'alpha' }])- .mockResolvedValueOnce([- { name: 'alpha', agentId: 'alpha' },- { name: 'beta', agentId: 'beta' },- ]);- const server = { searchAgents } as unknown as AgentUIServer;+ .mockResolvedValueOnce([{ name: 'alpha' }])+ .mockResolvedValueOnce([{ name: 'alpha' }, { name: 'beta' }]);+ const server = createMockAgentUIServer({ searchAgents });function Invalidate() {const shell = useShellMode();diff --git a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsxindex 5be288084..14d76616a 100644--- a/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx+++ b/packages/trueforge-ui-sdk/test/atoms/draft/DraftCompositeSelector.test.tsx@@ -5,7 +5,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';import { DraftCatalogProvider } from '@/atoms/draft/DraftCatalogProvider.js';import { DraftCompositeSelector, type DraftCompositeSelectorProps } from '@/atoms/draft/DraftCompositeSelector.js';import { ServerProvider } from '@/server/ServerContext.js';-import type { AgentSpec } from '@/server/types.js';+import type { AgentBuilderCapabilitiesResponse, AgentSpec } from '@/server/types.js';import { createMockAgentUIServer } from '../../server/mockServer.js';let agentSpec: AgentSpec;@@ -16,8 +16,14 @@ vi.mock('@truefoundry/assistant-ui-runtime', () => ({useTrueFoundryUpdateAgentSpec: () => updateAgentSpec,}));-function renderSelector(props: DraftCompositeSelectorProps = {}) {+type RenderSelectorOptions = {+ props?: DraftCompositeSelectorProps;+ getCapabilities?: () => Promise<AgentBuilderCapabilitiesResponse>;+};++function renderSelector({ props = {}, getCapabilities }: RenderSelectorOptions = {}) {const server = createMockAgentUIServer({+ ...(getCapabilities === undefined ? {} : { getCapabilities }),getSkills: async () => [{ id: 'research', name: 'Research', description: 'Find relevant sources' },{ id: 'writer', name: 'Writer', description: 'Draft polished copy' },@@ -87,7 +93,7 @@ describe('DraftCompositeSelector', () => {it('forwards attachment requests and closes the picker', async () => {const onAttach = vi.fn();- renderSelector({ onAttach });+ renderSelector({ props: { onAttach } });const trigger = screen.getByRole('button', { name: 'Add connectors, skills, or attachments' });fireEvent.click(trigger);await screen.findByRole('menuitemcheckbox', { name: /GitHub/ });@@ -99,6 +105,38 @@ describe('DraftCompositeSelector', () => {expect(trigger).toHaveAttribute('aria-expanded', 'false');});+ it('disables available skills while allowing selected skills to be removed', async () => {+ renderSelector({+ getCapabilities: async () => ({+ data: {+ sandbox: { enabled: false },+ skill: { enabled: false, reason: 'Select Sandbox first' },+ },+ }),+ });+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));+ fireEvent.click(screen.getByRole('button', { name: /Skills/ }));++ expect(await screen.findByRole('status')).toHaveTextContent('Select Sandbox first');+ const research = screen.getByRole('menuitemcheckbox', { name: /Research/ });+ expect(research).toBeEnabled();+ expect(screen.getByRole('menuitemcheckbox', { name: /Writer/ })).toBeDisabled();+ fireEvent.click(research);++ expect(updateAgentSpec).toHaveBeenCalledWith({ skills: [] });+ });++ it('disables available skills until capabilities load', async () => {+ renderSelector({+ getCapabilities: () => new Promise<AgentBuilderCapabilitiesResponse>(() => {}),+ });+ fireEvent.click(screen.getByRole('button', { name: 'Add connectors, skills, or attachments' }));+ fireEvent.click(screen.getByRole('button', { name: /Skills/ }));++ expect(await screen.findByRole('menuitemcheckbox', { name: /Research/ })).toBeEnabled();+ expect(screen.getByRole('menuitemcheckbox', { name: /Writer/ })).toBeDisabled();+ });+it('cannot open while disabled or running', () => {const { rerender } = render(<DraftCompositeSelector disabled />);diff --git a/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsxindex 783e7fe83..4ea0727d8 100644--- a/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx+++ b/packages/trueforge-ui-sdk/test/containers/TrueforgeUI.test.tsx@@ -291,6 +291,41 @@ describe('SidebarLayout', () => {</SlotsProvider>,);expect(screen.getAllByRole('button', { name: 'Settings' })).toHaveLength(2);+ const [settingsButton] = screen.getAllByRole('button', { name: 'Settings' });+ if (settingsButton === undefined) {+ throw new Error('Expected settings button');+ }+ fireEvent.click(settingsButton);+ expect(screen.getByRole('heading', { name: 'Settings' })).toBeInTheDocument();++ rerender(+ <SlotsProvider theme={{ brand: { name: 'Acme' } }}>+ <ServerProvider+ server={createMockAgentUIServer({+ catalog: stubCatalog,+ getCapabilities: async () => ({+ data: {+ sandbox: { enabled: true },+ skill: { enabled: true },+ settings: { enabled: false },+ },+ }),+ })}+ >+ <ShellModeProvider>+ <RuntimeHarness messages={[]}>+ <div className="h-96">+ <SidebarLayout />+ </div>+ </RuntimeHarness>+ </ShellModeProvider>+ </ServerProvider>+ </SlotsProvider>,+ );+ await waitFor(() => {+ expect(screen.queryByRole('button', { name: 'Settings' })).not.toBeInTheDocument();+ expect(screen.queryByRole('heading', { name: 'Settings' })).not.toBeInTheDocument();+ });// No catalog → no Settings button.rerender(diff --git a/packages/trueforge-ui-sdk/test/publicUiExports.test.ts b/packages/trueforge-ui-sdk/test/publicUiExports.test.tsindex fe49ff683..cc7e133a9 100644--- a/packages/trueforge-ui-sdk/test/publicUiExports.test.ts+++ b/packages/trueforge-ui-sdk/test/publicUiExports.test.ts@@ -124,6 +124,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = ['useOptionalServer','useOptionalShellMode','useServer',+ 'useServerCapabilities','useShellMode','useSlot','useTheme',diff --git a/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.tsindex 3481df17b..1a2a3a9e4 100644--- a/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts+++ b/packages/trueforge-ui-sdk/test/server/createTrueFoundryServer.test.ts@@ -18,6 +18,10 @@ describe('createTrueFoundryServer', () => {listEvents: vi.fn(),});+ const capabilities = {+ data: { sandbox: { enabled: true }, skill: { enabled: true } },+ };+ const getCapabilities = vi.fn(async () => capabilities);const getModels = vi.fn(async () => [{ name: 'm', provider: 'p', apiModel: 'p/m', modelId: 'm' }]);const getSkills = vi.fn(async () => []);const getMcp = vi.fn(async () => []);@@ -26,6 +30,7 @@ describe('createTrueFoundryServer', () => {const server = createTrueFoundryServer({chatServer,+ getCapabilities,getModels,getSkills,getMcp,@@ -37,6 +42,7 @@ describe('createTrueFoundryServer', () => {expect(server.listSessions).toBe(chatServer.listSessions);expect(server.catalog).toBeUndefined();+ await expect(server.getCapabilities()).resolves.toEqual(capabilities);await expect(server.getModels()).resolves.toHaveLength(1);await expect(server.searchAgents({ query: 'ask' })).resolves.toEqual([{ name: 'ask-ai-agent', agentId: 'ask-ai-agent' },@@ -144,6 +150,9 @@ describe('createTrueFoundryServer', () => {const server = createTrueFoundryServer({chatServer,+ getCapabilities: async () => ({+ data: { sandbox: { enabled: false }, skill: { enabled: false } },+ }),getModels: async () => [],getSkills: async () => [],getMcp: async () => [],diff --git a/packages/trueforge-ui-sdk/test/server/mockServer.ts b/packages/trueforge-ui-sdk/test/server/mockServer.tsindex ddc29933a..5cce475c4 100644--- a/packages/trueforge-ui-sdk/test/server/mockServer.ts+++ b/packages/trueforge-ui-sdk/test/server/mockServer.ts@@ -39,6 +39,9 @@ export function createMockAgentUIServer(overrides: Partial<AgentUIServer> = {}):listTurns: unavailable,getTurn: unavailable,listEvents: unavailable,+ getCapabilities: async () => ({+ data: { sandbox: { enabled: true }, skill: { enabled: true } },+ }),getModels: async () => [],getSkills: async () => [],getMcp: async () => [],