@promptbook/core 0.103.0-46 → 0.103.0-48

package/umd/index.umd.js

@@ -1,13 +1,13 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('colors'), require('bottleneck'), require('openai')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'colors', 'bottleneck', 'openai'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim$1, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
-})(this, (function (exports, spaceTrim$1, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('crypto-js'), require('crypto-js/enc-hex'), require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/sha256'), require('path'), require('mime-types'), require('papaparse'), require('moment'), require('colors'), require('bottleneck'), require('openai')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'crypto-js', 'crypto-js/enc-hex', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/sha256', 'path', 'mime-types', 'papaparse', 'moment', 'colors', 'bottleneck', 'openai'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.cryptoJs, global.hexEncoder, global.spaceTrim$1, global.crypto, global.rxjs, global.waitasecond, global.sha256, global.path, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, cryptoJs, hexEncoder, spaceTrim$1, crypto, rxjs, waitasecond, sha256, path, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
@@ -28,12 +28,21 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-46';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-48';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Computes SHA-256 hash of the agent source
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function computeAgentHash(agentSource) {
+        return cryptoJs.SHA256(hexEncoder__default["default"].parse(agentSource /* <- TODO: !!!!! spaceTrim */)).toString( /* hex */);
+    }
+
     var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
     /**
@@ -160,15 +169,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 +427,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
@@ -4324,6 +4335,8 @@
     /**
      * Converts a given text to kebab-case format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be converted.
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
@@ -4479,6 +4492,8 @@
     /**
      * Converts a title string into a normalized name.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param value The title string to be converted to a name.
      * @returns A normalized name derived from the input title.
      * @example 'Hello World!' -> 'hello-world'
@@ -7391,40 +7406,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
      *
@@ -7958,23 +7939,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)`;
@@ -7986,18 +7963,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
@@ -8808,6 +8773,7 @@
                 // Keep everything after the PERSONA section
                 cleanedMessage = lines.slice(personaEndIndex).join('\n').trim();
             }
+            // TODO: [🕛] There should be `agentFullname` not `agentName`
             // Create new system message with persona at the beginning
             // Format: "You are {agentName}\n{personaContent}"
             // The # PERSONA comment will be removed later by removeCommentsFromSystemMessage
@@ -9323,6 +9289,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
@@ -9413,29 +9413,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 @
@@ -9494,6 +9471,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
@@ -9595,6 +9595,8 @@
     /**
      * Normalizes a given text to camelCase format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be normalized.
      * @param _isFirstLetterCapital Whether the first letter should be capitalized.
      * @returns The camelCase formatted string.
@@ -9683,68 +9685,479 @@
      */
 
     /**
-     * Parses basic information from agent source
+     * Creates a Mermaid graph based on the promptbook
      *
-     * There are 2 similar functions:
-     * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
-     * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+     * Note: The result is not wrapped in a Markdown code block
      *
-     * @public exported from `@promptbook/core`
+     * @public exported from `@promptbook/utils`
      */
-    function parseAgentSource(agentSource) {
-        const parseResult = parseAgentSourceWithCommitments(agentSource);
-        // Find PERSONA and META commitments
-        let personaDescription = null;
-        for (const commitment of parseResult.commitments) {
-            if (commitment.type !== 'PERSONA') {
-                continue;
+    function renderPromptbookMermaid(pipelineJson, options) {
+        const { linkTask = () => null } = options || {};
+        const MERMAID_PREFIX = 'pipeline_';
+        const MERMAID_KNOWLEDGE_NAME = MERMAID_PREFIX + 'knowledge';
+        const MERMAID_RESERVED_NAME = MERMAID_PREFIX + 'reserved';
+        const MERMAID_INPUT_NAME = MERMAID_PREFIX + 'input';
+        const MERMAID_OUTPUT_NAME = MERMAID_PREFIX + 'output';
+        const parameterNameToTaskName = (parameterName) => {
+            if (parameterName === 'knowledge') {
+                return MERMAID_KNOWLEDGE_NAME;
             }
-            if (personaDescription === null) {
-                personaDescription = '';
+            else if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
+                return MERMAID_RESERVED_NAME;
             }
-            else {
-                personaDescription += `\n\n${personaDescription}`;
+            const parameter = pipelineJson.parameters.find((parameter) => parameter.name === parameterName);
+            if (!parameter) {
+                throw new UnexpectedError(`Could not find {${parameterName}}`);
+                // <- TODO: This causes problems when {knowledge} and other reserved parameters are used
             }
-            personaDescription += commitment.content;
-        }
-        const meta = {};
-        for (const commitment of parseResult.commitments) {
-            if (commitment.type !== 'META') {
-                continue;
+            if (parameter.isInput) {
+                return MERMAID_INPUT_NAME;
             }
-            // Parse META commitments - format is "META TYPE content"
-            const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
-            const metaType = normalizeTo_camelCase(metaTypeRaw);
-            meta[metaType] = spaceTrim__default["default"](commitment.content.substring(metaTypeRaw.length));
-        }
-        // Generate gravatar fallback if no meta image specified
-        if (!meta.image) {
-            meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
-        }
-        // Parse parameters using unified approach - both @Parameter and {parameter} notations
-        // are treated as the same syntax feature with unified representation
-        const parameters = parseParameters(agentSource);
-        return {
-            agentName: parseResult.agentName,
-            personaDescription,
-            meta,
-            parameters,
+            const task = pipelineJson.tasks.find((task) => task.resultingParameterName === parameterName);
+            if (!task) {
+                throw new Error(`Could not find task for {${parameterName}}`);
+            }
+            return MERMAID_PREFIX + (task.name || normalizeTo_camelCase('task-' + titleToName(task.title)));
         };
-    }
-    /**
-     * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
-     */
+        const inputAndIntermediateParametersMermaid = pipelineJson.tasks
+            .flatMap(({ title, dependentParameterNames, resultingParameterName }) => [
+            `${parameterNameToTaskName(resultingParameterName)}("${title}")`,
+            ...dependentParameterNames.map((dependentParameterName) => `${parameterNameToTaskName(dependentParameterName)}--"{${dependentParameterName}}"-->${parameterNameToTaskName(resultingParameterName)}`),
+        ])
+            .join('\n');
+        const outputParametersMermaid = pipelineJson.parameters
+            .filter(({ isOutput }) => isOutput)
+            .map(({ name }) => `${parameterNameToTaskName(name)}--"{${name}}"-->${MERMAID_OUTPUT_NAME}`)
+            .join('\n');
+        const linksMermaid = pipelineJson.tasks
+            .map((task) => {
+            const link = linkTask(task);
+            if (link === null) {
+                return '';
+            }
+            const { href, title } = link;
+            const taskName = parameterNameToTaskName(task.resultingParameterName);
+            return `click ${taskName} href "${href}" "${title}";`;
+        })
+            .filter((line) => line !== '')
+            .join('\n');
+        const interactionPointsMermaid = Object.entries({
+            [MERMAID_INPUT_NAME]: 'Input',
+            [MERMAID_OUTPUT_NAME]: 'Output',
+            [MERMAID_RESERVED_NAME]: 'Other',
+            [MERMAID_KNOWLEDGE_NAME]: 'Knowledge',
+        })
+            .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
+            .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
+            .join('\n');
+        const promptbookMermaid = spaceTrim$1.spaceTrim((block) => `
 
-    /**
-     * Creates model requirements for an agent based on its source
-     *
-     * There are 2 similar functions:
-     * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
-     * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools) {
+            %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
+
+            flowchart LR
+              subgraph "${pipelineJson.title}"
+
+                  %% Basic configuration
+                  direction TB
+
+                  %% Interaction points from pipeline to outside
+                  ${block(interactionPointsMermaid)}
+
+                  %% Input and intermediate parameters
+                  ${block(inputAndIntermediateParametersMermaid)}
+
+
+                  %% Output parameters
+                  ${block(outputParametersMermaid)}
+
+                  %% Links
+                  ${block(linksMermaid)}
+
+                  %% Styles
+                  classDef ${MERMAID_INPUT_NAME} color: grey;
+                  classDef ${MERMAID_OUTPUT_NAME} color: grey;
+                  classDef ${MERMAID_RESERVED_NAME} color: grey;
+                  classDef ${MERMAID_KNOWLEDGE_NAME} color: grey;
+
+              end;
+
+        `);
+        return promptbookMermaid;
+    }
+    /**
+     * TODO: [🧠] FOREACH in mermaid graph
+     * TODO: [🧠] Knowledge in mermaid graph
+     * TODO: [🧠] Personas in mermaid graph
+     * TODO: Maybe use some Mermaid package instead of string templating
+     * TODO: [🕌] When more than 2 functionalities, split into separate functions
+     */
+
+    /**
+     * Tag function for notating a prompt as template literal
+     *
+     * Note: There are 3 similar functions:
+     * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
+     * 2) `promptTemplate` alias for `prompt`
+     * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+     *
+     * @param strings
+     * @param values
+     * @returns the prompt string
+     * @public exported from `@promptbook/utils`
+     */
+    function prompt(strings, ...values) {
+        if (values.length === 0) {
+            return spaceTrim__default["default"](strings.join(''));
+        }
+        const stringsWithHiddenParameters = strings.map((stringsItem) => 
+        // TODO: [0] DRY
+        stringsItem.split('{').join(`${REPLACING_NONCE}beginbracket`).split('}').join(`${REPLACING_NONCE}endbracket`));
+        const placeholderParameterNames = values.map((value, i) => `${REPLACING_NONCE}${i}`);
+        const parameters = Object.fromEntries(values.map((value, i) => [placeholderParameterNames[i], value]));
+        // Combine strings and values
+        let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
+            ? `${result}${stringsItem}`
+            : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
+        pipelineString = spaceTrim__default["default"](pipelineString);
+        try {
+            pipelineString = templateParameters(pipelineString, parameters);
+        }
+        catch (error) {
+            if (!(error instanceof PipelineExecutionError)) {
+                throw error;
+            }
+            console.error({ pipelineString, parameters, placeholderParameterNames, error });
+            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                    Internal error in prompt template literal
+                  
+                    ${block(JSON.stringify({ strings, values }, null, 4))}}
+                  
+                `));
+        }
+        // TODO: [0] DRY
+        pipelineString = pipelineString
+            .split(`${REPLACING_NONCE}beginbracket`)
+            .join('{')
+            .split(`${REPLACING_NONCE}endbracket`)
+            .join('}');
+        return pipelineString;
+    }
+    /**
+     * TODO: [🧠][🈴] Where is the best location for this file
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInBrowser = new Function(`
+    try {
+        return this === window;
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Detects if the code is running in jest environment
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInJest = new Function(`
+    try {
+        return process.env.JEST_WORKER_ID !== undefined;
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Detects if the code is running in a Node.js environment
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInNode = new Function(`
+    try {
+        return this === global;
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Detects if the code is running in a web worker
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInWebWorker = new Function(`
+    try {
+        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
+            return true;
+        } else {
+            return false;
+        }
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Returns information about the current runtime environment
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environments
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function $detectRuntimeEnvironment() {
+        return {
+            isRunningInBrowser: $isRunningInBrowser(),
+            isRunningInJest: $isRunningInJest(),
+            isRunningInNode: $isRunningInNode(),
+            isRunningInWebWorker: $isRunningInWebWorker(),
+        };
+    }
+    /**
+     * TODO: [🎺] Also detect and report node version here
+     */
+
+    /**
+     * Simple wrapper `new Date().toISOString()`
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
+     *
+     * @returns string_date branded type
+     * @public exported from `@promptbook/utils`
+     */
+    function $getCurrentDate() {
+        return new Date().toISOString();
+    }
+
+    /**
+     * Function parseNumber will parse number from string
+     *
+     * Note: [🔂] This function is idempotent.
+     * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
+     * Note: it also works only with decimal numbers
+     *
+     * @returns parsed number
+     * @throws {ParseError} if the value is not a number
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function parseNumber(value) {
+        const originalValue = value;
+        if (typeof value === 'number') {
+            value = value.toString(); // <- TODO: Maybe more efficient way to do this
+        }
+        if (typeof value !== 'string') {
+            return 0;
+        }
+        value = value.trim();
+        if (value.startsWith('+')) {
+            return parseNumber(value.substring(1));
+        }
+        if (value.startsWith('-')) {
+            const number = parseNumber(value.substring(1));
+            if (number === 0) {
+                return 0; // <- Note: To prevent -0
+            }
+            return -number;
+        }
+        value = value.replace(/,/g, '.');
+        value = value.toUpperCase();
+        if (value === '') {
+            return 0;
+        }
+        if (value === '♾' || value.startsWith('INF')) {
+            return Infinity;
+        }
+        if (value.includes('/')) {
+            const [numerator_, denominator_] = value.split('/');
+            const numerator = parseNumber(numerator_);
+            const denominator = parseNumber(denominator_);
+            if (denominator === 0) {
+                throw new ParseError(`Unable to parse number from "${originalValue}" because denominator is zero`);
+            }
+            return numerator / denominator;
+        }
+        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
+            return 0;
+        }
+        if (value.includes('E')) {
+            const [significand, exponent] = value.split('E');
+            return parseNumber(significand) * 10 ** parseNumber(exponent);
+        }
+        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
+            throw new ParseError(`Unable to parse number from "${originalValue}"`);
+        }
+        const num = parseFloat(value);
+        if (isNaN(num)) {
+            throw new ParseError(`Unexpected NaN when parsing number from "${originalValue}"`);
+        }
+        return num;
+    }
+    /**
+     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+     * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
+     */
+
+    /**
+     * Removes quotes from a string
+     *
+     * Note: [🔂] This function is idempotent.
+     * Tip: This is very useful for post-processing of the result of the LLM model
+     * Note: This function removes only the same quotes from the beginning and the end of the string
+     * Note: There are two similar functions:
+     * - `removeQuotes` which removes only bounding quotes
+     * - `unwrapResult` which removes whole introduce sentence
+     *
+     * @param text optionally quoted text
+     * @returns text without quotes
+     * @public exported from `@promptbook/utils`
+     */
+    function removeQuotes(text) {
+        if (text.startsWith('"') && text.endsWith('"')) {
+            return text.slice(1, -1);
+        }
+        if (text.startsWith("'") && text.endsWith("'")) {
+            return text.slice(1, -1);
+        }
+        return text;
+    }
+
+    /**
+     * Trims string from all 4 sides
+     *
+     * Note: This is a re-exported function from the `spacetrim` package which is
+     *       Developed by same author @hejny as this package
+     *
+     * @public exported from `@promptbook/utils`
+     * @see https://github.com/hejny/spacetrim#usage
+     */
+    const spaceTrim = spaceTrim$1.spaceTrim;
+
+    /**
+     * Checks if the given value is a valid JavaScript identifier name.
+     *
+     * @param javascriptName The value to check for JavaScript identifier validity.
+     * @returns `true` if the value is a valid JavaScript name, false otherwise.
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidJavascriptName(javascriptName) {
+        if (typeof javascriptName !== 'string') {
+            return false;
+        }
+        return /^[a-zA-Z_$][0-9a-zA-Z_$]*$/i.test(javascriptName);
+    }
+
+    /**
+     * Normalizes agent name from arbitrary string to valid agent name
+     *
+     * Note: [🔂] This function is idempotent.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function normalizeAgentName(rawAgentName) {
+        return titleToName(spaceTrim__default["default"](rawAgentName));
+    }
+
+    /**
+     * Creates temporary default agent name based on agent source hash
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createDefaultAgentName(agentSource) {
+        const agentHash = computeAgentHash(agentSource);
+        return normalizeAgentName(`Agent ${agentHash.substring(0, 6)}`);
+    }
+
+    /**
+     * Parses basic information from agent source
+     *
+     * There are 2 similar functions:
+     * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+     * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function parseAgentSource(agentSource) {
+        const parseResult = parseAgentSourceWithCommitments(agentSource);
+        // Find PERSONA and META commitments
+        let personaDescription = null;
+        for (const commitment of parseResult.commitments) {
+            if (commitment.type !== 'PERSONA') {
+                continue;
+            }
+            if (personaDescription === null) {
+                personaDescription = '';
+            }
+            else {
+                personaDescription += `\n\n${personaDescription}`;
+            }
+            personaDescription += commitment.content;
+        }
+        const meta = {};
+        for (const commitment of parseResult.commitments) {
+            if (commitment.type !== 'META') {
+                continue;
+            }
+            // Parse META commitments - format is "META TYPE content"
+            const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
+            const metaType = normalizeTo_camelCase(metaTypeRaw);
+            meta[metaType] = spaceTrim__default["default"](commitment.content.substring(metaTypeRaw.length));
+        }
+        // Generate gravatar fallback if no meta image specified
+        if (!meta.image) {
+            meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
+        }
+        // Parse parameters using unified approach - both @Parameter and {parameter} notations
+        // are treated as the same syntax feature with unified representation
+        const parameters = parseParameters(agentSource);
+        const agentHash = computeAgentHash(agentSource);
+        return {
+            agentName: normalizeAgentName(parseResult.agentName || createDefaultAgentName(agentSource)),
+            agentHash,
+            personaDescription,
+            meta,
+            parameters,
+        };
+    }
+    /**
+     * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+     */
+
+    /**
+     * Creates model requirements for an agent based on its source
+     *
+     * There are 2 similar functions:
+     * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+     * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools) {
         // If availableModels are provided and no specific modelName is given,
         // use preparePersona to select the best model
         if (availableModels && !modelName && llmTools) {
@@ -9902,17 +10315,6 @@
     //                  <- !!! Buttons into genesis book
     // <- TODO: !!! generateBookBoilerplate and deprecate `DEFAULT_BOOK`
 
-    /**
-     * Trims string from all 4 sides
-     *
-     * Note: This is a re-exported function from the `spacetrim` package which is
-     *       Developed by same author @hejny as this package
-     *
-     * @public exported from `@promptbook/utils`
-     * @see https://github.com/hejny/spacetrim#usage
-     */
-    const spaceTrim = spaceTrim$1.spaceTrim;
-
     /**
      * Agent collection stored in Supabase table
      *
@@ -9921,7 +10323,7 @@
      * @public exported from `@promptbook/core`
      * <- TODO: !!! Move to `@promptbook/supabase` package
      */
-    class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
+    class AgentCollectionInSupabase /* TODO: !!!!!! implements Agent */ {
         /**
          * @param rootPath - path to the directory with agents
          * @param tools - Execution tools to be used in !!! `Agent` itself and listing the agents
@@ -9937,125 +10339,62 @@
                 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
-                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
-                .select('agentProfile');
-            if (result.error) {
+            const selectResult = await this.supabaseClient.from('Agent').select('agentName,agentProfile');
+            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);
-        }
-        /**
-         * !!!
-         * /
-        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();
+            return selectResult.data.map(({ agentName, agentProfile }) => {
+                if (isVerbose && agentProfile.agentName !== agentName) {
+                    console.warn(spaceTrim(`
+                        Agent name mismatch for agent "${agentName}". Using name from database.
 
-            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`),
-                    );
+                        agentName: "${agentName}"
+                        agentProfile.agentName: "${agentProfile.agentName}"
+                    `));
                 }
-                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 || {},
+                return {
+                    ...agentProfile,
+                    agentName,
+                };
             });
-
-            if (isVerbose) {
-                console.info(colors.cyan(`Created agent "${agent.agentName}" from source file ${agentSourcePath}`));
-            }
-
-            return agent;
-            * /
         }
-        */
         /**
          * !!!@@@
          */
         async getAgentSource(agentName) {
-            const result = await this.supabaseClient
-                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+            const selectResult = await this.supabaseClient
+                .from('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
@@ -10065,56 +10404,91 @@
         async createAgent(agentSource) {
             const agentProfile = parseAgentSource(agentSource);
             //     <- TODO: [🕛]
-            const result = await this.supabaseClient.from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */).insert({
-                agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
+            const { agentName, agentHash } = agentProfile;
+            const insertAgentResult = await this.supabaseClient.from('Agent').insert({
+                agentName,
+                agentHash,
                 agentProfile,
                 createdAt: new Date().toISOString(),
                 updatedAt: null,
-                agentVersion: 0,
                 promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
                 usage: ZERO_USAGE,
                 agentSource: agentSource,
             });
-            if (result.error) {
+            if (insertAgentResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                         Error creating agent "${agentProfile.agentName}" in Supabase:
                         
-                        ${block(result.error.message)}
+                        ${block(insertAgentResult.error.message)}
                     `));
             }
+            await this.supabaseClient.from('AgentHistory').insert({
+                createdAt: new Date().toISOString(),
+                agentName,
+                agentHash,
+                previousAgentHash: null,
+                agentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            });
+            // <- TODO: [🧠] What to do with `insertAgentHistoryResult.error`, ignore? wait?
             return agentProfile;
         }
         /**
          * Updates an existing agent in the collection
          */
         async updateAgentSource(agentName, agentSource) {
+            const selectPreviousAgentResult = await this.supabaseClient
+                .from('Agent')
+                .select('agentHash,agentName')
+                .eq('agentName', agentName)
+                .single();
+            if (selectPreviousAgentResult.error) {
+                throw new DatabaseError(spaceTrim((block) => `
+                
+                        Error fetching agent "${agentName}" from Supabase:
+                        
+                        ${block(selectPreviousAgentResult.error.message)}
+                    `));
+                // <- TODO: !!! First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
+            }
+            selectPreviousAgentResult.data.agentName;
+            const previousAgentHash = selectPreviousAgentResult.data.agentHash;
             const agentProfile = parseAgentSource(agentSource);
-            // TODO: !!!!!! What about agentName change
-            console.log('!!! agentName', agentName);
-            const oldAgentSource = await this.getAgentSource(agentName);
-            const result = await this.supabaseClient
-                .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+            //     <- TODO: [🕛]
+            const { agentHash } = agentProfile;
+            const updateAgentResult = await this.supabaseClient
+                .from('Agent')
                 .update({
                 // TODO: !!!! Compare not update> agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
                 agentProfile,
                 updatedAt: new Date().toISOString(),
-                agentVersion: 0,
-                agentSource: agentSource,
+                agentHash: agentProfile.agentHash,
+                agentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
             })
                 .eq('agentName', agentName);
-            const newAgentSource = await this.getAgentSource(agentName);
-            console.log('!!! updateAgent', result);
-            console.log('!!! old', oldAgentSource);
-            console.log('!!! new', newAgentSource);
-            if (result.error) {
+            // console.log('!!! updateAgent', updateResult);
+            // console.log('!!! old', oldAgentSource);
+            // console.log('!!! new', newAgentSource);
+            if (updateAgentResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                         Error updating agent "${agentName}" in Supabase:
                         
-                        ${block(result.error.message)}
+                        ${block(updateAgentResult.error.message)}
                     `));
             }
+            await this.supabaseClient.from('AgentHistory').insert({
+                createdAt: new Date().toISOString(),
+                agentName,
+                agentHash,
+                previousAgentHash,
+                agentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            });
+            // <- TODO: [🧠] What to do with `insertAgentHistoryResult.error`, ignore? wait?
         }
-        // TODO: !!!! getAgentSourceSubject
+        // TODO: !!!! public async getAgentSourceSubject(agentName: string_agent_name): Promise<BehaviorSubject<string_book>>
+        //            Use Supabase realtime logic
         /**
          * Deletes an agent from the collection
          */
@@ -10767,75 +11141,6 @@
      * TODO: [💝] Unite object for expecting amount and format - remove format
      */
 
-    /**
-     * Function parseNumber will parse number from string
-     *
-     * Note: [🔂] This function is idempotent.
-     * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
-     * Note: it also works only with decimal numbers
-     *
-     * @returns parsed number
-     * @throws {ParseError} if the value is not a number
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function parseNumber(value) {
-        const originalValue = value;
-        if (typeof value === 'number') {
-            value = value.toString(); // <- TODO: Maybe more efficient way to do this
-        }
-        if (typeof value !== 'string') {
-            return 0;
-        }
-        value = value.trim();
-        if (value.startsWith('+')) {
-            return parseNumber(value.substring(1));
-        }
-        if (value.startsWith('-')) {
-            const number = parseNumber(value.substring(1));
-            if (number === 0) {
-                return 0; // <- Note: To prevent -0
-            }
-            return -number;
-        }
-        value = value.replace(/,/g, '.');
-        value = value.toUpperCase();
-        if (value === '') {
-            return 0;
-        }
-        if (value === '♾' || value.startsWith('INF')) {
-            return Infinity;
-        }
-        if (value.includes('/')) {
-            const [numerator_, denominator_] = value.split('/');
-            const numerator = parseNumber(numerator_);
-            const denominator = parseNumber(denominator_);
-            if (denominator === 0) {
-                throw new ParseError(`Unable to parse number from "${originalValue}" because denominator is zero`);
-            }
-            return numerator / denominator;
-        }
-        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
-            return 0;
-        }
-        if (value.includes('E')) {
-            const [significand, exponent] = value.split('E');
-            return parseNumber(significand) * 10 ** parseNumber(exponent);
-        }
-        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
-            throw new ParseError(`Unable to parse number from "${originalValue}"`);
-        }
-        const num = parseFloat(value);
-        if (isNaN(num)) {
-            throw new ParseError(`Unexpected NaN when parsing number from "${originalValue}"`);
-        }
-        return num;
-    }
-    /**
-     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
-     * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
-     */
-
     /**
     import { WrappedError } from '../../errors/WrappedError';
     import { assertsError } from '../../errors/assertsError';
@@ -10978,30 +11283,6 @@
         },
     };
 
-    /**
-     * Removes quotes from a string
-     *
-     * Note: [🔂] This function is idempotent.
-     * Tip: This is very useful for post-processing of the result of the LLM model
-     * Note: This function removes only the same quotes from the beginning and the end of the string
-     * Note: There are two similar functions:
-     * - `removeQuotes` which removes only bounding quotes
-     * - `unwrapResult` which removes whole introduce sentence
-     *
-     * @param text optionally quoted text
-     * @returns text without quotes
-     * @public exported from `@promptbook/utils`
-     */
-    function removeQuotes(text) {
-        if (text.startsWith('"') && text.endsWith('"')) {
-            return text.slice(1, -1);
-        }
-        if (text.startsWith("'") && text.endsWith("'")) {
-            return text.slice(1, -1);
-        }
-        return 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.
@@ -12181,25 +12462,11 @@
             First definition:
             ${persona.description}
 
-            Second definition:
-            ${personaDescription}
-
-        `));
-        persona.description += spaceTrim__default["default"]('\n\n' + personaDescription);
-    }
-
-    /**
-     * Checks if the given value is a valid JavaScript identifier name.
-     *
-     * @param javascriptName The value to check for JavaScript identifier validity.
-     * @returns `true` if the value is a valid JavaScript name, false otherwise.
-     * @public exported from `@promptbook/utils`
-     */
-    function isValidJavascriptName(javascriptName) {
-        if (typeof javascriptName !== 'string') {
-            return false;
-        }
-        return /^[a-zA-Z_$][0-9a-zA-Z_$]*$/i.test(javascriptName);
+            Second definition:
+            ${personaDescription}
+
+        `));
+        persona.description += spaceTrim__default["default"]('\n\n' + personaDescription);
     }
 
     /**
@@ -13770,114 +14037,6 @@
      * TODO: [🏛] This can be part of markdown builder
      */
 
-    /**
-     * Creates a Mermaid graph based on the promptbook
-     *
-     * Note: The result is not wrapped in a Markdown code block
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function renderPromptbookMermaid(pipelineJson, options) {
-        const { linkTask = () => null } = options || {};
-        const MERMAID_PREFIX = 'pipeline_';
-        const MERMAID_KNOWLEDGE_NAME = MERMAID_PREFIX + 'knowledge';
-        const MERMAID_RESERVED_NAME = MERMAID_PREFIX + 'reserved';
-        const MERMAID_INPUT_NAME = MERMAID_PREFIX + 'input';
-        const MERMAID_OUTPUT_NAME = MERMAID_PREFIX + 'output';
-        const parameterNameToTaskName = (parameterName) => {
-            if (parameterName === 'knowledge') {
-                return MERMAID_KNOWLEDGE_NAME;
-            }
-            else if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
-                return MERMAID_RESERVED_NAME;
-            }
-            const parameter = pipelineJson.parameters.find((parameter) => parameter.name === parameterName);
-            if (!parameter) {
-                throw new UnexpectedError(`Could not find {${parameterName}}`);
-                // <- TODO: This causes problems when {knowledge} and other reserved parameters are used
-            }
-            if (parameter.isInput) {
-                return MERMAID_INPUT_NAME;
-            }
-            const task = pipelineJson.tasks.find((task) => task.resultingParameterName === parameterName);
-            if (!task) {
-                throw new Error(`Could not find task for {${parameterName}}`);
-            }
-            return MERMAID_PREFIX + (task.name || normalizeTo_camelCase('task-' + titleToName(task.title)));
-        };
-        const inputAndIntermediateParametersMermaid = pipelineJson.tasks
-            .flatMap(({ title, dependentParameterNames, resultingParameterName }) => [
-            `${parameterNameToTaskName(resultingParameterName)}("${title}")`,
-            ...dependentParameterNames.map((dependentParameterName) => `${parameterNameToTaskName(dependentParameterName)}--"{${dependentParameterName}}"-->${parameterNameToTaskName(resultingParameterName)}`),
-        ])
-            .join('\n');
-        const outputParametersMermaid = pipelineJson.parameters
-            .filter(({ isOutput }) => isOutput)
-            .map(({ name }) => `${parameterNameToTaskName(name)}--"{${name}}"-->${MERMAID_OUTPUT_NAME}`)
-            .join('\n');
-        const linksMermaid = pipelineJson.tasks
-            .map((task) => {
-            const link = linkTask(task);
-            if (link === null) {
-                return '';
-            }
-            const { href, title } = link;
-            const taskName = parameterNameToTaskName(task.resultingParameterName);
-            return `click ${taskName} href "${href}" "${title}";`;
-        })
-            .filter((line) => line !== '')
-            .join('\n');
-        const interactionPointsMermaid = Object.entries({
-            [MERMAID_INPUT_NAME]: 'Input',
-            [MERMAID_OUTPUT_NAME]: 'Output',
-            [MERMAID_RESERVED_NAME]: 'Other',
-            [MERMAID_KNOWLEDGE_NAME]: 'Knowledge',
-        })
-            .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
-            .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
-            .join('\n');
-        const promptbookMermaid = spaceTrim$1.spaceTrim((block) => `
-
-            %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
-
-            flowchart LR
-              subgraph "${pipelineJson.title}"
-
-                  %% Basic configuration
-                  direction TB
-
-                  %% Interaction points from pipeline to outside
-                  ${block(interactionPointsMermaid)}
-
-                  %% Input and intermediate parameters
-                  ${block(inputAndIntermediateParametersMermaid)}
-
-
-                  %% Output parameters
-                  ${block(outputParametersMermaid)}
-
-                  %% Links
-                  ${block(linksMermaid)}
-
-                  %% Styles
-                  classDef ${MERMAID_INPUT_NAME} color: grey;
-                  classDef ${MERMAID_OUTPUT_NAME} color: grey;
-                  classDef ${MERMAID_RESERVED_NAME} color: grey;
-                  classDef ${MERMAID_KNOWLEDGE_NAME} color: grey;
-
-              end;
-
-        `);
-        return promptbookMermaid;
-    }
-    /**
-     * TODO: [🧠] FOREACH in mermaid graph
-     * TODO: [🧠] Knowledge in mermaid graph
-     * TODO: [🧠] Personas in mermaid graph
-     * TODO: Maybe use some Mermaid package instead of string templating
-     * TODO: [🕌] When more than 2 functionalities, split into separate functions
-     */
-
     /**
      * Prettyfies Promptbook string and adds Mermaid graph
      *
@@ -14438,64 +14597,6 @@
      * TODO: [®] DRY Register logic
      */
 
-    /**
-     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    const $isRunningInBrowser = new Function(`
-    try {
-        return this === window;
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
-    /**
-     * Detects if the code is running in a Node.js environment
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    const $isRunningInNode = new Function(`
-    try {
-        return this === global;
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
-    /**
-     * Detects if the code is running in a web worker
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    const $isRunningInWebWorker = new Function(`
-    try {
-        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
-            return true;
-        } else {
-            return false;
-        }
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
     /**
      * Creates a message with all registered LLM tools
      *
@@ -14729,18 +14830,6 @@
         }
     }
 
-    /**
-     * Simple wrapper `new Date().toISOString()`
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
-     *
-     * @returns string_date branded type
-     * @public exported from `@promptbook/utils`
-     */
-    function $getCurrentDate() {
-        return new Date().toISOString();
-    }
-
     /**
      * Intercepts LLM tools and counts total usage of the tools
      *
@@ -15367,17 +15456,17 @@
             },
             /**/
             /*/
-          {
-              modelTitle: 'tts-1-hd-1106',
-              modelName: 'tts-1-hd-1106',
-          },
-          /**/
+            {
+                modelTitle: 'tts-1-hd-1106',
+                modelName: 'tts-1-hd-1106',
+            },
+            /**/
             /*/
-          {
-              modelTitle: 'tts-1-hd',
-              modelName: 'tts-1-hd',
-          },
-          /**/
+            {
+                modelTitle: 'tts-1-hd',
+                modelName: 'tts-1-hd',
+            },
+            /**/
             /**/
             {
                 modelVariant: 'CHAT',
@@ -16563,7 +16652,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
@@ -16669,17 +16758,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);
@@ -16734,15 +16827,19 @@
                 },
             });
         }
-        async playground() {
+        /*
+        public async playground() {
             const client = await this.getClient();
+
             // List all assistants
             const assistants = await client.beta.assistants.list();
             console.log('!!! Assistants:', assistants);
+
             // Get details of a specific assistant
             const assistantId = 'asst_MO8fhZf4dGloCfXSHeLcIik0';
             const assistant = await client.beta.assistants.retrieve(assistantId);
             console.log('!!! Assistant Details:', assistant);
+
             // Update an assistant
             const updatedAssistant = await client.beta.assistants.update(assistantId, {
                 name: assistant.name + '(M)',
@@ -16752,75 +16849,196 @@
                 },
             });
             console.log('!!! Updated Assistant:', updatedAssistant);
-            await waitasecond.forEver();
+
+            await forEver();
+        }
+        */
+        /**
+         * Get an existing assistant tool wrapper
+         */
+        getAssistant(assistantId) {
+            return new OpenAiAssistantExecutionTools({
+                ...this.options,
+                assistantId,
+            });
         }
         async createNewAssistant(options) {
             if (!this.isCreatingNewAssistantsAllowed) {
                 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;
+                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);
+                    }
+                }
             }
-
-            // 🌐 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);
+            // 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' }],
+            };
+            // 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
+            // TODO: !!!! Allow to update and reconnect to existing assistants
+            return new OpenAiAssistantExecutionTools({
+                ...this.options,
+                isCreatingNewAssistantsAllowed: false,
+                assistantId: assistant.id,
+            });
+        }
+        async updateAssistant(options) {
+            if (!this.isCreatingNewAssistantsAllowed) {
+                throw new NotAllowed(`Updating assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
             }
-
-            // 2️⃣ Upload files to OpenAI
-            const uploadedFiles = [];
-            for (const filepath of localFiles) {
-                const file = await uploadFileToOpenAI(filepath);
-                uploadedFiles.push(file.id);
+            const { assistantId, name, instructions, knowledgeSources } = options;
+            const client = await this.getClient();
+            let vectorStoreId;
+            // If knowledge sources are provided, create a vector store with them
+            // TODO: [🧠] Reuse vector store creation logic from createNewAssistant
+            if (knowledgeSources && knowledgeSources.length > 0) {
+                if (this.options.isVerbose) {
+                    console.info(`📚 Creating vector store for update with ${knowledgeSources.length} knowledge sources...`);
+                }
+                // Create a vector store
+                const vectorStore = await client.beta.vectorStores.create({
+                    name: `${name} Knowledge Base`,
+                });
+                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({
+            const assistantUpdate = {
                 name,
-                description: 'Assistant created via Promptbook',
-                model: 'gpt-4o',
                 instructions,
                 tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
-                // !!!! file_ids: uploadedFiles,
-            });
-            console.log(`✅ Assistant created: ${assistant.id}`);
-            // TODO: !!!! Try listing existing assistants
-            // TODO: !!!! Try marking existing assistants by DISCRIMINANT
-            // TODO: !!!! Allow to update and reconnect to existing assistants
+            };
+            if (vectorStoreId) {
+                assistantUpdate.tool_resources = {
+                    file_search: {
+                        vector_store_ids: [vectorStoreId],
+                    },
+                };
+            }
+            const assistant = await client.beta.assistants.update(assistantId, assistantUpdate);
+            if (this.options.isVerbose) {
+                console.log(`✅ Assistant updated: ${assistant.id}`);
+            }
             return new OpenAiAssistantExecutionTools({
                 ...this.options,
                 isCreatingNewAssistantsAllowed: false,
@@ -16859,7 +17077,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
@@ -16968,26 +17186,58 @@
             const chatPrompt = prompt;
             let underlyingLlmResult;
             if (OpenAiAssistantExecutionTools.isOpenAiAssistantExecutionTools(this.options.llmTools)) {
-                if (this.options.isVerbose) {
-                    console.log(`Creating new OpenAI Assistant for agent ${this.title}...`);
+                const requirementsHash = cryptoJs.SHA256(JSON.stringify(modelRequirements)).toString();
+                const cached = AgentLlmExecutionTools.assistantCache.get(this.title);
+                let assistant;
+                if (cached) {
+                    if (cached.requirementsHash === requirementsHash) {
+                        if (this.options.isVerbose) {
+                            console.log(`1️⃣ Using cached OpenAI Assistant for agent ${this.title}...`);
+                        }
+                        assistant = this.options.llmTools.getAssistant(cached.assistantId);
+                    }
+                    else {
+                        if (this.options.isVerbose) {
+                            console.log(`1️⃣ Updating OpenAI Assistant for agent ${this.title}...`);
+                        }
+                        assistant = await this.options.llmTools.updateAssistant({
+                            assistantId: cached.assistantId,
+                            name: this.title,
+                            instructions: modelRequirements.systemMessage,
+                            knowledgeSources: modelRequirements.knowledgeSources,
+                        });
+                        AgentLlmExecutionTools.assistantCache.set(this.title, {
+                            assistantId: assistant.assistantId,
+                            requirementsHash,
+                        });
+                    }
                 }
-                // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
-                const assistant = await this.options.llmTools.createNewAssistant({
-                    name: this.title,
-                    instructions: modelRequirements.systemMessage,
-                    /*
-                    !!!
-                    metadata: {
-                        agentModelName: this.modelName,
+                else {
+                    if (this.options.isVerbose) {
+                        console.log(`1️⃣ Creating new OpenAI Assistant for agent ${this.title}...`);
                     }
-                    */
-                });
-                // <- TODO: !!! Cache the assistant in prepareCache
+                    // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
+                    assistant = await this.options.llmTools.createNewAssistant({
+                        name: this.title,
+                        instructions: modelRequirements.systemMessage,
+                        knowledgeSources: modelRequirements.knowledgeSources,
+                        /*
+                        !!!
+                        metadata: {
+                            agentModelName: this.modelName,
+                        }
+                        */
+                    });
+                    AgentLlmExecutionTools.assistantCache.set(this.title, {
+                        assistantId: assistant.assistantId,
+                        requirementsHash,
+                    });
+                }
                 underlyingLlmResult = await assistant.callChatModel(chatPrompt);
             }
             else {
                 if (this.options.isVerbose) {
-                    console.log(`Creating Assistant ${this.title} on generic LLM execution tools...`);
+                    console.log(`2️⃣ Creating Assistant ${this.title} on generic LLM execution tools...`);
                 }
                 // Create modified chat prompt with agent system message
                 const modifiedChatPrompt = {
@@ -17017,6 +17267,10 @@
             return agentResult;
         }
     }
+    /**
+     * Cache of OpenAI assistants to avoid creating duplicates
+     */
+    AgentLlmExecutionTools.assistantCache = new Map();
     /**
      * TODO: [🍚] Implement Destroyable pattern to free resources
      * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
@@ -17025,7 +17279,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
@@ -17033,7 +17287,19 @@
      *
      * @public exported from `@promptbook/core`
      */
-    class Agent {
+    class Agent extends AgentLlmExecutionTools {
+        /**
+         * Name of the agent
+         */
+        get agentName() {
+            return this._agentName || createDefaultAgentName(this.agentSource.value);
+        }
+        /**
+         * Computed hash of the agent source for integrity verification
+         */
+        get agentHash() {
+            return computeAgentHash(this.agentSource.value);
+        }
         /**
          * Not used in Agent, always returns empty array
          */
@@ -17043,11 +17309,13 @@
             ];
         }
         constructor(options) {
-            this.options = options;
-            /**
-             * Name of the agent
-             */
-            this.agentName = null;
+            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
+            });
+            this._agentName = undefined;
             /**
              * Description of the agent
              */
@@ -17056,27 +17324,16 @@
              * 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;
+                this._agentName = agentName;
                 this.personaDescription = personaDescription;
                 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?
@@ -17143,6 +17400,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 and self-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
      *
@@ -17264,24 +17621,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Detects if the code is running in jest environment
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    const $isRunningInJest = new Function(`
-    try {
-        return process.env.JEST_WORKER_ID !== undefined;
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
     /**
      * Registration of LLM provider metadata
      *
@@ -17634,61 +17973,6 @@
      * TODO: [🧠][🈴] Where is the best location for this file
      */
 
-    /**
-     * Tag function for notating a prompt as template literal
-     *
-     * Note: There are 3 similar functions:
-     * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
-     * 2) `promptTemplate` alias for `prompt`
-     * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
-     *
-     * @param strings
-     * @param values
-     * @returns the prompt string
-     * @public exported from `@promptbook/utils`
-     */
-    function prompt(strings, ...values) {
-        if (values.length === 0) {
-            return spaceTrim__default["default"](strings.join(''));
-        }
-        const stringsWithHiddenParameters = strings.map((stringsItem) => 
-        // TODO: [0] DRY
-        stringsItem.split('{').join(`${REPLACING_NONCE}beginbracket`).split('}').join(`${REPLACING_NONCE}endbracket`));
-        const placeholderParameterNames = values.map((value, i) => `${REPLACING_NONCE}${i}`);
-        const parameters = Object.fromEntries(values.map((value, i) => [placeholderParameterNames[i], value]));
-        // Combine strings and values
-        let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
-            ? `${result}${stringsItem}`
-            : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
-        pipelineString = spaceTrim__default["default"](pipelineString);
-        try {
-            pipelineString = templateParameters(pipelineString, parameters);
-        }
-        catch (error) {
-            if (!(error instanceof PipelineExecutionError)) {
-                throw error;
-            }
-            console.error({ pipelineString, parameters, placeholderParameterNames, error });
-            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                    Internal error in prompt template literal
-                  
-                    ${block(JSON.stringify({ strings, values }, null, 4))}}
-                  
-                `));
-        }
-        // TODO: [0] DRY
-        pipelineString = pipelineString
-            .split(`${REPLACING_NONCE}beginbracket`)
-            .join('{')
-            .split(`${REPLACING_NONCE}endbracket`)
-            .join('}');
-        return pipelineString;
-    }
-    /**
-     * TODO: [🧠][🈴] Where is the best location for this file
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
      * Tag function for notating a pipeline with a book\`...\ notation as template literal
      *
@@ -18224,7 +18508,7 @@
                         });
 
                         const answer = response.choices[0].message.content;
-                        console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                        console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                         chatHistory.push({ role: 'assistant', content: answer });
                         promptUser();
@@ -18243,7 +18527,7 @@
 
                     (async () => {
                         await setupKnowledge();
-                        console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                        console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                         promptUser();
                     })();
                 `);
@@ -18290,7 +18574,7 @@
                     });
 
                     const answer = response.choices[0].message.content;
-                    console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                    console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                     chatHistory.push({ role: 'assistant', content: answer });
                     promptUser();
@@ -18307,7 +18591,7 @@
                     });
                 }
 
-                console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                 promptUser();
 
             `);
@@ -18315,25 +18599,6 @@
         },
     };
 
-    /**
-     * Returns information about the current runtime environment
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environments
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function $detectRuntimeEnvironment() {
-        return {
-            isRunningInBrowser: $isRunningInBrowser(),
-            isRunningInJest: $isRunningInJest(),
-            isRunningInNode: $isRunningInNode(),
-            isRunningInWebWorker: $isRunningInWebWorker(),
-        };
-    }
-    /**
-     * TODO: [🎺] Also detect and report node version here
-     */
-
     /**
      * Provide information about Promptbook, engine version, book language version, servers, ...
      *
@@ -18361,8 +18626,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);
@@ -18405,6 +18669,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',
@@ -18465,30 +18753,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
      *
@@ -18513,7 +18777,7 @@
         const agentSource = validateBook(spaceTrim__default["default"]((block) => `
                 ${agentName}
     
-                META COLOR ${color || '#3498db' /* <- TODO: !!!! Best default color */}
+                META COLOR ${color || '#3498db' /* <- TODO: [🧠] !!!! Best default color */}
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;
@@ -18620,6 +18884,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;
@@ -18655,12 +18920,14 @@
     exports.book = book;
     exports.cacheLlmTools = cacheLlmTools;
     exports.compilePipeline = compilePipeline;
+    exports.computeAgentHash = computeAgentHash;
     exports.computeCosineSimilarity = computeCosineSimilarity;
     exports.countUsage = countUsage;
     exports.createAgentLlmExecutionTools = createAgentLlmExecutionTools;
     exports.createAgentModelRequirements = createAgentModelRequirements;
     exports.createAgentModelRequirementsWithCommitments = createAgentModelRequirementsWithCommitments;
     exports.createBasicAgentModelRequirements = createBasicAgentModelRequirements;
+    exports.createDefaultAgentName = createDefaultAgentName;
     exports.createEmptyAgentModelRequirements = createEmptyAgentModelRequirements;
     exports.createLlmToolsFromConfiguration = createLlmToolsFromConfiguration;
     exports.createPipelineCollectionFromJson = createPipelineCollectionFromJson;
@@ -18690,6 +18957,7 @@
     exports.limitTotalUsage = limitTotalUsage;
     exports.makeKnowledgeSourceHandler = makeKnowledgeSourceHandler;
     exports.migratePipeline = migratePipeline;
+    exports.normalizeAgentName = normalizeAgentName;
     exports.padBook = padBook;
     exports.parseAgentSource = parseAgentSource;
     exports.parseParameters = parseParameters;