@promptbook/cli 0.113.0-9 → 0.114.0-0

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

@@ -1,3 +1,4 @@
+import { BookOpenText, MonitorCog } from 'lucide-react';
 import type { MenuItem } from './HeaderTypes';
 import type { SubMenuItem } from './SubMenuItem';
 
@@ -14,6 +15,7 @@ type HeaderMenuSetter = (isOpen: boolean) => void;
  * @private type of Header
  */
 type HeaderDropdownMenuItemConfig = {
+    readonly icon: MenuItem['icon'];
     readonly id: string;
     readonly isMobileOpen: boolean;
     readonly isOpen: boolean;
@@ -50,6 +52,7 @@ type BuildHeaderMenuItemsOptions = {
  * @private function of Header
  */
 function createHeaderDropdownMenuItem({
+    icon,
     id,
     isMobileOpen,
     isOpen,
@@ -60,6 +63,7 @@ function createHeaderDropdownMenuItem({
 }: HeaderDropdownMenuItemConfig): MenuItem {
     return {
         type: 'dropdown',
+        icon,
         id,
         label,
         isOpen,
@@ -96,6 +100,7 @@ export function buildHeaderMenuItems({
         items.push(
             createHeaderDropdownMenuItem({
                 id: 'documentation',
+                icon: BookOpenText,
                 label: documentationLabel,
                 items: documentationDropdownItems,
                 isOpen: isDocsOpen,
@@ -106,10 +111,13 @@ export function buildHeaderMenuItems({
         );
     }
 
-    if (systemMenuEntries.length > 0) {
+    // Note: The System menu (like Documentation) is only offered to signed-in viewers, so anonymous visitors never see
+    //       it — nor any admin-only warning indicator it might carry.
+    if (hasMenuAccess && systemMenuEntries.length > 0) {
         items.push(
             createHeaderDropdownMenuItem({
                 id: 'system',
+                icon: MonitorCog,
                 label: systemLabel,
                 items: systemMenuEntries,
                 isOpen: isSystemOpen,

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

@@ -1,23 +1,73 @@
 import {
     Activity,
+    Archive,
+    BadgeInfo,
     BarChart3,
-    Code2,
+    Blocks,
+    Bot,
+    Boxes,
+    Brain,
+    Bug,
+    Building2,
+    ChartNoAxesColumn,
+    ClipboardList,
+    Crown,
+    Database,
+    FileAudio,
+    FileCode,
+    FileCode2,
+    FileJson,
+    FileSearch,
+    FileStack,
+    FlaskConical,
+    FolderKanban,
     Globe2,
+    Gauge,
+    History,
+    Home,
+    Images,
     KeyRound,
+    LogIn,
+    Mail,
+    MailCheck,
+    Mails,
+    MessageCircle,
+    MessageSquareText,
+    Mic,
+    MousePointerClick,
+    Paintbrush,
+    PlugZap,
     RefreshCw,
-    Settings2,
+    Scale,
+    ScrollText,
+    Search,
+    Server,
+    ServerCog,
+    Shield,
     ShieldCheck,
+    SlidersHorizontal,
+    Star,
+    Terminal,
+    TerminalSquare,
     TriangleAlert,
+    UserCircle,
     UserRound,
+    Users,
+    WalletCards,
     Wrench,
     type LucideIcon,
 } from 'lucide-react';
 import { createElement } from 'react';
+import { HARNESS_AUTH_ADMIN_PATH } from '../../constants/harnessAuthRoutes';
 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 {
+    isHeaderSystemWarningShownForCategory,
+    isHeaderSystemWarningShownForHref,
+    type HeaderSystemWarnings,
+} from './resolveHeaderSystemWarnings';
 import type { SubMenuItem } from './SubMenuItem';
 
 /**
@@ -43,6 +93,59 @@ type SystemCategoryLabel =
     | 'Developer / Debug'
     | 'Legal & About';
 
+/**
+ * Hrefs owned by the System dropdown that receive a dedicated icon.
+ *
+ * @private type of Header
+ */
+type SystemMenuItemHref =
+    | '/system/settings'
+    | '/system/profile'
+    | '/system/user-memory'
+    | '/system/user-wallet'
+    | '/system/utilities'
+    | '/system/utilities/mocked-chats'
+    | '/admin/about'
+    | 'https://ptbk.io/'
+    | '/superadmin/servers'
+    | '/superadmin/environment'
+    | '/superadmin/email-server'
+    | '/superadmin/resource-monitor'
+    | '/superadmin/update'
+    | '/superadmin/database'
+    | '/admin/internal-s3'
+    | '/superadmin/logs'
+    | typeof HARNESS_AUTH_ADMIN_PATH
+    | '/superadmin/cli-access'
+    | '/admin/models'
+    | '/admin/core-agents'
+    | '/admin/metadata'
+    | '/admin/email-server'
+    | '/admin/limits'
+    | '/admin/messages'
+    | '/admin/backup'
+    | '/admin/users'
+    | '/admin/custom-css'
+    | '/admin/custom-js'
+    | '/admin/images'
+    | '/admin/files'
+    | '/admin/projects'
+    | '/admin/login-methods/shibboleth#setup-instructions'
+    | '/admin/login-methods/shibboleth'
+    | '/admin/usage'
+    | '/admin/task-manager'
+    | '/superadmin/task-manager'
+    | '/admin/chat-history'
+    | '/admin/chat-feedback'
+    | '/admin/api-tokens'
+    | '/swagger'
+    | '/admin/browser-test'
+    | '/admin/voice-input-test'
+    | '/admin/transcriptions'
+    | '/admin/search-engine-test'
+    | '/admin/error-simulation'
+    | '/experiments/story';
+
 /**
  * Input required to build the System dropdown tree.
  *
@@ -56,7 +159,17 @@ type BuildHeaderSystemMenuItemsOptions = {
     readonly isExperimental: boolean;
     readonly feedbackMode: ChatFeedbackMode;
     readonly shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
-    readonly resourceMonitorWarningStatus?: ServerResourceWarningStatus;
+    readonly systemWarnings?: HeaderSystemWarnings;
+};
+
+/**
+ * Shared warning-free fallback for callers that only need the static System menu structure.
+ *
+ * @private constant of Header
+ */
+const EMPTY_HEADER_SYSTEM_WARNINGS: HeaderSystemWarnings = {
+    warnings: [],
+    isSystemWarningShown: false,
 };
 
 /**
@@ -65,13 +178,65 @@ type BuildHeaderSystemMenuItemsOptions = {
 const SYSTEM_CATEGORY_ICON_MAP: Record<SystemCategoryLabel, LucideIcon> = {
     'My Account': UserRound,
     Utilities: Wrench,
-    'Super Admin': Settings2,
-    Administration: Settings2,
-    'Login Methods': KeyRound,
+    'Super Admin': Crown,
+    Administration: Building2,
+    'Login Methods': LogIn,
     'Monitoring & Usage': BarChart3,
-    'Integrations & Keys': KeyRound,
-    'Developer / Debug': Code2,
-    'Legal & About': Globe2,
+    'Integrations & Keys': PlugZap,
+    'Developer / Debug': Bug,
+    'Legal & About': Scale,
+};
+
+/**
+ * Dedicated icon used for each System dropdown leaf entry.
+ */
+const SYSTEM_MENU_ICON_BY_HREF: Record<SystemMenuItemHref, LucideIcon> = {
+    '/system/settings': SlidersHorizontal,
+    '/system/profile': UserCircle,
+    '/system/user-memory': Brain,
+    '/system/user-wallet': WalletCards,
+    '/system/utilities': MousePointerClick,
+    '/system/utilities/mocked-chats': MessageSquareText,
+    '/admin/about': BadgeInfo,
+    'https://ptbk.io/': Home,
+    '/superadmin/servers': Server,
+    '/superadmin/environment': FileCode2,
+    '/superadmin/email-server': Mails,
+    '/superadmin/resource-monitor': Activity,
+    '/superadmin/update': RefreshCw,
+    '/superadmin/database': Database,
+    '/admin/internal-s3': Boxes,
+    '/superadmin/logs': ScrollText,
+    [HARNESS_AUTH_ADMIN_PATH]: TerminalSquare,
+    '/superadmin/cli-access': Terminal,
+    '/admin/models': Bot,
+    '/admin/core-agents': Blocks,
+    '/admin/metadata': FileJson,
+    '/admin/email-server': MailCheck,
+    '/admin/limits': Gauge,
+    '/admin/messages': Mail,
+    '/admin/backup': Archive,
+    '/admin/users': Users,
+    '/admin/custom-css': Paintbrush,
+    '/admin/custom-js': FileCode,
+    '/admin/images': Images,
+    '/admin/files': FileStack,
+    '/admin/projects': FolderKanban,
+    '/admin/login-methods/shibboleth#setup-instructions': Shield,
+    '/admin/login-methods/shibboleth': ShieldCheck,
+    '/admin/usage': ChartNoAxesColumn,
+    '/admin/task-manager': ClipboardList,
+    '/superadmin/task-manager': ServerCog,
+    '/admin/chat-history': History,
+    '/admin/chat-feedback': MessageCircle,
+    '/admin/api-tokens': KeyRound,
+    '/swagger': FileSearch,
+    '/admin/browser-test': Globe2,
+    '/admin/voice-input-test': Mic,
+    '/admin/transcriptions': FileAudio,
+    '/admin/search-engine-test': Search,
+    '/admin/error-simulation': FlaskConical,
+    '/experiments/story': Star,
 };
 
 /**
@@ -90,24 +255,51 @@ const SYSTEM_CATEGORY_TRANSLATION_KEY_MAP: Record<SystemCategoryLabel, ServerTra
 };
 
 /**
- * Propagates one fallback icon to submenu entries that do not specify their own icon.
+ * Checks whether a href is one of the System dropdown routes with a dedicated icon.
  */
-function applyFallbackSubMenuIcon(
+function isSystemMenuItemHref(href: string): href is SystemMenuItemHref {
+    return Object.prototype.hasOwnProperty.call(SYSTEM_MENU_ICON_BY_HREF, href);
+}
+
+/**
+ * Resolves the icon for one System submenu entry.
+ */
+function resolveSystemSubMenuIcon(
+    item: SubMenuItem,
+    fallbackIcon: NonNullable<SubMenuItem['icon']>,
+): NonNullable<SubMenuItem['icon']> {
+    if (item.icon) {
+        return item.icon;
+    }
+
+    if (item.href && isSystemMenuItemHref(item.href)) {
+        return SYSTEM_MENU_ICON_BY_HREF[item.href];
+    }
+
+    return fallbackIcon;
+}
+
+/**
+ * Adds a stable icon to each System submenu entry without repeating icon assignments in every item literal.
+ */
+function applySystemSubMenuIcons(
     items: ReadonlyArray<SubMenuItem>,
     fallbackIcon: NonNullable<SubMenuItem['icon']>,
 ): SubMenuItem[] {
     return items.map((item) => {
-        const resolvedIcon = item.icon ?? fallbackIcon;
+        const resolvedIcon = resolveSystemSubMenuIcon(item, fallbackIcon);
         return {
             ...item,
             icon: resolvedIcon,
-            items: item.items ? applyFallbackSubMenuIcon(item.items, resolvedIcon) : item.items,
+            items: item.items ? applySystemSubMenuIcons(item.items, resolvedIcon) : item.items,
         };
     });
 }
 
 /**
- * Decorates a menu label with the warning indicator used for misconfigured login methods.
+ * Decorates a System menu label with the shared warning indicator.
+ *
+ * @private function of Header
  */
 function createWarningMenuLabel(label: string) {
     return createElement(
@@ -121,8 +313,32 @@ function createWarningMenuLabel(label: string) {
     );
 }
 
+/**
+ * Decorates every System menu entry whose destination currently has a visible warning.
+ *
+ * The warning registry owns the route-to-warning mapping, so adding another operational warning
+ * does not require scattered leaf-label conditionals throughout this menu tree.
+ *
+ * @private function of Header
+ */
+function applySystemSubMenuWarnings(
+    items: ReadonlyArray<SubMenuItem>,
+    systemWarnings: HeaderSystemWarnings,
+): SubMenuItem[] {
+    return items.map((item) => ({
+        ...item,
+        label:
+            item.href && typeof item.label === 'string' && isHeaderSystemWarningShownForHref(systemWarnings, item.href)
+                ? createWarningMenuLabel(item.label)
+                : item.label,
+        items: item.items ? applySystemSubMenuWarnings(item.items, systemWarnings) : item.items,
+    }));
+}
+
 /**
  * Creates one category entry inside the System dropdown when there are items to show.
+ *
+ * @private function of Header
  */
 function createSystemCategory(
     label: SystemCategoryLabel,
@@ -141,7 +357,7 @@ function createSystemCategory(
                 ? createWarningMenuLabel(translate(SYSTEM_CATEGORY_TRANSLATION_KEY_MAP[label]))
                 : translate(SYSTEM_CATEGORY_TRANSLATION_KEY_MAP[label]),
             icon: categoryIcon,
-            items: applyFallbackSubMenuIcon(items, categoryIcon),
+            items: applySystemSubMenuIcons(items, categoryIcon),
         },
     ];
 }
@@ -159,7 +375,7 @@ export function buildHeaderSystemMenuItems({
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
-    resourceMonitorWarningStatus,
+    systemWarnings = EMPTY_HEADER_SYSTEM_WARNINGS,
 }: BuildHeaderSystemMenuItemsOptions): SubMenuItem[] {
     const userAccountSystemItems: SubMenuItem[] = [
         {
@@ -222,46 +438,49 @@ export function buildHeaderSystemMenuItems({
         ];
     }
 
-    const isResourceMonitorWarningShown = Boolean(isGlobalAdmin && resourceMonitorWarningStatus?.isWarningShown);
     const superAdminSystemItems: SubMenuItem[] = [
         {
             label: translate('header.servers'),
-            href: '/admin/servers',
+            href: '/superadmin/servers',
             isBold: true,
         },
         {
             label: translate('header.environmentVariables'),
-            href: '/admin/environment',
+            href: '/superadmin/environment',
         },
         ...(isGlobalAdmin
             ? [
                   {
-                      label: isResourceMonitorWarningShown
-                          ? createWarningMenuLabel(translate('header.resourceMonitor'))
-                          : translate('header.resourceMonitor'),
-                      href: '/admin/resource-monitor',
-                      icon: Activity,
+                      label: translate('header.vpsEmailServer'),
+                      href: '/superadmin/email-server',
+                  } as SubMenuItem,
+                  {
+                      label: translate('header.resourceMonitor'),
+                      href: '/superadmin/resource-monitor',
                   } as SubMenuItem,
                   {
                       label: translate('header.update'),
-                      href: '/admin/update',
-                      icon: RefreshCw,
+                      href: '/superadmin/update',
                   } as SubMenuItem,
                   {
                       label: translate('header.database'),
-                      href: '/admin/database',
+                      href: '/superadmin/database',
+                  } as SubMenuItem,
+                  {
+                      label: translate('header.internalS3'),
+                      href: '/admin/internal-s3',
                   } as SubMenuItem,
                   {
                       label: translate('header.logs'),
-                      href: '/admin/logs',
+                      href: '/superadmin/logs',
                   } as SubMenuItem,
                   {
-                      label: translate('header.codeRunners'),
-                      href: '/admin/code-runners',
+                      label: translate('header.harnessAuth'),
+                      href: HARNESS_AUTH_ADMIN_PATH,
                   } as SubMenuItem,
                   {
                       label: translate('header.cliAccess'),
-                      href: '/admin/cli-access',
+                      href: '/superadmin/cli-access',
                   } as SubMenuItem,
               ]
             : []),
@@ -272,10 +491,18 @@ export function buildHeaderSystemMenuItems({
             label: translate('header.models'),
             href: '/admin/models',
         },
+        {
+            label: translate('header.coreAgents'),
+            href: '/admin/core-agents',
+        },
         {
             label: translate('header.metadata'),
             href: '/admin/metadata',
         },
+        {
+            label: translate('header.emailServer'),
+            href: '/admin/email-server',
+        },
         {
             label: translate('header.toolLimits'),
             href: '/admin/limits',
@@ -311,21 +538,19 @@ export function buildHeaderSystemMenuItems({
             label: translate('header.files'),
             href: '/admin/files',
         },
+        {
+            label: translate('header.agentProjects'),
+            href: '/admin/projects',
+        },
     ];
 
-    const isShibbolethConfigurationWarningShown = Boolean(
-        shibbolethAuthenticationStatus?.isActive && !shibbolethAuthenticationStatus.isConfigured,
-    );
     const loginMethodsSystemItems: SubMenuItem[] = shibbolethAuthenticationStatus?.isActive
         ? [
               {
-                  label: isShibbolethConfigurationWarningShown
-                      ? createWarningMenuLabel(translate('header.shibboleth'))
-                      : translate('header.shibboleth'),
-                  href: isShibbolethConfigurationWarningShown
+                  label: translate('header.shibboleth'),
+                  href: isHeaderSystemWarningShownForHref(systemWarnings, '/admin/login-methods/shibboleth')
                       ? '/admin/login-methods/shibboleth#setup-instructions'
                       : '/admin/login-methods/shibboleth',
-                  icon: ShieldCheck,
               },
           ]
         : [];
@@ -339,6 +564,14 @@ export function buildHeaderSystemMenuItems({
             label: translate('header.taskManager'),
             href: '/admin/task-manager',
         },
+        ...(isGlobalAdmin
+            ? [
+                  {
+                      label: translate('header.vpsTaskManager'),
+                      href: '/superadmin/task-manager',
+                  } as SubMenuItem,
+              ]
+            : []),
         {
             label: translate('header.chatHistory'),
             href: '/admin/chat-history',
@@ -396,20 +629,33 @@ export function buildHeaderSystemMenuItems({
             : []),
     ];
 
+    const applyWarnings = (items: ReadonlyArray<SubMenuItem>): SubMenuItem[] =>
+        applySystemSubMenuWarnings(items, systemWarnings);
+
     return [
-        ...createSystemCategory('My Account', userAccountSystemItems, translate),
-        ...createSystemCategory('Utilities', utilitiesSystemItems, translate),
-        ...createSystemCategory('Super Admin', superAdminSystemItems, translate, isResourceMonitorWarningShown),
-        ...createSystemCategory('Administration', administrationSystemItems, translate),
+        ...createSystemCategory('My Account', applyWarnings(userAccountSystemItems), translate),
+        ...createSystemCategory('Utilities', applyWarnings(utilitiesSystemItems), translate),
+        ...createSystemCategory(
+            'Super Admin',
+            applyWarnings(superAdminSystemItems),
+            translate,
+            isHeaderSystemWarningShownForCategory(systemWarnings, 'Super Admin'),
+        ),
+        ...createSystemCategory(
+            'Administration',
+            applyWarnings(administrationSystemItems),
+            translate,
+            isHeaderSystemWarningShownForCategory(systemWarnings, 'Administration'),
+        ),
         ...createSystemCategory(
             'Login Methods',
-            loginMethodsSystemItems,
+            applyWarnings(loginMethodsSystemItems),
             translate,
-            isShibbolethConfigurationWarningShown,
+            isHeaderSystemWarningShownForCategory(systemWarnings, 'Login Methods'),
         ),
-        ...createSystemCategory('Monitoring & Usage', monitoringAndUsageSystemItems, translate),
-        ...createSystemCategory('Integrations & Keys', integrationsAndKeysSystemItems, translate),
-        ...createSystemCategory('Developer / Debug', developerDebugSystemItems, translate),
-        ...createSystemCategory('Legal & About', legalAndAboutSystemItems, translate),
+        ...createSystemCategory('Monitoring & Usage', applyWarnings(monitoringAndUsageSystemItems), translate),
+        ...createSystemCategory('Integrations & Keys', applyWarnings(integrationsAndKeysSystemItems), translate),
+        ...createSystemCategory('Developer / Debug', applyWarnings(developerDebugSystemItems), translate),
+        ...createSystemCategory('Legal & About', applyWarnings(legalAndAboutSystemItems), translate),
     ];
 }

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

@@ -1,4 +1,11 @@
-import { Clock3Icon, FileTextIcon, MessageSquareIcon, MoreHorizontalIcon, NotebookPenIcon } from 'lucide-react';
+import {
+    Clock3Icon,
+    FileTextIcon,
+    FolderKanbanIcon,
+    MessageSquareIcon,
+    MoreHorizontalIcon,
+    NotebookPenIcon,
+} from 'lucide-react';
 import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys';
 
 /**
@@ -6,7 +13,7 @@ import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys
  *
  * @private type of Header
  */
-export type AgentHierarchyView = 'Profile' | 'Chat' | 'Book' | 'Timeouts' | 'More';
+export type AgentHierarchyView = 'Profile' | 'Chat' | 'Book' | 'Timeouts' | 'Projects' | 'More';
 
 /**
  * Icon displayed next to each hierarchy view label.
@@ -16,6 +23,7 @@ const AGENT_VIEW_ICON_MAP: Record<AgentHierarchyView, typeof FileTextIcon> = {
     Chat: MessageSquareIcon,
     Book: NotebookPenIcon,
     Timeouts: Clock3Icon,
+    Projects: FolderKanbanIcon,
     More: MoreHorizontalIcon,
 };
 
@@ -27,6 +35,7 @@ const AGENT_VIEW_TRANSLATION_KEY_MAP: Record<AgentHierarchyView, ServerTranslati
     Chat: 'common.chat',
     Book: 'common.book',
     Timeouts: 'common.timeouts',
+    Projects: 'common.projects',
     More: 'common.more',
 };
 

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

@@ -45,6 +45,10 @@ function resolveAgentHierarchyView(segment: string | undefined): AgentHierarchyV
         return 'Timeouts';
     }
 
+    if (segment === 'projects') {
+        return 'Projects';
+    }
+
     return 'More';
 }