@promptbook/cli 0.103.0-56 → 0.103.0-66

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

@@ -0,0 +1,334 @@
+'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 flex flex-col md:flex-row items-center md:items-start gap-8 md:gap-12 max-w-5xl w-full">
+                    {/* Agent image card (Flippable) */}
+                    <div className="flex-shrink-0 perspective-1000 group" style={{ perspective: '1000px' }}>
+                        <div
+                            className="relative w-72 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-3xl 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-8xl font-bold text-white/80"
+                                        style={{ backgroundColor: brandColorDarkHex }}
+                                    >
+                                        {fullname.charAt(0).toUpperCase()}
+                                    </div>
+                                )}
+
+                                {/* Flip hint icon */}
+                                <div className="absolute bottom-4 right-4 bg-black/30 p-2 rounded-full text-white/80 backdrop-blur-md opacity-0 group-hover:opacity-100 transition-opacity">
+                                    <RepeatIcon className="w-5 h-5" />
+                                </div>
+                            </div>
+
+                            {/* Back of Card (QR Code) */}
+                            <div
+                                className="absolute inset-0 w-full h-full backface-hidden rounded-3xl shadow-2xl overflow-hidden backdrop-blur-sm flex flex-col items-center justify-center 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-4 right-4 bg-black/10 p-2 rounded-full text-black/50 backdrop-blur-md">
+                                    <RepeatIcon className="w-5 h-5" />
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    {/* Agent info */}
+                    <div className="flex flex-col items-center md:items-start text-center md:text-left gap-6">
+                        {/* Agent name with custom font */}
+                        <h1
+                            className="text-4xl md:text-5xl lg:text-6xl font-bold text-gray-900 tracking-tight"
+                            style={{
+                                textShadow: '0 2px 20px rgba(255, 255, 255, 0.5)',
+                            }}
+                        >
+                            {fullname}
+                        </h1>
+
+                        {/* Short description */}
+                        <p className="text-lg md:text-xl text-gray-700 max-w-lg leading-relaxed font-medium">
+                            {personaDescription}
+                        </p>
+
+                        {/* Chat */}
+                        <div className="w-full">{children}</div>
+
+                        {/* Secondary Actions */}
+                        {!isHeadless && (
+                            <div className="flex flex-wrap justify-center md:justify-start items-center gap-4 md:gap-6 mt-2">
+                                {actions}
+                            </div>
+                        )}
+                    </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/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-56';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-66';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -374,15 +374,33 @@ class Color {
      * @param color
      * @returns Color object
      */
-    static from(color) {
-        if (color instanceof Color) {
+    static from(color, _isSingleValue = false) {
+        if (color === '') {
+            throw new Error(`Can not create color from empty string`);
+        }
+        else if (color instanceof Color) {
             return take(color);
         }
         else if (Color.isColor(color)) {
             return take(color);
         }
         else if (typeof color === 'string') {
-            return Color.fromString(color);
+            try {
+                return Color.fromString(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                if (_isSingleValue) {
+                    throw error;
+                }
+                const parts = color.split(/[\s+,;|]/);
+                if (parts.length > 0) {
+                    return Color.from(parts[0].trim(), true);
+                }
+                else {
+                    throw new Error(`Can not create color from given string "${color}"`);
+                }
+            }
         }
         else {
             console.error({ color });
@@ -22454,15 +22472,19 @@ const _FormattedBookInMarkdownTranspilerRegistration = $bookTranspilersRegister.
  *
  * @private - TODO: [🧠] Maybe should be public?
  */
-function createCommitmentRegex(commitment, aliases = []) {
+function createCommitmentRegex(commitment, aliases = [], requiresContent = true) {
     const allCommitments = [commitment, ...aliases];
     const patterns = allCommitments.map((c) => {
         const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
         return escapedCommitment.split(/\s+/).join('\\s+');
     });
     const keywordPattern = patterns.join('|');
-    const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
-    return regex;
+    if (requiresContent) {
+        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
+    }
+    else {
+        return new RegExp(`^\\s*(?<type>${keywordPattern})\\b(?:\\s+(?<contents>.+))?$`, 'gim');
+    }
 }
 /**
  * Generates a regex pattern to match a specific commitment type
@@ -22495,12 +22517,20 @@ class BaseCommitmentDefinition {
         this.type = type;
         this.aliases = aliases;
     }
+    /**
+     * Whether this commitment requires content.
+     * If true, regex will match only if there is content after the commitment keyword.
+     * If false, regex will match even if there is no content.
+     */
+    get requiresContent() {
+        return true;
+    }
     /**
      * Creates a regex pattern to match this commitment in agent source
      * Uses the existing createCommitmentRegex function as internal helper
      */
     createRegex() {
-        return createCommitmentRegex(this.type, this.aliases);
+        return createCommitmentRegex(this.type, this.aliases, this.requiresContent);
     }
     /**
      * Creates a regex pattern to match just the commitment type
@@ -22652,6 +22682,12 @@ class ClosedCommitmentDefinition extends BaseCommitmentDefinition {
     constructor() {
         super('CLOSED');
     }
+    /**
+     * The `CLOSED` commitment is standalone.
+     */
+    get requiresContent() {
+        return false;
+    }
     /**
      * Short one-line description of CLOSED.
      */
@@ -25331,6 +25367,12 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
     constructor() {
         super('USE BROWSER', ['BROWSER']);
     }
+    /**
+     * The `USE BROWSER` commitment is standalone.
+     */
+    get requiresContent() {
+        return false;
+    }
     /**
      * Short one-line description of USE BROWSER.
      */
@@ -26171,11 +26213,11 @@ function parseAgentSource(agentSource) {
             continue;
         }
         if (commitment.type === 'META COLOR') {
-            meta.color = spaceTrim$2(commitment.content);
+            meta.color = normalizeSeparator(commitment.content);
             continue;
         }
         if (commitment.type === 'META FONT') {
-            meta.font = spaceTrim$2(commitment.content);
+            meta.font = normalizeSeparator(commitment.content);
             continue;
         }
         if (commitment.type !== 'META') {
@@ -26211,6 +26253,19 @@ function parseAgentSource(agentSource) {
         parameters,
     };
 }
+/**
+ * Normalizes the separator in the content
+ *
+ * @param content - The content to normalize
+ * @returns The content with normalized separators
+ */
+function normalizeSeparator(content) {
+    const trimmed = spaceTrim$2(content);
+    if (trimmed.includes(',')) {
+        return trimmed;
+    }
+    return trimmed.split(/\s+/).join(', ');
+}
 /**
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  */