@promptbook/cli 0.104.0-0 → 0.104.0-2

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

@@ -0,0 +1,87 @@
+'use server';
+
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { ArrowLeftIcon, FileTextIcon } from 'lucide-react';
+import { headers } from 'next/headers';
+import Link from 'next/link';
+import { notFound } from 'next/navigation';
+import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { getAgentName, getAgentProfile } from '../_utils';
+import { generateAgentMetadata } from '../generateAgentMetadata';
+
+export const generateMetadata = generateAgentMetadata;
+
+export default async function AgentSystemMessagePage({ params }: { params: Promise<{ agentName: string }> }) {
+    $sideEffect(headers());
+    const agentName = await getAgentName(params);
+
+    let agentProfile;
+    let agentSource;
+    try {
+        agentProfile = await getAgentProfile(agentName);
+        const collection = await $provideAgentCollectionForServer();
+        agentSource = await collection.getAgentSource(agentName);
+    } catch (error) {
+        if (
+            error instanceof Error &&
+            (error.message.includes('Cannot coerce the result to a single JSON object') ||
+                error.message.includes('JSON object requested, multiple (or no) results returned'))
+        ) {
+            notFound();
+        }
+        throw error;
+    }
+
+    // For now, we'll display the agent source as the system message
+    // TODO: [🧠] This might need to be the actual generated system message from the Agent class
+    const systemMessage = agentSource || 'No system message available';
+
+    return (
+        <div className="min-h-screen p-6 md:p-12 flex flex-col items-center bg-gray-50">
+            <div className="w-full max-w-4xl bg-white rounded-xl shadow-sm border border-gray-200 overflow-hidden">
+                {/* Header */}
+                <div className="p-6 border-b border-gray-200 flex items-center gap-4">
+                    {agentProfile.meta.image && (
+                        // eslint-disable-next-line @next/next/no-img-element
+                        <img
+                            src={agentProfile.meta.image as string}
+                            alt={agentProfile.meta.fullname || agentName}
+                            className="w-16 h-16 rounded-full object-cover border-2 border-gray-200"
+                        />
+                    )}
+                    <div className="flex-1">
+                        <h1 className="text-2xl font-bold text-gray-900">{agentProfile.meta.fullname || agentName}</h1>
+                        <p className="text-gray-500 flex items-center gap-2">
+                            <FileTextIcon className="w-4 h-4" />
+                            System Message
+                        </p>
+                    </div>
+                    <Link
+                        href={`/agents/${encodeURIComponent(agentName)}`}
+                        className="p-2 text-gray-500 hover:text-gray-700 hover:bg-gray-100 rounded-full transition-colors"
+                        title="Back to Agent"
+                    >
+                        <ArrowLeftIcon className="w-6 h-6" />
+                    </Link>
+                </div>
+
+                <div className="p-6">
+                    <div className="bg-gray-50 rounded-lg p-4 border border-gray-200">
+                        <h2 className="text-lg font-semibold text-gray-900 mb-3">Generated System Message</h2>
+                        <pre className="text-sm text-gray-700 whitespace-pre-wrap font-mono bg-white p-4 rounded border border-gray-200 overflow-x-auto">
+                            {systemMessage}
+                        </pre>
+                    </div>
+
+                    <div className="mt-6 bg-blue-50 rounded-lg p-4 border border-blue-200">
+                        <h3 className="text-md font-semibold text-blue-900 mb-2">Model Requirements</h3>
+                        <div className="text-sm text-blue-800">
+                            <p><strong>Model Variant:</strong> CHAT</p>
+                            {/* TODO: [🧠] Add more model requirements if available */}
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    );
+}

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

@@ -7,8 +7,9 @@ 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 { just } from '../../../../../../../src/utils/organization/just';
 import { generateAgentMetadata } from '../generateAgentMetadata';
+import { WebsiteIntegrationTabs } from '../integration/WebsiteIntegrationTabs';
 
 export const generateMetadata = generateAgentMetadata;
 
@@ -24,20 +25,31 @@ export default async function WebsiteIntegrationAgentPage({ params }: { params:
     const { publicUrl } = await $provideServer();
     const agentUrl = `${publicUrl.href}agents/${encodeURIComponent(agentName)}`;
 
-    const code = spaceTrim(
+    const reactCode = spaceTrim(
         (block) => `
-
-            import { PromptbookAgent } from '@promptbook/components';
+            import { PromptbookAgentIntegration } from '@promptbook/components';
 
             export function YourComponent() {
                 return(
-                    <PromptbookAgent
+                    <PromptbookAgentIntegration
                         agentUrl="${agentUrl}"
                         meta={${block(JSON.stringify({ fullname, color, image, ...restMeta }, null, 4))}}
                     />
                 );
             }
-            
+        `,
+    );
+
+    // HTML Integration Code - use single quotes for meta attribute to allow JSON with double quotes inside
+    const metaJsonString = JSON.stringify({ fullname, color, image, ...restMeta }, null, 4);
+    const htmlCode = spaceTrim(
+        (block) => `
+            <script src="${publicUrl.href}api/embed.js" async defer></script>
+
+            <promptbook-agent-integration
+                agent-url="${agentUrl}"
+                meta='${block(metaJsonString)}'
+            />
         `,
     );
 
@@ -49,19 +61,24 @@ export default async function WebsiteIntegrationAgentPage({ params }: { params:
                 React application using the <code>{'<PromptbookAgent />'}</code> component.
             </p>
 
-            <CodePreview code={code} />
-            <PromptbookAgentIntegration
-                // formfactor="profile"
-                agentUrl={agentUrl}
-                meta={meta}
-                style={
-                    {
-                        // width: '400px',
-                        // height: '600px',
-                        // outline: `2px solid red`
+            <WebsiteIntegrationTabs reactCode={reactCode} htmlCode={htmlCode} />
+            {just(false) && (
+                <PromptbookAgentIntegration
+                    // formfactor="profile"
+                    agentUrl={agentUrl}
+                    meta={meta}
+                    style={
+                        {
+                            // width: '400px',
+                            // height: '600px',
+                            // outline: `2px solid red`
+                        }
                     }
-                }
-            />
+                />
+            )}
+            {htmlCode}
+            {just(true) && <div dangerouslySetInnerHTML={{ __html: htmlCode }} />}
+            {just(true) && <div dangerouslySetInnerHTML={{ __html: `<h1>Test</h1>` }} />}
         </main>
     );
 }

package/apps/agents-server/src/app/api/admin-email/route.ts

@@ -0,0 +1,12 @@
+import { getMetadata } from '../../../database/getMetadata';
+import { NextResponse } from 'next/server';
+
+export async function GET() {
+    try {
+        const adminEmail = await getMetadata('ADMIN_EMAIL');
+        return NextResponse.json({ adminEmail });
+    } catch (error) {
+        console.error('Failed to get admin email:', error);
+        return NextResponse.json({ adminEmail: 'support@ptbk.io' }, { status: 500 });
+    }
+}

package/apps/agents-server/src/app/api/agents/[agentName]/restore/route.ts

@@ -0,0 +1,19 @@
+// POST /api/agents/[agentName]/restore - restore deleted agent
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { TODO_any } from '@promptbook-local/types';
+import { NextResponse } from 'next/server';
+
+export async function POST(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    const { agentName } = await params;
+    const collection = await $provideAgentCollectionForServer();
+
+    try {
+        await collection.restoreAgent(agentName);
+        return NextResponse.json({ success: true });
+    } catch (error) {
+        return NextResponse.json(
+            { success: false, error: (error as TODO_any)?.message || 'Failed to restore agent' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/agents/[agentName]/route.ts

@@ -1,8 +1,50 @@
 // DELETE /api/agents/[agentName]
+// PATCH /api/agents/[agentName] - update agent visibility
+// POST /api/agents/[agentName]/restore - restore deleted agent
+import { $getTableName } from '@/src/database/$getTableName';
+import { $provideSupabaseForServer } from '@/src/database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { $provideServer } from '@/src/tools/$provideServer';
 import { TODO_any } from '@promptbook-local/types';
 import { NextResponse } from 'next/server';
 
+export async function PATCH(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    const { agentName } = await params;
+
+    try {
+        const body = await request.json();
+        const { visibility }: { visibility: 'PUBLIC' | 'PRIVATE' } = body;
+
+        if (!visibility || !['PUBLIC', 'PRIVATE'].includes(visibility)) {
+            return NextResponse.json(
+                { success: false, error: 'Invalid visibility value. Must be PUBLIC or PRIVATE.' },
+                { status: 400 },
+            );
+        }
+
+        const supabase = $provideSupabaseForServer();
+        const { tablePrefix } = await $provideServer();
+
+        const updateResult = await supabase
+            .from(await $getTableName(`Agent`))
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .update({ visibility } as any)
+            .or(`agentName.eq.${agentName},permanentId.eq.${agentName}`)
+            .is('deletedAt', null);
+
+        if (updateResult.error) {
+            return NextResponse.json({ success: false, error: updateResult.error.message }, { status: 500 });
+        }
+
+        return NextResponse.json({ success: true });
+    } catch (error) {
+        return NextResponse.json(
+            { success: false, error: (error as TODO_any)?.message || 'Failed to update agent visibility' },
+            { status: 500 },
+        );
+    }
+}
+
 export async function DELETE(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
     const { agentName } = await params;
     const collection = await $provideAgentCollectionForServer();

package/apps/agents-server/src/app/api/agents/route.ts

@@ -1,5 +1,7 @@
+import { $getTableName } from '@/src/database/$getTableName';
 import { $provideServer } from '@/src/tools/$provideServer';
 import { NextResponse } from 'next/server';
+import { $provideSupabaseForServer } from '../../../database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '../../../tools/$provideAgentCollectionForServer';
 import { getFederatedServersFromMetadata } from '../../../utils/getFederatedServersFromMetadata';
 
@@ -8,13 +10,36 @@ export const dynamic = 'force-dynamic';
 export async function GET() {
     try {
         const collection = await $provideAgentCollectionForServer();
-        const agents = await collection.listAgents();
+        const allAgents = await collection.listAgents();
         const federatedServers = await getFederatedServersFromMetadata();
-        const { publicUrl } = await $provideServer();
+        const { publicUrl, tablePrefix } = await $provideServer();
 
-        const agentsWithUrl = agents.map((agent) => ({
+        // Filter to only include PUBLIC agents for federated API
+        const supabase = $provideSupabaseForServer();
+        const visibilityResult = await supabase
+            .from(await $getTableName(`Agent`))
+            .select('agentName, visibility')
+            .is('deletedAt', null);
+
+        let publicAgents = allAgents;
+        if (!visibilityResult.error) {
+            const visibilityMap = new Map(
+                visibilityResult.data.map((item: { agentName: string; visibility: 'PUBLIC' | 'PRIVATE' }) => [
+                    item.agentName,
+                    item.visibility,
+                ]),
+            );
+
+            // Only include PUBLIC agents in federated API
+            publicAgents = allAgents.filter((agent) => {
+                const visibility = visibilityMap.get(agent.agentName);
+                return visibility === 'PUBLIC';
+            });
+        }
+
+        const agentsWithUrl = publicAgents.map((agent) => ({
             ...agent,
-            url: `${publicUrl.href}agents/${encodeURIComponent(agent.agentName)}`,
+            url: `${publicUrl.href}agents/${encodeURIComponent(agent.permanentId || agent.agentName)}`,
         }));
 
         const response = NextResponse.json({

package/apps/agents-server/src/app/api/docs/book.md/route.ts

@@ -0,0 +1,58 @@
+import { NextRequest, NextResponse } from 'next/server';
+import spaceTrim from 'spacetrim';
+import { getGroupedCommitmentDefinitions } from '../../../../../../../src/commitments';
+
+export const dynamic = 'force-static';
+
+export async function GET(request: NextRequest) {
+    const groupedCommitments = getGroupedCommitmentDefinitions();
+
+    const content = spaceTrim(
+        (block) => `
+            # Promptbook Documentation
+
+            Promptbook is a language for defining AI agents. It is based on Markdown and uses a set of commitments to define the behavior of the agent.
+
+            ## Commitments
+
+            The following commands (commitments) are available in Promptbook:
+
+            ${block(
+                groupedCommitments
+                    .map(({ primary, aliases }) => {
+                        const title = primary.type;
+                        const description = primary.description;
+                        const documentation = primary.documentation;
+                        const aliasList = aliases.length > 0 ? `**Aliases:** ${aliases.join(', ')}` : '';
+
+                        return spaceTrim(
+                            (block) => `
+                                ### ${title}
+
+                                ${description}
+
+                                ${aliasList}
+
+                                #### Usage
+
+                                ${block(getSafeCodeBlock(documentation))}
+                            `,
+                        );
+                    })
+                    .join('\n\n'),
+            )}
+        `,
+    );
+
+    return new NextResponse(content, {
+        headers: {
+            'Content-Type': 'text/markdown; charset=utf-8',
+        },
+    });
+}
+
+function getSafeCodeBlock(content: string, lang = 'markdown'): string {
+    const maxBackticks = Math.max(0, ...(content.match(/`+/g) || []).map((m) => m.length));
+    const fence = '`'.repeat(Math.max(3, maxBackticks + 1));
+    return `${fence}${lang}\n${content}\n${fence}`;
+}

package/apps/agents-server/src/app/api/embed.js/route.ts

@@ -1,3 +1,4 @@
+import { spaceTrim } from '@promptbook-local/utils';
 import { NextRequest, NextResponse } from 'next/server';
 
 export async function GET(request: NextRequest) {
@@ -5,84 +6,103 @@ export async function GET(request: NextRequest) {
     const host = request.nextUrl.host;
     const baseUrl = `${protocol}//${host}`;
 
-    const script = `
-(function() {
-    if (customElements.get('promptbook-agent')) {
-        return;
-    }
+    const script = spaceTrim(`
+        console.info('[🔌] Promptbook integration script from ${baseUrl}');
 
-    class PromptbookAgentElement extends HTMLElement {
-        constructor() {
-            super();
-            this.iframe = null;
-        }
+        (function() {
+            if (customElements.get('promptbook-agent-integration')) {
+                return;
+            }
 
-        static get observedAttributes() {
-            return ['agent-url'];
-        }
+            class PromptbookAgentIntegrationElement extends HTMLElement {
+                constructor() {
+                    super();
+                    console.info('[🔌] Initializing <promptbook-agent-integration/>',this);
+                    this.iframe = null;
+                }
 
-        connectedCallback() {
-            this.render();
-            window.addEventListener('message', this.handleMessage.bind(this));
-        }
+                static get observedAttributes() {
+                    return ['agent-url', 'meta'];
+                }
 
-        disconnectedCallback() {
-            window.removeEventListener('message', this.handleMessage.bind(this));
-        }
+                connectedCallback() {
+                    this.render();
+                    window.addEventListener('message', this.handleMessage.bind(this));
+                }
 
-        attributeChangedCallback(name, oldValue, newValue) {
-            if (name === 'agent-url' && oldValue !== newValue) {
-                this.render();
-            }
-        }
+                disconnectedCallback() {
+                    window.removeEventListener('message', this.handleMessage.bind(this));
+                }
 
-        handleMessage(event) {
-            if (event.data && event.data.type === 'PROMPTBOOK_AGENT_RESIZE') {
-                if (event.data.isOpen) {
-                    this.iframe.style.width = '450px';
-                    this.iframe.style.height = '650px';
-                    this.iframe.style.maxHeight = '90vh';
-                    this.iframe.style.maxWidth = '90vw';
-                    this.iframe.style.boxShadow = '0 4px 12px rgba(0,0,0,0.15)';
-                    this.iframe.style.borderRadius = '12px';
-                } else {
-                    this.iframe.style.width = '60px';
-                    this.iframe.style.height = '60px';
-                    this.iframe.style.boxShadow = 'none';
-                    this.iframe.style.borderRadius = '0';
+                attributeChangedCallback(name, oldValue, newValue) {
+                    if ((name === 'agent-url' || name === 'meta') && oldValue !== newValue) {
+                        this.render();
+                    }
                 }
-            }
-        }
 
-        render() {
-            const agentUrl = this.getAttribute('agent-url');
-            if (!agentUrl) return;
+                handleMessage(event) {
+                    if (event.data && event.data.type === 'PROMPTBOOK_AGENT_RESIZE') {
+                        if (event.data.isOpen) {
+                            // Match PromptbookAgentSeamlessIntegration.module.css dimensions
+                            // Window is 380x600 + 20px padding on each side
+                            this.iframe.style.width = '420px';
+                            this.iframe.style.height = '640px';
+                            this.iframe.style.maxHeight = 'calc(80vh + 40px)';
+                            this.iframe.style.maxWidth = 'calc(100vw - 20px)';
+                        } else {
+                            // Closed state - button area with padding and shadow space
+                            // Button is ~140px wide + 20px right margin + shadow space
+                            this.iframe.style.width = '180px';
+                            this.iframe.style.height = '100px';
+                            this.iframe.style.maxHeight = 'none';
+                            this.iframe.style.maxWidth = 'none';
+                        }
+                    }
+                }
 
-            if (!this.iframe) {
-                this.attachShadow({ mode: 'open' });
-                this.iframe = document.createElement('iframe');
-                this.iframe.style.border = 'none';
-                this.iframe.style.position = 'fixed';
-                this.iframe.style.bottom = '20px';
-                this.iframe.style.right = '20px';
-                this.iframe.style.width = '60px';
-                this.iframe.style.height = '60px';
-                this.iframe.style.zIndex = '2147483647'; // Max z-index
-                this.iframe.style.transition = 'width 0.3s ease, height 0.3s ease';
-                this.iframe.style.backgroundColor = 'transparent';
-                this.iframe.setAttribute('allow', 'microphone'); // Allow microphone if needed for voice
-                this.shadowRoot.appendChild(this.iframe);
-            }
+                render() {
+                    const agentUrl = this.getAttribute('agent-url');
+                    if (!agentUrl) return;
 
-            // Construct embed URL pointing to the Next.js page we created
-            const embedUrl = '${baseUrl}/embed?agentUrl=' + encodeURIComponent(agentUrl);
-            this.iframe.src = embedUrl;
-        }
-    }
+                    if (!this.iframe) {
+                        this.attachShadow({ mode: 'open' });
+                        this.iframe = document.createElement('iframe');
+                        this.iframe.style.border = 'none';
+                        this.iframe.style.position = 'fixed';
+                        this.iframe.style.bottom = '0';
+                        this.iframe.style.right = '0';
+                        // Initial size for the closed button state (with padding and shadow space)
+                        this.iframe.style.width = '180px';
+                        this.iframe.style.height = '100px';
+                        this.iframe.style.zIndex = '2147483647'; // Max z-index
+                        this.iframe.style.transition = 'width 0.3s ease, height 0.3s ease';
+                        this.iframe.style.backgroundColor = 'transparent';
+                        this.iframe.setAttribute('allow', 'microphone'); // Allow microphone if needed for voice
+                        this.shadowRoot.appendChild(this.iframe);
+                    }
+
+                    // Construct embed URL pointing to the Next.js page we created
+                    let embedUrl = '${baseUrl}/embed?agentUrl=' + encodeURIComponent(agentUrl);
+                    
+                    // Add meta parameter if provided
+                    const metaAttr = this.getAttribute('meta');
+                    if (metaAttr) {
+                        try {
+                            // Validate that it's valid JSON
+                            JSON.parse(metaAttr);
+                            embedUrl += '&meta=' + encodeURIComponent(metaAttr);
+                        } catch (e) {
+                            console.error('[🔌] Invalid meta JSON:', e);
+                        }
+                    }
+                    
+                    this.iframe.src = embedUrl;
+                }
+            }
 
-    customElements.define('promptbook-agent', PromptbookAgentElement);
-})();
-    `;
+            customElements.define('promptbook-agent-integration', PromptbookAgentIntegrationElement);
+        })();
+    `);
 
     return new NextResponse(script, {
         headers: {

package/apps/agents-server/src/app/api/federated-agents/route.ts

@@ -1,10 +1,22 @@
 import { NextResponse } from 'next/server';
 import { getFederatedServersFromMetadata } from '../../../utils/getFederatedServersFromMetadata';
+import { getMetadata } from '../../../database/getMetadata';
+import { getCurrentUser } from '../../../utils/getCurrentUser';
 
 export const dynamic = 'force-dynamic';
 
 export async function GET() {
     try {
+        const currentUser = await getCurrentUser();
+        const showFederatedServersPublicly = ((await getMetadata('SHOW_FEDERATED_SERVERS_PUBLICLY')) || 'false') === 'true';
+
+        // Only show federated servers if user is authenticated or if SHOW_FEDERATED_SERVERS_PUBLICLY is true
+        if (!currentUser && !showFederatedServersPublicly) {
+            return NextResponse.json({
+                federatedServers: [],
+            });
+        }
+
         const federatedServers = await getFederatedServersFromMetadata();
 
         return NextResponse.json({