@promptbook/node 0.61.0-10 → 0.61.0-12

package/umd/index.umd.js

@@ -149,6 +149,10 @@
         // <- 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
@@ -315,7 +319,7 @@
         });
     }
 
-    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
@@ -555,7 +559,7 @@
         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
      */
@@ -932,6 +936,12 @@
      *     >  * -   ...
      *     >  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
@@ -972,7 +982,7 @@
         /**
          * Constructs a pipeline collection from promptbooks
          *
-         * @param promptbooks !!!
+         * @param promptbooks @@@
          *
          * @private Use instead `createCollectionFromJson`
          * Note: During the construction logic of all promptbooks are validated
@@ -1613,7 +1623,7 @@
         };
         /**
          * 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 () {
@@ -1659,6 +1669,8 @@
     }());
     /**
      * 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
      */
 
     /**
@@ -1729,8 +1741,11 @@
     /**
      * 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
@@ -1912,7 +1927,6 @@
         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 () {
@@ -1988,7 +2002,10 @@
                                         : '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 () {
@@ -2435,10 +2452,12 @@
     }
     /**
      * 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
      */
 
     /**
@@ -2449,6 +2468,7 @@
      *
      * @param value any values
      * @returns void
+     * @private within the repository
      */
     function TODO_USE() {
         var value = [];
@@ -2456,7 +2476,6 @@
             value[_i] = arguments[_i];
         }
     }
-    // TODO: !!!! Find ACRY all just(...) and replace with TODO_USE
 
     /**
      * @@@
@@ -2585,6 +2604,7 @@
         });
     }
     /**
+     * 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
      */
@@ -2593,7 +2613,6 @@
      * 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 () {
@@ -2608,7 +2627,7 @@
                                 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();
@@ -2646,6 +2665,7 @@
     > ):
     */
     /**
+     * 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,_]]
@@ -2658,37 +2678,66 @@
      * 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
+     * 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
      */
 
-    /**
-     * Simple wrapper `new Date().toISOString()`
-     *
-     * @returns string_date branded type
-     */
-    function $currentDate() {
-        return new Date().toISOString();
-    }
-
     /**
      * Prepare pipeline from string (markdown) format to JSON format
      *
@@ -2711,7 +2760,7 @@
                         knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                         currentPreparation = {
                             id: 1,
-                            date: $currentDate(),
+                            // TODO: [🍥]> date: $currentDate(),
                             promptbookVersion: PROMPTBOOK_VERSION,
                             modelUsage: addUsage(),
                         };
@@ -2720,8 +2769,8 @@
                             // <- 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) {
@@ -2729,7 +2778,7 @@
                                         case 1:
                                             modelRequirements = _a.sent();
                                             preparedPersona = __assign(__assign({}, persona), { modelRequirements: modelRequirements, preparationIds: [/* TODO: [🧊] -> */ currentPreparation.id] });
-                                            preparedPersonas.push(preparedPersona);
+                                            preparedPersonas[index] = preparedPersona;
                                             return [2 /*return*/];
                                     }
                                 });
@@ -2748,12 +2797,187 @@
         });
     }
     /**
+     * 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__default["default"]("\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__default["default"]('\n\n' + personaDescription);
+        },
+    };
+
     /**
      * Removes Markdown formatting tags from a string.
      *
@@ -2909,7 +3133,7 @@
             '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',
@@ -2925,13 +3149,12 @@
             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__default["default"](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,
             };
         },
     };
@@ -3174,92 +3397,12 @@
         },
     };
 
-    /**
-     * 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
@@ -3401,59 +3544,6 @@
         },
     };
 
-    /**
-     * 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;
@@ -3671,7 +3761,8 @@
          * Parses the ACTION command
          */
         parse: function (input) {
-            input.args;
+            var args = input.args;
+            TODO_USE(args);
             return {
                 type: 'ACTION',
             };
@@ -3709,7 +3800,8 @@
          * Parses the INSTRUMENT command
          */
         parse: function (input) {
-            input.args;
+            var args = input.args;
+            TODO_USE(args);
             return {
                 type: 'INSTRUMENT',
             };
@@ -3767,6 +3859,7 @@
     };
     /**
      * TODO: [💐] Implement BOILERPLATE command into `pipelineStringToJsonSync` function
+     * Note: [⚪] This should never be in any released package
      */
 
     /**
@@ -3785,7 +3878,7 @@
         actionCommandParser,
         instrumentCommandParser,
         personaCommandParser,
-        boilerplateCommandParser, // <- TODO: !!!! Only in development, remove in production
+        boilerplateCommandParser, // <- TODO: !! Only in development, remove in production
     ];
 
     /**
@@ -3871,7 +3964,7 @@
         }));
     }
     /**
-     * !!!
+     * @@@
      */
     function getSupportedCommandsMessage() {
         return COMMANDS.flatMap(function (_a) {
@@ -3882,7 +3975,7 @@
         }).join('\n');
     }
     /**
-     * !!!
+     * @@@
      */
     function parseCommandVariant(input) {
         var e_1, _a;
@@ -3891,7 +3984,6 @@
         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 }) };
@@ -4001,25 +4093,42 @@
         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';
                     }
@@ -4035,11 +4144,13 @@
             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.
@@ -4057,13 +4168,12 @@
     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__default["default"](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
      */
 
     /**
@@ -4073,13 +4183,13 @@
         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__default["default"](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 };
     }
@@ -4461,7 +4571,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new ParsingError(spaceTrim.spaceTrim(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.spaceTrim(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) {
@@ -4480,11 +4590,12 @@
         // =============================================================
         // 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.spaceTrim(description);
         if (description === '') {
@@ -4512,7 +4623,7 @@
                         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'));
@@ -4521,7 +4632,8 @@
                         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: [🚞]
@@ -4550,7 +4662,27 @@
             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.spaceTrim(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;
@@ -4558,15 +4690,24 @@
                     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') {
@@ -4577,8 +4718,9 @@
                                 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
@@ -4618,16 +4760,20 @@
                             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'));
@@ -4645,7 +4791,6 @@
                 }
                 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');
@@ -4654,22 +4799,12 @@
                     throw new ParsingError(spaceTrim.spaceTrim(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.spaceTrim(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.spaceTrim(description_1);
             if (description_1 === '') {
@@ -4703,13 +4838,13 @@
                 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 {
             // =============================================================
@@ -4776,6 +4911,8 @@
      * 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
      */
 
     /**
@@ -4815,6 +4952,7 @@
     }
     /**
      * 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
      */
 
     /**
@@ -4843,6 +4981,9 @@
      * 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`
+     */
 
     /**
      * Constructs Promptbook from async sources
@@ -4961,6 +5102,7 @@
                         else {
                             colors__default["default"].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 () {
@@ -5005,6 +5147,7 @@
                                                     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:
@@ -5151,6 +5294,7 @@
     }
     /**
      * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+     * Note: [🟢] This code should never be published outside of `@promptbook/node`
      */
 
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;