@promptbook/node 0.75.0-2 → 0.75.1

package/umd/index.umd.js

@@ -43,7 +43,7 @@
      *
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.75.0-1';
+    var PROMPTBOOK_ENGINE_VERSION = '0.75.0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -381,7 +381,6 @@
      * TODO: [🧠] Is there a way how to meaningfully test this utility
      */
 
-    //            <- TODO: [🐊] Pick the best claim
     /**
      * When the title is not provided, the default title is used
      *
@@ -566,7 +565,7 @@
                 return isInput;
             })), _h = _g.next(); !_h.done; _h = _g.next()) {
                 var parameter = _h.value;
-                commands.push("INPUT PARAMETER ".concat(templateParameterJsonToString(parameter)));
+                commands.push("INPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
@@ -582,7 +581,7 @@
                 return isOutput;
             })), _k = _j.next(); !_k.done; _k = _j.next()) {
                 var parameter = _k.value;
-                commands.push("OUTPUT PARAMETER ".concat(templateParameterJsonToString(parameter)));
+                commands.push("OUTPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
             }
         }
         catch (e_2_1) { e_2 = { error: e_2_1 }; }
@@ -596,12 +595,12 @@
         pipelineString += commands.map(function (command) { return "- ".concat(command); }).join('\n');
         try {
             for (var tasks_1 = __values(tasks), tasks_1_1 = tasks_1.next(); !tasks_1_1.done; tasks_1_1 = tasks_1.next()) {
-                var template = tasks_1_1.value;
+                var task = tasks_1_1.value;
                 var 
                 /* Note: Not using:> name, */
-                title_1 = template.title, description_1 = template.description, 
+                title_1 = task.title, description_1 = task.description, 
                 /* Note: dependentParameterNames, */
-                jokers = template.jokerParameterNames, taskType = template.taskType, content = template.content, postprocessing = template.postprocessingFunctionNames, expectations = template.expectations, format = template.format, resultingParameterName = template.resultingParameterName;
+                jokers = task.jokerParameterNames, taskType = task.taskType, content = task.content, postprocessing = task.postprocessingFunctionNames, expectations = task.expectations, format = task.format, resultingParameterName = task.resultingParameterName;
                 pipelineString += '\n\n';
                 pipelineString += "## ".concat(title_1);
                 if (description_1) {
@@ -611,9 +610,10 @@
                 var commands_1 = [];
                 var contentLanguage = 'text';
                 if (taskType === 'PROMPT_TASK') {
-                    var modelRequirements = template.modelRequirements;
+                    var modelRequirements = task.modelRequirements;
                     var _l = modelRequirements || {}, modelName = _l.modelName, modelVariant = _l.modelVariant;
-                    commands_1.push("EXECUTE PROMPT TEMPLATE");
+                    // Note: Do nothing, it is default
+                    // commands.push(`PROMPT`);
                     if (modelVariant) {
                         commands_1.push("MODEL VARIANT ".concat(capitalize(modelVariant)));
                     }
@@ -626,16 +626,16 @@
                     // Note: Nothing special here
                 }
                 else if (taskType === 'SCRIPT_TASK') {
-                    commands_1.push("SCRIPT TEMPLATE");
-                    if (template.contentLanguage) {
-                        contentLanguage = template.contentLanguage;
+                    commands_1.push("SCRIPT");
+                    if (task.contentLanguage) {
+                        contentLanguage = task.contentLanguage;
                     }
                     else {
                         contentLanguage = '';
                     }
                 }
                 else if (taskType === 'DIALOG_TASK') {
-                    commands_1.push("DIALOG TEMPLATE");
+                    commands_1.push("DIALOG");
                     // Note: Nothing special here
                 } // <- }else if([🅱]
                 if (jokers) {
@@ -710,7 +710,7 @@
                 pipelineString += '\n';
                 pipelineString += '```';
                 pipelineString += '\n\n';
-                pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: [main] !!! If the parameter here has description, add it and use templateParameterJsonToString
+                pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: [main] !!! If the parameter here has description, add it and use taskParameterJsonToString
             }
         }
         catch (e_3_1) { e_3 = { error: e_3_1 }; }
@@ -725,8 +725,8 @@
     /**
      * @private internal utility of `pipelineJsonToString`
      */
-    function templateParameterJsonToString(templateParameterJson) {
-        var name = templateParameterJson.name, description = templateParameterJson.description;
+    function taskParameterJsonToString(taskParameterJson) {
+        var name = taskParameterJson.name, description = taskParameterJson.description;
         var parameterString = "{".concat(name, "}");
         if (description) {
             parameterString = "".concat(parameterString, " ").concat(description);
@@ -734,7 +734,7 @@
         return parameterString;
     }
     /**
-     * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `templateParameterJsonToString` , use `stringifyCommand`
+     * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
      * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
      * TODO: [🏛] Maybe make some markdown builder
      * TODO: [🏛] Escape all
@@ -1379,7 +1379,7 @@
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.book.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book.md",formfactorName:"GENERIC",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}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\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-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `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### Key `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",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.book.md"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./books/prepare-knowledge-from-markdown.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./books/prepare-knowledge-keywords.book.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./books/prepare-knowledge-title.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book.md",formfactorName:"GENERIC",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}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\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-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `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### Key `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",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./books/prepare-persona.book.md"}];
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -1772,20 +1772,20 @@
             }
             finally { if (e_3) throw e_3.error; }
         }
-        var unresovedTemplates = __spreadArray([], __read(pipeline.tasks), false);
+        var unresovedTasks = __spreadArray([], __read(pipeline.tasks), false);
         var loopLimit = LOOP_LIMIT;
         var _loop_3 = function () {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
                 throw new UnexpectedError(spaceTrim.spaceTrim(function (block) { return "\n                        Loop limit reached during detection of circular dependencies in `validatePipeline`\n\n                        ".concat(block(pipelineIdentification), "\n                    "); }));
             }
-            var currentlyResovedTemplates = unresovedTemplates.filter(function (task) {
+            var currentlyResovedTasks = unresovedTasks.filter(function (task) {
                 return task.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
             });
-            if (currentlyResovedTemplates.length === 0) {
+            if (currentlyResovedTasks.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        **Can not resolve:**\n                        ").concat(block(unresovedTemplates
+                spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        **Can not resolve:**\n                        ").concat(block(unresovedTasks
                     .map(function (_a) {
                     var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
                     return "- Parameter `{".concat(resultingParameterName, "}` which depends on ").concat(dependentParameterNames
@@ -1804,13 +1804,13 @@
                     .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
                     .join('\n')), "\n\n\n                    "); }));
             }
-            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTemplates.map(function (_a) {
+            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTasks.map(function (_a) {
                 var resultingParameterName = _a.resultingParameterName;
                 return resultingParameterName;
             })), false);
-            unresovedTemplates = unresovedTemplates.filter(function (task) { return !currentlyResovedTemplates.includes(task); });
+            unresovedTasks = unresovedTasks.filter(function (task) { return !currentlyResovedTasks.includes(task); });
         };
-        while (unresovedTemplates.length > 0) {
+        while (unresovedTasks.length > 0) {
             _loop_3();
         }
         // TODO: !!!!!! Test that pipeline interface implements declared formfactor interface
@@ -1872,7 +1872,7 @@
     /**
      * Parses the task and returns the list of all parameter names
      *
-     * @param template the task with parameters in {curly} braces
+     * @param template the string template with parameters in {curly} braces
      * @returns the list of parameter names
      * @public exported from `@promptbook/utils`
      */
@@ -1906,13 +1906,13 @@
         var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources, tasks = pipeline.tasks;
         personas = personas.map(function (persona) { return (__assign(__assign({}, persona), { modelRequirements: undefined, preparationIds: undefined })); });
         knowledgeSources = knowledgeSources.map(function (knowledgeSource) { return (__assign(__assign({}, knowledgeSource), { preparationIds: undefined })); });
-        tasks = tasks.map(function (template) {
-            var dependentParameterNames = template.dependentParameterNames;
-            var parameterNames = extractParameterNames(template.preparedContent || '');
+        tasks = tasks.map(function (task) {
+            var dependentParameterNames = task.dependentParameterNames;
+            var parameterNames = extractParameterNames(task.preparedContent || '');
             dependentParameterNames = dependentParameterNames.filter(function (dependentParameterName) { return !parameterNames.has(dependentParameterName); });
-            var templateUnprepared = __assign(__assign({}, template), { dependentParameterNames: dependentParameterNames });
-            delete templateUnprepared.preparedContent;
-            return templateUnprepared;
+            var taskUnprepared = __assign(__assign({}, task), { dependentParameterNames: dependentParameterNames });
+            delete taskUnprepared.preparedContent;
+            return taskUnprepared;
         });
         return $asDeeplyFrozenSerializableJson('Unprepared PipelineJson', __assign(__assign({}, pipeline), { tasks: tasks, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] }));
     }
@@ -2205,7 +2205,7 @@
      * TODO: [🐠] Maybe base this on `makeValidator`
      * 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
+     *     - [🏍] ? Is context in each task
      *     - [♨] Are examples prepared
      *     - [♨] Are tasks prepared
      */
@@ -2277,16 +2277,16 @@
      */
 
     /**
-     * Parses the template and returns the set of all used parameters
+     * Parses the task and returns the set of all used parameters
      *
-     * @param template the template with used parameters
+     * @param task the task with used parameters
      * @returns the set of parameter names
      * @throws {ParseError} if the script is invalid
      * @public exported from `@promptbook/utils`
      */
-    function extractParameterNamesFromTask(template) {
+    function extractParameterNamesFromTask(task) {
         var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
-        var title = template.title, description = template.description, taskType = template.taskType, content = template.content, preparedContent = template.preparedContent, jokerParameterNames = template.jokerParameterNames, foreach = template.foreach;
+        var title = task.title, description = task.description, taskType = task.taskType, content = task.content, preparedContent = task.preparedContent, jokerParameterNames = task.jokerParameterNames, foreach = task.foreach;
         var parameterNames = new Set();
         try {
             for (var _e = __values(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameterNames(title)), false), __read(extractParameterNames(description || '')), false), __read(extractParameterNames(content)), false), __read(extractParameterNames(preparedContent || '')), false)), _f = _e.next(); !_f.done; _f = _e.next()) {
@@ -5331,10 +5331,10 @@
                         _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a;
                         tasks = pipeline.tasks, pipeline.parameters, knowledgePiecesCount = pipeline.knowledgePiecesCount;
                         tasksPrepared = new Array(tasks.length);
-                        return [4 /*yield*/, forEachAsync(tasks, { 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 dependentParameterNames, preparedContent, preparedTemplate;
+                        return [4 /*yield*/, forEachAsync(tasks, { maxParallelCount: maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, function (task, index) { return __awaiter(_this, void 0, void 0, function () {
+                                var dependentParameterNames, preparedContent, preparedTask;
                                 return __generator(this, function (_a) {
-                                    dependentParameterNames = template.dependentParameterNames;
+                                    dependentParameterNames = task.dependentParameterNames;
                                     preparedContent = undefined;
                                     if (knowledgePiecesCount > 0 && !dependentParameterNames.includes('knowledge')) {
                                         preparedContent = spaceTrim.spaceTrim("\n                    {content}\n\n                    ## Knowledge\n\n                    {knowledge}\n                ");
@@ -5343,8 +5343,8 @@
                                             'knowledge',
                                         ], false);
                                     }
-                                    preparedTemplate = __assign(__assign({}, template), { dependentParameterNames: dependentParameterNames, preparedContent: preparedContent });
-                                    tasksPrepared[index] = preparedTemplate;
+                                    preparedTask = __assign(__assign({}, task), { dependentParameterNames: dependentParameterNames, preparedContent: preparedContent });
+                                    tasksPrepared[index] = preparedTask;
                                     return [2 /*return*/];
                                 });
                             }); })];
@@ -5356,8 +5356,8 @@
         });
     }
     /**
-     * TODO: [🧠] Add context to each template (if missing)
-     * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
+     * TODO: [🧠] Add context to each task (if missing)
+     * TODO: [🧠] What is better name `prepareTask` or `prepareTaskAndParameters`
      * TODO: [♨][main] !!! Prepare index the examples and maybe tasks
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
@@ -5443,7 +5443,7 @@
                             })];
                     case 3:
                         tasksPrepared = (_c.sent()).tasksPrepared;
-                        // ----- /Templates preparation -----
+                        // ----- /Tasks preparation -----
                         // Note: Count total usage
                         currentPreparation.usage = llmToolsWithUsage.getTotalUsage();
                         return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { tasks: __spreadArray([], __read(tasksPrepared), false), 
@@ -5462,6 +5462,40 @@
      *       @see https://docs.anthropic.com/en/docs/test-and-evaluate/strengthen-guardrails/increase-consistency#specify-the-desired-output-format
      */
 
+    /**
+     * All available task types
+     *
+     * There is is distinction between task types and section types
+     * - Every section in markdown has its SectionType
+     * - Some sections are tasks but other can be non-task sections
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var TaskTypes = [
+        'PROMPT',
+        'SIMPLE',
+        'SCRIPT',
+        'DIALOG',
+        // <- [🅱]
+    ];
+
+    /**
+     * All available sections which are not tasks
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var NonTaskSectionTypes = ['EXAMPLE', 'KNOWLEDGE', 'INSTRUMENT', 'ACTION'];
+    /**
+     * All available section types
+     *
+     * There is is distinction between task types and section types
+     * - Every section in markdown has its SectionType
+     * - Some sections are tasks but other can be non-task sections
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var SectionTypes = __spreadArray(__spreadArray([], __read(TaskTypes.map(function (TaskType) { return "".concat(TaskType, "_TASK"); })), false), __read(NonTaskSectionTypes), false);
+
     /**
      * Parses the knowledge command
      *
@@ -5554,24 +5588,6 @@
      * Note: [⛱] There are two types of KNOWLEDGE commands *...(read more in [⛱])*
      */
 
-    /**
-     * Section type describes the way how the section is sectiond
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var SectionTypes = [
-        'PROMPT_TASK',
-        'SIMPLE_TASK',
-        'SCRIPT_TASK',
-        'DIALOG_TASK',
-        'EXAMPLE',
-        'KNOWLEDGE',
-        'INSTRUMENT',
-        'ACTION',
-        // <- [🅱]
-    ];
-    // <- TODO: !!!!!! Make alongside `SectionType` the `TaskType`, `TaskType` + [⛱] and ACRY
-
     /**
      * Parses the section command
      *
@@ -5659,7 +5675,10 @@
             var normalized = input.normalized;
             normalized = normalized.split('SAMPLE').join('EXAMPLE');
             normalized = normalized.split('EXECUTE_').join('');
-            var taskTypes = SectionTypes.filter(function (taskType) { return normalized.includes(taskType.split('_TASK').join('')); });
+            normalized = normalized.split('DIALOGUE').join('DIALOG');
+            var taskTypes = SectionTypes.filter(function (sectionType) {
+                return normalized.includes(sectionType.split('_TASK').join(''));
+            });
             if (taskTypes.length !== 1) {
                 throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                        Unknown section type \"".concat(normalized, "\"\n\n                        Supported section types are:\n                        ").concat(block(SectionTypes.join(', ')), "\n                    "); }));
             }
@@ -6018,7 +6037,7 @@
         /**
          * Description of the FORMAT command
          */
-        description: spaceTrim__default["default"]("\n        Expect command describes the desired output of the template (after post-processing)\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
+        description: spaceTrim__default["default"]("\n        Expect command describes the desired output of the task *(after post-processing)*\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
         /**
          * Link to documentation
          */
@@ -6504,7 +6523,7 @@
         /**
          * Description of the FORMAT command
          */
-        description: spaceTrim__default["default"]("\n        Format command describes the desired output of the template (after post-processing)\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
+        description: spaceTrim__default["default"]("\n        Format command describes the desired output of the task (after post-processing)\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
         /**
          * Link to documentation
          */
@@ -6568,19 +6587,45 @@
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/174",
         pipelineInterface: {
-            inputParameterNames: ['previousTitle', 'previousConversationSummary', 'userMessage'],
-            outputParameterNames: ['title', 'conversationSummary', 'chatbotResponse'],
-            /*
-            <- TODO: !!!!!! Change to full interfaces
-
-            -   INPUT PARAMETER `{previousTitle}` Previous title of the conversation
-            -   INPUT PARAMETER `{previousConversationSummary}` Previous conversation summary
-            -   INPUT PARAMETER `{userMessage}` User message
-            -   OUTPUT PARAMETER `{title}` Title of the conversation
-            -   OUTPUT PARAMETER `{conversationSummary}` Summary of the conversation
-            -   OUTPUT PARAMETER `{chatbotResponse}` Chatbot response
+            inputParameters: [
+                {
+                    name: 'previousTitle',
+                    description: "Previous title of the conversation",
+                    isInput: true,
+                    isOutput: false,
+                },
+                {
+                    name: 'previousConversationSummary',
+                    description: "Previous conversation summary",
+                    isInput: true,
+                    isOutput: false,
+                },
+                { name: 'userMessage', description: "User message", isInput: true, isOutput: false },
+            ],
+            outputParameters: [
+                { name: 'title', description: "Title of the conversation", isInput: false, isOutput: true },
+                { name: 'conversationSummary', description: "Summary of the conversation", isInput: false, isOutput: true },
+                { name: 'chatbotResponse', description: "Chatbot response", isInput: false, isOutput: true },
+            ],
+        },
+    };
 
-            */
+    /**
+     * Generator is form of app that @@@
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var GeneratorFormfactorDefinition = {
+        name: 'GENERATOR',
+        description: "@@@",
+        documentationUrl: "https://github.com/webgptorg/promptbook/discussions/184",
+        pipelineInterface: {
+            inputParameters: [
+            /* @@@ */
+            ],
+            outputParameters: [
+            /* @@@ */
+            ],
         },
     };
 
@@ -6592,8 +6637,8 @@
      * @public exported from `@promptbook/core`
      */
     var GENERIC_PIPELINE_INTERFACE = {
-        inputParameterNames: [],
-        outputParameterNames: [],
+        inputParameters: [],
+        outputParameters: [],
     };
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -6621,10 +6666,10 @@
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177",
         pipelineInterface: {
-            inputParameterNames: [
+            inputParameters: [
             /* @@@ */
             ],
-            outputParameterNames: [
+            outputParameters: [
             /* @@@ */
             ],
         },
@@ -6640,8 +6685,22 @@
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/176",
         pipelineInterface: {
-            inputParameterNames: ['inputSheet'],
-            outputParameterNames: ['outputSheet'],
+            inputParameters: [
+                {
+                    name: 'inputSheet',
+                    description: "Input sheet to be processed as csv",
+                    isInput: true,
+                    isOutput: false,
+                },
+            ],
+            outputParameters: [
+                {
+                    name: 'outputSheet',
+                    description: "Output sheet as csv",
+                    isInput: false,
+                    isOutput: true,
+                },
+            ],
         },
     };
 
@@ -6655,9 +6714,23 @@
         description: "@@@",
         documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175",
         pipelineInterface: {
-            inputParameterNames: ['inputMessage'],
-            outputParameterNames: ['outputMessage'],
-            // <- TODO: !!!!!! Maybe add {summary}
+            inputParameters: [
+                {
+                    name: 'inputMessage',
+                    description: "Input message to be translated",
+                    isInput: true,
+                    isOutput: false,
+                },
+            ],
+            outputParameters: [
+                {
+                    name: 'outputMessage',
+                    description: "Translated output message",
+                    isInput: false,
+                    isOutput: true,
+                },
+            ],
+            // <- TODO: [🤓] Maybe add {summary}
             // <- TODO: [🧠] maybe change to {inputText}, {inputText} / or make system for any name of first input and first outpur parameter
         },
     };
@@ -6673,6 +6746,7 @@
         TranslatorFormfactorDefinition,
         SheetsFormfactorDefinition,
         MatcherFormfactorDefinition,
+        GeneratorFormfactorDefinition,
     ];
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -6785,7 +6859,7 @@
         /**
          * Description of the JOKER command
          */
-        description: "Joker parameter is used instead of executing the template result if jokers value meets the expectations requirements",
+        description: "Joker parameter is used instead of executing the task result if jokers value meets the expectations requirements",
         /**
          * Link to documentation
          */
@@ -7013,7 +7087,7 @@
         /**
          * Description of the PARAMETER command
          */
-        description: "Describes one parameter of the template",
+        description: "Describes one parameter of the task",
         /**
          * Link to documentation
          */
@@ -7369,7 +7443,7 @@
                     spaceTrim(
                         `
                             URL must not contain hash
-                            Hash is used for identification of the template in the pipeline
+                            Hash is used for identification of the section of the pipeline
                         `,
                     ),
                 );
@@ -7425,7 +7499,7 @@
         /**
          * Description of the ACTION command
          */
-        description: "Actions influences from the pipeline or template into external world. Like turning on a light, sending an email, etc.",
+        description: "Actions influences from the pipeline or task into external world. Like turning on a light, sending an email, etc.",
         /**
          * Link to documentation
          */
@@ -7491,7 +7565,7 @@
         /**
          * Description of the INSTRUMENT command
          */
-        description: "Instrument command is used to specify the instrument to be used in the pipeline or template like search, calculate, etc.",
+        description: "Instrument command is used to specify the instrument to be used in the pipeline or task like search, calculate, etc.",
         /**
          * Link to documentation
          */
@@ -7625,7 +7699,6 @@
         normalized = normalized.split('(').join('');
         normalized = normalized.split(')').join('');
         normalized = normalizeTo_SCREAMING_CASE(normalized);
-        normalized = normalized.split('DIALOGUE').join('DIALOG'); // <- TODO: !!!!!! Move to sectionCommandParser
         var items = raw
             .trim()
             // Note: [🐡]
@@ -7813,7 +7886,7 @@
     function extractOneBlockFromMarkdown(markdown) {
         var codeBlocks = extractAllBlocksFromMarkdown(markdown);
         if (codeBlocks.length !== 1) {
-            throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                    There should be exactly 1 code block in template, 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                "); }));
+            throw new ParseError(spaceTrim__default["default"](function (block) { return "\n                    There should be exactly 1 code block in task section, 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];
     }
@@ -8120,7 +8193,7 @@
             var command = parseCommand(listItem, 'PIPELINE_HEAD');
             var commandParser = getParserForCommand(command);
             if (commandParser.isUsedInPipelineHead !== true /* <- Note: [🦦][4] */) {
-                throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                        Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the pipeline template\n\n                        ").concat(block(getPipelineIdentification()), "\n                    "); })); // <- TODO: [🚞]
+                throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                        Command `".concat(command.type, "` is not allowed in the head of the pipeline ONLY at the pipeline task\n\n                        ").concat(block(getPipelineIdentification()), "\n                    "); })); // <- TODO: [🚞]
             }
             try {
                 commandParser.$applyToPipelineJson(command, $pipelineJson);
@@ -8152,7 +8225,7 @@
         }
         var _loop_2 = function (section) {
             var e_5, _l, e_6, _m;
-            // TODO: Parse template description (the content out of the codeblock and lists)
+            // TODO: Parse section's description (the content out of the codeblock and lists)
             var listItems_2 = extractAllListItemsFromMarkdown(section.content);
             var _o = extractOneBlockFromMarkdown(section.content), language = _o.language, content = _o.content;
             // TODO: [🎾][1] DRY description
@@ -8183,7 +8256,7 @@
                 resultingParameterNameMatch.groups.resultingParamName !== undefined) {
                 $taskJson.resultingParameterName = resultingParameterNameMatch.groups.resultingParamName;
             }
-            // TODO: [🥥] Maybe move this logic to `$parseAndApplyPipelineTemplateCommands`
+            // TODO: [🥥] Maybe move this logic to `$parseAndApplyPipelineTaskCommands`
             var commands = listItems_2.map(function (listItem) { return ({
                 listItem: listItem,
                 command: parseCommand(listItem, 'PIPELINE_TASK'),
@@ -8198,7 +8271,7 @@
             var _loop_4 = function (listItem, command) {
                 var commandParser = getParserForCommand(command);
                 if (commandParser.isUsedInPipelineTask !== true /* <- Note: [🦦][4] */) {
-                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            Command ".concat(command.type, " is not allowed in the template of the promptbook ONLY at the pipeline head\n\n                            ").concat(block(getPipelineIdentification()), "\n                        "); })); // <- TODO: [🚞]
+                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            Command `".concat(command.type, "` is not allowed in the task of the promptbook ONLY at the pipeline head\n\n                            ").concat(block(getPipelineIdentification()), "\n                        "); })); // <- TODO: [🚞]
                 }
                 try {
                     commandParser.$applyToTaskJson(
@@ -8209,7 +8282,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            Command ".concat(command.type, " failed to apply to the template\n\n                            The error:\n                            ").concat(block(error.message), "\n\n                            Current state of the template:\n                            ").concat(block(JSON.stringify($taskJson, null, 4)), "\n                               <- Maybe wrong order of commands?\n\n                            Raw command:\n                            - ").concat(listItem, "\n\n                            Usage of ").concat(command.type, ":\n                            ").concat(block(commandParser.examples.map(function (example) { return "- ".concat(example); }).join('\n')), "\n\n                            ").concat(block(getPipelineIdentification()), "\n                      "); })); // <- TODO: [🚞]
+                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            Command `".concat(command.type, "` failed to apply to the task\n\n                            The error:\n                            ").concat(block(error.message), "\n\n                            Current state of the task:\n                            ").concat(block(JSON.stringify($taskJson, null, 4)), "\n                               *<- Maybe wrong order of commands?*\n\n                            Raw command:\n                            - ").concat(listItem, "\n\n                            Usage of ").concat(command.type, ":\n                            ").concat(block(commandParser.examples.map(function (example) { return "- ".concat(example); }).join('\n')), "\n\n                            ").concat(block(getPipelineIdentification()), "\n                      "); })); // <- TODO: [🚞]
                 }
                 if (command.type === 'PARAMETER') {
                     defineParam(command);
@@ -8230,10 +8303,10 @@
                 }
                 finally { if (e_5) throw e_5.error; }
             }
-            // TODO: [🍧] Should be done in TEMPLATE command
+            // TODO: [🍧] Should be done in SECTION command
             if ($taskJson.taskType === 'SCRIPT_TASK') {
                 if (!language) {
-                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            You must specify the language of the script in the SCRIPT TEMPLATE\n\n                            ".concat(block(getPipelineIdentification()), "\n                        "); }));
+                    throw new ParseError(spaceTrim.spaceTrim(function (block) { return "\n                            You must specify the language of the script in the `SCRIPT` task\n\n                            ".concat(block(getPipelineIdentification()), "\n                        "); }));
                 }
                 if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
                     throw new ParseError(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                        "); }));
@@ -8244,7 +8317,7 @@
             try {
                 for (var _q = (e_6 = void 0, __values($taskJson.dependentParameterNames)), _r = _q.next(); !_r.done; _r = _q.next()) {
                     var parameterName = _r.value;
-                    // TODO: [🧠] This definition should be made first in the template
+                    // TODO: [🧠] This definition should be made first in the task
                     defineParam({
                         parameterName: parameterName,
                         parameterDescription: null,
@@ -8269,7 +8342,7 @@
                         (block) => `
                             Model requirements are defined for the block type ${
                                 $taskJson.taskType
-                            } which is not a PROMPT TEMPLATE
+                            } which is not a \`PROMPT\` task
 
                             This should be avoided by the \`modelCommandParser\`
 
@@ -8288,7 +8361,7 @@
         };
         try {
             // =============================================================
-            // Note: 4️⃣ Process each template of the pipeline
+            // Note: 4️⃣ Process each section of the pipeline
             for (var pipelineSections_1 = __values(pipelineSections), pipelineSections_1_1 = pipelineSections_1.next(); !pipelineSections_1_1.done; pipelineSections_1_1 = pipelineSections_1.next()) {
                 var section = pipelineSections_1_1.value;
                 _loop_2(section);
@@ -8305,7 +8378,7 @@
         // Note: 5️⃣ Mark parameters as INPUT if not explicitly set
         if ($pipelineJson.parameters.every(function (parameter) { return !parameter.isInput; })) {
             var _loop_3 = function (parameter) {
-                var isThisParameterResulting = $pipelineJson.tasks.some(function (template) { return template.resultingParameterName === parameter.name; });
+                var isThisParameterResulting = $pipelineJson.tasks.some(function (task) { return task.resultingParameterName === parameter.name; });
                 if (!isThisParameterResulting) {
                     parameter.isInput = true;
                 }