@promptbook/core 0.103.0-45 → 0.103.0-47

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-45';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-47';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -160,15 +160,20 @@
      */
     const REMOTE_SERVER_URLS = [
         {
-            title: 'Promptbook',
-            description: `Servers of Promptbook.studio`,
+            title: 'Promptbook.Studio',
+            description: `Server of Promptbook.studio`,
             owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
-            isAnonymousModeAllowed: true,
             urls: [
                 'https://promptbook.s5.ptbk.io/',
                 // Note: Servers 1-4 are not running
             ],
         },
+        {
+            title: 'Testing Agents',
+            description: `Testing Agents server on Vercel`,
+            owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+            urls: ['https://s6.ptbk.io/'],
+        },
         /*
         Note: Working on older version of Promptbook and not supported anymore
         {
@@ -413,9 +418,6 @@
             throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
         }
     }
-    /**
-     * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
-     */
 
     /**
      * Color object represents an RGB color with alpha channel
@@ -1543,6 +1545,8 @@
      * Function `validatePipelineString` will validate the if the string is a valid pipeline string
      * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param {string} pipelineString the candidate for a pipeline string
      * @returns {PipelineString} the same string as input, but validated as valid
      * @throws {ParseError} if the string is not a valid pipeline string
@@ -2174,6 +2178,8 @@
      * -   if it is valid json
      * -   if it is meaningful
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param pipeline valid or invalid PipelineJson
      * @returns the same pipeline if it is logically valid
      * @throws {PipelineLogicError} on logical error in the pipeline
@@ -6031,6 +6037,8 @@
      * This function provides a common abstraction for result validation that can be used
      * by both execution logic and caching logic to ensure consistency.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param options - The validation options including result string, expectations, and format
      * @returns Validation result with processed string and validity status
      * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
@@ -7385,40 +7393,6 @@
      * TODO: [🏢] Check validity of `temperature` in pipeline
      */
 
-    /**
-     * Creates an empty/basic agent model requirements object
-     * This serves as the starting point for the reduce-like pattern
-     * where each commitment applies its changes to build the final requirements
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function createEmptyAgentModelRequirements() {
-        return {
-            systemMessage: '',
-            // modelName: 'gpt-5',
-            modelName: 'gemini-2.5-flash-lite',
-            temperature: 0.7,
-            topP: 0.9,
-            topK: 50,
-        };
-    }
-    /**
-     * Creates a basic agent model requirements with just the agent name
-     * This is used when we have an agent name but no commitments
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function createBasicAgentModelRequirements(agentName) {
-        const empty = createEmptyAgentModelRequirements();
-        return {
-            ...empty,
-            systemMessage: `You are ${agentName || 'AI Agent'}`,
-        };
-    }
-    /**
-     * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
-     */
-
     /**
      * Generates a regex pattern to match a specific commitment
      *
@@ -7952,23 +7926,19 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a;
             const trimmedContent = content.trim();
             if (!trimmedContent) {
                 return requirements;
             }
             // Check if content is a URL (external knowledge source)
-            if (this.isUrl(trimmedContent)) {
+            if (isValidUrl(trimmedContent)) {
                 // Store the URL for later async processing
                 const updatedRequirements = {
                     ...requirements,
-                    metadata: {
-                        ...requirements.metadata,
-                        knowledgeSources: [
-                            ...(((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.knowledgeSources) || []),
-                            trimmedContent,
-                        ],
-                    },
+                    knowledgeSources: [
+                        ...(requirements.knowledgeSources || []),
+                        trimmedContent,
+                    ],
                 };
                 // Add placeholder information about knowledge sources to system message
                 const knowledgeInfo = `Knowledge Source URL: ${trimmedContent} (will be processed for retrieval during chat)`;
@@ -7980,18 +7950,6 @@
                 return this.appendToSystemMessage(requirements, knowledgeSection, '\n\n');
             }
         }
-        /**
-         * Check if content is a URL
-         */
-        isUrl(content) {
-            try {
-                new URL(content);
-                return true;
-            }
-            catch (_a) {
-                return false;
-            }
-        }
     }
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -9317,6 +9275,40 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Creates an empty/basic agent model requirements object
+     * This serves as the starting point for the reduce-like pattern
+     * where each commitment applies its changes to build the final requirements
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createEmptyAgentModelRequirements() {
+        return {
+            systemMessage: '',
+            // modelName: 'gpt-5',
+            modelName: 'gemini-2.5-flash-lite',
+            temperature: 0.7,
+            topP: 0.9,
+            topK: 50,
+        };
+    }
+    /**
+     * Creates a basic agent model requirements with just the agent name
+     * This is used when we have an agent name but no commitments
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createBasicAgentModelRequirements(agentName) {
+        const empty = createEmptyAgentModelRequirements();
+        return {
+            ...empty,
+            systemMessage: `You are ${agentName || 'AI Agent'}`,
+        };
+    }
+    /**
+     * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
+     */
+
     /**
      * Parses agent source using the new commitment system with multiline support
      * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -9407,29 +9399,6 @@
         };
     }
 
-    /**
-     * Removes comment lines (lines starting with #) from a system message
-     * This is used to clean up the final system message before sending it to the AI model
-     * while preserving the original content with comments in metadata
-     *
-     * @param systemMessage The system message that may contain comment lines
-     * @returns The system message with comment lines removed
-     *
-     * @private - TODO: [🧠] Maybe should be public?
-     */
-    function removeCommentsFromSystemMessage(systemMessage) {
-        if (!systemMessage) {
-            return systemMessage;
-        }
-        const lines = systemMessage.split('\n');
-        const filteredLines = lines.filter((line) => {
-            const trimmedLine = line.trim();
-            // Remove lines that start with # (comments)
-            return !trimmedLine.startsWith('#');
-        });
-        return filteredLines.join('\n').trim();
-    }
-
     /**
      * Parses parameters from text using both supported notations:
      * 1. @Parameter - single word parameter starting with @
@@ -9488,6 +9457,29 @@
         return uniqueParameters;
     }
 
+    /**
+     * Removes comment lines (lines starting with #) from a system message
+     * This is used to clean up the final system message before sending it to the AI model
+     * while preserving the original content with comments in metadata
+     *
+     * @param systemMessage The system message that may contain comment lines
+     * @returns The system message with comment lines removed
+     *
+     * @private - TODO: [🧠] Maybe should be public?
+     */
+    function removeCommentsFromSystemMessage(systemMessage) {
+        if (!systemMessage) {
+            return systemMessage;
+        }
+        const lines = systemMessage.split('\n');
+        const filteredLines = lines.filter((line) => {
+            const trimmedLine = line.trim();
+            // Remove lines that start with # (comments)
+            return !trimmedLine.startsWith('#');
+        });
+        return filteredLines.join('\n').trim();
+    }
+
     /**
      * Creates agent model requirements using the new commitment system
      * This function uses a reduce-like pattern where each commitment applies its changes
@@ -9823,6 +9815,8 @@
     /**
      * A function that adds padding to the book content
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function padBook(content) {
@@ -9868,6 +9862,8 @@
      * This function should be used when you have a string that you know represents agent source
      * but need to convert it to the branded type for type safety
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @public exported from `@promptbook/core`
      */
     function validateBook(source) {
@@ -9927,125 +9923,51 @@
                 console.info(`Creating pipeline collection from supabase...`);
             }
         }
-        /**
-         * Cached defined execution tools
-         */
-        // !!! private _definedTools: ExecutionTools | null = null;
-        /*
-        TODO: !!! Use or remove
-        /**
-         * Gets or creates execution tools for the collection
-         * /
-        private async getTools(): Promise<ExecutionTools> {
-            if (this._definedTools !== null) {
-                return this._definedTools;
-            }
-
-            this._definedTools = {
-                ...(this.tools === undefined || this.tools.fs === undefined ? await $provideExecutionToolsForNode() : {}),
-                ...this.tools,
-            };
-            return this._definedTools;
-        }
-        // <- TODO: [👪] Maybe create some common abstraction *(or parent abstract class)*
-        */
         /**
          * Gets all agents in the collection
          */
         async listAgents( /* TODO: [🧠] Allow to pass some condition here */) {
             const { isVerbose = exports.DEFAULT_IS_VERBOSE } = this.options || {};
-            const result = await this.supabaseClient
+            const selectResult = await this.supabaseClient
                 .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
                 .select('agentProfile');
-            if (result.error) {
+            if (selectResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                 
                         Error fetching agents from Supabase:
                         
-                        ${block(result.error.message)}
+                        ${block(selectResult.error.message)}
                     `));
             }
             if (isVerbose) {
-                console.info(`Found ${result.data.length} agents in directory`);
+                console.info(`Found ${selectResult.data.length} agents in directory`);
             }
-            return result.data.map((row) => row.agentProfile);
+            return selectResult.data.map((row) => row.agentProfile);
         }
-        /**
-         * !!!
-         * /
-        public async spawnAgent(agentName: string_agent_name): Promise<Agent> {
-       
-            // <- TODO: !!! ENOENT: no such file or directory, open 'C:\Users\me\work\ai\promptbook\agents\examples\Asistent pro LŠVP.book
-            const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
-            const tools = await this.getTools();
-
-            const agentSourceValue = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
-            const agentSource = new BehaviorSubject(agentSourceValue);
-
-            // Note: Write file whenever agent source changes
-            agentSource.subscribe(async (newSource) => {
-                if (isVerbose) {
-                    console.info(colors.cyan(`Writing agent source to file ${agentSourcePath}`));
-                }
-                await forTime(500); // <- TODO: [🙌] !!! Remove
-                await tools.fs!.writeFile(agentSourcePath, newSource, 'utf-8');
-            });
-
-            // Note: Watch file for external changes
-            for await (const event of tools.fs!.watch(agentSourcePath)) {
-                // <- TODO: !!!! Solve the memory freeing when the watching is no longer needed
-
-                if (event.eventType !== 'change') {
-                    continue;
-                }
-
-                if (isVerbose) {
-                    console.info(
-                        colors.cyan(`Detected external change in agent source file ${agentSourcePath}, reloading`),
-                    );
-                }
-                await forTime(500); // <- TODO: [🙌] !!! Remove
-                const newSource = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
-                agentSource.next(newSource);
-            }
-
-            // TODO: [🙌] !!!! Debug the infinite loop when file is changed externally and agent source is updated which causes file to be written again
-
-            const agent = new Agent({
-                ...this.options,
-                agentSource,
-                executionTools: this.tools || {},
-            });
-
-            if (isVerbose) {
-                console.info(colors.cyan(`Created agent "${agent.agentName}" from source file ${agentSourcePath}`));
-            }
-
-            return agent;
-            * /
-        }
-        */
         /**
          * !!!@@@
          */
         async getAgentSource(agentName) {
-            const result = await this.supabaseClient
+            const selectResult = await this.supabaseClient
                 .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
                 .select('agentSource')
                 .eq('agentName', agentName)
                 .single();
-            if (result.error) {
+            /*
+            if (selectResult.data===null) {
+                throw new NotFoundError(`Agent "${agentName}" not found`);
+            }
+            */
+            if (selectResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                 
                         Error fetching agent "${agentName}" from Supabase:
                         
-                        ${block(result.error.message)}
+                        ${block(selectResult.error.message)}
                     `));
                 // <- TODO: !!! First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
             }
-            const agentSource = new rxjs.BehaviorSubject(result.data.agentSource);
-            // <- TODO: !!!! Dynamic updates
-            return agentSource;
+            return selectResult.data.agentSource;
         }
         /**
          * Creates a new agent in the collection
@@ -10055,7 +9977,9 @@
         async createAgent(agentSource) {
             const agentProfile = parseAgentSource(agentSource);
             //     <- TODO: [🕛]
-            const result = await this.supabaseClient.from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */).insert({
+            const selectResult = await this.supabaseClient
+                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+                .insert({
                 agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
                 agentProfile,
                 createdAt: new Date().toISOString(),
@@ -10065,15 +9989,56 @@
                 usage: ZERO_USAGE,
                 agentSource: agentSource,
             });
-            if (result.error) {
+            if (selectResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                         Error creating agent "${agentProfile.agentName}" in Supabase:
                         
-                        ${block(result.error.message)}
+                        ${block(selectResult.error.message)}
                     `));
             }
             return agentProfile;
         }
+        /**
+         * Updates an existing agent in the collection
+         */
+        async updateAgentSource(agentName, agentSource) {
+            const selectResult = await this.supabaseClient
+                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+                .select('agentVersion')
+                .eq('agentName', agentName)
+                .single();
+            if (!selectResult.data) {
+                throw new NotFoundError(`Agent "${agentName}" not found`);
+            }
+            const agentProfile = parseAgentSource(agentSource);
+            // TODO: !!!!!! What about agentName change
+            console.log('!!! agentName', agentName);
+            const oldAgentSource = await this.getAgentSource(agentName);
+            const updateResult = await this.supabaseClient
+                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+                .update({
+                // TODO: !!!! Compare not update> agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
+                agentProfile,
+                updatedAt: new Date().toISOString(),
+                agentVersion: selectResult.data.agentVersion + 1,
+                agentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            })
+                .eq('agentName', agentName);
+            const newAgentSource = await this.getAgentSource(agentName);
+            console.log('!!! updateAgent', updateResult);
+            console.log('!!! old', oldAgentSource);
+            console.log('!!! new', newAgentSource);
+            if (updateResult.error) {
+                throw new DatabaseError(spaceTrim((block) => `
+                        Error updating agent "${agentName}" in Supabase:
+                        
+                        ${block(updateResult.error.message)}
+                    `));
+            }
+        }
+        // TODO: !!!! public async getAgentSourceSubject(agentName: string_agent_name): Promise<BehaviorSubject<string_book>>
+        //            Use Supabase realtime logic
         /**
          * Deletes an agent from the collection
          */
@@ -10965,6 +10930,8 @@
      * Function `validateParameterName` will normalize and validate a parameter name for use in pipelines.
      * It removes diacritics, emojis, and quotes, normalizes to camelCase, and checks for reserved names and invalid characters.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param parameterName The parameter name to validate and normalize.
      * @returns The validated and normalized parameter name.
      * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.
@@ -16520,7 +16487,7 @@
      *
      * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
      *
-     * Note: [🦖] There are several different things in Promptbook:
+     * !!! Note: [🦖] There are several different things in Promptbook:
      * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
      * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
      * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
@@ -16626,17 +16593,21 @@
                     console.info('connect', stream.currentEvent);
                 }
             });
+            /*
             stream.on('messageDelta', (messageDelta) => {
-                var _a;
-                if (this.options.isVerbose &&
+                if (
+                    this.options.isVerbose &&
                     messageDelta &&
                     messageDelta.content &&
                     messageDelta.content[0] &&
-                    messageDelta.content[0].type === 'text') {
-                    console.info('messageDelta', (_a = messageDelta.content[0].text) === null || _a === void 0 ? void 0 : _a.value);
+                    messageDelta.content[0].type === 'text'
+                ) {
+                    console.info('messageDelta', messageDelta.content[0].text?.value);
                 }
+
                 // <- TODO: [🐚] Make streaming and running tasks working
             });
+            */
             stream.on('messageCreated', (message) => {
                 if (this.options.isVerbose) {
                     console.info('messageCreated', message);
@@ -16716,64 +16687,85 @@
                 throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
             }
             // await this.playground();
-            const { name, instructions } = options;
+            const { name, instructions, knowledgeSources } = options;
             const client = await this.getClient();
-            /*/
-            //TODO: !!!
-            async function downloadFile(url: string, folder = './tmp'): Promise<string> {
-                const filename = path.basename(url.split('?')[0]);
-                const filepath = path.join(folder, filename);
-
-                if (!fs.existsSync(folder)) fs.mkdirSync(folder);
-
-                const res = await fetch(url);
-                if (!res.ok) throw new Error(`Download error: ${url}`);
-                const buffer = await res.arrayBuffer();
-                fs.writeFileSync(filepath, Buffer.from(buffer));
-                console.log(`📥 File downloaded: ${filename}`);
-
-                return filepath;
-            }
-
-            async function uploadFileToOpenAI(filepath: string) {
-                const file = await client.files.create({
-                    file: fs.createReadStream(filepath),
-                    purpose: 'assistants',
+            let vectorStoreId;
+            // If knowledge sources are provided, create a vector store with them
+            if (knowledgeSources && knowledgeSources.length > 0) {
+                if (this.options.isVerbose) {
+                    console.info(`📚 Creating vector store with ${knowledgeSources.length} knowledge sources...`);
+                }
+                // Create a vector store
+                const vectorStore = await client.beta.vectorStores.create({
+                    name: `${name} Knowledge Base`,
                 });
-                console.log(`⬆️  File uploaded to OpenAI: ${file.filename} (${file.id})`);
-                return file;
-            }
-
-            // 🌐 URL addresses of files to upload
-            const fileUrls = [
-                'https://raw.githubusercontent.com/vercel/next.js/canary/packages/next/README.md',
-                'https://raw.githubusercontent.com/openai/openai-cookbook/main/examples/How_to_call_the_Assistants_API_with_Node.js.ipynb',
-            ];
-
-            // 1️⃣ Download files from URL
-            const localFiles = [];
-            for (const url of fileUrls) {
-                const filepath = await downloadFile(url);
-                localFiles.push(filepath);
-            }
-
-            // 2️⃣ Upload files to OpenAI
-            const uploadedFiles = [];
-            for (const filepath of localFiles) {
-                const file = await uploadFileToOpenAI(filepath);
-                uploadedFiles.push(file.id);
+                vectorStoreId = vectorStore.id;
+                if (this.options.isVerbose) {
+                    console.info(`✅ Vector store created: ${vectorStoreId}`);
+                }
+                // Upload files from knowledge sources to the vector store
+                const fileStreams = [];
+                for (const source of knowledgeSources) {
+                    try {
+                        // Check if it's a URL
+                        if (source.startsWith('http://') || source.startsWith('https://')) {
+                            // Download the file
+                            const response = await fetch(source);
+                            if (!response.ok) {
+                                console.error(`Failed to download ${source}: ${response.statusText}`);
+                                continue;
+                            }
+                            const buffer = await response.arrayBuffer();
+                            const filename = source.split('/').pop() || 'downloaded-file';
+                            const blob = new Blob([buffer]);
+                            const file = new File([blob], filename);
+                            fileStreams.push(file);
+                        }
+                        else {
+                            // Assume it's a local file path
+                            // Note: This will work in Node.js environment
+                            // For browser environments, this would need different handling
+                            const fs = await import('fs');
+                            const fileStream = fs.createReadStream(source);
+                            fileStreams.push(fileStream);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Error processing knowledge source ${source}:`, error);
+                    }
+                }
+                // Batch upload files to the vector store
+                if (fileStreams.length > 0) {
+                    try {
+                        await client.beta.vectorStores.fileBatches.uploadAndPoll(vectorStoreId, {
+                            files: fileStreams,
+                        });
+                        if (this.options.isVerbose) {
+                            console.info(`✅ Uploaded ${fileStreams.length} files to vector store`);
+                        }
+                    }
+                    catch (error) {
+                        console.error('Error uploading files to vector store:', error);
+                    }
+                }
             }
-            /**/
-            // alert('!!!! Creating new OpenAI assistant');
-            // 3️⃣ Create assistant with uploaded files
-            const assistant = await client.beta.assistants.create({
+            // Create assistant with vector store attached
+            const assistantConfig = {
                 name,
                 description: 'Assistant created via Promptbook',
                 model: 'gpt-4o',
                 instructions,
                 tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
-                // !!!! file_ids: uploadedFiles,
-            });
+            };
+            // Attach vector store if created
+            if (vectorStoreId) {
+                assistantConfig.tool_resources = {
+                    file_search: {
+                        vector_store_ids: [vectorStoreId],
+                    },
+                };
+            }
+            const assistant = await client.beta.assistants.create(assistantConfig);
             console.log(`✅ Assistant created: ${assistant.id}`);
             // TODO: !!!! Try listing existing assistants
             // TODO: !!!! Try marking existing assistants by DISCRIMINANT
@@ -16816,7 +16808,7 @@
      * Execution Tools for calling LLM models with a predefined agent "soul"
      * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
      *
-     * Note: [🦖] There are several different things in Promptbook:
+     * !!! Note: [🦖] There are several different things in Promptbook:
      * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
      * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
      * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
@@ -16932,6 +16924,7 @@
                 const assistant = await this.options.llmTools.createNewAssistant({
                     name: this.title,
                     instructions: modelRequirements.systemMessage,
+                    knowledgeSources: modelRequirements.knowledgeSources,
                     /*
                     !!!
                     metadata: {
@@ -16982,7 +16975,7 @@
     /**
      * Represents one AI Agent
      *
-     * Note: [🦖] There are several different things in Promptbook:
+     * !!! Note: [🦖] There are several different things in Promptbook:
      * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
      * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
      * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
@@ -16990,7 +16983,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    class Agent {
+    class Agent extends AgentLlmExecutionTools {
         /**
          * Not used in Agent, always returns empty array
          */
@@ -17000,7 +16993,12 @@
             ];
         }
         constructor(options) {
-            this.options = options;
+            const agentSource = asUpdatableSubject(options.agentSource);
+            super({
+                isVerbose: options.isVerbose,
+                llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
+                agentSource: agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+            });
             /**
              * Name of the agent
              */
@@ -17013,7 +17011,9 @@
              * Metadata like image or color
              */
             this.meta = {};
-            this.agentSource = asUpdatableSubject(options.agentSource);
+            // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
+            // TODO: !!!! Add `Agent` learning by promptbookAgent
+            this.agentSource = agentSource;
             this.agentSource.subscribe((source) => {
                 const { agentName, personaDescription, meta } = parseAgentSource(source);
                 this.agentName = agentName;
@@ -17021,19 +17021,6 @@
                 this.meta = { ...this.meta, ...meta };
             });
         }
-        /**
-         * Creates LlmExecutionTools which exposes the agent as a model
-         */
-        getLlmExecutionTools() {
-            const llmTools = new AgentLlmExecutionTools({
-                isVerbose: this.options.isVerbose,
-                llmTools: getSingleLlmExecutionTools(this.options.executionTools.llm),
-                agentSource: this.agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
-            });
-            // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
-            // TODO: !!!! Add `Agent` learning by promptbookAgent
-            return llmTools;
-        }
     }
     /**
      * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
@@ -17100,6 +17087,106 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Represents one AI Agent
+     *
+     * !!! Note: [🦖] There are several different things in Promptbook:
+     * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+     * !!!! `RemoteAgent`
+     * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+     * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+     * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class RemoteAgent extends Agent {
+        static async connect(options) {
+            console.log('!!!!!', `${options.agentUrl}/api/book`);
+            const bookResponse = await fetch(`${options.agentUrl}/api/book`);
+            // <- TODO: !!!! What about closed-source agents?
+            // <- TODO: !!!! Maybe use promptbookFetch
+            const agentSourceValue = (await bookResponse.text());
+            const agentSource = new rxjs.BehaviorSubject(agentSourceValue);
+            // <- TODO: !!!!!! Support updating
+            return new RemoteAgent({
+                ...options,
+                executionTools: {
+                /* Note: These tools are not used */
+                // ---------------------------------------
+                /*
+                TODO: !!! Get rid of
+                
+                > You have not provided any `LlmExecutionTools`
+                > This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.
+                >
+                > Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.
+
+                */
+                },
+                agentSource,
+            });
+        }
+        constructor(options) {
+            super(options);
+            this.agentUrl = options.agentUrl;
+        }
+        /**
+         * Calls the agent on agents remote server
+         */
+        async callChatModel(prompt) {
+            // Ensure we're working with a chat prompt
+            if (prompt.modelRequirements.modelVariant !== 'CHAT') {
+                throw new Error('Agents only supports chat prompts');
+            }
+            const bookResponse = await fetch(`${this.agentUrl}/api/chat?message=${encodeURIComponent(prompt.content)}`);
+            // <- TODO: !!!! What about closed-source agents?
+            // <- TODO: !!!! Maybe use promptbookFetch
+            let content = '';
+            if (!bookResponse.body) {
+                content = await bookResponse.text();
+            }
+            else {
+                // Note: [🐚] Problem with streaming is not here but it is not implemented on server
+                const decoder = new TextDecoder();
+                // Web ReadableStream is not async-iterable in many runtimes; use a reader.
+                const reader = bookResponse.body.getReader();
+                try {
+                    let doneReading = false;
+                    while (!doneReading) {
+                        const { done, value } = await reader.read();
+                        doneReading = !!done;
+                        if (value) {
+                            const textChunk = decoder.decode(value, { stream: true });
+                            // console.debug('RemoteAgent chunk:', textChunk);
+                            content += textChunk;
+                        }
+                    }
+                    // Flush any remaining decoder internal state
+                    content += decoder.decode();
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            // <- TODO: !!!!!!!! Transfer metadata
+            const agentResult = {
+                content,
+                modelName: this.modelName,
+                timing: {},
+                usage: {},
+                rawPromptContent: {},
+                rawRequest: {},
+                rawResponse: {},
+                // <- TODO: !!!!!!!! Transfer and proxy the metadata
+            };
+            return agentResult;
+        }
+    }
+    /**
+     * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+     * TODO: !!! Agent on remote server
+     */
+
     /**
      * Registration of LLM provider metadata
      *
@@ -18318,8 +18405,7 @@
 
                 ## Servers
 
-                ${block(REMOTE_SERVER_URLS.map(({ title, urls, isAnonymousModeAllowed, description }, index) => `${index + 1}. ${title} ${description}
-                        ${isAnonymousModeAllowed ? '🐱‍💻 ' : ''} ${urls.join(', ')}
+                ${block(REMOTE_SERVER_URLS.map(({ title, urls, description }, index) => `${index + 1}. ${title} ${description} ${urls.join(', ')}
                     `).join('\n'))}
             `);
             fullInfoPieces.push(serversInfo);
@@ -18362,6 +18448,30 @@
      * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
      */
 
+    const PERSONALITIES = [
+        'Friendly and helpful AI agent.',
+        'Professional and efficient virtual assistant.',
+        'Creative and imaginative digital companion.',
+        'Knowledgeable and informative AI guide.',
+        'Empathetic and understanding support bot.',
+        'Energetic and enthusiastic conversational partner.',
+        'Calm and patient virtual helper.',
+        'Curious and inquisitive AI explorer.',
+        'Witty and humorous digital friend.',
+        'Serious and focused AI consultant.',
+    ];
+    /**
+     * @@@@
+     *
+     * @private internal helper function
+     */
+    function $randomAgentPersona() {
+        return $randomItem(...PERSONALITIES);
+    }
+    /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+     */
+
     const FIRSTNAMES = [
         'Paul',
         'George',
@@ -18422,30 +18532,6 @@
      * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
      */
 
-    const PERSONALITIES = [
-        'Friendly and helpful AI agent.',
-        'Professional and efficient virtual assistant.',
-        'Creative and imaginative digital companion.',
-        'Knowledgeable and informative AI guide.',
-        'Empathetic and understanding support bot.',
-        'Energetic and enthusiastic conversational partner.',
-        'Calm and patient virtual helper.',
-        'Curious and inquisitive AI explorer.',
-        'Witty and humorous digital friend.',
-        'Serious and focused AI consultant.',
-    ];
-    /**
-     * @@@@
-     *
-     * @private internal helper function
-     */
-    function $randomAgentPersona() {
-        return $randomItem(...PERSONALITIES);
-    }
-    /**
-     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
-     */
-
     /**
      * Generates boilerplate for a new agent book
      *
@@ -18577,6 +18663,7 @@
     exports.PromptbookFetchError = PromptbookFetchError;
     exports.REMOTE_SERVER_URLS = REMOTE_SERVER_URLS;
     exports.RESERVED_PARAMETER_NAMES = RESERVED_PARAMETER_NAMES;
+    exports.RemoteAgent = RemoteAgent;
     exports.SET_IS_VERBOSE = SET_IS_VERBOSE;
     exports.SectionTypes = SectionTypes;
     exports.SheetsFormfactorDefinition = SheetsFormfactorDefinition;