@promptbook/cli 0.113.0-7 → 0.113.0-9

package/apps/agents-server/src/app/api/admin/chat-tasks/[taskId]/terminal/route.ts

@@ -0,0 +1,52 @@
+import { NextResponse } from 'next/server';
+import { createInteractiveTerminalEventStream } from '@/src/utils/createInteractiveTerminalEventStream';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { resolveAdminTaskTerminalSession } from '@/src/utils/taskTerminal/resolveAdminTaskTerminalSession';
+
+/**
+ * Forces fresh terminal snapshots and live streams for every request.
+ */
+export const dynamic = 'force-dynamic';
+
+/**
+ * Reads or live-streams the read-only CLI terminal of one background task.
+ *
+ * Restricted to the super-admin because raw task console output can contain
+ * internal infrastructure details that regular administrators must not see.
+ *
+ * Query parameters:
+ * - `stream=1` — switches from a JSON snapshot to a Server-Sent-Events live stream
+ */
+export async function GET(request: Request, { params }: { params: Promise<{ taskId: string }> }) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    const { taskId: rawTaskId } = await params;
+    const taskId = decodeURIComponent(rawTaskId);
+
+    try {
+        const terminalResolution = await resolveAdminTaskTerminalSession(taskId);
+        if (!terminalResolution) {
+            return NextResponse.json({ error: 'Task not found.' }, { status: 404 });
+        }
+
+        const { searchParams } = new URL(request.url);
+        if (searchParams.get('stream') === '1') {
+            return createInteractiveTerminalEventStream(
+                request,
+                taskId,
+                terminalResolution.session,
+                terminalResolution.subscribe,
+            );
+        }
+
+        return NextResponse.json({ session: terminalResolution.session });
+    } catch (error) {
+        console.error('[admin-chat-task] terminal failed', { taskId, error });
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load the task terminal.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/update/route.ts

@@ -1,6 +1,11 @@
 import { NextResponse } from 'next/server';
 import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
-import { readVpsSelfUpdateOverview, startVpsSelfUpdate } from '@/src/utils/vpsSelfUpdate';
+import {
+    readVpsSelfUpdateOverview,
+    rescheduleAutomaticVpsSelfUpdateScheduler,
+    startVpsSelfUpdate,
+    updateVpsSelfUpdateAutomaticConfiguration,
+} from '@/src/utils/vpsSelfUpdate';
 
 export const runtime = 'nodejs';
 export const dynamic = 'force-dynamic';
@@ -32,13 +37,11 @@ export async function POST(request: Request) {
     }
 
     try {
-        const body = (await request.json().catch(() => null)) as
-            | {
-                  readonly environment?: string;
-                  readonly customRef?: string | null;
-                  readonly originRepositoryUrl?: string | null;
-              }
-            | null;
+        const body = (await request.json().catch(() => null)) as {
+            readonly environment?: string;
+            readonly customRef?: string | null;
+            readonly originRepositoryUrl?: string | null;
+        } | null;
 
         if (!body?.environment || typeof body.environment !== 'string') {
             return NextResponse.json({ error: 'Update environment is required.' }, { status: 400 });
@@ -48,6 +51,7 @@ export async function POST(request: Request) {
             environmentId: body.environment,
             customRef: body.customRef ?? null,
             originRepositoryUrl: body.originRepositoryUrl ?? null,
+            trigger: 'manual',
         });
 
         return NextResponse.json(overview, { status: 202 });
@@ -58,3 +62,46 @@ export async function POST(request: Request) {
         );
     }
 }
+
+/**
+ * Persists automatic standalone VPS self-update configuration.
+ */
+export async function PATCH(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as {
+            readonly automaticConfiguration?: {
+                readonly isEnabled?: boolean;
+                readonly environment?: string;
+                readonly cronExpression?: string;
+            };
+        } | null;
+        const automaticConfiguration = body?.automaticConfiguration;
+
+        if (
+            !automaticConfiguration ||
+            typeof automaticConfiguration.isEnabled !== 'boolean' ||
+            typeof automaticConfiguration.environment !== 'string' ||
+            typeof automaticConfiguration.cronExpression !== 'string'
+        ) {
+            return NextResponse.json({ error: 'Automatic self-update configuration is required.' }, { status: 400 });
+        }
+
+        await updateVpsSelfUpdateAutomaticConfiguration({
+            isEnabled: automaticConfiguration.isEnabled,
+            environmentId: automaticConfiguration.environment,
+            cronExpression: automaticConfiguration.cronExpression,
+        });
+        rescheduleAutomaticVpsSelfUpdateScheduler();
+
+        return NextResponse.json(await readVpsSelfUpdateOverview());
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to save automatic update configuration.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/update/versions/route.ts

@@ -0,0 +1,34 @@
+import { NextResponse } from 'next/server';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { deleteVpsSelfUpdateInstalledVersion, readVpsSelfUpdateOverview } from '@/src/utils/vpsSelfUpdate';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+/**
+ * Deletes one old installed Agents Server version from the standalone VPS releases directory.
+ */
+export async function DELETE(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as {
+            readonly versionName?: string;
+        } | null;
+
+        if (!body?.versionName || typeof body.versionName !== 'string') {
+            return NextResponse.json({ error: 'Version name is required.' }, { status: 400 });
+        }
+
+        await deleteVpsSelfUpdateInstalledVersion(body.versionName);
+
+        return NextResponse.json(await readVpsSelfUpdateOverview());
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to delete the installed version.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/auth/shibboleth/acs/route.ts

@@ -6,6 +6,7 @@ import {
     getShibbolethRequestDetails,
     recordShibbolethAuthenticationAttempt,
     resolveShibbolethAuthenticationConfiguration,
+    resolveShibbolethPublicRequestUrl,
     sanitizeShibbolethRelayState,
 } from '../../../../../utils/shibbolethAuthentication';
 import { setSession } from '../../../../../utils/session';
@@ -15,6 +16,7 @@ import { setSession } from '../../../../../utils/session';
  */
 export async function POST(request: Request) {
     const requestDetails = getShibbolethRequestDetails(request);
+    const publicRequestUrl = resolveShibbolethPublicRequestUrl(request);
     let relayState = '/';
 
     try {
@@ -34,7 +36,7 @@ export async function POST(request: Request) {
         }
 
         const configuration = await resolveShibbolethAuthenticationConfiguration({
-            requestUrl: request.url,
+            requestUrl: publicRequestUrl,
             isIdentityProviderMetadataValidationEnabled: true,
         });
 
@@ -95,7 +97,7 @@ export async function POST(request: Request) {
             rawAttributes: linkedUser.profileAttributes.rawAttributes,
         });
 
-        return NextResponse.redirect(new URL(relayState, request.url), 303);
+        return NextResponse.redirect(new URL(relayState, configuration.serviceProviderUrls.origin), 303);
     } catch (error) {
         const errorMessage = error instanceof Error ? error.message : 'Failed to finish Shibboleth authentication.';
         await recordShibbolethAuthenticationAttempt({

package/apps/agents-server/src/app/api/auth/shibboleth/login/route.ts

@@ -4,6 +4,7 @@ import {
     getShibbolethRequestDetails,
     recordShibbolethAuthenticationAttempt,
     resolveShibbolethAuthenticationConfiguration,
+    resolveShibbolethPublicRequestUrl,
     sanitizeShibbolethRelayState,
 } from '../../../../../utils/shibbolethAuthentication';
 
@@ -12,11 +13,12 @@ import {
  */
 export async function GET(request: Request) {
     const requestDetails = getShibbolethRequestDetails(request);
+    const publicRequestUrl = resolveShibbolethPublicRequestUrl(request);
     const relayState = sanitizeShibbolethRelayState(new URL(request.url).searchParams.get('returnTo'));
 
     try {
         const configuration = await resolveShibbolethAuthenticationConfiguration({
-            requestUrl: request.url,
+            requestUrl: publicRequestUrl,
             isIdentityProviderMetadataValidationEnabled: true,
         });
 

package/apps/agents-server/src/app/api/auth/shibboleth/metadata/route.ts

@@ -1,11 +1,14 @@
 import { NextResponse } from 'next/server';
-import { createShibbolethServiceProviderMetadataXml } from '../../../../../utils/shibbolethAuthentication';
+import {
+    createShibbolethServiceProviderMetadataXml,
+    resolveShibbolethPublicRequestUrl,
+} from '../../../../../utils/shibbolethAuthentication';
 
 /**
  * Handles get.
  */
 export async function GET(request: Request) {
-    const metadataXml = await createShibbolethServiceProviderMetadataXml(request.url);
+    const metadataXml = await createShibbolethServiceProviderMetadataXml(resolveShibbolethPublicRequestUrl(request));
 
     return new NextResponse(metadataXml, {
         headers: {

package/apps/agents-server/src/app/api/auth/shibboleth/status/route.ts

@@ -1,12 +1,15 @@
 import { NextResponse } from 'next/server';
-import { resolveShibbolethAuthenticationConfiguration } from '../../../../../utils/shibbolethAuthentication';
+import {
+    resolveShibbolethAuthenticationConfiguration,
+    resolveShibbolethPublicRequestUrl,
+} from '../../../../../utils/shibbolethAuthentication';
 
 /**
  * Handles get.
  */
 export async function GET(request: Request) {
     const configuration = await resolveShibbolethAuthenticationConfiguration({
-        requestUrl: request.url,
+        requestUrl: resolveShibbolethPublicRequestUrl(request),
         isIdentityProviderMetadataValidationEnabled: false,
     });
 

package/apps/agents-server/src/app/layout.tsx

@@ -32,11 +32,7 @@ import {
     DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY,
     resolveDefaultAgentAvatarVisualId,
 } from '../constants/defaultAgentAvatarVisual';
-import {
-    DEFAULT_THEME_METADATA_KEY,
-    THEME_MODE_COOKIE_NAME,
-    resolveThemeMode,
-} from '../constants/themeMode';
+import { DEFAULT_THEME_METADATA_KEY, THEME_MODE_COOKIE_NAME, resolveThemeMode } from '../constants/themeMode';
 import { parseChatFeedbackMode } from '../utils/chatFeedbackMode';
 import { getFederatedServers } from '../utils/getFederatedServers';
 import { isUserAdmin } from '../utils/isUserAdmin';
@@ -53,6 +49,8 @@ import {
     resolveShibbolethAuthenticationMenuStatus,
 } from '../constants/shibbolethAuth';
 import { resolveFileUploadAvailability } from '../utils/upload/fileUploadAvailability';
+import { readServerResourceWarningStatus } from '../utils/resourceMonitor/readServerResourceMonitorSnapshot';
+import { RESOURCE_MONITOR_OK_WARNING_STATUS } from '../utils/resourceMonitor/resourceMonitorTypes';
 import '@prisma/studio-core/ui/index.css';
 import './globals.css';
 
@@ -270,6 +268,18 @@ export default async function RootLayout({
     const currentUserPromise = getCurrentUser();
     const isAdminPromise = isUserAdmin();
     const isGlobalAdminPromise = isUserGlobalAdmin();
+    const resourceMonitorWarningStatusPromise = isGlobalAdminPromise.then(async (isGlobalAdmin) => {
+        if (!isGlobalAdmin) {
+            return RESOURCE_MONITOR_OK_WARNING_STATUS;
+        }
+
+        try {
+            return await readServerResourceWarningStatus();
+        } catch (error) {
+            console.error('Failed to resolve resource monitor warning status:', error);
+            return RESOURCE_MONITOR_OK_WARNING_STATUS;
+        }
+    });
     const providedServerPromise = $provideServer();
     const serverVisibilityPromise = getServerVisibility();
     const agentNamingPromise = getAgentNaming();
@@ -289,10 +299,7 @@ export default async function RootLayout({
         'custom stylesheet CSS',
         getAggregatedCustomStylesheetCss,
     );
-    const customJavascriptPromise = resolveOptionalLayoutText(
-        'custom JavaScript',
-        getCustomJavascriptWithIntegrations,
-    );
+    const customJavascriptPromise = resolveOptionalLayoutText('custom JavaScript', getCustomJavascriptWithIntegrations);
     const cookieStorePromise = cookies();
     const requestHeadersPromise = headers();
     const defaultThemeModePromise = Promise.all([currentUserPromise, cookieStorePromise, layoutMetadataPromise]).then(
@@ -318,23 +325,25 @@ export default async function RootLayout({
                 showFederatedServersPublicly: (layoutMetadata.SHOW_FEDERATED_SERVERS_PUBLICLY ?? 'false') === 'true',
             }),
     );
-    const footerLinksPromise = Promise.all([layoutMetadataPromise, federatedServersPromise, serverVisibilityPromise]).then(
-        ([layoutMetadata, federatedServers, serverVisibility]) => {
-            const footerLinks = [
-                ...parseFooterLinks(layoutMetadata.FOOTER_LINKS),
-                ...federatedServers.map(({ title, url }) => ({ title, url })),
-            ];
+    const footerLinksPromise = Promise.all([
+        layoutMetadataPromise,
+        federatedServersPromise,
+        serverVisibilityPromise,
+    ]).then(([layoutMetadata, federatedServers, serverVisibility]) => {
+        const footerLinks = [
+            ...parseFooterLinks(layoutMetadata.FOOTER_LINKS),
+            ...federatedServers.map(({ title, url }) => ({ title, url })),
+        ];
 
-            if (isPublicServerVisibility(serverVisibility)) {
-                footerLinks.push({
-                    title: 'Sitemap',
-                    url: '/sitemap.xml',
-                });
-            }
+        if (isPublicServerVisibility(serverVisibility)) {
+            footerLinks.push({
+                title: 'Sitemap',
+                url: '/sitemap.xml',
+            });
+        }
 
-            return footerLinks;
-        },
-    );
+        return footerLinks;
+    });
 
     const [
         isAdmin,
@@ -354,6 +363,7 @@ export default async function RootLayout({
         footerLinks,
         serverVisibility,
         fileUploadAvailability,
+        resourceMonitorWarningStatus,
     ] = await Promise.all([
         isAdminPromise,
         isGlobalAdminPromise,
@@ -372,6 +382,7 @@ export default async function RootLayout({
         footerLinksPromise,
         serverVisibilityPromise,
         fileUploadAvailabilityPromise,
+        resourceMonitorWarningStatusPromise,
     ]);
 
     const serverName = layoutMetadata.SERVER_NAME || 'Promptbook Agents Server';
@@ -433,7 +444,9 @@ export default async function RootLayout({
                     agentFolders={JSON.parse(JSON.stringify(agentFolders))}
                     agentNaming={agentNaming}
                     isFooterShown={isFooterShown}
-                    footerLinks={isPublicServer ? footerLinks : footerLinks.filter((link) => link.url !== '/sitemap.xml')}
+                    footerLinks={
+                        isPublicServer ? footerLinks : footerLinks.filter((link) => link.url !== '/sitemap.xml')
+                    }
                     federatedServers={federatedServers}
                     defaultIsSoundsOn={chatPreferences.defaultIsSoundsOn}
                     defaultIsVibrationOn={chatPreferences.defaultIsVibrationOn}
@@ -441,6 +454,7 @@ export default async function RootLayout({
                     isExperimental={isExperimental}
                     feedbackMode={feedbackMode}
                     shibbolethAuthenticationStatus={shibbolethAuthenticationStatus}
+                    resourceMonitorWarningStatus={resourceMonitorWarningStatus}
                     isExperimentalPwaAppEnabled={isExperimentalPwaAppEnabled}
                     controlPanelOptionAvailability={controlPanelOptionAvailability}
                     defaultServerLanguage={serverLanguage}

package/apps/agents-server/src/components/AgentAvatar/AgentAvatar.tsx

@@ -78,7 +78,7 @@ type AgentAvatarProps = {
 
 /**
  * Renders either the explicit agent image or the shared animated default avatar visual.
- * Agent-level `META AVATAR` values are resolved before the federated server default and the
+ * Agent-level `META AVATAR` / `META VISUAL` values are resolved before the federated server default and the
  * local server metadata default.
  *
  * @private shared component of Agents Server

package/apps/agents-server/src/components/AgentAvatar/DefaultAgentAvatarVisualProvider.tsx

@@ -14,7 +14,7 @@ type DefaultAgentAvatarVisualProviderProps = {
     readonly children: ReactNode;
 
     /**
-     * Metadata-resolved built-in visual id used when an agent has no `META IMAGE` or `META AVATAR`.
+     * Metadata-resolved built-in visual id used when an agent has no `META IMAGE`, `META AVATAR`, or `META VISUAL`.
      */
     readonly defaultAgentAvatarVisualId: AvatarVisualId;
 };

package/apps/agents-server/src/components/Header/Header.tsx

@@ -56,6 +56,7 @@ export function Header(props: HeaderProps) {
         isExperimental = false,
         feedbackMode = 'stars',
         shibbolethAuthenticationStatus,
+        resourceMonitorWarningStatus,
     } = props;
     const [isChangePasswordOpen, setIsChangePasswordOpen] = useState(false);
     const router = useRouter();
@@ -241,6 +242,8 @@ export function Header(props: HeaderProps) {
     const isShibbolethConfigurationWarningShown = Boolean(
         shibbolethAuthenticationStatus?.isActive && !shibbolethAuthenticationStatus.isConfigured,
     );
+    const isResourceMonitorWarningShown = Boolean(isGlobalAdmin && resourceMonitorWarningStatus?.isWarningShown);
+    const isSystemWarningShown = isShibbolethConfigurationWarningShown || isResourceMonitorWarningShown;
     const systemMenuEntries = useMemo(
         () =>
             buildHeaderSystemMenuItems({
@@ -251,12 +254,22 @@ export function Header(props: HeaderProps) {
                 isExperimental,
                 feedbackMode,
                 shibbolethAuthenticationStatus,
+                resourceMonitorWarningStatus,
             }),
-        [currentUser, feedbackMode, isAdmin, isExperimental, isGlobalAdmin, shibbolethAuthenticationStatus, t],
+        [
+            currentUser,
+            feedbackMode,
+            isAdmin,
+            isExperimental,
+            isGlobalAdmin,
+            resourceMonitorWarningStatus,
+            shibbolethAuthenticationStatus,
+            t,
+        ],
     );
     const systemLabel = useMemo(
         () =>
-            isShibbolethConfigurationWarningShown ? (
+            isSystemWarningShown ? (
                 <span className="inline-flex items-center gap-2">
                     {t('header.systemMenuLabel')}
                     <TriangleAlert className="h-4 w-4 text-amber-500" aria-label="Warning" />
@@ -264,7 +277,7 @@ export function Header(props: HeaderProps) {
             ) : (
                 t('header.systemMenuLabel')
             ),
-        [isShibbolethConfigurationWarningShown, t],
+        [isSystemWarningShown, t],
     );
     const menuItems = useMemo(
         () =>

package/apps/agents-server/src/components/Header/HeaderTypes.ts

@@ -3,6 +3,7 @@ import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../util
 import type { ChatFeedbackMode } from '../../utils/chatFeedbackMode';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
+import type { ServerResourceWarningStatus } from '../../utils/resourceMonitor/resourceMonitorTypes';
 import type { SubMenuItem } from './SubMenuItem';
 
 /**
@@ -63,6 +64,11 @@ export type HeaderProps = {
      * Shibboleth authentication status used to show login-method menu entries and warnings.
      */
     shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
+
+    /**
+     * Resource monitor status used to show super-admin resource pressure warnings.
+     */
+    resourceMonitorWarningStatus?: ServerResourceWarningStatus;
 };
 
 /**

package/apps/agents-server/src/components/Header/buildAgentMenuStructure.tsx

@@ -1,6 +1,7 @@
 import type { ReactNode } from 'react';
 import { resolveAgentAvatarImageUrl } from '../../../../../src/utils/agents/resolveAgentAvatarImageUrl';
 import { buildFolderPath, getFolderPathSegments } from '../../utils/agentOrganization/folderPath';
+import { filterHiddenFolderTree } from '../../utils/agentOrganization/hiddenFolders';
 import type { AgentOrganizationAgent } from '../../utils/agentOrganization/types';
 import { buildFreshAgentChatHref } from '../../utils/agentRouting/agentRouteHrefs';
 import { FolderAppearanceIcon } from '../FolderAppearance/FolderAppearanceIcon';
@@ -428,14 +429,15 @@ export function buildAgentMenuStructure(
     agents: ReadonlyArray<HeaderAgentMenuAgent>,
     folders: ReadonlyArray<HeaderAgentMenuFolder>,
 ): AgentMenuStructure {
-    const agentMenuData = prepareAgentMenuData(agents, folders);
-    const agentAvatarByIdentifier = createAgentAvatarByIdentifier(agents);
+    const { agents: visibleAgents, folders: visibleFolders } = filterHiddenFolderTree(folders, agents, false);
+    const agentMenuData = prepareAgentMenuData(visibleAgents, visibleFolders);
+    const agentAvatarByIdentifier = createAgentAvatarByIdentifier(visibleAgents);
 
     const getAgentAvatarUrl = (agent: HeaderAgentMenuAgent): string | null =>
         agentAvatarByIdentifier.get(getAgentNavigationId(agent)) ?? null;
 
     return {
-        tree: createAgentTree(folders, agentMenuData, getAgentAvatarUrl),
-        items: createAgentMenuItems(folders, agentMenuData, getAgentAvatarUrl),
+        tree: createAgentTree(visibleFolders, agentMenuData, getAgentAvatarUrl),
+        items: createAgentMenuItems(visibleFolders, agentMenuData, getAgentAvatarUrl),
     };
 }

package/apps/agents-server/src/components/Header/buildHeaderSystemMenuItems.ts

@@ -1,4 +1,5 @@
 import {
+    Activity,
     BarChart3,
     Code2,
     Globe2,
@@ -16,6 +17,7 @@ import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys
 import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
 import type { ChatFeedbackMode } from '../../utils/chatFeedbackMode';
 import type { UserInfo } from '../../utils/getCurrentUser';
+import type { ServerResourceWarningStatus } from '../../utils/resourceMonitor/resourceMonitorTypes';
 import type { SubMenuItem } from './SubMenuItem';
 
 /**
@@ -54,6 +56,7 @@ type BuildHeaderSystemMenuItemsOptions = {
     readonly isExperimental: boolean;
     readonly feedbackMode: ChatFeedbackMode;
     readonly shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
+    readonly resourceMonitorWarningStatus?: ServerResourceWarningStatus;
 };
 
 /**
@@ -156,6 +159,7 @@ export function buildHeaderSystemMenuItems({
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
+    resourceMonitorWarningStatus,
 }: BuildHeaderSystemMenuItemsOptions): SubMenuItem[] {
     const userAccountSystemItems: SubMenuItem[] = [
         {
@@ -218,6 +222,7 @@ export function buildHeaderSystemMenuItems({
         ];
     }
 
+    const isResourceMonitorWarningShown = Boolean(isGlobalAdmin && resourceMonitorWarningStatus?.isWarningShown);
     const superAdminSystemItems: SubMenuItem[] = [
         {
             label: translate('header.servers'),
@@ -230,6 +235,13 @@ export function buildHeaderSystemMenuItems({
         },
         ...(isGlobalAdmin
             ? [
+                  {
+                      label: isResourceMonitorWarningShown
+                          ? createWarningMenuLabel(translate('header.resourceMonitor'))
+                          : translate('header.resourceMonitor'),
+                      href: '/admin/resource-monitor',
+                      icon: Activity,
+                  } as SubMenuItem,
                   {
                       label: translate('header.update'),
                       href: '/admin/update',
@@ -387,7 +399,7 @@ export function buildHeaderSystemMenuItems({
     return [
         ...createSystemCategory('My Account', userAccountSystemItems, translate),
         ...createSystemCategory('Utilities', utilitiesSystemItems, translate),
-        ...createSystemCategory('Super Admin', superAdminSystemItems, translate),
+        ...createSystemCategory('Super Admin', superAdminSystemItems, translate, isResourceMonitorWarningShown),
         ...createSystemCategory('Administration', administrationSystemItems, translate),
         ...createSystemCategory(
             'Login Methods',

package/apps/agents-server/src/components/Homepage/useAgentsListState.ts

@@ -3,9 +3,9 @@
 import type { string_url } from '@promptbook-local/types';
 import { useMemo } from 'react';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
+import { filterHiddenFolderTree } from '../../utils/agentOrganization/hiddenFolders';
 import { useAgentNaming } from '../AgentNaming/AgentNamingContext';
 import { getAgentIdentifier } from './agentOrganizationUtils';
-import { filterHiddenFolderTree } from './hiddenFolders';
 import { useAgentsListAgentState } from './useAgentsListAgentState';
 import { useAgentsListDerivedState } from './useAgentsListDerivedState';
 import {

package/apps/agents-server/src/components/LayoutWrapper/LayoutWrapper.tsx

@@ -8,6 +8,7 @@ import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../util
 import type { ChatFeedbackMode } from '../../utils/chatFeedbackMode';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
+import type { ServerResourceWarningStatus } from '../../utils/resourceMonitor/resourceMonitorTypes';
 import { AgentNamingProvider } from '../AgentNaming/AgentNamingContext';
 import { DefaultAgentAvatarVisualProvider } from '../AgentAvatar/DefaultAgentAvatarVisualProvider';
 import { LegacyUiAutoTranslator } from '../AgentNaming/LegacyUiAutoTranslator';
@@ -56,6 +57,10 @@ type LayoutWrapperProps = {
      * Shibboleth authentication status used by the header menu.
      */
     readonly shibbolethAuthenticationStatus: ShibbolethAuthenticationMenuStatus;
+    /**
+     * Resource monitor status used by the header menu.
+     */
+    readonly resourceMonitorWarningStatus: ServerResourceWarningStatus;
     /**
      * Indicates if the install-as-app option should be shown in agent menus.
      */
@@ -101,6 +106,7 @@ export function LayoutWrapper({
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
+    resourceMonitorWarningStatus,
     isExperimentalPwaAppEnabled,
     controlPanelOptionAvailability,
     defaultIsSoundsOn,
@@ -152,7 +158,9 @@ export function LayoutWrapper({
                                                     <BrowserPushNotificationsProvider
                                                         defaultEnabled={defaultIsNotificationsOn}
                                                         pushPublicKey={webPushPublicKey}
-                                                        isMetadataAvailable={controlPanelOptionAvailability.notifications}
+                                                        isMetadataAvailable={
+                                                            controlPanelOptionAvailability.notifications
+                                                        }
                                                     >
                                                         <ChatEnterBehaviorPreferencesProvider>
                                                             <ClientVersionMismatchListener />
@@ -181,12 +189,17 @@ export function LayoutWrapper({
                                                                                         serverLogoUrl={serverLogoUrl}
                                                                                         agents={agents}
                                                                                         agentFolders={agentFolders}
-                                                                                        federatedServers={federatedServers}
+                                                                                        federatedServers={
+                                                                                            federatedServers
+                                                                                        }
                                                                                         isExperimental={isExperimental}
                                                                                         feedbackMode={feedbackMode}
                                                                                         shibbolethAuthenticationStatus={
                                                                                             shibbolethAuthenticationStatus
                                                                                         }
+                                                                                        resourceMonitorWarningStatus={
+                                                                                            resourceMonitorWarningStatus
+                                                                                        }
                                                                                     />
                                                                                     <main className={mainClassName}>
                                                                                         <HomepageOptimisticNavigation
@@ -195,9 +208,12 @@ export function LayoutWrapper({
                                                                                             {children}
                                                                                         </HomepageOptimisticNavigation>
                                                                                     </main>
-                                                                                    {isFooterShown && !isFooterHiddenOnPage && (
-                                                                                        <Footer extraLinks={footerLinks} />
-                                                                                    )}
+                                                                                    {isFooterShown &&
+                                                                                        !isFooterHiddenOnPage && (
+                                                                                            <Footer
+                                                                                                extraLinks={footerLinks}
+                                                                                            />
+                                                                                        )}
                                                                                 </div>
                                                                             )}
                                                                         </ActiveAgentBreadcrumbProvider>