@promptbook/cli 0.61.0-10 → 0.61.0-12

package/esm/index.es.js

@@ -2,12 +2,13 @@ import commander from 'commander';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import colors from 'colors';
 import { forTime } from 'waitasecond';
-import { access, constants, readFile, readdir, writeFile, mkdir } from 'fs/promises';
+import { access, constants, readFile, readdir, stat, writeFile, mkdir, unlink } from 'fs/promises';
 import { join, dirname } from 'path';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
+import hexEncoder from 'crypto-js/enc-hex';
+import sha256 from 'crypto-js/sha256';
 import Anthropic from '@anthropic-ai/sdk';
-import { LoremIpsum } from 'lorem-ipsum';
 import OpenAI from 'openai';
 import glob from 'glob-promise';
 
@@ -142,12 +143,18 @@ var isRunningInNode = new Function("\n    try {\n        return this === global;
  * Detects if the code is running in a web worker
  */
 new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/utils`
+ */
 
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.61.0-9';
+var PROMPTBOOK_VERSION = '0.61.0-11';
 // TODO: !!!! List here all the versions and annotate + put into script
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/code`
+ */
 
 /**
  * Initializes testing `hello` command for Promptbook CLI utilities
@@ -178,6 +185,9 @@ function initializeHelloCommand(program) {
         });
     });
 }
+/**
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ */
 
 /**
  * Converts PipelineCollection to serialized JSON
@@ -208,14 +218,14 @@ function collectionToJson(collection) {
  * The maximum number of iterations for a loops
  */
 var LOOP_LIMIT = 1000;
-/**
- * The maximum number of iterations for a loops which adds characters one by one
- */
-var CHARACTER_LOOP_LIMIT = 100000;
 /**
  * The maximum number of (LLM) tasks running in parallel
  */
 var MAX_PARALLEL_COUNT = 5;
+/**
+ * The maximum length of the (generated) filename
+ */
+var MAX_FILENAME_LENGTH = 30;
 /**
  * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
  */
@@ -228,6 +238,10 @@ var RESERVED_PARAMETER_NAMES = [
     // <- TODO: Add more like 'date', 'modelName',...
     // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
 ];
+/*
+TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
+*/
+// [🟡][🟢][🔵][⚪]
 
 /**
  * Function `addUsage` will add multiple usages into one
@@ -394,7 +408,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-9",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,date:"2024-07-29T00:04:31.966Z",promptbookVersion:"0.61.0-9",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-9",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,date:"2024-07-29T00:04:31.970Z",promptbookVersion:"0.61.0-9",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-9",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,date:"2024-07-29T00:04:31.976Z",promptbookVersion:"0.61.0-9",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"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.61.0-11",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-11",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-11",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-11",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-11",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-11",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-11",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-11",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"}];
 
 /**
  * Prettify the html code
@@ -634,7 +648,7 @@ function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
     return parameterString;
 }
 /**
- * TODO: !!!!! Implement new features and commands into `promptTemplateParameterJsonToString`
+ * TODO: !!!! Implement new features and commands into `promptTemplateParameterJsonToString`
  * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
  * TODO: Escape all
  */
@@ -1011,6 +1025,12 @@ function validatePipeline(pipeline) {
  *     >  * -   ...
  *     >  ex port function validatePipeline(promptbook: unknown): asserts promptbook is PipelineJson {
  */
+/**
+ * TODO: [🧠][🐣] !!!! Validate that all samples match expectations
+ * TODO: [🧠][🐣] !!!! Validate that knowledge is valid (non-void)
+ * 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
+ */
 
 /**
  * This error indicates that promptbook not found in the collection
@@ -1051,7 +1071,7 @@ var SimplePipelineCollection = /** @class */ (function () {
     /**
      * Constructs a pipeline collection from promptbooks
      *
-     * @param promptbooks !!!
+     * @param promptbooks @@@
      *
      * @private Use instead `createCollectionFromJson`
      * Note: During the construction logic of all promptbooks are validated
@@ -1692,7 +1712,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
     };
     /**
      * List all available models that can be used
-     * This liost is a combination of all available models from all execution tools
+     * This lists is a combination of all available models from all execution tools
      */
     MultipleLlmExecutionTools.prototype.listModels = function () {
         return __awaiter(this, void 0, void 0, function () {
@@ -1738,6 +1758,8 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
 }());
 /**
  * TODO: [🧠][🎛] Aggregating multiple models - have result not only from one first aviable model BUT all of them
+ * TODO: [🏖] If no llmTools have for example not defined `callCompletionModel` this will still return object with defined `callCompletionModel` which just throws `PipelineExecutionError`, make it undefined instead
+ *       Look how `countTotalUsage` (and `cacheLlmTools`) implements it
  */
 
 /**
@@ -1911,27 +1933,6 @@ function checkExpectations(expectations, value) {
         finally { if (e_1) throw e_1.error; }
     }
 }
-/**
- * Function checkExpectations will check if the expectations on given value are met
- *
- * Note: There are two simmilar functions:
- * - `checkExpectations` which throws an error if the expectations are not met
- * - `isPassingExpectations` which returns a boolean
- *
- * @returns {boolean} True if the expectations are met
- */
-function isPassingExpectations(expectations, value) {
-    try {
-        checkExpectations(expectations, value);
-        return true;
-    }
-    catch (error) {
-        if (!(error instanceof ExpectError)) {
-            throw error;
-        }
-        return false;
-    }
-}
 /**
  * TODO: [💝] Unite object for expecting amount and format
  */
@@ -2006,7 +2007,6 @@ 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;
-    // TODO: !!!!! Implement new commands
     validatePipeline(pipeline);
     var llmTools = joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(arrayableToArray(tools.llm)), false));
     var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
@@ -2082,7 +2082,10 @@ function createPipelineExecutor(options) {
                                     : '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
                                 modelRequirements: currentTemplate.modelRequirements,
+                                // <- TODO: !!!!! Apply persona
                                 expectations: currentTemplate.expectations,
                                 expectFormat: currentTemplate.expectFormat,
                                 postprocessing: (currentTemplate.postprocessing || []).map(function (functionName) { return function (result) { return __awaiter(_this, void 0, void 0, function () {
@@ -2529,10 +2532,12 @@ function createPipelineExecutor(options) {
 }
 /**
  * TODO: [🪂] Pass maxParallelCount here
+ * 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
  */
 
 /**
@@ -2543,6 +2548,7 @@ function createPipelineExecutor(options) {
  *
  * @param value any values
  * @returns void
+ * @private within the repository
  */
 function TODO_USE() {
     var value = [];
@@ -2550,7 +2556,6 @@ function TODO_USE() {
         value[_i] = arguments[_i];
     }
 }
-// TODO: !!!! Find ACRY all just(...) and replace with TODO_USE
 
 /**
  * @@@
@@ -2679,6 +2684,7 @@ function prepareKnowledgeFromMarkdown(content /* <- TODO: [🖖] (?maybe not) Al
     });
 }
 /**
+ * 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
  */
@@ -2687,7 +2693,6 @@ function prepareKnowledgeFromMarkdown(content /* <- TODO: [🖖] (?maybe not) Al
  * Prepares the knowle
  *
  * @see https://github.com/webgptorg/promptbook/discussions/41
- * @private within the package
  */
 function prepareKnowledgePieces(knowledgeSources, options) {
     return __awaiter(this, void 0, void 0, function () {
@@ -2702,7 +2707,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();
@@ -2740,6 +2745,7 @@ TODO: [🧊] This is how it can look in future
 > ):
 */
 /**
+ * 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,_]]
@@ -2752,36 +2758,65 @@ TODO: [🧊] This is how it can look in future
  * Prepares the persona for the pipeline
  *
  * @see https://github.com/webgptorg/promptbook/discussions/22
- * @private within the package
  */
 function preparePersona(personaDescription, options) {
     return __awaiter(this, void 0, void 0, function () {
-        var llmTools, _a, maxParallelCount, _b, isVerbose;
-        return __generator(this, function (_c) {
-            llmTools = options.llmTools, _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a, _b = options.isVerbose, isVerbose = _b === void 0 ? false : _b;
-            TODO_USE(maxParallelCount); // <- [🪂]
-            TODO_USE(personaDescription); // <- !!!!!
-            TODO_USE(llmTools); // <- !!!!!
-            TODO_USE(isVerbose); // <- !!!!!
-            return [2 /*return*/, {
-                    modelVariant: 'CHAT',
-                    modelName: 'gpt-4',
-                }];
+        var llmTools, _a, isVerbose, collection, preparePersonaExecutor, _b, availableModels, availableModelNames, result, outputParameters, modelRequirementsRaw, modelRequirements, modelName, systemMessage, temperature;
+        var _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    llmTools = options.llmTools, _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
+                    collection = createCollectionFromJson.apply(void 0, __spreadArray([], __read(PipelineCollection), false));
+                    _b = createPipelineExecutor;
+                    _c = {};
+                    return [4 /*yield*/, collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.ptbk.md')];
+                case 1:
+                    preparePersonaExecutor = _b.apply(void 0, [(_c.pipeline = _d.sent(),
+                            _c.tools = {
+                                llm: llmTools,
+                            },
+                            _c)]);
+                    return [4 /*yield*/, llmTools.listModels()];
+                case 2:
+                    availableModels = _d.sent();
+                    availableModelNames = availableModels
+                        .filter(function (_a) {
+                        var modelVariant = _a.modelVariant;
+                        return modelVariant === 'CHAT';
+                    })
+                        .map(function (_a) {
+                        var modelName = _a.modelName;
+                        return modelName;
+                    })
+                        .join(',');
+                    return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription })];
+                case 3:
+                    result = _d.sent();
+                    assertsExecutionSuccessful(result);
+                    outputParameters = result.outputParameters;
+                    modelRequirementsRaw = outputParameters.modelRequirements;
+                    modelRequirements = JSON.parse(modelRequirementsRaw);
+                    if (isVerbose) {
+                        console.info("PERSONA ".concat(personaDescription), modelRequirements);
+                    }
+                    modelName = modelRequirements.modelName, systemMessage = modelRequirements.systemMessage, temperature = modelRequirements.temperature;
+                    return [2 /*return*/, {
+                            modelVariant: 'CHAT',
+                            modelName: modelName,
+                            systemMessage: systemMessage,
+                            temperature: temperature,
+                        }];
+            }
         });
     });
 }
 /**
- * TODO: [🪂] Do it in parallel
- */
-
-/**
- * Simple wrapper `new Date().toISOString()`
- *
- * @returns string_date branded type
+ * TODO: [🔼] !!! Export via `@promptbook/core`
+ * TODO: [🏢] !! Check validity of `modelName` in pipeline
+ * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
+ * TODO: [🏢] !! Check validity of `temperature` in pipeline
  */
-function $currentDate() {
-    return new Date().toISOString();
-}
 
 /**
  * Prepare pipeline from string (markdown) format to JSON format
@@ -2805,7 +2840,7 @@ function preparePipeline(pipeline, options) {
                     knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                     currentPreparation = {
                         id: 1,
-                        date: $currentDate(),
+                        // TODO: [🍥]> date: $currentDate(),
                         promptbookVersion: PROMPTBOOK_VERSION,
                         modelUsage: addUsage(),
                     };
@@ -2814,8 +2849,8 @@ function preparePipeline(pipeline, options) {
                         // <- TODO: [🧊]
                         currentPreparation,
                     ];
-                    preparedPersonas = [];
-                    return [4 /*yield*/, forEachAsync(personas, { maxParallelCount: maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, function (persona) { return __awaiter(_this, void 0, void 0, function () {
+                    preparedPersonas = new Array(personas.length);
+                    return [4 /*yield*/, forEachAsync(personas, { maxParallelCount: maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, function (persona, index) { return __awaiter(_this, void 0, void 0, function () {
                             var modelRequirements, preparedPersona;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
@@ -2823,7 +2858,7 @@ function preparePipeline(pipeline, options) {
                                     case 1:
                                         modelRequirements = _a.sent();
                                         preparedPersona = __assign(__assign({}, persona), { modelRequirements: modelRequirements, preparationIds: [/* TODO: [🧊] -> */ currentPreparation.id] });
-                                        preparedPersonas.push(preparedPersona);
+                                        preparedPersonas[index] = preparedPersona;
                                         return [2 /*return*/];
                                 }
                             });
@@ -2842,11 +2877,186 @@ function preparePipeline(pipeline, options) {
     });
 }
 /**
+ * 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
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
- * TODO: [💸] Make utilities `interceptLlmTools` and `costLlmTools` to compute cost and DO put this counting logic in `prepareKnowledge` or `preparePersona`
+ * TODO: [🎐] !!!! Use here countTotalUsage
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ */
+
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: This does not check if the file exists only if the path is valid
+ */
+function isValidFilePath(filePath) {
+    if (typeof filePath !== 'string') {
+        return false;
+    }
+    var filePathSlashes = filePath.split('\\').join('/');
+    // Absolute Unix path: /hello.txt
+    if (/^(\/)/i.test(filePathSlashes)) {
+        return true;
+    }
+    // Absolute Windows path: /hello.txt
+    if (/^([A-Z]{1,2}:\/?)\//i.test(filePathSlashes)) {
+        return true;
+    }
+    // Relative path: ./hello.txt
+    if (/^(\.\.?\/)+/i.test(filePathSlashes)) {
+        return true;
+    }
+    return false;
+}
+
+/**
+ * Parses the knowledge command
+ *
+ * @see ./KNOWLEDGE-README.md for more details
+ * @private within the commands folder
+ */
+var knowledgeCommandParser = {
+    /**
+     * Name of the command
+     */
+    name: 'KNOWLEDGE',
+    /**
+     * BOILERPLATE command can be used in:
+     */
+    usagePlaces: ['PIPELINE_HEAD'],
+    /**
+     * Description of the KNOWLEDGE command
+     */
+    description: "Tells promptbook which external knowledge to use",
+    /**
+     * Link to discussion
+     */
+    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/41',
+    /**
+     * Example usages of the KNOWLEDGE command
+     */
+    examples: [
+        'KNOWLEDGE https://www.pavolhejny.com/',
+        'KNOWLEDGE ./hejny-cv.txt',
+        'KNOWLEDGE ./hejny-cv.md',
+        'KNOWLEDGE ./hejny-cv.pdf',
+        'KNOWLEDGE ./hejny-cv.docx',
+    ],
+    /**
+     * Parses the KNOWLEDGE command
+     */
+    parse: function (input) {
+        var args = input.args;
+        var source = args[0];
+        if (source === undefined) {
+            throw new ParsingError("Source is not defined");
+        }
+        if (source.startsWith('http://')) {
+            throw new ParsingError("Source is not secure");
+        }
+        if (!(isValidFilePath(source) || isValidUrl(source))) {
+            throw new ParsingError("Source not valid");
+        }
+        if (source.startsWith('../') || source.startsWith('/') || /^[A-Z]:[\\/]+/i.test(source)) {
+            throw new ParsingError("Source cannot be outside of the .ptbk.md folder");
+        }
+        return {
+            type: 'KNOWLEDGE',
+            source: source,
+        };
+    },
+    /**
+     * Note: Prototype of [🍧] (remove this comment after full implementation)
+     */
+    applyToPipelineJson: function (pipelineJson, personaCommand) {
+        var source = personaCommand.source;
+        var name = titleToName(source);
+        pipelineJson.knowledgeSources.push({
+            name: name,
+            source: source,
+        });
+    },
+};
+
+/**
+ * Parses the persona command
+ *
+ * @see ./PERSONA-README.md for more details
+ * @private within the commands folder
  */
+var personaCommandParser = {
+    /**
+     * Name of the command
+     */
+    name: 'PERSONA',
+    /**
+     * Aliases for the PERSONA command
+     */
+    aliasNames: ['PERSON'],
+    /**
+     * PERSONA command can be used in:
+     */
+    usagePlaces: ['PIPELINE_HEAD', 'PIPELINE_TEMPLATE'],
+    /**
+     * Description of the PERSONA command
+     */
+    description: "Persona command is used to specify who the system is, it will be transformed into system message, top_t,...",
+    /**
+     * Link to discussion
+     */
+    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/22',
+    /**
+     * Example usages of the PERSONA command
+     */
+    examples: ['PERSONA Jane, skilled copywriter', 'PERSONA Joe, male 28 years old, programmer'],
+    /**
+     * Parses the PERSONA command
+     */
+    parse: function (input) {
+        var rawArgs = input.rawArgs;
+        var _a = __read(rawArgs.split(/[,;:]/, 2), 2), personaNameRaw = _a[0], personaDescriptionRaw = _a[1];
+        var personaName = (personaNameRaw || '').trim();
+        if (personaName === '') {
+            throw new ParsingError("You must set name for the persona");
+        }
+        var personaDescription = (personaDescriptionRaw || '').trim();
+        if (personaDescription === '') {
+            personaDescription = null;
+        }
+        return {
+            type: 'PERSONA',
+            personaName: personaName,
+            personaDescription: personaDescription,
+        };
+    },
+    /**
+     * Note: Prototype of [🍧] (remove this comment after full implementation)
+     */
+    applyToPipelineJson: function (pipelineJson, personaCommand) {
+        var personaName = personaCommand.personaName, personaDescription = personaCommand.personaDescription;
+        var persona = pipelineJson.personas.find(function (persona) { return persona.name === personaName; });
+        if (persona === undefined) {
+            pipelineJson.personas.push({
+                name: personaName,
+                description: personaDescription || '',
+            });
+            return;
+        }
+        if (persona.description === personaDescription) {
+            return;
+        }
+        if (personaDescription === null) {
+            return;
+        }
+        if (persona.description === '') {
+            persona.description = personaDescription;
+            return;
+        }
+        console.warn(spaceTrim("\n\n                Persona \"".concat(personaName, "\" is defined multiple times with different description:\n\n                First definition:\n                ").concat(persona.description, "\n\n                Second definition:\n                ").concat(personaDescription, "\n\n            ")));
+        persona.description += spaceTrim('\n\n' + personaDescription);
+    },
+};
 
 /**
  * Removes Markdown formatting tags from a string.
@@ -3003,7 +3213,7 @@ var blockCommandParser = {
         'Knowledge BLOCK',
         // 'Knowledge', // <- Note: [⛱] For execution blocks which are also separate commands shortcut does not work
         //---
-        /* TODO: !!!! Not implemented block types will be in examples in future -> */
+        /* Note: Not implemented block types will be in examples in future -> */
         'Instrument BLOCK',
         // 'Instrument', // <- Note: [⛱]
         'Action BLOCK',
@@ -3019,13 +3229,12 @@ var blockCommandParser = {
         normalized = normalized.split('EXAMPLE').join('SAMPLE');
         var blockTypes = BlockTypes.filter(function (blockType) { return normalized.includes(blockType); });
         if (blockTypes.length !== 1) {
-            // console.log('!!!', { blockType });
             throw new ParsingError(spaceTrim(function (block) { return "\n                        Unknown block type in BLOCK command\n\n                        Supported block types are:\n                        ".concat(block(BlockTypes.join(', ')), "\n                    "); }));
         }
-        // TODO: !!!! Not supported yet
+        var blockType = blockTypes[0];
         return {
             type: 'BLOCK',
-            blockType: blockTypes[0],
+            blockType: blockType,
         };
     },
 };
@@ -3268,116 +3477,36 @@ var jokerCommandParser = {
     },
 };
 
+var MODEL_VARIANTS = ['COMPLETION', 'CHAT', 'EMBEDDING' /* <- TODO [🏳] */ /* <- [🤖] */];
 /**
- * Tests if given string is valid URL.
- *
- * Note: This does not check if the file exists only if the path is valid
+ * TODO: [🧠][🈁] `seed` should maybe be somewhere else (not in `ModelRequirements`) (simmilar that `user` identification is not here)
+ * TODO: [🧠][💱] Add more model options: `stop_token`, `logit_bias`, `logprobs` (`top_logprobs`), `top_k`, `top_p`, `presence_penalty`, `frequency_penalty`, `bestOf`, `logitBias`, `logitBiasType`,...
+ *       [💱] Probbably keep using just `temperature` in Promptbook (not `top_k` and `top_p`)
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: Maybe figure out better word than "variant"
+ * TODO: Add here more requirement options like max context size, max tokens, etc.
+ * TODO: [💕][🧠] Just selecting gpt3 or gpt4 level of model
  */
-function isValidFilePath(filePath) {
-    if (typeof filePath !== 'string') {
-        return false;
-    }
-    var filePathSlashes = filePath.split('\\').join('/');
-    // Absolute Unix path: /hello.txt
-    if (/^(\/)/i.test(filePathSlashes)) {
-        return true;
-    }
-    // Absolute Windows path: /hello.txt
-    if (/^([A-Z]{1,2}:\/?)\//i.test(filePathSlashes)) {
-        return true;
-    }
-    // Relative path: ./hello.txt
-    if (/^(\.\.?\/)+/i.test(filePathSlashes)) {
-        return true;
-    }
-    return false;
-}
 
 /**
- * Parses the knowledge command
+ * Parses the model command
  *
- * @see ./KNOWLEDGE-README.md for more details
+ * @see ./MODEL-README.md for more details
  * @private within the commands folder
  */
-var knowledgeCommandParser = {
+var modelCommandParser = {
     /**
      * Name of the command
      */
-    name: 'KNOWLEDGE',
+    name: 'MODEL',
     /**
      * BOILERPLATE command can be used in:
      */
-    usagePlaces: ['PIPELINE_HEAD'],
+    usagePlaces: ['PIPELINE_HEAD', 'PIPELINE_TEMPLATE'],
     /**
-     * Description of the KNOWLEDGE command
+     * Description of the MODEL command
      */
-    description: "Tells promptbook which external knowledge to use",
-    /**
-     * Link to discussion
-     */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/41',
-    /**
-     * Example usages of the KNOWLEDGE command
-     */
-    examples: [
-        'KNOWLEDGE https://www.pavolhejny.com/',
-        'KNOWLEDGE ./hejny-cv.txt',
-        'KNOWLEDGE ./hejny-cv.md',
-        'KNOWLEDGE ./hejny-cv.pdf',
-        'KNOWLEDGE ./hejny-cv.docx',
-    ],
-    /**
-     * Parses the KNOWLEDGE command
-     */
-    parse: function (input) {
-        var args = input.args;
-        var source = args[0];
-        if (source === undefined) {
-            throw new ParsingError("Source is not defined");
-        }
-        if (source.startsWith('http://')) {
-            throw new ParsingError("Source is not secure");
-        }
-        if (!(isValidFilePath(source) || isValidUrl(source))) {
-            throw new ParsingError("Source not valid");
-        }
-        if (source.startsWith('../') || source.startsWith('/') || /^[A-Z]:[\\/]+/i.test(source)) {
-            throw new ParsingError("Source cannot be outside of the .ptbk.md folder");
-        }
-        return {
-            type: 'KNOWLEDGE',
-            source: source,
-        };
-    },
-};
-
-var MODEL_VARIANTS = ['COMPLETION', 'CHAT', 'EMBEDDING' /* <- TODO [🏳] */ /* <- [🤖] */];
-/**
- * TODO: !!!!! Add and use systemMessage, temprerature, top_k, top_p, presencePenalty, frequencyPenalty, bestOf, n, logitBias, logitBiasType, stop, ... to ModelRequirements
- * TODO: Maybe figure out better word than "variant"
- * TODO: Add here more requirement options like max context size, max tokens, etc.
- * TODO: [💕][🧠] Just selecting gpt3 or gpt4 level of model
- */
-
-/**
- * Parses the model command
- *
- * @see ./MODEL-README.md for more details
- * @private within the commands folder
- */
-var modelCommandParser = {
-    /**
-     * Name of the command
-     */
-    name: 'MODEL',
-    /**
-     * BOILERPLATE command can be used in:
-     */
-    usagePlaces: ['PIPELINE_HEAD', 'PIPELINE_TEMPLATE'],
-    /**
-     * Description of the MODEL command
-     */
-    description: "Tells which model and modelRequirements to use for the prompt template execution",
+    description: "Tells which model and modelRequirements to use for the prompt template execution",
     /**
      * Link to discussion
      */
@@ -3495,59 +3624,6 @@ var parameterCommandParser = {
     },
 };
 
-/**
- * Parses the persona command
- *
- * @see ./PERSONA-README.md for more details
- * @private within the commands folder
- */
-var personaCommandParser = {
-    /**
-     * Name of the command
-     */
-    name: 'PERSONA',
-    /**
-     * Aliases for the PERSONA command
-     */
-    aliasNames: ['PERSON'],
-    /**
-     * PERSONA command can be used in:
-     */
-    usagePlaces: ['PIPELINE_HEAD', 'PIPELINE_TEMPLATE'],
-    /**
-     * Description of the PERSONA command
-     */
-    description: "Persona command is used to specify who the system is, it will be transformed into system message, top_t,...",
-    /**
-     * Link to discussion
-     */
-    discussionUrl: 'https://github.com/webgptorg/promptbook/discussions/22',
-    /**
-     * Example usages of the PERSONA command
-     */
-    examples: ['PERSONA Jane, skilled copywriter', 'PERSONA Joe, male 28 years old, programmer'],
-    /**
-     * Parses the PERSONA command
-     */
-    parse: function (input) {
-        var rawArgs = input.rawArgs;
-        var _a = __read(rawArgs.split(/[,;:]/, 2), 2), personaNameRaw = _a[0], personaDescriptionRaw = _a[1];
-        var personaName = (personaNameRaw || '').trim();
-        if (personaName === '') {
-            throw new ParsingError("You must set name for the persona");
-        }
-        var personaDescription = (personaDescriptionRaw || '').trim();
-        if (personaDescription === '') {
-            personaDescription = null;
-        }
-        return {
-            type: 'PERSONA',
-            personaName: personaName,
-            personaDescription: personaDescription,
-        };
-    },
-};
-
 function isValidJavascriptName(javascriptName) {
     if (typeof javascriptName !== 'string') {
         return false;
@@ -3765,7 +3841,8 @@ var actionCommandParser = {
      * Parses the ACTION command
      */
     parse: function (input) {
-        input.args;
+        var args = input.args;
+        TODO_USE(args);
         return {
             type: 'ACTION',
         };
@@ -3803,7 +3880,8 @@ var instrumentCommandParser = {
      * Parses the INSTRUMENT command
      */
     parse: function (input) {
-        input.args;
+        var args = input.args;
+        TODO_USE(args);
         return {
             type: 'INSTRUMENT',
         };
@@ -3861,6 +3939,7 @@ var boilerplateCommandParser = {
 };
 /**
  * TODO: [💐] Implement BOILERPLATE command into `pipelineStringToJsonSync` function
+ * Note: [⚪] This should never be in any released package
  */
 
 /**
@@ -3879,7 +3958,7 @@ var COMMANDS = [
     actionCommandParser,
     instrumentCommandParser,
     personaCommandParser,
-    boilerplateCommandParser, // <- TODO: !!!! Only in development, remove in production
+    boilerplateCommandParser, // <- TODO: !! Only in development, remove in production
 ];
 
 /**
@@ -3965,7 +4044,7 @@ function parseCommand(raw, usagePlace) {
     }));
 }
 /**
- * !!!
+ * @@@
  */
 function getSupportedCommandsMessage() {
     return COMMANDS.flatMap(function (_a) {
@@ -3976,7 +4055,7 @@ function getSupportedCommandsMessage() {
     }).join('\n');
 }
 /**
- * !!!
+ * @@@
  */
 function parseCommandVariant(input) {
     var e_1, _a;
@@ -3985,7 +4064,6 @@ function parseCommandVariant(input) {
     var _loop_1 = function (commandParser) {
         var name_1 = commandParser.name, aliasNames = commandParser.aliasNames, deprecatedNames = commandParser.deprecatedNames, parse = commandParser.parse;
         var names = __spreadArray(__spreadArray([name_1], __read((aliasNames || [])), false), __read((deprecatedNames || [])), false);
-        // console.log('!!!', { commandName, names });
         if (names.includes(commandName)) {
             try {
                 return { value: parse({ usagePlace: usagePlace, raw: raw, rawArgs: rawArgs, normalized: normalized, args: args }) };
@@ -4095,25 +4173,42 @@ function extractAllBlocksFromMarkdown(markdown) {
     var e_1, _a;
     var codeBlocks = [];
     var lines = markdown.split('\n');
+    // Note: [0] Ensure that the last block notated by gt > will be closed
+    lines.push('');
     var currentCodeBlock = null;
     try {
         for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
             var line = lines_1_1.value;
+            if (line.startsWith('> ') || line === '>') {
+                if (currentCodeBlock === null) {
+                    currentCodeBlock = { blockNotation: '>', language: null, content: '' };
+                } /* not else */
+                if (currentCodeBlock.blockNotation === '>') {
+                    if (currentCodeBlock.content !== '') {
+                        currentCodeBlock.content += '\n';
+                    }
+                    currentCodeBlock.content += line.slice(2);
+                }
+            }
+            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
+                codeBlocks.push(currentCodeBlock);
+                currentCodeBlock = null;
+            }
+            /* not else */
             if (line.startsWith('```')) {
                 var language = line.slice(3).trim() || null;
                 if (currentCodeBlock === null) {
-                    currentCodeBlock = { language: language, content: '' };
+                    currentCodeBlock = { blockNotation: '```', language: language, content: '' };
                 }
                 else {
                     if (language !== null) {
-                        // [🌻]
-                        throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+                        throw new ParsingError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
                     }
                     codeBlocks.push(currentCodeBlock);
                     currentCodeBlock = null;
                 }
             }
-            else if (currentCodeBlock !== null) {
+            else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
                 if (currentCodeBlock.content !== '') {
                     currentCodeBlock.content += '\n';
                 }
@@ -4129,11 +4224,13 @@ function extractAllBlocksFromMarkdown(markdown) {
         finally { if (e_1) throw e_1.error; }
     }
     if (currentCodeBlock !== null) {
-        // [🌻]
-        throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
+        throw new ParsingError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
     }
     return codeBlocks;
 }
+/**
+ * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
+ */
 
 /**
  * Extracts exactly ONE code block from markdown.
@@ -4151,13 +4248,12 @@ function extractAllBlocksFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     var codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        // TODO: Report more specific place where the error happened
-        throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
+        throw new ParsingError(spaceTrim(function (block) { return "\n                    There should be exactly 1 code block, found ".concat(codeBlocks.length, " code blocks\n\n                    ").concat(block(codeBlocks.map(function (block, i) { return "Block ".concat(i + 1, ":\n").concat(block.content); }).join('\n\n\n')), "\n                "); }));
     }
     return codeBlocks[0];
 }
 /***
- * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+ * TODO: [🍓][🌻] Decide of this is internal util, external util OR validator/postprocessor
  */
 
 /**
@@ -4167,13 +4263,13 @@ function parseMarkdownSection(value) {
     var _a, _b;
     var lines = value.split('\n');
     if (!lines[0].startsWith('#')) {
-        throw new Error('Markdown section must start with heading');
+        throw new ParsingError('Markdown section must start with heading');
     }
     var title = lines[0].replace(/^#+\s*/, '');
     var level = (_b = (_a = lines[0].match(/^#+/)) === null || _a === void 0 ? void 0 : _a[0].length) !== null && _b !== void 0 ? _b : 0;
     var content = spaceTrim(lines.slice(1).join('\n'));
     if (level < 1 || level > 6) {
-        throw new Error('Markdown section must have heading level between 1 and 6');
+        throw new ParsingError('Markdown section must have heading level between 1 and 6');
     }
     return { title: title, level: level, content: content };
 }
@@ -4555,7 +4651,7 @@ function pipelineStringToJsonSync(pipelineString) {
             existingParameter.description &&
             existingParameter.description !== parameterDescription &&
             parameterDescription) {
-            throw new ParsingError(spaceTrim$1(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+            throw new ParsingError(spaceTrim$1(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description:\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
         }
         if (existingParameter) {
             if (parameterDescription) {
@@ -4574,11 +4670,12 @@ function pipelineStringToJsonSync(pipelineString) {
     // =============================================================
     // Note: 3️⃣ Process pipeline head
     pipelineJson.title = pipelineHead.title;
-    // TODO: [1] DRY description
+    // TODO: [🎾][1] DRY description
     var description = pipelineHead.content;
-    // Note: Remove codeblocks - TODO: Maybe put this into util (exported from `@promptbool/utils`)
+    // Note: Remove codeblocks - TODO: [🎾] Make util removeAllBlocksFromMarkdown (exported from `@promptbool/utils`)
     description = description.split(/^```.*^```/gms).join('');
-    //Note: Remove lists and return statement - TODO: Maybe put this into util (exported from `@promptbool/utils`)
+    description = description.split(/^>.*$/gm).join('');
+    //Note: Remove lists and return statement - TODO: [🎾] Make util  (exported from `@promptbool/utils`)
     description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
     description = spaceTrim$1(description);
     if (description === '') {
@@ -4606,7 +4703,7 @@ function pipelineStringToJsonSync(pipelineString) {
                     pipelineJson.pipelineUrl = command.pipelineUrl.href;
                     break;
                 case 'KNOWLEDGE':
-                    console.error(new NotYetImplementedError('Knowledge is not implemented yet'));
+                    knowledgeCommandParser.applyToPipelineJson(pipelineJson, command);
                     break;
                 case 'ACTION':
                     console.error(new NotYetImplementedError('Actions are not implemented yet'));
@@ -4615,7 +4712,8 @@ function pipelineStringToJsonSync(pipelineString) {
                     console.error(new NotYetImplementedError('Instruments are not implemented yet'));
                     break;
                 case 'PERSONA':
-                    console.error(new NotYetImplementedError('Personas are not implemented yet'));
+                    personaCommandParser.applyToPipelineJson(pipelineJson, command);
+                    //                    <- Note: Prototype of [🍧] (remove this comment after full implementation)
                     break;
                 case 'BOILERPLATE':
                     throw new ParsingError('BOILERPLATE command is only for testing purposes and should not be used in the .ptbk.md file'); // <- TODO: [🚞]
@@ -4644,7 +4742,27 @@ function pipelineStringToJsonSync(pipelineString) {
         var postprocessing = [];
         var expectAmount = {};
         var expectFormat = undefined;
-        var isBlockTypeChanged = false;
+        var isBlockTypeSet = false;
+        var lastLine = section.content.split('\n').pop();
+        var resultingParameterNameMatch = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
+        var resultingParameterName = null;
+        if (resultingParameterNameMatch &&
+            resultingParameterNameMatch.groups !== undefined &&
+            resultingParameterNameMatch.groups.resultingParamName !== undefined) {
+            resultingParameterName = resultingParameterNameMatch.groups.resultingParamName;
+        }
+        var expectResultingParameterName = function () {
+            if (resultingParameterName !== null) {
+                return resultingParameterName;
+            }
+            throw new ParsingError(spaceTrim$1(function (block) { return "\n                    Template section must end with -> {parameterName}\n\n                    Invalid section:\n                    ".concat(block(
+            // TODO: Show code of invalid sections each time + DRY
+            section.content
+                .split('\n')
+                .map(function (line) { return "  | ".concat(line); } /* <- TODO: [🚞] */)
+                .join('\n')), "\n                  "); }));
+        };
+        var _e = extractOneBlockFromMarkdown(section.content), language = _e.language, content = _e.content;
         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;
@@ -4652,15 +4770,24 @@ function pipelineStringToJsonSync(pipelineString) {
                 switch (command.type) {
                     // TODO: [🍧] Use here applyToPipelineJson and remove switch statement
                     case 'BLOCK':
-                        if (isBlockTypeChanged) {
+                        if (isBlockTypeSet) {
                             throw new ParsingError('Block type is already defined in the prompt template. It can be defined only once.');
                         }
                         if (command.blockType === 'SAMPLE') {
-                            console.error(new NotYetImplementedError('Block type SAMPLE is not implemented yet'));
+                            expectResultingParameterName();
+                            var parameter = pipelineJson.parameters.find(function (param) { return param.name === resultingParameterName; });
+                            if (parameter === undefined) {
+                                throw new UnexpectedError("Can not find parameter {".concat(resultingParameterName, "} to assign sample value"));
+                            }
+                            parameter.sampleValues = parameter.sampleValues || [];
+                            parameter.sampleValues.push(content);
                             return "continue-templates";
                         }
                         if (command.blockType === 'KNOWLEDGE') {
-                            console.error(new NotYetImplementedError('Knowledge is not implemented yet'));
+                            knowledgeCommandParser.applyToPipelineJson(pipelineJson, {
+                                type: 'KNOWLEDGE',
+                                source: content, // <- TODO: [🐝] !!!! Work with KNOWLEDGE which not referring to the source file/wweb, but its content itself
+                            });
                             return "continue-templates";
                         }
                         if (command.blockType === 'ACTION') {
@@ -4671,8 +4798,9 @@ function pipelineStringToJsonSync(pipelineString) {
                             console.error(new NotYetImplementedError('Instruments are not implemented yet'));
                             return "continue-templates";
                         }
+                        expectResultingParameterName();
                         blockType = command.blockType;
-                        isBlockTypeChanged = true;
+                        isBlockTypeSet = true;
                         break;
                     case 'EXPECT_AMOUNT':
                         // eslint-disable-next-line no-case-declarations
@@ -4712,16 +4840,20 @@ function pipelineStringToJsonSync(pipelineString) {
                         postprocessing.push(command.functionName);
                         break;
                     case 'KNOWLEDGE':
-                        console.error(new NotYetImplementedError('Knowledge is not implemented yet'));
+                        // TODO: [👙] The knowledge is maybe relevant for just this template
+                        knowledgeCommandParser.applyToPipelineJson(pipelineJson, command);
                         break;
                     case 'ACTION':
+                        // TODO: [👙] The action is maybe relevant for just this template
                         console.error(new NotYetImplementedError('Actions are not implemented yet'));
                         break;
                     case 'INSTRUMENT':
+                        // TODO: [👙] The instrument is maybe relevant for just this template
                         console.error(new NotYetImplementedError('Instruments are not implemented yet'));
                         break;
                     case 'PERSONA':
-                        console.error(new NotYetImplementedError('Personas are not implemented yet'));
+                        personaCommandParser.applyToPipelineJson(pipelineJson, command);
+                        //                    <- Note: Prototype of [🍧] (remove this comment after full implementation)
                         break;
                     case 'BOILERPLATE':
                         console.error(new ParsingError('BOILERPLATE command is only for testing purposes and should not be used in the .ptbk.md file'));
@@ -4739,7 +4871,6 @@ function pipelineStringToJsonSync(pipelineString) {
             }
             finally { if (e_3) throw e_3.error; }
         }
-        var _e = extractOneBlockFromMarkdown(section.content), language = _e.language, content = _e.content;
         if (blockType === 'SCRIPT') {
             if (!language) {
                 throw new ParsingError('You must specify the language of the script in the prompt template');
@@ -4748,22 +4879,12 @@ function pipelineStringToJsonSync(pipelineString) {
                 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                        "); }));
             }
         }
-        var lastLine = section.content.split('\n').pop();
-        var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
-        if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
-            throw new ParsingError(spaceTrim$1(function (block) { return "\n                        Each section must end with -> {parameterName}\n\n                        Invalid section:\n                        ".concat(block(
-            // TODO: Show code of invalid sections each time + DRY
-            section.content
-                .split('\n')
-                .map(function (line) { return "  | ".concat(line); } /* <- TODO: [🚞] */)
-                .join('\n')), "\n                      "); }));
-        }
-        var resultingParameterName = match.groups.resultingParamName;
-        // TODO: [1] DRY description
+        // TODO: [🎾][1] DRY description
         var description_1 = section.content;
-        // Note: Remove codeblocks
+        // Note: Remove codeblocks - TODO: [🎾]
         description_1 = description_1.split(/^```.*^```/gms).join('');
-        //Note: Remove lists and return statement
+        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 === '') {
@@ -4797,13 +4918,13 @@ function pipelineStringToJsonSync(pipelineString) {
             modelRequirements: templateModelRequirements,
             contentLanguage: blockType === 'SCRIPT' ? language : undefined,
             content: content,
-            resultingParameterName: resultingParameterName,
+            resultingParameterName: expectResultingParameterName( /* <- Note: This is once more redundant */),
         };
         if (blockType !== 'PROMPT_TEMPLATE') {
             delete template.modelRequirements;
         }
         // TODO: [🍧] What actually about preparation and pushing the block into `promptTemplates`
-        pipelineJson.promptTemplates.push(template /* <- !!! */);
+        pipelineJson.promptTemplates.push(template);
     };
     try {
         // =============================================================
@@ -4870,6 +4991,8 @@ function pipelineStringToJsonSync(pipelineString) {
  * TODO: Use spaceTrim more effectively
  * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
  * TODO: [🥞] Not optimal parsing because `splitMarkdownIntoSections` is executed twice with same string, once through `flattenMarkdown` and second directly here
+ * TODO: [♈] Probbably move expectations from templates to parameters
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */
 
 /**
@@ -4909,6 +5032,7 @@ function pipelineStringToJson(pipelineString, options) {
 }
 /**
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */
 
 /**
@@ -5042,6 +5166,7 @@ function createCollectionFromDirectory(path, options) {
                     else {
                         colors.green("(In future, not implemented yet) Using your prebuild pipeline collection ".concat(makedLibraryFilePath));
                         // TODO: !! Implement;
+                        // TODO: [🌗]
                     }
                     _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? false : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e;
                     collection = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
@@ -5086,6 +5211,7 @@ function createCollectionFromDirectory(path, options) {
                                                 case 5:
                                                     // TODO: Handle non-valid JSON files
                                                     promptbook = _d.apply(_c, [_e.sent()]);
+                                                    // TODO: [🌗]
                                                     promptbook = __assign(__assign({}, promptbook), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
                                                 case 6:
@@ -5232,6 +5358,126 @@ function listAllFiles(path, isRecursive) {
 }
 /**
  * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+ * Note: [🟢] This code should never be published outside of `@promptbook/node`
+ */
+
+/**
+ * This error type indicates that you try to use a feature that is not available in the current environment
+ */
+var EnvironmentMismatchError = /** @class */ (function (_super) {
+    __extends(EnvironmentMismatchError, _super);
+    function EnvironmentMismatchError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+        return _this;
+    }
+    return EnvironmentMismatchError;
+}(Error));
+
+/**
+ * @@@
+ *
+ * @private for `FilesStorage`
+ */
+function nameToSubfolderPath(name) {
+    return [name.substr(0, 1).toLowerCase(), name.substr(1, 1).toLowerCase()];
+}
+
+/**
+ * @@@
+ */
+var FilesStorage = /** @class */ (function () {
+    function FilesStorage(options) {
+        this.options = options;
+        if (!isRunningInNode()) {
+            throw new EnvironmentMismatchError("FilesStorage works only in Node.js environment");
+        }
+    }
+    /**
+     * @@@
+     */
+    FilesStorage.prototype.getFilenameForKey = function (key) {
+        var name = titleToName(key);
+        var hash = sha256(hexEncoder.parse(name)).toString( /* hex */);
+        return join.apply(void 0, __spreadArray(__spreadArray([this.options.cacheFolderPath], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(name.substring(0, MAX_FILENAME_LENGTH), ".json")], false));
+    };
+    /**
+     * @@@ Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    FilesStorage.prototype.getItem = function (key) {
+        return __awaiter(this, void 0, void 0, function () {
+            var filename, isFileExisting, fileContent, value;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        filename = this.getFilenameForKey(key);
+                        return [4 /*yield*/, stat(filename)
+                                .then(function (fileStat) { return fileStat.isFile(); })
+                                .catch(function () { return false; })];
+                    case 1:
+                        isFileExisting = _a.sent();
+                        if (!isFileExisting) {
+                            return [2 /*return*/, null];
+                        }
+                        return [4 /*yield*/, readFile(filename, 'utf-8')];
+                    case 2:
+                        fileContent = _a.sent();
+                        value = JSON.parse(fileContent);
+                        // TODO: [🌗]
+                        return [2 /*return*/, value];
+                }
+            });
+        });
+    };
+    /**
+     * @@@ Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    FilesStorage.prototype.setItem = function (key, value) {
+        return __awaiter(this, void 0, void 0, function () {
+            var filename, fileContent;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        filename = this.getFilenameForKey(key);
+                        fileContent = JSON.stringify(value, null, 4);
+                        return [4 /*yield*/, mkdir(dirname(filename), { recursive: true })];
+                    case 1:
+                        _a.sent(); // <- [0]
+                        return [4 /*yield*/, writeFile(filename, fileContent, 'utf-8')];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * @@@ Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    FilesStorage.prototype.removeItem = function (key) {
+        return __awaiter(this, void 0, void 0, function () {
+            var filename;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        filename = this.getFilenameForKey(key);
+                        // TODO: [🧠] What to use `unlink` or `rm`
+                        return [4 /*yield*/, unlink(filename)];
+                    case 1:
+                        // TODO: [🧠] What to use `unlink` or `rm`
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return FilesStorage;
+}());
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/node`
+ * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
+ * Note: [🟢] This code should never be published outside of `@promptbook/node`
  */
 
 /**
@@ -5279,7 +5525,7 @@ function getCurrentIsoDate() {
 /**
  * Function computeUsage will create price per one token based on the string value found on openai page
  *
- * @private within the package, used only as internal helper for `OPENAI_MODELS`
+ * @private within the repository, used only as internal helper for `OPENAI_MODELS`
  */
 function computeUsage(value) {
     var _a = __read(value.split(' / '), 2), price = _a[0], tokens = _a[1];
@@ -5352,7 +5598,7 @@ var ANTHROPIC_CLAUDE_MODELS = [
 ];
 /**
  * Note: [🤖] Add models of new variant
- * TODO: !!!! Add embedding models OR Anthropic has only chat+completion models?
+ * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
  * TODO: [🧠] Some mechanism to propagate unsureness
  * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
  * TODO: [🕚] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
@@ -5410,6 +5656,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
                             model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
                             max_tokens: modelRequirements.maxTokens || 4096,
                             //                                            <- TODO: Make some global max cap for maxTokens
+                            // <- TODO: !!!!! Use here `systemMessage`, `temperature` and `seed`
                             messages: [
                                 {
                                     role: 'user',
@@ -5479,6 +5726,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
             model: rawResponse.model || model,
             max_tokens: modelRequirements.maxTokens || 2000, // <- Note: 2000 is for lagacy reasons
             //                                                  <- TODO: Make some global max cap for maxTokens
+            // <- TODO: Use here `systemMessage`, `temperature` and `seed`
         };
 
         const rawRequest: xxxx.Completions.CompletionCreateParamsNonStreaming = {
@@ -5565,201 +5813,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
  * TODO: [🧠] Maybe handle errors via transformAnthropicError (like transformAzureError)
  * TODO: Maybe Create some common util for callChatModel and callCompletionModel
  * TODO: Maybe make custom OpenaiError
- */
-
-/**
- * Gets the expectations and creates a fake text that meets the expectations
- *
- * Note: You can provide postprocessing functions to modify the text before checking the expectations
- *       The result will be the text BEFORE the postprocessing
- *
- * @private internal util for MockedFackedLlmExecutionTools
- */
-function $fakeTextToExpectations(expectations, postprocessing) {
-    return __awaiter(this, void 0, void 0, function () {
-        var lorem, loremText, text, loopLimit, textToCheck, _a, _b, func, e_1_1;
-        var e_1, _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
-                case 0:
-                    lorem = new LoremIpsum({
-                        wordsPerSentence: { min: 5, max: 15 },
-                        sentencesPerParagraph: { min: 5, max: 15 },
-                    });
-                    loremText = '';
-                    text = '';
-                    loopLimit = CHARACTER_LOOP_LIMIT;
-                    _d.label = 1;
-                case 1:
-                    if (!(loopLimit-- > 0)) return [3 /*break*/, 11];
-                    textToCheck = text;
-                    _d.label = 2;
-                case 2:
-                    _d.trys.push([2, 7, 8, 9]);
-                    _a = (e_1 = void 0, __values(postprocessing || [])), _b = _a.next();
-                    _d.label = 3;
-                case 3:
-                    if (!!_b.done) return [3 /*break*/, 6];
-                    func = _b.value;
-                    return [4 /*yield*/, func(textToCheck)];
-                case 4:
-                    textToCheck = _d.sent();
-                    _d.label = 5;
-                case 5:
-                    _b = _a.next();
-                    return [3 /*break*/, 3];
-                case 6: return [3 /*break*/, 9];
-                case 7:
-                    e_1_1 = _d.sent();
-                    e_1 = { error: e_1_1 };
-                    return [3 /*break*/, 9];
-                case 8:
-                    try {
-                        if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
-                    }
-                    finally { if (e_1) throw e_1.error; }
-                    return [7 /*endfinally*/];
-                case 9:
-                    if (isPassingExpectations(expectations, textToCheck)) {
-                        return [2 /*return*/, text]; // <- Note: Returning the text because the postprocessing
-                    }
-                    if (loremText === '') {
-                        loremText = lorem.generateParagraphs(1) + '\n\n';
-                    }
-                    text += loremText.substring(0, 1);
-                    loremText = loremText.substring(1);
-                    _d.label = 10;
-                case 10: return [3 /*break*/, 1];
-                case 11: throw new Error(spaceTrim$1(function (block) { return "\n                Can not generate fake text to met the expectations\n\n                Loop limit reached\n                The expectations:\n                ".concat(block(JSON.stringify(expectations, null, 4)), "\n\n                The draft text:\n                ").concat(block(text), "\n\n            "); }));
-            }
-        });
-    });
-}
-/**
- * TODO: [💝] Unite object for expecting amount and format - use here also a format
- */
-
-/**
- * Mocked execution Tools for just faking expected responses for testing purposes
- */
-var MockedFackedLlmExecutionTools = /** @class */ (function () {
-    function MockedFackedLlmExecutionTools(options) {
-        if (options === void 0) { options = {}; }
-        this.options = options;
-    }
-    Object.defineProperty(MockedFackedLlmExecutionTools.prototype, "title", {
-        get: function () {
-            return 'Mocked facked';
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(MockedFackedLlmExecutionTools.prototype, "description", {
-        get: function () {
-            return 'Use faked lorem ipsum data - just for testing';
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * Fakes chat model
-     */
-    MockedFackedLlmExecutionTools.prototype.callChatModel = function (prompt) {
-        return __awaiter(this, void 0, void 0, function () {
-            var content, result;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (this.options.isVerbose) {
-                            console.info('💬 Mocked faked prompt', prompt);
-                        }
-                        return [4 /*yield*/, $fakeTextToExpectations(prompt.expectations || {
-                                sentences: { min: 1, max: 1 },
-                            }, prompt.postprocessing)];
-                    case 1:
-                        content = _a.sent();
-                        result = {
-                            content: content,
-                            modelName: 'mocked-facked',
-                            timing: {
-                                start: getCurrentIsoDate(),
-                                complete: getCurrentIsoDate(),
-                            },
-                            usage: addUsage( /* <- TODO: [🧠] Compute here at least words, characters,... etc */),
-                            rawResponse: {
-                                note: 'This is mocked echo',
-                            },
-                            // <- [🤹‍♂️]
-                        };
-                        if (this.options.isVerbose) {
-                            console.info('💬 Mocked faked result', result);
-                        }
-                        return [2 /*return*/, result];
-                }
-            });
-        });
-    };
-    /**
-     * Fakes completion model
-     */
-    MockedFackedLlmExecutionTools.prototype.callCompletionModel = function (prompt) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.callChatModel(prompt)];
-            });
-        });
-    };
-    /**
-     * Fakes embedding model
-     */
-    MockedFackedLlmExecutionTools.prototype.callEmbeddingModel = function (prompt) {
-        return __awaiter(this, void 0, void 0, function () {
-            var content, result;
-            return __generator(this, function (_a) {
-                content = new Array(25).fill(0).map(function () { return Math.random() * 2 - 1; });
-                result = {
-                    content: content,
-                    modelName: 'mocked-facked',
-                    timing: {
-                        start: getCurrentIsoDate(),
-                        complete: getCurrentIsoDate(),
-                    },
-                    usage: addUsage( /* <- TODO: [🧠] Compute here at least words, characters,... etc */),
-                    rawResponse: {
-                        note: 'This is mocked embedding',
-                    },
-                    // <- [🤹‍♂️]
-                };
-                if (this.options.isVerbose) {
-                    console.info('💬 Mocked faked result', result);
-                }
-                return [2 /*return*/, result];
-            });
-        });
-    };
-    // <- Note: [🤖] callXxxModel
-    /**
-     * List all available fake-models that can be used
-     */
-    MockedFackedLlmExecutionTools.prototype.listModels = function () {
-        return [
-            {
-                modelTitle: 'Fake chat',
-                modelName: 'mocked-echo',
-                modelVariant: 'CHAT',
-            },
-            {
-                modelTitle: 'Fake completion',
-                modelName: 'mocked-echo',
-                modelVariant: 'COMPLETION',
-            },
-            // <- Note: [🤖]
-        ];
-    };
-    return MockedFackedLlmExecutionTools;
-}());
-/**
- * TODO: [🕵️‍♀️] Maybe just remove
+ * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
  */
 
 /**
@@ -6109,6 +6163,7 @@ var OPENAI_MODELS = [
  * @see /other/playground/playground.ts
  * TODO: [🍓] Make better
  * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
+ * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
  */
 
 /**
@@ -6200,6 +6255,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             model: model,
                             max_tokens: modelRequirements.maxTokens,
                             //                                   <- TODO: Make some global max cap for maxTokens
+                            // <- TODO: !!!!! Use here `systemMessage`, `temperature` and `seed`
                         };
                         if (expectFormat === 'JSON') {
                             modelSettings.response_format = {
@@ -6273,6 +6329,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             model: model,
                             max_tokens: modelRequirements.maxTokens || 2000, // <- Note: 2000 is for lagacy reasons
                             //                                                  <- TODO: Make some global max cap for maxTokens
+                            // <- TODO: !!!!! Use here `systemMessage`, `temperature` and `seed`
                         };
                         rawRequest = __assign(__assign({}, modelSettings), { prompt: content, user: this.options.user });
                         start = getCurrentIsoDate();
@@ -6423,6 +6480,236 @@ var OpenAiExecutionTools = /** @class */ (function () {
  * TODO: [🧠][🧙‍♂️] Maybe there can be some wizzard for thoose who want to use just OpenAI
  * TODO: Maybe Create some common util for callChatModel and callCompletionModel
  * TODO: Maybe make custom OpenaiError
+ * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+ */
+
+/**
+ * @@@
+ *
+ * Note: This function is not cached, every call creates new instance of LlmExecutionTools
+ *
+ * It looks for environment variables:
+ * - `process.env.OPENAI_API_KEY`
+ * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ *
+ * @returns @@@
+ */
+function createLlmToolsFromEnv() {
+    if (!isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `createLlmToolsFromEnv` works only in Node.js environment');
+    }
+    var llmTools = [];
+    if (typeof process.env.OPENAI_API_KEY === 'string') {
+        llmTools.push(new OpenAiExecutionTools({
+            isVerbose: true,
+            apiKey: process.env.OPENAI_API_KEY,
+        }));
+    }
+    if (typeof process.env.ANTHROPIC_CLAUDE_API_KEY === 'string') {
+        llmTools.push(new AnthropicClaudeExecutionTools({
+            isVerbose: true,
+            apiKey: process.env.ANTHROPIC_CLAUDE_API_KEY,
+        }));
+    }
+    if (llmTools.length === 0) {
+        throw new Error(spaceTrim("\n                No LLM tools found in the environment\n\n                Please set one of environment variables:\n                - OPENAI_API_KEY\n                - ANTHROPIC_CLAUDE_API_KEY\n            "));
+    }
+    else if (llmTools.length === 1) {
+        return llmTools[0];
+    }
+    else {
+        return joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(llmTools), false));
+    }
+}
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/node`
+ * TODO: @@@ write discussion about this - wizzard
+ * TODO: Add Azure
+ * TODO: [🧠] Which name is better `createLlmToolsFromEnv` or `createLlmToolsFromEnvironment`?
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠] Maybe pass env as argument
+ * Note: [🟢] This code should never be published outside of `@promptbook/node`
+ */
+
+/**
+ * Stores
+ */
+var MemoryStorage = /** @class */ (function () {
+    function MemoryStorage() {
+        this.storage = {};
+    }
+    Object.defineProperty(MemoryStorage.prototype, "length", {
+        /**
+         * Returns the number of key/value pairs currently present in the list associated with the object.
+         */
+        get: function () {
+            return Object.keys(this.storage).length;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Empties the list associated with the object of all key/value pairs, if there are any.
+     */
+    MemoryStorage.prototype.clear = function () {
+        this.storage = {};
+    };
+    /**
+     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    MemoryStorage.prototype.getItem = function (key) {
+        return this.storage[key] || null;
+    };
+    /**
+     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+     */
+    MemoryStorage.prototype.key = function (index) {
+        return Object.keys(this.storage)[index] || null;
+    };
+    /**
+     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    MemoryStorage.prototype.setItem = function (key, value) {
+        this.storage[key] = value;
+    };
+    /**
+     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    MemoryStorage.prototype.removeItem = function (key) {
+        delete this.storage[key];
+    };
+    return MemoryStorage;
+}());
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/core`
+ */
+
+/**
+ * Simple wrapper `new Date().toISOString()`
+ *
+ * @returns string_date branded type
+ */
+function $currentDate() {
+    return new Date().toISOString();
+}
+
+/**
+ * Intercepts LLM tools and counts total usage of the tools
+ *
+ * @param llmTools LLM tools to be intercepted with usage counting
+ * @returns LLM tools with same functionality with added total cost counting
+ */
+function cacheLlmTools(llmTools, options) {
+    var _this = this;
+    if (options === void 0) { options = {}; }
+    var _a = options.storage, storage = _a === void 0 ? new MemoryStorage() : _a;
+    var proxyTools = {
+        get title() {
+            // TODO: [🧠] Maybe put here some suffix
+            return llmTools.title;
+        },
+        get description() {
+            // TODO: [🧠] Maybe put here some suffix
+            return llmTools.description;
+        },
+        listModels: function () {
+            // TODO: [🧠] Should be model listing also cached?
+            return /* not await */ llmTools.listModels();
+        },
+    };
+    var callCommonModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+        var key, cacheItem, promptResult, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
+                        '-' +
+                        sha256(hexEncoder.parse(JSON.stringify(prompt.parameters))).toString( /* hex */));
+                    return [4 /*yield*/, storage.getItem(key)];
+                case 1:
+                    cacheItem = _b.sent();
+                    if (cacheItem) {
+                        return [2 /*return*/, cacheItem.promptResult];
+                    }
+                    _a = prompt.modelRequirements.modelVariant;
+                    switch (_a) {
+                        case 'CHAT': return [3 /*break*/, 2];
+                        case 'COMPLETION': return [3 /*break*/, 4];
+                        case 'EMBEDDING': return [3 /*break*/, 6];
+                    }
+                    return [3 /*break*/, 8];
+                case 2: return [4 /*yield*/, llmTools.callChatModel(prompt)];
+                case 3:
+                    promptResult = _b.sent();
+                    return [3 /*break*/, 9];
+                case 4: return [4 /*yield*/, llmTools.callCompletionModel(prompt)];
+                case 5:
+                    promptResult = _b.sent();
+                    return [3 /*break*/, 9];
+                case 6: return [4 /*yield*/, llmTools.callEmbeddingModel(prompt)];
+                case 7:
+                    promptResult = _b.sent();
+                    return [3 /*break*/, 9];
+                case 8: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
+                case 9: return [4 /*yield*/, storage.setItem(key, {
+                        date: $currentDate(),
+                        promptbookVersion: PROMPTBOOK_VERSION,
+                        prompt: prompt,
+                        promptResult: promptResult,
+                    })];
+                case 10:
+                    _b.sent();
+                    return [2 /*return*/, promptResult];
+            }
+        });
+    }); };
+    if (llmTools.callChatModel !== undefined) {
+        proxyTools.callChatModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+            });
+        }); };
+    }
+    if (llmTools.callCompletionModel !== undefined) {
+        proxyTools.callCompletionModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+            });
+        }); };
+    }
+    if (llmTools.callEmbeddingModel !== undefined) {
+        proxyTools.callEmbeddingModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+            });
+        }); };
+    }
+    // <- Note: [🤖]
+    return proxyTools;
+}
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/core`
+ * TODO: @@@ write discussion about this and storages
+ *            write how to combine multiple interceptors
+ * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ */
+
+/**
+ * Returns LLM tools for CLI
+ *
+ * @private within the repository - for CLI utils
+ */
+function getLlmToolsForCli() {
+    if (!isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `getLlmToolsForTestingAndScriptsAndPlayground` works only in Node.js environment');
+    }
+    return cacheLlmTools(createLlmToolsFromEnv(), {
+        storage: new FilesStorage({ cacheFolderPath: join(process.cwd(), '/.promptbook/executions-cache') }),
+    });
+}
+/**
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
  */
 
 /**
@@ -6441,7 +6728,6 @@ function initializeMakeCommand(program) {
     helloCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
     helloCommand.option('--verbose', "Is verbose", false);
     helloCommand.option('-o, --out-file <path>', spaceTrim("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), PIPELINE_COLLECTION_BASE_FILENAME);
-    // TODO: !!! Auto-detect AI api keys + explicit api keys as argv
     helloCommand.action(function (path, _a) {
         var projectName = _a.projectName, format = _a.format, validation = _a.validation, verbose = _a.verbose, outFile = _a.outFile;
         return __awaiter(_this, void 0, void 0, function () {
@@ -6451,7 +6737,6 @@ function initializeMakeCommand(program) {
             return __generator(this, function (_f) {
                 switch (_f.label) {
                     case 0:
-                        console.info('!!!', { projectName: projectName, path: path, format: format, validation: validation, verbose: verbose, outFile: outFile });
                         isVerbose = verbose;
                         formats = (format || '')
                             .split(',')
@@ -6465,17 +6750,7 @@ function initializeMakeCommand(program) {
                             console.error(colors.red("You can use only one format when saving to a file"));
                             process.exit(1);
                         }
-                        llmTools = joinLlmExecutionTools(
-                        // TODO: !!!! Remove mocked
-                        new MockedFackedLlmExecutionTools({
-                            isVerbose: isVerbose,
-                        }), new AnthropicClaudeExecutionTools({
-                            isVerbose: isVerbose,
-                            apiKey: process.env.ANTHROPIC_CLAUDE_API_KEY,
-                        }), new OpenAiExecutionTools({
-                            isVerbose: isVerbose,
-                            apiKey: process.env.OPENAI_API_KEY,
-                        }));
+                        llmTools = getLlmToolsForCli();
                         return [4 /*yield*/, createCollectionFromDirectory(path, {
                                 llmTools: llmTools,
                                 isVerbose: isVerbose,
@@ -6592,11 +6867,14 @@ function initializeMakeCommand(program) {
         });
     });
 }
+/**
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ */
 
 /**
  * Add or modify an auto-generated section in a markdown file
  *
- * @private within the package
+ * @private within the repository
  */
 function addAutoGeneratedSection(content, options) {
     var sectionName = options.sectionName, sectionContent = options.sectionContent;
@@ -6608,7 +6886,10 @@ function addAutoGeneratedSection(content, options) {
     }
     var placeForSection = removeContentComments(content).match(/^##.*$/im);
     if (!placeForSection) {
-        throw new Error("No place where to put the section <!--".concat(sectionName, "-->"));
+        throw new ParsingError(
+        // <- [🧠] Maybe something better than `ParsingError`
+        "No place where to put the section <!--".concat(sectionName, "-->"));
+        // <- [🚞]
     }
     var _a = __read(placeForSection, 1), heading = _a[0];
     return content.replace(heading, "<!--".concat(sectionName, "-->\n").concat(warningLine, "\n").concat(sectionContent, "\n<!--/").concat(sectionName, "-->\n\n").concat(heading));
@@ -6848,6 +7129,9 @@ function initializePrettifyCommand(program) {
         });
     });
 }
+/**
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ */
 
 /**
  * Runs CLI utilities of Promptbook package
@@ -6857,7 +7141,7 @@ function promptbookCli() {
         var program;
         return __generator(this, function (_a) {
             if (!isRunningInNode()) {
-                throw new Error(spaceTrim$1("\n                Function promptbookCli is initiator of CLI script and should be run in Node.js environment.\n\n                - In browser use function exported from `@promptbook/utils` or  `@promptbook/core` directly, for example `prettifyPipelineString`.\n\n            "));
+                throw new EnvironmentMismatchError(spaceTrim$1("\n                Function promptbookCli is initiator of CLI script and should be run in Node.js environment.\n\n                - In browser use function exported from `@promptbook/utils` or  `@promptbook/core` directly, for example `prettifyPipelineString`.\n\n            "));
             }
             program = new commander.Command();
             program.name('promptbook');
@@ -6875,6 +7159,7 @@ function promptbookCli() {
  * TODO: [🥠] Do not export to utils directly, its just for CLI script
  * TODO: [🕌] When more functionalities, rename
  * Note: 11:11
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
  */
 
 // @promptbook/cli