@promptbook/cli 0.113.0-9 → 0.114.0-0

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

@@ -23,7 +23,6 @@ import { useAgentsListOverlayDetailsState } from './useAgentsListOverlayDetailsS
 import { useAgentsListOverlayState } from './useAgentsListOverlayState';
 import { useAgentsListQueryState } from './useAgentsListQueryState';
 import { useAgentsListSyncState } from './useAgentsListSyncState';
-import type { AgentWithVisibility } from './useFederatedAgents';
 import { useIsTouchInput } from './useIsTouchInput';
 
 /**
@@ -48,22 +47,10 @@ type UseAgentsListStateProps = {
      * Indicates if the current user can organize agents and folders.
      */
     readonly canOrganize: boolean;
-    /**
-     * Controls whether federated agents are loaded and shown in graph view.
-     */
-    readonly showFederatedAgents: boolean;
     /**
      * Base URL of the agents server.
      */
     readonly publicUrl: string_url;
-    /**
-     * Optional external agents to display in list view.
-     */
-    readonly externalAgents?: AgentWithVisibility[];
-    /**
-     * Whether the current view is inside a subfolder.
-     */
-    readonly isSubfolderView: boolean;
 };
 
 /**
@@ -75,27 +62,18 @@ type UseAgentsListStateProps = {
  * @private function of AgentsList
  */
 export function useAgentsListState(props: UseAgentsListStateProps) {
-    const {
-        agents: initialAgents,
-        folders: initialFolders,
-        canOrganize,
-        publicUrl,
-        showFederatedAgents,
-        externalAgents: initialExternalAgents,
-    } = props;
+    const { agents: initialAgents, folders: initialFolders, canOrganize, publicUrl } = props;
     const {
         folderQuery,
         isHiddenFoldersVisible,
         routeSyncKey,
         searchParamsSnapshot,
         setHiddenFoldersVisible,
-        setViewMode,
         updateCurrentPathQuery,
-        viewMode,
     } = useAgentsListQueryState();
     const { formatText } = useAgentNaming();
     const isTouchInput = useIsTouchInput();
-    const allowFullCardDrag = canOrganize && viewMode === 'LIST' && !isTouchInput;
+    const allowFullCardDrag = canOrganize && !isTouchInput;
     const {
         agents: agentsBeforeHiddenFilter,
         folders: foldersBeforeHiddenFilter,
@@ -109,11 +87,7 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         initialFolders,
         routeSyncKey,
     });
-    const {
-        agents,
-        folders,
-        hasHiddenFolders,
-    } = useMemo(
+    const { agents, folders, hasHiddenFolders } = useMemo(
         () => filterHiddenFolderTree(foldersBeforeHiddenFilter, agentsBeforeHiddenFilter, isHiddenFoldersVisible),
         [foldersBeforeHiddenFilter, agentsBeforeHiddenFilter, isHiddenFoldersVisible],
     );
@@ -126,9 +100,6 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         folderPathSegments,
         getFolderPreviewAgents,
         headingTitle,
-        mazeAgents,
-        officeAgents,
-        officeFolders,
         parentFolderInfo,
         visibleAgents,
         visibleFolders,
@@ -137,8 +108,6 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         folderQuery,
         folders,
         formatText,
-        publicUrl,
-        viewMode,
     });
 
     useAgentsListFolderPathRecovery({
@@ -151,16 +120,12 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         updateCurrentPathQuery,
     });
 
-    const { buildAgentEmail, buildAgentUrl, federatedAgents, federatedServersStatus, navigateToFolder } =
-        useAgentsListNavigationState({
-            folders,
-            initialExternalAgents,
-            publicUrl,
-            searchParamsSnapshot,
-            showFederatedAgents,
-            updateCurrentPathQuery,
-            viewMode,
-        });
+    const { buildAgentEmail, buildAgentUrl, navigateToFolder } = useAgentsListNavigationState({
+        folders,
+        publicUrl,
+        searchParamsSnapshot,
+        updateCurrentPathQuery,
+    });
 
     const organizationActions = useAgentsListOrganizationActions({
         agents,
@@ -256,8 +221,6 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         dragAgentLabel,
         dragFolderLabel,
         dropIndicator: dragState.dropIndicator,
-        federatedAgents,
-        federatedServersStatus,
         folderEditDialogInitialValues: folderState.folderEditDialogState?.initialValues ?? null,
         folderEditDialogMode: folderState.folderEditDialogState?.mode ?? null,
         folders,
@@ -297,17 +260,12 @@ export function useAgentsListState(props: UseAgentsListStateProps) {
         isFolderEditSubmitting: folderState.isFolderEditSubmitting,
         isHiddenFoldersVisible,
         navigateToFolder,
-        mazeAgents,
-        officeAgents,
-        officeFolders,
         parentFolderInfo,
         qrCodeAgent,
         qrCodeAgentEmail,
         qrCodeAgentUrl,
         sensors,
         setHiddenFoldersVisible,
-        setViewMode,
-        viewMode,
         visibleAgentDragIds,
         visibleAgents,
         visibleFolderDragIds,

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

@@ -18,7 +18,7 @@ import { ClientVersionMismatchListener } from '../ClientVersion/ClientVersionMis
 import { ChatEnterBehaviorPreferencesProvider } from '../ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { HomepageOptimisticNavigation } from '../Homepage/HomepageOptimisticNavigation';
 import { FileUploadAvailabilityProvider } from '../FileUploadAvailability/FileUploadAvailabilityContext';
-import { Footer, type FooterLink } from '../Footer/Footer';
+import { Footer, type FooterLink, type FooterVersionInfo } from '../Footer/Footer';
 import { ActiveAgentBreadcrumbProvider } from '../Header/ActiveAgentBreadcrumbContext';
 import { Header } from '../Header/Header';
 import { MobileMenuHoistingProvider } from '../Header/MobileMenuHoistingContext';
@@ -50,6 +50,7 @@ type LayoutWrapperProps = {
     agentNaming: AgentNaming;
     isFooterShown: boolean;
     footerLinks: Array<FooterLink>;
+    footerVersion: FooterVersionInfo;
     federatedServers: Array<{ url: string; title: string }>;
     isExperimental: boolean;
     feedbackMode: ChatFeedbackMode;
@@ -61,6 +62,30 @@ type LayoutWrapperProps = {
      * Resource monitor status used by the header menu.
      */
     readonly resourceMonitorWarningStatus: ServerResourceWarningStatus;
+    /**
+     * Whether one or more bundled core agents are missing on this server (admin-only warning).
+     */
+    readonly isCoreAgentsMissing: boolean;
+    /**
+     * Whether the current server's agent email integration needs administrator attention.
+     */
+    readonly isAgentEmailWarningShown: boolean;
+    /**
+     * Whether generated project domain DNS needs administrator attention.
+     */
+    readonly isAgentProjectsDnsWarningShown: boolean;
+    /**
+     * Whether the VPS-wide email service needs super-admin attention.
+     */
+    readonly isVpsEmailServerWarningShown: boolean;
+    /**
+     * Whether registered server or project DNS needs super-admin attention.
+     */
+    readonly isServersDnsWarningShown: boolean;
+    /**
+     * Whether active self-contained S3 storage needs super-admin attention.
+     */
+    readonly isInternalS3WarningShown: boolean;
     /**
      * Indicates if the install-as-app option should be shown in agent menus.
      */
@@ -102,11 +127,18 @@ export function LayoutWrapper({
     agentNaming,
     isFooterShown,
     footerLinks,
+    footerVersion,
     federatedServers,
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
     resourceMonitorWarningStatus,
+    isCoreAgentsMissing,
+    isAgentEmailWarningShown,
+    isAgentProjectsDnsWarningShown,
+    isVpsEmailServerWarningShown,
+    isServersDnsWarningShown,
+    isInternalS3WarningShown,
     isExperimentalPwaAppEnabled,
     controlPanelOptionAvailability,
     defaultIsSoundsOn,
@@ -200,6 +232,24 @@ export function LayoutWrapper({
                                                                                         resourceMonitorWarningStatus={
                                                                                             resourceMonitorWarningStatus
                                                                                         }
+                                                                                        isCoreAgentsMissing={
+                                                                                            isCoreAgentsMissing
+                                                                                        }
+                                                                                        isAgentEmailWarningShown={
+                                                                                            isAgentEmailWarningShown
+                                                                                        }
+                                                                                        isAgentProjectsDnsWarningShown={
+                                                                                            isAgentProjectsDnsWarningShown
+                                                                                        }
+                                                                                        isVpsEmailServerWarningShown={
+                                                                                            isVpsEmailServerWarningShown
+                                                                                        }
+                                                                                        isServersDnsWarningShown={
+                                                                                            isServersDnsWarningShown
+                                                                                        }
+                                                                                        isInternalS3WarningShown={
+                                                                                            isInternalS3WarningShown
+                                                                                        }
                                                                                     />
                                                                                     <main className={mainClassName}>
                                                                                         <HomepageOptimisticNavigation
@@ -212,6 +262,7 @@ export function LayoutWrapper({
                                                                                         !isFooterHiddenOnPage && (
                                                                                             <Footer
                                                                                                 extraLinks={footerLinks}
+                                                                                                version={footerVersion}
                                                                                             />
                                                                                         )}
                                                                                 </div>

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

@@ -4,6 +4,7 @@ import type { string_book } from '@promptbook-local/types';
 import { useCallback, useMemo, useState } from 'react';
 import type { NewAgentWizardMode } from '../../../constants/newAgentWizard';
 import type { AgentVisibility } from '../../../utils/agentVisibility';
+import type { NewAgentOpenEditorRequest } from '../NewAgentOpenEditorRequest';
 import { Dialog } from '../../Portal/Dialog';
 import { ONBOARDING_ENTRY_PATH, ONBOARDING_STEPS } from './config/steps';
 import { ManGoOnboardingNavigationContext } from './ManGoOnboardingNavigation';
@@ -48,6 +49,11 @@ type ManGoNewAgentWizardProps = {
      * Opens the created agent route after the completion screen.
      */
     readonly onOpenCreatedAgent: (targetPath: string) => void;
+
+    /**
+     * Switches from manGo onboarding to the classic Book editor before creation.
+     */
+    readonly onOpenEditor: (request: NewAgentOpenEditorRequest) => void;
 };
 
 /**
@@ -112,7 +118,7 @@ function renderManGoWizardStep(props: {
  * @returns Fullscreen create-agent wizard dialog.
  */
 export function ManGoNewAgentWizard(props: ManGoNewAgentWizardProps) {
-    const { defaultVisibility, onClose, onCreate, onOpenCreatedAgent } = props;
+    const { defaultVisibility, onClose, onCreate, onOpenCreatedAgent, onOpenEditor } = props;
     const [currentPath, setCurrentPath] = useState(ONBOARDING_ENTRY_PATH);
     const navigateToPath = useCallback((path: string) => {
         setCurrentPath(path);
@@ -136,7 +142,7 @@ export function ManGoNewAgentWizard(props: ManGoNewAgentWizardProps) {
         >
             <ManGoOnboardingNavigationContext.Provider value={navigationContextValue}>
                 <OnboardingProvider>
-                    <WizardShell>
+                    <WizardShell defaultVisibility={defaultVisibility} onOpenEditor={onOpenEditor}>
                         {renderManGoWizardStep({
                             currentPath,
                             defaultVisibility,

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

@@ -1,22 +1,102 @@
 import type { CSSProperties, ReactNode } from 'react';
+import { BookOpen } from 'lucide-react';
 
+import type { AgentVisibility } from '../../../../utils/agentVisibility';
+import type { NewAgentOpenEditorRequest } from '../../NewAgentOpenEditorRequest';
 import { ONBOARDING_FLOW, getFlowIndexByPath } from '../config/steps';
 import { useManGoOnboardingNavigation } from '../ManGoOnboardingNavigation';
+import { createManGoOpenEditorRequest } from '../services/createManGoOpenEditorRequest';
 import { useOnboarding } from '../state/OnboardingProvider';
 import { Logo } from './Logo';
 import { RailStepper } from './RailStepper';
 import { RailArtwork } from './brand/RailArtwork';
 
+/**
+ * Accessible label for switching from manGo to the classic Book editor.
+ *
+ * @private internal constant of <WizardShell/>.
+ */
+const OPEN_CLASSIC_BOOK_EDITOR_LABEL = 'Otevřít klasický editor booku';
+
+/**
+ * Completion-step path where the wizard may already have persisted the agent.
+ *
+ * @private internal constant of <WizardShell/>.
+ */
+const ONBOARDING_DONE_PATH = ONBOARDING_FLOW.find((step) => step.id === 'done')?.path;
+
+/**
+ * Props for the classic Book editor icon button.
+ */
+type ClassicBookEditorButtonProps = {
+    /**
+     * Opens the classic Book editor with the current draft.
+     */
+    readonly onOpenEditor: () => void;
+
+    /**
+     * Size and color styling for the current rail layout.
+     */
+    readonly className: string;
+};
+
+/**
+ * Props for the imported manGo wizard shell.
+ */
+type WizardShellProps = {
+    /**
+     * Active wizard content.
+     */
+    readonly children: ReactNode;
+
+    /**
+     * Metadata-backed default visibility for newly created agents.
+     */
+    readonly defaultVisibility: AgentVisibility;
+
+    /**
+     * Switches from manGo onboarding to the classic Book editor before creation.
+     */
+    readonly onOpenEditor: (request: NewAgentOpenEditorRequest) => void;
+};
+
+/**
+ * Desktop rail gradient used by the manGo wizard shell.
+ *
+ * @private internal constant of <WizardShell/>.
+ */
 const RAIL_GRADIENT: CSSProperties = {
     backgroundImage: 'var(--ob-grad-ink)',
 };
 
+/**
+ * Renders the shared icon-only action that exits manGo into the classic Book editor.
+ *
+ * @param props - Button event handler and layout-specific class names.
+ * @returns Classic editor button.
+ */
+function ClassicBookEditorButton(props: ClassicBookEditorButtonProps) {
+    const { className, onOpenEditor } = props;
+
+    return (
+        <button
+            type="button"
+            onClick={onOpenEditor}
+            aria-label={OPEN_CLASSIC_BOOK_EDITOR_LABEL}
+            title={OPEN_CLASSIC_BOOK_EDITOR_LABEL}
+            className={className}
+        >
+            <BookOpen className="h-4 w-4" />
+        </button>
+    );
+}
+
 /**
  * Split-screen wizard chrome: a persistent accent rail (brand identity, agent name,
  * vertical stepper, progress) beside the active step. The rail collapses to a compact
  * top bar on small screens.
  */
-export function WizardShell({ children }: { readonly children: ReactNode }) {
+export function WizardShell({ children, defaultVisibility, onOpenEditor }: WizardShellProps) {
     const { currentPath, requestClose } = useManGoOnboardingNavigation();
     const { state } = useOnboarding();
 
@@ -24,9 +104,17 @@ export function WizardShell({ children }: { readonly children: ReactNode }) {
     const total = ONBOARDING_FLOW.length;
     const progress = Math.round(((activeIndex + 1) / total) * 100);
     const agentName = state.agentName.trim() || 'Váš nový agent';
+    const isClassicBookEditorButtonVisible = currentPath !== ONBOARDING_DONE_PATH;
+
+    /**
+     * Opens the classic Book editor with the current manGo draft.
+     */
+    function handleOpenEditor(): void {
+        onOpenEditor(createManGoOpenEditorRequest(state, defaultVisibility));
+    }
 
     return (
-        <div data-onboarding-ui className="flex min-h-screen flex-col bg-zinc-50 text-zinc-900 lg:flex-row">
+        <div data-onboarding-ui className="flex h-[100dvh] min-h-0 flex-col overflow-hidden bg-zinc-50 text-zinc-900 lg:flex-row">
             {/* Mobile: compact top bar */}
             <div className="relative overflow-hidden text-white lg:hidden" style={RAIL_GRADIENT}>
                 <div className="relative z-10 flex items-center justify-between px-5 py-3.5">
@@ -38,14 +126,22 @@ export function WizardShell({ children }: { readonly children: ReactNode }) {
                         <Logo className="text-white" />
                     </button>
                     <span className="max-w-[40%] truncate text-[13px] text-white/80">{agentName}</span>
-                    <button
-                        type="button"
-                        onClick={requestClose}
-                        aria-label="Zavřít průvodce"
-                        className="flex h-8 w-8 items-center justify-center rounded-lg text-xl leading-none text-white/70 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
-                    >
-                        ×
-                    </button>
+                    <div className="flex items-center gap-1">
+                        {isClassicBookEditorButtonVisible && (
+                            <ClassicBookEditorButton
+                                onOpenEditor={handleOpenEditor}
+                                className="flex h-8 w-8 items-center justify-center rounded-lg text-white/70 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                            />
+                        )}
+                        <button
+                            type="button"
+                            onClick={requestClose}
+                            aria-label="Zavřít průvodce"
+                            className="flex h-8 w-8 items-center justify-center rounded-lg text-xl leading-none text-white/70 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                        >
+                            ×
+                        </button>
+                    </div>
                 </div>
                 <div className="relative z-10 overflow-x-auto px-5 pb-3.5">
                     <RailStepper activeIndex={activeIndex} orientation="horizontal" />
@@ -54,11 +150,11 @@ export function WizardShell({ children }: { readonly children: ReactNode }) {
 
             {/* Desktop: persistent side rail */}
             <aside
-                className="relative hidden w-80 flex-shrink-0 overflow-hidden p-7 text-white lg:sticky lg:top-0 lg:flex lg:h-screen lg:flex-col"
+                className="relative hidden w-80 flex-shrink-0 overflow-hidden text-white lg:sticky lg:top-0 lg:flex lg:h-screen lg:flex-col"
                 style={RAIL_GRADIENT}
             >
                 <RailArtwork />
-                <div className="relative z-10 flex h-full flex-col">
+                <div className="relative z-10 flex min-h-0 w-full flex-1 flex-col overflow-y-auto overflow-x-hidden overscroll-contain p-7">
                     <div className="flex items-center justify-between gap-3">
                         <button
                             type="button"
@@ -67,14 +163,22 @@ export function WizardShell({ children }: { readonly children: ReactNode }) {
                         >
                             <Logo className="text-white" />
                         </button>
-                        <button
-                            type="button"
-                            onClick={requestClose}
-                            aria-label="Zavřít průvodce"
-                            className="flex h-9 w-9 items-center justify-center rounded-lg text-2xl leading-none text-white/55 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
-                        >
-                            ×
-                        </button>
+                        <div className="flex items-center gap-1">
+                            {isClassicBookEditorButtonVisible && (
+                                <ClassicBookEditorButton
+                                    onOpenEditor={handleOpenEditor}
+                                    className="flex h-9 w-9 items-center justify-center rounded-lg text-white/55 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                                />
+                            )}
+                            <button
+                                type="button"
+                                onClick={requestClose}
+                                aria-label="Zavřít průvodce"
+                                className="flex h-9 w-9 items-center justify-center rounded-lg text-2xl leading-none text-white/55 transition-colors hover:bg-white/10 hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50"
+                            >
+                                ×
+                            </button>
+                        </div>
                     </div>
 
                     <div className="mt-10">
@@ -106,7 +210,7 @@ export function WizardShell({ children }: { readonly children: ReactNode }) {
                 </div>
             </aside>
 
-            <main className="flex-1 px-5 py-8 sm:px-8 sm:py-12">
+            <main className="min-h-0 min-w-0 flex-1 overflow-y-auto overflow-x-hidden overscroll-contain px-5 py-8 sm:px-8 sm:py-12">
                 <div className="ob-animate-rise">{children}</div>
             </main>
         </div>

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

@@ -1,30 +1,34 @@
+import { postManGoOnboardingJson } from './postManGoOnboardingJson';
+
+/**
+ * One result check shown after the step 4 test run.
+ */
 export type ReplyCheck = {
     readonly status: 'ok' | 'warn';
     readonly text: string;
 };
 
 /**
- * Boundary to the `evaluateAgentReply` server function — judges a proposed reply against
- * the book and returns pass/warn checks for the Test step's result panel.
+ * Response returned by the manGo step 4 evaluator endpoint.
+ *
+ * @private internal type of the manGo agent evaluation service.
+ */
+type EvaluateReplyResponse = {
+    readonly checks: ReplyCheck[];
+};
+
+/**
+ * Boundary to the manGo evaluator endpoint that judges a proposed reply against the book.
  *
  * @param input - Current Book source, customer input, and generated preview reply.
- * @returns Lightweight local checks for the preview result.
+ * @returns AI-generated checks for the preview result.
  */
 export async function evaluateReply(input: {
     readonly bookSource: string;
     readonly customerEmail: string;
     readonly reply: string;
 }): Promise<ReplyCheck[]> {
-    return [
-        {
-            status: input.bookSource.trim() && input.reply.trim() ? 'ok' : 'warn',
-            text: input.bookSource.trim()
-                ? 'Book je pro testovací běh vyplněný.'
-                : 'Book je prázdný, odpověď je pouze obecný náhled.',
-        },
-        {
-            status: input.customerEmail.trim() ? 'ok' : 'warn',
-            text: input.customerEmail.trim() ? 'Testovací vstup je vyplněný.' : 'Doplňte testovací vstup.',
-        },
-    ];
+    const response = await postManGoOnboardingJson<EvaluateReplyResponse>('/api/onboarding/evaluate', input);
+
+    return response.checks;
 }

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

@@ -1,29 +1,39 @@
-import { spaceTrim } from 'spacetrim';
-
 import type { ChatMessage, KnowledgeItem } from '../types';
+import { postManGoOnboardingJson } from './postManGoOnboardingJson';
 
+/**
+ * Request sent by the step 4 test UI.
+ */
 export type AgentTestRequest = {
     readonly bookSource: string;
     readonly knowledge: readonly KnowledgeItem[];
     readonly messages: readonly ChatMessage[];
 };
 
+/**
+ * Reply returned by the live step 4 agent test.
+ */
 export type AgentTestReply = {
     readonly role: 'agent';
     readonly content: string;
 };
 
 /**
- * Boundary for "run the agent against a test message". Backed by the `runAgentTest`
- * server function (Promptbook `LiteAgent`). The UI depends only on this interface — see
- * the wizard Test step.
+ * Boundary for "run the agent against a test message".
  */
 export type AgentTestService = {
     send(request: AgentTestRequest): Promise<AgentTestReply>;
-}
+};
 
-/** Public URLs of knowledge sources that finished uploading (files → S3 URL, links → URL). */
-function knowledgeUrls(knowledge: readonly KnowledgeItem[]): string[] {
+/**
+ * Public URLs of knowledge sources that finished uploading.
+ *
+ * @param knowledge - Wizard knowledge items.
+ * @returns Public knowledge URLs.
+ *
+ * @private internal helper of the manGo agent test service.
+ */
+function knowledgeUrls(knowledge: readonly KnowledgeItem[]): readonly string[] {
     return knowledge
         .filter((item) => item.status === 'ready')
         .map((item) => (item.kind === 'url' ? item.url : item.publicUrl))
@@ -31,39 +41,25 @@ function knowledgeUrls(knowledge: readonly KnowledgeItem[]): string[] {
 }
 
 /**
- * Resolves the last user message sent to the preview responder.
+ * API payload sent to the step 4 test endpoint.
  *
- * @param messages - Chat history collected in the test step.
- * @returns Most recent user message content.
+ * @private internal type of the manGo agent test service.
  */
-function getLastUserMessage(messages: readonly ChatMessage[]): string {
-    for (let index = messages.length - 1; index >= 0; index -= 1) {
-        const message = messages[index];
-        if (message.role === 'user') {
-            return message.content;
-        }
-    }
-
-    return '';
-}
+type AgentTestApiRequest = {
+    readonly bookSource: string;
+    readonly knowledge: readonly string[];
+    readonly messages: ReadonlyArray<Pick<ChatMessage, 'role' | 'content'>>;
+};
 
+/**
+ * Endpoint-backed service used by the step 4 test UI.
+ */
 export const agentTestService: AgentTestService = {
     async send(request) {
-        const lastUserMessage = getLastUserMessage(request.messages);
-        const readyKnowledgeUrls = knowledgeUrls(request.knowledge);
-        const reply = spaceTrim(`
-            Návrh odpovědi podle aktuálního booku:
-
-            Rozumím požadavku: "${lastUserMessage || 'bez zadání'}"
-
-            Doporučený postup:
-            1. Odpovědět věcně a stručně podle pravidel v booku.
-            2. Zmínit dostupný kontext ze znalostní báze${
-                readyKnowledgeUrls.length > 0 ? ` (${readyKnowledgeUrls.length} zdrojů)` : ''
-            }.
-            3. Pokud chybí jistota, požádat o doplnění nebo předat člověku.
-        `);
-
-        return { role: 'agent', content: reply };
+        return postManGoOnboardingJson<AgentTestReply>('/api/onboarding/test', {
+            bookSource: request.bookSource,
+            knowledge: knowledgeUrls(request.knowledge),
+            messages: request.messages.map((message) => ({ role: message.role, content: message.content })),
+        } satisfies AgentTestApiRequest);
     },
 };