Skip to content

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

Enhance TrueForge UI with schedules and sessions support (#610)

Govinda Vashishthad5b479df8c8e
diff --git a/.changeset/optional-server-lego-gates.md b/.changeset/optional-server-lego-gates.md
new file mode 100644
index 000000000..52d278a7f
--- /dev/null
+++ b/.changeset/optional-server-lego-gates.md
@@ -0,0 +1,5 @@
+---
+'@truefoundry/trueforge-ui': patch
+---
+
+Clamp optional sessions/schedules chrome and unregister `/sessions`, `/schedules`, and `/library/:agentId` when those server ports are omitted, matching the Settings Lego gate.
diff --git a/packages/trueforge-ui/README.md b/packages/trueforge-ui/README.md
index c23572e81..36a9651ef 100644
--- a/packages/trueforge-ui/README.md
+++ b/packages/trueforge-ui/README.md
@@ -550,6 +550,7 @@ type AgentUIServer = AgentChatServer &
catalog?: CatalogServer;
sessions?: AgentSessionsServer;
metrics?: AgentMetricsServer;
+ schedules?: ScheduleServer;
};
```
@@ -557,8 +558,14 @@ type AgentUIServer = AgentChatServer &
| -------------------- | ------------------------------------------------------------------- |
| `AgentChatServer` | Sessions, turns, streaming, draft `AgentSpec` sync |
| `AgentBuilderServer` | `getModels` / `getSkills` / `getMcp` / `searchAgents` / `saveAgent` |
+| `catalog` | Settings CRUD (models / connectors / optional skills & sandbox) |
+| `sessions` | Agent details + sessions browser (`/sessions`, `/library/:agentId`) |
+| `schedules` | Schedules page (`/schedules`) |
| `AgentMetricsServer` | Agent meter aggregates, chart definitions, and chart data |
+Omit an optional port to hide its chrome and unregister its routes (same gate as the
+Settings button for `catalog`).
+
**Zero-config TrueFoundry** — see [Getting started](#getting-started). The SDK calls `createTrueFoundryAgentUIServer` for you.
**Zero-config TrueForge (Harness)** — see [Getting started](#getting-started).
diff --git a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
index 981134e8d..6608a638a 100644
--- a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
+++ b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
@@ -4,6 +4,7 @@ import { useCallback, useEffect, useState } from 'react';
import { useSessionShareSearch } from '../hooks/useSessionShareSearch.js';
import { Icon } from '../icons/Icon.js';
+import { isSchedulesChromeEnabled, isSessionsChromeEnabled } from '../server/serverChrome.js';
import { useOptionalAgentSessionsServer, useOptionalScheduleServer } from '../server/ServerContext.js';
import { libraryAgentId, useShellMode } from '../server/ShellModeContext.js';
import type { AgentLibraryEntry, AgentSpec, Schedule } from '../server/types.js';
@@ -277,8 +278,9 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {
const canMutate = shell.isComposerEnabled === true;
const agentsListEpoch = shell.agentsListEpoch;
- const showSchedulesColumn = scheduleServer != null;
- const canManageSchedules = scheduleServer != null;
+ const showSchedulesColumn = isSchedulesChromeEnabled({ schedules: scheduleServer });
+ const canManageSchedules = showSchedulesColumn;
+ const canOpenAgentDetails = isSessionsChromeEnabled({ sessions: sessionsServer });
useEffect(() => {
if (!open) setQuery('');
@@ -433,7 +435,7 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {
onManageSchedules: () => openSchedulesForAgent({ agentId: id }),
}
: {})}
- {...(sessionsServer != null && agentId != null
+ {...(canOpenAgentDetails && agentId != null
? {
onOpen: () => {
updateShareSearch({
diff --git a/packages/trueforge-ui/src/atoms/SchedulesButton.tsx b/packages/trueforge-ui/src/atoms/SchedulesButton.tsx
index 839c10eef..271a5330e 100644
--- a/packages/trueforge-ui/src/atoms/SchedulesButton.tsx
+++ b/packages/trueforge-ui/src/atoms/SchedulesButton.tsx
@@ -3,6 +3,7 @@
import { Icon } from '../icons/Icon.js';
import { useOptionalScheduleServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
+import { isSchedulesChromeEnabled } from '../server/serverChrome.js';
import { auiButtonClass } from './lib/buttonClasses.js';
import { cn } from './lib/cn.js';
@@ -15,7 +16,7 @@ export function SchedulesButton({ className, compact = false }: SchedulesButtonP
const shell = useOptionalShellMode();
const scheduleServer = useOptionalScheduleServer();
- const enabled = scheduleServer != null && shell != null;
+ const enabled = isSchedulesChromeEnabled({ schedules: scheduleServer }) && shell != null;
const open = shell?.schedulesOpen === true;
if (!enabled) return null;
diff --git a/packages/trueforge-ui/src/atoms/SessionsBrowserButton.tsx b/packages/trueforge-ui/src/atoms/SessionsBrowserButton.tsx
index 9945c26b3..4ae61ccb0 100644
--- a/packages/trueforge-ui/src/atoms/SessionsBrowserButton.tsx
+++ b/packages/trueforge-ui/src/atoms/SessionsBrowserButton.tsx
@@ -4,6 +4,7 @@ import { useSessionShareSearch } from '../hooks/useSessionShareSearch.js';
import { Icon } from '../icons/Icon.js';
import { useOptionalAgentSessionsServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
+import { isSessionsChromeEnabled } from '../server/serverChrome.js';
import { defaultSessionTimeRange, readSessionShareSearch } from '../utils/sessionShareUrl.js';
import { auiButtonClass } from './lib/buttonClasses.js';
import { cn } from './lib/cn.js';
@@ -18,8 +19,9 @@ export function SessionsBrowserButton({ className, compact = false }: SessionsBr
const shell = useOptionalShellMode();
const { updateShareSearch } = useSessionShareSearch();
const sessionsOpen = shell?.sessionsOpen === true;
+ const enabled = isSessionsChromeEnabled({ sessions: sessionsServer }) && shell != null;
- if (sessionsServer == null || shell == null) return null;
+ if (!enabled) return null;
return (
<div className={cn('relative min-w-0 w-full', className)}>
diff --git a/packages/trueforge-ui/src/atoms/ShellActions.tsx b/packages/trueforge-ui/src/atoms/ShellActions.tsx
index 6df1992c4..de971ffb8 100644
--- a/packages/trueforge-ui/src/atoms/ShellActions.tsx
+++ b/packages/trueforge-ui/src/atoms/ShellActions.tsx
@@ -3,7 +3,7 @@
import { Icon } from '../icons/Icon.js';
import { useOptionalCatalogServer, useServerCapabilities } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
-import { isSettingsChromeEnabled } from '../server/settingsChrome.js';
+import { isSettingsChromeEnabled } from '../server/serverChrome.js';
import { useSlot } from '../theme/SlotsProvider.js';
import { useTheme } from '../theme/ThemeProvider.js';
import { auiButtonClass } from './lib/buttonClasses.js';
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
index 2ab93c072..bb05057a1 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
@@ -1,6 +1,7 @@
'use client';
import { Icon } from '../../icons/Icon.js';
+import { isSchedulesChromeEnabled } from '../../server/serverChrome.js';
import { useOptionalScheduleServer, useOptionalServer } from '../../server/ServerContext.js';
import { useShellMode } from '../../server/ShellModeContext.js';
import { writeOpenSchedulesForAgentSearch } from '../../utils/scheduleShareUrl.js';
@@ -15,7 +16,7 @@ export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHead
const scheduleServer = useOptionalScheduleServer();
const builder = useOptionalServer();
const canMutate = shell.isComposerEnabled && detail != null && builder != null;
- const canManageSchedules = scheduleServer != null && detail != null;
+ const canManageSchedules = isSchedulesChromeEnabled({ schedules: scheduleServer }) && detail != null;
const handleTry = () => {
if (detail == null) return;
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsPage.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsPage.tsx
index 9d4ab195f..f20db188d 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsPage.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsPage.tsx
@@ -4,6 +4,7 @@ import { Suspense, useCallback, useEffect, useState } from 'react';
import { useSessionShareSearch } from '../../hooks/useSessionShareSearch.js';
import { useOptionalAgentMetricsServer, useOptionalAgentSessionsServer } from '../../server/ServerContext.js';
import { useShellMode } from '../../server/ShellModeContext.js';
+import { isMetricsChromeEnabled } from '../../server/serverChrome.js';
import type { AgentDetail, CodeSnippet } from '../../server/types.js';
import { useSlot } from '../../theme/SlotsProvider.js';
import { libraryAgentTabFromSearch } from '../../utils/sessionShareUrl.js';
@@ -17,7 +18,8 @@ export function AgentDetailsPage({ agentId }: AgentDetailsPageProps) {
const share = useSessionShareSearch();
const { updateShareSearch } = share;
const requestedTab = libraryAgentTabFromSearch(share, agentId);
- const activeTab = requestedTab === 'metrics' && metricsServer == null ? 'overview' : requestedTab;
+ const showMetrics = isMetricsChromeEnabled({ metrics: metricsServer });
+ const activeTab = requestedTab === 'metrics' && !showMetrics ? 'overview' : requestedTab;
const AgentDetailsHeader = useSlot('AgentDetailsHeader');
const AgentDetailsTabs = useSlot('AgentDetailsTabs');
const AgentDetailsUnavailable = useSlot('AgentDetailsUnavailable');
@@ -133,7 +135,7 @@ export function AgentDetailsPage({ agentId }: AgentDetailsPageProps) {
{sessionsServer != null && !detailFailed ? (
<AgentDetailsTabs
activeTab={activeTab}
- showMetrics={metricsServer != null}
+ showMetrics={showMetrics}
onTabChange={tab =>
updateShareSearch({
agentId,
diff --git a/packages/trueforge-ui/src/atoms/lib/useInfiniteScrollSentinel.ts b/packages/trueforge-ui/src/atoms/lib/useInfiniteScrollSentinel.ts
index f0d9d7399..1bddb202a 100644
--- a/packages/trueforge-ui/src/atoms/lib/useInfiniteScrollSentinel.ts
+++ b/packages/trueforge-ui/src/atoms/lib/useInfiniteScrollSentinel.ts
@@ -2,7 +2,8 @@
import { useCallback, useEffect, useRef, useState } from 'react';
-const DEFAULT_ROOT_MARGIN = '3rem';
+// IntersectionObserver only accepts px/% — not rem (3rem @ 16px).
+const DEFAULT_ROOT_MARGIN = '48px';
export type UseInfiniteScrollSentinelOptions = {
enabled: boolean;
diff --git a/packages/trueforge-ui/src/routing/LibrarySessionShareBoot.tsx b/packages/trueforge-ui/src/routing/LibrarySessionShareBoot.tsx
index dd07c9901..0f2e9ce54 100644
--- a/packages/trueforge-ui/src/routing/LibrarySessionShareBoot.tsx
+++ b/packages/trueforge-ui/src/routing/LibrarySessionShareBoot.tsx
@@ -2,14 +2,19 @@
import { useEffect } from 'react';
+import { useOptionalAgentSessionsServer } from '../server/ServerContext.js';
import { useShellMode } from '../server/ShellModeContext.js';
+import { isSessionsChromeEnabled } from '../server/serverChrome.js';
import { readSessionShareSearch } from '../utils/sessionShareUrl.js';
/** Open the sessions browser or a library agent from the share query — with or without `withRouter`. */
export function LibrarySessionShareBoot() {
const { openLibraryAgent, setSessionsOpen } = useShellMode();
+ const sessions = useOptionalAgentSessionsServer();
+ const sessionsEnabled = isSessionsChromeEnabled({ sessions });
useEffect(() => {
+ if (!sessionsEnabled) return;
const share = readSessionShareSearch(window.location.search);
if (share.view === 'sessions') {
setSessionsOpen(true);
@@ -17,7 +22,7 @@ export function LibrarySessionShareBoot() {
}
if (share.agentId == null) return;
openLibraryAgent(share.agentId);
- }, [openLibraryAgent, setSessionsOpen]);
+ }, [openLibraryAgent, sessionsEnabled, setSessionsOpen]);
return null;
}
diff --git a/packages/trueforge-ui/src/routing/ShellRouteSync.tsx b/packages/trueforge-ui/src/routing/ShellRouteSync.tsx
index 512019367..4ec0607c4 100644
--- a/packages/trueforge-ui/src/routing/ShellRouteSync.tsx
+++ b/packages/trueforge-ui/src/routing/ShellRouteSync.tsx
@@ -4,9 +4,15 @@ import { useCallback, useEffect, useMemo, useRef } from 'react';
import { useLocation, useNavigate } from 'react-router-dom';
import { sessionIsCreateAgent } from '../atoms/lib/sessionCreateAgent.js';
-import { useOptionalCatalogServer, useOptionalServer, useServerCapabilities } from '../server/ServerContext.js';
+import {
+ useOptionalAgentSessionsServer,
+ useOptionalCatalogServer,
+ useOptionalScheduleServer,
+ useOptionalServer,
+ useServerCapabilities,
+} from '../server/ServerContext.js';
import { useShellMode } from '../server/ShellModeContext.js';
-import { isSettingsChromeEnabled } from '../server/settingsChrome.js';
+import { toEffectiveRoutes } from '../server/serverChrome.js';
import { deriveChatPlace, derivePlace } from './derivePlace.js';
import { buildPath, matchLocation, placesEqual, sanitizeSearchForPlace } from './paths.js';
import type { ResolvedRoutes, RoutePlace, ShellSnapshot } from './types.js';
@@ -27,16 +33,25 @@ export function ShellRouteSync({
const shell = useShellMode();
const server = useOptionalServer();
const catalog = useOptionalCatalogServer();
+ const sessions = useOptionalAgentSessionsServer();
+ const schedules = useOptionalScheduleServer();
const capabilities = useServerCapabilities();
const navigate = useNavigate();
const location = useLocation();
- // Same gate as the Settings sidebar button: no catalog / settings capability
- // off → `/settings` is unregistered (match + build return null).
- const settingsChromeEnabled = isSettingsChromeEnabled({ catalog, capabilities });
+ // Same gates as sidebar chrome: missing optional ports unregister their paths.
const effectiveRoutes = useMemo(
- () => (settingsChromeEnabled ? routes : { ...routes, settings: null }),
- [routes, settingsChromeEnabled],
+ () => toEffectiveRoutes({ routes, catalog, capabilities, sessions, schedules }),
+ [routes, catalog, capabilities, sessions, schedules],
);
+ const settingsChromeEnabled = effectiveRoutes.settings != null;
+ // Gate identity only — avoid re-syncing when capabilities object identity churns
+ // without changing which paths are registered (would clobber window share query).
+ const routeGatesKey = [
+ effectiveRoutes.settings,
+ effectiveRoutes.sessionsBrowser,
+ effectiveRoutes.libraryAgent,
+ effectiveRoutes.schedules,
+ ].join('\0');
const snapshot: ShellSnapshot = {
settingsOpen: shell.settingsOpen,
@@ -216,7 +231,7 @@ export function ShellRouteSync({
navigate({ pathname: target, search: targetSearch, hash: location.hash }, { replace });
// location.pathname intentionally excluded: only react to shell-derived place changes.
// eslint-disable-next-line react-hooks/exhaustive-deps
- }, [placeKey, settingsChromeEnabled]);
+ }, [placeKey, routeGatesKey]);
// URL -> shell: apply on genuine location changes (Back/Forward, manual edits).
useEffect(() => {
diff --git a/packages/trueforge-ui/src/server/ShellModeContext.tsx b/packages/trueforge-ui/src/server/ShellModeContext.tsx
index 6a777ef4b..62c292ff7 100644
--- a/packages/trueforge-ui/src/server/ShellModeContext.tsx
+++ b/packages/trueforge-ui/src/server/ShellModeContext.tsx
@@ -10,13 +10,14 @@ import {
writeDraftSpecPreferences,
type DraftPreferenceKind,
} from './draftSpecPreferences.js';
+import { isSchedulesChromeEnabled, isSessionsChromeEnabled, isSettingsChromeEnabled } from './serverChrome.js';
import {
+ useOptionalAgentSessionsServer,
useOptionalCatalogServer,
useOptionalRefreshServerCapabilities,
useOptionalScheduleServer,
useServerCapabilities,
} from './ServerContext.js';
-import { isSettingsChromeEnabled } from './settingsChrome.js';
import type { AgentLibraryEntry, AgentSpec } from './types.js';
/** Host-facing shell configuration for agent / library / composer chrome. */
@@ -209,6 +210,7 @@ export function ShellModeProvider({
const capabilities = useServerCapabilities();
const catalog = useOptionalCatalogServer();
const refreshCapabilities = useOptionalRefreshServerCapabilities();
+ const sessionsServer = useOptionalAgentSessionsServer();
const scheduleServer = useOptionalScheduleServer();
const chatSeedRef = useRef(
readDraftSpecPreferences('chat') ?? selectDraftSpecPreferences(mutableSeedFromConfig(agentConfig), 'chat'),
@@ -237,22 +239,26 @@ export function ShellModeProvider({
const [pendingSessionId, setPendingSessionId] = useState<string | undefined>(undefined);
const settingsEnabled = isSettingsChromeEnabled({ catalog, capabilities });
const settingsOpen = settingsEnabled && settingsOpenState;
- const schedulesEnabled = scheduleServer != null;
+ const sessionsEnabled = isSessionsChromeEnabled({ sessions: sessionsServer });
+ const schedulesEnabled = isSchedulesChromeEnabled({ schedules: scheduleServer });
const schedulesOpen = schedulesEnabled && schedulesOpenState;
const libraryOpen = isLibraryEnabled && libraryOpenState;
- const sessionsOpen = sessionsOpenState;
- const setSessionsOpen = useCallback((open: boolean) => {
- if (open) {
- setSettingsOpenState(false);
- setAgentConfigOpenState(false);
- setLibraryOpenState(false);
- setLibraryAgentId(null);
- setSchedulesOpenState(false);
- } else {
- replaceSessionShareSearch({ view: null });
- }
- setSessionsOpenState(open);
- }, []);
+ const sessionsOpen = sessionsEnabled && sessionsOpenState;
+ const setSessionsOpen = useCallback(
+ (open: boolean) => {
+ if (open) {
+ setSettingsOpenState(false);
+ setAgentConfigOpenState(false);
+ setLibraryOpenState(false);
+ setLibraryAgentId(null);
+ setSchedulesOpenState(false);
+ } else {
+ replaceSessionShareSearch({ view: null });
+ }
+ setSessionsOpenState(sessionsEnabled && open);
+ },
+ [sessionsEnabled],
+ );
const setLibraryOpen = useCallback(
(open: boolean) => {
if (!isLibraryEnabled) return;
@@ -269,7 +275,7 @@ export function ShellModeProvider({
);
const openLibraryAgent = useCallback(
(agentId: string) => {
- if (!isLibraryEnabled) return;
+ if (!isLibraryEnabled || !sessionsEnabled) return;
setSettingsOpenState(false);
setAgentConfigOpenState(false);
setSessionsOpen(false);
@@ -277,7 +283,7 @@ export function ShellModeProvider({
setLibraryOpenState(true);
setLibraryAgentId(agentId);
},
- [isLibraryEnabled, setSessionsOpen],
+ [isLibraryEnabled, sessionsEnabled, setSessionsOpen],
);
const closeLibraryAgent = useCallback(() => {
setLibraryAgentId(null);
@@ -331,6 +337,13 @@ export function ShellModeProvider({
}
}, [settingsEnabled]);
+ useEffect(() => {
+ if (!sessionsEnabled) {
+ setSessionsOpenState(false);
+ setLibraryAgentId(null);
+ }
+ }, [sessionsEnabled]);
+
useEffect(() => {
if (!schedulesEnabled) {
setSchedulesOpenState(false);
diff --git a/packages/trueforge-ui/src/server/serverChrome.ts b/packages/trueforge-ui/src/server/serverChrome.ts
new file mode 100644
index 000000000..86b91ce92
--- /dev/null
+++ b/packages/trueforge-ui/src/server/serverChrome.ts
@@ -0,0 +1,58 @@
+import type { ResolvedRoutes } from '../routing/types.js';
+import type { AgentMetricsServer, AgentSessionsServer, CatalogServer, ScheduleServer } from './types.js';
+
+/**
+ * Whether Settings chrome is available: sidebar button and `/settings` route.
+ * Matches the gate in {@link ShellActions}.
+ */
+export function isSettingsChromeEnabled({
+ catalog,
+ capabilities,
+}: {
+ catalog: CatalogServer | null | undefined;
+ capabilities: { settings?: { enabled?: boolean } } | null | undefined;
+}): boolean {
+ return catalog != null && capabilities?.settings?.enabled !== false;
+}
+
+/** Sessions browser + agent-detail surfaces (Overview / sessions / code). */
+export function isSessionsChromeEnabled({ sessions }: { sessions: AgentSessionsServer | null | undefined }): boolean {
+ return sessions != null;
+}
+
+/** Schedules page + library schedules column. */
+export function isSchedulesChromeEnabled({ schedules }: { schedules: ScheduleServer | null | undefined }): boolean {
+ return schedules != null;
+}
+
+/** Agent-details Metrics tab (no top-level path). */
+export function isMetricsChromeEnabled({ metrics }: { metrics: AgentMetricsServer | null | undefined }): boolean {
+ return metrics != null;
+}
+
+/**
+ * Unregister path-backed places whose optional server port is absent.
+ * Chrome gates and route gates must stay in lockstep.
+ */
+export function toEffectiveRoutes({
+ routes,
+ catalog,
+ capabilities,
+ sessions,
+ schedules,
+}: {
+ routes: ResolvedRoutes;
+ catalog: CatalogServer | null | undefined;
+ capabilities: { settings?: { enabled?: boolean } } | null | undefined;
+ sessions: AgentSessionsServer | null | undefined;
+ schedules: ScheduleServer | null | undefined;
+}): ResolvedRoutes {
+ const sessionsEnabled = isSessionsChromeEnabled({ sessions });
+ return {
+ ...routes,
+ settings: isSettingsChromeEnabled({ catalog, capabilities }) ? routes.settings : null,
+ sessionsBrowser: sessionsEnabled ? routes.sessionsBrowser : null,
+ libraryAgent: sessionsEnabled ? routes.libraryAgent : null,
+ schedules: isSchedulesChromeEnabled({ schedules }) ? routes.schedules : null,
+ };
+}
diff --git a/packages/trueforge-ui/src/server/settingsChrome.ts b/packages/trueforge-ui/src/server/settingsChrome.ts
index 7781184aa..2155c561d 100644
--- a/packages/trueforge-ui/src/server/settingsChrome.ts
+++ b/packages/trueforge-ui/src/server/settingsChrome.ts
@@ -1,15 +1,11 @@
-import type { CatalogServer } from './types.js';
-
/**
- * Whether Settings chrome is available: sidebar button and `/settings` route.
- * Matches the gate in {@link ShellActions}.
+ * @deprecated Import chrome gates from `./serverChrome.js`.
+ * Kept so existing relative imports keep working.
*/
-export function isSettingsChromeEnabled({
- catalog,
- capabilities,
-}: {
- catalog: CatalogServer | null | undefined;
- capabilities: { settings?: { enabled?: boolean } } | null | undefined;
-}): boolean {
- return catalog != null && capabilities?.settings?.enabled !== false;
-}
+export {
+ isMetricsChromeEnabled,
+ isSchedulesChromeEnabled,
+ isSessionsChromeEnabled,
+ isSettingsChromeEnabled,
+ toEffectiveRoutes,
+} from './serverChrome.js';
diff --git a/packages/trueforge-ui/test/atoms/lib/useInfiniteScrollSentinel.test.tsx b/packages/trueforge-ui/test/atoms/lib/useInfiniteScrollSentinel.test.tsx
index 49885f07a..ad9e8e35b 100644
--- a/packages/trueforge-ui/test/atoms/lib/useInfiniteScrollSentinel.test.tsx
+++ b/packages/trueforge-ui/test/atoms/lib/useInfiniteScrollSentinel.test.tsx
@@ -21,9 +21,12 @@ const observerStub: IntersectionObserver = {
thresholds: [],
};
+let lastRootMargin: string | undefined;
+
class FakeIntersectionObserver implements IntersectionObserver {
- constructor(callback: ObserverCallback) {
+ constructor(callback: ObserverCallback, options?: IntersectionObserverInit) {
observerCallback = callback;
+ lastRootMargin = options?.rootMargin;
}
observe = observe;
unobserve = vi.fn();
@@ -96,6 +99,7 @@ function ControlledProbe({ onLoadMore }: { onLoadMore: () => void }): ReactEleme
describe('useInfiniteScrollSentinel', () => {
beforeEach(() => {
observerCallback = null;
+ lastRootMargin = undefined;
observe.mockClear();
disconnect.mockClear();
vi.stubGlobal('IntersectionObserver', FakeIntersectionObserver);
@@ -105,6 +109,12 @@ describe('useInfiniteScrollSentinel', () => {
vi.unstubAllGlobals();
});
+ it('passes a px/percent rootMargin (IntersectionObserver rejects rem)', async () => {
+ render(<Probe hasMore loading={false} onLoadMore={() => undefined} />);
+ await waitFor(() => expect(observe).toHaveBeenCalled());
+ expect(lastRootMargin).toMatch(/^-?\d+(\.\d+)?(px|%)(\s+-?\d+(\.\d+)?(px|%)){0,3}$/);
+ });
+
it('re-observes after loading settles so a still-visible sentinel can load again', async () => {
const onLoadMore = vi.fn();
render(<ControlledProbe onLoadMore={onLoadMore} />);
diff --git a/packages/trueforge-ui/test/routing/LibrarySessionShareBoot.test.tsx b/packages/trueforge-ui/test/routing/LibrarySessionShareBoot.test.tsx
index ae1e78c60..2e563881d 100644
--- a/packages/trueforge-ui/test/routing/LibrarySessionShareBoot.test.tsx
+++ b/packages/trueforge-ui/test/routing/LibrarySessionShareBoot.test.tsx
@@ -3,7 +3,9 @@ import { render } from '@testing-library/react';
import { afterEach, describe, expect, it } from 'vitest';
import { LibrarySessionShareBoot } from '@/routing/LibrarySessionShareBoot.js';
+import { ServerProvider } from '@/server/ServerContext.js';
import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
+import { createMockAgentSessionsServer, createMockAgentUIServer } from '../server/mockServer.js';
afterEach(() => {
window.history.replaceState(null, '', '/');
@@ -19,38 +21,49 @@ function Probe() {
);
}
-describe('LibrarySessionShareBoot', () => {
- it('opens the library agent from ?agentId= without a router', () => {
- window.history.replaceState(null, '', '/?agentId=agent-1&sessionId=sess-1');
- const { getByText } = render(
+function renderBoot({ includeSessions = true }: { includeSessions?: boolean } = {}) {
+ const server = createMockAgentUIServer({
+ ...(includeSessions ? { sessions: createMockAgentSessionsServer() } : {}),
+ });
+ return render(
+ <ServerProvider server={server}>
<ShellModeProvider>
<LibrarySessionShareBoot />
<Probe />
- </ShellModeProvider>,
- );
+ </ShellModeProvider>
+ </ServerProvider>,
+ );
+}
+
+describe('LibrarySessionShareBoot', () => {
+ it('opens the library agent from ?agentId= without a router', () => {
+ window.history.replaceState(null, '', '/?agentId=agent-1&sessionId=sess-1');
+ const { getByText } = renderBoot();
expect(getByText('agent-1')).toBeInTheDocument();
});
it('leaves the library closed when the share query is absent', () => {
- const { getByText } = render(
- <ShellModeProvider>
- <LibrarySessionShareBoot />
- <Probe />
- </ShellModeProvider>,
- );
+ const { getByText } = renderBoot();
expect(getByText('none')).toBeInTheDocument();
expect(getByText('sessions-closed')).toBeInTheDocument();
});
it('opens the sessions browser from ?view=sessions without a router', () => {
window.history.replaceState(null, '', '/?view=sessions&agentId=agent-1');
- const { getByText } = render(
- <ShellModeProvider>
- <LibrarySessionShareBoot />
- <Probe />
- </ShellModeProvider>,
- );
+ const { getByText } = renderBoot();
expect(getByText('none')).toBeInTheDocument();
expect(getByText('sessions-open')).toBeInTheDocument();
});
+
+ it('ignores ?view=sessions when sessions port is missing', () => {
+ window.history.replaceState(null, '', '/?view=sessions');
+ const { getByText } = renderBoot({ includeSessions: false });
+ expect(getByText('sessions-closed')).toBeInTheDocument();
+ });
+
+ it('ignores ?agentId= when sessions port is missing', () => {
+ window.history.replaceState(null, '', '/?agentId=agent-1');
+ const { getByText } = renderBoot({ includeSessions: false });
+ expect(getByText('none')).toBeInTheDocument();
+ });
});
diff --git a/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx b/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx
index ff1213bfe..ab2786b3f 100644
--- a/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx
+++ b/packages/trueforge-ui/test/routing/ShellRouteSync.test.tsx
@@ -8,7 +8,12 @@ import { resolveRoutesConfig } from '@/routing/paths.js';
import { ShellRouteSync } from '@/routing/ShellRouteSync.js';
import { ServerProvider } from '@/server/ServerContext.js';
import { ShellModeProvider, useShellMode, type AgentConfig } from '@/server/ShellModeContext.js';
-import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';
+import {
+ createMockAgentSessionsServer,
+ createMockAgentUIServer,
+ createMockCatalog,
+ createMockScheduleServer,
+} from '../server/mockServer.js';
const routes = resolveRoutesConfig();
@@ -39,13 +44,19 @@ function SettingsCatalogProvider({
children,
settingsEnabled = true,
includeCatalog = true,
+ includeSessions = true,
+ includeSchedules = false,
}: {
children: ReactNode;
settingsEnabled?: boolean;
includeCatalog?: boolean;
+ includeSessions?: boolean;
+ includeSchedules?: boolean;
}) {
const server = createMockAgentUIServer({
...(includeCatalog ? { catalog: createMockCatalog() } : {}),
+ ...(includeSessions ? { sessions: createMockAgentSessionsServer() } : {}),
+ ...(includeSchedules ? { schedules: createMockScheduleServer() } : {}),
getCapabilities: async () => ({
data: {
sandbox: { enabled: true },
@@ -70,17 +81,26 @@ function Harness({
initialSettingsOpen = false,
settingsEnabled = true,
includeCatalog = true,
+ includeSessions = true,
+ includeSchedules = false,
}: {
agentConfig?: AgentConfig;
initialRemoteId?: string;
initialSettingsOpen?: boolean;
settingsEnabled?: boolean;
includeCatalog?: boolean;
+ includeSessions?: boolean;
+ includeSchedules?: boolean;
}) {
const [remoteId, setId] = useState<string | undefined>(initialRemoteId);
setRemoteId = setId;
return (
- <SettingsCatalogProvider settingsEnabled={settingsEnabled} includeCatalog={includeCatalog}>
+ <SettingsCatalogProvider
+ settingsEnabled={settingsEnabled}
+ includeCatalog={includeCatalog}
+ includeSessions={includeSessions}
+ includeSchedules={includeSchedules}
+ >
<ShellModeProvider agentConfig={agentConfig} initialSettingsOpen={initialSettingsOpen}>
<CaptureShell />
<CaptureLocation />
@@ -96,6 +116,8 @@ function renderSync(opts: {
initialSettingsOpen?: boolean;
settingsEnabled?: boolean;
includeCatalog?: boolean;
+ includeSessions?: boolean;
+ includeSchedules?: boolean;
}) {
return render(
<MemoryRouter initialEntries={opts.initialEntries ?? ['/']}>
@@ -104,6 +126,8 @@ function renderSync(opts: {
initialSettingsOpen={opts.initialSettingsOpen}
settingsEnabled={opts.settingsEnabled}
includeCatalog={opts.includeCatalog}
+ includeSessions={opts.includeSessions}
+ includeSchedules={opts.includeSchedules}
/>
</MemoryRouter>,
);
@@ -239,6 +263,68 @@ describe('ShellRouteSync', () => {
expect(pathname).toBe('/library/agent-7');
});
+ it('unregisters /library/:agentId when sessions port is missing', async () => {
+ renderSync({
+ initialEntries: ['/library/agent-7'],
+ agentConfig: { mode: 'AgentLibraryWithComposer' },
+ includeSessions: false,
+ });
+ await waitFor(() => {
+ expect(shell.libraryAgentId).toBeNull();
+ expect(pathname).toBe('/');
+ });
+ act(() => shell.openLibraryAgent('agent-7'));
+ expect(shell.libraryAgentId).toBeNull();
+ });
+
+ it('unregisters sessions browser when sessions port is missing', async () => {
+ renderSync({
+ initialEntries: ['/sessions'],
+ agentConfig: { mode: 'AgentLibraryWithComposer' },
+ includeSessions: false,
+ });
+ await waitFor(() => {
+ expect(shell.sessionsOpen).toBe(false);
+ expect(pathname).toBe('/');
+ });
+ act(() => shell.setSessionsOpen(true));
+ expect(shell.sessionsOpen).toBe(false);
+ expect(pathname).toBe('/');
+ });
+
+ it('mirrors sessions browser open through history when sessions port is present', () => {
+ renderSync({ initialEntries: ['/'], agentConfig: { mode: 'AgentLibraryWithComposer' } });
+ act(() => shell.setSessionsOpen(true));
+ expect(shell.sessionsOpen).toBe(true);
+ expect(pathname).toBe('/sessions');
+ });
+
+ it('unregisters /schedules when schedules port is missing', async () => {
+ renderSync({
+ initialEntries: ['/schedules'],
+ agentConfig: { mode: 'AgentLibraryWithComposer' },
+ includeSchedules: false,
+ });
+ await waitFor(() => {
+ expect(shell.schedulesOpen).toBe(false);
+ expect(pathname).toBe('/');
+ });
+ act(() => shell.setSchedulesOpen(true));
+ expect(shell.schedulesOpen).toBe(false);
+ expect(pathname).toBe('/');
+ });
+
+ it('mirrors schedules open through history when schedules port is present', () => {
+ renderSync({
+ initialEntries: ['/'],
+ agentConfig: { mode: 'AgentLibraryWithComposer' },
+ includeSchedules: true,
+ });
+ act(() => shell.setSchedulesOpen(true));
+ expect(shell.schedulesOpen).toBe(true);
+ expect(pathname).toBe('/schedules');
+ });
+
it('returns to the chat place when a /library deep link is closed', () => {
renderSync({ initialEntries: ['/library'], agentConfig: { mode: 'AgentLibraryWithComposer' } });
expect(shell.libraryOpen).toBe(true);
diff --git a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx b/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
index 48048a732..3f3bb028d 100644
--- a/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
+++ b/packages/trueforge-ui/test/server/ShellModeContext.test.tsx
@@ -12,10 +12,13 @@ import {
import { ServerProvider, useServerCapabilities } from '@/server/ServerContext.js';
import { ShellModeProvider, useOptionalShellMode, useShellMode, type AgentConfig } from '@/server/ShellModeContext.js';
import type { AgentUIServer } from '@/server/types.js';
-import { createMockAgentUIServer, createMockCatalog } from './mockServer.js';
+import { createMockAgentSessionsServer, createMockAgentUIServer, createMockCatalog } from './mockServer.js';
function wrap(agentConfig?: AgentConfig, initialSettingsOpen?: boolean) {
- const server = createMockAgentUIServer({ catalog: createMockCatalog() });
+ const server = createMockAgentUIServer({
+ catalog: createMockCatalog(),
+ sessions: createMockAgentSessionsServer(),
+ });
return function Wrapper({ children }: { children: ReactNode }) {
return (
<ServerProvider server={server}>
@@ -40,6 +43,17 @@ function wrapWithoutCatalog(agentConfig?: AgentConfig, initialSettingsOpen?: boo
};
}
+function wrapWithoutSessions(agentConfig?: AgentConfig) {
+ const server = createMockAgentUIServer({ catalog: createMockCatalog() });
+ return function Wrapper({ children }: { children: ReactNode }) {
+ return (
+ <ServerProvider server={server}>
+ <ShellModeProvider agentConfig={agentConfig}>{children}</ShellModeProvider>
+ </ServerProvider>
+ );
+ };
+}
+
function wrapWithServer(server: AgentUIServer, agentConfig?: AgentConfig) {
return function Wrapper({ children }: { children: ReactNode }) {
return (
@@ -173,6 +187,17 @@ describe('ShellModeProvider', () => {
expect(result.current.libraryAgentId).toBeNull();
});
+ it('ignores openLibraryAgent and sessions open when sessions port is missing', () => {
+ const { result } = renderHook(() => useShellMode(), { wrapper: wrapWithoutSessions() });
+
+ act(() => result.current.openLibraryAgent('agent-1'));
+ expect(result.current.libraryOpen).toBe(false);
+ expect(result.current.libraryAgentId).toBeNull();
+
+ act(() => result.current.setSessionsOpen(true));
+ expect(result.current.sessionsOpen).toBe(false);
+ });
+
it('defaults to AgentLibraryWithComposer (mutable + library)', () => {
const { result } = renderHook(() => useShellMode(), { wrapper: wrap() });
expect(result.current.mode).toMatchObject({ status: 'active', isMutable: true, locked: false });
diff --git a/packages/trueforge-ui/test/server/mockServer.ts b/packages/trueforge-ui/test/server/mockServer.ts
index 473308ffc..2f5f444ce 100644
--- a/packages/trueforge-ui/test/server/mockServer.ts
+++ b/packages/trueforge-ui/test/server/mockServer.ts
@@ -1,4 +1,10 @@
-import type { AgentSessionsServer, AgentUIServer, CatalogServer } from '@/server/types.js';
+import type {
+ AgentMetricsServer,
+ AgentSessionsServer,
+ AgentUIServer,
+ CatalogServer,
+ ScheduleServer,
+} from '@/server/types.js';
async function unavailable(): Promise<never> {
throw new Error('Unexpected mock server call');
@@ -38,6 +44,28 @@ export function createMockAgentSessionsServer(overrides: Partial<AgentSessionsSe
};
}
+export function createMockScheduleServer(overrides: Partial<ScheduleServer> = {}): ScheduleServer {
+ return {
+ listSchedules: async () => ({ data: [] }),
+ getSchedule: unavailable,
+ createSchedule: unavailable,
+ updateSchedule: unavailable,
+ deleteSchedule: unavailable,
+ listScheduleRuns: async () => [],
+ createScheduleRun: unavailable,
+ ...overrides,
+ };
+}
+
+export function createMockAgentMetricsServer(overrides: Partial<AgentMetricsServer> = {}): AgentMetricsServer {
+ return {
+ getCharts: async () => [],
+ getMeters: async () => [],
+ getChartData: unavailable,
+ ...overrides,
+ };
+}
+
export function createMockAgentUIServer(overrides: Partial<AgentUIServer> = {}): AgentUIServer {
return {
createSession: unavailable,
diff --git a/packages/trueforge-ui/test/server/serverChrome.test.ts b/packages/trueforge-ui/test/server/serverChrome.test.ts
new file mode 100644
index 000000000..76a684473
--- /dev/null
+++ b/packages/trueforge-ui/test/server/serverChrome.test.ts
@@ -0,0 +1,72 @@
+import { describe, expect, it } from 'vitest';
+
+import { resolveRoutesConfig } from '@/routing/paths.js';
+import {
+ isMetricsChromeEnabled,
+ isSchedulesChromeEnabled,
+ isSessionsChromeEnabled,
+ isSettingsChromeEnabled,
+ toEffectiveRoutes,
+} from '@/server/serverChrome.js';
+import {
+ createMockAgentMetricsServer,
+ createMockAgentSessionsServer,
+ createMockCatalog,
+ createMockScheduleServer,
+} from './mockServer.js';
+
+describe('serverChrome', () => {
+ const catalog = createMockCatalog();
+ const sessions = createMockAgentSessionsServer();
+ const schedules = createMockScheduleServer();
+ const metrics = createMockAgentMetricsServer();
+ const routes = resolveRoutesConfig();
+
+ it('isSettingsChromeEnabled requires catalog; missing settings capability counts as on', () => {
+ expect(isSettingsChromeEnabled({ catalog: null, capabilities: null })).toBe(false);
+ expect(isSettingsChromeEnabled({ catalog, capabilities: null })).toBe(true);
+ expect(
+ isSettingsChromeEnabled({
+ catalog,
+ capabilities: { settings: { enabled: false } },
+ }),
+ ).toBe(false);
+ });
+
+ it('gates sessions / schedules / metrics on port presence', () => {
+ expect(isSessionsChromeEnabled({ sessions: null })).toBe(false);
+ expect(isSessionsChromeEnabled({ sessions })).toBe(true);
+ expect(isSchedulesChromeEnabled({ schedules: null })).toBe(false);
+ expect(isSchedulesChromeEnabled({ schedules })).toBe(true);
+ expect(isMetricsChromeEnabled({ metrics: null })).toBe(false);
+ expect(isMetricsChromeEnabled({ metrics })).toBe(true);
+ });
+
+ it('toEffectiveRoutes nulls path-backed places when ports are missing', () => {
+ const disabled = toEffectiveRoutes({
+ routes,
+ catalog: null,
+ capabilities: null,
+ sessions: null,
+ schedules: null,
+ });
+ expect(disabled.settings).toBeNull();
+ expect(disabled.sessionsBrowser).toBeNull();
+ expect(disabled.libraryAgent).toBeNull();
+ expect(disabled.schedules).toBeNull();
+ expect(disabled.root).toBe('/');
+ expect(disabled.library).toBe('/library');
+
+ const enabled = toEffectiveRoutes({
+ routes,
+ catalog,
+ capabilities: { settings: { enabled: true } },
+ sessions,
+ schedules,
+ });
+ expect(enabled.settings).toBe('/settings');
+ expect(enabled.sessionsBrowser).toBe('/sessions');
+ expect(enabled.libraryAgent).toBe('/library/:agentId');
+ expect(enabled.schedules).toBe('/schedules');
+ });
+});
diff --git a/packages/trueforge-ui/test/server/settingsChrome.test.ts b/packages/trueforge-ui/test/server/settingsChrome.test.ts
index ffbcf81b6..82858f327 100644
--- a/packages/trueforge-ui/test/server/settingsChrome.test.ts
+++ b/packages/trueforge-ui/test/server/settingsChrome.test.ts
@@ -3,6 +3,7 @@ import { describe, expect, it } from 'vitest';
import { isSettingsChromeEnabled } from '@/server/settingsChrome.js';
import { createMockCatalog } from './mockServer.js';
+/** Re-export path still works for Settings chrome. */
describe('isSettingsChromeEnabled', () => {
const catalog = createMockCatalog();