@promptbook/node 0.61.0-22 → 0.61.0-24

package/umd/index.umd.js

@@ -191,15 +191,26 @@
      * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
      */
     var PIPELINE_COLLECTION_BASE_FILENAME = "index";
+    /**
+     * Nonce which is used for replacing things in strings
+     */
+    var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
     /**
      * The names of the parameters that are reserved for special purposes
      */
     var RESERVED_PARAMETER_NAMES = deepFreeze([
         'context',
+        'knowledge',
+        'samples',
+        'modelName',
         'currentDate',
         // <- TODO: Add more like 'date', 'modelName',...
         // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
     ]);
+    /**
+     * @@@
+     */
+    var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
     /*
     TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
     */
@@ -643,7 +654,7 @@
         });
     }
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.61.0-21",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"knowledge"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-21",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-21",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-21",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-21",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {content}",expectations:{words:{min:1,max:8}},dependentParameterNames:["content"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-21",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-21",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-21",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.61.0-23",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-23",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-23",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-23",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-23",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {content}",expectations:{words:{min:1,max:8}},dependentParameterNames:["content"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-23",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-23",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-23",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"}];
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -911,7 +922,7 @@
                     throw new PipelineLogicError("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
                 }
                 if (RESERVED_PARAMETER_NAMES.includes(template.resultingParameterName)) {
-                    throw new PipelineLogicError("Parameter name {".concat(template.resultingParameterName, "} is reserved, please use fifferent name"));
+                    throw new PipelineLogicError("Parameter name {".concat(template.resultingParameterName, "} is reserved, please use different name"));
                 }
                 definedParameters.add(template.resultingParameterName);
                 if (template.blockType === 'PROMPT_TEMPLATE' && template.modelRequirements.modelVariant === undefined) {
@@ -1081,14 +1092,17 @@
      * Unprepare just strips the preparation data of the pipeline
      */
     function unpreparePipeline(pipeline) {
-        var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources;
+        var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources, promptTemplates = pipeline.promptTemplates;
         personas = personas.map(function (persona) { return (__assign(__assign({}, persona), { modelRequirements: undefined, preparationIds: undefined })); });
         knowledgeSources = knowledgeSources.map(function (knowledgeSource) { return (__assign(__assign({}, knowledgeSource), { preparationIds: undefined })); });
-        return __assign(__assign({}, pipeline), { knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
+        promptTemplates = promptTemplates.map(function (promptTemplate) { return (__assign(__assign({}, promptTemplate), { preparedContent: undefined })); });
+        return __assign(__assign({}, pipeline), { promptTemplates: promptTemplates, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
     }
     /**
      * TODO: [🔼] !!! Export via `@promptbook/core`
+     * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
      * TODO: Write tests for `preparePipeline`
+     * TODO: [🍙] Make some standart order of json properties
      */
 
     /**
@@ -1990,22 +2004,27 @@
         // Note: Ignoring `pipeline.preparations` @@@
         // Note: Ignoring `pipeline.knowledgePieces` @@@
         if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
-            console.log('!!!!', 'Not all personas have modelRequirements');
             return false;
         }
         if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
-            console.log('!!!!', 'Not all knowledgeSources have preparationIds');
             return false;
         }
-        // TODO: !!!!! Is context in each template
-        // TODO: !!!!! Are samples prepared
-        // TODO: !!!!! Are templates prepared
+        /*
+        TODO: [🧠][🍫] `promptTemplates` can not be determined if they are fully prepared SO ignoring them
+        > if (!pipeline.promptTemplates.every(({ preparedContent }) => preparedContent === undefined)) {
+        >     return false;
+        > }
+        */
         return true;
     }
     /**
      * TODO: [🐠] Maybe base this on `makeValidator`
      * TODO: [🔼] Export via core or utils
      * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
+     * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
+     *     - Is context in each template
+     *     - Are samples prepared
+     *     - Are templates prepared
      */
 
     /**
@@ -2067,6 +2086,22 @@
      * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
      */
     function replaceParameters(template, parameters) {
+        var e_1, _a;
+        try {
+            for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
+                if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
+                    throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
         var replacedTemplate = template;
         var match;
         var loopLimit = LOOP_LIMIT;
@@ -2192,7 +2227,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.61.0-21';
+    var PROMPTBOOK_VERSION = '0.61.0-23';
     // TODO: !!!! List here all the versions and annotate + put into script
 
     /**
@@ -2322,14 +2357,25 @@
             pipeline = rawPipeline;
         }
         else {
-            console.warn(spaceTrim.spaceTrim("\n                Pipeline ".concat(rawPipeline.pipelineUrl || rawPipeline.sourceFile || rawPipeline.title, " is not prepared\n\n                It will be prepared ad-hoc before the first execution\n                But it is recommended to prepare the pipeline during collection preparation\n\n                @see more at https://ptbk.io/prepare-pipeline\n            ")));
+            // TODO: !!!! This should be maybe warning in report
+            console.warn(spaceTrim.spaceTrim("\n                Pipeline ".concat(rawPipeline.pipelineUrl || rawPipeline.sourceFile || rawPipeline.title, " is not prepared\n\n                ").concat(rawPipeline.sourceFile, "\n\n                It will be prepared ad-hoc before the first execution\n                But it is recommended to prepare the pipeline during collection preparation\n\n                @see more at https://ptbk.io/prepare-pipeline\n            ")));
         }
         var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+            // TODO: !!!!! Extract to separate functions and files - ALL FUNCTIONS BELOW
             function getContextForTemplate(// <- TODO: [🧠][🥜]
             template) {
                 return __awaiter(this, void 0, void 0, function () {
                     return __generator(this, function (_a) {
-                        // TODO: !!!!!! Implement Better - use real index and keyword search
+                        TODO_USE(template);
+                        return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: !!!! Implement */];
+                    });
+                });
+            }
+            function getKnowledgeForTemplate(// <- TODO: [🧠][🥜]
+            template) {
+                return __awaiter(this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        // TODO: !!!! Implement Better - use real index and keyword search
                         TODO_USE(template);
                         return [2 /*return*/, pipeline.knowledgePieces.map(function (_a) {
                                 var content = _a.content;
@@ -2338,19 +2384,39 @@
                     });
                 });
             }
+            function getSamplesForTemplate(// <- TODO: [🧠][🥜]
+            template) {
+                return __awaiter(this, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        // TODO: !!!! Implement Better - use real index and keyword search
+                        TODO_USE(template);
+                        return [2 /*return*/, RESERVED_PARAMETER_MISSING_VALUE /* <- TODO: !!!! Implement */];
+                    });
+                });
+            }
             function getReservedParametersForTemplate(template) {
                 return __awaiter(this, void 0, void 0, function () {
-                    var context, currentDate, reservedParameters, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
+                    var context, knowledge, samples, currentDate, modelName, reservedParameters, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
                     var e_3, _a;
                     return __generator(this, function (_b) {
                         switch (_b.label) {
                             case 0: return [4 /*yield*/, getContextForTemplate(template)];
                             case 1:
                                 context = _b.sent();
+                                return [4 /*yield*/, getKnowledgeForTemplate(template)];
+                            case 2:
+                                knowledge = _b.sent();
+                                return [4 /*yield*/, getSamplesForTemplate(template)];
+                            case 3:
+                                samples = _b.sent();
                                 currentDate = new Date().toISOString();
+                                modelName = RESERVED_PARAMETER_MISSING_VALUE;
                                 reservedParameters = {
                                     context: context,
+                                    knowledge: knowledge,
+                                    samples: samples,
                                     currentDate: currentDate,
+                                    modelName: modelName,
                                 };
                                 try {
                                     // Note: Doublecheck that ALL reserved parameters are defined:
@@ -2375,7 +2441,7 @@
             }
             function executeSingleTemplate(currentTemplate) {
                 return __awaiter(this, void 0, void 0, function () {
-                    var name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _d, _e, parameterName, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokerParameterNames, attempt, isJokerAttempt, jokerParameterName, _f, _g, _h, _j, scriptTools, error_2, e_4_1, _k, _l, functionName, postprocessingError, _m, _o, scriptTools, error_3, e_5_1, e_6_1, error_4;
+                    var name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _d, _e, parameterName, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokerParameterNames, preparedContent, attempt, isJokerAttempt, jokerParameterName, _f, _g, _h, _j, scriptTools, error_2, e_4_1, _k, _l, functionName, postprocessingError, _m, _o, scriptTools, error_3, e_5_1, e_6_1, error_4;
                     var e_7, _p, e_4, _q, e_6, _r, e_5, _s, _t;
                     var _this = this;
                     return __generator(this, function (_u) {
@@ -2445,6 +2511,9 @@
                                 expectError = null;
                                 maxAttempts = currentTemplate.blockType === 'PROMPT_DIALOG' ? Infinity : maxExecutionAttempts;
                                 jokerParameterNames = currentTemplate.jokerParameterNames || [];
+                                preparedContent = (currentTemplate.preparedContent || '{content}')
+                                    .split('{content}')
+                                    .join(currentTemplate.content);
                                 attempt = -jokerParameterNames.length;
                                 _u.label = 4;
                             case 4:
@@ -2479,7 +2548,7 @@
                                 }
                                 return [3 /*break*/, 29];
                             case 6:
-                                resultString = replaceParameters(currentTemplate.content, parameters);
+                                resultString = replaceParameters(preparedContent, parameters);
                                 return [3 /*break*/, 30];
                             case 7:
                                 prompt = {
@@ -2488,7 +2557,7 @@
                                         ? pipeline.pipelineUrl
                                         : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous pipelines, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
                                     parameters: parameters,
-                                    content: currentTemplate.content,
+                                    content: preparedContent,
                                     modelRequirements: currentTemplate.modelRequirements,
                                     expectations: __assign(__assign({}, (pipeline.personas.find(function (_a) {
                                         var name = _a.name;
@@ -2610,7 +2679,7 @@
                                 _u.trys.push([19, 21, , 22]);
                                 return [4 /*yield*/, scriptTools.execute(deepFreeze({
                                         scriptLanguage: currentTemplate.contentLanguage,
-                                        script: currentTemplate.content,
+                                        script: preparedContent,
                                         parameters: parameters,
                                     }))];
                             case 20:
@@ -2659,7 +2728,7 @@
                                 return [4 /*yield*/, tools.userInterface.promptDialog(deepFreeze({
                                         promptTitle: currentTemplate.title,
                                         promptMessage: replaceParameters(currentTemplate.description || '', parameters),
-                                        defaultValue: replaceParameters(currentTemplate.content, parameters),
+                                        defaultValue: replaceParameters(preparedContent, parameters),
                                         // TODO: [🧠] !! Figure out how to define placeholder in .ptbk.md file
                                         placeholder: undefined,
                                         priority: priority,
@@ -2837,7 +2906,7 @@
                         var parameter = _c.value;
                         if (parametersToPass[parameter.name] === undefined) {
                             // [4]
-                            errors.push(new PipelineExecutionError("Parameter {".concat(parameter.name, "} should be an output parameter, but it was not be resolved")));
+                            warnings.push(new PipelineExecutionError("Parameter {".concat(parameter.name, "} should be an output parameter, but it was not generated during pipeline execution")));
                             continue;
                         }
                         outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
@@ -2852,7 +2921,7 @@
                 }
                 return outputParameters;
             }
-            var executionReport, _a, _b, parameter, errors, _loop_1, _c, _d, parameterName, state_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
+            var errors, warnings, executionReport, _a, _b, parameter, _loop_1, _c, _d, parameterName, state_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
             var e_1, _e, e_2, _f;
             return __generator(this, function (_g) {
                 switch (_g.label) {
@@ -2867,6 +2936,8 @@
                         pipeline = _g.sent();
                         _g.label = 2;
                     case 2:
+                        errors = [];
+                        warnings = [];
                         executionReport = {
                             pipelineUrl: pipeline.pipelineUrl,
                             title: pipeline.title,
@@ -2885,10 +2956,10 @@
                                 if (inputParameters[parameter.name] === undefined) {
                                     return [2 /*return*/, deepFreezeWithSameType({
                                             isSuccessful: false,
-                                            errors: [
-                                                new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an input parameter")),
-                                                // <- TODO: !!!!! Test this error
-                                            ],
+                                            errors: __spreadArray([
+                                                new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an input parameter"))
+                                            ], __read(errors), false),
+                                            warnings: [],
                                             executionReport: executionReport,
                                             outputParameters: {},
                                             usage: ZERO_USAGE,
@@ -2903,22 +2974,21 @@
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
-                        errors = [];
                         _loop_1 = function (parameterName) {
                             var parameter = pipeline.parameters.find(function (_a) {
                                 var name = _a.name;
                                 return name === parameterName;
                             });
                             if (parameter === undefined) {
-                                errors.push(new PipelineExecutionError("Extra parameter {".concat(parameterName, "} is passed as input parameter")));
+                                warnings.push(new PipelineExecutionError("Extra parameter {".concat(parameterName, "} is being passed which is not part of the pipeline.")));
                             }
                             else if (parameter.isInput === false) {
                                 return { value: deepFreezeWithSameType({
                                         isSuccessful: false,
-                                        errors: [
-                                            new PipelineExecutionError("Parameter {".concat(parameter.name, "} is passed as input parameter but is not input")),
-                                            // <- TODO: !!!!! Test this error
-                                        ],
+                                        errors: __spreadArray([
+                                            new PipelineExecutionError("Parameter {".concat(parameter.name, "} is passed as input parameter but it is not input"))
+                                        ], __read(errors), false),
+                                        warnings: warnings,
                                         executionReport: executionReport,
                                         outputParameters: {},
                                         usage: ZERO_USAGE,
@@ -3027,6 +3097,7 @@
                         return [2 /*return*/, deepFreezeWithSameType({
                                 isSuccessful: false,
                                 errors: __spreadArray([error_1], __read(errors), false),
+                                warnings: warnings,
                                 usage: usage_1,
                                 executionReport: executionReport,
                                 outputParameters: outputParameters_1,
@@ -3040,6 +3111,7 @@
                         return [2 /*return*/, deepFreezeWithSameType({
                                 isSuccessful: true,
                                 errors: errors,
+                                warnings: warnings,
                                 usage: usage,
                                 executionReport: executionReport,
                                 outputParameters: outputParameters,
@@ -3066,7 +3138,7 @@
      */
     function prepareKnowledgeFromMarkdown(content /* <- TODO: [🖖] (?maybe not) Always the file */, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var llmTools, _a, maxParallelCount, _b, isVerbose, collection, prepareKnowledgeFromMarkdownExecutor, _c, prepareTitleExecutor, _d, prepareKeywordsExecutor, _e, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
+            var llmTools, _a, maxParallelCount, _b, isVerbose, collection, prepareKnowledgeFromMarkdownExecutor, _c, prepareTitleExecutor, _d, prepareKeywordsExecutor, _e, result, outputParameters, knowledgePiecesRaw, knowledgeTextPieces, knowledge;
             var _f, _g, _h;
             var _this = this;
             return __generator(this, function (_j) {
@@ -3107,8 +3179,8 @@
                         result = _j.sent();
                         assertsExecutionSuccessful(result);
                         outputParameters = result.outputParameters;
-                        knowledgeRaw = outputParameters.knowledge;
-                        knowledgeTextPieces = (knowledgeRaw || '').split('\n---\n');
+                        knowledgePiecesRaw = outputParameters.knowledgePieces;
+                        knowledgeTextPieces = (knowledgePiecesRaw || '').split('\n---\n');
                         if (isVerbose) {
                             console.info('knowledgeTextPieces:', knowledgeTextPieces);
                         }
@@ -3322,6 +3394,53 @@
      * TODO: [🏢] !! Check validity of `temperature` in pipeline
      */
 
+    /**
+     * @@@
+     */
+    function prepareTemplates(pipeline, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, maxParallelCount, promptTemplates, parameters, knowledgePiecesCount, promptTemplatesPrepared;
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a;
+                        promptTemplates = pipeline.promptTemplates, parameters = pipeline.parameters, knowledgePiecesCount = pipeline.knowledgePiecesCount;
+                        // TODO: !!!! Apply samples to each template (if missing and is for the template defined)
+                        TODO_USE(parameters);
+                        promptTemplatesPrepared = new Array(promptTemplates.length);
+                        return [4 /*yield*/, forEachAsync(promptTemplates, { maxParallelCount: maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, function (template, index) { return __awaiter(_this, void 0, void 0, function () {
+                                var preparedContent, preparedTemplate;
+                                return __generator(this, function (_a) {
+                                    preparedContent = undefined;
+                                    if (knowledgePiecesCount > 0) {
+                                        preparedContent = spaceTrim.spaceTrim("\n                    {content}\n\n                    ## Knowledge\n\n                    {knowledge}\n                ");
+                                        // <- TODO: [🧠][🧻] Cutomize shape/language/formatting of the addition to the prompt
+                                    }
+                                    preparedTemplate = __assign(__assign({}, template), { preparedContent: preparedContent });
+                                    promptTemplatesPrepared[index] = preparedTemplate;
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _b.sent();
+                        return [2 /*return*/, { promptTemplatesPrepared: promptTemplatesPrepared }];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🧠] Add context to each template (if missing)
+     * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
+     * TODO: !!!!! Index the samples and maybe templates
+     * TODO: [🔼] !!! Export via `@promptbook/core`
+     * TODO: Write tests for `preparePipeline`
+     * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+     * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
+     * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+     * TODO: [🧠][🥜]
+     */
+
     /**
      * Prepare pipeline from string (markdown) format to JSON format
      *
@@ -3330,18 +3449,18 @@
      */
     function preparePipeline(pipeline, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var _a, maxParallelCount, 
+            var _a, maxParallelCount, parameters, promptTemplates, 
             /*
             <- TODO: [🧠][0] `promptbookVersion` */
             knowledgeSources /*
             <- TODO: [🧊] `knowledgePieces` */, personas /*
-            <- TODO: [🧊] `preparations` */, currentPreparation, preparations, preparedPersonas, knowledgeSourcesPrepared, partialknowledgePiecesPrepared, knowledgePiecesPrepared;
+            <- TODO: [🧊] `preparations` */, currentPreparation, preparations, preparedPersonas, knowledgeSourcesPrepared, partialknowledgePiecesPrepared, knowledgePiecesPrepared, promptTemplatesPrepared /* TODO: parameters: parametersPrepared*/;
             var _this = this;
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
                         _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a;
-                        knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
+                        parameters = pipeline.parameters, promptTemplates = pipeline.promptTemplates, knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                         currentPreparation = {
                             id: 1,
                             // TODO: [🍥]> date: $currentDate(),
@@ -3374,16 +3493,20 @@
                     case 2:
                         partialknowledgePiecesPrepared = _b.sent();
                         knowledgePiecesPrepared = partialknowledgePiecesPrepared.map(function (piece) { return (__assign(__assign({}, piece), { preparationIds: [/* TODO: [🧊] -> */ currentPreparation.id] })); });
-                        // ----- /Knowledge preparation -----
-                        // TODO: !!!!! Add context to each template (if missing)
-                        // TODO: !!!!! Apply samples to each template (if missing)
-                        return [2 /*return*/, __assign(__assign({}, pipeline), { knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations })];
+                        return [4 /*yield*/, prepareTemplates({
+                                parameters: parameters,
+                                promptTemplates: promptTemplates,
+                                knowledgePiecesCount: knowledgePiecesPrepared.length,
+                            }, options)];
+                    case 3:
+                        promptTemplatesPrepared = (_b.sent()).promptTemplatesPrepared;
+                        // ----- /Templates preparation -----
+                        return [2 /*return*/, __assign(__assign({}, pipeline), { promptTemplates: promptTemplatesPrepared, knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations })];
                 }
             });
         });
     }
     /**
-     * TODO: !!!!! Index the samples and maybe templates
      * TODO: [🔼] !!! Export via `@promptbook/core`
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
@@ -5316,6 +5439,7 @@
      * 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
+     * TODO: [🍙] Make some standart order of json properties
      */
 
     /**
@@ -5899,7 +6023,7 @@
          */
         AnthropicClaudeExecutionTools.prototype.callChatModel = function (prompt) {
             return __awaiter(this, void 0, void 0, function () {
-                var content, parameters, modelRequirements, rawRequest, start, complete, rawResponse, resultContent, usage;
+                var content, parameters, modelRequirements, modelName, rawRequest, start, complete, rawResponse, resultContent, usage;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
                         case 0:
@@ -5911,6 +6035,7 @@
                             if (modelRequirements.modelVariant !== 'CHAT') {
                                 throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
                             }
+                            modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
                             rawRequest = {
                                 model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
                                 max_tokens: modelRequirements.maxTokens || 4096,
@@ -5922,7 +6047,7 @@
                                 messages: [
                                     {
                                         role: 'user',
-                                        content: replaceParameters(content, parameters),
+                                        content: replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName })),
                                     },
                                 ],
                                 // TODO: Is here some equivalent of user identification?> user: this.options.user,
@@ -5983,9 +6108,9 @@
                 throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
             }
 
-            const model = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+            const modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
             const modelSettings = {
-                model: rawResponse.model || model,
+                model: modelName,
                 max_tokens: modelRequirements.maxTokens || 2000, // <- Note: 2000 is for lagacy reasons
                 //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
                 // <- TODO: Use here `systemMessage`, `temperature` and `seed`
@@ -5993,7 +6118,7 @@
 
             const rawRequest: xxxx.Completions.CompletionCreateParamsNonStreaming = {
                 ...modelSettings,
-                prompt: replaceParameters(content, parameters),
+                prompt: replaceParameters(content, { ...parameters, modelName }),
                 user: this.options.user,
             };
             const start: string_date_iso8601 = getCurrentIsoDate();
@@ -6500,7 +6625,7 @@
          */
         OpenAiExecutionTools.prototype.callChatModel = function (prompt) {
             return __awaiter(this, void 0, void 0, function () {
-                var content, parameters, modelRequirements, expectFormat, model, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
+                var content, parameters, modelRequirements, expectFormat, modelName, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
                         case 0:
@@ -6512,9 +6637,9 @@
                             if (modelRequirements.modelVariant !== 'CHAT') {
                                 throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
                             }
-                            model = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+                            modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
                             modelSettings = {
-                                model: model,
+                                model: modelName,
                                 max_tokens: modelRequirements.maxTokens,
                                 //                                   <- TODO: [🌾] Make some global max cap for maxTokens
                                 temperature: modelRequirements.temperature,
@@ -6536,7 +6661,7 @@
                                     ])), false), [
                                     {
                                         role: 'user',
-                                        content: replaceParameters(content, parameters),
+                                        content: replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName })),
                                     },
                                 ], false), user: this.options.user });
                             start = getCurrentIsoDate();
@@ -6565,7 +6690,7 @@
                             }
                             return [2 /*return*/, {
                                     content: resultContent,
-                                    modelName: rawResponse.model || model,
+                                    modelName: rawResponse.model || modelName,
                                     timing: {
                                         start: start,
                                         complete: complete,
@@ -6583,7 +6708,7 @@
          */
         OpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
             return __awaiter(this, void 0, void 0, function () {
-                var content, parameters, modelRequirements, model, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
+                var content, parameters, modelRequirements, modelName, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
                         case 0:
@@ -6595,16 +6720,16 @@
                             if (modelRequirements.modelVariant !== 'COMPLETION') {
                                 throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
                             }
-                            model = modelRequirements.modelName || this.getDefaultCompletionModel().modelName;
+                            modelName = modelRequirements.modelName || this.getDefaultCompletionModel().modelName;
                             modelSettings = {
-                                model: model,
+                                model: modelName,
                                 max_tokens: modelRequirements.maxTokens || 2000,
                                 //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
                                 temperature: modelRequirements.temperature,
                                 // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                                 // <- Note: [🧆]
                             };
-                            rawRequest = __assign(__assign({}, modelSettings), { prompt: replaceParameters(content, parameters), user: this.options.user });
+                            rawRequest = __assign(__assign({}, modelSettings), { prompt: replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName })), user: this.options.user });
                             start = getCurrentIsoDate();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
@@ -6628,7 +6753,7 @@
                             usage = computeOpenaiUsage(content, resultContent || '', rawResponse);
                             return [2 /*return*/, {
                                     content: resultContent,
-                                    modelName: rawResponse.model || model,
+                                    modelName: rawResponse.model || modelName,
                                     timing: {
                                         start: start,
                                         complete: complete,
@@ -6646,7 +6771,7 @@
          */
         OpenAiExecutionTools.prototype.callEmbeddingModel = function (prompt) {
             return __awaiter(this, void 0, void 0, function () {
-                var content, parameters, modelRequirements, model, rawRequest, start, complete, rawResponse, resultContent, usage;
+                var content, parameters, modelRequirements, modelName, rawRequest, start, complete, rawResponse, resultContent, usage;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
                         case 0:
@@ -6658,10 +6783,10 @@
                             if (modelRequirements.modelVariant !== 'EMBEDDING') {
                                 throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
                             }
-                            model = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
+                            modelName = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
                             rawRequest = {
-                                input: replaceParameters(content, parameters),
-                                model: model,
+                                input: replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName })),
+                                model: modelName,
                                 // TODO: !!!! Test model 3 and dimensions
                             };
                             start = getCurrentIsoDate();
@@ -6683,7 +6808,7 @@
                             usage = computeOpenaiUsage(content, '', rawResponse);
                             return [2 /*return*/, {
                                     content: resultContent,
-                                    modelName: rawResponse.model || model,
+                                    modelName: rawResponse.model || modelName,
                                     timing: {
                                         start: start,
                                         complete: complete,