@promptbook/cli 0.112.0-93 → 0.112.0-96

package/apps/agents-server/next.config.ts

@@ -36,7 +36,14 @@ const nextConfig: NextConfig = {
     eslint: {
         ignoreDuringBuilds: isNextValidationIgnored,
     },
-    serverExternalPackages: ['pg', '@napi-rs/canvas', 'playwright', 'playwright-core'],
+    serverExternalPackages: [
+        'pg',
+        'better-sqlite3',
+        '@prisma/studio-core',
+        '@napi-rs/canvas',
+        'playwright',
+        'playwright-core',
+    ],
     typescript: {
         ignoreBuildErrors: isNextValidationIgnored,
     },

package/apps/agents-server/playwright.config.ts

@@ -28,6 +28,8 @@ const APP_E2E_ENV = {
     ADMIN_PASSWORD: 'e2e-admin-password',
     NEXT_DIST_DIR: '.next-e2e',
     NEXT_PUBLIC_SITE_URL: APP_URL,
+    PTBK_AGENTS_SERVER_DATABASE: 'supabase',
+    PTBK_AGENTS_SERVER_SQLITE_PATH: '',
     SUPABASE_TABLE_PREFIX: '',
     POSTGRES_URL: '',
     DATABASE_URL: '',

package/apps/agents-server/src/app/admin/_components/AdminConfigurationShell.tsx

@@ -6,7 +6,7 @@ import Link from 'next/link';
  *
  * @private admin configuration UI helper
  */
-type AdminConfigurationPage = 'metadata' | 'limits';
+type AdminConfigurationPage = 'environment' | 'metadata' | 'limits';
 
 /**
  * One shared navigation item rendered in the configuration shell.
@@ -15,15 +15,21 @@ type AdminConfigurationPage = 'metadata' | 'limits';
  */
 const ADMIN_CONFIGURATION_NAVIGATION_ITEMS: ReadonlyArray<{
     readonly id: AdminConfigurationPage;
-    readonly href: '/admin/metadata' | '/admin/limits';
+    readonly href: '/admin/environment' | '/admin/metadata' | '/admin/limits';
     readonly label: string;
     readonly description: string;
 }> = [
+    {
+        id: 'environment',
+        href: '/admin/environment',
+        label: 'Environment variables',
+        description: 'VPS-wide .env values with secrets masked in the browser.',
+    },
     {
         id: 'metadata',
         href: '/admin/metadata',
         label: 'Metadata',
-        description: 'Feature flags, text settings, and legacy compatibility keys.',
+        description: 'Domain-specific feature flags, text settings, and compatibility keys.',
     },
     {
         id: 'limits',
@@ -44,7 +50,7 @@ type AdminConfigurationShellProps = {
 };
 
 /**
- * Shared page shell used by the Metadata and Limits admin pages.
+ * Shared page shell used by the Environment variables, Metadata, and Limits admin pages.
  */
 export function AdminConfigurationShell({ activePage, children }: AdminConfigurationShellProps) {
     return (
@@ -53,11 +59,11 @@ export function AdminConfigurationShell({ activePage, children }: AdminConfigura
                 <div>
                     <h1 className="text-3xl font-light text-gray-900">Server configuration</h1>
                     <p className="mt-1 max-w-3xl text-sm text-gray-500">
-                        Manage raw metadata together with dedicated operational limits. Deprecated compatibility metadata
-                        stays visible, but active quota changes belong on the Limits page.
+                        Manage VPS-wide environment variables, domain-specific metadata, and dedicated operational
+                        limits from one configuration area.
                     </p>
                 </div>
-                <div className="grid gap-3 md:grid-cols-2">
+                <div className="grid gap-3 md:grid-cols-3">
                     {ADMIN_CONFIGURATION_NAVIGATION_ITEMS.map((item) => {
                         const isActive = item.id === activePage;
 

package/apps/agents-server/src/app/admin/code-runners/CodeRunnersClient.tsx

@@ -0,0 +1,225 @@
+'use client';
+
+import { Loader2, Save, ServerCog } from 'lucide-react';
+import { useEffect, useState } from 'react';
+import { Card } from '../../../components/Homepage/Card';
+
+/**
+ * Code-runner API response.
+ */
+type CodeRunnersResponse = {
+    readonly agent?: string;
+    readonly model?: string;
+    readonly thinkingLevel?: string;
+    readonly status?: string;
+    readonly applyResult?: {
+        readonly isAvailable: boolean;
+        readonly output: string;
+    } | null;
+    readonly error?: string;
+};
+
+/**
+ * Supported runner options shown by the standalone UI.
+ */
+const RUNNER_OPTIONS = [
+    { value: 'github-copilot', label: 'GitHub Copilot' },
+    { value: 'openai-codex', label: 'OpenAI Codex' },
+    { value: 'claude-code', label: 'Claude Code' },
+    { value: 'opencode', label: 'Opencode' },
+    { value: 'gemini', label: 'Gemini' },
+] as const;
+
+/**
+ * Shared input styling for code-runner controls.
+ */
+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';
+
+/**
+ * Client UI for configuring the local coding runner used by durable chats.
+ */
+export function CodeRunnersClient() {
+    const [agent, setAgent] = useState('github-copilot');
+    const [model, setModel] = useState('gpt-5.4');
+    const [thinkingLevel, setThinkingLevel] = useState('xhigh');
+    const [status, setStatus] = useState('');
+    const [isLoading, setIsLoading] = useState(true);
+    const [isSaving, setIsSaving] = useState(false);
+    const [errorMessage, setErrorMessage] = useState<string | null>(null);
+    const [successMessage, setSuccessMessage] = useState<string | null>(null);
+    const [applyOutput, setApplyOutput] = useState<string | null>(null);
+
+    useEffect(() => {
+        void loadConfiguration();
+    }, []);
+
+    /**
+     * Loads current code-runner settings.
+     */
+    async function loadConfiguration(): Promise<void> {
+        try {
+            setIsLoading(true);
+            setErrorMessage(null);
+            const response = await fetch('/api/admin/code-runners', { cache: 'no-store' });
+            const payload = (await response.json()) as CodeRunnersResponse;
+
+            if (!response.ok) {
+                throw new Error(payload.error || 'Failed to load code-runner configuration.');
+            }
+
+            setAgent(payload.agent || 'github-copilot');
+            setModel(payload.model || 'gpt-5.4');
+            setThinkingLevel(payload.thinkingLevel || 'xhigh');
+            setStatus(payload.status || '');
+        } catch (error) {
+            setErrorMessage(error instanceof Error ? error.message : 'Failed to load code-runner configuration.');
+        } finally {
+            setIsLoading(false);
+        }
+    }
+
+    /**
+     * Saves code-runner settings into `.env`.
+     */
+    async function saveConfiguration(applyRuntimeConfiguration: boolean): Promise<void> {
+        try {
+            setIsSaving(true);
+            setErrorMessage(null);
+            setSuccessMessage(null);
+            setApplyOutput(null);
+
+            const response = await fetch('/api/admin/code-runners', {
+                method: 'PATCH',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ agent, model, thinkingLevel, applyRuntimeConfiguration }),
+            });
+            const payload = (await response.json()) as CodeRunnersResponse;
+
+            if (!response.ok) {
+                throw new Error(payload.error || 'Failed to save code-runner configuration.');
+            }
+
+            setAgent(payload.agent || agent);
+            setModel(payload.model || model);
+            setThinkingLevel(payload.thinkingLevel || thinkingLevel);
+            setStatus(payload.status || '');
+            setApplyOutput(payload.applyResult?.output || null);
+            setSuccessMessage(
+                applyRuntimeConfiguration
+                    ? 'Code-runner configuration was saved and applied.'
+                    : 'Code-runner configuration was saved.',
+            );
+        } catch (error) {
+            setErrorMessage(error instanceof Error ? error.message : 'Failed to save code-runner configuration.');
+        } finally {
+            setIsSaving(false);
+        }
+    }
+
+    return (
+        <div className="container mx-auto space-y-6 px-4 py-8">
+            <div className="mt-20">
+                <h1 className="text-3xl font-light text-gray-900">Code runners</h1>
+                <p className="mt-1 text-sm text-gray-500">
+                    Configure the local runner used by the standalone Agents Server durable chat worker.
+                </p>
+            </div>
+
+            {errorMessage && (
+                <div className="rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
+                    {errorMessage}
+                </div>
+            )}
+            {successMessage && (
+                <div className="rounded-xl border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm text-emerald-700">
+                    {successMessage}
+                </div>
+            )}
+
+            <Card className="hover:border-gray-200 hover:shadow-md">
+                <div className="grid gap-5 md:grid-cols-3">
+                    <label className="space-y-2">
+                        <span className="text-sm font-semibold text-slate-700">Runner</span>
+                        <select
+                            value={agent}
+                            onChange={(event) => setAgent(event.target.value)}
+                            disabled={isLoading || isSaving}
+                            className={INPUT_CLASS_NAME}
+                        >
+                            {RUNNER_OPTIONS.map((option) => (
+                                <option key={option.value} value={option.value}>
+                                    {option.label}
+                                </option>
+                            ))}
+                        </select>
+                    </label>
+                    <label className="space-y-2">
+                        <span className="text-sm font-semibold text-slate-700">Model</span>
+                        <input
+                            type="text"
+                            value={model}
+                            onChange={(event) => setModel(event.target.value)}
+                            disabled={isLoading || isSaving}
+                            className={INPUT_CLASS_NAME}
+                        />
+                    </label>
+                    <label className="space-y-2">
+                        <span className="text-sm font-semibold text-slate-700">Thinking level</span>
+                        <input
+                            type="text"
+                            value={thinkingLevel}
+                            onChange={(event) => setThinkingLevel(event.target.value)}
+                            disabled={isLoading || isSaving}
+                            className={INPUT_CLASS_NAME}
+                        />
+                    </label>
+                </div>
+
+                <div className="mt-6 flex flex-wrap items-center gap-3">
+                    <button
+                        type="button"
+                        onClick={() => void saveConfiguration(false)}
+                        disabled={isLoading || isSaving}
+                        className="inline-flex items-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"
+                    >
+                        {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <Save className="h-4 w-4" />}
+                        Save runner
+                    </button>
+                    <button
+                        type="button"
+                        onClick={() => void saveConfiguration(true)}
+                        disabled={isLoading || isSaving}
+                        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"
+                    >
+                        {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <ServerCog className="h-4 w-4" />}
+                        Save and apply runner
+                    </button>
+                </div>
+            </Card>
+
+            {applyOutput ? (
+                <pre className="max-h-72 overflow-auto rounded-xl border border-slate-200 bg-slate-950 p-4 text-xs text-slate-100">
+                    {applyOutput}
+                </pre>
+            ) : null}
+
+            <Card className="hover:border-gray-200 hover:shadow-md">
+                <div className="space-y-3">
+                    <h2 className="text-lg font-semibold text-slate-900">Authentication</h2>
+                    <p className="text-sm text-slate-600">
+                        GitHub Copilot still requires an interactive CLI login and project trust setup on the VPS
+                        terminal. Use <span className="font-mono">sudo -u $USER copilot</span>, run{' '}
+                        <span className="font-mono">/login</span> when prompted, trust the install directory, then
+                        restart the pm2 process.
+                    </p>
+                    <pre className="max-h-64 overflow-auto rounded-xl border border-slate-200 bg-slate-950 p-4 text-xs text-slate-100">
+                        {status || 'Runner status was not available.'}
+                    </pre>
+                </div>
+            </Card>
+        </div>
+    );
+}

package/apps/agents-server/src/app/admin/code-runners/page.tsx

@@ -0,0 +1,14 @@
+import { ForbiddenPage } from '../../../components/ForbiddenPage/ForbiddenPage';
+import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
+import { CodeRunnersClient } from './CodeRunnersClient';
+
+/**
+ * Super-admin page for configuring standalone code runners.
+ */
+export default async function CodeRunnersPage() {
+    if (!(await isUserGlobalAdmin())) {
+        return <ForbiddenPage />;
+    }
+
+    return <CodeRunnersClient />;
+}

package/apps/agents-server/src/app/admin/database/DatabaseAdminClient.tsx

@@ -0,0 +1,38 @@
+'use client';
+
+import dynamic from 'next/dynamic';
+import type { AgentsServerDatabaseMode } from '../../../database/agentsServerDatabaseMode';
+
+/**
+ * Props consumed by the lazy Embedded Prisma Studio client.
+ *
+ * @private route component props of DatabaseAdminPage
+ */
+type DatabaseAdminClientProps = {
+    readonly databaseMode: AgentsServerDatabaseMode;
+};
+
+/**
+ * Client-only Embedded Prisma Studio surface.
+ */
+const DatabaseAdminStudioSurface = dynamic(
+    () => import('./DatabaseAdminStudioSurface').then((module) => module.DatabaseAdminStudioSurface),
+    {
+        ssr: false,
+        loading: () => (
+            <div className="flex h-full items-center justify-center text-sm text-gray-500">Loading database...</div>
+        ),
+    },
+);
+
+/**
+ * Renders the Embedded Prisma Studio client after hydration.
+ *
+ * @param props - Active database mode.
+ * @returns Database admin client.
+ *
+ * @private route component of DatabaseAdminPage
+ */
+export function DatabaseAdminClient({ databaseMode }: DatabaseAdminClientProps) {
+    return <DatabaseAdminStudioSurface databaseMode={databaseMode} />;
+}

package/apps/agents-server/src/app/admin/database/DatabaseAdminStudioSurface.tsx

@@ -0,0 +1,42 @@
+'use client';
+
+import { createStudioBFFClient } from '@prisma/studio-core/data/bff';
+import { createPostgresAdapter } from '@prisma/studio-core/data/postgres-core';
+import { createSQLiteAdapter } from '@prisma/studio-core/data/sqlite-core';
+import { Studio } from '@prisma/studio-core/ui';
+import { useMemo } from 'react';
+import type { AgentsServerDatabaseMode } from '../../../database/agentsServerDatabaseMode';
+
+/**
+ * Backend endpoint used by Embedded Prisma Studio.
+ */
+const DATABASE_ADMIN_STUDIO_ENDPOINT = '/api/admin/database/studio';
+
+/**
+ * Props consumed by the hydrated Embedded Prisma Studio surface.
+ *
+ * @private route component props of DatabaseAdminPage
+ */
+type DatabaseAdminStudioSurfaceProps = {
+    readonly databaseMode: AgentsServerDatabaseMode;
+};
+
+/**
+ * Renders Prisma Studio with an adapter matching the configured database backend.
+ *
+ * @param props - Active database mode.
+ * @returns Embedded Prisma Studio surface.
+ *
+ * @private route component of DatabaseAdminPage
+ */
+export function DatabaseAdminStudioSurface({ databaseMode }: DatabaseAdminStudioSurfaceProps) {
+    const adapter = useMemo(() => {
+        const executor = createStudioBFFClient({
+            url: DATABASE_ADMIN_STUDIO_ENDPOINT,
+        });
+
+        return databaseMode === 'sqlite' ? createSQLiteAdapter({ executor }) : createPostgresAdapter({ executor });
+    }, [databaseMode]);
+
+    return <Studio adapter={adapter} />;
+}

package/apps/agents-server/src/app/admin/database/page.tsx

@@ -0,0 +1,33 @@
+import { ForbiddenPage } from '../../../components/ForbiddenPage/ForbiddenPage';
+import { resolveAgentsServerDatabaseMode } from '../../../database/agentsServerDatabaseMode';
+import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
+import { DatabaseAdminClient } from './DatabaseAdminClient';
+
+/**
+ * Super-admin page exposing raw database access through Embedded Prisma Studio.
+ */
+export default async function DatabaseAdminPage() {
+    if (!(await isUserGlobalAdmin())) {
+        return <ForbiddenPage />;
+    }
+
+    const databaseMode = resolveAgentsServerDatabaseMode();
+    const databaseModeLabel = databaseMode === 'sqlite' ? 'SQLite' : 'Supabase';
+
+    return (
+        <div className="flex h-[calc(100vh-60px)] flex-col overflow-hidden bg-white text-gray-900 dark:bg-gray-950 dark:text-gray-100">
+            <div className="flex flex-wrap items-center justify-between gap-3 border-b border-gray-200 px-5 py-3 dark:border-gray-800">
+                <div>
+                    <p className="text-xs uppercase tracking-[0.25em] text-gray-400">Super Admin</p>
+                    <h1 className="text-xl font-semibold">Database</h1>
+                </div>
+                <span className="rounded border border-gray-200 px-2 py-1 text-xs font-medium text-gray-600 dark:border-gray-700 dark:text-gray-300">
+                    {databaseModeLabel}
+                </span>
+            </div>
+            <div className="min-h-0 flex-1">
+                <DatabaseAdminClient databaseMode={databaseMode} />
+            </div>
+        </div>
+    );
+}