The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Add reload button on Sessions page for fetching latest data (#906)
harshil-2096e8d58c354cf2
diff --git a/.changeset/sessions-page-reload-button.md b/.changeset/sessions-page-reload-button.mdnew file mode 100644index 000000000..0cca71195--- /dev/null+++ b/.changeset/sessions-page-reload-button.md@@ -0,0 +1,5 @@+---+'@truefoundry/trueforge-ui': patch+---++Add a reload button before the agent filter on the Sessions page to fetch latest data without requiring a browser refresh.diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsxindex cf753fff3..3cd72793e 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx@@ -51,6 +51,8 @@ export function AgentSessions({detailSessionId,onCloseDetail,onLoadRecentSessions,+ refreshKey = 0,+ onLoadingChange,}: AgentSessionsProps) {const sessionsServer = useAgentSessionsServer();const chatServer = useServer();@@ -142,7 +144,7 @@ export function AgentSessions({return () => {cancelled = true;};- }, [detailOnly, listRequest, sessionsServer]);+ }, [detailOnly, listRequest, refreshKey, sessionsServer]);const loadMore = useCallback(async () => {// A ref, not `listLoadingMore`: the observer can fire twice before a re-render.@@ -230,7 +232,10 @@ export function AgentSessions({return () => {cancelled = true;};- }, [chatServer, detailOnly, onCloseDetail, selectedSessionId, sessionsServer, toaster]);+ }, [chatServer, detailOnly, onCloseDetail, refreshKey, selectedSessionId, sessionsServer, toaster]);+ useEffect(() => {+ onLoadingChange?.(listLoading || detailLoading);+ }, [detailLoading, listLoading, onLoadingChange]);const selectSession = (entry: SessionListEntry) => {const pinned = shareView === 'sessions' ? sessionTimeRangeFromCreatedAt(entry.createdAt) : null;diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionsFilters.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionsFilters.tsxindex af45ae9c6..1d77b1f56 100644--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionsFilters.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionsFilters.tsx@@ -27,6 +27,8 @@ export type AgentSessionsFiltersProps = {onTimeRangeChange: (range: SessionTimeRange) => void;showAgentFilter?: boolean;showCustomTimeRange?: boolean;+ onReload?: () => void;+ isReloading?: boolean;};export function AgentSessionsFilters({@@ -36,6 +38,8 @@ export function AgentSessionsFilters({onTimeRangeChange,showAgentFilter = true,showCustomTimeRange = true,+ onReload,+ isReloading = false,}: AgentSessionsFiltersProps) {const server = useOptionalServer();const [agentLabelById, setAgentLabelById] = useState<Record<string, string>>({});@@ -107,6 +111,18 @@ export function AgentSessionsFilters({return (<div className="flex min-w-0 items-center gap-2">+ {onReload != null ? (+ <Button.Secondary+ type="button"+ size="icon"+ aria-label="Reload sessions"+ title="Reload sessions"+ disabled={isReloading}+ onClick={onReload}+ >+ <Icon name="refresh-cw" className={cn('size-3.5', isReloading && 'animate-spin')} />+ </Button.Secondary>+ ) : null}{showAgentFilter ? (<AgentSearchPickeraria-label="Filter sessions by agent"diff --git a/packages/trueforge-ui/src/atoms/agent-details/SessionsPage.tsx b/packages/trueforge-ui/src/atoms/agent-details/SessionsPage.tsxindex 816966c18..bee20682c 100644--- a/packages/trueforge-ui/src/atoms/agent-details/SessionsPage.tsx+++ b/packages/trueforge-ui/src/atoms/agent-details/SessionsPage.tsx@@ -52,9 +52,27 @@ export function SessionsPage() {return () => window.removeEventListener('popstate', syncFilters);}, []);- // Resolve relative presets only when the filter changes. Unrelated query- // updates (such as selecting a session) must not shift/refetch the list.- const resolved = useMemo(() => resolveSessionTimeRange(timeRange), [timeRange]);+ const [refreshEpoch, setRefreshEpoch] = useState(0);+ const [isReloading, setIsReloading] = useState(false);++ const handleReload = useCallback(() => {+ setIsReloading(true);+ setRefreshEpoch(epoch => epoch + 1);+ }, []);++ const handleLoadingChange = useCallback((loading: boolean) => {+ if (!loading) {+ setIsReloading(false);+ }+ }, []);++ // Resolve relative presets only when the filter changes or reload is requested.+ // Unrelated query updates (such as selecting a session) must not shift/refetch the list.+ const resolved = useMemo(+ () => resolveSessionTimeRange(timeRange),+ // eslint-disable-next-line react-hooks/exhaustive-deps+ [timeRange, refreshEpoch],+ );const timeRangeDurationMs = timeRange.endTs - timeRange.startTs;const showLoadRecentSessions =timeRange.timeWindowMs == null && timeRangeDurationMs > 0 && timeRangeDurationMs <= 2 * SESSION_TIME_BUFFER_MS;@@ -81,6 +99,8 @@ export function SessionsPage() {setTimeRange(nextRange);updateShareSearch({ timeRange: nextRange, sessionId: null, view: 'sessions' });}}+ onReload={sessionsServer == null ? undefined : handleReload}+ isReloading={isReloading}/>) : null}@@ -97,6 +117,8 @@ export function SessionsPage() {}><AgentSessions+ refreshKey={refreshEpoch}+ onLoadingChange={handleLoadingChange}agentId={agentFilter ?? undefined}startTimestamp={new Date(resolved.startTs).toISOString()}endTimestamp={new Date(resolved.endTs).toISOString()}diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.tsindex 752c98241..6c24f7c8d 100644--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts@@ -24,6 +24,10 @@ export type AgentSessionsProps = {onCloseDetail?: () => void;/** Restores the rolling recent-session window from a URL-loaded session. */onLoadRecentSessions?: () => void;+ /** Bump to force a reload of the sessions list and active detail. */+ refreshKey?: number;+ /** Called when the loading state changes (list or detail). */+ onLoadingChange?: (loading: boolean) => void;};export type AgentSessionListRowProps = {diff --git a/packages/trueforge-ui/src/icons/IconRegistry.tsx b/packages/trueforge-ui/src/icons/IconRegistry.tsxindex 5811ce81b..3371797e5 100644--- a/packages/trueforge-ui/src/icons/IconRegistry.tsx+++ b/packages/trueforge-ui/src/icons/IconRegistry.tsx@@ -55,6 +55,7 @@ import {Play,Plug,Plus,+ RefreshCw,RotateCw,Save,Search,@@ -140,6 +141,7 @@ const defaults: Record<string, IconEntry> = {'grip-vertical': GripVertical,'square-pen': SquarePen,'rotate-right': RotateCw,+ 'refresh-cw': RefreshCw,broom: Broom,ellipsis: Ellipsis,'ellipsis-vertical': EllipsisVertical,diff --git a/packages/trueforge-ui/test/atoms/AgentSessionsFilters.test.tsx b/packages/trueforge-ui/test/atoms/AgentSessionsFilters.test.tsxindex b40f672fa..9f72b722f 100644--- a/packages/trueforge-ui/test/atoms/AgentSessionsFilters.test.tsx+++ b/packages/trueforge-ui/test/atoms/AgentSessionsFilters.test.tsx@@ -88,4 +88,53 @@ describe('AgentSessionsFilters', () => {fireEvent.click(screen.getByRole('button', { name: 'Last 24 hours' }));expect(screen.queryByRole('button', { name: 'Custom Time Range' })).not.toBeInTheDocument();});++ it('renders and triggers the reload button when onReload is passed', () => {+ const onReload = vi.fn();+ render(+ <AgentSessionsFilters+ agentId={null}+ timeRange={{ startTs: 1, endTs: 2 }}+ onAgentChange={() => undefined}+ onTimeRangeChange={() => undefined}+ onReload={onReload}+ />,+ );++ const reloadButton = screen.getByRole('button', { name: 'Reload sessions' });+ expect(reloadButton).toBeInTheDocument();+ expect(reloadButton).not.toBeDisabled();+ fireEvent.click(reloadButton);+ expect(onReload).toHaveBeenCalledOnce();+ });++ it('disables the reload button and spins icon when isReloading is true', () => {+ render(+ <AgentSessionsFilters+ agentId={null}+ timeRange={{ startTs: 1, endTs: 2 }}+ onAgentChange={() => undefined}+ onTimeRangeChange={() => undefined}+ onReload={() => undefined}+ isReloading={true}+ />,+ );++ const reloadButton = screen.getByRole('button', { name: 'Reload sessions' });+ expect(reloadButton).toBeDisabled();+ expect(reloadButton.querySelector('.animate-spin')).toBeInTheDocument();+ });++ it('does not render reload button when onReload is omitted', () => {+ render(+ <AgentSessionsFilters+ agentId={null}+ timeRange={{ startTs: 1, endTs: 2 }}+ onAgentChange={() => undefined}+ onTimeRangeChange={() => undefined}+ />,+ );++ expect(screen.queryByRole('button', { name: 'Reload sessions' })).not.toBeInTheDocument();+ });});diff --git a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsxindex eb2b56ee0..66b4a2ca4 100644--- a/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx+++ b/packages/trueforge-ui/test/atoms/SessionsPage.test.tsx@@ -436,4 +436,59 @@ describe('SessionsPage', () => {});expect(deleteSession).not.toHaveBeenCalled();});++ it('renders the reload button before the agent filter and refetches latest data on click', async () => {+ let now = Date.parse('2026-01-01T12:00:00.000Z');+ const nowSpy = vi.spyOn(Date, 'now').mockImplementation(() => now);+ const listSessions = vi.fn(async (_req?: ListSessionsRequest) => ({ data: [namedRow] }));+ renderPage({ listSessions });++ const reloadButton = await screen.findByRole('button', { name: 'Reload sessions' });+ expect(reloadButton).toBeInTheDocument();+ expect(listSessions).toHaveBeenCalledTimes(1);++ // Advance time and click reload+ now = Date.parse('2026-01-01T13:00:00.000Z');+ fireEvent.click(reloadButton);++ await waitFor(() => {+ expect(listSessions).toHaveBeenCalledTimes(2);+ expect(listSessions).toHaveBeenLastCalledWith(+ expect.objectContaining({+ startTimestamp: new Date(now - DEFAULT_SESSION_TIME_WINDOW_MS).toISOString(),+ endTimestamp: new Date(now).toISOString(),+ }),+ );+ });++ nowSpy.mockRestore();+ });++ it('refetches both session list and selected session detail on reload', async () => {+ window.history.replaceState(null, '', '/?view=sessions&sessionId=sess-1');+ const listSessions = vi.fn(async () => ({ data: [namedRow] }));+ const listSessionEvents = vi.fn(async () => ({ data: [] as SessionEventItem[] }));+ const getSession = vi.fn(async (): Promise<Session> => ({+ id: 'sess-1',+ title: 'Named session',+ isMutable: false,+ createdAt: namedRow.createdAt,+ updatedAt: namedRow.updatedAt,+ }));++ renderPage({ listSessions, listSessionEvents, getSession });++ const reloadButton = await screen.findByRole('button', { name: 'Reload sessions' });+ await screen.findByRole('heading', { name: 'Named session' });++ expect(listSessions).toHaveBeenCalledTimes(1);+ expect(getSession).toHaveBeenCalledTimes(1);++ fireEvent.click(reloadButton);++ await waitFor(() => {+ expect(listSessions).toHaveBeenCalledTimes(2);+ expect(getSession).toHaveBeenCalledTimes(2);+ });+ });});