Skip to content

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

Refine settings empty-state and helper copy (#100)

shubhamagarwal-create0c452e50143e
diff --git a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx b/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
index f497200fb..dbbdf55e7 100644
--- a/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
+++ b/packages/trueforge-ui-sdk/src/atoms/AgentsLibrary.tsx
@@ -177,7 +177,11 @@ export function AgentsLibrary({ open, onOpenChange, onSelectAgent }: AgentsLibra
) : error ? (
<p className="text-destructive px-3 py-8 text-center text-sm">{error}</p>
) : agents.length === 0 ? (
- <p className="text-muted-foreground px-3 py-8 text-center text-sm">No agents found</p>
+ <p className="text-muted-foreground px-3 py-8 text-center text-sm">
+ {query.trim()
+ ? `No agents match "${query.trim()}".`
+ : 'No agents yet. Build one in a chat, then save it as an agent.'}
+ </p>
) : (
agents.map(agent => {
const agentSpec = agent.agentSpec;
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
index 329a76090..2ac237df6 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/ConnectorSettings.tsx
@@ -362,7 +362,7 @@ const ConnectorSettings = () => {
return (
<>
<h3 className="text-xl font-semibold tracking-tight text-foreground">Connectors</h3>
- <p className="mt-1 text-sm text-muted-foreground">Enable the tools agents may call.</p>
+ <p className="mt-1 text-sm text-muted-foreground">Connect tools your agents can use.</p>
{error ? (
<p className="mt-3 rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive">
diff --git a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.tsx b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.tsx
index a6cd5386e..218f5f0bd 100644
--- a/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.tsx
+++ b/packages/trueforge-ui-sdk/src/containers/SettingsBuilder/SandboxSettings.tsx
@@ -136,8 +136,7 @@ const SandboxSettings = () => {
<>
<h3 className="text-xl font-semibold tracking-tight text-foreground">Sandbox providers</h3>
<p className="mt-1 text-sm text-muted-foreground">
- Choose a provider that runs sandboxes for code, files, and shell commands. These are providers, not sandboxes
- themselves. Only one sandbox provider can be configured for this workspace.
+ Choose a provider that runs sandboxes for code, files and shell commands. Only one can be active at a time.
</p>
{error ? (
@@ -222,7 +221,7 @@ const SandboxSettings = () => {
{availableEntries.length === 0 ? (
<p className="text-sm text-muted-foreground">
{hasConfiguredProvider
- ? 'A sandbox provider is already configured. Remove it to choose a different one.'
+ ? 'One provider is set up. Update it or remove it to switch.'
: catalog.length > 0
? 'All catalog providers are configured.'
: 'No sandbox providers in the catalog.'}
diff --git a/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
index 2da1b9372..44291e3d7 100644
--- a/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
+++ b/packages/trueforge-ui-sdk/test/atoms/AgentsLibrary.test.tsx
@@ -145,6 +145,45 @@ describe('AgentsLibrary', () => {
});
expect(screen.queryByRole('button', { name: 'Edit agent writer' })).not.toBeInTheDocument();
});
+
+ it('shows create-one guidance when there are no agents yet', async () => {
+ const server = mockServer([]);
+
+ render(
+ <SlotsProvider>
+ <ServerProvider server={server}>
+ <ShellModeProvider>
+ <AgentsLibrary open onOpenChange={() => undefined} />
+ </ShellModeProvider>
+ </ServerProvider>
+ </SlotsProvider>,
+ );
+
+ await waitFor(() => {
+ expect(screen.getByText('No agents yet. Build one in a chat, then save it as an agent.')).toBeInTheDocument();
+ });
+ });
+
+ it('shows a no-matches message (not the create-one guidance) when a search returns nothing', async () => {
+ const server = mockServer([]);
+
+ render(
+ <SlotsProvider>
+ <ServerProvider server={server}>
+ <ShellModeProvider>
+ <AgentsLibrary open onOpenChange={() => undefined} />
+ </ShellModeProvider>
+ </ServerProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.change(screen.getByPlaceholderText('Search agents'), { target: { value: 'zzz' } });
+
+ await waitFor(() => {
+ expect(screen.getByText('No agents match "zzz".')).toBeInTheDocument();
+ });
+ expect(screen.queryByText('No agents yet. Build one in a chat, then save it as an agent.')).not.toBeInTheDocument();
+ });
});
describe('AgentsLibraryButton', () => {
diff --git a/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
index 62b946cbe..51e9f3778 100644
--- a/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
+++ b/packages/trueforge-ui-sdk/test/containers/SettingsBuilder/SandboxSettings.test.tsx
@@ -211,8 +211,6 @@ describe('SandboxSettings', () => {
expect(screen.getByText('Sandbox providers')).toBeTruthy();
});
expect(screen.queryByRole('button', { name: 'Configure' })).toBeNull();
- expect(
- screen.getByText('A sandbox provider is already configured. Remove it to choose a different one.'),
- ).toBeTruthy();
+ expect(screen.getByText('One provider is set up. Update it or remove it to switch.')).toBeTruthy();
});
});