@promptbook/cli 0.59.0-8 → 0.59.0

package/umd/index.umd.js

@@ -1,16 +1,16 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('fs/promises'), require('glob-promise'), require('spacetrim'), require('waitasecond'), require('prettier'), require('prettier/parser-html')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'fs/promises', 'glob-promise', 'spacetrim', 'waitasecond', 'prettier', 'prettier/parser-html'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global.promises, global.glob, global.spaceTrim, global.waitasecond, global.prettier, global.parserHtml));
-})(this, (function (exports, colors, commander, promises, glob, spaceTrim, waitasecond, prettier, parserHtml) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('commander'), require('spacetrim'), require('colors'), require('waitasecond'), require('fs/promises'), require('path'), require('prettier'), require('prettier/parser-html'), require('glob-promise')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'commander', 'spacetrim', 'colors', 'waitasecond', 'fs/promises', 'path', 'prettier', 'prettier/parser-html', 'glob-promise'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.commander, global.spaceTrim, global.colors, global.waitasecond, global.promises, global.path, global.prettier, global.parserHtml, global.glob));
+})(this, (function (exports, commander, spaceTrim, colors, waitasecond, promises, path, prettier, parserHtml, glob) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var commander__default = /*#__PURE__*/_interopDefaultLegacy(commander);
-    var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
+    var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -147,70 +147,60 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.59.0-7';
+    var PROMPTBOOK_VERSION = '0.59.0-36';
 
     /**
-     * Removes HTML or Markdown comments from a string.
+     * Initializes testing `hello` command for Promptbook CLI utilities
      *
-     * @param {string} content - The string to remove comments from.
-     * @returns {string} The input string with all comments removed.
+     * @private part of `promptbookCli`
      */
-    function removeContentComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+    function initializeHello(program) {
+        var _this = this;
+        var helloCommand = program.command('hello');
+        helloCommand.description(spaceTrim__default["default"]("\n            Just command for testing\n      "));
+        helloCommand.argument('<name>', 'Your name');
+        helloCommand.option('-g, --greeting <greeting>', "Greeting", 'Hello');
+        helloCommand.action(function (name, _a) {
+            var greeting = _a.greeting;
+            return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            console.info(colors__default["default"].cyan("".concat(greeting, " ").concat(name)));
+                            return [4 /*yield*/, waitasecond.forTime(1000)];
+                        case 1:
+                            _b.sent();
+                            console.info(colors__default["default"].rainbow("Nice to meet you!"));
+                            process.exit(0);
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        });
     }
 
     /**
-     * Add or modify an auto-generated section in a markdown file
-     *
-     * @private within the library
+     * The maximum number of iterations for a loops
      */
-    function addAutoGeneratedSection(content, options) {
-        var sectionName = options.sectionName, sectionContent = options.sectionContent;
-        var warningLine = "<!-- \u26A0\uFE0F WARNING: This section was auto-generated -->";
-        var sectionRegex = new RegExp("<!--".concat(sectionName, "-->([\\s\\S]*?)<!--/").concat(sectionName, "-->"), 'g');
-        var sectionMatch = content.match(sectionRegex);
-        if (sectionMatch) {
-            return content.replace(sectionRegex, spaceTrim.spaceTrim(function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
-        }
-        var placeForSection = removeContentComments(content).match(/^##.*$/im);
-        if (!placeForSection) {
-            throw new Error("No place where to put the section <!--".concat(sectionName, "-->"));
-        }
-        var _a = __read(placeForSection, 1), heading = _a[0];
-        return content.replace(heading, "<!--".concat(sectionName, "-->\n").concat(warningLine, "\n").concat(sectionContent, "\n<!--/").concat(sectionName, "-->\n\n").concat(heading));
-    }
+    var LOOP_LIMIT = 1000;
+    /**
+     * The name of the builded promptbook library made by CLI `promptbook make` and for lookup in `createLibraryFromDirectory`
+     */
+    var PROMPTBOOK_MAKED_BASE_FILENAME = "index";
 
     /**
-     * Prettify the html code
-     *
-     * @param content raw html code
-     * @returns formatted html code
+     * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
      */
-    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;
+    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 that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -226,64 +216,6 @@
         return PromptbookSyntaxError;
     }(Error));
 
-    /**
-     * 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
-     */
-
-    /**
-     * The maximum number of iterations for a loops
-     */
-    var LOOP_LIMIT = 1000;
-
-    /**
-     * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
-     */
-    var PromptbookLogicError = /** @class */ (function (_super) {
-        __extends(PromptbookLogicError, _super);
-        function PromptbookLogicError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PromptbookLogicError';
-            Object.setPrototypeOf(_this, PromptbookLogicError.prototype);
-            return _this;
-        }
-        return PromptbookLogicError;
-    }(Error));
-
     /**
      * This error type indicates that the error should not happen and its last check before crashing with some other error
      */
@@ -337,7 +269,7 @@
      * @returns the same promptbook if it is logically valid
      * @throws {PromptbookLogicError} on logical error in the promptbook
      */
-    function validatePromptbookJson(promptbook) {
+    function validatePromptbook(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) {
@@ -401,8 +333,7 @@
                     throw new PromptbookLogicError("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
                 }
                 definedParameters.add(template.resultingParameterName);
-                if (template.executionType === 'PROMPT_TEMPLATE' &&
-                    (template.modelRequirements.modelVariant === undefined)) {
+                if (template.executionType === 'PROMPT_TEMPLATE' && template.modelRequirements.modelVariant === undefined) {
                     throw new PromptbookLogicError(spaceTrim.spaceTrim("\n\n                  You must specify MODEL VARIANT in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
                 }
                 if (template.jokers && template.jokers.length > 0) {
@@ -472,7 +403,7 @@
         var loopLimit = LOOP_LIMIT;
         var _loop_2 = function () {
             if (loopLimit-- < 0) {
-                throw new UnexpectedError('Loop limit reached during detection of circular dependencies in `validatePromptbookJson`');
+                throw new UnexpectedError('Loop limit reached during detection of circular dependencies in `validatePromptbook`');
             }
             var currentlyResovedTemplates = unresovedTemplates.filter(function (template) {
                 return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
@@ -507,7 +438,48 @@
      *     >  * It checks:
      *     >  * -   it has a valid structure
      *     >  * -   ...
-     *     >  ex port function validatePromptbookJson(promptbook: unknown): asserts promptbook is PromptbookJson {
+     *     >  ex port function validatePromptbook(promptbook: unknown): asserts promptbook is PromptbookJson {
+     */
+
+    var promptbookLibrary = [{title:"Prepare Keywords",promptbookUrl:"https://promptbook.studio/promptbook/prepare-keywords.ptbk.md",promptbookVersion:"0.59.0-36",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {content}",resultingParameterName:"keywords"}],knowledge:[]},{title:"Prepare Knowledge from Markdown",promptbookUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.59.0-36",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",resultingParameterName:"knowledge"}],knowledge:[]}];
+
+    /**
+     * 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
      */
 
     /**
@@ -1085,7 +1057,7 @@
         var _this = this;
         var promptbook = options.promptbook, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
         var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? 3 : _b;
-        validatePromptbookJson(promptbook);
+        validatePromptbook(promptbook);
         var promptbookExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
             function executeSingleTemplate(currentTemplate) {
                 return __awaiter(this, void 0, void 0, function () {
@@ -1516,7 +1488,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 validatePromptbook\n                        "));
                                     case 1:
                                         if (!!currentTemplate) return [3 /*break*/, 3];
                                         /* [5] */ return [4 /*yield*/, Promise.race(resolving_1)];
@@ -1606,6 +1578,38 @@
      * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
      */
 
+    /**
+     * 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;
+        }
+    }
+
     /**
      * Makes first letter of a string uppercase
      *
@@ -1845,6 +1849,7 @@
      * Library of promptbooks that groups together promptbooks for an application.
      * This implementation is a very thin wrapper around the Array / Map of promptbooks.
      *
+     * @private use `createLibraryFromJson` instead
      * @see https://github.com/webgptorg/promptbook#promptbook-library
      */
     var SimplePromptbookLibrary = /** @class */ (function () {
@@ -1853,8 +1858,9 @@
          *
          * @param promptbooks !!!
          *
+         * @private Use instead `createLibraryFromJson`
          * Note: During the construction logic of all promptbooks are validated
-         * Note: It is not recommended to use this constructor directly, use `createPromptbookLibraryFromSources` *(or other variant)* instead
+         * Note: It is not recommended to use this constructor directly, use `createLibraryFromJson` *(or other variant)* instead
          */
         function SimplePromptbookLibrary() {
             var e_1, _a;
@@ -1869,7 +1875,7 @@
                     if (promptbook.promptbookUrl === undefined) {
                         throw new PromptbookReferenceError(spaceTrim.spaceTrim("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the promptbook library\n\n                    ")));
                     }
-                    validatePromptbookJson(promptbook);
+                    validatePromptbook(promptbook);
                     // Note: [🦄]
                     if (this.library.has(promptbook.promptbookUrl) &&
                         promptbookJsonToString(promptbook) !==
@@ -1923,68 +1929,19 @@
     /**
      * Creates PromptbookLibrary from array of PromptbookJson or PromptbookString
      *
-     * Note: You can combine `PromptbookString` (`.ptbk.md`) with `PromptbookJson` BUT it is not recommended
+     * Note: Functions `libraryToJson` and `createLibraryFromJson` are complementary
      * Note: During the construction syntax and logic of all sources are validated
      *
      * @param promptbookSources
      * @returns PromptbookLibrary
      */
-    function createPromptbookLibraryFromSources() {
-        var promptbookSources = [];
+    function createLibraryFromJson() {
+        var promptbooks = [];
         for (var _i = 0; _i < arguments.length; _i++) {
-            promptbookSources[_i] = arguments[_i];
+            promptbooks[_i] = arguments[_i];
         }
-        return __awaiter(this, void 0, void 0, function () {
-            var promptbooks, promptbookSources_1, promptbookSources_1_1, source, promptbook, e_1_1;
-            var e_1, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        promptbooks = new Array();
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 8, 9, 10]);
-                        promptbookSources_1 = __values(promptbookSources), promptbookSources_1_1 = promptbookSources_1.next();
-                        _b.label = 2;
-                    case 2:
-                        if (!!promptbookSources_1_1.done) return [3 /*break*/, 7];
-                        source = promptbookSources_1_1.value;
-                        promptbook = void 0;
-                        if (!(typeof source === 'string')) return [3 /*break*/, 4];
-                        return [4 /*yield*/, promptbookStringToJson(source)];
-                    case 3:
-                        // Note: When directly creating from string, no need to validate the source
-                        //       The validation is performed always before execution
-                        promptbook = _b.sent();
-                        return [3 /*break*/, 5];
-                    case 4:
-                        promptbook = source;
-                        _b.label = 5;
-                    case 5:
-                        promptbooks.push(promptbook);
-                        _b.label = 6;
-                    case 6:
-                        promptbookSources_1_1 = promptbookSources_1.next();
-                        return [3 /*break*/, 2];
-                    case 7: return [3 /*break*/, 10];
-                    case 8:
-                        e_1_1 = _b.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 10];
-                    case 9:
-                        try {
-                            if (promptbookSources_1_1 && !promptbookSources_1_1.done && (_a = promptbookSources_1.return)) _a.call(promptbookSources_1);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                        return [7 /*endfinally*/];
-                    case 10: return [2 /*return*/, new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))()];
-                }
-            });
-        });
+        return new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))();
     }
-    /**
-     * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
-     */
 
     /* tslint:disable */
     function normalizeToKebabCase(sentence) {
@@ -2043,85 +2000,100 @@
 
     function prepareKnowledgeFromMarkdown(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var content, llmTools, library, promptbook, executor, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
+            var content, llmTools, _a, isVerbose, library, prepareKnowledgeFromMarkdownPromptbook, prepareKnowledgeFromMarkdownExecutor, prepareKeywordsPromptbook, prepareKeywordsExecutor, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
             var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
-                        content = options.content, llmTools = options.llmTools;
-                        return [4 /*yield*/, createPromptbookLibraryFromSources(
-                            /* !!!! ...(promptbookLibrary as Array<PromptbookJson>)*/ {
-                                title: 'Prepare Knowledge from Markdown',
-                                promptbookUrl: 'https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md',
-                                promptbookVersion: '0.59.0-5',
-                                parameters: [
-                                    { name: 'content', description: 'Markdown document content', isInput: true, isOutput: false },
-                                    { name: 'knowledge', description: 'The knowledge JSON object', isInput: false, isOutput: true },
-                                ],
-                                promptTemplates: [
-                                    {
-                                        name: 'knowledge',
-                                        title: 'Knowledge',
-                                        dependentParameterNames: ['content'],
-                                        executionType: 'PROMPT_TEMPLATE',
-                                        modelRequirements: { modelVariant: 'CHAT', modelName: 'claude-3-opus-20240229' },
-                                        content: 'You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}',
-                                        resultingParameterName: 'knowledge',
-                                    },
-                                ],
-                                knowledge: [],
-                            })];
+                        content = options.content, llmTools = options.llmTools, _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
+                        library = createLibraryFromJson.apply(void 0, __spreadArray([], __read(promptbookLibrary), false));
+                        return [4 /*yield*/, library.getPromptbookByUrl('https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md')];
                     case 1:
-                        library = _a.sent();
-                        promptbook = library.getPromptbookByUrl('https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md');
-                        executor = createPromptbookExecutor({
-                            promptbook: promptbook,
+                        prepareKnowledgeFromMarkdownPromptbook = _b.sent();
+                        prepareKnowledgeFromMarkdownExecutor = createPromptbookExecutor({
+                            promptbook: prepareKnowledgeFromMarkdownPromptbook,
                             tools: {
                                 llm: llmTools,
                                 script: [
-                                /* <- TODO: Allow to just not define script tools */
+                                /* <- TODO: Allow to just keep script undefined */
                                 ],
                             },
                         });
-                        return [4 /*yield*/, executor({ content: content })];
+                        return [4 /*yield*/, library.getPromptbookByUrl('https://promptbook.studio/promptbook/prepare-keywords.ptbk.md')];
                     case 2:
-                        result = _a.sent();
+                        prepareKeywordsPromptbook = _b.sent();
+                        prepareKeywordsExecutor = createPromptbookExecutor({
+                            promptbook: prepareKeywordsPromptbook,
+                            tools: {
+                                llm: llmTools,
+                                script: [
+                                /* <- TODO: Allow to just keep script undefined */
+                                ],
+                            },
+                        });
+                        return [4 /*yield*/, prepareKnowledgeFromMarkdownExecutor({ content: content })];
+                    case 3:
+                        result = _b.sent();
                         assertsExecutionSuccessful(result);
                         outputParameters = result.outputParameters;
                         knowledgeRaw = outputParameters.knowledge;
                         knowledgeTextPieces = (knowledgeRaw || '').split('\n---\n');
+                        if (isVerbose) {
+                            console.info('knowledgeTextPieces:', knowledgeTextPieces);
+                        }
                         return [4 /*yield*/, Promise.all(knowledgeTextPieces.map(function (knowledgeTextPiece, i) { return __awaiter(_this, void 0, void 0, function () {
-                                var name, title, content, keywords, index, sources;
-                                return __generator(this, function (_a) {
-                                    name = "piece-".concat(i);
-                                    title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 100));
-                                    content = spaceTrim__default["default"](knowledgeTextPiece);
-                                    keywords = [];
-                                    index = [];
-                                    sources = [];
-                                    try {
-                                        // TODO: !!!! Summarize name and title from the content
-                                        title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 30));
-                                        name = normalizeToKebabCase(title);
-                                        // TODO: !!!! Extract keywords via prompt
-                                        // TODO: !!!! Index through LLM model
-                                        // TODO: [🖖] !!!! Make system for sources and identification of sources
-                                    }
-                                    catch (error) {
-                                        console.error(error);
+                                var name, title, content, keywords, index, sources, result_1, _a, outputParameters_1, keywordsRaw, error_1;
+                                return __generator(this, function (_b) {
+                                    switch (_b.label) {
+                                        case 0:
+                                            name = "piece-".concat(i);
+                                            title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 100));
+                                            content = spaceTrim__default["default"](knowledgeTextPiece);
+                                            keywords = [];
+                                            index = [];
+                                            sources = [];
+                                            _b.label = 1;
+                                        case 1:
+                                            _b.trys.push([1, 3, , 4]);
+                                            // TODO: !!!! Summarize name and title from the content
+                                            title = spaceTrim__default["default"](knowledgeTextPiece.substring(0, 30));
+                                            name = normalizeToKebabCase(title);
+                                            return [4 /*yield*/, prepareKeywordsExecutor({ content: content })];
+                                        case 2:
+                                            result_1 = _b.sent();
+                                            _a = result_1.outputParameters, outputParameters_1 = _a === void 0 ? {} : _a;
+                                            keywordsRaw = outputParameters_1.keywords;
+                                            keywords = (keywordsRaw || '')
+                                                .split(',')
+                                                .map(function (keyword) { return keyword.trim(); })
+                                                .filter(function (keyword) { return keyword !== ''; });
+                                            if (isVerbose) {
+                                                console.info("Keywords for \"".concat(title, "\":"), keywords);
+                                            }
+                                            // ---
+                                            // TODO: !!!! Index through LLM model
+                                            index.push({
+                                                modelName: 'fake-model',
+                                                position: new Array(25).fill(0).map(function () { return Math.random() * 2 - 1; }),
+                                            });
+                                            return [3 /*break*/, 4];
+                                        case 3:
+                                            error_1 = _b.sent();
+                                            console.error(error_1);
+                                            return [3 /*break*/, 4];
+                                        case 4: return [2 /*return*/, {
+                                                name: name,
+                                                title: title,
+                                                content: content,
+                                                keywords: keywords,
+                                                index: index,
+                                                sources: sources,
+                                            }];
                                     }
-                                    return [2 /*return*/, {
-                                            name: name,
-                                            title: title,
-                                            content: content,
-                                            keywords: keywords,
-                                            index: index,
-                                            sources: sources,
-                                        }];
                                 });
                             }); }))];
-                    case 3:
-                        knowledge = _a.sent();
+                    case 4:
+                        knowledge = _b.sent();
                         return [2 /*return*/, knowledge];
                 }
             });
@@ -2362,12 +2334,22 @@
      */
 
     /**
-     * Creates a new set with all elements that are present in either set
+     * Removes HTML or Markdown comments from a string.
+     *
+     * @param {string} content - The string to remove comments from.
+     * @returns {string} The input string with all comments removed.
      */
-    function union() {
-        var e_1, _a, e_2, _b;
-        var sets = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
+    function removeContentComments(content) {
+        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+    }
+
+    /**
+     * Creates a new set with all elements that are present in either set
+     */
+    function union() {
+        var e_1, _a, e_2, _b;
+        var sets = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
             sets[_i] = arguments[_i];
         }
         var union = new Set();
@@ -2960,9 +2942,279 @@
         return value;
     }
 
+    /**
+     * Compile promptbook from string (markdown) format to JSON format synchronously
+     *
+     * Note: There are two similar functions:
+     * - `promptbookStringToJson` **(preferred)** - which propperly compiles the promptbook and use embedding for external knowledge
+     * - `promptbookStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
+     *
+     * @param promptbookString {Promptbook} in string markdown format (.ptbk.md)
+     * @param options - Options and tools for the compilation
+     * @returns {Promptbook} compiled in JSON format (.ptbk.json)
+     * @throws {PromptbookSyntaxError} if the promptbook string is not valid
+     *
+     * Note: This function does not validate logic of the pipeline only the syntax
+     * Note: This function acts as compilation process
+     */
+    function promptbookStringToJsonSync(promptbookString) {
+        var e_1, _a, e_2, _b;
+        var promptbookJson = {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
+            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
+            promptbookVersion: PROMPTBOOK_VERSION,
+            description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
+            parameters: [],
+            promptTemplates: [],
+            knowledge: [],
+        };
+        // =============================================================
+        // Note: 1️⃣ Normalization of the PROMPTBOOK string
+        promptbookString = removeContentComments(promptbookString);
+        promptbookString = promptbookString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
+        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
+        // =============================================================
+        ///Note: 2️⃣ Function for adding parameters
+        var addParam = function (parameterCommand) {
+            var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInput = parameterCommand.isInput, isOutput = parameterCommand.isOutput;
+            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+            if (existingParameter &&
+                existingParameter.description &&
+                existingParameter.description !== parameterDescription &&
+                parameterDescription) {
+                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+            }
+            if (existingParameter) {
+                if (parameterDescription) {
+                    existingParameter.description = parameterDescription;
+                }
+            }
+            else {
+                promptbookJson.parameters.push({
+                    name: parameterName,
+                    description: parameterDescription || undefined,
+                    isInput: isInput,
+                    isOutput: isOutput,
+                });
+            }
+        };
+        // =============================================================
+        // Note: 3️⃣ Parse the dynamic part - the template pipeline
+        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            ")));
+        }
+        promptbookJson.title = markdownStructure.title;
+        // TODO: [1] DRY description
+        var description = markdownStructure.content;
+        // Note: Remove codeblocks
+        description = description.split(/^```.*^```/gms).join('');
+        //Note: Remove lists and return statement
+        description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+        description = spaceTrim.spaceTrim(description);
+        if (description === '') {
+            description = undefined;
+        }
+        promptbookJson.description = description;
+        var defaultModelRequirements = {};
+        var listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
+        try {
+            for (var listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
+                var listItem = listItems_1_1.value;
+                var command = parseCommand(listItem);
+                switch (command.type) {
+                    case 'PROMPTBOOK_URL':
+                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
+                        break;
+                    case 'PROMPTBOOK_VERSION':
+                        promptbookJson.promptbookVersion = command.promptbookVersion;
+                        break;
+                    case 'MODEL':
+                        defaultModelRequirements[command.key] = command.value;
+                        break;
+                    case 'PARAMETER':
+                        addParam(command);
+                        break;
+                    default:
+                        throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (listItems_1_1 && !listItems_1_1.done && (_a = listItems_1.return)) _a.call(listItems_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var _loop_1 = function (section) {
+            var e_3, _e;
+            // TODO: Parse prompt template description (the content out of the codeblock and lists)
+            var templateModelRequirements = __assign({}, defaultModelRequirements);
+            var listItems_3 = extractAllListItemsFromMarkdown(section.content);
+            var dependentParameterNames = new Set();
+            var executionType = 'PROMPT_TEMPLATE';
+            var jokers = [];
+            var postprocessing = [];
+            var expectAmount = {};
+            var expectFormat = undefined;
+            var isExecutionTypeChanged = false;
+            try {
+                for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
+                    var listItem = listItems_2_1.value;
+                    var command = parseCommand(listItem);
+                    switch (command.type) {
+                        case 'JOKER':
+                            jokers.push(command.parameterName);
+                            dependentParameterNames.add(command.parameterName);
+                            break;
+                        case 'EXECUTE':
+                            if (isExecutionTypeChanged) {
+                                throw new PromptbookSyntaxError('Execution type is already defined in the prompt template. It can be defined only once.');
+                            }
+                            executionType = command.executionType;
+                            isExecutionTypeChanged = true;
+                            break;
+                        case 'MODEL':
+                            templateModelRequirements[command.key] = command.value;
+                            break;
+                        case 'PARAMETER':
+                            // Note: This is just for detecting resulitng parameter name
+                            addParam(command);
+                            break;
+                        case 'POSTPROCESS':
+                            postprocessing.push(command.functionName);
+                            break;
+                        case 'EXPECT_AMOUNT':
+                            // eslint-disable-next-line no-case-declarations
+                            var unit = command.unit.toLowerCase();
+                            expectAmount[unit] = expectAmount[unit] || {};
+                            if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
+                                if (expectAmount[unit].min !== undefined) {
+                                    throw new PromptbookSyntaxError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                }
+                                expectAmount[unit].min = command.amount;
+                            } /* not else */
+                            if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
+                                if (expectAmount[unit].max !== undefined) {
+                                    throw new PromptbookSyntaxError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                                }
+                                expectAmount[unit].max = command.amount;
+                            }
+                            break;
+                        case 'EXPECT_FORMAT':
+                            if (expectFormat !== undefined && command.format !== expectFormat) {
+                                throw new PromptbookSyntaxError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
+                            }
+                            expectFormat = command.format;
+                            break;
+                        default:
+                            throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
+                    }
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (listItems_2_1 && !listItems_2_1.done && (_e = listItems_2.return)) _e.call(listItems_2);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            var _f = extractOneBlockFromMarkdown(section.content), language = _f.language, content = _f.content;
+            if (executionType === 'SCRIPT') {
+                if (!language) {
+                    throw new PromptbookSyntaxError('You must specify the language of the script in the prompt template');
+                }
+                else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
+                    throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
+                }
+            }
+            var lastLine = section.content.split('\n').pop();
+            var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
+            if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
+                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
+                // TODO: Show code of invalid sections each time + DRY
+                section.content
+                    .split('\n')
+                    .map(function (line) { return "> ".concat(line); })
+                    .join('\n')), "\n                        "); }));
+            }
+            var resultingParameterName = match.groups.resultingParamName;
+            // TODO: [1] DRY description
+            var description_1 = section.content;
+            // Note: Remove codeblocks
+            description_1 = description_1.split(/^```.*^```/gms).join('');
+            //Note: Remove lists and return statement
+            description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
+            description_1 = spaceTrim.spaceTrim(description_1);
+            if (description_1 === '') {
+                description_1 = undefined;
+            }
+            if (Object.keys(jokers).length === 0) {
+                jokers = undefined;
+            }
+            if (Object.keys(expectAmount).length === 0) {
+                expectAmount = undefined;
+            }
+            if (Object.keys(postprocessing).length === 0) {
+                postprocessing = undefined;
+            }
+            dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, executionType: executionType, content: content })));
+            if (templateModelRequirements.modelVariant === undefined) {
+                templateModelRequirements.modelVariant = 'CHAT';
+            }
+            var template = {
+                name: titleToName(section.title),
+                title: section.title,
+                description: description_1,
+                dependentParameterNames: Array.from(dependentParameterNames),
+                executionType: executionType,
+                jokers: jokers,
+                postprocessing: postprocessing,
+                expectations: expectAmount,
+                expectFormat: expectFormat,
+                modelRequirements: templateModelRequirements,
+                contentLanguage: executionType === 'SCRIPT' ? language : undefined,
+                content: content,
+                resultingParameterName: resultingParameterName,
+            };
+            if (executionType !== 'PROMPT_TEMPLATE') {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                delete template.modelRequirements;
+            }
+            promptbookJson.promptTemplates.push(template);
+        };
+        try {
+            for (var _c = __values(markdownStructure.sections), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var section = _d.value;
+                _loop_1(section);
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        // =============================================================
+        return promptbookJson;
+    }
+    /**
+     * TODO: Report here line/column of error
+     * TODO: Use spaceTrim more effectively
+     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+     */
+
     /**
      * Compile promptbook from string (markdown) format to JSON format
      *
+     * Note: There are two similar functions:
+     * - `promptbookStringToJson` **(preferred)** - which propperly compiles the promptbook and use embedding for external knowledge
+     * - `promptbookStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
+     *
      * @param promptbookString {Promptbook} in string markdown format (.ptbk.md)
      * @param options - Options and tools for the compilation
      * @returns {Promptbook} compiled in JSON format (.ptbk.json)
@@ -2974,263 +3226,542 @@
     function promptbookStringToJson(promptbookString, options) {
         if (options === void 0) { options = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var llmTools, promptbookJson, knowledge, addParam, markdownStructure, markdownStructureDeepness, description, defaultModelRequirements, listItems, listItems_1, listItems_1_1, listItem, command, _loop_1, _a, _b, section;
-            var e_1, _c, e_2, _d;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
+            var llmTools, knowledge, promptbookJson;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
                     case 0:
                         llmTools = options.llmTools;
-                        promptbookJson = {
-                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
-                            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
-                            promptbookVersion: PROMPTBOOK_VERSION,
-                            description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
-                            parameters: [],
-                            promptTemplates: [],
-                            knowledge: [],
-                        };
                         if (!llmTools) return [3 /*break*/, 2];
                         return [4 /*yield*/, prepareKnowledgeFromMarkdown({
                                 content: 'Roses are red, violets are blue, programmers use Promptbook, users too',
                                 llmTools: llmTools,
                             })];
                     case 1:
-                        knowledge = _e.sent();
+                        knowledge = _a.sent();
                         console.info('!!!! knowledge', knowledge);
-                        _e.label = 2;
+                        _a.label = 2;
                     case 2:
-                        // =============================================================
-                        // Note: 1️⃣ Normalization of the PROMPTBOOK string
-                        promptbookString = removeContentComments(promptbookString);
-                        promptbookString = promptbookString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
-                        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
-                        addParam = function (parameterCommand) {
-                            var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInput = parameterCommand.isInput, isOutput = parameterCommand.isOutput;
-                            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
-                            if (existingParameter &&
-                                existingParameter.description &&
-                                existingParameter.description !== parameterDescription &&
-                                parameterDescription) {
-                                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description.\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
-                            }
-                            if (existingParameter) {
-                                if (parameterDescription) {
-                                    existingParameter.description = parameterDescription;
-                                }
-                            }
-                            else {
-                                promptbookJson.parameters.push({
-                                    name: parameterName,
-                                    description: parameterDescription || undefined,
-                                    isInput: isInput,
-                                    isOutput: isOutput,
-                                });
+                        promptbookJson = promptbookStringToJsonSync(promptbookString);
+                        return [2 /*return*/, promptbookJson];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+     */
+
+    /**
+     * 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));
+
+    /**
+     * Constructs Promptbook from async sources
+     * It can be one of the following:
+     * - Promise of array of PromptbookJson or PromptbookString
+     * - Factory function that returns Promise of array of PromptbookJson or PromptbookString
+     *
+     * Note: This is useful as internal tool for other constructor functions like
+     *       `createLibraryFromUrl` or `createLibraryFromDirectory`
+     *       Consider using those functions instead of this one
+     *
+     * 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  `createLibraryFromDirectory` or `createLibraryFromUrl`
+     *
+     * @param promptbookSourcesPromiseOrFactory
+     * @returns PromptbookLibrary
+     * @deprecated Do not use, it will became internal tool for other constructor functions
+     */
+    function createLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
+        var library;
+        function forSources() {
+            return __awaiter(this, void 0, void 0, function () {
+                var promptbookSources;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (typeof promptbookSourcesPromiseOrFactory === 'function') {
+                                // Note: Calling factory function only once despite multiple calls to resolveSources
+                                promptbookSourcesPromiseOrFactory = promptbookSourcesPromiseOrFactory();
                             }
-                        };
-                        markdownStructure = markdownToMarkdownStructure(promptbookString);
-                        markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
-                        if (markdownStructureDeepness !== 2) {
-                            throw new PromptbookSyntaxError(spaceTrim.spaceTrim("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
-                        }
-                        promptbookJson.title = markdownStructure.title;
-                        description = markdownStructure.content;
-                        // Note: Remove codeblocks
-                        description = description.split(/^```.*^```/gms).join('');
-                        //Note: Remove lists and return statement
-                        description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-                        description = spaceTrim.spaceTrim(description);
-                        if (description === '') {
-                            description = undefined;
+                            return [4 /*yield*/, promptbookSourcesPromiseOrFactory];
+                        case 1:
+                            promptbookSources = _a.sent();
+                            library = createLibraryFromJson.apply(void 0, __spreadArray([], __read(promptbookSources), false));
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        }
+        function listPromptbooks() {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, forSources()];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/, /* not await */ library.listPromptbooks()];
+                    }
+                });
+            });
+        }
+        function getPromptbookByUrl(url) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, forSources()];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/, /* not await */ library.getPromptbookByUrl(url)];
+                    }
+                });
+            });
+        }
+        function isResponsibleForPrompt(prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, forSources()];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/, /* not await */ library.isResponsibleForPrompt(prompt)];
+                    }
+                });
+            });
+        }
+        return {
+            listPromptbooks: listPromptbooks,
+            getPromptbookByUrl: getPromptbookByUrl,
+            isResponsibleForPrompt: isResponsibleForPrompt,
+        };
+    }
+
+    /**
+     * Constructs Promptbook from given directory
+     *
+     * Note: Works only in Node.js environment because it reads the file system
+     *
+     * @param path - path to the directory with promptbooks
+     * @param options - Misc options for the library
+     * @returns PromptbookLibrary
+     */
+    function createLibraryFromDirectory(path$1, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var makedLibraryFilePath, makedLibraryFileExists, _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 `createLibraryFromDirectory` can only be run in Node.js environment because it reads the file system.');
                         }
-                        promptbookJson.description = description;
-                        defaultModelRequirements = {};
-                        listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
-                        try {
-                            for (listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
-                                listItem = listItems_1_1.value;
-                                command = parseCommand(listItem);
-                                switch (command.type) {
-                                    case 'PROMPTBOOK_URL':
-                                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
-                                        break;
-                                    case 'PROMPTBOOK_VERSION':
-                                        promptbookJson.promptbookVersion = command.promptbookVersion;
-                                        break;
-                                    case 'MODEL':
-                                        defaultModelRequirements[command.key] = command.value;
-                                        break;
-                                    case 'PARAMETER':
-                                        addParam(command);
-                                        break;
-                                    default:
-                                        throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
-                                }
-                            }
+                        makedLibraryFilePath = path.join(path$1, "".concat(PROMPTBOOK_MAKED_BASE_FILENAME, ".json"));
+                        return [4 /*yield*/, promises.access(makedLibraryFilePath, promises.constants.R_OK)
+                                .then(function () { return true; })
+                                .catch(function () { return false; })];
+                    case 1:
+                        makedLibraryFileExists = _f.sent();
+                        if (!makedLibraryFileExists) {
+                            console.info(colors__default["default"].yellow("Tip: Prebuild your promptbook library (file with supposed prebuild ".concat(makedLibraryFilePath, " not found) with CLI util \"promptbook make\" to speed up the library creation.")));
                         }
-                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                        finally {
-                            try {
-                                if (listItems_1_1 && !listItems_1_1.done && (_c = listItems_1.return)) _c.call(listItems_1);
-                            }
-                            finally { if (e_1) throw e_1.error; }
+                        else {
+                            colors__default["default"].green("(In future, not implemented yet) Using your prebuild promptbook library ".concat(makedLibraryFilePath));
+                            // TODO: !! Implement;
                         }
-                        _loop_1 = function (section) {
-                            var e_3, _f;
-                            // TODO: Parse prompt template description (the content out of the codeblock and lists)
-                            var templateModelRequirements = __assign({}, defaultModelRequirements);
-                            var listItems_3 = extractAllListItemsFromMarkdown(section.content);
-                            var dependentParameterNames = new Set();
-                            var executionType = 'PROMPT_TEMPLATE';
-                            var jokers = [];
-                            var postprocessing = [];
-                            var expectAmount = {};
-                            var expectFormat = undefined;
-                            var isExecutionTypeChanged = false;
-                            try {
-                                for (var listItems_2 = (e_3 = void 0, __values(listItems_3)), listItems_2_1 = listItems_2.next(); !listItems_2_1.done; listItems_2_1 = listItems_2.next()) {
-                                    var listItem = listItems_2_1.value;
-                                    var command = parseCommand(listItem);
-                                    switch (command.type) {
-                                        case 'JOKER':
-                                            jokers.push(command.parameterName);
-                                            dependentParameterNames.add(command.parameterName);
-                                            break;
-                                        case 'EXECUTE':
-                                            if (isExecutionTypeChanged) {
-                                                throw new PromptbookSyntaxError('Execution type is already defined in the prompt template. It can be defined only once.');
-                                            }
-                                            executionType = command.executionType;
-                                            isExecutionTypeChanged = true;
-                                            break;
-                                        case 'MODEL':
-                                            templateModelRequirements[command.key] = command.value;
-                                            break;
-                                        case 'PARAMETER':
-                                            // Note: This is just for detecting resulitng parameter name
-                                            addParam(command);
-                                            break;
-                                        case 'POSTPROCESS':
-                                            postprocessing.push(command.functionName);
-                                            break;
-                                        case 'EXPECT_AMOUNT':
-                                            // eslint-disable-next-line no-case-declarations
-                                            var unit = command.unit.toLowerCase();
-                                            expectAmount[unit] = expectAmount[unit] || {};
-                                            if (command.sign === 'MINIMUM' || command.sign === 'EXACTLY') {
-                                                if (expectAmount[unit].min !== undefined) {
-                                                    throw new PromptbookSyntaxError("Already defined minumum ".concat(expectAmount[unit].min, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
-                                                }
-                                                expectAmount[unit].min = command.amount;
-                                            } /* not else */
-                                            if (command.sign === 'MAXIMUM' || command.sign === 'EXACTLY') {
-                                                if (expectAmount[unit].max !== undefined) {
-                                                    throw new PromptbookSyntaxError("Already defined maximum ".concat(expectAmount[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
+                        _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 = createLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
+                            var 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$1.split('\\').join('/')));
+                                        }
+                                        return [4 /*yield*/, listAllFiles(path$1, isRecursive)];
+                                    case 1:
+                                        fileNames = _b.sent();
+                                        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, 7, , 8]);
+                                                        promptbook = null;
+                                                        if (!fileName.endsWith('.ptbk.md')) return [3 /*break*/, 3];
+                                                        return [4 /*yield*/, promises.readFile(fileName, 'utf8')];
+                                                    case 1:
+                                                        promptbookString = (_e.sent());
+                                                        return [4 /*yield*/, promptbookStringToJson(promptbookString)];
+                                                    case 2:
+                                                        promptbook = _e.sent();
+                                                        return [3 /*break*/, 6];
+                                                    case 3:
+                                                        if (!fileName.endsWith('.ptbk.json')) return [3 /*break*/, 5];
+                                                        if (isVerbose) {
+                                                            console.info("Loading ".concat(fileName.split('\\').join('/')));
+                                                        }
+                                                        _d = (_c = JSON).parse;
+                                                        return [4 /*yield*/, promises.readFile(fileName, 'utf8')];
+                                                    case 4:
+                                                        // TODO: Handle non-valid JSON files
+                                                        promptbook = _d.apply(_c, [_e.sent()]);
+                                                        return [3 /*break*/, 6];
+                                                    case 5:
+                                                        if (isVerbose) {
+                                                            console.info("Skipping file ".concat(fileName.split('\\').join('/')));
+                                                        }
+                                                        _e.label = 6;
+                                                    case 6:
+                                                        // ---
+                                                        if (promptbook !== null) {
+                                                            if (!promptbook.promptbookUrl) {
+                                                                if (isVerbose) {
+                                                                    console.info("Not loading ".concat(fileName.split('\\').join('/'), " - missing URL"));
+                                                                }
+                                                            }
+                                                            else {
+                                                                if (isVerbose) {
+                                                                    console.info("Loading ".concat(fileName.split('\\').join('/')));
+                                                                }
+                                                                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
+                                                                    validatePromptbook(promptbook);
+                                                                }
+                                                                // Note: [🦄] Promptbook with same url uniqueness will be checked automatically in SimplePromptbookLibrary
+                                                                promptbooks.push(promptbook);
+                                                            }
+                                                        }
+                                                        return [3 /*break*/, 8];
+                                                    case 7:
+                                                        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*/, 8];
+                                                    case 8: return [2 /*return*/];
                                                 }
-                                                expectAmount[unit].max = command.amount;
-                                            }
-                                            break;
-                                        case 'EXPECT_FORMAT':
-                                            if (expectFormat !== undefined && command.format !== expectFormat) {
-                                                throw new PromptbookSyntaxError("Expect format is already defined to \"".concat(expectFormat, "\". Now you try to redefine it by \"").concat(command.format, "\"."));
-                                            }
-                                            expectFormat = command.format;
-                                            break;
-                                        default:
-                                            throw new PromptbookSyntaxError("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
-                                    }
-                                }
-                            }
-                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                            finally {
-                                try {
-                                    if (listItems_2_1 && !listItems_2_1.done && (_f = listItems_2.return)) _f.call(listItems_2);
+                                            });
+                                        };
+                                        _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];
                                 }
-                                finally { if (e_3) throw e_3.error; }
+                            });
+                        }); });
+                        if (!(isLazyLoaded === false)) return [3 /*break*/, 3];
+                        return [4 /*yield*/, library.listPromptbooks()];
+                    case 2:
+                        _f.sent();
+                        _f.label = 3;
+                    case 3: 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 `createLibraryFromDirectory`
+     */
+    function listAllFiles(path$1, isRecursive) {
+        return __awaiter(this, void 0, void 0, function () {
+            var 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: return [4 /*yield*/, promises.readdir(path$1, {
+                            withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
+                        })];
+                    case 1:
+                        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:
+                        _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: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+     */
+
+    /**
+     * Converts PromptbookLibrary to serialized JSON
+     *
+     * Note: Functions `libraryToJson` and `createLibraryFromJson` are complementary
+     */
+    function libraryToJson(library) {
+        return __awaiter(this, void 0, void 0, function () {
+            var promptbookUrls, promptbooks;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, library.listPromptbooks()];
+                    case 1:
+                        promptbookUrls = _a.sent();
+                        return [4 /*yield*/, Promise.all(promptbookUrls.map(function (url) { return library.getPromptbookByUrl(url); }))];
+                    case 2:
+                        promptbooks = _a.sent();
+                        return [2 /*return*/, promptbooks];
+                }
+            });
+        });
+    }
+
+    /**
+     * Initializes `make` command for Promptbook CLI utilities
+     *
+     * @private part of `promptbookCli`
+     */
+    function initializeMake(program) {
+        var _this = this;
+        var helloCommand = program.command('make');
+        helloCommand.description(spaceTrim__default["default"]("\n            Makes a new promptbook library in given folder\n      "));
+        helloCommand.argument('<path>', 'Path to promptbook directory');
+        helloCommand.option('--project-name', "Name of the project for whom library is", 'Project');
+        helloCommand.option('-f, --format <format>', spaceTrim__default["default"]("\n            Output format of builded library \"javascript\", \"typescript\" or \"json\"\n\n            Note: You can use multiple formats separated by comma\n        "), 'javascript' /* <- Note: [🏳‍🌈] */);
+        helloCommand.option('--no-validation', "Do not validate logic of promptbooks in library", true);
+        helloCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
+        helloCommand.option('--verbose', "Is verbose", false);
+        helloCommand.option('-o, --out-file <path>', spaceTrim__default["default"]("\n            Where to save the builded library\n\n            Note: If you keep it \"".concat(PROMPTBOOK_MAKED_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), PROMPTBOOK_MAKED_BASE_FILENAME);
+        // TODO: !!! Auto-detect AI api keys + explicit api keys as argv
+        helloCommand.action(function (path$1, _a) {
+            var projectName = _a.projectName, format = _a.format, validation = _a.validation, verbose = _a.verbose, outFile = _a.outFile;
+            return __awaiter(_this, void 0, void 0, function () {
+                var formats, validations, library, validations_1, validations_1_1, validation_1, _b, _c, promptbookUrl, promptbook, e_1_1, e_2_1, libraryJson, libraryJsonString, saveFile;
+                var e_2, _d, e_1, _e;
+                var _this = this;
+                return __generator(this, function (_f) {
+                    switch (_f.label) {
+                        case 0:
+                            console.info('!!!', { projectName: projectName, path: path$1, format: format, validation: validation, verbose: verbose, outFile: outFile });
+                            formats = (format || '')
+                                .split(',')
+                                .map(function (_) { return _.trim(); })
+                                .filter(function (_) { return _ !== ''; });
+                            validations = (validation || '')
+                                .split(',')
+                                .map(function (_) { return _.trim(); })
+                                .filter(function (_) { return _ !== ''; });
+                            if (outFile !== PROMPTBOOK_MAKED_BASE_FILENAME && formats.length !== 1) {
+                                console.error(colors__default["default"].red("You can use only one format when saving to a file"));
+                                process.exit(1);
                             }
-                            var _g = extractOneBlockFromMarkdown(section.content), language = _g.language, content = _g.content;
-                            if (executionType === 'SCRIPT') {
-                                if (!language) {
-                                    throw new PromptbookSyntaxError('You must specify the language of the script in the prompt template');
+                            return [4 /*yield*/, createLibraryFromDirectory(path$1, {
+                                    isVerbose: verbose,
+                                    isRecursive: true,
+                                })];
+                        case 1:
+                            library = _f.sent();
+                            _f.label = 2;
+                        case 2:
+                            _f.trys.push([2, 14, 15, 16]);
+                            validations_1 = __values(validations), validations_1_1 = validations_1.next();
+                            _f.label = 3;
+                        case 3:
+                            if (!!validations_1_1.done) return [3 /*break*/, 13];
+                            validation_1 = validations_1_1.value;
+                            _f.label = 4;
+                        case 4:
+                            _f.trys.push([4, 10, 11, 12]);
+                            e_1 = void 0;
+                            return [4 /*yield*/, library.listPromptbooks()];
+                        case 5:
+                            _b = (__values.apply(void 0, [_f.sent()])), _c = _b.next();
+                            _f.label = 6;
+                        case 6:
+                            if (!!_c.done) return [3 /*break*/, 9];
+                            promptbookUrl = _c.value;
+                            return [4 /*yield*/, library.getPromptbookByUrl(promptbookUrl)];
+                        case 7:
+                            promptbook = _f.sent();
+                            if (validation_1 === 'logic') {
+                                validatePromptbook(promptbook);
+                                if (verbose) {
+                                    console.info(colors__default["default"].cyan("Validated logic of ".concat(promptbook.promptbookUrl)));
                                 }
-                                else if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                                    throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
-                                }
-                            }
-                            var lastLine = section.content.split('\n').pop();
-                            var match = /^->\s*\{(?<resultingParamName>[a-z0-9_]+)\}/im.exec(lastLine);
-                            if (!match || match.groups === undefined || match.groups.resultingParamName === undefined) {
-                                throw new PromptbookSyntaxError(spaceTrim.spaceTrim(function (block) { return "\n                        Invalid template - each section must end with \"-> {...}\"\n\n                        Invalid section:\n                        ".concat(block(
-                                // TODO: Show code of invalid sections each time + DRY
-                                section.content
-                                    .split('\n')
-                                    .map(function (line) { return "> ".concat(line); })
-                                    .join('\n')), "\n                        "); }));
                             }
-                            var resultingParameterName = match.groups.resultingParamName;
-                            // TODO: [1] DRY description
-                            var description_1 = section.content;
-                            // Note: Remove codeblocks
-                            description_1 = description_1.split(/^```.*^```/gms).join('');
-                            //Note: Remove lists and return statement
-                            description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-                            description_1 = spaceTrim.spaceTrim(description_1);
-                            if (description_1 === '') {
-                                description_1 = undefined;
-                            }
-                            if (Object.keys(jokers).length === 0) {
-                                jokers = undefined;
-                            }
-                            if (Object.keys(expectAmount).length === 0) {
-                                expectAmount = undefined;
-                            }
-                            if (Object.keys(postprocessing).length === 0) {
-                                postprocessing = undefined;
-                            }
-                            dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, executionType: executionType, content: content })));
-                            if (templateModelRequirements.modelVariant === undefined) {
-                                templateModelRequirements.modelVariant = 'CHAT';
-                            }
-                            promptbookJson.promptTemplates.push({
-                                name: titleToName(section.title),
-                                title: section.title,
-                                description: description_1,
-                                dependentParameterNames: Array.from(dependentParameterNames),
-                                executionType: executionType,
-                                jokers: jokers,
-                                postprocessing: postprocessing,
-                                expectations: expectAmount,
-                                expectFormat: expectFormat,
-                                modelRequirements: templateModelRequirements,
-                                contentLanguage: executionType === 'SCRIPT' ? language : undefined,
-                                content: content,
-                                resultingParameterName: resultingParameterName,
-                            });
-                        };
-                        try {
-                            for (_a = __values(markdownStructure.sections), _b = _a.next(); !_b.done; _b = _a.next()) {
-                                section = _b.value;
-                                _loop_1(section);
+                            _f.label = 8;
+                        case 8:
+                            _c = _b.next();
+                            return [3 /*break*/, 6];
+                        case 9: return [3 /*break*/, 12];
+                        case 10:
+                            e_1_1 = _f.sent();
+                            e_1 = { error: e_1_1 };
+                            return [3 /*break*/, 12];
+                        case 11:
+                            try {
+                                if (_c && !_c.done && (_e = _b.return)) _e.call(_b);
                             }
-                        }
-                        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-                        finally {
+                            finally { if (e_1) throw e_1.error; }
+                            return [7 /*endfinally*/];
+                        case 12:
+                            validations_1_1 = validations_1.next();
+                            return [3 /*break*/, 3];
+                        case 13: return [3 /*break*/, 16];
+                        case 14:
+                            e_2_1 = _f.sent();
+                            e_2 = { error: e_2_1 };
+                            return [3 /*break*/, 16];
+                        case 15:
                             try {
-                                if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
+                                if (validations_1_1 && !validations_1_1.done && (_d = validations_1.return)) _d.call(validations_1);
                             }
                             finally { if (e_2) throw e_2.error; }
-                        }
-                        // =============================================================
-                        return [2 /*return*/, promptbookJson];
-                }
+                            return [7 /*endfinally*/];
+                        case 16: return [4 /*yield*/, libraryToJson(library)];
+                        case 17:
+                            libraryJson = _f.sent();
+                            libraryJsonString = JSON.stringify(libraryJson);
+                            saveFile = function (extension, content) { return __awaiter(_this, void 0, void 0, function () {
+                                var filePath;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0:
+                                            filePath = outFile !== PROMPTBOOK_MAKED_BASE_FILENAME
+                                                ? outFile
+                                                : path.join(path$1, "".concat(PROMPTBOOK_MAKED_BASE_FILENAME, ".").concat(extension));
+                                            if (!outFile.endsWith(".".concat(extension))) {
+                                                console.warn(colors__default["default"].yellow("Warning: Extension of output file should be \"".concat(extension, "\"")));
+                                            }
+                                            return [4 /*yield*/, promises.mkdir(path.dirname(filePath), { recursive: true })];
+                                        case 1:
+                                            _a.sent();
+                                            return [4 /*yield*/, promises.writeFile(filePath, content, 'utf-8')];
+                                        case 2:
+                                            _a.sent();
+                                            // Note: Log despite of verbose mode
+                                            console.info(colors__default["default"].green("Maked ".concat(filePath.split('\\').join('/'))));
+                                            return [2 /*return*/];
+                                    }
+                                });
+                            }); };
+                            if (!formats.includes('json')) return [3 /*break*/, 19];
+                            return [4 /*yield*/, saveFile('json', libraryJsonString + '\n')];
+                        case 18:
+                            _f.sent();
+                            _f.label = 19;
+                        case 19:
+                            if (!formats.includes('javascript')) return [3 /*break*/, 21];
+                            return [4 /*yield*/, saveFile('js', spaceTrim__default["default"]("\n                        import { createLibraryFromJson } from '@promptbook/core';\n\n                        /**\n                         * Promptbook library for ".concat(projectName, "\n                         *\n                         * @private internal cache for `getPromptbookLibrary`\n                         */\n                        let promptbookLibrary = null;\n\n\n                        /**\n                         *  Get promptbook library for ").concat(projectName, "\n                         *\n                         *  @returns {PromptbookLibrary} Library of promptbooks for ").concat(projectName, "\n                         *  @generated by `@promptbook/cli`\n                         */\n                        export function getPromptbookLibrary(){\n                            if(promptbookLibrary===null){\n                                promptbookLibrary = createLibraryFromJson(").concat(libraryJsonString.substring(1, libraryJsonString.length - 1), ");\n                            }\n\n                            return promptbookLibrary;\n                        }\n                    ") + '\n'))];
+                        case 20:
+                            _f.sent();
+                            _f.label = 21;
+                        case 21:
+                            if (!formats.includes('typescript')) return [3 /*break*/, 23];
+                            return [4 /*yield*/, saveFile('ts', spaceTrim__default["default"]("\n                        import { createLibraryFromJson } from '@promptbook/core';\n                        import type { PromptbookLibrary } from '@promptbook/types';\n\n                        /**\n                         * Promptbook library for ".concat(projectName, "\n                         *\n                         * @private internal cache for `getPromptbookLibrary`\n                         */\n                        let promptbookLibrary: null | PromptbookLibrary = null;\n\n\n                        /**\n                         *  Get promptbook library for ").concat(projectName, "\n                         *\n                         *  @returns {PromptbookLibrary} Library of promptbooks for ").concat(projectName, "\n                         *  @generated by `@promptbook/cli`\n                         */\n                        export function getPromptbookLibrary(): PromptbookLibrary{\n                            if(promptbookLibrary===null){\n                                promptbookLibrary = createLibraryFromJson(").concat(libraryJsonString.substring(1, libraryJsonString.length - 1), ");\n                            }\n\n                            return promptbookLibrary;\n                        }\n                    ") + '\n'))];
+                        case 22:
+                            _f.sent();
+                            _f.label = 23;
+                        case 23:
+                            process.exit(0);
+                            return [2 /*return*/];
+                    }
+                });
             });
         });
     }
+
     /**
-     * TODO: Report here line/column of error
-     * TODO: Use spaceTrim more effectively
-     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+     * Add or modify an auto-generated section in a markdown file
+     *
+     * @private within the library
      */
+    function addAutoGeneratedSection(content, options) {
+        var sectionName = options.sectionName, sectionContent = options.sectionContent;
+        var warningLine = "<!-- \u26A0\uFE0F WARNING: This section was auto-generated -->";
+        var sectionRegex = new RegExp("<!--".concat(sectionName, "-->([\\s\\S]*?)<!--/").concat(sectionName, "-->"), 'g');
+        var sectionMatch = content.match(sectionRegex);
+        if (sectionMatch) {
+            return content.replace(sectionRegex, spaceTrim.spaceTrim(function (block) { return "\n                    <!--".concat(sectionName, "-->\n                    ").concat(block(warningLine), "\n                    ").concat(block(sectionContent), "\n                    <!--/").concat(sectionName, "-->\n                "); }));
+        }
+        var placeForSection = removeContentComments(content).match(/^##.*$/im);
+        if (!placeForSection) {
+            throw new Error("No place where to put the section <!--".concat(sectionName, "-->"));
+        }
+        var _a = __read(placeForSection, 1), heading = _a[0];
+        return content.replace(heading, "<!--".concat(sectionName, "-->\n").concat(warningLine, "\n").concat(sectionContent, "\n<!--/").concat(sectionName, "-->\n\n").concat(heading));
+    }
 
     /* tslint:disable */
     function normalizeTo_camelCase(sentence, __firstLetterCapital) {
@@ -3356,7 +3887,7 @@
                     case 0:
                         isGraphAdded = options.isGraphAdded, isPrettifyed = options.isPrettifyed;
                         if (!isGraphAdded) return [3 /*break*/, 2];
-                        return [4 /*yield*/, promptbookStringToJson(promptbookString /* , {!!!!} */)];
+                        return [4 /*yield*/, promptbookStringToJson(promptbookString)];
                     case 1:
                         promptbookJson = _a.sent();
                         promptbookMermaid_1 = renderPromptbookMermaid(promptbookJson, {
@@ -3385,117 +3916,106 @@
      */
 
     /**
-     * Runs CLI script for prettifying promptbooks
+     * Initializes `prettify` command for Promptbook CLI utilities
+     *
+     * @private part of `promptbookCli`
      */
-    function prettifyPromptbookStringCli() {
+    function initializePrettify(program) {
+        var _this = this;
+        var prettifyCommand = program.command('prettify');
+        prettifyCommand.description(spaceTrim__default["default"]("\n            Iterates over promptbooks and does multiple enhancing operations on them:\n\n            1) Adds Mermaid graph\n            2) Prettifies the markdown\n      "));
+        prettifyCommand.argument('<filesGlob>', 'Promptbooks to prettify as glob pattern');
+        prettifyCommand.option('-i, --ignore <glob>', "Ignore as glob pattern");
+        prettifyCommand.action(function (filesGlob, _a) {
+            var ignore = _a.ignore;
+            return __awaiter(_this, void 0, void 0, function () {
+                var filePaths, filePaths_1, filePaths_1_1, filePath, promptbookMarkdown, error_1, e_1_1;
+                var e_1, _b;
+                return __generator(this, function (_c) {
+                    switch (_c.label) {
+                        case 0: return [4 /*yield*/, glob__default["default"](filesGlob, { ignore: ignore })];
+                        case 1:
+                            filePaths = _c.sent();
+                            _c.label = 2;
+                        case 2:
+                            _c.trys.push([2, 11, 12, 13]);
+                            filePaths_1 = __values(filePaths), filePaths_1_1 = filePaths_1.next();
+                            _c.label = 3;
+                        case 3:
+                            if (!!filePaths_1_1.done) return [3 /*break*/, 10];
+                            filePath = filePaths_1_1.value;
+                            if (!filePath.endsWith('.ptbk.md')) {
+                                console.warn(colors__default["default"].yellow("Skipping prettify of non-promptbook ".concat(filePath)));
+                                return [3 /*break*/, 9];
+                            }
+                            return [4 /*yield*/, promises.readFile(filePath, 'utf-8')];
+                        case 4:
+                            promptbookMarkdown = (_c.sent());
+                            _c.label = 5;
+                        case 5:
+                            _c.trys.push([5, 8, , 9]);
+                            return [4 /*yield*/, prettifyPromptbookString(promptbookMarkdown, {
+                                    isGraphAdded: true,
+                                    isPrettifyed: true,
+                                    // <- [🕌]
+                                })];
+                        case 6:
+                            promptbookMarkdown = _c.sent();
+                            return [4 /*yield*/, promises.writeFile(filePath, promptbookMarkdown)];
+                        case 7:
+                            _c.sent();
+                            console.info(colors__default["default"].green("Prettify ".concat(filePath)));
+                            return [3 /*break*/, 9];
+                        case 8:
+                            error_1 = _c.sent();
+                            if (!(error_1 instanceof Error)) {
+                                throw error_1;
+                            }
+                            console.info(colors__default["default"].red("Prettify ".concat(error_1.name, " ").concat(filePath)));
+                            console.error(colors__default["default"].bgRed(error_1.name));
+                            console.error(error_1);
+                            process.exit(1);
+                            return [3 /*break*/, 9];
+                        case 9:
+                            filePaths_1_1 = filePaths_1.next();
+                            return [3 /*break*/, 3];
+                        case 10: return [3 /*break*/, 13];
+                        case 11:
+                            e_1_1 = _c.sent();
+                            e_1 = { error: e_1_1 };
+                            return [3 /*break*/, 13];
+                        case 12:
+                            try {
+                                if (filePaths_1_1 && !filePaths_1_1.done && (_b = filePaths_1.return)) _b.call(filePaths_1);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                            return [7 /*endfinally*/];
+                        case 13:
+                            process.exit(0);
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        });
+    }
+
+    /**
+     * Runs CLI utilities of Promptbook package
+     */
+    function promptbookCli() {
         return __awaiter(this, void 0, void 0, function () {
-            var program, prettifyCommand, helloCommand;
-            var _this = this;
+            var program;
             return __generator(this, function (_a) {
                 if (!isRunningInNode()) {
-                    throw new Error(spaceTrim.spaceTrim("\n                Function prettifyPromptbookStringCli is initiator of CLI script and should be run in Node.js environment.\n\n                - In browser use prettifyPromptbookString.\n\n            "));
+                    throw new Error(spaceTrim.spaceTrim("\n                Function promptbookCli is initiator of CLI script and should be run in Node.js environment.\n\n                - In browser use function exported from `@promptbook/utils` or  `@promptbook/core` directly, for example `prettifyPromptbookString`.\n\n            "));
                 }
                 program = new commander__default["default"].Command();
                 program.name('promptbook');
                 program.version(PROMPTBOOK_VERSION);
-                program.description(spaceTrim.spaceTrim("\n            Promptbook utilities\n        "));
-                prettifyCommand = program.command('prettify');
-                prettifyCommand.description(spaceTrim.spaceTrim("\n            Iterates over promptbooks and does multiple enhancing operations on them:\n            1) Adds Mermaid graph\n            2) Prettifies the markdown\n        "));
-                prettifyCommand.argument('<filesGlob>', 'Promptbooks to prettify as glob pattern');
-                prettifyCommand.option('-i, --ignore <glob>', "Ignore as glob pattern");
-                prettifyCommand.action(function (filesGlob, _a) {
-                    var ignore = _a.ignore;
-                    return __awaiter(_this, void 0, void 0, function () {
-                        var filePaths, filePaths_1, filePaths_1_1, filePath, promptbookMarkdown, error_1, e_1_1;
-                        var e_1, _b;
-                        return __generator(this, function (_c) {
-                            switch (_c.label) {
-                                case 0: return [4 /*yield*/, glob__default["default"](filesGlob, { ignore: ignore })];
-                                case 1:
-                                    filePaths = _c.sent();
-                                    _c.label = 2;
-                                case 2:
-                                    _c.trys.push([2, 11, 12, 13]);
-                                    filePaths_1 = __values(filePaths), filePaths_1_1 = filePaths_1.next();
-                                    _c.label = 3;
-                                case 3:
-                                    if (!!filePaths_1_1.done) return [3 /*break*/, 10];
-                                    filePath = filePaths_1_1.value;
-                                    if (!filePath.endsWith('.ptbk.md')) {
-                                        console.warn(colors__default["default"].yellow("Skipping prettify of non-promptbook ".concat(filePath)));
-                                        return [3 /*break*/, 9];
-                                    }
-                                    return [4 /*yield*/, promises.readFile(filePath, 'utf-8')];
-                                case 4:
-                                    promptbookMarkdown = (_c.sent());
-                                    _c.label = 5;
-                                case 5:
-                                    _c.trys.push([5, 8, , 9]);
-                                    return [4 /*yield*/, prettifyPromptbookString(promptbookMarkdown, {
-                                            isGraphAdded: true,
-                                            isPrettifyed: true,
-                                            // <- [🕌]
-                                        })];
-                                case 6:
-                                    promptbookMarkdown = _c.sent();
-                                    return [4 /*yield*/, promises.writeFile(filePath, promptbookMarkdown)];
-                                case 7:
-                                    _c.sent();
-                                    console.info(colors__default["default"].green("Prettify ".concat(filePath)));
-                                    return [3 /*break*/, 9];
-                                case 8:
-                                    error_1 = _c.sent();
-                                    if (!(error_1 instanceof Error)) {
-                                        throw error_1;
-                                    }
-                                    console.info(colors__default["default"].red("Prettify ".concat(error_1.name, " ").concat(filePath)));
-                                    console.error(colors__default["default"].bgRed(error_1.name));
-                                    console.error(error_1);
-                                    process.exit(1);
-                                    return [3 /*break*/, 9];
-                                case 9:
-                                    filePaths_1_1 = filePaths_1.next();
-                                    return [3 /*break*/, 3];
-                                case 10: return [3 /*break*/, 13];
-                                case 11:
-                                    e_1_1 = _c.sent();
-                                    e_1 = { error: e_1_1 };
-                                    return [3 /*break*/, 13];
-                                case 12:
-                                    try {
-                                        if (filePaths_1_1 && !filePaths_1_1.done && (_b = filePaths_1.return)) _b.call(filePaths_1);
-                                    }
-                                    finally { if (e_1) throw e_1.error; }
-                                    return [7 /*endfinally*/];
-                                case 13:
-                                    process.exit(0);
-                                    return [2 /*return*/];
-                            }
-                        });
-                    });
-                });
-                helloCommand = program.command('hello');
-                helloCommand.description(spaceTrim.spaceTrim("\n            Just command for testing\n        "));
-                helloCommand.argument('<name>', 'Your name');
-                helloCommand.option('-g, --greeting <greeting>', "Greeting", 'Hello');
-                helloCommand.action(function (name, _a) {
-                    var greeting = _a.greeting;
-                    return __awaiter(_this, void 0, void 0, function () {
-                        return __generator(this, function (_b) {
-                            switch (_b.label) {
-                                case 0:
-                                    console.info(colors__default["default"].cyan("".concat(greeting, " ").concat(name)));
-                                    return [4 /*yield*/, waitasecond.forTime(1000)];
-                                case 1:
-                                    _b.sent();
-                                    console.info(colors__default["default"].rainbow("Nice to meet you!"));
-                                    process.exit(0);
-                                    return [2 /*return*/];
-                            }
-                        });
-                    });
-                });
-                //------
+                program.description(spaceTrim.spaceTrim("\n            Promptbook utilities for enhancing workflow with promptbooks\n        "));
+                initializeHello(program);
+                initializeMake(program);
+                initializePrettify(program);
                 program.parse(process.argv);
                 return [2 /*return*/];
             });
@@ -3511,13 +4031,13 @@
     /**
      * Hidden utilities which should not be used by external consumers.
      */
-    var __ = {
+    var __CLI = {
         // Note: [🥠]
-        prettifyPromptbookStringCli: prettifyPromptbookStringCli,
+        __initialize: promptbookCli,
     };
 
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;
-    exports.__ = __;
+    exports.__CLI = __CLI;
 
     Object.defineProperty(exports, '__esModule', { value: true });