@promptbook/core 0.48.0 → 0.48.1-0

package/umd/index.umd.js

@@ -1,12 +1,12 @@
 (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));
-})(this, (function (exports, spaceTrim) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spacetrim, global.prettier, global.parserHtml));
+})(this, (function (exports, spacetrim, prettier, parserHtml) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -212,7 +212,7 @@
     var UnexpectedError = /** @class */ (function (_super) {
         __extends(UnexpectedError, _super);
         function UnexpectedError(message) {
-            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+            var _this = _super.call(this, spacetrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
             _this.name = 'UnexpectedError';
             Object.setPrototypeOf(_this, UnexpectedError.prototype);
             return _this;
@@ -265,7 +265,7 @@
                             }
                             if (parent_1.parent === null /* <- Note: We are in root */) {
                                 // [🌻]
-                                throw new Error(spaceTrim.spaceTrim("\n                                The file has an invalid structure.\n                                The markdown file must have exactly one top-level section.\n                            "));
+                                throw new Error(spacetrim.spaceTrim("\n                                The file has an invalid structure.\n                                The markdown file must have exactly one top-level section.\n                            "));
                             }
                             parent_1 = parent_1.parent;
                         }
@@ -299,7 +299,7 @@
         return {
             level: level,
             title: title,
-            content: spaceTrim.spaceTrim(contentLines.join('\n')),
+            content: spacetrim.spaceTrim(contentLines.join('\n')),
             sections: sections.map(parsingMarkdownStructureToMarkdownStructure),
         };
     }
@@ -439,13 +439,13 @@
      * @returns {string} The input string with all comments removed.
      */
     function removeContentComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+        return spacetrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.48.0-1';
+    var PROMPTBOOK_VERSION = '0.48.0';
 
     /**
      * Parses the given script and returns the list of all used variables that are not defined in the script
@@ -490,11 +490,43 @@
             if (!(error instanceof Error)) {
                 throw error;
             }
-            throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+            throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
         }
         return variables;
     }
 
+    /**
+     * Prettify the html code
+     *
+     * @param content raw html code
+     * @returns formatted html code
+     */
+    function prettifyMarkdown(content) {
+        try {
+            return prettier.format(content, {
+                parser: 'markdown',
+                plugins: [parserHtml__default["default"]],
+                // TODO: DRY - make some import or auto-copy of .prettierrc
+                endOfLine: 'lf',
+                tabWidth: 4,
+                singleQuote: true,
+                trailingComma: 'all',
+                arrowParens: 'always',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                jsxBracketSameLine: false,
+                bracketSpacing: true,
+            });
+        }
+        catch (error) {
+            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
+                error: error,
+                html: content,
+            });
+            return content;
+        }
+    }
+
     /**
      * Removes emojis from a string and fix whitespaces
      *
@@ -587,6 +619,20 @@
      * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
      */
 
+    /**
+     * 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 indicates errors during the execution of the promptbook
      */
@@ -1270,15 +1316,15 @@
             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                    ")));
+                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                    ")));
+                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                    ")));
+                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',
@@ -1287,7 +1333,7 @@
         }
         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                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
             var promptbookVersion = listItemParts.pop();
             // TODO: Validate version
@@ -1302,7 +1348,7 @@
             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                    "); }));
+                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',
@@ -1327,7 +1373,7 @@
                     };
                 }
                 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                        "); }));
+                    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')) {
@@ -1338,7 +1384,7 @@
                 };
             }
             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                    "); }));
+                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') ||
@@ -1348,12 +1394,12 @@
             listItem.startsWith('> {') /* <- Note: This is a bit hack to parse return parameters defined at the end of each section */) {
             var parametersMatch = listItem.match(/\{(?<parameterName>[a-z0-9_]+)\}[^\S\r\n]*(?<parameterDescription>.*)$/im);
             if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                        Invalid parameter in command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Invalid parameter in command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             var _b = parametersMatch.groups, parameterName = _b.parameterName, parameterDescription = _b.parameterDescription;
             if (parameterDescription && parameterDescription.match(/\{(?<parameterName>[a-z0-9_]+)\}/im)) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                        Parameter {".concat(parameterName, "} can not contain another parameter in description:\n\n                        - ").concat(listItem, "\n                    ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                        Parameter {".concat(parameterName, "} can not contain another parameter in description:\n\n                        - ").concat(listItem, "\n                    ")));
             }
             var isInput = type.startsWith('INPUT');
             var isOutput = type.startsWith('OUTPUT');
@@ -1371,11 +1417,11 @@
         }
         else if (type.startsWith('JOKER')) {
             if (listItemParts.length !== 2) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Invalid JOKER command:\n\n                - ".concat(listItem, "\n            ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid JOKER command:\n\n                - ".concat(listItem, "\n            ")));
             }
             var parametersMatch = (listItemParts.pop() || '').match(/^\{(?<parameterName>[a-z0-9_]+)\}$/im);
             if (!parametersMatch || !parametersMatch.groups || !parametersMatch.groups.parameterName) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                      Invalid parameter in command:\n\n                      - ".concat(listItem, "\n                  ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                      Invalid parameter in command:\n\n                      - ".concat(listItem, "\n                  ")));
             }
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             var parameterName = parametersMatch.groups.parameterName;
@@ -1386,7 +1432,7 @@
         }
         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            ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid POSTPROCESSING command:\n\n                - ".concat(listItem, "\n            ")));
             }
             var functionName = listItemParts.pop();
             return {
@@ -1466,7 +1512,7 @@
                 if (!(error instanceof Error)) {
                     throw error;
                 }
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                  Invalid EXPECT command; ".concat(error.message, ":\n\n                  - ").concat(listItem, "\n              ")));
             }
             /*
         } else if (type.startsWith('__________________')) {
@@ -1474,7 +1520,7 @@
         */
         }
         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                ")));
+            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                ")));
         }
     }
 
@@ -1510,7 +1556,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
             }
             if (existingParameter) {
                 if (parameterDescription) {
@@ -1531,7 +1577,7 @@
         var markdownStructure = markdownToMarkdownStructure(promptbookString);
         var markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
         if (markdownStructureDeepness !== 2) {
-            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
+            throw new PromptbookSyntaxError(spacetrim.spaceTrim("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
         }
         promptbookJson.title = markdownStructure.title;
         // TODO: [1] DRY description
@@ -1540,7 +1586,7 @@
         description = description.split(/^```.*^```/gms).join('');
         //Note: Remove lists and return statement
         description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description = spaceTrim.spaceTrim(description);
+        description = spacetrim.spaceTrim(description);
         if (description === '') {
             description = undefined;
         }
@@ -1655,13 +1701,13 @@
                     throw new PromptbookSyntaxError('You must specify the language of the script in the prompt template');
                 }
                 else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                    throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
+                    throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
                 }
             }
             var lastLine = section.content.split('\n').pop();
             var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
             if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
-                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
+                throw new PromptbookSyntaxError(spacetrim.spaceTrim(function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
                 // TODO: Show code of invalid sections each time + DRY
                 section.content
                     .split('\n')
@@ -1675,7 +1721,7 @@
             description_1 = description_1.split(/^```.*^```/gms).join('');
             //Note: Remove lists and return statement
             description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-            description_1 = spaceTrim.spaceTrim(description_1);
+            description_1 = spacetrim.spaceTrim(description_1);
             if (description_1 === '') {
                 description_1 = undefined;
             }
@@ -1756,28 +1802,186 @@
      */
 
     function promptbookJsonToString(promptbookJson) {
-        return spaceTrim__default["default"](function (block) { return "\n\n            # ".concat(block(promptbookJson.title), "\n\n        "); });
+        var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e;
+        var title = promptbookJson.title, promptbookUrl = promptbookJson.promptbookUrl, promptbookVersion = promptbookJson.promptbookVersion, description = promptbookJson.description, parameters = promptbookJson.parameters, promptTemplates = promptbookJson.promptTemplates;
+        var promptbookString = "# ".concat(title);
+        if (description) {
+            promptbookString += '\n\n';
+            promptbookString += description;
+        }
+        // TODO:> const commands: Array<Command>
+        var commands = [];
+        if (promptbookUrl) {
+            commands.push("PROMPTBOOK URL ".concat(promptbookUrl));
+        }
+        commands.push("PROMPTBOOK VERSION ".concat(promptbookVersion));
+        promptbookString = prettifyMarkdown(promptbookString);
+        try {
+            for (var parameters_1 = __values(parameters), parameters_1_1 = parameters_1.next(); !parameters_1_1.done; parameters_1_1 = parameters_1.next()) {
+                var parameter = parameters_1_1.value;
+                var isInput = parameter.isInput, isOutput = parameter.isOutput;
+                if (isInput) {
+                    commands.push("INPUT PARAMETER ".concat(promptTemplateParameterJsonToString(parameter)));
+                }
+                else if (isOutput) {
+                    commands.push("OUTPUT PARAMETER ".concat(promptTemplateParameterJsonToString(parameter)));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (parameters_1_1 && !parameters_1_1.done && (_a = parameters_1.return)) _a.call(parameters_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        promptbookString += '\n\n';
+        promptbookString += commands.map(function (command) { return "- ".concat(command); }).join('\n');
+        try {
+            for (var promptTemplates_1 = __values(promptTemplates), promptTemplates_1_1 = promptTemplates_1.next(); !promptTemplates_1_1.done; promptTemplates_1_1 = promptTemplates_1.next()) {
+                var promptTemplate = promptTemplates_1_1.value;
+                var 
+                /* Note: Not using:> name, */
+                title_1 = promptTemplate.title, description_1 = promptTemplate.description, 
+                /* Note: dependentParameterNames, */
+                jokers = promptTemplate.jokers, executionType = promptTemplate.executionType, content = promptTemplate.content, postprocessing = promptTemplate.postprocessing, expectations = promptTemplate.expectations, expectFormat = promptTemplate.expectFormat, resultingParameterName = promptTemplate.resultingParameterName;
+                promptbookString += '\n\n';
+                promptbookString += "## ".concat(title_1);
+                if (description_1) {
+                    promptbookString += '\n\n';
+                    promptbookString += description_1;
+                }
+                // TODO:> const commands: Array<Command>
+                var commands_1 = [];
+                var contentLanguage = 'markdown';
+                if (executionType === 'PROMPT_TEMPLATE') {
+                    var modelRequirements = promptTemplate.modelRequirements;
+                    var modelName = modelRequirements.modelName, modelVariant = modelRequirements.modelVariant;
+                    commands_1.push("EXECUTE PROMPT TEMPLATE");
+                    if (modelVariant) {
+                        commands_1.push("MODEL VARIANT ".concat(capitalize(modelVariant)));
+                    }
+                    if (modelName) {
+                        commands_1.push("MODEL NAME `".concat(modelName, "`"));
+                    }
+                }
+                else if (executionType === 'SIMPLE_TEMPLATE') {
+                    commands_1.push("SIMPLE TEMPLATE");
+                    // Note: Nothing special here
+                }
+                else if (executionType === 'SCRIPT') {
+                    commands_1.push("EXECUTE SCRIPT");
+                    if (promptTemplate.contentLanguage) {
+                        contentLanguage = promptTemplate.contentLanguage;
+                    }
+                    else {
+                        contentLanguage = '';
+                    }
+                }
+                else if (executionType === 'PROMPT_DIALOG') {
+                    commands_1.push("PROMPT DIALOG");
+                    // Note: Nothing special here
+                }
+                if (jokers) {
+                    try {
+                        for (var jokers_1 = (e_3 = void 0, __values(jokers)), jokers_1_1 = jokers_1.next(); !jokers_1_1.done; jokers_1_1 = jokers_1.next()) {
+                            var joker = jokers_1_1.value;
+                            commands_1.push("JOKER {".concat(joker, "}"));
+                        }
+                    }
+                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    finally {
+                        try {
+                            if (jokers_1_1 && !jokers_1_1.done && (_c = jokers_1.return)) _c.call(jokers_1);
+                        }
+                        finally { if (e_3) throw e_3.error; }
+                    }
+                } /* not else */
+                if (postprocessing) {
+                    try {
+                        for (var postprocessing_1 = (e_4 = void 0, __values(postprocessing)), postprocessing_1_1 = postprocessing_1.next(); !postprocessing_1_1.done; postprocessing_1_1 = postprocessing_1.next()) {
+                            var postprocessingFunctionName = postprocessing_1_1.value;
+                            commands_1.push("POSTPROCESSING `".concat(postprocessingFunctionName, "`"));
+                        }
+                    }
+                    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                    finally {
+                        try {
+                            if (postprocessing_1_1 && !postprocessing_1_1.done && (_d = postprocessing_1.return)) _d.call(postprocessing_1);
+                        }
+                        finally { if (e_4) throw e_4.error; }
+                    }
+                } /* not else */
+                if (expectations) {
+                    try {
+                        for (var _f = (e_5 = void 0, __values(Object.entries(expectations))), _g = _f.next(); !_g.done; _g = _f.next()) {
+                            var _h = __read(_g.value, 2), unit = _h[0], _j = _h[1], min = _j.min, max = _j.max;
+                            if (min === max) {
+                                commands_1.push("EXPECT EXACTLY ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                            }
+                            else {
+                                if (min !== undefined) {
+                                    commands_1.push("EXPECT MIN ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                                } /* not else */
+                                if (max !== undefined) {
+                                    commands_1.push("EXPECT MAX ".concat(max, " ").concat(capitalize(unit + (max > 1 ? 's' : ''))));
+                                }
+                            }
+                        }
+                    }
+                    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                    finally {
+                        try {
+                            if (_g && !_g.done && (_e = _f.return)) _e.call(_f);
+                        }
+                        finally { if (e_5) throw e_5.error; }
+                    }
+                } /* not else */
+                if (expectFormat) {
+                    if (expectFormat === 'JSON') {
+                        // TODO: @deprecated remove
+                        commands_1.push("EXPECT JSON");
+                    }
+                } /* not else */
+                promptbookString += '\n\n';
+                promptbookString += commands_1.map(function (command) { return "- ".concat(command); }).join('\n');
+                promptbookString += '\n\n';
+                promptbookString += '```' + contentLanguage;
+                promptbookString += '\n';
+                promptbookString += content; // <- TODO: !!! Escape
+                promptbookString += '\n';
+                promptbookString += '```';
+                promptbookString += '\n\n';
+                promptbookString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: !!! If the parameter here has description, add it and use promptTemplateParameterJsonToString
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (promptTemplates_1_1 && !promptTemplates_1_1.done && (_b = promptTemplates_1.return)) _b.call(promptTemplates_1);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        return promptbookString;
+    }
+    /**
+     * @private internal util of promptbookJsonToString
+     */
+    function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
+        var name = promptTemplateParameterJson.name, description = promptTemplateParameterJson.description;
+        var parameterString = "{".concat(name, "}");
+        if (description) {
+            parameterString = "".concat(parameterString, " ").concat(description);
+        }
+        return parameterString;
     }
     /**
      * TODO: !!!!! Implement
      * TODO: !!!!! Annotate and warn
      * TODO: !!!!! Test + test together with promptbookStringToJson
+     * 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.
      *
@@ -1804,7 +2008,7 @@
     }
 
     /**
-     * Validates PromptbookJson if it is logically valid.
+     * Validates PromptbookJson if it is logically valid
      *
      * It checks:
      * -   if it has correct parameters dependency
@@ -1814,6 +2018,7 @@
      * -   if it is meaningful
      *
      * @param promptbook valid or invalid PromptbookJson
+     * @returns the same promptbook if it is logically valid
      * @throws {PromptbookLogicError} on logical error in the promptbook
      */
     function validatePromptbookJson(promptbook) {
@@ -1832,12 +2037,12 @@
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !promptbook.promptTemplates.some(function (template) { return template.dependentParameterNames.includes(parameter.name); })) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is created but not used\n\n                    You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                    - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                ")));
+                throw new PromptbookLogicError(spacetrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is created but not used\n\n                    You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                    - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                ")));
             }
             // Note: Testing that parameter is either input or result of some template
             if (!parameter.isInput &&
                 !promptbook.promptTemplates.some(function (template) { return template.resultingParameterName === parameter.name; })) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is declared but not defined\n\n                    You can do one of these:\n                    - Remove declaration of {").concat(parameter.name, "}\n                    - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                ")));
+                throw new PromptbookLogicError(spacetrim.spaceTrim("\n                    Parameter {".concat(parameter.name, "} is declared but not defined\n\n                    You can do one of these:\n                    - Remove declaration of {").concat(parameter.name, "}\n                    - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                ")));
             }
         };
         try {
@@ -1872,7 +2077,7 @@
                 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              ")));
+                    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              ")));
                 }
                 if (template.jokers && template.jokers.length > 0) {
                     if (!template.expectFormat &&
@@ -1947,7 +2152,7 @@
                 return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
             });
             if (currentlyResovedTemplates.length === 0) {
-                throw new PromptbookLogicError(spaceTrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters\n                        It may be circular dependencies\n\n                        Can not resolve:\n                        ".concat(block(unresovedTemplates
+                throw new PromptbookLogicError(spacetrim.spaceTrim(function (block) { return "\n\n                        Can not resolve some parameters\n                        It may be circular dependencies\n\n                        Can not resolve:\n                        ".concat(block(unresovedTemplates
                     .map(function (_a) {
                     var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
                     return "- {".concat(resultingParameterName, "} depends on ").concat(dependentParameterNames
@@ -1965,6 +2170,7 @@
         while (unresovedTemplates.length > 0) {
             _loop_2();
         }
+        return promptbook;
     }
     /**
      * TODO: [🧠] Work with promptbookVersion
@@ -2120,7 +2326,7 @@
                                                         throw errors[0];
                                                     }
                                                     else {
-                                                        throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                                        Postprocessing in LlmExecutionTools failed ".concat(errors.length, "x\n\n                                                        ").concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n\n')), "\n                                                      "); }));
+                                                        throw new PromptbookExecutionError(spacetrim.spaceTrim(function (block) { return "\n                                                        Postprocessing in LlmExecutionTools failed ".concat(errors.length, "x\n\n                                                        ").concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n\n')), "\n                                                      "); }));
                                                     }
                                             }
                                         });
@@ -2204,7 +2410,7 @@
                                     throw scriptExecutionErrors[0];
                                 }
                                 else {
-                                    throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                                              Script execution failed ".concat(scriptExecutionErrors.length, " times\n\n                                              ").concat(block(scriptExecutionErrors
+                                    throw new PromptbookExecutionError(spacetrim.spaceTrim(function (block) { return "\n                                              Script execution failed ".concat(scriptExecutionErrors.length, " times\n\n                                              ").concat(block(scriptExecutionErrors
                                         .map(function (error) { return '- ' + error.message; })
                                         .join('\n\n')), "\n                                          "); }));
                                 }
@@ -2344,7 +2550,7 @@
                                 return [7 /*endfinally*/];
                             case 47:
                                 if (expectError !== null && attempt === maxAttempts - 1) {
-                                    throw new PromptbookExecutionError(spaceTrim.spaceTrim(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ---\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block((expectError === null || expectError === void 0 ? void 0 : expectError.message) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
+                                    throw new PromptbookExecutionError(spacetrim.spaceTrim(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ---\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block((expectError === null || expectError === void 0 ? void 0 : expectError.message) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
                                 }
                                 _o.label = 48;
                             case 48:
@@ -2413,7 +2619,7 @@
                                             return template.dependentParameterNames.every(function (name) { return resovedParameters_1.includes(name); });
                                         });
                                         if (!(!currentTemplate && resolving_1.length === 0)) return [3 /*break*/, 1];
-                                        throw new UnexpectedError(spaceTrim.spaceTrim("\n                            Can not resolve some parameters\n\n                            Note: This should be catched during validatePromptbookJson\n                        "));
+                                        throw new UnexpectedError(spacetrim.spaceTrim("\n                            Can not resolve some parameters\n\n                            Note: This should be catched during validatePromptbookJson\n                        "));
                                     case 1:
                                         if (!!currentTemplate) return [3 /*break*/, 3];
                                         /* [5] */ return [4 /*yield*/, Promise.race(resolving_1)];
@@ -2513,7 +2719,7 @@
                         case 1:
                             answer = _a.sent();
                             if (this.options.isVerbose) {
-                                console.info(spaceTrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer), "\n                    "); }));
+                                console.info(spacetrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer), "\n                    "); }));
                             }
                             return [2 /*return*/, answer];
                     }
@@ -2540,9 +2746,9 @@
             return __awaiter(this, void 0, void 0, function () {
                 var answer;
                 return __generator(this, function (_a) {
-                    answer = window.prompt(spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(options.promptTitle), "\n\n                    ").concat(block(options.promptMessage), "\n                "); }));
+                    answer = window.prompt(spacetrim.spaceTrim(function (block) { return "\n                    ".concat(block(options.promptTitle), "\n\n                    ").concat(block(options.promptMessage), "\n                "); }));
                     if (this.options.isVerbose) {
-                        console.info(spaceTrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer || '🚫 User cancelled prompt'), "\n                    "); }));
+                        console.info(spacetrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer || '🚫 User cancelled prompt'), "\n                    "); }));
                     }
                     if (answer === null) {
                         throw new PromptbookExecutionError('User cancelled prompt');
@@ -2608,7 +2814,7 @@
                 for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
                     var promptbook = promptbooks_1_1.value;
                     if (promptbook.promptbookUrl === undefined) {
-                        throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the promptbook library\n\n                    ")));
+                        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);
                     this.library.set(promptbook.promptbookUrl, promptbook);
@@ -2637,7 +2843,7 @@
             var _this = this;
             var promptbook = this.library.get(url);
             if (!promptbook) {
-                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()
+                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                    "); }));
             }
@@ -2815,7 +3021,7 @@
                         case 0:
                             if (!!predicate(url)) return [3 /*break*/, 2];
                             _a = PromptbookNotFoundError.bind;
-                            return [4 /*yield*/, spaceTrim.spaceTrim(function (block) { return __awaiter(_this, void 0, void 0, function () {
+                            return [4 /*yield*/, spacetrim.spaceTrim(function (block) { return __awaiter(_this, void 0, void 0, function () {
                                     var _a, _b, _c, _d, _e, _f;
                                     return __generator(this, function (_g) {
                                         switch (_g.label) {