@promptbook/cli 0.113.0-9 → 0.114.0-0

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/bookService.ts

@@ -1,21 +1,21 @@
-import { validateBook } from '../../../../../../../src/book-2.0/agent-source/string_book';
+import { postManGoOnboardingJson } from './postManGoOnboardingJson';
 
 /**
- * Boundary used by the imported Book language panel.
+ * Response returned by the manGo Book conversion endpoint.
  *
- * The Agents Server draft is already Book language, so conversion means validating the
- * current editable source and returning it unchanged.
+ * @private internal type of the manGo wizard book service.
+ */
+type ConvertToBookResponse = {
+    readonly book: string;
+    readonly isValid: boolean;
+};
+
+/**
+ * Boundary used by the imported Book language panel. Backed by the manGo book expert.
  *
  * @param input - Current Book editor content.
  * @returns Validated Book source and validation flag for the panel badge.
  */
 export async function convertToBook(input: string): Promise<{ book: string; isValid: boolean }> {
-    let isValid = true;
-    try {
-        validateBook(input);
-    } catch {
-        isValid = false;
-    }
-
-    return { book: input, isValid };
+    return postManGoOnboardingJson<ConvertToBookResponse>('/api/onboarding/book', { input });
 }

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/createManGoAgentSource.ts

@@ -72,7 +72,12 @@ function insertCommitmentsBeforeLearningMarker(source: string, commitments: Read
     const lines = source.replace(/\r\n/g, '\n').split('\n');
     let markerIndex = -1;
     for (let lineIndex = lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
-        const normalizedLine = lines[lineIndex].trim().toUpperCase();
+        const line = lines[lineIndex];
+        if (line === undefined) {
+            continue;
+        }
+
+        const normalizedLine = line.trim().toUpperCase();
         if (normalizedLine === 'OPEN' || normalizedLine === 'CLOSED') {
             markerIndex = lineIndex;
             break;

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/createManGoOpenEditorRequest.ts

@@ -0,0 +1,23 @@
+import type { AgentVisibility } from '../../../../utils/agentVisibility';
+import type { NewAgentOpenEditorRequest } from '../../NewAgentOpenEditorRequest';
+import type { OnboardingState } from '../types';
+import { createManGoAgentSource } from './createManGoAgentSource';
+
+/**
+ * Builds the classic Book editor payload from the current manGo onboarding state.
+ *
+ * @param state - Current imported wizard state.
+ * @param defaultVisibility - Metadata-backed default visibility for newly created agents.
+ * @returns Classic Book editor request carrying the current draft.
+ *
+ * @private internal utility of <ManGoNewAgentWizard/>.
+ */
+export function createManGoOpenEditorRequest(
+    state: OnboardingState,
+    defaultVisibility: AgentVisibility,
+): NewAgentOpenEditorRequest {
+    return {
+        agentSource: createManGoAgentSource(state),
+        visibility: defaultVisibility,
+    };
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/draftService.ts

@@ -1,16 +1,13 @@
-import { spaceTrim } from 'spacetrim';
+import { postManGoOnboardingJson } from './postManGoOnboardingJson';
 
 /**
- * Normalizes one user-entered single-line wizard value.
+ * Response returned by the manGo Book draft endpoint.
  *
- * @param value - Raw user-entered value.
- * @returns Trimmed single-line text.
- *
- * @private internal helper of the manGo wizard draft service.
+ * @private internal type of the manGo wizard draft service.
  */
-function normalizeSingleLineInput(value: string): string {
-    return value.replace(/\s+/g, ' ').trim();
-}
+type GenerateBookDraftResponse = {
+    readonly draft: string;
+};
 
 /**
  * Builds the initial Book source for the imported manGo wizard.
@@ -26,20 +23,10 @@ export async function generateBookDraft(input: {
     readonly agentName: string;
     readonly agentBrief: string;
 }): Promise<string> {
-    const agentName = normalizeSingleLineInput(input.agentName) || 'Nový agent';
-    const agentBrief = normalizeSingleLineInput(input.agentBrief);
-
-    return spaceTrim(`
-        ${agentName}
-
-        NOTE This agent was created via the NEW_AGENT_WIZARD manGo wizard flow
-
-        GOAL ${agentBrief || 'Help users with the assigned business workflow.'}
-
-        RULE Answer clearly and practically.
-        RULE Ask a clarifying question when the request is ambiguous.
-        RULE Escalate risky, unclear, or out-of-scope requests to a human.
+    const response = await postManGoOnboardingJson<GenerateBookDraftResponse>('/api/onboarding/draft', {
+        agentName: input.agentName,
+        agentBrief: input.agentBrief,
+    });
 
-        CLOSED
-    `);
+    return response.draft;
 }

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/postManGoOnboardingJson.ts

@@ -0,0 +1,104 @@
+import { NotAllowed } from '../../../../../../../src/errors/NotAllowed';
+import { spaceTrim } from 'spacetrim';
+
+/**
+ * JSON headers shared by manGo onboarding service calls.
+ *
+ * @private internal constant of manGo onboarding services
+ */
+const MAN_GO_ONBOARDING_JSON_HEADERS = {
+    'Content-Type': 'application/json',
+};
+
+/**
+ * Error payload returned by manGo onboarding API routes.
+ *
+ * @private internal type of manGo onboarding services
+ */
+type ManGoOnboardingApiErrorPayload = {
+    readonly error?: {
+        readonly message?: unknown;
+    };
+};
+
+/**
+ * Posts JSON to one manGo onboarding API route and returns the typed response payload.
+ *
+ * @param path - API route path.
+ * @param body - JSON-serializable request body.
+ * @returns Parsed response payload.
+ *
+ * @private internal utility of manGo onboarding services
+ */
+export async function postManGoOnboardingJson<ResponsePayload>(
+    path: string,
+    body: unknown,
+): Promise<ResponsePayload> {
+    const response = await fetch(path, {
+        method: 'POST',
+        headers: MAN_GO_ONBOARDING_JSON_HEADERS,
+        body: JSON.stringify(body),
+    });
+    const payload = await readManGoOnboardingJson(response);
+
+    if (!response.ok) {
+        throw new NotAllowed(resolveManGoOnboardingErrorMessage(payload, response.status));
+    }
+
+    return payload as ResponsePayload;
+}
+
+/**
+ * Reads a JSON response body and wraps parse failures in a branded error.
+ *
+ * @param response - Fetch response.
+ * @returns Parsed JSON payload.
+ *
+ * @private internal utility of manGo onboarding services
+ */
+async function readManGoOnboardingJson(response: Response): Promise<unknown> {
+    try {
+        return await response.json();
+    } catch {
+        throw new NotAllowed(
+            spaceTrim(`
+                The manGo onboarding API returned an invalid JSON response.
+
+                Endpoint status: \`${response.status}\`
+            `),
+        );
+    }
+}
+
+/**
+ * Resolves a human-readable error message from the stable API error payload.
+ *
+ * @param payload - Parsed response payload.
+ * @param status - HTTP status code.
+ * @returns Error message for the UI.
+ *
+ * @private internal utility of manGo onboarding services
+ */
+function resolveManGoOnboardingErrorMessage(payload: unknown, status: number): string {
+    if (isManGoOnboardingApiErrorPayload(payload) && typeof payload.error?.message === 'string') {
+        return payload.error.message;
+    }
+
+    return spaceTrim(`
+        The manGo onboarding API request failed.
+
+        Endpoint status: \`${status}\`
+    `);
+}
+
+/**
+ * Checks whether a parsed JSON value matches the API error payload shape.
+ *
+ * @param payload - Parsed JSON payload.
+ * @returns Whether the payload contains an error object.
+ *
+ * @private internal utility of manGo onboarding services
+ */
+function isManGoOnboardingApiErrorPayload(payload: unknown): payload is ManGoOnboardingApiErrorPayload {
+    return typeof payload === 'object' && payload !== null && 'error' in payload;
+}

package/apps/agents-server/src/components/NewAgentDialog/NewAgentOpenEditorRequest.ts

@@ -0,0 +1,19 @@
+import type { string_book } from '@promptbook-local/types';
+import type { AgentVisibility } from '../../utils/agentVisibility';
+
+/**
+ * Payload used when a guided new-agent surface switches to the classic Book editor.
+ *
+ * @private internal type of <NewAgentDialog/>.
+ */
+export type NewAgentOpenEditorRequest = {
+    /**
+     * Book source synthesized from the current guided surface.
+     */
+    readonly agentSource: string_book;
+
+    /**
+     * Visibility that should be used when the classic editor creates the agent.
+     */
+    readonly visibility: AgentVisibility;
+};

package/apps/agents-server/src/components/NewAgentDialog/NewAgentWizard.tsx

@@ -16,6 +16,7 @@ import { NewAgentWizardRulesStep } from './NewAgentWizardRulesStep';
 import { NewAgentWizardTeamStep } from './NewAgentWizardTeamStep';
 import { NewAgentWizardUseSetupStep } from './NewAgentWizardUseSetupStep';
 import { NewAgentWizardWritingStep } from './NewAgentWizardWritingStep';
+import type { NewAgentOpenEditorRequest } from './NewAgentOpenEditorRequest';
 import { useNewAgentWizard } from './useNewAgentWizard';
 
 /**
@@ -81,17 +82,7 @@ export type NewAgentWizardCreateRequest = {
 /**
  * Payload used when the user switches from the wizard to the advanced editor.
  */
-export type NewAgentWizardOpenEditorRequest = {
-    /**
-     * Hidden book source synthesized from the wizard form.
-     */
-    readonly agentSource: string_book;
-
-    /**
-     * Explicit visibility choice selected in the wizard.
-     */
-    readonly visibility: AgentVisibility;
-};
+export type NewAgentWizardOpenEditorRequest = NewAgentOpenEditorRequest;
 
 /**
  * Renders the current wizard step content.

package/apps/agents-server/src/components/NewAgentDialog/createNewAgentWizardSubmissionActions.ts

@@ -3,6 +3,7 @@ import type { Dispatch, SetStateAction } from 'react';
 import type { NewAgentWizardMode } from '../../constants/newAgentWizard';
 import type { AgentVisibility } from '../../utils/agentVisibility';
 import { createNewAgentWizardSource } from './createNewAgentWizardSource';
+import type { NewAgentOpenEditorRequest } from './NewAgentOpenEditorRequest';
 import { buildWizardSourceOptions, type NewAgentWizardState } from './NewAgentWizardState';
 import { trackNewAgentCreationEvent } from './trackNewAgentCreationEvent';
 
@@ -39,10 +40,7 @@ type CreateNewAgentWizardSubmissionActionsOptions = {
     /**
      * Switches from the wizard to the advanced raw editor before creation.
      */
-    readonly onOpenEditor: (request: {
-        readonly agentSource: string_book;
-        readonly visibility: AgentVisibility;
-    }) => void;
+    readonly onOpenEditor: (request: NewAgentOpenEditorRequest) => void;
 
     /**
      * Tracks whether the create request is currently in flight.

package/apps/agents-server/src/components/NewAgentDialog/useNewAgentDialog.tsx

@@ -14,11 +14,9 @@ import {
 } from '../../app/actions';
 import type { NewAgentWizardMode } from '../../constants/newAgentWizard';
 import { NewAgentDialog } from './NewAgentDialog';
-import type {
-    NewAgentWizardCreateRequest,
-    NewAgentWizardOpenEditorRequest,
-} from './NewAgentWizard';
+import type { NewAgentWizardCreateRequest } from './NewAgentWizard';
 import { NewAgentWizard } from './NewAgentWizard';
+import type { NewAgentOpenEditorRequest } from './NewAgentOpenEditorRequest';
 import {
     ManGoNewAgentWizard,
     type ManGoNewAgentWizardCreateRequest,
@@ -335,9 +333,12 @@ export function useNewAgentDialog(options: UseNewAgentDialogOptions): UseNewAgen
         [isHeadless],
     );
 
-    const handleOpenEditorFromWizard = useCallback((request: NewAgentWizardOpenEditorRequest) => {
+    const handleOpenEditorFromGuidedSurface = useCallback((request: NewAgentOpenEditorRequest) => {
         setDialogState((currentDialogState) => {
-            if (!currentDialogState || currentDialogState.surface !== 'wizard') {
+            if (
+                !currentDialogState ||
+                (currentDialogState.surface !== 'wizard' && currentDialogState.surface !== 'mango-wizard')
+            ) {
                 return currentDialogState;
             }
 
@@ -370,7 +371,7 @@ export function useNewAgentDialog(options: UseNewAgentDialogOptions): UseNewAgen
                     folderId={dialogState.targetFolderId}
                     onClose={closeNewAgentDialog}
                     onCreate={handleCreateFromWizard}
-                    onOpenEditor={handleOpenEditorFromWizard}
+                    onOpenEditor={handleOpenEditorFromGuidedSurface}
                 />
             ) : dialogState?.surface === 'mango-wizard' ? (
                 <ManGoNewAgentWizard
@@ -380,6 +381,7 @@ export function useNewAgentDialog(options: UseNewAgentDialogOptions): UseNewAgen
                     onClose={closeNewAgentDialog}
                     onCreate={handleCreateFromManGoWizard}
                     onOpenCreatedAgent={handleOpenCreatedManGoAgent}
+                    onOpenEditor={handleOpenEditorFromGuidedSurface}
                 />
             ) : null,
     };

package/apps/agents-server/src/components/Skeleton/HomepageLoadingSkeleton.tsx

@@ -1,21 +1,10 @@
 import { AgentCardsLoadingSkeleton } from './AgentCardsLoadingSkeleton';
-import { GraphLoadingSkeleton } from './GraphLoadingSkeleton';
 import { Skeleton } from './Skeleton';
 
-/**
- * Props for home-route skeleton rendering.
- */
-type HomepageLoadingSkeletonProps = {
-    /**
-     * Whether graph placeholder should be shown together with list placeholders.
-     */
-    readonly showGraphPlaceholder?: boolean;
-};
-
 /**
  * Placeholder for large home/list route loads.
  */
-export function HomepageLoadingSkeleton({ showGraphPlaceholder = true }: HomepageLoadingSkeletonProps) {
+export function HomepageLoadingSkeleton() {
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50 dark:from-slate-950 dark:via-slate-950 dark:to-slate-900">
             <div
@@ -34,15 +23,9 @@ export function HomepageLoadingSkeleton({ showGraphPlaceholder = true }: Homepag
                     <section className="mt-16">
                         <div className="mb-6 flex flex-wrap items-center justify-between gap-4">
                             <Skeleton className="h-10 w-72 rounded-xl" />
-                            <div className="flex items-center gap-2">
-                                <Skeleton className="h-9 w-20 rounded-lg" />
-                                <Skeleton className="h-9 w-20 rounded-lg" />
-                            </div>
                         </div>
                         <AgentCardsLoadingSkeleton cardCount={8} />
                     </section>
-
-                    {showGraphPlaceholder && <GraphLoadingSkeleton height={520} />}
                 </div>
             </div>
         </div>

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

@@ -0,0 +1,52 @@
+'use client';
+
+import { RefreshCcw } from 'lucide-react';
+import { useActionState } from 'react';
+import type { StalwartSynchronizationResult } from '../../utils/stalwart/captureStalwartSynchronizationResult';
+
+/**
+ * Synchronization button shared by the per-server and VPS-wide Stalwart administration pages.
+ *
+ * The synchronization runs against a mail service which can be unreachable or still bootstrapping, so its
+ * failure is rendered next to the button instead of replacing the whole page with a server error.
+ *
+ * @private shared by the Agents Server email administration views
+ */
+export function StalwartSynchronizeButton({
+    label,
+    synchronize,
+}: {
+    /**
+     * Caption of the submit button.
+     */
+    readonly label: string;
+
+    /**
+     * Server action performing the synchronization.
+     */
+    readonly synchronize: () => Promise<StalwartSynchronizationResult>;
+}) {
+    const [result, submitAction, isPending] = useActionState<StalwartSynchronizationResult | null, FormData>(
+        () => synchronize(),
+        null,
+    );
+
+    return (
+        <form action={submitAction} className="flex flex-col items-start gap-2">
+            <button
+                type="submit"
+                disabled={isPending}
+                className="inline-flex items-center gap-2 rounded-md bg-gray-900 px-4 py-2 text-sm font-semibold text-white hover:bg-gray-700 disabled:cursor-progress disabled:opacity-60"
+            >
+                <RefreshCcw className={`h-4 w-4 ${isPending ? 'animate-spin' : ''}`} />
+                {isPending ? 'Synchronizing…' : label}
+            </button>
+            {result?.isSuccessful ? (
+                <p className="max-w-xl text-xs text-emerald-700">Stalwart synchronization finished.</p>
+            ) : null}
+            {result?.errorMessage ? (
+                <p className="max-w-xl whitespace-pre-wrap text-xs text-red-700">{result.errorMessage}</p>
+            ) : null}
+        </form>
+    );
+}

package/apps/agents-server/src/components/UsersList/CreateUserDialog.tsx

@@ -0,0 +1,153 @@
+'use client';
+
+import { Loader2, RefreshCw, X } from 'lucide-react';
+import type { Dispatch, FormEvent, SetStateAction } from 'react';
+import { Dialog } from '../Portal/Dialog';
+import { SecretInput } from '../SecretInput/SecretInput';
+import { useServerLanguage } from '../ServerLanguage/ServerLanguageProvider';
+
+/**
+ * Shared input styling used by the create-user dialog.
+ */
+const INPUT_CLASS_NAME =
+    'w-full rounded-md border border-gray-300 px-3 py-2 text-sm text-gray-900 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-2 focus:ring-blue-200';
+
+/**
+ * Shared secondary button styling used by the create-user dialog.
+ */
+const SECONDARY_BUTTON_CLASS_NAME =
+    'inline-flex items-center justify-center gap-2 rounded-md border border-gray-300 bg-white px-3 py-2 text-sm font-semibold text-gray-700 hover:bg-gray-50 disabled:cursor-not-allowed disabled:opacity-60';
+
+/**
+ * Shared primary button styling used by the create-user dialog.
+ */
+const PRIMARY_BUTTON_CLASS_NAME =
+    'inline-flex items-center justify-center gap-2 rounded-md bg-blue-600 px-3 py-2 text-sm font-semibold text-white hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-60';
+
+/**
+ * Props for the create-user dialog.
+ *
+ * @private component of <UsersList/>
+ */
+type CreateUserDialogProps = {
+    readonly isAdmin: boolean;
+    readonly isOpen: boolean;
+    readonly isSubmitting: boolean;
+    readonly onClose: () => void;
+    readonly onGeneratePassword: () => void;
+    readonly onSubmit: (event: FormEvent<HTMLFormElement>) => Promise<void>;
+    readonly password: string;
+    readonly setIsAdmin: Dispatch<SetStateAction<boolean>>;
+    readonly setPassword: Dispatch<SetStateAction<string>>;
+    readonly setUsername: Dispatch<SetStateAction<string>>;
+    readonly username: string;
+};
+
+/**
+ * Renders the create-user dialog modelled after the create-server flow.
+ *
+ * @private component of <UsersList/>
+ */
+export function CreateUserDialog({
+    isAdmin,
+    isOpen,
+    isSubmitting,
+    onClose,
+    onGeneratePassword,
+    onSubmit,
+    password,
+    setIsAdmin,
+    setPassword,
+    setUsername,
+    username,
+}: CreateUserDialogProps) {
+    const { t } = useServerLanguage();
+
+    if (!isOpen) {
+        return null;
+    }
+
+    return (
+        <Dialog onClose={onClose} className="mx-4 w-full max-w-lg overflow-hidden">
+            <form onSubmit={(event) => void onSubmit(event)}>
+                <div className="flex items-start justify-between gap-4 border-b border-gray-200 px-6 py-5">
+                    <div>
+                        <h2 className="text-xl font-semibold text-gray-900">{t('users.createDialogTitle')}</h2>
+                        <p className="mt-1 text-sm text-gray-500">{t('users.createDialogDescription')}</p>
+                    </div>
+                    <button
+                        type="button"
+                        onClick={onClose}
+                        className="rounded-md p-2 text-gray-400 hover:bg-gray-100 hover:text-gray-700"
+                        aria-label={t('users.closeCreateDialog')}
+                    >
+                        <X className="h-5 w-5" />
+                    </button>
+                </div>
+
+                <div className="space-y-5 px-6 py-6">
+                    <div>
+                        <label htmlFor="create-user-username" className="mb-1 block text-sm font-medium text-gray-700">
+                            {t('users.usernameLabel')}
+                        </label>
+                        <input
+                            id="create-user-username"
+                            type="text"
+                            value={username}
+                            onChange={(event) => setUsername(event.target.value)}
+                            className={INPUT_CLASS_NAME}
+                            placeholder={t('users.usernamePlaceholder')}
+                            autoComplete="off"
+                            required
+                        />
+                    </div>
+
+                    <div>
+                        <SecretInput
+                            id="create-user-password"
+                            label={t('users.passwordLabel')}
+                            placeholder={t('users.passwordPlaceholder')}
+                            value={password}
+                            onChange={(event) => setPassword(event.target.value)}
+                            required
+                            aria-label={t('users.passwordAriaLabel')}
+                            autoComplete="new-password"
+                        />
+                        <button
+                            type="button"
+                            onClick={onGeneratePassword}
+                            className="mt-2 text-sm font-medium text-blue-600 hover:text-blue-800"
+                        >
+                            <RefreshCw className="mr-1 inline h-3.5 w-3.5" />
+                            {t('users.generatePassword')}
+                        </button>
+                        <p className="mt-1 text-xs text-gray-500">{t('users.passwordGeneratorDescription')}</p>
+                    </div>
+
+                    <label className="flex items-start gap-3 rounded-lg border border-gray-200 bg-gray-50 p-4 text-sm text-gray-600">
+                        <input
+                            type="checkbox"
+                            checked={isAdmin}
+                            onChange={(event) => setIsAdmin(event.target.checked)}
+                            className="mt-0.5 h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
+                        />
+                        <span>
+                            <span className="block font-semibold text-gray-900">{t('users.isAdminCheckbox')}</span>
+                            <span className="mt-1 block">{t('users.adminRoleDescription')}</span>
+                        </span>
+                    </label>
+                </div>
+
+                <div className="flex flex-col-reverse gap-3 border-t border-gray-100 px-6 py-5 sm:flex-row sm:justify-end">
+                    <button type="button" onClick={onClose} className={SECONDARY_BUTTON_CLASS_NAME}>
+                        {t('users.deleteConfirmCancel')}
+                    </button>
+                    <button type="submit" disabled={isSubmitting} className={PRIMARY_BUTTON_CLASS_NAME}>
+                        {isSubmitting ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
+                        {t('users.createUser')}
+                    </button>
+                </div>
+            </form>
+        </Dialog>
+    );
+}