@promptbook/cli 0.113.0-8 → 0.114.0-0

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

@@ -1,21 +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 {
+    isHeaderSystemWarningShownForCategory,
+    isHeaderSystemWarningShownForHref,
+    type HeaderSystemWarnings,
+} from './resolveHeaderSystemWarnings';
 import type { SubMenuItem } from './SubMenuItem';
 
 /**
@@ -41,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.
  *
@@ -54,6 +159,17 @@ type BuildHeaderSystemMenuItemsOptions = {
     readonly isExperimental: boolean;
     readonly feedbackMode: ChatFeedbackMode;
     readonly shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
+    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,
 };
 
 /**
@@ -62,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,
 };
 
 /**
@@ -87,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 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 applyFallbackSubMenuIcon(
+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(
@@ -118,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,
@@ -138,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),
         },
     ];
 }
@@ -156,6 +375,7 @@ export function buildHeaderSystemMenuItems({
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
+    systemWarnings = EMPTY_HEADER_SYSTEM_WARNINGS,
 }: BuildHeaderSystemMenuItemsOptions): SubMenuItem[] {
     const userAccountSystemItems: SubMenuItem[] = [
         {
@@ -221,35 +441,46 @@ export function buildHeaderSystemMenuItems({
     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: 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,
               ]
             : []),
@@ -260,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',
@@ -299,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,
               },
           ]
         : [];
@@ -327,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',
@@ -384,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),
-        ...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';
 }