@promptbook/core 0.103.0-45 → 0.103.0-47

package/esm/index.es.js

@@ -27,7 +27,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -159,15 +159,20 @@ class ParseError extends Error {
  */
 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
     {
@@ -412,9 +417,6 @@ function checkChannelValue(channelName, value) {
         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
@@ -1542,6 +1544,8 @@ function isValidJsonString(value /* <- [👨‍⚖️] */) {
  * 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
@@ -2173,6 +2177,8 @@ function isValidPipelineUrl(url) {
  * -   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
@@ -6030,6 +6036,8 @@ function isPassingExpectations(expectations, value) {
  * 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`
@@ -7384,40 +7392,6 @@ async function preparePersona(personaDescription, tools, options) {
  * 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
  *
@@ -7951,23 +7925,19 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     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)`;
@@ -7979,18 +7949,6 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             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
@@ -9316,6 +9274,40 @@ function isCommitmentSupported(type) {
  * 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
@@ -9406,29 +9398,6 @@ function parseAgentSourceWithCommitments(agentSource) {
     };
 }
 
-/**
- * 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 @
@@ -9487,6 +9456,29 @@ function parseParameters(text) {
     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
@@ -9822,6 +9814,8 @@ const PADDING_LINES = 11;
 /**
  * A function that adds padding to the book content
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 function padBook(content) {
@@ -9867,6 +9861,8 @@ function isValidBook(value) {
  * 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) {
@@ -9926,125 +9922,51 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
             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 = 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 BehaviorSubject(result.data.agentSource);
-        // <- TODO: !!!! Dynamic updates
-        return agentSource;
+        return selectResult.data.agentSource;
     }
     /**
      * Creates a new agent in the collection
@@ -10054,7 +9976,9 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
     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(),
@@ -10064,15 +9988,56 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
             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
      */
@@ -10964,6 +10929,8 @@ function removeQuotes(text) {
  * 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.
@@ -16519,7 +16486,7 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
  *
  * 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
@@ -16625,17 +16592,21 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 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);
@@ -16715,64 +16686,85 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             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
@@ -16815,7 +16807,7 @@ const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
  * 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
@@ -16931,6 +16923,7 @@ class AgentLlmExecutionTools {
             const assistant = await this.options.llmTools.createNewAssistant({
                 name: this.title,
                 instructions: modelRequirements.systemMessage,
+                knowledgeSources: modelRequirements.knowledgeSources,
                 /*
                 !!!
                 metadata: {
@@ -16981,7 +16974,7 @@ class AgentLlmExecutionTools {
 /**
  * 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
@@ -16989,7 +16982,7 @@ class AgentLlmExecutionTools {
  *
  * @public exported from `@promptbook/core`
  */
-class Agent {
+class Agent extends AgentLlmExecutionTools {
     /**
      * Not used in Agent, always returns empty array
      */
@@ -16999,7 +16992,12 @@ class Agent {
         ];
     }
     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
          */
@@ -17012,7 +17010,9 @@ class Agent {
          * 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;
@@ -17020,19 +17020,6 @@ class Agent {
             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?
@@ -17099,6 +17086,106 @@ const _AgentRegistration = $llmToolsRegister.register(createAgentLlmExecutionToo
  * 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 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
  *
@@ -18317,8 +18404,7 @@ function aboutPromptbookInformation(options) {
 
                 ## 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);
@@ -18361,6 +18447,30 @@ function $randomItem(...items) {
  * 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',
@@ -18421,30 +18531,6 @@ function $randomFullnameWithColor() {
  * 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
  *
@@ -18478,5 +18564,5 @@ function $generateBookBoilerplate(options) {
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  */
 
-export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
+export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map