@promptbook/core 0.75.0-2 → 0.75.1

package/esm/index.es.js

@@ -22,7 +22,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  *
  * @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
@@ -247,7 +247,7 @@ function pipelineJsonToString(pipelineJson) {
             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 }; }
@@ -263,7 +263,7 @@ function pipelineJsonToString(pipelineJson) {
             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 }; }
@@ -277,12 +277,12 @@ function pipelineJsonToString(pipelineJson) {
     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) {
@@ -292,9 +292,10 @@ function pipelineJsonToString(pipelineJson) {
             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)));
                 }
@@ -307,16 +308,16 @@ function pipelineJsonToString(pipelineJson) {
                 // 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) {
@@ -391,7 +392,7 @@ function pipelineJsonToString(pipelineJson) {
             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 }; }
@@ -406,8 +407,8 @@ function pipelineJsonToString(pipelineJson) {
 /**
  * @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);
@@ -415,7 +416,7 @@ function templateParameterJsonToString(templateParameterJson) {
     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
@@ -641,6 +642,14 @@ function $asDeeplyFrozenSerializableJson(name, objectValue) {
  * @private within the repository
  */
 var GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has been generated so that any manual changes will be overwritten";
+/**
+ * Name for the Promptbook
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+var NAME = "Promptbook";
 /**
  * Claim for the Promptbook
  *
@@ -650,6 +659,22 @@ var GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has been generated so t
  */
 var CLAIM = "It's time for a paradigm shift. The future of software in plain English, French or Latin";
 //            <- TODO: [🐊] Pick the best claim
+/**
+ * Logo for the light theme
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+var LOGO_LIGHT_SRC = "https://promptbook.studio/_next/static/media/promptbook-logo.b21f0c70.png";
+/**
+ * Logo for the dark theme
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+var LOGO_DARK_SRC = "https://promptbook.studio/_next/static/media/promptbook-logo-white.09887cbc.png";
 /**
  * When the title is not provided, the default title is used
  *
@@ -708,6 +733,13 @@ var DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
  * @public exported from `@promptbook/core`
  */
 var DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
+/**
+ * Where to store your books
+ * This is kind of a "src" for your books
+ *
+ * @public exported from `@promptbook/core`
+ */
+var DEFAULT_BOOKS_DIRNAME = './books';
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -715,7 +747,7 @@ var DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
  *
  * @public exported from `@promptbook/core`
  */
-var DEFAULT_EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
+var DEFAULT_EXECUTIONS_CACHE_DIRNAME = './.promptbook/executions-cache';
 /**
  * Where to store the scrape cache
  *
@@ -723,7 +755,7 @@ var DEFAULT_EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
  *
  * @public exported from `@promptbook/core`
  */
-var DEFAULT_SCRAPE_CACHE_DIRNAME = '/.promptbook/scrape-cache';
+var DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
 /**
  * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
  *
@@ -1215,20 +1247,20 @@ function validatePipelineCore(pipeline) {
         }
         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$1(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$1(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$1(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
@@ -1247,13 +1279,13 @@ function validatePipelineCore(pipeline) {
                 .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
@@ -1315,7 +1347,7 @@ var PipelineUrlError = /** @class */ (function (_super) {
 /**
  * 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`
  */
@@ -1349,13 +1381,13 @@ function unpreparePipeline(pipeline) {
     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: [] }));
 }
@@ -1672,24 +1704,6 @@ function createSubcollection(collection, predicate) {
     };
 }
 
-/**
- * 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
-
 /**
  * This error type indicates that some tools are missing for pipeline execution or preparation
  *
@@ -2328,7 +2342,7 @@ function joinLlmExecutionTools() {
  * 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 pipeline collection cannot be propperly loaded
@@ -2508,7 +2522,7 @@ function isPipelinePrepared(pipeline) {
  * 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
  */
@@ -2580,16 +2594,16 @@ function extractVariables(script) {
  */
 
 /**
- * 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()) {
@@ -5656,10 +5670,10 @@ function prepareTasks(pipeline, tools, options) {
                     _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$1("\n                    {content}\n\n                    ## Knowledge\n\n                    {knowledge}\n                ");
@@ -5668,8 +5682,8 @@ function prepareTasks(pipeline, tools, options) {
                                         '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*/];
                             });
                         }); })];
@@ -5681,8 +5695,8 @@ function prepareTasks(pipeline, tools, options) {
     });
 }
 /**
- * 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
@@ -5768,7 +5782,7 @@ function preparePipeline(pipeline, tools, options) {
                         })];
                 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), 
@@ -5787,6 +5801,40 @@ function preparePipeline(pipeline, tools, options) {
  *       @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
  *
@@ -5966,7 +6014,10 @@ var sectionCommandParser = {
         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(function (block) { return "\n                        Unknown section type \"".concat(normalized, "\"\n\n                        Supported section types are:\n                        ").concat(block(SectionTypes.join(', ')), "\n                    "); }));
         }
@@ -6325,7 +6376,7 @@ var expectCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim("\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("\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
      */
@@ -6811,7 +6862,7 @@ var formatCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim("\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("\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
      */
@@ -6875,19 +6926,45 @@ var ChatbotFormfactorDefinition = {
     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: [
+        /* @@@ */
+        ],
     },
 };
 
@@ -6899,8 +6976,8 @@ var ChatbotFormfactorDefinition = {
  * @public exported from `@promptbook/core`
  */
 var GENERIC_PIPELINE_INTERFACE = {
-    inputParameterNames: [],
-    outputParameterNames: [],
+    inputParameters: [],
+    outputParameters: [],
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -6928,10 +7005,10 @@ var MatcherFormfactorDefinition = {
     description: "@@@",
     documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177",
     pipelineInterface: {
-        inputParameterNames: [
+        inputParameters: [
         /* @@@ */
         ],
-        outputParameterNames: [
+        outputParameters: [
         /* @@@ */
         ],
     },
@@ -6947,8 +7024,22 @@ var SheetsFormfactorDefinition = {
     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,
+            },
+        ],
     },
 };
 
@@ -6962,9 +7053,23 @@ var TranslatorFormfactorDefinition = {
     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
     },
 };
@@ -6980,6 +7085,7 @@ var FORMFACTOR_DEFINITIONS = [
     TranslatorFormfactorDefinition,
     SheetsFormfactorDefinition,
     MatcherFormfactorDefinition,
+    GeneratorFormfactorDefinition,
 ];
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -7092,7 +7198,7 @@ var jokerCommandParser = {
     /**
      * 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
      */
@@ -7320,7 +7426,7 @@ var parameterCommandParser = {
     /**
      * Description of the PARAMETER command
      */
-    description: "Describes one parameter of the template",
+    description: "Describes one parameter of the task",
     /**
      * Link to documentation
      */
@@ -7676,7 +7782,7 @@ var urlCommandParser = {
                 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
                     `,
                 ),
             );
@@ -7732,7 +7838,7 @@ var actionCommandParser = {
     /**
      * 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
      */
@@ -7798,7 +7904,7 @@ var instrumentCommandParser = {
     /**
      * 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
      */
@@ -7932,7 +8038,6 @@ function parseCommand(raw, usagePlace) {
     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: [🐡]
@@ -8120,7 +8225,7 @@ function extractAllListItemsFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     var codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim(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(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];
 }
@@ -8427,7 +8532,7 @@ function pipelineStringToJsonSync(pipelineString) {
         var command = parseCommand(listItem, 'PIPELINE_HEAD');
         var commandParser = getParserForCommand(command);
         if (commandParser.isUsedInPipelineHead !== true /* <- Note: [🦦][4] */) {
-            throw new ParseError(spaceTrim$1(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$1(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);
@@ -8459,7 +8564,7 @@ function pipelineStringToJsonSync(pipelineString) {
     }
     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
@@ -8490,7 +8595,7 @@ function pipelineStringToJsonSync(pipelineString) {
             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'),
@@ -8505,7 +8610,7 @@ function pipelineStringToJsonSync(pipelineString) {
         var _loop_4 = function (listItem, command) {
             var commandParser = getParserForCommand(command);
             if (commandParser.isUsedInPipelineTask !== true /* <- Note: [🦦][4] */) {
-                throw new ParseError(spaceTrim$1(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$1(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(
@@ -8516,7 +8621,7 @@ function pipelineStringToJsonSync(pipelineString) {
                 if (!(error instanceof ParseError)) {
                     throw error;
                 }
-                throw new ParseError(spaceTrim$1(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$1(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);
@@ -8537,10 +8642,10 @@ function pipelineStringToJsonSync(pipelineString) {
             }
             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$1(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$1(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$1(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
@@ -8551,7 +8656,7 @@ function pipelineStringToJsonSync(pipelineString) {
         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,
@@ -8576,7 +8681,7 @@ function pipelineStringToJsonSync(pipelineString) {
                     (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\`
 
@@ -8595,7 +8700,7 @@ function pipelineStringToJsonSync(pipelineString) {
     };
     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);
@@ -8612,7 +8717,7 @@ function pipelineStringToJsonSync(pipelineString) {
     // 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;
             }
@@ -8783,8 +8888,8 @@ function addAutoGeneratedSection(content, options) {
  * @public exported from `@promptbook/utils`
  */
 function renderPromptbookMermaid(pipelineJson, options) {
-    var _a = (options || {}).linkTemplate, linkTemplate = _a === void 0 ? function () { return null; } : _a;
-    var parameterNameToTemplateName = function (parameterName) {
+    var _a = (options || {}).linkTask, linkTask = _a === void 0 ? function () { return null; } : _a;
+    var parameterNameToTaskName = function (parameterName) {
         var parameter = pipelineJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
         if (!parameter) {
             throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
@@ -8792,19 +8897,19 @@ function renderPromptbookMermaid(pipelineJson, options) {
         if (parameter.isInput) {
             return 'input';
         }
-        var template = pipelineJson.tasks.find(function (template) { return template.resultingParameterName === parameterName; });
-        if (!template) {
-            throw new Error("Could not find template for {".concat(parameterName, "}"));
+        var task = pipelineJson.tasks.find(function (task) { return task.resultingParameterName === parameterName; });
+        if (!task) {
+            throw new Error("Could not find task for {".concat(parameterName, "}"));
         }
-        return normalizeTo_camelCase('template-' + titleToName(template.title));
+        return normalizeTo_camelCase('task-' + titleToName(task.title));
     };
     var promptbookMermaid = spaceTrim$1(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(pipelineJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(pipelineJson.tasks
         .flatMap(function (_a) {
         var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
         return __spreadArray([
-            "".concat(parameterNameToTemplateName(resultingParameterName), "(\"").concat(title, "\")")
+            "".concat(parameterNameToTaskName(resultingParameterName), "(\"").concat(title, "\")")
         ], __read(dependentParameterNames.map(function (dependentParameterName) {
-            return "".concat(parameterNameToTemplateName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTemplateName(resultingParameterName));
+            return "".concat(parameterNameToTaskName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTaskName(resultingParameterName));
         })), false);
     })
         .join('\n')), "\n\n                  ").concat(block(pipelineJson.parameters
@@ -8814,17 +8919,17 @@ function renderPromptbookMermaid(pipelineJson, options) {
     })
         .map(function (_a) {
         var name = _a.name;
-        return "".concat(parameterNameToTemplateName(name), "--\"{").concat(name, "}\"-->output");
+        return "".concat(parameterNameToTaskName(name), "--\"{").concat(name, "}\"-->output");
     })
         .join('\n')), "\n                  output((Output)):::output\n\n                  ").concat(block(pipelineJson.tasks
-        .map(function (template) {
-        var link = linkTemplate(template);
+        .map(function (task) {
+        var link = linkTask(task);
         if (link === null) {
             return '';
         }
         var href = link.href, title = link.title;
-        var templateName = parameterNameToTemplateName(template.resultingParameterName);
-        return "click ".concat(templateName, " href \"").concat(href, "\" \"").concat(title, "\";");
+        var taskName = parameterNameToTaskName(task.resultingParameterName);
+        return "click ".concat(taskName, " href \"").concat(href, "\" \"").concat(title, "\";");
     })
         .filter(function (line) { return line !== ''; })
         .join('\n')), "\n\n                  classDef input color: grey;\n                  classDef output color: grey;\n\n              end;\n\n        "); });
@@ -8855,7 +8960,7 @@ function prettifyPipelineString(pipelineString, options) {
                 case 1:
                     pipelineJson = _a.sent();
                     promptbookMermaid_1 = renderPromptbookMermaid(pipelineJson, {
-                        linkTemplate: function (task) {
+                        linkTask: function (task) {
                             return { href: "#".concat(task.name), title: task.title };
                         },
                     });
@@ -9196,7 +9301,7 @@ function executionReportJsonToString(executionReportJson, options) {
                     if (/^\s*\p{Extended_Pictographic}/u.test(promptExecution.prompt.title)) {
                         hash = '-' + hash;
                     }
-                    // TODO: Make working hash link for the template in md + pdf
+                    // TODO: Make working hash link for the task in md + pdf
                     return "- [".concat(promptExecution.prompt.title, "](#").concat(hash, ")");
                 })
                     .join('\n');
@@ -9205,7 +9310,7 @@ function executionReportJsonToString(executionReportJson, options) {
                 '## ⌚ Time chart' +
                 '\n\n' +
                 createMarkdownChart({
-                    nameHeader: 'Template',
+                    nameHeader: 'Task',
                     valueHeader: 'Timeline',
                     items: timingItems,
                     width: chartsWidth,
@@ -9216,7 +9321,7 @@ function executionReportJsonToString(executionReportJson, options) {
                 '## 💸 Cost chart' +
                 '\n\n' +
                 createMarkdownChart({
-                    nameHeader: 'Template',
+                    nameHeader: 'Task',
                     valueHeader: 'Cost',
                     items: costItems,
                     width: chartsWidth,
@@ -9372,11 +9477,13 @@ var BoilerplateFormfactorDefinition = {
     name: 'BOILERPLATE',
     description: "@@@",
     documentationUrl: "https://github.com/webgptorg/promptbook/discussions/@@",
+    //                                                                     <- TODO: https://github.com/webgptorg/promptbook/discussions/new?category=concepts
+    //                                                                              "🔠 Boilerplate Formfactor"
     pipelineInterface: {
-        inputParameterNames: [
+        inputParameters: [
         /* @@@ */
         ],
-        outputParameterNames: [
+        outputParameters: [
         /* @@@ */
         ],
     },
@@ -9955,18 +10062,18 @@ var _OpenAiAssistantMetadataRegistration = $llmToolsMetadataRegister.register({
 function getPipelineInterface(pipeline) {
     var e_1, _a, e_2, _b;
     var pipelineInterface = {
-        inputParameterNames: [],
-        outputParameterNames: [],
+        inputParameters: [],
+        outputParameters: [],
     };
     try {
         for (var _c = __values(pipeline.parameters), _d = _c.next(); !_d.done; _d = _c.next()) {
             var parameter = _d.value;
-            var name_1 = parameter.name, isInput = parameter.isInput, isOutput = parameter.isOutput;
+            var isInput = parameter.isInput, isOutput = parameter.isOutput;
             if (isInput) {
-                pipelineInterface.inputParameterNames.push(name_1);
+                pipelineInterface.inputParameters.push(parameter);
             }
             if (isOutput) {
-                pipelineInterface.outputParameterNames.push(name_1);
+                pipelineInterface.outputParameters.push(parameter);
             }
         }
     }
@@ -9978,9 +10085,15 @@ function getPipelineInterface(pipeline) {
         finally { if (e_1) throw e_1.error; }
     }
     try {
-        for (var _e = __values(['inputParameterNames', 'outputParameterNames']), _f = _e.next(); !_f.done; _f = _e.next()) {
+        for (var _e = __values(['inputParameters', 'outputParameters']), _f = _e.next(); !_f.done; _f = _e.next()) {
             var key = _f.value;
-            pipelineInterface[key].sort(function (a, b) { return a.localeCompare(b); });
+            pipelineInterface[key].sort(function (_a, _b) {
+                var name1 = _a.name;
+                var name2 = _b.name;
+                return name1.localeCompare(name2);
+            });
+            // <- TODO: [🧠] Should we compare a descriptions?
+            // <- TODO: [🧠][🛴] Maybe add type + expectations into the intefrace, like "a person name"
         }
     }
     catch (e_2_1) { e_2 = { error: e_2_1 }; }
@@ -10248,5 +10361,5 @@ var PrefixStorage = /** @class */ (function () {
     return PrefixStorage;
 }());
 
-export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, AbstractFormatError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateFormfactorDefinition, CLAIM, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_CSV_SETTINGS, DEFAULT_EXECUTIONS_CACHE_DIRNAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TITLE, ERRORS, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GenericFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NotFoundError, NotYetImplementedError, PROMPTBOOK_ENGINE_VERSION, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, SectionTypes, SheetsFormfactorDefinition, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _DocumentScraperMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, assertsExecutionSuccessful, cacheLlmTools, collectionToJson, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, stringifyPipelineJson, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline };
+export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, AbstractFormatError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateFormfactorDefinition, CLAIM, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_BOOKS_DIRNAME, DEFAULT_CSV_SETTINGS, DEFAULT_EXECUTIONS_CACHE_DIRNAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TITLE, ERRORS, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, KnowledgeScrapeError, LOGO_DARK_SRC, LOGO_LIGHT_SRC, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotFoundError, NotYetImplementedError, PROMPTBOOK_ENGINE_VERSION, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _DocumentScraperMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, assertsExecutionSuccessful, cacheLlmTools, collectionToJson, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, stringifyPipelineJson, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline };
 //# sourceMappingURL=index.es.js.map