Skip to content

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

chore: mark schedule runs and widen agent config and some ui fixes (#626)

harshil-20961b8a3f7f5a41
diff --git a/.changeset/add-documentation-links.md b/.changeset/add-documentation-links.md
new file mode 100644
index 000000000..a39392f92
--- /dev/null
+++ b/.changeset/add-documentation-links.md
@@ -0,0 +1,5 @@
+---
+"@truefoundry/trueforge-ui": patch
+---
+
+Add documentation links to the code snippets view and shell actions.
diff --git a/.changeset/wide-agent-config-panel.md b/.changeset/wide-agent-config-panel.md
new file mode 100644
index 000000000..ab0fa49ab
--- /dev/null
+++ b/.changeset/wide-agent-config-panel.md
@@ -0,0 +1,5 @@
+---
+"@truefoundry/trueforge-ui": patch
+---
+
+Match the Build Agent configuration panel width to the agent playground and identify sessions created by schedule runs.
diff --git a/packages/trueforge-ui/src/atoms/PageHeader.tsx b/packages/trueforge-ui/src/atoms/PageHeader.tsx
index 50f0d272f..02f6ea774 100644
--- a/packages/trueforge-ui/src/atoms/PageHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/PageHeader.tsx
@@ -25,10 +25,7 @@ export type PageHeaderProps = {
export function PageHeader({ title, start, end, children, className }: PageHeaderProps) {
return (
<header
- className={cn(
- 'flex min-h-14 shrink-0 flex-wrap items-center gap-2 border-b border-border px-4 md:px-6',
- className,
- )}
+ className={cn('flex min-h-14 shrink-0 flex-wrap items-center gap-2 border-b border-border px-4', className)}
>
{start}
{typeof title === 'string' ? <h1 className={pageHeaderTitleClassName}>{title}</h1> : title}
diff --git a/packages/trueforge-ui/src/atoms/ShellActions.tsx b/packages/trueforge-ui/src/atoms/ShellActions.tsx
index 941970c78..1890184e4 100644
--- a/packages/trueforge-ui/src/atoms/ShellActions.tsx
+++ b/packages/trueforge-ui/src/atoms/ShellActions.tsx
@@ -29,6 +29,21 @@ export function ShellActions({ className, labeled = false }: { className?: strin
className,
)}
>
+ <a
+ href="https://trueforge.dev"
+ target="_blank"
+ rel="noopener noreferrer"
+ aria-label="Documentation"
+ title="Documentation"
+ className={auiButtonClass({
+ variant: 'ghost',
+ size: labeled ? undefined : 'icon',
+ className: cn(hoverClass, labeled && sidebarRailButtonClassName),
+ })}
+ >
+ <Icon name="book-open" size={labeled ? 14 : undefined} />
+ {labeled ? <span className="text-center">Docs</span> : null}
+ </a>
<button
type="button"
aria-label={isDark ? 'Switch to light theme' : 'Switch to dark theme'}
diff --git a/packages/trueforge-ui/src/atoms/ThreadShell.tsx b/packages/trueforge-ui/src/atoms/ThreadShell.tsx
index b012a8be9..5dd73a9c0 100644
--- a/packages/trueforge-ui/src/atoms/ThreadShell.tsx
+++ b/packages/trueforge-ui/src/atoms/ThreadShell.tsx
@@ -41,7 +41,7 @@ export const ThreadViewportShell = forwardRef<HTMLDivElement, ThreadViewportShel
>
<div
className={cn(
- 'mx-auto flex w-full min-w-0 max-w-(--thread-max-width) flex-col px-3 pt-3 sm:px-4 sm:pt-4',
+ 'mx-auto flex w-full min-w-0 max-w-(--thread-max-width) flex-col px-3 pt-3',
isEmpty ? 'min-h-full justify-center pb-4' : 'pb-32',
)}
>
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentCodeSnippets.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentCodeSnippets.tsx
index 651593224..c3e00f37c 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentCodeSnippets.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentCodeSnippets.tsx
@@ -54,26 +54,37 @@ export default function AgentCodeSnippets({ snippets }: AgentCodeSnippetsProps)
</nav>
<section className="flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden rounded-lg border border-border bg-card-bg">
- <div className="flex h-10 shrink-0 items-end gap-1 border-b border-border px-3">
- {(
- [
- ['stream', 'Stream'],
- ['nonStream', 'Non-stream'],
- ] satisfies Array<[SnippetMode, string]>
- ).map(([id, label]) => (
- <button
- key={id}
- type="button"
- className={cn(
- 'relative h-10 cursor-pointer px-3 text-xs font-medium text-text-secondary',
- mode === id &&
- 'text-primary-button-bg after:absolute after:inset-x-0 after:bottom-0 after:h-0.5 after:bg-primary-button-bg',
- )}
- onClick={() => setMode(id)}
- >
- {label}
- </button>
- ))}
+ <div className="flex h-10 shrink-0 items-center justify-between gap-1 border-b border-border px-3">
+ <div className="flex items-end gap-1">
+ {(
+ [
+ ['stream', 'Stream'],
+ ['nonStream', 'Non-stream'],
+ ] satisfies Array<[SnippetMode, string]>
+ ).map(([id, label]) => (
+ <button
+ key={id}
+ type="button"
+ className={cn(
+ 'relative h-10 cursor-pointer px-3 text-xs font-medium text-text-secondary',
+ mode === id &&
+ 'text-primary-button-bg after:absolute after:inset-x-0 after:bottom-0 after:h-0.5 after:bg-primary-button-bg',
+ )}
+ onClick={() => setMode(id)}
+ >
+ {label}
+ </button>
+ ))}
+ </div>
+ <a
+ href="https://trueforge.dev/api/use-agent"
+ target="_blank"
+ rel="noopener noreferrer"
+ className="flex items-center gap-1 text-xs text-text-secondary"
+ >
+ <span>View Docs</span>
+ <Icon name="external-link" className="size-3 shrink-0" />
+ </a>
</div>
<div className="min-h-0 flex-1 overflow-auto">
<AgentCodeBlock code={selected.sampleCode[mode]} language={selected.language} />
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
index f92653d9c..202c2c548 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
@@ -41,7 +41,7 @@ export function AgentSessionDetailHeader({
};
return (
- <div className="flex shrink-0 items-center gap-3 border-b border-border px-4 py-3">
+ <div className="flex shrink-0 items-center gap-3 border-b border-border p-3">
<div className="flex min-w-0 flex-1 items-center gap-1.5">
<h2 className="min-w-0 truncate text-sm font-semibold text-text-primary">{title}</h2>
<code className="min-w-0 truncate font-mono text-xs text-text-secondary">{sessionId}</code>
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimeline.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimeline.tsx
index a8013910a..98cdbeb8a 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimeline.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimeline.tsx
@@ -59,7 +59,7 @@ export function AgentSessionEventTimeline({ turns, segments, onSelectTurn }: Age
})}
</div>
</div>
- <div className="w-full py-2">
+ <div className="w-full p-2">
<AgentSessionEventTimelineChart
turns={turns}
segments={segments}
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsx
index 7a355dc33..240ef0189 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsx
@@ -454,6 +454,7 @@ export function AgentSessionEventTimelineChart({
},
ticks: {
color: axis,
+ align: 'inner',
autoSkip: false,
includeBounds: false,
maxTicksLimit: 9,
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
index b09a7ac63..28753446f 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionListRow.tsx
@@ -4,11 +4,13 @@ import { Icon } from '../../icons/Icon.js';
import { formatSessionListMetrics } from '../../utils/sessionDisplayFormat.js';
import { cn } from '../lib/cn.js';
import { formatRelativeShort } from '../lib/threadListMeta.js';
+import { Tooltip } from '../primitives/Tooltip.js';
import type { AgentSessionListRowProps } from './types.js';
export function AgentSessionListRow({
title,
agentName,
+ sourceType,
lastActivityAt,
metrics,
active,
@@ -22,11 +24,20 @@ export function AgentSessionListRow({
onClick={onSelect}
data-active={active || undefined}
className={cn(
- 'flex w-full flex-col gap-2 border-b border-border px-3 py-3 text-left transition-colors',
+ 'flex w-full flex-col gap-2 border-b border-border px-4 py-3 text-left transition-colors',
active ? 'bg-dropdown-selected-item-bg' : 'hover:bg-ghost-button-hover',
)}
>
- <span className="line-clamp-2 text-sm font-medium text-text-primary">{title}</span>
+ <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">
+ <span aria-label="Scheduled run" className="mt-0.5 inline-flex shrink-0">
+ <Icon name="calendar" className="size-3.5" />
+ </span>
+ </Tooltip>
+ ) : null}
+ </span>
<span className="flex items-end justify-between gap-2 text-xs text-text-secondary">
<span className="flex min-w-0 items-center gap-1">
{agentName != null ? (
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
index 80cb278ed..129b51ed5 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
@@ -31,6 +31,10 @@ function entryIsMutable(entry: SessionListEntry): boolean {
return entry.agentName == null;
}
+function entrySourceType(entry: SessionListEntry): 'schedule' | undefined {
+ return 'sourceType' in entry && Reflect.get(entry, 'sourceType') === 'schedule' ? 'schedule' : undefined;
+}
+
export function AgentSessions({ agentId, startTimestamp, endTimestamp, shareView }: AgentSessionsProps) {
const sessionsServer = useAgentSessionsServer();
const chatServer = useServer();
@@ -243,6 +247,7 @@ export function AgentSessions({ agentId, startTimestamp, endTimestamp, shareView
key={entry.id}
title={sessionTitle(entry)}
agentName={entry.agentName ?? undefined}
+ sourceType={entrySourceType(entry)}
lastActivityAt={entry.lastActivityAt}
metrics={entry.metrics}
active={entry.id === selectedSessionId}
diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.ts
index 46d307640..90a4acaa7 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts
+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts
@@ -23,6 +23,7 @@ export type AgentSessionsProps = {
export type AgentSessionListRowProps = {
title: string;
agentName?: string;
+ sourceType?: 'schedule';
lastActivityAt: string;
metrics: {
totalTurns: number;
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx b/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
index 97baa13dd..0b19f5eb3 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
@@ -229,7 +229,7 @@ export function AgentConfigPanel({
return (
<div className="bg-card-bg text-text-primary flex h-full min-h-0 flex-col">
- <header className="flex min-h-14 shrink-0 items-center gap-1 border-b border-border bg-topbar-bg px-2 py-1.5">
+ <header className="flex min-h-14 shrink-0 items-center gap-1 border-b border-border bg-topbar-bg px-3 py-1.5">
<Icon name="sliders" className="size-4" />
<h2 className="text-sm font-semibold">Agent Config</h2>
<span className="min-w-0 flex-1" />
diff --git a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
index fcd0a9ee5..0fa5abeb8 100644
--- a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
@@ -389,7 +389,7 @@ export function SchedulesPage() {
}
/>
- <div className="min-h-0 flex-1 overflow-auto px-4 py-4 md:px-6">
+ <div className="min-h-0 flex-1 overflow-auto px-4 py-4">
{loading ? (
<div className="flex flex-col gap-2" role="status" aria-label="Loading schedules">
{Array.from({ length: 5 }, (_, i) => (
diff --git a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx b/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
index 409052ca5..568ad44b0 100644
--- a/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
+++ b/packages/trueforge-ui/src/layouts/SidebarLayout.tsx
@@ -108,7 +108,7 @@ function SidebarNav(): ReactNode {
onClick={handleNewAgent}
>
<Icon name="agent-2" size={14} />
- <span className="text-center">New Agent</span>
+ <span className="text-center whitespace-nowrap">Build Agent</span>
</button>
) : null}
<AgentsLibraryButton compact />
@@ -216,7 +216,7 @@ export function SidebarLayout({ className }: { className?: string }) {
<aside
role="dialog"
aria-label="Agent Config"
- className="absolute inset-y-0 left-0 z-20 w-full max-w-sm border-r border-border shadow-xl md:static md:z-auto md:w-88 md:max-w-none md:shrink-0 md:shadow-none"
+ className="absolute inset-y-0 left-0 z-20 w-full max-w-sm border-r border-border shadow-xl md:static md:z-auto md:max-w-140 md:flex-1 md:shadow-none 2xl:max-w-150"
>
<AgentConfigDrawerContainer showClose={isMobile} />
</aside>
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts
index bee2cbd31..d0edf239b 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentSessionsServer.ts
@@ -13,6 +13,7 @@ export type CreateHarnessAgentSessionsServerOptions = CreateTrueForgeClientOptio
export type HarnessSessionListEntry = SessionListEntry<HarnessAgentSpec> & {
isCreateAgent: boolean;
isMutable: boolean;
+ sourceType?: 'schedule';
};
function toSessionListEntry(session: TrueForgeApi.Session): HarnessSessionListEntry {
@@ -31,6 +32,7 @@ function toSessionListEntry(session: TrueForgeApi.Session): HarnessSessionListEn
...(session.title === null ? {} : { title: session.title }),
...(session.agent.type === 'reference' && session.agent.name !== null ? { agentName: session.agent.name } : {}),
...(session.agent.type === 'inline' ? { agentSpec: toUiAgentSpec(session.agent.spec) } : {}),
+ ...(session.source?.type === 'schedule' ? { sourceType: session.source.type } : {}),
};
}
diff --git a/packages/trueforge-ui/test/atoms/AgentSessionEventTimelineChart.test.tsx b/packages/trueforge-ui/test/atoms/AgentSessionEventTimelineChart.test.tsx
index fc2e4680b..5d4f1822e 100644
--- a/packages/trueforge-ui/test/atoms/AgentSessionEventTimelineChart.test.tsx
+++ b/packages/trueforge-ui/test/atoms/AgentSessionEventTimelineChart.test.tsx
@@ -120,6 +120,7 @@ describe('AgentSessionEventTimelineChart', () => {
const xScale = typeof scales === 'object' && scales != null ? Reflect.get(scales, 'x') : undefined;
const ticks = typeof xScale === 'object' && xScale != null ? Reflect.get(xScale, 'ticks') : undefined;
expect(typeof ticks === 'object' && ticks != null ? Reflect.has(ticks, 'stepSize') : false).toBe(false);
+ expect(typeof ticks === 'object' && ticks != null ? Reflect.get(ticks, 'align') : undefined).toBe('inner');
});
it('keeps an open tooltip anchored to live chart bounds while scrolling', async () => {
diff --git a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
index 08b7c824d..1e6fb0510 100644
--- a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
+++ b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx
@@ -109,6 +109,15 @@ describe('SessionsPage', () => {
expect(screen.getByRole('separator', { name: 'Resize session list' })).toHaveClass('w-0');
});
+ it('labels sessions created by a schedule run', async () => {
+ const scheduledRow = { ...namedRow, id: 'sess-scheduled', sourceType: 'schedule' as const };
+ renderPage({ listSessions: vi.fn(async () => ({ data: [scheduledRow] })) });
+
+ const indicator = await screen.findByLabelText('Scheduled run');
+ fireEvent.mouseEnter(indicator);
+ expect(await screen.findByRole('tooltip')).toHaveTextContent('Scheduled run');
+ });
+
it('shows a single empty screen when there are no sessions', async () => {
renderPage({ listSessions: vi.fn(async () => ({ data: [] })) });
expect(await screen.findByRole('heading', { name: 'Agent Sessions' })).toBeInTheDocument();
diff --git a/packages/trueforge-ui/test/atoms/draft/AgentConfigPanel.test.tsx b/packages/trueforge-ui/test/atoms/draft/AgentConfigPanel.test.tsx
index 420ca2ddb..6f7860599 100644
--- a/packages/trueforge-ui/test/atoms/draft/AgentConfigPanel.test.tsx
+++ b/packages/trueforge-ui/test/atoms/draft/AgentConfigPanel.test.tsx
@@ -89,7 +89,7 @@ describe('AgentConfigPanel', () => {
'min-h-14',
'border-b',
'bg-topbar-bg',
- 'px-2',
+ 'px-3',
'py-1.5',
);
});
diff --git a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
index d3dd4fa3f..9aaed083b 100644
--- a/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
+++ b/packages/trueforge-ui/test/containers/TrueForgeUI.test.tsx
@@ -508,6 +508,7 @@ describe('SidebarLayout', () => {
expect(screen.queryByText('Acme')).not.toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Start new chat' })).toBeInTheDocument();
expect(screen.getByText('New Chat')).toBeInTheDocument();
+ expect(screen.getByRole('link', { name: 'Documentation' })).toHaveAttribute('href', 'https://trueforge.dev');
expect(screen.queryByRole('button', { name: /^(Collapse|Expand) sidebar$/ })).not.toBeInTheDocument();
});
@@ -540,7 +541,7 @@ describe('SidebarLayout', () => {
expect(deselectedNewChat).not.toHaveAttribute('aria-current');
const config = await screen.findByRole('dialog', { name: 'Agent Config' });
const chatColumn = config.nextElementSibling;
- expect(config).toHaveClass('border-r');
+ expect(config).toHaveClass('md:max-w-140', 'md:flex-1', '2xl:max-w-150', 'border-r');
expect(chatColumn).not.toBeNull();
expect(config.querySelector('header')).toHaveClass('min-h-14');
expect(chatColumn?.querySelector('header')).toHaveClass('min-h-14');
diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts
index a25098d46..b893e47f6 100644
--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts
+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/agentSessionsServer.test.ts
@@ -69,6 +69,11 @@ describe('createHarnessAgentSessionsServer', () => {
totalCostInUsd: 0.25,
totalDurationMs: 29_711,
},
+ source: {
+ type: 'schedule',
+ id: 'schedule-1',
+ runId: 'run-1',
+ },
},
],
response: { pagination: { nextPageToken: 'next-1' } },
@@ -101,6 +106,7 @@ describe('createHarnessAgentSessionsServer', () => {
isMutable: false,
metrics: { totalTurns: 3, totalCostInUsd: 0.25, totalDurationMs: 29_711 },
agentName: 'writer',
+ sourceType: 'schedule',
},
],
nextPageToken: 'next-1',