@promptbook/cli 0.103.0-52 → 0.103.0-53

package/apps/agents-server/src/app/docs/page.tsx

@@ -0,0 +1,33 @@
+import Link from 'next/link';
+import { Card } from '../../components/Homepage/Card';
+import { Section } from '../../components/Homepage/Section';
+import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
+
+export default function DocsPage() {
+    const groupedCommitments = getVisibleCommitmentDefinitions();
+
+    return (
+        <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50">
+            <div className="container mx-auto px-4 py-16">
+                <Section title="Documentation">
+                    {groupedCommitments.map(({ primary, aliases }) => (
+                        <Link key={primary.type} href={`/docs/${primary.type}`} className="block h-full group">
+                            <Card className="h-full group-hover:border-blue-500 transition-colors">
+                                <h3 className="text-xl font-semibold mb-2 group-hover:text-blue-600 transition-colors">
+                                    {primary.type}
+                                    {aliases.length > 0 && (
+                                        <span className="text-gray-400 font-normal text-lg">
+                                            {' / '}
+                                            {aliases.join(' / ')}
+                                        </span>
+                                    )}
+                                </h3>
+                                {primary.description && <p className="text-gray-600 line-clamp-3">{primary.description}</p>}
+                            </Card>
+                        </Link>
+                    ))}
+                </Section>
+            </div>
+        </div>
+    );
+}

package/apps/agents-server/src/app/layout.tsx

@@ -3,7 +3,10 @@ import { LayoutWrapper } from '@/src/components/LayoutWrapper/LayoutWrapper';
 import type { Metadata } from 'next';
 import { Barlow_Condensed } from 'next/font/google';
 import { getMetadata } from '../database/getMetadata';
+import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
+import { $provideServer } from '../tools/$provideServer';
 import { isUserAdmin } from '../utils/isUserAdmin';
+import { getCurrentUser } from '../utils/getCurrentUser';
 import './globals.css';
 
 const barlowCondensed = Barlow_Condensed({
@@ -13,9 +16,9 @@ const barlowCondensed = Barlow_Condensed({
 });
 
 export async function generateMetadata(): Promise<Metadata> {
+    const { publicUrl } = await $provideServer();
     const serverName = (await getMetadata('SERVER_NAME')) || 'Promptbook Agents Server';
     const serverDescription = (await getMetadata('SERVER_DESCRIPTION')) || 'Agents server powered by Promptbook';
-    const serverUrl = (await getMetadata('SERVER_URL')) || 'https://ptbk.io';
 
     return {
         title: serverName,
@@ -44,7 +47,7 @@ export async function generateMetadata(): Promise<Metadata> {
             description: serverDescription,
             // TODO: images: ['https://www.ptbk.io/design'],
         },
-        metadataBase: new URL(serverUrl),
+        metadataBase: publicUrl,
     };
 }
 
@@ -54,9 +57,22 @@ export default async function RootLayout({
     children: React.ReactNode;
 }>) {
     const isAdmin = await isUserAdmin();
+    const currentUser = await getCurrentUser();
     const serverName = (await getMetadata('SERVER_NAME')) || 'Promptbook Agents Server';
     const serverLogoUrl = (await getMetadata('SERVER_LOGO_URL')) || null;
     const serverFaviconUrl = (await getMetadata('SERVER_FAVICON_URL')) || faviconLogoImage.src;
+    const isFooterShown = ((await getMetadata('IS_FOOTER_SHOWN')) || 'true') === 'true';
+
+    let footerLinks = [];
+    try {
+        const footerLinksString = (await getMetadata('FOOTER_LINKS')) || '[]';
+        footerLinks = JSON.parse(footerLinksString);
+    } catch (error) {
+        console.error('Failed to parse FOOTER_LINKS', error);
+    }
+
+    const collection = await $provideAgentCollectionForServer();
+    const agents = await collection.listAgents();
 
     return (
         <html lang="en">
@@ -83,9 +99,19 @@ export default async function RootLayout({
                 <link rel="icon" href={serverFaviconUrl} type="image/x-icon" />
             </head>
             <body className={`${barlowCondensed.variable} antialiased bg-white text-gray-900`}>
-                <LayoutWrapper isAdmin={isAdmin} serverName={serverName} serverLogoUrl={serverLogoUrl}>
+                <LayoutWrapper
+                    isAdmin={isAdmin}
+                    currentUser={currentUser}
+                    serverName={serverName}
+                    serverLogoUrl={serverLogoUrl}
+                    agents={JSON.parse(JSON.stringify(agents))}
+                    isFooterShown={isFooterShown}
+                    footerLinks={footerLinks}
+                >
                     {children}
                 </LayoutWrapper>
+                {/* Global portal root for modals/popups */}
+                <div id="portal-root" />
             </body>
         </html>
     );

package/apps/agents-server/src/app/manifest.ts

@@ -0,0 +1,109 @@
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { MetadataRoute } from 'next';
+import { headers } from 'next/headers';
+import { Color } from '../../../../src/utils/color/Color';
+import { getMetadata } from '../database/getMetadata';
+import { $provideServer } from '../tools/$provideServer';
+import { getAgentProfile } from './agents/[agentName]/_utils';
+
+export default async function manifest(): Promise<MetadataRoute.Manifest> {
+    const { publicUrl } = await $provideServer();
+    const serverName = (await getMetadata('SERVER_NAME')) || 'Promptbook Agents Server';
+    const serverDescription = (await getMetadata('SERVER_DESCRIPTION')) || 'Agents server powered by Promptbook';
+
+    const referer = (await headers()).get('referer') || '';
+    const isAgentManifest = referer.includes('/agents/');
+
+    if (!isAgentManifest) {
+        return {
+            name: serverName,
+            short_name: serverName,
+            description: serverDescription,
+            start_url: publicUrl.href,
+            display_override: ['fullscreen', 'minimal-ui'],
+            display: 'standalone',
+            background_color: PROMPTBOOK_COLOR.toHex(),
+            theme_color: PROMPTBOOK_COLOR.toHex(),
+            icons: [
+                // TODO: Create icons for the server homepage
+            ],
+            scope: publicUrl.href,
+        } satisfies MetadataRoute.Manifest;
+    }
+
+    const agentName = decodeURIComponent(referer.split('/agents/')[1]?.split('/')[0]);
+
+    try {
+        const agentProfile = await getAgentProfile(agentName);
+
+        const name = agentProfile.meta.fullname || agentProfile.agentName;
+        const short_name = agentProfile.agentName;
+        const description = agentProfile.meta.description || agentProfile.personaDescription || `Agent ${name}`;
+
+        // Extract brand color from meta
+        const brandColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
+        const theme_color = brandColor.toHex();
+        const background_color = '#ffffff';
+
+        const agentUrl = `${publicUrl.href}agents/${encodeURIComponent(agentName)}`;
+
+        const icons: MetadataRoute.Manifest['icons'] = [
+            {
+                src: `${agentUrl}/images/icon-256.png`,
+                sizes: '256x256',
+                type: 'image/png',
+                purpose: 'any',
+            },
+            {
+                src: `${agentUrl}/images/icon-256.png`,
+                sizes: '256x256',
+                type: 'image/png',
+                purpose: 'maskable',
+            },
+        ];
+
+        const screenshots: MetadataRoute.Manifest['screenshots'] = [
+            {
+                src: `${agentUrl}/images/screenshot-fullhd.png`,
+                sizes: '1920x1080',
+                type: 'image/png',
+                form_factor: 'wide',
+                label: 'Full HD Screenshot',
+            },
+            {
+                src: `${agentUrl}/images/screenshot-phone.png`,
+                sizes: '1080x1920',
+                type: 'image/png',
+                form_factor: 'narrow',
+                label: 'Phone Screenshot',
+            },
+        ];
+
+        return {
+            id: agentUrl,
+            name,
+            short_name,
+            description,
+            start_url: `${agentUrl}/chat`,
+            scope: agentUrl,
+            display_override: ['fullscreen', 'minimal-ui'],
+            display: 'standalone',
+            background_color,
+            theme_color,
+            icons,
+            screenshots,
+        } satisfies MetadataRoute.Manifest;
+    } catch (error) {
+        console.warn(`Failed to generate manifest for agent ${agentName}`, error);
+        return {
+            name: agentName,
+            short_name: agentName,
+            start_url: `${publicUrl.href}agents/${encodeURIComponent(agentName)}/chat`,
+            display_override: ['fullscreen', 'minimal-ui'],
+            display: 'standalone',
+            background_color: '#ffffff',
+            theme_color: PROMPTBOOK_COLOR.toHex(),
+            icons: [],
+        } satisfies MetadataRoute.Manifest;
+    }
+}

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

@@ -5,22 +5,18 @@ import moment from 'moment';
 import { headers } from 'next/headers';
 import { AboutPromptbookInformation } from '../../../../src/utils/misc/xAboutPromptbookInformation';
 import { $sideEffect } from '../../../../src/utils/organization/$sideEffect';
-import { AuthControls } from '../components/Auth/AuthControls';
-import { AgentCard } from '../components/Homepage/AgentCard';
-import { ModelCard } from '../components/Homepage/ModelCard';
+import { AgentsList } from '../components/Homepage/AgentsList';
+import { ExternalAgentsSectionClient } from '../components/Homepage/ExternalAgentsSectionClient';
+import { ModelsSection } from '../components/Homepage/ModelsSection';
 import { Section } from '../components/Homepage/Section';
 import { TechInfoCard } from '../components/Homepage/TechInfoCard';
 import { UsersList } from '../components/UsersList/UsersList';
 import VercelDeploymentCard from '../components/VercelDeploymentCard/VercelDeploymentCard';
-import { getMetadata } from '../database/getMetadata';
 import { getLongRunningTask } from '../deamons/longRunningTask';
 import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
 import { $provideExecutionToolsForServer } from '../tools/$provideExecutionToolsForServer';
 import { $provideServer } from '../tools/$provideServer';
-import { getCurrentUser } from '../utils/getCurrentUser';
-import { getFederatedAgents } from '../utils/getFederatedAgents';
 import { isUserAdmin } from '../utils/isUserAdmin';
-import { AddAgentButton } from './AddAgentButton';
 
 // Add calendar formats that include seconds
 const calendarWithSeconds = {
@@ -36,19 +32,10 @@ export default async function HomePage() {
     $sideEffect(/* Note: [🐶] This will ensure dynamic rendering of page and avoid Next.js pre-render */ headers());
 
     const isAdmin = await isUserAdmin(); /* <- TODO: [👹] Here should be user permissions */
-    const currentUser = await getCurrentUser();
 
     const collection = await $provideAgentCollectionForServer();
     const agents = await collection.listAgents();
 
-    const federatedServersString = (await getMetadata('FEDERATED_SERVERS')) || '';
-    const federatedServers = federatedServersString
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s !== '');
-
-    const externalAgents = await getFederatedAgents(federatedServers);
-
     const longRunningTask = getLongRunningTask();
 
     const executionTools = await $provideExecutionToolsForServer();
@@ -59,38 +46,14 @@ export default async function HomePage() {
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50">
             <div className="container mx-auto px-4 py-16">
-                <div className="flex justify-end mb-4">
-                    <AuthControls initialUser={currentUser} />
-                </div>
-
-                <Section title={`Agents (${agents.length})`}>
-                    {agents.map((agent) => (
-                        <AgentCard key={agent.agentName} agent={agent} href={`/${agent.agentName}`} />
-                    ))}
-                    {isAdmin && <AddAgentButton />}
-                </Section>
-
-                {externalAgents.length > 0 && (
-                    <Section title={`External Agents (${externalAgents.length})`}>
-                        {externalAgents.map((agent) => (
-                            <AgentCard key={agent.url} agent={agent} href={agent.url} />
-                        ))}
-                    </Section>
-                )}
+                <AgentsList agents={[...agents]} isAdmin={isAdmin} />
+
+                <ExternalAgentsSectionClient />
 
-                {isAdmin && <UsersList />}
+                {isAdmin && <UsersList allowCreate={false} />}
 
                 {isAdmin && (
-                    <Section title={`Models (${models.length})`}>
-                        {models.map(({ modelName, modelTitle, modelDescription }) => (
-                            <ModelCard
-                                key={modelName}
-                                modelName={modelName}
-                                modelTitle={modelTitle || modelName}
-                                modelDescription={modelDescription}
-                            />
-                        ))}
-                    </Section>
+                    <ModelsSection models={models} maxVisible={11} showViewAllLink />
                 )}
 
                 {isAdmin && (

package/apps/agents-server/src/app/recycle-bin/RestoreAgentButton.tsx

@@ -0,0 +1,40 @@
+'use client';
+
+import { RefreshCcwIcon } from 'lucide-react';
+import { useRouter } from 'next/navigation';
+import { useState } from 'react';
+import { restoreDeletedAgent } from './actions';
+
+type RestoreAgentButtonProps = {
+    agentName: string;
+};
+
+export function RestoreAgentButton({ agentName }: RestoreAgentButtonProps) {
+    const router = useRouter();
+    const [isRestoring, setIsRestoring] = useState(false);
+
+    const handleRestore = async () => {
+        try {
+            setIsRestoring(true);
+            await restoreDeletedAgent(agentName);
+            router.refresh();
+        } catch (error) {
+            console.error('Failed to restore agent:', error);
+            alert('Failed to restore agent');
+        } finally {
+            setIsRestoring(false);
+        }
+    };
+
+    return (
+        <button
+            onClick={handleRestore}
+            disabled={isRestoring}
+            className="flex items-center gap-2 px-3 py-2 bg-white border border-gray-300 rounded hover:bg-gray-50 text-gray-700 disabled:opacity-50"
+            title="Restore agent"
+        >
+            <RefreshCcwIcon className={`w-4 h-4 ${isRestoring ? 'animate-spin' : ''}`} />
+            {isRestoring ? 'Restoring...' : 'Restore'}
+        </button>
+    );
+}

package/apps/agents-server/src/app/recycle-bin/actions.ts

@@ -0,0 +1,27 @@
+'use server';
+
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { revalidatePath } from 'next/cache';
+
+export async function restoreDeletedAgent(agentName: string) {
+    const collection = await $provideAgentCollectionForServer();
+    
+    // Find the latest history item for this agent
+    const history = await collection.listAgentHistory(agentName);
+    
+    if (history.length === 0) {
+        throw new Error(`No history found for agent ${agentName}`);
+    }
+    
+    const latestVersion = history[0];
+    
+    if (!latestVersion) {
+         throw new Error(`No history found for agent ${agentName}`);
+    }
+
+    await collection.restoreAgent(latestVersion.id);
+    
+    revalidatePath('/recycle-bin');
+    revalidatePath(`/agents/${agentName}`);
+    revalidatePath('/');
+}

package/apps/agents-server/src/app/recycle-bin/page.tsx

@@ -0,0 +1,58 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { TrashIcon } from 'lucide-react';
+import Link from 'next/link';
+import { RestoreAgentButton } from './RestoreAgentButton';
+
+export const metadata = {
+    title: 'Recycle Bin',
+};
+
+export default async function RecycleBinPage() {
+    const collection = await $provideAgentCollectionForServer();
+    const deletedAgents = await collection.listDeletedAgents();
+
+    return (
+        <div className="container mx-auto p-6 max-w-4xl">
+            <header className="flex items-center gap-4 mb-8">
+                <div className="bg-red-100 p-3 rounded-full">
+                    <TrashIcon className="w-8 h-8 text-red-600" />
+                </div>
+                <div>
+                    <h1 className="text-3xl font-bold text-gray-900">Recycle Bin</h1>
+                    <p className="text-gray-600">Restore deleted agents from here.</p>
+                </div>
+            </header>
+
+            {deletedAgents.length === 0 ? (
+                <div className="text-center py-12 bg-gray-50 rounded-lg border border-dashed border-gray-300">
+                    <p className="text-gray-500 text-lg">Recycle bin is empty</p>
+                    <Link href="/" className="text-blue-600 hover:underline mt-2 inline-block">
+                        Go back to agents
+                    </Link>
+                </div>
+            ) : (
+                <div className="grid gap-4">
+                    {deletedAgents.map((agentName) => (
+                        <div
+                            key={agentName}
+                            className="bg-white p-4 rounded-lg shadow-sm border border-gray-200 flex items-center justify-between hover:shadow-md transition-shadow"
+                        >
+                            <div className="flex items-center gap-3">
+                                <div className="w-10 h-10 bg-gray-100 rounded-full flex items-center justify-center text-gray-500 font-bold text-lg">
+                                    {agentName.charAt(0).toUpperCase()}
+                                </div>
+                                <div>
+                                    <h3 className="font-semibold text-lg text-gray-900">{agentName}</h3>
+                                    <p className="text-sm text-gray-500">Deleted agent</p>
+                                </div>
+                            </div>
+                            <div className="flex gap-2">
+                                <RestoreAgentButton agentName={agentName} />
+                            </div>
+                        </div>
+                    ))}
+                </div>
+            )}
+        </div>
+    );
+}

package/apps/agents-server/src/app/restricted/page.tsx

@@ -0,0 +1,33 @@
+import { ShieldAlert } from 'lucide-react';
+import Link from 'next/link';
+
+export default function RestrictedPage() {
+    return (
+        <div className="flex flex-col items-center justify-center min-h-[calc(100vh-4rem)] p-4 text-center">
+            <div className="bg-red-50 p-6 rounded-full mb-6">
+                <ShieldAlert className="w-12 h-12 text-red-600" />
+            </div>
+            <h1 className="text-2xl font-bold text-gray-900 mb-2">Access Restricted</h1>
+            <p className="text-gray-600 max-w-md mb-8">
+                This server is restricted to authorized users or specific IP addresses. 
+                Please log in to continue or contact the administrator if you believe this is an error.
+            </p>
+            
+            {/* The Login button in the header is available, so we can just point to it or instruct the user */}
+            <div className="p-4 bg-blue-50 text-blue-800 rounded-lg max-w-md text-sm">
+                <p>
+                    <strong>Tip:</strong> Use the <strong>Log in</strong> button in the top right corner to access your account.
+                </p>
+            </div>
+
+            <div className="mt-8 flex gap-4">
+                <Link 
+                    href="/"
+                    className="px-4 py-2 bg-gray-100 hover:bg-gray-200 text-gray-700 rounded-md transition-colors"
+                >
+                    Go Home
+                </Link>
+            </div>
+        </div>
+    );
+}

package/apps/agents-server/src/app/test/og-image/README.md

@@ -0,0 +1 @@
+In this folder we are testing miscellaneous things related to Promptbook Agents Server

package/apps/agents-server/src/app/test/og-image/opengraph-image.tsx

@@ -0,0 +1,37 @@
+import { ImageResponse } from 'next/og';
+
+export const runtime = 'edge';
+
+export const alt = 'Agent Profile';
+export const size = {
+    width: 1200,
+    height: 630,
+};
+
+export const contentType = 'image/png';
+
+export default async function Image() {
+    return new ImageResponse(
+        (
+            <div
+                style={{
+                    display: 'flex',
+                    flexDirection: 'row',
+                    width: '100%',
+                    height: '100%',
+                    backgroundColor: 'white',
+                }}
+            >
+                <h1>Hello</h1>
+            </div>
+        ),
+        {
+            ...size,
+            emoji: 'openmoji',
+        },
+    );
+}
+
+/**
+ * TODO:  [webpack.cache.PackFileCacheStrategy] Serializing big strings (126kiB) impacts deserialization performance (consider using Buffer instead and decode when needed)
+ */

package/apps/agents-server/src/app/test/og-image/page.tsx

@@ -0,0 +1,22 @@
+import { NEXT_PUBLIC_SITE_URL } from '@/config';
+import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+    metadataBase: NEXT_PUBLIC_SITE_URL,
+    title: 'Test OG Image',
+    description: 'Testing og-image',
+};
+
+export default function TestPage() {
+    return (
+        <div className="min-h-screen flex items-center justify-center bg-gray-100">
+            <div className="bg-white p-8 rounded-lg shadow-md max-w-md w-full">
+                <h1 className="text-3xl font-bold text-red-600 mb-4 text-center">Test page</h1>
+                <p className="text-gray-700 mb-6 text-center">Testing og-image</p>
+                <p className="text-gray-600 text-sm text-center mt-4">
+                    View page source or share this URL to see the OG image in action
+                </p>
+            </div>
+        </div>
+    );
+}