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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.tsxindex 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.tsxindex 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?: strinclassName,)}>+ <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><buttontype="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.tsxindex 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><divclassName={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.tsxindex 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.tsxindex 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.tsxindex 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"><AgentSessionEventTimelineChartturns={turns}segments={segments}diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionEventTimelineChart.tsxindex 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.tsxindex 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.tsxindex 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, shareViewkey={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.tsindex 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.tsxindex 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.tsxindex 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.tsxindex 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 }) {<asiderole="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.tsindex 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 = CreateTrueForgeClientOptioexport 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.tsxindex 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.tsxindex 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.tsxindex 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.tsxindex 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.tsindex 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',