@promptbook/cli 0.103.0-52 → 0.103.0-53

package/apps/agents-server/src/app/agents/[agentName]/history/page.tsx

@@ -0,0 +1,62 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { HistoryIcon } from 'lucide-react';
+import Link from 'next/link';
+import { RestoreVersionButton } from './RestoreVersionButton';
+
+export const metadata = {
+    title: 'Agent History',
+};
+
+export default async function AgentHistoryPage({ params }: { params: Promise<{ agentName: string }> }) {
+    const { agentName } = await params;
+    const collection = await $provideAgentCollectionForServer();
+    const history = await collection.listAgentHistory(agentName);
+
+    return (
+        <div className="container mx-auto p-6 max-w-4xl">
+            <header className="flex items-center gap-4 mb-8">
+                <div className="bg-blue-100 p-3 rounded-full">
+                    <HistoryIcon className="w-8 h-8 text-blue-600" />
+                </div>
+                <div>
+                    <h1 className="text-3xl font-bold text-gray-900">History: {agentName}</h1>
+                    <p className="text-gray-600">
+                        Previous versions of this agent. <Link href={`/agents/${agentName}`} className="text-blue-600 hover:underline">Back to agent</Link>
+                    </p>
+                </div>
+            </header>
+
+            {history.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">No history found</p>
+                </div>
+            ) : (
+                <div className="relative border-l border-gray-200 ml-4">
+                    {history.map((item, index) => (
+                        <div key={item.id} className="mb-8 ml-6">
+                            <span className="absolute flex items-center justify-center w-6 h-6 bg-blue-100 rounded-full -left-3 ring-8 ring-white">
+                                <span className="w-3 h-3 bg-blue-600 rounded-full"></span>
+                            </span>
+                            <div className="p-4 bg-white border border-gray-200 rounded-lg shadow-sm">
+                                <div className="flex justify-between items-start mb-2">
+                                    <div>
+                                        <time className="block mb-1 text-sm font-normal leading-none text-gray-400">
+                                            {new Date(item.createdAt).toLocaleString()}
+                                        </time>
+                                        <h3 className="text-lg font-semibold text-gray-900">
+                                            Version {history.length - index}
+                                        </h3>
+                                        <p className="text-sm text-gray-500">
+                                            Hash: <code className="bg-gray-100 px-1 rounded">{item.agentHash.substring(0, 8)}</code>
+                                        </p>
+                                    </div>
+                                    <RestoreVersionButton agentName={agentName} historyId={item.id} />
+                                </div>
+                            </div>
+                        </div>
+                    ))}
+                </div>
+            )}
+        </div>
+    );
+}

package/apps/agents-server/src/app/agents/[agentName]/images/icon-256.png/route.tsx

@@ -0,0 +1,80 @@
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { serializeError } from '@promptbook-local/utils';
+import { ImageResponse } from 'next/og';
+import { assertsError } from '../../../../../../../../src/errors/assertsError';
+import { Color } from '../../../../../../../../src/utils/color/Color';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
+import { getAgentName, getAgentProfile } from '../../_utils';
+
+const size = {
+    width: 256,
+    height: 256,
+};
+
+export async function GET(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    keepUnused(request /* <- Note: We dont need `request` parameter */);
+
+    try {
+        const agentName = await getAgentName(params);
+        const agentProfile = await getAgentProfile(agentName);
+        const agentColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
+
+        return new ImageResponse(
+            (
+                <div
+                    style={{
+                        width: '100%',
+                        height: '100%',
+                        backgroundColor: 'transparent',
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                        borderRadius: '50%',
+                        overflow: 'hidden',
+                    }}
+                >
+                    <div
+                        style={{
+                            width: '100%',
+                            height: '100%',
+                            backgroundColor: agentColor.toHex(),
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                        }}
+                    >
+                        {/* Note: `next/image` is not working propperly with `next/og` */}
+                        {/* eslint-disable-next-line @next/next/no-img-element */}
+                        <img src={agentProfile.meta.image!} alt="Agent Icon" />
+                    </div>
+                </div>
+            ),
+            {
+                ...size,
+                emoji: 'openmoji',
+            },
+        );
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}
+
+/**
+ * TODO: [🦚] DRY
+ */

package/apps/agents-server/src/app/agents/[agentName]/images/screenshot-fullhd.png/route.tsx

@@ -0,0 +1,92 @@
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { serializeError } from '@promptbook-local/utils';
+import { ImageResponse } from 'next/og';
+import { assertsError } from '../../../../../../../../src/errors/assertsError';
+import { Color } from '../../../../../../../../src/utils/color/Color';
+import { textColor } from '../../../../../../../../src/utils/color/operators/furthest';
+import { grayscale } from '../../../../../../../../src/utils/color/operators/grayscale';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
+import { getAgentName, getAgentProfile } from '../../_utils';
+
+const size = {
+    width: 1920,
+    height: 1080,
+};
+
+export async function GET(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    keepUnused(request /* <- Note: We dont need `request` parameter */);
+
+    try {
+        const agentName = await getAgentName(params);
+        const agentProfile = await getAgentProfile(agentName);
+        const agentColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
+        const backgroundColor = agentColor.then(grayscale(0.5));
+
+        return new ImageResponse(
+            (
+                <div
+                    style={{
+                        width: '100%',
+                        height: '100%',
+                        backgroundColor: backgroundColor.toHex(),
+                        color: agentColor.then(textColor).toHex(),
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                    }}
+                >
+                    <div
+                        style={{
+                            width: '40%',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                        }}
+                    >
+                        {/* Note: `next/image` is not working propperly with `next/og` */}
+                        {/* eslint-disable-next-line @next/next/no-img-element */}
+                        <img
+                            style={{
+                                width: '80%',
+                                backgroundColor: agentColor.toHex(),
+                                borderRadius: '50%',
+                            }}
+                            src={agentProfile.meta.image!}
+                            alt="Agent Icon"
+                        />
+                    </div>
+                    <div style={{ width: '60%', display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
+                        <h1 style={{ fontSize: '110px' }}>{agentProfile.meta.fullname || agentName}</h1>
+                    </div>
+                </div>
+            ),
+            {
+                ...size,
+                emoji: 'openmoji',
+            },
+        );
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}
+
+/**
+ * TODO: [🦚] DRY
+ * TODO: [🦚] This should be the true screenshot NOT just image + Agent name
+ */

package/apps/agents-server/src/app/agents/[agentName]/images/screenshot-phone.png/route.tsx

@@ -0,0 +1,92 @@
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { serializeError } from '@promptbook-local/utils';
+import { ImageResponse } from 'next/og';
+import { assertsError } from '../../../../../../../../src/errors/assertsError';
+import { Color } from '../../../../../../../../src/utils/color/Color';
+import { textColor } from '../../../../../../../../src/utils/color/operators/furthest';
+import { grayscale } from '../../../../../../../../src/utils/color/operators/grayscale';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
+import { getAgentName, getAgentProfile } from '../../_utils';
+
+const size = {
+    width: 1080,
+    height: 1920,
+};
+
+export async function GET(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    keepUnused(request /* <- Note: We dont need `request` parameter */);
+
+    try {
+        const agentName = await getAgentName(params);
+        const agentProfile = await getAgentProfile(agentName);
+        const agentColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
+        const backgroundColor = agentColor.then(grayscale(0.5));
+
+        return new ImageResponse(
+            (
+                <div
+                    style={{
+                        width: '100%',
+                        height: '100%',
+                        backgroundColor: backgroundColor.toHex(),
+                        color: agentColor.then(textColor).toHex(),
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                    }}
+                >
+                    <div
+                        style={{
+                            width: '40%',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                        }}
+                    >
+                        {/* Note: `next/image` is not working propperly with `next/og` */}
+                        {/* eslint-disable-next-line @next/next/no-img-element */}
+                        <img
+                            style={{
+                                width: '80%',
+                                backgroundColor: agentColor.toHex(),
+                                borderRadius: '50%',
+                            }}
+                            src={agentProfile.meta.image!}
+                            alt="Agent Icon"
+                        />
+                    </div>
+                    <div style={{ width: '60%', display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
+                        <h1 style={{ fontSize: '110px' }}>{agentProfile.meta.fullname || agentName}</h1>
+                    </div>
+                </div>
+            ),
+            {
+                ...size,
+                emoji: 'openmoji',
+            },
+        );
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}
+
+/**
+ * TODO: [🦚] DRY
+ * TODO: [🦚] This should be the true screenshot NOT just image + Agent name
+ */

package/apps/agents-server/src/app/agents/[agentName]/integration/page.tsx

@@ -0,0 +1,61 @@
+'use server';
+
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { $provideServer } from '@/src/tools/$provideServer';
+import { PromptbookAgent } from '@promptbook-local/components';
+import { parseAgentSource } from '@promptbook-local/core';
+import { headers } from 'next/headers';
+import spaceTrim from 'spacetrim';
+import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { CodePreview } from '../../../../../../_common/components/CodePreview/CodePreview';
+import { generateAgentMetadata } from '../generateAgentMetadata';
+
+export const generateMetadata = generateAgentMetadata;
+
+export default async function AgentChatPage({ params }: { params: Promise<{ agentName: string }> }) {
+    $sideEffect(headers());
+    let { agentName } = await params;
+    agentName = decodeURIComponent(agentName);
+
+    const collection = await $provideAgentCollectionForServer();
+    const agentSource = await collection.getAgentSource(agentName);
+    const { meta } = parseAgentSource(agentSource);
+    const { fullname, color, image, ...restMeta } = meta;
+    const { publicUrl } = await $provideServer();
+    const agentUrl = `${publicUrl.href}agents/${encodeURIComponent(agentName)}`;
+
+    const code = spaceTrim(
+        (block) => `
+
+            import { PromptbookAgent } from '@promptbook/components';
+
+            export function YourComponent() {
+                return(
+                    <PromptbookAgent
+                        agentUrl="${agentUrl}"
+                        meta={${block(JSON.stringify({ fullname, color, image, ...restMeta }, null, 4))}}
+                    />
+                );
+            }
+            
+        `,
+    );
+
+    return (
+        <main className="w-screen h-screen p-4">
+            <h1 className="text-2xl font-bold p-4 border-b">{meta.fullname || agentName} Integration Code</h1>
+            <p className="mt-4 mb-8 text-gray-600">
+                Use the following code to integrate the <strong>{meta.fullname || agentName}</strong> agent into your
+                React application using the <code>{'<PromptbookAgent />'}</code> component.
+            </p>
+
+            <CodePreview code={code} />
+            <PromptbookAgent agentUrl={agentUrl} meta={meta} />
+        </main>
+    );
+}
+
+/**
+ * TODO: Make this page better, bring from Promptbook.Studio
+ * TODO: [🚗] Components and pages here should be just tiny UI wraper around proper agent logic and conponents
+ */

package/apps/agents-server/src/app/agents/[agentName]/opengraph-image.tsx

@@ -0,0 +1,102 @@
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { serializeError } from '@promptbook-local/utils';
+import { ImageResponse } from 'next/og';
+import { assertsError } from '../../../../../../src/errors/assertsError';
+import { Color } from '../../../../../../src/utils/color/Color';
+import { textColor } from '../../../../../../src/utils/color/operators/furthest';
+import { grayscale } from '../../../../../../src/utils/color/operators/grayscale';
+import { getAgentName, getAgentProfile } from './_utils';
+
+// export const runtime = 'edge';
+// <- Note: On Vercel Edge runtime some modules are not working *(like `crypto`)*
+
+export const alt = 'Agent Profile';
+export const size = {
+    width: 1200,
+    height: 630,
+};
+
+export const contentType = 'image/png';
+
+export default async function Image({ params }: { params: Promise<{ agentName: string }> }) {
+    try {
+        const agentName = await getAgentName(params);
+        const agentProfile = await getAgentProfile(agentName);
+        const agentColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
+        const backgroundColor = agentColor.then(grayscale(0.5));
+
+        return new ImageResponse(
+            (
+                <div
+                    style={{
+                        width: '100%',
+                        height: '100%',
+                        backgroundColor: backgroundColor.toHex(),
+                        color: agentColor.then(textColor).toHex(),
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                    }}
+                >
+                    <div
+                        style={{
+                            width: '50%',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                        }}
+                    >
+                        {/* Note: `next/image` is not working propperly with `next/og` */}
+                        {/* eslint-disable-next-line @next/next/no-img-element */}
+                        <img
+                            style={{
+                                width: '80%',
+                                backgroundColor: agentColor.toHex(),
+                                borderRadius: '50%',
+                            }}
+                            src={agentProfile.meta.image!}
+                            alt="Agent Icon"
+                        />
+                    </div>
+                    <div
+                        style={{
+                            width: '50%',
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            textAlign: 'center',
+                        }}
+                    >
+                        <h1 style={{ fontSize: '100px' }}>{agentProfile.meta.fullname || agentName}</h1>
+                    </div>
+                </div>
+            ),
+            {
+                ...size,
+                emoji: 'openmoji',
+            },
+        );
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}
+
+/**
+ * TODO: [🦚] DRY
+ */

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

@@ -1,19 +1,25 @@
 'use server';
 
-import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 // import { BookEditor } from '@promptbook-local/components';
 import { $provideServer } from '@/src/tools/$provideServer';
-import { parseAgentSource } from '@promptbook-local/core';
-import { Columns2Icon, MessagesSquareIcon, NotebookPenIcon } from 'lucide-react';
+import { PROMPTBOOK_COLOR } from '@promptbook-local/core';
+import { CodeIcon, HistoryIcon, NotebookPenIcon } from 'lucide-react';
 import { headers } from 'next/headers';
 import { notFound } from 'next/navigation';
 import { Color } from '../../../../../../src/utils/color/Color';
 import { withAlpha } from '../../../../../../src/utils/color/operators/withAlpha';
 import { $sideEffect } from '../../../../../../src/utils/organization/$sideEffect';
+import { AGENT_ACTIONS, getAgentName, getAgentProfile } from './_utils';
 import { AgentChatWrapper } from './AgentChatWrapper';
 import { AgentQrCode } from './AgentQrCode';
 import { CopyField } from './CopyField';
 import { generateAgentMetadata } from './generateAgentMetadata';
+import { InstallPwaButton } from './InstallPwaButton';
+import { ServiceWorkerRegister } from './ServiceWorkerRegister';
+import { ClearAgentChatHistoryButton } from './ClearAgentChatHistoryButton';
+import { ClearAgentChatFeedbackButton } from './ClearAgentChatFeedbackButton';
+import { CloneAgentButton } from './CloneAgentButton';
+import { isUserAdmin } from '../../../utils/isUserAdmin';
 // import { Agent } from '@promptbook-local/core';
 // import { RemoteLlmExecutionTools } from '@promptbook-local/remote-client';
 // import { OpenAiAssistantExecutionTools } from '@promptbook-local/openai';
@@ -27,13 +33,12 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
 
     $sideEffect(headers());
 
-    let { agentName } = await params;
-    agentName = decodeURIComponent(agentName);
+    const agentName = await getAgentName(params);
+    const isAdmin = await isUserAdmin();
 
-    const collection = await $provideAgentCollectionForServer();
-    let agentSource;
+    let agentProfile;
     try {
-        agentSource = await collection.getAgentSource(agentName);
+        agentProfile = await getAgentProfile(agentName);
     } catch (error) {
         if (
             error instanceof Error &&
@@ -45,7 +50,6 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
         }
         throw error;
     }
-    const agentProfile = parseAgentSource(agentSource);
 
     const { publicUrl } = await $provideServer();
 
@@ -58,13 +62,15 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
     console.log('[🐱‍🚀]', { pageUrl: agentUrl });
 
     // Extract brand color from meta
-    const brandColor = Color.from(agentProfile.meta.color || '#3b82f6'); // Default to blue-600
+    const brandColor = Color.from(agentProfile.meta.color || PROMPTBOOK_COLOR);
 
     // Mock agent actions
-    const agentActions = ['Emails', 'Web chat', 'Read documents', 'Browser', 'WhatsApp', '<Coding/>'];
+    const agentActions = AGENT_ACTIONS;
 
     return (
         <div className="flex flex-col md:flex-row h-[calc(100vh-60px)] w-full overflow-hidden">
+            <ServiceWorkerRegister scope={`/agents/${encodeURIComponent(agentName)}/`} />
+
             {/* Left sidebar: Profile info */}
             <div
                 className="w-full md:w-[400px] flex flex-col gap-6 p-6 overflow-y-auto border-r bg-gray-50 flex-shrink-0"
@@ -114,33 +120,46 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
                     </div>
                 </div>
 
-                <div className="flex flex-col gap-2 mt-auto">
+                <div className="flex flex-col gap-3 mt-auto">
                     <div className="flex gap-2">
                         <a
-                            href={`/agents/${encodeURIComponent(agentName)}/chat`}
+                            href={`/agents/${encodeURIComponent(agentName)}/book+chat`}
                             // <- TODO: [🧠] Can I append path like this on current browser URL in href?
                             className="flex-1 inline-flex items-center justify-center whitespace-nowrap bg-white hover:bg-gray-100 text-gray-800 px-4 py-2 rounded shadow font-semibold transition border border-gray-200"
                         >
-                            <MessagesSquareIcon className="ml-2 w-4 h-4 mr-2" />
-                            Chat
+                            <NotebookPenIcon className="ml-2 w-4 h-4 mr-2" />
+                            Edit
                         </a>
                         <a
-                            href={`/agents/${encodeURIComponent(agentName)}/book+chat`}
+                            href={`/agents/${encodeURIComponent(agentName)}/integration`}
                             // <- TODO: [🧠] Can I append path like this on current browser URL in href?
                             className="flex-1 inline-flex items-center justify-center whitespace-nowrap bg-white hover:bg-gray-100 text-gray-800 px-4 py-2 rounded shadow font-semibold transition border border-gray-200"
                         >
-                            <Columns2Icon className="ml-2 w-4 h-4 mr-2" />
-                            Book + Chat
+                            <CodeIcon className="ml-2 w-4 h-4 mr-2" />
+                            Integration
                         </a>
                         <a
-                            href={`/agents/${encodeURIComponent(agentName)}/book`}
-                            // <- TODO: [🧠] Can I append path like this on current browser URL in href?
+                            href={`/agents/${encodeURIComponent(agentName)}/history`}
                             className="flex-1 inline-flex items-center justify-center whitespace-nowrap bg-white hover:bg-gray-100 text-gray-800 px-4 py-2 rounded shadow font-semibold transition border border-gray-200"
                         >
-                            <NotebookPenIcon className="ml-2 w-4 h-4 mr-2" />
-                            Edit
+                            <HistoryIcon className="ml-2 w-4 h-4 mr-2" />
+                            History
                         </a>
+                        {isAdmin && <CloneAgentButton agentName={agentName} />}
+                        <InstallPwaButton />
                     </div>
+
+                    {isAdmin && (
+                        <div className="border-t border-dashed border-gray-300 pt-3">
+                            <h2 className="mb-2 text-xs font-semibold uppercase tracking-wide text-gray-600">
+                                Maintenance
+                            </h2>
+                            <div className="flex flex-col gap-2">
+                                <ClearAgentChatHistoryButton agentName={agentName} />
+                                <ClearAgentChatFeedbackButton agentName={agentName} />
+                            </div>
+                        </div>
+                    )}
                 </div>
 
                 <div className="flex flex-col items-center gap-4 pt-6 border-t border-gray-200 w-full">