@promptbook/core 0.103.0-48 → 0.103.0-49

package/umd/index.umd.js

@@ -28,140 +28,12 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-48';
+    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
      */
 
-    /**
-     * Computes SHA-256 hash of the agent source
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function computeAgentHash(agentSource) {
-        return cryptoJs.SHA256(hexEncoder__default["default"].parse(agentSource /* <- TODO: !!!!! spaceTrim */)).toString( /* hex */);
-    }
-
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
-
-    /**
-     * 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
      *
@@ -195,6 +67,7 @@
         */
     ];
     /**
+     * TODO: [🐱‍🚀] Auto-federated server from url in here
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
@@ -528,6 +401,9 @@
             if (hex.length === 3) {
                 return Color.fromHex3(hex);
             }
+            if (hex.length === 4) {
+                return Color.fromHex4(hex);
+            }
             if (hex.length === 6) {
                 return Color.fromHex6(hex);
             }
@@ -548,6 +424,19 @@
             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)
          *
@@ -738,7 +627,8 @@
          * @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
@@ -1079,6 +969,7 @@
     const PROMPTBOOK_SYNTAX_COLORS = {
         TITLE: Color.fromHex('#244EA8'),
         LINE: Color.fromHex('#eeeeee'),
+        SEPARATOR: Color.fromHex('#cccccc'),
         COMMITMENT: Color.fromHex('#DA0F78'),
         PARAMETER: Color.fromHex('#8e44ad'),
     };
@@ -1457,76 +1348,297 @@
     }
 
     /**
-     * This error type indicates that the error should not happen and its last check before crashing with some other error
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class UnexpectedError extends Error {
+        constructor(message) {
+            super(spaceTrim$1.spaceTrim((block) => `
+                    ${block(message)}
+
+                    Note: This error should not happen.
+                    It's probably a bug in the pipeline collection
+
+                    Please report issue:
+                    ${block(getErrorReportUrl(new Error(message)).href)}
+
+                    Or contact us on ${ADMIN_EMAIL}
+
+                `));
+            this.name = 'UnexpectedError';
+            Object.setPrototypeOf(this, UnexpectedError.prototype);
+        }
+    }
+
+    /**
+     * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class WrappedError extends Error {
+        constructor(whatWasThrown) {
+            const tag = `[🤮]`;
+            console.error(tag, whatWasThrown);
+            super(spaceTrim$1.spaceTrim(`
+                Non-Error object was thrown
+
+                Note: Look for ${tag} in the console for more details
+                Please report issue on ${ADMIN_EMAIL}
+            `));
+            this.name = 'WrappedError';
+            Object.setPrototypeOf(this, WrappedError.prototype);
+        }
+    }
+
+    /**
+     * Helper used in catch blocks to assert that the error is an instance of `Error`
+     *
+     * @param whatWasThrown Any object that was thrown
+     * @returns Nothing if the error is an instance of `Error`
+     * @throws `WrappedError` or `UnexpectedError` if the error is not standard
+     *
+     * @private within the repository
+     */
+    function assertsError(whatWasThrown) {
+        // Case 1: Handle error which was rethrown as `WrappedError`
+        if (whatWasThrown instanceof WrappedError) {
+            const wrappedError = whatWasThrown;
+            throw wrappedError;
+        }
+        // Case 2: Handle unexpected errors
+        if (whatWasThrown instanceof UnexpectedError) {
+            const unexpectedError = whatWasThrown;
+            throw unexpectedError;
+        }
+        // Case 3: Handle standard errors - keep them up to consumer
+        if (whatWasThrown instanceof Error) {
+            return;
+        }
+        // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw
+        throw new WrappedError(whatWasThrown);
+    }
+
+    /**
+     * 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
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    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;
+        }
+    }
+
+    /**
+     * Computes SHA-256 hash of the given object
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function computeHash(value) {
+        return cryptoJs.SHA256(hexEncoder__default["default"].parse(spaceTrim__default["default"](valueToString(value)))).toString( /* hex */);
+    }
+    /**
+     * TODO: [🥬][🥬] Use this ACRY
+     */
+
+    /**
+     * Computes SHA-256 hash of the agent source
+     *
+     * @public exported from `@promptbook/core`
+     */
+    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"}];
+
+    /**
+     * 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.
      *
-     * @public exported from `@promptbook/core`
+     * 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`
      */
-    class UnexpectedError extends Error {
-        constructor(message) {
-            super(spaceTrim$1.spaceTrim((block) => `
-                    ${block(message)}
-
-                    Note: This error should not happen.
-                    It's probably a bug in the pipeline collection
-
-                    Please report issue:
-                    ${block(getErrorReportUrl(new Error(message)).href)}
-
-                    Or contact us on ${ADMIN_EMAIL}
-
-                `));
-            this.name = 'UnexpectedError';
-            Object.setPrototypeOf(this, UnexpectedError.prototype);
+    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 type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
+     * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
      *
      * @public exported from `@promptbook/core`
      */
-    class WrappedError extends Error {
-        constructor(whatWasThrown) {
-            const tag = `[🤮]`;
-            console.error(tag, whatWasThrown);
-            super(spaceTrim$1.spaceTrim(`
-                Non-Error object was thrown
-
-                Note: Look for ${tag} in the console for more details
-                Please report issue on ${ADMIN_EMAIL}
-            `));
-            this.name = 'WrappedError';
-            Object.setPrototypeOf(this, WrappedError.prototype);
+    class ParseError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'ParseError';
+            Object.setPrototypeOf(this, ParseError.prototype);
         }
     }
-
     /**
-     * Helper used in catch blocks to assert that the error is an instance of `Error`
-     *
-     * @param whatWasThrown Any object that was thrown
-     * @returns Nothing if the error is an instance of `Error`
-     * @throws `WrappedError` or `UnexpectedError` if the error is not standard
-     *
-     * @private within the repository
+     * TODO: Maybe split `ParseError` and `ApplyError`
      */
-    function assertsError(whatWasThrown) {
-        // Case 1: Handle error which was rethrown as `WrappedError`
-        if (whatWasThrown instanceof WrappedError) {
-            const wrappedError = whatWasThrown;
-            throw wrappedError;
-        }
-        // Case 2: Handle unexpected errors
-        if (whatWasThrown instanceof UnexpectedError) {
-            const unexpectedError = whatWasThrown;
-            throw unexpectedError;
-        }
-        // Case 3: Handle standard errors - keep them up to consumer
-        if (whatWasThrown instanceof Error) {
-            return;
-        }
-        // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw
-        throw new WrappedError(whatWasThrown);
-    }
 
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
@@ -1940,7 +2052,7 @@
         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);
         >     }
@@ -2793,7 +2905,7 @@
         }
     }
     /**
-     * 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
      */
 
     /**
@@ -5062,87 +5174,6 @@
      *       @see https://docs.anthropic.com/en/docs/test-and-evaluate/strengthen-guardrails/increase-consistency#specify-the-desired-output-format
      */
 
-    /**
-     * 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
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    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
      *
@@ -8069,6 +8100,60 @@
      * 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$1.spaceTrim(`
+            # ${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
      *
@@ -9230,6 +9315,7 @@
         new NoteCommitmentDefinition('NONCE'),
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
+        new InitialMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),
@@ -10118,13 +10204,31 @@
             }
             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__default["default"](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__default["default"](commitment.content.substring(metaTypeRaw.length)));
+            }
             const metaType = normalizeTo_camelCase(metaTypeRaw);
             meta[metaType] = spaceTrim__default["default"](commitment.content.substring(metaTypeRaw.length));
         }
@@ -10140,7 +10244,9 @@
             agentName: normalizeAgentName(parseResult.agentName || createDefaultAgentName(agentSource)),
             agentHash,
             personaDescription,
+            initialMessage,
             meta,
+            links,
             parameters,
         };
     }
@@ -10311,26 +10417,28 @@
             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`
+    // <- 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 Agent */ {
+    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;
@@ -10344,7 +10452,9 @@
          */
         async listAgents( /* TODO: [🧠] Allow to pass some condition here */) {
             const { isVerbose = exports.DEFAULT_IS_VERBOSE } = this.options || {};
-            const selectResult = await this.supabaseClient.from('Agent').select('agentName,agentProfile');
+            const selectResult = await this.supabaseClient
+                .from(this.getTableName('Agent'))
+                .select('agentName,agentProfile');
             if (selectResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
                 
@@ -10372,11 +10482,11 @@
             });
         }
         /**
-         * !!!@@@
+         * [🐱‍🚀]@@@
          */
         async getAgentSource(agentName) {
             const selectResult = await this.supabaseClient
-                .from('Agent')
+                .from(this.getTableName('Agent'))
                 .select('agentSource')
                 .eq('agentName', agentName)
                 .single();
@@ -10392,7 +10502,7 @@
                         
                         ${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;
         }
@@ -10405,7 +10515,7 @@
             const agentProfile = parseAgentSource(agentSource);
             //     <- TODO: [🕛]
             const { agentName, agentHash } = agentProfile;
-            const insertAgentResult = await this.supabaseClient.from('Agent').insert({
+            const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert({
                 agentName,
                 agentHash,
                 agentProfile,
@@ -10422,7 +10532,7 @@
                         ${block(insertAgentResult.error.message)}
                     `));
             }
-            await this.supabaseClient.from('AgentHistory').insert({
+            await this.supabaseClient.from(this.getTableName('AgentHistory')).insert({
                 createdAt: new Date().toISOString(),
                 agentName,
                 agentHash,
@@ -10438,7 +10548,7 @@
          */
         async updateAgentSource(agentName, agentSource) {
             const selectPreviousAgentResult = await this.supabaseClient
-                .from('Agent')
+                .from(this.getTableName('Agent'))
                 .select('agentHash,agentName')
                 .eq('agentName', agentName)
                 .single();
@@ -10449,7 +10559,7 @@
                         
                         ${block(selectPreviousAgentResult.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`
             }
             selectPreviousAgentResult.data.agentName;
             const previousAgentHash = selectPreviousAgentResult.data.agentHash;
@@ -10457,9 +10567,9 @@
             //     <- TODO: [🕛]
             const { agentHash } = agentProfile;
             const updateAgentResult = await this.supabaseClient
-                .from('Agent')
+                .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(),
                 agentHash: agentProfile.agentHash,
@@ -10467,9 +10577,9 @@
                 promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
             })
                 .eq('agentName', agentName);
-            // console.log('!!! updateAgent', updateResult);
-            // console.log('!!! old', oldAgentSource);
-            // console.log('!!! new', newAgentSource);
+            // 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:
@@ -10477,7 +10587,7 @@
                         ${block(updateAgentResult.error.message)}
                     `));
             }
-            await this.supabaseClient.from('AgentHistory').insert({
+            await this.supabaseClient.from(this.getTableName('AgentHistory')).insert({
                 createdAt: new Date().toISOString(),
                 agentName,
                 agentHash,
@@ -10487,7 +10597,7 @@
             });
             // <- 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
@@ -10495,9 +10605,19 @@
         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
      */
@@ -16652,11 +16772,12 @@
      *
      * 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`
      */
@@ -16691,6 +16812,12 @@
          * 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 });
@@ -16758,21 +16885,24 @@
                     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);
@@ -16808,7 +16938,7 @@
             }
             return exportJson({
                 name: 'promptResult',
-                message: `Result of \`OpenAiAssistantExecutionTools.callChatModel\``,
+                message: `Result of \`OpenAiAssistantExecutionTools.callChatModelStream\``,
                 order: [],
                 value: {
                     content: resultContent,
@@ -16947,9 +17077,9 @@
             }
             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,
@@ -17077,11 +17207,12 @@
      * 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`
      */
@@ -17175,9 +17306,12 @@
          * 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');
@@ -17216,7 +17350,7 @@
                     if (this.options.isVerbose) {
                         console.log(`1️⃣ Creating new OpenAI Assistant for agent ${this.title}...`);
                     }
-                    // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
+                    // <- TODO: [🐱‍🚀] Check also `isCreatingNewAssistantsAllowed` and warn about it
                     assistant = await this.options.llmTools.createNewAssistant({
                         name: this.title,
                         instructions: modelRequirements.systemMessage,
@@ -17233,7 +17367,7 @@
                         requirementsHash,
                     });
                 }
-                underlyingLlmResult = await assistant.callChatModel(chatPrompt);
+                underlyingLlmResult = await assistant.callChatModelStream(chatPrompt, onProgress);
             }
             else {
                 if (this.options.isVerbose) {
@@ -17252,7 +17386,16 @@
                                 : ''),
                     },
                 };
-                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
@@ -17279,11 +17422,12 @@
     /**
      * 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`
      */
@@ -17313,31 +17457,40 @@
             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
             });
             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);
+                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
      */
 
     /**
@@ -17403,24 +17556,24 @@
     /**
      * 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 rxjs.BehaviorSubject(agentSourceValue);
-            // <- TODO: !!!! Support updating and self-updating
+            // <- TODO: [🐱‍🚀] Support updating and self-updating
             return new RemoteAgent({
                 ...options,
                 executionTools: {
@@ -17447,13 +17600,29 @@
          * 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();
@@ -17472,16 +17641,37 @@
                             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,
@@ -17490,7 +17680,7 @@
                 rawPromptContent: {},
                 rawRequest: {},
                 rawResponse: {},
-                // <- TODO: !!!! Transfer and proxy the metadata
+                // <- TODO: [🐱‍🚀] Transfer and proxy the metadata
             };
             return agentResult;
         }
@@ -18777,7 +18967,7 @@
         const agentSource = validateBook(spaceTrim__default["default"]((block) => `
                 ${agentName}
     
-                META COLOR ${color || '#3498db' /* <- TODO: [🧠] !!!! Best default color */}
+                META COLOR ${color || '#3498db' /* <- TODO: [🧠] [🐱‍🚀] Best default color */}
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;