@promptbook/cli 0.103.0-55 → 0.103.0-56

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

@@ -0,0 +1,90 @@
+'use client';
+
+import { AgentBasicInformation } from '@promptbook-local/types';
+import { XIcon } from 'lucide-react';
+import { useEffect } from 'react';
+import { AgentQrCode } from './AgentQrCode';
+
+type QrCodeModalProps = {
+    isOpen: boolean;
+    onClose: () => void;
+    agentName: string;
+    meta: AgentBasicInformation['meta'];
+    personaDescription: string;
+    agentUrl: string;
+    agentEmail: string;
+    brandColorHex: string;
+};
+
+export function QrCodeModal({
+    isOpen,
+    onClose,
+    agentName,
+    meta,
+    personaDescription,
+    agentUrl,
+    agentEmail,
+    brandColorHex,
+}: QrCodeModalProps) {
+    useEffect(() => {
+        if (isOpen) {
+            document.body.style.overflow = 'hidden';
+        } else {
+            document.body.style.overflow = '';
+        }
+        return () => {
+            document.body.style.overflow = '';
+        };
+    }, [isOpen]);
+
+    useEffect(() => {
+        function handleEscape(event: KeyboardEvent) {
+            if (event.key === 'Escape') {
+                onClose();
+            }
+        }
+
+        if (isOpen) {
+            document.addEventListener('keydown', handleEscape);
+        }
+        return () => document.removeEventListener('keydown', handleEscape);
+    }, [isOpen, onClose]);
+
+    if (!isOpen) return null;
+
+    return (
+        <div
+            className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm"
+            onClick={onClose}
+        >
+            <div
+                className="relative bg-white rounded-2xl shadow-2xl p-8 max-w-sm w-full mx-4 animate-in zoom-in-95 duration-200"
+                onClick={(e) => e.stopPropagation()}
+            >
+                <button
+                    onClick={onClose}
+                    className="absolute top-4 right-4 p-2 rounded-full hover:bg-gray-100 transition-colors"
+                    aria-label="Close"
+                >
+                    <XIcon className="w-5 h-5 text-gray-500" />
+                </button>
+
+                <h3 className="text-xl font-semibold text-gray-900 mb-6 text-center">Scan to Chat</h3>
+
+                <div className="flex justify-center">
+                    <AgentQrCode
+                        agentName={agentName}
+                        meta={meta}
+                        personaDescription={personaDescription}
+                        agentUrl={agentUrl}
+                        agentEmail={agentEmail}
+                    />
+                </div>
+
+                <p className="mt-6 text-sm text-gray-500 text-center">
+                    Scan this QR code to start chatting with {(meta.fullname as string) || agentName}
+                </p>
+            </div>
+        </div>
+    );
+}

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

@@ -0,0 +1,80 @@
+import {
+    BookOpenIcon,
+    CodeIcon,
+    GlobeIcon,
+    HistoryIcon,
+    LinkIcon,
+    MessageSquareIcon,
+    NotebookPenIcon,
+} from 'lucide-react';
+import type { ComponentType } from 'react';
+
+type AgentLink = {
+    title: string;
+    href: string;
+    icon: ComponentType<{ className?: string }>;
+    description?: string;
+    target?: '_blank' | '_self';
+    rel?: string;
+};
+
+export const getAgentLinks = (agentName: string): AgentLink[] => {
+    const encodedName = encodeURIComponent(agentName);
+    return [
+        {
+            title: 'Chat with Agent',
+            href: `/agents/${encodedName}`,
+            icon: MessageSquareIcon,
+            description: 'Direct interface to converse with the agent.',
+        },
+        {
+            title: 'Edit Book',
+            href: `/agents/${encodedName}/book`,
+            icon: NotebookPenIcon,
+            description: "Edit the agent's knowledge book.",
+        },
+        {
+            title: 'Integration',
+            href: `/agents/${encodedName}/integration`,
+            icon: CodeIcon,
+            description: 'Learn how to integrate this agent into your applications.',
+        },
+        {
+            title: 'History & Feedback',
+            href: `/agents/${encodedName}/history`,
+            icon: HistoryIcon,
+            description: 'View past conversations and provide feedback.',
+        },
+        {
+            title: 'All Links',
+            href: `/agents/${encodedName}/links`,
+            icon: LinkIcon,
+            description: 'Signpost & Links',
+        },
+        {
+            title: 'Website Integration',
+            href: `/agents/${encodedName}/website-integration`,
+            icon: GlobeIcon,
+            description: 'Embed the agent chat widget directly into your React application.',
+        },
+    ];
+};
+
+export const getAgentExternalLinks = (): AgentLink[] => [
+    {
+        title: 'Promptbook Studio',
+        href: 'https://promptbook.studio',
+        icon: BookOpenIcon,
+        description: 'Create and manage your own agents',
+        target: '_blank',
+        rel: 'noopener noreferrer',
+    },
+    {
+        title: 'GitHub Repository',
+        href: 'https://github.com/webgptorg/promptbook',
+        icon: CodeIcon,
+        description: 'Star us and contribute to the project',
+        target: '_blank',
+        rel: 'noopener noreferrer',
+    },
+];

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

@@ -1,4 +1,5 @@
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { resolveInheritedAgentSource } from '@/src/utils/resolveInheritedAgentSource';
 import { padBook, validateBook } from '@promptbook-local/core';
 import { serializeError } from '@promptbook-local/utils';
 import spaceTrim from 'spacetrim';
@@ -13,8 +14,9 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
     try {
         const collection = await $provideAgentCollectionForServer();
         const agentSource = await collection.getAgentSource(agentName);
+        const effectiveAgentSource = await resolveInheritedAgentSource(agentSource, collection);
 
-        return new Response(agentSource, {
+        return new Response(effectiveAgentSource, {
             status: 200,
             headers: { 'Content-Type': 'text/plain' /* <- TODO: [🎳] Mime type of book */ },
         });

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

@@ -77,11 +77,15 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
             userAgent,
             language,
             platform,
+            source: 'AGENT_PAGE_CHAT',
+            apiKey: null,
         });
 
         const encoder = new TextEncoder();
         const readableStream = new ReadableStream({
             start(controller) {
+                let previousContent = '';
+
                 agent.callChatModelStream!(
                     {
                         title: `Chat with agent ${
@@ -95,7 +99,11 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
                         thread,
                     },
                     (chunk) => {
-                        controller.enqueue(encoder.encode(chunk.content));
+                        const fullContent = chunk.content;
+                        const deltaContent = fullContent.substring(previousContent.length);
+                        previousContent = fullContent;
+
+                        controller.enqueue(encoder.encode(deltaContent));
                     },
                 )
                     .then(async (response) => {
@@ -119,6 +127,8 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
                             userAgent,
                             language,
                             platform,
+                            source: 'AGENT_PAGE_CHAT',
+                            apiKey: null,
                         });
 
                         // Note: [🐱‍🚀] Save the learned data

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

@@ -0,0 +1,93 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { validateApiKey } from '@/src/utils/validateApiKey';
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * GET /agents/[agentName]/api/openai/models
+ *
+ * Lists available models for the OpenAI-compatible API.
+ * This endpoint is required for OpenAI-compatible clients (like Jan, LM Studio, etc.)
+ * to discover available models.
+ */
+export async function GET(request: NextRequest, { params }: { params: Promise<{ agentName: string }> }) {
+    const { agentName } = await params;
+
+    // Validate API key explicitly (in addition to middleware)
+    const apiKeyValidation = await validateApiKey(request);
+    if (!apiKeyValidation.isValid) {
+        return NextResponse.json(
+            {
+                error: {
+                    message: apiKeyValidation.error || 'Invalid API key',
+                    type: 'authentication_error',
+                },
+            },
+            { status: 401 },
+        );
+    }
+
+    try {
+        const collection = await $provideAgentCollectionForServer();
+
+        let agentSource;
+        try {
+            agentSource = await collection.getAgentSource(agentName);
+        } catch (error) {
+            return NextResponse.json(
+                { error: { message: `Agent '${agentName}' not found.`, type: 'invalid_request_error' } },
+                { status: 404 },
+            );
+        }
+
+        if (!agentSource) {
+            return NextResponse.json(
+                { error: { message: `Agent '${agentName}' not found.`, type: 'invalid_request_error' } },
+                { status: 404 },
+            );
+        }
+
+        // Return the agent as a single model in OpenAI format
+        // The model ID is the agent name, which clients will use when making chat completion requests
+        const models = [
+            {
+                id: agentName,
+                object: 'model',
+                created: Math.floor(Date.now() / 1000),
+                owned_by: 'promptbook',
+                permission: [
+                    {
+                        id: `modelperm-${agentName}`,
+                        object: 'model_permission',
+                        created: Math.floor(Date.now() / 1000),
+                        allow_create_engine: false,
+                        allow_sampling: true,
+                        allow_logprobs: false,
+                        allow_search_indices: false,
+                        allow_view: true,
+                        allow_fine_tuning: false,
+                        organization: '*',
+                        group: null,
+                        is_blocking: false,
+                    },
+                ],
+                root: agentName,
+                parent: null,
+            },
+        ];
+
+        return NextResponse.json({
+            object: 'list',
+            data: models,
+        });
+    } catch (error) {
+        console.error('Error in models listing handler:', error);
+        return NextResponse.json(
+            { error: { message: (error as Error).message || 'Internal Server Error', type: 'server_error' } },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * TODO: [🧠] Consider listing all available agents as models when agentName is a wildcard or special value
+ */

package/apps/agents-server/src/app/agents/[agentName]/api/openai/v1/chat/completions/route.ts

@@ -0,0 +1,10 @@
+import { handleChatCompletion } from '@/src/utils/handleChatCompletion';
+import { NextRequest } from 'next/server';
+
+export async function POST(
+    request: NextRequest,
+    { params }: { params: Promise<{ agentName: string }> },
+) {
+    const { agentName } = await params;
+    return handleChatCompletion(request, { agentName }, 'OpenAI API Chat Completion');
+}

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

@@ -0,0 +1,93 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { validateApiKey } from '@/src/utils/validateApiKey';
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * GET /agents/[agentName]/api/openai/v1/models
+ *
+ * Lists available models for the OpenAI-compatible API.
+ * This endpoint is required for OpenAI-compatible clients (like Jan, LM Studio, etc.)
+ * to discover available models.
+ */
+export async function GET(request: NextRequest, { params }: { params: Promise<{ agentName: string }> }) {
+    const { agentName } = await params;
+
+    // Validate API key explicitly (in addition to middleware)
+    const apiKeyValidation = await validateApiKey(request);
+    if (!apiKeyValidation.isValid) {
+        return NextResponse.json(
+            {
+                error: {
+                    message: apiKeyValidation.error || 'Invalid API key',
+                    type: 'authentication_error',
+                },
+            },
+            { status: 401 },
+        );
+    }
+
+    try {
+        const collection = await $provideAgentCollectionForServer();
+
+        let agentSource;
+        try {
+            agentSource = await collection.getAgentSource(agentName);
+        } catch (error) {
+            return NextResponse.json(
+                { error: { message: `Agent '${agentName}' not found.`, type: 'invalid_request_error' } },
+                { status: 404 },
+            );
+        }
+
+        if (!agentSource) {
+            return NextResponse.json(
+                { error: { message: `Agent '${agentName}' not found.`, type: 'invalid_request_error' } },
+                { status: 404 },
+            );
+        }
+
+        // Return the agent as a single model in OpenAI format
+        // The model ID is the agent name, which clients will use when making chat completion requests
+        const models = [
+            {
+                id: agentName,
+                object: 'model',
+                created: Math.floor(Date.now() / 1000),
+                owned_by: 'promptbook',
+                permission: [
+                    {
+                        id: `modelperm-${agentName}`,
+                        object: 'model_permission',
+                        created: Math.floor(Date.now() / 1000),
+                        allow_create_engine: false,
+                        allow_sampling: true,
+                        allow_logprobs: false,
+                        allow_search_indices: false,
+                        allow_view: true,
+                        allow_fine_tuning: false,
+                        organization: '*',
+                        group: null,
+                        is_blocking: false,
+                    },
+                ],
+                root: agentName,
+                parent: null,
+            },
+        ];
+
+        return NextResponse.json({
+            object: 'list',
+            data: models,
+        });
+    } catch (error) {
+        console.error('Error in models listing handler:', error);
+        return NextResponse.json(
+            { error: { message: (error as Error).message || 'Internal Server Error', type: 'server_error' } },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * TODO: [🧠] Consider listing all available agents as models when agentName is a wildcard or special value
+ */

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

@@ -98,6 +98,8 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
             userAgent,
             language,
             platform,
+            source: 'AGENT_PAGE_CHAT',
+            apiKey: null,
         });
 
         // Call Agent
@@ -131,6 +133,8 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
             userAgent,
             language,
             platform,
+            source: 'AGENT_PAGE_CHAT',
+            apiKey: null,
         });
 
         // Learning

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

@@ -7,16 +7,23 @@ import { AgentChatWrapper } from '../AgentChatWrapper';
 
 export const generateMetadata = generateAgentMetadata;
 
-export default async function AgentChatPage({ params }: { params: Promise<{ agentName: string }> }) {
+export default async function AgentChatPage({
+    params,
+    searchParams,
+}: {
+    params: Promise<{ agentName: string }>;
+    searchParams: Promise<{ message?: string }>;
+}) {
     $sideEffect(headers());
     let { agentName } = await params;
     agentName = decodeURIComponent(agentName);
+    const { message } = await searchParams;
 
     const agentUrl = `/agents/${agentName}`;
 
     return (
         <main className={`w-screen h-screen`}>
-            <AgentChatWrapper agentUrl={agentUrl} />
+            <AgentChatWrapper agentUrl={agentUrl} autoExecuteMessage={message} />
         </main>
     );
 }

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

@@ -0,0 +1,31 @@
+'use client';
+
+import { CodePreview } from '../../../../../../_common/components/CodePreview/CodePreview';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '../../../../../../_common/components/Tabs/Tabs';
+
+type SdkCodeTabsProps = {
+    curlCode: string;
+    pythonCode: string;
+    jsCode: string;
+};
+
+export function SdkCodeTabs({ curlCode, pythonCode, jsCode }: SdkCodeTabsProps) {
+    return (
+        <Tabs defaultValue="curl" className="w-full">
+            <TabsList>
+                <TabsTrigger value="curl">cURL</TabsTrigger>
+                <TabsTrigger value="python">Python SDK</TabsTrigger>
+                <TabsTrigger value="javascript">JavaScript/TypeScript SDK</TabsTrigger>
+            </TabsList>
+            <TabsContent value="curl">
+                <CodePreview code={curlCode} language="bash" />
+            </TabsContent>
+            <TabsContent value="python">
+                <CodePreview code={pythonCode} language="python" />
+            </TabsContent>
+            <TabsContent value="javascript">
+                <CodePreview code={jsCode} language="typescript" />
+            </TabsContent>
+        </Tabs>
+    );
+}