@promptbook/cli 0.104.0-10 → 0.104.0-12

package/apps/agents-server/src/components/Homepage/AgentCard.tsx

@@ -5,16 +5,17 @@ import { really_any } from '@promptbook-local/types';
 import { EyeIcon, EyeOffIcon, RotateCcwIcon } from 'lucide-react';
 import Link from 'next/link';
 import { AgentBasicInformation } from '../../../../../src/book-2.0/agent-source/AgentBasicInformation';
+import { AgentCapabilityChips } from '../AgentProfile/AgentCapabilityChips';
 import { useAgentBackground } from '../AgentProfile/useAgentBackground';
 
 type AgentCardProps = {
     /**
-     * @@@
+     * The basic information of the agent to display
      */
     readonly agent: AgentBasicInformation;
 
     /**
-     * @@@
+     * The URL to navigate to when the card is clicked
      */
     readonly href: string;
 
@@ -24,32 +25,32 @@ type AgentCardProps = {
     readonly publicUrl: URL;
 
     /**
-     * @@@
+     * Whether the current user has admin privileges
      */
     readonly isAdmin?: boolean;
 
     /**
-     * @@@
+     * Callback function to delete the agent
      */
     readonly onDelete?: (agentIdentifier: string) => void;
 
     /**
-     * @@@
+     * Callback function to clone the agent
      */
     readonly onClone?: (agentIdentifier: string) => void;
 
     /**
-     * @@@
+     * Callback function to toggle the agent's visibility
      */
     readonly onToggleVisibility?: (agentIdentifier: string) => void;
 
     /**
-     * @@@
+     * Callback function to restore a deleted agent
      */
     readonly onRestore?: (agentIdentifier: string) => void;
 
     /**
-     * @@@
+     * The current visibility status of the agent
      */
     readonly visibility?: 'PUBLIC' | 'PRIVATE';
 };
@@ -122,6 +123,10 @@ export function AgentCard({
                         <p className="text-sm text-gray-800 text-center line-clamp-3 leading-relaxed font-medium mix-blend-hard-light">
                             {personaDescription}
                         </p>
+
+                        <div className="flex justify-center w-full">
+                            <AgentCapabilityChips agent={agent} className="justify-center mt-3 opacity-90 scale-90" />
+                        </div>
                     </div>
                 </div>
             </Link>

package/apps/agents-server/src/database/$getTableName.ts

@@ -15,4 +15,5 @@ type string_table_name = keyof AgentsServerDatabase['public']['Tables'];
 export async function $getTableName<TTable extends string_table_name>(tableName: TTable): Promise<TTable> {
     const { tablePrefix } = await $provideServer();
     return `${tablePrefix}${tableName}` as TTable;
+    // <- TODO: [🏧] DRY
 }

package/apps/agents-server/src/database/migrations/2025-12-0830-image-purpose.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "prefix_Image" ADD COLUMN "agentId" BIGINT REFERENCES "prefix_Agent"("id") ON DELETE CASCADE;
+ALTER TABLE "prefix_Image" ADD COLUMN "purpose" TEXT CHECK ("purpose" IN ('AVATAR', 'TESTING'));
+
+COMMENT ON COLUMN "prefix_Image"."agentId" IS 'The agent this image belongs to (nullable for testing images)';
+COMMENT ON COLUMN "prefix_Image"."purpose" IS 'The purpose of the image (AVATAR or TESTING)';

package/apps/agents-server/src/database/migrations/2025-12-0890-file-agent-id.sql

@@ -0,0 +1,5 @@
+-- Add agentId column to associate files with agents
+ALTER TABLE "prefix_File" ADD COLUMN IF NOT EXISTS "agentId" INTEGER NULL;
+
+-- Add foreign key constraint to Agent table
+ALTER TABLE "prefix_File" ADD CONSTRAINT "File_agentId_fkey" FOREIGN KEY ("agentId") REFERENCES "prefix_Agent" ("id") ON DELETE SET NULL;

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

@@ -389,6 +389,8 @@ export type AgentsServerDatabase = {
                     prompt: string;
                     cdnUrl: string;
                     cdnKey: string;
+                    agentId: number | null;
+                    purpose: 'AVATAR' | 'TESTING' | null;
                 };
                 Insert: {
                     id?: number;
@@ -398,6 +400,8 @@ export type AgentsServerDatabase = {
                     prompt: string;
                     cdnUrl: string;
                     cdnKey: string;
+                    agentId?: number | null;
+                    purpose?: 'AVATAR' | 'TESTING' | null;
                 };
                 Update: {
                     id?: number;
@@ -407,8 +411,17 @@ export type AgentsServerDatabase = {
                     prompt?: string;
                     cdnUrl?: string;
                     cdnKey?: string;
+                    agentId?: number | null;
+                    purpose?: 'AVATAR' | 'TESTING' | null;
                 };
-                Relationships: [];
+                Relationships: [
+                    {
+                        foreignKeyName: 'Image_agentId_fkey';
+                        columns: ['agentId'];
+                        referencedRelation: 'Agent';
+                        referencedColumns: ['id'];
+                    },
+                ];
             };
             File: {
                 Row: {

package/apps/agents-server/src/utils/messages/sendMessage.ts

@@ -1,3 +1,4 @@
+import type { PostgrestSingleResponse, SupabaseClient } from '@supabase/supabase-js';
 import type { really_any } from '@promptbook-local/types';
 import { serializeError } from '@promptbook-local/utils';
 import { assertsError } from '../../../../../src/errors/assertsError';
@@ -5,15 +6,16 @@ import { $getTableName } from '../../database/$getTableName';
 import { $provideSupabaseForServer } from '../../database/$provideSupabaseForServer';
 import { EMAIL_PROVIDERS } from '../../message-providers';
 import { OutboundEmail } from '../../message-providers/email/_common/Email';
+import type { AgentsServerDatabase } from '../../database/schema';
 
 /**
  * Sends a message
  */
 export async function sendMessage(message: OutboundEmail): Promise<void> {
-    const supabase = await $provideSupabaseForServer();
+    const supabase: SupabaseClient<AgentsServerDatabase> = await $provideSupabaseForServer();
 
     // 1. Insert message
-    const { data: insertedMessage, error: insertError } = await supabase
+    const { data: insertedMessage, error: insertError }: PostgrestSingleResponse<AgentsServerDatabase['public']['Tables']['Message']['Row']> = await supabase
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         .from(await $getTableName('Message'))
         .insert({
@@ -46,11 +48,11 @@ export async function sendMessage(message: OutboundEmail): Promise<void> {
             return;
         }
 
-        let isSent = false;
+        let isSent: boolean = false;
 
         for (const providerName of providers) {
             const provider = EMAIL_PROVIDERS[providerName];
-            let isSuccessful = false;
+            let isSuccessful: boolean = false;
             let raw: really_any = null;
 
             try {
@@ -67,7 +69,6 @@ export async function sendMessage(message: OutboundEmail): Promise<void> {
             // 3. Log attempt
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             await supabase.from(await $getTableName('MessageSendAttempt')).insert({
-                // @ts-expect-error: insertedMessage is any
                 messageId: insertedMessage.id,
                 providerName,
                 isSuccessful,

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.104.0-10';
+const PROMPTBOOK_ENGINE_VERSION = '0.104.0-12';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5410,7 +5410,7 @@ function countUsage(llmTools) {
  * TODO: [🧠] Is there some meaningfull way how to test this util
  * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
  *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual explaining the construction and usage of LLM tools in the Promptbook ecosystem
  */
 
 /**
@@ -5663,7 +5663,7 @@ function joinLlmExecutionTools(title, ...llmExecutionTools) {
 }
 /**
  * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
  */
 
 /**
@@ -5848,7 +5848,7 @@ async function $provideLlmToolsForWizardOrCli(options) {
 }
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
  * TODO: [🥃] Allow `ptbk make` without llm tools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
  * TODO: [®] DRY Register logic
@@ -8005,7 +8005,7 @@ function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools) {
 }
 /**
  * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
  */
 
 /**
@@ -19302,6 +19302,22 @@ resultContent, rawResponse) {
  * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
  */
 
+/**
+ * Maps Promptbook tools to OpenAI tools.
+ *
+ * @private
+ */
+function mapToolsToOpenAi(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+
 /**
  * Parses an OpenAI error message to identify which parameter is unsupported
  *
@@ -19499,6 +19515,9 @@ class OpenAiCompatibleExecutionTools {
                 },
             ],
             user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
+            tools: currentModelRequirements.tools === undefined
+                ? undefined
+                : mapToolsToOpenAi(currentModelRequirements.tools),
         };
         const start = $getCurrentDate();
         if (this.options.isVerbose) {
@@ -19643,6 +19662,7 @@ class OpenAiCompatibleExecutionTools {
         const rawPromptContent = templateParameters(content, { ...parameters, modelName });
         const rawRequest = {
             ...modelSettings,
+            model: modelName,
             prompt: rawPromptContent,
             user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
         };
@@ -19897,8 +19917,8 @@ class OpenAiCompatibleExecutionTools {
         const rawPromptContent = templateParameters(content, { ...parameters, modelName });
         const rawRequest = {
             ...modelSettings,
-            size: modelSettings.size || '1024x1024',
             prompt: rawPromptContent,
+            size: modelSettings.size || '1024x1024',
             user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
             response_format: 'url', // TODO: [🧠] Maybe allow b64_json
         };
@@ -20796,6 +20816,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             thread: {
                 messages: threadMessages,
             },
+            tools: modelRequirements.tools === undefined ? undefined : mapToolsToOpenAi(modelRequirements.tools),
             // <- TODO: Add user identification here> user: this.options.user,
         };
         const start = $getCurrentDate();
@@ -25749,19 +25770,37 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        // We simply mark that browser capability is enabled in metadata
-        // Get existing metadata
-        const existingMetadata = requirements.metadata || {};
         // Get existing tools array or create new one
-        const existingTools = existingMetadata.tools || [];
-        // Add 'browser' to tools if not already present
-        const updatedTools = existingTools.includes('browser') ? existingTools : [...existingTools, 'browser'];
-        // Return requirements with updated metadata
+        const existingTools = requirements.tools || [];
+        // Add 'web_browser' to tools if not already present
+        const updatedTools = existingTools.some((tool) => tool.name === 'web_browser')
+            ? existingTools
+            : [
+                ...existingTools,
+                {
+                    name: 'web_browser',
+                    description: spaceTrim$1(`
+                        A tool that can browse the web.
+                        Use this tool when you need to access specific websites or browse the internet.
+                    `),
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            url: {
+                                type: 'string',
+                                description: 'The URL to browse',
+                            },
+                        },
+                        required: ['url'],
+                    },
+                },
+            ];
+        // Return requirements with updated tools and metadata
         return {
             ...requirements,
+            tools: updatedTools,
             metadata: {
-                ...existingMetadata,
-                tools: updatedTools,
+                ...requirements.metadata,
                 useBrowser: true,
             },
         };
@@ -25854,13 +25893,13 @@ class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
  * The `USE SEARCH ENGINE` commitment indicates that the agent should utilize a search engine tool
  * to access and retrieve up-to-date information from the internet when necessary.
  *
- * The content following `USE SEARCH ENGINE` is ignored (similar to NOTE).
+ * The content following `USE SEARCH ENGINE` is an arbitrary text that the agent should know (e.g. search scope or instructions).
  *
  * Example usage in agent source:
  *
  * ```book
  * USE SEARCH ENGINE
- * USE SEARCH ENGINE This will be ignored
+ * USE SEARCH ENGINE Hledej informace o Přemyslovcích
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
@@ -25892,7 +25931,7 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
 
             ## Key aspects
 
-            - The content following \`USE SEARCH ENGINE\` is ignored (similar to NOTE)
+            - The content following \`USE SEARCH ENGINE\` is an arbitrary text that the agent should know (e.g. search scope or instructions).
             - The actual search engine tool usage is handled by the agent runtime
             - Allows the agent to search for current information from the web
             - Useful for research tasks, finding facts, and accessing dynamic content
@@ -25917,20 +25956,39 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        // We simply mark that search engine capability is enabled in metadata
-        // Get existing metadata
-        const existingMetadata = requirements.metadata || {};
         // Get existing tools array or create new one
-        const existingTools = existingMetadata.tools || [];
-        // Add 'search-engine' to tools if not already present
-        const updatedTools = existingTools.includes('search-engine') ? existingTools : [...existingTools, 'search-engine'];
-        // Return requirements with updated metadata
+        const existingTools = requirements.tools || [];
+        // Add 'web_search' to tools if not already present
+        const updatedTools = existingTools.some((tool) => tool.name === 'web_search')
+            ? existingTools
+            : [
+                ...existingTools,
+                {
+                    name: 'web_search',
+                    description: spaceTrim$1(`
+                        Search the internet for information.
+                        Use this tool when you need to find up-to-date information or facts that you don't know.
+                        ${!content ? '' : `Search scope / instructions: ${content}`}
+                    `),
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'The search query',
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+            ];
+        // Return requirements with updated tools and metadata
         return {
             ...requirements,
+            tools: updatedTools,
             metadata: {
-                ...existingMetadata,
-                tools: updatedTools,
-                useSearchEngine: true,
+                ...requirements.metadata,
+                useSearchEngine: content || true,
             },
         };
     }
@@ -26534,7 +26592,57 @@ function parseAgentSource(agentSource) {
     }
     const meta = {};
     const links = [];
+    const capabilities = [];
     for (const commitment of parseResult.commitments) {
+        if (commitment.type === 'USE BROWSER') {
+            capabilities.push({
+                type: 'browser',
+                label: 'Browser',
+                iconName: 'Globe',
+            });
+            continue;
+        }
+        if (commitment.type === 'USE SEARCH ENGINE') {
+            capabilities.push({
+                type: 'search-engine',
+                label: 'Search Internet',
+                iconName: 'Search',
+            });
+            continue;
+        }
+        if (commitment.type === 'KNOWLEDGE') {
+            const content = spaceTrim$2(commitment.content).split('\n')[0] || '';
+            let label = content;
+            let iconName = 'Book';
+            if (content.startsWith('http://') || content.startsWith('https://')) {
+                try {
+                    const url = new URL(content);
+                    if (url.pathname.endsWith('.pdf')) {
+                        label = url.pathname.split('/').pop() || 'Document.pdf';
+                        iconName = 'FileText';
+                    }
+                    else {
+                        label = url.hostname.replace(/^www\./, '');
+                    }
+                }
+                catch (e) {
+                    // Invalid URL, treat as text
+                }
+            }
+            else {
+                // Text content - take first few words
+                const words = content.split(/\s+/);
+                if (words.length > 4) {
+                    label = words.slice(0, 4).join(' ') + '...';
+                }
+            }
+            capabilities.push({
+                type: 'knowledge',
+                label,
+                iconName,
+            });
+            continue;
+        }
         if (commitment.type === 'META LINK') {
             const linkValue = spaceTrim$2(commitment.content);
             links.push(linkValue);
@@ -26545,6 +26653,10 @@ function parseAgentSource(agentSource) {
             meta.image = spaceTrim$2(commitment.content);
             continue;
         }
+        if (commitment.type === 'META DESCRIPTION') {
+            meta.description = spaceTrim$2(commitment.content);
+            continue;
+        }
         if (commitment.type === 'META COLOR') {
             meta.color = normalizeSeparator(commitment.content);
             continue;
@@ -26581,6 +26693,7 @@ function parseAgentSource(agentSource) {
         meta,
         links,
         parameters,
+        capabilities,
     };
 }
 /**