@promptbook/core 0.61.0-14 → 0.61.0-16

package/esm/index.es.js

@@ -251,7 +251,7 @@ function pipelineJsonToString(pipelineJson) {
             /* Note: Not using:> name, */
             title_1 = promptTemplate.title, description_1 = promptTemplate.description, 
             /* Note: dependentParameterNames, */
-            jokers = promptTemplate.jokers, blockType = promptTemplate.blockType, content = promptTemplate.content, postprocessing = promptTemplate.postprocessing, expectations = promptTemplate.expectations, expectFormat = promptTemplate.expectFormat, resultingParameterName = promptTemplate.resultingParameterName;
+            jokers = promptTemplate.jokerParameterNames, blockType = promptTemplate.blockType, content = promptTemplate.content, postprocessing = promptTemplate.postprocessingFunctionNames, expectations = promptTemplate.expectations, expectFormat = promptTemplate.expectFormat, resultingParameterName = promptTemplate.resultingParameterName;
             pipelineString += '\n\n';
             pipelineString += "## ".concat(title_1);
             if (description_1) {
@@ -395,7 +395,7 @@ function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
  *
  * @returns The same object as the input, but deeply frozen
  *
- * Note: This function mutates the object
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
  */
 function deepFreeze(objectValue) {
     var e_1, _a;
@@ -418,11 +418,42 @@ function deepFreeze(objectValue) {
     }
     return Object.freeze(objectValue);
 }
+/**
+ * @@@
+ * @@@
+ *
+ * @returns The same object as the input, but deeply frozen
+ *
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ */
+function deepFreezeWithSameType(objectValue) {
+    return deepFreeze(objectValue);
+}
 /**
  * TODO: [🔼] Export from `@promptbook/utils`
  * TODO: [🧠] Is there a way how to meaningfully test this utility
  */
 
+/**
+ * Returns the same value that is passed as argument.
+ * No side effects.
+ *
+ * Note: It can be usefull for:
+ *
+ * 1) Leveling indentation
+ * 2) Putting always-true or always-false conditions without getting eslint errors
+ *
+ * @param value any values
+ * @returns the same values
+ * @private within the repository
+ */
+function just(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value;
+}
+
 /**
  * The maximum number of iterations for a loops
  */
@@ -431,18 +462,30 @@ var LOOP_LIMIT = 1000;
  * The maximum number of (LLM) tasks running in parallel
  */
 var MAX_PARALLEL_COUNT = 5;
+/**
+ * The maximum number of attempts to execute LLM task before giving up
+ */
+var MAX_EXECUTION_ATTEMPTS = 3;
 /**
  * The names of the parameters that are reserved for special purposes
  */
 var RESERVED_PARAMETER_NAMES = deepFreeze([
     'context',
+    'currentDate',
     // <- TODO: Add more like 'date', 'modelName',...
     // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
 ]);
+/**
+ * Nonce which is used for replacing things in strings
+ */
+var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
 /*
 TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
 */
 // [🟡][🟢][🔵][⚪]
+/**
+ * TODO: [🔼] Export all to core
+ */
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -645,7 +688,7 @@ function isValidPipelineUrl(url) {
  */
 function validatePipeline(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, e_4, _d;
+    var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e;
     if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
         // <- Note: [🚲]
         throw new PipelineLogicError("Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\""));
@@ -682,19 +725,19 @@ function validatePipeline(pipeline) {
     };
     try {
         // Note: Check each parameter individually
-        for (var _e = __values(pipeline.parameters), _f = _e.next(); !_f.done; _f = _e.next()) {
-            var parameter = _f.value;
+        for (var _f = __values(pipeline.parameters), _g = _f.next(); !_g.done; _g = _f.next()) {
+            var parameter = _g.value;
             _loop_1(parameter);
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
+            if (_g && !_g.done && (_a = _f.return)) _a.call(_f);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    // Note: Check each template individually
+    // Note: All input parameters are defined - so that they can be used as result of some template
     var definedParameters = new Set(pipeline.parameters.filter(function (_a) {
         var isInput = _a.isInput;
         return isInput;
@@ -703,23 +746,27 @@ function validatePipeline(pipeline) {
         return name;
     }));
     try {
-        for (var _g = __values(pipeline.promptTemplates), _h = _g.next(); !_h.done; _h = _g.next()) {
-            var template = _h.value;
+        // Note: Checking each template individually
+        for (var _h = __values(pipeline.promptTemplates), _j = _h.next(); !_j.done; _j = _h.next()) {
+            var template = _j.value;
             if (definedParameters.has(template.resultingParameterName)) {
                 throw new PipelineLogicError("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
             }
+            if (RESERVED_PARAMETER_NAMES.includes(template.resultingParameterName)) {
+                throw new PipelineLogicError("Parameter name {".concat(template.resultingParameterName, "} is reserved, please use fifferent name"));
+            }
             definedParameters.add(template.resultingParameterName);
             if (template.blockType === 'PROMPT_TEMPLATE' && template.modelRequirements.modelVariant === undefined) {
                 throw new PipelineLogicError(spaceTrim$1("\n\n                  You must specify MODEL VARIANT in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
             }
-            if (template.jokers && template.jokers.length > 0) {
+            if (template.jokerParameterNames && template.jokerParameterNames.length > 0) {
                 if (!template.expectFormat &&
                     !template.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
                     throw new PipelineLogicError("Joker parameters are used for {".concat(template.resultingParameterName, "} but no expectations are defined"));
                 }
                 try {
-                    for (var _j = (e_3 = void 0, __values(template.jokers)), _k = _j.next(); !_k.done; _k = _j.next()) {
-                        var joker = _k.value;
+                    for (var _k = (e_3 = void 0, __values(template.jokerParameterNames)), _l = _k.next(); !_l.done; _l = _k.next()) {
+                        var joker = _l.value;
                         if (!template.dependentParameterNames.includes(joker)) {
                             throw new PipelineLogicError("Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in dependentParameterNames"));
                         }
@@ -728,15 +775,15 @@ function validatePipeline(pipeline) {
                 catch (e_3_1) { e_3 = { error: e_3_1 }; }
                 finally {
                     try {
-                        if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
+                        if (_l && !_l.done && (_c = _k.return)) _c.call(_k);
                     }
                     finally { if (e_3) throw e_3.error; }
                 }
             }
             if (template.expectations) {
                 try {
-                    for (var _l = (e_4 = void 0, __values(Object.entries(template.expectations))), _m = _l.next(); !_m.done; _m = _l.next()) {
-                        var _o = __read(_m.value, 2), unit = _o[0], _p = _o[1], min = _p.min, max = _p.max;
+                    for (var _m = (e_4 = void 0, __values(Object.entries(template.expectations))), _o = _m.next(); !_o.done; _o = _m.next()) {
+                        var _p = __read(_o.value, 2), unit = _p[0], _q = _p[1], min = _q.min, max = _q.max;
                         if (min !== undefined && max !== undefined && min > max) {
                             throw new PipelineLogicError("Min expectation (=".concat(min, ") of ").concat(unit, " is higher than max expectation (=").concat(max, ")"));
                         }
@@ -751,7 +798,7 @@ function validatePipeline(pipeline) {
                 catch (e_4_1) { e_4 = { error: e_4_1 }; }
                 finally {
                     try {
-                        if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+                        if (_o && !_o.done && (_d = _m.return)) _d.call(_m);
                     }
                     finally { if (e_4) throw e_4.error; }
                 }
@@ -761,7 +808,7 @@ function validatePipeline(pipeline) {
     catch (e_2_1) { e_2 = { error: e_2_1 }; }
     finally {
         try {
-            if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
+            if (_j && !_j.done && (_b = _h.return)) _b.call(_h);
         }
         finally { if (e_2) throw e_2.error; }
     }
@@ -775,7 +822,22 @@ function validatePipeline(pipeline) {
         var name = _a.name;
         return name;
     });
+    try {
+        // Note: All reserved parameters are resolved
+        for (var 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()) {
+            var reservedParameterName = RESERVED_PARAMETER_NAMES_1_1.value;
+            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), [reservedParameterName], false);
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (RESERVED_PARAMETER_NAMES_1_1 && !RESERVED_PARAMETER_NAMES_1_1.done && (_e = RESERVED_PARAMETER_NAMES_1.return)) _e.call(RESERVED_PARAMETER_NAMES_1);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
     var unresovedTemplates = __spreadArray([], __read(pipeline.promptTemplates), false);
+    //            <- TODO: [🧠][🥜]
     var loopLimit = LOOP_LIMIT;
     var _loop_2 = function () {
         if (loopLimit-- < 0) {
@@ -820,6 +882,9 @@ function validatePipeline(pipeline) {
 /**
  * TODO: [🧠][🐣] !!!! Validate that all samples match expectations
  * TODO: [🧠][🐣] !!!! Validate that knowledge is valid (non-void)
+ * TODO: [🧠][🐣] !!!! Validate that persona can be used only with CHAT variant
+ * TODO: !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+ * TODO: !!!! Validate that reserved parameter is not used as joker
  * TODO: [🧠] !!! Validationg not only logic itself but imports around - files and websites and rerefenced pipelines exists
  * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */
@@ -1359,7 +1424,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.61.0-13",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],blockType:"PROMPT_TEMPLATE",personaName:null,modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"knowledge"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-13",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.61.0-13",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],blockType:"PROMPT_TEMPLATE",personaName:null,modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-13",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.61.0-13",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],blockType:"PROMPT_TEMPLATE",expectations:{words:{min:1,max:8}},personaName:null,modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-13",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.61.0-13",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}],promptTemplates:[{name:"make-model-requirements",title:"Make modelRequirements",dependentParameterNames:["availableModelNames","personaDescription"],blockType:"PROMPT_TEMPLATE",expectFormat:"JSON",personaName:null,modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},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### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `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### Option `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"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-13",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],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.61.0-15",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",dependentParameterNames:["content"],resultingParameterName:"knowledge"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",dependentParameterNames:["content"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",expectations:{words:{min:1,max:8}},dependentParameterNames:["content"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.61.0-15",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}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},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### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `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### Option `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}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
 var defaultDiacriticsRemovalMap = [
     {
@@ -1739,6 +1804,212 @@ function assertsExecutionSuccessful(executionResult) {
  * TODO: [🧠] Can this return type be better typed than void
  */
 
+/**
+ * Create difference set of two sets.
+ *
+ * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+ */
+function difference(a, b, isEqual) {
+    var e_1, _a;
+    if (isEqual === void 0) { isEqual = function (a, b) { return a === b; }; }
+    var diff = new Set();
+    var _loop_1 = function (itemA) {
+        if (!Array.from(b).some(function (itemB) { return isEqual(itemA, itemB); })) {
+            diff.add(itemA);
+        }
+    };
+    try {
+        for (var _b = __values(Array.from(a)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var itemA = _c.value;
+            _loop_1(itemA);
+        }
+    }
+    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; }
+    }
+    return diff;
+}
+/**
+ * TODO: [🧠][💯] Maybe also implement symmetricDifference
+ */
+
+/**
+ * Parses the template and returns the list of all parameter names
+ *
+ * @param template the template with parameters in {curly} braces
+ * @returns the list of parameter names
+ */
+function extractParameters(template) {
+    var e_1, _a;
+    var matches = template.matchAll(/{\w+}/g);
+    var parameterNames = new Set();
+    try {
+        for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
+            var match = matches_1_1.value;
+            var parameterName = match[0].slice(1, -1);
+            parameterNames.add(parameterName);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return parameterNames;
+}
+
+/**
+ * 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 {ParsingError} if the script is invalid
+ */
+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
+                      [ReferenceError: 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 ParsingError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+    }
+    return variables;
+}
+/**
+ * TODO: [🔣] Support for multiple languages - python, java,...
+ */
+
+/**
+ * Parses the prompt template and returns the set of all used parameters
+ *
+ * @param promptTemplate the template with used parameters
+ * @returns the set of parameter names
+ * @throws {ParsingError} if the script is invalid
+ */
+function extractParametersFromPromptTemplate(promptTemplate) {
+    var e_1, _a, e_2, _b, e_3, _c;
+    var title = promptTemplate.title, description = promptTemplate.description, blockType = promptTemplate.blockType, content = promptTemplate.content, jokerParameterNames = promptTemplate.jokerParameterNames;
+    var parameterNames = new Set();
+    try {
+        for (var _d = __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(title)), false), __read(extractParameters(description || '')), false), __read(extractParameters(content)), 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 (blockType === 'SCRIPT') {
+        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);
+        }
+    }
+    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; }
+    }
+    return parameterNames;
+}
+/**
+ * TODO: [🔣] If script require contentLanguage
+ */
+
+/**
+ * Creates a new set with all elements that are present in either set
+ *
+ * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+ */
+function union() {
+    var e_1, _a, e_2, _b;
+    var sets = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        sets[_i] = arguments[_i];
+    }
+    var union = new Set();
+    try {
+        for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
+            var set = sets_1_1.value;
+            try {
+                for (var _c = (e_2 = void 0, __values(Array.from(set))), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    var item = _d.value;
+                    union.add(item);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return union;
+}
+
 /**
  * This error occurs when some expectation is not met in the execution of the pipeline
  *
@@ -2011,6 +2282,28 @@ function joinLlmExecutionTools() {
     return new (MultipleLlmExecutionTools.bind.apply(MultipleLlmExecutionTools, __spreadArray([void 0], __read(llmExecutionTools), false)))();
 }
 
+/**
+ * Determine if the pipeline is fully prepared
+ */
+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: !!!!! Is context in each template
+    // TODO: !!!!! Are samples prepared
+    // TODO: !!!!! Are templates prepared
+    return true;
+}
+/**
+ * TODO: [🔼] Export via core or utils
+ * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
+ */
+
 /**
  * Takes an item or an array of items and returns an array of items
  *
@@ -2031,9 +2324,98 @@ function arrayableToArray(input) {
 }
 
 /**
- * The version of the Promptbook library
+ * 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
  */
-var PROMPTBOOK_VERSION = '0.61.0-13';
+function TODO_USE() {
+    var value = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        value[_i] = arguments[_i];
+    }
+}
+
+/**
+ * This error type indicates that some limit was reached
+ */
+var LimitReachedError = /** @class */ (function (_super) {
+    __extends(LimitReachedError, _super);
+    function LimitReachedError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'LimitReachedError';
+        Object.setPrototypeOf(_this, LimitReachedError.prototype);
+        return _this;
+    }
+    return LimitReachedError;
+}(Error));
+
+/**
+ * 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
+ */
+function replaceParameters(template, parameters) {
+    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`');
+        }
+        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;
+}
+
+/**
+ * The version of the Promptbook library
+ */
+var PROMPTBOOK_VERSION = '0.61.0-15';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /**
@@ -2167,80 +2549,6 @@ function isPassingExpectations(expectations, value) {
  * TODO: [💝] Unite object for expecting amount and format
  */
 
-/**
- * This error type indicates that some limit was reached
- */
-var LimitReachedError = /** @class */ (function (_super) {
-    __extends(LimitReachedError, _super);
-    function LimitReachedError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'LimitReachedError';
-        Object.setPrototypeOf(_this, LimitReachedError.prototype);
-        return _this;
-    }
-    return LimitReachedError;
-}(Error));
-
-/**
- * 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
- *
- * @private within the createPipelineExecutor
- */
-function replaceParameters(template, parameters) {
-    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`');
-        }
-        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;
-}
-
 /**
  * Creates executor function from pipeline and execution tools.
  *
@@ -2249,18 +2557,73 @@ function replaceParameters(template, parameters) {
  */
 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 ? 3 : _b;
-    validatePipeline(pipeline);
+    var rawPipeline = 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 ? false : _d;
+    validatePipeline(rawPipeline);
     var llmTools = joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(arrayableToArray(tools.llm)), false));
+    var pipeline;
+    if (isPipelinePrepared(rawPipeline)) {
+        pipeline = rawPipeline;
+    }
+    else {
+        console.warn(spaceTrim$1("\n                Pipeline is not prepared\n\n                It will be prepared ad-hoc before the first execution\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 () {
+        function getContextForTemplate(// <- TODO: [🧠][🥜]
+        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*/, pipeline.knowledgePieces.map(function (_a) {
+                            var content = _a.content;
+                            return "- ".concat(content);
+                        }).join('\n')];
+                });
+            });
+        }
+        function getReservedParametersForTemplate(template) {
+            return __awaiter(this, void 0, void 0, function () {
+                var context, currentDate, reservedParameters, 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();
+                            currentDate = new Date().toISOString();
+                            reservedParameters = {
+                                context: context,
+                                currentDate: currentDate,
+                            };
+                            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;
+                                    if (reservedParameters[parameterName] === undefined) {
+                                        throw new UnexpectedError("Reserved parameter {".concat(parameterName, "} is not defined"));
+                                    }
+                                }
+                            }
+                            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];
+                    }
+                });
+            });
+        }
         function executeSingleTemplate(currentTemplate) {
             return __awaiter(this, void 0, void 0, function () {
-                var name, title, priority, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokers, attempt, isJokerAttempt, joker, _a, _b, _c, _d, scriptTools, error_2, e_2_1, _e, _f, functionName, postprocessingError, _g, _h, scriptTools, error_3, e_3_1, e_4_1, error_4;
-                var e_2, _j, e_4, _k, e_3, _l, _m;
+                var name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _d, _e, parameterName, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokerParameterNames, attempt, isJokerAttempt, jokerParameterName, _f, _g, _h, _j, scriptTools, error_2, e_4_1, _k, _l, functionName, postprocessingError, _m, _o, scriptTools, error_3, e_5_1, e_6_1, error_4;
+                var e_7, _p, e_4, _q, e_6, _r, e_5, _s, _t;
                 var _this = this;
-                return __generator(this, function (_o) {
-                    switch (_o.label) {
+                return __generator(this, function (_u) {
+                    switch (_u.label) {
                         case 0:
                             name = "pipeline-executor-frame-".concat(currentTemplate.name);
                             title = currentTemplate.title;
@@ -2277,64 +2640,108 @@ function createPipelineExecutor(options) {
                                     // <- [3]
                                 })];
                         case 1:
-                            _o.sent();
-                            _o.label = 2;
+                            _u.sent();
+                            _u.label = 2;
                         case 2:
+                            usedParameterNames = extractParametersFromPromptTemplate(currentTemplate);
+                            dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
+                            if (union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)).size !== 0) {
+                                throw new UnexpectedError(spaceTrim$1("\n                        Dependent parameters are not consistent used parameters:\n\n                        Dependent parameters:\n                        ".concat(Array.from(dependentParameterNames).join(', '), "\n\n                        Used parameters:\n                        ").concat(Array.from(usedParameterNames).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([(_u.sent())])), parametersToPass])]);
+                            definedParameterNames = new Set(Object.keys(definedParameters));
+                            parameters = {};
+                            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;
+                                    // 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)) {
+                                        // Do not pass this parameter to prompt
+                                    }
+                                    // 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("\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                        ")));
+                                    }
+                                }
+                            }
+                            catch (e_7_1) { e_7 = { error: e_7_1 }; }
+                            finally {
+                                try {
+                                    if (_e && !_e.done && (_p = _d.return)) _p.call(_d);
+                                }
+                                finally { if (e_7) throw e_7.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.blockType === 'PROMPT_DIALOG' ? Infinity : maxExecutionAttempts;
-                            jokers = currentTemplate.jokers || [];
-                            attempt = -jokers.length;
-                            _o.label = 3;
-                        case 3:
-                            if (!(attempt < maxAttempts)) return [3 /*break*/, 51];
+                            jokerParameterNames = currentTemplate.jokerParameterNames || [];
+                            attempt = -jokerParameterNames.length;
+                            _u.label = 4;
+                        case 4:
+                            if (!(attempt < maxAttempts)) return [3 /*break*/, 52];
                             isJokerAttempt = attempt < 0;
-                            joker = jokers[jokers.length + attempt];
-                            if (isJokerAttempt && !joker) {
+                            jokerParameterName = jokerParameterNames[jokerParameterNames.length + attempt];
+                            if (isJokerAttempt && !jokerParameterName) {
                                 throw new UnexpectedError("Joker not found in attempt ".concat(attempt));
                             }
                             result = null;
                             resultString = null;
                             expectError = null;
                             if (isJokerAttempt) {
-                                if (typeof parametersToPass[joker] === 'undefined') {
-                                    throw new PipelineExecutionError("Joker parameter {".concat(joker, "} not defined"));
+                                if (parameters[jokerParameterName] === undefined) {
+                                    throw new PipelineExecutionError("Joker parameter {".concat(jokerParameterName, "} not defined"));
+                                    // <- TODO: This is maybe `PipelineLogicError` which should be detected in `validatePipeline` and here just thrown as `UnexpectedError`
+                                }
+                                else {
+                                    resultString = parameters[jokerParameterName];
                                 }
-                                resultString = parametersToPass[joker];
-                            }
-                            _o.label = 4;
-                        case 4:
-                            _o.trys.push([4, 47, 48, 49]);
-                            if (!!isJokerAttempt) return [3 /*break*/, 29];
-                            _a = currentTemplate.blockType;
-                            switch (_a) {
-                                case 'SIMPLE_TEMPLATE': return [3 /*break*/, 5];
-                                case 'PROMPT_TEMPLATE': return [3 /*break*/, 6];
-                                case 'SCRIPT': return [3 /*break*/, 15];
-                                case 'PROMPT_DIALOG': return [3 /*break*/, 26];
                             }
-                            return [3 /*break*/, 28];
+                            _u.label = 5;
                         case 5:
-                            resultString = replaceParameters(currentTemplate.content, parametersToPass);
+                            _u.trys.push([5, 48, 49, 50]);
+                            if (!!isJokerAttempt) return [3 /*break*/, 30];
+                            _f = currentTemplate.blockType;
+                            switch (_f) {
+                                case 'SIMPLE_TEMPLATE': return [3 /*break*/, 6];
+                                case 'PROMPT_TEMPLATE': return [3 /*break*/, 7];
+                                case 'SCRIPT': return [3 /*break*/, 16];
+                                case 'PROMPT_DIALOG': return [3 /*break*/, 27];
+                            }
                             return [3 /*break*/, 29];
                         case 6:
+                            resultString = replaceParameters(currentTemplate.content, parameters);
+                            return [3 /*break*/, 30];
+                        case 7:
                             prompt = {
                                 title: currentTemplate.title,
                                 pipelineUrl: "".concat(pipeline.pipelineUrl
                                     ? pipeline.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: parametersToPass,
-                                content: replaceParameters(currentTemplate.content, parametersToPass) /* <- [2] */,
-                                // <- TODO: !!!!! Apply {context} and knowledges
-                                // <- TODO: !!!!! Apply samples
+                                parameters: parameters,
+                                content: currentTemplate.content,
                                 modelRequirements: currentTemplate.modelRequirements,
-                                // <- TODO: !!!!! Apply persona
-                                expectations: currentTemplate.expectations,
+                                expectations: __assign(__assign({}, (pipeline.personas.find(function (_a) {
+                                    var name = _a.name;
+                                    return name === currentTemplate.personaName;
+                                }) || {})), currentTemplate.expectations),
                                 expectFormat: currentTemplate.expectFormat,
-                                postprocessing: (currentTemplate.postprocessing || []).map(function (functionName) { return function (result) { return __awaiter(_this, void 0, void 0, function () {
-                                    var errors, _a, _b, scriptTools, error_5, e_5_1;
-                                    var e_5, _c;
+                                postprocessing: (currentTemplate.postprocessingFunctionNames || []).map(function (functionName) { return function (result) { return __awaiter(_this, void 0, void 0, function () {
+                                    var errors, _a, _b, scriptTools, error_5, e_8_1;
+                                    var e_8, _c;
                                     return __generator(this, function (_d) {
                                         switch (_d.label) {
                                             case 0:
@@ -2355,7 +2762,7 @@ function createPipelineExecutor(options) {
                                                         script: "".concat(functionName, "(result)"),
                                                         parameters: {
                                                             result: result || '',
-                                                            // Note: No ...parametersToPass, because working with result only
+                                                            // Note: No ...parametersForTemplate, because working with result only
                                                         },
                                                     })];
                                             case 4: return [2 /*return*/, _d.sent()];
@@ -2364,6 +2771,9 @@ function createPipelineExecutor(options) {
                                                 if (!(error_5 instanceof Error)) {
                                                     throw error_5;
                                                 }
+                                                if (error_5 instanceof UnexpectedError) {
+                                                    throw error_5;
+                                                }
                                                 errors.push(error_5);
                                                 return [3 /*break*/, 6];
                                             case 6:
@@ -2371,14 +2781,14 @@ function createPipelineExecutor(options) {
                                                 return [3 /*break*/, 2];
                                             case 7: return [3 /*break*/, 10];
                                             case 8:
-                                                e_5_1 = _d.sent();
-                                                e_5 = { error: e_5_1 };
+                                                e_8_1 = _d.sent();
+                                                e_8 = { error: e_8_1 };
                                                 return [3 /*break*/, 10];
                                             case 9:
                                                 try {
                                                     if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
                                                 }
-                                                finally { if (e_5) throw e_5.error; }
+                                                finally { if (e_8) throw e_8.error; }
                                                 return [7 /*endfinally*/];
                                             case 10:
                                                 if (errors.length === 0) {
@@ -2394,35 +2804,35 @@ function createPipelineExecutor(options) {
                                     });
                                 }); }; }),
                             };
-                            _b = currentTemplate.modelRequirements.modelVariant;
-                            switch (_b) {
-                                case 'CHAT': return [3 /*break*/, 7];
-                                case 'COMPLETION': return [3 /*break*/, 9];
-                                case 'EMBEDDING': return [3 /*break*/, 11];
+                            _g = currentTemplate.modelRequirements.modelVariant;
+                            switch (_g) {
+                                case 'CHAT': return [3 /*break*/, 8];
+                                case 'COMPLETION': return [3 /*break*/, 10];
+                                case 'EMBEDDING': return [3 /*break*/, 12];
                             }
-                            return [3 /*break*/, 13];
-                        case 7: return [4 /*yield*/, llmTools.callChatModel(prompt)];
-                        case 8:
-                            chatResult = _o.sent();
+                            return [3 /*break*/, 14];
+                        case 8: return [4 /*yield*/, llmTools.callChatModel(deepFreeze(prompt))];
+                        case 9:
+                            chatResult = _u.sent();
                             // TODO: [🍬] Destroy chatThread
                             result = chatResult;
                             resultString = chatResult.content;
-                            return [3 /*break*/, 14];
-                        case 9: return [4 /*yield*/, llmTools.callCompletionModel(prompt)];
-                        case 10:
-                            completionResult = _o.sent();
+                            return [3 /*break*/, 15];
+                        case 10: return [4 /*yield*/, llmTools.callCompletionModel(deepFreeze(prompt))];
+                        case 11:
+                            completionResult = _u.sent();
                             result = completionResult;
                             resultString = completionResult.content;
-                            return [3 /*break*/, 14];
-                        case 11: return [4 /*yield*/, llmTools.callEmbeddingModel(prompt)];
-                        case 12:
-                            embeddingResult = _o.sent();
+                            return [3 /*break*/, 15];
+                        case 12: return [4 /*yield*/, llmTools.callEmbeddingModel(deepFreeze(prompt))];
+                        case 13:
+                            embeddingResult = _u.sent();
                             result = embeddingResult;
                             resultString = embeddingResult.content.join(',');
-                            return [3 /*break*/, 14];
-                        case 13: throw new PipelineExecutionError("Unknown model variant \"".concat(currentTemplate.modelRequirements.modelVariant, "\""));
-                        case 14: return [3 /*break*/, 29];
-                        case 15:
+                            return [3 /*break*/, 15];
+                        case 14: throw new PipelineExecutionError("Unknown model variant \"".concat(currentTemplate.modelRequirements.modelVariant, "\""));
+                        case 15: return [3 /*break*/, 30];
+                        case 16:
                             if (arrayableToArray(tools.script).length === 0) {
                                 throw new PipelineExecutionError('No script execution tools are available');
                             }
@@ -2431,49 +2841,52 @@ function createPipelineExecutor(options) {
                             }
                             // TODO: DRY [1]
                             scriptPipelineExecutionErrors = [];
-                            _o.label = 16;
-                        case 16:
-                            _o.trys.push([16, 23, 24, 25]);
-                            _c = (e_2 = void 0, __values(arrayableToArray(tools.script))), _d = _c.next();
-                            _o.label = 17;
+                            _u.label = 17;
                         case 17:
-                            if (!!_d.done) return [3 /*break*/, 22];
-                            scriptTools = _d.value;
-                            _o.label = 18;
+                            _u.trys.push([17, 24, 25, 26]);
+                            _h = (e_4 = void 0, __values(arrayableToArray(tools.script))), _j = _h.next();
+                            _u.label = 18;
                         case 18:
-                            _o.trys.push([18, 20, , 21]);
-                            return [4 /*yield*/, scriptTools.execute({
+                            if (!!_j.done) return [3 /*break*/, 23];
+                            scriptTools = _j.value;
+                            _u.label = 19;
+                        case 19:
+                            _u.trys.push([19, 21, , 22]);
+                            return [4 /*yield*/, scriptTools.execute(deepFreeze({
                                     scriptLanguage: currentTemplate.contentLanguage,
                                     script: currentTemplate.content,
-                                    parameters: parametersToPass,
-                                })];
-                        case 19:
-                            resultString = _o.sent();
-                            return [3 /*break*/, 22];
+                                    parameters: parameters,
+                                }))];
                         case 20:
-                            error_2 = _o.sent();
+                            resultString = _u.sent();
+                            return [3 /*break*/, 23];
+                        case 21:
+                            error_2 = _u.sent();
                             if (!(error_2 instanceof Error)) {
                                 throw error_2;
                             }
+                            if (error_2 instanceof UnexpectedError) {
+                                throw error_2;
+                            }
                             scriptPipelineExecutionErrors.push(error_2);
-                            return [3 /*break*/, 21];
-                        case 21:
-                            _d = _c.next();
-                            return [3 /*break*/, 17];
-                        case 22: return [3 /*break*/, 25];
-                        case 23:
-                            e_2_1 = _o.sent();
-                            e_2 = { error: e_2_1 };
-                            return [3 /*break*/, 25];
+                            return [3 /*break*/, 22];
+                        case 22:
+                            _j = _h.next();
+                            return [3 /*break*/, 18];
+                        case 23: return [3 /*break*/, 26];
                         case 24:
+                            e_4_1 = _u.sent();
+                            e_4 = { error: e_4_1 };
+                            return [3 /*break*/, 26];
+                        case 25:
                             try {
-                                if (_d && !_d.done && (_j = _c.return)) _j.call(_c);
+                                if (_j && !_j.done && (_q = _h.return)) _q.call(_h);
                             }
-                            finally { if (e_2) throw e_2.error; }
+                            finally { if (e_4) throw e_4.error; }
                             return [7 /*endfinally*/];
-                        case 25:
+                        case 26:
                             if (resultString !== null) {
-                                return [3 /*break*/, 29];
+                                return [3 /*break*/, 30];
                             }
                             if (scriptPipelineExecutionErrors.length === 1) {
                                 throw scriptPipelineExecutionErrors[0];
@@ -2483,101 +2896,104 @@ function createPipelineExecutor(options) {
                                     .map(function (error) { return '- ' + error.message; })
                                     .join('\n\n')), "\n                                          "); }));
                             }
-                        case 26:
+                        case 27:
                             if (tools.userInterface === undefined) {
                                 throw new PipelineExecutionError('User interface tools are not available');
                             }
-                            return [4 /*yield*/, tools.userInterface.promptDialog({
+                            return [4 /*yield*/, tools.userInterface.promptDialog(deepFreeze({
                                     promptTitle: currentTemplate.title,
-                                    promptMessage: replaceParameters(currentTemplate.description || '', parametersToPass),
-                                    defaultValue: replaceParameters(currentTemplate.content, parametersToPass),
+                                    promptMessage: replaceParameters(currentTemplate.description || '', parameters),
+                                    defaultValue: replaceParameters(currentTemplate.content, parameters),
                                     // TODO: [🧠] !! Figure out how to define placeholder in .ptbk.md file
                                     placeholder: undefined,
                                     priority: priority,
-                                })];
-                        case 27:
+                                }))];
+                        case 28:
                             // TODO: [🌹] When making next attempt for `PROMPT DIALOG`, preserve the previous user input
-                            resultString = _o.sent();
-                            return [3 /*break*/, 29];
-                        case 28: throw new PipelineExecutionError("Unknown execution type \"".concat(currentTemplate.blockType, "\""));
-                        case 29:
-                            if (!(!isJokerAttempt && currentTemplate.postprocessing)) return [3 /*break*/, 46];
-                            _o.label = 30;
+                            resultString = _u.sent();
+                            return [3 /*break*/, 30];
+                        case 29: throw new PipelineExecutionError("Unknown execution type \"".concat(currentTemplate.blockType, "\""));
                         case 30:
-                            _o.trys.push([30, 44, 45, 46]);
-                            _e = (e_4 = void 0, __values(currentTemplate.postprocessing)), _f = _e.next();
-                            _o.label = 31;
+                            if (!(!isJokerAttempt && currentTemplate.postprocessingFunctionNames)) return [3 /*break*/, 47];
+                            _u.label = 31;
                         case 31:
-                            if (!!_f.done) return [3 /*break*/, 43];
-                            functionName = _f.value;
+                            _u.trys.push([31, 45, 46, 47]);
+                            _k = (e_6 = void 0, __values(currentTemplate.postprocessingFunctionNames)), _l = _k.next();
+                            _u.label = 32;
+                        case 32:
+                            if (!!_l.done) return [3 /*break*/, 44];
+                            functionName = _l.value;
                             // TODO: DRY [1]
                             scriptPipelineExecutionErrors = [];
                             postprocessingError = null;
-                            _o.label = 32;
-                        case 32:
-                            _o.trys.push([32, 39, 40, 41]);
-                            _g = (e_3 = void 0, __values(arrayableToArray(tools.script))), _h = _g.next();
-                            _o.label = 33;
+                            _u.label = 33;
                         case 33:
-                            if (!!_h.done) return [3 /*break*/, 38];
-                            scriptTools = _h.value;
-                            _o.label = 34;
+                            _u.trys.push([33, 40, 41, 42]);
+                            _m = (e_5 = void 0, __values(arrayableToArray(tools.script))), _o = _m.next();
+                            _u.label = 34;
                         case 34:
-                            _o.trys.push([34, 36, , 37]);
+                            if (!!_o.done) return [3 /*break*/, 39];
+                            scriptTools = _o.value;
+                            _u.label = 35;
+                        case 35:
+                            _u.trys.push([35, 37, , 38]);
                             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 ...parametersToPass, because working with result only
+                                        // Note: No ...parametersForTemplate, because working with result only
                                     },
                                 })];
-                        case 35:
-                            resultString = _o.sent();
-                            postprocessingError = null;
-                            return [3 /*break*/, 38];
                         case 36:
-                            error_3 = _o.sent();
+                            resultString = _u.sent();
+                            postprocessingError = null;
+                            return [3 /*break*/, 39];
+                        case 37:
+                            error_3 = _u.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*/, 37];
-                        case 37:
-                            _h = _g.next();
-                            return [3 /*break*/, 33];
-                        case 38: return [3 /*break*/, 41];
-                        case 39:
-                            e_3_1 = _o.sent();
-                            e_3 = { error: e_3_1 };
-                            return [3 /*break*/, 41];
+                            return [3 /*break*/, 38];
+                        case 38:
+                            _o = _m.next();
+                            return [3 /*break*/, 34];
+                        case 39: return [3 /*break*/, 42];
                         case 40:
+                            e_5_1 = _u.sent();
+                            e_5 = { error: e_5_1 };
+                            return [3 /*break*/, 42];
+                        case 41:
                             try {
-                                if (_h && !_h.done && (_l = _g.return)) _l.call(_g);
+                                if (_o && !_o.done && (_s = _m.return)) _s.call(_m);
                             }
-                            finally { if (e_3) throw e_3.error; }
+                            finally { if (e_5) throw e_5.error; }
                             return [7 /*endfinally*/];
-                        case 41:
+                        case 42:
                             if (postprocessingError) {
                                 throw postprocessingError;
                             }
-                            _o.label = 42;
-                        case 42:
-                            _f = _e.next();
-                            return [3 /*break*/, 31];
-                        case 43: return [3 /*break*/, 46];
-                        case 44:
-                            e_4_1 = _o.sent();
-                            e_4 = { error: e_4_1 };
-                            return [3 /*break*/, 46];
+                            _u.label = 43;
+                        case 43:
+                            _l = _k.next();
+                            return [3 /*break*/, 32];
+                        case 44: return [3 /*break*/, 47];
                         case 45:
+                            e_6_1 = _u.sent();
+                            e_6 = { error: e_6_1 };
+                            return [3 /*break*/, 47];
+                        case 46:
                             try {
-                                if (_f && !_f.done && (_k = _e.return)) _k.call(_e);
+                                if (_l && !_l.done && (_r = _k.return)) _r.call(_k);
                             }
-                            finally { if (e_4) throw e_4.error; }
+                            finally { if (e_6) throw e_6.error; }
                             return [7 /*endfinally*/];
-                        case 46:
+                        case 47:
                             // TODO: [💝] Unite object for expecting amount and format
                             if (currentTemplate.expectFormat) {
                                 if (currentTemplate.expectFormat === 'JSON') {
@@ -2590,15 +3006,18 @@ function createPipelineExecutor(options) {
                             if (currentTemplate.expectations) {
                                 checkExpectations(currentTemplate.expectations, resultString || '');
                             }
-                            return [3 /*break*/, 51];
-                        case 47:
-                            error_4 = _o.sent();
+                            return [3 /*break*/, 52];
+                        case 48:
+                            error_4 = _u.sent();
                             if (!(error_4 instanceof ExpectError)) {
                                 throw error_4;
                             }
+                            if (error_4 instanceof UnexpectedError) {
+                                throw error_4;
+                            }
                             expectError = error_4;
-                            return [3 /*break*/, 49];
-                        case 48:
+                            return [3 /*break*/, 50];
+                        case 49:
                             if (!isJokerAttempt &&
                                 currentTemplate.blockType === 'PROMPT_TEMPLATE' &&
                                 prompt
@@ -2620,15 +3039,15 @@ function createPipelineExecutor(options) {
                                 });
                             }
                             return [7 /*endfinally*/];
-                        case 49:
+                        case 50:
                             if (expectError !== null && attempt === maxAttempts - 1) {
                                 throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\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) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
                             }
-                            _o.label = 50;
-                        case 50:
-                            attempt++;
-                            return [3 /*break*/, 3];
+                            _u.label = 51;
                         case 51:
+                            attempt++;
+                            return [3 /*break*/, 4];
+                        case 52:
                             if (resultString === null) {
                                 throw new UnexpectedError('Something went wrong and prompt result is null');
                             }
@@ -2644,18 +3063,27 @@ function createPipelineExecutor(options) {
                                     // <- [3]
                                 });
                             }
-                            parametersToPass = __assign(__assign({}, parametersToPass), (_m = {}, _m[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because pipeline checks logic consistency during construction */, _m));
+                            parametersToPass = Object.freeze(__assign(__assign({}, parametersToPass), (_t = {}, _t[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because pipeline checks logic consistency during construction */, _t)));
                             return [2 /*return*/];
                     }
                 });
             });
         }
-        var parametersToPass, executionReport, resovedParameters_1, unresovedTemplates, resolving_1, loopLimit, _loop_1, error_1, usage_1, _a, _b, parameter, usage;
-        var e_1, _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var executionReport, _a, _b, parameter, parametersToPass, resovedParameters_1, unresovedTemplates, resolving_1, loopLimit, _loop_1, error_1, usage_1, outputParameters, errors, _c, _d, parameter, usage;
+        var e_1, _e, e_2, _f;
+        return __generator(this, function (_g) {
+            switch (_g.label) {
                 case 0:
-                    parametersToPass = inputParameters;
+                    if (!(pipeline === undefined)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, preparePipeline(rawPipeline, {
+                            llmTools: llmTools,
+                            isVerbose: isVerbose,
+                            maxParallelCount: maxParallelCount,
+                        })];
+                case 1:
+                    pipeline = _g.sent();
+                    _g.label = 2;
+                case 2:
                     executionReport = {
                         pipelineUrl: pipeline.pipelineUrl,
                         title: pipeline.title,
@@ -2664,9 +3092,35 @@ function createPipelineExecutor(options) {
                         description: pipeline.description,
                         promptExecutions: [],
                     };
-                    _d.label = 1;
-                case 1:
-                    _d.trys.push([1, 6, , 7]);
+                    try {
+                        // Note: Check that all input input parameters are defined
+                        for (_a = __values(pipeline.parameters), _b = _a.next(); !_b.done; _b = _a.next()) {
+                            parameter = _b.value;
+                            if (parameter.isInput && inputParameters[parameter.name] === undefined) {
+                                return [2 /*return*/, deepFreezeWithSameType({
+                                        isSuccessful: false,
+                                        errors: [
+                                            new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an input parameter")),
+                                            // <- TODO: !!!!! Test this error
+                                        ],
+                                        executionReport: executionReport,
+                                        outputParameters: {},
+                                        usage: ZERO_USAGE,
+                                    })];
+                            }
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (_b && !_b.done && (_e = _a.return)) _e.call(_a);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    parametersToPass = inputParameters;
+                    _g.label = 3;
+                case 3:
+                    _g.trys.push([3, 8, , 9]);
                     resovedParameters_1 = pipeline.parameters
                         .filter(function (_a) {
                         var isInput = _a.isInput;
@@ -2681,8 +3135,8 @@ function createPipelineExecutor(options) {
                     loopLimit = LOOP_LIMIT;
                     _loop_1 = function () {
                         var currentTemplate, work_1;
-                        return __generator(this, function (_e) {
-                            switch (_e.label) {
+                        return __generator(this, function (_h) {
+                            switch (_h.label) {
                                 case 0:
                                     if (loopLimit-- < 0) {
                                         // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
@@ -2697,7 +3151,7 @@ function createPipelineExecutor(options) {
                                     if (!!currentTemplate) return [3 /*break*/, 3];
                                     /* [5] */ return [4 /*yield*/, Promise.race(resolving_1)];
                                 case 2:
-                                    /* [5] */ _e.sent();
+                                    /* [5] */ _h.sent();
                                     return [3 /*break*/, 4];
                                 case 3:
                                     unresovedTemplates = unresovedTemplates.filter(function (template) { return template !== currentTemplate; });
@@ -2709,24 +3163,24 @@ function createPipelineExecutor(options) {
                                         resolving_1 = resolving_1.filter(function (w) { return w !== work_1; });
                                     });
                                     resolving_1.push(work_1);
-                                    _e.label = 4;
+                                    _h.label = 4;
                                 case 4: return [2 /*return*/];
                             }
                         });
                     };
-                    _d.label = 2;
-                case 2:
-                    if (!(unresovedTemplates.length > 0)) return [3 /*break*/, 4];
+                    _g.label = 4;
+                case 4:
+                    if (!(unresovedTemplates.length > 0)) return [3 /*break*/, 6];
                     return [5 /*yield**/, _loop_1()];
-                case 3:
-                    _d.sent();
-                    return [3 /*break*/, 2];
-                case 4: return [4 /*yield*/, Promise.all(resolving_1)];
                 case 5:
-                    _d.sent();
-                    return [3 /*break*/, 7];
-                case 6:
-                    error_1 = _d.sent();
+                    _g.sent();
+                    return [3 /*break*/, 4];
+                case 6: return [4 /*yield*/, Promise.all(resolving_1)];
+                case 7:
+                    _g.sent();
+                    return [3 /*break*/, 9];
+                case 8:
+                    error_1 = _g.sent();
                     if (!(error_1 instanceof Error)) {
                         throw error_1;
                     }
@@ -2734,73 +3188,63 @@ function createPipelineExecutor(options) {
                         var result = _a.result;
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
-                    return [2 /*return*/, {
+                    return [2 /*return*/, deepFreezeWithSameType({
                             isSuccessful: false,
                             errors: [error_1],
                             usage: usage_1,
                             executionReport: executionReport,
                             outputParameters: parametersToPass,
-                        }];
-                case 7:
+                        })];
+                case 9:
+                    outputParameters = {};
+                    errors = [];
                     try {
                         // Note: Filter ONLY output parameters
-                        for (_a = __values(pipeline.parameters), _b = _a.next(); !_b.done; _b = _a.next()) {
-                            parameter = _b.value;
-                            if (parameter.isOutput) {
+                        for (_c = __values(pipeline.parameters.filter(function (_a) {
+                            var isOutput = _a.isOutput;
+                            return isOutput;
+                        })), _d = _c.next(); !_d.done; _d = _c.next()) {
+                            parameter = _d.value;
+                            if (parametersToPass[parameter.name] === undefined) {
+                                errors.push(new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an output parameter but not set in the pipeline")));
                                 continue;
                             }
-                            delete parametersToPass[parameter.name];
+                            outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
                         }
                     }
-                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    catch (e_2_1) { e_2 = { error: e_2_1 }; }
                     finally {
                         try {
-                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                            if (_d && !_d.done && (_f = _c.return)) _f.call(_c);
                         }
-                        finally { if (e_1) throw e_1.error; }
+                        finally { if (e_2) throw e_2.error; }
                     }
                     usage = addUsage.apply(void 0, __spreadArray([], __read(executionReport.promptExecutions.map(function (_a) {
                         var result = _a.result;
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
-                    return [2 /*return*/, {
+                    return [2 /*return*/, deepFreezeWithSameType({
                             isSuccessful: true,
-                            errors: [],
+                            errors: errors,
                             usage: usage,
                             executionReport: executionReport,
-                            outputParameters: parametersToPass,
-                        }];
+                            outputParameters: outputParameters,
+                        })];
             }
         });
     }); };
     return pipelineExecutor;
 }
 /**
- * TODO: [🪂] Pass maxParallelCount here
+ * TODO: Use isVerbose here (not only pass to `preparePipeline`)
+ * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
  * TODO: [♈] Probbably move expectations from templates to parameters
  * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, 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
- */
-
-/**
- * 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
- */
-function TODO_USE() {
-    var value = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        value[_i] = arguments[_i];
-    }
-}
+ */
 
 /**
  * @@@
@@ -2929,7 +3373,7 @@ function prepareKnowledgeFromMarkdown(content /* <- TODO: [🖖] (?maybe not) Al
     });
 }
 /**
- * TODO: [🔼] !!! Export via `@promptbook/markdown`
+ * TODO: [🐝][🔼] !!! Export via `@promptbook/markdown`
  * TODO: [🪂] Do it in parallel 11:11
  * Note: No need to aggregate usage here, it is done by intercepting the llmTools
  */
@@ -2952,7 +3396,7 @@ function prepareKnowledgePieces(knowledgeSources, options) {
                             var partialPieces, pieces;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
-                                    case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.source, // <- TODO: [🐝] !!!!! Unhardcode markdown, detect which type it is
+                                    case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.source, // <- TODO: [🐝] !!! Unhardcode markdown, detect which type it is
                                         options)];
                                     case 1:
                                         partialPieces = _a.sent();
@@ -2990,7 +3434,7 @@ TODO: [🧊] This is how it can look in future
 > ):
 */
 /**
- * TODO: [🔼] !!! Export via `@promptbook/core`
+ * TODO: [🐝][🔼] !!! Export via `@promptbook/core`
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
  *       Put `knowledgePieces` into `PrepareKnowledgeOptions`
  * TODO: [🪂] More than max things can run in parallel by acident [1,[2a,2b,_],[3a,3b,_]]
@@ -3116,12 +3560,15 @@ function preparePipeline(pipeline, options) {
                     partialknowledgePiecesPrepared = _b.sent();
                     knowledgePiecesPrepared = partialknowledgePiecesPrepared.map(function (piece) { return (__assign(__assign({}, piece), { preparationIds: [/* TODO: [🧊] -> */ currentPreparation.id] })); });
                     // ----- /Knowledge preparation -----
+                    // TODO: !!!!! Add context to each template (if missing)
+                    // TODO: !!!!! Apply samples to each template (if missing)
                     return [2 /*return*/, __assign(__assign({}, pipeline), { knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations })];
             }
         });
     });
 }
 /**
+ * TODO: !!!!! Index the samples and maybe templates
  * TODO: [🔼] !!! Export via `@promptbook/core`
  * TODO: Write tests for `preparePipeline`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
@@ -3177,7 +3624,7 @@ var knowledgeCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/41',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/41',
     /**
      * Example usages of the KNOWLEDGE command
      */
@@ -3214,8 +3661,9 @@ var knowledgeCommandParser = {
     /**
      * Note: Prototype of [🍧] (remove this comment after full implementation)
      */
-    applyToPipelineJson: function (pipelineJson, personaCommand) {
+    applyToPipelineJson: function (personaCommand, subjects) {
         var source = personaCommand.source;
+        var pipelineJson = subjects.pipelineJson;
         var name = titleToName(source);
         pipelineJson.knowledgeSources.push({
             name: name,
@@ -3250,7 +3698,7 @@ var personaCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/22',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/22',
     /**
      * Example usages of the PERSONA command
      */
@@ -3278,8 +3726,15 @@ var personaCommandParser = {
     /**
      * Note: Prototype of [🍧] (remove this comment after full implementation)
      */
-    applyToPipelineJson: function (pipelineJson, personaCommand) {
+    applyToPipelineJson: function (personaCommand, subjects) {
         var personaName = personaCommand.personaName, personaDescription = personaCommand.personaDescription;
+        var pipelineJson = subjects.pipelineJson, templateJson = subjects.templateJson;
+        if (templateJson !== null) {
+            if (templateJson.blockType !== 'PROMPT_TEMPLATE') {
+                throw new ParsingError("PERSONA command can be used only in PROMPT_TEMPLATE block");
+            }
+            templateJson.personaName = personaName;
+        }
         var persona = pipelineJson.personas.find(function (persona) { return persona.name === personaName; });
         if (persona === undefined) {
             pipelineJson.personas.push({
@@ -3421,7 +3876,7 @@ var blockCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/64',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/64',
     /**
      * Example usages of the BLOCK command
      */
@@ -3449,6 +3904,7 @@ var blockCommandParser = {
         //---
         /* <- TODO: [🧠] Maybe dynamic */
     ],
+    // TODO: [♓️] order: -10 /* <- Note: Putting before other commands */
     /**
      * Parses the BLOCK command
      */
@@ -3565,7 +4021,7 @@ var expectCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/30',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/30',
     /**
      * Example usages of the EXPECT command
      */
@@ -3683,7 +4139,7 @@ var jokerCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/66',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/66',
     /**
      * Example usages of the JOKER command
      */
@@ -3726,7 +4182,11 @@ var modelCommandParser = {
     /**
      * BOILERPLATE command can be used in:
      */
-    usagePlaces: ['PIPELINE_HEAD', 'PIPELINE_TEMPLATE'],
+    usagePlaces: [
+        'PIPELINE_HEAD',
+        //  <- TODO: [🧠][❔] Should there be possibility to set MODEL for entire pipeline?
+        'PIPELINE_TEMPLATE',
+    ],
     /**
      * Description of the MODEL command
      */
@@ -3734,7 +4194,7 @@ var modelCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/67',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/67',
     /**
      * Example usages of the MODEL command
      */
@@ -3814,7 +4274,7 @@ var parameterCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/68',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/68',
     /**
      * Example usages of the PARAMETER command
      */
@@ -3878,7 +4338,7 @@ var postprocessCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/31',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/31',
     /**
      * Example usages of the POSTPROCESS command
      */
@@ -3933,7 +4393,7 @@ var promptbookVersionCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/69',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/69',
     /**
      * Example usages of the PROMPTBOOK_VERSION command
      */
@@ -3986,7 +4446,7 @@ var urlCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/70',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/70',
     /**
      * Example usages of the URL command
      */
@@ -4056,7 +4516,7 @@ var actionCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/72',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/72',
     /**
      * Example usages of the ACTION command
      */
@@ -4095,7 +4555,7 @@ var instrumentCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/71',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/71',
     /**
      * Example usages of the INSTRUMENT command
      */
@@ -4138,7 +4598,7 @@ var boilerplateCommandParser = {
     /**
      * Link to discussion
      */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
+    documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
     /**
      * Example usages of the BOILERPLATE command
      */
@@ -4272,9 +4732,9 @@ function parseCommand(raw, usagePlace) {
  */
 function getSupportedCommandsMessage() {
     return COMMANDS.flatMap(function (_a) {
-        var name = _a.name, aliasNames = _a.aliasNames, description = _a.description, discussionUrl = _a.discussionUrl;
+        var name = _a.name, aliasNames = _a.aliasNames, description = _a.description, documentationUrl = _a.documentationUrl;
         return __spreadArray([
-            "- **".concat(name, "** ").concat(description, ", see [discussion](").concat(discussionUrl, ")")
+            "- **".concat(name, "** ").concat(description, ", see [discussion](").concat(documentationUrl, ")")
         ], __read((aliasNames || []).map(function (aliasName) { return "    - **".concat(aliasName, "** Alias for **").concat(name, "**"); })), false);
     }).join('\n');
 }
@@ -4629,195 +5089,6 @@ function removeContentComments(content) {
     return spaceTrim$1(content.replace(/<!--(.*?)-->/gs, ''));
 }
 
-/**
- * Create difference set of two sets.
- *
- * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
- */
-function difference(a, b, isEqual) {
-    var e_1, _a;
-    if (isEqual === void 0) { isEqual = function (a, b) { return a === b; }; }
-    var diff = new Set();
-    var _loop_1 = function (itemA) {
-        if (!Array.from(b).some(function (itemB) { return isEqual(itemA, itemB); })) {
-            diff.add(itemA);
-        }
-    };
-    try {
-        for (var _b = __values(Array.from(a)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var itemA = _c.value;
-            _loop_1(itemA);
-        }
-    }
-    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; }
-    }
-    return diff;
-}
-
-/**
- * Creates a new set with all elements that are present in either set
- *
- * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
- */
-function union() {
-    var e_1, _a, e_2, _b;
-    var sets = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        sets[_i] = arguments[_i];
-    }
-    var union = new Set();
-    try {
-        for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
-            var set = sets_1_1.value;
-            try {
-                for (var _c = (e_2 = void 0, __values(Array.from(set))), _d = _c.next(); !_d.done; _d = _c.next()) {
-                    var item = _d.value;
-                    union.add(item);
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return union;
-}
-
-/**
- * Parses the template and returns the list of all parameter names
- *
- * @param template the template with parameters in {curly} braces
- * @returns the list of parameter names
- */
-function extractParameters(template) {
-    var e_1, _a;
-    var matches = template.matchAll(/{\w+}/g);
-    var parameterNames = new Set();
-    try {
-        for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
-            var match = matches_1_1.value;
-            var parameterName = match[0].slice(1, -1);
-            parameterNames.add(parameterName);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return parameterNames;
-}
-
-/**
- * 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 {ParsingError} if the script is invalid
- */
-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
-                      [ReferenceError: 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 ParsingError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
-    }
-    return variables;
-}
-/**
- * TODO: [🔣] Support for multiple languages - python, java,...
- */
-
-/**
- * Parses the prompt template and returns the set of all used parameters
- *
- * @param promptTemplate the template with used parameters
- * @returns the set of parameter names
- * @throws {ParsingError} if the script is invalid
- */
-function extractParametersFromPromptTemplate(promptTemplate) {
-    var e_1, _a, e_2, _b;
-    var parameterNames = new Set();
-    try {
-        for (var _c = __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(promptTemplate.title)), false), __read(extractParameters(promptTemplate.description || '')), false), __read(extractParameters(promptTemplate.content)), false)), _d = _c.next(); !_d.done; _d = _c.next()) {
-            var parameterName = _d.value;
-            parameterNames.add(parameterName);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    if (promptTemplate.blockType === 'SCRIPT') {
-        try {
-            for (var _e = __values(extractVariables(promptTemplate.content)), _f = _e.next(); !_f.done; _f = _e.next()) {
-                var parameterName = _f.value;
-                parameterNames.add(parameterName);
-            }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
-            }
-            finally { if (e_2) throw e_2.error; }
-        }
-    }
-    return parameterNames;
-}
-/**
- * TODO: [🔣] If script require contentLanguage
- */
-
 /**
  * Compile pipeline from string (markdown) format to JSON format synchronously
  *
@@ -4927,7 +5198,7 @@ function pipelineStringToJsonSync(pipelineString) {
                     pipelineJson.pipelineUrl = command.pipelineUrl.href;
                     break;
                 case 'KNOWLEDGE':
-                    knowledgeCommandParser.applyToPipelineJson(pipelineJson, command);
+                    knowledgeCommandParser.applyToPipelineJson(command, { pipelineJson: pipelineJson, templateJson: null });
                     break;
                 case 'ACTION':
                     console.error(new NotYetImplementedError('Actions are not implemented yet'));
@@ -4936,7 +5207,7 @@ function pipelineStringToJsonSync(pipelineString) {
                     console.error(new NotYetImplementedError('Instruments are not implemented yet'));
                     break;
                 case 'PERSONA':
-                    personaCommandParser.applyToPipelineJson(pipelineJson, command);
+                    personaCommandParser.applyToPipelineJson(command, { pipelineJson: pipelineJson, templateJson: null });
                     //                    <- Note: Prototype of [🍧] (remove this comment after full implementation)
                     break;
                 case 'BOILERPLATE':
@@ -4960,13 +5231,6 @@ function pipelineStringToJsonSync(pipelineString) {
         // TODO: Parse prompt template description (the content out of the codeblock and lists)
         var templateModelRequirements = __assign({}, defaultModelRequirements);
         var listItems_3 = extractAllListItemsFromMarkdown(section.content);
-        var dependentParameterNames = new Set();
-        var blockType = 'PROMPT_TEMPLATE';
-        var jokers = [];
-        var postprocessing = [];
-        var expectAmount = {};
-        var expectFormat = undefined;
-        var isBlockTypeSet = false;
         var lastLine = section.content.split('\n').pop();
         var resultingParameterNameMatch = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
         var resultingParameterName = null;
@@ -4987,10 +5251,39 @@ function pipelineStringToJsonSync(pipelineString) {
                 .join('\n')), "\n                  "); }));
         };
         var _e = extractOneBlockFromMarkdown(section.content), language = _e.language, content = _e.content;
+        // TODO: [🎾][1] DRY description
+        var description_1 = section.content;
+        // Note: Remove codeblocks - TODO: [🎾]
+        description_1 = description_1.split(/^```.*^```/gms).join('');
+        description_1 = description_1.split(/^>.*$/gm).join('');
+        //Note: Remove lists and return statement - TODO: [🎾]
+        description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+        description_1 = spaceTrim$1(description_1);
+        if (description_1 === '') {
+            description_1 = undefined;
+        }
+        var templateJson = {
+            blockType: 'PROMPT_TEMPLATE',
+            name: titleToName(section.title),
+            title: section.title,
+            description: description_1,
+            modelRequirements: templateModelRequirements,
+            content: content,
+        };
+        /**
+         * This is nessesary because block type can be
+         * - Set zero times, so anticipate 'PROMPT_TEMPLATE'
+         * - Set one time
+         * - Set more times - throw error
+         *
+         * Note: [2]
+         */
+        var isBlockTypeSet = false;
         try {
             for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
                 var listItem = listItems_2_1.value;
                 var command = parseCommand(listItem, 'PIPELINE_TEMPLATE');
+                // TODO [🍧][♓️] List commands and before apply order them
                 switch (command.type) {
                     // TODO: [🍧] Use here applyToPipelineJson and remove switch statement
                     case 'BLOCK':
@@ -5008,9 +5301,12 @@ function pipelineStringToJsonSync(pipelineString) {
                             return "continue-templates";
                         }
                         if (command.blockType === 'KNOWLEDGE') {
-                            knowledgeCommandParser.applyToPipelineJson(pipelineJson, {
+                            knowledgeCommandParser.applyToPipelineJson({
                                 type: 'KNOWLEDGE',
-                                source: content, // <- TODO: [🐝] !!!! Work with KNOWLEDGE which not referring to the source file/wweb, but its content itself
+                                source: content, // <- TODO: [🐝] !!! Work with KNOWLEDGE which not referring to the source file or website, but its content itself
+                            }, {
+                                pipelineJson: pipelineJson,
+                                templateJson: templateJson,
                             });
                             return "continue-templates";
                         }
@@ -5023,35 +5319,36 @@ function pipelineStringToJsonSync(pipelineString) {
                             return "continue-templates";
                         }
                         expectResultingParameterName();
-                        blockType = command.blockType;
-                        isBlockTypeSet = true;
+                        templateJson.blockType = command.blockType;
+                        isBlockTypeSet = true; //<- Note: [2]
                         break;
                     case 'EXPECT_AMOUNT':
                         // eslint-disable-next-line no-case-declarations
                         var unit = command.unit.toLowerCase();
-                        expectAmount[unit] = expectAmount[unit] || {};
+                        templateJson.expectations = templateJson.expectations || {};
+                        templateJson.expectations[unit] = templateJson.expectations[unit] || {};
                         if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
-                            if (expectAmount[unit].min !== undefined) {
-                                throw new ParsingError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                            if (templateJson.expectations[unit].min !== undefined) {
+                                throw new ParsingError("Already defined minumum ".concat(templateJson.expectations[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
                             }
-                            expectAmount[unit].min = command.amount;
+                            templateJson.expectations[unit].min = command.amount;
                         } /* not else */
                         if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
-                            if (expectAmount[unit].max !== undefined) {
-                                throw new ParsingError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                            if (templateJson.expectations[unit].max !== undefined) {
+                                throw new ParsingError("Already defined maximum ".concat(templateJson.expectations[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
                             }
-                            expectAmount[unit].max = command.amount;
+                            templateJson.expectations[unit].max = command.amount;
                         }
                         break;
                     case 'EXPECT_FORMAT':
-                        if (expectFormat !== undefined && command.format !== expectFormat) {
-                            throw new ParsingError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
+                        if (templateJson.expectFormat !== undefined && command.format !== templateJson.expectFormat) {
+                            throw new ParsingError(spaceTrim$1("\n                                Expect format is already defined to \"".concat(templateJson.expectFormat, "\".\n                                Now you try to redefine it by \"").concat(command.format, "\".\n                            ")));
                         }
-                        expectFormat = command.format;
+                        templateJson.expectFormat = command.format;
                         break;
                     case 'JOKER':
-                        jokers.push(command.parameterName);
-                        dependentParameterNames.add(command.parameterName);
+                        templateJson.jokerParameterNames = templateJson.jokerParameterNames || [];
+                        templateJson.jokerParameterNames.push(command.parameterName);
                         break;
                     case 'MODEL':
                         templateModelRequirements[command.key] = command.value;
@@ -5061,11 +5358,12 @@ function pipelineStringToJsonSync(pipelineString) {
                         defineParam(command);
                         break;
                     case 'POSTPROCESS':
-                        postprocessing.push(command.functionName);
+                        templateJson.postprocessingFunctionNames = templateJson.postprocessingFunctionNames || [];
+                        templateJson.postprocessingFunctionNames.push(command.functionName);
                         break;
                     case 'KNOWLEDGE':
                         // TODO: [👙] The knowledge is maybe relevant for just this template
-                        knowledgeCommandParser.applyToPipelineJson(pipelineJson, command);
+                        knowledgeCommandParser.applyToPipelineJson(command, { pipelineJson: pipelineJson, templateJson: templateJson });
                         break;
                     case 'ACTION':
                         // TODO: [👙] The action is maybe relevant for just this template
@@ -5076,7 +5374,7 @@ function pipelineStringToJsonSync(pipelineString) {
                         console.error(new NotYetImplementedError('Instruments are not implemented yet'));
                         break;
                     case 'PERSONA':
-                        personaCommandParser.applyToPipelineJson(pipelineJson, command);
+                        personaCommandParser.applyToPipelineJson(command, { pipelineJson: pipelineJson, templateJson: templateJson });
                         //                    <- Note: Prototype of [🍧] (remove this comment after full implementation)
                         break;
                     case 'BOILERPLATE':
@@ -5095,60 +5393,29 @@ function pipelineStringToJsonSync(pipelineString) {
             }
             finally { if (e_3) throw e_3.error; }
         }
-        if (blockType === 'SCRIPT') {
+        // TODO: [🍧] Should be done in BLOCK command
+        if (templateJson.blockType === 'SCRIPT') {
             if (!language) {
                 throw new ParsingError('You must specify the language of the script in the prompt template');
             }
-            else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
+            if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
                 throw new ParsingError(spaceTrim$1(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
             }
+            templateJson.contentLanguage = language;
         }
-        // TODO: [🎾][1] DRY description
-        var description_1 = section.content;
-        // Note: Remove codeblocks - TODO: [🎾]
-        description_1 = description_1.split(/^```.*^```/gms).join('');
-        description_1 = description_1.split(/^>.*$/gm).join('');
-        //Note: Remove lists and return statement - TODO: [🎾]
-        description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description_1 = spaceTrim$1(description_1);
-        if (description_1 === '') {
-            description_1 = undefined;
-        }
-        if (Object.keys(jokers).length === 0) {
-            jokers = undefined;
-        }
-        if (Object.keys(expectAmount).length === 0) {
-            expectAmount = undefined;
-        }
-        if (Object.keys(postprocessing).length === 0) {
-            postprocessing = undefined;
-        }
-        dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, blockType: blockType, content: content })));
+        // TODO: [🍧][❔] Should be done in BLOCK command
         if (templateModelRequirements.modelVariant === undefined) {
             templateModelRequirements.modelVariant = 'CHAT';
         }
-        dependentParameterNames = difference(dependentParameterNames, new Set(RESERVED_PARAMETER_NAMES));
-        var template = {
-            name: titleToName(section.title),
-            title: section.title,
-            description: description_1,
-            dependentParameterNames: Array.from(dependentParameterNames),
-            blockType: blockType,
-            jokers: jokers,
-            postprocessing: postprocessing,
-            expectations: expectAmount,
-            expectFormat: expectFormat,
-            personaName: null,
-            modelRequirements: templateModelRequirements,
-            contentLanguage: blockType === 'SCRIPT' ? language : undefined,
-            content: content,
-            resultingParameterName: expectResultingParameterName( /* <- Note: This is once more redundant */),
-        };
-        if (blockType !== 'PROMPT_TEMPLATE') {
-            delete template.modelRequirements;
+        templateJson.dependentParameterNames = Array.from(extractParametersFromPromptTemplate(templateJson));
+        // TODO: [🍧][❔] Remove this condition - modelRequirements should be put here via BLOCK command not removed when PROMPT_TEMPLATE
+        if (templateJson.blockType !== 'PROMPT_TEMPLATE') {
+            delete templateJson.modelRequirements;
         }
+        // TODO: [🍧] Make this better - for example each command parser can call and apply this
+        templateJson.resultingParameterName = expectResultingParameterName( /* <- Note: This is once more redundant */);
         // TODO: [🍧] What actually about preparation and pushing the block into `promptTemplates`
-        pipelineJson.promptTemplates.push(template);
+        pipelineJson.promptTemplates.push(templateJson);
     };
     try {
         // =============================================================
@@ -5434,6 +5701,27 @@ function prettifyPipelineString(pipelineString, options) {
  * TODO: [🕌] When more than 2 functionalities, split into separate functions
  */
 
+/**
+ * Stringify the PipelineJson with proper formatting
+ *
+ * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
+ * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
+ */
+function stringifyPipelineJson(pipeline) {
+    var pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
+    for (var i = 0; i < LOOP_LIMIT; i++) {
+        pipelineJsonStringified = pipelineJsonStringified.replace(/(-?0\.\d+),[\n\s]+(-?0\.\d+)/gms, "$1".concat(REPLACING_NONCE, "$2"));
+    }
+    pipelineJsonStringified = pipelineJsonStringified.split(REPLACING_NONCE).join(', ');
+    pipelineJsonStringified += '\n';
+    return pipelineJsonStringified;
+}
+/**
+ * TODO: !!!! Not Working propperly @see https://promptbook.studio/samples/mixed-knowledge.ptbk.md
+ * TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
+ * TODO: [🧠] Maybe more elegant solution than replacing via regex
+ */
+
 /**
  * This error indicates that the pipeline collection cannot be propperly loaded
  */
@@ -5667,26 +5955,6 @@ function escapeMarkdownBlock(value) {
     return value.replace(/```/g, '\\`\\`\\`');
 }
 
-/**
- * Returns the same value that is passed as argument.
- * No side effects.
- *
- * Note: It can be usefull for:
- *
- * 1) Leveling indentation
- * 2) Putting always-true or always-false conditions without getting eslint errors
- *
- * @param value any values
- * @returns the same values
- * @private within the repository
- */
-function just(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value;
-}
-
 /**
  * The thresholds for the relative time in the `moment` NPM package.
  *
@@ -5897,5 +6165,5 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Allow to filter out some parts of the report by options
  */
 
-export { BlockTypes, CallbackInterfaceTools, CollectionError, ExecutionReportStringOptionsDefaults, ExpectError, NotFoundError, PROMPTBOOK_VERSION, ParsingError, PipelineExecutionError, PipelineLogicError, RESERVED_PARAMETER_NAMES, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, UnexpectedError, VersionMismatchError, addUsage, assertsExecutionSuccessful, checkExpectations, collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, joinLlmExecutionTools, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, preparePipeline, prettifyPipelineString, unpreparePipeline, usageToWorktime, validatePipeline };
+export { BlockTypes, CallbackInterfaceTools, CollectionError, ExecutionReportStringOptionsDefaults, ExpectError, NotFoundError, PROMPTBOOK_VERSION, ParsingError, PipelineExecutionError, PipelineLogicError, RESERVED_PARAMETER_NAMES, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, UnexpectedError, VersionMismatchError, addUsage, assertsExecutionSuccessful, checkExpectations, collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, joinLlmExecutionTools, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, preparePipeline, prettifyPipelineString, stringifyPipelineJson, unpreparePipeline, usageToWorktime, validatePipeline };
 //# sourceMappingURL=index.es.js.map