@promptbook/cli 0.104.0-1 → 0.104.0-11

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

@@ -27,7 +27,11 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         const agentSource = await collection.getAgentSource(agentName);
         const agentProfile = parseAgentSource(agentSource);
         const agentHash = computeAgentHash(agentSource);
-        const isVoiceCallingEnabled = (await getMetadata('IS_VOICE_CALLING_ENABLED')) === 'true';
+        const isVoiceCallingEnabled = (await getMetadata('IS_EXPERIMENTAL_VOICE_CALLING_ENABLED')) === 'true';
+
+        if (!agentProfile.meta.image) {
+            agentProfile.meta.image = `/agents/${encodeURIComponent(agentName)}/images/default-avatar.png`;
+        }
 
         return new Response(
             JSON.stringify(

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

@@ -6,10 +6,13 @@ import { $provideOpenAiAssistantExecutionToolsForServer } from '@/src/tools/$pro
 import { Agent, computeAgentHash, PROMPTBOOK_ENGINE_VERSION } from '@promptbook-local/core';
 import { computeHash, serializeError } from '@promptbook-local/utils';
 import { assertsError } from '../../../../../../../../src/errors/assertsError';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
 
 export const maxDuration = 300;
 
 export async function OPTIONS(request: Request) {
+    keepUnused(request);
+
     return new Response(null, {
         status: 200,
         headers: {
@@ -22,7 +25,7 @@ export async function OPTIONS(request: Request) {
 
 export async function POST(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
     // Check if voice calling is enabled
-    const isVoiceCallingEnabled = (await getMetadata('IS_VOICE_CALLING_ENABLED')) === 'true';
+    const isVoiceCallingEnabled = (await getMetadata('IS_EXPERIMENTAL_VOICE_CALLING_ENABLED')) === 'true';
     if (!isVoiceCallingEnabled) {
         return new Response(JSON.stringify({ error: 'Voice calling is disabled on this server' }), {
             status: 403,
@@ -38,7 +41,7 @@ export async function POST(request: Request, { params }: { params: Promise<{ age
     const audioFile = formData.get('audio') as File | null;
     const threadString = formData.get('thread') as string | null;
     const thread = threadString ? JSON.parse(threadString) : undefined;
-    const messageContext = formData.get('message') as string | null; // Optional text context or previous message?
+    // const messageContext = formData.get('message') as string | null; // Optional text context or previous message?
 
     if (!audioFile) {
         return new Response(JSON.stringify({ error: 'No audio file provided' }), {

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

@@ -2,6 +2,7 @@
 
 import { BookEditor } from '@promptbook-local/components';
 import { string_book } from '@promptbook-local/types';
+import { upload } from '@vercel/blob/client';
 import { useEffect, useRef, useState } from 'react';
 
 type BookEditorWrapperProps = {
@@ -93,35 +94,38 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                 value={agentSource}
                 onChange={handleChange}
                 onFileUpload={async (file) => {
-                    const formData = new FormData();
-                    formData.append('file', file);
-
-                    const response = await fetch('/api/upload', {
-                        method: 'POST',
-                        body: formData,
+                    console.info('🔼 Uploading file', file);
+
+                    // Build the full path including prefix and user/files directory
+                    const pathPrefix = process.env.NEXT_PUBLIC_CDN_PATH_PREFIX || '';
+                    const uploadPath = pathPrefix ? `${pathPrefix}/user/files/${file.name}` : `user/files/${file.name}`;
+
+                    // Upload directly to Vercel Blob using client upload
+                    const blob = await upload(uploadPath, file, {
+                        access: 'public',
+                        handleUploadUrl: '/api/upload',
+                        clientPayload: JSON.stringify({
+                            purpose: 'KNOWLEDGE',
+                            contentType: file.type,
+                        }),
                     });
 
-                    if (!response.ok) {
-                        throw new Error(`Failed to upload file: ${response.statusText}`);
-                    }
-
-                    const { fileUrl: longFileUrl } = await response.json();
+                    const fileUrl = blob.url;
 
                     const LONG_URL = `${process.env.NEXT_PUBLIC_CDN_PUBLIC_URL!}/${process.env
                         .NEXT_PUBLIC_CDN_PATH_PREFIX!}/user/files/`;
                     const SHORT_URL = `https://ptbk.io/k/`;
                     // <- TODO: [🌍] Unite this logic in one place
 
-                    const shortFileUrl = longFileUrl.split(LONG_URL).join(SHORT_URL);
+                    const shortFileUrl = fileUrl.split(LONG_URL).join(SHORT_URL);
 
-                    console.log(`File uploaded:`, {
+                    console.log(`🔼 File uploaded:`, {
                         LONG_URL,
                         SHORT_URL,
-                        longFileUrl,
+                        fileUrl,
                         shortFileUrl,
                         file,
-                        formData,
-                        response,
+                        blob,
                     });
 
                     return shortFileUrl;

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

@@ -5,21 +5,34 @@ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentColle
 import { isUserAdmin } from '@/src/utils/isUserAdmin';
 import { headers } from 'next/headers';
 import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { isAgentDeleted } from '../_utils';
 import { generateAgentMetadata } from '../generateAgentMetadata';
 import { BookEditorWrapper } from './BookEditorWrapper';
+import { DeletedAgentBanner } from '../../../../components/DeletedAgentBanner';
 
 export const generateMetadata = generateAgentMetadata;
 
 export default async function AgentBookPage({ params }: { params: Promise<{ agentName: string }> }) {
     $sideEffect(headers());
 
+    let { agentName } = await params;
+    agentName = decodeURIComponent(agentName);
+
+    const isDeleted = await isAgentDeleted(agentName);
+
+    if (isDeleted) {
+        return (
+            <div className="w-screen h-[calc(100vh-60px)] flex items-center justify-center p-8">
+                <DeletedAgentBanner />
+            </div>
+        );
+    }
+
     if (!(await isUserAdmin())) {
         /* <- TODO: [👹] Here should be user permissions */
         return <ForbiddenPage />;
     }
 
-    let { agentName } = await params;
-    agentName = decodeURIComponent(agentName);
     const collection = await $provideAgentCollectionForServer();
     const agentSource = await collection.getAgentSource(decodeURIComponent(agentName));
 

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

@@ -5,21 +5,34 @@ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentColle
 import { isUserAdmin } from '@/src/utils/isUserAdmin';
 import { headers } from 'next/headers';
 import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { isAgentDeleted } from '../_utils';
 import { generateAgentMetadata } from '../generateAgentMetadata';
 import { AgentBookAndChat } from './AgentBookAndChat';
+import { DeletedAgentBanner } from '../../../../components/DeletedAgentBanner';
 
 export const generateMetadata = generateAgentMetadata;
 
 export default async function AgentBookAndChatPage({ params }: { params: Promise<{ agentName: string }> }) {
     $sideEffect(headers());
 
+    let { agentName } = await params;
+    agentName = decodeURIComponent(agentName);
+
+    const isDeleted = await isAgentDeleted(agentName);
+
+    if (isDeleted) {
+        return (
+            <div className="w-screen h-[calc(100vh-60px)] flex items-center justify-center p-8">
+                <DeletedAgentBanner />
+            </div>
+        );
+    }
+
     if (!(await isUserAdmin())) {
         /* <- TODO: [👹] Here should be user permissions */
         return <ForbiddenPage />;
     }
 
-    let { agentName } = await params;
-    agentName = decodeURIComponent(agentName);
     const collection = await $provideAgentCollectionForServer();
     const agentSource = await collection.getAgentSource(agentName);
     const agentUrl = `/agents/${agentName}`;

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

@@ -2,8 +2,10 @@
 
 import { headers } from 'next/headers';
 import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { isAgentDeleted } from '../_utils';
 import { generateAgentMetadata } from '../generateAgentMetadata';
 import { AgentChatWrapper } from '../AgentChatWrapper';
+import { DeletedAgentBanner } from '../../../../components/DeletedAgentBanner';
 
 export const generateMetadata = generateAgentMetadata;
 
@@ -19,6 +21,16 @@ export default async function AgentChatPage({
     agentName = decodeURIComponent(agentName);
     const { message } = await searchParams;
 
+    const isDeleted = await isAgentDeleted(agentName);
+
+    if (isDeleted) {
+        return (
+            <main className="w-screen h-screen flex items-center justify-center p-8">
+                <DeletedAgentBanner message="This agent has been deleted. You can restore it from the Recycle Bin." />
+            </main>
+        );
+    }
+
     const agentUrl = `/agents/${agentName}`;
 
     return (

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

@@ -0,0 +1,68 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { $provideExecutionToolsForServer } from '@/src/tools/$provideExecutionToolsForServer';
+import { NextRequest, NextResponse } from 'next/server';
+import { $bookTranspilersRegister } from '../../../../../../../../src/transpilers/_common/register/$bookTranspilersRegister';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
+
+export async function GET(request: NextRequest, { params }: { params: Promise<{ agentName: string }> }) {
+    keepUnused(request);
+    keepUnused(params);
+    // const agentName = (await params).agentName;
+
+    try {
+        // Get available transpilers
+        const transpilers = $bookTranspilersRegister.list().map((transpiler) => ({
+            name: transpiler.name,
+            title: transpiler.title,
+        }));
+
+        return NextResponse.json({ transpilers });
+    } catch (error) {
+        console.error('Error getting transpilers:', error);
+        return NextResponse.json({ error: 'Failed to get transpilers' }, { status: 500 });
+    }
+}
+
+export async function POST(request: NextRequest, { params }: { params: Promise<{ agentName: string }> }) {
+    const agentName = (await params).agentName;
+
+    try {
+        const { transpilerName } = await request.json();
+
+        if (!transpilerName) {
+            return NextResponse.json({ error: 'Transpiler name is required' }, { status: 400 });
+        }
+
+        // Get the transpiler
+        const allTranspilers = $bookTranspilersRegister.list();
+        const transpiler = allTranspilers.find((t) => t.name === transpilerName);
+        if (!transpiler) {
+            return NextResponse.json({ error: 'Transpiler not found' }, { status: 404 });
+        }
+
+        // Get agent source
+        const collection = await $provideAgentCollectionForServer();
+        const agentSource = await collection.getAgentSource(agentName);
+
+        if (!agentSource) {
+            return NextResponse.json({ error: 'Agent source not found' }, { status: 404 });
+        }
+
+        // Get execution tools
+        const tools = await $provideExecutionToolsForServer();
+
+        // Transpile the code
+        const transpiledCode = await transpiler.transpileBook(agentSource, tools);
+
+        return NextResponse.json({
+            code: transpiledCode,
+            transpiler: {
+                name: transpiler.name,
+                title: transpiler.title,
+            },
+        });
+    } catch (error) {
+        console.error('Error transpiling code:', error);
+        return NextResponse.json({ error: 'Failed to transpile code' }, { status: 500 });
+    }
+}

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

@@ -0,0 +1,223 @@
+'use client';
+
+import { NEXT_PUBLIC_SITE_URL } from '@/config';
+import Editor from '@monaco-editor/react';
+import { generatePlaceholderAgentProfileImageUrl } from '@promptbook-local/core';
+import { AgentBasicInformation } from '@promptbook-local/types';
+import { ArrowLeftIcon, ChevronDownIcon, CodeIcon } from 'lucide-react';
+import Link from 'next/link';
+import { useCallback, useEffect, useState } from 'react';
+
+type Transpiler = {
+    name: string;
+    title: string;
+};
+
+type TranspilationResult = {
+    code: string;
+    transpiler: Transpiler;
+};
+
+function getLanguageFromTranspiler(transpilerName?: string): string {
+    if (!transpilerName) return 'plaintext';
+
+    // Map transpiler names to Monaco language identifiers
+    if (transpilerName.includes('openai-sdk')) return 'javascript';
+    if (transpilerName.includes('langchain') || transpilerName.includes('python')) return 'python';
+    if (transpilerName.includes('markdown')) return 'markdown';
+
+    // Default to plaintext for unknown transpilers
+    return 'plaintext';
+}
+
+export default function AgentCodePage({ params }: { params: Promise<{ agentName: string }> }) {
+    const [agentName, setAgentName] = useState<string>('');
+    const [agentProfile, setAgentProfile] = useState<AgentBasicInformation | null>(null);
+    const [transpilers, setTranspilers] = useState<Transpiler[]>([]);
+    const [selectedTranspiler, setSelectedTranspiler] = useState<Transpiler | null>(null);
+    const [transpiledCode, setTranspiledCode] = useState<string>('');
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState<string>('');
+
+    useEffect(() => {
+        params.then((p) => setAgentName(p.agentName));
+    }, [params]);
+
+    useEffect(() => {
+        if (!agentName) return;
+
+        // Fetch agent profile
+        fetch(`/api/agents/${encodeURIComponent(agentName)}`)
+            .then((res) => res.json())
+            .then((data) => setAgentProfile(data))
+            .catch((err) => console.error('Error fetching agent profile:', err));
+
+        // Fetch available transpilers
+        fetch(`/agents/${encodeURIComponent(agentName)}/code/api`)
+            .then((res) => res.json())
+            .then((data) => {
+                setTranspilers(data.transpilers || []);
+                if (data.transpilers && data.transpilers.length > 0) {
+                    setSelectedTranspiler(data.transpilers[0]);
+                }
+            })
+            .catch((err) => console.error('Error fetching transpilers:', err));
+    }, [agentName]);
+
+    const transpileCode = useCallback(
+        async (transpilerName: string) => {
+            setLoading(true);
+            setError('');
+
+            try {
+                const response = await fetch(`/agents/${encodeURIComponent(agentName)}/code/api`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({ transpilerName }),
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json();
+                    throw new Error(errorData.error || 'Failed to transpile code');
+                }
+
+                const result: TranspilationResult = await response.json();
+                setTranspiledCode(result.code);
+            } catch (err) {
+                setError(err instanceof Error ? err.message : 'Failed to transpile code');
+                setTranspiledCode('');
+            } finally {
+                setLoading(false);
+            }
+        },
+        [agentName],
+    );
+
+    useEffect(() => {
+        if (selectedTranspiler && agentName) {
+            transpileCode(selectedTranspiler.name);
+        }
+    }, [selectedTranspiler, agentName, transpileCode]);
+
+    if (!agentProfile) {
+        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 p-12">
+                    <div className="text-center">Loading...</div>
+                </div>
+            </div>
+        );
+    }
+
+    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">
+                    {/* eslint-disable @typescript-eslint/no-explicit-any, @next/next/no-img-element */}
+
+                    <img
+                        src={
+                            agentProfile.meta.image ||
+                            generatePlaceholderAgentProfileImageUrl(
+                                agentProfile.permanentId || agentName,
+                                NEXT_PUBLIC_SITE_URL, // <- TODO: !!!! Use here `const { publicUrl } = await $provideServer();`
+                            )
+                        }
+                        alt={agentProfile.meta.fullname || agentName}
+                        className="w-16 h-16 rounded-full object-cover border-2 border-gray-200"
+                    />
+
+                    <div className="flex-1">
+                        {/* eslint-disable-next-line @typescript-eslint/no-explicit-any */}
+                        <h1 className="text-2xl font-bold text-gray-900">
+                            {(agentProfile as any)?.meta?.fullname || agentName}
+                        </h1>
+                        <p className="text-gray-500 flex items-center gap-2">
+                            <CodeIcon className="w-4 h-4" />
+                            Generated Code
+                        </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">
+                    {/* Transpiler Selector */}
+                    <div className="mb-6">
+                        <label className="block text-sm font-medium text-gray-700 mb-2">Select Transpiler</label>
+                        <div className="relative">
+                            <select
+                                value={selectedTranspiler?.name || ''}
+                                onChange={(e) => {
+                                    const transpiler = transpilers.find((t) => t.name === e.target.value);
+                                    if (transpiler) setSelectedTranspiler(transpiler);
+                                }}
+                                className="w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
+                            >
+                                {transpilers.map((transpiler) => (
+                                    <option key={transpiler.name} value={transpiler.name}>
+                                        {transpiler.title}
+                                    </option>
+                                ))}
+                            </select>
+                            <ChevronDownIcon className="absolute right-3 top-3 w-4 h-4 text-gray-400 pointer-events-none" />
+                        </div>
+                    </div>
+
+                    {/* Code Display */}
+                    <div className="bg-gray-50 rounded-lg border border-gray-200 overflow-hidden">
+                        <div className="p-4 border-b border-gray-200 flex items-center justify-between">
+                            <h2 className="text-lg font-semibold text-gray-900">
+                                {selectedTranspiler?.title || 'Generated Code'}
+                            </h2>
+                            {loading && <div className="text-sm text-gray-500">Generating...</div>}
+                        </div>
+                        <div className="p-4">
+                            {error && (
+                                <div className="text-red-600 text-sm mb-4 p-3 bg-red-50 rounded border border-red-200">
+                                    {error}
+                                </div>
+                            )}
+                            {transpiledCode ? (
+                                <div className="h-96 border border-gray-200 rounded">
+                                    <Editor
+                                        value={transpiledCode}
+                                        language={getLanguageFromTranspiler(selectedTranspiler?.name)}
+                                        options={{
+                                            readOnly: true,
+                                            minimap: { enabled: false },
+                                            fontSize: 14,
+                                            lineNumbers: 'on',
+                                            scrollBeyondLastLine: false,
+                                            automaticLayout: true,
+                                            wordWrap: 'on',
+                                        }}
+                                        loading={
+                                            <div className="flex items-center justify-center h-full text-gray-500">
+                                                Loading editor...
+                                            </div>
+                                        }
+                                    />
+                                </div>
+                            ) : loading ? (
+                                <div className="text-gray-500 text-center py-8">Generating code...</div>
+                            ) : (
+                                <div className="text-gray-500 text-center py-8">
+                                    Select a transpiler to generate code
+                                </div>
+                            )}
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    );
+}

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

@@ -15,6 +15,8 @@ export async function generateAgentMetadata({ params }: { params: Promise<{ agen
         // Use the agent's icon-256.png as the favicon
         const iconUrl = `/agents/${encodeURIComponent(agentName)}/images/icon-256.png`;
 
+        const canonicalUrl = `/agents/${encodeURIComponent(agentProfile.permanentId || agentName)}`;
+
         const metadata = {
             metadataBase: publicUrl,
             title,
@@ -24,6 +26,9 @@ export async function generateAgentMetadata({ params }: { params: Promise<{ agen
                 shortcut: iconUrl,
                 apple: iconUrl,
             },
+            alternates: {
+                canonical: canonicalUrl,
+            },
             openGraph: {
                 title,
                 description,

package/apps/agents-server/src/app/agents/[agentName]/history/actions.ts

@@ -5,8 +5,8 @@ import { revalidatePath } from 'next/cache';
 
 export async function restoreAgentVersion(agentName: string, historyId: number) {
     const collection = await $provideAgentCollectionForServer();
-    await collection.restoreAgent(historyId);
-    
+    await collection.restoreAgentFromHistory(historyId);
+
     revalidatePath(`/agents/${agentName}`);
     revalidatePath(`/agents/${agentName}/history`);
 }

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

@@ -10,7 +10,8 @@ export const metadata = {
 export default async function AgentHistoryPage({ params }: { params: Promise<{ agentName: string }> }) {
     const { agentName } = await params;
     const collection = await $provideAgentCollectionForServer();
-    const history = await collection.listAgentHistory(agentName);
+    const agentId = await collection.getAgentPermanentId(agentName);
+    const history = await collection.listAgentHistory(agentId);
 
     return (
         <div className="container mx-auto p-6 max-w-4xl">
@@ -21,7 +22,10 @@ export default async function AgentHistoryPage({ params }: { params: Promise<{ a
                 <div>
                     <h1 className="text-3xl font-bold text-gray-900">History: {agentName}</h1>
                     <p className="text-gray-600">
-                        Previous versions of this agent. <Link href={`/agents/${agentName}`} className="text-blue-600 hover:underline">Back to agent</Link>
+                        Previous versions of this agent.{' '}
+                        <Link href={`/agents/${agentName}`} className="text-blue-600 hover:underline">
+                            Back to agent
+                        </Link>
                     </p>
                 </div>
             </header>
@@ -47,7 +51,10 @@ export default async function AgentHistoryPage({ params }: { params: Promise<{ a
                                             Version {history.length - index}
                                         </h3>
                                         <p className="text-sm text-gray-500">
-                                            Hash: <code className="bg-gray-100 px-1 rounded">{item.agentHash.substring(0, 8)}</code>
+                                            Hash:{' '}
+                                            <code className="bg-gray-100 px-1 rounded">
+                                                {item.agentHash.substring(0, 8)}
+                                            </code>
                                         </p>
                                     </div>
                                     <RestoreVersionButton agentName={agentName} historyId={item.id} />

package/apps/agents-server/src/app/agents/[agentName]/images/default-avatar.png/getAgentDefaultAvatarPrompt.ts

@@ -0,0 +1,31 @@
+import { AgentBasicInformation } from '@promptbook-local/types';
+import spaceTrim from 'spacetrim';
+import { string_prompt_image } from '../../../../../../../../src/types/typeAliases';
+
+export function getAgentDefaultAvatarPrompt(agent: AgentBasicInformation): string_prompt_image {
+    const {
+        agentName,
+        personaDescription,
+        meta: { fullname, color },
+    } = agent;
+
+    return spaceTrim(
+        (block) => `
+            Professional corporate headshot of ${fullname || agentName}
+            
+            ${block(personaDescription || '')}
+            
+            - Professional business portrait photograph
+            - Photorealistic, studio quality lighting
+            - Shot with 85mm lens, shallow depth of field
+            - Neutral gray or soft gradient background
+            - Subject wearing professional attire with accent colors: ${color}
+            - Confident, approachable expression with slight smile
+            - Eye-level camera angle, centered composition
+            - Soft diffused lighting, subtle rim light
+            - Sharp focus on eyes, cinematic color grading
+            - 8K resolution, ultra detailed
+            
+        `,
+    );
+}