@promptbook/cli 0.113.0-1 → 0.113.0-10

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/HeaderDesktopTopMenuNavigation.tsx

@@ -28,6 +28,26 @@ type HeaderDesktopTopMenuNavigationProps = {
     ) => ReactNode;
 };
 
+/**
+ * Renders a top-level menu label with its optional icon.
+ *
+ * @private function of Header
+ */
+function HeaderDesktopTopMenuItemLabel({ item }: { readonly item: MenuItem }) {
+    const ItemIcon = item.icon;
+
+    if (!ItemIcon) {
+        return item.label;
+    }
+
+    return (
+        <span className="inline-flex min-w-0 items-center gap-2">
+            <ItemIcon className="h-4 w-4 shrink-0 text-gray-500" aria-hidden />
+            <span className="min-w-0">{item.label}</span>
+        </span>
+    );
+}
+
 /**
  * Renders desktop-only top-level navigation entries shown to the right of the search slot.
  *
@@ -54,7 +74,7 @@ export function HeaderDesktopTopMenuNavigation({
                             href={item.href}
                             className="text-sm font-medium text-gray-600 hover:text-gray-900 transition-colors cursor-pointer"
                         >
-                            {item.label}
+                            <HeaderDesktopTopMenuItemLabel item={item} />
                         </HeadlessLink>
                     );
                 }
@@ -91,7 +111,7 @@ export function HeaderDesktopTopMenuNavigation({
                             onBlur={() => scheduleMenuClose(item.id, () => item.setIsOpen(false))}
                             aria-expanded={item.isOpen}
                         >
-                            {item.label}
+                            <HeaderDesktopTopMenuItemLabel item={item} />
                             <ChevronDown className="w-4 h-4" />
                         </button>
 

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

@@ -31,7 +31,7 @@ export function HeaderHomepageLink({
     onClick,
 }: HeaderHomepageLinkProps) {
     const compactServerName = serverName.split(' ')[0] || serverName;
-    const mergedLogoClassName = `h-6 w-6 shrink-0 object-contain sm:h-8 sm:w-8 ${logoClassName}`.trim();
+    const mergedLogoClassName = `h-6 w-6 shrink-0 object-contain sm:h-6 sm:w-6 ${logoClassName}`.trim();
     const mergedLabelClassName =
         `min-w-0 truncate text-base font-bold tracking-tight text-gray-900 dark:text-slate-100 ${labelClassName}`.trim();
 

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

@@ -758,6 +758,26 @@ type HeaderMobileDrawerMenuEntryProps = {
     readonly renderMobileNestedMenuItems: HeaderMobileDrawerNestedMenuRenderer;
 };
 
+/**
+ * Renders a top-level mobile menu label with its optional icon.
+ *
+ * @private function of HeaderMobileDrawer
+ */
+function HeaderMobileDrawerMenuItemLabel({ item }: { readonly item: MenuItem }) {
+    const ItemIcon = item.icon;
+
+    if (!ItemIcon) {
+        return item.label;
+    }
+
+    return (
+        <span className="inline-flex min-w-0 items-center gap-2">
+            <ItemIcon className="h-4 w-4 shrink-0 text-gray-500" aria-hidden />
+            <span className="min-w-0">{item.label}</span>
+        </span>
+    );
+}
+
 /**
  * Renders one top-level mobile menu item as either a direct link or a nested dropdown.
  *
@@ -776,7 +796,7 @@ function HeaderMobileDrawerMenuEntry({
                 className="block w-full rounded-lg px-3 py-2.5 text-left text-sm font-semibold text-gray-700 transition-colors hover:bg-gray-50 hover:text-blue-600 active:bg-gray-100"
                 onClick={closeMenu}
             >
-                {item.label}
+                <HeaderMobileDrawerMenuItemLabel item={item} />
             </HeadlessLink>
         );
     }
@@ -787,7 +807,7 @@ function HeaderMobileDrawerMenuEntry({
                 className={MOBILE_DRAWER_TOP_LEVEL_BUTTON_CLASSNAME}
                 onClick={() => item.setIsMobileOpen(!item.isMobileOpen)}
             >
-                {item.label}
+                <HeaderMobileDrawerMenuItemLabel item={item} />
                 <ChevronDown className={createHeaderMobileDrawerChevronClassName(item.isMobileOpen)} />
             </button>
             {item.isMobileOpen && (

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

@@ -1,8 +1,9 @@
-import type { ReactNode } from 'react';
+import type { ComponentType, ReactNode } from 'react';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
 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;
 };
 
 /**
@@ -73,6 +79,11 @@ type MenuItemBase = {
      * Unique identifier used for hover timers and shared actions.
      */
     readonly id: string;
+
+    /**
+     * Optional visual icon rendered before the menu label.
+     */
+    readonly icon?: ComponentType<{ className?: string }>;
 };
 
 /**

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/buildDocumentationDropdownItems.tsx

@@ -1,3 +1,75 @@
+import {
+    Asterisk,
+    BadgeCheck,
+    BellRing,
+    BookCopy,
+    BookMarked,
+    BookOpenText,
+    BookText,
+    BotMessageSquare,
+    Braces,
+    Brain,
+    Brush,
+    CalendarDays,
+    CircleGauge,
+    ClipboardCheck,
+    ClipboardList,
+    Clock3,
+    CodeXml,
+    Component,
+    ContactRound,
+    DatabaseZap,
+    DraftingCompass,
+    Eye,
+    FileArchive,
+    FileAudio,
+    FileCog,
+    FileInput,
+    FilePenLine,
+    FileQuestion,
+    FileText,
+    Fingerprint,
+    Flag,
+    FolderInput,
+    Gem,
+    Globe,
+    Goal,
+    Handshake,
+    History,
+    Image,
+    Languages,
+    Link,
+    ListChecks,
+    ListTree,
+    Lock,
+    Mail,
+    MapPin,
+    MessageCircle,
+    MessageSquare,
+    Mic,
+    MousePointerClick,
+    Network,
+    Palette,
+    PenLine,
+    Puzzle,
+    Radar,
+    ReceiptText,
+    Search,
+    Send,
+    Shield,
+    Sparkles,
+    SquareMousePointer,
+    Tags,
+    TerminalSquare,
+    TextCursorInput,
+    Trash2,
+    UsersRound,
+    WalletCards,
+    WandSparkles,
+    Waypoints,
+    Workflow,
+    type LucideIcon,
+} from 'lucide-react';
 import type { ReactNode } from 'react';
 import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys';
 import {
@@ -14,6 +86,93 @@ type DocumentationCommitmentGroup = {
     aliases: string[];
 };
 
+/**
+ * Dedicated icons for fixed Documentation dropdown entries.
+ */
+const DOCUMENTATION_OVERVIEW_ICON = BookOpenText;
+
+/**
+ * Dedicated icon for OpenAPI reference entry.
+ */
+const DOCUMENTATION_API_REFERENCE_ICON = Braces;
+
+/**
+ * Dedicated icon for the "All" Documentation submenu.
+ */
+const DOCUMENTATION_ALL_ICON = ListTree;
+
+/**
+ * Reusable unique icon pool assigned to commitment documentation entries in registry order.
+ */
+const DOCUMENTATION_COMMITMENT_ICONS: ReadonlyArray<LucideIcon> = [
+    Goal,
+    ListChecks,
+    Brain,
+    Handshake,
+    ContactRound,
+    BookText,
+    ClipboardCheck,
+    Languages,
+    Mic,
+    PenLine,
+    Brush,
+    FileText,
+    FilePenLine,
+    FileArchive,
+    FolderInput,
+    BotMessageSquare,
+    Component,
+    Image,
+    Palette,
+    TextCursorInput,
+    Link,
+    Globe,
+    Shield,
+    Eye,
+    FileCog,
+    FileAudio,
+    BadgeCheck,
+    BellRing,
+    MessageSquare,
+    Send,
+    MousePointerClick,
+    Puzzle,
+    Tags,
+    WalletCards,
+    DraftingCompass,
+    Trash2,
+    BookCopy,
+    Lock,
+    UsersRound,
+    Radar,
+    Search,
+    Sparkles,
+    Workflow,
+    Clock3,
+    MapPin,
+    CalendarDays,
+    Mail,
+    SquareMousePointer,
+    WandSparkles,
+    Network,
+    Fingerprint,
+    DatabaseZap,
+    Asterisk,
+    CircleGauge,
+    ClipboardList,
+    CodeXml,
+    FileInput,
+    FileQuestion,
+    Flag,
+    Gem,
+    History,
+    MessageCircle,
+    ReceiptText,
+    TerminalSquare,
+    Waypoints,
+    BookMarked,
+];
+
 /**
  * Creates a label node that reuses the existing alias styling.
  *
@@ -40,17 +199,49 @@ function createDocumentationCommitmentLabel(
     );
 }
 
+/**
+ * Assigns commitment documentation icons from one shared pool.
+ */
+function createDocumentationCommitmentIconByType(
+    groups: ReadonlyArray<DocumentationCommitmentGroup>,
+): ReadonlyMap<string, LucideIcon> {
+    const iconByType = new Map<string, LucideIcon>();
+
+    groups.forEach((group, index) => {
+        const icon = DOCUMENTATION_COMMITMENT_ICONS[index];
+        if (icon) {
+            iconByType.set(group.primary.type, icon);
+        }
+    });
+
+    return iconByType;
+}
+
+/**
+ * Resolves the icon for one commitment documentation entry.
+ */
+function resolveDocumentationCommitmentIcon(
+    group: DocumentationCommitmentGroup,
+    iconByType: ReadonlyMap<string, LucideIcon>,
+): LucideIcon {
+    return iconByType.get(group.primary.type) ?? FileQuestion;
+}
+
 /**
  * Maps a commitment group to a documentation submenu item.
  *
  * @param group Commitment metadata returned from the registry.
  * @returns Configured submenu item linking to the commitment page.
  */
-function createDocumentationCommitmentItem(group: DocumentationCommitmentGroup): SubMenuItem {
+function createDocumentationCommitmentItem(
+    group: DocumentationCommitmentGroup,
+    iconByType: ReadonlyMap<string, LucideIcon>,
+): SubMenuItem {
     const notice = getCommitmentNoticeMetadata(group.primary);
     const isLowVisibilityNotice = isLowVisibilityCommitmentNotice(notice);
 
     return {
+        icon: resolveDocumentationCommitmentIcon(group, iconByType),
         label: createDocumentationCommitmentLabel(
             group.primary,
             group.aliases,
@@ -76,27 +267,31 @@ export function buildDocumentationDropdownItems(
 ): SubMenuItem[] {
     const highlightedCommitments = groups.filter((group) => group.primary.isImportant);
     const remainingCommitments = groups.filter((group) => !group.primary.isImportant);
+    const iconByType = createDocumentationCommitmentIconByType(groups);
 
     const items: SubMenuItem[] = [
         {
+            icon: DOCUMENTATION_OVERVIEW_ICON,
             label: translate('header.documentationOverview'),
             href: '/docs',
             isBold: true,
             isBordered: true,
         },
         {
+            icon: DOCUMENTATION_API_REFERENCE_ICON,
             label: translate('header.documentationApiReference'),
             href: '/swagger',
             isBold: true,
             isBordered: true,
         },
-        ...highlightedCommitments.map(createDocumentationCommitmentItem),
+        ...highlightedCommitments.map((group) => createDocumentationCommitmentItem(group, iconByType)),
     ];
 
     if (remainingCommitments.length > 0) {
         items.push({
+            icon: DOCUMENTATION_ALL_ICON,
             label: translate('header.documentationAll'),
-            items: remainingCommitments.map(createDocumentationCommitmentItem),
+            items: remainingCommitments.map((group) => createDocumentationCommitmentItem(group, iconByType)),
         });
     }
 

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,
@@ -110,6 +115,7 @@ export function buildHeaderMenuItems({
         items.push(
             createHeaderDropdownMenuItem({
                 id: 'system',
+                icon: MonitorCog,
                 label: systemLabel,
                 items: systemMenuEntries,
                 isOpen: isSystemOpen,