@promptbook/node 0.59.0-2 → 0.59.0-21

package/umd/index.umd.js

@@ -142,49 +142,66 @@
         return PromptbookSyntaxError;
     }(Error));
 
-    // import prepareKnowledgeFromMarkdownStringPromptbook from './prepare-knowledge-from-markdown.ptbk.md';
-    function prepareKnowledgeFromMarkdown(options) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, []];
-            });
-        });
-    }
+    var promptbookLibrary = [{title:"Prepare Knowledge from Markdown",promptbookUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.59.0-20",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",resultingParameterName:"knowledge"}],knowledge:[]}];
 
     /**
-     * Supported script languages
+     * This error indicates errors during the execution of the promptbook
      */
-    var SUPPORTED_SCRIPT_LANGUAGES = ['javascript', 'typescript', 'python'];
+    var PromptbookExecutionError = /** @class */ (function (_super) {
+        __extends(PromptbookExecutionError, _super);
+        function PromptbookExecutionError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PromptbookExecutionError';
+            Object.setPrototypeOf(_this, PromptbookExecutionError.prototype);
+            return _this;
+        }
+        return PromptbookExecutionError;
+    }(Error));
 
     /**
-     * Computes the deepness of the markdown structure.
+     * Asserts that the execution of a promptnook is successful
      *
-     * @private within the library
+     * @param executionResult - The partial result of the promptnook execution
+     * @throws {PromptbookExecutionError} If the execution is not successful or if multiple errors occurred
      */
-    function countMarkdownStructureDeepness(markdownStructure) {
-        var e_1, _a;
-        var maxDeepness = 0;
-        try {
-            for (var _b = __values(markdownStructure.sections), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var section = _c.value;
-                maxDeepness = Math.max(maxDeepness, countMarkdownStructureDeepness(section));
-            }
+    function assertsExecutionSuccessful(executionResult) {
+        var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
+        if (isSuccessful === true) {
+            return;
         }
-        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; }
+        if (errors.length === 0) {
+            throw new PromptbookExecutionError("Promptnook Execution failed because of unknown reason");
+        }
+        else if (errors.length === 1) {
+            throw errors[0];
+        }
+        else {
+            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                "); }));
         }
-        return maxDeepness + 1;
     }
+    /**
+     * TODO: [🧠] Can this return type be better typed than void
+     */
 
     /**
      * The maximum number of iterations for a loops
      */
     var LOOP_LIMIT = 1000;
 
+    /**
+     * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+     */
+    var PromptbookLogicError = /** @class */ (function (_super) {
+        __extends(PromptbookLogicError, _super);
+        function PromptbookLogicError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PromptbookLogicError';
+            Object.setPrototypeOf(_this, PromptbookLogicError.prototype);
+            return _this;
+        }
+        return PromptbookLogicError;
+    }(Error));
+
     /**
      * This error type indicates that the error should not happen and its last check before crashing with some other error
      */
@@ -200,804 +217,400 @@
     }(Error));
 
     /**
-     * Parse a markdown string into a MarkdownStructure object.
-     *
-     * Note: This function does work with code blocks
-     * Note: This function does not work with markdown comments
-     *
-     * @param markdown The markdown string to parse.
-     * @returns The MarkdownStructure object.
+     * Tests if given string is valid URL.
      *
-     * @private within the library
+     * Note: Dataurl are considered perfectly valid.
      */
-    function markdownToMarkdownStructure(markdown) {
-        var e_1, _a;
-        var lines = markdown.split('\n');
-        var root = { level: 0, title: '', contentLines: [], sections: [], parent: null };
-        var current = root;
-        var isInsideCodeBlock = false;
+    function isValidUrl(url) {
+        if (typeof url !== 'string') {
+            return false;
+        }
         try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                var headingMatch = line.match(/^(?<mark>#{1,6})\s(?<title>.*)/);
-                if (isInsideCodeBlock || !headingMatch) {
-                    if (line.startsWith('```')) {
-                        isInsideCodeBlock = !isInsideCodeBlock;
-                    }
-                    current.contentLines.push(line);
-                }
-                else {
-                    var level = headingMatch.groups.mark.length;
-                    var title = headingMatch.groups.title.trim();
-                    var parent_1 = void 0;
-                    if (level > current.level) {
-                        // Note: Going deeper (next section is child of current)
-                        parent_1 = current;
-                    }
-                    else {
-                        // Note: Going up or staying at the same level (next section is sibling or parent or grandparent,... of current)
-                        parent_1 = current;
-                        var loopLimit = LOOP_LIMIT;
-                        while (parent_1.level !== level - 1) {
-                            if (loopLimit-- < 0) {
-                                throw new UnexpectedError('Loop limit reached during parsing of markdown structure in `markdownToMarkdownStructure`');
-                            }
-                            if (parent_1.parent === null /* <- Note: We are in root */) {
-                                // [🌻]
-                                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;
-                        }
-                    }
-                    var section = { level: level, title: title, contentLines: [], sections: [], parent: parent_1 };
-                    parent_1.sections.push(section);
-                    current = section;
-                }
+            if (url.startsWith('blob:')) {
+                url = url.replace(/^blob:/, '');
             }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            var urlObject = new URL(url);
+            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+                return false;
             }
-            finally { if (e_1) throw e_1.error; }
+            return true;
         }
-        if (root.sections.length === 1) {
-            var markdownStructure = parsingMarkdownStructureToMarkdownStructure(root.sections[0]);
-            return markdownStructure;
+        catch (error) {
+            return false;
         }
-        // [🌻]
-        throw new Error('The markdown file must have exactly one top-level section.');
-        // return root;
-    }
-    /**
-     * @private
-     */
-    function parsingMarkdownStructureToMarkdownStructure(parsingMarkdownStructure) {
-        var level = parsingMarkdownStructure.level, title = parsingMarkdownStructure.title, contentLines = parsingMarkdownStructure.contentLines, sections = parsingMarkdownStructure.sections;
-        return {
-            level: level,
-            title: title,
-            content: spaceTrim.spaceTrim(contentLines.join('\n')),
-            sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
-        };
     }
 
     /**
-     * Utility function to extract all list items from markdown
+     * Validates PromptbookJson if it is logically valid
      *
-     * Note: It works with both ul and ol
-     * Note: It omits list items in code blocks
-     * Note: It flattens nested lists
-     * Note: It can not work with html syntax and comments
+     * It checks:
+     * -   if it has correct parameters dependency
      *
-     * @param markdown any valid markdown
-     * @returns
+     * It does NOT check:
+     * -   if it is valid json
+     * -   if it is meaningful
+     *
+     * @param promptbook valid or invalid PromptbookJson
+     * @returns the same promptbook if it is logically valid
+     * @throws {PromptbookLogicError} on logical error in the promptbook
      */
-    function extractAllListItemsFromMarkdown(markdown) {
-        var e_1, _a;
-        var lines = markdown.split('\n');
-        var listItems = [];
-        var isInCodeBlock = false;
+    function validatePromptbookJson(promptbook) {
+        // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
+        var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
+        if (promptbook.promptbookUrl !== undefined) {
+            if (!isValidUrl(promptbook.promptbookUrl)) {
+                // TODO: This should be maybe the syntax error detected during parsing
+                throw new PromptbookLogicError("Invalid promptbook URL \"".concat(promptbook.promptbookUrl, "\""));
+            }
+        }
+        // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+        if (!Array.isArray(promptbook.parameters)) {
+            // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Promptbook is valid JSON but with wrong structure\n\n                promptbook.parameters expected to be an array, but got ".concat(typeof promptbook.parameters, "\n            ")));
+        }
+        // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+        if (!Array.isArray(promptbook.promptTemplates)) {
+            // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n              Promptbook is valid JSON but with wrong structure\n\n              promptbook.promptTemplates expected to be an array, but got ".concat(typeof promptbook.promptTemplates, "\n          ")));
+        }
+        var _loop_1 = function (parameter) {
+            if (parameter.isInput && parameter.isOutput) {
+                throw new PromptbookLogicError("Parameter {".concat(parameter.name, "} can not be both input and output"));
+            }
+            // Note: Testing that parameter is either intermediate or output BUT not created and unused
+            if (!parameter.isInput &&
+                !parameter.isOutput &&
+                !promptbook.promptTemplates.some(function (template) { return template.dependentParameterNames.includes(parameter.name); })) {
+                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is created but not used\n\n                    You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                    - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                ")));
+            }
+            // Note: Testing that parameter is either input or result of some template
+            if (!parameter.isInput &&
+                !promptbook.promptTemplates.some(function (template) { return template.resultingParameterName === parameter.name; })) {
+                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is declared but not defined\n\n                    You can do one of these:\n                    - Remove declaration of {").concat(parameter.name, "}\n                    - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                ")));
+            }
+        };
         try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                var trimmedLine = line.trim();
-                if (trimmedLine.startsWith('```')) {
-                    isInCodeBlock = !isInCodeBlock;
-                }
-                if (!isInCodeBlock && (trimmedLine.startsWith('-') || trimmedLine.match(/^\d+\./))) {
-                    var listItem = trimmedLine.replace(/^-|\d+\./, '').trim();
-                    listItems.push(listItem);
-                }
+            // Note: Check each parameter individually
+            for (var _e = __values(promptbook.parameters), _f = _e.next(); !_f.done; _f = _e.next()) {
+                var parameter = _f.value;
+                _loop_1(parameter);
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+                if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
             }
             finally { if (e_1) throw e_1.error; }
         }
-        return listItems;
-    }
-
-    /**
-     * Makes first letter of a string uppercase
-     *
-     */
-    function capitalize(word) {
-        return word.substring(0, 1).toUpperCase() + word.substring(1);
-    }
-
-    /**
-     * Extracts all code blocks from markdown.
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
-     *
-     * @param markdown any valid markdown
-     * @returns code blocks with language and content
-     *
-     */
-    function extractAllBlocksFromMarkdown(markdown) {
-        var e_1, _a;
-        var codeBlocks = [];
-        var lines = markdown.split('\n');
-        var currentCodeBlock = null;
+        // Note: Check each template individually
+        var definedParameters = new Set(promptbook.parameters.filter(function (_a) {
+            var isInput = _a.isInput;
+            return isInput;
+        }).map(function (_a) {
+            var name = _a.name;
+            return name;
+        }));
         try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                if (line.startsWith('```')) {
-                    var language = line.slice(3).trim() || null;
-                    if (currentCodeBlock === null) {
-                        currentCodeBlock = { language: language, content: '' };
-                    }
-                    else {
-                        if (language !== null) {
-                            // [🌻]
-                            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+            for (var _g = __values(promptbook.promptTemplates), _h = _g.next(); !_h.done; _h = _g.next()) {
+                var template = _h.value;
+                if (definedParameters.has(template.resultingParameterName)) {
+                    throw new PromptbookLogicError("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
+                }
+                definedParameters.add(template.resultingParameterName);
+                if (template.executionType === 'PROMPT_TEMPLATE' &&
+                    (template.modelRequirements.modelVariant === undefined)) {
+                    throw new PromptbookLogicError(spaceTrim.spaceTrim("\n\n                  You must specify MODEL VARIANT in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
+                }
+                if (template.jokers && template.jokers.length > 0) {
+                    if (!template.expectFormat &&
+                        !template.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
+                        throw new PromptbookLogicError("Joker parameters are used for {".concat(template.resultingParameterName, "} but no expectations are defined"));
+                    }
+                    try {
+                        for (var _j = (e_3 = void 0, __values(template.jokers)), _k = _j.next(); !_k.done; _k = _j.next()) {
+                            var joker = _k.value;
+                            if (!template.dependentParameterNames.includes(joker)) {
+                                throw new PromptbookLogicError("Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in dependentParameterNames"));
+                            }
                         }
-                        codeBlocks.push(currentCodeBlock);
-                        currentCodeBlock = null;
+                    }
+                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    finally {
+                        try {
+                            if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
+                        }
+                        finally { if (e_3) throw e_3.error; }
                     }
                 }
-                else if (currentCodeBlock !== null) {
-                    if (currentCodeBlock.content !== '') {
-                        currentCodeBlock.content += '\n';
+                if (template.expectations) {
+                    try {
+                        for (var _l = (e_4 = void 0, __values(Object.entries(template.expectations))), _m = _l.next(); !_m.done; _m = _l.next()) {
+                            var _o = __read(_m.value, 2), unit = _o[0], _p = _o[1], min = _p.min, max = _p.max;
+                            if (min !== undefined && max !== undefined && min > max) {
+                                throw new PromptbookLogicError("Min expectation (=".concat(min, ") of ").concat(unit, " is higher than max expectation (=").concat(max, ")"));
+                            }
+                            if (min !== undefined && min < 0) {
+                                throw new PromptbookLogicError("Min expectation of ".concat(unit, " must be zero or positive"));
+                            }
+                            if (max !== undefined && max <= 0) {
+                                throw new PromptbookLogicError("Max expectation of ".concat(unit, " must be positive"));
+                            }
+                        }
+                    }
+                    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                    finally {
+                        try {
+                            if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+                        }
+                        finally { if (e_4) throw e_4.error; }
                     }
-                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
                 }
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+                if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_2) throw e_2.error; }
         }
-        if (currentCodeBlock !== null) {
-            // [🌻]
-            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
+        // Note: Detect circular dependencies
+        var resovedParameters = promptbook.parameters
+            .filter(function (_a) {
+            var isInput = _a.isInput;
+            return isInput;
+        })
+            .map(function (_a) {
+            var name = _a.name;
+            return name;
+        });
+        var unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
+        var loopLimit = LOOP_LIMIT;
+        var _loop_2 = function () {
+            if (loopLimit-- < 0) {
+                throw new UnexpectedError('Loop limit reached during detection of circular dependencies in `validatePromptbookJson`');
+            }
+            var currentlyResovedTemplates = unresovedTemplates.filter(function (template) {
+                return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
+            });
+            if (currentlyResovedTemplates.length === 0) {
+                throw new PromptbookLogicError(spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters\n                        It may be circular dependencies\n\n                        Can not resolve:\n                        ".concat(block(unresovedTemplates
+                    .map(function (_a) {
+                    var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
+                    return "- {".concat(resultingParameterName, "} depends on ").concat(dependentParameterNames
+                        .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
+                        .join(', '));
+                })
+                    .join('\n')), "\n\n                        Resolved:\n                        ").concat(block(resovedParameters.map(function (name) { return "- {".concat(name, "}"); }).join('\n')), "\n                    "); }));
+            }
+            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTemplates.map(function (_a) {
+                var resultingParameterName = _a.resultingParameterName;
+                return resultingParameterName;
+            })), false);
+            unresovedTemplates = unresovedTemplates.filter(function (template) { return !currentlyResovedTemplates.includes(template); });
+        };
+        while (unresovedTemplates.length > 0) {
+            _loop_2();
         }
-        return codeBlocks;
+        return promptbook;
     }
+    /**
+     * TODO: [🧠] Work with promptbookVersion
+     * TODO: Use here some json-schema, Zod or something similar and change it to:
+     *     > /**
+     *     >  * Validates PromptbookJson if it is logically valid.
+     *     >  *
+     *     >  * It checks:
+     *     >  * -   it has a valid structure
+     *     >  * -   ...
+     *     >  ex port function validatePromptbookJson(promptbook: unknown): asserts promptbook is PromptbookJson {
+     */
 
     /**
-     * Extracts exactly ONE code block from markdown.
-     *
-     * Note: If there are multiple or no code blocks the function throws an error
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     * This error occurs when some expectation is not met in the execution of the pipeline
      *
-     * @param markdown any valid markdown
-     * @returns code block with language and content
+     * @private Always catched and rethrown as `PromptbookExecutionError`
+     * Note: This is a kindof subtype of PromptbookExecutionError
      */
-    function extractOneBlockFromMarkdown(markdown) {
-        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
-        if (codeBlocks.length !== 1) {
-            // TODO: Report more specific place where the error happened
-            throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
+    var ExpectError = /** @class */ (function (_super) {
+        __extends(ExpectError, _super);
+        function ExpectError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'ExpectError';
+            Object.setPrototypeOf(_this, ExpectError.prototype);
+            return _this;
         }
-        return codeBlocks[0];
-    }
-    /***
-     * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
-     */
+        return ExpectError;
+    }(Error));
 
     /**
-     * Removes HTML or Markdown comments from a string.
-     *
-     * @param {string} content - The string to remove comments from.
-     * @returns {string} The input string with all comments removed.
+     * Function isValidJsonString will tell you if the string is valid JSON or not
      */
-    function removeContentComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+    function isValidJsonString(value /* <-[👨‍⚖️] */) {
+        try {
+            JSON.parse(value);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (error.message.includes('Unexpected token')) {
+                return false;
+            }
+            return false;
+        }
     }
 
     /**
-     * Creates a new set with all elements that are present in either set
+     * The version of the Promptbook library
      */
-    function union() {
-        var e_1, _a, e_2, _b;
-        var sets = [];
+    var PROMPTBOOK_VERSION = '0.59.0-20';
+
+    /**
+     * Function `addUsage` will add multiple usages into one
+     *
+     * Note: If you provide 0 values, it returns void usage
+     */
+    function addUsage() {
+        var usageItems = [];
         for (var _i = 0; _i < arguments.length; _i++) {
-            sets[_i] = arguments[_i];
-        }
-        var union = new Set();
-        try {
-            for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
-                var set = sets_1_1.value;
-                try {
-                    for (var _c = (e_2 = void 0, __values(Array.from(set))), _d = _c.next(); !_d.done; _d = _c.next()) {
-                        var item = _d.value;
-                        union.add(item);
+            usageItems[_i] = arguments[_i];
+        }
+        var initialStructure = {
+            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 },
+            },
+        };
+        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_2_1) { e_2 = { error: e_2_1 }; }
-                finally {
-                    try {
-                        if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
-                    }
-                    finally { if (e_2) throw e_2.error; }
+            }
+            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; }
             }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
             try {
-                if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
+                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;
+                        }
+                    }
+                }
             }
-            finally { if (e_1) throw e_1.error; }
-        }
-        return union;
+            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;
+        }, initialStructure);
     }
 
     /**
-     * The version of the Promptbook library
+     * Counts number of characters in the text
      */
-    var PROMPTBOOK_VERSION = '0.59.0-1';
+    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;
+    }
 
     /**
-     * Parses the template and returns the list of all parameter names
-     *
-     * @param template the template with parameters in {curly} braces
-     * @returns the list of parameter names
+     * Counts number of lines in the text
      */
-    function extractParameters(template) {
-        var e_1, _a;
-        var matches = template.matchAll(/{\w+}/g);
-        var parameterNames = new Set();
-        try {
-            for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
-                var match = matches_1_1.value;
-                var parameterName = match[0].slice(1, -1);
-                parameterNames.add(parameterName);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
-            }
-            finally { if (e_1) throw e_1.error; }
+    function countLines(text) {
+        if (text === '') {
+            return 0;
         }
-        return parameterNames;
+        return text.split('\n').length;
     }
 
     /**
-     * Parses the given script and returns the list of all used variables that are not defined in the script
-     *
-     * @param script from which to extract the variables
-     * @returns the list of variable names
-     * @throws {PromptbookSyntaxError} if the script is invalid
+     * Counts number of pages in the text
      */
-    function extractVariables(script) {
-        var variables = new Set();
-        script = "(()=>{".concat(script, "})()");
-        try {
-            for (var i = 0; i < 100 /* <- TODO: This limit to configuration */; i++)
-                try {
-                    eval(script);
-                }
-                catch (error) {
-                    if (!(error instanceof ReferenceError)) {
-                        throw error;
-                    }
-                    var undefinedName = error.message.split(' ')[0];
-                    /*
-                    Note: Remapping error
-                          From: [ReferenceError: thing is not defined],
-                          To:   [Error: Parameter {thing} is not defined],
-                    */
-                    if (!undefinedName) {
-                        throw error;
-                    }
-                    if (script.includes(undefinedName + '(')) {
-                        script = "const ".concat(undefinedName, " = ()=>'';") + script;
-                    }
-                    else {
-                        variables.add(undefinedName);
-                        script = "const ".concat(undefinedName, " = '';") + script;
-                    }
-                }
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            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;
+    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;
     }
-    /**
-     * TODO: [🔣] Support for multiple languages - python, java,...
-     */
 
     /**
-     * Parses the prompt template and returns the set of all used parameters
-     *
-     * @param promptTemplate the template with used parameters
-     * @returns the set of parameter names
-     * @throws {PromptbookSyntaxError} if the script is invalid
-     */
-    function extractParametersFromPromptTemplate(promptTemplate) {
-        var e_1, _a, e_2, _b;
-        var parameterNames = new Set();
-        try {
-            for (var _c = __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(promptTemplate.title)), false), __read(extractParameters(promptTemplate.description || '')), false), __read(extractParameters(promptTemplate.content)), false)), _d = _c.next(); !_d.done; _d = _c.next()) {
-                var parameterName = _d.value;
-                parameterNames.add(parameterName);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        if (promptTemplate.executionType === 'SCRIPT') {
-            try {
-                for (var _e = __values(extractVariables(promptTemplate.content)), _f = _e.next(); !_f.done; _f = _e.next()) {
-                    var parameterName = _f.value;
-                    parameterNames.add(parameterName);
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-        }
-        return parameterNames;
-    }
-    /**
-     * TODO: [🔣] If script require contentLanguage
+     * Counts number of paragraphs in the text
      */
-
-    /* tslint:disable */
-    /*
-    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');
-    */
-    function normalizeTo_SCREAMING_CASE(sentence) {
-        var e_1, _a;
-        var charType;
-        var lastCharType = 'OTHER';
-        var normalizedName = '';
-        try {
-            for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
-                var char = sentence_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 (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_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;
+    function countParagraphs(text) {
+        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
     }
-    /**
-     * TODO: [🌺] Use some intermediate util splitWords
-     */
-
-    /**
-     * Execution type describes the way how the block is executed
-     *
-     * @see https://github.com/webgptorg/promptbook#execution-type
-     */
-    var ExecutionTypes = [
-        'PROMPT_TEMPLATE',
-        'SIMPLE_TEMPLATE',
-        'SCRIPT',
-        'PROMPT_DIALOG',
-        // <- [🥻] Insert here when making new command
-    ];
-
-    /**
-     * Units of text measurement
-     */
-    var EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
-    /**
-     * TODO: [💝] Unite object for expecting amount and format - remove expectFormat
-     * TODO: use one helper type> (string_prompt | string_javascript | string_markdown) & string_template
-     * TODO: [👙][🧠] Just selecting gpt3 or gpt4 level of model
-     */
 
     /**
-     * Removes Markdown formatting tags from a string.
-     *
-     * @param {string} str - The string to remove Markdown tags from.
-     * @returns {string} The input string with all Markdown tags removed.
+     * Split text into sentences
      */
-    function removeMarkdownFormatting(str) {
-        // Remove bold formatting
-        str = str.replace(/\*\*(.*?)\*\*/g, '$1');
-        // Remove italic formatting
-        str = str.replace(/\*(.*?)\*/g, '$1');
-        // Remove code formatting
-        str = str.replace(/`(.*?)`/g, '$1');
-        return str;
+    function splitIntoSentences(text) {
+        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
     }
-
     /**
-     * Function parseNumber will parse number from string
-     *
-     * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
-     * Note: it also works only with decimal numbers
-     *
-     * @returns parsed number
-     * @throws {PromptbookSyntaxError} if the value is not a number
-     *
-     * @private within the parseCommand
+     * Counts number of sentences in the text
      */
-    function parseNumber(value) {
-        var originalValue = value;
-        if (typeof value === 'number') {
-            value = value.toString(); // <- TODO: Maybe more efficient way to do this
-        }
-        if (typeof value !== 'string') {
-            return 0;
-        }
-        value = value.trim();
-        if (value.startsWith('+')) {
-            return parseNumber(value.substring(1));
-        }
-        if (value.startsWith('-')) {
-            var number = parseNumber(value.substring(1));
-            if (number === 0) {
-                return 0; // <- Note: To prevent -0
-            }
-            return -number;
-        }
-        value = value.replace(/,/g, '.');
-        value = value.toUpperCase();
-        if (value === '') {
-            return 0;
-        }
-        if (value === '♾' || value.startsWith('INF')) {
-            return Infinity;
-        }
-        if (value.includes('/')) {
-            var _a = __read(value.split('/'), 2), numerator_ = _a[0], denominator_ = _a[1];
-            var numerator = parseNumber(numerator_);
-            var denominator = parseNumber(denominator_);
-            if (denominator === 0) {
-                throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\" because denominator is zero"));
-            }
-            return numerator / denominator;
-        }
-        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
-            return 0;
-        }
-        if (value.includes('E')) {
-            var _b = __read(value.split('E'), 2), significand = _b[0], exponent = _b[1];
-            return parseNumber(significand) * Math.pow(10, parseNumber(exponent));
-        }
-        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
-            throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\""));
-        }
-        var num = parseFloat(value);
-        if (isNaN(num)) {
-            throw new PromptbookSyntaxError("Unexpected NaN when parsing number from \"".concat(originalValue, "\""));
-        }
-        return num;
-    }
-    /**
-     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
-     */
-
-    /**
-     * Parses one line of ul/ol to command
-     *
-     * @returns parsed command object
-     * @throws {PromptbookSyntaxError} if the command is invalid
-     *
-     * @private within the promptbookStringToJson
-     */
-    function parseCommand(listItem) {
-        var e_1, _a;
-        if (listItem.includes('\n') || listItem.includes('\r')) {
-            throw new PromptbookSyntaxError('Command can not contain new line characters:');
-        }
-        var type = listItem.trim();
-        type = type.split('`').join('');
-        type = type.split('"').join('');
-        type = type.split("'").join('');
-        type = type.split('~').join('');
-        type = type.split('[').join('');
-        type = type.split(']').join('');
-        type = type.split('(').join('');
-        type = type.split(')').join('');
-        type = normalizeTo_SCREAMING_CASE(type);
-        type = type.split('DIALOGUE').join('DIALOG');
-        var listItemParts = listItem
-            .split(' ')
-            .map(function (part) { return part.trim(); })
-            .filter(function (item) { return item !== ''; })
-            .filter(function (item) { return !/^PTBK$/i.test(item); })
-            .filter(function (item) { return !/^PROMPTBOOK$/i.test(item); })
-            .map(removeMarkdownFormatting);
-        if (type.startsWith('URL') ||
-            type.startsWith('PTBK_URL') ||
-            type.startsWith('PTBKURL') ||
-            type.startsWith('PROMPTBOOK_URL') ||
-            type.startsWith('PROMPTBOOKURL') ||
-            type.startsWith('HTTPS')) {
-            if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
-                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.spaceTrim("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
-            }
-            if (promptbookUrl.hash !== '') {
-                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',
-                promptbookUrl: promptbookUrl,
-            };
-        }
-        else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
-            if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
-            }
-            var promptbookVersion = listItemParts.pop();
-            // TODO: Validate version
-            return {
-                type: 'PROMPTBOOK_VERSION',
-                promptbookVersion: promptbookVersion,
-            };
-        }
-        else if (type.startsWith('EXECUTE') ||
-            type.startsWith('EXEC') ||
-            type.startsWith('PROMPT_DIALOG') ||
-            type.startsWith('SIMPLE_TEMPLATE')) {
-            var executionTypes = ExecutionTypes.filter(function (executionType) { return type.includes(executionType); });
-            if (executionTypes.length !== 1) {
-                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',
-                executionType: executionTypes[0],
-            };
-        }
-        else if (type.startsWith('MODEL')) {
-            // TODO: Make this more elegant and dynamically
-            if (type.startsWith('MODEL_VARIANT')) {
-                if (type === 'MODEL_VARIANT_CHAT') {
-                    return {
-                        type: 'MODEL',
-                        key: 'modelVariant',
-                        value: 'CHAT',
-                    };
-                }
-                else if (type === 'MODEL_VARIANT_COMPLETION') {
-                    return {
-                        type: 'MODEL',
-                        key: 'modelVariant',
-                        value: 'COMPLETION',
-                    };
-                }
-                else {
-                    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')) {
-                return {
-                    type: 'MODEL',
-                    key: 'modelName',
-                    value: listItemParts.pop(),
-                };
-            }
-            else {
-                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') ||
-            type.startsWith('INPUT_PARAM') ||
-            type.startsWith('OUTPUT_PARAM') ||
-            listItem.startsWith('{') ||
-            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.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.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');
-            if (listItem.startsWith('> {')) {
-                isInput = false;
-                isOutput = false;
-            }
-            return {
-                type: 'PARAMETER',
-                parameterName: parameterName,
-                parameterDescription: parameterDescription.trim() || null,
-                isInput: isInput,
-                isOutput: isOutput,
-            };
-        }
-        else if (type.startsWith('JOKER')) {
-            if (listItemParts.length !== 2) {
-                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.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;
-            return {
-                type: 'JOKER',
-                parameterName: parameterName,
-            };
-        }
-        else if (type.startsWith('POSTPROCESS') || type.startsWith('POST_PROCESS')) {
-            if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
-            }
-            var functionName = listItemParts.pop();
-            return {
-                type: 'POSTPROCESS',
-                functionName: functionName,
-            };
-        }
-        else if (type.startsWith('EXPECT_JSON')) {
-            return {
-                type: 'EXPECT_FORMAT',
-                format: 'JSON',
-            };
-            // [🥤]
-        }
-        else if (type.startsWith('EXPECT')) {
-            try {
-                listItemParts.shift();
-                var sign = void 0;
-                var signRaw = listItemParts.shift();
-                if (/^exact/i.test(signRaw)) {
-                    sign = 'EXACTLY';
-                }
-                else if (/^min/i.test(signRaw)) {
-                    sign = 'MINIMUM';
-                }
-                else if (/^max/i.test(signRaw)) {
-                    sign = 'MAXIMUM';
-                }
-                else {
-                    throw new PromptbookSyntaxError("Invalid sign \"".concat(signRaw, "\", expected EXACTLY, MIN or MAX"));
-                }
-                var amountRaw = listItemParts.shift();
-                var amount = parseNumber(amountRaw);
-                if (amount < 0) {
-                    throw new PromptbookSyntaxError('Amount must be positive number or zero');
-                }
-                if (amount !== Math.floor(amount)) {
-                    throw new PromptbookSyntaxError('Amount must be whole number');
-                }
-                var unitRaw = listItemParts.shift();
-                var unit = undefined;
-                try {
-                    for (var EXPECTATION_UNITS_1 = __values(EXPECTATION_UNITS), EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next(); !EXPECTATION_UNITS_1_1.done; EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next()) {
-                        var existingUnit = EXPECTATION_UNITS_1_1.value;
-                        var existingUnitText = existingUnit;
-                        existingUnitText = existingUnitText.substring(0, existingUnitText.length - 1);
-                        if (existingUnitText === 'CHARACTER') {
-                            existingUnitText = 'CHAR';
-                        }
-                        if (new RegExp("^".concat(existingUnitText.toLowerCase())).test(unitRaw.toLowerCase()) ||
-                            new RegExp("^".concat(unitRaw.toLowerCase())).test(existingUnitText.toLowerCase())) {
-                            if (unit !== undefined) {
-                                throw new PromptbookSyntaxError("Ambiguous unit \"".concat(unitRaw, "\""));
-                            }
-                            unit = existingUnit;
-                        }
-                    }
-                }
-                catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                finally {
-                    try {
-                        if (EXPECTATION_UNITS_1_1 && !EXPECTATION_UNITS_1_1.done && (_a = EXPECTATION_UNITS_1.return)) _a.call(EXPECTATION_UNITS_1);
-                    }
-                    finally { if (e_1) throw e_1.error; }
-                }
-                if (unit === undefined) {
-                    throw new PromptbookSyntaxError("Invalid unit \"".concat(unitRaw, "\""));
-                }
-                return {
-                    type: 'EXPECT_AMOUNT',
-                    sign: sign,
-                    unit: unit,
-                    amount: amount,
-                };
-            }
-            catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
-            }
-            /*
-        } else if (type.startsWith('__________________')) {
-            // <- [🥻] Insert here when making new command
-        */
-        }
-        else {
-            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                ")));
-        }
+    function countSentences(text) {
+        return splitIntoSentences(text).length;
     }
 
     var defaultDiacriticsRemovalMap = [
@@ -1252,674 +865,744 @@
         });
     }
 
-    /* tslint:disable */
-    function normalizeToKebabCase(sentence) {
+    /**
+     * Counts number of words in the text
+     */
+    function countWords(text) {
+        text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
+        text = removeDiacritics(text);
+        return text.split(/[^a-zа-я0-9]+/i).filter(function (word) { return word.length > 0; }).length;
+    }
+
+    /**
+     * Index of all counter functions
+     */
+    var CountUtils = {
+        CHARACTERS: countCharacters,
+        WORDS: countWords,
+        SENTENCES: countSentences,
+        PARAGRAPHS: countParagraphs,
+        LINES: countLines,
+        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;
-        sentence = removeDiacritics(sentence);
-        var charType;
-        var lastCharType = 'OTHER';
-        var normalizedName = '';
         try {
-            for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
-                var char = sentence_1_1.value;
-                var normalizedChar = void 0;
-                if (/^[a-z]$/.test(char)) {
-                    charType = 'LOWERCASE';
-                    normalizedChar = char;
-                }
-                else if (/^[A-Z]$/.test(char)) {
-                    charType = 'UPPERCASE';
-                    normalizedChar = char.toLowerCase();
-                }
-                else if (/^[0-9]$/.test(char)) {
-                    charType = 'NUMBER';
-                    normalizedChar = char;
-                }
-                else if (/^\/$/.test(char)) {
-                    charType = 'SLASH';
-                    normalizedChar = char;
-                }
-                else {
-                    charType = 'OTHER';
-                    normalizedChar = '-';
+            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));
                 }
-                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 (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_1);
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
             }
             finally { if (e_1) throw e_1.error; }
         }
-        normalizedName = normalizedName.split(/-+/g).join('-');
-        normalizedName = normalizedName.split(/-?\/-?/g).join('/');
-        normalizedName = normalizedName.replace(/^-/, '');
-        normalizedName = normalizedName.replace(/-$/, '');
-        return normalizedName;
     }
+    /**
+     * TODO: [💝] Unite object for expecting amount and format
+     */
 
     /**
-     * Removes emojis from a string and fix whitespaces
+     * This error occurs during the parameter replacement in the template
      *
-     * @param text with emojis
-     * @returns text without emojis
+     * Note: This is a kindof subtype of PromptbookExecutionError because it occurs during the execution of the pipeline
      */
-    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;
-    }
+    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));
 
     /**
-     * Function normalizes title to name which can be used as identifier
+     * 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 titleToName(value) {
-        value = removeEmojis(value);
-        value = normalizeToKebabCase(value);
-        // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
-        return value;
+    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;
     }
 
     /**
-     * Compile promptbook from string (markdown) format to JSON format
-     *
-     * @param promptbookString {Promptbook} in string markdown format (.ptbk.md)
-     * @param options - Options and tools for the compilation
-     * @returns {Promptbook} compiled in JSON format (.ptbk.json)
-     * @throws {PromptbookSyntaxError} if the promptbook string is not valid
+     * Creates executor function from promptbook and execution tools.
      *
-     * Note: This function does not validate logic of the pipeline only the syntax
-     * Note: This function acts as compilation process
+     * @returns The executor function
+     * @throws {PromptbookLogicError} on logical error in the promptbook
      */
-    function promptbookStringToJson(promptbookString, options) {
-        if (options === void 0) { options = {}; }
-        return __awaiter(this, void 0, void 0, function () {
-            var llmTools, promptbookJson, knowledge, addParam, markdownStructure, markdownStructureDeepness, description, defaultModelRequirements, listItems, listItems_1, listItems_1_1, listItem, command, _loop_1, _a, _b, section;
-            var e_1, _c, e_2, _d;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
-                    case 0:
-                        llmTools = options.llmTools;
-                        promptbookJson = {
+    function createPromptbookExecutor(options) {
+        var _this = this;
+        var promptbook = options.promptbook, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
+        var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? 3 : _b;
+        validatePromptbookJson(promptbook);
+        var promptbookExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+            function executeSingleTemplate(currentTemplate) {
+                return __awaiter(this, void 0, void 0, function () {
+                    var name, title, priority, prompt, chatThread, completionResult, result, resultString, expectError, scriptExecutionErrors, maxAttempts, jokers, attempt, isJokerAttempt, joker, _a, _b, _c, _d, scriptTools, error_2, e_2_1, _e, _f, functionName, postprocessingError, _g, _h, scriptTools, error_3, e_3_1, e_4_1, error_4;
+                    var e_2, _j, e_4, _k, e_3, _l, _m;
+                    var _this = this;
+                    return __generator(this, function (_o) {
+                        switch (_o.label) {
+                            case 0:
+                                name = "promptbook-executor-frame-".concat(currentTemplate.name);
+                                title = currentTemplate.title;
+                                priority = promptbook.promptTemplates.length - promptbook.promptTemplates.indexOf(currentTemplate);
+                                if (!onProgress /* <- [3] */) return [3 /*break*/, 2]; /* <- [3] */
+                                return [4 /*yield*/, onProgress({
+                                        name: name,
+                                        title: title,
+                                        isStarted: false,
+                                        isDone: false,
+                                        executionType: currentTemplate.executionType,
+                                        parameterName: currentTemplate.resultingParameterName,
+                                        parameterValue: null,
+                                        // <- [3]
+                                    })];
+                            case 1:
+                                _o.sent();
+                                _o.label = 2;
+                            case 2:
+                                result = null;
+                                resultString = null;
+                                expectError = null;
+                                maxAttempts = currentTemplate.executionType === 'PROMPT_DIALOG' ? Infinity : maxExecutionAttempts;
+                                jokers = currentTemplate.jokers || [];
+                                attempt = -jokers.length;
+                                _o.label = 3;
+                            case 3:
+                                if (!(attempt < maxAttempts)) return [3 /*break*/, 49];
+                                isJokerAttempt = attempt < 0;
+                                joker = jokers[jokers.length + attempt];
+                                if (isJokerAttempt && !joker) {
+                                    throw new UnexpectedError("Joker not found in attempt ".concat(attempt));
+                                }
+                                result = null;
+                                resultString = null;
+                                expectError = null;
+                                if (isJokerAttempt) {
+                                    if (typeof parametersToPass[joker] === 'undefined') {
+                                        throw new PromptbookExecutionError("Joker parameter {".concat(joker, "} not defined"));
+                                    }
+                                    resultString = parametersToPass[joker];
+                                }
+                                _o.label = 4;
+                            case 4:
+                                _o.trys.push([4, 45, 46, 47]);
+                                if (!!isJokerAttempt) return [3 /*break*/, 27];
+                                _a = currentTemplate.executionType;
+                                switch (_a) {
+                                    case 'SIMPLE_TEMPLATE': return [3 /*break*/, 5];
+                                    case 'PROMPT_TEMPLATE': return [3 /*break*/, 6];
+                                    case 'SCRIPT': return [3 /*break*/, 13];
+                                    case 'PROMPT_DIALOG': return [3 /*break*/, 24];
+                                }
+                                return [3 /*break*/, 26];
+                            case 5:
+                                resultString = replaceParameters(currentTemplate.content, parametersToPass);
+                                return [3 /*break*/, 27];
+                            case 6:
+                                prompt = {
+                                    title: currentTemplate.title,
+                                    promptbookUrl: "".concat(promptbook.promptbookUrl
+                                        ? promptbook.promptbookUrl
+                                        : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous PROMPTBOOKs, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
+                                    parameters: parametersToPass,
+                                    content: replaceParameters(currentTemplate.content, parametersToPass) /* <- [2] */,
+                                    modelRequirements: currentTemplate.modelRequirements,
+                                    expectations: currentTemplate.expectations,
+                                    expectFormat: currentTemplate.expectFormat,
+                                    postprocessing: (currentTemplate.postprocessing || []).map(function (functionName) { return function (result) { return __awaiter(_this, void 0, void 0, function () {
+                                        var errors, _a, _b, scriptTools, error_5, e_5_1;
+                                        var e_5, _c;
+                                        return __generator(this, function (_d) {
+                                            switch (_d.label) {
+                                                case 0:
+                                                    errors = [];
+                                                    _d.label = 1;
+                                                case 1:
+                                                    _d.trys.push([1, 8, 9, 10]);
+                                                    _a = __values(tools.script), _b = _a.next();
+                                                    _d.label = 2;
+                                                case 2:
+                                                    if (!!_b.done) return [3 /*break*/, 7];
+                                                    scriptTools = _b.value;
+                                                    _d.label = 3;
+                                                case 3:
+                                                    _d.trys.push([3, 5, , 6]);
+                                                    return [4 /*yield*/, scriptTools.execute({
+                                                            scriptLanguage: "javascript" /* <- TODO: Try it in each languages; In future allow postprocessing with arbitrary combination of languages to combine */,
+                                                            script: "".concat(functionName, "(result)"),
+                                                            parameters: {
+                                                                result: result || '',
+                                                                // Note: No ...parametersToPass, because working with result only
+                                                            },
+                                                        })];
+                                                case 4: return [2 /*return*/, _d.sent()];
+                                                case 5:
+                                                    error_5 = _d.sent();
+                                                    if (!(error_5 instanceof Error)) {
+                                                        throw error_5;
+                                                    }
+                                                    errors.push(error_5);
+                                                    return [3 /*break*/, 6];
+                                                case 6:
+                                                    _b = _a.next();
+                                                    return [3 /*break*/, 2];
+                                                case 7: return [3 /*break*/, 10];
+                                                case 8:
+                                                    e_5_1 = _d.sent();
+                                                    e_5 = { error: e_5_1 };
+                                                    return [3 /*break*/, 10];
+                                                case 9:
+                                                    try {
+                                                        if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                                                    }
+                                                    finally { if (e_5) throw e_5.error; }
+                                                    return [7 /*endfinally*/];
+                                                case 10:
+                                                    if (errors.length === 0) {
+                                                        throw new PromptbookExecutionError('Postprocessing in LlmExecutionTools failed because no ScriptExecutionTools were provided');
+                                                    }
+                                                    else if (errors.length === 1) {
+                                                        throw errors[0];
+                                                    }
+                                                    else {
+                                                        throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                                        Postprocessing in LlmExecutionTools failed ".concat(errors.length, "x\n\n                                                        ").concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n\n')), "\n                                                      "); }));
+                                                    }
+                                            }
+                                        });
+                                    }); }; }),
+                                };
+                                _b = currentTemplate.modelRequirements.modelVariant;
+                                switch (_b) {
+                                    case 'CHAT': return [3 /*break*/, 7];
+                                    case 'COMPLETION': return [3 /*break*/, 9];
+                                }
+                                return [3 /*break*/, 11];
+                            case 7: return [4 /*yield*/, tools.llm.gptChat(prompt)];
+                            case 8:
+                                chatThread = _o.sent();
+                                // TODO: [🍬] Destroy chatThread
+                                result = chatThread;
+                                resultString = chatThread.content;
+                                return [3 /*break*/, 12];
+                            case 9: return [4 /*yield*/, tools.llm.gptComplete(prompt)];
+                            case 10:
+                                completionResult = _o.sent();
+                                result = completionResult;
+                                resultString = completionResult.content;
+                                return [3 /*break*/, 12];
+                            case 11: throw new PromptbookExecutionError("Unknown model variant \"".concat(currentTemplate.modelRequirements.modelVariant, "\""));
+                            case 12: return [3 /*break*/, 27];
+                            case 13:
+                                if (tools.script.length === 0) {
+                                    throw new PromptbookExecutionError('No script execution tools are available');
+                                }
+                                if (!currentTemplate.contentLanguage) {
+                                    throw new PromptbookExecutionError("Script language is not defined for prompt template \"".concat(currentTemplate.name, "\""));
+                                }
+                                // TODO: DRY [1]
+                                scriptExecutionErrors = [];
+                                _o.label = 14;
+                            case 14:
+                                _o.trys.push([14, 21, 22, 23]);
+                                _c = (e_2 = void 0, __values(tools.script)), _d = _c.next();
+                                _o.label = 15;
+                            case 15:
+                                if (!!_d.done) return [3 /*break*/, 20];
+                                scriptTools = _d.value;
+                                _o.label = 16;
+                            case 16:
+                                _o.trys.push([16, 18, , 19]);
+                                return [4 /*yield*/, scriptTools.execute({
+                                        scriptLanguage: currentTemplate.contentLanguage,
+                                        script: currentTemplate.content,
+                                        parameters: parametersToPass,
+                                    })];
+                            case 17:
+                                resultString = _o.sent();
+                                return [3 /*break*/, 20];
+                            case 18:
+                                error_2 = _o.sent();
+                                if (!(error_2 instanceof Error)) {
+                                    throw error_2;
+                                }
+                                scriptExecutionErrors.push(error_2);
+                                return [3 /*break*/, 19];
+                            case 19:
+                                _d = _c.next();
+                                return [3 /*break*/, 15];
+                            case 20: return [3 /*break*/, 23];
+                            case 21:
+                                e_2_1 = _o.sent();
+                                e_2 = { error: e_2_1 };
+                                return [3 /*break*/, 23];
+                            case 22:
+                                try {
+                                    if (_d && !_d.done && (_j = _c.return)) _j.call(_c);
+                                }
+                                finally { if (e_2) throw e_2.error; }
+                                return [7 /*endfinally*/];
+                            case 23:
+                                if (resultString !== null) {
+                                    return [3 /*break*/, 27];
+                                }
+                                if (scriptExecutionErrors.length === 1) {
+                                    throw scriptExecutionErrors[0];
+                                }
+                                else {
+                                    throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                              Script execution failed ".concat(scriptExecutionErrors.length, " times\n\n                                              ").concat(block(scriptExecutionErrors
+                                        .map(function (error) { return '- ' + error.message; })
+                                        .join('\n\n')), "\n                                          "); }));
+                                }
+                            case 24:
+                                if (tools.userInterface === undefined) {
+                                    throw new PromptbookExecutionError('User interface tools are not available');
+                                }
+                                return [4 /*yield*/, tools.userInterface.promptDialog({
+                                        promptTitle: currentTemplate.title,
+                                        promptMessage: replaceParameters(currentTemplate.description || '', parametersToPass),
+                                        defaultValue: replaceParameters(currentTemplate.content, parametersToPass),
+                                        // TODO: [🧠] !! Figure out how to define placeholder in .ptbk.md file
+                                        placeholder: undefined,
+                                        priority: priority,
+                                    })];
+                            case 25:
+                                // TODO: [🌹] When making next attempt for `PROMPT DIALOG`, preserve the previous user input
+                                resultString = _o.sent();
+                                return [3 /*break*/, 27];
+                            case 26: throw new PromptbookExecutionError(
                             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
-                            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
-                            promptbookVersion: PROMPTBOOK_VERSION,
-                            description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
-                            parameters: [],
-                            promptTemplates: [],
-                            knowledge: [],
+                            "Unknown execution type \"".concat(currentTemplate.executionType, "\""));
+                            case 27:
+                                if (!(!isJokerAttempt && currentTemplate.postprocessing)) return [3 /*break*/, 44];
+                                _o.label = 28;
+                            case 28:
+                                _o.trys.push([28, 42, 43, 44]);
+                                _e = (e_4 = void 0, __values(currentTemplate.postprocessing)), _f = _e.next();
+                                _o.label = 29;
+                            case 29:
+                                if (!!_f.done) return [3 /*break*/, 41];
+                                functionName = _f.value;
+                                // TODO: DRY [1]
+                                scriptExecutionErrors = [];
+                                postprocessingError = null;
+                                _o.label = 30;
+                            case 30:
+                                _o.trys.push([30, 37, 38, 39]);
+                                _g = (e_3 = void 0, __values(tools.script)), _h = _g.next();
+                                _o.label = 31;
+                            case 31:
+                                if (!!_h.done) return [3 /*break*/, 36];
+                                scriptTools = _h.value;
+                                _o.label = 32;
+                            case 32:
+                                _o.trys.push([32, 34, , 35]);
+                                return [4 /*yield*/, scriptTools.execute({
+                                        scriptLanguage: "javascript" /* <- TODO: Try it in each languages; In future allow postprocessing with arbitrary combination of languages to combine */,
+                                        script: "".concat(functionName, "(resultString)"),
+                                        parameters: {
+                                            resultString: resultString || '',
+                                            // Note: No ...parametersToPass, because working with result only
+                                        },
+                                    })];
+                            case 33:
+                                resultString = _o.sent();
+                                postprocessingError = null;
+                                return [3 /*break*/, 36];
+                            case 34:
+                                error_3 = _o.sent();
+                                if (!(error_3 instanceof Error)) {
+                                    throw error_3;
+                                }
+                                postprocessingError = error_3;
+                                scriptExecutionErrors.push(error_3);
+                                return [3 /*break*/, 35];
+                            case 35:
+                                _h = _g.next();
+                                return [3 /*break*/, 31];
+                            case 36: return [3 /*break*/, 39];
+                            case 37:
+                                e_3_1 = _o.sent();
+                                e_3 = { error: e_3_1 };
+                                return [3 /*break*/, 39];
+                            case 38:
+                                try {
+                                    if (_h && !_h.done && (_l = _g.return)) _l.call(_g);
+                                }
+                                finally { if (e_3) throw e_3.error; }
+                                return [7 /*endfinally*/];
+                            case 39:
+                                if (postprocessingError) {
+                                    throw postprocessingError;
+                                }
+                                _o.label = 40;
+                            case 40:
+                                _f = _e.next();
+                                return [3 /*break*/, 29];
+                            case 41: return [3 /*break*/, 44];
+                            case 42:
+                                e_4_1 = _o.sent();
+                                e_4 = { error: e_4_1 };
+                                return [3 /*break*/, 44];
+                            case 43:
+                                try {
+                                    if (_f && !_f.done && (_k = _e.return)) _k.call(_e);
+                                }
+                                finally { if (e_4) throw e_4.error; }
+                                return [7 /*endfinally*/];
+                            case 44:
+                                // TODO: [💝] Unite object for expecting amount and format
+                                if (currentTemplate.expectFormat) {
+                                    if (currentTemplate.expectFormat === 'JSON') {
+                                        if (!isValidJsonString(resultString || '')) {
+                                            throw new ExpectError('Expected valid JSON string');
+                                        }
+                                    }
+                                }
+                                // TODO: [💝] Unite object for expecting amount and format
+                                if (currentTemplate.expectations) {
+                                    checkExpectations(currentTemplate.expectations, resultString || '');
+                                }
+                                return [3 /*break*/, 49];
+                            case 45:
+                                error_4 = _o.sent();
+                                if (!(error_4 instanceof ExpectError)) {
+                                    throw error_4;
+                                }
+                                expectError = error_4;
+                                return [3 /*break*/, 47];
+                            case 46:
+                                if (!isJokerAttempt &&
+                                    currentTemplate.executionType === 'PROMPT_TEMPLATE' &&
+                                    prompt
+                                //    <- Note:  [2] When some expected parameter is not defined, error will occur in replaceParameters
+                                //              In that case we don’t want to make a report about it because it’s not a llm execution error
+                                ) {
+                                    // TODO: [🧠] Maybe put other executionTypes into report
+                                    executionReport.promptExecutions.push({
+                                        prompt: {
+                                            title: currentTemplate.title /* <- Note: If title in promptbook contains emojis, pass it innto report */,
+                                            content: prompt.content,
+                                            modelRequirements: prompt.modelRequirements,
+                                            expectations: prompt.expectations,
+                                            expectFormat: prompt.expectFormat,
+                                            // <- Note: Do want to pass ONLY wanted information to the report
+                                        },
+                                        result: result || undefined,
+                                        error: expectError || undefined,
+                                    });
+                                }
+                                return [7 /*endfinally*/];
+                            case 47:
+                                if (expectError !== null && attempt === maxAttempts - 1) {
+                                    throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ---\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block((expectError === null || expectError === void 0 ? void 0 : expectError.message) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
+                                }
+                                _o.label = 48;
+                            case 48:
+                                attempt++;
+                                return [3 /*break*/, 3];
+                            case 49:
+                                if (resultString === null) {
+                                    throw new UnexpectedError('Something went wrong and prompt result is null');
+                                }
+                                if (onProgress /* <- [3] */) {
+                                    onProgress({
+                                        name: name,
+                                        title: title,
+                                        isStarted: true,
+                                        isDone: true,
+                                        executionType: currentTemplate.executionType,
+                                        parameterName: currentTemplate.resultingParameterName,
+                                        parameterValue: resultString,
+                                        // <- [3]
+                                    });
+                                }
+                                parametersToPass = __assign(__assign({}, parametersToPass), (_m = {}, _m[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because Promptbook checks logic consistency during construction */, _m));
+                                return [2 /*return*/];
+                        }
+                    });
+                });
+            }
+            var parametersToPass, executionReport, resovedParameters_1, unresovedTemplates, resolving_1, loopLimit, _loop_1, error_1, usage_1, _a, _b, parameter, usage;
+            var e_1, _c;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        parametersToPass = inputParameters;
+                        executionReport = {
+                            promptbookUrl: promptbook.promptbookUrl,
+                            title: promptbook.title,
+                            promptbookUsedVersion: PROMPTBOOK_VERSION,
+                            promptbookRequestedVersion: promptbook.promptbookVersion,
+                            description: promptbook.description,
+                            promptExecutions: [],
                         };
-                        if (!llmTools) return [3 /*break*/, 2];
-                        return [4 /*yield*/, prepareKnowledgeFromMarkdown()];
+                        _d.label = 1;
                     case 1:
-                        knowledge = _e.sent();
-                        console.info('!!!! knowledge', knowledge);
-                        _e.label = 2;
-                    case 2:
-                        // =============================================================
-                        // Note: 1️⃣ Normalization of the PROMPTBOOK string
-                        promptbookString = removeContentComments(promptbookString);
-                        promptbookString = promptbookString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
-                        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
-                        addParam = function (parameterCommand) {
-                            var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInput = parameterCommand.isInput, isOutput = parameterCommand.isOutput;
-                            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
-                            if (existingParameter &&
-                                existingParameter.description &&
-                                existingParameter.description !== parameterDescription &&
-                                parameterDescription) {
-                                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) {
-                                    existingParameter.description = parameterDescription;
+                        _d.trys.push([1, 6, , 7]);
+                        resovedParameters_1 = promptbook.parameters
+                            .filter(function (_a) {
+                            var isInput = _a.isInput;
+                            return isInput;
+                        })
+                            .map(function (_a) {
+                            var name = _a.name;
+                            return name;
+                        });
+                        unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
+                        resolving_1 = [];
+                        loopLimit = LOOP_LIMIT;
+                        _loop_1 = function () {
+                            var currentTemplate, work_1;
+                            return __generator(this, function (_e) {
+                                switch (_e.label) {
+                                    case 0:
+                                        if (loopLimit-- < 0) {
+                                            throw new UnexpectedError('Loop limit reached during resolving parameters promptbook execution');
+                                        }
+                                        currentTemplate = unresovedTemplates.find(function (template) {
+                                            return template.dependentParameterNames.every(function (name) { return resovedParameters_1.includes(name); });
+                                        });
+                                        if (!(!currentTemplate && resolving_1.length === 0)) return [3 /*break*/, 1];
+                                        throw new UnexpectedError(spaceTrim.spaceTrim("\n                            Can not resolve some parameters\n\n                            Note: This should be catched during validatePromptbookJson\n                        "));
+                                    case 1:
+                                        if (!!currentTemplate) return [3 /*break*/, 3];
+                                        /* [5] */ return [4 /*yield*/, Promise.race(resolving_1)];
+                                    case 2:
+                                        /* [5] */ _e.sent();
+                                        return [3 /*break*/, 4];
+                                    case 3:
+                                        unresovedTemplates = unresovedTemplates.filter(function (template) { return template !== currentTemplate; });
+                                        work_1 = executeSingleTemplate(currentTemplate)
+                                            .then(function () {
+                                            resovedParameters_1 = __spreadArray(__spreadArray([], __read(resovedParameters_1), false), [currentTemplate.resultingParameterName], false);
+                                        })
+                                            .then(function () {
+                                            resolving_1 = resolving_1.filter(function (w) { return w !== work_1; });
+                                        });
+                                        resolving_1.push(work_1);
+                                        _e.label = 4;
+                                    case 4: return [2 /*return*/];
                                 }
-                            }
-                            else {
-                                promptbookJson.parameters.push({
-                                    name: parameterName,
-                                    description: parameterDescription || undefined,
-                                    isInput: isInput,
-                                    isOutput: isOutput,
-                                });
-                            }
+                            });
                         };
-                        markdownStructure = markdownToMarkdownStructure(promptbookString);
-                        markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
-                        if (markdownStructureDeepness !== 2) {
-                            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;
-                        description = markdownStructure.content;
-                        // Note: Remove codeblocks
-                        description = description.split(/^```.*^```/gms).join('');
-                        //Note: Remove lists and return statement
-                        description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-                        description = spaceTrim.spaceTrim(description);
-                        if (description === '') {
-                            description = undefined;
+                        _d.label = 2;
+                    case 2:
+                        if (!(unresovedTemplates.length > 0)) return [3 /*break*/, 4];
+                        return [5 /*yield**/, _loop_1()];
+                    case 3:
+                        _d.sent();
+                        return [3 /*break*/, 2];
+                    case 4: return [4 /*yield*/, Promise.all(resolving_1)];
+                    case 5:
+                        _d.sent();
+                        return [3 /*break*/, 7];
+                    case 6:
+                        error_1 = _d.sent();
+                        if (!(error_1 instanceof Error)) {
+                            throw error_1;
                         }
-                        promptbookJson.description = description;
-                        defaultModelRequirements = {};
-                        listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
+                        usage_1 = addUsage.apply(void 0, __spreadArray([], __read(executionReport.promptExecutions.map(function (_a) {
+                            var result = _a.result;
+                            return (result === null || result === void 0 ? void 0 : result.usage) || addUsage();
+                        })), false));
+                        return [2 /*return*/, {
+                                isSuccessful: false,
+                                errors: [error_1],
+                                usage: usage_1,
+                                executionReport: executionReport,
+                                outputParameters: parametersToPass,
+                            }];
+                    case 7:
                         try {
-                            for (listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
-                                listItem = listItems_1_1.value;
-                                command = parseCommand(listItem);
-                                switch (command.type) {
-                                    case 'PROMPTBOOK_URL':
-                                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
-                                        break;
-                                    case 'PROMPTBOOK_VERSION':
-                                        promptbookJson.promptbookVersion = command.promptbookVersion;
-                                        break;
-                                    case 'MODEL':
-                                        defaultModelRequirements[command.key] = command.value;
-                                        break;
-                                    case 'PARAMETER':
-                                        addParam(command);
-                                        break;
-                                    default:
-                                        throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
+                            // Note: Filter ONLY output parameters
+                            for (_a = __values(promptbook.parameters), _b = _a.next(); !_b.done; _b = _a.next()) {
+                                parameter = _b.value;
+                                if (parameter.isOutput) {
+                                    continue;
                                 }
+                                delete parametersToPass[parameter.name];
                             }
                         }
                         catch (e_1_1) { e_1 = { error: e_1_1 }; }
                         finally {
                             try {
-                                if (listItems_1_1 && !listItems_1_1.done && (_c = listItems_1.return)) _c.call(listItems_1);
+                                if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
-                        _loop_1 = function (section) {
-                            var e_3, _f;
-                            // TODO: Parse prompt template description (the content out of the codeblock and lists)
-                            var templateModelRequirements = __assign({}, defaultModelRequirements);
-                            var listItems_3 = extractAllListItemsFromMarkdown(section.content);
-                            var dependentParameterNames = new Set();
-                            var executionType = 'PROMPT_TEMPLATE';
-                            var jokers = [];
-                            var postprocessing = [];
-                            var expectAmount = {};
-                            var expectFormat = undefined;
-                            var isExecutionTypeChanged = false;
-                            try {
-                                for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
-                                    var listItem = listItems_2_1.value;
-                                    var command = parseCommand(listItem);
-                                    switch (command.type) {
-                                        case 'JOKER':
-                                            jokers.push(command.parameterName);
-                                            dependentParameterNames.add(command.parameterName);
-                                            break;
-                                        case 'EXECUTE':
-                                            if (isExecutionTypeChanged) {
-                                                throw new PromptbookSyntaxError('Execution type is already defined in the prompt template. It can be defined only once.');
-                                            }
-                                            executionType = command.executionType;
-                                            isExecutionTypeChanged = true;
-                                            break;
-                                        case 'MODEL':
-                                            templateModelRequirements[command.key] = command.value;
-                                            break;
-                                        case 'PARAMETER':
-                                            // Note: This is just for detecting resulitng parameter name
-                                            addParam(command);
-                                            break;
-                                        case 'POSTPROCESS':
-                                            postprocessing.push(command.functionName);
-                                            break;
-                                        case 'EXPECT_AMOUNT':
-                                            // eslint-disable-next-line no-case-declarations
-                                            var unit = command.unit.toLowerCase();
-                                            expectAmount[unit] = expectAmount[unit] || {};
-                                            if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
-                                                if (expectAmount[unit].min !== undefined) {
-                                                    throw new PromptbookSyntaxError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
-                                                }
-                                                expectAmount[unit].min = command.amount;
-                                            } /* not else */
-                                            if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
-                                                if (expectAmount[unit].max !== undefined) {
-                                                    throw new PromptbookSyntaxError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
-                                                }
-                                                expectAmount[unit].max = command.amount;
-                                            }
-                                            break;
-                                        case 'EXPECT_FORMAT':
-                                            if (expectFormat !== undefined && command.format !== expectFormat) {
-                                                throw new PromptbookSyntaxError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
-                                            }
-                                            expectFormat = command.format;
-                                            break;
-                                        default:
-                                            throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
-                                    }
-                                }
-                            }
-                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                            finally {
-                                try {
-                                    if (listItems_2_1 && !listItems_2_1.done && (_f = listItems_2.return)) _f.call(listItems_2);
-                                }
-                                finally { if (e_3) throw e_3.error; }
-                            }
-                            var _g = extractOneBlockFromMarkdown(section.content), language = _g.language, content = _g.content;
-                            if (executionType === 'SCRIPT') {
-                                if (!language) {
-                                    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.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.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')
-                                    .map(function (line) { return "> ".concat(line); })
-                                    .join('\n')), "\n                        "); }));
-                            }
-                            var resultingParameterName = match.groups.resultingParamName;
-                            // TODO: [1] DRY description
-                            var description_1 = section.content;
-                            // Note: Remove codeblocks
-                            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.spaceTrim(description_1);
-                            if (description_1 === '') {
-                                description_1 = undefined;
-                            }
-                            if (Object.keys(jokers).length === 0) {
-                                jokers = undefined;
-                            }
-                            if (Object.keys(expectAmount).length === 0) {
-                                expectAmount = undefined;
-                            }
-                            if (Object.keys(postprocessing).length === 0) {
-                                postprocessing = undefined;
-                            }
-                            dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, executionType: executionType, content: content })));
-                            if (templateModelRequirements.modelVariant === undefined) {
-                                templateModelRequirements.modelVariant = 'CHAT';
-                            }
-                            promptbookJson.promptTemplates.push({
-                                name: titleToName(section.title),
-                                title: section.title,
-                                description: description_1,
-                                dependentParameterNames: Array.from(dependentParameterNames),
-                                executionType: executionType,
-                                jokers: jokers,
-                                postprocessing: postprocessing,
-                                expectations: expectAmount,
-                                expectFormat: expectFormat,
-                                modelRequirements: templateModelRequirements,
-                                contentLanguage: executionType === 'SCRIPT' ? language : undefined,
-                                content: content,
-                                resultingParameterName: resultingParameterName,
-                            });
-                        };
-                        try {
-                            for (_a = __values(markdownStructure.sections), _b = _a.next(); !_b.done; _b = _a.next()) {
-                                section = _b.value;
-                                _loop_1(section);
-                            }
-                        }
-                        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-                        finally {
-                            try {
-                                if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
-                            }
-                            finally { if (e_2) throw e_2.error; }
-                        }
-                        // =============================================================
-                        return [2 /*return*/, promptbookJson];
+                        usage = addUsage.apply(void 0, __spreadArray([], __read(executionReport.promptExecutions.map(function (_a) {
+                            var result = _a.result;
+                            return (result === null || result === void 0 ? void 0 : result.usage) || addUsage();
+                        })), false));
+                        return [2 /*return*/, {
+                                isSuccessful: true,
+                                errors: [],
+                                usage: usage,
+                                executionReport: executionReport,
+                                outputParameters: parametersToPass,
+                            }];
                 }
             });
-        });
+        }); };
+        return promptbookExecutor;
     }
     /**
-     * TODO: Report here line/column of error
-     * TODO: Use spaceTrim more effectively
-     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
-     */
-
-    /**
-     * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+     * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user
+     * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+     * Note: CreatePromptbookExecutorOptions are just connected to PromptbookExecutor so do not extract to types folder
+     * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
      */
-    var PromptbookLogicError = /** @class */ (function (_super) {
-        __extends(PromptbookLogicError, _super);
-        function PromptbookLogicError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PromptbookLogicError';
-            Object.setPrototypeOf(_this, PromptbookLogicError.prototype);
-            return _this;
-        }
-        return PromptbookLogicError;
-    }(Error));
 
     /**
-     * Tests if given string is valid URL.
+     * Prettify the html code
      *
-     * Note: Dataurl are considered perfectly valid.
+     * @param content raw html code
+     * @returns formatted html code
      */
-    function isValidUrl(url) {
-        if (typeof url !== 'string') {
-            return false;
-        }
+    function prettifyMarkdown(content) {
         try {
-            if (url.startsWith('blob:')) {
-                url = url.replace(/^blob:/, '');
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            var urlObject = new URL(url);
-            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-                return false;
-            }
-            return true;
+            return prettier.format(content, {
+                parser: 'markdown',
+                plugins: [parserHtml__default["default"]],
+                // TODO: DRY - make some import or auto-copy of .prettierrc
+                endOfLine: 'lf',
+                tabWidth: 4,
+                singleQuote: true,
+                trailingComma: 'all',
+                arrowParens: 'always',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                jsxBracketSameLine: false,
+                bracketSpacing: true,
+            });
         }
         catch (error) {
-            return false;
+            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
+                error: error,
+                html: content,
+            });
+            return content;
         }
     }
 
     /**
-     * Validates PromptbookJson if it is logically valid
-     *
-     * It checks:
-     * -   if it has correct parameters dependency
+     * Makes first letter of a string uppercase
      *
-     * It does NOT check:
-     * -   if it is valid json
-     * -   if it is meaningful
+     */
+    function capitalize(word) {
+        return word.substring(0, 1).toUpperCase() + word.substring(1);
+    }
+
+    /**
+     * Converts promptbook in JSON format to string format
      *
-     * @param promptbook valid or invalid PromptbookJson
-     * @returns the same promptbook if it is logically valid
-     * @throws {PromptbookLogicError} on logical error in the promptbook
+     * @param promptbookJson Promptbook in JSON format (.ptbk.json)
+     * @returns Promptbook in string format (.ptbk.md)
      */
-    function validatePromptbookJson(promptbook) {
-        // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
-        var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
-        if (promptbook.promptbookUrl !== undefined) {
-            if (!isValidUrl(promptbook.promptbookUrl)) {
-                // TODO: This should be maybe the syntax error detected during parsing
-                throw new PromptbookLogicError("Invalid promptbook URL \"".concat(promptbook.promptbookUrl, "\""));
-            }
-        }
-        // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
-        if (!Array.isArray(promptbook.parameters)) {
-            // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Promptbook is valid JSON but with wrong structure\n\n                promptbook.parameters expected to be an array, but got ".concat(typeof promptbook.parameters, "\n            ")));
+    function promptbookJsonToString(promptbookJson) {
+        var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e, e_6, _f;
+        var title = promptbookJson.title, promptbookUrl = promptbookJson.promptbookUrl, promptbookVersion = promptbookJson.promptbookVersion, description = promptbookJson.description, parameters = promptbookJson.parameters, promptTemplates = promptbookJson.promptTemplates;
+        var promptbookString = "# ".concat(title);
+        if (description) {
+            promptbookString += '\n\n';
+            promptbookString += description;
         }
-        // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
-        if (!Array.isArray(promptbook.promptTemplates)) {
-            // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n              Promptbook is valid JSON but with wrong structure\n\n              promptbook.promptTemplates expected to be an array, but got ".concat(typeof promptbook.promptTemplates, "\n          ")));
+        // TODO:> const commands: Array<Command>
+        var commands = [];
+        if (promptbookUrl) {
+            commands.push("PROMPTBOOK URL ".concat(promptbookUrl));
         }
-        var _loop_1 = function (parameter) {
-            if (parameter.isInput && parameter.isOutput) {
-                throw new PromptbookLogicError("Parameter {".concat(parameter.name, "} can not be both input and output"));
-            }
-            // Note: Testing that parameter is either intermediate or output BUT not created and unused
-            if (!parameter.isInput &&
-                !parameter.isOutput &&
-                !promptbook.promptTemplates.some(function (template) { return template.dependentParameterNames.includes(parameter.name); })) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is created but not used\n\n                    You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                    - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                ")));
-            }
-            // Note: Testing that parameter is either input or result of some template
-            if (!parameter.isInput &&
-                !promptbook.promptTemplates.some(function (template) { return template.resultingParameterName === parameter.name; })) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is declared but not defined\n\n                    You can do one of these:\n                    - Remove declaration of {").concat(parameter.name, "}\n                    - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                ")));
-            }
-        };
+        commands.push("PROMPTBOOK VERSION ".concat(promptbookVersion));
+        promptbookString = prettifyMarkdown(promptbookString);
         try {
-            // Note: Check each parameter individually
-            for (var _e = __values(promptbook.parameters), _f = _e.next(); !_f.done; _f = _e.next()) {
-                var parameter = _f.value;
-                _loop_1(parameter);
+            for (var _g = __values(parameters.filter(function (_a) {
+                var isInput = _a.isInput;
+                return isInput;
+            })), _h = _g.next(); !_h.done; _h = _g.next()) {
+                var parameter = _h.value;
+                commands.push("INPUT PARAMETER ".concat(promptTemplateParameterJsonToString(parameter)));
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        // Note: Check each template individually
-        var definedParameters = new Set(promptbook.parameters.filter(function (_a) {
-            var isInput = _a.isInput;
-            return isInput;
-        }).map(function (_a) {
-            var name = _a.name;
-            return name;
-        }));
-        try {
-            for (var _g = __values(promptbook.promptTemplates), _h = _g.next(); !_h.done; _h = _g.next()) {
-                var template = _h.value;
-                if (definedParameters.has(template.resultingParameterName)) {
-                    throw new PromptbookLogicError("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
-                }
-                definedParameters.add(template.resultingParameterName);
-                if (template.executionType === 'PROMPT_TEMPLATE' &&
-                    (template.modelRequirements.modelVariant === undefined)) {
-                    throw new PromptbookLogicError(spaceTrim.spaceTrim("\n\n                  You must specify MODEL VARIANT in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
-                }
-                if (template.jokers && template.jokers.length > 0) {
-                    if (!template.expectFormat &&
-                        !template.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                        throw new PromptbookLogicError("Joker parameters are used for {".concat(template.resultingParameterName, "} but no expectations are defined"));
-                    }
-                    try {
-                        for (var _j = (e_3 = void 0, __values(template.jokers)), _k = _j.next(); !_k.done; _k = _j.next()) {
-                            var joker = _k.value;
-                            if (!template.dependentParameterNames.includes(joker)) {
-                                throw new PromptbookLogicError("Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in dependentParameterNames"));
-                            }
-                        }
-                    }
-                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                    finally {
-                        try {
-                            if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
-                        }
-                        finally { if (e_3) throw e_3.error; }
-                    }
-                }
-                if (template.expectations) {
-                    try {
-                        for (var _l = (e_4 = void 0, __values(Object.entries(template.expectations))), _m = _l.next(); !_m.done; _m = _l.next()) {
-                            var _o = __read(_m.value, 2), unit = _o[0], _p = _o[1], min = _p.min, max = _p.max;
-                            if (min !== undefined && max !== undefined && min > max) {
-                                throw new PromptbookLogicError("Min expectation (=".concat(min, ") of ").concat(unit, " is higher than max expectation (=").concat(max, ")"));
-                            }
-                            if (min !== undefined && min < 0) {
-                                throw new PromptbookLogicError("Min expectation of ".concat(unit, " must be zero or positive"));
-                            }
-                            if (max !== undefined && max <= 0) {
-                                throw new PromptbookLogicError("Max expectation of ".concat(unit, " must be positive"));
-                            }
-                        }
-                    }
-                    catch (e_4_1) { e_4 = { error: e_4_1 }; }
-                    finally {
-                        try {
-                            if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
-                        }
-                        finally { if (e_4) throw e_4.error; }
-                    }
-                }
-            }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
-            }
-            finally { if (e_2) throw e_2.error; }
-        }
-        // Note: Detect circular dependencies
-        var resovedParameters = promptbook.parameters
-            .filter(function (_a) {
-            var isInput = _a.isInput;
-            return isInput;
-        })
-            .map(function (_a) {
-            var name = _a.name;
-            return name;
-        });
-        var unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
-        var loopLimit = LOOP_LIMIT;
-        var _loop_2 = function () {
-            if (loopLimit-- < 0) {
-                throw new UnexpectedError('Loop limit reached during detection of circular dependencies in `validatePromptbookJson`');
-            }
-            var currentlyResovedTemplates = unresovedTemplates.filter(function (template) {
-                return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
-            });
-            if (currentlyResovedTemplates.length === 0) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters\n                        It may be circular dependencies\n\n                        Can not resolve:\n                        ".concat(block(unresovedTemplates
-                    .map(function (_a) {
-                    var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
-                    return "- {".concat(resultingParameterName, "} depends on ").concat(dependentParameterNames
-                        .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
-                        .join(', '));
-                })
-                    .join('\n')), "\n\n                        Resolved:\n                        ").concat(block(resovedParameters.map(function (name) { return "- {".concat(name, "}"); }).join('\n')), "\n                    "); }));
-            }
-            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTemplates.map(function (_a) {
-                var resultingParameterName = _a.resultingParameterName;
-                return resultingParameterName;
-            })), false);
-            unresovedTemplates = unresovedTemplates.filter(function (template) { return !currentlyResovedTemplates.includes(template); });
-        };
-        while (unresovedTemplates.length > 0) {
-            _loop_2();
-        }
-        return promptbook;
-    }
-    /**
-     * TODO: [🧠] Work with promptbookVersion
-     * TODO: Use here some json-schema, Zod or something similar and change it to:
-     *     > /**
-     *     >  * Validates PromptbookJson if it is logically valid.
-     *     >  *
-     *     >  * It checks:
-     *     >  * -   it has a valid structure
-     *     >  * -   ...
-     *     >  ex port function validatePromptbookJson(promptbook: unknown): asserts promptbook is PromptbookJson {
-     */
-
-    /**
-     * This error indicates that the promptbook library cannot be propperly loaded
-     */
-    var PromptbookLibraryError = /** @class */ (function (_super) {
-        __extends(PromptbookLibraryError, _super);
-        function PromptbookLibraryError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PromptbookLibraryError';
-            Object.setPrototypeOf(_this, PromptbookLibraryError.prototype);
-            return _this;
-        }
-        return PromptbookLibraryError;
-    }(Error));
-
-    /**
-     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
-     */
-    new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
-    /**
-     * Detects if the code is running in a Node.js environment
-     */
-    var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
-    /**
-     * Detects if the code is running in a web worker
-     */
-    new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
-
-    /**
-     * Prettify the html code
-     *
-     * @param content raw html code
-     * @returns formatted html code
-     */
-    function prettifyMarkdown(content) {
-        try {
-            return prettier.format(content, {
-                parser: 'markdown',
-                plugins: [parserHtml__default["default"]],
-                // TODO: DRY - make some import or auto-copy of .prettierrc
-                endOfLine: 'lf',
-                tabWidth: 4,
-                singleQuote: true,
-                trailingComma: 'all',
-                arrowParens: 'always',
-                printWidth: 120,
-                htmlWhitespaceSensitivity: 'ignore',
-                jsxBracketSameLine: false,
-                bracketSpacing: true,
-            });
-        }
-        catch (error) {
-            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
-                error: error,
-                html: content,
-            });
-            return content;
-        }
-    }
-
-    /**
-     * Converts promptbook in JSON format to string format
-     *
-     * @param promptbookJson Promptbook in JSON format (.ptbk.json)
-     * @returns Promptbook in string format (.ptbk.md)
-     */
-    function promptbookJsonToString(promptbookJson) {
-        var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e, e_6, _f;
-        var title = promptbookJson.title, promptbookUrl = promptbookJson.promptbookUrl, promptbookVersion = promptbookJson.promptbookVersion, description = promptbookJson.description, parameters = promptbookJson.parameters, promptTemplates = promptbookJson.promptTemplates;
-        var promptbookString = "# ".concat(title);
-        if (description) {
-            promptbookString += '\n\n';
-            promptbookString += description;
-        }
-        // TODO:> const commands: Array<Command>
-        var commands = [];
-        if (promptbookUrl) {
-            commands.push("PROMPTBOOK URL ".concat(promptbookUrl));
-        }
-        commands.push("PROMPTBOOK VERSION ".concat(promptbookVersion));
-        promptbookString = prettifyMarkdown(promptbookString);
-        try {
-            for (var _g = __values(parameters.filter(function (_a) {
-                var isInput = _a.isInput;
-                return isInput;
-            })), _h = _g.next(); !_h.done; _h = _g.next()) {
-                var parameter = _h.value;
-                commands.push("INPUT PARAMETER ".concat(promptTemplateParameterJsonToString(parameter)));
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
+                if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
             }
             finally { if (e_1) throw e_1.error; }
         }
@@ -2011,252 +1694,1517 @@
                     catch (e_5_1) { e_5 = { error: e_5_1 }; }
                     finally {
                         try {
-                            if (postprocessing_1_1 && !postprocessing_1_1.done && (_e = postprocessing_1.return)) _e.call(postprocessing_1);
-                        }
-                        finally { if (e_5) throw e_5.error; }
-                    }
-                } /* not else */
-                if (expectations) {
-                    try {
-                        for (var _l = (e_6 = void 0, __values(Object.entries(expectations))), _m = _l.next(); !_m.done; _m = _l.next()) {
-                            var _o = __read(_m.value, 2), unit = _o[0], _p = _o[1], min = _p.min, max = _p.max;
-                            if (min === max) {
-                                commands_1.push("EXPECT EXACTLY ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
-                            }
-                            else {
-                                if (min !== undefined) {
-                                    commands_1.push("EXPECT MIN ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
-                                } /* not else */
-                                if (max !== undefined) {
-                                    commands_1.push("EXPECT MAX ".concat(max, " ").concat(capitalize(unit + (max > 1 ? 's' : ''))));
-                                }
+                            if (postprocessing_1_1 && !postprocessing_1_1.done && (_e = postprocessing_1.return)) _e.call(postprocessing_1);
+                        }
+                        finally { if (e_5) throw e_5.error; }
+                    }
+                } /* not else */
+                if (expectations) {
+                    try {
+                        for (var _l = (e_6 = void 0, __values(Object.entries(expectations))), _m = _l.next(); !_m.done; _m = _l.next()) {
+                            var _o = __read(_m.value, 2), unit = _o[0], _p = _o[1], min = _p.min, max = _p.max;
+                            if (min === max) {
+                                commands_1.push("EXPECT EXACTLY ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                            }
+                            else {
+                                if (min !== undefined) {
+                                    commands_1.push("EXPECT MIN ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                                } /* not else */
+                                if (max !== undefined) {
+                                    commands_1.push("EXPECT MAX ".concat(max, " ").concat(capitalize(unit + (max > 1 ? 's' : ''))));
+                                }
+                            }
+                        }
+                    }
+                    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+                    finally {
+                        try {
+                            if (_m && !_m.done && (_f = _l.return)) _f.call(_l);
+                        }
+                        finally { if (e_6) throw e_6.error; }
+                    }
+                } /* not else */
+                if (expectFormat) {
+                    if (expectFormat === 'JSON') {
+                        // TODO: @deprecated remove
+                        commands_1.push("EXPECT JSON");
+                    }
+                } /* not else */
+                promptbookString += '\n\n';
+                promptbookString += commands_1.map(function (command) { return "- ".concat(command); }).join('\n');
+                promptbookString += '\n\n';
+                promptbookString += '```' + contentLanguage;
+                promptbookString += '\n';
+                promptbookString += spaceTrim__default["default"](content);
+                //                   <- TODO: !!! Escape
+                //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
+                promptbookString += '\n';
+                promptbookString += '```';
+                promptbookString += '\n\n';
+                promptbookString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: !!! If the parameter here has description, add it and use promptTemplateParameterJsonToString
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (promptTemplates_1_1 && !promptTemplates_1_1.done && (_c = promptTemplates_1.return)) _c.call(promptTemplates_1);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+        return promptbookString;
+    }
+    /**
+     * @private internal util of promptbookJsonToString
+     */
+    function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
+        var name = promptTemplateParameterJson.name, description = promptTemplateParameterJson.description;
+        var parameterString = "{".concat(name, "}");
+        if (description) {
+            parameterString = "".concat(parameterString, " ").concat(description);
+        }
+        return parameterString;
+    }
+    /**
+     * TODO: Escape all
+     */
+
+    /**
+     * This error indicates that promptbook not found in the library
+     */
+    var PromptbookNotFoundError = /** @class */ (function (_super) {
+        __extends(PromptbookNotFoundError, _super);
+        function PromptbookNotFoundError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PromptbookNotFoundError';
+            Object.setPrototypeOf(_this, PromptbookNotFoundError.prototype);
+            return _this;
+        }
+        return PromptbookNotFoundError;
+    }(Error));
+
+    /**
+     * This error indicates errors in referencing promptbooks between each other
+     */
+    var PromptbookReferenceError = /** @class */ (function (_super) {
+        __extends(PromptbookReferenceError, _super);
+        function PromptbookReferenceError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PromptbookReferenceError';
+            Object.setPrototypeOf(_this, PromptbookReferenceError.prototype);
+            return _this;
+        }
+        return PromptbookReferenceError;
+    }(Error));
+
+    /**
+     * Library of promptbooks that groups together promptbooks for an application.
+     * This implementation is a very thin wrapper around the Array / Map of promptbooks.
+     *
+     * @see https://github.com/webgptorg/promptbook#promptbook-library
+     */
+    var SimplePromptbookLibrary = /** @class */ (function () {
+        /**
+         * Constructs a promptbook library from promptbooks
+         *
+         * @param promptbooks !!!
+         *
+         * Note: During the construction logic of all promptbooks are validated
+         * Note: It is not recommended to use this constructor directly, use `createPromptbookLibraryFromSources` *(or other variant)* instead
+         */
+        function SimplePromptbookLibrary() {
+            var e_1, _a;
+            var promptbooks = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                promptbooks[_i] = arguments[_i];
+            }
+            this.library = new Map();
+            try {
+                for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
+                    var promptbook = promptbooks_1_1.value;
+                    if (promptbook.promptbookUrl === undefined) {
+                        throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the promptbook library\n\n                    ")));
+                    }
+                    validatePromptbookJson(promptbook);
+                    // Note: [🦄]
+                    if (this.library.has(promptbook.promptbookUrl) &&
+                        promptbookJsonToString(promptbook) !==
+                            promptbookJsonToString(this.library.get(promptbook.promptbookUrl))) {
+                        throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with URL \"".concat(promptbook.promptbookUrl, "\" is already in the library\n\n                        Note: Promptbooks with the same URL are not allowed\n                        Note: Automatically check whether the promptbooks are the same BUT they are DIFFERENT\n\n                    ")));
+                    }
+                    this.library.set(promptbook.promptbookUrl, promptbook);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (promptbooks_1_1 && !promptbooks_1_1.done && (_a = promptbooks_1.return)) _a.call(promptbooks_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        /**
+         * Gets all promptbooks in the library
+         */
+        SimplePromptbookLibrary.prototype.listPromptbooks = function () {
+            return Array.from(this.library.keys());
+        };
+        /**
+         * Gets promptbook by its URL
+         *
+         * Note: This is not a direct fetching from the URL, but a lookup in the library
+         */
+        SimplePromptbookLibrary.prototype.getPromptbookByUrl = function (url) {
+            var _this = this;
+            var promptbook = this.library.get(url);
+            if (!promptbook) {
+                if (this.listPromptbooks().length === 0) {
+                    throw new PromptbookNotFoundError(spaceTrim.spaceTrim("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
+                }
+                throw new PromptbookNotFoundError(spaceTrim.spaceTrim(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPromptbooks()
+                    .map(function (promptbookUrl) { return "- ".concat(promptbookUrl); })
+                    .join('\n')), "\n\n                    "); }));
+            }
+            return promptbook;
+        };
+        /**
+         * Checks whether given prompt was defined in any promptbook in the library
+         */
+        SimplePromptbookLibrary.prototype.isResponsibleForPrompt = function (prompt) {
+            return true;
+        };
+        return SimplePromptbookLibrary;
+    }());
+
+    /**
+     * Creates PromptbookLibrary from array of PromptbookJson or PromptbookString
+     *
+     * Note: You can combine `PromptbookString` (`.ptbk.md`) with `PromptbookJson` BUT it is not recommended
+     * Note: During the construction syntax and logic of all sources are validated
+     *
+     * @param promptbookSources
+     * @returns PromptbookLibrary
+     */
+    function createPromptbookLibraryFromSources() {
+        var promptbookSources = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            promptbookSources[_i] = arguments[_i];
+        }
+        return __awaiter(this, void 0, void 0, function () {
+            var promptbooks, promptbookSources_1, promptbookSources_1_1, source, promptbook, e_1_1;
+            var e_1, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        promptbooks = new Array();
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 8, 9, 10]);
+                        promptbookSources_1 = __values(promptbookSources), promptbookSources_1_1 = promptbookSources_1.next();
+                        _b.label = 2;
+                    case 2:
+                        if (!!promptbookSources_1_1.done) return [3 /*break*/, 7];
+                        source = promptbookSources_1_1.value;
+                        promptbook = void 0;
+                        if (!(typeof source === 'string')) return [3 /*break*/, 4];
+                        return [4 /*yield*/, promptbookStringToJson(source)];
+                    case 3:
+                        // Note: When directly creating from string, no need to validate the source
+                        //       The validation is performed always before execution
+                        promptbook = _b.sent();
+                        return [3 /*break*/, 5];
+                    case 4:
+                        promptbook = source;
+                        _b.label = 5;
+                    case 5:
+                        promptbooks.push(promptbook);
+                        _b.label = 6;
+                    case 6:
+                        promptbookSources_1_1 = promptbookSources_1.next();
+                        return [3 /*break*/, 2];
+                    case 7: return [3 /*break*/, 10];
+                    case 8:
+                        e_1_1 = _b.sent();
+                        e_1 = { error: e_1_1 };
+                        return [3 /*break*/, 10];
+                    case 9:
+                        try {
+                            if (promptbookSources_1_1 && !promptbookSources_1_1.done && (_a = promptbookSources_1.return)) _a.call(promptbookSources_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                        return [7 /*endfinally*/];
+                    case 10: return [2 /*return*/, new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))()];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+     */
+
+    /* tslint:disable */
+    function normalizeToKebabCase(sentence) {
+        var e_1, _a;
+        sentence = removeDiacritics(sentence);
+        var charType;
+        var lastCharType = 'OTHER';
+        var normalizedName = '';
+        try {
+            for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
+                var char = sentence_1_1.value;
+                var normalizedChar = void 0;
+                if (/^[a-z]$/.test(char)) {
+                    charType = 'LOWERCASE';
+                    normalizedChar = char;
+                }
+                else if (/^[A-Z]$/.test(char)) {
+                    charType = 'UPPERCASE';
+                    normalizedChar = char.toLowerCase();
+                }
+                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 (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        normalizedName = normalizedName.split(/-+/g).join('-');
+        normalizedName = normalizedName.split(/-?\/-?/g).join('/');
+        normalizedName = normalizedName.replace(/^-/, '');
+        normalizedName = normalizedName.replace(/-$/, '');
+        return normalizedName;
+    }
+
+    function prepareKnowledgeFromMarkdown(options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var content, llmTools, _a, isVerbose, library, promptbook, executor, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        content = options.content, llmTools = options.llmTools, _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
+                        return [4 /*yield*/, createPromptbookLibraryFromSources.apply(void 0, __spreadArray([], __read(promptbookLibrary), false))];
+                    case 1:
+                        library = _b.sent();
+                        promptbook = library.getPromptbookByUrl('https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md');
+                        executor = createPromptbookExecutor({
+                            promptbook: promptbook,
+                            tools: {
+                                llm: llmTools,
+                                script: [
+                                /* <- TODO: Allow to just keep script undefined */
+                                ],
+                            },
+                        });
+                        return [4 /*yield*/, executor({ content: content })];
+                    case 2:
+                        result = _b.sent();
+                        assertsExecutionSuccessful(result);
+                        outputParameters = result.outputParameters;
+                        knowledgeRaw = outputParameters.knowledge;
+                        knowledgeTextPieces = (knowledgeRaw || '').split('\n---\n');
+                        if (isVerbose) {
+                            console.info('knowledgeTextPieces:', knowledgeTextPieces);
+                        }
+                        return [4 /*yield*/, Promise.all(knowledgeTextPieces.map(function (knowledgeTextPiece, i) { return __awaiter(_this, void 0, void 0, function () {
+                                var name, title, content, keywords, index, sources;
+                                return __generator(this, function (_a) {
+                                    name = "piece-".concat(i);
+                                    title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 100));
+                                    content = spaceTrim__default["default"](knowledgeTextPiece);
+                                    keywords = [];
+                                    index = [];
+                                    sources = [];
+                                    try {
+                                        // TODO: !!!! Summarize name and title from the content
+                                        title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 30));
+                                        name = normalizeToKebabCase(title);
+                                        // TODO: !!!! Extract keywords via prompt
+                                        // TODO: !!!! Index through LLM model
+                                        // TODO: [🖖] !!!! Make system for sources and identification of sources
+                                    }
+                                    catch (error) {
+                                        console.error(error);
+                                    }
+                                    return [2 /*return*/, {
+                                            name: name,
+                                            title: title,
+                                            content: content,
+                                            keywords: keywords,
+                                            index: index,
+                                            sources: sources,
+                                        }];
+                                });
+                            }); }))];
+                    case 3:
+                        knowledge = _b.sent();
+                        return [2 /*return*/, knowledge];
+                }
+            });
+        });
+    }
+
+    /**
+     * Supported script languages
+     */
+    var SUPPORTED_SCRIPT_LANGUAGES = ['javascript', 'typescript', 'python'];
+
+    /**
+     * Computes the deepness of the markdown structure.
+     *
+     * @private within the library
+     */
+    function countMarkdownStructureDeepness(markdownStructure) {
+        var e_1, _a;
+        var maxDeepness = 0;
+        try {
+            for (var _b = __values(markdownStructure.sections), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var section = _c.value;
+                maxDeepness = Math.max(maxDeepness, countMarkdownStructureDeepness(section));
+            }
+        }
+        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; }
+        }
+        return maxDeepness + 1;
+    }
+
+    /**
+     * Parse a markdown string into a MarkdownStructure object.
+     *
+     * Note: This function does work with code blocks
+     * Note: This function does not work with markdown comments
+     *
+     * @param markdown The markdown string to parse.
+     * @returns The MarkdownStructure object.
+     *
+     * @private within the library
+     */
+    function markdownToMarkdownStructure(markdown) {
+        var e_1, _a;
+        var lines = markdown.split('\n');
+        var root = { level: 0, title: '', contentLines: [], sections: [], parent: null };
+        var current = root;
+        var isInsideCodeBlock = false;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                var headingMatch = line.match(/^(?<mark>#{1,6})\s(?<title>.*)/);
+                if (isInsideCodeBlock || !headingMatch) {
+                    if (line.startsWith('```')) {
+                        isInsideCodeBlock = !isInsideCodeBlock;
+                    }
+                    current.contentLines.push(line);
+                }
+                else {
+                    var level = headingMatch.groups.mark.length;
+                    var title = headingMatch.groups.title.trim();
+                    var parent_1 = void 0;
+                    if (level > current.level) {
+                        // Note: Going deeper (next section is child of current)
+                        parent_1 = current;
+                    }
+                    else {
+                        // Note: Going up or staying at the same level (next section is sibling or parent or grandparent,... of current)
+                        parent_1 = current;
+                        var loopLimit = LOOP_LIMIT;
+                        while (parent_1.level !== level - 1) {
+                            if (loopLimit-- < 0) {
+                                throw new UnexpectedError('Loop limit reached during parsing of markdown structure in `markdownToMarkdownStructure`');
+                            }
+                            if (parent_1.parent === null /* <- Note: We are in root */) {
+                                // [🌻]
+                                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;
+                        }
+                    }
+                    var section = { level: level, title: title, contentLines: [], sections: [], parent: parent_1 };
+                    parent_1.sections.push(section);
+                    current = section;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (root.sections.length === 1) {
+            var markdownStructure = parsingMarkdownStructureToMarkdownStructure(root.sections[0]);
+            return markdownStructure;
+        }
+        // [🌻]
+        throw new Error('The markdown file must have exactly one top-level section.');
+        // return root;
+    }
+    /**
+     * @private
+     */
+    function parsingMarkdownStructureToMarkdownStructure(parsingMarkdownStructure) {
+        var level = parsingMarkdownStructure.level, title = parsingMarkdownStructure.title, contentLines = parsingMarkdownStructure.contentLines, sections = parsingMarkdownStructure.sections;
+        return {
+            level: level,
+            title: title,
+            content: spaceTrim.spaceTrim(contentLines.join('\n')),
+            sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
+        };
+    }
+
+    /**
+     * Utility function to extract all list items from markdown
+     *
+     * Note: It works with both ul and ol
+     * Note: It omits list items in code blocks
+     * Note: It flattens nested lists
+     * Note: It can not work with html syntax and comments
+     *
+     * @param markdown any valid markdown
+     * @returns
+     */
+    function extractAllListItemsFromMarkdown(markdown) {
+        var e_1, _a;
+        var lines = markdown.split('\n');
+        var listItems = [];
+        var isInCodeBlock = false;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                var trimmedLine = line.trim();
+                if (trimmedLine.startsWith('```')) {
+                    isInCodeBlock = !isInCodeBlock;
+                }
+                if (!isInCodeBlock && (trimmedLine.startsWith('-') || trimmedLine.match(/^\d+\./))) {
+                    var listItem = trimmedLine.replace(/^-|\d+\./, '').trim();
+                    listItems.push(listItem);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return listItems;
+    }
+
+    /**
+     * Extracts all code blocks from markdown.
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code blocks with language and content
+     *
+     */
+    function extractAllBlocksFromMarkdown(markdown) {
+        var e_1, _a;
+        var codeBlocks = [];
+        var lines = markdown.split('\n');
+        var currentCodeBlock = null;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                if (line.startsWith('```')) {
+                    var language = line.slice(3).trim() || null;
+                    if (currentCodeBlock === null) {
+                        currentCodeBlock = { language: language, content: '' };
+                    }
+                    else {
+                        if (language !== null) {
+                            // [🌻]
+                            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+                        }
+                        codeBlocks.push(currentCodeBlock);
+                        currentCodeBlock = null;
+                    }
+                }
+                else if (currentCodeBlock !== null) {
+                    if (currentCodeBlock.content !== '') {
+                        currentCodeBlock.content += '\n';
+                    }
+                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (currentCodeBlock !== null) {
+            // [🌻]
+            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
+        }
+        return codeBlocks;
+    }
+
+    /**
+     * Extracts exactly ONE code block from markdown.
+     *
+     * Note: If there are multiple or no code blocks the function throws an error
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code block with language and content
+     */
+    function extractOneBlockFromMarkdown(markdown) {
+        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
+        if (codeBlocks.length !== 1) {
+            // TODO: Report more specific place where the error happened
+            throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
+        }
+        return codeBlocks[0];
+    }
+    /***
+     * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+     */
+
+    /**
+     * Removes HTML or Markdown comments from a string.
+     *
+     * @param {string} content - The string to remove comments from.
+     * @returns {string} The input string with all comments removed.
+     */
+    function removeContentComments(content) {
+        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+    }
+
+    /**
+     * Creates a new set with all elements that are present in either set
+     */
+    function union() {
+        var e_1, _a, e_2, _b;
+        var sets = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            sets[_i] = arguments[_i];
+        }
+        var union = new Set();
+        try {
+            for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
+                var set = sets_1_1.value;
+                try {
+                    for (var _c = (e_2 = void 0, __values(Array.from(set))), _d = _c.next(); !_d.done; _d = _c.next()) {
+                        var item = _d.value;
+                        union.add(item);
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return union;
+    }
+
+    /**
+     * Parses the template and returns the list of all parameter names
+     *
+     * @param template the template with parameters in {curly} braces
+     * @returns the list of parameter names
+     */
+    function extractParameters(template) {
+        var e_1, _a;
+        var matches = template.matchAll(/{\w+}/g);
+        var parameterNames = new Set();
+        try {
+            for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
+                var match = matches_1_1.value;
+                var parameterName = match[0].slice(1, -1);
+                parameterNames.add(parameterName);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return parameterNames;
+    }
+
+    /**
+     * Parses the given script and returns the list of all used variables that are not defined in the script
+     *
+     * @param script from which to extract the variables
+     * @returns the list of variable names
+     * @throws {PromptbookSyntaxError} if the script is invalid
+     */
+    function extractVariables(script) {
+        var variables = new Set();
+        script = "(()=>{".concat(script, "})()");
+        try {
+            for (var i = 0; i < 100 /* <- TODO: This limit to configuration */; i++)
+                try {
+                    eval(script);
+                }
+                catch (error) {
+                    if (!(error instanceof ReferenceError)) {
+                        throw error;
+                    }
+                    var undefinedName = error.message.split(' ')[0];
+                    /*
+                    Note: Remapping error
+                          From: [ReferenceError: thing is not defined],
+                          To:   [Error: Parameter {thing} is not defined],
+                    */
+                    if (!undefinedName) {
+                        throw error;
+                    }
+                    if (script.includes(undefinedName + '(')) {
+                        script = "const ".concat(undefinedName, " = ()=>'';") + script;
+                    }
+                    else {
+                        variables.add(undefinedName);
+                        script = "const ".concat(undefinedName, " = '';") + script;
+                    }
+                }
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            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;
+    }
+    /**
+     * TODO: [🔣] Support for multiple languages - python, java,...
+     */
+
+    /**
+     * Parses the prompt template and returns the set of all used parameters
+     *
+     * @param promptTemplate the template with used parameters
+     * @returns the set of parameter names
+     * @throws {PromptbookSyntaxError} if the script is invalid
+     */
+    function extractParametersFromPromptTemplate(promptTemplate) {
+        var e_1, _a, e_2, _b;
+        var parameterNames = new Set();
+        try {
+            for (var _c = __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(promptTemplate.title)), false), __read(extractParameters(promptTemplate.description || '')), false), __read(extractParameters(promptTemplate.content)), false)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var parameterName = _d.value;
+                parameterNames.add(parameterName);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        if (promptTemplate.executionType === 'SCRIPT') {
+            try {
+                for (var _e = __values(extractVariables(promptTemplate.content)), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    var parameterName = _f.value;
+                    parameterNames.add(parameterName);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+        return parameterNames;
+    }
+    /**
+     * TODO: [🔣] If script require contentLanguage
+     */
+
+    /* tslint:disable */
+    /*
+    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');
+    */
+    function normalizeTo_SCREAMING_CASE(sentence) {
+        var e_1, _a;
+        var charType;
+        var lastCharType = 'OTHER';
+        var normalizedName = '';
+        try {
+            for (var sentence_1 = __values(sentence), sentence_1_1 = sentence_1.next(); !sentence_1_1.done; sentence_1_1 = sentence_1.next()) {
+                var char = sentence_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 (sentence_1_1 && !sentence_1_1.done && (_a = sentence_1.return)) _a.call(sentence_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: [🌺] Use some intermediate util splitWords
+     */
+
+    /**
+     * Execution type describes the way how the block is executed
+     *
+     * @see https://github.com/webgptorg/promptbook#execution-type
+     */
+    var ExecutionTypes = [
+        'PROMPT_TEMPLATE',
+        'SIMPLE_TEMPLATE',
+        'SCRIPT',
+        'PROMPT_DIALOG',
+        // <- [🥻] Insert here when making new command
+    ];
+
+    /**
+     * Units of text measurement
+     */
+    var EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
+    /**
+     * TODO: [💝] Unite object for expecting amount and format - remove expectFormat
+     * TODO: use one helper type> (string_prompt | string_javascript | string_markdown) & string_template
+     * TODO: [👙][🧠] Just selecting gpt3 or gpt4 level of model
+     */
+
+    /**
+     * Removes Markdown formatting tags from a string.
+     *
+     * @param {string} str - The string to remove Markdown tags from.
+     * @returns {string} The input string with all Markdown tags removed.
+     */
+    function removeMarkdownFormatting(str) {
+        // Remove bold formatting
+        str = str.replace(/\*\*(.*?)\*\*/g, '$1');
+        // Remove italic formatting
+        str = str.replace(/\*(.*?)\*/g, '$1');
+        // Remove code formatting
+        str = str.replace(/`(.*?)`/g, '$1');
+        return str;
+    }
+
+    /**
+     * Function parseNumber will parse number from string
+     *
+     * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
+     * Note: it also works only with decimal numbers
+     *
+     * @returns parsed number
+     * @throws {PromptbookSyntaxError} if the value is not a number
+     *
+     * @private within the parseCommand
+     */
+    function parseNumber(value) {
+        var originalValue = value;
+        if (typeof value === 'number') {
+            value = value.toString(); // <- TODO: Maybe more efficient way to do this
+        }
+        if (typeof value !== 'string') {
+            return 0;
+        }
+        value = value.trim();
+        if (value.startsWith('+')) {
+            return parseNumber(value.substring(1));
+        }
+        if (value.startsWith('-')) {
+            var number = parseNumber(value.substring(1));
+            if (number === 0) {
+                return 0; // <- Note: To prevent -0
+            }
+            return -number;
+        }
+        value = value.replace(/,/g, '.');
+        value = value.toUpperCase();
+        if (value === '') {
+            return 0;
+        }
+        if (value === '♾' || value.startsWith('INF')) {
+            return Infinity;
+        }
+        if (value.includes('/')) {
+            var _a = __read(value.split('/'), 2), numerator_ = _a[0], denominator_ = _a[1];
+            var numerator = parseNumber(numerator_);
+            var denominator = parseNumber(denominator_);
+            if (denominator === 0) {
+                throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\" because denominator is zero"));
+            }
+            return numerator / denominator;
+        }
+        if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
+            return 0;
+        }
+        if (value.includes('E')) {
+            var _b = __read(value.split('E'), 2), significand = _b[0], exponent = _b[1];
+            return parseNumber(significand) * Math.pow(10, parseNumber(exponent));
+        }
+        if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
+            throw new PromptbookSyntaxError("Unable to parse number from \"".concat(originalValue, "\""));
+        }
+        var num = parseFloat(value);
+        if (isNaN(num)) {
+            throw new PromptbookSyntaxError("Unexpected NaN when parsing number from \"".concat(originalValue, "\""));
+        }
+        return num;
+    }
+    /**
+     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+     */
+
+    /**
+     * Parses one line of ul/ol to command
+     *
+     * @returns parsed command object
+     * @throws {PromptbookSyntaxError} if the command is invalid
+     *
+     * @private within the promptbookStringToJson
+     */
+    function parseCommand(listItem) {
+        var e_1, _a;
+        if (listItem.includes('\n') || listItem.includes('\r')) {
+            throw new PromptbookSyntaxError('Command can not contain new line characters:');
+        }
+        var type = listItem.trim();
+        type = type.split('`').join('');
+        type = type.split('"').join('');
+        type = type.split("'").join('');
+        type = type.split('~').join('');
+        type = type.split('[').join('');
+        type = type.split(']').join('');
+        type = type.split('(').join('');
+        type = type.split(')').join('');
+        type = normalizeTo_SCREAMING_CASE(type);
+        type = type.split('DIALOGUE').join('DIALOG');
+        var listItemParts = listItem
+            .split(' ')
+            .map(function (part) { return part.trim(); })
+            .filter(function (item) { return item !== ''; })
+            .filter(function (item) { return !/^PTBK$/i.test(item); })
+            .filter(function (item) { return !/^PROMPTBOOK$/i.test(item); })
+            .map(removeMarkdownFormatting);
+        if (type.startsWith('URL') ||
+            type.startsWith('PTBK_URL') ||
+            type.startsWith('PTBKURL') ||
+            type.startsWith('PROMPTBOOK_URL') ||
+            type.startsWith('PROMPTBOOKURL') ||
+            type.startsWith('HTTPS')) {
+            if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
+                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.spaceTrim("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+            }
+            if (promptbookUrl.hash !== '') {
+                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',
+                promptbookUrl: promptbookUrl,
+            };
+        }
+        else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
+            if (listItemParts.length !== 2) {
+                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
+            }
+            var promptbookVersion = listItemParts.pop();
+            // TODO: Validate version
+            return {
+                type: 'PROMPTBOOK_VERSION',
+                promptbookVersion: promptbookVersion,
+            };
+        }
+        else if (type.startsWith('EXECUTE') ||
+            type.startsWith('EXEC') ||
+            type.startsWith('PROMPT_DIALOG') ||
+            type.startsWith('SIMPLE_TEMPLATE')) {
+            var executionTypes = ExecutionTypes.filter(function (executionType) { return type.includes(executionType); });
+            if (executionTypes.length !== 1) {
+                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',
+                executionType: executionTypes[0],
+            };
+        }
+        else if (type.startsWith('MODEL')) {
+            // TODO: Make this more elegant and dynamically
+            if (type.startsWith('MODEL_VARIANT')) {
+                if (type === 'MODEL_VARIANT_CHAT') {
+                    return {
+                        type: 'MODEL',
+                        key: 'modelVariant',
+                        value: 'CHAT',
+                    };
+                }
+                else if (type === 'MODEL_VARIANT_COMPLETION') {
+                    return {
+                        type: 'MODEL',
+                        key: 'modelVariant',
+                        value: 'COMPLETION',
+                    };
+                }
+                else {
+                    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')) {
+                return {
+                    type: 'MODEL',
+                    key: 'modelName',
+                    value: listItemParts.pop(),
+                };
+            }
+            else {
+                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') ||
+            type.startsWith('INPUT_PARAM') ||
+            type.startsWith('OUTPUT_PARAM') ||
+            listItem.startsWith('{') ||
+            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.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.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');
+            if (listItem.startsWith('> {')) {
+                isInput = false;
+                isOutput = false;
+            }
+            return {
+                type: 'PARAMETER',
+                parameterName: parameterName,
+                parameterDescription: parameterDescription.trim() || null,
+                isInput: isInput,
+                isOutput: isOutput,
+            };
+        }
+        else if (type.startsWith('JOKER')) {
+            if (listItemParts.length !== 2) {
+                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.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;
+            return {
+                type: 'JOKER',
+                parameterName: parameterName,
+            };
+        }
+        else if (type.startsWith('POSTPROCESS') || type.startsWith('POST_PROCESS')) {
+            if (listItemParts.length !== 2) {
+                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
+            }
+            var functionName = listItemParts.pop();
+            return {
+                type: 'POSTPROCESS',
+                functionName: functionName,
+            };
+        }
+        else if (type.startsWith('EXPECT_JSON')) {
+            return {
+                type: 'EXPECT_FORMAT',
+                format: 'JSON',
+            };
+            // [🥤]
+        }
+        else if (type.startsWith('EXPECT')) {
+            try {
+                listItemParts.shift();
+                var sign = void 0;
+                var signRaw = listItemParts.shift();
+                if (/^exact/i.test(signRaw)) {
+                    sign = 'EXACTLY';
+                }
+                else if (/^min/i.test(signRaw)) {
+                    sign = 'MINIMUM';
+                }
+                else if (/^max/i.test(signRaw)) {
+                    sign = 'MAXIMUM';
+                }
+                else {
+                    throw new PromptbookSyntaxError("Invalid sign \"".concat(signRaw, "\", expected EXACTLY, MIN or MAX"));
+                }
+                var amountRaw = listItemParts.shift();
+                var amount = parseNumber(amountRaw);
+                if (amount < 0) {
+                    throw new PromptbookSyntaxError('Amount must be positive number or zero');
+                }
+                if (amount !== Math.floor(amount)) {
+                    throw new PromptbookSyntaxError('Amount must be whole number');
+                }
+                var unitRaw = listItemParts.shift();
+                var unit = undefined;
+                try {
+                    for (var EXPECTATION_UNITS_1 = __values(EXPECTATION_UNITS), EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next(); !EXPECTATION_UNITS_1_1.done; EXPECTATION_UNITS_1_1 = EXPECTATION_UNITS_1.next()) {
+                        var existingUnit = EXPECTATION_UNITS_1_1.value;
+                        var existingUnitText = existingUnit;
+                        existingUnitText = existingUnitText.substring(0, existingUnitText.length - 1);
+                        if (existingUnitText === 'CHARACTER') {
+                            existingUnitText = 'CHAR';
+                        }
+                        if (new RegExp("^".concat(existingUnitText.toLowerCase())).test(unitRaw.toLowerCase()) ||
+                            new RegExp("^".concat(unitRaw.toLowerCase())).test(existingUnitText.toLowerCase())) {
+                            if (unit !== undefined) {
+                                throw new PromptbookSyntaxError("Ambiguous unit \"".concat(unitRaw, "\""));
+                            }
+                            unit = existingUnit;
+                        }
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (EXPECTATION_UNITS_1_1 && !EXPECTATION_UNITS_1_1.done && (_a = EXPECTATION_UNITS_1.return)) _a.call(EXPECTATION_UNITS_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+                if (unit === undefined) {
+                    throw new PromptbookSyntaxError("Invalid unit \"".concat(unitRaw, "\""));
+                }
+                return {
+                    type: 'EXPECT_AMOUNT',
+                    sign: sign,
+                    unit: unit,
+                    amount: amount,
+                };
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+            }
+            /*
+        } else if (type.startsWith('__________________')) {
+            // <- [🥻] Insert here when making new command
+        */
+        }
+        else {
+            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                ")));
+        }
+    }
+
+    /**
+     * 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;
+    }
+
+    /**
+     * Function normalizes title to name which can be used as identifier
+     */
+    function titleToName(value) {
+        value = removeEmojis(value);
+        value = normalizeToKebabCase(value);
+        // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
+        return value;
+    }
+
+    /**
+     * Compile promptbook from string (markdown) format to JSON format
+     *
+     * @param promptbookString {Promptbook} in string markdown format (.ptbk.md)
+     * @param options - Options and tools for the compilation
+     * @returns {Promptbook} compiled in JSON format (.ptbk.json)
+     * @throws {PromptbookSyntaxError} if the promptbook string is not valid
+     *
+     * Note: This function does not validate logic of the pipeline only the syntax
+     * Note: This function acts as compilation process
+     */
+    function promptbookStringToJson(promptbookString, options) {
+        if (options === void 0) { options = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var llmTools, promptbookJson, knowledge, addParam, markdownStructure, markdownStructureDeepness, description, defaultModelRequirements, listItems, listItems_1, listItems_1_1, listItem, command, _loop_1, _a, _b, section;
+            var e_1, _c, e_2, _d;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        llmTools = options.llmTools;
+                        promptbookJson = {
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
+                            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
+                            promptbookVersion: PROMPTBOOK_VERSION,
+                            description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
+                            parameters: [],
+                            promptTemplates: [],
+                            knowledge: [],
+                        };
+                        if (!llmTools) return [3 /*break*/, 2];
+                        return [4 /*yield*/, prepareKnowledgeFromMarkdown({
+                                content: 'Roses are red, violets are blue, programmers use Promptbook, users too',
+                                llmTools: llmTools,
+                            })];
+                    case 1:
+                        knowledge = _e.sent();
+                        console.info('!!!! knowledge', knowledge);
+                        _e.label = 2;
+                    case 2:
+                        // =============================================================
+                        // Note: 1️⃣ Normalization of the PROMPTBOOK string
+                        promptbookString = removeContentComments(promptbookString);
+                        promptbookString = promptbookString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
+                        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
+                        addParam = function (parameterCommand) {
+                            var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInput = parameterCommand.isInput, isOutput = parameterCommand.isOutput;
+                            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+                            if (existingParameter &&
+                                existingParameter.description &&
+                                existingParameter.description !== parameterDescription &&
+                                parameterDescription) {
+                                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) {
+                                    existingParameter.description = parameterDescription;
+                                }
+                            }
+                            else {
+                                promptbookJson.parameters.push({
+                                    name: parameterName,
+                                    description: parameterDescription || undefined,
+                                    isInput: isInput,
+                                    isOutput: isOutput,
+                                });
+                            }
+                        };
+                        markdownStructure = markdownToMarkdownStructure(promptbookString);
+                        markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
+                        if (markdownStructureDeepness !== 2) {
+                            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;
+                        description = markdownStructure.content;
+                        // Note: Remove codeblocks
+                        description = description.split(/^```.*^```/gms).join('');
+                        //Note: Remove lists and return statement
+                        description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+                        description = spaceTrim.spaceTrim(description);
+                        if (description === '') {
+                            description = undefined;
+                        }
+                        promptbookJson.description = description;
+                        defaultModelRequirements = {};
+                        listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
+                        try {
+                            for (listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
+                                listItem = listItems_1_1.value;
+                                command = parseCommand(listItem);
+                                switch (command.type) {
+                                    case 'PROMPTBOOK_URL':
+                                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
+                                        break;
+                                    case 'PROMPTBOOK_VERSION':
+                                        promptbookJson.promptbookVersion = command.promptbookVersion;
+                                        break;
+                                    case 'MODEL':
+                                        defaultModelRequirements[command.key] = command.value;
+                                        break;
+                                    case 'PARAMETER':
+                                        addParam(command);
+                                        break;
+                                    default:
+                                        throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
+                                }
+                            }
+                        }
+                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                        finally {
+                            try {
+                                if (listItems_1_1 && !listItems_1_1.done && (_c = listItems_1.return)) _c.call(listItems_1);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                        }
+                        _loop_1 = function (section) {
+                            var e_3, _f;
+                            // TODO: Parse prompt template description (the content out of the codeblock and lists)
+                            var templateModelRequirements = __assign({}, defaultModelRequirements);
+                            var listItems_3 = extractAllListItemsFromMarkdown(section.content);
+                            var dependentParameterNames = new Set();
+                            var executionType = 'PROMPT_TEMPLATE';
+                            var jokers = [];
+                            var postprocessing = [];
+                            var expectAmount = {};
+                            var expectFormat = undefined;
+                            var isExecutionTypeChanged = false;
+                            try {
+                                for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
+                                    var listItem = listItems_2_1.value;
+                                    var command = parseCommand(listItem);
+                                    switch (command.type) {
+                                        case 'JOKER':
+                                            jokers.push(command.parameterName);
+                                            dependentParameterNames.add(command.parameterName);
+                                            break;
+                                        case 'EXECUTE':
+                                            if (isExecutionTypeChanged) {
+                                                throw new PromptbookSyntaxError('Execution type is already defined in the prompt template. It can be defined only once.');
+                                            }
+                                            executionType = command.executionType;
+                                            isExecutionTypeChanged = true;
+                                            break;
+                                        case 'MODEL':
+                                            templateModelRequirements[command.key] = command.value;
+                                            break;
+                                        case 'PARAMETER':
+                                            // Note: This is just for detecting resulitng parameter name
+                                            addParam(command);
+                                            break;
+                                        case 'POSTPROCESS':
+                                            postprocessing.push(command.functionName);
+                                            break;
+                                        case 'EXPECT_AMOUNT':
+                                            // eslint-disable-next-line no-case-declarations
+                                            var unit = command.unit.toLowerCase();
+                                            expectAmount[unit] = expectAmount[unit] || {};
+                                            if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
+                                                if (expectAmount[unit].min !== undefined) {
+                                                    throw new PromptbookSyntaxError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                                }
+                                                expectAmount[unit].min = command.amount;
+                                            } /* not else */
+                                            if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
+                                                if (expectAmount[unit].max !== undefined) {
+                                                    throw new PromptbookSyntaxError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                                }
+                                                expectAmount[unit].max = command.amount;
+                                            }
+                                            break;
+                                        case 'EXPECT_FORMAT':
+                                            if (expectFormat !== undefined && command.format !== expectFormat) {
+                                                throw new PromptbookSyntaxError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
+                                            }
+                                            expectFormat = command.format;
+                                            break;
+                                        default:
+                                            throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
+                                    }
+                                }
+                            }
+                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                            finally {
+                                try {
+                                    if (listItems_2_1 && !listItems_2_1.done && (_f = listItems_2.return)) _f.call(listItems_2);
+                                }
+                                finally { if (e_3) throw e_3.error; }
+                            }
+                            var _g = extractOneBlockFromMarkdown(section.content), language = _g.language, content = _g.content;
+                            if (executionType === 'SCRIPT') {
+                                if (!language) {
+                                    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.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.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')
+                                    .map(function (line) { return "> ".concat(line); })
+                                    .join('\n')), "\n                        "); }));
+                            }
+                            var resultingParameterName = match.groups.resultingParamName;
+                            // TODO: [1] DRY description
+                            var description_1 = section.content;
+                            // Note: Remove codeblocks
+                            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.spaceTrim(description_1);
+                            if (description_1 === '') {
+                                description_1 = undefined;
+                            }
+                            if (Object.keys(jokers).length === 0) {
+                                jokers = undefined;
+                            }
+                            if (Object.keys(expectAmount).length === 0) {
+                                expectAmount = undefined;
+                            }
+                            if (Object.keys(postprocessing).length === 0) {
+                                postprocessing = undefined;
+                            }
+                            dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, executionType: executionType, content: content })));
+                            if (templateModelRequirements.modelVariant === undefined) {
+                                templateModelRequirements.modelVariant = 'CHAT';
+                            }
+                            promptbookJson.promptTemplates.push({
+                                name: titleToName(section.title),
+                                title: section.title,
+                                description: description_1,
+                                dependentParameterNames: Array.from(dependentParameterNames),
+                                executionType: executionType,
+                                jokers: jokers,
+                                postprocessing: postprocessing,
+                                expectations: expectAmount,
+                                expectFormat: expectFormat,
+                                modelRequirements: templateModelRequirements,
+                                contentLanguage: executionType === 'SCRIPT' ? language : undefined,
+                                content: content,
+                                resultingParameterName: resultingParameterName,
+                            });
+                        };
+                        try {
+                            for (_a = __values(markdownStructure.sections), _b = _a.next(); !_b.done; _b = _a.next()) {
+                                section = _b.value;
+                                _loop_1(section);
                             }
                         }
-                    }
-                    catch (e_6_1) { e_6 = { error: e_6_1 }; }
-                    finally {
-                        try {
-                            if (_m && !_m.done && (_f = _l.return)) _f.call(_l);
+                        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                        finally {
+                            try {
+                                if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
+                            }
+                            finally { if (e_2) throw e_2.error; }
                         }
-                        finally { if (e_6) throw e_6.error; }
-                    }
-                } /* not else */
-                if (expectFormat) {
-                    if (expectFormat === 'JSON') {
-                        // TODO: @deprecated remove
-                        commands_1.push("EXPECT JSON");
-                    }
-                } /* not else */
-                promptbookString += '\n\n';
-                promptbookString += commands_1.map(function (command) { return "- ".concat(command); }).join('\n');
-                promptbookString += '\n\n';
-                promptbookString += '```' + contentLanguage;
-                promptbookString += '\n';
-                promptbookString += spaceTrim__default["default"](content);
-                //                   <- TODO: !!! Escape
-                //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
-                promptbookString += '\n';
-                promptbookString += '```';
-                promptbookString += '\n\n';
-                promptbookString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: !!! If the parameter here has description, add it and use promptTemplateParameterJsonToString
-            }
-        }
-        catch (e_3_1) { e_3 = { error: e_3_1 }; }
-        finally {
-            try {
-                if (promptTemplates_1_1 && !promptTemplates_1_1.done && (_c = promptTemplates_1.return)) _c.call(promptTemplates_1);
-            }
-            finally { if (e_3) throw e_3.error; }
-        }
-        return promptbookString;
-    }
-    /**
-     * @private internal util of promptbookJsonToString
-     */
-    function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
-        var name = promptTemplateParameterJson.name, description = promptTemplateParameterJson.description;
-        var parameterString = "{".concat(name, "}");
-        if (description) {
-            parameterString = "".concat(parameterString, " ").concat(description);
-        }
-        return parameterString;
+                        // =============================================================
+                        return [2 /*return*/, promptbookJson];
+                }
+            });
+        });
     }
     /**
-     * TODO: Escape all
-     */
-
-    /**
-     * This error indicates that promptbook not found in the library
+     * TODO: Report here line/column of error
+     * TODO: Use spaceTrim more effectively
+     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
      */
-    var PromptbookNotFoundError = /** @class */ (function (_super) {
-        __extends(PromptbookNotFoundError, _super);
-        function PromptbookNotFoundError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PromptbookNotFoundError';
-            Object.setPrototypeOf(_this, PromptbookNotFoundError.prototype);
-            return _this;
-        }
-        return PromptbookNotFoundError;
-    }(Error));
 
     /**
-     * This error indicates errors in referencing promptbooks between each other
+     * This error indicates that the promptbook library cannot be propperly loaded
      */
-    var PromptbookReferenceError = /** @class */ (function (_super) {
-        __extends(PromptbookReferenceError, _super);
-        function PromptbookReferenceError(message) {
+    var PromptbookLibraryError = /** @class */ (function (_super) {
+        __extends(PromptbookLibraryError, _super);
+        function PromptbookLibraryError(message) {
             var _this = _super.call(this, message) || this;
-            _this.name = 'PromptbookReferenceError';
-            Object.setPrototypeOf(_this, PromptbookReferenceError.prototype);
+            _this.name = 'PromptbookLibraryError';
+            Object.setPrototypeOf(_this, PromptbookLibraryError.prototype);
             return _this;
         }
-        return PromptbookReferenceError;
+        return PromptbookLibraryError;
     }(Error));
 
     /**
-     * Library of promptbooks that groups together promptbooks for an application.
-     * This implementation is a very thin wrapper around the Array / Map of promptbooks.
-     *
-     * @see https://github.com/webgptorg/promptbook#promptbook-library
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
      */
-    var SimplePromptbookLibrary = /** @class */ (function () {
-        /**
-         * Constructs a promptbook library from promptbooks
-         *
-         * @param promptbooks !!!
-         *
-         * Note: During the construction logic of all promptbooks are validated
-         * Note: It is not recommended to use this constructor directly, use `createPromptbookLibraryFromSources` *(or other variant)* instead
-         */
-        function SimplePromptbookLibrary() {
-            var e_1, _a;
-            var promptbooks = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                promptbooks[_i] = arguments[_i];
-            }
-            this.library = new Map();
-            try {
-                for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
-                    var promptbook = promptbooks_1_1.value;
-                    if (promptbook.promptbookUrl === undefined) {
-                        throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the promptbook library\n\n                    ")));
-                    }
-                    validatePromptbookJson(promptbook);
-                    // Note: [🦄]
-                    if (this.library.has(promptbook.promptbookUrl) &&
-                        promptbookJsonToString(promptbook) !==
-                            promptbookJsonToString(this.library.get(promptbook.promptbookUrl))) {
-                        throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with URL \"".concat(promptbook.promptbookUrl, "\" is already in the library\n\n                        Note: Promptbooks with the same URL are not allowed\n                        Note: Automatically check whether the promptbooks are the same BUT they are DIFFERENT\n\n                    ")));
-                    }
-                    this.library.set(promptbook.promptbookUrl, promptbook);
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (promptbooks_1_1 && !promptbooks_1_1.done && (_a = promptbooks_1.return)) _a.call(promptbooks_1);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-        }
-        /**
-         * Gets all promptbooks in the library
-         */
-        SimplePromptbookLibrary.prototype.listPromptbooks = function () {
-            return Array.from(this.library.keys());
-        };
-        /**
-         * Gets promptbook by its URL
-         *
-         * Note: This is not a direct fetching from the URL, but a lookup in the library
-         */
-        SimplePromptbookLibrary.prototype.getPromptbookByUrl = function (url) {
-            var _this = this;
-            var promptbook = this.library.get(url);
-            if (!promptbook) {
-                if (this.listPromptbooks().length === 0) {
-                    throw new PromptbookNotFoundError(spaceTrim.spaceTrim("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
-                }
-                throw new PromptbookNotFoundError(spaceTrim.spaceTrim(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPromptbooks()
-                    .map(function (promptbookUrl) { return "- ".concat(promptbookUrl); })
-                    .join('\n')), "\n\n                    "); }));
-            }
-            return promptbook;
-        };
-        /**
-         * Checks whether given prompt was defined in any promptbook in the library
-         */
-        SimplePromptbookLibrary.prototype.isResponsibleForPrompt = function (prompt) {
-            return true;
-        };
-        return SimplePromptbookLibrary;
-    }());
-
+    new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * Creates PromptbookLibrary from array of PromptbookJson or PromptbookString
-     *
-     * Note: You can combine `PromptbookString` (`.ptbk.md`) with `PromptbookJson` BUT it is not recommended
-     * Note: During the construction syntax and logic of all sources are validated
-     *
-     * @param promptbookSources
-     * @returns PromptbookLibrary
+     * Detects if the code is running in a Node.js environment
      */
-    function createPromptbookLibraryFromSources() {
-        var promptbookSources = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            promptbookSources[_i] = arguments[_i];
-        }
-        return __awaiter(this, void 0, void 0, function () {
-            var promptbooks, promptbookSources_1, promptbookSources_1_1, source, promptbook, e_1_1;
-            var e_1, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        promptbooks = new Array();
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 8, 9, 10]);
-                        promptbookSources_1 = __values(promptbookSources), promptbookSources_1_1 = promptbookSources_1.next();
-                        _b.label = 2;
-                    case 2:
-                        if (!!promptbookSources_1_1.done) return [3 /*break*/, 7];
-                        source = promptbookSources_1_1.value;
-                        promptbook = void 0;
-                        if (!(typeof source === 'string')) return [3 /*break*/, 4];
-                        return [4 /*yield*/, promptbookStringToJson(source)];
-                    case 3:
-                        // Note: When directly creating from string, no need to validate the source
-                        //       The validation is performed always before execution
-                        promptbook = _b.sent();
-                        return [3 /*break*/, 5];
-                    case 4:
-                        promptbook = source;
-                        _b.label = 5;
-                    case 5:
-                        promptbooks.push(promptbook);
-                        _b.label = 6;
-                    case 6:
-                        promptbookSources_1_1 = promptbookSources_1.next();
-                        return [3 /*break*/, 2];
-                    case 7: return [3 /*break*/, 10];
-                    case 8:
-                        e_1_1 = _b.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 10];
-                    case 9:
-                        try {
-                            if (promptbookSources_1_1 && !promptbookSources_1_1.done && (_a = promptbookSources_1.return)) _a.call(promptbookSources_1);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                        return [7 /*endfinally*/];
-                    case 10: return [2 /*return*/, new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))()];
-                }
-            });
-        });
-    }
+    var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+     * Detects if the code is running in a web worker
      */
+    new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
 
     /**
      * Constructs Promptbook from async sources