@promptbook/core 0.103.0-47 → 0.103.0-48

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,12 +27,21 @@ 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-48';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Computes SHA-256 hash of the agent source
+ *
+ * @public exported from `@promptbook/core`
+ */
+function computeAgentHash(agentSource) {
+    return SHA256(hexEncoder.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"}];
 
 /**
@@ -4325,6 +4334,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 +4491,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'
@@ -8759,6 +8772,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
@@ -9580,6 +9594,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,132 +9684,543 @@ 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 description = personaDescription || agentName || 'AI Agent';
+    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 {
-        // Use preparePersona directly
-        const { modelsRequirements } = await preparePersona(description, { llm: llmTools }, { isVerbose: false });
-        // Extract the first model name from the requirements
-        if (modelsRequirements.length > 0 && ((_a = modelsRequirements[0]) === null || _a === void 0 ? void 0 : _a.modelName)) {
-            return modelsRequirements[0].modelName;
-        }
-        // Fallback: get available models and return the first CHAT model
-        const availableModels = await llmTools.listModels();
-        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
-        if (chatModels.length === 0) {
-            throw new Error('No CHAT models available for agent model selection');
-        }
-        return chatModels[0].modelName;
+        pipelineString = templateParameters(pipelineString, parameters);
     }
     catch (error) {
-        console.warn('Failed to use preparePersona for model selection, falling back to first available model:', error);
-        // Fallback: get available models and return the first CHAT model
-        const availableModels = await llmTools.listModels();
-        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
-        if (chatModels.length === 0) {
-            throw new Error('No CHAT models available for agent model selection');
+        if (!(error instanceof PipelineExecutionError)) {
+            throw error;
         }
-        return chatModels[0].modelName;
+        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;
 }
 /**
- * Extracts MCP servers from agent source
+ * 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)
  *
- * @param agentSource The agent source string that may contain MCP lines
- * @returns Array of MCP server identifiers
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
  *
- * @private TODO: [🧠] Maybe should be public
+ * @public exported from `@promptbook/utils`
  */
-function extractMcpServers(agentSource) {
-    if (!agentSource) {
-        return [];
-    }
-    const lines = agentSource.split('\n');
-    const mcpRegex = /^\s*MCP\s+(.+)$/i;
+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;
+    }
+    const meta = {};
+    for (const commitment of parseResult.commitments) {
+        if (commitment.type !== 'META') {
+            continue;
+        }
+        // Parse META commitments - format is "META TYPE content"
+        const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
+        const metaType = normalizeTo_camelCase(metaTypeRaw);
+        meta[metaType] = spaceTrim$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,
+        meta,
+        parameters,
+    };
+}
+/**
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ */
+
+/**
+ * Creates model requirements for an agent based on its source
+ *
+ * There are 2 similar functions:
+ * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
+ *
+ * @public exported from `@promptbook/core`
+ */
+async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools) {
+    // If availableModels are provided and no specific modelName is given,
+    // use preparePersona to select the best model
+    if (availableModels && !modelName && llmTools) {
+        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
+        const { modelsRequirements } = await preparePersona(description, { llm: llmTools }, { isVerbose: false });
+        // Extract the first model name from the requirements
+        if (modelsRequirements.length > 0 && ((_a = modelsRequirements[0]) === null || _a === void 0 ? void 0 : _a.modelName)) {
+            return modelsRequirements[0].modelName;
+        }
+        // Fallback: get available models and return the first CHAT model
+        const availableModels = await llmTools.listModels();
+        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
+        if (chatModels.length === 0) {
+            throw new Error('No CHAT models available for agent model selection');
+        }
+        return chatModels[0].modelName;
+    }
+    catch (error) {
+        console.warn('Failed to use preparePersona for model selection, falling back to first available model:', error);
+        // Fallback: get available models and return the first CHAT model
+        const availableModels = await llmTools.listModels();
+        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
+        if (chatModels.length === 0) {
+            throw new Error('No CHAT models available for agent model selection');
+        }
+        return chatModels[0].modelName;
+    }
+}
+/**
+ * Extracts MCP servers from agent source
+ *
+ * @param agentSource The agent source string that may contain MCP lines
+ * @returns Array of MCP server identifiers
+ *
+ * @private TODO: [🧠] Maybe should be public
+ */
+function extractMcpServers(agentSource) {
+    if (!agentSource) {
+        return [];
+    }
+    const lines = agentSource.split('\n');
+    const mcpRegex = /^\s*MCP\s+(.+)$/i;
     const mcpServers = [];
     // Look for MCP lines
     for (const line of lines) {
@@ -9887,17 +10314,6 @@ const DEFAULT_BOOK = padBook(validateBook(spaceTrim$1(`
 //                  <- !!! 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;
-
 /**
  * Agent collection stored in Supabase table
  *
@@ -9906,7 +10322,7 @@ const spaceTrim = spaceTrim$2;
  * @public exported from `@promptbook/core`
  * <- TODO: !!! Move to `@promptbook/supabase` package
  */
-class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
+class AgentCollectionInSupabase /* TODO: !!!!!! implements Agent */ {
     /**
      * @param rootPath - path to the directory with agents
      * @param tools - Execution tools to be used in !!! `Agent` itself and listing the agents
@@ -9927,9 +10343,7 @@ 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');
+        const selectResult = await this.supabaseClient.from('Agent').select('agentName,agentProfile');
         if (selectResult.error) {
             throw new DatabaseError(spaceTrim((block) => `
                 
@@ -9941,14 +10355,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('Agent')
             .select('agentSource')
             .eq('agentName', agentName)
             .single();
@@ -9976,65 +10403,88 @@ 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('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('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('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('Agent')
             .update({
             // 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('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>>
     //            Use Supabase realtime logic
@@ -10680,83 +11130,14 @@ const bookVersionCommandParser = {
 };
 
 /**
- * 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
+ * Units of text measurement
  *
- * @public exported from `@promptbook/utils`
+ * @see https://github.com/webgptorg/promptbook/discussions/30
+ * @public exported from `@promptbook/core`
  */
-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;
-}
+const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
 /**
- * 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`
+ * TODO: [💝] Unite object for expecting amount and format - remove format
  */
 
 /**
@@ -10901,30 +11282,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 +12468,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 +14036,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
  *
@@ -14352,71 +14587,13 @@ const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
 /**
  * Register for LLM tools.
  *
- * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
- * @public exported from `@promptbook/core`
- */
-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`
+ * Note: `$` is used to indicate that this interacts with the global scope
+ * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
+ * @public exported from `@promptbook/core`
  */
-const $isRunningInWebWorker = new Function(`
-    try {
-        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
-            return true;
-        } else {
-            return false;
-        }
-    } catch (e) {
-        return false;
-    }
-`);
+const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
 /**
- * TODO: [🎺]
+ * TODO: [®] DRY Register logic
  */
 
 /**
@@ -14652,18 +14829,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 +15455,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',
@@ -16661,15 +16826,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 +16848,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.`);
@@ -16775,6 +16955,95 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             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,
+            assistantId: assistant.id,
+        });
+    }
     /**
      * Discriminant for type guards
      */
@@ -16916,27 +17185,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
+                // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
+                assistant = await this.options.llmTools.createNewAssistant({
+                    name: this.title,
+                    instructions: modelRequirements.systemMessage,
+                    knowledgeSources: modelRequirements.knowledgeSources,
+                    /*
+                    !!!
+                    metadata: {
+                        agentModelName: this.modelName,
+                    }
+                    */
+                });
+                AgentLlmExecutionTools.assistantCache.set(this.title, {
+                    assistantId: assistant.assistantId,
+                    requirementsHash,
+                });
+            }
             underlyingLlmResult = await assistant.callChatModel(chatPrompt);
         }
         else {
             if (this.options.isVerbose) {
-                console.log(`Creating Assistant ${this.title} on generic LLM execution tools...`);
+                console.log(`2️⃣ Creating Assistant ${this.title} on generic LLM execution tools...`);
             }
             // Create modified chat prompt with agent system message
             const modifiedChatPrompt = {
@@ -16966,6 +17266,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)
@@ -16983,6 +17287,18 @@ class AgentLlmExecutionTools {
  * @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
      */
@@ -16998,10 +17314,7 @@ class Agent extends AgentLlmExecutionTools {
             llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
             agentSource: agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
         });
-        /**
-         * Name of the agent
-         */
-        this.agentName = null;
+        this._agentName = undefined;
         /**
          * Description of the agent
          */
@@ -17010,12 +17323,12 @@ class Agent extends AgentLlmExecutionTools {
          * 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;
+            this._agentName = agentName;
             this.personaDescription = personaDescription;
             this.meta = { ...this.meta, ...meta };
         });
@@ -17089,9 +17402,9 @@ 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`
+ * !!!!!! `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`
@@ -17106,7 +17419,7 @@ class RemoteAgent extends Agent {
         // <- 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: {
@@ -17167,7 +17480,7 @@ class RemoteAgent extends Agent {
                 reader.releaseLock();
             }
         }
-        // <- TODO: !!!!!!!! Transfer metadata
+        // <- TODO: !!!! Transfer metadata
         const agentResult = {
             content,
             modelName: this.modelName,
@@ -17176,7 +17489,7 @@ class RemoteAgent extends Agent {
             rawPromptContent: {},
             rawRequest: {},
             rawResponse: {},
-            // <- TODO: !!!!!!!! Transfer and proxy the metadata
+            // <- TODO: !!!! Transfer and proxy the metadata
         };
         return agentResult;
     }
@@ -17307,24 +17620,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 +17972,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 +18507,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 +18526,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 +18573,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 +18590,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 +18598,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 +18776,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 +18785,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