@promptbook/cli 0.114.0-0 → 0.114.0-10

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

@@ -4,10 +4,9 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 
 import { ONBOARDING_ENTRY_PATH, ONBOARDING_STEPS } from '../../config/steps';
 import { useManGoOnboardingNavigation } from '../../ManGoOnboardingNavigation';
-import { generateBookDraft } from '../../services/draftService';
+import { generateBook } from '../../services/bookService';
 import { useOnboarding } from '../../state/OnboardingProvider';
-import { BookLanguagePanel } from '../BookLanguagePanel';
-import { MarkdownBookEditor } from '../MarkdownBookEditor';
+import { ManGoBookEditor } from '../ManGoBookEditor';
 import { StepFooter, StepHeader } from '../StepFrame';
 import { Banner } from '../ui/Banner';
 import { Button } from '../ui/Button';
@@ -29,16 +28,16 @@ export function BookStep() {
         setPhase('generating');
         setError(null);
         try {
-            const draft = await generateBookDraft({ agentName: state.agentName, agentBrief: state.agentBrief });
-            update({ bookSource: draft });
+            const book = await generateBook({ agentName: state.agentName, agentBrief: state.agentBrief });
+            update({ bookSource: book });
             setPhase('ready');
         } catch (caught) {
-            setError(caught instanceof Error ? caught.message : 'Generování draftu selhalo.');
+            setError(caught instanceof Error ? caught.message : 'Generování booku selhalo.');
             setPhase('error');
         }
     }, [state.agentName, state.agentBrief, update]);
 
-    // Generate the draft once, after hydration completes — so we read the persisted
+    // Generate the Book once, after hydration completes — so we read the persisted
     // name/brief rather than the initial empty state. Runs a single time (startedRef),
     // reading the latest values from the closure captured when hydration flips true.
     useEffect(() => {
@@ -59,7 +58,7 @@ export function BookStep() {
     if (phase === 'init' || phase === 'generating') {
         return (
             <div className="mx-auto max-w-2xl">
-                <StepHeader eyebrow="Definice agenta" title="Připravujeme draft booku" />
+                <StepHeader eyebrow="Definice agenta" title="Generujeme book" />
                 <Card variant="elevated" className="flex flex-col items-center justify-center gap-5 px-8 py-20 text-center">
                     <span className="relative flex h-14 w-14 items-center justify-center">
                         <span className="absolute inset-0 animate-ping rounded-full bg-[color:var(--ob-accent-200)] opacity-60" />
@@ -68,7 +67,7 @@ export function BookStep() {
                         </span>
                     </span>
                     <div>
-                        <p className="text-sm font-semibold text-zinc-800">Čtu vaše zadání a píšu draft book.md…</p>
+                        <p className="text-sm font-semibold text-zinc-800">Čtu vaše zadání a píšu book…</p>
                         <p className="mt-1 text-xs text-zinc-400">Chvíli to může trvat — generuje skutečný model.</p>
                     </div>
                 </Card>
@@ -82,12 +81,12 @@ export function BookStep() {
         <div className="mx-auto max-w-4xl">
             <StepHeader
                 eyebrow="Definice agenta"
-                title="Draft booku je hotový"
-                subtitle="Je to jen výchozí návrh — cokoli přepište, smažte nebo doplňte, klidně přímo na schůzce s klientem."
+                title="Book je připravený"
+                subtitle="Je to výchozí verze — cokoli přepište, smažte nebo doplňte přímo v editoru booku."
             />
 
             {phase === 'error' && (
-                <Banner tone="warning" title="Draft se nepodařilo vygenerovat." className="mb-5">
+                <Banner tone="warning" title="Book se nepodařilo vygenerovat." className="mb-5">
                     <p>{error}</p>
                     <p className="mt-1">Book můžete napsat i ručně níže, nebo to zkuste znovu.</p>
                 </Banner>
@@ -95,7 +94,7 @@ export function BookStep() {
 
             {!isBriefAvailable && state.bookSource.trim().length === 0 && phase !== 'error' && (
                 <Banner tone="info" className="mb-5">
-                    Nejprve vyplňte zadání, ať můžeme draft vygenerovat — nebo book napište ručně níže.{' '}
+                    Nejprve vyplňte zadání, ať můžeme book vygenerovat — nebo book napište ručně níže.{' '}
                     <button
                         type="button"
                         className="font-semibold text-[color:var(--ob-accent-700)] underline underline-offset-2 hover:text-[color:var(--ob-accent-800)]"
@@ -106,14 +105,12 @@ export function BookStep() {
                 </Banner>
             )}
 
-            <MarkdownBookEditor
+            <ManGoBookEditor
                 value={state.bookSource}
                 onChange={(value) => update({ bookSource: value })}
                 onRegenerate={isBriefAvailable ? () => void generate() : undefined}
             />
 
-            {state.bookSource.trim().length > 0 && <BookLanguagePanel source={state.bookSource} />}
-
             <StepFooter
                 left={
                     <Button variant="ghost" onClick={() => navigateToPath(ONBOARDING_ENTRY_PATH)}>

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

@@ -9,7 +9,7 @@ import { InputField, TextareaField } from '../ui/Field';
 
 /**
  * Entry screen of the wizard ("Řekněte mi o agentovi"). Captures the agent name + a
- * one-sentence brief, then continues to the Book step where the draft is generated.
+ * one-sentence brief, then continues to the Book step where the Book is generated.
  */
 export function ZadaniStep() {
     const { navigateToPath } = useManGoOnboardingNavigation();
@@ -24,8 +24,8 @@ export function ZadaniStep() {
                     Řekněte mi o agentovi
                 </h1>
                 <p className="mt-2.5 text-sm leading-relaxed text-zinc-500">
-                    Stačí název a jedna věta o tom, co má agent dělat. Z toho připravíme draft booku, který si pak
-                    libovolně upravíte.
+                    Stačí název a jedna věta o tom, co má agent dělat. Z toho připravíme book, který si pak libovolně
+                    upravíte.
                 </p>
 
                 <div className="mt-8 space-y-6">
@@ -54,7 +54,7 @@ export function ZadaniStep() {
                             trailingIcon={<span aria-hidden>→</span>}
                             onClick={() => navigateToPath(ONBOARDING_STEPS[0].path)}
                         >
-                            Vygenerovat draft booku
+                            Vygenerovat book
                         </Button>
                     }
                 />

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/config/bookSections.ts

@@ -1,31 +1,36 @@
 import { spaceTrim } from 'spacetrim';
 
 /**
- * Predefined markdown sections offered as "Přidat sekci" chips in the book editor.
- * Mirrors the wireframe's section presets; users append and then freely edit them.
+ * Predefined Book-language sections offered as "Přidat sekci" chips in the editor.
+ * Mirrors the wireframe's section presets; users insert and then freely edit them.
  */
 export type BookSectionPreset = {
     readonly key: string;
     readonly label: string;
-    readonly markdown: string;
+    readonly book: string;
 };
 
+/**
+ * Book-language section presets shown below the manGo Book editor.
+ *
+ * @private internal constant of <ManGoBookEditor/>
+ */
 export const BOOK_SECTION_PRESETS: readonly BookSectionPreset[] = [
     {
         key: 'priklady',
         label: 'Příklady odpovědí',
-        markdown: spaceTrim(`
-            ## Příklady odpovědí
-            **Dotaz:** Kde je moje objednávka?
-            **Odpověď:** Dobrý den, děkujeme za zprávu. Vaši objednávku jsme ověřili — …
+        book: spaceTrim(`
+            WRITING SAMPLE
+            Uživatel: Kde je moje objednávka?
+            Agent: Dobrý den, děkujeme za zprávu. Vaši objednávku jsme ověřili — …
         `),
     },
     {
         key: 'eskalace',
         label: 'Eskalace',
-        markdown: spaceTrim(`
-            ## Eskalace
-            Kdy předat člověku:
+        book: spaceTrim(`
+            RULE
+            Požadavek předejte člověku, pokud jde o:
             - Reklamace nad 10 000 Kč
             - Rozzlobený zákazník (2. a další urgence)
             - Právní dotazy
@@ -34,8 +39,8 @@ export const BOOK_SECTION_PRESETS: readonly BookSectionPreset[] = [
     {
         key: 'podpis',
         label: 'Podpis / šablona',
-        markdown: spaceTrim(`
-            ## Podpis / šablona
+        book: spaceTrim(`
+            MESSAGE SUFFIX
             S pozdravem,
             Zákaznická podpora
             kontakt@firma.cz
@@ -44,8 +49,9 @@ export const BOOK_SECTION_PRESETS: readonly BookSectionPreset[] = [
     {
         key: 'zakazana',
         label: 'Zakázaná témata',
-        markdown: spaceTrim(`
-            ## Zakázaná témata
+        book: spaceTrim(`
+            RULE
+            Nikdy neposkytujte ani nerozebírejte:
             - Interní procesy a ceny dodavatelů
             - Srovnávání s konkurencí
             - Právní stanoviska
@@ -54,8 +60,9 @@ export const BOOK_SECTION_PRESETS: readonly BookSectionPreset[] = [
     {
         key: 'vlastni',
         label: 'Vlastní sekce',
-        markdown: spaceTrim(`
-            ## Nová sekce
+        book: spaceTrim(`
+            NOTE
+            Vlastní sekce:
             Sem napište cokoli dalšího…
         `),
     },

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/lib/bookSource.ts

@@ -0,0 +1,54 @@
+/**
+ * Inserts Book-language sections before the final learning-mode marker.
+ *
+ * `OPEN` and `CLOSED` apply to the whole agent and should remain the final
+ * commitment. Keeping this operation shared prevents the section chips and
+ * the knowledge-source integration from creating different source layouts.
+ *
+ * @param source - Current Book source.
+ * @param sections - Book-language sections to insert.
+ * @returns Source with the sections inserted before `OPEN` or `CLOSED`.
+ */
+export function insertBookContentBeforeLearningMarker(source: string, sections: readonly string[]): string {
+    const normalizedSections = sections.map((section) => section.trim()).filter((section) => section !== '');
+
+    if (normalizedSections.length === 0) {
+        return source;
+    }
+
+    const normalizedSource = source.replace(/\r\n/g, '\n').trimEnd();
+    const lines = normalizedSource.split('\n');
+    const markerIndex = findLearningMarkerIndex(lines);
+    const sectionSource = normalizedSections.join('\n\n');
+
+    if (markerIndex === -1) {
+        return [normalizedSource, sectionSource].filter((content) => content !== '').join('\n\n');
+    }
+
+    const sourceBeforeMarker = lines.slice(0, markerIndex).join('\n').trimEnd();
+    const sourceFromMarker = lines.slice(markerIndex).join('\n').trim();
+
+    return [sourceBeforeMarker, sectionSource, sourceFromMarker]
+        .filter((content) => content !== '')
+        .join('\n\n');
+}
+
+/**
+ * Finds the last standalone `OPEN` or `CLOSED` line in a Book source.
+ *
+ * @param lines - Normalized Book source lines.
+ * @returns Index of the learning-mode marker, or `-1` when absent.
+ *
+ * @private internal utility of manGo Book source editing
+ */
+function findLearningMarkerIndex(lines: readonly string[]): number {
+    for (let lineIndex = lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
+        const line = lines[lineIndex];
+
+        if (line && (line.trim().toUpperCase() === 'OPEN' || line.trim().toUpperCase() === 'CLOSED')) {
+            return lineIndex;
+        }
+    }
+
+    return -1;
+}

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

@@ -1,21 +1,28 @@
 import { postManGoOnboardingJson } from './postManGoOnboardingJson';
 
 /**
- * Response returned by the manGo Book conversion endpoint.
+ * Response returned by the manGo Book generation endpoint.
  *
  * @private internal type of the manGo wizard book service.
  */
-type ConvertToBookResponse = {
+type GenerateBookResponse = {
     readonly book: string;
-    readonly isValid: boolean;
 };
 
 /**
- * Boundary used by the imported Book language panel. Backed by the manGo book expert.
+ * Generates the initial Book directly from the assignment step.
  *
- * @param input - Current Book editor content.
- * @returns Validated Book source and validation flag for the panel badge.
+ * @param input - Agent name and brief captured by the entry step.
+ * @returns Editable Book source used by the following wizard steps.
  */
-export async function convertToBook(input: string): Promise<{ book: string; isValid: boolean }> {
-    return postManGoOnboardingJson<ConvertToBookResponse>('/api/onboarding/book', { input });
+export async function generateBook(input: {
+    readonly agentName: string;
+    readonly agentBrief: string;
+}): Promise<string> {
+    const response = await postManGoOnboardingJson<GenerateBookResponse>('/api/onboarding/book', {
+        agentName: input.agentName,
+        agentBrief: input.agentBrief,
+    });
+
+    return response.book;
 }

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

@@ -1,5 +1,6 @@
 import { spaceTrim } from 'spacetrim';
 import { validateBook, type string_book } from '../../../../../../../src/book-2.0/agent-source/string_book';
+import { insertBookContentBeforeLearningMarker } from '../lib/bookSource';
 import type { KnowledgeItem, OnboardingState } from '../types';
 
 /**
@@ -22,7 +23,7 @@ function getKnowledgeSource(item: KnowledgeItem): string {
 }
 
 /**
- * Creates a minimal Book source when the editable draft is empty.
+ * Creates a minimal Book source when the editable Book is empty.
  *
  * @param state - Current wizard state.
  * @returns Book source fallback.
@@ -57,41 +58,6 @@ function ensureBookTitle(source: string, agentName: string): string {
     return agentName.trim() || FALLBACK_AGENT_NAME;
 }
 
-/**
- * Inserts extra commitments before a final `OPEN` or `CLOSED` marker when present.
- *
- * @param source - Current Book source.
- * @param commitments - Commitment lines to insert.
- * @returns Source with inserted commitments.
- */
-function insertCommitmentsBeforeLearningMarker(source: string, commitments: ReadonlyArray<string>): string {
-    if (commitments.length === 0) {
-        return source;
-    }
-
-    const lines = source.replace(/\r\n/g, '\n').split('\n');
-    let markerIndex = -1;
-    for (let lineIndex = lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
-        const line = lines[lineIndex];
-        if (line === undefined) {
-            continue;
-        }
-
-        const normalizedLine = line.trim().toUpperCase();
-        if (normalizedLine === 'OPEN' || normalizedLine === 'CLOSED') {
-            markerIndex = lineIndex;
-            break;
-        }
-    }
-    const insertionLines = ['', ...commitments];
-
-    if (markerIndex === -1) {
-        return [...lines, ...insertionLines].join('\n');
-    }
-
-    return [...lines.slice(0, markerIndex), ...insertionLines, '', ...lines.slice(markerIndex)].join('\n');
-}
-
 /**
  * Builds the final Book source submitted from the manGo wizard.
  *
@@ -108,5 +74,5 @@ export function createManGoAgentSource(state: OnboardingState): string_book {
         .filter((source) => !titledSource.includes(`KNOWLEDGE ${source}`))
         .map((source) => `KNOWLEDGE ${source}`);
 
-    return validateBook(insertCommitmentsBeforeLearningMarker(titledSource, knowledgeCommitments));
+    return validateBook(insertBookContentBeforeLearningMarker(titledSource, knowledgeCommitments));
 }

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

@@ -8,7 +8,7 @@ import { createManGoAgentSource } from './createManGoAgentSource';
  *
  * @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.
+ * @returns Classic Book editor request carrying the current Book.
  *
  * @private internal utility of <ManGoNewAgentWizard/>.
  */

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

@@ -6,8 +6,8 @@ import { NotAllowed } from '../../../../../../../src/errors/NotAllowed';
 import type { OnboardingState } from '../types';
 
 /** sessionStorage key for the wizard session — exported so callers (e.g. the dashboard's
- * "Nový onboarding") can clear a stale draft before starting fresh. */
-export const ONBOARDING_STORAGE_KEY = 'onboarding:v1';
+ * "Nový onboarding") can clear a stale Book before starting fresh. */
+export const ONBOARDING_STORAGE_KEY = 'onboarding:v2';
 const STORAGE_KEY = ONBOARDING_STORAGE_KEY;
 
 const INITIAL_STATE: OnboardingState = {

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

@@ -62,10 +62,6 @@ export type NewAgentWizardCapabilitySetupByCommitment = {
         readonly calendarUrl: string;
         readonly instructions: string;
     };
-    readonly 'USE EMAIL': {
-        readonly instructions: string;
-        readonly senderEmail: string;
-    };
     readonly 'USE MCP': {
         readonly instructions: string;
         readonly serverUrl: string;
@@ -275,10 +271,6 @@ export function createInitialWizardState(
                 calendarUrl: '',
                 instructions: '',
             },
-            'USE EMAIL': {
-                instructions: '',
-                senderEmail: '',
-            },
             'USE MCP': {
                 instructions: '',
                 serverUrl: '',
@@ -590,10 +582,6 @@ export function buildWizardSourceOptions(state: NewAgentWizardState): CreateNewA
                     setup.instructions,
                 );
             }
-            case 'USE EMAIL': {
-                const setup = state.capabilitySetupByCommitment['USE EMAIL'];
-                return createCapabilityCommitmentEntry('USE EMAIL', setup.senderEmail, setup.instructions);
-            }
             case 'USE CALENDAR': {
                 const setup = state.capabilitySetupByCommitment['USE CALENDAR'];
                 return createCapabilityCommitmentEntry('USE CALENDAR', setup.calendarUrl, setup.instructions);

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

@@ -187,64 +187,6 @@ function renderCapabilitySetupFields(options: {
             );
         }
 
-        case 'USE EMAIL': {
-            const emailSetup = state.capabilitySetupByCommitment['USE EMAIL'];
-
-            return (
-                <>
-                    <div>
-                        <label className={NewAgentWizardClassNames.fieldLabel}>
-                            {t('agentCreation.wizard.useSetupEmailSenderLabel')}
-                        </label>
-                        <input
-                            type="email"
-                            value={emailSetup.senderEmail}
-                            onChange={(event) =>
-                                setState((previous) => ({
-                                    ...previous,
-                                    capabilitySetupByCommitment: {
-                                        ...previous.capabilitySetupByCommitment,
-                                        'USE EMAIL': {
-                                            ...previous.capabilitySetupByCommitment['USE EMAIL'],
-                                            senderEmail: event.target.value,
-                                        },
-                                    },
-                                }))
-                            }
-                            placeholder={t('agentCreation.wizard.useSetupEmailSenderPlaceholder')}
-                            className={NewAgentWizardClassNames.input}
-                        />
-                        <p className={`mt-2 ${NewAgentWizardClassNames.sectionHint}`}>
-                            {t('agentCreation.wizard.useSetupEmailSenderHint')}
-                        </p>
-                    </div>
-
-                    <div className="mt-4">
-                        <label className={NewAgentWizardClassNames.fieldLabel}>
-                            {t('agentCreation.wizard.useSetupInstructionsLabel')}
-                        </label>
-                        <textarea
-                            value={emailSetup.instructions}
-                            onChange={(event) =>
-                                setState((previous) => ({
-                                    ...previous,
-                                    capabilitySetupByCommitment: {
-                                        ...previous.capabilitySetupByCommitment,
-                                        'USE EMAIL': {
-                                            ...previous.capabilitySetupByCommitment['USE EMAIL'],
-                                            instructions: event.target.value,
-                                        },
-                                    },
-                                }))
-                            }
-                            placeholder={t('agentCreation.wizard.useSetupInstructionsPlaceholder')}
-                            className={NewAgentWizardClassNames.textarea}
-                        />
-                    </div>
-                </>
-            );
-        }
-
         case 'USE CALENDAR': {
             const calendarSetup = state.capabilitySetupByCommitment['USE CALENDAR'];
             const parsedCalendar = parseGoogleCalendarReference(calendarSetup.calendarUrl);

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

@@ -356,54 +356,6 @@ export const NEW_AGENT_WIZARD_WRITING_STYLE_PRESETS = [
  * Capability presets available in page 2.
  */
 export const NEW_AGENT_WIZARD_CAPABILITY_PRESETS = [
-    {
-        id: 'browser',
-        labelKey: 'agentCreation.wizard.capabilityBrowser',
-        icon: '🌐',
-        commitmentKeyword: 'USE BROWSER',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
-    {
-        id: 'search-engine',
-        labelKey: 'agentCreation.wizard.capabilitySearchEngine',
-        icon: '🔍',
-        commitmentKeyword: 'USE SEARCH ENGINE',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
-    {
-        id: 'deep-search',
-        labelKey: 'agentCreation.wizard.capabilityDeepSearch',
-        icon: '🔎',
-        commitmentKeyword: 'USE DEEPSEARCH',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
-    {
-        id: 'spawn',
-        labelKey: 'agentCreation.wizard.capabilitySpawn',
-        icon: '🧬',
-        commitmentKeyword: 'USE SPAWN',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
-    {
-        id: 'timeout',
-        labelKey: 'agentCreation.wizard.capabilityTimeout',
-        icon: '⏱️',
-        commitmentKeyword: 'USE TIMEOUT',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
-    {
-        id: 'time',
-        labelKey: 'agentCreation.wizard.capabilityTime',
-        icon: '🕒',
-        commitmentKeyword: 'USE TIME',
-        availability: 'wizard',
-        setupKind: 'none',
-    },
     {
         id: 'user-location',
         labelKey: 'agentCreation.wizard.capabilityUserLocation',
@@ -420,14 +372,6 @@ export const NEW_AGENT_WIZARD_CAPABILITY_PRESETS = [
         availability: 'wizard',
         setupKind: 'calendar',
     },
-    {
-        id: 'email',
-        labelKey: 'agentCreation.wizard.capabilityEmail',
-        icon: '📧',
-        commitmentKeyword: 'USE EMAIL',
-        availability: 'wizard',
-        setupKind: 'email',
-    },
     {
         id: 'popup',
         labelKey: 'agentCreation.wizard.capabilityPopup',

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

@@ -5,25 +5,14 @@ import type { Dispatch, FormEvent, SetStateAction } from 'react';
 import { Dialog } from '../Portal/Dialog';
 import { SecretInput } from '../SecretInput/SecretInput';
 import { useServerLanguage } from '../ServerLanguage/ServerLanguageProvider';
+import { USER_DIALOG_PRIMARY_BUTTON_CLASS_NAME, USER_DIALOG_SECONDARY_BUTTON_CLASS_NAME } from './userDialogClassNames';
 
 /**
- * Shared input styling used by the create-user dialog.
+ * Styling for ordinary form inputs inside the create-user dialog.
  */
-const INPUT_CLASS_NAME =
+const CREATE_USER_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.
  *
@@ -31,10 +20,12 @@ const PRIMARY_BUTTON_CLASS_NAME =
  */
 type CreateUserDialogProps = {
     readonly isAdmin: boolean;
+    /** Whether the dialog can be dismissed through its backdrop or Escape key. */
+    readonly isDismissible?: boolean;
     readonly isOpen: boolean;
     readonly isSubmitting: boolean;
     readonly onClose: () => void;
-    readonly onGeneratePassword: () => void;
+    readonly onOpenPasswordGenerator: () => void;
     readonly onSubmit: (event: FormEvent<HTMLFormElement>) => Promise<void>;
     readonly password: string;
     readonly setIsAdmin: Dispatch<SetStateAction<boolean>>;
@@ -50,10 +41,11 @@ type CreateUserDialogProps = {
  */
 export function CreateUserDialog({
     isAdmin,
+    isDismissible,
     isOpen,
     isSubmitting,
     onClose,
-    onGeneratePassword,
+    onOpenPasswordGenerator,
     onSubmit,
     password,
     setIsAdmin,
@@ -68,7 +60,7 @@ export function CreateUserDialog({
     }
 
     return (
-        <Dialog onClose={onClose} className="mx-4 w-full max-w-lg overflow-hidden">
+        <Dialog onClose={onClose} isDismissible={isDismissible} 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>
@@ -95,7 +87,7 @@ export function CreateUserDialog({
                             type="text"
                             value={username}
                             onChange={(event) => setUsername(event.target.value)}
-                            className={INPUT_CLASS_NAME}
+                            className={CREATE_USER_INPUT_CLASS_NAME}
                             placeholder={t('users.usernamePlaceholder')}
                             autoComplete="off"
                             required
@@ -115,13 +107,12 @@ export function CreateUserDialog({
                         />
                         <button
                             type="button"
-                            onClick={onGeneratePassword}
+                            onClick={onOpenPasswordGenerator}
                             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">
@@ -139,10 +130,10 @@ export function CreateUserDialog({
                 </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}>
+                    <button type="button" onClick={onClose} className={USER_DIALOG_SECONDARY_BUTTON_CLASS_NAME}>
                         {t('users.deleteConfirmCancel')}
                     </button>
-                    <button type="submit" disabled={isSubmitting} className={PRIMARY_BUTTON_CLASS_NAME}>
+                    <button type="submit" disabled={isSubmitting} className={USER_DIALOG_PRIMARY_BUTTON_CLASS_NAME}>
                         {isSubmitting ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
                         {t('users.createUser')}
                     </button>