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.mdnew file mode 100644index 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.mdindex 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.tsxindex 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.tsxindex 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 }: SchedulesButtonPconst 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.tsxindex 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 }: SessionsBrconst 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.tsxindex 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.tsxindex 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 }: AgentDetailsHeadconst 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.tsxindex 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 ? (<AgentDetailsTabsactiveTab={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.tsindex 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.tsxindex 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.tsxindex 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.tsxindex 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.tsnew file mode 100644index 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.tsindex 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.tsxindex 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 }): ReactElemedescribe('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.tsxindex 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.tsxindex 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.tsxindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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();