@promptbook/utils 0.44.0-2 → 0.44.0-20

package/umd/index.umd.js

@@ -1,12 +1,11 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('moment')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'moment'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.moment));
-})(this, (function (exports, spaceTrim, prettier, parserHtml, moment) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.spacetrim, global.prettier, global.parserHtml, global.moment));
+})(this, (function (exports, spacetrim, prettier, parserHtml, moment) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
 
@@ -176,7 +175,7 @@
     var UnexpectedError = /** @class */ (function (_super) {
         __extends(UnexpectedError, _super);
         function UnexpectedError(message) {
-            var _this = _super.call(this, spaceTrim__default["default"](function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+            var _this = _super.call(this, spacetrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
             _this.name = 'UnexpectedError';
             Object.setPrototypeOf(_this, UnexpectedError.prototype);
             return _this;
@@ -229,7 +228,7 @@
                             }
                             if (parent_1.parent === null /* <- Note: We are in root */) {
                                 // [🌻]
-                                throw new Error(spaceTrim__default["default"]("\n                                The file has an invalid structure.\n                                The markdown file must have exactly one top-level section.\n                            "));
+                                throw new Error(spacetrim.spaceTrim("\n                                The file has an invalid structure.\n                                The markdown file must have exactly one top-level section.\n                            "));
                             }
                             parent_1 = parent_1.parent;
                         }
@@ -263,7 +262,7 @@
         return {
             level: level,
             title: title,
-            content: spaceTrim__default["default"](contentLines.join('\n')),
+            content: spacetrim.spaceTrim(contentLines.join('\n')),
             sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
         };
     }
@@ -403,13 +402,13 @@
      * @returns {string} The input string with all comments removed.
      */
     function removeContentComments(content) {
-        return spaceTrim__default["default"](content.replace(/<!--(.*?)-->/gs, ''));
+        return spacetrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.44.0-1';
+    var PROMPTBOOK_VERSION = '0.44.0-19';
 
     /**
      * Parses the given script and returns the list of all used variables that are not defined in the script
@@ -454,7 +453,7 @@
             if (!(error instanceof Error)) {
                 throw error;
             }
-            throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+            throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
         }
         return variables;
     }
@@ -477,6 +476,7 @@
      */
     var EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'PARAGRAPHS', 'LINES', 'PAGES'];
     /**
+     * TODO: [💝] Unite object for expecting amount and format - remove expectFormat
      * TODO: use one helper type> (string_prompt | string_javascript | string_markdown) & string_template
      */
 
@@ -601,15 +601,15 @@
             type.startsWith('PROMPTBOOKURL') ||
             type.startsWith('HTTPS')) {
             if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
             var promptbookUrlString = listItemParts.pop();
             var promptbookUrl = new URL(promptbookUrlString);
             if (promptbookUrl.protocol !== 'https:') {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
             }
             if (promptbookUrl.hash !== '') {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        URL must not contain hash\n                        Hash is used for identification of the prompt template in the pipeline\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        URL must not contain hash\n                        Hash is used for identification of the prompt template in the pipeline\n                    ")));
             }
             return {
                 type: 'PROMPTBOOK_URL',
@@ -618,7 +618,7 @@
         }
         else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
             if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
             var promptbookVersion = listItemParts.pop();
             // TODO: Validate version
@@ -633,7 +633,7 @@
             type.startsWith('SIMPLE_TEMPLATE')) {
             var executionTypes = ExecutionTypes.filter(function (executionType) { return type.includes(executionType); });
             if (executionTypes.length !== 1) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Unknown execution type in command:\n\n                        - ".concat(listItem, "\n\n                        Supported execution types are:\n                        ").concat(block(ExecutionTypes.join(', ')), "\n                    "); }));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                        Unknown execution type in command:\n\n                        - ".concat(listItem, "\n\n                        Supported execution types are:\n                        ").concat(block(ExecutionTypes.join(', ')), "\n                    "); }));
             }
             return {
                 type: 'EXECUTE',
@@ -658,7 +658,7 @@
                     };
                 }
                 else {
-                    throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                            Unknown model variant in command:\n\n                            - ".concat(listItem, "\n\n                            Supported variants are:\n                            ").concat(block(['CHAT', 'COMPLETION'].join(', ')), "\n                        "); }));
+                    throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                            Unknown model variant in command:\n\n                            - ".concat(listItem, "\n\n                            Supported variants are:\n                            ").concat(block(['CHAT', 'COMPLETION'].join(', ')), "\n                        "); }));
                 }
             }
             if (type.startsWith('MODEL_NAME')) {
@@ -669,7 +669,7 @@
                 };
             }
             else {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                          Unknown model key in command:\n\n                          - ".concat(listItem, "\n\n                          Supported model keys are:\n                          ").concat(block(['variant', 'name'].join(', ')), "\n\n                          Example:\n\n                          - MODEL VARIANT Chat\n                          - MODEL NAME gpt-4\n                    "); }));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                          Unknown model key in command:\n\n                          - ".concat(listItem, "\n\n                          Supported model keys are:\n                          ").concat(block(['variant', 'name'].join(', ')), "\n\n                          Example:\n\n                          - MODEL VARIANT Chat\n                          - MODEL NAME gpt-4\n                    "); }));
             }
         }
         else if (type.startsWith('PARAM') ||
@@ -679,12 +679,12 @@
             listItem.startsWith('> {') /* <- Note: This is a bit hack to parse return parameters defined at the end of each section */) {
             var parametersMatch = listItem.match(/\{(?<parameterName>[a-z0-9_]+)\}[^\S\r\n]*(?<parameterDescription>.*)$/im);
             if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Invalid parameter in command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid parameter in command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             var _b = parametersMatch.groups, parameterName = _b.parameterName, parameterDescription = _b.parameterDescription;
             if (parameterDescription && parameterDescription.match(/\{(?<parameterName>[a-z0-9_]+)\}/im)) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                        Parameter {".concat(parameterName, "} can not contain another parameter in description:\n\n                        - ").concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Parameter {".concat(parameterName, "} can not contain another parameter in description:\n\n                        - ").concat(listItem, "\n                    ")));
             }
             var isInput = type.startsWith('INPUT');
             var isOutput = type.startsWith('OUTPUT');
@@ -702,11 +702,11 @@
         }
         else if (type.startsWith('JOKER')) {
             if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid JOKER command:\n\n                - ".concat(listItem, "\n            ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid JOKER command:\n\n                - ".concat(listItem, "\n            ")));
             }
             var parametersMatch = (listItemParts.pop() || '').match(/^\{(?<parameterName>[a-z0-9_]+)\}$/im);
             if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                      Invalid parameter in command:\n\n                      - ".concat(listItem, "\n                  ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                      Invalid parameter in command:\n\n                      - ".concat(listItem, "\n                  ")));
             }
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             var parameterName = parametersMatch.groups.parameterName;
@@ -717,7 +717,7 @@
         }
         else if (type.startsWith('POSTPROCESS') || type.startsWith('POST_PROCESS')) {
             if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
             }
             var functionName = listItemParts.pop();
             return {
@@ -797,7 +797,7 @@
                 if (!(error instanceof Error)) {
                     throw error;
                 }
-                throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
             }
             /*
         } else if (type.startsWith('__________________')) {
@@ -805,7 +805,7 @@
         */
         }
         else {
-            throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - PROMPTBOOK_URL <url>\n                    - PROMPTBOOK_VERSION <version>\n                    - EXECUTE PROMPT TEMPLATE\n                    - EXECUTE SIMPLE TEMPLATE\n                    -         SIMPLE TEMPLATE\n                    - EXECUTE SCRIPT\n                    - EXECUTE PROMPT_DIALOG'\n                    -         PROMPT_DIALOG'\n                    - MODEL NAME <name>\n                    - MODEL VARIANT <\"Chat\"|\"Completion\">\n                    - INPUT  PARAM {<name>} <description>\n                    - OUTPUT PARAM {<name>} <description>\n                    - POSTPROCESS `{functionName}`\n                    - JOKER {<name>}\n                    - EXPECT JSON\n                    - EXPECT <\"Exactly\"|\"Min\"|\"Max\"> <number> <\"Chars\"|\"Words\"|\"Sentences\"|\"Paragraphs\"|\"Pages\">\n\n                ")));
+            throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - PROMPTBOOK_URL <url>\n                    - PROMPTBOOK_VERSION <version>\n                    - EXECUTE PROMPT TEMPLATE\n                    - EXECUTE SIMPLE TEMPLATE\n                    -         SIMPLE TEMPLATE\n                    - EXECUTE SCRIPT\n                    - EXECUTE PROMPT_DIALOG'\n                    -         PROMPT_DIALOG'\n                    - MODEL NAME <name>\n                    - MODEL VARIANT <\"Chat\"|\"Completion\">\n                    - INPUT  PARAM {<name>} <description>\n                    - OUTPUT PARAM {<name>} <description>\n                    - POSTPROCESS `{functionName}`\n                    - JOKER {<name>}\n                    - EXPECT JSON\n                    - EXPECT <\"Exactly\"|\"Min\"|\"Max\"> <number> <\"Chars\"|\"Words\"|\"Sentences\"|\"Paragraphs\"|\"Pages\">\n\n                ")));
         }
     }
 
@@ -841,7 +841,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
             }
             if (existingParameter) {
                 if (parameterDescription) {
@@ -862,7 +862,7 @@
         var markdownStructure = markdownToMarkdownStructure(promptbookString);
         var markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
         if (markdownStructureDeepness !== 2) {
-            throw new PromptbookSyntaxError(spaceTrim__default["default"]("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
+            throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
         }
         promptbookJson.title = markdownStructure.title;
         // TODO: [1] DRY description
@@ -871,7 +871,7 @@
         description = description.split(/^```.*^```/gms).join('');
         //Note: Remove lists and return statement
         description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description = spaceTrim__default["default"](description);
+        description = spacetrim.spaceTrim(description);
         if (description === '') {
             description = undefined;
         }
@@ -986,13 +986,13 @@
                     throw new PromptbookSyntaxError('You must specify the language of the script in the prompt template');
                 }
                 else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                    throw new PromptbookSyntaxError(spaceTrim__default["default"](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                        "); }));
+                    throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
                 }
             }
             var lastLine = section.content.split('\n').pop();
             var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
             if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
-                throw new PromptbookSyntaxError(spaceTrim__default["default"](function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
                 // TODO: Show code of invalid sections each time + DRY
                 section.content
                     .split('\n')
@@ -1006,7 +1006,7 @@
             description_1 = description_1.split(/^```.*^```/gms).join('');
             //Note: Remove lists and return statement
             description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-            description_1 = spaceTrim__default["default"](description_1);
+            description_1 = spacetrim.spaceTrim(description_1);
             if (description_1 === '') {
                 description_1 = undefined;
             }
@@ -1097,7 +1097,7 @@
         var sectionRegex = new RegExp("<!--".concat(sectionName, "-->([\\s\\S]*?)<!--/").concat(sectionName, "-->"), 'g');
         var sectionMatch = content.match(sectionRegex);
         if (sectionMatch) {
-            return content.replace(sectionRegex, spaceTrim__default["default"](function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
+            return content.replace(sectionRegex, spacetrim.spaceTrim(function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
         }
         var placeForSection = removeContentComments(content).match(/^##.*$/im);
         if (!placeForSection) {
@@ -1160,7 +1160,7 @@
                 }
                 return 'template' + normalizeTo_PascalCase(template.title);
             };
-            var promptbookMermaid_1 = spaceTrim__default["default"](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(promptbookJson_1.title, "\"\n\n                      direction TB\n\n                      input((Input)):::input\n                      ").concat(block(promptbookJson_1.promptTemplates
+            var promptbookMermaid_1 = spacetrim.spaceTrim(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(promptbookJson_1.title, "\"\n\n                      direction TB\n\n                      input((Input)):::input\n                      ").concat(block(promptbookJson_1.promptTemplates
                 .flatMap(function (_a) {
                 var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
                 return __spreadArray([
@@ -1179,7 +1179,7 @@
                 return "".concat(parameterNameToTemplateName_1(name), "--\"{").concat(name, "}\"-->output");
             })
                 .join('\n')), "\n                      output((Output)):::output\n\n                      classDef input color: grey;\n                      classDef output color: grey;\n\n                  end;\n\n\n\n        "); });
-            var promptbookMermaidBlock = spaceTrim__default["default"](function (block) { return "\n            ```mermaid\n            ".concat(block(promptbookMermaid_1), "\n            ```\n        "); });
+            var promptbookMermaidBlock = spacetrim.spaceTrim(function (block) { return "\n            ```mermaid\n            ".concat(block(promptbookMermaid_1), "\n            ```\n        "); });
             promptbookString = addAutoGeneratedSection(promptbookString, {
                 sectionName: 'Graph',
                 sectionContent: promptbookMermaidBlock,
@@ -1227,7 +1227,7 @@
             throw errors[0];
         }
         else {
-            throw new PromptbookExecutionError(spaceTrim__default["default"](function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n')), "\n                "); }));
+            throw new PromptbookExecutionError(spacetrim.spaceTrim(function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n')), "\n                "); }));
         }
     }
     /**
@@ -1235,464 +1235,73 @@
      */
 
     /**
-     * This error occurs during the parameter replacement in the template
+     * This error occurs when some expectation is not met in the execution of the pipeline
      *
-     * Note: This is a kindof subtype of PromptbookExecutionError because it occurs during the execution of the pipeline
+     * @private Always catched and rethrown as `PromptbookExecutionError`
+     * Note: This is a kindof subtype of PromptbookExecutionError
      */
-    var TemplateError = /** @class */ (function (_super) {
-        __extends(TemplateError, _super);
-        function TemplateError(message) {
+    var ExpectError = /** @class */ (function (_super) {
+        __extends(ExpectError, _super);
+        function ExpectError(message) {
             var _this = _super.call(this, message) || this;
-            _this.name = 'TemplateError';
-            Object.setPrototypeOf(_this, TemplateError.prototype);
+            _this.name = 'ExpectError';
+            Object.setPrototypeOf(_this, ExpectError.prototype);
             return _this;
         }
-        return TemplateError;
+        return ExpectError;
     }(Error));
 
     /**
-     * Replaces parameters in template with values from parameters object
-     *
-     * @param template the template with parameters in {curly} braces
-     * @param parameters the object with parameters
-     * @returns the template with replaced parameters
-     * @throws {TemplateError} if parameter is not defined, not closed, or not opened
-     *
-     * @private within the createPromptbookExecutor
-     */
-    function replaceParameters(template, parameters) {
-        var replacedTemplate = template;
-        var match;
-        var loopLimit = LOOP_LIMIT;
-        var _loop_1 = function () {
-            if (loopLimit-- < 0) {
-                throw new UnexpectedError('Loop limit reached during parameters replacement in `replaceParameters`');
-            }
-            var precol = match.groups.precol;
-            var parameterName = match.groups.parameterName;
-            if (parameterName === '') {
-                return "continue";
-            }
-            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-                throw new TemplateError('Parameter is already opened or not closed');
-            }
-            if (parameters[parameterName] === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
-            }
-            var parameterValue = parameters[parameterName];
-            if (parameterValue === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
-            }
-            parameterValue = parameterValue.toString();
-            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
-                parameterValue = parameterValue
-                    .split('\n')
-                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
-                    .join('\n');
-            }
-            replacedTemplate =
-                replacedTemplate.substring(0, match.index + precol.length) +
-                    parameterValue +
-                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
-        };
-        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
-            .exec(replacedTemplate))) {
-            _loop_1();
-        }
-        // [💫] Check if there are parameters that are not closed properly
-        if (/{\w+$/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not closed');
-        }
-        // [💫] Check if there are parameters that are not opened properly
-        if (/^\w+}/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not opened');
-        }
-        return replacedTemplate;
-    }
-
-    /**
-     * Format either small or big number
-     *
-     * @private within the library
-     */
-    function formatNumber(value) {
-        if (value === 0) {
-            return '0';
-        }
-        for (var exponent = 0; exponent < 15; exponent++) {
-            var factor = Math.pow(10, exponent);
-            var valueRounded = Math.round(value * factor) / factor;
-            if (Math.abs(value - valueRounded) / value <
-                0.001 /* <- TODO: Pass as option, pass to executionReportJsonToString as option */) {
-                return valueRounded.toFixed(exponent);
-            }
-        }
-        return value.toString();
-    }
-
-    /**
-     * Returns the same value that is passed as argument.
-     * No side effects.
-     *
-     * Note: It can be usefull for leveling indentation
-     *
-     * @param value any values
-     * @returns the same values
-     */
-    function just(value) {
-        if (value === undefined) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            return undefined;
-        }
-        return value;
-    }
-
-    /**
-     * Removes emojis from a string and fix whitespaces
-     *
-     * @param text with emojis
-     * @returns text without emojis
+     * Counts number of characters in the text
      */
-    function removeEmojis(text) {
+    function countCharacters(text) {
+        // Remove null characters
+        text = text.replace(/\0/g, '');
         // Replace emojis (and also ZWJ sequence) with hyphens
         text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
         text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-        text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
-        text = text.replace(/\p{Extended_Pictographic}/gu, '');
-        return text;
-    }
-
-    /**
-     * Create a markdown table from a 2D array of strings
-     *
-     * @private within the library
-     */
-    function createMarkdownTable(table) {
-        var columnWidths = table.reduce(function (widths, row) {
-            row.forEach(function (cell, columnIndex) {
-                var cellLength = cell.length;
-                if (!widths[columnIndex] || cellLength > widths[columnIndex]) {
-                    widths[columnIndex] = cellLength;
-                }
-            });
-            return widths;
-        }, []);
-        var header = "| ".concat(table[0]
-            .map(function (cell, columnIndex) { return cell.padEnd(columnWidths[columnIndex]); })
-            .join(' | '), " |");
-        var separator = "|".concat(columnWidths.map(function (width) { return '-'.repeat(width + 2); }).join('|'), "|");
-        var rows = table.slice(1).map(function (row) {
-            var paddedRow = row.map(function (cell, columnIndex) {
-                return cell.padEnd(columnWidths[columnIndex]);
-            });
-            return "| ".concat(paddedRow.join(' | '), " |");
-        });
-        return __spreadArray([header, separator], __read(rows), false).join('\n');
+        text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
+        return text.length;
     }
 
     /**
-     * Function createMarkdownChart will draw a chart in markdown from ⬛+🟦 tiles
-     *
-     * @private within the library
+     * Counts number of lines in the text
      */
-    function createMarkdownChart(options) {
-        var e_1, _a;
-        var nameHeader = options.nameHeader, valueHeader = options.valueHeader, items = options.items, width = options.width, unitName = options.unitName;
-        var from = Math.min.apply(Math, __spreadArray([], __read(items.map(function (item) { return item.from; })), false));
-        var to = Math.max.apply(Math, __spreadArray([], __read(items.map(function (item) { return item.to; })), false));
-        var scale = width / (to - from);
-        var table = [[nameHeader, valueHeader]];
-        try {
-            for (var items_1 = __values(items), items_1_1 = items_1.next(); !items_1_1.done; items_1_1 = items_1.next()) {
-                var item = items_1_1.value;
-                var before = Math.round((item.from - from) * scale);
-                var during = Math.round((item.to - item.from) * scale);
-                var after = width - before - during;
-                table.push([removeEmojis(item.title).trim(), '░'.repeat(before) + '█'.repeat(during) + '░'.repeat(after)]);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (items_1_1 && !items_1_1.done && (_a = items_1.return)) _a.call(items_1);
-            }
-            finally { if (e_1) throw e_1.error; }
+    function countLines(text) {
+        if (text === '') {
+            return 0;
         }
-        var legend = "_Note: Each \u2588 represents ".concat(formatNumber(1 / scale), " ").concat(unitName, ", width of ").concat(valueHeader.toLowerCase(), " is ").concat(formatNumber(to - from), " ").concat(unitName, " = ").concat(width, " squares_");
-        return createMarkdownTable(table) + '\n\n' + legend;
+        return text.split('\n').length;
     }
-    /**
-     * TODO: Maybe use Mermain Gant Diagrams
-     *       @see https://jojozhuang.github.io/tutorial/mermaid-cheat-sheet/
-     */
 
     /**
-     * Function escapeMarkdownBlock will escape markdown block if needed
-     * It is useful when you want have block in block
+     * Counts number of pages in the text
      */
-    function escapeMarkdownBlock(value) {
-        return value.replace(/```/g, '\\`\\`\\`');
+    function countPages(text) {
+        var sentencesPerPage = 5; // Assuming each page has 5 sentences
+        var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+        var pageCount = Math.ceil(sentences.length / sentencesPerPage);
+        return pageCount;
     }
 
     /**
-     * Default options for generating an execution report string
+     * Counts number of paragraphs in the text
      */
-    var ExecutionReportStringOptionsDefaults = {
-        taxRate: 0,
-        chartsWidth: 36,
-    };
+    function countParagraphs(text) {
+        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
+    }
 
     /**
-     * The thresholds for the relative time in the `moment` library.
-     *
-     * @see https://momentjscom.readthedocs.io/en/latest/moment/07-customization/13-relative-time-threshold/
+     * Split text into sentences
      */
-    var MOMENT_ARG_THRESHOLDS = {
-        ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
-    };
-
+    function splitIntoSentences(text) {
+        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+    }
     /**
-     * Count the duration of working time
-     *
-     * @private within the library
+     * Counts number of sentences in the text
      */
-    function countWorkingDuration(items) {
-        var e_1, _a;
-        var steps = Array.from(new Set(items.flatMap(function (item) { return [item.from, item.to]; })));
-        steps.sort(function (a, b) { return a - b; });
-        var intervals = steps.map(function (step, index) { return [step, steps[index + 1] || 0]; }).slice(0, -1);
-        var duration = 0;
-        var _loop_1 = function (interval) {
-            var _b = __read(interval, 2), from = _b[0], to = _b[1];
-            if (items.some(function (item) { return item.from < to && item.to > from; })) {
-                duration += to - from;
-            }
-        };
-        try {
-            for (var intervals_1 = __values(intervals), intervals_1_1 = intervals_1.next(); !intervals_1_1.done; intervals_1_1 = intervals_1.next()) {
-                var interval = intervals_1_1.value;
-                _loop_1(interval);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (intervals_1_1 && !intervals_1_1.done && (_a = intervals_1.return)) _a.call(intervals_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        return duration;
-    }
-
-    /**
-     * Converts execution report from JSON to string format
-     */
-    function executionReportJsonToString(executionReportJson, options) {
-        var e_1, _a;
-        var _b, _c, _d, _e, _f, _g;
-        var _h = __assign(__assign({}, ExecutionReportStringOptionsDefaults), (options || {})), taxRate = _h.taxRate, chartsWidth = _h.chartsWidth;
-        var executionReportString = spaceTrim__default["default"](function (block) { return "\n            # ".concat(executionReportJson.title || 'Execution report', "\n\n            ").concat(block(executionReportJson.description || ''), "\n          "); });
-        var headerList = [];
-        if (executionReportJson.promptbookUrl) {
-            headerList.push("PROMPTBOOK URL ".concat(executionReportJson.promptbookUrl));
-        }
-        headerList.push("PROMPTBOOK VERSION ".concat(executionReportJson.promptbookUsedVersion) +
-            (!executionReportJson.promptbookRequestedVersion
-                ? ''
-                : " *(requested ".concat(executionReportJson.promptbookRequestedVersion, ")*")));
-        if (executionReportJson.promptExecutions.length !== 0) {
-            // TODO: What if startedAt OR/AND completedAt is not defined?
-            var startedAt = moment__default["default"](Math.min.apply(Math, __spreadArray([], __read(executionReportJson.promptExecutions
-                .filter(function (promptExecution) { var _a, _b; return (_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.start; })
-                .map(function (promptExecution) { return moment__default["default"](promptExecution.result.timing.start).valueOf(); })), false)));
-            var completedAt = moment__default["default"](Math.max.apply(Math, __spreadArray([], __read(executionReportJson.promptExecutions
-                .filter(function (promptExecution) { var _a, _b; return (_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.complete; })
-                .map(function (promptExecution) { return moment__default["default"](promptExecution.result.timing.complete).valueOf(); })), false)));
-            var timingItems = executionReportJson.promptExecutions.map(function (promptExecution) {
-                var _a, _b, _c, _d;
-                return ({
-                    title: promptExecution.prompt.title,
-                    from: moment__default["default"]((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.start).valueOf() / 1000,
-                    to: moment__default["default"]((_d = (_c = promptExecution.result) === null || _c === void 0 ? void 0 : _c.timing) === null || _d === void 0 ? void 0 : _d.complete).valueOf() / 1000,
-                });
-            });
-            var costItems = executionReportJson.promptExecutions
-                .filter(function (promptExecution) { var _a, _b; return typeof ((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) === 'number'; })
-                .map(function (promptExecution) {
-                var _a, _b;
-                return ({
-                    title: promptExecution.prompt.title,
-                    from: 0,
-                    to: ((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) * (1 + taxRate),
-                });
-            });
-            var duration = moment__default["default"].duration(completedAt.diff(startedAt));
-            var naturalDuration = moment__default["default"].duration(countWorkingDuration(timingItems) * 1000);
-            var executionsWithKnownCost = executionReportJson.promptExecutions.filter(function (promptExecution) { var _a, _b; return (((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) || 'UNKNOWN') !== 'UNKNOWN'; });
-            var cost = executionsWithKnownCost.reduce(function (cost, promptExecution) { return cost + (promptExecution.result.usage.price || 0); }, 0);
-            headerList.push("STARTED AT ".concat(moment__default["default"](startedAt).format("YYYY-MM-DD HH:mm:ss")));
-            headerList.push("COMPLETED AT ".concat(moment__default["default"](completedAt).format("YYYY-MM-DD HH:mm:ss")));
-            headerList.push("TOTAL DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
-            headerList.push("TOTAL NATURAL DURATION ".concat(naturalDuration.humanize(MOMENT_ARG_THRESHOLDS)));
-            headerList.push("TOTAL COST $".concat(formatNumber(cost * (1 + taxRate))) +
-                (executionsWithKnownCost.length === executionReportJson.promptExecutions.length
-                    ? ''
-                    : " *(Some cost is unknown)*") +
-                (taxRate !== 0 ? " *(with tax ".concat(taxRate * 100, "%)*") : ''));
-            executionReportString += '\n\n' + headerList.map(function (header) { return "- ".concat(header); }).join('\n');
-            executionReportString +=
-                '\n\n' +
-                    '## 🗃 Index' +
-                    '\n\n' +
-                    executionReportJson.promptExecutions
-                        .map(function (promptExecution) {
-                        // TODO: Make some better system to convert hedings to links
-                        var hash = normalizeToKebabCase(promptExecution.prompt.title);
-                        if (/^\s*\p{Extended_Pictographic}/u.test(promptExecution.prompt.title)) {
-                            hash = '-' + hash;
-                        }
-                        // TODO: Make working hash link for the template in md + pdf
-                        return "- [".concat(promptExecution.prompt.title, "](#").concat(hash, ")");
-                    })
-                        .join('\n');
-            executionReportString +=
-                '\n\n' +
-                    '## ⌚ Time chart' +
-                    '\n\n' +
-                    createMarkdownChart({
-                        nameHeader: 'Template',
-                        valueHeader: 'Timeline',
-                        items: timingItems,
-                        width: chartsWidth,
-                        unitName: 'seconds',
-                    });
-            executionReportString +=
-                '\n\n' +
-                    '## 💸 Cost chart' +
-                    '\n\n' +
-                    createMarkdownChart({
-                        nameHeader: 'Template',
-                        valueHeader: 'Cost',
-                        items: costItems,
-                        width: chartsWidth,
-                        unitName: 'USD',
-                    });
-        }
-        else {
-            headerList.push("TOTAL COST $0 *(Nothing executed)*");
-        }
-        var _loop_1 = function (promptExecution) {
-            executionReportString += '\n\n\n\n' + "## ".concat(promptExecution.prompt.title);
-            var templateList = [];
-            // TODO: What if startedAt OR/AND completedAt is not defined?
-            var startedAt = moment__default["default"]((_c = (_b = promptExecution.result) === null || _b === void 0 ? void 0 : _b.timing) === null || _c === void 0 ? void 0 : _c.start);
-            var completedAt = moment__default["default"]((_e = (_d = promptExecution.result) === null || _d === void 0 ? void 0 : _d.timing) === null || _e === void 0 ? void 0 : _e.complete);
-            var duration = moment__default["default"].duration(completedAt.diff(startedAt));
-            // Not need here:
-            // > templateList.push(`STARTED AT ${moment(startedAt).calendar()}`);
-            templateList.push("DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
-            if (typeof ((_g = (_f = promptExecution.result) === null || _f === void 0 ? void 0 : _f.usage) === null || _g === void 0 ? void 0 : _g.price) === 'number') {
-                templateList.push("COST $".concat(formatNumber(promptExecution.result.usage.price * (1 + taxRate))) +
-                    (taxRate !== 0 ? " *(with tax ".concat(taxRate * 100, "%)*") : ''));
-            }
-            else {
-                templateList.push("COST UNKNOWN");
-            }
-            executionReportString += '\n\n' + templateList.map(function (header) { return "- ".concat(header); }).join('\n');
-            /*
-              -   MODEL VARIANT ${promptExecution.prompt.modelRequirements.modelVariant}
-                    -   MODEL NAME \`${promptExecution.result?.model}\` (requested \`${
-                        promptExecution.prompt.modelRequirements.modelName
-
-            */
-            if (just(true)) {
-                executionReportString +=
-                    '\n\n\n\n' +
-                        spaceTrim__default["default"](function (block) { return "\n\n                        ### Prompt\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.prompt.content)), "\n                        ```\n\n                    "); });
-            }
-            if (promptExecution.result && promptExecution.result.content) {
-                executionReportString +=
-                    '\n\n\n\n' +
-                        spaceTrim__default["default"](function (block) { return "\n\n                        ### Result\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.result.content)), "\n                        ```\n                    "); });
-            }
-            if (promptExecution.error && promptExecution.error.message) {
-                executionReportString +=
-                    '\n\n\n\n' +
-                        spaceTrim__default["default"](function (block) { return "\n\n                        ### Error\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.error.message)), "\n                        ```\n\n                    "); });
-            }
-        };
-        try {
-            for (var _j = __values(executionReportJson.promptExecutions), _k = _j.next(); !_k.done; _k = _j.next()) {
-                var promptExecution = _k.value;
-                _loop_1(promptExecution);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        executionReportString = prettifyMarkdown(executionReportString);
-        return executionReportString;
-    }
-    /**
-     * TODO: Add mermaid chart for every report
-     * TODO: [🧠] Allow to filter out some parts of the report by options
-     */
-
-    /**
-     * Counts number of characters in the text
-     */
-    function countCharacters(text) {
-        // Remove null characters
-        text = text.replace(/\0/g, '');
-        // Replace emojis (and also ZWJ sequence) with hyphens
-        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-        text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
-        return text.length;
-    }
-
-    /**
-     * Counts number of lines in the text
-     */
-    function countLines(text) {
-        if (text === '') {
-            return 0;
-        }
-        return text.split('\n').length;
-    }
-
-    /**
-     * Counts number of pages in the text
-     */
-    function countPages(text) {
-        var sentencesPerPage = 5; // Assuming each page has 5 sentences
-        var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-        var pageCount = Math.ceil(sentences.length / sentencesPerPage);
-        return pageCount;
-    }
-
-    /**
-     * Counts number of paragraphs in the text
-     */
-    function countParagraphs(text) {
-        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
-    }
-
-    /**
-     * Split text into sentences
-     */
-    function splitIntoSentences(text) {
-        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-    }
-    /**
-     * Counts number of sentences in the text
-     */
-    function countSentences(text) {
-        return splitIntoSentences(text).length;
+    function countSentences(text) {
+        return splitIntoSentences(text).length;
     }
 
     var defaultDiacriticsRemovalMap = [
@@ -1969,6 +1578,471 @@
         PAGES: countPages,
     };
 
+    /**
+     * Function checkExpectations will check if the expectations on given value are met
+     *
+     * Note: There are two simmilar functions:
+     * - `checkExpectations` which throws an error if the expectations are not met
+     * - `isPassingExpectations` which returns a boolean
+     *
+     * @throws {ExpectError} if the expectations are not met
+     * @returns {void} Nothing
+     */
+    function checkExpectations(expectations, value) {
+        var e_1, _a;
+        try {
+            for (var _b = __values(Object.entries(expectations)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), unit = _d[0], _e = _d[1], max = _e.max, min = _e.min;
+                var amount = CountUtils[unit.toUpperCase()](value);
+                if (min && amount < min) {
+                    throw new ExpectError("Expected at least ".concat(min, " ").concat(unit, " but got ").concat(amount));
+                } /* not else */
+                if (max && amount > max) {
+                    throw new ExpectError("Expected at most ".concat(max, " ").concat(unit, " but got ").concat(amount));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    /**
+     * Function checkExpectations will check if the expectations on given value are met
+     *
+     * Note: There are two simmilar functions:
+     * - `checkExpectations` which throws an error if the expectations are not met
+     * - `isPassingExpectations` which returns a boolean
+     *
+     * @returns {boolean} True if the expectations are met
+     */
+    function isPassingExpectations(expectations, value) {
+        try {
+            checkExpectations(expectations, value);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof ExpectError)) {
+                throw error;
+            }
+            return false;
+        }
+    }
+    /**
+     * TODO: [💝] Unite object for expecting amount and format
+     */
+
+    /**
+     * This error occurs during the parameter replacement in the template
+     *
+     * Note: This is a kindof subtype of PromptbookExecutionError because it occurs during the execution of the pipeline
+     */
+    var TemplateError = /** @class */ (function (_super) {
+        __extends(TemplateError, _super);
+        function TemplateError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'TemplateError';
+            Object.setPrototypeOf(_this, TemplateError.prototype);
+            return _this;
+        }
+        return TemplateError;
+    }(Error));
+
+    /**
+     * Replaces parameters in template with values from parameters object
+     *
+     * @param template the template with parameters in {curly} braces
+     * @param parameters the object with parameters
+     * @returns the template with replaced parameters
+     * @throws {TemplateError} if parameter is not defined, not closed, or not opened
+     *
+     * @private within the createPromptbookExecutor
+     */
+    function replaceParameters(template, parameters) {
+        var replacedTemplate = template;
+        var match;
+        var loopLimit = LOOP_LIMIT;
+        var _loop_1 = function () {
+            if (loopLimit-- < 0) {
+                throw new UnexpectedError('Loop limit reached during parameters replacement in `replaceParameters`');
+            }
+            var precol = match.groups.precol;
+            var parameterName = match.groups.parameterName;
+            if (parameterName === '') {
+                return "continue";
+            }
+            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+                throw new TemplateError('Parameter is already opened or not closed');
+            }
+            if (parameters[parameterName] === undefined) {
+                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            var parameterValue = parameters[parameterName];
+            if (parameterValue === undefined) {
+                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            parameterValue = parameterValue.toString();
+            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+                parameterValue = parameterValue
+                    .split('\n')
+                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
+                    .join('\n');
+            }
+            replacedTemplate =
+                replacedTemplate.substring(0, match.index + precol.length) +
+                    parameterValue +
+                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
+        };
+        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+            .exec(replacedTemplate))) {
+            _loop_1();
+        }
+        // [💫] Check if there are parameters that are not closed properly
+        if (/{\w+$/.test(replacedTemplate)) {
+            throw new TemplateError('Parameter is not closed');
+        }
+        // [💫] Check if there are parameters that are not opened properly
+        if (/^\w+}/.test(replacedTemplate)) {
+            throw new TemplateError('Parameter is not opened');
+        }
+        return replacedTemplate;
+    }
+
+    /**
+     * Format either small or big number
+     *
+     * @private within the library
+     */
+    function formatNumber(value) {
+        if (value === 0) {
+            return '0';
+        }
+        for (var exponent = 0; exponent < 15; exponent++) {
+            var factor = Math.pow(10, exponent);
+            var valueRounded = Math.round(value * factor) / factor;
+            if (Math.abs(value - valueRounded) / value <
+                0.001 /* <- TODO: Pass as option, pass to executionReportJsonToString as option */) {
+                return valueRounded.toFixed(exponent);
+            }
+        }
+        return value.toString();
+    }
+
+    /**
+     * Returns the same value that is passed as argument.
+     * No side effects.
+     *
+     * Note: It can be usefull for leveling indentation
+     *
+     * @param value any values
+     * @returns the same values
+     */
+    function just(value) {
+        if (value === undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return undefined;
+        }
+        return value;
+    }
+
+    /**
+     * Removes emojis from a string and fix whitespaces
+     *
+     * @param text with emojis
+     * @returns text without emojis
+     */
+    function removeEmojis(text) {
+        // Replace emojis (and also ZWJ sequence) with hyphens
+        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
+        text = text.replace(/\p{Extended_Pictographic}/gu, '');
+        return text;
+    }
+
+    /**
+     * Create a markdown table from a 2D array of strings
+     *
+     * @private within the library
+     */
+    function createMarkdownTable(table) {
+        var columnWidths = table.reduce(function (widths, row) {
+            row.forEach(function (cell, columnIndex) {
+                var cellLength = cell.length;
+                if (!widths[columnIndex] || cellLength > widths[columnIndex]) {
+                    widths[columnIndex] = cellLength;
+                }
+            });
+            return widths;
+        }, []);
+        var header = "| ".concat(table[0]
+            .map(function (cell, columnIndex) { return cell.padEnd(columnWidths[columnIndex]); })
+            .join(' | '), " |");
+        var separator = "|".concat(columnWidths.map(function (width) { return '-'.repeat(width + 2); }).join('|'), "|");
+        var rows = table.slice(1).map(function (row) {
+            var paddedRow = row.map(function (cell, columnIndex) {
+                return cell.padEnd(columnWidths[columnIndex]);
+            });
+            return "| ".concat(paddedRow.join(' | '), " |");
+        });
+        return __spreadArray([header, separator], __read(rows), false).join('\n');
+    }
+
+    /**
+     * Function createMarkdownChart will draw a chart in markdown from ⬛+🟦 tiles
+     *
+     * @private within the library
+     */
+    function createMarkdownChart(options) {
+        var e_1, _a;
+        var nameHeader = options.nameHeader, valueHeader = options.valueHeader, items = options.items, width = options.width, unitName = options.unitName;
+        var from = Math.min.apply(Math, __spreadArray([], __read(items.map(function (item) { return item.from; })), false));
+        var to = Math.max.apply(Math, __spreadArray([], __read(items.map(function (item) { return item.to; })), false));
+        var scale = width / (to - from);
+        var table = [[nameHeader, valueHeader]];
+        try {
+            for (var items_1 = __values(items), items_1_1 = items_1.next(); !items_1_1.done; items_1_1 = items_1.next()) {
+                var item = items_1_1.value;
+                var before = Math.round((item.from - from) * scale);
+                var during = Math.round((item.to - item.from) * scale);
+                var after = width - before - during;
+                table.push([removeEmojis(item.title).trim(), '░'.repeat(before) + '█'.repeat(during) + '░'.repeat(after)]);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (items_1_1 && !items_1_1.done && (_a = items_1.return)) _a.call(items_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var legend = "_Note: Each \u2588 represents ".concat(formatNumber(1 / scale), " ").concat(unitName, ", width of ").concat(valueHeader.toLowerCase(), " is ").concat(formatNumber(to - from), " ").concat(unitName, " = ").concat(width, " squares_");
+        return createMarkdownTable(table) + '\n\n' + legend;
+    }
+    /**
+     * TODO: Maybe use Mermain Gant Diagrams
+     *       @see https://jojozhuang.github.io/tutorial/mermaid-cheat-sheet/
+     */
+
+    /**
+     * Function escapeMarkdownBlock will escape markdown block if needed
+     * It is useful when you want have block in block
+     */
+    function escapeMarkdownBlock(value) {
+        return value.replace(/```/g, '\\`\\`\\`');
+    }
+
+    /**
+     * Default options for generating an execution report string
+     */
+    var ExecutionReportStringOptionsDefaults = {
+        taxRate: 0,
+        chartsWidth: 36,
+    };
+
+    /**
+     * The thresholds for the relative time in the `moment` library.
+     *
+     * @see https://momentjscom.readthedocs.io/en/latest/moment/07-customization/13-relative-time-threshold/
+     */
+    var MOMENT_ARG_THRESHOLDS = {
+        ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
+    };
+
+    /**
+     * Count the duration of working time
+     *
+     * @private within the library
+     */
+    function countWorkingDuration(items) {
+        var e_1, _a;
+        var steps = Array.from(new Set(items.flatMap(function (item) { return [item.from, item.to]; })));
+        steps.sort(function (a, b) { return a - b; });
+        var intervals = steps.map(function (step, index) { return [step, steps[index + 1] || 0]; }).slice(0, -1);
+        var duration = 0;
+        var _loop_1 = function (interval) {
+            var _b = __read(interval, 2), from = _b[0], to = _b[1];
+            if (items.some(function (item) { return item.from < to && item.to > from; })) {
+                duration += to - from;
+            }
+        };
+        try {
+            for (var intervals_1 = __values(intervals), intervals_1_1 = intervals_1.next(); !intervals_1_1.done; intervals_1_1 = intervals_1.next()) {
+                var interval = intervals_1_1.value;
+                _loop_1(interval);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (intervals_1_1 && !intervals_1_1.done && (_a = intervals_1.return)) _a.call(intervals_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return duration;
+    }
+
+    /**
+     * Converts execution report from JSON to string format
+     */
+    function executionReportJsonToString(executionReportJson, options) {
+        var e_1, _a;
+        var _b, _c, _d, _e, _f, _g;
+        var _h = __assign(__assign({}, ExecutionReportStringOptionsDefaults), (options || {})), taxRate = _h.taxRate, chartsWidth = _h.chartsWidth;
+        var executionReportString = spacetrim.spaceTrim(function (block) { return "\n            # ".concat(executionReportJson.title || 'Execution report', "\n\n            ").concat(block(executionReportJson.description || ''), "\n          "); });
+        var headerList = [];
+        if (executionReportJson.promptbookUrl) {
+            headerList.push("PROMPTBOOK URL ".concat(executionReportJson.promptbookUrl));
+        }
+        headerList.push("PROMPTBOOK VERSION ".concat(executionReportJson.promptbookUsedVersion) +
+            (!executionReportJson.promptbookRequestedVersion
+                ? ''
+                : " *(requested ".concat(executionReportJson.promptbookRequestedVersion, ")*")));
+        if (executionReportJson.promptExecutions.length !== 0) {
+            // TODO: What if startedAt OR/AND completedAt is not defined?
+            var startedAt = moment__default["default"](Math.min.apply(Math, __spreadArray([], __read(executionReportJson.promptExecutions
+                .filter(function (promptExecution) { var _a, _b; return (_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.start; })
+                .map(function (promptExecution) { return moment__default["default"](promptExecution.result.timing.start).valueOf(); })), false)));
+            var completedAt = moment__default["default"](Math.max.apply(Math, __spreadArray([], __read(executionReportJson.promptExecutions
+                .filter(function (promptExecution) { var _a, _b; return (_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.complete; })
+                .map(function (promptExecution) { return moment__default["default"](promptExecution.result.timing.complete).valueOf(); })), false)));
+            var timingItems = executionReportJson.promptExecutions.map(function (promptExecution) {
+                var _a, _b, _c, _d;
+                return ({
+                    title: promptExecution.prompt.title,
+                    from: moment__default["default"]((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.timing) === null || _b === void 0 ? void 0 : _b.start).valueOf() / 1000,
+                    to: moment__default["default"]((_d = (_c = promptExecution.result) === null || _c === void 0 ? void 0 : _c.timing) === null || _d === void 0 ? void 0 : _d.complete).valueOf() / 1000,
+                });
+            });
+            var costItems = executionReportJson.promptExecutions
+                .filter(function (promptExecution) { var _a, _b; return typeof ((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) === 'number'; })
+                .map(function (promptExecution) {
+                var _a, _b;
+                return ({
+                    title: promptExecution.prompt.title,
+                    from: 0,
+                    to: ((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) * (1 + taxRate),
+                });
+            });
+            var duration = moment__default["default"].duration(completedAt.diff(startedAt));
+            var naturalDuration = moment__default["default"].duration(countWorkingDuration(timingItems) * 1000);
+            var executionsWithKnownCost = executionReportJson.promptExecutions.filter(function (promptExecution) { var _a, _b; return (((_b = (_a = promptExecution.result) === null || _a === void 0 ? void 0 : _a.usage) === null || _b === void 0 ? void 0 : _b.price) || 'UNKNOWN') !== 'UNKNOWN'; });
+            var cost = executionsWithKnownCost.reduce(function (cost, promptExecution) { return cost + (promptExecution.result.usage.price || 0); }, 0);
+            headerList.push("STARTED AT ".concat(moment__default["default"](startedAt).format("YYYY-MM-DD HH:mm:ss")));
+            headerList.push("COMPLETED AT ".concat(moment__default["default"](completedAt).format("YYYY-MM-DD HH:mm:ss")));
+            headerList.push("TOTAL DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
+            headerList.push("TOTAL NATURAL DURATION ".concat(naturalDuration.humanize(MOMENT_ARG_THRESHOLDS)));
+            headerList.push("TOTAL COST $".concat(formatNumber(cost * (1 + taxRate))) +
+                (executionsWithKnownCost.length === executionReportJson.promptExecutions.length
+                    ? ''
+                    : " *(Some cost is unknown)*") +
+                (taxRate !== 0 ? " *(with tax ".concat(taxRate * 100, "%)*") : ''));
+            executionReportString += '\n\n' + headerList.map(function (header) { return "- ".concat(header); }).join('\n');
+            executionReportString +=
+                '\n\n' +
+                    '## 🗃 Index' +
+                    '\n\n' +
+                    executionReportJson.promptExecutions
+                        .map(function (promptExecution) {
+                        // TODO: Make some better system to convert hedings to links
+                        var hash = normalizeToKebabCase(promptExecution.prompt.title);
+                        if (/^\s*\p{Extended_Pictographic}/u.test(promptExecution.prompt.title)) {
+                            hash = '-' + hash;
+                        }
+                        // TODO: Make working hash link for the template in md + pdf
+                        return "- [".concat(promptExecution.prompt.title, "](#").concat(hash, ")");
+                    })
+                        .join('\n');
+            executionReportString +=
+                '\n\n' +
+                    '## ⌚ Time chart' +
+                    '\n\n' +
+                    createMarkdownChart({
+                        nameHeader: 'Template',
+                        valueHeader: 'Timeline',
+                        items: timingItems,
+                        width: chartsWidth,
+                        unitName: 'seconds',
+                    });
+            executionReportString +=
+                '\n\n' +
+                    '## 💸 Cost chart' +
+                    '\n\n' +
+                    createMarkdownChart({
+                        nameHeader: 'Template',
+                        valueHeader: 'Cost',
+                        items: costItems,
+                        width: chartsWidth,
+                        unitName: 'USD',
+                    });
+        }
+        else {
+            headerList.push("TOTAL COST $0 *(Nothing executed)*");
+        }
+        var _loop_1 = function (promptExecution) {
+            executionReportString += '\n\n\n\n' + "## ".concat(promptExecution.prompt.title);
+            var templateList = [];
+            // TODO: What if startedAt OR/AND completedAt is not defined?
+            var startedAt = moment__default["default"]((_c = (_b = promptExecution.result) === null || _b === void 0 ? void 0 : _b.timing) === null || _c === void 0 ? void 0 : _c.start);
+            var completedAt = moment__default["default"]((_e = (_d = promptExecution.result) === null || _d === void 0 ? void 0 : _d.timing) === null || _e === void 0 ? void 0 : _e.complete);
+            var duration = moment__default["default"].duration(completedAt.diff(startedAt));
+            // Not need here:
+            // > templateList.push(`STARTED AT ${moment(startedAt).calendar()}`);
+            templateList.push("DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
+            if (typeof ((_g = (_f = promptExecution.result) === null || _f === void 0 ? void 0 : _f.usage) === null || _g === void 0 ? void 0 : _g.price) === 'number') {
+                templateList.push("COST $".concat(formatNumber(promptExecution.result.usage.price * (1 + taxRate))) +
+                    (taxRate !== 0 ? " *(with tax ".concat(taxRate * 100, "%)*") : ''));
+            }
+            else {
+                templateList.push("COST UNKNOWN");
+            }
+            executionReportString += '\n\n' + templateList.map(function (header) { return "- ".concat(header); }).join('\n');
+            /*
+              -   MODEL VARIANT ${promptExecution.prompt.modelRequirements.modelVariant}
+                    -   MODEL NAME \`${promptExecution.result?.model}\` (requested \`${
+                        promptExecution.prompt.modelRequirements.modelName
+
+            */
+            if (just(true)) {
+                executionReportString +=
+                    '\n\n\n\n' +
+                        spacetrim.spaceTrim(function (block) { return "\n\n                        ### Prompt\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.prompt.content)), "\n                        ```\n\n                    "); });
+            }
+            if (promptExecution.result && promptExecution.result.content) {
+                executionReportString +=
+                    '\n\n\n\n' +
+                        spacetrim.spaceTrim(function (block) { return "\n\n                        ### Result\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.result.content)), "\n                        ```\n                    "); });
+            }
+            if (promptExecution.error && promptExecution.error.message) {
+                executionReportString +=
+                    '\n\n\n\n' +
+                        spacetrim.spaceTrim(function (block) { return "\n\n                        ### Error\n\n                        ```\n                        ".concat(block(escapeMarkdownBlock(promptExecution.error.message)), "\n                        ```\n\n                    "); });
+            }
+        };
+        try {
+            for (var _j = __values(executionReportJson.promptExecutions), _k = _j.next(); !_k.done; _k = _j.next()) {
+                var promptExecution = _k.value;
+                _loop_1(promptExecution);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        executionReportString = prettifyMarkdown(executionReportString);
+        return executionReportString;
+    }
+    /**
+     * TODO: Add mermaid chart for every report
+     * TODO: [🧠] Allow to filter out some parts of the report by options
+     */
+
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
      */
@@ -2340,13 +2414,13 @@
      *
      */
     function trimCodeBlock(value) {
-        value = spaceTrim__default["default"](value);
+        value = spacetrim.spaceTrim(value);
         if (!/^```[a-z]*(.*)```$/is.test(value)) {
             return value;
         }
         value = value.replace(/^```[a-z]*/i, '');
         value = value.replace(/```$/i, '');
-        value = spaceTrim__default["default"](value);
+        value = spacetrim.spaceTrim(value);
         return value;
     }
 
@@ -2357,9 +2431,9 @@
      *       if you want to start code block in the prompt but you don't want to end it in the result.
      */
     function trimEndOfCodeBlock(value) {
-        value = spaceTrim__default["default"](value);
+        value = spacetrim.spaceTrim(value);
         value = value.replace(/```$/g, '');
-        value = spaceTrim__default["default"](value);
+        value = spacetrim.spaceTrim(value);
         return value;
     }
 
@@ -2380,7 +2454,7 @@
         var trimmedText = text;
         // Remove leading and trailing spaces and newlines
         if (isTrimmed) {
-            trimmedText = spaceTrim__default["default"](trimmedText);
+            trimmedText = spacetrim.spaceTrim(trimmedText);
         }
         var processedText = trimmedText;
         if (isIntroduceSentenceRemoved) {
@@ -2389,7 +2463,7 @@
                 // Remove the introduce sentence and quotes by replacing it with an empty string
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
-            processedText = spaceTrim__default["default"](processedText);
+            processedText = spacetrim.spaceTrim(processedText);
         }
         if (processedText.length < 3) {
             return trimmedText;
@@ -2436,14 +2510,17 @@
 
     // And the normalization (originally n12 library) utilities:
     var normalizeTo = {
+        // [🕙] lowercase: normalizeTo_lowercase,
+        // [🕙] UPPERCASE: normalizeTo_UPPERCASE,
         camelCase: normalizeTo_camelCase,
         PascalCase: normalizeTo_PascalCase,
-        'SCREAMING-CASE': normalizeTo_SCREAMING_CASE,
+        SCREAMING_CASE: normalizeTo_SCREAMING_CASE,
         snake_case: normalizeTo_snake_case,
         'kebab-case': normalizeToKebabCase,
     };
     /**
      * TODO: [🧠] Maybe create some indipendent package like `markdown-tools` from both here exported and @private utilities
+     * Note: [🕙] It does not make sence to have simple lower / UPPER case normalization
      */
 
     exports.CountUtils = CountUtils;
@@ -2451,6 +2528,7 @@
     exports.ExecutionReportStringOptionsDefaults = ExecutionReportStringOptionsDefaults;
     exports.assertsExecutionSuccessful = assertsExecutionSuccessful;
     exports.capitalize = capitalize;
+    exports.checkExpectations = checkExpectations;
     exports.countCharacters = countCharacters;
     exports.countLines = countLines;
     exports.countPages = countPages;
@@ -2463,6 +2541,7 @@
     exports.extractAllListItemsFromMarkdown = extractAllListItemsFromMarkdown;
     exports.extractBlock = extractBlock;
     exports.extractOneBlockFromMarkdown = extractOneBlockFromMarkdown;
+    exports.isPassingExpectations = isPassingExpectations;
     exports.isValidJsonString = isValidJsonString;
     exports.isValidKeyword = isValidKeyword;
     exports.nameToUriPart = nameToUriPart;