@promptbook/cli 0.59.0-23 → 0.59.0-25

package/bin/promptbook-cli.js

@@ -1,10 +1,8 @@
 #!/usr/bin/env node
 
-const {
-    __: { prettifyPromptbookStringCli },
-} = require('../umd/index.umd.js');
+const { __CLI /* <- Note: [🥠] */ } = require('../umd/index.umd.js');
 
-promptbookCli();
+__CLI.__initialize();
 
 /**
  * TODO: [🕌] When more functionalities, rename

package/esm/index.es.js

@@ -2,10 +2,11 @@ import commander from 'commander';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import colors from 'colors';
 import { forTime } from 'waitasecond';
-import { writeFile, readFile } from 'fs/promises';
-import glob from 'glob-promise';
+import { access, constants, readFile, readdir, writeFile } from 'fs/promises';
+import { join } from 'path';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
+import glob from 'glob-promise';
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -142,7 +143,7 @@ new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined'
 /**
  * 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
@@ -175,67 +176,13 @@ function initializeHello(program) {
 }
 
 /**
- * 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$1(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$1(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 format(content, {
-            parser: 'markdown',
-            plugins: [parserHtml],
-            // 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
@@ -251,7 +198,7 @@ var PromptbookSyntaxError = /** @class */ (function (_super) {
     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
@@ -292,11 +239,6 @@ function assertsExecutionSuccessful(executionResult) {
  * 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)
  */
@@ -1633,6 +1575,38 @@ function createPromptbookExecutor(options) {
  * 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 format(content, {
+            parser: 'markdown',
+            plugins: [parserHtml],
+            // 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
  *
@@ -2327,6 +2301,16 @@ function extractOneBlockFromMarkdown(markdown) {
  * 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$1(content.replace(/<!--(.*?)-->/gs, ''));
+}
+
 /**
  * Creates a new set with all elements that are present in either set
  */
@@ -3198,6 +3182,443 @@ function promptbookStringToJson(promptbookString, options) {
  * 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, 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 = join(path, "".concat(PROMPTBOOK_MAKED_BASE_FILENAME, ".json"));
+                    return [4 /*yield*/, access(makedLibraryFilePath, constants.R_OK)
+                            .then(function () { return true; })
+                            .catch(function () { return false; })];
+                case 1:
+                    makedLibraryFileExists = _f.sent();
+                    if (!makedLibraryFileExists) {
+                        console.info(colors.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.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));
+                                    }
+                                    return [4 /*yield*/, listAllFiles(path, isRecursive)];
+                                case 1:
+                                    fileNames = _b.sent();
+                                    if (isVerbose) {
+                                        console.info('createLibraryFromDirectory', { path: path, isRecursive: isRecursive, fileNames: fileNames });
+                                    }
+                                    promptbooks = [];
+                                    _loop_1 = function (fileName) {
+                                        var promptbook, promptbookString, _c, _d, error_1, wrappedErrorMessage;
+                                        return __generator(this, function (_e) {
+                                            switch (_e.label) {
+                                                case 0:
+                                                    _e.trys.push([0, 7, , 8]);
+                                                    promptbook = null;
+                                                    if (!fileName.endsWith('.ptbk.md')) return [3 /*break*/, 3];
+                                                    return [4 /*yield*/, 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*/, 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(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, 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*/, readdir(path, {
+                        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 join(path, 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 = join(path, 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("\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("\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, _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, format: format, validation: validation });
+                        return [4 /*yield*/, createLibraryFromDirectory(path, {
+                                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 = join(path, "promptbook-library.".concat(extension));
+                                        return [4 /*yield*/, writeFile(filePath, content, 'utf-8')];
+                                    case 1:
+                                        _a.sent();
+                                        console.info(colors.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("\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$1(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;
@@ -3449,6 +3870,7 @@ function promptbookCli() {
             program.version(PROMPTBOOK_VERSION);
             program.description(spaceTrim$1("\n            Promptbook utilities for enhancing workflow with promptbooks\n        "));
             initializeHello(program);
+            initializeMake(program);
             initializePrettify(program);
             program.parse(process.argv);
             return [2 /*return*/];
@@ -3465,10 +3887,10 @@ function promptbookCli() {
 /**
  * Hidden utilities which should not be used by external consumers.
  */
-var __ = {
+var __CLI = {
     // Note: [🥠]
-    promptbookCli: promptbookCli,
+    __initialize: promptbookCli,
 };
 
-export { PROMPTBOOK_VERSION, __ };
+export { PROMPTBOOK_VERSION, __CLI };
 //# sourceMappingURL=index.es.js.map