Skip to content

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

Chore: Show runtime config in drawer (#635)

harshil-209612b02ff114d5
diff --git a/.changeset/runtime-config-drawer.md b/.changeset/runtime-config-drawer.md
new file mode 100644
index 000000000..668ce70d7
--- /dev/null
+++ b/.changeset/runtime-config-drawer.md
@@ -0,0 +1,5 @@
+---
+"@truefoundry/trueforge-ui": minor
+---
+
+Open Runtime Config in a right-side drawer and label scheduled sessions consistently.
diff --git a/packages/trueforge-ui/README.md b/packages/trueforge-ui/README.md
index 36a9651ef..9ac44523c 100644
--- a/packages/trueforge-ui/README.md
+++ b/packages/trueforge-ui/README.md
@@ -407,7 +407,7 @@ show the title text (see [Custom layouts](#custom-layouts)).
In library modes, picking an agent from Agents switches to a named chat for that agent **and remounts the runtime** so the new agent starts from a clean conversation. Draft chats can be promoted via **Save agent** (`server.saveAgent` on the resolved `AgentUIServer`). **Clear Chat** (thread header) resets the current named or draft session.
-Mutable composers expose **Agent Config** for live model parameters, instructions, runtime behavior, per-connector MCP tools, and skills. The compact Tools picker contains only Connectors and Skills. The Save Agent dialog keeps a local editable copy of the same configuration and shares the same selector dialogs; cancelling it leaves the active draft unchanged. Model context and output limits render when the server supplies that optional catalog metadata.
+Mutable composers expose **Agent Config** for live model parameters, instructions, runtime behavior, per-connector MCP tools, and skills. Runtime Config opens in a second right-side drawer. The compact Tools picker contains only Connectors and Skills. The Save Agent dialog keeps a local editable copy of the same configuration and shares the same selector dialogs; cancelling it leaves the active draft unchanged. Model context and output limits render when the server supplies that optional catalog metadata.
```tsx
{
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
index 28753446f..4ebe63184 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
@@ -31,9 +31,9 @@ export function AgentSessionListRow({
<span className="flex items-start justify-between gap-2">
<span className="line-clamp-2 text-sm font-medium text-text-primary">{title}</span>
{sourceType === 'schedule' ? (
- <Tooltip content="Scheduled run">
+ <Tooltip content="Scheduled Session">
<span aria-label="Scheduled run" className="mt-0.5 inline-flex shrink-0">
- <Icon name="calendar" className="size-3.5" />
+ <Icon name="calendar" className="size-3.5 text-primary-button-bg" />
</span>
</Tooltip>
) : null}
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentConfigEditors.tsx b/packages/trueforge-ui/src/atoms/draft/AgentConfigEditors.tsx
index 06814f49b..6d4a7b6e2 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentConfigEditors.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentConfigEditors.tsx
@@ -48,7 +48,7 @@ export function AgentConfigEditors({
}: AgentConfigEditorsProps) {
const AgentModelConfigModal = useSlot('AgentModelConfigModal');
const AgentResourceConfigModal = useSlot('AgentResourceConfigModal');
- const AgentRuntimeConfigModal = useSlot('AgentRuntimeConfigModal');
+ const AgentRuntimeConfigDrawer = useSlot('AgentRuntimeConfigDrawer');
const AgentInstructionsDrawer = useSlot('AgentInstructionsDrawer');
const [query, setQuery] = useState('');
const [activeConnectorId, setActiveConnectorId] = useState<string | null>(null);
@@ -141,7 +141,7 @@ export function AgentConfigEditors({
/>
) : null}
{editor === 'runtime' ? (
- <AgentRuntimeConfigModal
+ <AgentRuntimeConfigDrawer
open
spec={spec}
sandboxAvailable={sandboxAvailable}
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigModal.tsx b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigDrawer.tsx
similarity index 64%
rename from packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigModal.tsx
rename to packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigDrawer.tsx
index e4fc605df..8b39e2a61 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigModal.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigDrawer.tsx
@@ -2,9 +2,9 @@
import type { AgentSpec } from '../../server/types.js';
import { useSlot } from '../../theme/SlotsProvider.js';
-import { CenteredModal } from '../primitives/CenteredModal.js';
+import { SideDrawer } from '../primitives/SideDrawer.js';
-export type AgentRuntimeConfigModalProps = {
+export type AgentRuntimeConfigDrawerProps = {
open: boolean;
spec: AgentSpec;
sandboxAvailable: boolean;
@@ -12,31 +12,33 @@ export type AgentRuntimeConfigModalProps = {
onClose: () => void;
};
-export function AgentRuntimeConfigModal({
+export function AgentRuntimeConfigDrawer({
open,
spec,
sandboxAvailable,
onChange,
onClose,
-}: AgentRuntimeConfigModalProps) {
+}: AgentRuntimeConfigDrawerProps) {
const AgentRuntimeEditorContent = useSlot('AgentRuntimeEditorContent');
return (
- <CenteredModal
+ <SideDrawer
open={open}
onOpenChange={nextOpen => !nextOpen && onClose()}
title="Runtime Config"
- className="md:w-[min(56rem,calc(100%-3rem))] md:max-w-4xl"
- contentSized
+ description="Control execution, sandbox, and context behavior."
+ anchor="right"
+ size="xl"
+ className="md:w-3xl"
aria-label="Edit Runtime Config"
>
<AgentRuntimeEditorContent spec={spec} sandboxAvailable={sandboxAvailable} onChange={onChange} />
- </CenteredModal>
+ </SideDrawer>
);
}
declare module '../../theme/SlotsProvider.js' {
interface AtomSlots {
- AgentRuntimeConfigModal: typeof AgentRuntimeConfigModal;
+ AgentRuntimeConfigDrawer: typeof AgentRuntimeConfigDrawer;
}
}
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx
index 355a43928..04802619f 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeConfigFields.tsx
@@ -160,8 +160,8 @@ export function AgentRuntimeConfigFields({
return (
<div className="space-y-5">
{showCapabilities ? (
- // Stacked below `md` so the bottom-sheet modal does not cram three labeled switches into one row.
- <div className="flex flex-col gap-3 md:flex-row">
+ // Stack below `md` so narrow bottom sheets retain usable control widths.
+ <div className="flex flex-col gap-3 border-b border-border pb-5 md:flex-row">
{capabilityFields.map((field, index) =>
switchField({
field,
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeEditorContent.tsx b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeEditorContent.tsx
index 3baa1c9c7..8a5075aea 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentRuntimeEditorContent.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentRuntimeEditorContent.tsx
@@ -13,7 +13,7 @@ export function AgentRuntimeEditorContent({ spec, sandboxAvailable, onChange }:
const AgentRuntimeConfigFields = useSlot('AgentRuntimeConfigFields');
return (
- <div className="h-[min(38rem,calc(100dvh-8rem))] w-full overflow-y-auto p-5">
+ <div className="w-full p-5">
<AgentRuntimeConfigFields
value={spec.config ?? {}}
sandboxAvailable={sandboxAvailable}
diff --git a/packages/trueforge-ui/src/index.ts b/packages/trueforge-ui/src/index.ts
index 280d6a1e9..2b284bc9a 100644
--- a/packages/trueforge-ui/src/index.ts
+++ b/packages/trueforge-ui/src/index.ts
@@ -479,10 +479,10 @@ export { AgentResourceConfigModal } from './atoms/draft/AgentResourceConfigModal
export type { AgentResourceConfigModalProps } from './atoms/draft/AgentResourceConfigModal.js';
export { AgentResourceEditorContent } from './atoms/draft/AgentResourceEditorContent.js';
export type { AgentResourceEditorContentProps } from './atoms/draft/AgentResourceEditorContent.js';
+export { AgentRuntimeConfigDrawer } from './atoms/draft/AgentRuntimeConfigDrawer.js';
+export type { AgentRuntimeConfigDrawerProps } from './atoms/draft/AgentRuntimeConfigDrawer.js';
export { AgentRuntimeConfigFields } from './atoms/draft/AgentRuntimeConfigFields.js';
export type { AgentRuntimeConfigFieldsProps } from './atoms/draft/AgentRuntimeConfigFields.js';
-export { AgentRuntimeConfigModal } from './atoms/draft/AgentRuntimeConfigModal.js';
-export type { AgentRuntimeConfigModalProps } from './atoms/draft/AgentRuntimeConfigModal.js';
export { AgentRuntimeEditorContent } from './atoms/draft/AgentRuntimeEditorContent.js';
export type { AgentRuntimeEditorContentProps } from './atoms/draft/AgentRuntimeEditorContent.js';
export { AgentSkillsEditorContent } from './atoms/draft/AgentSkillsEditorContent.js';
diff --git a/packages/trueforge-ui/src/theme/defaultSlots.ts b/packages/trueforge-ui/src/theme/defaultSlots.ts
index dff5ceca9..e90eea4ff 100644
--- a/packages/trueforge-ui/src/theme/defaultSlots.ts
+++ b/packages/trueforge-ui/src/theme/defaultSlots.ts
@@ -50,8 +50,8 @@ import { AgentModelEditorContent } from '../atoms/draft/AgentModelEditorContent.
import { AgentModelSettingsContent } from '../atoms/draft/AgentModelSettingsContent.js';
import { AgentResourceConfigModal } from '../atoms/draft/AgentResourceConfigModal.js';
import { AgentResourceEditorContent } from '../atoms/draft/AgentResourceEditorContent.js';
+import { AgentRuntimeConfigDrawer } from '../atoms/draft/AgentRuntimeConfigDrawer.js';
import { AgentRuntimeConfigFields } from '../atoms/draft/AgentRuntimeConfigFields.js';
-import { AgentRuntimeConfigModal } from '../atoms/draft/AgentRuntimeConfigModal.js';
import { AgentRuntimeEditorContent } from '../atoms/draft/AgentRuntimeEditorContent.js';
import { AgentSkillsEditorContent } from '../atoms/draft/AgentSkillsEditorContent.js';
import { DraftAgentConfigTrigger } from '../atoms/draft/DraftAgentConfigTrigger.js';
@@ -157,7 +157,7 @@ export const defaultSlots = {
AgentConfigPanel,
AgentConfigSection,
AgentRuntimeConfigFields,
- AgentRuntimeConfigModal,
+ AgentRuntimeConfigDrawer,
AgentRuntimeEditorContent,
DraftCompositeSelector,
CatalogRow,
diff --git a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
index 1e6fb0510..f79bd3cb7 100644
--- a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
+++ b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
@@ -115,7 +115,7 @@ describe('SessionsPage', () => {
const indicator = await screen.findByLabelText('Scheduled run');
fireEvent.mouseEnter(indicator);
- expect(await screen.findByRole('tooltip')).toHaveTextContent('Scheduled run');
+ expect(await screen.findByRole('tooltip')).toHaveTextContent('Scheduled Session');
});
it('shows a single empty screen when there are no sessions', async () => {
diff --git a/packages/trueforge-ui/test/atoms/draft/AgentConfigEditors.test.tsx b/packages/trueforge-ui/test/atoms/draft/AgentConfigEditors.test.tsx
index d1f18a75f..85704b88d 100644
--- a/packages/trueforge-ui/test/atoms/draft/AgentConfigEditors.test.tsx
+++ b/packages/trueforge-ui/test/atoms/draft/AgentConfigEditors.test.tsx
@@ -232,7 +232,7 @@ describe('AgentConfigEditors', () => {
});
});
- it('opens runtime configuration in a dedicated modal', () => {
+ it('opens runtime configuration in a right-side drawer', () => {
const spec: AgentSpec = { model: { name: 'openai/gpt' } };
render(
<SlotsProvider>
@@ -251,7 +251,7 @@ describe('AgentConfigEditors', () => {
</SlotsProvider>,
);
- expect(screen.getByRole('dialog', { name: 'Runtime Config' })).toBeInTheDocument();
+ expect(screen.getByRole('dialog', { name: 'Runtime Config' })).toHaveClass('md:ml-auto', 'md:mr-0', 'md:h-dvh');
expect(screen.getByRole('switch', { name: 'Context compaction' })).toBeInTheDocument();
});
diff --git a/packages/trueforge-ui/test/containers/AgentConfigDrawerContainer.test.tsx b/packages/trueforge-ui/test/containers/AgentConfigDrawerContainer.test.tsx
index caf14eab7..a979d5fab 100644
--- a/packages/trueforge-ui/test/containers/AgentConfigDrawerContainer.test.tsx
+++ b/packages/trueforge-ui/test/containers/AgentConfigDrawerContainer.test.tsx
@@ -1,5 +1,5 @@
// @vitest-environment jsdom
-import { fireEvent, render, screen } from '@testing-library/react';
+import { fireEvent, render, screen, within } from '@testing-library/react';
import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
import { SaveAgentButton } from '@/atoms/SaveAgentButton.js';
@@ -103,6 +103,33 @@ describe('AgentConfigDrawerContainer', () => {
expect(screen.queryByRole('button', { name: 'Close agent config' })).not.toBeInTheDocument();
});
+ it('opens Runtime Config in a second right-side drawer', async () => {
+ render(
+ <SlotsProvider>
+ <ServerProvider server={createMockAgentUIServer()}>
+ <ShellModeProvider agentConfig={{ mode: 'AgentComposer' }}>
+ <AgentConfigInstructionsProvider>
+ <TestView compact={false} />
+ </AgentConfigInstructionsProvider>
+ </ShellModeProvider>
+ </ServerProvider>
+ </SlotsProvider>,
+ );
+
+ fireEvent.click(screen.getByRole('button', { name: 'Open config' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Edit Runtime Config' }));
+
+ const runtimeDrawer = await screen.findByRole('dialog', { name: 'Runtime Config' });
+ expect(runtimeDrawer).toHaveClass('md:ml-auto', 'md:mr-0', 'md:h-dvh');
+ fireEvent.click(within(runtimeDrawer).getByRole('switch', { name: 'Generative UI' }));
+
+ expect(updateAgentSpec).toHaveBeenCalledWith({
+ model: { name: 'openai/gpt-4.1' },
+ config: { generativeUi: { enabled: false } },
+ instructions: undefined,
+ });
+ });
+
it('commits drawer instructions and messages in one spec update', () => {
render(
<SlotsProvider>
diff --git a/packages/trueforge-ui/test/publicUiExports.test.ts b/packages/trueforge-ui/test/publicUiExports.test.ts
index 0eb0e69ee..326aec585 100644
--- a/packages/trueforge-ui/test/publicUiExports.test.ts
+++ b/packages/trueforge-ui/test/publicUiExports.test.ts
@@ -25,7 +25,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = [
'AgentResourceEditorContent',
'AgentResourceConfigModal',
'AgentRuntimeConfigFields',
- 'AgentRuntimeConfigModal',
+ 'AgentRuntimeConfigDrawer',
'AgentRuntimeEditorContent',
'AgentSkillsEditorContent',
'AgentSessionsFilters',