@promptbook/cli 0.104.0-10 → 0.104.0-11

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/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-11';
 /**
  * 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
  */
 
 /**
@@ -26534,7 +26534,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);
@@ -26581,6 +26631,7 @@ function parseAgentSource(agentSource) {
         meta,
         links,
         parameters,
+        capabilities,
     };
 }
 /**