Skip to content

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.ts
index 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.ts
index 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.tsx
index 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 ? (
<button
type="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.tsx
index 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 '@truefou
import { 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 }: DraftC
const 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 }: DraftC
onChange={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 }: DraftC
title={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 }: DraftC
title={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.tsx
index 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.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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 () => [],