@promptbook/cli 0.112.0-97 → 0.112.0-98

package/apps/agents-server/src/app/agents/[agentName]/chat/CanonicalAgentChatSurface.tsx

@@ -3,14 +3,17 @@
 import { Chat } from '@promptbook-local/components';
 import { useCallback, useMemo, type CSSProperties, type ReactNode } from 'react';
 import type { ChatParticipant } from '../../../../../../../src/book-components/Chat/types/ChatParticipant';
+import type { ChatSaveFormatHandlerOptions } from '../../../../../../../src/book-components/Chat/save/_common/ChatSaveFormatHandler';
 import { useAgentBackground } from '../../../../components/AgentProfile/useAgentBackground';
 import { useChatEnterBehaviorPreferences } from '../../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
+import { notifyError } from '../../../../components/Notifications/notifications';
 import { useChatVisualMode } from '../../../../components/ChatVisualMode/ChatVisualModeProvider';
 import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
 import { ChatThreadLoadingSkeleton } from '../../../../components/Skeleton/ChatThreadLoadingSkeleton';
 import { useSoundSystem } from '../../../../components/SoundSystemProvider/SoundSystemProvider';
 import { usePromptbookTheme } from '../../../../components/ThemeMode/usePromptbookTheme';
 import { createDefaultChatEffects } from '../../../../utils/chat/createDefaultChatEffects';
+import { downloadChatPdfFromServer } from '../../../../utils/chatExport/downloadChatPdfFromServer';
 import { executeQuickActionButton } from '../../../../utils/chat/executeQuickActionButton';
 import {
     isChatFeedbackEnabled,
@@ -175,6 +178,26 @@ export function CanonicalAgentChatSurface({
             </button>
         );
     }, [cancellableJob, isReadOnly, onCancelActiveJob, translateText]);
+    const handlePdfSaveFormat = useCallback(
+        async ({ title, messages, participants }: ChatSaveFormatHandlerOptions) => {
+            try {
+                await downloadChatPdfFromServer({
+                    title,
+                    messages,
+                    participants,
+                });
+            } catch (error) {
+                notifyError(error instanceof Error ? error.message : 'Failed to export chat as PDF.');
+            }
+        },
+        [],
+    );
+    const saveFormatHandlers = useMemo(
+        () => ({
+            pdf: handlePdfSaveFormat,
+        }),
+        [handlePdfSaveFormat],
+    );
     const extraActionNodes = useMemo(
         () => (
             <>
@@ -235,6 +258,7 @@ export function CanonicalAgentChatSurface({
             elevenLabsVoiceId={state.elevenLabsVoiceId}
             teamAgentProfiles={state.teamAgentProfiles}
             extraActions={extraActionNodes}
+            saveFormatHandlers={saveFormatHandlers}
             theme={promptbookTheme}
         >
             {isReadOnly && frozenChatBannerLabel && (

package/apps/agents-server/src/app/api/admin/cli-access/route.ts

@@ -0,0 +1,137 @@
+import { NextResponse } from 'next/server';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { createInteractiveTerminalEventStream } from '@/src/utils/createInteractiveTerminalEventStream';
+import {
+    getLatestServerCliAccessSession,
+    getServerCliAccessSession,
+    startServerCliAccessSession,
+    stopServerCliAccessSession,
+    subscribeToServerCliAccessSession,
+    writeServerCliAccessSessionInput,
+} from '@/src/utils/serverCliAccess';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+/**
+ * Loads the latest CLI access session or streams a specific terminal session.
+ */
+export async function GET(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const { searchParams } = new URL(request.url);
+        const sessionId = searchParams.get('sessionId')?.trim() || '';
+        const isStreamRequested = searchParams.get('stream') === '1';
+
+        if (isStreamRequested) {
+            if (!sessionId) {
+                return NextResponse.json({ error: 'CLI access session id is required.' }, { status: 400 });
+            }
+
+            const session = getServerCliAccessSession(sessionId);
+            if (!session) {
+                return NextResponse.json({ error: 'CLI access session was not found.' }, { status: 404 });
+            }
+
+            return createInteractiveTerminalEventStream(
+                request,
+                sessionId,
+                session,
+                subscribeToServerCliAccessSession,
+            );
+        }
+
+        return NextResponse.json({
+            session: getLatestServerCliAccessSession(),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load the CLI access session.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Starts or reconnects to the raw server shell exposed in the browser.
+ */
+export async function POST() {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        return NextResponse.json({
+            session: await startServerCliAccessSession(),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to start the CLI access session.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Sends raw input to the running CLI access shell.
+ */
+export async function PATCH(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as
+            | {
+                  readonly sessionId?: string;
+                  readonly input?: string;
+              }
+            | null;
+
+        if (!body?.sessionId || typeof body.input !== 'string') {
+            return NextResponse.json({ error: 'CLI access session input is required.' }, { status: 400 });
+        }
+
+        return NextResponse.json({
+            session: writeServerCliAccessSessionInput(body.sessionId, body.input),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to send CLI access input.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Stops one running CLI access shell session.
+ */
+export async function DELETE(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as
+            | {
+                  readonly sessionId?: string;
+              }
+            | null;
+
+        if (!body?.sessionId) {
+            return NextResponse.json({ error: 'CLI access session id is required.' }, { status: 400 });
+        }
+
+        return NextResponse.json({
+            session: stopServerCliAccessSession(body.sessionId),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to stop the CLI access session.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/code-runners/authentication/route.ts

@@ -1,5 +1,6 @@
 import { NextResponse } from 'next/server';
 import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { createInteractiveTerminalEventStream } from '@/src/utils/createInteractiveTerminalEventStream';
 import {
     getCodeRunnerAuthenticationSession,
     getLatestCodeRunnerAuthenticationSession,
@@ -36,7 +37,12 @@ export async function GET(request: Request) {
                 return NextResponse.json({ error: 'Authentication session was not found.' }, { status: 404 });
             }
 
-            return createCodeRunnerAuthenticationEventStream(request, sessionId, session);
+            return createInteractiveTerminalEventStream(
+                request,
+                sessionId,
+                session,
+                subscribeToCodeRunnerAuthenticationSession,
+            );
         }
 
         const { agent } = await readConfiguredCodeRunner();
@@ -132,66 +138,3 @@ export async function DELETE(request: Request) {
         );
     }
 }
-
-/**
- * Creates one SSE response that replays buffered output and then streams live terminal events.
- *
- * @param request - Browser stream request.
- * @param sessionId - Authentication session id.
- * @param session - Existing session snapshot.
- * @returns Event stream response.
- */
-function createCodeRunnerAuthenticationEventStream(
-    request: Request,
-    sessionId: string,
-    session: NonNullable<ReturnType<typeof getCodeRunnerAuthenticationSession>>,
-): Response {
-    const encoder = new TextEncoder();
-
-    return new Response(
-        new ReadableStream({
-            start(controller) {
-                const emitEvent = (event: string, payload: unknown) => {
-                    controller.enqueue(encoder.encode(`event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`));
-                };
-
-                emitEvent('snapshot', session);
-
-                if (!session.isRunning) {
-                    controller.close();
-                    return;
-                }
-
-                const unsubscribe = subscribeToCodeRunnerAuthenticationSession(sessionId, {
-                    onOutput: ({ chunk }) => emitEvent('output', { chunk }),
-                    onExit: ({ snapshot: nextSession }) => {
-                        emitEvent('exit', nextSession);
-                        unsubscribe?.();
-                        controller.close();
-                    },
-                });
-
-                if (!unsubscribe) {
-                    controller.error(new Error('Authentication session was not found.'));
-                    return;
-                }
-
-                request.signal.addEventListener(
-                    'abort',
-                    () => {
-                        unsubscribe();
-                        controller.close();
-                    },
-                    { once: true },
-                );
-            },
-        }),
-        {
-            headers: {
-                'Content-Type': 'text/event-stream',
-                'Cache-Control': 'no-cache, no-transform',
-                Connection: 'keep-alive',
-            },
-        },
-    );
-}

package/apps/agents-server/src/app/api/admin/servers/[serverId]/route.ts

@@ -1,5 +1,5 @@
 import { NextResponse } from 'next/server';
-import { isAgentsServerStandaloneMode } from '../../../../../database/agentsServerDatabaseMode';
+import { isAgentsServerSqliteMode } from '../../../../../database/agentsServerDatabaseMode';
 import { resolveCurrentServerRegistryContext } from '../../../../../utils/currentServerRegistryContext';
 import { isUserGlobalAdmin } from '../../../../../utils/isUserGlobalAdmin';
 import {
@@ -37,7 +37,7 @@ export async function PATCH(request: Request, context: { params: Promise<{ serve
         const body = (await request.json()) as Omit<UpdateServerInput, 'id'>;
         const parsedServerId = parseManagedServerId(serverId);
 
-        if (isAgentsServerStandaloneMode()) {
+        if (isAgentsServerSqliteMode()) {
             const updatedServer = await updateStandaloneVpsServerDomain(parsedServerId, body.domain);
             await applyStandaloneVpsServerMetadata({
                 tablePrefix: updatedServer.tablePrefix,
@@ -76,7 +76,7 @@ export async function DELETE(_request: Request, context: { params: Promise<{ ser
         const { serverId } = await context.params;
         const parsedServerId = parseManagedServerId(serverId);
 
-        if (isAgentsServerStandaloneMode()) {
+        if (isAgentsServerSqliteMode()) {
             await deleteStandaloneVpsServerDomain(parsedServerId);
             return NextResponse.json({
                 success: true,

package/apps/agents-server/src/app/api/admin/servers/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server';
 import { spaceTrim } from 'spacetrim';
 import { DatabaseError } from '../../../../../../../src/errors/DatabaseError';
-import { isAgentsServerStandaloneMode } from '../../../../database/agentsServerDatabaseMode';
+import { isAgentsServerSqliteMode } from '../../../../database/agentsServerDatabaseMode';
 import { resolveCurrentServerRegistryContext } from '../../../../utils/currentServerRegistryContext';
 import { isUserAdmin } from '../../../../utils/isUserAdmin';
 import { isUserGlobalAdmin } from '../../../../utils/isUserGlobalAdmin';
@@ -41,7 +41,7 @@ export async function GET() {
         }
 
         const context = await resolveCurrentServerRegistryContext();
-        const servers = isAgentsServerStandaloneMode()
+        const servers = isAgentsServerSqliteMode()
             ? await createStandaloneVpsServersResponse(context.registeredServers)
             : context.registeredServers;
 
@@ -49,7 +49,7 @@ export async function GET() {
             servers,
             currentServerId: context.currentServer?.id ?? null,
             canEdit: await isUserGlobalAdmin(),
-            isStandaloneVps: isAgentsServerStandaloneMode(),
+            isStandaloneVps: isAgentsServerSqliteMode(),
         });
     } catch (error) {
         return NextResponse.json(
@@ -96,7 +96,7 @@ export async function POST(request: Request) {
         assertGlobalAdminAccess(await isUserGlobalAdmin());
 
         const body = withEnvironmentAdminUser((await request.json()) as CreateServerInput);
-        if (isAgentsServerStandaloneMode()) {
+        if (isAgentsServerSqliteMode()) {
             const normalizedDomain = normalizeServerDomain(body.domain);
             if (!normalizedDomain) {
                 return NextResponse.json({ error: 'A valid domain is required.' }, { status: 400 });

package/apps/agents-server/src/app/api/chat/export/pdf/route.ts

@@ -0,0 +1,63 @@
+import { buildChatHtml } from '../../../../../../../../src/book-components/Chat/save/html/htmlSaveFormatDefinition';
+import type { ChatMessage } from '../../../../../../../../src/book-components/Chat/types/ChatMessage';
+import type { ChatParticipant } from '../../../../../../../../src/book-components/Chat/types/ChatParticipant';
+import { createChatExportFilename } from '../../../../../../../../src/book-components/Chat/save/_common/createChatExportFilename';
+import { NextRequest, NextResponse } from 'next/server';
+import { renderHtmlToPdfOnServer } from '@/src/utils/chatExport/renderHtmlToPdfOnServer';
+
+/**
+ * PDF export requires the Node.js runtime because it depends on Playwright.
+ */
+export const runtime = 'nodejs';
+
+/**
+ * Minimal request payload accepted by the chat PDF export endpoint.
+ *
+ * @private internal type for POST /api/chat/export/pdf
+ */
+type ChatPdfExportRequestBody = {
+    readonly title: string;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly participants: ReadonlyArray<ChatParticipant>;
+};
+
+/**
+ * Builds a server-rendered PDF from the standalone HTML chat export.
+ */
+export async function POST(request: NextRequest) {
+    let requestBody: ChatPdfExportRequestBody;
+
+    try {
+        requestBody = (await request.json()) as ChatPdfExportRequestBody;
+    } catch {
+        return NextResponse.json({ error: 'Invalid JSON payload.' }, { status: 400 });
+    }
+
+    if (
+        typeof requestBody?.title !== 'string' ||
+        !Array.isArray(requestBody.messages) ||
+        !Array.isArray(requestBody.participants)
+    ) {
+        return NextResponse.json(
+            { error: 'Expected `title`, `messages`, and `participants` in the PDF export payload.' },
+            { status: 400 },
+        );
+    }
+
+    try {
+        const pdfBuffer = await renderHtmlToPdfOnServer(
+            buildChatHtml(requestBody.title, requestBody.messages, requestBody.participants),
+        );
+        const filename = createChatExportFilename(requestBody.title, 'pdf');
+
+        return new NextResponse(pdfBuffer, {
+            headers: {
+                'Content-Type': 'application/pdf',
+                'Content-Disposition': `attachment; filename="${filename}"`,
+            },
+        });
+    } catch (error) {
+        console.error('Failed to export chat PDF:', error);
+        return NextResponse.json({ error: 'Failed to export chat as PDF.' }, { status: 500 });
+    }
+}

package/apps/agents-server/src/components/AdminTerminal/AdminTerminalCard.tsx

@@ -0,0 +1,279 @@
+'use client';
+
+import { Loader2, Play, Send, SquareTerminal } from 'lucide-react';
+import type { ReactNode } from 'react';
+import { useEffect, useRef } from 'react';
+import { Card } from '../Homepage/Card';
+import type { AdminTerminalSession } from './useAdminTerminalSession';
+
+/**
+ * One quick terminal action rendered next to the input box.
+ */
+type AdminTerminalQuickAction = {
+    /**
+     * Visible button label.
+     */
+    readonly label: string;
+
+    /**
+     * Raw terminal input sent when the button is clicked.
+     */
+    readonly input: string;
+};
+
+/**
+ * Props accepted by the shared admin terminal card.
+ */
+type AdminTerminalCardProps<TSession extends AdminTerminalSession> = {
+    /**
+     * Title shown above the terminal card.
+     */
+    readonly title: string;
+
+    /**
+     * Short description of what the terminal is for.
+     */
+    readonly description: string;
+
+    /**
+     * Optional extra hint shown below the description.
+     */
+    readonly hint?: string;
+
+    /**
+     * Active or latest terminal session snapshot.
+     */
+    readonly session: TSession | null;
+
+    /**
+     * Controlled terminal input value.
+     */
+    readonly input: string;
+
+    /**
+     * Updates the controlled terminal input.
+     */
+    readonly onInputChange: (value: string) => void;
+
+    /**
+     * Starts or reconnects to the terminal session.
+     */
+    readonly onStart: () => void;
+
+    /**
+     * Stops the active terminal session.
+     */
+    readonly onStop: () => void;
+
+    /**
+     * Sends one raw input chunk to the terminal.
+     */
+    readonly onSend: (input: string) => void;
+
+    /**
+     * Whether the surrounding page is still loading the initial terminal state.
+     */
+    readonly isLoading?: boolean;
+
+    /**
+     * Whether a session start request is currently pending.
+     */
+    readonly isStarting?: boolean;
+
+    /**
+     * Whether a terminal input request is currently pending.
+     */
+    readonly isSending?: boolean;
+
+    /**
+     * Whether a session stop request is currently pending.
+     */
+    readonly isStopping?: boolean;
+
+    /**
+     * Label used for the start button while the session is idle.
+     */
+    readonly startLabel: string;
+
+    /**
+     * Label used for the start button while the session is already running.
+     */
+    readonly runningLabel?: string;
+
+    /**
+     * Label used for the stop button.
+     */
+    readonly stopLabel: string;
+
+    /**
+     * Label shown above the terminal output.
+     */
+    readonly outputLabel: string;
+
+    /**
+     * Empty-state text shown before any terminal output exists.
+     */
+    readonly outputEmptyState: string;
+
+    /**
+     * Placeholder used by the terminal input control.
+     */
+    readonly inputPlaceholder: string;
+
+    /**
+     * Optional shortcut buttons that send raw terminal input.
+     */
+    readonly quickActions?: ReadonlyArray<AdminTerminalQuickAction>;
+
+    /**
+     * Optional extra content inserted between the description and the terminal output.
+     */
+    readonly children?: ReactNode;
+};
+
+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 disabled:bg-gray-50 disabled:text-gray-500';
+
+/**
+ * Shared terminal card used by super-admin pages that expose interactive browser terminals.
+ */
+export function AdminTerminalCard<TSession extends AdminTerminalSession>({
+    title,
+    description,
+    hint,
+    session,
+    input,
+    onInputChange,
+    onStart,
+    onStop,
+    onSend,
+    isLoading = false,
+    isStarting = false,
+    isSending = false,
+    isStopping = false,
+    startLabel,
+    runningLabel,
+    stopLabel,
+    outputLabel,
+    outputEmptyState,
+    inputPlaceholder,
+    quickActions = [],
+    children,
+}: AdminTerminalCardProps<TSession>) {
+    const outputReference = useRef<HTMLPreElement | null>(null);
+
+    useEffect(() => {
+        if (!outputReference.current) {
+            return;
+        }
+
+        outputReference.current.scrollTop = outputReference.current.scrollHeight;
+    }, [session?.output]);
+
+    return (
+        <Card className="hover:border-gray-200 hover:shadow-md">
+            <div className="space-y-4">
+                <div className="space-y-2">
+                    <h2 className="text-lg font-semibold text-slate-900">{title}</h2>
+                    <p className="text-sm text-slate-600">{description}</p>
+                    {hint ? <p className="text-sm text-slate-600">{hint}</p> : null}
+                </div>
+
+                <div className="flex flex-wrap items-center gap-3">
+                    <button
+                        type="button"
+                        onClick={onStart}
+                        disabled={isLoading || isStarting || session?.isRunning}
+                        className="inline-flex items-center gap-2 rounded-md bg-slate-900 px-4 py-2 text-sm font-semibold text-white hover:bg-slate-800 disabled:cursor-not-allowed disabled:opacity-60"
+                    >
+                        {isStarting ? <Loader2 className="h-4 w-4 animate-spin" /> : <Play className="h-4 w-4" />}
+                        {session?.isRunning ? runningLabel || startLabel : startLabel}
+                    </button>
+                    <button
+                        type="button"
+                        onClick={onStop}
+                        disabled={!session?.isRunning || isStopping}
+                        className="inline-flex items-center gap-2 rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-60"
+                    >
+                        {isStopping ? (
+                            <Loader2 className="h-4 w-4 animate-spin" />
+                        ) : (
+                            <SquareTerminal className="h-4 w-4" />
+                        )}
+                        {stopLabel}
+                    </button>
+                </div>
+
+                {children}
+
+                <div className="space-y-2">
+                    <div className="flex flex-wrap items-center justify-between gap-3">
+                        <h3 className="text-sm font-semibold text-slate-700">{outputLabel}</h3>
+                        {session ? (
+                            <span className="text-xs text-slate-500">
+                                {session.isRunning
+                                    ? 'Running'
+                                    : session.exitCode === 0
+                                      ? 'Finished successfully'
+                                      : 'Finished with an error'}
+                            </span>
+                        ) : (
+                            <span className="text-xs text-slate-500">No session started yet.</span>
+                        )}
+                    </div>
+                    <pre
+                        ref={outputReference}
+                        className="max-h-96 overflow-auto rounded-xl border border-slate-200 bg-slate-950 p-4 text-xs text-slate-100"
+                    >
+                        {session?.output || outputEmptyState}
+                    </pre>
+                </div>
+
+                <form
+                    className="flex flex-col gap-3 md:flex-row"
+                    onSubmit={(event) => {
+                        event.preventDefault();
+
+                        if (!input.trim()) {
+                            return;
+                        }
+
+                        const formattedInput = input.endsWith('\n') ? input : `${input}\n`;
+                        onSend(formattedInput);
+                        onInputChange('');
+                    }}
+                >
+                    <input
+                        type="text"
+                        value={input}
+                        onChange={(event) => onInputChange(event.target.value)}
+                        disabled={!session?.isRunning || isSending}
+                        placeholder={inputPlaceholder}
+                        className={INPUT_CLASS_NAME}
+                    />
+                    <div className="flex flex-wrap gap-3">
+                        <button
+                            type="submit"
+                            disabled={!session?.isRunning || isSending || input.trim() === ''}
+                            className="inline-flex items-center justify-center gap-2 rounded-md bg-blue-600 px-4 py-2 text-sm font-semibold text-white hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-60"
+                        >
+                            {isSending ? <Loader2 className="h-4 w-4 animate-spin" /> : <Send className="h-4 w-4" />}
+                            Send
+                        </button>
+                        {quickActions.map((quickAction) => (
+                            <button
+                                key={`${quickAction.label}:${quickAction.input}`}
+                                type="button"
+                                onClick={() => onSend(quickAction.input)}
+                                disabled={!session?.isRunning || isSending}
+                                className="inline-flex items-center justify-center rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-60"
+                            >
+                                {quickAction.label}
+                            </button>
+                        ))}
+                    </div>
+                </form>
+            </div>
+        </Card>
+    );
+}