@promptbook/cli 0.114.0-0 → 0.114.0-10

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

@@ -37,6 +37,7 @@ import {
     MousePointerClick,
     Paintbrush,
     PlugZap,
+    RefreshCcw,
     RefreshCw,
     Scale,
     ScrollText,
@@ -63,6 +64,7 @@ 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 { isHeaderSystemActivityShownForHref, type HeaderSystemActivities } from './resolveHeaderSystemActivities';
 import {
     isHeaderSystemWarningShownForCategory,
     isHeaderSystemWarningShownForHref,
@@ -160,6 +162,7 @@ type BuildHeaderSystemMenuItemsOptions = {
     readonly feedbackMode: ChatFeedbackMode;
     readonly shibbolethAuthenticationStatus?: ShibbolethAuthenticationMenuStatus;
     readonly systemWarnings?: HeaderSystemWarnings;
+    readonly systemActivities?: HeaderSystemActivities;
 };
 
 /**
@@ -172,6 +175,15 @@ const EMPTY_HEADER_SYSTEM_WARNINGS: HeaderSystemWarnings = {
     isSystemWarningShown: false,
 };
 
+/**
+ * Shared activity-free fallback for callers that only need the static System menu structure.
+ *
+ * @private constant of Header
+ */
+const EMPTY_HEADER_SYSTEM_ACTIVITIES: HeaderSystemActivities = {
+    activities: [],
+};
+
 /**
  * Default icon used for each System dropdown category.
  */
@@ -297,42 +309,104 @@ function applySystemSubMenuIcons(
 }
 
 /**
- * Decorates a System menu label with the shared warning indicator.
+ * Kinds of status indicator that can decorate a System menu label.
+ *
+ * @private type of Header
+ */
+type SystemMenuIndicatorKind = 'warning' | 'activity';
+
+/**
+ * Visual definition of one System menu status indicator.
+ *
+ * @private type of Header
+ */
+type SystemMenuIndicatorDefinition = {
+    /**
+     * Icon rendered after the menu label.
+     */
+    readonly icon: LucideIcon;
+
+    /**
+     * Utility classes applied to the indicator icon.
+     */
+    readonly className: string;
+
+    /**
+     * Accessible description of the indicated state.
+     */
+    readonly ariaLabel: string;
+};
+
+/**
+ * Look of every System menu status indicator, kept in one place so labels never style icons themselves.
+ *
+ * @private constant of Header
+ */
+const SYSTEM_MENU_INDICATOR_DEFINITIONS: Record<SystemMenuIndicatorKind, SystemMenuIndicatorDefinition> = {
+    warning: {
+        icon: TriangleAlert,
+        className: 'h-4 w-4 text-amber-500',
+        ariaLabel: 'Warning',
+    },
+    activity: {
+        icon: RefreshCcw,
+        className: 'h-4 w-4 animate-spin text-blue-500',
+        ariaLabel: 'Running',
+    },
+};
+
+/**
+ * Resolves which indicator, if any, one System menu destination currently shows.
+ *
+ * @private type of Header
+ */
+type SystemMenuIndicatorResolver = (href: string) => SystemMenuIndicatorKind | null;
+
+/**
+ * Decorates a System menu label with one shared status indicator.
  *
  * @private function of Header
  */
-function createWarningMenuLabel(label: string) {
+function createIndicatorMenuLabel(label: string, indicatorKind: SystemMenuIndicatorKind) {
+    const indicator = SYSTEM_MENU_INDICATOR_DEFINITIONS[indicatorKind];
+
     return createElement(
         'span',
         { className: 'inline-flex items-center gap-2' },
         label,
-        createElement(TriangleAlert, {
-            className: 'h-4 w-4 text-amber-500',
-            'aria-label': 'Warning',
+        createElement(indicator.icon, {
+            className: indicator.className,
+            'aria-label': indicator.ariaLabel,
         }),
     );
 }
 
 /**
- * Decorates every System menu entry whose destination currently has a visible warning.
+ * Decorates every System menu entry whose destination currently has a visible status indicator.
  *
- * 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.
+ * The warning and activity registries own the route-to-indicator mapping, so adding another
+ * operational state does not require scattered leaf-label conditionals throughout this menu tree.
  *
  * @private function of Header
  */
-function applySystemSubMenuWarnings(
+function applySystemSubMenuIndicators(
     items: ReadonlyArray<SubMenuItem>,
-    systemWarnings: HeaderSystemWarnings,
+    resolveIndicatorKind: SystemMenuIndicatorResolver,
 ): 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,
-    }));
+    return items.map((item) => {
+        const decoratedItems = item.items ? applySystemSubMenuIndicators(item.items, resolveIndicatorKind) : item.items;
+
+        if (!item.href || typeof item.label !== 'string') {
+            return { ...item, items: decoratedItems };
+        }
+
+        const indicatorKind = resolveIndicatorKind(item.href);
+        return {
+            ...item,
+            label: indicatorKind ? createIndicatorMenuLabel(item.label, indicatorKind) : item.label,
+            items: decoratedItems,
+        };
+    });
 }
 
 /**
@@ -354,7 +428,7 @@ function createSystemCategory(
     return [
         {
             label: isWarningShown
-                ? createWarningMenuLabel(translate(SYSTEM_CATEGORY_TRANSLATION_KEY_MAP[label]))
+                ? createIndicatorMenuLabel(translate(SYSTEM_CATEGORY_TRANSLATION_KEY_MAP[label]), 'warning')
                 : translate(SYSTEM_CATEGORY_TRANSLATION_KEY_MAP[label]),
             icon: categoryIcon,
             items: applySystemSubMenuIcons(items, categoryIcon),
@@ -376,6 +450,7 @@ export function buildHeaderSystemMenuItems({
     feedbackMode,
     shibbolethAuthenticationStatus,
     systemWarnings = EMPTY_HEADER_SYSTEM_WARNINGS,
+    systemActivities = EMPTY_HEADER_SYSTEM_ACTIVITIES,
 }: BuildHeaderSystemMenuItemsOptions): SubMenuItem[] {
     const userAccountSystemItems: SubMenuItem[] = [
         {
@@ -629,33 +704,46 @@ export function buildHeaderSystemMenuItems({
             : []),
     ];
 
-    const applyWarnings = (items: ReadonlyArray<SubMenuItem>): SubMenuItem[] =>
-        applySystemSubMenuWarnings(items, systemWarnings);
+    // Note: A warning always wins over a running activity, so a menu entry which needs administrator
+    //       attention is never hidden behind the progress of a background job.
+    const resolveIndicatorKind: SystemMenuIndicatorResolver = (href) => {
+        if (isHeaderSystemWarningShownForHref(systemWarnings, href)) {
+            return 'warning';
+        }
+
+        if (isHeaderSystemActivityShownForHref(systemActivities, href)) {
+            return 'activity';
+        }
+
+        return null;
+    };
+    const applyIndicators = (items: ReadonlyArray<SubMenuItem>): SubMenuItem[] =>
+        applySystemSubMenuIndicators(items, resolveIndicatorKind);
 
     return [
-        ...createSystemCategory('My Account', applyWarnings(userAccountSystemItems), translate),
-        ...createSystemCategory('Utilities', applyWarnings(utilitiesSystemItems), translate),
+        ...createSystemCategory('My Account', applyIndicators(userAccountSystemItems), translate),
+        ...createSystemCategory('Utilities', applyIndicators(utilitiesSystemItems), translate),
         ...createSystemCategory(
             'Super Admin',
-            applyWarnings(superAdminSystemItems),
+            applyIndicators(superAdminSystemItems),
             translate,
             isHeaderSystemWarningShownForCategory(systemWarnings, 'Super Admin'),
         ),
         ...createSystemCategory(
             'Administration',
-            applyWarnings(administrationSystemItems),
+            applyIndicators(administrationSystemItems),
             translate,
             isHeaderSystemWarningShownForCategory(systemWarnings, 'Administration'),
         ),
         ...createSystemCategory(
             'Login Methods',
-            applyWarnings(loginMethodsSystemItems),
+            applyIndicators(loginMethodsSystemItems),
             translate,
             isHeaderSystemWarningShownForCategory(systemWarnings, 'Login Methods'),
         ),
-        ...createSystemCategory('Monitoring & Usage', applyWarnings(monitoringAndUsageSystemItems), translate),
-        ...createSystemCategory('Integrations & Keys', applyWarnings(integrationsAndKeysSystemItems), translate),
-        ...createSystemCategory('Developer / Debug', applyWarnings(developerDebugSystemItems), translate),
-        ...createSystemCategory('Legal & About', applyWarnings(legalAndAboutSystemItems), translate),
+        ...createSystemCategory('Monitoring & Usage', applyIndicators(monitoringAndUsageSystemItems), translate),
+        ...createSystemCategory('Integrations & Keys', applyIndicators(integrationsAndKeysSystemItems), translate),
+        ...createSystemCategory('Developer / Debug', applyIndicators(developerDebugSystemItems), translate),
+        ...createSystemCategory('Legal & About', applyIndicators(legalAndAboutSystemItems), translate),
     ];
 }

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

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

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

@@ -41,8 +41,8 @@ function resolveAgentHierarchyView(segment: string | undefined): AgentHierarchyV
         return 'Book';
     }
 
-    if (segment === 'timeouts') {
-        return 'Timeouts';
+    if (segment === 'goal') {
+        return 'Goal';
     }
 
     if (segment === 'projects') {

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

@@ -0,0 +1,86 @@
+/**
+ * System-menu hrefs that can display a running-activity indicator.
+ *
+ * @private type of Header
+ */
+type HeaderSystemActivityHref = '/superadmin/update';
+
+/**
+ * One resolved background activity together with the System-menu location it decorates.
+ *
+ * @private type of Header
+ */
+type HeaderSystemActivity = {
+    /**
+     * Fragment-free href of the System menu item to decorate.
+     */
+    readonly href: HeaderSystemActivityHref;
+
+    /**
+     * Whether the current viewer is permitted to see this activity.
+     */
+    readonly isShown: boolean;
+};
+
+/**
+ * Inputs needed to decide which System activities the current viewer is allowed to see.
+ *
+ * @private type of Header
+ */
+export type ResolveHeaderSystemActivitiesOptions = {
+    /**
+     * Whether the current viewer is the environment-backed super-admin.
+     */
+    readonly isGlobalAdmin: boolean;
+
+    /**
+     * Whether a standalone VPS self-update is running right now.
+     */
+    readonly isSelfUpdateRunning?: boolean;
+};
+
+/**
+ * Visibility of the currently running System activities.
+ *
+ * @private type of Header
+ */
+export type HeaderSystemActivities = {
+    /**
+     * Individual activities keyed by their System-menu destination.
+     */
+    readonly activities: ReadonlyArray<HeaderSystemActivity>;
+};
+
+/**
+ * Resolves the complete running-activity registry for the current System menu.
+ *
+ * Mirrors the warning registry: each activity defines both its visibility policy and its menu
+ * destination in one place, so operational progress never leaks to viewers who may not see the
+ * matching administration page.
+ *
+ * @private function of Header
+ */
+export function resolveHeaderSystemActivities({
+    isGlobalAdmin,
+    isSelfUpdateRunning = false,
+}: ResolveHeaderSystemActivitiesOptions): HeaderSystemActivities {
+    return {
+        activities: [
+            {
+                href: '/superadmin/update',
+                isShown: Boolean(isGlobalAdmin && isSelfUpdateRunning),
+            },
+        ],
+    };
+}
+
+/**
+ * Checks whether a System menu href should display its running-activity indicator.
+ *
+ * @private function of Header
+ */
+export function isHeaderSystemActivityShownForHref(activities: HeaderSystemActivities, href: string): boolean {
+    const hrefWithoutFragment = href.split('#', 1)[0];
+
+    return activities.activities.some((activity) => activity.href === hrefWithoutFragment && activity.isShown);
+}

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

@@ -6,7 +6,6 @@ import Link from 'next/link';
 import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
 import type { AgentVisibility } from '../../utils/agentVisibility';
 import {
-    AGENT_CARD_HIDDEN_CAPABILITY_TYPES,
     AgentCapabilityChips,
     HOMEPAGE_CAPABILITY_CHIPS_LIMIT,
 } from '../AgentProfile/AgentCapabilityChips';
@@ -157,7 +156,6 @@ export function AgentCard({
                             <AgentCapabilityChips
                                 agent={agent}
                                 className="mt-2"
-                                hiddenCapabilityTypes={AGENT_CARD_HIDDEN_CAPABILITY_TYPES}
                                 maxChips={HOMEPAGE_CAPABILITY_CHIPS_LIMIT}
                                 size="compact"
                             />
@@ -207,7 +205,6 @@ export function AgentCard({
                             <AgentCapabilityChips
                                 agent={agent}
                                 className="mt-2"
-                                hiddenCapabilityTypes={AGENT_CARD_HIDDEN_CAPABILITY_TYPES}
                                 maxChips={HOMEPAGE_CAPABILITY_CHIPS_LIMIT}
                                 size="compact"
                             />

package/apps/agents-server/src/components/Homepage/useAgentsListImportExportState.ts

@@ -2,6 +2,7 @@
 
 import JSZip from 'jszip';
 import { useCallback, useRef, useState, type DragEvent } from 'react';
+import { spaceTrim } from 'spacetrim';
 import { downloadBlob, parseFilenameFromContentDisposition } from '../../utils/download/browserFileDownload';
 import { showAlert, showConfirm, showPrompt } from '../AsyncDialogs/asyncDialogs';
 
@@ -323,7 +324,10 @@ async function uploadAgentsImportFiles(options: {
         formData.append(FILES_FORM_FIELD, file);
     }
 
-    formData.append(TARGET_FOLDER_ID_FORM_FIELD, options.targetFolderId === null ? 'null' : String(options.targetFolderId));
+    formData.append(
+        TARGET_FOLDER_ID_FORM_FIELD,
+        options.targetFolderId === null ? 'null' : String(options.targetFolderId),
+    );
     formData.append(CONFLICT_RESOLUTION_FORM_FIELD, options.conflictResolution);
 
     return fetch(AGENTS_IMPORT_ENDPOINT, {
@@ -392,11 +396,16 @@ async function promptAgentsImportConflictResolution(
 ): Promise<Exclude<AgentsImportConflictResolution, 'ASK'> | null> {
     const decision = await showPrompt({
         title: 'Duplicate agents',
-        message: [
-            'Some dropped books have the same agent name as existing agents but different book source.',
-            'Type `duplicate` to import them as additional agents, or `skip` to skip the conflicting books.',
-            createWarningListMessage(conflicts.map((conflict) => `${conflict.agentName}: ${conflict.path}`)),
-        ].join('\n\n'),
+        message: spaceTrim(
+            (block) => `
+                Some dropped books have the same agent name as existing agents but different book source.
+                Type \`duplicate\` to import them as additional agents, or \`skip\` to skip the conflicting books.
+
+                ${block(
+                    createWarningListMessage(conflicts.map((conflict) => `${conflict.agentName}: ${conflict.path}`)),
+                )}
+            `,
+        ),
         inputLabel: 'Decision',
         defaultValue: 'skip',
         placeholder: 'duplicate or skip',
@@ -437,10 +446,13 @@ async function confirmNonBookZipEntries(files: ReadonlyArray<File>): Promise<boo
 
     return showConfirm({
         title: 'Import agents',
-        message: [
-            'The ZIP archive contains files that are not `.book` files. They will be ignored.',
-            createWarningListMessage(nonBookZipEntryPaths),
-        ].join('\n\n'),
+        message: spaceTrim(
+            (block) => `
+                The ZIP archive contains files that are not \`.book\` files. They will be ignored.
+
+                ${block(createWarningListMessage(nonBookZipEntryPaths))}
+            `,
+        ),
         confirmLabel: 'Import agents',
         cancelLabel: 'Cancel',
     }).catch(() => false);

package/apps/agents-server/src/components/LayoutWrapper/LayoutWrapper.tsx

@@ -86,6 +86,10 @@ type LayoutWrapperProps = {
      * Whether active self-contained S3 storage needs super-admin attention.
      */
     readonly isInternalS3WarningShown: boolean;
+    /**
+     * Whether a standalone VPS self-update is running right now.
+     */
+    readonly isSelfUpdateRunning: boolean;
     /**
      * Indicates if the install-as-app option should be shown in agent menus.
      */
@@ -139,6 +143,7 @@ export function LayoutWrapper({
     isVpsEmailServerWarningShown,
     isServersDnsWarningShown,
     isInternalS3WarningShown,
+    isSelfUpdateRunning,
     isExperimentalPwaAppEnabled,
     controlPanelOptionAvailability,
     defaultIsSoundsOn,
@@ -250,6 +255,9 @@ export function LayoutWrapper({
                                                                                         isInternalS3WarningShown={
                                                                                             isInternalS3WarningShown
                                                                                         }
+                                                                                        isSelfUpdateRunning={
+                                                                                            isSelfUpdateRunning
+                                                                                        }
                                                                                     />
                                                                                     <main className={mainClassName}>
                                                                                         <HomepageOptimisticNavigation

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/components/ManGoBookEditor.tsx

@@ -0,0 +1,82 @@
+'use client';
+
+import type { string_book } from '../../../../../../../src/book-2.0/agent-source/string_book';
+import { BookEditor } from '../../../../../../../src/book-components/BookEditor/BookEditor';
+import { BOOK_SECTION_PRESETS } from '../config/bookSections';
+import { insertBookContentBeforeLearningMarker } from '../lib/bookSource';
+import { Badge } from './ui/Badge';
+import { Button } from './ui/Button';
+
+/**
+ * Props for the editable manGo Book editor.
+ */
+type ManGoBookEditorProps = {
+    readonly value: string;
+    readonly onChange: (value: string) => void;
+    readonly onRegenerate?: () => void;
+    readonly isRegenerating?: boolean;
+};
+
+/**
+ * Renders the editable Book source and the Book-language section presets used by manGo.
+ *
+ * @param props - Current source and editor actions.
+ * @returns Editable Book editor with section controls.
+ */
+export function ManGoBookEditor({ value, onChange, onRegenerate, isRegenerating = false }: ManGoBookEditorProps) {
+    function addSection(section: string): void {
+        onChange(insertBookContentBeforeLearningMarker(value, [section]));
+    }
+
+    return (
+        <div>
+            <div className="overflow-hidden rounded-2xl border border-zinc-200 bg-white shadow-[var(--ob-shadow-md)]">
+                <div className="flex flex-wrap items-center justify-between gap-3 border-b border-zinc-200 bg-zinc-50/80 px-4 py-2.5">
+                    <span className="flex items-center gap-2 text-[13px] text-zinc-600">
+                        <span aria-hidden>📖</span>
+                        <strong className="font-semibold text-zinc-800">Book</strong>
+                        <span className="hidden sm:inline">
+                            <Badge tone="accent">Plně editovatelný</Badge>
+                        </span>
+                    </span>
+                    {onRegenerate && (
+                        <Button
+                            variant="ghost"
+                            size="sm"
+                            isLoading={isRegenerating}
+                            leadingIcon={<span aria-hidden>↻</span>}
+                            onClick={onRegenerate}
+                            title="Přegenerovat book ze zadání"
+                        >
+                            <span className="hidden md:inline">Přegenerovat</span>
+                        </Button>
+                    )}
+                </div>
+
+                <BookEditor
+                    value={value as string_book}
+                    onChange={(nextValue) => onChange(nextValue)}
+                    height="28rem"
+                    isBorderRadiusDisabled
+                    isVerbose={false}
+                />
+            </div>
+
+            <div className="mt-4">
+                <div className="mb-2 text-xs font-semibold text-zinc-500">Přidat sekci do booku:</div>
+                <div className="flex flex-wrap gap-2">
+                    {BOOK_SECTION_PRESETS.map((preset) => (
+                        <button
+                            key={preset.key}
+                            type="button"
+                            onClick={() => addSection(preset.book)}
+                            className="inline-flex items-center gap-1 rounded-full border border-dashed border-zinc-300 bg-white px-3 py-1.5 text-xs font-medium text-zinc-500 transition-colors hover:border-[color:var(--ob-accent-400)] hover:bg-[color:var(--ob-accent-50)] hover:text-[color:var(--ob-accent-700)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--ob-ring)]"
+                        >
+                            + {preset.label}
+                        </button>
+                    ))}
+                </div>
+            </div>
+        </div>
+    );
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/components/WizardShell.tsx

@@ -30,7 +30,7 @@ const ONBOARDING_DONE_PATH = ONBOARDING_FLOW.find((step) => step.id === 'done')?
  */
 type ClassicBookEditorButtonProps = {
     /**
-     * Opens the classic Book editor with the current draft.
+     * Opens the classic Book editor with the current Book.
      */
     readonly onOpenEditor: () => void;
 
@@ -107,7 +107,7 @@ export function WizardShell({ children, defaultVisibility, onOpenEditor }: Wizar
     const isClassicBookEditorButtonVisible = currentPath !== ONBOARDING_DONE_PATH;
 
     /**
-     * Opens the classic Book editor with the current manGo draft.
+     * Opens the classic Book editor with the current manGo Book.
      */
     function handleOpenEditor(): void {
         onOpenEditor(createManGoOpenEditorRequest(state, defaultVisibility));