@promptbook/core 0.69.0-1 → 0.69.0-11

package/esm/index.es.js

@@ -2,6 +2,7 @@ import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
 import { forTime } from 'waitasecond';
+import { unparse, parse } from 'papaparse';
 import hexEncoder from 'crypto-js/enc-hex';
 import sha256 from 'crypto-js/sha256';
 import moment from 'moment';
@@ -10,7 +11,7 @@ import moment from 'moment';
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.69.0-0';
+var PROMPTBOOK_VERSION = '0.69.0-10';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
@@ -652,13 +653,13 @@ var IMMEDIATE_TIME = 10;
  *
  * @public exported from `@promptbook/core`
  */
-var MAX_PARALLEL_COUNT = 5;
+var MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
 /**
  * The maximum number of attempts to execute LLM task before giving up
  *
  * @public exported from `@promptbook/core`
  */
-var MAX_EXECUTION_ATTEMPTS = 3;
+var MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
 /**
  * The maximum length of the (generated) filename
  *
@@ -709,6 +710,7 @@ var RESERVED_PARAMETER_NAMES = $asDeeplyFrozenSerializableJson('RESERVED_PARAMET
     'samples',
     'modelName',
     'currentDate',
+    // <- TODO: !!!!! list here all command names
     // <- TODO: Add more like 'date', 'modelName',...
     // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
 ]);
@@ -752,6 +754,15 @@ var DEFAULT_REMOTE_URL_PATH = '/promptbook/socket.io';
  * @public exported from `@promptbook/core`
  */
 var IS_VERBOSE = false;
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+var IS_PIPELINE_LOGIC_VALIDATED = just(
+/**/
+// Note: In normal situations, we check the pipeline logic:
+true);
 /**
  * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
  */
@@ -961,6 +972,26 @@ function isValidPipelineUrl(url) {
  * @public exported from `@promptbook/core`
  */
 function validatePipeline(pipeline) {
+    if (IS_PIPELINE_LOGIC_VALIDATED) {
+        validatePipelineCore(pipeline);
+    }
+    else {
+        try {
+            validatePipelineCore(pipeline);
+        }
+        catch (error) {
+            if (!(error instanceof PipelineLogicError)) {
+                throw error;
+            }
+            console.error(spaceTrim$1(function (block) { return "\n                        Pipeline is not valid but logic errors are temporarily disabled via `IS_PIPELINE_LOGIC_VALIDATED`\n\n                        ".concat(block(error.message), "\n                    "); }));
+        }
+    }
+    return pipeline;
+}
+/**
+ * @private internal function for `validatePipeline`
+ */
+function validatePipelineCore(pipeline) {
     // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
     var e_1, _a, e_2, _b, e_3, _c;
     var pipelineIdentification = (function () {
@@ -985,12 +1016,12 @@ function validatePipeline(pipeline) {
     // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.parameters)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.templates)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.templates` expected to be an array, but got ".concat(typeof pipeline.templates, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.templates` expected to be an array, but got ".concat(typeof pipeline.templates, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     var _loop_1 = function (parameter) {
         if (parameter.isInput && parameter.isOutput) {
@@ -1159,9 +1190,9 @@ function validatePipeline(pipeline) {
     while (unresovedTemplates.length > 0) {
         _loop_3();
     }
-    return pipeline;
 }
 /**
+ * TODO: !!!!!! [🧞‍♀️] Do not allow joker + foreach
  * TODO: [🧠] Work with promptbookVersion
  * TODO: Use here some json-schema, Zod or something similar and change it to:
  *     > /**
@@ -1788,7 +1819,7 @@ function forEachAsync(array, options, callbackfunction) {
     });
 }
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.69.0-0",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.69.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.69.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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-   Title should be concise and clear\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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.69.0-0",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.69.0-10",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.69.0-10",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.69.0-10",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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-   Title should be concise and clear\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"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.69.0-10",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
 var defaultDiacriticsRemovalMap = [
     {
@@ -2317,113 +2348,35 @@ function assertsExecutionSuccessful(executionResult) {
  */
 
 /**
- * Parses the given script and returns the list of all used variables that are not defined in the script
- *
- * @param script from which to extract the variables
- * @returns the list of variable names
- * @throws {ParseError} if the script is invalid
- * @public exported from `@promptbook/utils`
- */
-function extractVariables(script) {
-    var variables = new Set();
-    script = "(()=>{".concat(script, "})()");
-    try {
-        for (var i = 0; i < 100 /* <- TODO: This limit to configuration */; i++)
-            try {
-                eval(script);
-            }
-            catch (error) {
-                if (!(error instanceof ReferenceError)) {
-                    throw error;
-                }
-                var undefinedName = error.message.split(' ')[0];
-                /*
-                Note: Parsing the error
-                      [PipelineUrlError: thing is not defined]
-                */
-                if (!undefinedName) {
-                    throw error;
-                }
-                if (script.includes(undefinedName + '(')) {
-                    script = "const ".concat(undefinedName, " = ()=>'';") + script;
-                }
-                else {
-                    variables.add(undefinedName);
-                    script = "const ".concat(undefinedName, " = '';") + script;
-                }
-            }
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.toString()), "}\n                "); }));
-    }
-    return variables;
-}
-/**
- * TODO: [🔣] Support for multiple languages - python, java,...
- */
-
-/**
- * Parses the template and returns the set of all used parameters
+ * Determine if the pipeline is fully prepared
  *
- * @param template the template with used parameters
- * @returns the set of parameter names
- * @throws {ParseError} if the script is invalid
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
  */
-function extractParameterNamesFromTemplate(template) {
-    var e_1, _a, e_2, _b, e_3, _c;
-    var title = template.title, description = template.description, templateType = template.templateType, content = template.content, preparedContent = template.preparedContent, jokerParameterNames = template.jokerParameterNames;
-    var parameterNames = new Set();
-    try {
-        for (var _d = __values(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameterNames(title)), false), __read(extractParameterNames(description || '')), false), __read(extractParameterNames(content)), false), __read(extractParameterNames(preparedContent || '')), false)), _e = _d.next(); !_e.done; _e = _d.next()) {
-            var parameterName = _e.value;
-            parameterNames.add(parameterName);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    if (templateType === 'SCRIPT_TEMPLATE') {
-        try {
-            for (var _f = __values(extractVariables(content)), _g = _f.next(); !_g.done; _g = _f.next()) {
-                var parameterName = _g.value;
-                parameterNames.add(parameterName);
-            }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
-            }
-            finally { if (e_2) throw e_2.error; }
-        }
-    }
-    try {
-        for (var _h = __values(jokerParameterNames || []), _j = _h.next(); !_j.done; _j = _h.next()) {
-            var jokerName = _j.value;
-            parameterNames.add(jokerName);
-        }
+function isPipelinePrepared(pipeline) {
+    // Note: Ignoring `pipeline.preparations` @@@
+    // Note: Ignoring `pipeline.knowledgePieces` @@@
+    if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
+        return false;
     }
-    catch (e_3_1) { e_3 = { error: e_3_1 }; }
-    finally {
-        try {
-            if (_j && !_j.done && (_c = _h.return)) _c.call(_h);
-        }
-        finally { if (e_3) throw e_3.error; }
+    if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
+        return false;
     }
-    parameterNames.delete('content');
-    //                      <- Note {websiteContent} is used in `preparedContent`
-    return parameterNames;
+    /*
+    TODO: [🧠][🍫] `templates` can not be determined if they are fully prepared SO ignoring them
+    > if (!pipeline.templates.every(({ preparedContent }) => preparedContent === undefined)) {
+    >     return false;
+    > }
+    */
+    return true;
 }
 /**
- * TODO: [🔣] If script require contentLanguage
+ * TODO: [🔃] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
+ * TODO: [🐠] Maybe base this on `makeValidator`
+ * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
+ * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
+ *     - [🏍] ? Is context in each template
+ *     - [♨] Are samples prepared
+ *     - [♨] Are templates prepared
  */
 
 /**
@@ -2443,27 +2396,6 @@ function serializeError(error) {
     };
 }
 
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
-    }
-}
-
 /**
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
@@ -2758,288 +2690,153 @@ function joinLlmExecutionTools() {
  */
 
 /**
- * Extracts all code blocks from markdown.
+ * Takes an item or an array of items and returns an array of items
  *
- * Note: There are multiple simmilar function:
- * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
- * - `extractJsonBlock` extracts exactly one valid JSON code block
- * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
- * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ * 1) Any item except array and undefined returns array with that one item (also null)
+ * 2) Undefined returns empty array
+ * 3) Array returns itself
  *
- * @param markdown any valid markdown
- * @returns code blocks with language and content
- * @throws {ParseError} if block is not closed properly
- * @public exported from `@promptbook/markdown-utils`
+ * @private internal utility
  */
-function extractAllBlocksFromMarkdown(markdown) {
-    var e_1, _a;
-    var codeBlocks = [];
-    var lines = markdown.split('\n');
-    // Note: [0] Ensure that the last block notated by gt > will be closed
-    lines.push('');
-    var currentCodeBlock = null;
+function arrayableToArray(input) {
+    if (input === undefined) {
+        return [];
+    }
+    if (input instanceof Array) {
+        return input;
+    }
+    return [input];
+}
+
+/**
+ * Parses the given script and returns the list of all used variables that are not defined in the script
+ *
+ * @param script from which to extract the variables
+ * @returns the list of variable names
+ * @throws {ParseError} if the script is invalid
+ * @public exported from `@promptbook/utils`
+ */
+function extractVariables(script) {
+    var variables = new Set();
+    script = "(()=>{".concat(script, "})()");
     try {
-        for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-            var line = lines_1_1.value;
-            if (line.startsWith('> ') || line === '>') {
-                if (currentCodeBlock === null) {
-                    currentCodeBlock = { blockNotation: '>', language: null, content: '' };
-                } /* not else */
-                if (currentCodeBlock.blockNotation === '>') {
-                    if (currentCodeBlock.content !== '') {
-                        currentCodeBlock.content += '\n';
-                    }
-                    currentCodeBlock.content += line.slice(2);
-                }
-            }
-            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
-                codeBlocks.push(currentCodeBlock);
-                currentCodeBlock = null;
+        for (var i = 0; i < 100 /* <- TODO: This limit to configuration */; i++)
+            try {
+                eval(script);
             }
-            /* not else */
-            if (line.startsWith('```')) {
-                var language = line.slice(3).trim() || null;
-                if (currentCodeBlock === null) {
-                    currentCodeBlock = { blockNotation: '```', language: language, content: '' };
+            catch (error) {
+                if (!(error instanceof ReferenceError)) {
+                    throw error;
                 }
-                else {
-                    if (language !== null) {
-                        throw new ParseError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
-                    }
-                    codeBlocks.push(currentCodeBlock);
-                    currentCodeBlock = null;
+                var undefinedName = error.message.split(' ')[0];
+                /*
+                Note: Parsing the error
+                      [PipelineUrlError: thing is not defined]
+                */
+                if (!undefinedName) {
+                    throw error;
                 }
-            }
-            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
-                if (currentCodeBlock.content !== '') {
-                    currentCodeBlock.content += '\n';
+                if (script.includes(undefinedName + '(')) {
+                    script = "const ".concat(undefinedName, " = ()=>'';") + script;
+                }
+                else {
+                    variables.add(undefinedName);
+                    script = "const ".concat(undefinedName, " = '';") + script;
                 }
-                currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
             }
+    }
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
         }
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.toString()), "}\n                "); }));
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    if (currentCodeBlock !== null) {
-        throw new ParseError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
-    }
-    return codeBlocks;
-}
-/**
- * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
- */
-
-/**
- * Extracts  extracts exactly one valid JSON code block
- *
- * - When given string is a valid JSON as it is, it just returns it
- * - When there is no JSON code block the function throws a `ParseError`
- * - When there are multiple JSON code blocks the function throws a `ParseError`
- *
- * Note: It is not important if marked as ```json BUT if it is VALID JSON
- * Note: There are multiple simmilar function:
- * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
- * - `extractJsonBlock` extracts exactly one valid JSON code block
- * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
- * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
- *
- * @public exported from `@promptbook/markdown-utils`
- * @throws {ParseError} if there is no valid JSON block in the markdown
- */
-function extractJsonBlock(markdown) {
-    if (isValidJsonString(markdown)) {
-        return markdown;
-    }
-    var codeBlocks = extractAllBlocksFromMarkdown(markdown);
-    var jsonBlocks = codeBlocks.filter(function (_a) {
-        var content = _a.content;
-        return isValidJsonString(content);
-    });
-    if (jsonBlocks.length === 0) {
-        throw new Error('There is no valid JSON block in the markdown');
-    }
-    if (jsonBlocks.length > 1) {
-        throw new Error('There are multiple JSON code blocks in the markdown');
-    }
-    return jsonBlocks[0].content;
-}
-/**
- * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
- * TODO: [🏢] Make this logic part of `JsonFormatDefinition` or `isValidJsonString`
- */
-
-/**
- * Determine if the pipeline is fully prepared
- *
- * @public exported from `@promptbook/core`
- */
-function isPipelinePrepared(pipeline) {
-    // Note: Ignoring `pipeline.preparations` @@@
-    // Note: Ignoring `pipeline.knowledgePieces` @@@
-    if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
-        return false;
-    }
-    if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
-        return false;
-    }
-    /*
-    TODO: [🧠][🍫] `templates` can not be determined if they are fully prepared SO ignoring them
-    > if (!pipeline.templates.every(({ preparedContent }) => preparedContent === undefined)) {
-    >     return false;
-    > }
-    */
-    return true;
-}
-/**
- * TODO: [🔃] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
- * TODO: [🐠] Maybe base this on `makeValidator`
- * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
- * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- *     - [🏍] ? Is context in each template
- *     - [♨] Are samples prepared
- *     - [♨] Are templates prepared
- */
-
-/**
- * Takes an item or an array of items and returns an array of items
- *
- * 1) Any item except array and undefined returns array with that one item (also null)
- * 2) Undefined returns empty array
- * 3) Array returns itself
- *
- * @private internal utility
- */
-function arrayableToArray(input) {
-    if (input === undefined) {
-        return [];
-    }
-    if (input instanceof Array) {
-        return input;
-    }
-    return [input];
-}
-
-/**
- * Just says that the variable is not used but should be kept
- * No side effects.
- *
- * Note: It can be usefull for:
- *
- * 1) Suppressing eager optimization of unused imports
- * 2) Suppressing eslint errors of unused variables in the tests
- * 3) Keeping the type of the variable for type testing
- *
- * @param value any values
- * @returns void
- * @private within the repository
- */
-function keepUnused() {
-    var valuesToKeep = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        valuesToKeep[_i] = arguments[_i];
-    }
+    return variables;
 }
-
 /**
- * Just marks a place of place where should be something implemented
- * No side effects.
- *
- * Note: It can be usefull suppressing eslint errors of unused variables
- *
- * @param value any values
- * @returns void
- * @private within the repository
+ * TODO: [🔣] Support for multiple languages - python, java,...
  */
-function TODO_USE() {
-    var value = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        value[_i] = arguments[_i];
-    }
-}
 
 /**
- * Replaces parameters in template with values from parameters object
+ * Parses the template and returns the set of all used parameters
  *
- * @param template the template with parameters in {curly} braces
- * @param parameters the object with parameters
- * @returns the template with replaced parameters
- * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+ * @param template the template with used parameters
+ * @returns the set of parameter names
+ * @throws {ParseError} if the script is invalid
  * @public exported from `@promptbook/utils`
  */
-function replaceParameters(template, parameters) {
-    var e_1, _a;
+function extractParameterNamesFromTemplate(template) {
+    var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
+    var title = template.title, description = template.description, templateType = template.templateType, content = template.content, preparedContent = template.preparedContent, jokerParameterNames = template.jokerParameterNames, foreach = template.foreach;
+    var parameterNames = new Set();
     try {
-        for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
-            if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
-                throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
-            }
-            else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
-                // TODO: [🍵]
-                throw new UnexpectedError("Parameter {".concat(parameterName, "} is restricted to use"));
-            }
+        for (var _e = __values(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameterNames(title)), false), __read(extractParameterNames(description || '')), false), __read(extractParameterNames(content)), false), __read(extractParameterNames(preparedContent || '')), false)), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var parameterName = _f.value;
+            parameterNames.add(parameterName);
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    var replacedTemplate = template;
-    var match;
-    var loopLimit = LOOP_LIMIT;
-    var _loop_1 = function () {
-        if (loopLimit-- < 0) {
-            throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
+    if (templateType === 'SCRIPT_TEMPLATE') {
+        try {
+            for (var _g = __values(extractVariables(content)), _h = _g.next(); !_h.done; _h = _g.next()) {
+                var parameterName = _h.value;
+                parameterNames.add(parameterName);
+            }
         }
-        var precol = match.groups.precol;
-        var parameterName = match.groups.parameterName;
-        if (parameterName === '') {
-            return "continue";
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
+            }
+            finally { if (e_2) throw e_2.error; }
         }
-        if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-            throw new PipelineExecutionError('Parameter is already opened or not closed');
+    }
+    try {
+        for (var _j = __values(jokerParameterNames || []), _k = _j.next(); !_k.done; _k = _j.next()) {
+            var jokerName = _k.value;
+            parameterNames.add(jokerName);
         }
-        if (parameters[parameterName] === undefined) {
-            throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
         }
-        var parameterValue = parameters[parameterName];
-        if (parameterValue === undefined) {
-            throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+        finally { if (e_3) throw e_3.error; }
+    }
+    parameterNames.delete('content');
+    //                      <- Note {websiteContent} is used in `preparedContent`
+    // Note: [🍭] Fixing dependent subparameterName from FOREACH command
+    if (foreach !== undefined) {
+        try {
+            for (var _l = __values(foreach.subparameterNames), _m = _l.next(); !_m.done; _m = _l.next()) {
+                var subparameterName = _m.value;
+                if (parameterNames.has(subparameterName)) {
+                    parameterNames.delete(subparameterName);
+                    parameterNames.add(foreach.parameterName);
+                    // <- TODO: [🚎] Warn/logic error when `subparameterName` not used
+                }
+            }
         }
-        parameterValue = parameterValue.toString();
-        if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
-            parameterValue = parameterValue
-                .split('\n')
-                .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
-                .join('\n');
+        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+        finally {
+            try {
+                if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+            }
+            finally { if (e_4) throw e_4.error; }
         }
-        replacedTemplate =
-            replacedTemplate.substring(0, match.index + precol.length) +
-                parameterValue +
-                replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
-    };
-    while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
-        .exec(replacedTemplate))) {
-        _loop_1();
     }
-    // [💫] Check if there are parameters that are not closed properly
-    if (/{\w+$/.test(replacedTemplate)) {
-        throw new PipelineExecutionError('Parameter is not closed');
-    }
-    // [💫] Check if there are parameters that are not opened properly
-    if (/^\w+}/.test(replacedTemplate)) {
-        throw new PipelineExecutionError('Parameter is not opened');
-    }
-    return replacedTemplate;
+    return parameterNames;
 }
+/**
+ * TODO: [🔣] If script require contentLanguage
+ */
 
 /**
  * Create difference set of two sets.
@@ -3117,117 +2914,364 @@ function union() {
 }
 
 /**
- * Counts number of characters in the text
+ * Just marks a place of place where should be something implemented
+ * No side effects.
  *
- * @public exported from `@promptbook/utils`
- */
-function countCharacters(text) {
-    // Remove null characters
-    text = text.replace(/\0/g, '');
-    // Replace emojis (and also ZWJ sequence) with hyphens
-    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-    text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
-    return text.length;
-}
-
-/**
- * Counts number of lines in the text
+ * Note: It can be usefull suppressing eslint errors of unused variables
  *
- * @public exported from `@promptbook/utils`
+ * @param value any values
+ * @returns void
+ * @private within the repository
  */
-function countLines(text) {
-    if (text === '') {
-        return 0;
+function TODO_USE() {
+    var value = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        value[_i] = arguments[_i];
     }
-    return text.split('\n').length;
 }
 
 /**
- * Counts number of pages in the text
+ * Definition for CSV spreadsheet
  *
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
+ *                          <- TODO: [🏢] Export from package `@promptbook/csv`
+ */
+var CsvFormatDefinition = {
+    formatName: 'CSV',
+    aliases: ['SPREADSHEET', 'TABLE'],
+    isValid: function (value, schema) {
+        TODO_USE(value /* <- TODO: Use value here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return true;
+    },
+    canBeValid: function (partialValue, schema) {
+        TODO_USE(partialValue /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return true;
+    },
+    heal: function (value, schema) {
+        TODO_USE(value /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        throw new Error('Not implemented');
+    },
+    subvalueDefinitions: [
+        {
+            subvalueName: 'ROW',
+            mapValues: function (value, mapCallback) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var csv, mappedData;
+                    var _this = this;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                csv = parse(value, {
+                                    header: true,
+                                    delimiter: ',',
+                                    quoteChar: '"',
+                                    newline: '\r\n',
+                                    skipEmptyLines: true,
+                                    // encoding: 'utf8',
+                                    // <- TODO: !!!!!! DEFAULT_CSV_OPTIONS
+                                    // <- TODO: [🧠] How to define parsing options for formats, its different concept than schema
+                                });
+                                if (csv.errors.length !== 0) {
+                                    throw new ParseError(// <- TODO: !!!!!! Split PipelineParseError and FormatParseError -> CsvParseError
+                                    spaceTrim(function (block) { return "\n                                CSV parsing error\n\n                                ".concat(block(csv.errors.map(function (error) { return error.message; }).join('\n\n')), "\n                            "); }));
+                                }
+                                return [4 /*yield*/, Promise.all(csv.data.map(function (row, index) { return __awaiter(_this, void 0, void 0, function () {
+                                        var _a;
+                                        var _b;
+                                        return __generator(this, function (_c) {
+                                            switch (_c.label) {
+                                                case 0:
+                                                    _a = [__assign({}, row)];
+                                                    _b = {};
+                                                    // <- TODO: !!!!!! Dynamic new column name and position
+                                                    return [4 /*yield*/, mapCallback(row, index)];
+                                                case 1: return [2 /*return*/, (__assign.apply(void 0, _a.concat([(_b.newColumn = 
+                                                        // <- TODO: !!!!!! Dynamic new column name and position
+                                                        _c.sent(), _b)])))];
+                                            }
+                                        });
+                                    }); }))];
+                            case 1:
+                                mappedData = _a.sent();
+                                return [2 /*return*/, unparse(mappedData, {
+                                        header: true,
+                                        delimiter: ',',
+                                        quoteChar: '"',
+                                        newline: '\r\n',
+                                        skipEmptyLines: true,
+                                        // encoding: 'utf8',
+                                        // <- TODO: !!!!!! DEFAULT_CSV_OPTIONS
+                                        // <- TODO: [🧠] How to define parsing options for formats, its different concept than schema
+                                    })];
+                        }
+                    });
+                });
+            },
+        },
+        {
+            subvalueName: 'CELL',
+            mapValues: function (value, mapCallback) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var csv, mappedData;
+                    var _this = this;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                csv = parse(value, {
+                                    header: true,
+                                    delimiter: ',',
+                                    quoteChar: '"',
+                                    newline: '\r\n',
+                                    skipEmptyLines: true,
+                                    // encoding: 'utf8',
+                                    // <- TODO: !!!!!! DEFAULT_CSV_OPTIONS
+                                    // <- TODO: [🧠] How to define parsing options for formats, its different concept than schema
+                                });
+                                if (csv.errors.length !== 0) {
+                                    throw new ParseError(// <- TODO: !!!!!! Split PipelineParseError and FormatParseError -> CsvParseError
+                                    spaceTrim(function (block) { return "\n                                CSV parsing error\n\n                                ".concat(block(csv.errors.map(function (error) { return error.message; }).join('\n\n')), "\n                            "); }));
+                                }
+                                return [4 /*yield*/, Promise.all(csv.data.map(function (row, rowIndex) { return __awaiter(_this, void 0, void 0, function () {
+                                        var _this = this;
+                                        return __generator(this, function (_a) {
+                                            return [2 /*return*/, /* not await */ Promise.all(Object.entries(row).map(function (_a, columnIndex) {
+                                                    var _b = __read(_a, 2), key = _b[0], value = _b[1];
+                                                    return __awaiter(_this, void 0, void 0, function () {
+                                                        var index;
+                                                        var _c;
+                                                        return __generator(this, function (_d) {
+                                                            index = rowIndex * Object.keys(row).length + columnIndex;
+                                                            return [2 /*return*/, /* not await */ mapCallback((_c = {}, _c[key] = value, _c), index)];
+                                                        });
+                                                    });
+                                                }))];
+                                        });
+                                    }); }))];
+                            case 1:
+                                mappedData = _a.sent();
+                                return [2 /*return*/, unparse(mappedData, {
+                                        header: true,
+                                        delimiter: ',',
+                                        quoteChar: '"',
+                                        newline: '\r\n',
+                                        skipEmptyLines: true,
+                                        // encoding: 'utf8',
+                                        // <- TODO: !!!!!! DEFAULT_CSV_OPTIONS
+                                        // <- TODO: [🧠] How to define parsing options for formats, its different concept than schema
+                                    })];
+                        }
+                    });
+                });
+            },
+        },
+    ],
+};
+/**
+ * TODO: [🍓] In `CsvFormatDefinition` implement simple `isValid`
+ * TODO: [🍓] In `CsvFormatDefinition` implement partial `canBeValid`
+ * TODO: [🍓] In `CsvFormatDefinition` implement `heal
+ * TODO: [🍓] In `CsvFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🏢] Allow to expect something inside CSV objects and other formats
  */
-function countPages(text) {
-    var sentencesPerPage = 5; // Assuming each page has 5 sentences
-    var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-    var pageCount = Math.ceil(sentences.length / sentencesPerPage);
-    return pageCount;
-}
 
 /**
- * Counts number of paragraphs in the text
+ * Function isValidJsonString will tell you if the string is valid JSON or not
  *
  * @public exported from `@promptbook/utils`
  */
-function countParagraphs(text) {
-    return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        return false;
+    }
 }
 
 /**
- * Split text into sentences
+ * Definition for JSON format
  *
- * @public exported from `@promptbook/utils`
+ * @private still in development [🏢]
  */
-function splitIntoSentences(text) {
-    return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-}
+var JsonFormatDefinition = {
+    formatName: 'JSON',
+    mimeType: 'application/json',
+    isValid: function (value, schema) {
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return isValidJsonString(value);
+    },
+    canBeValid: function (partialValue, schema) {
+        TODO_USE(partialValue /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return true;
+    },
+    heal: function (value, schema) {
+        TODO_USE(value /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        throw new Error('Not implemented');
+    },
+    subvalueDefinitions: [],
+};
 /**
- * Counts number of sentences in the text
- *
- * @public exported from `@promptbook/utils`
+ * TODO: [🧠] Maybe propper instance of object
+ * TODO: [0] Make string_serialized_json
+ * TODO: [1] Make type for JSON Schema
+ * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
+ * TODO: [🍓] In `JsonFormatDefinition` implement simple `isValid`
+ * TODO: [🍓] In `JsonFormatDefinition` implement partial `canBeValid`
+ * TODO: [🍓] In `JsonFormatDefinition` implement `heal
+ * TODO: [🍓] In `JsonFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🏢] Allow to expect something inside JSON objects and other formats
  */
-function countSentences(text) {
-    return splitIntoSentences(text).length;
-}
 
 /**
- * Counts number of words in the text
+ * Definition for any text - this will be always valid
  *
- * @public exported from `@promptbook/utils`
+ * Note: This is not useful for validation, but for splitting and mapping with `subvalueDefinitions`
+ *
+ * @public exported from `@promptbook/core`
+ */
+var TextFormatDefinition = {
+    formatName: 'TEXT',
+    isValid: function (value) {
+        return typeof value === 'string';
+    },
+    canBeValid: function (partialValue) {
+        return typeof partialValue === 'string';
+    },
+    heal: function () {
+        throw new UnexpectedError('It does not make sense to call `TextFormatDefinition.heal`');
+    },
+    subvalueDefinitions: [
+        {
+            subvalueName: 'LINE',
+            mapValues: function (value, mapCallback) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var lines, mappedLines;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                lines = value.split('\n');
+                                return [4 /*yield*/, Promise.all(lines.map(function (lineContent, lineNumber) {
+                                        // TODO: [🧠] Maybe option to skip empty line
+                                        /* not await */ return mapCallback({
+                                            lineContent: lineContent,
+                                            // TODO: [🧠] Maybe also put here `lineNumber`
+                                        }, lineNumber);
+                                    }))];
+                            case 1:
+                                mappedLines = _a.sent();
+                                return [2 /*return*/, mappedLines.join('\n')];
+                        }
+                    });
+                });
+            },
+        },
+        // <- TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages aviable as subvalues
+    ],
+};
+/**
+ * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages aviable as subvalues
+ * TODO: [🍓] In `TextFormatDefinition` implement simple `isValid`
+ * TODO: [🍓] In `TextFormatDefinition` implement partial `canBeValid`
+ * TODO: [🍓] In `TextFormatDefinition` implement `heal
+ * TODO: [🍓] In `TextFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🏢] Allow to expect something inside each item of list and other formats
  */
-function countWords(text) {
-    text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
-    text = removeDiacritics(text);
-    return text.split(/[^a-zа-я0-9]+/i).filter(function (word) { return word.length > 0; }).length;
-}
 
 /**
- * Index of all counter functions
+ * Definition for XML format
  *
- * @public exported from `@promptbook/utils`
+ * @private still in development [🏢]
  */
-var CountUtils = {
-    CHARACTERS: countCharacters,
-    WORDS: countWords,
-    SENTENCES: countSentences,
-    PARAGRAPHS: countParagraphs,
-    LINES: countLines,
-    PAGES: countPages,
+var XmlFormatDefinition = {
+    formatName: 'XML',
+    mimeType: 'application/xml',
+    isValid: function (value, schema) {
+        TODO_USE(value /* <- TODO: Use value here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return true;
+    },
+    canBeValid: function (partialValue, schema) {
+        TODO_USE(partialValue /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        return true;
+    },
+    heal: function (value, schema) {
+        TODO_USE(value /* <- TODO: Use partialValue here */);
+        TODO_USE(schema /* <- TODO: Use schema here */);
+        throw new Error('Not implemented');
+    },
+    subvalueDefinitions: [],
 };
+/**
+ * TODO: [🧠] Maybe propper instance of object
+ * TODO: [0] Make string_serialized_xml
+ * TODO: [1] Make type for XML Schema
+ * TODO: [🧠] What to use for validating XMLs - XSD,...
+ * TODO: [🍓] In `XmlFormatDefinition` implement simple `isValid`
+ * TODO: [🍓] In `XmlFormatDefinition` implement partial `canBeValid`
+ * TODO: [🍓] In `XmlFormatDefinition` implement `heal
+ * TODO: [🍓] In `XmlFormatDefinition` implement `subvalueDefinitions`
+ * TODO: [🏢] Allow to expect something inside XML and other formats
+ */
 
 /**
- * Function checkExpectations will check if the expectations on given value are met
+ * Definitions for all formats supported by Promptbook
  *
- * Note: There are two simmilar functions:
- * - `checkExpectations` which throws an error if the expectations are not met
- * - `isPassingExpectations` which returns a boolean
+ * @private internal index of `...` <- TODO [🏢]
+ */
+var FORMAT_DEFINITIONS = [
+    JsonFormatDefinition,
+    XmlFormatDefinition,
+    TextFormatDefinition,
+    CsvFormatDefinition,
+];
+
+/**
+ * Maps available parameters to expected parameters
  *
- * @throws {ExpectError} if the expectations are not met
- * @returns {void} Nothing
- * @private internal function of `createPipelineExecutor`
+ * The strategy is:
+ * 1) @@@
+ * 2) @@@
+ *
+ * @throws {PipelineExecutionError} @@@
+ * @private within the repository used in `createPipelineExecutor`
  */
-function checkExpectations(expectations, value) {
+function mapAvailableToExpectedParameters(options) {
     var e_1, _a;
+    var expectedParameters = options.expectedParameters, availableParameters = options.availableParameters;
+    var availableParametersNames = new Set(Object.keys(availableParameters));
+    var expectedParameterNames = new Set(Object.keys(expectedParameters));
+    var mappedParameters = {};
     try {
-        for (var _b = __values(Object.entries(expectations)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var _d = __read(_c.value, 2), unit = _d[0], _e = _d[1], max = _e.max, min = _e.min;
-            var amount = CountUtils[unit.toUpperCase()](value);
-            if (min && amount < min) {
-                throw new ExpectError("Expected at least ".concat(min, " ").concat(unit, " but got ").concat(amount));
-            } /* not else */
-            if (max && amount > max) {
-                throw new ExpectError("Expected at most ".concat(max, " ").concat(unit, " but got ").concat(amount));
+        // Phase 1️⃣: Matching mapping
+        for (var _b = __values(Array.from(union(availableParametersNames, expectedParameterNames))), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var parameterName = _c.value;
+            // Situation: Parameter is available and expected
+            if (availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) {
+                mappedParameters[parameterName] = availableParameters[parameterName];
+                // <- Note: [👩‍👩‍👧] Maybe detect parameter collision here?
+                availableParametersNames.delete(parameterName);
+                expectedParameterNames.delete(parameterName);
+            }
+            // Situation: Parameter is available but NOT expected
+            else if (availableParametersNames.has(parameterName) && !expectedParameterNames.has(parameterName)) {
+                // [🐱‍👤] Do not pass this parameter to prompt - Maybe use it non-matching mapping
+            }
+            // Situation: Parameter is NOT available BUT expected
+            else if (!availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) {
+                //  Do nothing here - this will be maybe fixed in the non-matching mapping
             }
         }
     }
@@ -3238,622 +3282,1145 @@ function checkExpectations(expectations, value) {
         }
         finally { if (e_1) throw e_1.error; }
     }
+    if (expectedParameterNames.size === 0) {
+        // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent @@@
+        Object.freeze(mappedParameters);
+        return mappedParameters;
+    }
+    // Phase 2️⃣: Non-matching mapping
+    if (expectedParameterNames.size !== availableParametersNames.size) {
+        throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                    Can not map available parameters to expected parameters\n\n                    Mapped parameters:\n                    ".concat(block(Object.keys(mappedParameters)
+            .map(function (parameterName) { return "- {".concat(parameterName, "}"); })
+            .join('\n')), "\n\n                    Expected parameters which can not be mapped:\n                    ").concat(block(Array.from(expectedParameterNames)
+            .map(function (parameterName) { return "- {".concat(parameterName, "}"); })
+            .join('\n')), "\n\n                    Remaining available parameters:\n                    ").concat(block(Array.from(availableParametersNames)
+            .map(function (parameterName) { return "- {".concat(parameterName, "}"); })
+            .join('\n')), "\n\n                "); }));
+    }
+    var expectedParameterNamesArray = Array.from(expectedParameterNames);
+    var availableParametersNamesArray = Array.from(availableParametersNames);
+    for (var i = 0; i < expectedParameterNames.size; i++) {
+        mappedParameters[expectedParameterNamesArray[i]] = availableParameters[availableParametersNamesArray[i]];
+    }
+    // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent @@@
+    Object.freeze(mappedParameters);
+    return mappedParameters;
 }
+
 /**
- * Function checkExpectations will check if the expectations on given value are met
+ * Extracts all code blocks from markdown.
  *
- * Note: There are two simmilar functions:
- * - `checkExpectations` which throws an error if the expectations are not met
- * - `isPassingExpectations` which returns a boolean
+ * Note: There are multiple simmilar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
  *
- * @returns {boolean} True if the expectations are met
- * @public exported from `@promptbook/core`
+ * @param markdown any valid markdown
+ * @returns code blocks with language and content
+ * @throws {ParseError} if block is not closed properly
+ * @public exported from `@promptbook/markdown-utils`
  */
-function isPassingExpectations(expectations, value) {
+function extractAllBlocksFromMarkdown(markdown) {
+    var e_1, _a;
+    var codeBlocks = [];
+    var lines = markdown.split('\n');
+    // Note: [0] Ensure that the last block notated by gt > will be closed
+    lines.push('');
+    var currentCodeBlock = null;
     try {
-        checkExpectations(expectations, value);
-        return true;
+        for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+            var line = lines_1_1.value;
+            if (line.startsWith('> ') || line === '>') {
+                if (currentCodeBlock === null) {
+                    currentCodeBlock = { blockNotation: '>', language: null, content: '' };
+                } /* not else */
+                if (currentCodeBlock.blockNotation === '>') {
+                    if (currentCodeBlock.content !== '') {
+                        currentCodeBlock.content += '\n';
+                    }
+                    currentCodeBlock.content += line.slice(2);
+                }
+            }
+            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
+                codeBlocks.push(currentCodeBlock);
+                currentCodeBlock = null;
+            }
+            /* not else */
+            if (line.startsWith('```')) {
+                var language = line.slice(3).trim() || null;
+                if (currentCodeBlock === null) {
+                    currentCodeBlock = { blockNotation: '```', language: language, content: '' };
+                }
+                else {
+                    if (language !== null) {
+                        throw new ParseError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+                    }
+                    codeBlocks.push(currentCodeBlock);
+                    currentCodeBlock = null;
+                }
+            }
+            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
+                if (currentCodeBlock.content !== '') {
+                    currentCodeBlock.content += '\n';
+                }
+                currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
+            }
+        }
     }
-    catch (error) {
-        if (!(error instanceof ExpectError)) {
-            throw error;
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
         }
-        return false;
+        finally { if (e_1) throw e_1.error; }
+    }
+    if (currentCodeBlock !== null) {
+        throw new ParseError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
     }
+    return codeBlocks;
 }
 /**
- * TODO: [💝] Unite object for expecting amount and format
+ * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
  */
 
 /**
- * Creates executor function from pipeline and execution tools.
+ * Extracts  extracts exactly one valid JSON code block
  *
- * @returns The executor function
- * @throws {PipelineLogicError} on logical error in the pipeline
- * @public exported from `@promptbook/core`
+ * - When given string is a valid JSON as it is, it just returns it
+ * - When there is no JSON code block the function throws a `ParseError`
+ * - When there are multiple JSON code blocks the function throws a `ParseError`
+ *
+ * Note: It is not important if marked as ```json BUT if it is VALID JSON
+ * Note: There are multiple simmilar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ * @throws {ParseError} if there is no valid JSON block in the markdown
  */
-function createPipelineExecutor(options) {
-    var _this = this;
-    var pipeline = options.pipeline, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
-    var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? MAX_EXECUTION_ATTEMPTS : _b, _c = settings.maxParallelCount, maxParallelCount = _c === void 0 ? MAX_PARALLEL_COUNT : _c, _d = settings.isVerbose, isVerbose = _d === void 0 ? IS_VERBOSE : _d, _e = settings.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _e === void 0 ? false : _e;
-    validatePipeline(pipeline);
-    var pipelineIdentification = (function () {
-        // Note: This is a 😐 implementation of [🚞]
-        var _ = [];
-        if (pipeline.sourceFile !== undefined) {
-            _.push("File: ".concat(pipeline.sourceFile));
-        }
-        if (pipeline.pipelineUrl !== undefined) {
-            _.push("Url: ".concat(pipeline.pipelineUrl));
-        }
-        return _.join('\n');
-    })();
-    var llmTools = joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(arrayableToArray(tools.llm)), false));
-    var preparedPipeline;
-    if (isPipelinePrepared(pipeline)) {
-        preparedPipeline = pipeline;
+function extractJsonBlock(markdown) {
+    if (isValidJsonString(markdown)) {
+        return markdown;
     }
-    else if (isNotPreparedWarningSupressed !== true) {
-        console.warn(spaceTrim$1(function (block) { return "\n                    Pipeline is not prepared\n\n                    ".concat(block(pipelineIdentification), "\n\n                    It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                    But it is recommended to prepare the pipeline during collection preparation\n\n                    @see more at https://ptbk.io/prepare-pipeline\n                "); }));
+    var codeBlocks = extractAllBlocksFromMarkdown(markdown);
+    var jsonBlocks = codeBlocks.filter(function (_a) {
+        var content = _a.content;
+        return isValidJsonString(content);
+    });
+    if (jsonBlocks.length === 0) {
+        throw new Error('There is no valid JSON block in the markdown');
     }
-    var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
-        // TODO: !!! Extract to separate functions and files - ALL FUNCTIONS BELOW
-        function getContextForTemplate(template) {
-            return __awaiter(this, void 0, void 0, function () {
-                return __generator(this, function (_a) {
-                    TODO_USE(template);
-                    return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: [🏍] Implement */];
-                });
-            });
+    if (jsonBlocks.length > 1) {
+        throw new Error('There are multiple JSON code blocks in the markdown');
+    }
+    return jsonBlocks[0].content;
+}
+/**
+ * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
+ * TODO: [🏢] Make this logic part of `JsonFormatDefinition` or `isValidJsonString`
+ */
+
+/**
+ * Just says that the variable is not used but should be kept
+ * No side effects.
+ *
+ * Note: It can be usefull for:
+ *
+ * 1) Suppressing eager optimization of unused imports
+ * 2) Suppressing eslint errors of unused variables in the tests
+ * 3) Keeping the type of the variable for type testing
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+function keepUnused() {
+    var valuesToKeep = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        valuesToKeep[_i] = arguments[_i];
+    }
+}
+
+/**
+ * Replaces parameters in template with values from parameters object
+ *
+ * @param template the template with parameters in {curly} braces
+ * @param parameters the object with parameters
+ * @returns the template with replaced parameters
+ * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+ * @public exported from `@promptbook/utils`
+ */
+function replaceParameters(template, parameters) {
+    var e_1, _a;
+    try {
+        for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
+            if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
+                throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
+            }
+            else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
+                // TODO: [🍵]
+                throw new UnexpectedError("Parameter {".concat(parameterName, "} is restricted to use"));
+            }
         }
-        function getKnowledgeForTemplate(template) {
-            return __awaiter(this, void 0, void 0, function () {
-                return __generator(this, function (_a) {
-                    // TODO: [♨] Implement Better - use real index and keyword search from `template` and {samples}
-                    TODO_USE(template);
-                    return [2 /*return*/, preparedPipeline.knowledgePieces.map(function (_a) {
-                            var content = _a.content;
-                            return "- ".concat(content);
-                        }).join('\n')];
-                });
-            });
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        function getSamplesForTemplate(template) {
-            return __awaiter(this, void 0, void 0, function () {
-                return __generator(this, function (_a) {
-                    // TODO: [♨] Implement Better - use real index and keyword search
-                    TODO_USE(template);
-                    return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: [♨] Implement */];
-                });
-            });
+        finally { if (e_1) throw e_1.error; }
+    }
+    var replacedTemplate = template;
+    var match;
+    var loopLimit = LOOP_LIMIT;
+    var _loop_1 = function () {
+        if (loopLimit-- < 0) {
+            throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
         }
-        function getReservedParametersForTemplate(template) {
-            return __awaiter(this, void 0, void 0, function () {
-                var context, knowledge, samples, currentDate, modelName, reservedParameters, _loop_3, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
-                var e_3, _a;
-                return __generator(this, function (_b) {
-                    switch (_b.label) {
-                        case 0: return [4 /*yield*/, getContextForTemplate(template)];
-                        case 1:
-                            context = _b.sent();
-                            return [4 /*yield*/, getKnowledgeForTemplate(template)];
-                        case 2:
-                            knowledge = _b.sent();
-                            return [4 /*yield*/, getSamplesForTemplate(template)];
-                        case 3:
-                            samples = _b.sent();
-                            currentDate = new Date().toISOString();
-                            modelName = RESERVED_PARAMETER_MISSING_VALUE;
-                            reservedParameters = {
-                                content: RESERVED_PARAMETER_RESTRICTED,
-                                context: context,
-                                knowledge: knowledge,
-                                samples: samples,
-                                currentDate: currentDate,
-                                modelName: modelName,
-                            };
-                            _loop_3 = function (parameterName) {
-                                if (reservedParameters[parameterName] === undefined) {
-                                    throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Reserved parameter {".concat(parameterName, "} is not defined\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
-                                }
-                            };
-                            try {
-                                // Note: Doublecheck that ALL reserved parameters are defined:
-                                for (RESERVED_PARAMETER_NAMES_1 = __values(RESERVED_PARAMETER_NAMES), RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next(); !RESERVED_PARAMETER_NAMES_1_1.done; RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next()) {
-                                    parameterName = RESERVED_PARAMETER_NAMES_1_1.value;
-                                    _loop_3(parameterName);
-                                }
-                            }
-                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                            finally {
-                                try {
-                                    if (RESERVED_PARAMETER_NAMES_1_1 && !RESERVED_PARAMETER_NAMES_1_1.done && (_a = RESERVED_PARAMETER_NAMES_1.return)) _a.call(RESERVED_PARAMETER_NAMES_1);
-                                }
-                                finally { if (e_3) throw e_3.error; }
-                            }
-                            return [2 /*return*/, reservedParameters];
-                    }
-                });
-            });
+        var precol = match.groups.precol;
+        var parameterName = match.groups.parameterName;
+        if (parameterName === '') {
+            return "continue";
+        }
+        if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+            throw new PipelineExecutionError('Parameter is already opened or not closed');
+        }
+        if (parameters[parameterName] === undefined) {
+            throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+        }
+        var parameterValue = parameters[parameterName];
+        if (parameterValue === undefined) {
+            throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+        }
+        parameterValue = parameterValue.toString();
+        if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+            parameterValue = parameterValue
+                .split('\n')
+                .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
+                .join('\n');
+        }
+        replacedTemplate =
+            replacedTemplate.substring(0, match.index + precol.length) +
+                parameterValue +
+                replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
+    };
+    while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+        .exec(replacedTemplate))) {
+        _loop_1();
+    }
+    // [💫] Check if there are parameters that are not closed properly
+    if (/{\w+$/.test(replacedTemplate)) {
+        throw new PipelineExecutionError('Parameter is not closed');
+    }
+    // [💫] Check if there are parameters that are not opened properly
+    if (/^\w+}/.test(replacedTemplate)) {
+        throw new PipelineExecutionError('Parameter is not opened');
+    }
+    return replacedTemplate;
+}
+
+/**
+ * Counts number of characters in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countCharacters(text) {
+    // Remove null characters
+    text = text.replace(/\0/g, '');
+    // Replace emojis (and also ZWJ sequence) with hyphens
+    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+    text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
+    return text.length;
+}
+
+/**
+ * Counts number of lines in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countLines(text) {
+    if (text === '') {
+        return 0;
+    }
+    return text.split('\n').length;
+}
+
+/**
+ * Counts number of pages in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countPages(text) {
+    var sentencesPerPage = 5; // Assuming each page has 5 sentences
+    var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+    var pageCount = Math.ceil(sentences.length / sentencesPerPage);
+    return pageCount;
+}
+
+/**
+ * Counts number of paragraphs in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countParagraphs(text) {
+    return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
+}
+
+/**
+ * Split text into sentences
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function splitIntoSentences(text) {
+    return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+}
+/**
+ * Counts number of sentences in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countSentences(text) {
+    return splitIntoSentences(text).length;
+}
+
+/**
+ * Counts number of words in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countWords(text) {
+    text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
+    text = removeDiacritics(text);
+    return text.split(/[^a-zа-я0-9]+/i).filter(function (word) { return word.length > 0; }).length;
+}
+
+/**
+ * Index of all counter functions
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var CountUtils = {
+    CHARACTERS: countCharacters,
+    WORDS: countWords,
+    SENTENCES: countSentences,
+    PARAGRAPHS: countParagraphs,
+    LINES: countLines,
+    PAGES: countPages,
+};
+/**
+ * TODO: [🧠][🤠] This should be probbably as part of `TextFormatDefinition`
+ */
+
+/**
+ * Function checkExpectations will check if the expectations on given value are met
+ *
+ * Note: There are two simmilar functions:
+ * - `checkExpectations` which throws an error if the expectations are not met
+ * - `isPassingExpectations` which returns a boolean
+ *
+ * @throws {ExpectError} if the expectations are not met
+ * @returns {void} Nothing
+ * @private internal function of `createPipelineExecutor`
+ */
+function checkExpectations(expectations, value) {
+    var e_1, _a;
+    try {
+        for (var _b = __values(Object.entries(expectations)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), unit = _d[0], _e = _d[1], max = _e.max, min = _e.min;
+            var amount = CountUtils[unit.toUpperCase()](value);
+            if (min && amount < min) {
+                throw new ExpectError("Expected at least ".concat(min, " ").concat(unit, " but got ").concat(amount));
+            } /* not else */
+            if (max && amount > max) {
+                throw new ExpectError("Expected at most ".concat(max, " ").concat(unit, " but got ").concat(amount));
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+}
+/**
+ * Function checkExpectations will check if the expectations on given value are met
+ *
+ * Note: There are two simmilar functions:
+ * - `checkExpectations` which throws an error if the expectations are not met
+ * - `isPassingExpectations` which returns a boolean
+ *
+ * @returns {boolean} True if the expectations are met
+ * @public exported from `@promptbook/core`
+ */
+function isPassingExpectations(expectations, value) {
+    try {
+        checkExpectations(expectations, value);
+        return true;
+    }
+    catch (error) {
+        if (!(error instanceof ExpectError)) {
+            throw error;
         }
-        function executeSingleTemplate(currentTemplate) {
-            return __awaiter(this, void 0, void 0, function () {
-                var name, title, priority, progress_1, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_4, _d, _e, parameterName, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokerParameterNames, preparedContent, _loop_5, attempt, state_2, progress_2;
-                var e_4, _f, _g;
-                return __generator(this, function (_h) {
-                    switch (_h.label) {
-                        case 0:
-                            name = "pipeline-executor-frame-".concat(currentTemplate.name);
-                            title = currentTemplate.title;
-                            priority = preparedPipeline.templates.length - preparedPipeline.templates.indexOf(currentTemplate);
-                            if (!(onProgress !== undefined) /* <- [3] */) return [3 /*break*/, 2]; /* <- [3] */
-                            progress_1 = {
-                                name: name,
-                                title: title,
-                                isStarted: false,
-                                isDone: false,
-                                templateType: currentTemplate.templateType,
-                                parameterName: currentTemplate.resultingParameterName,
-                                parameterValue: null,
-                                // <- [3]
-                            };
-                            if (isReturned) {
-                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Can not call `onProgress` after pipeline execution is finished \uD83C\uDF4F\n\n                                ".concat(block(pipelineIdentification), "\n\n                                ").concat(block(JSON.stringify(progress_1, null, 4)
-                                    .split('\n')
-                                    .map(function (line) { return "> ".concat(line); })
-                                    .join('\n')), "\n                            "); }));
-                            }
-                            return [4 /*yield*/, onProgress(progress_1)];
-                        case 1:
-                            _h.sent();
-                            _h.label = 2;
-                        case 2:
-                            usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
-                            dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
-                            if (union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)).size !== 0) {
-                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                            Dependent parameters are not consistent with used parameters:\n\n                            ".concat(block(pipelineIdentification), "\n\n                            Dependent parameters:\n                            ").concat(Array.from(dependentParameterNames)
-                                    .map(function (name) { return "{".concat(name, "}"); })
-                                    .join(', '), "\n\n                            Used parameters:\n                            ").concat(Array.from(usedParameterNames)
-                                    .map(function (name) { return "{".concat(name, "}"); })
-                                    .join(', '), "\n\n                        "); }));
-                            }
-                            _b = (_a = Object).freeze;
-                            _c = [{}];
-                            return [4 /*yield*/, getReservedParametersForTemplate(currentTemplate)];
-                        case 3:
-                            definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
-                            definedParameterNames = new Set(Object.keys(definedParameters));
-                            parameters = {};
-                            _loop_4 = function (parameterName) {
-                                // Situation: Parameter is defined and used
-                                if (definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
-                                    parameters[parameterName] = definedParameters[parameterName];
-                                }
-                                // Situation: Parameter is defined but NOT used
-                                else if (definedParameterNames.has(parameterName) && !usedParameterNames.has(parameterName)) ;
-                                // Situation: Parameter is NOT defined BUT used
-                                else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
-                                    // Houston, we have a problem
-                                    // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-                                    throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Parameter {".concat(parameterName, "} is NOT defined\n                                BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                                This should be catched in `validatePipeline`\n\n                                ").concat(block(pipelineIdentification), "\n\n                            "); }));
-                                }
-                            };
-                            try {
-                                // Note: [2] Check that all used parameters are defined and removing unused parameters for this template
-                                for (_d = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _e = _d.next(); !_e.done; _e = _d.next()) {
-                                    parameterName = _e.value;
-                                    _loop_4(parameterName);
-                                }
-                            }
-                            catch (e_4_1) { e_4 = { error: e_4_1 }; }
-                            finally {
-                                try {
-                                    if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
-                                }
-                                finally { if (e_4) throw e_4.error; }
-                            }
-                            // Note: Now we can freeze `parameters` because we are sure that all and only used parameters are defined
-                            Object.freeze(parameters);
-                            result = null;
-                            resultString = null;
-                            expectError = null;
-                            maxAttempts = currentTemplate.templateType === 'DIALOG_TEMPLATE' ? Infinity : maxExecutionAttempts;
-                            jokerParameterNames = currentTemplate.jokerParameterNames || [];
-                            preparedContent = (currentTemplate.preparedContent || '{content}')
-                                .split('{content}')
-                                .join(currentTemplate.content);
-                            _loop_5 = function (attempt) {
-                                var isJokerAttempt, jokerParameterName, _j, modelRequirements, _k, _l, _m, scriptTools, error_2, e_5_1, _o, _p, functionName, postprocessingError, _q, _r, scriptTools, error_3, e_6_1, e_7_1, error_4;
-                                var e_5, _s, e_7, _t, e_6, _u;
-                                return __generator(this, function (_v) {
-                                    switch (_v.label) {
-                                        case 0:
-                                            isJokerAttempt = attempt < 0;
-                                            jokerParameterName = jokerParameterNames[jokerParameterNames.length + attempt];
-                                            if (isJokerAttempt && !jokerParameterName) {
-                                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Joker not found in attempt ".concat(attempt, "\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
-                                            }
-                                            result = null;
-                                            resultString = null;
-                                            expectError = null;
-                                            if (isJokerAttempt) {
-                                                if (parameters[jokerParameterName] === undefined) {
-                                                    throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                    Joker parameter {".concat(jokerParameterName, "} not defined\n\n                                    ").concat(block(pipelineIdentification), "\n                                "); }));
-                                                    // <- TODO: This is maybe `PipelineLogicError` which should be detected in `validatePipeline` and here just thrown as `UnexpectedError`
-                                                }
-                                                else {
-                                                    resultString = parameters[jokerParameterName];
-                                                }
-                                            }
-                                            _v.label = 1;
-                                        case 1:
-                                            _v.trys.push([1, 44, 45, 46]);
-                                            if (!!isJokerAttempt) return [3 /*break*/, 26];
-                                            _j = currentTemplate.templateType;
-                                            switch (_j) {
-                                                case 'SIMPLE_TEMPLATE': return [3 /*break*/, 2];
-                                                case 'PROMPT_TEMPLATE': return [3 /*break*/, 3];
-                                                case 'SCRIPT_TEMPLATE': return [3 /*break*/, 12];
-                                                case 'DIALOG_TEMPLATE': return [3 /*break*/, 23];
-                                            }
-                                            return [3 /*break*/, 25];
-                                        case 2:
-                                            resultString = replaceParameters(preparedContent, parameters);
-                                            return [3 /*break*/, 26];
-                                        case 3:
-                                            modelRequirements = __assign(__assign({ modelVariant: 'CHAT' }, (pipeline.defaultModelRequirements || {})), (currentTemplate.modelRequirements || {}));
-                                            prompt = {
-                                                title: currentTemplate.title,
-                                                pipelineUrl: "".concat(preparedPipeline.pipelineUrl
-                                                    ? preparedPipeline.pipelineUrl
-                                                    : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous pipelines, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
-                                                parameters: parameters,
-                                                content: preparedContent,
-                                                modelRequirements: modelRequirements,
-                                                expectations: __assign(__assign({}, (preparedPipeline.personas.find(function (_a) {
-                                                    var name = _a.name;
-                                                    return name === currentTemplate.personaName;
-                                                }) || {})), currentTemplate.expectations),
-                                                format: currentTemplate.format,
-                                                postprocessingFunctionNames: currentTemplate.postprocessingFunctionNames,
-                                            }; // <- TODO: Not very good type guard
-                                            _k = modelRequirements.modelVariant;
-                                            switch (_k) {
-                                                case 'CHAT': return [3 /*break*/, 4];
-                                                case 'COMPLETION': return [3 /*break*/, 6];
-                                                case 'EMBEDDING': return [3 /*break*/, 8];
-                                            }
-                                            return [3 /*break*/, 10];
-                                        case 4: return [4 /*yield*/, llmTools.callChatModel($deepFreeze(prompt))];
-                                        case 5:
-                                            chatResult = _v.sent();
-                                            // TODO: [🍬] Destroy chatThread
-                                            result = chatResult;
-                                            resultString = chatResult.content;
-                                            return [3 /*break*/, 11];
-                                        case 6: return [4 /*yield*/, llmTools.callCompletionModel($deepFreeze(prompt))];
-                                        case 7:
-                                            completionResult = _v.sent();
-                                            result = completionResult;
-                                            resultString = completionResult.content;
-                                            return [3 /*break*/, 11];
-                                        case 8: return [4 /*yield*/, llmTools.callEmbeddingModel($deepFreeze(prompt))];
-                                        case 9:
-                                            embeddingResult = _v.sent();
-                                            result = embeddingResult;
-                                            resultString = embeddingResult.content.join(',');
-                                            return [3 /*break*/, 11];
-                                        case 10: throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                                        Unknown model variant \"".concat(currentTemplate.modelRequirements
-                                            .modelVariant, "\"\n\n                                                        ").concat(block(pipelineIdentification), "\n\n                                                    "); }));
-                                        case 11: return [3 /*break*/, 26];
-                                        case 12:
-                                            if (arrayableToArray(tools.script).length === 0) {
-                                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                                No script execution tools are available\n\n                                                ".concat(block(pipelineIdentification), "\n                                            "); }));
-                                            }
-                                            if (!currentTemplate.contentLanguage) {
-                                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                                Script language is not defined for SCRIPT TEMPLATE \"".concat(currentTemplate.name, "\"\n\n                                                ").concat(block(pipelineIdentification), "\n                                            "); }));
-                                            }
-                                            // TODO: DRY [1]
-                                            scriptPipelineExecutionErrors = [];
-                                            _v.label = 13;
-                                        case 13:
-                                            _v.trys.push([13, 20, 21, 22]);
-                                            _l = (e_5 = void 0, __values(arrayableToArray(tools.script))), _m = _l.next();
-                                            _v.label = 14;
-                                        case 14:
-                                            if (!!_m.done) return [3 /*break*/, 19];
-                                            scriptTools = _m.value;
-                                            _v.label = 15;
-                                        case 15:
-                                            _v.trys.push([15, 17, , 18]);
-                                            return [4 /*yield*/, scriptTools.execute($deepFreeze({
-                                                    scriptLanguage: currentTemplate.contentLanguage,
-                                                    script: preparedContent,
-                                                    parameters: parameters,
-                                                }))];
-                                        case 16:
-                                            resultString = _v.sent();
-                                            return [3 /*break*/, 19];
-                                        case 17:
-                                            error_2 = _v.sent();
-                                            if (!(error_2 instanceof Error)) {
-                                                throw error_2;
-                                            }
-                                            if (error_2 instanceof UnexpectedError) {
-                                                throw error_2;
-                                            }
-                                            scriptPipelineExecutionErrors.push(error_2);
-                                            return [3 /*break*/, 18];
-                                        case 18:
-                                            _m = _l.next();
-                                            return [3 /*break*/, 14];
-                                        case 19: return [3 /*break*/, 22];
-                                        case 20:
-                                            e_5_1 = _v.sent();
-                                            e_5 = { error: e_5_1 };
-                                            return [3 /*break*/, 22];
-                                        case 21:
-                                            try {
-                                                if (_m && !_m.done && (_s = _l.return)) _s.call(_l);
-                                            }
-                                            finally { if (e_5) throw e_5.error; }
-                                            return [7 /*endfinally*/];
-                                        case 22:
-                                            if (resultString !== null) {
-                                                return [3 /*break*/, 26];
-                                            }
-                                            if (scriptPipelineExecutionErrors.length === 1) {
-                                                throw scriptPipelineExecutionErrors[0];
-                                            }
-                                            else {
-                                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                              Script execution failed ".concat(scriptPipelineExecutionErrors.length, " times\n\n                                              ").concat(block(pipelineIdentification), "\n\n                                              ").concat(block(scriptPipelineExecutionErrors
-                                                    .map(function (error) { return '- ' + error.message; })
-                                                    .join('\n\n')), "\n                                          "); }));
-                                            }
-                                        case 23:
-                                            if (tools.userInterface === undefined) {
-                                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                                User interface tools are not available\n\n                                                ".concat(block(pipelineIdentification), "\n                                            "); }));
-                                            }
-                                            return [4 /*yield*/, tools.userInterface.promptDialog($deepFreeze({
-                                                    promptTitle: currentTemplate.title,
-                                                    promptMessage: replaceParameters(currentTemplate.description || '', parameters),
-                                                    defaultValue: replaceParameters(preparedContent, parameters),
-                                                    // TODO: [🧠] !! Figure out how to define placeholder in .ptbk.md file
-                                                    placeholder: undefined,
-                                                    priority: priority,
-                                                }))];
-                                        case 24:
-                                            // TODO: [🌹] When making next attempt for `DIALOG TEMPLATE`, preserve the previous user input
-                                            resultString = _v.sent();
-                                            return [3 /*break*/, 26];
-                                        case 25: throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                            Unknown execution type \"".concat(currentTemplate.templateType, "\"\n\n                                            ").concat(block(pipelineIdentification), "\n                                        "); }));
-                                        case 26:
-                                            if (!(!isJokerAttempt && currentTemplate.postprocessingFunctionNames)) return [3 /*break*/, 43];
-                                            _v.label = 27;
-                                        case 27:
-                                            _v.trys.push([27, 41, 42, 43]);
-                                            _o = (e_7 = void 0, __values(currentTemplate.postprocessingFunctionNames)), _p = _o.next();
-                                            _v.label = 28;
-                                        case 28:
-                                            if (!!_p.done) return [3 /*break*/, 40];
-                                            functionName = _p.value;
-                                            // TODO: DRY [1]
-                                            scriptPipelineExecutionErrors = [];
-                                            postprocessingError = null;
-                                            _v.label = 29;
-                                        case 29:
-                                            _v.trys.push([29, 36, 37, 38]);
-                                            _q = (e_6 = void 0, __values(arrayableToArray(tools.script))), _r = _q.next();
-                                            _v.label = 30;
-                                        case 30:
-                                            if (!!_r.done) return [3 /*break*/, 35];
-                                            scriptTools = _r.value;
-                                            _v.label = 31;
-                                        case 31:
-                                            _v.trys.push([31, 33, , 34]);
-                                            return [4 /*yield*/, scriptTools.execute({
-                                                    scriptLanguage: "javascript" /* <- TODO: Try it in each languages; In future allow postprocessing with arbitrary combination of languages to combine */,
-                                                    script: "".concat(functionName, "(resultString)"),
-                                                    parameters: {
-                                                        resultString: resultString || '',
-                                                        // Note: No ...parametersForTemplate, because working with result only
-                                                    },
-                                                })];
-                                        case 32:
-                                            resultString = _v.sent();
-                                            postprocessingError = null;
-                                            return [3 /*break*/, 35];
-                                        case 33:
-                                            error_3 = _v.sent();
-                                            if (!(error_3 instanceof Error)) {
-                                                throw error_3;
-                                            }
-                                            if (error_3 instanceof UnexpectedError) {
-                                                throw error_3;
-                                            }
-                                            postprocessingError = error_3;
-                                            scriptPipelineExecutionErrors.push(error_3);
-                                            return [3 /*break*/, 34];
-                                        case 34:
-                                            _r = _q.next();
-                                            return [3 /*break*/, 30];
-                                        case 35: return [3 /*break*/, 38];
-                                        case 36:
-                                            e_6_1 = _v.sent();
-                                            e_6 = { error: e_6_1 };
-                                            return [3 /*break*/, 38];
-                                        case 37:
-                                            try {
-                                                if (_r && !_r.done && (_u = _q.return)) _u.call(_q);
-                                            }
-                                            finally { if (e_6) throw e_6.error; }
-                                            return [7 /*endfinally*/];
-                                        case 38:
-                                            if (postprocessingError) {
-                                                throw postprocessingError;
-                                            }
-                                            _v.label = 39;
-                                        case 39:
-                                            _p = _o.next();
-                                            return [3 /*break*/, 28];
-                                        case 40: return [3 /*break*/, 43];
-                                        case 41:
-                                            e_7_1 = _v.sent();
-                                            e_7 = { error: e_7_1 };
-                                            return [3 /*break*/, 43];
-                                        case 42:
-                                            try {
-                                                if (_p && !_p.done && (_t = _o.return)) _t.call(_o);
-                                            }
-                                            finally { if (e_7) throw e_7.error; }
-                                            return [7 /*endfinally*/];
-                                        case 43:
-                                            // TODO: [💝] Unite object for expecting amount and format
-                                            if (currentTemplate.format) {
-                                                if (currentTemplate.format === 'JSON') {
-                                                    if (!isValidJsonString(resultString || '')) {
-                                                        // TODO: [🏢] Do more universally via `FormatDefinition`
-                                                        try {
-                                                            resultString = extractJsonBlock(resultString || '');
-                                                        }
-                                                        catch (error) {
-                                                            keepUnused(error);
-                                                            throw new ExpectError(spaceTrim$1(function (block) { return "\n                                                Expected valid JSON string\n\n                                                ".concat(block(
-                                                            /*<- Note: No need for `pipelineIdentification`, it will be catched and added later */ ''), "\n                                            "); }));
-                                                        }
-                                                    }
+        return false;
+    }
+}
+/**
+ * TODO: [💝] Unite object for expecting amount and format
+ * TODO: [🧠][🤠] This should be part of `TextFormatDefinition`
+ * Note: [💝] and [🤠] are interconnected together
+ */
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function executeAttempts(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var jokerParameterNames, priority, maxAttempts, preparedContent, parameters, template, preparedPipeline, tools, llmTools, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, $ongoingTemplateResult, _loop_1, attempt, state_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    jokerParameterNames = options.jokerParameterNames, priority = options.priority, maxAttempts = options.maxAttempts, preparedContent = options.preparedContent, parameters = options.parameters, template = options.template, preparedPipeline = options.preparedPipeline, tools = options.tools, llmTools = options.llmTools, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
+                    maxExecutionAttempts = settings.maxExecutionAttempts;
+                    $ongoingTemplateResult = {
+                        $result: null,
+                        $resultString: null,
+                        $expectError: null,
+                        $scriptPipelineExecutionErrors: [],
+                    };
+                    _loop_1 = function (attempt) {
+                        var isJokerAttempt, jokerParameterName, _b, modelRequirements, _c, _d, _e, _f, _g, _h, scriptTools, _j, error_1, e_1_1, _k, _l, _m, functionName, postprocessingError, _o, _p, scriptTools, _q, error_2, e_2_1, e_3_1, error_3;
+                        var e_1, _r, e_3, _s, e_2, _t;
+                        return __generator(this, function (_u) {
+                            switch (_u.label) {
+                                case 0:
+                                    isJokerAttempt = attempt < 0;
+                                    jokerParameterName = jokerParameterNames[jokerParameterNames.length + attempt];
+                                    // TODO: [🧠] !!!!!! JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
+                                    if (isJokerAttempt && !jokerParameterName) {
+                                        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                      Joker not found in attempt ".concat(attempt, "\n\n                      ").concat(block(pipelineIdentification), "\n                  "); }));
+                                    }
+                                    $ongoingTemplateResult.$result = null;
+                                    $ongoingTemplateResult.$resultString = null;
+                                    $ongoingTemplateResult.$expectError = null;
+                                    if (isJokerAttempt) {
+                                        if (parameters[jokerParameterName] === undefined) {
+                                            throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                          Joker parameter {".concat(jokerParameterName, "} not defined\n\n                          ").concat(block(pipelineIdentification), "\n                      "); }));
+                                            // <- TODO: This is maybe `PipelineLogicError` which should be detected in `validatePipeline` and here just thrown as `UnexpectedError`
+                                        }
+                                        else {
+                                            $ongoingTemplateResult.$resultString = parameters[jokerParameterName];
+                                        }
+                                    }
+                                    _u.label = 1;
+                                case 1:
+                                    _u.trys.push([1, 44, 45, 46]);
+                                    if (!!isJokerAttempt) return [3 /*break*/, 26];
+                                    _b = template.templateType;
+                                    switch (_b) {
+                                        case 'SIMPLE_TEMPLATE': return [3 /*break*/, 2];
+                                        case 'PROMPT_TEMPLATE': return [3 /*break*/, 3];
+                                        case 'SCRIPT_TEMPLATE': return [3 /*break*/, 12];
+                                        case 'DIALOG_TEMPLATE': return [3 /*break*/, 23];
+                                    }
+                                    return [3 /*break*/, 25];
+                                case 2:
+                                    $ongoingTemplateResult.$resultString = replaceParameters(preparedContent, parameters);
+                                    return [3 /*break*/, 26];
+                                case 3:
+                                    modelRequirements = __assign(__assign({ modelVariant: 'CHAT' }, (preparedPipeline.defaultModelRequirements || {})), (template.modelRequirements || {}));
+                                    $ongoingTemplateResult.$prompt = {
+                                        title: template.title,
+                                        pipelineUrl: "".concat(preparedPipeline.pipelineUrl
+                                            ? preparedPipeline.pipelineUrl
+                                            : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous pipelines, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(template.name),
+                                        parameters: parameters,
+                                        content: preparedContent,
+                                        modelRequirements: modelRequirements,
+                                        expectations: __assign(__assign({}, (preparedPipeline.personas.find(function (_a) {
+                                            var name = _a.name;
+                                            return name === template.personaName;
+                                        }) ||
+                                            {})), template.expectations),
+                                        format: template.format,
+                                        postprocessingFunctionNames: template.postprocessingFunctionNames,
+                                    }; // <- TODO: Not very good type guard
+                                    _c = modelRequirements.modelVariant;
+                                    switch (_c) {
+                                        case 'CHAT': return [3 /*break*/, 4];
+                                        case 'COMPLETION': return [3 /*break*/, 6];
+                                        case 'EMBEDDING': return [3 /*break*/, 8];
+                                    }
+                                    return [3 /*break*/, 10];
+                                case 4:
+                                    _d = $ongoingTemplateResult;
+                                    return [4 /*yield*/, llmTools.callChatModel($deepFreeze($ongoingTemplateResult.$prompt))];
+                                case 5:
+                                    _d.$chatResult = _u.sent();
+                                    // TODO: [🍬] Destroy chatThread
+                                    $ongoingTemplateResult.$result = $ongoingTemplateResult.$chatResult;
+                                    $ongoingTemplateResult.$resultString = $ongoingTemplateResult.$chatResult.content;
+                                    return [3 /*break*/, 11];
+                                case 6:
+                                    _e = $ongoingTemplateResult;
+                                    return [4 /*yield*/, llmTools.callCompletionModel($deepFreeze($ongoingTemplateResult.$prompt))];
+                                case 7:
+                                    _e.$completionResult = _u.sent();
+                                    $ongoingTemplateResult.$result = $ongoingTemplateResult.$completionResult;
+                                    $ongoingTemplateResult.$resultString =
+                                        $ongoingTemplateResult.$completionResult.content;
+                                    return [3 /*break*/, 11];
+                                case 8:
+                                    // TODO: [🧠] This is weird, embedding model can not be used such a way in the pipeline
+                                    _f = $ongoingTemplateResult;
+                                    return [4 /*yield*/, llmTools.callEmbeddingModel($deepFreeze($ongoingTemplateResult.$prompt))];
+                                case 9:
+                                    // TODO: [🧠] This is weird, embedding model can not be used such a way in the pipeline
+                                    _f.$embeddingResult = _u.sent();
+                                    $ongoingTemplateResult.$result = $ongoingTemplateResult.$embeddingResult;
+                                    $ongoingTemplateResult.$resultString =
+                                        $ongoingTemplateResult.$embeddingResult.content.join(',');
+                                    return [3 /*break*/, 11];
+                                case 10: throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                              Unknown model variant \"".concat(template.modelRequirements.modelVariant, "\"\n\n                                              ").concat(block(pipelineIdentification), "\n\n                                          "); }));
+                                case 11: return [3 /*break*/, 26];
+                                case 12:
+                                    if (arrayableToArray(tools.script).length === 0) {
+                                        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                      No script execution tools are available\n\n                                      ".concat(block(pipelineIdentification), "\n                                  "); }));
+                                    }
+                                    if (!template.contentLanguage) {
+                                        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                      Script language is not defined for SCRIPT TEMPLATE \"".concat(template.name, "\"\n\n                                      ").concat(block(pipelineIdentification), "\n                                  "); }));
+                                    }
+                                    _u.label = 13;
+                                case 13:
+                                    _u.trys.push([13, 20, 21, 22]);
+                                    _g = (e_1 = void 0, __values(arrayableToArray(tools.script))), _h = _g.next();
+                                    _u.label = 14;
+                                case 14:
+                                    if (!!_h.done) return [3 /*break*/, 19];
+                                    scriptTools = _h.value;
+                                    _u.label = 15;
+                                case 15:
+                                    _u.trys.push([15, 17, , 18]);
+                                    _j = $ongoingTemplateResult;
+                                    return [4 /*yield*/, scriptTools.execute($deepFreeze({
+                                            scriptLanguage: template.contentLanguage,
+                                            script: preparedContent,
+                                            parameters: parameters,
+                                        }))];
+                                case 16:
+                                    _j.$resultString = _u.sent();
+                                    return [3 /*break*/, 19];
+                                case 17:
+                                    error_1 = _u.sent();
+                                    if (!(error_1 instanceof Error)) {
+                                        throw error_1;
+                                    }
+                                    if (error_1 instanceof UnexpectedError) {
+                                        throw error_1;
+                                    }
+                                    $ongoingTemplateResult.$scriptPipelineExecutionErrors.push(error_1);
+                                    return [3 /*break*/, 18];
+                                case 18:
+                                    _h = _g.next();
+                                    return [3 /*break*/, 14];
+                                case 19: return [3 /*break*/, 22];
+                                case 20:
+                                    e_1_1 = _u.sent();
+                                    e_1 = { error: e_1_1 };
+                                    return [3 /*break*/, 22];
+                                case 21:
+                                    try {
+                                        if (_h && !_h.done && (_r = _g.return)) _r.call(_g);
+                                    }
+                                    finally { if (e_1) throw e_1.error; }
+                                    return [7 /*endfinally*/];
+                                case 22:
+                                    if ($ongoingTemplateResult.$resultString !== null) {
+                                        return [3 /*break*/, 26];
+                                    }
+                                    if ($ongoingTemplateResult.$scriptPipelineExecutionErrors.length === 1) {
+                                        throw $ongoingTemplateResult.$scriptPipelineExecutionErrors[0];
+                                    }
+                                    else {
+                                        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                      Script execution failed ".concat($ongoingTemplateResult.$scriptPipelineExecutionErrors.length, "x\n\n                                      ").concat(block(pipelineIdentification), "\n\n                                      ").concat(block($ongoingTemplateResult.$scriptPipelineExecutionErrors
+                                            .map(function (error) { return '- ' + error.message; })
+                                            .join('\n\n')), "\n                                  "); }));
+                                    }
+                                case 23:
+                                    if (tools.userInterface === undefined) {
+                                        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                      User interface tools are not available\n\n                                      ".concat(block(pipelineIdentification), "\n                                  "); }));
+                                    }
+                                    // TODO: [🌹] When making next attempt for `DIALOG TEMPLATE`, preserve the previous user input
+                                    _k = $ongoingTemplateResult;
+                                    return [4 /*yield*/, tools.userInterface.promptDialog($deepFreeze({
+                                            promptTitle: template.title,
+                                            promptMessage: replaceParameters(template.description || '', parameters),
+                                            defaultValue: replaceParameters(preparedContent, parameters),
+                                            // TODO: [🧠] !! Figure out how to define placeholder in .ptbk.md file
+                                            placeholder: undefined,
+                                            priority: priority,
+                                        }))];
+                                case 24:
+                                    // TODO: [🌹] When making next attempt for `DIALOG TEMPLATE`, preserve the previous user input
+                                    _k.$resultString = _u.sent();
+                                    return [3 /*break*/, 26];
+                                case 25: throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                  Unknown execution type \"".concat(template.templateType, "\"\n\n                                  ").concat(block(pipelineIdentification), "\n                              "); }));
+                                case 26:
+                                    if (!(!isJokerAttempt && template.postprocessingFunctionNames)) return [3 /*break*/, 43];
+                                    _u.label = 27;
+                                case 27:
+                                    _u.trys.push([27, 41, 42, 43]);
+                                    _l = (e_3 = void 0, __values(template.postprocessingFunctionNames)), _m = _l.next();
+                                    _u.label = 28;
+                                case 28:
+                                    if (!!_m.done) return [3 /*break*/, 40];
+                                    functionName = _m.value;
+                                    postprocessingError = null;
+                                    _u.label = 29;
+                                case 29:
+                                    _u.trys.push([29, 36, 37, 38]);
+                                    _o = (e_2 = void 0, __values(arrayableToArray(tools.script))), _p = _o.next();
+                                    _u.label = 30;
+                                case 30:
+                                    if (!!_p.done) return [3 /*break*/, 35];
+                                    scriptTools = _p.value;
+                                    _u.label = 31;
+                                case 31:
+                                    _u.trys.push([31, 33, , 34]);
+                                    _q = $ongoingTemplateResult;
+                                    return [4 /*yield*/, scriptTools.execute({
+                                            scriptLanguage: "javascript" /* <- TODO: Try it in each languages; In future allow postprocessing with arbitrary combination of languages to combine */,
+                                            script: "".concat(functionName, "(resultString)"),
+                                            parameters: {
+                                                resultString: $ongoingTemplateResult.$resultString || '',
+                                                // Note: No ...parametersForTemplate, because working with result only
+                                            },
+                                        })];
+                                case 32:
+                                    _q.$resultString = _u.sent();
+                                    postprocessingError = null;
+                                    return [3 /*break*/, 35];
+                                case 33:
+                                    error_2 = _u.sent();
+                                    if (!(error_2 instanceof Error)) {
+                                        throw error_2;
+                                    }
+                                    if (error_2 instanceof UnexpectedError) {
+                                        throw error_2;
+                                    }
+                                    postprocessingError = error_2;
+                                    $ongoingTemplateResult.$scriptPipelineExecutionErrors.push(error_2);
+                                    return [3 /*break*/, 34];
+                                case 34:
+                                    _p = _o.next();
+                                    return [3 /*break*/, 30];
+                                case 35: return [3 /*break*/, 38];
+                                case 36:
+                                    e_2_1 = _u.sent();
+                                    e_2 = { error: e_2_1 };
+                                    return [3 /*break*/, 38];
+                                case 37:
+                                    try {
+                                        if (_p && !_p.done && (_t = _o.return)) _t.call(_o);
+                                    }
+                                    finally { if (e_2) throw e_2.error; }
+                                    return [7 /*endfinally*/];
+                                case 38:
+                                    if (postprocessingError) {
+                                        throw postprocessingError;
+                                    }
+                                    _u.label = 39;
+                                case 39:
+                                    _m = _l.next();
+                                    return [3 /*break*/, 28];
+                                case 40: return [3 /*break*/, 43];
+                                case 41:
+                                    e_3_1 = _u.sent();
+                                    e_3 = { error: e_3_1 };
+                                    return [3 /*break*/, 43];
+                                case 42:
+                                    try {
+                                        if (_m && !_m.done && (_s = _l.return)) _s.call(_l);
+                                    }
+                                    finally { if (e_3) throw e_3.error; }
+                                    return [7 /*endfinally*/];
+                                case 43:
+                                    // TODO: [💝] Unite object for expecting amount and format
+                                    if (template.format) {
+                                        if (template.format === 'JSON') {
+                                            if (!isValidJsonString($ongoingTemplateResult.$resultString || '')) {
+                                                // TODO: [🏢] Do more universally via `FormatDefinition`
+                                                try {
+                                                    $ongoingTemplateResult.$resultString = extractJsonBlock($ongoingTemplateResult.$resultString || '');
                                                 }
-                                                else {
-                                                    throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                        Unknown format \"".concat(currentTemplate.format, "\"\n\n                                        ").concat(block(pipelineIdentification), "\n                                    "); }));
+                                                catch (error) {
+                                                    keepUnused(error);
+                                                    throw new ExpectError(spaceTrim$1(function (block) { return "\n                                      Expected valid JSON string\n\n                                      ".concat(block(
+                                                    /*<- Note: No need for `pipelineIdentification`, it will be catched and added later */ ''), "\n                                  "); }));
                                                 }
                                             }
-                                            // TODO: [💝] Unite object for expecting amount and format
-                                            if (currentTemplate.expectations) {
-                                                checkExpectations(currentTemplate.expectations, resultString || '');
-                                            }
-                                            return [2 /*return*/, "break-attempts"];
-                                        case 44:
-                                            error_4 = _v.sent();
-                                            if (!(error_4 instanceof ExpectError)) {
-                                                throw error_4;
-                                            }
-                                            expectError = error_4;
-                                            return [3 /*break*/, 46];
-                                        case 45:
-                                            if (!isJokerAttempt &&
-                                                currentTemplate.templateType === 'PROMPT_TEMPLATE' &&
-                                                prompt
-                                            //    <- Note:  [2] When some expected parameter is not defined, error will occur in replaceParameters
-                                            //              In that case we don’t want to make a report about it because it’s not a llm execution error
-                                            ) {
-                                                // TODO: [🧠] Maybe put other templateTypes into report
-                                                executionReport.promptExecutions.push({
-                                                    prompt: __assign({}, prompt),
-                                                    result: result || undefined,
-                                                    error: expectError === null ? undefined : serializeError(expectError),
-                                                });
-                                            }
-                                            return [7 /*endfinally*/];
-                                        case 46:
-                                            if (expectError !== null && attempt === maxAttempts - 1) {
-                                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ").concat(block(pipelineIdentification), "\n\n                              ---\n                              The Prompt:\n                              ").concat(block(prompt.content
-                                                    .split('\n')
-                                                    .map(function (line) { return "> ".concat(line); })
-                                                    .join('\n')), "\n\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block(((expectError === null || expectError === void 0 ? void 0 : expectError.message) || '')
+                                        }
+                                        else {
+                                            throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                              Unknown format \"".concat(template.format, "\"\n\n                              ").concat(block(pipelineIdentification), "\n                          "); }));
+                                        }
+                                    }
+                                    // TODO: [💝] Unite object for expecting amount and format
+                                    if (template.expectations) {
+                                        checkExpectations(template.expectations, $ongoingTemplateResult.$resultString || '');
+                                    }
+                                    return [2 /*return*/, "break-attempts"];
+                                case 44:
+                                    error_3 = _u.sent();
+                                    if (!(error_3 instanceof ExpectError)) {
+                                        throw error_3;
+                                    }
+                                    $ongoingTemplateResult.$expectError = error_3;
+                                    return [3 /*break*/, 46];
+                                case 45:
+                                    if (!isJokerAttempt &&
+                                        template.templateType === 'PROMPT_TEMPLATE' &&
+                                        $ongoingTemplateResult.$prompt
+                                    //    <- Note:  [2] When some expected parameter is not defined, error will occur in replaceParameters
+                                    //              In that case we don’t want to make a report about it because it’s not a llm execution error
+                                    ) {
+                                        // TODO: [🧠] Maybe put other templateTypes into report
+                                        $executionReport.promptExecutions.push({
+                                            prompt: __assign({}, $ongoingTemplateResult.$prompt),
+                                            result: $ongoingTemplateResult.$result || undefined,
+                                            error: $ongoingTemplateResult.$expectError === null
+                                                ? undefined
+                                                : serializeError($ongoingTemplateResult.$expectError),
+                                        });
+                                    }
+                                    return [7 /*endfinally*/];
+                                case 46:
+                                    if ($ongoingTemplateResult.$expectError !== null && attempt === maxAttempts - 1) {
+                                        throw new PipelineExecutionError(spaceTrim$1(function (block) {
+                                            var _a, _b, _c;
+                                            return "\n                      LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                      ").concat(block(pipelineIdentification), "\n\n                      ---\n                      The Prompt:\n                      ").concat(block((((_a = $ongoingTemplateResult.$prompt) === null || _a === void 0 ? void 0 : _a.content) || '')
+                                                .split('\n')
+                                                .map(function (line) { return "> ".concat(line); })
+                                                .join('\n')), "\n\n                      Last error ").concat(((_b = $ongoingTemplateResult.$expectError) === null || _b === void 0 ? void 0 : _b.name) || '', ":\n                      ").concat(block((((_c = $ongoingTemplateResult.$expectError) === null || _c === void 0 ? void 0 : _c.message) || '')
+                                                .split('\n')
+                                                .map(function (line) { return "> ".concat(line); })
+                                                .join('\n')), "\n\n                      Last result:\n                      ").concat(block($ongoingTemplateResult.$resultString === null
+                                                ? 'null'
+                                                : $ongoingTemplateResult.$resultString
                                                     .split('\n')
                                                     .map(function (line) { return "> ".concat(line); })
-                                                    .join('\n')), "\n\n                              Last result:\n                              ").concat(block(resultString === null
-                                                    ? 'null'
-                                                    : resultString
-                                                        .split('\n')
-                                                        .map(function (line) { return "> ".concat(line); })
-                                                        .join('\n')), "\n                              ---\n                          "); }));
-                                            }
-                                            return [2 /*return*/];
+                                                    .join('\n')), "\n                      ---\n                  ");
+                                        }));
                                     }
-                                });
-                            };
-                            attempt = -jokerParameterNames.length;
-                            _h.label = 4;
-                        case 4:
-                            if (!(attempt < maxAttempts)) return [3 /*break*/, 7];
-                            return [5 /*yield**/, _loop_5(attempt)];
-                        case 5:
-                            state_2 = _h.sent();
-                            switch (state_2) {
-                                case "break-attempts": return [3 /*break*/, 7];
-                            }
-                            _h.label = 6;
-                        case 6:
-                            attempt++;
-                            return [3 /*break*/, 4];
-                        case 7:
-                            if (resultString === null) {
-                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                            Something went wrong and prompt result is null\n\n                            ".concat(block(pipelineIdentification), "\n                        "); }));
+                                    return [2 /*return*/];
                             }
-                            if (!(onProgress !== undefined) /* <- [3] */) return [3 /*break*/, 9]; /* <- [3] */
-                            progress_2 = {
-                                name: name,
-                                title: title,
-                                isStarted: true,
-                                isDone: true,
-                                templateType: currentTemplate.templateType,
-                                parameterName: currentTemplate.resultingParameterName,
-                                parameterValue: resultString,
-                                // <- [3]
-                            };
-                            if (isReturned) {
-                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Can not call `onProgress` after pipeline execution is finished \uD83C\uDF4E\n\n                                ".concat(block(pipelineIdentification), "\n\n                                ").concat(block(JSON.stringify(progress_2, null, 4)
-                                    .split('\n')
-                                    .map(function (line) { return "> ".concat(line); })
-                                    .join('\n')), "\n\n                            "); }));
-                            }
-                            return [4 /*yield*/, onProgress(progress_2)];
-                        case 8:
-                            _h.sent();
-                            _h.label = 9;
-                        case 9:
-                            parametersToPass = Object.freeze(__assign(__assign({}, parametersToPass), (_g = {}, _g[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because pipeline checks logic consistency during construction */, _g)));
-                            return [2 /*return*/];
+                        });
+                    };
+                    attempt = -jokerParameterNames.length;
+                    _a.label = 1;
+                case 1:
+                    if (!(attempt < maxAttempts)) return [3 /*break*/, 4];
+                    return [5 /*yield**/, _loop_1(attempt)];
+                case 2:
+                    state_1 = _a.sent();
+                    switch (state_1) {
+                        case "break-attempts": return [3 /*break*/, 4];
                     }
-                });
-            });
+                    _a.label = 3;
+                case 3:
+                    attempt++;
+                    return [3 /*break*/, 1];
+                case 4:
+                    if ($ongoingTemplateResult.$resultString === null) {
+                        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                  Something went wrong and prompt result is null\n\n                  ".concat(block(pipelineIdentification), "\n              "); }));
+                    }
+                    return [2 /*return*/, $ongoingTemplateResult.$resultString];
+            }
+        });
+    });
+}
+/**
+ * TODO: Break into smaller functions
+ */
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function executeFormatCells(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var template, jokerParameterNames, parameters, priority, pipelineIdentification, parameterValue, formatDefinition, subvalueDefinition, resultString;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    template = options.template, jokerParameterNames = options.jokerParameterNames, parameters = options.parameters, priority = options.priority, pipelineIdentification = options.pipelineIdentification;
+                    if (template.foreach === undefined) {
+                        return [2 /*return*/, /* not await */ executeAttempts(options)];
+                    }
+                    if (jokerParameterNames.length !== 0) {
+                        throw new UnexpectedError(spaceTrim(function (block) { return "\n                    JOKER parameters are not supported together with FOREACH command\n\n                    [\uD83E\uDDDE\u200D\u2640\uFE0F] This should be prevented in `validatePipeline`\n\n                    ".concat(block(pipelineIdentification), "\n                "); }));
+                    }
+                    parameterValue = parameters[template.foreach.parameterName] || '';
+                    formatDefinition = FORMAT_DEFINITIONS.find(function (formatDefinition) {
+                        return __spreadArray([formatDefinition.formatName], __read((formatDefinition.aliases || [])), false).includes(template.foreach.formatName);
+                    });
+                    if (formatDefinition === undefined) {
+                        throw new UnexpectedError(
+                        // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
+                        spaceTrim(function (block) { return "\n                    Unsupported format \"".concat(template.foreach.formatName, "\"\n\n                    Available formats:\n                    ").concat(block(FORMAT_DEFINITIONS.map(function (formatDefinition) { return formatDefinition.formatName; })
+                            .map(function (formatName) { return "- ".concat(formatName); })
+                            .join('\n')), "\n\n                    [\u26F7] This should never happen because format name should be validated during parsing\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+                    }
+                    subvalueDefinition = formatDefinition.subvalueDefinitions.find(function (subvalueDefinition) {
+                        return __spreadArray([subvalueDefinition.subvalueName], __read((subvalueDefinition.aliases || [])), false).includes(template.foreach.cellName);
+                    });
+                    if (subvalueDefinition === undefined) {
+                        throw new UnexpectedError(
+                        // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
+                        spaceTrim(function (block) { return "\n                    Unsupported cell name \"".concat(template.foreach.cellName, "\" for format \"").concat(template.foreach.formatName, "\"\n\n                    Available cell names for format \"").concat(formatDefinition.formatName, "\":\n                    ").concat(block(formatDefinition.subvalueDefinitions
+                            .map(function (subvalueDefinition) { return subvalueDefinition.subvalueName; })
+                            .map(function (subvalueName) { return "- ".concat(subvalueName); })
+                            .join('\n')), "\n\n                    [\u26F7] This should never happen because cell name should be validated during parsing\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+                    }
+                    return [4 /*yield*/, subvalueDefinition.mapValues(parameterValue, function (subparameters, index) { return __awaiter(_this, void 0, void 0, function () {
+                            var mappedParameters, allSubparameters, subresultString;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0:
+                                        try {
+                                            mappedParameters = mapAvailableToExpectedParameters({
+                                                expectedParameters: Object.fromEntries(template.foreach.subparameterNames.map(function (subparameterName) { return [subparameterName, null]; })),
+                                                availableParameters: subparameters,
+                                            });
+                                        }
+                                        catch (error) {
+                                            if (!(error instanceof PipelineExecutionError)) {
+                                                throw error;
+                                            }
+                                            throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                        ".concat(error.message, "\n\n                        This is error in FOREACH command\n                        You have probbably passed wrong data to pipeline or wrong data was generated which are processed by FOREACH command\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+                                        }
+                                        allSubparameters = __assign(__assign({}, parameters), mappedParameters);
+                                        // Note: [👨‍👨‍👧] Now we can freeze `subparameters` because we are sure that all and only used parameters are defined and are not going to be changed
+                                        Object.freeze(allSubparameters);
+                                        return [4 /*yield*/, executeAttempts(__assign(__assign({}, options), { priority: priority + index, parameters: allSubparameters, pipelineIdentification: pipelineIdentification }))];
+                                    case 1:
+                                        subresultString = _a.sent();
+                                        return [2 /*return*/, subresultString];
+                                }
+                            });
+                        }); })];
+                case 1:
+                    resultString = _a.sent();
+                    return [2 /*return*/, resultString];
+            }
+        });
+    });
+}
+/**
+ * TODO: !!!!!! Make pipelineIdentification more precise
+ * TODO: !!!!!! How FOREACH execution looks in the report
+ * TODO: [🧠][🦥] Better (less confusing) name for "cell" / "subvalue" / "subparameter"
+ * TODO: []
+ */
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function getContextForTemplate(template) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            TODO_USE(template);
+            return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: [🏍] Implement */];
+        });
+    });
+}
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function getKnowledgeForTemplate(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var preparedPipeline, template;
+        return __generator(this, function (_a) {
+            preparedPipeline = options.preparedPipeline, template = options.template;
+            // TODO: [♨] Implement Better - use real index and keyword search from `template` and {samples}
+            TODO_USE(template);
+            return [2 /*return*/, preparedPipeline.knowledgePieces.map(function (_a) {
+                    var content = _a.content;
+                    return "- ".concat(content);
+                }).join('\n')];
+        });
+    });
+}
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function getSamplesForTemplate(template) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            // TODO: [♨] Implement Better - use real index and keyword search
+            TODO_USE(template);
+            return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: [♨] Implement */];
+        });
+    });
+}
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function getReservedParametersForTemplate(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var preparedPipeline, template, pipelineIdentification, context, knowledge, samples, currentDate, modelName, reservedParameters, _loop_1, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
+        var e_1, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    preparedPipeline = options.preparedPipeline, template = options.template, pipelineIdentification = options.pipelineIdentification;
+                    return [4 /*yield*/, getContextForTemplate(template)];
+                case 1:
+                    context = _b.sent();
+                    return [4 /*yield*/, getKnowledgeForTemplate({ preparedPipeline: preparedPipeline, template: template })];
+                case 2:
+                    knowledge = _b.sent();
+                    return [4 /*yield*/, getSamplesForTemplate(template)];
+                case 3:
+                    samples = _b.sent();
+                    currentDate = new Date().toISOString();
+                    modelName = RESERVED_PARAMETER_MISSING_VALUE;
+                    reservedParameters = {
+                        content: RESERVED_PARAMETER_RESTRICTED,
+                        context: context,
+                        knowledge: knowledge,
+                        samples: samples,
+                        currentDate: currentDate,
+                        modelName: modelName,
+                    };
+                    _loop_1 = function (parameterName) {
+                        if (reservedParameters[parameterName] === undefined) {
+                            throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                        Reserved parameter {".concat(parameterName, "} is not defined\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+                        }
+                    };
+                    try {
+                        // Note: Doublecheck that ALL reserved parameters are defined:
+                        for (RESERVED_PARAMETER_NAMES_1 = __values(RESERVED_PARAMETER_NAMES), RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next(); !RESERVED_PARAMETER_NAMES_1_1.done; RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next()) {
+                            parameterName = RESERVED_PARAMETER_NAMES_1_1.value;
+                            _loop_1(parameterName);
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (RESERVED_PARAMETER_NAMES_1_1 && !RESERVED_PARAMETER_NAMES_1_1.done && (_a = RESERVED_PARAMETER_NAMES_1.return)) _a.call(RESERVED_PARAMETER_NAMES_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    return [2 /*return*/, reservedParameters];
+            }
+        });
+    });
+}
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function executeTemplate(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var currentTemplate, preparedPipeline, parametersToPass, tools, llmTools, onProgress, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
+        var e_1, _f, _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0:
+                    currentTemplate = options.currentTemplate, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, llmTools = options.llmTools, onProgress = options.onProgress, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
+                    maxExecutionAttempts = settings.maxExecutionAttempts;
+                    name = "pipeline-executor-frame-".concat(currentTemplate.name);
+                    title = currentTemplate.title;
+                    priority = preparedPipeline.templates.length - preparedPipeline.templates.indexOf(currentTemplate);
+                    return [4 /*yield*/, onProgress({
+                            name: name,
+                            title: title,
+                            isStarted: false,
+                            isDone: false,
+                            templateType: currentTemplate.templateType,
+                            parameterName: currentTemplate.resultingParameterName,
+                            parameterValue: null,
+                            // <- [🍸]
+                        })];
+                case 1:
+                    _h.sent();
+                    usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
+                    dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
+                    // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
+                    if (union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)).size !== 0) {
+                        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                    Dependent parameters are not consistent with used parameters:\n\n                    Dependent parameters:\n                    ".concat(Array.from(dependentParameterNames)
+                            .map(function (name) { return "{".concat(name, "}"); })
+                            .join(', '), "\n\n                    Used parameters:\n                    ").concat(Array.from(usedParameterNames)
+                            .map(function (name) { return "{".concat(name, "}"); })
+                            .join(', '), "\n\n                    ").concat(block(pipelineIdentification), "\n\n                "); }));
+                    }
+                    _b = (_a = Object).freeze;
+                    _c = [{}];
+                    return [4 /*yield*/, getReservedParametersForTemplate({
+                            preparedPipeline: preparedPipeline,
+                            template: currentTemplate,
+                            pipelineIdentification: pipelineIdentification,
+                        })];
+                case 2:
+                    definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
+                    definedParameterNames = new Set(Object.keys(definedParameters));
+                    parameters = {};
+                    _loop_1 = function (parameterName) {
+                        // Situation: Parameter is defined and used
+                        if (definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
+                            parameters[parameterName] = definedParameters[parameterName];
+                        }
+                        // Situation: Parameter is defined but NOT used
+                        else if (definedParameterNames.has(parameterName) && !usedParameterNames.has(parameterName)) ;
+                        // Situation: Parameter is NOT defined BUT used
+                        else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
+                            // Houston, we have a problem
+                            // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
+                            throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                        Parameter {".concat(parameterName, "} is NOT defined\n                        BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                        This should be catched in `validatePipeline`\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
+                        }
+                    };
+                    try {
+                        // Note: [2] Check that all used parameters are defined and removing unused parameters for this template
+                        // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
+                        for (_d = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _e = _d.next(); !_e.done; _e = _d.next()) {
+                            parameterName = _e.value;
+                            _loop_1(parameterName);
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    // Note: [👨‍👨‍👧] Now we can freeze `parameters` because we are sure that all and only used parameters are defined and are not going to be changed
+                    Object.freeze(parameters);
+                    maxAttempts = currentTemplate.templateType === 'DIALOG_TEMPLATE' ? Infinity : maxExecutionAttempts;
+                    jokerParameterNames = currentTemplate.jokerParameterNames || [];
+                    preparedContent = (currentTemplate.preparedContent || '{content}')
+                        .split('{content}')
+                        .join(currentTemplate.content);
+                    return [4 /*yield*/, executeFormatCells({
+                            jokerParameterNames: jokerParameterNames,
+                            priority: priority,
+                            maxAttempts: maxAttempts,
+                            preparedContent: preparedContent,
+                            parameters: parameters,
+                            template: currentTemplate,
+                            preparedPipeline: preparedPipeline,
+                            tools: tools,
+                            llmTools: llmTools,
+                            settings: settings,
+                            $executionReport: $executionReport,
+                            pipelineIdentification: pipelineIdentification,
+                        })];
+                case 3:
+                    resultString = _h.sent();
+                    return [4 /*yield*/, onProgress({
+                            name: name,
+                            title: title,
+                            isStarted: true,
+                            isDone: true,
+                            templateType: currentTemplate.templateType,
+                            parameterName: currentTemplate.resultingParameterName,
+                            parameterValue: resultString,
+                            // <- [🍸]
+                        })];
+                case 4:
+                    _h.sent();
+                    return [2 /*return*/, Object.freeze((_g = {},
+                            _g[currentTemplate.resultingParameterName] = 
+                            // <- Note: [👩‍👩‍👧] No need to detect parameter collision here because pipeline checks logic consistency during construction
+                            resultString,
+                            _g))];
+            }
+        });
+    });
+}
+/**
+ * TODO: [🤹‍♂️]
+ */
+
+/**
+ * @@@
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function filterJustOutputParameters(options) {
+    var e_1, _a;
+    var preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, $warnings = options.$warnings, pipelineIdentification = options.pipelineIdentification;
+    var outputParameters = {};
+    var _loop_1 = function (parameter) {
+        if (parametersToPass[parameter.name] === undefined) {
+            // [4]
+            $warnings.push(new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                            Parameter {".concat(parameter.name, "} should be an output parameter, but it was not generated during pipeline execution\n\n                            ").concat(block(pipelineIdentification), "\n                        "); })));
+            return "continue";
+        }
+        outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
+    };
+    try {
+        // Note: Filter ONLY output parameters
+        // TODO: [👩🏾‍🤝‍👩🏻] Maybe use here `mapAvailableToExpectedParameters`
+        for (var _b = __values(preparedPipeline.parameters.filter(function (_a) {
+            var isOutput = _a.isOutput;
+            return isOutput;
+        })), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var parameter = _c.value;
+            _loop_1(parameter);
         }
-        function filterJustOutputParameters() {
-            var e_8, _a;
-            var outputParameters = {};
-            var _loop_6 = function (parameter) {
-                if (parametersToPass[parameter.name] === undefined) {
-                    // [4]
-                    warnings.push(new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                    Parameter {".concat(parameter.name, "} should be an output parameter, but it was not generated during pipeline execution\n\n                                    ").concat(block(pipelineIdentification), "\n                                "); })));
-                    return "continue";
-                }
-                outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
-            };
-            try {
-                // Note: Filter ONLY output parameters
-                for (var _b = __values(preparedPipeline.parameters.filter(function (_a) {
-                    var isOutput = _a.isOutput;
-                    return isOutput;
-                })), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var parameter = _c.value;
-                    _loop_6(parameter);
-                }
-            }
-            catch (e_8_1) { e_8 = { error: e_8_1 }; }
-            finally {
-                try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-                }
-                finally { if (e_8) throw e_8.error; }
-            }
-            return outputParameters;
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        var errors, warnings, executionReport, isReturned, _a, _b, parameter, e_1_1, _loop_1, _c, _d, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
+        finally { if (e_1) throw e_1.error; }
+    }
+    return outputParameters;
+}
+
+/**
+ * @@@
+ *
+ * Note: This is not a `PipelineExecutor` (which is binded with one exact pipeline), but a utility function of `createPipelineExecutor` which creates `PipelineExecutor`
+ *
+ * @private internal utility of `createPipelineExecutor`
+ */
+function executePipeline(options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, settings, maxParallelCount, isVerbose, preparedPipeline, llmTools, errors, warnings, executionReport, isReturned, _a, _b, parameter, e_1_1, _loop_1, _c, _d, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
         var e_1, _e, e_2, _f;
         return __generator(this, function (_g) {
             switch (_g.label) {
                 case 0:
+                    inputParameters = options.inputParameters, tools = options.tools, onProgress = options.onProgress, pipeline = options.pipeline, setPreparedPipeline = options.setPreparedPipeline, pipelineIdentification = options.pipelineIdentification, settings = options.settings;
+                    maxParallelCount = settings.maxParallelCount, isVerbose = settings.isVerbose;
+                    preparedPipeline = options.preparedPipeline;
+                    llmTools = joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(arrayableToArray(tools.llm)), false));
                     if (!(preparedPipeline === undefined)) return [3 /*break*/, 2];
                     return [4 /*yield*/, preparePipeline(pipeline, {
                             llmTools: llmTools,
@@ -3862,6 +4429,7 @@ function createPipelineExecutor(options) {
                         })];
                 case 1:
                     preparedPipeline = _g.sent();
+                    setPreparedPipeline(preparedPipeline);
                     _g.label = 2;
                 case 2:
                     errors = [];
@@ -3931,7 +4499,7 @@ function createPipelineExecutor(options) {
                                         return name === parameterName;
                                     });
                                     if (!(parameter === undefined)) return [3 /*break*/, 1];
-                                    warnings.push(new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                Extra parameter {".concat(parameterName, "} is being passed which is not part of the pipeline.\n\n                                ").concat(block(pipelineIdentification), "\n                            "); })));
+                                    warnings.push(new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                              Extra parameter {".concat(parameterName, "} is being passed which is not part of the pipeline.\n\n                              ").concat(block(pipelineIdentification), "\n                          "); })));
                                     return [3 /*break*/, 4];
                                 case 1:
                                     if (!(parameter.isInput === false)) return [3 /*break*/, 4];
@@ -3943,10 +4511,10 @@ function createPipelineExecutor(options) {
                                     // Note: Wait a short time to prevent race conditions
                                     _h.sent();
                                     _h.label = 3;
-                                case 3: return [2 /*return*/, { value: $asDeeplyFrozenSerializableJson(spaceTrim$1(function (block) { return "\n                            Unuccessful PipelineExecutorResult (with extra parameter {".concat(parameter.name, "}) PipelineExecutorResult\n\n                            ").concat(block(pipelineIdentification), "\n                        "); }), {
+                                case 3: return [2 /*return*/, { value: $asDeeplyFrozenSerializableJson(spaceTrim$1(function (block) { return "\n                          Unuccessful PipelineExecutorResult (with extra parameter {".concat(parameter.name, "}) PipelineExecutorResult\n\n                          ").concat(block(pipelineIdentification), "\n                      "); }), {
                                             isSuccessful: false,
                                             errors: __spreadArray([
-                                                new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                        Parameter {".concat(parameter.name, "} is passed as input parameter but it is not input\n\n                                        ").concat(block(pipelineIdentification), "\n                                    "); }))
+                                                new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                      Parameter {".concat(parameter.name, "} is passed as input parameter but it is not input\n\n                                      ").concat(block(pipelineIdentification), "\n                                  "); }))
                                             ], __read(errors), false).map(serializeError),
                                             warnings: warnings.map(serializeError),
                                             executionReport: executionReport,
@@ -4010,7 +4578,7 @@ function createPipelineExecutor(options) {
                                 case 0:
                                     if (loopLimit-- < 0) {
                                         // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                                        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                Loop limit reached during resolving parameters pipeline execution\n\n                                ".concat(block(pipelineIdentification), "\n                            "); }));
+                                        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                              Loop limit reached during resolving parameters pipeline execution\n\n                              ".concat(block(pipelineIdentification), "\n                          "); }));
                                     }
                                     currentTemplate = unresovedTemplates_1.find(function (template) {
                                         return template.dependentParameterNames.every(function (name) {
@@ -4020,29 +4588,52 @@ function createPipelineExecutor(options) {
                                     if (!(!currentTemplate && resolving_1.length === 0)) return [3 /*break*/, 1];
                                     throw new UnexpectedError(
                                     // TODO: [🐎] DRY
-                                    spaceTrim$1(function (block) { return "\n                                Can not resolve some parameters:\n\n                                ".concat(block(pipelineIdentification), "\n\n                                Can not resolve:\n                                ").concat(block(unresovedTemplates_1
+                                    spaceTrim$1(function (block) { return "\n                              Can not resolve some parameters:\n\n                              ".concat(block(pipelineIdentification), "\n\n                              Can not resolve:\n                              ").concat(block(unresovedTemplates_1
                                         .map(function (_a) {
                                         var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
                                         return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
                                             .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
                                             .join(' and '));
                                     })
-                                        .join('\n')), "\n\n                                Resolved:\n                                ").concat(block(resovedParameterNames_1.map(function (name) { return "- Parameter {".concat(name, "}"); }).join('\n')), "\n\n                                Note: This should be catched in `validatePipeline`\n                            "); }));
+                                        .join('\n')), "\n\n                              Resolved:\n                              ").concat(block(resovedParameterNames_1.map(function (name) { return "- Parameter {".concat(name, "}"); }).join('\n')), "\n\n                              Note: This should be catched in `validatePipeline`\n                          "); }));
                                 case 1:
                                     if (!!currentTemplate) return [3 /*break*/, 3];
-                                    /* [5] */ return [4 /*yield*/, Promise.race(resolving_1)];
+                                    /* [🤹‍♂️] */ return [4 /*yield*/, Promise.race(resolving_1)];
                                 case 2:
-                                    /* [5] */ _j.sent();
+                                    /* [🤹‍♂️] */ _j.sent();
                                     return [3 /*break*/, 4];
                                 case 3:
                                     unresovedTemplates_1 = unresovedTemplates_1.filter(function (template) { return template !== currentTemplate; });
-                                    work_1 = executeSingleTemplate(currentTemplate)
-                                        .then(function () {
+                                    work_1 = executeTemplate({
+                                        currentTemplate: currentTemplate,
+                                        preparedPipeline: preparedPipeline,
+                                        parametersToPass: parametersToPass,
+                                        tools: tools,
+                                        llmTools: llmTools,
+                                        onProgress: function (progress) {
+                                            if (isReturned) {
+                                                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                                          Can not call `onProgress` after pipeline execution is finished\n\n                                          ".concat(block(pipelineIdentification), "\n\n                                          ").concat(block(JSON.stringify(progress, null, 4)
+                                                    .split('\n')
+                                                    .map(function (line) { return "> ".concat(line); })
+                                                    .join('\n')), "\n                                      "); }));
+                                            }
+                                            if (onProgress) {
+                                                onProgress(progress);
+                                            }
+                                        },
+                                        settings: settings,
+                                        $executionReport: executionReport,
+                                        pipelineIdentification: pipelineIdentification,
+                                    })
+                                        .then(function (newParametersToPass) {
+                                        parametersToPass = __assign(__assign({}, newParametersToPass), parametersToPass);
                                         resovedParameterNames_1 = __spreadArray(__spreadArray([], __read(resovedParameterNames_1), false), [currentTemplate.resultingParameterName], false);
                                     })
                                         .then(function () {
                                         resolving_1 = resolving_1.filter(function (w) { return w !== work_1; });
                                     });
+                                    // <- Note: Errors are catched here [3]
+                                    //    TODO: BUT if in multiple templates are errors, only the first one is catched so maybe we should catch errors here and save them to errors array here
                                     resolving_1.push(work_1);
                                     _j.label = 4;
                                 case 4: return [2 /*return*/];
@@ -4069,7 +4660,12 @@ function createPipelineExecutor(options) {
                         var result = _a.result;
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
-                    outputParameters_1 = filterJustOutputParameters();
+                    outputParameters_1 = filterJustOutputParameters({
+                        preparedPipeline: preparedPipeline,
+                        parametersToPass: parametersToPass,
+                        $warnings: warnings,
+                        pipelineIdentification: pipelineIdentification,
+                    });
                     isReturned = true;
                     if (!(onProgress !== undefined)) return [3 /*break*/, 27];
                     // Note: Wait a short time to prevent race conditions
@@ -4092,7 +4688,12 @@ function createPipelineExecutor(options) {
                         var result = _a.result;
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
-                    outputParameters = filterJustOutputParameters();
+                    outputParameters = filterJustOutputParameters({
+                        preparedPipeline: preparedPipeline,
+                        parametersToPass: parametersToPass,
+                        $warnings: warnings,
+                        pipelineIdentification: pipelineIdentification,
+                    });
                     isReturned = true;
                     if (!(onProgress !== undefined)) return [3 /*break*/, 30];
                     // Note: Wait a short time to prevent race conditions
@@ -4112,22 +4713,62 @@ function createPipelineExecutor(options) {
                     })];
             }
         });
-    }); };
-    return pipelineExecutor;
+    });
 }
+
 /**
- * TODO: !!! Identify not only pipeline BUT exact template ${block(pipelineIdentification)}
- * TODO: Use isVerbose here (not only pass to `preparePipeline`)
- * TODO: [🧠][🌳] Use here `countTotalUsage` and put preparation and prepared pipiline to report
- * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
- * TODO: [♈] Probbably move expectations from templates to parameters
- * TODO: [🧠] When not meet expectations in DIALOG_TEMPLATE, make some way to tell the user
- * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
- * Note: CreatePipelineExecutorOptions are just connected to PipelineExecutor so do not extract to types folder
- * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- * TODO: [🧠][💷] `assertsExecutionSuccessful` should be the method of `PipelineExecutor` result BUT maybe NOT to preserve pure JSON object
+ * Creates executor function from pipeline and execution tools.
+ *
+ * @returns The executor function
+ * @throws {PipelineLogicError} on logical error in the pipeline
+ * @public exported from `@promptbook/core`
  */
+function createPipelineExecutor(options) {
+    var _this = this;
+    var pipeline = options.pipeline, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
+    var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? MAX_EXECUTION_ATTEMPTS : _b, _c = settings.maxParallelCount, maxParallelCount = _c === void 0 ? MAX_PARALLEL_COUNT : _c, _d = settings.isVerbose, isVerbose = _d === void 0 ? IS_VERBOSE : _d, _e = settings.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _e === void 0 ? false : _e;
+    validatePipeline(pipeline);
+    var pipelineIdentification = (function () {
+        // Note: This is a 😐 implementation of [🚞]
+        var _ = [];
+        if (pipeline.sourceFile !== undefined) {
+            _.push("File: ".concat(pipeline.sourceFile));
+        }
+        if (pipeline.pipelineUrl !== undefined) {
+            _.push("Url: ".concat(pipeline.pipelineUrl));
+        }
+        return _.join('\n');
+    })();
+    var preparedPipeline;
+    if (isPipelinePrepared(pipeline)) {
+        preparedPipeline = pipeline;
+    }
+    else if (isNotPreparedWarningSupressed !== true) {
+        console.warn(spaceTrim$1(function (block) { return "\n                    Pipeline is not prepared\n\n                    ".concat(block(pipelineIdentification), "\n\n                    It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                    But it is recommended to prepare the pipeline during collection preparation\n\n                    @see more at https://ptbk.io/prepare-pipeline\n                "); }));
+    }
+    var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            return [2 /*return*/, executePipeline({
+                    pipeline: pipeline,
+                    preparedPipeline: preparedPipeline,
+                    setPreparedPipeline: function (newPreparedPipeline) {
+                        preparedPipeline = newPreparedPipeline;
+                    },
+                    inputParameters: inputParameters,
+                    tools: tools,
+                    onProgress: onProgress,
+                    pipelineIdentification: pipelineIdentification,
+                    settings: {
+                        maxExecutionAttempts: maxExecutionAttempts,
+                        maxParallelCount: maxParallelCount,
+                        isVerbose: isVerbose,
+                        isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
+                    },
+                })];
+        });
+    }); };
+    return pipelineExecutor;
+}
 
 /**
  * @@@
@@ -5263,6 +5904,145 @@ function normalizeTo_SCREAMING_CASE(text) {
  * TODO: [🌺] Use some intermediate util splitWords
  */
 
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @param _isFirstLetterCapital @@@
+ * @returns @@@
+ * @example 'helloWorld'
+ * @example 'iLovePromptbook'
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_camelCase(text, _isFirstLetterCapital) {
+    var e_1, _a;
+    if (_isFirstLetterCapital === void 0) { _isFirstLetterCapital = false; }
+    var charType;
+    var lastCharType = null;
+    var normalizedName = '';
+    try {
+        for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+            var char = text_1_1.value;
+            var normalizedChar = void 0;
+            if (/^[a-z]$/.test(char)) {
+                charType = 'LOWERCASE';
+                normalizedChar = char;
+            }
+            else if (/^[A-Z]$/.test(char)) {
+                charType = 'UPPERCASE';
+                normalizedChar = char.toLowerCase();
+            }
+            else if (/^[0-9]$/.test(char)) {
+                charType = 'NUMBER';
+                normalizedChar = char;
+            }
+            else {
+                charType = 'OTHER';
+                normalizedChar = '';
+            }
+            if (!lastCharType) {
+                if (_isFirstLetterCapital) {
+                    normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
+                }
+            }
+            else if (charType !== lastCharType &&
+                !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
+                !(lastCharType === 'NUMBER') &&
+                !(charType === 'NUMBER')) {
+                normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
+            }
+            normalizedName += normalizedChar;
+            lastCharType = charType;
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return normalizedName;
+}
+/**
+ * TODO: [🌺] Use some intermediate util splitWords
+ */
+
+/**
+ * Function `validateParameterName` will @@@
+ *
+ * @param parameterName @@@
+ * @returns @@@
+ * @throws {ParseError} @@@
+ * @private within the repository
+ */
+function validateParameterName(parameterName) {
+    var e_1, _a;
+    var rawParameterName = parameterName;
+    try {
+        for (var _b = __values([
+            ['`', '`'],
+            ['{', '}'],
+            ['[', ']'],
+            ['(', ')'],
+            ['<', '>'],
+        ]), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), start = _d[0], end = _d[1];
+            if (parameterName.substring(0, 1) === start &&
+                parameterName.substring(parameterName.length - 1, parameterName.length) === end
+            // <- TODO: More universal that 1 character
+            ) {
+                parameterName = parameterName.substring(1, parameterName.length - 1);
+                // <- TODO: More universal that 1 character
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    // TODO: [🐠] Following try-catch block should be part of common validators logic
+    try {
+        /*
+        Note: We don't need to check for spaces because we are going to normalize the parameter name to camelCase
+        if (parameterName.includes(' ')) {
+            throw new ParseError(`Parameter name cannot contain spaces`);
+        }
+        */
+        if (parameterName.includes('.')) {
+            throw new ParseError("Parameter name cannot contain dots");
+        }
+        if (parameterName.includes('/') || parameterName.includes('\\')) {
+            throw new ParseError("Parameter name cannot contain slashes");
+        }
+        if (parameterName.includes('(') ||
+            parameterName.includes(')') ||
+            parameterName.includes('{') ||
+            parameterName.includes('}') ||
+            parameterName.includes('[') ||
+            parameterName.includes(']')) {
+            throw new ParseError("Parameter name cannot contain braces");
+        }
+        parameterName = normalizeTo_camelCase(parameterName);
+        if (parameterName === '') {
+            throw new ParseError("Parameter name cannot be empty");
+        }
+        if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
+            throw new ParseError("{".concat(parameterName, "} is a reserved parameter name"));
+        }
+    }
+    catch (error) {
+        if (!(error instanceof ParseError)) {
+            throw error;
+        }
+        throw new ParseError(spaceTrim(function (block) { return "\n                    ".concat(block(error.message), "\n\n                    Tried to validate parameter name:\n                    ").concat(block(rawParameterName), "\n                "); }));
+    }
+    return parameterName;
+}
+
 /**
  * Parses the foreach command
  *
@@ -5297,62 +6077,66 @@ var foreachCommandParser = {
      * Example usages of the FOREACH command
      */
     examples: [
-        'FOREACH List Line -> `{customer}`',
-        'FOR List Line -> `{customer}`',
-        'EACH List Line -> `{customer}`',
+        'FOREACH Text Line `{customers}` -> `{customer}`',
+        'FOR Csv Row `{customers}` -> `{firstName}`, `{lastName}`',
+        'EACH Csv Cell `{customers}` -> `{cell}`',
         // <- TODO: [🍭] !!!!!! More
     ],
     /**
      * Parses the FOREACH command
      */
     parse: function (input) {
-        var args = input.args, rawArgs = input.rawArgs;
+        var args = input.args;
         var formatName = normalizeTo_SCREAMING_CASE(args[0] || '');
         var cellName = normalizeTo_SCREAMING_CASE(args[1] || '');
-        var assignSign = args[2];
-        var parameter = args[3];
-        if (![
-            'LIST',
-            'CSV',
-            // <- TODO: [🏢] Unhardcode formats
-        ].includes(formatName)) {
+        var parameterNameWrapped = args[2];
+        var assignSign = args[3];
+        var formatDefinition = FORMAT_DEFINITIONS.find(function (formatDefinition) {
+            return __spreadArray([formatDefinition.formatName], __read((formatDefinition.aliases || [])), false).includes(formatName);
+        });
+        if (formatDefinition === undefined) {
             console.info({ args: args, formatName: formatName });
-            throw new Error("Unsupported format \"".concat(formatName, "\""));
+            throw new ParseError(spaceTrim(function (block) { return "\n                        Unsupported format \"".concat(formatName, "\"\n\n                        Available formats:\n                        ").concat(block(FORMAT_DEFINITIONS.map(function (formatDefinition) { return formatDefinition.formatName; })
+                .map(function (formatName) { return "- ".concat(formatName); })
+                .join('\n')), "\n                    "); }));
             // <- TODO: [🏢] List all supported format names
         }
-        if (![
-            'LINE',
-            'ROW',
-            'COLUMN',
-            'CELL',
-            // <- TODO: [🏢] Unhardcode format cekks
-        ].includes(cellName)) {
+        var subvalueDefinition = formatDefinition.subvalueDefinitions.find(function (subvalueDefinition) {
+            return __spreadArray([subvalueDefinition.subvalueName], __read((subvalueDefinition.aliases || [])), false).includes(cellName);
+        });
+        if (subvalueDefinition === undefined) {
             console.info({ args: args, cellName: cellName });
-            throw new Error("Format ".concat(formatName, " does not support cell \"").concat(cellName, "\""));
+            throw new ParseError(spaceTrim(function (block) { return "\n                        Unsupported cell name \"".concat(cellName, "\" for format \"").concat(formatName, "\"\n\n                        Available cell names for format \"").concat(formatDefinition.formatName, "\":\n                        ").concat(block(formatDefinition.subvalueDefinitions
+                .map(function (subvalueDefinition) { return subvalueDefinition.subvalueName; })
+                .map(function (subvalueName) { return "- ".concat(subvalueName); })
+                .join('\n')), "\n                    "); }));
             // <- TODO: [🏢] List all supported cell names for the format
         }
         if (assignSign !== '->') {
             console.info({ args: args, assignSign: assignSign });
-            throw new Error("FOREACH command must have '->' to assign the value to the parameter");
-        }
-        var parameterNames = extractParameterNames(parameter || rawArgs);
-        if (parameterNames.size !== 1) {
-            console.info({ args: args, parameter: parameter, rawArgs: rawArgs });
-            throw new Error("FOREACH command contain exactly one parameter, but found ".concat(parameterNames.size));
-        }
-        var parameterName = parameterNames.values().next().value;
-        if (typeof parameterName !== 'string'
-        // <- TODO: !!!!!! Replace with propper parameter name validation
-        ) {
-            console.info({ args: args, parameterName: parameterName });
-            throw new Error("Invalid parameter name");
-            // <- TODO: !!!!!! Better error (with rules and precise error) from validateParameterName
+            throw new ParseError("FOREACH command must have '->' to assign the value to the parameter");
+        }
+        // TODO: !!!!!! Replace with propper parameter name validation `validateParameterName`
+        if ((parameterNameWrapped === null || parameterNameWrapped === void 0 ? void 0 : parameterNameWrapped.substring(0, 1)) !== '{' ||
+            (parameterNameWrapped === null || parameterNameWrapped === void 0 ? void 0 : parameterNameWrapped.substring(parameterNameWrapped.length - 1, parameterNameWrapped.length)) !== '}') {
+            console.info({ args: args, parameterNameWrapped: parameterNameWrapped }, parameterNameWrapped === null || parameterNameWrapped === void 0 ? void 0 : parameterNameWrapped.substring(0, 1), parameterNameWrapped === null || parameterNameWrapped === void 0 ? void 0 : parameterNameWrapped.substring(parameterNameWrapped.length - 1, parameterNameWrapped.length));
+            throw new ParseError("!!!!!! 1 Here will be error (with rules and precise error) from validateParameterName");
+        }
+        var parameterName = parameterNameWrapped.substring(1, parameterNameWrapped.length - 1);
+        var subparameterNames = args
+            .slice(4)
+            .map(function (parameterName) { return parameterName.split(',').join(' ').trim(); })
+            .filter(function (parameterName) { return parameterName !== ''; })
+            .map(validateParameterName);
+        if (subparameterNames.length === 0) {
+            throw new ParseError("FOREACH command must have at least one subparameter");
         }
         return {
             type: 'FOREACH',
             formatName: formatName,
             cellName: cellName,
             parameterName: parameterName,
+            subparameterNames: subparameterNames,
         };
     },
     /**
@@ -5361,8 +6145,12 @@ var foreachCommandParser = {
      * Note: `$` is used to indicate that this function mutates given `templateJson`
      */
     $applyToTemplateJson: function (command, $templateJson, $pipelineJson) {
-        keepUnused(command, $templateJson, $pipelineJson);
-        // <- TODO: [🍭] !!!!!! Implement
+        var formatName = command.formatName, cellName = command.cellName, parameterName = command.parameterName, subparameterNames = command.subparameterNames;
+        // TODO: !!!!!! Detect double use
+        // TODO: !!!!!! Detect usage with JOKER and don't allow it
+        $templateJson.foreach = { formatName: formatName, cellName: cellName, parameterName: parameterName, subparameterNames: subparameterNames };
+        keepUnused($pipelineJson); // <- TODO: !!!!!! BUT Maybe register subparameter from foreach into parameters of the pipeline
+        // Note: [🍭] FOREACH apply has some sideeffects on different places in codebase
     },
     /**
      * Converts the FOREACH command back to string
@@ -5371,8 +6159,7 @@ var foreachCommandParser = {
      */
     stringify: function (command) {
         keepUnused(command);
-        return "";
-        // <- TODO: [🍭] !!!!!! Implement
+        return "---"; // <- TODO: [🛋] Implement
     },
     /**
      * Reads the FOREACH command from the `TemplateJson`
@@ -5381,12 +6168,12 @@ var foreachCommandParser = {
      */
     takeFromTemplateJson: function ($templateJson) {
         keepUnused($templateJson);
-        return [];
-        // <- TODO: [🍭] !!!!!! Implement
+        throw new NotYetImplementedError("[\uD83D\uDECB] Not implemented yet"); // <- TODO: [🛋] Implement
     },
 };
 /**
- * TODO: !!!!!! Comment console logs
+ * TODO: !!!!!! Remove console logs
+ * TODO: [🧠][🦥] Better (less confusing) name for "cell" / "subvalue" / "subparameter"
  * TODO: [🍭] !!!!!! Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
  */
 
@@ -5497,6 +6284,7 @@ var jokerCommandParser = {
      */
     parse: function (input) {
         var args = input.args;
+        // TODO: !!!!!! Replace with propper parameter name validation `validateParameterName`
         var parametersMatch = (args.pop() || '').match(/^\{(?<parameterName>[a-z0-9_]+)\}$/im);
         if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
             throw new ParseError("Invalid joker");
@@ -5626,6 +6414,7 @@ var modelCommandParser = {
         if ($pipelineJson.defaultModelRequirements[command.key] !== undefined) {
             if ($pipelineJson.defaultModelRequirements[command.key] === command.value) {
                 console.warn("Multiple commands `MODEL ".concat(command.key, " ").concat(command.value, "` in the pipeline head"));
+                // <- TODO: [🚎] Some better way how to get warnings from pipeline parsing / logic
             }
             else {
                 throw new ParseError(spaceTrim("\n                        Redefinition of MODEL `".concat(command.key, "` in the pipeline head\n\n                        You have used:\n                        - MODEL ").concat(command.key, " ").concat($pipelineJson.defaultModelRequirements[command.key], "\n                        - MODEL ").concat(command.key, " ").concat(command.value, "\n                    ")));
@@ -6702,7 +7491,7 @@ function extractAllListItemsFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     var codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim(function (block) { return "\n                    There should be exactly 1 code block, found ".concat(codeBlocks.length, " code blocks\n\n                    ").concat(block(codeBlocks.map(function (block, i) { return "Block ".concat(i + 1, ":\n").concat(block.content); }).join('\n\n\n')), "\n                "); }));
+        throw new ParseError(spaceTrim(function (block) { return "\n                    There should be exactly 1 code block in template, found ".concat(codeBlocks.length, " code blocks\n\n                    ").concat(block(codeBlocks.map(function (block, i) { return "Block ".concat(i + 1, ":\n").concat(block.content); }).join('\n\n\n')), "\n                "); }));
     }
     return codeBlocks[0];
 }
@@ -7261,70 +8050,6 @@ function addAutoGeneratedSection(content, options) {
  * TODO: [🏛] This can be part of markdown builder
  */
 
-/**
- * @@@
- *
- * @param text @@@
- * @param _isFirstLetterCapital @@@
- * @returns @@@
- * @example 'helloWorld'
- * @example 'iLovePromptbook'
- * @public exported from `@promptbook/utils`
- */
-function normalizeTo_camelCase(text, _isFirstLetterCapital) {
-    var e_1, _a;
-    if (_isFirstLetterCapital === void 0) { _isFirstLetterCapital = false; }
-    var charType;
-    var lastCharType = null;
-    var normalizedName = '';
-    try {
-        for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
-            var char = text_1_1.value;
-            var normalizedChar = void 0;
-            if (/^[a-z]$/.test(char)) {
-                charType = 'LOWERCASE';
-                normalizedChar = char;
-            }
-            else if (/^[A-Z]$/.test(char)) {
-                charType = 'UPPERCASE';
-                normalizedChar = char.toLowerCase();
-            }
-            else if (/^[0-9]$/.test(char)) {
-                charType = 'NUMBER';
-                normalizedChar = char;
-            }
-            else {
-                charType = 'OTHER';
-                normalizedChar = '';
-            }
-            if (!lastCharType) {
-                if (_isFirstLetterCapital) {
-                    normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
-                }
-            }
-            else if (charType !== lastCharType &&
-                !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
-                !(lastCharType === 'NUMBER') &&
-                !(charType === 'NUMBER')) {
-                normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
-            }
-            normalizedName += normalizedChar;
-            lastCharType = charType;
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return normalizedName;
-}
-/**
- * TODO: [🌺] Use some intermediate util splitWords
- */
-
 /**
  * Creates a Mermaid graph based on the promptbook
  *
@@ -7381,6 +8106,9 @@ function renderPromptbookMermaid(pipelineJson, options) {
     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
  */
@@ -7522,21 +8250,41 @@ function usageToWorktime(usage) {
  * @public exported from `@promptbook/core`
  */
 function usageToHuman(usage) {
-    var report = 'Usage:';
+    var reportItems = [];
     var uncertainNumberToHuman = function (_a) {
         var value = _a.value, isUncertain = _a.isUncertain;
         return "".concat(isUncertain ? 'approximately ' : '').concat(Math.round(value * 100) / 100);
     };
-    report += '\n' + "- Cost ".concat(uncertainNumberToHuman(usage.price), " USD");
-    report += '\n' + "- Saved ".concat(uncertainNumberToHuman(usageToWorktime(usage)), " hours of human time");
-    return spaceTrim(report);
+    if (usage.price.value > 0.01
+    // <- TODO: [🍓][🧞‍♂️][👩🏽‍🤝‍🧑🏻] Configure negligible value - default value to config + value to `UsageToHumanSettings`
+    ) {
+        reportItems.push("Cost ".concat(uncertainNumberToHuman(usage.price), " USD"));
+    }
+    else {
+        reportItems.push("Negligible cost");
+    }
+    var worktime = usageToWorktime(usage);
+    if (worktime.value >
+        1 / 60
+    // <- TODO: [🍓][🧞‍♂️][👩🏽‍🤝‍🧑🏻]
+    ) {
+        reportItems.push("Saved ".concat(uncertainNumberToHuman(usageToWorktime(usage)), " hours of human time"));
+        // TODO: [🍓][🧞‍♂️] Show minutes, seconds, days NOT 0.1 hours
+    }
+    if (usage.output.charactersCount.value > 0) {
+        reportItems.push("Written ".concat(uncertainNumberToHuman(usage.output.charactersCount), " characters"));
+    }
+    if (reportItems.length === 0) {
+        // Note: For negligible usage, we report at least something
+        reportItems.push('Negligible');
+    }
+    return spaceTrim(function (block) { return "\n            Usage:\n            ".concat(block(reportItems.map(function (item) { return "- ".concat(item); }).join('\n')), "\n        "); });
 }
 /**
- * TODO: Use "$1" not "1 USD"
- * TODO: Use markdown formatting like "Cost approximately **$1**"
- * TODO: Report in minutes, seconds, days NOT 0.1 hours
+ * TODO: [🍓][🧞‍♂️] Use "$1" not "1 USD"
+ * TODO: [🍓][🧞‍♂️] Use markdown formatting like "Cost approximately **$1**"
+ * TODO: [🍓][🧞‍♂️] Report in minutes, seconds, days NOT 0.1 hours
  * TODO: [🧠] Maybe make from `uncertainNumberToHuman` separate exported utility
- * TODO: When negligible usage, report "Negligible" or just don't report it
  * TODO: [🧠] Maybe use "~" instead of "approximately"
  * TODO: [🏛] Maybe make some markdown builder
  */
@@ -8475,5 +9223,5 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Should be in generated file GENERATOR_WARNING
  */
 
-export { $llmToolsMetadataRegister, $llmToolsRegister, CLAIM, CallbackInterfaceTools, CollectionError, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, ERRORS, EXECUTIONS_CACHE_DIRNAME, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, IS_VERBOSE, LimitReachedError, MAX_EXECUTION_ATTEMPTS, MAX_FILENAME_LENGTH, MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, MAX_PARALLEL_COUNT, MODEL_VARIANTS, MemoryStorage, NotFoundError, NotYetImplementedError, PIPELINE_COLLECTION_BASE_FILENAME, PROMPTBOOK_VERSION, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, TemplateTypes, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _OpenAiMetadataRegistration, addUsage, assertsExecutionSuccessful, cacheLlmTools, collectionToJson, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, isPipelinePrepared, joinLlmExecutionTools, limitTotalUsage, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTemplates, prettifyPipelineString, stringifyPipelineJson, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline };
+export { $llmToolsMetadataRegister, $llmToolsRegister, CLAIM, CallbackInterfaceTools, CollectionError, CsvFormatDefinition, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, ERRORS, EXECUTIONS_CACHE_DIRNAME, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, IS_VERBOSE, LimitReachedError, MAX_EXECUTION_ATTEMPTS, MAX_FILENAME_LENGTH, MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, MAX_PARALLEL_COUNT, MODEL_VARIANTS, MemoryStorage, NotFoundError, NotYetImplementedError, PIPELINE_COLLECTION_BASE_FILENAME, PROMPTBOOK_VERSION, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, TemplateTypes, TextFormatDefinition, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _OpenAiMetadataRegistration, addUsage, assertsExecutionSuccessful, cacheLlmTools, collectionToJson, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, isPipelinePrepared, joinLlmExecutionTools, limitTotalUsage, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTemplates, prettifyPipelineString, stringifyPipelineJson, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline };
 //# sourceMappingURL=index.es.js.map