@promptbook/cli 0.103.0-56 → 0.103.0-67

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

@@ -0,0 +1,339 @@
+'use client';
+
+import { AgentBasicInformation } from '@promptbook-local/types';
+import { RepeatIcon } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import spaceTrim from 'spacetrim';
+import { Color } from '../../../../../src/utils/color/Color';
+import { darken } from '../../../../../src/utils/color/operators/darken';
+import { lighten } from '../../../../../src/utils/color/operators/lighten';
+import { AgentQrCode } from './AgentQrCode';
+import { QrCodeModal } from './QrCodeModal';
+
+type AgentProfileProps = {
+    /**
+     * The agent to display
+     */
+    readonly agent: AgentBasicInformation;
+
+    /**
+     * URL of the agent page
+     *
+     * @default undefined - If not provided, some features like QR code for link might be disabled or use generic link
+     */
+    readonly agentUrl?: string;
+
+    /**
+     * Email of the agent
+     */
+    readonly agentEmail?: string;
+
+    /**
+     * Content for the menu (top right)
+     *
+     * @param props.onShowQrCode - Function to open QR code modal
+     */
+    readonly renderMenu?: (props: { onShowQrCode: () => void }) => React.ReactNode;
+
+    /**
+     * Content for the chat area
+     */
+    readonly children?: React.ReactNode;
+
+    /**
+     * Content for the secondary actions (links)
+     */
+    readonly actions?: React.ReactNode;
+
+    /**
+     * If true, hides the menu and actions for fullscreen/embedded view
+     */
+    readonly isHeadless?: boolean;
+
+    /**
+     * CSS class name
+     */
+    readonly className?: string;
+};
+
+export function AgentProfile(props: AgentProfileProps) {
+    const {
+        agent,
+        agentUrl = '',
+        agentEmail = '',
+        renderMenu,
+        children,
+        actions,
+        isHeadless = false,
+        className,
+    } = props;
+    const { meta, agentName } = agent;
+    const fullname = (meta.fullname as string) || agentName || 'Agent';
+    const personaDescription = agent.personaDescription || '';
+    const imageUrl = (meta.image as string) || null;
+
+    const [isQrModalOpen, setIsQrModalOpen] = useState(false);
+    const [isFlipped, setIsFlipped] = useState(false);
+
+    // Dynamic Font Loading
+    const fontString = meta.font;
+    let fontStyle: React.CSSProperties = {};
+
+    if (fontString) {
+        // [🧠] TODO: Properly parse font string to get family name
+        const primaryFont = fontString.split(',')[0].trim().replace(/['"]/g, '');
+        fontStyle = {
+            fontFamily: fontString,
+        };
+    }
+
+    // Compute Colors and Background
+    const { brandColorHex, brandColorLightHex, brandColorDarkHex, backgroundImage } = useMemo(() => {
+        // [🧠] Default color should be imported constant, but for now hardcoded fallback
+        const PROMPTBOOK_COLOR_HEX = '#f15b24'; // TODO: Import PROMPTBOOK_COLOR
+        const brandColorString = meta.color || PROMPTBOOK_COLOR_HEX;
+
+        let brandColor;
+        try {
+            brandColor = Color.fromSafe(brandColorString.split(',')[0].trim());
+        } catch {
+            brandColor = Color.fromHex(PROMPTBOOK_COLOR_HEX);
+        }
+
+        const brandColorHex = brandColor.toHex();
+        const brandColorLightHex = brandColor.then(lighten(0.2)).toHex();
+        const brandColorDarkHex = brandColor.then(darken(0.15)).toHex();
+
+        // Generate Noisy SVG Background
+        const color1 = brandColor;
+        // const color2 = brandColors[1] || brandColors[0]!; // Use secondary color if available?
+        // For simplicity using primary color for now or derive second one
+        const color2 = brandColor;
+
+        // [🧠] Make colors much lighter for the background
+        const color1Light = color1.then(lighten(0.3)).toHex();
+        const color1Main = color1.toHex();
+        const color1Dark = color1.then(darken(0.3)).toHex();
+
+        const color2Light = color2.then(lighten(0.3)).toHex();
+        const color2Main = color2.toHex();
+        const color2Dark = color2.then(darken(0.3)).toHex();
+
+        const svgContent = spaceTrim(`
+            <svg xmlns="http://www.w3.org/2000/svg"
+              viewBox="0 0 1920 1080"
+              width="1920" height="1080"
+              preserveAspectRatio="xMidYMid slice">
+              <defs>
+                <!-- Bottom-left -->
+                <radialGradient id="grad1" cx="0%" cy="100%" r="90%">
+                  <stop offset="0%" stop-color="${color1Light}" />
+                  <stop offset="50%" stop-color="${color1Main}" />
+                  <stop offset="100%" stop-color="${color1Dark}" />
+                </radialGradient>
+
+                <!-- Bottom-right -->
+                <radialGradient id="grad2" cx="100%" cy="100%" r="90%">
+                  <stop offset="0%" stop-color="${color2Light}" />
+                  <stop offset="50%" stop-color="${color2Main}" />
+                  <stop offset="100%" stop-color="${color2Dark}" />
+                </radialGradient>
+
+                <!-- White top fade -->
+                <linearGradient id="whiteTopGrad" x1="0%" y1="0%" x2="0%" y2="100%">
+                  <stop offset="0%" stop-color="#ffffff" stop-opacity="1" />
+                  <stop offset="100%" stop-color="#ffffff" stop-opacity="0.3" />
+                </linearGradient>
+
+                <!-- Strong grain -->
+                <filter id="grain" x="-10%" y="-10%" width="120%" height="120%">
+                  <feTurbulence type="fractalNoise" baseFrequency="3.5" numOctaves="3" seed="8" result="noise" />
+                  <feComponentTransfer>
+                    <feFuncR type="linear" slope="3.5" intercept="-1.2" />
+                    <feFuncG type="linear" slope="3.5" intercept="-1.2" />
+                    <feFuncB type="linear" slope="3.5" intercept="-1.2" />
+                    <feFuncA type="table" tableValues="0 0.8" />
+                  </feComponentTransfer>
+                </filter>
+              </defs>
+
+              <!-- White base -->
+              <rect width="100%" height="100%" fill="#ffffff" />
+
+              <!-- Gradients -->
+              <rect width="100%" height="100%" fill="url(#grad1)" />
+              <rect width="100%" height="100%" fill="url(#grad2)" style="mix-blend-mode:screen; opacity:0.85" />
+
+              <!-- White fade on top -->
+              <rect width="100%" height="100%" fill="url(#whiteTopGrad)" />
+
+              <!-- Strong visible noise -->
+              <rect width="100%" height="100%" filter="url(#grain)"
+                style="mix-blend-mode:soft-light; opacity:1.2" />
+            </svg>
+        `);
+
+        const backgroundImage = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svgContent)}`;
+
+        return { brandColorHex, brandColorLightHex, brandColorDarkHex, backgroundImage };
+    }, [meta.color]);
+
+    return (
+        <>
+            {fontString && (
+                <style jsx global>{`
+                    @import url('https://fonts.googleapis.com/css2?family=${encodeURIComponent(
+                        fontString.split(',')[0].trim().replace(/['"]/g, ''),
+                    )}:wght@400;600;700&display=swap');
+                `}</style>
+            )}
+
+            {/* Full-screen background with agent color */}
+            <div
+                className={`w-full flex flex-col items-center justify-center p-6 md:p-12 relative overflow-hidden ${
+                    isHeadless ? 'min-h-screen' : 'min-h-[calc(100vh-60px)]'
+                } ${className || ''}`}
+                style={{
+                    background: `url("${backgroundImage}")`,
+                    backgroundSize: 'cover',
+                    backgroundPosition: 'center',
+                    ...fontStyle,
+                }}
+            >
+                {/* Options menu in top right */}
+                {!isHeadless && renderMenu && (
+                    <div className="absolute top-4 right-4 z-[9999]">
+                        {renderMenu({ onShowQrCode: () => setIsQrModalOpen(true) })}
+                    </div>
+                )}
+
+                {/* Main profile content */}
+                <div className="relative z-10 grid grid-cols-[auto_1fr] gap-x-6 gap-y-4 md:gap-12 max-w-5xl w-full items-start">
+                    {/* Agent image card (Flippable) */}
+                    <div
+                        className="flex-shrink-0 perspective-1000 group row-start-1 col-start-1 md:row-span-3"
+                        style={{ perspective: '1000px' }}
+                    >
+                        <div
+                            className="relative w-24 md:w-80 transition-all duration-700 transform-style-3d cursor-pointer"
+                            style={{
+                                aspectRatio: '1 / 1.618', // Golden Ratio
+                                transformStyle: 'preserve-3d',
+                                transform: isFlipped ? 'rotateY(180deg)' : 'rotateY(0deg)',
+                            }}
+                            onClick={() => setIsFlipped(!isFlipped)}
+                        >
+                            {/* Front of Card (Image) */}
+                            <div
+                                className="absolute inset-0 w-full h-full backface-hidden rounded-lg md:rounded-3xl shadow-lg md:shadow-2xl overflow-hidden backdrop-blur-sm"
+                                style={{
+                                    backfaceVisibility: 'hidden',
+                                    backgroundColor: brandColorDarkHex,
+                                    boxShadow: `0 25px 50px -12px rgba(0, 0, 0, 0.25), 0 0 0 1px ${brandColorLightHex}40`,
+                                }}
+                            >
+                                {imageUrl ? (
+                                    // eslint-disable-next-line @next/next/no-img-element
+                                    <img src={imageUrl} alt={fullname} className="w-full h-full object-cover" />
+                                ) : (
+                                    <div
+                                        className="w-full h-full flex items-center justify-center text-3xl md:text-8xl font-bold text-white/80"
+                                        style={{ backgroundColor: brandColorDarkHex }}
+                                    >
+                                        {fullname.charAt(0).toUpperCase()}
+                                    </div>
+                                )}
+
+                                {/* Flip hint icon */}
+                                <div className="absolute bottom-2 md:bottom-4 right-2 md:right-4 bg-black/30 p-1 md:p-2 rounded-full text-white/80 backdrop-blur-md opacity-0 group-hover:opacity-100 transition-opacity">
+                                    <RepeatIcon className="w-3 h-3 md:w-5 md:h-5" />
+                                </div>
+                            </div>
+
+                            {/* Back of Card (QR Code) */}
+                            <div
+                                className="absolute inset-0 w-full h-full backface-hidden rounded-lg md:rounded-3xl shadow-lg md:shadow-2xl overflow-hidden backdrop-blur-sm flex flex-col items-center justify-center p-2 md:p-6"
+                                style={{
+                                    backfaceVisibility: 'hidden',
+                                    transform: 'rotateY(180deg)',
+                                    background: `linear-gradient(135deg, ${brandColorLightHex} 0%, #ffffff 100%)`,
+                                    boxShadow: `0 25px 50px -12px rgba(0, 0, 0, 0.25), 0 0 0 1px ${brandColorLightHex}40`,
+                                }}
+                            >
+                                <div className="transform scale-90 md:scale-100">
+                                    <AgentQrCode
+                                        agentName={agentName}
+                                        agentUrl={agentUrl}
+                                        agentEmail={agentEmail}
+                                        personaDescription={personaDescription}
+                                        meta={meta}
+                                        isJustVcardShown
+                                    />
+                                </div>
+
+                                {/* Flip hint icon */}
+                                <div className="absolute bottom-2 md:bottom-4 right-2 md:right-4 bg-black/10 p-1 md:p-2 rounded-full text-black/50 backdrop-blur-md">
+                                    <RepeatIcon className="w-3 h-3 md:w-5 md:h-5" />
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    {/* Agent info - Header Area */}
+                    <div className="row-start-1 col-start-2 flex flex-col justify-center md:justify-start h-full md:h-auto gap-1 md:gap-6">
+                        {/* Agent name with custom font */}
+                        <h1
+                            className="text-2xl md:text-5xl lg:text-6xl font-bold text-gray-900 tracking-tight leading-tight"
+                            style={{
+                                textShadow: '0 2px 20px rgba(255, 255, 255, 0.5)',
+                            }}
+                        >
+                            {fullname}
+                        </h1>
+
+                        {/* Short description */}
+                        <p className="text-sm md:text-xl text-gray-700 max-w-lg leading-relaxed font-medium line-clamp-3 md:line-clamp-none">
+                            {personaDescription}
+                        </p>
+                    </div>
+
+                    {/* Chat Area */}
+                    <div className="col-span-2 md:col-span-1 md:col-start-2 w-full mt-2 md:mt-0">
+                        {children}
+                    </div>
+
+                    {/* Secondary Actions */}
+                    {!isHeadless && (
+                        <div className="col-span-2 md:col-span-1 md:col-start-2 flex flex-wrap justify-center md:justify-start items-center gap-4 md:gap-6 mt-2">
+                            {actions}
+                        </div>
+                    )}
+                </div>
+
+                {/* Subtle gradient overlay at bottom */}
+                <div
+                    className="absolute bottom-0 left-0 right-0 h-32 pointer-events-none"
+                    style={{
+                        background: `linear-gradient(to top, ${brandColorDarkHex}40, transparent)`,
+                    }}
+                />
+            </div>
+
+            {/* QR Code Modal */}
+            <QrCodeModal
+                isOpen={isQrModalOpen}
+                onClose={() => setIsQrModalOpen(false)}
+                agentName={agentName}
+                meta={meta}
+                personaDescription={personaDescription}
+                agentUrl={agentUrl}
+                agentEmail={agentEmail}
+                brandColorHex={brandColorHex}
+            />
+        </>
+    );
+}
+
+/**
+ * TODO: !!!! Use 3D badge @see https://vercel.com/blog/building-an-interactive-3d-event-badge-with-react-three-fiber
+ */

package/apps/agents-server/src/components/AgentProfile/AgentProfileFromSource.tsx

@@ -0,0 +1,23 @@
+'use client';
+
+import { string_book } from '@promptbook-local/types';
+import { useMemo } from 'react';
+import { parseAgentSource } from '../../../../../src/book-2.0/agent-source/parseAgentSource';
+import { AgentProfile } from './AgentProfile';
+
+type AgentProfileFromSourceProps = Omit<React.ComponentProps<typeof AgentProfile>, 'agent'> & {
+    /**
+     * Source code of the agent (book)
+     */
+    readonly source: string_book;
+};
+
+export function AgentProfileFromSource(props: AgentProfileFromSourceProps) {
+    const { source, ...rest } = props;
+
+    const agent = useMemo(() => {
+        return parseAgentSource(source);
+    }, [source]);
+
+    return <AgentProfile agent={agent} {...rest} />;
+}

package/apps/agents-server/src/{app/agents/[agentName] → components/AgentProfile}/AgentQrCode.tsx

@@ -8,9 +8,12 @@ import spaceTrim from 'spacetrim';
 type AgentQrCodeProps = Pick<AgentBasicInformation, 'agentName' | 'personaDescription' | 'meta'> & {
     agentUrl: string;
     agentEmail: string;
+
+    isJustVcardShown?: boolean;
 };
 
-export function AgentQrCode({ agentName, agentUrl, agentEmail, personaDescription, meta }: AgentQrCodeProps) {
+export function AgentQrCode(props: AgentQrCodeProps) {
+    const { agentName, agentUrl, agentEmail, personaDescription, meta, isJustVcardShown } = props;
     const [mode, setMode] = useState<'contact' | 'link'>('contact');
 
     // TODO: [🧠] Should we include more info in VCARD?
@@ -27,6 +30,10 @@ export function AgentQrCode({ agentName, agentUrl, agentEmail, personaDescriptio
     const qrValue = mode === 'contact' ? vcard : agentUrl;
     const label = mode === 'contact' ? 'Scan to add contact' : 'Scan to open agent';
 
+    if (isJustVcardShown) {
+        return <PromptbookQrCode value={vcard} className="" size={250} />;
+    }
+
     return (
         <div className="flex flex-col items-center">
             <div className="flex bg-gray-100 p-1 rounded-lg mb-4">

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

@@ -1,6 +1,6 @@
 'use client';
 
-import { usePathname } from 'next/navigation';
+import { usePathname, useSearchParams } from 'next/navigation';
 import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import { Footer, type FooterLink } from '../Footer/Footer';
@@ -28,12 +28,13 @@ export function LayoutWrapper({
     footerLinks,
 }: LayoutWrapperProps) {
     const pathname = usePathname();
-    const isAdminChatPage =
-        pathname?.startsWith('/admin/chat-history') || pathname?.startsWith('/admin/chat-feedback');
-    const isHeaderHidden = pathname?.includes('/chat') && !isAdminChatPage;
-    const isFooterHiddenOnPage = pathname ? /^\/agents\/[^/]+\/book(\+chat)?$/.test(pathname) : false;
+    const searchParams = useSearchParams();
+    const isHeadless = searchParams.has('headless');
+    // const isAdminChatPage = pathname?.startsWith('/admin/chat-history') || pathname?.startsWith('/admin/chat-feedback');
+    const isHeaderHidden = false; // pathname?.includes('/chat') && !isAdminChatPage;
+    const isFooterHiddenOnPage = pathname ? /^\/agents\/[^/]+\/(book|chat|book\+chat)$/.test(pathname) : false;
 
-    if (isHeaderHidden) {
+    if (isHeaderHidden || isHeadless) {
         return <main className={`pt-0`}>{children}</main>;
     }
 

package/apps/agents-server/src/database/metadataDefaults.ts

@@ -61,6 +61,12 @@ export const metadataDefaults = [
         note: 'Maximum size of file that can be uploaded in MB.',
         type: 'NUMBER',
     },
+    {
+        key: 'NAME_POOL',
+        value: 'ENGLISH',
+        note: 'Language for generating new agent names. Possible values: ENGLISH, CZECH.',
+        type: 'TEXT_SINGLE_LINE',
+    },
 ] as const satisfies ReadonlyArray<{
     key: string;
     value: string;

package/apps/agents-server/src/tools/$provideCdnForServer.ts

@@ -14,10 +14,22 @@ let cdn: IIFilesStorageWithCdn | null = null;
 export function $provideCdnForServer(): IIFilesStorageWithCdn {
     if (!cdn) {
         cdn = new VercelBlobStorage({
-            token: process.env.BLOB_READ_WRITE_TOKEN!,
+            token: process.env.VERCEL_BLOB_READ_WRITE_TOKEN!,
             pathPrefix: process.env.NEXT_PUBLIC_CDN_PATH_PREFIX!,
             cdnPublicUrl: new URL(process.env.NEXT_PUBLIC_CDN_PUBLIC_URL!),
         });
+
+        /*
+        cdn = new DigitalOceanSpaces({
+            bucket: process.env.CDN_BUCKET!,
+            pathPrefix: process.env.NEXT_PUBLIC_CDN_PATH_PREFIX!,
+            endpoint: process.env.CDN_ENDPOINT!,
+            accessKeyId: process.env.CDN_ACCESS_KEY_ID!,
+            secretAccessKey: process.env.CDN_SECRET_ACCESS_KEY!,
+            cdnPublicUrl: new URL(process.env.NEXT_PUBLIC_CDN_PUBLIC_URL!),
+            gzip: true,
+        });
+        */
     }
 
     return cdn;

package/apps/agents-server/src/utils/cdn/classes/DigitalOceanSpaces.ts

@@ -0,0 +1,119 @@
+import { GetObjectCommand, PutObjectCommand, PutObjectCommandInput, S3Client } from '@aws-sdk/client-s3';
+import { NotYetImplementedError } from '@promptbook-local/core';
+import { gzip, ungzip } from 'node-gzip';
+import { TODO_USE } from '../../../../../../src/utils/organization/TODO_USE';
+import { validateMimeType } from '../../validators/validateMimeType';
+import type { IFile, IIFilesStorageWithCdn } from '../interfaces/IFilesStorage';
+
+type IDigitalOceanSpacesConfig = {
+    readonly bucket: string;
+    readonly pathPrefix: string;
+    readonly endpoint: string;
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    readonly cdnPublicUrl: URL;
+    readonly gzip: boolean;
+
+    // TODO: [⛳️] Probbably prefix should be in this config not on the consumer side
+};
+
+export class DigitalOceanSpaces implements IIFilesStorageWithCdn {
+    public get cdnPublicUrl() {
+        return this.config.cdnPublicUrl;
+    }
+
+    private s3: S3Client;
+
+    public constructor(private readonly config: IDigitalOceanSpacesConfig) {
+        this.s3 = new S3Client({
+            region: 'auto',
+            endpoint: 'https://' + config.endpoint,
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+        });
+    }
+
+    public getItemUrl(key: string): URL {
+        return new URL(this.config.pathPrefix + '/' + key, this.cdnPublicUrl);
+    }
+
+    public async getItem(key: string): Promise<IFile | null> {
+        const parameters = {
+            Bucket: this.config.bucket,
+            Key: this.config.pathPrefix + '/' + key,
+        };
+
+        try {
+            const { Body, ContentType, ContentEncoding } = await this.s3.send(new GetObjectCommand(parameters));
+
+            // const blob = new Blob([await Body?.transformToByteArray()!]);
+
+            if (ContentEncoding === 'gzip') {
+                return {
+                    type: validateMimeType(ContentType),
+                    data: await ungzip(await Body!.transformToByteArray()),
+                };
+            } else {
+                return {
+                    type: validateMimeType(ContentType),
+                    data: (await Body!.transformToByteArray()) as Buffer,
+                };
+            }
+        } catch (error) {
+            if (error instanceof Error && error.name.match(/^NoSuchKey/)) {
+                return null;
+            } else {
+                throw error;
+            }
+        }
+    }
+
+    public async removeItem(key: string): Promise<void> {
+        TODO_USE(key);
+        throw new NotYetImplementedError(`DigitalOceanSpaces.removeItem is not implemented yet`);
+    }
+
+    public async setItem(key: string, file: IFile): Promise<void> {
+        // TODO: Put putObjectRequestAdditional into processedFile
+        const putObjectRequestAdditional: Partial<PutObjectCommandInput> = {};
+
+        let processedFile: IFile;
+        if (this.config.gzip) {
+            const gzipped = await gzip(file.data);
+            const sizePercentageAfterCompression = gzipped.byteLength / file.data.byteLength;
+            if (sizePercentageAfterCompression < 0.7) {
+                // consolex.log(`Gzipping ${key} (${Math.floor(sizePercentageAfterCompression * 100)}%)`);
+                processedFile = { ...file, data: gzipped };
+                putObjectRequestAdditional.ContentEncoding = 'gzip';
+            } else {
+                processedFile = file;
+                // consolex.log(`NOT Gzipping ${key} (${Math.floor(sizePercentageAfterCompression * 100)}%)`);
+            }
+        } else {
+            processedFile = file;
+        }
+
+        const uploadResult = await this.s3.send(
+            new PutObjectCommand({
+                Bucket: this.config.bucket,
+                Key: this.config.pathPrefix + '/' + key,
+                ContentType: processedFile.type,
+                ...putObjectRequestAdditional,
+                Body: processedFile.data,
+                // TODO: Public read access / just private to extending class
+                ACL: 'public-read',
+            }),
+        );
+
+        if (!uploadResult.ETag) {
+            throw new Error(`Upload result does not contain ETag`);
+        }
+    }
+}
+
+/**
+ * TODO: Implement Read-only mode
+ * TODO: [☹️] Unite with `PromptbookStorage` and move to `/src/...`
+ */

package/apps/agents-server/src/utils/cdn/classes/VercelBlobStorage.ts

@@ -51,12 +51,13 @@ export class VercelBlobStorage implements IIFilesStorageWithCdn {
 
     public async setItem(key: string, file: IFile): Promise<void> {
         const path = this.config.pathPrefix ? `${this.config.pathPrefix}/${key}` : key;
-        
+
         await put(path, file.data, {
             access: 'public',
             addRandomSuffix: false,
             contentType: file.type,
             token: this.config.token,
+            allowOverwrite: true, // <- TODO: This is inefficient, we should check first if the file exists and only then decide to overwrite or not
             // Note: We rely on Vercel Blob for compression
         });
     }