@promptbook/core 0.52.0-9 → 0.53.0

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('moment')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'moment'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.moment));
-})(this, (function (exports, spaceTrim, prettier, parserHtml, moment) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('path'), require('moment')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'path', 'moment'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.path, global.moment));
+})(this, (function (exports, spaceTrim, prettier, parserHtml, path, moment) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -454,7 +454,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.52.0-8';
+    var PROMPTBOOK_VERSION = '0.52.0';
 
     /**
      * Parses the template and returns the list of all parameter names
@@ -576,88 +576,108 @@
      * 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;
+    }
     /**
-     * Removes emojis from a string and fix whitespaces
+     * TODO: [🌺] Use some intermediate util splitWords
+     */
+
+    /**
+     * Execution type describes the way how the block is executed
      *
-     * @param text with emojis
-     * @returns text without emojis
+     * @see https://github.com/webgptorg/promptbook#execution-type
      */
-    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 ExecutionTypes = [
+        'PROMPT_TEMPLATE',
+        'SIMPLE_TEMPLATE',
+        'SCRIPT',
+        'PROMPT_DIALOG',
+        // <- [🥻] Insert here when making new command
+    ];
 
     /**
-     * Function normalizes title to name which can be used as identifier
+     * 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
      */
-    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;
-    }
 
     /**
-     * Creates a Mermaid graph based on the promptbook
+     * Removes Markdown formatting tags from a string.
      *
-     * Note: The result is not wrapped in a Markdown code block
+     * @param {string} str - The string to remove Markdown tags from.
+     * @returns {string} The input string with all Markdown tags removed.
      */
-    function renderPromptbookMermaid(promptbookJson, options) {
-        var _a = (options || {}).linkPromptTemplate, linkPromptTemplate = _a === void 0 ? function () { return null; } : _a;
-        var parameterNameToTemplateName = function (parameterName) {
-            var parameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
-            if (!parameter) {
-                throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
-            }
-            if (parameter.isInput) {
-                return 'input';
-            }
-            var template = promptbookJson.promptTemplates.find(function (template) { return template.resultingParameterName === parameterName; });
-            if (!template) {
-                throw new Error("Could not find template for {".concat(parameterName, "}"));
-            }
-            return normalizeTo_camelCase('template-' + titleToName(template.title));
-        };
-        var promptbookMermaid = spaceTrim.spaceTrim(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(promptbookJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(promptbookJson.promptTemplates
-            .flatMap(function (_a) {
-            var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
-            return __spreadArray([
-                "".concat(parameterNameToTemplateName(resultingParameterName), "(\"").concat(title, "\")")
-            ], __read(dependentParameterNames.map(function (dependentParameterName) {
-                return "".concat(parameterNameToTemplateName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTemplateName(resultingParameterName));
-            })), false);
-        })
-            .join('\n')), "\n\n                  ").concat(block(promptbookJson.parameters
-            .filter(function (_a) {
-            var isOutput = _a.isOutput;
-            return isOutput;
-        })
-            .map(function (_a) {
-            var name = _a.name;
-            return "".concat(parameterNameToTemplateName(name), "--\"{").concat(name, "}\"-->output");
-        })
-            .join('\n')), "\n                  output((Output)):::output\n\n                  ").concat(block(promptbookJson.promptTemplates
-            .map(function (promptTemplate) {
-            var link = linkPromptTemplate(promptTemplate);
-            if (link === null) {
-                return '';
-            }
-            var href = link.href, title = link.title;
-            var templateName = parameterNameToTemplateName(promptTemplate.resultingParameterName);
-            return "click ".concat(templateName, " href \"").concat(href, "\" \"").concat(title, "\";");
-        })
-            .filter(function (line) { return line !== ''; })
-            .join('\n')), "\n\n                  classDef input color: grey;\n                  classDef output color: grey;\n\n              end;\n\n        "); });
-        return promptbookMermaid;
+    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;
     }
-    /**
-     * TODO: Maybe use some Mermaid library instead of string templating
-     * TODO: [🕌] When more than 2 functionalities, split into separate functions
-     */
 
     /**
      * Function parseNumber will parse number from string
@@ -727,146 +747,249 @@
      */
 
     /**
-     * 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 occurs during the parameter replacement in the template
-     *
-     * Note: This is a kindof subtype of PromptbookExecutionError because it occurs during the execution of the pipeline
-     */
-    var TemplateError = /** @class */ (function (_super) {
-        __extends(TemplateError, _super);
-        function TemplateError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'TemplateError';
-            Object.setPrototypeOf(_this, TemplateError.prototype);
-            return _this;
-        }
-        return TemplateError;
-    }(Error));
-
-    /**
-     * Replaces parameters in template with values from parameters object
+     * Parses one line of ul/ol to command
      *
-     * @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
+     * @returns parsed command object
+     * @throws {PromptbookSyntaxError} if the command is invalid
      *
-     * @private within the createPromptbookExecutor
+     * @private within the promptbookStringToJson
      */
-    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";
+    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                    ")));
             }
-            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-                throw new TemplateError('Parameter is already opened or not closed');
+            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 (parameters[parameterName] === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            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                    ")));
             }
-            var parameterValue = parameters[parameterName];
-            if (parameterValue === undefined) {
-                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            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                    ")));
             }
-            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');
+            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                    "); }));
             }
-            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();
+            return {
+                type: 'EXECUTE',
+                executionType: executionTypes[0],
+            };
         }
-        // [💫] Check if there are parameters that are not closed properly
-        if (/{\w+$/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not closed');
+        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                    "); }));
+            }
         }
-        // [💫] Check if there are parameters that are not opened properly
-        if (/^\w+}/.test(replacedTemplate)) {
-            throw new TemplateError('Parameter is not opened');
+        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,
+            };
         }
-        return replacedTemplate;
-    }
-
-    /**
-     * Counts number of characters in the text
-     */
-    function countCharacters(text) {
-        // Remove null characters
-        text = text.replace(/\0/g, '');
-        // Replace emojis (and also ZWJ sequence) with hyphens
-        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-        text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
-        return text.length;
-    }
-
-    /**
-     * Counts number of lines in the text
-     */
-    function countLines(text) {
-        if (text === '') {
-            return 0;
+        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                ")));
         }
-        return text.split('\n').length;
-    }
-
-    /**
-     * Counts number of pages in the text
-     */
-    function countPages(text) {
-        var sentencesPerPage = 5; // Assuming each page has 5 sentences
-        var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-        var pageCount = Math.ceil(sentences.length / sentencesPerPage);
-        return pageCount;
-    }
-
-    /**
-     * Counts number of paragraphs in the text
-     */
-    function countParagraphs(text) {
-        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
-    }
-
-    /**
-     * Split text into sentences
-     */
-    function splitIntoSentences(text) {
-        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
-    }
-    /**
-     * Counts number of sentences in the text
-     */
-    function countSentences(text) {
-        return splitIntoSentences(text).length;
     }
 
     var defaultDiacriticsRemovalMap = [
@@ -1078,546 +1201,127 @@
         },
     ];
     /**
-     * Map of letters from diacritic variant to diacritless variant
-     * Contains lowercase and uppercase separatelly
-     *
-     * > "á" => "a"
-     * > "ě" => "e"
-     * > "Ă" => "A"
-     * > ...
-     */
-    var DIACRITIC_VARIANTS_LETTERS = {};
-    // tslint:disable-next-line: prefer-for-of
-    for (var i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
-        var letters = defaultDiacriticsRemovalMap[i].letters;
-        // tslint:disable-next-line: prefer-for-of
-        for (var j = 0; j < letters.length; j++) {
-            DIACRITIC_VARIANTS_LETTERS[letters[j]] = defaultDiacriticsRemovalMap[i].base;
-        }
-    }
-    // <- TODO: [🍓] Put to maker function to save execution time if not needed
-    /*
-      @see https://stackoverflow.com/questions/990904/remove-accents-diacritics-in-a-string-in-javascript
-       Licensed under the Apache License, Version 2.0 (the "License");
-       you may not use this file except in compliance with the License.
-       You may obtain a copy of the License at
-
-           http://www.apache.org/licenses/LICENSE-2.0
-
-       Unless required by applicable law or agreed to in writing, software
-       distributed under the License is distributed on an "AS IS" BASIS,
-       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-       See the License for the specific language governing permissions and
-       limitations under the License.
-    */
-
-    /**
-     *
-     */
-    function removeDiacritics(input) {
-        /*eslint no-control-regex: "off"*/
-        return input.replace(/[^\u0000-\u007E]/g, function (a) {
-            return DIACRITIC_VARIANTS_LETTERS[a] || a;
-        });
-    }
-
-    /**
-     * 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 isValidJsonString will tell you if the string is valid JSON or not
-     */
-    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;
-        }
-    }
-
-    /**
-     * 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;
-    }
-
-    /* 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
-     */
-
-    /* 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;
-    }
-
-    /* tslint:disable */
-    function normalizeTo_camelCase(sentence, __firstLetterCapital) {
-        var e_1, _a;
-        if (__firstLetterCapital === void 0) { __firstLetterCapital = false; }
-        var charType;
-        var lastCharType = null;
-        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 {
-                    charType = 'OTHER';
-                    normalizedChar = '';
-                }
-                if (!lastCharType) {
-                    if (__firstLetterCapital) {
-                        normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
-                    }
-                }
-                else if (charType !== lastCharType &&
-                    !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
-                    !(lastCharType === 'NUMBER') &&
-                    !(charType === 'NUMBER')) {
-                    normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
-                }
-                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; }
-        }
-        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
-     */
-
-    /**
-     * 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],
-            };
+     * Map of letters from diacritic variant to diacritless variant
+     * Contains lowercase and uppercase separatelly
+     *
+     * > "á" => "a"
+     * > "ě" => "e"
+     * > "Ă" => "A"
+     * > ...
+     */
+    var DIACRITIC_VARIANTS_LETTERS = {};
+    // tslint:disable-next-line: prefer-for-of
+    for (var i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
+        var letters = defaultDiacriticsRemovalMap[i].letters;
+        // tslint:disable-next-line: prefer-for-of
+        for (var j = 0; j < letters.length; j++) {
+            DIACRITIC_VARIANTS_LETTERS[letters[j]] = defaultDiacriticsRemovalMap[i].base;
         }
-        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                        "); }));
+    }
+    // <- TODO: [🍓] Put to maker function to save execution time if not needed
+    /*
+      @see https://stackoverflow.com/questions/990904/remove-accents-diacritics-in-a-string-in-javascript
+       Licensed under the Apache License, Version 2.0 (the "License");
+       you may not use this file except in compliance with the License.
+       You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing, software
+       distributed under the License is distributed on an "AS IS" BASIS,
+       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+       See the License for the specific language governing permissions and
+       limitations under the License.
+    */
+
+    /**
+     *
+     */
+    function removeDiacritics(input) {
+        /*eslint no-control-regex: "off"*/
+        return input.replace(/[^\u0000-\u007E]/g, function (a) {
+            return DIACRITIC_VARIANTS_LETTERS[a] || a;
+        });
+    }
+
+    /* 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;
                 }
-            }
-            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 (/^[A-Z]$/.test(char)) {
+                    charType = 'UPPERCASE';
+                    normalizedChar = char.toLowerCase();
                 }
-                else if (/^min/i.test(signRaw)) {
-                    sign = 'MINIMUM';
+                else if (/^[0-9]$/.test(char)) {
+                    charType = 'NUMBER';
+                    normalizedChar = char;
                 }
-                else if (/^max/i.test(signRaw)) {
-                    sign = 'MAXIMUM';
+                else if (/^\/$/.test(char)) {
+                    charType = 'SLASH';
+                    normalizedChar = char;
                 }
                 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, "\""));
+                    charType = 'OTHER';
+                    normalizedChar = '-';
                 }
-                return {
-                    type: 'EXPECT_AMOUNT',
-                    sign: sign,
-                    unit: unit,
-                    amount: amount,
-                };
-            }
-            catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
+                if (charType !== lastCharType &&
+                    !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+                    !(lastCharType === 'NUMBER') &&
+                    !(charType === 'NUMBER')) {
+                    normalizedName += '-';
                 }
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+                normalizedName += normalizedChar;
+                lastCharType = charType;
             }
-            /*
-        } 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                ")));
+        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;
+    }
+
+    /**
+     * 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;
     }
 
     /**
@@ -1831,6 +1535,9 @@
                 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,
@@ -1922,6 +1629,119 @@
         }
     }
 
+    /* tslint:disable */
+    function normalizeTo_camelCase(sentence, __firstLetterCapital) {
+        var e_1, _a;
+        if (__firstLetterCapital === void 0) { __firstLetterCapital = false; }
+        var charType;
+        var lastCharType = null;
+        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 {
+                    charType = 'OTHER';
+                    normalizedChar = '';
+                }
+                if (!lastCharType) {
+                    if (__firstLetterCapital) {
+                        normalizedChar = normalizedChar.toUpperCase(); //TODO: DRY
+                    }
+                }
+                else if (charType !== lastCharType &&
+                    !(charType === 'LOWERCASE' && lastCharType === 'UPPERCASE') &&
+                    !(lastCharType === 'NUMBER') &&
+                    !(charType === 'NUMBER')) {
+                    normalizedChar = normalizedChar.toUpperCase(); //TODO: [🌺] DRY
+                }
+                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; }
+        }
+        return normalizedName;
+    }
+    /**
+     * TODO: [🌺] Use some intermediate util splitWords
+     */
+
+    /**
+     * Creates a Mermaid graph based on the promptbook
+     *
+     * Note: The result is not wrapped in a Markdown code block
+     */
+    function renderPromptbookMermaid(promptbookJson, options) {
+        var _a = (options || {}).linkPromptTemplate, linkPromptTemplate = _a === void 0 ? function () { return null; } : _a;
+        var parameterNameToTemplateName = function (parameterName) {
+            var parameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+            if (!parameter) {
+                throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
+            }
+            if (parameter.isInput) {
+                return 'input';
+            }
+            var template = promptbookJson.promptTemplates.find(function (template) { return template.resultingParameterName === parameterName; });
+            if (!template) {
+                throw new Error("Could not find template for {".concat(parameterName, "}"));
+            }
+            return normalizeTo_camelCase('template-' + titleToName(template.title));
+        };
+        var promptbookMermaid = spaceTrim.spaceTrim(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(promptbookJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(promptbookJson.promptTemplates
+            .flatMap(function (_a) {
+            var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
+            return __spreadArray([
+                "".concat(parameterNameToTemplateName(resultingParameterName), "(\"").concat(title, "\")")
+            ], __read(dependentParameterNames.map(function (dependentParameterName) {
+                return "".concat(parameterNameToTemplateName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTemplateName(resultingParameterName));
+            })), false);
+        })
+            .join('\n')), "\n\n                  ").concat(block(promptbookJson.parameters
+            .filter(function (_a) {
+            var isOutput = _a.isOutput;
+            return isOutput;
+        })
+            .map(function (_a) {
+            var name = _a.name;
+            return "".concat(parameterNameToTemplateName(name), "--\"{").concat(name, "}\"-->output");
+        })
+            .join('\n')), "\n                  output((Output)):::output\n\n                  ").concat(block(promptbookJson.promptTemplates
+            .map(function (promptTemplate) {
+            var link = linkPromptTemplate(promptTemplate);
+            if (link === null) {
+                return '';
+            }
+            var href = link.href, title = link.title;
+            var templateName = parameterNameToTemplateName(promptTemplate.resultingParameterName);
+            return "click ".concat(templateName, " href \"").concat(href, "\" \"").concat(title, "\";");
+        })
+            .filter(function (line) { return line !== ''; })
+            .join('\n')), "\n\n                  classDef input color: grey;\n                  classDef output color: grey;\n\n              end;\n\n        "); });
+        return promptbookMermaid;
+    }
+    /**
+     * TODO: Maybe use some Mermaid library instead of string templating
+     * TODO: [🕌] When more than 2 functionalities, split into separate functions
+     */
+
     /**
      * Prettyfies Promptbook string and adds Mermaid graph
      */
@@ -2136,6 +1956,20 @@
      * TODO: Escape all
      */
 
+    /**
+     * 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));
+
     /**
      * Tests if given string is valid URL.
      *
@@ -2176,6 +2010,7 @@
      * @throws {PromptbookLogicError} on logical error in the promptbook
      */
     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)) {
@@ -2183,6 +2018,16 @@
                 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"));
@@ -2229,9 +2074,8 @@
                 }
                 definedParameters.add(template.resultingParameterName);
                 if (template.executionType === 'PROMPT_TEMPLATE' &&
-                    (template.modelRequirements.modelVariant === undefined ||
-                        template.modelRequirements.modelName === undefined)) {
-                    throw new PromptbookLogicError(spaceTrim.spaceTrim("\n\n                  You must specify MODEL VARIANT and MODEL NAME in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
+                    (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 &&
@@ -2339,60 +2183,153 @@
      */
 
     /**
-     * This error indicates errors during the execution of the promptbook
+     * This error indicates errors during the execution of the promptbook
+     */
+    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));
+
+    /**
+     * Asserts that the execution of a promptnook is successful
+     *
+     * @param executionResult - The partial result of the promptnook execution
+     * @throws {PromptbookExecutionError} If the execution is not successful or if multiple errors occurred
+     */
+    function assertsExecutionSuccessful(executionResult) {
+        var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
+        if (isSuccessful === true) {
+            return;
+        }
+        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                "); }));
+        }
+    }
+    /**
+     * TODO: [🧠] Can this return type be better typed than void
+     */
+
+    /**
+     * This error occurs when some expectation is not met in the execution of the pipeline
+     *
+     * @private Always catched and rethrown as `PromptbookExecutionError`
+     * Note: This is a kindof subtype of PromptbookExecutionError
+     */
+    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 ExpectError;
+    }(Error));
+
+    /**
+     * Function isValidJsonString will tell you if the string is valid JSON or not
+     */
+    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;
+        }
+    }
+
+    /**
+     * Counts number of characters in the text
+     */
+    function countCharacters(text) {
+        // Remove null characters
+        text = text.replace(/\0/g, '');
+        // Replace emojis (and also ZWJ sequence) with hyphens
+        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+        text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
+        return text.length;
+    }
+
+    /**
+     * Counts number of lines in the text
+     */
+    function countLines(text) {
+        if (text === '') {
+            return 0;
+        }
+        return text.split('\n').length;
+    }
+
+    /**
+     * Counts number of pages in the text
+     */
+    function countPages(text) {
+        var sentencesPerPage = 5; // Assuming each page has 5 sentences
+        var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+        var pageCount = Math.ceil(sentences.length / sentencesPerPage);
+        return pageCount;
+    }
+
+    /**
+     * Counts number of paragraphs in the text
+     */
+    function countParagraphs(text) {
+        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
+    }
+
+    /**
+     * Split text into sentences
      */
-    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));
-
+    function splitIntoSentences(text) {
+        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+    }
     /**
-     * Asserts that the execution of a promptnook is successful
-     *
-     * @param executionResult - The partial result of the promptnook execution
-     * @throws {PromptbookExecutionError} If the execution is not successful or if multiple errors occurred
+     * Counts number of sentences in the text
      */
-    function assertsExecutionSuccessful(executionResult) {
-        var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
-        if (isSuccessful === true) {
-            return;
-        }
-        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                "); }));
-        }
+    function countSentences(text) {
+        return splitIntoSentences(text).length;
     }
+
     /**
-     * TODO: [🧠] Can this return type be better typed than void
+     * 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;
+    }
 
     /**
-     * This error occurs when some expectation is not met in the execution of the pipeline
-     *
-     * @private Always catched and rethrown as `PromptbookExecutionError`
-     * Note: This is a kindof subtype of PromptbookExecutionError
+     * Index of all counter functions
      */
-    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 ExpectError;
-    }(Error));
+    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
@@ -2451,6 +2388,82 @@
      * TODO: [💝] Unite object for expecting amount and format
      */
 
+    /**
+     * This error occurs during the parameter replacement in the template
+     *
+     * Note: This is a kindof subtype of PromptbookExecutionError because it occurs during the execution of the pipeline
+     */
+    var TemplateError = /** @class */ (function (_super) {
+        __extends(TemplateError, _super);
+        function TemplateError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'TemplateError';
+            Object.setPrototypeOf(_this, TemplateError.prototype);
+            return _this;
+        }
+        return TemplateError;
+    }(Error));
+
+    /**
+     * Replaces parameters in template with values from parameters object
+     *
+     * @param template the template with parameters in {curly} braces
+     * @param parameters the object with parameters
+     * @returns the template with replaced parameters
+     * @throws {TemplateError} if parameter is not defined, not closed, or not opened
+     *
+     * @private within the createPromptbookExecutor
+     */
+    function replaceParameters(template, parameters) {
+        var replacedTemplate = template;
+        var match;
+        var loopLimit = LOOP_LIMIT;
+        var _loop_1 = function () {
+            if (loopLimit-- < 0) {
+                throw new UnexpectedError('Loop limit reached during parameters replacement in `replaceParameters`');
+            }
+            var precol = match.groups.precol;
+            var parameterName = match.groups.parameterName;
+            if (parameterName === '') {
+                return "continue";
+            }
+            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+                throw new TemplateError('Parameter is already opened or not closed');
+            }
+            if (parameters[parameterName] === undefined) {
+                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            var parameterValue = parameters[parameterName];
+            if (parameterValue === undefined) {
+                throw new TemplateError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            parameterValue = parameterValue.toString();
+            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+                parameterValue = parameterValue
+                    .split('\n')
+                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
+                    .join('\n');
+            }
+            replacedTemplate =
+                replacedTemplate.substring(0, match.index + precol.length) +
+                    parameterValue +
+                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
+        };
+        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+            .exec(replacedTemplate))) {
+            _loop_1();
+        }
+        // [💫] Check if there are parameters that are not closed properly
+        if (/{\w+$/.test(replacedTemplate)) {
+            throw new TemplateError('Parameter is not closed');
+        }
+        // [💫] Check if there are parameters that are not opened properly
+        if (/^\w+}/.test(replacedTemplate)) {
+            throw new TemplateError('Parameter is not opened');
+        }
+        return replacedTemplate;
+    }
+
     /**
      * Creates executor function from promptbook and execution tools.
      *
@@ -2532,7 +2545,7 @@
                                     title: currentTemplate.title,
                                     promptbookUrl: "".concat(promptbook.promptbookUrl
                                         ? promptbook.promptbookUrl
-                                        : 'anonymous' /* <- [🧠][🈴] How to deal with anonymous PROMPTBOOKs, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
+                                        : '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,
@@ -3162,6 +3175,20 @@
         return SimplePromptInterfaceTools;
     }());
 
+    /**
+     * 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)
      */
@@ -3175,6 +3202,23 @@
      */
     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");
 
+    /**
+     * Returns the same value that is passed as argument.
+     * No side effects.
+     *
+     * Note: It can be usefull for leveling indentation
+     *
+     * @param value any values
+     * @returns the same values
+     */
+    function just(value) {
+        if (value === undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return undefined;
+        }
+        return value;
+    }
+
     /**
      * This error indicates that promptbook not found in the library
      */
@@ -3232,6 +3276,12 @@
                         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);
                 }
             }
@@ -3258,6 +3308,9 @@
             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                    "); }));
@@ -3330,11 +3383,11 @@
      * Note: The function does NOT return promise it returns the library directly which waits for the sources to be resolved
      *       when error occurs in given promise or factory function, it is thrown during `listPromptbooks` or `getPromptbookByUrl` call
      *
+     * Note: Consider using  `createPromptbookLibraryFromDirectory` or `createPromptbookLibraryFromUrl`
      *
      * @param promptbookSourcesPromiseOrFactory
      * @returns PromptbookLibrary
-     *
-     * @deprecated Consider using `createPromptbookLibraryFromUrl` or `createPromptbookLibraryFromDirectory`
+     * @private Just internal tool for other constructor functions
      */
     function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
         var library;
@@ -3407,37 +3460,252 @@
      * Constructs Promptbook from given directory
      *
      * Note: Works only in Node.js environment because it reads the file system
-     * Note: The function does NOT return promise it returns the library directly which dynamically loads promptbooks when needed
-     *       SO during the construction syntax and logic sources IS NOT validated
      *
      * @param path - path to the directory with promptbooks
      * @param options - Misc options for the library
      * @returns PromptbookLibrary
      */
     function createPromptbookLibraryFromDirectory(path, options) {
-        var _this = this;
-        if (!isRunningInNode()) {
-            throw new Error('Function `createPromptbookLibraryFromDirectory` can only be run in Node.js environment because it reads the file system.');
-        }
-        var _a = (options || {}).isRecursive, isRecursive = _a === void 0 ? true : _a;
-        return createPromptbookLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
-            var readdir, readdirResult;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, import('fs/promises')];
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashOnError, library;
+            var _this = this;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        if (!isRunningInNode()) {
+                            throw new Error('Function `createPromptbookLibraryFromDirectory` can only be run in Node.js environment because it reads the file system.');
+                        }
+                        _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? false : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashOnError, isCrashOnError = _e === void 0 ? true : _e;
+                        library = createPromptbookLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
+                            var fsPromises, readFile, fileNames, promptbooks, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
+                            var e_1, _a;
+                            return __generator(this, function (_b) {
+                                switch (_b.label) {
+                                    case 0:
+                                        if (isVerbose) {
+                                            console.info("Creating promptbook library from path ".concat(path));
+                                        }
+                                        fsPromises = require(just('fs/promises') /* <- Note: [1] */);
+                                        readFile = fsPromises.readFile;
+                                        return [4 /*yield*/, listAllFiles(path, isRecursive)];
+                                    case 1:
+                                        fileNames = _b.sent();
+                                        if (isVerbose) {
+                                            console.info('createPromptbookLibraryFromDirectory', { path: path, isRecursive: isRecursive, fileNames: fileNames });
+                                        }
+                                        promptbooks = [];
+                                        _loop_1 = function (fileName) {
+                                            var promptbook, promptbookString, _c, _d, error_1, wrappedErrorMessage;
+                                            return __generator(this, function (_e) {
+                                                switch (_e.label) {
+                                                    case 0:
+                                                        _e.trys.push([0, 6, , 7]);
+                                                        promptbook = null;
+                                                        if (!fileName.endsWith('.ptbk.md')) return [3 /*break*/, 2];
+                                                        return [4 /*yield*/, readFile(fileName, 'utf8')];
+                                                    case 1:
+                                                        promptbookString = (_e.sent());
+                                                        promptbook = promptbookStringToJson(promptbookString);
+                                                        return [3 /*break*/, 5];
+                                                    case 2:
+                                                        if (!fileName.endsWith('.ptbk.json')) return [3 /*break*/, 4];
+                                                        if (isVerbose) {
+                                                            console.info("Loading ".concat(fileName));
+                                                        }
+                                                        _d = (_c = JSON).parse;
+                                                        return [4 /*yield*/, readFile(fileName, 'utf8')];
+                                                    case 3:
+                                                        // TODO: Handle non-valid JSON files
+                                                        promptbook = _d.apply(_c, [_e.sent()]);
+                                                        return [3 /*break*/, 5];
+                                                    case 4:
+                                                        if (isVerbose) {
+                                                            console.info("Skipping file ".concat(fileName));
+                                                        }
+                                                        _e.label = 5;
+                                                    case 5:
+                                                        // ---
+                                                        if (promptbook !== null) {
+                                                            if (!promptbook.promptbookUrl) {
+                                                                if (isVerbose) {
+                                                                    console.info("Not loading ".concat(fileName, " - missing URL"));
+                                                                }
+                                                            }
+                                                            else {
+                                                                if (isVerbose) {
+                                                                    console.info("Loading ".concat(fileName));
+                                                                }
+                                                                if (!isCrashOnError) {
+                                                                    // Note: Validate promptbook to check if it is logically correct to not crash on invalid promptbooks
+                                                                    //       But be handled in current try-catch block
+                                                                    validatePromptbookJson(promptbook);
+                                                                }
+                                                                // Note: [🦄] Promptbook with same url uniqueness will be checked automatically in SimplePromptbookLibrary
+                                                                promptbooks.push(promptbook);
+                                                            }
+                                                        }
+                                                        return [3 /*break*/, 7];
+                                                    case 6:
+                                                        error_1 = _e.sent();
+                                                        if (!(error_1 instanceof Error)) {
+                                                            throw error_1;
+                                                        }
+                                                        wrappedErrorMessage = spaceTrim__default["default"](function (block) { return "\n                        Error during loading promptbook from file ".concat(fileName.split('\\').join('/'), ":\n\n                        ").concat(block(error_1.message), "\n\n                    "); });
+                                                        if (isCrashOnError) {
+                                                            throw new PromptbookLibraryError(wrappedErrorMessage);
+                                                        }
+                                                        console.error(wrappedErrorMessage);
+                                                        return [3 /*break*/, 7];
+                                                    case 7: return [2 /*return*/];
+                                                }
+                                            });
+                                        };
+                                        _b.label = 2;
+                                    case 2:
+                                        _b.trys.push([2, 7, 8, 9]);
+                                        fileNames_1 = __values(fileNames), fileNames_1_1 = fileNames_1.next();
+                                        _b.label = 3;
+                                    case 3:
+                                        if (!!fileNames_1_1.done) return [3 /*break*/, 6];
+                                        fileName = fileNames_1_1.value;
+                                        return [5 /*yield**/, _loop_1(fileName)];
+                                    case 4:
+                                        _b.sent();
+                                        _b.label = 5;
+                                    case 5:
+                                        fileNames_1_1 = fileNames_1.next();
+                                        return [3 /*break*/, 3];
+                                    case 6: return [3 /*break*/, 9];
+                                    case 7:
+                                        e_1_1 = _b.sent();
+                                        e_1 = { error: e_1_1 };
+                                        return [3 /*break*/, 9];
+                                    case 8:
+                                        try {
+                                            if (fileNames_1_1 && !fileNames_1_1.done && (_a = fileNames_1.return)) _a.call(fileNames_1);
+                                        }
+                                        finally { if (e_1) throw e_1.error; }
+                                        return [7 /*endfinally*/];
+                                    case 9: return [2 /*return*/, promptbooks];
+                                }
+                            });
+                        }); });
+                        if (!(isLazyLoaded === false)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, library.listPromptbooks()];
+                    case 1:
+                        _f.sent();
+                        _f.label = 2;
+                    case 2: return [2 /*return*/, library];
+                }
+            });
+        });
+    }
+    /**
+     * Reads all files in the directory
+     *
+     * @param path
+     * @param isRecursive
+     * @returns List of all files in the directory
+     * @private internal function for `createPromptbookLibraryFromDirectory`
+     */
+    function listAllFiles(path$1, isRecursive) {
+        return __awaiter(this, void 0, void 0, function () {
+            var fsPromises, readdir, dirents, fileNames, _a, _b, dirent, subPath, _c, _d, _e, _f, e_2_1;
+            var e_2, _g;
+            return __generator(this, function (_h) {
+                switch (_h.label) {
+                    case 0:
+                        fsPromises = require(just('fs/promises') /* <- Note: [1] */);
+                        readdir = fsPromises.readdir;
+                        return [4 /*yield*/, readdir(path$1, {
+                                withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
+                            })];
                     case 1:
-                        readdir = (_a.sent()).readdir;
-                        return [4 /*yield*/, readdir(path)];
+                        dirents = _h.sent();
+                        fileNames = dirents.filter(function (dirent) { return dirent.isFile(); }).map(function (_a) {
+                            var name = _a.name;
+                            return path.join(path$1, name);
+                        });
+                        if (!isRecursive) return [3 /*break*/, 9];
+                        _h.label = 2;
                     case 2:
-                        readdirResult = _a.sent();
-                        // TODO: !!! Implement
-                        console.info('createPromptbookLibraryFromDirectory', { path: path, isRecursive: isRecursive, readdirResult: readdirResult });
-                        throw new Error('Not implemented yet');
+                        _h.trys.push([2, 7, 8, 9]);
+                        _a = __values(dirents.filter(function (dirent) { return dirent.isDirectory(); })), _b = _a.next();
+                        _h.label = 3;
+                    case 3:
+                        if (!!_b.done) return [3 /*break*/, 6];
+                        dirent = _b.value;
+                        subPath = path.join(path$1, dirent.name);
+                        _d = (_c = fileNames.push).apply;
+                        _e = [fileNames];
+                        _f = [[]];
+                        return [4 /*yield*/, listAllFiles(subPath, isRecursive)];
+                    case 4:
+                        _d.apply(_c, _e.concat([__spreadArray.apply(void 0, _f.concat([__read.apply(void 0, [(_h.sent())]), false]))]));
+                        _h.label = 5;
+                    case 5:
+                        _b = _a.next();
+                        return [3 /*break*/, 3];
+                    case 6: return [3 /*break*/, 9];
+                    case 7:
+                        e_2_1 = _h.sent();
+                        e_2 = { error: e_2_1 };
+                        return [3 /*break*/, 9];
+                    case 8:
+                        try {
+                            if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
+                        }
+                        finally { if (e_2) throw e_2.error; }
+                        return [7 /*endfinally*/];
+                    case 9: return [2 /*return*/, fileNames];
+                }
+            });
+        });
+    }
+    /***
+     * TODO: [🧠] Maybe do not do hacks like [1] and just create package @promptbook/node
+     *       [🍓][🚯] maybe make `@promptbook/library` package
+     * TODO: Fix the dynamic import issue in Webpack (! Not working !)
+     *     > ./node_modules/@promptbook/core/esm/index.es.js
+     *     > Critical dependency: the request of a dependency is an expression
+     *
+     * Note: [1] Using require(just('fs/promises')) to allow
+     *     the `@promptbook/core` work for both Node.js and browser environments
+     */
+
+    /**
+     * Constructs Promptbook from remote Promptbase URL
+
+     * @returns PromptbookLibrary
+     */
+    function createPromptbookLibraryFromUrl(url, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, isVerbose, _c, isLazyLoaded, library;
+            var _this = this;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        _a = options || {}, _b = _a.isVerbose, isVerbose = _b === void 0 ? false : _b, _c = _a.isLazyLoaded, isLazyLoaded = _c === void 0 ? false : _c;
+                        library = createPromptbookLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
+                            return __generator(this, function (_a) {
+                                if (isVerbose) {
+                                    console.info("Creating promptbook library from url ".concat(url.toString()));
+                                }
+                                throw new Error('Not implemented yet');
+                            });
+                        }); });
+                        if (!(isLazyLoaded === false)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, library.listPromptbooks()];
+                    case 1:
+                        _d.sent();
+                        _d.label = 2;
+                    case 2: return [2 /*return*/, library];
                 }
             });
-        }); });
+        });
     }
     /***
+     * TODO: [⚖] Compatible with remote server
      * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
      */
 
@@ -3523,6 +3791,31 @@
      * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
      */
 
+    /**
+     * Just testing imports and compatibility
+     */
+    function justTestFsImport() {
+        return __awaiter(this, void 0, void 0, function () {
+            var files;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!isRunningInNode()) {
+                            throw new Error('Function `testFiles` can only be run in Node.js environment because it reads the file system.');
+                        }
+                        return [4 /*yield*/, require(just('glob-promise'))('/**/*')];
+                    case 1:
+                        files = _a.sent();
+                        console.info('testFiles', { files: files });
+                        return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: !!! Remove this file
+     */
+
     /**
      * Format either small or big number
      *
@@ -3543,23 +3836,6 @@
         return value.toString();
     }
 
-    /**
-     * Returns the same value that is passed as argument.
-     * No side effects.
-     *
-     * Note: It can be usefull for leveling indentation
-     *
-     * @param value any values
-     * @returns the same values
-     */
-    function just(value) {
-        if (value === undefined) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            return undefined;
-        }
-        return value;
-    }
-
     /**
      * Create a markdown table from a 2D array of strings
      *
@@ -3851,11 +4127,12 @@
     exports.checkExpectations = checkExpectations;
     exports.createPromptbookExecutor = createPromptbookExecutor;
     exports.createPromptbookLibraryFromDirectory = createPromptbookLibraryFromDirectory;
-    exports.createPromptbookLibraryFromPromise = createPromptbookLibraryFromPromise;
     exports.createPromptbookLibraryFromSources = createPromptbookLibraryFromSources;
+    exports.createPromptbookLibraryFromUrl = createPromptbookLibraryFromUrl;
     exports.createPromptbookSublibrary = createPromptbookSublibrary;
     exports.executionReportJsonToString = executionReportJsonToString;
     exports.isPassingExpectations = isPassingExpectations;
+    exports.justTestFsImport = justTestFsImport;
     exports.prettifyPromptbookString = prettifyPromptbookString;
     exports.promptbookJsonToString = promptbookJsonToString;
     exports.promptbookStringToJson = promptbookStringToJson;