@promptbook/cli 0.113.0-9 → 0.114.0-0

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

@@ -0,0 +1,215 @@
+import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
+import type { ServerResourceWarningStatus } from '../../utils/resourceMonitor/resourceMonitorTypes';
+
+/**
+ * System dropdown categories that can contain an administrator warning.
+ *
+ * @private type of Header
+ */
+export type HeaderSystemWarningCategory = 'Super Admin' | 'Administration' | 'Login Methods';
+
+/**
+ * System-menu hrefs that can display an administrator warning indicator.
+ *
+ * @private type of Header
+ */
+type HeaderSystemWarningHref =
+    | '/superadmin/servers'
+    | '/superadmin/email-server'
+    | '/superadmin/resource-monitor'
+    | '/admin/internal-s3'
+    | '/admin/core-agents'
+    | '/admin/email-server'
+    | '/admin/projects'
+    | '/admin/login-methods/shibboleth';
+
+/**
+ * One resolved warning together with the System-menu location it decorates.
+ *
+ * @private type of Header
+ */
+type HeaderSystemWarning = {
+    /**
+     * System dropdown category that contains the warning source.
+     */
+    readonly category: HeaderSystemWarningCategory;
+
+    /**
+     * Fragment-free href of the System menu item to decorate.
+     */
+    readonly href: HeaderSystemWarningHref;
+
+    /**
+     * Whether the current viewer is permitted to see this warning.
+     */
+    readonly isShown: boolean;
+};
+
+/**
+ * Inputs needed to decide which System warnings the current viewer is allowed to see.
+ *
+ * @private type of Header
+ */
+export type ResolveHeaderSystemWarningsOptions = {
+    /**
+     * Whether the current viewer is a per-server administrator.
+     */
+    readonly isAdmin: boolean;
+
+    /**
+     * Whether the current viewer is the environment-backed super-admin.
+     */
+    readonly isGlobalAdmin: boolean;
+
+    /**
+     * Shibboleth authentication status, used to detect a misconfigured login method.
+     */
+    readonly shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
+
+    /**
+     * Resource monitor status, used to detect server resource pressure.
+     */
+    readonly resourceMonitorWarningStatus?: ServerResourceWarningStatus;
+
+    /**
+     * Whether one or more bundled core agents are missing on this server.
+     */
+    readonly isCoreAgentsMissing?: boolean;
+
+    /**
+     * Whether the current server's Stalwart email integration needs administrator attention.
+     */
+    readonly isAgentEmailWarningShown?: boolean;
+
+    /**
+     * Whether one or more generated project domains need DNS configuration.
+     */
+    readonly isAgentProjectsDnsWarningShown?: boolean;
+
+    /**
+     * Whether the VPS-wide Stalwart email configuration needs super-admin attention.
+     */
+    readonly isVpsEmailServerWarningShown?: boolean;
+
+    /**
+     * Whether one or more registered server or project domains need DNS configuration.
+     */
+    readonly isServersDnsWarningShown?: boolean;
+
+    /**
+     * Whether the active self-contained S3 storage is incomplete or unavailable.
+     */
+    readonly isInternalS3WarningShown?: boolean;
+};
+
+/**
+ * Visibility of System warnings together with the aggregate indicator.
+ *
+ * @private type of Header
+ */
+export type HeaderSystemWarnings = {
+    /**
+     * Individual warnings keyed by their System-menu destination.
+     */
+    readonly warnings: ReadonlyArray<HeaderSystemWarning>;
+
+    /**
+     * Whether any System warning should decorate the top-level System menu label.
+     */
+    readonly isSystemWarningShown: boolean;
+};
+
+/**
+ * Resolves the complete warning registry for the current System menu.
+ *
+ * Each warning defines both its visibility policy and its menu destination in one place. This keeps
+ * the top-level System indicator, category labels, and individual menu entries in agreement while
+ * preventing admin-only operational details from leaking to normal or anonymous viewers.
+ *
+ * @private function of Header
+ */
+export function resolveHeaderSystemWarnings({
+    isAdmin,
+    isGlobalAdmin,
+    shibbolethAuthenticationStatus,
+    resourceMonitorWarningStatus,
+    isCoreAgentsMissing = false,
+    isAgentEmailWarningShown = false,
+    isAgentProjectsDnsWarningShown = false,
+    isVpsEmailServerWarningShown = false,
+    isServersDnsWarningShown = false,
+    isInternalS3WarningShown = false,
+}: ResolveHeaderSystemWarningsOptions): HeaderSystemWarnings {
+    const warnings: ReadonlyArray<HeaderSystemWarning> = [
+        {
+            category: 'Super Admin',
+            href: '/superadmin/servers',
+            isShown: Boolean(isGlobalAdmin && isServersDnsWarningShown),
+        },
+        {
+            category: 'Super Admin',
+            href: '/superadmin/email-server',
+            isShown: Boolean(isGlobalAdmin && isVpsEmailServerWarningShown),
+        },
+        {
+            category: 'Super Admin',
+            href: '/superadmin/resource-monitor',
+            isShown: Boolean(isGlobalAdmin && resourceMonitorWarningStatus?.isWarningShown),
+        },
+        {
+            category: 'Super Admin',
+            href: '/admin/internal-s3',
+            isShown: Boolean(isGlobalAdmin && isInternalS3WarningShown),
+        },
+        {
+            category: 'Administration',
+            href: '/admin/core-agents',
+            isShown: Boolean(isAdmin && isCoreAgentsMissing),
+        },
+        {
+            category: 'Administration',
+            href: '/admin/email-server',
+            isShown: Boolean(isAdmin && isAgentEmailWarningShown),
+        },
+        {
+            category: 'Administration',
+            href: '/admin/projects',
+            isShown: Boolean(isAdmin && isAgentProjectsDnsWarningShown),
+        },
+        {
+            category: 'Login Methods',
+            href: '/admin/login-methods/shibboleth',
+            isShown: Boolean(
+                isAdmin && shibbolethAuthenticationStatus?.isActive && !shibbolethAuthenticationStatus.isConfigured,
+            ),
+        },
+    ];
+
+    return {
+        warnings,
+        isSystemWarningShown: warnings.some((warning) => warning.isShown),
+    };
+}
+
+/**
+ * Checks whether a System menu href should display its warning indicator.
+ *
+ * @private function of Header
+ */
+export function isHeaderSystemWarningShownForHref(warnings: HeaderSystemWarnings, href: string): boolean {
+    const hrefWithoutFragment = href.split('#', 1)[0];
+
+    return warnings.warnings.some((warning) => warning.href === hrefWithoutFragment && warning.isShown);
+}
+
+/**
+ * Checks whether a System dropdown category contains a visible warning.
+ *
+ * @private function of Header
+ */
+export function isHeaderSystemWarningShownForCategory(
+    warnings: HeaderSystemWarnings,
+    category: HeaderSystemWarningCategory,
+): boolean {
+    return warnings.warnings.some((warning) => warning.category === category && warning.isShown);
+}

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

@@ -4,6 +4,7 @@ import { resolveAgentAvatarImageUrl } from '../../../../../src/utils/agents/reso
 import { buildAgentFolderContext, type AgentFolderContext } from '../../utils/agentOrganization/agentFolderContext';
 import type { AgentOrganizationAgent } from '../../utils/agentOrganization/types';
 import { buildAgentProfileHref, buildFreshAgentChatHref } from '../../utils/agentRouting/agentRouteHrefs';
+import { createAgentEmailAddress } from '../../utils/email/agentEmailAddress';
 import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys';
 import { useActiveAgentBreadcrumbInfo, type ActiveAgentBreadcrumbInfo } from './ActiveAgentBreadcrumbContext';
 import type { HeaderAgentMenuFolder } from './AgentMenuStructure';
@@ -53,6 +54,7 @@ type HeaderActiveAgentState = {
     readonly activeAgentNavigationId: string | null;
     readonly activeAgentOrigin: string;
     readonly activeAgentUrl: string;
+    readonly isActiveAgentProjectsViewVisible: boolean;
     readonly activeAgentView: ActiveAgentNavigation['view'];
     readonly activeAgentViewLabel: ReactNode;
     readonly agentMenuTree: ReturnType<typeof buildAgentMenuStructure>['tree'];
@@ -201,12 +203,26 @@ function createActiveAgentUrl(activeAgentNavigationId: string | null, origin: st
  *
  * @private function of Header
  */
-function createActiveAgentEmail(activeAgentNavigationId: string | null, hostname: string): string {
+function createActiveAgentEmail(
+    activeAgent: AgentOrganizationAgent | null,
+    activeAgentBreadcrumbInfo: ActiveAgentBreadcrumbInfo | null,
+    activeAgentNavigationId: string | null,
+    hostname: string,
+): string {
     if (!activeAgentNavigationId || !hostname) {
         return '';
     }
 
-    return `${activeAgentNavigationId}@${hostname}`;
+    const agentIdentity = activeAgent || activeAgentBreadcrumbInfo;
+
+    return createAgentEmailAddress(
+        {
+            agentName: agentIdentity?.agentName || activeAgentNavigationId,
+            permanentId: agentIdentity?.permanentId || activeAgentNavigationId,
+            fullname: agentIdentity?.meta?.fullname,
+        },
+        hostname,
+    );
 }
 
 /**
@@ -266,7 +282,12 @@ export function useHeaderActiveAgent({
     return {
         activeAgent,
         activeAgentAvatarUrl,
-        activeAgentEmail: createActiveAgentEmail(activeAgentNavigationId, hostname),
+        activeAgentEmail: createActiveAgentEmail(
+            activeAgent,
+            activeAgentBreadcrumbInfo,
+            activeAgentNavigationId,
+            hostname,
+        ),
         activeAgentFolderContext,
         activeAgentHref,
         activeAgentLabel,
@@ -274,6 +295,7 @@ export function useHeaderActiveAgent({
         activeAgentNavigationId,
         activeAgentOrigin: origin,
         activeAgentUrl: createActiveAgentUrl(activeAgentNavigationId, origin),
+        isActiveAgentProjectsViewVisible: activeAgentBreadcrumbInfo?.isProjectsViewVisible === true,
         activeAgentView: activeAgentNavigation.view,
         activeAgentViewLabel: activeAgentNavigation.view
             ? createAgentViewLabel(activeAgentNavigation.view, translate)

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

@@ -44,6 +44,7 @@ type UseHeaderAgentMenusOptions = {
     readonly isAdmin: boolean;
     readonly isAuthenticated: boolean;
     readonly isInstalled: boolean;
+    readonly isProjectsViewVisible: boolean;
     readonly namingPlural: string;
     readonly namingSingular: string;
     readonly onAgentRenamed: (payload: AgentContextMenuRenamePayload) => void;
@@ -159,6 +160,7 @@ export function useHeaderAgentMenus({
     isAdmin,
     isAuthenticated,
     isInstalled,
+    isProjectsViewVisible,
     namingPlural,
     namingSingular,
     onAgentRenamed,
@@ -185,6 +187,7 @@ export function useHeaderAgentMenus({
         folderContext: activeAgentFolderContext,
         isAdmin,
         isAuthenticated,
+        isProjectsViewVisible,
         onShowQrCode: handleShowAgentQrCode,
         onAgentRenamed,
         onRequestClose: closeAgentViewDropdown,
@@ -202,9 +205,10 @@ export function useHeaderAgentMenus({
                 activeAgentNavigationId,
                 agentMoreViewItems,
                 isAdmin,
+                isProjectsViewVisible,
                 translate,
             }),
-        [activeAgentNavigationId, agentMoreViewItems, isAdmin, translate],
+        [activeAgentNavigationId, agentMoreViewItems, isAdmin, isProjectsViewVisible, translate],
     );
 
     const {

package/apps/agents-server/src/components/Homepage/AgentsList.tsx

@@ -5,8 +5,7 @@ import { string_url } from '@promptbook-local/types';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
 import { AgentsListDialogs } from './AgentsListDialogs';
 import { AgentsListHeader } from './AgentsListHeader';
-import { AgentsListViewContent } from './AgentsListViewContent';
-import type { AgentWithVisibility } from './useFederatedAgents';
+import { AgentsListListView } from './AgentsListListView';
 import { useAgentsListState } from './useAgentsListState';
 
 /**
@@ -33,31 +32,16 @@ type AgentsListProps = {
      */
     readonly canOrganize: boolean;
 
-    /**
-     * Controls whether federated agents are loaded and shown in graph view.
-     */
-    readonly showFederatedAgents: boolean;
-
     /**
      * Base URL of the agents server
      *
      * Note: [??] Using `string_url`, not `URL` object because we are passing prop from server to client.
      */
     readonly publicUrl: string_url;
-
-    /**
-     * Optional external agents to display in the list view (used for federated agents)
-     */
-    readonly externalAgents?: AgentWithVisibility[];
-
-    /**
-     * Whether the current view is inside a subfolder.
-     */
-    readonly isSubfolderView: boolean;
 };
 
 /**
- * Renders the agents list with folder navigation and graph view toggles.
+ * Renders the agents list with folder navigation and organization controls.
  */
 export function AgentsList(props: AgentsListProps) {
     const { canOrganize, isAdmin, publicUrl } = props;
@@ -69,7 +53,9 @@ export function AgentsList(props: AgentsListProps) {
     const onRenameContextMenuFolder =
         canOrganize && contextMenuFolder ? () => state.handleRenameFolder(contextMenuFolder.id) : undefined;
     const onRequestContextMenuFolderVisibilityUpdate =
-        isAdmin && contextMenuFolder ? () => state.handleRequestFolderVisibilityUpdate(contextMenuFolder.id) : undefined;
+        isAdmin && contextMenuFolder
+            ? () => state.handleRequestFolderVisibilityUpdate(contextMenuFolder.id)
+            : undefined;
 
     return (
         <section
@@ -101,23 +87,17 @@ export function AgentsList(props: AgentsListProps) {
                 onExportAgents={() => void state.handleAgentsExport()}
                 onNavigateToFolder={state.navigateToFolder}
                 onSetHiddenFoldersVisible={state.setHiddenFoldersVisible}
-                onSetViewMode={state.setViewMode}
-                viewMode={state.viewMode}
             />
-            <AgentsListViewContent
+            <AgentsListListView
                 activeAgent={state.activeAgent}
                 activeDragItemType={state.activeDragItemType}
                 activeFolder={state.activeFolder}
-                agents={state.agents}
                 allowFullCardDrag={state.allowFullCardDrag}
                 canOrganize={canOrganize}
                 currentFolderId={state.currentFolderId}
                 dragAgentLabel={state.dragAgentLabel}
                 dragFolderLabel={state.dragFolderLabel}
                 dropIndicator={state.dropIndicator}
-                federatedAgents={state.federatedAgents}
-                federatedServersStatus={state.federatedServersStatus}
-                folders={state.folders}
                 getAgentDragId={state.getAgentDragId}
                 getFolderDragId={state.getFolderDragId}
                 getFolderPreviewAgents={state.getFolderPreviewAgents}
@@ -133,14 +113,10 @@ export function AgentsList(props: AgentsListProps) {
                 handleRenameFolder={state.handleRenameFolder}
                 handleRequestAgentVisibilityChange={state.handleRequestAgentVisibilityChange}
                 isAdmin={isAdmin}
-                mazeAgents={state.mazeAgents}
-                officeAgents={state.officeAgents}
-                officeFolders={state.officeFolders}
                 onNavigateToFolder={state.navigateToFolder}
                 parentFolderInfo={state.parentFolderInfo}
                 publicUrl={publicUrl}
                 sensors={state.sensors}
-                viewMode={state.viewMode}
                 visibleAgentDragIds={state.visibleAgentDragIds}
                 visibleAgents={state.visibleAgents}
                 visibleFolderDragIds={state.visibleFolderDragIds}

package/apps/agents-server/src/components/Homepage/AgentsListHeader.tsx

@@ -1,45 +1,9 @@
 'use client';
 
-import {
-    Building2,
-    DownloadIcon,
-    Eye,
-    EyeOff,
-    FolderPlusIcon,
-    Gamepad2,
-    Grid,
-    Map,
-    Network,
-    type LucideIcon,
-} from 'lucide-react';
+import { DownloadIcon, Eye, EyeOff, FolderPlusIcon } from 'lucide-react';
 import type { AgentOrganizationFolder } from '../../utils/agentOrganization/types';
-import type { HomeViewMode } from './homeViewMode';
 import { BreadcrumbDropTarget } from './BreadcrumbDropTarget';
 
-/**
- * Static metadata for one view-mode toggle button.
- *
- * @private function of AgentsList
- */
-type ViewModeButton = {
-    /**
-     * View mode activated by the button.
-     */
-    readonly mode: HomeViewMode;
-    /**
-     * Short visible label shown next to the icon.
-     */
-    readonly label: string;
-    /**
-     * Tooltip title for the toggle button.
-     */
-    readonly title: string;
-    /**
-     * Icon rendered next to the label.
-     */
-    readonly icon: LucideIcon;
-};
-
 /**
  * Props for the private AgentsList header.
  *
@@ -94,14 +58,6 @@ type AgentsListHeaderProps = {
      * Toggles whether hidden folders are visible in the agents list.
      */
     readonly onSetHiddenFoldersVisible: (isVisible: boolean) => void;
-    /**
-     * Switches the homepage view mode.
-     */
-    readonly onSetViewMode: (mode: HomeViewMode) => void;
-    /**
-     * Currently active homepage view mode.
-     */
-    readonly viewMode: HomeViewMode;
     /**
      * Whether agents export is currently running.
      */
@@ -113,23 +69,10 @@ type AgentsListHeaderProps = {
 };
 
 /**
- * View-mode button definitions rendered in the header toggle group.
- *
- * @private function of AgentsList
- */
-const VIEW_MODE_BUTTONS: ReadonlyArray<ViewModeButton> = [
-    { mode: 'LIST', label: 'List', title: 'List View', icon: Grid },
-    { mode: 'GRAPH', label: 'Graph', title: 'Graph View', icon: Network },
-    { mode: 'OFFICE', label: 'Office', title: 'Office View', icon: Building2 },
-    { mode: 'MAZE', label: 'Maze', title: 'Maze View', icon: Map },
-    { mode: 'PIXEL_OFFICE', label: 'Pixel', title: 'Pixel Office View', icon: Gamepad2 },
-];
-
-/**
- * Renders the heading, breadcrumbs, and view toggle toolbar for `AgentsList`.
+ * Renders the heading, breadcrumbs, and organization toolbar for `AgentsList`.
  *
  * @param props - Heading data and toolbar callbacks.
- * @returns Header block shown above the active homepage view.
+ * @returns Header block shown above the agents list.
  *
  * @private function of AgentsList
  */
@@ -148,12 +91,7 @@ export function AgentsListHeader({
     onExportAgents,
     onNavigateToFolder,
     onSetHiddenFoldersVisible,
-    onSetViewMode,
-    viewMode,
 }: AgentsListHeaderProps) {
-    const isListView = viewMode === 'LIST';
-    const showBreadcrumbs = viewMode !== 'GRAPH';
-
     return (
         <h2 className="text-3xl text-gray-900 mb-6 font-light">
             <div className="flex flex-wrap items-center justify-between w-full gap-4">
@@ -161,30 +99,28 @@ export function AgentsListHeader({
                     <span>
                         {headingTitle} ({agentCount})
                     </span>
-                    {showBreadcrumbs && (
-                        <div className="mt-2 flex items-center gap-2 text-sm text-gray-600">
-                            <BreadcrumbDropTarget
-                                label={allAgentsLabel}
-                                folderId={null}
-                                onClick={() => onNavigateToFolder(null)}
-                                canOrganize={canOrganize}
-                            />
-                            {breadcrumbFolders.map((folder) => (
-                                <div key={folder.id} className="flex items-center gap-2">
-                                    <span>/</span>
-                                    <BreadcrumbDropTarget
-                                        label={folder.name}
-                                        folderId={folder.id}
-                                        onClick={() => onNavigateToFolder(folder.id)}
-                                        canOrganize={canOrganize}
-                                    />
-                                </div>
-                            ))}
-                        </div>
-                    )}
+                    <div className="mt-2 flex items-center gap-2 text-sm text-gray-600">
+                        <BreadcrumbDropTarget
+                            label={allAgentsLabel}
+                            folderId={null}
+                            onClick={() => onNavigateToFolder(null)}
+                            canOrganize={canOrganize}
+                        />
+                        {breadcrumbFolders.map((folder) => (
+                            <div key={folder.id} className="flex items-center gap-2">
+                                <span>/</span>
+                                <BreadcrumbDropTarget
+                                    label={folder.name}
+                                    folderId={folder.id}
+                                    onClick={() => onNavigateToFolder(folder.id)}
+                                    canOrganize={canOrganize}
+                                />
+                            </div>
+                        ))}
+                    </div>
                 </div>
                 <div className="flex items-center gap-2">
-                    {isListView && isAdmin && (
+                    {isAdmin && (
                         <>
                             <button
                                 type="button"
@@ -198,7 +134,7 @@ export function AgentsListHeader({
                             </button>
                         </>
                     )}
-                    {isListView && canOrganize && (
+                    {canOrganize && (
                         <button
                             type="button"
                             onClick={onCreateFolder}
@@ -225,32 +161,10 @@ export function AgentsListHeader({
                             }
                             aria-pressed={isHiddenFoldersVisible}
                         >
-                            {isHiddenFoldersVisible ? (
-                                <EyeOff className="w-4 h-4" />
-                            ) : (
-                                <Eye className="w-4 h-4" />
-                            )}
+                            {isHiddenFoldersVisible ? <EyeOff className="w-4 h-4" /> : <Eye className="w-4 h-4" />}
                             {isHiddenFoldersVisible ? 'Hide hidden' : 'Show hidden'}
                         </button>
                     )}
-                    <div className="flex items-center gap-2 bg-gray-100 p-1 rounded-lg ml-4">
-                        {VIEW_MODE_BUTTONS.map(({ mode, label, title, icon: Icon }) => (
-                            <button
-                                key={mode}
-                                type="button"
-                                onClick={() => onSetViewMode(mode)}
-                                className={`flex items-center gap-1.5 px-3 py-1.5 rounded-md text-sm transition-colors ${
-                                    viewMode === mode
-                                        ? 'bg-white shadow-sm text-blue-600 font-medium'
-                                        : 'text-gray-500 hover:text-gray-900'
-                                }`}
-                                title={title}
-                            >
-                                <Icon className="w-4 h-4" />
-                                <span>{label}</span>
-                            </button>
-                        ))}
-                    </div>
                 </div>
             </div>
         </h2>