@promptbook/core 0.61.0-10 → 0.61.0-12

package/esm/index.es.js

@@ -385,7 +385,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
  */
@@ -406,6 +406,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
+*/
+// [🟡][🟢][🔵][⚪]
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -779,6 +783,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
@@ -819,7 +829,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
@@ -1288,7 +1298,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"}];
 
 var defaultDiacriticsRemovalMap = [
     {
@@ -1844,7 +1854,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 () {
@@ -1890,6 +1900,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
  */
 
 /**
@@ -1960,8 +1972,11 @@ function arrayableToArray(input) {
 /**
  * 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`
+ */
 
 /**
  * Counts number of characters in the text
@@ -2164,7 +2179,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 () {
@@ -2240,7 +2254,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 () {
@@ -2687,10 +2704,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
  */
 
 /**
@@ -2701,6 +2720,7 @@ function createPipelineExecutor(options) {
  *
  * @param value any values
  * @returns void
+ * @private within the repository
  */
 function TODO_USE() {
     var value = [];
@@ -2708,7 +2728,6 @@ function TODO_USE() {
         value[_i] = arguments[_i];
     }
 }
-// TODO: !!!! Find ACRY all just(...) and replace with TODO_USE
 
 /**
  * @@@
@@ -2837,6 +2856,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
  */
@@ -2845,7 +2865,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 () {
@@ -2860,7 +2879,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();
@@ -2898,6 +2917,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,_]]
@@ -2910,36 +2930,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
@@ -2963,7 +3012,7 @@ function preparePipeline(pipeline, options) {
                     knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                     currentPreparation = {
                         id: 1,
-                        date: $currentDate(),
+                        // TODO: [🍥]> date: $currentDate(),
                         promptbookVersion: PROMPTBOOK_VERSION,
                         modelUsage: addUsage(),
                     };
@@ -2972,8 +3021,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) {
@@ -2981,7 +3030,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*/];
                                 }
                             });
@@ -3000,11 +3049,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.
@@ -3144,7 +3368,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',
@@ -3160,13 +3384,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,
         };
     },
 };
@@ -3409,92 +3632,12 @@ var jokerCommandParser = {
     },
 };
 
-/**
- * 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,
-        };
-    },
-};
-
 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: [🧠][🈁] `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
@@ -3636,59 +3779,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;
@@ -3875,22 +3965,6 @@ var urlCommandParser = {
     },
 };
 
-/**
- * Returns the same value that is passed as argument.
- * No side effects.
- *
- * Note: It can be usefull for leveling indentation
- *
- * @param value any values
- * @returns the same values
- */
-function just(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value;
-}
-
 /**
  * Parses the action command
  *
@@ -3922,7 +3996,8 @@ var actionCommandParser = {
      * Parses the ACTION command
      */
     parse: function (input) {
-        input.args;
+        var args = input.args;
+        TODO_USE(args);
         return {
             type: 'ACTION',
         };
@@ -3960,7 +4035,8 @@ var instrumentCommandParser = {
      * Parses the INSTRUMENT command
      */
     parse: function (input) {
-        input.args;
+        var args = input.args;
+        TODO_USE(args);
         return {
             type: 'INSTRUMENT',
         };
@@ -4018,6 +4094,7 @@ var boilerplateCommandParser = {
 };
 /**
  * TODO: [💐] Implement BOILERPLATE command into `pipelineStringToJsonSync` function
+ * Note: [⚪] This should never be in any released package
  */
 
 /**
@@ -4036,7 +4113,7 @@ var COMMANDS = [
     actionCommandParser,
     instrumentCommandParser,
     personaCommandParser,
-    boilerplateCommandParser, // <- TODO: !!!! Only in development, remove in production
+    boilerplateCommandParser, // <- TODO: !! Only in development, remove in production
 ];
 
 /**
@@ -4122,7 +4199,7 @@ function parseCommand(raw, usagePlace) {
     }));
 }
 /**
- * !!!
+ * @@@
  */
 function getSupportedCommandsMessage() {
     return COMMANDS.flatMap(function (_a) {
@@ -4133,7 +4210,7 @@ function getSupportedCommandsMessage() {
     }).join('\n');
 }
 /**
- * !!!
+ * @@@
  */
 function parseCommandVariant(input) {
     var e_1, _a;
@@ -4142,7 +4219,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 }) };
@@ -4252,25 +4328,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';
                 }
@@ -4286,11 +4379,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.
@@ -4308,13 +4403,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
  */
 
 /**
@@ -4324,13 +4418,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 };
 }
@@ -4712,7 +4806,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) {
@@ -4731,11 +4825,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 === '') {
@@ -4763,7 +4858,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'));
@@ -4772,7 +4867,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: [🚞]
@@ -4801,7 +4897,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;
@@ -4809,15 +4925,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') {
@@ -4828,8 +4953,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
@@ -4869,16 +4995,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'));
@@ -4896,7 +5026,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');
@@ -4905,22 +5034,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 === '') {
@@ -4954,13 +5073,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 {
         // =============================================================
@@ -5027,6 +5146,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
  */
 
 /**
@@ -5066,12 +5187,13 @@ 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
  */
 
 /**
  * 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;
@@ -5083,7 +5205,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));
@@ -5257,15 +5382,15 @@ var CollectionError = /** @class */ (function (_super) {
 /**
  * This error type indicates that the version of the pipeline is not matching the expected version
  */
-var VersionMismatch = /** @class */ (function (_super) {
-    __extends(VersionMismatch, _super);
-    function VersionMismatch(message, expectedVersion) {
+var VersionMismatchError = /** @class */ (function (_super) {
+    __extends(VersionMismatchError, _super);
+    function VersionMismatchError(message, expectedVersion) {
         var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    This error indicates that there is error with compatibility\n\n                    Expected version:\n                    ").concat(expectedVersion, "\n\n                    Current version:\n                    ").concat(PROMPTBOOK_VERSION, "\n\n                "); })) || this;
         _this.name = 'UnexpectedError';
-        Object.setPrototypeOf(_this, VersionMismatch.prototype);
+        Object.setPrototypeOf(_this, VersionMismatchError.prototype);
         return _this;
     }
-    return VersionMismatch;
+    return VersionMismatchError;
 }(Error));
 
 /**
@@ -5355,6 +5480,9 @@ var SimplePromptInterfaceTools = /** @class */ (function () {
     };
     return SimplePromptInterfaceTools;
 }());
+/**
+ * Note: [🔵] This code should never be published outside of `@promptbook/browser`
+ */
 
 /**
  * Unprepare just strips the preparation data of the pipeline
@@ -5366,6 +5494,7 @@ function unpreparePipeline(pipeline) {
     return __assign(__assign({}, pipeline), { knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
 }
 /**
+ * TODO: [🔼] !!! Export via `@promptbook/core`
  * TODO: Write tests for `preparePipeline`
  */
 
@@ -5380,7 +5509,7 @@ var ExecutionReportStringOptionsDefaults = {
 /**
  * Format either small or big number
  *
- * @private within the package
+ * @private within the repository
  */
 function formatNumber(value) {
     if (value === 0) {
@@ -5400,7 +5529,7 @@ function formatNumber(value) {
 /**
  * Create a markdown table from a 2D array of strings
  *
- * @private within the package
+ * @private within the repository
  */
 function createMarkdownTable(table) {
     var columnWidths = table.reduce(function (widths, row) {
@@ -5428,7 +5557,7 @@ function createMarkdownTable(table) {
 /**
  * Function createMarkdownChart will draw a chart in markdown from ⬛+🟦 tiles
  *
- * @private within the package
+ * @private within the repository
  */
 function createMarkdownChart(options) {
     var e_1, _a;
@@ -5469,6 +5598,23 @@ function escapeMarkdownBlock(value) {
     return value.replace(/```/g, '\\`\\`\\`');
 }
 
+/**
+ * Returns the same value that is passed as argument.
+ * No side effects.
+ *
+ * Note: It can be usefull for leveling indentation
+ *
+ * @param value any values
+ * @returns the same values
+ * @private within the repository
+ */
+function just(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value;
+}
+
 /**
  * The thresholds for the relative time in the `moment` NPM package.
  *
@@ -5481,7 +5627,7 @@ var MOMENT_ARG_THRESHOLDS = {
 /**
  * Count the duration of working time
  *
- * @private within the package
+ * @private within the repository
  */
 function countWorkingDuration(items) {
     var e_1, _a;
@@ -5679,5 +5825,5 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Allow to filter out some parts of the report by options
  */
 
-export { BlockTypes, CallbackInterfaceTools, CollectionError, ExecutionReportStringOptionsDefaults, ExpectError, NotFoundError, PROMPTBOOK_VERSION, ParsingError, PipelineExecutionError, PipelineLogicError, RESERVED_PARAMETER_NAMES, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, UnexpectedError, VersionMismatch, addUsage, assertsExecutionSuccessful, checkExpectations, collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, joinLlmExecutionTools, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, preparePipeline, prettifyPipelineString, unpreparePipeline, usageToWorktime, validatePipeline };
+export { BlockTypes, CallbackInterfaceTools, CollectionError, ExecutionReportStringOptionsDefaults, ExpectError, NotFoundError, PROMPTBOOK_VERSION, ParsingError, PipelineExecutionError, PipelineLogicError, RESERVED_PARAMETER_NAMES, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, UnexpectedError, VersionMismatchError, addUsage, assertsExecutionSuccessful, checkExpectations, collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, joinLlmExecutionTools, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, preparePipeline, prettifyPipelineString, unpreparePipeline, usageToWorktime, validatePipeline };
 //# sourceMappingURL=index.es.js.map