@promptbook/cli 0.113.0-8 → 0.114.0-0

package/apps/agents-server/src/app/docs/[docId]/page.tsx

@@ -4,6 +4,7 @@ import { getVisibleCommitmentDefinitions } from '../../../utils/getVisibleCommit
 import { DocsToolbar } from '../../../components/DocsToolbar/DocsToolbar';
 import { PrintHeader } from '../../../components/PrintHeader/PrintHeader';
 import { DocumentationContent } from '../../../components/DocumentationContent/DocumentationContent';
+import { getBookLanguageDocumentationAgentOptions } from '../../../utils/bookLanguageDocumentation/getBookLanguageDocumentationAgents';
 
 /**
  * Props for doc page.
@@ -19,11 +20,14 @@ type DocPageProps = {
  */
 export default async function DocPage(props: DocPageProps) {
     const { docId } = await props.params;
+    const agents = await getBookLanguageDocumentationAgentOptions();
 
     // Decode the docId in case it contains encoded characters (though types usually don't)
     const commitmentType = decodeURIComponent(docId) as BookCommitment;
     const groupedCommitments = getVisibleCommitmentDefinitions();
-    const group = groupedCommitments.find((g) => g.primary.type === commitmentType || g.aliases.includes(commitmentType));
+    const group = groupedCommitments.find(
+        (g) => g.primary.type === commitmentType || g.aliases.includes(commitmentType),
+    );
 
     if (!group) {
         notFound();
@@ -34,14 +38,10 @@ export default async function DocPage(props: DocPageProps) {
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50 dark:from-slate-950 dark:via-slate-950 dark:to-slate-900">
             <div className="container mx-auto px-4 py-16">
-                <DocsToolbar />
+                <DocsToolbar agents={agents} />
                 <PrintHeader title={primary.type} />
-                
-                <DocumentationContent 
-                    primary={primary} 
-                    aliases={aliases} 
-                    isPrintOnly={false} 
-                />
+
+                <DocumentationContent primary={primary} aliases={aliases} isPrintOnly={false} />
             </div>
         </div>
     );

package/apps/agents-server/src/app/docs/page.tsx

@@ -6,6 +6,7 @@ import { Card } from '../../components/Homepage/Card';
 import { Section } from '../../components/Homepage/Section';
 import { OpenMojiIcon } from '../../components/OpenMojiIcon/OpenMojiIcon';
 import { PrintHeader } from '../../components/PrintHeader/PrintHeader';
+import { getBookLanguageDocumentationAgentOptions } from '../../utils/bookLanguageDocumentation/getBookLanguageDocumentationAgents';
 import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
 import {
     getCommitmentNoticeMetadata,
@@ -15,13 +16,14 @@ import {
 /**
  * Handles docs page.
  */
-export default function DocsPage() {
+export default async function DocsPage() {
     const groupedCommitments = getVisibleCommitmentDefinitions();
+    const agents = await getBookLanguageDocumentationAgentOptions();
 
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50 dark:from-slate-950 dark:via-slate-950 dark:to-slate-900">
             <div className="container mx-auto px-4 py-16">
-                <DocsToolbar />
+                <DocsToolbar agents={agents} />
                 <PrintHeader title="Full Documentation" />
 
                 {/* Screen view: Cards */}
@@ -35,7 +37,9 @@ export default function DocsPage() {
                                 <Link key={primary.type} href={`/docs/${primary.type}`} className="block h-full group">
                                     <Card
                                         className={`h-full group-hover:border-blue-500 transition-colors ${
-                                            isLowVisibilityNotice ? 'opacity-75 transition-opacity group-hover:opacity-100' : ''
+                                            isLowVisibilityNotice
+                                                ? 'opacity-75 transition-opacity group-hover:opacity-100'
+                                                : ''
                                         }`}
                                     >
                                         <div className="flex flex-wrap items-center gap-2 mb-2">

package/apps/agents-server/src/app/globals.css

@@ -300,27 +300,6 @@ html.dark .agents-server-route-shell {
     overflow: hidden;
 }
 
-/* Agents graph styling */
-.agents-graph-surface {
-    background: radial-gradient(circle at 15% 15%, rgba(186, 230, 253, 0.45), transparent 55%),
-        radial-gradient(circle at 85% 85%, rgba(253, 230, 138, 0.35), transparent 60%), #f8fafc;
-}
-
-html.dark .agents-graph-surface {
-    background: radial-gradient(circle at 15% 15%, rgba(14, 165, 233, 0.2), transparent 45%),
-        radial-gradient(circle at 85% 85%, rgba(59, 130, 246, 0.16), transparent 48%), #020617;
-}
-
-.agents-graph-canvas {
-    position: relative;
-    z-index: 1;
-}
-
-.agents-graph-flow {
-    font-family: var(--font-poppins), 'Poppins', system-ui, -apple-system, sans-serif;
-    text-rendering: optimizeLegibility;
-}
-
 /* Code block styling */
 pre code {
     font-family: var(--font-mono), 'Courier New', monospace;
@@ -394,44 +373,6 @@ html.dark ::-webkit-scrollbar-thumb:hover {
     animation: spin 1s linear infinite;
 }
 
-@keyframes agents-maze-bob {
-    0%,
-    100% {
-        transform: translateY(0);
-    }
-    50% {
-        transform: translateY(-4px);
-    }
-}
-
-@keyframes agents-maze-pulse {
-    0%,
-    100% {
-        opacity: 0.24;
-        transform: scale(0.7);
-    }
-    50% {
-        opacity: 0.52;
-        transform: scale(1);
-    }
-}
-
-.agents-maze-avatar {
-    animation: agents-maze-bob 3s ease-in-out infinite;
-    transform-origin: center bottom;
-}
-
-.agents-maze-pulse {
-    animation: agents-maze-pulse 2.2s ease-in-out infinite;
-}
-
-@media (prefers-reduced-motion: reduce) {
-    .agents-maze-avatar,
-    .agents-maze-pulse {
-        animation: none;
-    }
-}
-
 /* Global route-transition progress bar */
 .agents-server-navigation-progress {
     position: fixed;

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

@@ -8,6 +8,7 @@ import { CONTENT_SECURITY_POLICY_NONCE_REQUEST_HEADER } from '../middleware/cont
 import { getCustomJavascriptWithIntegrations } from '../database/customJavascript';
 import { getAggregatedCustomStylesheetCss } from '../database/customStylesheet';
 import { getMetadataMap } from '../database/getMetadata';
+import { isAgentsServerSqliteMode } from '../database/agentsServerDatabaseMode';
 import { getServerVisibility } from '../utils/getServerVisibility';
 import {
     IS_SERVER_LANGUAGE_ENFORCED_METADATA_KEY,
@@ -20,9 +21,20 @@ import { $provideServer } from '../tools/$provideServer';
 import { isSelfContainedS3StorageSelected } from '../tools/$provideCdnForServer';
 import { loadAgentOrganizationState } from '../utils/agentOrganization/loadAgentOrganizationState';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../utils/agentOrganization/types';
+import {
+    isAgentProjectDnsDiagnosticIssue,
+    listAgentProjectDnsDiagnostics,
+} from '../utils/agentProjects/listAgentProjectDnsDiagnostics';
+import { listAgentProjectDomainRecords } from '../utils/agentProjects/agentProjectRuntimeDomains';
+import { resolveCurrentAgentProjectServerDomain } from '../utils/agentProjects/resolveCurrentAgentProjectServerDomain';
+import {
+    loadBundledAgentIdentities,
+    resolveMissingCoreAgentNames,
+} from '../utils/defaultAgents/resolveDefaultAgentsStatus';
 import { getAgentNaming } from '../utils/getAgentNaming';
 import { getCurrentUser } from '../utils/getCurrentUser';
 import { getDefaultChatPreferences } from '../utils/chatPreferences';
+import { formatServerLanguageHumanReadableDate } from '../utils/localization/formatServerLanguageHumanReadableDate';
 import {
     CHAT_VISUAL_MODE_COOKIE_NAME,
     CHAT_VISUAL_MODE_METADATA_KEY,
@@ -32,11 +44,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';
@@ -50,9 +58,21 @@ import {
 } from '../utils/getControlPanelOptionAvailability';
 import {
     SHIBBOLETH_AUTHENTICATION_METADATA_KEYS,
+    SHIBBOLETH_AUTHENTICATION_MENU_STATUS_HIDDEN,
     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 { isInternalS3WarningShown } from '../utils/internalS3/resolveInternalS3Status';
+import { readInternalS3Snapshot } from '../utils/internalS3/readInternalS3Snapshot';
+import { resolveServersDnsWarningStatus } from '../utils/serverManagement/resolveServersDnsWarningStatus';
+import {
+    isStalwartEmailSnapshotOperational,
+    readStalwartEmailSnapshot,
+} from '../utils/stalwart/readStalwartEmailSnapshot';
+import { readStalwartConfiguration } from '../utils/stalwart/StalwartConfiguration';
+import { readAgentsServerFooterVersion } from '../utils/vpsSelfUpdate/readAgentsServerFooterVersion';
 import '@prisma/studio-core/ui/index.css';
 import './globals.css';
 
@@ -179,6 +199,86 @@ async function resolveOptionalLayoutText(label: string, loader: () => Promise<st
     }
 }
 
+/**
+ * Resolves whether generated project DNS needs an administrator-facing menu warning.
+ *
+ * @param isAdmin - Whether the current viewer may see project administration details.
+ * @returns `true` when a generated project domain is not verified on a standalone VPS.
+ */
+async function resolveAgentProjectsDnsWarningStatus(isAdmin: boolean): Promise<boolean> {
+    if (!isAdmin || !isAgentsServerSqliteMode()) {
+        return false;
+    }
+
+    try {
+        const [currentServerDomain, projectDomainRecords] = await Promise.all([
+            resolveCurrentAgentProjectServerDomain(),
+            listAgentProjectDomainRecords(),
+        ]);
+        const projectDnsDiagnostics = await listAgentProjectDnsDiagnostics({
+            projectDomainRecords,
+            publicIpAddress: process.env.PTBK_PUBLIC_IP_ADDRESS,
+            serverDomain: currentServerDomain,
+        });
+
+        return projectDnsDiagnostics.some(isAgentProjectDnsDiagnosticIssue);
+    } catch (error) {
+        console.error('Failed to resolve agent project DNS warning status:', error);
+        return false;
+    }
+}
+
+/**
+ * Resolves whether the current server's agent email integration needs an administrator-facing menu warning.
+ *
+ * @param options - Current viewer capability and the server domain whose mail integration is checked.
+ * @returns `true` when the current server cannot receive and route agent email.
+ */
+async function resolveAgentEmailWarningStatus(options: {
+    readonly isAdmin: boolean;
+    readonly serverDomain: string;
+}): Promise<boolean> {
+    if (!options.isAdmin) {
+        return false;
+    }
+
+    try {
+        return !isStalwartEmailSnapshotOperational(await readStalwartEmailSnapshot(options.serverDomain));
+    } catch (error) {
+        console.error('Failed to resolve agent email warning status:', error);
+        return false;
+    }
+}
+
+/**
+ * Resolves whether the VPS-wide Stalwart configuration needs a super-admin menu warning.
+ *
+ * @param isGlobalAdmin - Whether the current viewer may see VPS-wide operational details.
+ * @returns `true` when Stalwart credentials or bridge secrets are incomplete.
+ */
+function resolveVpsEmailServerWarningStatus(isGlobalAdmin: boolean): boolean {
+    return Boolean(isGlobalAdmin && !readStalwartConfiguration().isConfigured);
+}
+
+/**
+ * Resolves whether the selected self-contained S3 storage needs a super-admin menu warning.
+ *
+ * @param isGlobalAdmin - Whether the current viewer may see VPS-wide operational details.
+ * @returns `true` when the active self-contained S3 storage is incomplete or unavailable.
+ */
+async function resolveInternalS3WarningStatus(isGlobalAdmin: boolean): Promise<boolean> {
+    if (!isGlobalAdmin) {
+        return false;
+    }
+
+    try {
+        return isInternalS3WarningShown(await readInternalS3Snapshot());
+    } catch (error) {
+        console.error('Failed to resolve Internal S3 warning status:', error);
+        return false;
+    }
+}
+
 /**
  * Generates metadata.
  */
@@ -270,14 +370,47 @@ 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 agentProjectsDnsWarningPromise = isAdminPromise.then(resolveAgentProjectsDnsWarningStatus);
     const providedServerPromise = $provideServer();
+    const agentEmailWarningPromise = Promise.all([isAdminPromise, providedServerPromise]).then(
+        ([isAdmin, providedServer]) =>
+            resolveAgentEmailWarningStatus({
+                isAdmin,
+                serverDomain: providedServer.publicUrl.hostname,
+            }),
+    );
+    const vpsEmailServerWarningPromise = isGlobalAdminPromise.then(resolveVpsEmailServerWarningStatus);
+    const serversDnsWarningPromise = isGlobalAdminPromise.then(resolveServersDnsWarningStatus);
+    const internalS3WarningPromise = isGlobalAdminPromise.then(resolveInternalS3WarningStatus);
     const serverVisibilityPromise = getServerVisibility();
     const agentNamingPromise = getAgentNaming();
     const organizationStatePromise = isAdminPromise.then((isAdmin) =>
         isAdmin ? loadAgentOrganizationState({ status: 'ACTIVE', includePrivate: true }) : null,
     );
+    // Note: Core agents live in the private `.core` folder, which is already part of the admin organization state, so
+    //       the missing-core warning is derived without any extra database query.
+    const coreAgentIdentitiesPromise = isAdminPromise.then((isAdmin) =>
+        isAdmin
+            ? loadBundledAgentIdentities()
+                  .then((identities) => identities.coreAgents)
+                  .catch(() => [])
+            : [],
+    );
     const chatPreferencesPromise = getDefaultChatPreferences();
     const defaultIsNotificationsOnPromise = getDefaultIsNotificationsOn();
+    const footerVersionMetadataPromise = readAgentsServerFooterVersion();
     const fileUploadAvailabilityPromise = providedServerPromise.then((providedServer) =>
         resolveFileUploadAvailability({
             serverId: providedServer.id,
@@ -289,10 +422,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 +448,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 })),
-            ];
-
-            if (isPublicServerVisibility(serverVisibility)) {
-                footerLinks.push({
-                    title: 'Sitemap',
-                    url: '/sitemap.xml',
-                });
-            }
+    const footerLinksPromise = Promise.all([
+        layoutMetadataPromise,
+        federatedServersPromise,
+        serverVisibilityPromise,
+    ]).then(([layoutMetadata, federatedServers, serverVisibility]) => {
+        const footerLinks = [
+            ...parseFooterLinks(layoutMetadata.FOOTER_LINKS),
+            ...federatedServers.map(({ title, url }) => ({ title, url })),
+        ];
 
-            return footerLinks;
-        },
-    );
+        if (isPublicServerVisibility(serverVisibility)) {
+            footerLinks.push({
+                title: 'Sitemap',
+                url: '/sitemap.xml',
+            });
+        }
+
+        return footerLinks;
+    });
 
     const [
         isAdmin,
@@ -354,6 +486,14 @@ export default async function RootLayout({
         footerLinks,
         serverVisibility,
         fileUploadAvailability,
+        resourceMonitorWarningStatus,
+        footerVersionMetadata,
+        coreAgentIdentities,
+        isAgentEmailWarningShown,
+        isAgentProjectsDnsWarningShown,
+        isVpsEmailServerWarningShown,
+        isServersDnsWarningShown,
+        isInternalS3WarningShown,
     ] = await Promise.all([
         isAdminPromise,
         isGlobalAdminPromise,
@@ -372,6 +512,14 @@ export default async function RootLayout({
         footerLinksPromise,
         serverVisibilityPromise,
         fileUploadAvailabilityPromise,
+        resourceMonitorWarningStatusPromise,
+        footerVersionMetadataPromise,
+        coreAgentIdentitiesPromise,
+        agentEmailWarningPromise,
+        agentProjectsDnsWarningPromise,
+        vpsEmailServerWarningPromise,
+        serversDnsWarningPromise,
+        internalS3WarningPromise,
     ]);
 
     const serverName = layoutMetadata.SERVER_NAME || 'Promptbook Agents Server';
@@ -379,6 +527,12 @@ export default async function RootLayout({
     const isFooterShown = (layoutMetadata.IS_FOOTER_SHOWN ?? 'true') === 'true';
     const agents: AgentOrganizationAgent[] = organizationState?.agents || [];
     const agentFolders: AgentOrganizationFolder[] = organizationState?.folders || [];
+    const isCoreAgentsMissing =
+        isAdmin &&
+        resolveMissingCoreAgentNames(
+            coreAgentIdentities,
+            agents.map((agent) => agent.agentName),
+        ).length > 0;
     const isExperimental = (layoutMetadata.IS_EXPERIMENTAL_APP ?? 'false') === 'true';
     const feedbackMode = parseChatFeedbackMode(layoutMetadata.CHAT_FEEDBACK_MODE, layoutMetadata.IS_FEEDBACK_ENABLED);
     const isExperimentalPwaAppEnabled = (layoutMetadata.IS_EXPERIMENTAL_PWA_APP_ENABLED ?? 'true') === 'true';
@@ -400,11 +554,25 @@ export default async function RootLayout({
     const defaultAgentAvatarVisualId = resolveDefaultAgentAvatarVisualId(rawDefaultAgentAvatarVisual);
     const preferredLanguageSource = isServerLanguageEnforced ? rawServerLanguage : cookieLanguage || rawServerLanguage;
     const serverLanguage = resolveServerLanguageCode(preferredLanguageSource);
+    const footerVersionReleasedAtLabel =
+        formatServerLanguageHumanReadableDate(footerVersionMetadata.releasedAt, serverLanguage, {
+            fallbackLabel: '',
+        }) || null;
+    const footerVersion = {
+        label: footerVersionMetadata.label,
+        url: footerVersionMetadata.versionUrl,
+        commitSha: footerVersionMetadata.currentCommitSha,
+        releasedAtLabel: footerVersionReleasedAtLabel,
+    };
     const controlPanelOptionAvailability = getControlPanelOptionAvailability({
         metadata: layoutMetadata,
         isPushNotificationsConfigured: Boolean(webPushPublicKey),
     });
-    const shibbolethAuthenticationStatus = resolveShibbolethAuthenticationMenuStatus(layoutMetadata);
+    // Note: The Shibboleth activation/configuration status backs an admin-only login-method warning, so it is never
+    //       sent to regular or anonymous visitors — they receive an inert status instead of the real values.
+    const shibbolethAuthenticationStatus = isAdmin
+        ? resolveShibbolethAuthenticationMenuStatus(layoutMetadata)
+        : SHIBBOLETH_AUTHENTICATION_MENU_STATUS_HIDDEN;
     const themeModeBootstrapScript = createThemeModeBootstrapScript(defaultThemeMode);
 
     return (
@@ -433,7 +601,10 @@ 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')
+                    }
+                    footerVersion={footerVersion}
                     federatedServers={federatedServers}
                     defaultIsSoundsOn={chatPreferences.defaultIsSoundsOn}
                     defaultIsVibrationOn={chatPreferences.defaultIsVibrationOn}
@@ -441,6 +612,13 @@ export default async function RootLayout({
                     isExperimental={isExperimental}
                     feedbackMode={feedbackMode}
                     shibbolethAuthenticationStatus={shibbolethAuthenticationStatus}
+                    resourceMonitorWarningStatus={resourceMonitorWarningStatus}
+                    isCoreAgentsMissing={isCoreAgentsMissing}
+                    isAgentEmailWarningShown={isAgentEmailWarningShown}
+                    isAgentProjectsDnsWarningShown={isAgentProjectsDnsWarningShown}
+                    isVpsEmailServerWarningShown={isVpsEmailServerWarningShown}
+                    isServersDnsWarningShown={isServersDnsWarningShown}
+                    isInternalS3WarningShown={isInternalS3WarningShown}
                     isExperimentalPwaAppEnabled={isExperimentalPwaAppEnabled}
                     controlPanelOptionAvailability={controlPanelOptionAvailability}
                     defaultServerLanguage={serverLanguage}

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

@@ -3,8 +3,10 @@ import Link from 'next/link';
 import { redirect } from 'next/navigation';
 import { $sideEffect } from '../../../../src/utils/organization/$sideEffect';
 import { ForbiddenPage } from '../components/ForbiddenPage/ForbiddenPage';
+import { DefaultAgentsStatusNotice } from '../components/Homepage/DefaultAgentsStatusNotice';
 import { HomepagePrimarySections } from '../components/Homepage/HomepagePrimarySections';
 import { $provideServer } from '../tools/$provideServer';
+import { resolveDefaultAgentsStatus } from '../utils/defaultAgents/resolveDefaultAgentsStatus';
 import { isUserAdmin } from '../utils/isUserAdmin';
 import { isUserGlobalAdmin } from '../utils/isUserGlobalAdmin';
 import {
@@ -29,7 +31,7 @@ export default async function HomePage() {
     }
 
     if (ipAddressRouting === 'CONFIGURE') {
-        redirect('/admin/servers?setup=1');
+        redirect('/superadmin/servers?setup=1');
     }
 
     if (Array.isArray(ipAddressRouting)) {
@@ -42,9 +44,29 @@ export default async function HomePage() {
         getHomePageAgents(),
     ]);
 
+    // Note: The missing-agents notice is only relevant to admins, who alone can reinstate the bundled agents.
+    const defaultAgentsStatus = isAdmin
+        ? await resolveDefaultAgentsStatus().catch((error) => {
+              console.error('Failed to resolve default agents status:', error);
+              return null;
+          })
+        : null;
+
     return (
         <div className="agents-server-route-shell min-h-screen">
             <div className="container mx-auto px-4 py-16">
+                {defaultAgentsStatus && (
+                    <DefaultAgentsStatusNotice
+                        isAnyCoreAgentMissing={defaultAgentsStatus.isAnyCoreAgentMissing}
+                        isAnyDefaultAgentMissing={defaultAgentsStatus.isAnyDefaultAgentMissing}
+                        missingCoreAgentTitles={defaultAgentsStatus.coreAgents
+                            .filter((coreAgent) => !coreAgent.isPresent)
+                            .map((coreAgent) => coreAgent.title)}
+                        missingDefaultAgentTitles={defaultAgentsStatus.defaultAgents
+                            .filter((defaultAgent) => !defaultAgent.isPresent)
+                            .map((defaultAgent) => defaultAgent.title)}
+                    />
+                )}
                 <HomepagePrimarySections
                     agents={agents}
                     folders={folders}

package/apps/agents-server/src/app/superadmin/email-server/actions.ts

@@ -0,0 +1,28 @@
+'use server';
+
+import { NotAllowed } from '../../../../../../src/errors/NotAllowed';
+import { spaceTrim } from '../../../../../../src/utils/organization/spaceTrim';
+import { revalidatePath } from 'next/cache';
+import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
+import {
+    captureStalwartSynchronizationResult,
+    type StalwartSynchronizationResult,
+} from '../../../utils/stalwart/captureStalwartSynchronizationResult';
+import { synchronizeAllStalwartEmailDomains } from '../../../utils/stalwart/synchronizeAllStalwartEmailDomains';
+
+/**
+ * Synchronizes every registered Agents Server domain with the VPS-wide Stalwart service.
+ */
+export async function $synchronizeAllStalwartEmailDomains(): Promise<StalwartSynchronizationResult> {
+    if (!(await isUserGlobalAdmin())) {
+        throw new NotAllowed(
+            spaceTrim(`
+                You are not allowed to synchronize the VPS email server.
+            `),
+        );
+    }
+
+    const result = await captureStalwartSynchronizationResult(() => synchronizeAllStalwartEmailDomains());
+    revalidatePath('/superadmin/email-server');
+    return result;
+}