@promptbook/core 0.70.0-1 → 0.72.0-0

package/umd/index.umd.js

@@ -16,8 +16,8 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.70.0-0';
-    // TODO: !!!! List here all the versions and annotate + put into script
+    var PROMPTBOOK_VERSION = '0.68.5';
+    // TODO:[main] !!!! List here all the versions and annotate + put into script
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -229,7 +229,7 @@
             commands.push("PIPELINE URL ".concat(pipelineUrl));
         }
         commands.push("PROMPTBOOK VERSION ".concat(promptbookVersion));
-        // TODO: !!! This increase size of the bundle and is probbably not necessary
+        // TODO:[main] !!! This increase size of the bundle and is probbably not necessary
         pipelineString = prettifyMarkdown(pipelineString);
         try {
             for (var _g = __values(parameters.filter(function (_a) {
@@ -377,12 +377,12 @@
                 pipelineString += '```' + contentLanguage;
                 pipelineString += '\n';
                 pipelineString += spaceTrim__default["default"](content);
-                //                   <- TODO: !!! Escape
+                //                   <- TODO:[main] !!! Escape
                 //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
                 pipelineString += '\n';
                 pipelineString += '```';
                 pipelineString += '\n\n';
-                pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: !!! 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 templateParameterJsonToString
             }
         }
         catch (e_3_1) { e_3 = { error: e_3_1 }; }
@@ -602,7 +602,7 @@
     }
     /**
      * TODO: [🧠][🛣] More elegant way to tracking than passing `name`
-     * TODO: [🧠] !!! In-memory cache of same values to prevent multiple checks
+     * TODO: [🧠][main] !!! In-memory cache of same values to prevent multiple checks
      * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
      */
 
@@ -673,14 +673,14 @@
     var MAX_FILENAME_LENGTH = 30;
     /**
      * @@@
-     * TODO: [🐝] !!! Use
+     * TODO: [🐝][main] !!! Use
      *
      * @public exported from `@promptbook/core`
      */
     var MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
     /**
      * @@@
-     * TODO: [🐝] !!! Use
+     * TODO: [🐝][main] !!! Use
      *
      * @public exported from `@promptbook/core`
      */
@@ -835,7 +835,7 @@
         if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
             return false;
         }
-        // <- TODO: !!! Check isValidPromptbookVersion against PROMPTBOOK_VERSIONS
+        // <- TODO:[main] !!! Check isValidPromptbookVersion against PROMPTBOOK_VERSIONS
         return true;
     }
 
@@ -984,7 +984,7 @@
             // <- Note: [🚲]
             throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                    Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
         }
-        if (!isValidPromptbookVersion(pipeline.promptbookVersion)) {
+        if (pipeline.promptbookVersion !== undefined && !isValidPromptbookVersion(pipeline.promptbookVersion)) {
             // <- Note: [🚲]
             throw new PipelineLogicError(spaceTrim.spaceTrim(function (block) { return "\n                    Invalid Promptbook Version \"".concat(pipeline.promptbookVersion, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
         }
@@ -1179,11 +1179,11 @@
      *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
      */
     /**
-     * TODO: [🐣] !!!! Validate that all samples match expectations
-     * TODO: [🐣][🐝] !!!! Validate that knowledge is valid (non-void)
-     * TODO: [🐣] !!!! Validate that persona can be used only with CHAT variant
-     * TODO: [🐣] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
-     * TODO: [🐣] !!!! Validate that reserved parameter is not used as joker
+     * TODO: [🐣][main] !!!! Validate that all samples match expectations
+     * TODO: [🐣][🐝][main] !!!! Validate that knowledge is valid (non-void)
+     * TODO: [🐣][main] !!!! Validate that persona can be used only with CHAT variant
+     * TODO: [🐣][main] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+     * TODO: [🐣][main] !!!! Validate that reserved parameter is not used as joker
      * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
      * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
      */
@@ -1497,7 +1497,7 @@
         });
     }
     /**
-     * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+     * TODO:[main] !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
      */
 
     /**
@@ -1598,127 +1598,6 @@
         // <- [🅱]
     ];
 
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function deepClone(objectValue) {
-        return JSON.parse(JSON.stringify(objectValue));
-        /*
-        TODO: [🧠] Is there a better implementation?
-        > const propertyNames = Object.getOwnPropertyNames(objectValue);
-        > for (const propertyName of propertyNames) {
-        >     const value = (objectValue as really_any)[propertyName];
-        >     if (value && typeof value === 'object') {
-        >         deepClone(value);
-        >     }
-        > }
-        > return Object.assign({}, objectValue);
-        */
-    }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
-
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var ZERO_USAGE = $deepFreeze({
-        price: { value: 0 },
-        input: {
-            tokensCount: { value: 0 },
-            charactersCount: { value: 0 },
-            wordsCount: { value: 0 },
-            sentencesCount: { value: 0 },
-            linesCount: { value: 0 },
-            paragraphsCount: { value: 0 },
-            pagesCount: { value: 0 },
-        },
-        output: {
-            tokensCount: { value: 0 },
-            charactersCount: { value: 0 },
-            wordsCount: { value: 0 },
-            sentencesCount: { value: 0 },
-            linesCount: { value: 0 },
-            paragraphsCount: { value: 0 },
-            pagesCount: { value: 0 },
-        },
-    });
-    /**
-     * Function `addUsage` will add multiple usages into one
-     *
-     * Note: If you provide 0 values, it returns ZERO_USAGE
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function addUsage() {
-        var usageItems = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            usageItems[_i] = arguments[_i];
-        }
-        return usageItems.reduce(function (acc, item) {
-            var e_1, _a, e_2, _b;
-            var _c;
-            acc.price.value += ((_c = item.price) === null || _c === void 0 ? void 0 : _c.value) || 0;
-            try {
-                for (var _d = __values(Object.keys(acc.input)), _e = _d.next(); !_e.done; _e = _d.next()) {
-                    var key = _e.value;
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    if (item.input[key]) {
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        acc.input[key].value += item.input[key].value || 0;
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        if (item.input[key].isUncertain) {
-                            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                            //@ts-ignore
-                            acc.input[key].isUncertain = true;
-                        }
-                    }
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            try {
-                for (var _f = __values(Object.keys(acc.output)), _g = _f.next(); !_g.done; _g = _f.next()) {
-                    var key = _g.value;
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    if (item.output[key]) {
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        acc.output[key].value += item.output[key].value || 0;
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        if (item.output[key].isUncertain) {
-                            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                            //@ts-ignore
-                            acc.output[key].isUncertain = true;
-                        }
-                    }
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-            return acc;
-        }, deepClone(ZERO_USAGE));
-    }
-
     /**
      * Async version of Array.forEach
      *
@@ -1794,7 +1673,60 @@
         });
     }
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.70.0-0",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.70.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.70.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.70.0-0",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}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   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.ptbk.md"}];
+    /**
+     * Represents the usage with no resources consumed
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var ZERO_USAGE = $deepFreeze({
+        price: { value: 0 },
+        input: {
+            tokensCount: { value: 0 },
+            charactersCount: { value: 0 },
+            wordsCount: { value: 0 },
+            sentencesCount: { value: 0 },
+            linesCount: { value: 0 },
+            paragraphsCount: { value: 0 },
+            pagesCount: { value: 0 },
+        },
+        output: {
+            tokensCount: { value: 0 },
+            charactersCount: { value: 0 },
+            wordsCount: { value: 0 },
+            sentencesCount: { value: 0 },
+            linesCount: { value: 0 },
+            paragraphsCount: { value: 0 },
+            pagesCount: { value: 0 },
+        },
+    });
+    /**
+     * Represents the usage with unknown resources consumed
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var UNCERTAIN_USAGE = $deepFreeze({
+        price: { value: 0, isUncertain: true },
+        input: {
+            tokensCount: { value: 0, isUncertain: true },
+            charactersCount: { value: 0, isUncertain: true },
+            wordsCount: { value: 0, isUncertain: true },
+            sentencesCount: { value: 0, isUncertain: true },
+            linesCount: { value: 0, isUncertain: true },
+            paragraphsCount: { value: 0, isUncertain: true },
+            pagesCount: { value: 0, isUncertain: true },
+        },
+        output: {
+            tokensCount: { value: 0, isUncertain: true },
+            charactersCount: { value: 0, isUncertain: true },
+            wordsCount: { value: 0, isUncertain: true },
+            sentencesCount: { value: 0, isUncertain: true },
+            linesCount: { value: 0, isUncertain: true },
+            paragraphsCount: { value: 0, isUncertain: true },
+            pagesCount: { value: 0, isUncertain: true },
+        },
+    });
+
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",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.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",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}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   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.ptbk.md"}];
 
     var defaultDiacriticsRemovalMap = [
         {
@@ -2902,7 +2834,7 @@
         return true;
     }
     /**
-     * TODO: [🔃] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
+     * TODO: [🔃][main] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
      * 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`
@@ -3122,6 +3054,101 @@
         return union;
     }
 
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function deepClone(objectValue) {
+        return JSON.parse(JSON.stringify(objectValue));
+        /*
+        TODO: [🧠] Is there a better implementation?
+        > const propertyNames = Object.getOwnPropertyNames(objectValue);
+        > for (const propertyName of propertyNames) {
+        >     const value = (objectValue as really_any)[propertyName];
+        >     if (value && typeof value === 'object') {
+        >         deepClone(value);
+        >     }
+        > }
+        > return Object.assign({}, objectValue);
+        */
+    }
+    /**
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
+
+    /**
+     * Function `addUsage` will add multiple usages into one
+     *
+     * Note: If you provide 0 values, it returns ZERO_USAGE
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function addUsage() {
+        var usageItems = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            usageItems[_i] = arguments[_i];
+        }
+        return usageItems.reduce(function (acc, item) {
+            var e_1, _a, e_2, _b;
+            var _c;
+            acc.price.value += ((_c = item.price) === null || _c === void 0 ? void 0 : _c.value) || 0;
+            try {
+                for (var _d = __values(Object.keys(acc.input)), _e = _d.next(); !_e.done; _e = _d.next()) {
+                    var key = _e.value;
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    if (item.input[key]) {
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        acc.input[key].value += item.input[key].value || 0;
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        if (item.input[key].isUncertain) {
+                            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                            //@ts-ignore
+                            acc.input[key].isUncertain = true;
+                        }
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            try {
+                for (var _f = __values(Object.keys(acc.output)), _g = _f.next(); !_g.done; _g = _f.next()) {
+                    var key = _g.value;
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    if (item.output[key]) {
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        acc.output[key].value += item.output[key].value || 0;
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        if (item.output[key].isUncertain) {
+                            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                            //@ts-ignore
+                            acc.output[key].isUncertain = true;
+                        }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            return acc;
+        }, deepClone(ZERO_USAGE));
+    }
+
     /**
      * Counts number of characters in the text
      *
@@ -3303,7 +3330,7 @@
             console.warn(spaceTrim.spaceTrim(function (block) { return "\n                    Pipeline is not prepared\n\n                    ".concat(block(pipelineIdentification), "\n\n                    It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                    But it is recommended to prepare the pipeline during collection preparation\n\n                    @see more at https://ptbk.io/prepare-pipeline\n                "); }));
         }
         var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
-            // TODO: !!! Extract to separate functions and files - ALL FUNCTIONS BELOW
+            // TODO:[main] !!! Extract to separate functions and files - ALL FUNCTIONS BELOW
             function getContextForTemplate(template) {
                 return __awaiter(this, void 0, void 0, function () {
                     return __generator(this, function (_a) {
@@ -4122,7 +4149,7 @@
         return pipelineExecutor;
     }
     /**
-     * TODO: !!! Identify not only pipeline BUT exact template ${block(pipelineIdentification)}
+     * TODO:[main] !!! Identify not only pipeline BUT exact template ${block(pipelineIdentification)}
      * TODO: Use isVerbose here (not only pass to `preparePipeline`)
      * TODO: [🧠][🌳] Use here `countTotalUsage` and put preparation and prepared pipiline to report
      * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
@@ -4185,7 +4212,7 @@
                         outputParameters = result.outputParameters;
                         knowledgePiecesRaw = outputParameters.knowledgePieces;
                         knowledgeTextPieces = (knowledgePiecesRaw || '').split('\n---\n');
-                        //                                                               <- TODO: !!!!! Smarter split and filter out empty pieces
+                        //                                                               <- TODO:[main] !!!!! Smarter split and filter out empty pieces
                         if (isVerbose) {
                             console.info('knowledgeTextPieces:', knowledgeTextPieces);
                         }
@@ -4265,7 +4292,7 @@
         });
     }
     /**
-     * TODO: [🐝][🔼] !!! Export via `@promptbook/markdown`
+     * TODO: [🐝][🔼][main] !!! Export via `@promptbook/markdown`
      * TODO: [🪂] Do it in parallel 11:11
      * Note: No need to aggregate usage here, it is done by intercepting the llmTools
      */
@@ -4289,7 +4316,7 @@
                                 var partialPieces, pieces;
                                 return __generator(this, function (_a) {
                                     switch (_a.label) {
-                                        case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.sourceContent, // <- TODO: [🐝] !!! Unhardcode markdown, detect which type it is - BE AWARE of big package size
+                                        case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.sourceContent, // <- TODO: [🐝][main] !!! Unhardcode markdown, detect which type it is - BE AWARE of big package size
                                             options)];
                                         case 1:
                                             partialPieces = _a.sent();
@@ -4481,7 +4508,7 @@
         });
     }
     /**
-     * TODO: [🔃] !!!!! If the persona was prepared with different version or different set of models, prepare it once again
+     * TODO: [🔃][main] !!!!! If the persona was prepared with different version or different set of models, prepare it once again
      * TODO: [🏢] !! Check validity of `modelName` in pipeline
      * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
      * TODO: [🏢] !! Check validity of `temperature` in pipeline
@@ -4530,7 +4557,7 @@
                     case 0:
                         _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a;
                         templates = pipeline.templates, parameters = pipeline.parameters, knowledgePiecesCount = pipeline.knowledgePiecesCount;
-                        // TODO: !!!!! Apply samples to each template (if missing and is for the template defined)
+                        // TODO:[main] !!!!! Apply samples to each template (if missing and is for the template defined)
                         TODO_USE(parameters);
                         templatesPrepared = new Array(
                         //            <- TODO: [🧱] Implement in a functional (not new Class) way
@@ -4562,7 +4589,7 @@
     /**
      * TODO: [🧠] Add context to each template (if missing)
      * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
-     * TODO: [♨] !!! Prepare index the samples and maybe templates
+     * TODO: [♨][main] !!! Prepare index the samples and maybe templates
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
      * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
@@ -4734,7 +4761,7 @@
             if (sourceContent === '') {
                 throw new ParseError("Source is not defined");
             }
-            // TODO: !!!! Following checks should be applied every link in the `sourceContent`
+            // TODO:[main] !!!! Following checks should be applied every link in the `sourceContent`
             if (sourceContent.startsWith('http://')) {
                 throw new ParseError("Source is not secure");
             }
@@ -4919,7 +4946,7 @@
             if (command.templateType === 'KNOWLEDGE') {
                 knowledgeCommandParser.$applyToPipelineJson({
                     type: 'KNOWLEDGE',
-                    sourceContent: $templateJson.content, // <- TODO: [🐝] !!! Work with KNOWLEDGE which not referring to the source file or website, but its content itself
+                    sourceContent: $templateJson.content, // <- TODO: [🐝][main] !!! Work with KNOWLEDGE which not referring to the source file or website, but its content itself
                 }, $pipelineJson);
                 $templateJson.isTemplate = false;
                 return;
@@ -5199,76 +5226,6 @@
         },
     };
 
-    /**
-     * @@@
-     *
-     * @param text @@@
-     * @returns @@@
-     * @example 'HELLO_WORLD'
-     * @example 'I_LOVE_PROMPTBOOK'
-     * @public exported from `@promptbook/utils`
-     */
-    function normalizeTo_SCREAMING_CASE(text) {
-        var e_1, _a;
-        var charType;
-        var lastCharType = 'OTHER';
-        var normalizedName = '';
-        try {
-            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
-                var char = text_1_1.value;
-                var normalizedChar = void 0;
-                if (/^[a-z]$/.test(char)) {
-                    charType = 'LOWERCASE';
-                    normalizedChar = char.toUpperCase();
-                }
-                else if (/^[A-Z]$/.test(char)) {
-                    charType = 'UPPERCASE';
-                    normalizedChar = char;
-                }
-                else if (/^[0-9]$/.test(char)) {
-                    charType = 'NUMBER';
-                    normalizedChar = char;
-                }
-                else if (/^\/$/.test(char)) {
-                    charType = 'SLASH';
-                    normalizedChar = char;
-                }
-                else {
-                    charType = 'OTHER';
-                    normalizedChar = '_';
-                }
-                if (charType !== lastCharType &&
-                    !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
-                    !(lastCharType === 'NUMBER') &&
-                    !(charType === 'NUMBER')) {
-                    normalizedName += '_';
-                }
-                normalizedName += normalizedChar;
-                lastCharType = charType;
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        normalizedName = normalizedName.replace(/_+/g, '_');
-        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
-        normalizedName = normalizedName.replace(/^_/, '');
-        normalizedName = normalizedName.replace(/_$/, '');
-        return normalizedName;
-    }
-    /**
-     * TODO: Tests
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
-     * TODO: [🌺] Use some intermediate util splitWords
-     */
-
     /**
      * Parses the foreach command
      *
@@ -5306,59 +5263,17 @@
             'FOREACH List Line -> `{customer}`',
             'FOR List Line -> `{customer}`',
             'EACH List Line -> `{customer}`',
-            // <- TODO: [🍭] !!!!!! More
+            // <- TODO: [🍭] More
         ],
         /**
          * Parses the FOREACH command
          */
         parse: function (input) {
-            var args = input.args, rawArgs = input.rawArgs;
-            var formatName = normalizeTo_SCREAMING_CASE(args[0] || '');
-            var cellName = normalizeTo_SCREAMING_CASE(args[1] || '');
-            var assignSign = args[2];
-            var parameter = args[3];
-            if (![
-                'LIST',
-                'CSV',
-                // <- TODO: [🏢] Unhardcode formats
-            ].includes(formatName)) {
-                console.info({ args: args, formatName: formatName });
-                throw new Error("Unsupported format \"".concat(formatName, "\""));
-                // <- TODO: [🏢] List all supported format names
-            }
-            if (![
-                'LINE',
-                'ROW',
-                'COLUMN',
-                'CELL',
-                // <- TODO: [🏢] Unhardcode format cekks
-            ].includes(cellName)) {
-                console.info({ args: args, cellName: cellName });
-                throw new Error("Format ".concat(formatName, " does not support cell \"").concat(cellName, "\""));
-                // <- TODO: [🏢] List all supported cell names for the format
-            }
-            if (assignSign !== '->') {
-                console.info({ args: args, assignSign: assignSign });
-                throw new Error("FOREACH command must have '->' to assign the value to the parameter");
-            }
-            var parameterNames = extractParameterNames(parameter || rawArgs);
-            if (parameterNames.size !== 1) {
-                console.info({ args: args, parameter: parameter, rawArgs: rawArgs });
-                throw new Error("FOREACH command contain exactly one parameter, but found ".concat(parameterNames.size));
-            }
-            var parameterName = parameterNames.values().next().value;
-            if (typeof parameterName !== 'string'
-            // <- TODO: !!!!!! Replace with propper parameter name validation
-            ) {
-                console.info({ args: args, parameterName: parameterName });
-                throw new Error("Invalid parameter name");
-                // <- TODO: !!!!!! Better error (with rules and precise error) from validateParameterName
-            }
+            var args = input.args;
+            keepUnused(args);
+            // <- TODO: [🍭] Implement
             return {
                 type: 'FOREACH',
-                formatName: formatName,
-                cellName: cellName,
-                parameterName: parameterName,
             };
         },
         /**
@@ -5368,7 +5283,7 @@
          */
         $applyToTemplateJson: function (command, $templateJson, $pipelineJson) {
             keepUnused(command, $templateJson, $pipelineJson);
-            // <- TODO: [🍭] !!!!!! Implement
+            // <- TODO: [🍭] Implement
         },
         /**
          * Converts the FOREACH command back to string
@@ -5378,7 +5293,7 @@
         stringify: function (command) {
             keepUnused(command);
             return "";
-            // <- TODO: [🍭] !!!!!! Implement
+            // <- TODO: [🍭] Implement
         },
         /**
          * Reads the FOREACH command from the `TemplateJson`
@@ -5388,12 +5303,11 @@
         takeFromTemplateJson: function ($templateJson) {
             keepUnused($templateJson);
             return [];
-            // <- TODO: [🍭] !!!!!! Implement
+            // <- TODO: [🍭] Implement
         },
     };
     /**
-     * TODO: !!!!!! Comment console logs
-     * TODO: [🍭] !!!!!! Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
+     * TODO: [🍭] Make .ptbk.md file with examples of the FOREACH command and also with wrong parsing and logic
      */
 
     /**
@@ -5746,7 +5660,6 @@
                 isInput = false;
                 isOutput = false;
             }
-            // TODO: !!!!!! Add parameter name validation
             return {
                 type: 'PARAMETER',
                 parameterName: parameterName,
@@ -6075,6 +5988,7 @@
          * Note: `$` is used to indicate that this function mutates given `pipelineJson`
          */
         $applyToPipelineJson: function (command, $pipelineJson) {
+            // TODO: Warn if the version is overridden
             $pipelineJson.promptbookVersion = command.promptbookVersion;
         },
         /**
@@ -6499,6 +6413,76 @@
         return str;
     }
 
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @returns @@@
+     * @example 'HELLO_WORLD'
+     * @example 'I_LOVE_PROMPTBOOK'
+     * @public exported from `@promptbook/utils`
+     */
+    function normalizeTo_SCREAMING_CASE(text) {
+        var e_1, _a;
+        var charType;
+        var lastCharType = 'OTHER';
+        var normalizedName = '';
+        try {
+            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+                var char = text_1_1.value;
+                var normalizedChar = void 0;
+                if (/^[a-z]$/.test(char)) {
+                    charType = 'LOWERCASE';
+                    normalizedChar = char.toUpperCase();
+                }
+                else if (/^[A-Z]$/.test(char)) {
+                    charType = 'UPPERCASE';
+                    normalizedChar = char;
+                }
+                else if (/^[0-9]$/.test(char)) {
+                    charType = 'NUMBER';
+                    normalizedChar = char;
+                }
+                else if (/^\/$/.test(char)) {
+                    charType = 'SLASH';
+                    normalizedChar = char;
+                }
+                else {
+                    charType = 'OTHER';
+                    normalizedChar = '_';
+                }
+                if (charType !== lastCharType &&
+                    !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+                    !(lastCharType === 'NUMBER') &&
+                    !(charType === 'NUMBER')) {
+                    normalizedName += '_';
+                }
+                normalizedName += normalizedChar;
+                lastCharType = charType;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        normalizedName = normalizedName.replace(/_+/g, '_');
+        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+        normalizedName = normalizedName.replace(/^_/, '');
+        normalizedName = normalizedName.replace(/_$/, '');
+        return normalizedName;
+    }
+    /**
+     * TODO: Tests
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+     * TODO: [🌺] Use some intermediate util splitWords
+     */
+
     /**
      * Parses one line of ul/ol to command
      *
@@ -6511,7 +6495,6 @@
         if (raw.includes('\n') || raw.includes('\r')) {
             throw new ParseError('Command can not contain new line characters' /* <- TODO: [🚞] */);
         }
-        // TODO: Unit test all this processing and parsing
         var normalized = raw.trim();
         normalized = normalized.split('`').join('');
         normalized = normalized.split('"').join('');
@@ -6567,7 +6550,7 @@
         //        Arg1   Arg2   Arg3 | FOO
         {
             var commandNameRaw = items.slice(-1).join('_');
-            var args = items.slice(0, -1); // <- Note: This is probbably not correct
+            var args = items.slice(0, -1);
             var rawArgs = raw.substring(0, raw.length - commandNameRaw.length).trim();
             var command = parseCommandVariant({ usagePlace: usagePlace, raw: raw, rawArgs: rawArgs, normalized: normalized, args: args, commandNameRaw: commandNameRaw });
             if (command !== null) {
@@ -6895,7 +6878,7 @@
         var $pipelineJson = {
             title: undefined /* <- Note: [🍙] Putting here placeholder to keep `title` on top at final JSON */,
             pipelineUrl: undefined /* <- Note: Putting here placeholder to keep `pipelineUrl` on top at final JSON */,
-            promptbookVersion: PROMPTBOOK_VERSION,
+            promptbookVersion: undefined /* <- Note: By default no explicit version */,
             description: undefined /* <- Note: [🍙] Putting here placeholder to keep `description` on top at final JSON */,
             parameters: [],
             templates: [],
@@ -7186,7 +7169,7 @@
         return $asDeeplyFrozenSerializableJson('pipelineJson', $pipelineJson);
     }
     /**
-     * TODO: !!!! Warn if used only sync version
+     * TODO:[main] !!!! Warn if used only sync version
      * TODO: [🚞] Report here line/column of error
      * TODO: Use spaceTrim more effectively
      * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
@@ -7461,7 +7444,7 @@
         }
     }
     /**
-     * TODO: [🧠] !!! In-memory cache of same values to prevent multiple checks
+     * TODO: [🧠][main] !!! In-memory cache of same values to prevent multiple checks
      * TODO: [🧠][💺] Can be done this on type-level?
      */
 
@@ -8514,6 +8497,7 @@
     exports.PrefixStorage = PrefixStorage;
     exports.RESERVED_PARAMETER_NAMES = RESERVED_PARAMETER_NAMES;
     exports.TemplateTypes = TemplateTypes;
+    exports.UNCERTAIN_USAGE = UNCERTAIN_USAGE;
     exports.UnexpectedError = UnexpectedError;
     exports.ZERO_USAGE = ZERO_USAGE;
     exports._AnthropicClaudeMetadataRegistration = _AnthropicClaudeMetadataRegistration;