@promptbook/core 0.103.0-47 → 0.103.0-49

package/esm/index.es.js

@@ -1,11 +1,11 @@
+import { SHA256 } from 'crypto-js';
+import hexEncoder from 'crypto-js/enc-hex';
 import spaceTrim$1, { spaceTrim as spaceTrim$2 } from 'spacetrim';
 import { randomBytes } from 'crypto';
 import { Subject, BehaviorSubject } from 'rxjs';
-import { forTime, forEver } from 'waitasecond';
-import hexEncoder from 'crypto-js/enc-hex';
+import { forTime } from 'waitasecond';
 import sha256 from 'crypto-js/sha256';
 import { basename, join, dirname, isAbsolute } from 'path';
-import { SHA256 } from 'crypto-js';
 import { lookup, extension } from 'mime-types';
 import { parse, unparse } from 'papaparse';
 import moment from 'moment';
@@ -27,131 +27,12 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-47';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-49';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-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"}];
-
-/**
- * Checks if value is valid email
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidEmail(email) {
-    if (typeof email !== 'string') {
-        return false;
-    }
-    if (email.split('\n').length > 1) {
-        return false;
-    }
-    return /^.+@.+\..+$/.test(email);
-}
-
-/**
- * Tests if given string is valid file path.
- *
- * Note: This does not check if the file exists only if the path is valid
- * @public exported from `@promptbook/utils`
- */
-function isValidFilePath(filename) {
-    if (typeof filename !== 'string') {
-        return false;
-    }
-    if (filename.split('\n').length > 1) {
-        return false;
-    }
-    // Normalize slashes early so heuristics can detect path-like inputs
-    const filenameSlashes = filename.replace(/\\/g, '/');
-    // Reject strings that look like sentences (informational text)
-    // Heuristic: contains multiple spaces and ends with a period, or contains typical sentence punctuation
-    // But skip this heuristic if the string looks like a path (contains '/' or starts with a drive letter)
-    if (filename.trim().length > 60 && // long enough to be a sentence
-        /[.!?]/.test(filename) && // contains sentence punctuation
-        filename.split(' ').length > 8 && // has many words
-        !/\/|^[A-Z]:/i.test(filenameSlashes) // do NOT treat as sentence if looks like a path
-    ) {
-        return false;
-    }
-    // Absolute Unix path: /hello.txt
-    if (/^(\/)/i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Unix path: /hello.txt');
-        return true;
-    }
-    // Absolute Windows path: C:/ or C:\ (allow spaces and multiple dots in filename)
-    if (/^[A-Z]:\/.+$/i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Windows path: /hello.txt');
-        return true;
-    }
-    // Relative path: ./hello.txt
-    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Relative path: ./hello.txt');
-        return true;
-    }
-    // Allow paths like foo/hello
-    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like foo/hello');
-        return true;
-    }
-    // Allow paths like hello.book
-    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like hello.book');
-        return true;
-    }
-    return false;
-}
-/**
- * TODO: [🍏] Implement for MacOs
- */
-
-/**
- * Tests if given string is valid URL.
- *
- * Note: [🔂] This function is idempotent.
- * Note: Dataurl are considered perfectly valid.
- * Note: There are two similar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidUrl(url) {
-    if (typeof url !== 'string') {
-        return false;
-    }
-    try {
-        if (url.startsWith('blob:')) {
-            url = url.replace(/^blob:/, '');
-        }
-        const urlObject = new URL(url /* because fail is handled */);
-        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-            return false;
-        }
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-
-/**
- * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
- *
- * @public exported from `@promptbook/core`
- */
-class ParseError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ParseError';
-        Object.setPrototypeOf(this, ParseError.prototype);
-    }
-}
-/**
- * TODO: Maybe split `ParseError` and `ApplyError`
- */
-
 /**
  * Available remote servers for the Promptbook
  *
@@ -185,6 +66,7 @@ const REMOTE_SERVER_URLS = [
     */
 ];
 /**
+ * TODO: [🐱‍🚀] Auto-federated server from url in here
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
@@ -518,6 +400,9 @@ class Color {
         if (hex.length === 3) {
             return Color.fromHex3(hex);
         }
+        if (hex.length === 4) {
+            return Color.fromHex4(hex);
+        }
         if (hex.length === 6) {
             return Color.fromHex6(hex);
         }
@@ -538,6 +423,19 @@ class Color {
         const b = parseInt(hex.substr(2, 1), 16) * 16;
         return take(new Color(r, g, b));
     }
+    /**
+     * Creates a new Color instance from color in hex format with 4 digits (with alpha channel)
+     *
+     * @param color in hex for example `09df`
+     * @returns Color object
+     */
+    static fromHex4(hex) {
+        const r = parseInt(hex.substr(0, 1), 16) * 16;
+        const g = parseInt(hex.substr(1, 1), 16) * 16;
+        const b = parseInt(hex.substr(2, 1), 16) * 16;
+        const a = parseInt(hex.substr(3, 1), 16) * 16;
+        return take(new Color(r, g, b, a));
+    }
     /**
      * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
      *
@@ -728,7 +626,8 @@ class Color {
      * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
      */
     static isHexColorString(value) {
-        return typeof value === 'string' && /^#(?:[0-9a-fA-F]{3}){1,2}$/.test(value);
+        return (typeof value === 'string' &&
+            /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
     }
     /**
      * Creates new Color object
@@ -1069,6 +968,7 @@ const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
 const PROMPTBOOK_SYNTAX_COLORS = {
     TITLE: Color.fromHex('#244EA8'),
     LINE: Color.fromHex('#eeeeee'),
+    SEPARATOR: Color.fromHex('#cccccc'),
     COMMITMENT: Color.fromHex('#DA0F78'),
     PARAMETER: Color.fromHex('#8e44ad'),
 };
@@ -1519,86 +1419,307 @@ function assertsError(whatWasThrown) {
 }
 
 /**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @param value The string to check
- * @returns `true` if the string is a valid JSON string, false otherwise
+ * Format either small or big number
  *
  * @public exported from `@promptbook/utils`
  */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
+function numberToString(value) {
+    if (value === 0) {
+        return '0';
     }
-    catch (error) {
-        assertsError(error);
-        if (error.message.includes('Unexpected token')) {
-            return false;
+    else if (Number.isNaN(value)) {
+        return VALUE_STRINGS.nan;
+    }
+    else if (value === Infinity) {
+        return VALUE_STRINGS.infinity;
+    }
+    else if (value === -Infinity) {
+        return VALUE_STRINGS.negativeInfinity;
+    }
+    for (let exponent = 0; exponent < 15; exponent++) {
+        const factor = 10 ** exponent;
+        const valueRounded = Math.round(value * factor) / factor;
+        if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {
+            return valueRounded.toFixed(exponent);
         }
-        return false;
     }
+    return value.toString();
 }
 
 /**
- * Function `validatePipelineString` will validate the if the string is a valid pipeline string
- * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ * Function `valueToString` will convert the given value to string
+ * This is useful and used in the `templateParameters` function
  *
- * Note: [🔂] This function is idempotent.
+ * Note: This function is not just calling `toString` method
+ *       It's more complex and can handle this conversion specifically for LLM models
+ *       See `VALUE_STRINGS`
  *
- * @param {string} pipelineString the candidate for a pipeline string
- * @returns {PipelineString} the same string as input, but validated as valid
- * @throws {ParseError} if the string is not a valid pipeline string
- * @public exported from `@promptbook/core`
+ * Note: There are 2 similar functions
+ * - `valueToString` converts value to string for LLM models as human-readable string
+ * - `asSerializable` converts value to string to preserve full information to be able to convert it back
+ *
+ * @public exported from `@promptbook/utils`
  */
-function validatePipelineString(pipelineString) {
-    if (isValidJsonString(pipelineString)) {
-        throw new ParseError('Expected a book, but got a JSON string');
-    }
-    else if (isValidUrl(pipelineString)) {
-        throw new ParseError(`Expected a book, but got just the URL "${pipelineString}"`);
-    }
-    else if (isValidFilePath(pipelineString)) {
-        throw new ParseError(`Expected a book, but got just the file path "${pipelineString}"`);
+function valueToString(value) {
+    try {
+        if (value === '') {
+            return VALUE_STRINGS.empty;
+        }
+        else if (value === null) {
+            return VALUE_STRINGS.null;
+        }
+        else if (value === undefined) {
+            return VALUE_STRINGS.undefined;
+        }
+        else if (typeof value === 'string') {
+            return value;
+        }
+        else if (typeof value === 'number') {
+            return numberToString(value);
+        }
+        else if (value instanceof Date) {
+            return value.toISOString();
+        }
+        else {
+            try {
+                return JSON.stringify(value);
+            }
+            catch (error) {
+                if (error instanceof TypeError && error.message.includes('circular structure')) {
+                    return VALUE_STRINGS.circular;
+                }
+                throw error;
+            }
+        }
     }
-    else if (isValidEmail(pipelineString)) {
-        throw new ParseError(`Expected a book, but got just the email "${pipelineString}"`);
+    catch (error) {
+        assertsError(error);
+        console.error(error);
+        return VALUE_STRINGS.unserializable;
     }
-    // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
-    return pipelineString;
 }
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- */
 
 /**
- * Prettify the html code
+ * Computes SHA-256 hash of the given object
  *
- * @param content raw html code
- * @returns formatted html code
- * @private withing the package because of HUGE size of prettier dependency
- * @deprecated Prettier removed from Promptbook due to package size
+ * @public exported from `@promptbook/utils`
  */
-function prettifyMarkdown(content) {
-    return (content + `\n\n<!-- Note: Prettier removed from Promptbook -->`);
+function computeHash(value) {
+    return SHA256(hexEncoder.parse(spaceTrim$1(valueToString(value)))).toString( /* hex */);
 }
+/**
+ * TODO: [🥬][🥬] Use this ACRY
+ */
 
 /**
- * Makes first letter of a string uppercase
+ * Computes SHA-256 hash of the agent source
  *
- * Note: [🔂] This function is idempotent.
- *
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
  */
-function capitalize(word) {
-    return word.substring(0, 1).toUpperCase() + word.substring(1);
+function computeAgentHash(agentSource) {
+    return computeHash(agentSource);
 }
 
+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"}];
+
 /**
- * Converts promptbook in JSON format to string format
+ * Checks if value is valid email
  *
- * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
- * @param pipelineJson Promptbook in JSON format (.bookc)
+ * @public exported from `@promptbook/utils`
+ */
+function isValidEmail(email) {
+    if (typeof email !== 'string') {
+        return false;
+    }
+    if (email.split('\n').length > 1) {
+        return false;
+    }
+    return /^.+@.+\..+$/.test(email);
+}
+
+/**
+ * Tests if given string is valid file path.
+ *
+ * Note: This does not check if the file exists only if the path is valid
+ * @public exported from `@promptbook/utils`
+ */
+function isValidFilePath(filename) {
+    if (typeof filename !== 'string') {
+        return false;
+    }
+    if (filename.split('\n').length > 1) {
+        return false;
+    }
+    // Normalize slashes early so heuristics can detect path-like inputs
+    const filenameSlashes = filename.replace(/\\/g, '/');
+    // Reject strings that look like sentences (informational text)
+    // Heuristic: contains multiple spaces and ends with a period, or contains typical sentence punctuation
+    // But skip this heuristic if the string looks like a path (contains '/' or starts with a drive letter)
+    if (filename.trim().length > 60 && // long enough to be a sentence
+        /[.!?]/.test(filename) && // contains sentence punctuation
+        filename.split(' ').length > 8 && // has many words
+        !/\/|^[A-Z]:/i.test(filenameSlashes) // do NOT treat as sentence if looks like a path
+    ) {
+        return false;
+    }
+    // Absolute Unix path: /hello.txt
+    if (/^(\/)/i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Unix path: /hello.txt');
+        return true;
+    }
+    // Absolute Windows path: C:/ or C:\ (allow spaces and multiple dots in filename)
+    if (/^[A-Z]:\/.+$/i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Windows path: /hello.txt');
+        return true;
+    }
+    // Relative path: ./hello.txt
+    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Relative path: ./hello.txt');
+        return true;
+    }
+    // Allow paths like foo/hello
+    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like foo/hello');
+        return true;
+    }
+    // Allow paths like hello.book
+    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like hello.book');
+        return true;
+    }
+    return false;
+}
+/**
+ * TODO: [🍏] Implement for MacOs
+ */
+
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: [🔂] This function is idempotent.
+ * Note: Dataurl are considered perfectly valid.
+ * Note: There are two similar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
+    }
+    try {
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
+        }
+        const urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
+ */
+class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+/**
+ * TODO: Maybe split `ParseError` and `ApplyError`
+ */
+
+/**
+ * Function isValidJsonString will tell you if the string is valid JSON or not
+ *
+ * @param value The string to check
+ * @returns `true` if the string is a valid JSON string, false otherwise
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (error) {
+        assertsError(error);
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        return false;
+    }
+}
+
+/**
+ * Function `validatePipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {PipelineString} the same string as input, but validated as valid
+ * @throws {ParseError} if the string is not a valid pipeline string
+ * @public exported from `@promptbook/core`
+ */
+function validatePipelineString(pipelineString) {
+    if (isValidJsonString(pipelineString)) {
+        throw new ParseError('Expected a book, but got a JSON string');
+    }
+    else if (isValidUrl(pipelineString)) {
+        throw new ParseError(`Expected a book, but got just the URL "${pipelineString}"`);
+    }
+    else if (isValidFilePath(pipelineString)) {
+        throw new ParseError(`Expected a book, but got just the file path "${pipelineString}"`);
+    }
+    else if (isValidEmail(pipelineString)) {
+        throw new ParseError(`Expected a book, but got just the email "${pipelineString}"`);
+    }
+    // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
+    return pipelineString;
+}
+/**
+ * TODO: [🧠][🈴] Where is the best location for this file
+ */
+
+/**
+ * Prettify the html code
+ *
+ * @param content raw html code
+ * @returns formatted html code
+ * @private withing the package because of HUGE size of prettier dependency
+ * @deprecated Prettier removed from Promptbook due to package size
+ */
+function prettifyMarkdown(content) {
+    return (content + `\n\n<!-- Note: Prettier removed from Promptbook -->`);
+}
+
+/**
+ * Makes first letter of a string uppercase
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function capitalize(word) {
+    return word.substring(0, 1).toUpperCase() + word.substring(1);
+}
+
+/**
+ * Converts promptbook in JSON format to string format
+ *
+ * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
+ * @param pipelineJson Promptbook in JSON format (.bookc)
  * @returns Promptbook in string format (.book.md)
  * @public exported from `@promptbook/core`
  */
@@ -1930,7 +2051,7 @@ function deepClone(objectValue) {
     TODO: [🧠] Is there a better implementation?
     > const propertyNames = Object.getOwnPropertyNames(objectValue);
     > for (const propertyName of propertyNames) {
-    >     const value = (objectValue as really_any)[propertyName];
+    >     const value = (objectValue as chococake)[propertyName];
     >     if (value && typeof value === 'object') {
     >         deepClone(value);
     >     }
@@ -2783,7 +2904,7 @@ class DatabaseError extends Error {
     }
 }
 /**
- * TODO: !!!! Explain that NotFoundError (!!! and other specific errors) has priority over DatabaseError in some contexts
+ * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
  */
 
 /**
@@ -4325,6 +4446,8 @@ function removeDiacritics(input) {
 /**
  * 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'
@@ -4480,6 +4603,8 @@ function removeEmojis(text) {
 /**
  * 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'
@@ -5049,98 +5174,17 @@ async function preparePipeline(pipeline, tools, options) {
  */
 
 /**
- * Format either small or big number
- *
- * @public exported from `@promptbook/utils`
- */
-function numberToString(value) {
-    if (value === 0) {
-        return '0';
-    }
-    else if (Number.isNaN(value)) {
-        return VALUE_STRINGS.nan;
-    }
-    else if (value === Infinity) {
-        return VALUE_STRINGS.infinity;
-    }
-    else if (value === -Infinity) {
-        return VALUE_STRINGS.negativeInfinity;
-    }
-    for (let exponent = 0; exponent < 15; exponent++) {
-        const factor = 10 ** exponent;
-        const valueRounded = Math.round(value * factor) / factor;
-        if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {
-            return valueRounded.toFixed(exponent);
-        }
-    }
-    return value.toString();
-}
-
-/**
- * Function `valueToString` will convert the given value to string
- * This is useful and used in the `templateParameters` function
- *
- * Note: This function is not just calling `toString` method
- *       It's more complex and can handle this conversion specifically for LLM models
- *       See `VALUE_STRINGS`
- *
- * Note: There are 2 similar functions
- * - `valueToString` converts value to string for LLM models as human-readable string
- * - `asSerializable` converts value to string to preserve full information to be able to convert it back
+ * Parses the given script and returns the list of all used variables that are not defined in the script
  *
- * @public exported from `@promptbook/utils`
+ * @param script from which to extract the variables
+ * @returns the list of variable names
+ * @throws {ParseError} if the script is invalid
+ * @public exported from `@promptbook/javascript`
  */
-function valueToString(value) {
-    try {
-        if (value === '') {
-            return VALUE_STRINGS.empty;
-        }
-        else if (value === null) {
-            return VALUE_STRINGS.null;
-        }
-        else if (value === undefined) {
-            return VALUE_STRINGS.undefined;
-        }
-        else if (typeof value === 'string') {
-            return value;
-        }
-        else if (typeof value === 'number') {
-            return numberToString(value);
-        }
-        else if (value instanceof Date) {
-            return value.toISOString();
-        }
-        else {
-            try {
-                return JSON.stringify(value);
-            }
-            catch (error) {
-                if (error instanceof TypeError && error.message.includes('circular structure')) {
-                    return VALUE_STRINGS.circular;
-                }
-                throw error;
-            }
-        }
-    }
-    catch (error) {
-        assertsError(error);
-        console.error(error);
-        return VALUE_STRINGS.unserializable;
-    }
-}
-
-/**
- * Parses the given script and returns the list of all used variables that are not defined in the script
- *
- * @param script from which to extract the variables
- * @returns the list of variable names
- * @throws {ParseError} if the script is invalid
- * @public exported from `@promptbook/javascript`
- */
-function extractVariablesFromJavascript(script) {
-    const variables = new Set();
-    const originalScript = script;
-    script = `(()=>{${script}})()`;
+function extractVariablesFromJavascript(script) {
+    const variables = new Set();
+    const originalScript = script;
+    script = `(()=>{${script}})()`;
     try {
         for (let i = 0; i < LOOP_LIMIT; i++)
             try {
@@ -8055,6 +8099,60 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * INITIAL MESSAGE commitment definition
+ *
+ * The INITIAL MESSAGE commitment defines the first message that the user sees when opening the chat.
+ * It is used to greet the user and set the tone of the conversation.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * INITIAL MESSAGE Hello! I am ready to help you with your tasks.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class InitialMessageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('INITIAL MESSAGE');
+    }
+    /**
+     * Short one-line description of INITIAL MESSAGE.
+     */
+    get description() {
+        return 'Defines the **initial message** shown to the user when the chat starts.';
+    }
+    /**
+     * Markdown documentation for INITIAL MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$2(`
+            # ${this.type}
+
+            Defines the first message that the user sees when opening the chat. This message is purely for display purposes in the UI and does not inherently become part of the LLM's system prompt context (unless also included via other means).
+
+            ## Key aspects
+
+            - Used to greet the user.
+            - Sets the tone of the conversation.
+            - Displayed immediately when the chat interface loads.
+
+            ## Examples
+
+            \`\`\`book
+            Support Agent
+
+            PERSONA You are a helpful support agent.
+            INITIAL MESSAGE Hi there! How can I assist you today?
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        return requirements;
+    }
+}
+
 /**
  * MESSAGE commitment definition
  *
@@ -8759,6 +8857,7 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
             // 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
@@ -9215,6 +9314,7 @@ const COMMITMENT_REGISTRY = [
     new NoteCommitmentDefinition('NONCE'),
     new GoalCommitmentDefinition('GOAL'),
     new GoalCommitmentDefinition('GOALS'),
+    new InitialMessageCommitmentDefinition(),
     new MessageCommitmentDefinition('MESSAGE'),
     new MessageCommitmentDefinition('MESSAGES'),
     new ScenarioCommitmentDefinition('SCENARIO'),
@@ -9580,6 +9680,8 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
 /**
  * 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.
@@ -9668,91 +9770,522 @@ function generatePlaceholderAgentProfileImageUrl(agentName) {
  */
 
 /**
- * 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$1(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)));
     };
+    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$2((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: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ * 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
  */
 
 /**
- * Creates model requirements for an agent based on its source
+ * Tag function for notating a prompt as template literal
  *
- * 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.
+ * 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`
  *
- * @public exported from `@promptbook/core`
+ * @param strings
+ * @param values
+ * @returns the prompt string
+ * @public exported from `@promptbook/utils`
  */
-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) {
-        const selectedModelName = await selectBestModelUsingPersona(agentSource, llmTools);
-        return createAgentModelRequirementsWithCommitments(agentSource, selectedModelName);
+function prompt(strings, ...values) {
+    if (values.length === 0) {
+        return spaceTrim$1(strings.join(''));
     }
-    // Use the new commitment-based system with provided or default model
-    return createAgentModelRequirementsWithCommitments(agentSource, modelName);
-}
-/**
- * Selects the best model using the preparePersona function
- * This directly uses preparePersona to ensure DRY principle
- *
- * @param agentSource The agent source to derive persona description from
- * @param llmTools LLM tools for preparing persona
- * @returns The name of the best selected model
- * @private function of `createAgentModelRequirements`
- */
-async function selectBestModelUsingPersona(agentSource, llmTools) {
-    var _a;
-    // Parse agent source to get persona description
-    const { agentName, personaDescription } = parseAgentSource(agentSource);
-    // Use agent name as fallback if no persona description is available
+    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$1(pipelineString);
+    try {
+        pipelineString = templateParameters(pipelineString, parameters);
+    }
+    catch (error) {
+        if (!(error instanceof PipelineExecutionError)) {
+            throw error;
+        }
+        console.error({ pipelineString, parameters, placeholderParameterNames, error });
+        throw new UnexpectedError(spaceTrim$1((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$2;
+
+/**
+ * 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$1(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;
+    }
+    let initialMessage = null;
+    for (const commitment of parseResult.commitments) {
+        if (commitment.type !== 'INITIAL MESSAGE') {
+            continue;
+        }
+        // Note: Initial message override logic - later overrides earlier
+        //       Or should it append? Usually initial message is just one block.
+        //       Let's stick to "later overrides earlier" for simplicity, or just take the last one.
+        initialMessage = commitment.content;
+    }
+    const meta = {};
+    const links = [];
+    for (const commitment of parseResult.commitments) {
+        if (commitment.type === 'META LINK') {
+            links.push(spaceTrim$1(commitment.content));
+            continue;
+        }
+        if (commitment.type !== 'META') {
+            continue;
+        }
+        // Parse META commitments - format is "META TYPE content"
+        const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
+        if (metaTypeRaw === 'LINK') {
+            links.push(spaceTrim$1(commitment.content.substring(metaTypeRaw.length)));
+        }
+        const metaType = normalizeTo_camelCase(metaTypeRaw);
+        meta[metaType] = spaceTrim$1(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,
+        initialMessage,
+        meta,
+        links,
+        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) {
+        const selectedModelName = await selectBestModelUsingPersona(agentSource, llmTools);
+        return createAgentModelRequirementsWithCommitments(agentSource, selectedModelName);
+    }
+    // Use the new commitment-based system with provided or default model
+    return createAgentModelRequirementsWithCommitments(agentSource, modelName);
+}
+/**
+ * Selects the best model using the preparePersona function
+ * This directly uses preparePersona to ensure DRY principle
+ *
+ * @param agentSource The agent source to derive persona description from
+ * @param llmTools LLM tools for preparing persona
+ * @returns The name of the best selected model
+ * @private function of `createAgentModelRequirements`
+ */
+async function selectBestModelUsingPersona(agentSource, llmTools) {
+    var _a;
+    // Parse agent source to get persona description
+    const { agentName, personaDescription } = parseAgentSource(agentSource);
+    // Use agent name as fallback if no persona description is available
     const description = personaDescription || agentName || 'AI Agent';
     try {
         // Use preparePersona directly
@@ -9883,37 +10416,28 @@ const DEFAULT_BOOK = padBook(validateBook(spaceTrim$1(`
             PERSONA A friendly AI assistant that helps you with your tasks
         `)));
 // <- Note: Not using book`...` notation to avoid strange error in jest unit tests `TypeError: (0 , book_notation_1.book) is not a function`
-// <- TODO: !!! `GENESIS_BOOK` / `ADAM_BOOK` in `/agents/adam.book`
-//                  <- !!! 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$2;
+// <- TODO: [🐱‍🚀] `GENESIS_BOOK` / `ADAM_BOOK` in `/agents/adam.book`
+//                  <- [🐱‍🚀] Buttons into genesis book
+// <- TODO: [🐱‍🚀] generateBookBoilerplate and deprecate `DEFAULT_BOOK`
 
+// import { getTableName } from '../../../../../apps/agents-server/src/database/getTableName';
+// <- TODO: [🐱‍🚀] Prevent imports from `/apps` -> `/src`
 /**
  * Agent collection stored in Supabase table
  *
  * Note: This object can work both from Node.js and browser environment depending on the Supabase client provided
  *
  * @public exported from `@promptbook/core`
- * <- TODO: !!! Move to `@promptbook/supabase` package
+ * <- 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
+     * @param tools - Execution tools to be used in [🐱‍🚀] `Agent` itself and listing the agents
      * @param options - Options for the collection creation
      */
     constructor(supabaseClient, 
-    /// TODO: !!! Remove> private readonly tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>,
+    /// TODO: [🐱‍🚀] Remove> private readonly tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>,
     options) {
         this.supabaseClient = supabaseClient;
         this.options = options;
@@ -9928,8 +10452,8 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
     async listAgents( /* TODO: [🧠] Allow to pass some condition here */) {
         const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
         const selectResult = await this.supabaseClient
-            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
-            .select('agentProfile');
+            .from(this.getTableName('Agent'))
+            .select('agentName,agentProfile');
         if (selectResult.error) {
             throw new DatabaseError(spaceTrim((block) => `
                 
@@ -9941,14 +10465,27 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
         if (isVerbose) {
             console.info(`Found ${selectResult.data.length} agents in directory`);
         }
-        return selectResult.data.map((row) => row.agentProfile);
+        return selectResult.data.map(({ agentName, agentProfile }) => {
+            if (isVerbose && agentProfile.agentName !== agentName) {
+                console.warn(spaceTrim(`
+                        Agent name mismatch for agent "${agentName}". Using name from database.
+
+                        agentName: "${agentName}"
+                        agentProfile.agentName: "${agentProfile.agentName}"
+                    `));
+            }
+            return {
+                ...agentProfile,
+                agentName,
+            };
+        });
     }
     /**
-     * !!!@@@
+     * [🐱‍🚀]@@@
      */
     async getAgentSource(agentName) {
         const selectResult = await this.supabaseClient
-            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+            .from(this.getTableName('Agent'))
             .select('agentSource')
             .eq('agentName', agentName)
             .single();
@@ -9964,7 +10501,7 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
                         
                         ${block(selectResult.error.message)}
                     `));
-            // <- TODO: !!! First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
+            // <- TODO: [🐱‍🚀] First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
         }
         return selectResult.data.agentSource;
     }
@@ -9976,67 +10513,90 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
     async createAgent(agentSource) {
         const agentProfile = parseAgentSource(agentSource);
         //     <- TODO: [🕛]
-        const selectResult = 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(this.getTableName('Agent')).insert({
+            agentName,
+            agentHash,
             agentProfile,
             createdAt: new Date().toISOString(),
             updatedAt: null,
-            agentVersion: 0,
             promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
             usage: ZERO_USAGE,
             agentSource: agentSource,
         });
-        if (selectResult.error) {
+        if (insertAgentResult.error) {
             throw new DatabaseError(spaceTrim((block) => `
                         Error creating agent "${agentProfile.agentName}" in Supabase:
                         
-                        ${block(selectResult.error.message)}
+                        ${block(insertAgentResult.error.message)}
                     `));
         }
+        await this.supabaseClient.from(this.getTableName('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 selectResult = await this.supabaseClient
-            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
-            .select('agentVersion')
+        const selectPreviousAgentResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
+            .select('agentHash,agentName')
             .eq('agentName', agentName)
             .single();
-        if (!selectResult.data) {
-            throw new NotFoundError(`Agent "${agentName}" not found`);
+        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 updateResult = await this.supabaseClient
-            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+        //     <- TODO: [🕛]
+        const { agentHash } = agentProfile;
+        const updateAgentResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
             .update({
-            // TODO: !!!! Compare not update> agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
+            // TODO: [🐱‍🚀] Compare not update> agentName: agentProfile.agentName || '[🐱‍🚀]' /* <- TODO: [🐱‍🚀] Remove */,
             agentProfile,
             updatedAt: new Date().toISOString(),
-            agentVersion: selectResult.data.agentVersion + 1,
+            agentHash: agentProfile.agentHash,
             agentSource,
             promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
         })
             .eq('agentName', agentName);
-        const newAgentSource = await this.getAgentSource(agentName);
-        console.log('!!! updateAgent', updateResult);
-        console.log('!!! old', oldAgentSource);
-        console.log('!!! new', newAgentSource);
-        if (updateResult.error) {
+        // 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(updateResult.error.message)}
+                        ${block(updateAgentResult.error.message)}
                     `));
         }
+        await this.supabaseClient.from(this.getTableName('AgentHistory')).insert({
+            createdAt: new Date().toISOString(),
+            agentName,
+            agentHash,
+            previousAgentHash,
+            agentSource,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+        });
+        // <- TODO: [🧠] What to do with `insertAgentHistoryResult.error`, ignore? wait?
     }
-    // TODO: !!!! public async getAgentSourceSubject(agentName: string_agent_name): Promise<BehaviorSubject<string_book>>
+    // TODO: [🐱‍🚀] public async getAgentSourceSubject(agentName: string_agent_name): Promise<BehaviorSubject<string_book>>
     //            Use Supabase realtime logic
     /**
      * Deletes an agent from the collection
@@ -10044,9 +10604,19 @@ class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
     async deleteAgent(agentName) {
         throw new NotYetImplementedError('Method not implemented.');
     }
+    /**
+     * Get the Supabase table name with prefix
+     *
+     * @param tableName - The original table name
+     * @returns The prefixed table name
+     */
+    getTableName(tableName) {
+        const { tablePrefix = '' } = this.options || {};
+        return `${tablePrefix}${tableName}`;
+    }
 }
 /**
- * TODO: !!!! Implement it here correctly and update JSDoc comments here, and on interface + other implementations
+ * TODO: [🐱‍🚀] Implement it here correctly and update JSDoc comments here, and on interface + other implementations
  * TODO: Write unit test
  * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
  */
@@ -10654,109 +11224,40 @@ const bookVersionCommandParser = {
     },
     /**
      * Apply the BOOK_VERSION command to the `pipelineJson`
-     *
-     * Note: `$` is used to indicate that this function mutates given `pipelineJson`
-     */
-    $applyToPipelineJson(command, $pipelineJson) {
-        // TODO: Warn if the version is overridden
-        $pipelineJson.bookVersion = command.bookVersion;
-    },
-    /**
-     * Converts the BOOK_VERSION command back to string
-     *
-     * Note: This is used in `pipelineJsonToString` utility
-     */
-    stringify(command) {
-        return `---`; // <- TODO: [🛋] Implement
-    },
-    /**
-     * Reads the BOOK_VERSION command from the `PipelineJson`
-     *
-     * Note: This is used in `pipelineJsonToString` utility
-     */
-    takeFromPipelineJson(pipelineJson) {
-        throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
-    },
-};
-
-/**
- * Units of text measurement
- *
- * @see https://github.com/webgptorg/promptbook/discussions/30
- * @public exported from `@promptbook/core`
- */
-const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
-/**
- * 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;
-}
+     *
+     * Note: `$` is used to indicate that this function mutates given `pipelineJson`
+     */
+    $applyToPipelineJson(command, $pipelineJson) {
+        // TODO: Warn if the version is overridden
+        $pipelineJson.bookVersion = command.bookVersion;
+    },
+    /**
+     * Converts the BOOK_VERSION command back to string
+     *
+     * Note: This is used in `pipelineJsonToString` utility
+     */
+    stringify(command) {
+        return `---`; // <- TODO: [🛋] Implement
+    },
+    /**
+     * Reads the BOOK_VERSION command from the `PipelineJson`
+     *
+     * Note: This is used in `pipelineJsonToString` utility
+     */
+    takeFromPipelineJson(pipelineJson) {
+        throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
+    },
+};
+
 /**
- * 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`
+ * Units of text measurement
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/30
+ * @public exported from `@promptbook/core`
+ */
+const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
+/**
+ * TODO: [💝] Unite object for expecting amount and format - remove format
  */
 
 /**
@@ -10901,30 +11402,6 @@ const expectCommandParser = {
     },
 };
 
-/**
- * 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.
@@ -12111,20 +12588,6 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
     persona.description += spaceTrim$1('\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);
-}
-
 /**
  * Parses the postprocess command
  *
@@ -13693,114 +14156,6 @@ function addAutoGeneratedSection(content, options) {
  * 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$2((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
  *
@@ -14361,64 +14716,6 @@ const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
  * 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
  *
@@ -14652,18 +14949,6 @@ class MemoryStorage {
     }
 }
 
-/**
- * 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
  *
@@ -15290,17 +15575,17 @@ const OPENAI_MODELS = exportJson({
         },
         /**/
         /*/
-      {
-          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',
@@ -16486,11 +16771,12 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
  *
  * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
  *
- * !!! Note: [🦖] There are several different things in Promptbook:
+ * Note: [🦖] There are several different things in Promptbook:
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
  * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/openai`
  */
@@ -16525,6 +16811,12 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
      * Calls OpenAI API to use a chat model.
      */
     async callChatModel(prompt) {
+        return this.callChatModelStream(prompt, () => { });
+    }
+    /**
+     * Calls OpenAI API to use a chat model with streaming.
+     */
+    async callChatModelStream(prompt, onProgress) {
         var _a, _b, _c;
         if (this.options.isVerbose) {
             console.info('💬 OpenAI callChatModel call', { prompt });
@@ -16592,21 +16884,24 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 console.info('connect', stream.currentEvent);
             }
         });
-        /*
-        stream.on('messageDelta', (messageDelta) => {
-            if (
-                this.options.isVerbose &&
-                messageDelta &&
-                messageDelta.content &&
-                messageDelta.content[0] &&
-                messageDelta.content[0].type === 'text'
-            ) {
-                console.info('messageDelta', messageDelta.content[0].text?.value);
+        stream.on('textDelta', (textDelta, snapshot) => {
+            if (this.options.isVerbose && textDelta.value) {
+                console.info('textDelta', textDelta.value);
             }
-
-            // <- TODO: [🐚] Make streaming and running tasks working
+            const chunk = {
+                content: textDelta.value || '',
+                modelName: 'assistant',
+                timing: {
+                    start,
+                    complete: $getCurrentDate(),
+                },
+                usage: UNCERTAIN_USAGE,
+                rawPromptContent,
+                rawRequest,
+                rawResponse: snapshot,
+            };
+            onProgress(chunk);
         });
-        */
         stream.on('messageCreated', (message) => {
             if (this.options.isVerbose) {
                 console.info('messageCreated', message);
@@ -16642,7 +16937,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
         }
         return exportJson({
             name: 'promptResult',
-            message: `Result of \`OpenAiAssistantExecutionTools.callChatModel\``,
+            message: `Result of \`OpenAiAssistantExecutionTools.callChatModelStream\``,
             order: [],
             value: {
                 content: resultContent,
@@ -16661,15 +16956,19 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             },
         });
     }
-    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)',
@@ -16679,8 +16978,19 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             },
         });
         console.log('!!! Updated Assistant:', updatedAssistant);
+
         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.`);
@@ -16766,9 +17076,98 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
         }
         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
+        // 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.`);
+        }
+        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);
+                }
+            }
+        }
+        const assistantUpdate = {
+            name,
+            instructions,
+            tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
+        };
+        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,
@@ -16807,11 +17206,12 @@ const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
  * Execution Tools for calling LLM models with a predefined agent "soul"
  * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
  *
- * !!! Note: [🦖] There are several different things in Promptbook:
+ * Note: [🦖] There are several different things in Promptbook:
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
  * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/core`
  */
@@ -16905,9 +17305,12 @@ class AgentLlmExecutionTools {
      * Calls the chat model with agent-specific system prompt and requirements
      */
     async callChatModel(prompt) {
-        if (!this.options.llmTools.callChatModel) {
-            throw new Error('Underlying LLM execution tools do not support chat model calls');
-        }
+        return this.callChatModelStream(prompt, () => { });
+    }
+    /**
+     * Calls the chat model with agent-specific system prompt and requirements with streaming
+     */
+    async callChatModelStream(prompt, onProgress) {
         // Ensure we're working with a chat prompt
         if (prompt.modelRequirements.modelVariant !== 'CHAT') {
             throw new Error('AgentLlmExecutionTools only supports chat prompts');
@@ -16916,27 +17319,58 @@ class AgentLlmExecutionTools {
         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 = 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,
-                knowledgeSources: modelRequirements.knowledgeSources,
-                /*
-                !!!
-                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
-            underlyingLlmResult = await assistant.callChatModel(chatPrompt);
+                // <- 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.callChatModelStream(chatPrompt, onProgress);
         }
         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 = {
@@ -16951,7 +17385,16 @@ class AgentLlmExecutionTools {
                             : ''),
                 },
             };
-            underlyingLlmResult = await this.options.llmTools.callChatModel(modifiedChatPrompt);
+            if (this.options.llmTools.callChatModelStream) {
+                underlyingLlmResult = await this.options.llmTools.callChatModelStream(modifiedChatPrompt, onProgress);
+            }
+            else if (this.options.llmTools.callChatModel) {
+                underlyingLlmResult = await this.options.llmTools.callChatModel(modifiedChatPrompt);
+                onProgress(underlyingLlmResult);
+            }
+            else {
+                throw new Error('Underlying LLM execution tools do not support chat model calls');
+            }
         }
         let content = underlyingLlmResult.content;
         // Note: Cleanup the AI artifacts from the content
@@ -16966,6 +17409,10 @@ class AgentLlmExecutionTools {
         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)
@@ -16974,15 +17421,28 @@ class AgentLlmExecutionTools {
 /**
  * Represents one AI Agent
  *
- * !!! Note: [🦖] There are several different things in Promptbook:
+ * Note: [🦖] There are several different things in Promptbook:
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
  * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/core`
  */
 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
      */
@@ -16996,34 +17456,40 @@ class Agent extends AgentLlmExecutionTools {
         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
+            agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
         });
-        /**
-         * Name of the agent
-         */
-        this.agentName = null;
+        this._agentName = undefined;
         /**
          * Description of the agent
          */
         this.personaDescription = null;
+        /**
+         * The initial message shown to the user when the chat starts
+         */
+        this.initialMessage = null;
+        /**
+         * Links found in the agent source
+         */
+        this.links = [];
         /**
          * Metadata like image or color
          */
         this.meta = {};
-        // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
-        // TODO: !!!! Add `Agent` learning by promptbookAgent
+        // 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;
+            const { agentName, personaDescription, initialMessage, links, meta } = parseAgentSource(source);
+            this._agentName = agentName;
             this.personaDescription = personaDescription;
+            this.initialMessage = initialMessage;
+            this.links = links;
             this.meta = { ...this.meta, ...meta };
         });
     }
 }
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- * TODO: !!! Agent on remote server
  */
 
 /**
@@ -17089,24 +17555,24 @@ const _AgentRegistration = $llmToolsRegister.register(createAgentLlmExecutionToo
 /**
  * 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:
- * !!!! `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`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/core`
  */
 class RemoteAgent extends Agent {
     static async connect(options) {
-        console.log('!!!!!', `${options.agentUrl}/api/book`);
+        console.log('[🐱‍🚀]', `${options.agentUrl}/api/book`);
         const bookResponse = await fetch(`${options.agentUrl}/api/book`);
-        // <- TODO: !!!! What about closed-source agents?
-        // <- TODO: !!!! Maybe use promptbookFetch
+        // <- TODO: [🐱‍🚀] What about closed-source agents?
+        // <- TODO: [🐱‍🚀] Maybe use promptbookFetch
         const agentSourceValue = (await bookResponse.text());
         const agentSource = new BehaviorSubject(agentSourceValue);
-        // <- TODO: !!!!!! Support updating
+        // <- TODO: [🐱‍🚀] Support updating and self-updating
         return new RemoteAgent({
             ...options,
             executionTools: {
@@ -17133,13 +17599,29 @@ class RemoteAgent extends Agent {
      * Calls the agent on agents remote server
      */
     async callChatModel(prompt) {
+        return this.callChatModelStream(prompt, () => { });
+    }
+    /**
+     * Calls the agent on agents remote server with streaming
+     */
+    async callChatModelStream(prompt, onProgress) {
         // 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
+        const chatPrompt = prompt;
+        const bookResponse = await fetch(`${this.agentUrl}/api/chat`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                message: prompt.content,
+                thread: chatPrompt.thread,
+            }),
+        });
+        // <- TODO: [🐱‍🚀] What about closed-source agents?
+        // <- TODO: [🐱‍🚀] Maybe use promptbookFetch
         let content = '';
         if (!bookResponse.body) {
             content = await bookResponse.text();
@@ -17158,16 +17640,37 @@ class RemoteAgent extends Agent {
                         const textChunk = decoder.decode(value, { stream: true });
                         // console.debug('RemoteAgent chunk:', textChunk);
                         content += textChunk;
+                        onProgress({
+                            content,
+                            modelName: this.modelName,
+                            timing: {},
+                            usage: {},
+                            rawPromptContent: {},
+                            rawRequest: {},
+                            rawResponse: {},
+                        });
                     }
                 }
                 // Flush any remaining decoder internal state
-                content += decoder.decode();
+                const lastChunk = decoder.decode();
+                if (lastChunk) {
+                    content += lastChunk;
+                    onProgress({
+                        content: lastChunk,
+                        modelName: this.modelName,
+                        timing: {},
+                        usage: {},
+                        rawPromptContent: {},
+                        rawRequest: {},
+                        rawResponse: {},
+                    });
+                }
             }
             finally {
                 reader.releaseLock();
             }
         }
-        // <- TODO: !!!!!!!! Transfer metadata
+        // <- TODO: [🐱‍🚀] Transfer metadata
         const agentResult = {
             content,
             modelName: this.modelName,
@@ -17176,7 +17679,7 @@ class RemoteAgent extends Agent {
             rawPromptContent: {},
             rawRequest: {},
             rawResponse: {},
-            // <- TODO: !!!!!!!! Transfer and proxy the metadata
+            // <- TODO: [🐱‍🚀] Transfer and proxy the metadata
         };
         return agentResult;
     }
@@ -17307,24 +17810,6 @@ const _AzureOpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
  * 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
  *
@@ -17677,61 +18162,6 @@ function isValidPipelineString(pipelineString) {
  * 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$1(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$1(pipelineString);
-    try {
-        pipelineString = templateParameters(pipelineString, parameters);
-    }
-    catch (error) {
-        if (!(error instanceof PipelineExecutionError)) {
-            throw error;
-        }
-        console.error({ pipelineString, parameters, placeholderParameterNames, error });
-        throw new UnexpectedError(spaceTrim$1((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
  *
@@ -18267,7 +18697,7 @@ const OpenAiSdkTranspiler = {
                         });
 
                         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();
@@ -18286,7 +18716,7 @@ const OpenAiSdkTranspiler = {
 
                     (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();
                     })();
                 `);
@@ -18333,7 +18763,7 @@ const OpenAiSdkTranspiler = {
                     });
 
                     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();
@@ -18350,7 +18780,7 @@ const OpenAiSdkTranspiler = {
                     });
                 }
 
-                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();
 
             `);
@@ -18358,25 +18788,6 @@ const OpenAiSdkTranspiler = {
     },
 };
 
-/**
- * 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, ...
  *
@@ -18555,7 +18966,7 @@ function $generateBookBoilerplate(options) {
     const agentSource = validateBook(spaceTrim$1((block) => `
                 ${agentName}
     
-                META COLOR ${color || '#3498db' /* <- TODO: !!!! Best default color */}
+                META COLOR ${color || '#3498db' /* <- TODO: [🧠] [🐱‍🚀] Best default color */}
                 PERSONA ${block(personaDescription)}
             `));
     return agentSource;
@@ -18564,5 +18975,5 @@ function $generateBookBoilerplate(options) {
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  */
 
-export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
+export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeAgentHash, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createDefaultAgentName, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, normalizeAgentName, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map