Skip to content

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.md
new file mode 100644
index 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.tsx
index 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.tsx
index 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 ? (
<AgentSearchPicker
aria-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.tsx
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
index 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);
+ });
+ });
});