@promptbook/cli 0.59.0-23 → 0.59.0-25

package/umd/index.umd.js

@@ -1,16 +1,16 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('commander'), require('spacetrim'), require('colors'), require('waitasecond'), require('fs/promises'), require('glob-promise'), require('prettier'), require('prettier/parser-html')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'commander', 'spacetrim', 'colors', 'waitasecond', 'fs/promises', 'glob-promise', 'prettier', 'prettier/parser-html'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.commander, global.spaceTrim, global.colors, global.waitasecond, global.promises, global.glob, global.prettier, global.parserHtml));
-})(this, (function (exports, commander, spaceTrim, colors, waitasecond, promises, glob, 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 commander__default = /*#__PURE__*/_interopDefaultLegacy(commander);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
-    var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
+    var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -147,7 +147,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.59.0-21';
+    var PROMPTBOOK_VERSION = '0.59.0-24';
 
     /**
      * Initializes testing `hello` command for Promptbook CLI utilities
@@ -180,67 +180,13 @@
     }
 
     /**
-     * Removes HTML or Markdown comments from a string.
-     *
-     * @param {string} content - The string to remove comments from.
-     * @returns {string} The input string with all comments removed.
-     */
-    function removeContentComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
-    }
-
-    /**
-     * 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;
     /**
-     * Prettify the html code
-     *
-     * @param content raw html code
-     * @returns formatted html code
+     * The name of the builded promptbook library made by CLI `promptbook make` and for lookup in `createLibraryFromDirectory`
      */
-    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 PROMPTBOOK_MAKED_BASE_FILENAME = "promptbook-library";
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -256,7 +202,7 @@
         return PromptbookSyntaxError;
     }(Error));
 
-    var promptbookLibrary = [{title:"Prepare Knowledge from Markdown",promptbookUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.59.0-21",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:[]}];
+    var promptbookLibrary = [{title:"Prepare Knowledge from Markdown",promptbookUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.59.0-24",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
@@ -297,11 +243,6 @@
      * 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)
      */
@@ -1638,6 +1579,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
      *
@@ -2332,6 +2305,16 @@
      * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
      */
 
+    /**
+     * Removes HTML or Markdown comments from a string.
+     *
+     * @param {string} content - The string to remove comments from.
+     * @returns {string} The input string with all comments removed.
+     */
+    function removeContentComments(content) {
+        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+    }
+
     /**
      * Creates a new set with all elements that are present in either set
      */
@@ -3203,6 +3186,443 @@
      * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
      */
 
+    /**
+     * 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();
+                            }
+                            return [4 /*yield*/, promptbookSourcesPromiseOrFactory];
+                        case 1:
+                            promptbookSources = _a.sent();
+                            return [4 /*yield*/, createLibraryFromJson.apply(void 0, __spreadArray([], __read(promptbookSources), false))];
+                        case 2:
+                            library = _a.sent();
+                            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.');
+                        }
+                        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.")));
+                        }
+                        else {
+                            colors__default["default"].green("Using your prebuild promptbook library ".concat(makedLibraryFilePath));
+                            // TODO: !!!!! Implement;
+                        }
+                        _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));
+                                        }
+                                        return [4 /*yield*/, listAllFiles(path$1, isRecursive)];
+                                    case 1:
+                                        fileNames = _b.sent();
+                                        if (isVerbose) {
+                                            console.info('createLibraryFromDirectory', { path: path$1, isRecursive: isRecursive, fileNames: fileNames });
+                                        }
+                                        promptbooks = [];
+                                        _loop_1 = function (fileName) {
+                                            var promptbook, promptbookString, _c, _d, error_1, wrappedErrorMessage;
+                                            return __generator(this, function (_e) {
+                                                switch (_e.label) {
+                                                    case 0:
+                                                        _e.trys.push([0, 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));
+                                                        }
+                                                        _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));
+                                                        }
+                                                        _e.label = 6;
+                                                    case 6:
+                                                        // ---
+                                                        if (promptbook !== null) {
+                                                            if (!promptbook.promptbookUrl) {
+                                                                if (isVerbose) {
+                                                                    console.info("Not loading ".concat(fileName, " - missing URL"));
+                                                                }
+                                                            }
+                                                            else {
+                                                                if (isVerbose) {
+                                                                    console.info("Loading ".concat(fileName));
+                                                                }
+                                                                if (!isCrashOnError) {
+                                                                    // Note: Validate promptbook to check if it is logically correct to not crash on invalid promptbooks
+                                                                    //       But be handled in current try-catch block
+                                                                    validatePromptbookJson(promptbook);
+                                                                }
+                                                                // Note: [🦄] Promptbook with same url uniqueness will be checked automatically in SimplePromptbookLibrary
+                                                                promptbooks.push(promptbook);
+                                                            }
+                                                        }
+                                                        return [3 /*break*/, 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*/];
+                                                }
+                                            });
+                                        };
+                                        _b.label = 2;
+                                    case 2:
+                                        _b.trys.push([2, 7, 8, 9]);
+                                        fileNames_1 = __values(fileNames), fileNames_1_1 = fileNames_1.next();
+                                        _b.label = 3;
+                                    case 3:
+                                        if (!!fileNames_1_1.done) return [3 /*break*/, 6];
+                                        fileName = fileNames_1_1.value;
+                                        return [5 /*yield**/, _loop_1(fileName)];
+                                    case 4:
+                                        _b.sent();
+                                        _b.label = 5;
+                                    case 5:
+                                        fileNames_1_1 = fileNames_1.next();
+                                        return [3 /*break*/, 3];
+                                    case 6: return [3 /*break*/, 9];
+                                    case 7:
+                                        e_1_1 = _b.sent();
+                                        e_1 = { error: e_1_1 };
+                                        return [3 /*break*/, 9];
+                                    case 8:
+                                        try {
+                                            if (fileNames_1_1 && !fileNames_1_1.done && (_a = fileNames_1.return)) _a.call(fileNames_1);
+                                        }
+                                        finally { if (e_1) throw e_1.error; }
+                                        return [7 /*endfinally*/];
+                                    case 9: return [2 /*return*/, promptbooks];
+                                }
+                            });
+                        }); });
+                        if (!(isLazyLoaded === false)) return [3 /*break*/, 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');
+        // 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;
+            return __awaiter(_this, void 0, void 0, function () {
+                var library, libraryJson, libraryJsonString, saveFile;
+                var _this = this;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            console.info('!!!', { projectName: projectName, path: path$1, format: format, validation: validation });
+                            return [4 /*yield*/, createLibraryFromDirectory(path$1, {
+                                    isVerbose: true,
+                                    isRecursive: true,
+                                })];
+                        case 1:
+                            library = _b.sent();
+                            return [4 /*yield*/, libraryToJson(library)];
+                        case 2:
+                            libraryJson = _b.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 = path.join(path$1, "promptbook-library.".concat(extension));
+                                            return [4 /*yield*/, promises.writeFile(filePath, content, 'utf-8')];
+                                        case 1:
+                                            _a.sent();
+                                            console.info(colors__default["default"].green("Maked ".concat(filePath)));
+                                            return [2 /*return*/];
+                                    }
+                                });
+                            }); };
+                            if (!format.includes('json')) return [3 /*break*/, 4];
+                            return [4 /*yield*/, saveFile('json', libraryJsonString + '\n')];
+                        case 3:
+                            _b.sent();
+                            _b.label = 4;
+                        case 4:
+                            if (format.includes('javascript')) {
+                                // TODO: !!!!;
+                                // TODO: !!! DRY javascript and typescript
+                                format.push('javascript');
+                            }
+                            if (!format.includes('typescript')) return [3 /*break*/, 6];
+                            // TODO: !!!!!!!! Javascript json
+                            return [4 /*yield*/, saveFile('ts', spaceTrim__default["default"]("\n                        import type { PromptbookLibrary, SimplePromptbookLibrary } from '@promptbook/types';\n                        import type { PromptbookLibrary } from '@promptbook/core';\n\n                        /**\n                         * Promptbook library for ".concat(projectName, "\n                         *\n                         * @private internal cache for `getPromptbookLibrary`\n                         */\n                        let promptbookLibrary: null | SimplePromptbookLibrary = 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, ");\n                            }\n\n                            return promptbookLibrary;\n                        }\n                    ") + '\n'))];
+                        case 5:
+                            // TODO: !!!!!!!! Javascript json
+                            _b.sent();
+                            _b.label = 6;
+                        case 6:
+                            process.exit(0);
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        });
+    }
+
+    /**
+     * 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) {
         var e_1, _a;
@@ -3454,6 +3874,7 @@
                 program.version(PROMPTBOOK_VERSION);
                 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*/];
@@ -3470,13 +3891,13 @@
     /**
      * Hidden utilities which should not be used by external consumers.
      */
-    var __ = {
+    var __CLI = {
         // Note: [🥠]
-        promptbookCli: promptbookCli,
+        __initialize: promptbookCli,
     };
 
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;
-    exports.__ = __;
+    exports.__CLI = __CLI;
 
     Object.defineProperty(exports, '__esModule', { value: true });