@promptbook/cli 0.63.0-5 → 0.63.0-7

package/esm/index.es.js

@@ -2,7 +2,7 @@ import commander from 'commander';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import colors from 'colors';
 import { forTime } from 'waitasecond';
-import { readdir, access, constants, readFile, stat, writeFile, mkdir, unlink } from 'fs/promises';
+import { stat, access, constants, readdir, readFile, writeFile, mkdir, unlink } from 'fs/promises';
 import { join as join$1, dirname } from 'path';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
@@ -14,10 +14,11 @@ import Anthropic from '@anthropic-ai/sdk';
 import OpenAI from 'openai';
 import glob from 'glob-promise';
 
+// ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.63.0-4';
+var PROMPTBOOK_VERSION = '0.63.0-6';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
@@ -174,66 +175,6 @@ var isRunningInNode = new Function("\n    try {\n        return this === global;
  */
 new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
 
-/**
- * Initializes testing `hello` command for Promptbook CLI utilities
- *
- * @private internal function of `promptbookCli`
- */
-function initializeHelloCommand(program) {
-    var _this = this;
-    var helloCommand = program.command('hello');
-    helloCommand.description(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.cyan("".concat(greeting, " ").concat(name)));
-                        return [4 /*yield*/, forTime(1000)];
-                    case 1:
-                        _b.sent();
-                        console.info(colors.rainbow("Nice to meet you!"));
-                        process.exit(0);
-                        return [2 /*return*/];
-                }
-            });
-        });
-    });
-}
-/**
- * Note: [🟡] This code should never be published outside of `@promptbook/cli`
- */
-
-/**
- * Converts PipelineCollection to serialized JSON
- *
- * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
- *
- * @public exported from `@promptbook/core`
- */
-function collectionToJson(collection) {
-    return __awaiter(this, void 0, void 0, function () {
-        var pipelineUrls, promptbooks;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, collection.listPipelines()];
-                case 1:
-                    pipelineUrls = _a.sent();
-                    return [4 /*yield*/, Promise.all(pipelineUrls.map(function (url) { return collection.getPipelineByUrl(url); }))];
-                case 2:
-                    promptbooks = _a.sent();
-                    return [2 /*return*/, promptbooks];
-            }
-        });
-    });
-}
-/**
- * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
- */
-
 /**
  * @@@
  *
@@ -285,6 +226,14 @@ function deepFreezeWithSameType(objectValue) {
  * @private within the repository
  */
 var GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has been generated so that any manual changes will be overwritten";
+/**
+ * Claim for the Promptbook
+ *
+ * TODO: [🗽] Unite branding and make single place for it
+ *
+ * @public exported from `@promptbook/core`
+ */
+var CLAIM = "Supercharge LLM models with Promptbook";
 /**
  * Warning message for the generated sections and files files
  *
@@ -362,6 +311,91 @@ var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
  */
 var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
 
+/**
+ * Initializes `about` command for Promptbook CLI utilities
+ *
+ * @private internal function of `promptbookCli`
+ */
+function initializeAboutCommand(program) {
+    var _this = this;
+    var makeCommand = program.command('about');
+    makeCommand.description(spaceTrim("\n            Tells about Promptbook CLI and its abilities\n      "));
+    makeCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            console.info(colors.cyan("Promptbook"));
+            console.info(colors.cyan(CLAIM));
+            console.info(colors.cyan("Version: ".concat(PROMPTBOOK_VERSION)));
+            console.info(colors.cyan("https://ptbk.io"));
+            process.exit(0);
+            return [2 /*return*/];
+        });
+    }); });
+}
+/**
+ * TODO: [🗽] Unite branding and make single place for it
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ */
+
+/**
+ * Initializes testing `hello` command for Promptbook CLI utilities
+ *
+ * @private internal function of `promptbookCli`
+ */
+function initializeHelloCommand(program) {
+    var _this = this;
+    var helloCommand = program.command('hello');
+    helloCommand.description(spaceTrim("\n            Just command for testing\n      "));
+    helloCommand.argument('[name]', 'Your name', 'Paul');
+    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.cyan("".concat(greeting, " ").concat(name)));
+                        return [4 /*yield*/, forTime(1000)];
+                    case 1:
+                        _b.sent();
+                        console.info(colors.rainbow("Nice to meet you!"));
+                        process.exit(0);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    });
+}
+/**
+ * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ */
+
+/**
+ * Converts PipelineCollection to serialized JSON
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ *
+ * @public exported from `@promptbook/core`
+ */
+function collectionToJson(collection) {
+    return __awaiter(this, void 0, void 0, function () {
+        var pipelineUrls, promptbooks;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, collection.listPipelines()];
+                case 1:
+                    pipelineUrls = _a.sent();
+                    return [4 /*yield*/, Promise.all(pipelineUrls.map(function (url) { return collection.getPipelineByUrl(url); }))];
+                case 2:
+                    promptbooks = _a.sent();
+                    return [2 /*return*/, promptbooks];
+            }
+        });
+    });
+}
+/**
+ * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+ */
+
 /**
  * Prettify the html code
  *
@@ -805,7 +839,7 @@ function forEachAsync(array, options, callbackfunction) {
     });
 }
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.63.0-4",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",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> {knowledgeContent}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-4",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.63.0-4",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-4",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.63.0-4",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-4",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.63.0-4",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-4",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.63.0-6",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",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> {knowledgeContent}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-6",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.63.0-6",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-6",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.63.0-6",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-6",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.63.0-6",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.63.0-6",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -5905,6 +5939,75 @@ var CollectionError = /** @class */ (function (_super) {
     return CollectionError;
 }(Error));
 
+/**
+ * Checks if the file exists
+ *
+ * @private within the repository
+ */
+function isFileExisting(filePath) {
+    return __awaiter(this, void 0, void 0, function () {
+        var isReadAccessAllowed, isFile;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, access(filePath, constants.R_OK)
+                        .then(function () { return true; })
+                        .catch(function () { return false; })];
+                case 1:
+                    isReadAccessAllowed = _a.sent();
+                    if (!isReadAccessAllowed) {
+                        return [2 /*return*/, false];
+                    }
+                    return [4 /*yield*/, stat(filePath)
+                            .then(function (fileStat) { return fileStat.isFile(); })
+                            .catch(function () { return false; })];
+                case 2:
+                    isFile = _a.sent();
+                    return [2 /*return*/, isFile];
+            }
+        });
+    });
+}
+/**
+ * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
+ * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
+ * TODO: [🖇] What about symlinks?
+ */
+
+/**
+ * Checks if the directory exists
+ *
+ * @private within the repository
+ */
+function isDirectoryExisting(directoryPath) {
+    return __awaiter(this, void 0, void 0, function () {
+        var isReadAccessAllowed, isDirectory;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, access(directoryPath, constants.R_OK)
+                        .then(function () { return true; })
+                        .catch(function () { return false; })];
+                case 1:
+                    isReadAccessAllowed = _a.sent();
+                    if (!isReadAccessAllowed) {
+                        return [2 /*return*/, false];
+                    }
+                    return [4 /*yield*/, stat(directoryPath)
+                            .then(function (fileStat) { return fileStat.isDirectory(); })
+                            .catch(function () { return false; })];
+                case 2:
+                    isDirectory = _a.sent();
+                    return [2 /*return*/, isDirectory];
+            }
+        });
+    });
+}
+/**
+ * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
+ * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
+ * TODO: [🧠][📂] "directory" vs "folder"
+ * TODO: [🖇] What about symlinks?
+ */
+
 /**
  * Reads all files in the directory
  *
@@ -5919,53 +6022,60 @@ function listAllFiles(path, isRecursive) {
         var e_1, _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 0: return [4 /*yield*/, isDirectoryExisting(path)];
                 case 1:
+                    if (!(_h.sent())) {
+                        throw new Error("Directory \"".concat(path, "\" does not exist or is not readable"));
+                        //           <- TODO: Use some custom error class
+                    }
+                    return [4 /*yield*/, readdir(path, {
+                            withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
+                        })];
+                case 2:
                     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();
+                    if (!isRecursive) return [3 /*break*/, 10];
                     _h.label = 3;
                 case 3:
-                    if (!!_b.done) return [3 /*break*/, 6];
+                    _h.trys.push([3, 8, 9, 10]);
+                    _a = __values(dirents.filter(function (dirent) { return dirent.isDirectory(); })), _b = _a.next();
+                    _h.label = 4;
+                case 4:
+                    if (!!_b.done) return [3 /*break*/, 7];
                     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:
+                    _d.apply(_c, _e.concat([__spreadArray.apply(void 0, _f.concat([__read.apply(void 0, [(_h.sent())]), false]))]));
+                    _h.label = 6;
+                case 6:
                     _b = _a.next();
-                    return [3 /*break*/, 3];
-                case 6: return [3 /*break*/, 9];
-                case 7:
+                    return [3 /*break*/, 4];
+                case 7: return [3 /*break*/, 10];
+                case 8:
                     e_1_1 = _h.sent();
                     e_1 = { error: e_1_1 };
-                    return [3 /*break*/, 9];
-                case 8:
+                    return [3 /*break*/, 10];
+                case 9:
                     try {
                         if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
                     }
                     finally { if (e_1) throw e_1.error; }
                     return [7 /*endfinally*/];
-                case 9: return [2 /*return*/, fileNames];
+                case 10: return [2 /*return*/, fileNames];
             }
         });
     });
 }
 /**
  * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
+ * TODO: [🖇] What about symlinks?
  */
 
 /**
@@ -6067,7 +6177,7 @@ function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
  */
 function createCollectionFromDirectory(path, options) {
     return __awaiter(this, void 0, void 0, function () {
-        var makedLibraryFilePath, makedLibraryFileExists, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, collection;
+        var makedLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, collection;
         var _this = this;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -6076,12 +6186,9 @@ function createCollectionFromDirectory(path, options) {
                         throw new Error('Function `createCollectionFromDirectory` can only be run in Node.js environment because it reads the file system.');
                     }
                     makedLibraryFilePath = join$1(path, "".concat(PIPELINE_COLLECTION_BASE_FILENAME, ".json"));
-                    return [4 /*yield*/, access(makedLibraryFilePath, constants.R_OK)
-                            .then(function () { return true; })
-                            .catch(function () { return false; })];
+                    return [4 /*yield*/, isFileExisting(makedLibraryFilePath)];
                 case 1:
-                    makedLibraryFileExists = _f.sent();
-                    if (!makedLibraryFileExists) {
+                    if (!(_f.sent())) {
                         console.info(colors.yellow("Tip: Prebuild your pipeline collection (file with supposed prebuild ".concat(makedLibraryFilePath, " not found) with CLI util \"ptbk make\" to speed up the collection creation.")));
                     }
                     else {
@@ -6245,6 +6352,7 @@ function createCollectionFromDirectory(path, options) {
 }
 /**
  * Note: [🟢] This code should never be published outside of `@promptbook/node` and `@promptbook/cli` and `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe option isSymlinksFollowed
  */
 
 /**
@@ -6350,17 +6458,14 @@ var FilesStorage = /** @class */ (function () {
      */
     FilesStorage.prototype.getItem = function (key) {
         return __awaiter(this, void 0, void 0, function () {
-            var filename, isFileExisting, fileContent, value;
+            var filename, fileContent, value;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         filename = this.getFilenameForKey(key);
-                        return [4 /*yield*/, stat(filename)
-                                .then(function (fileStat) { return fileStat.isFile(); })
-                                .catch(function () { return false; })];
+                        return [4 /*yield*/, isFileExisting(filename)];
                     case 1:
-                        isFileExisting = _a.sent();
-                        if (!isFileExisting) {
+                        if (!(_a.sent())) {
                             return [2 /*return*/, null];
                         }
                         return [4 /*yield*/, readFile(filename, 'utf-8')];
@@ -7717,8 +7822,10 @@ function initializeMakeCommand(program) {
     var _this = this;
     var makeCommand = program.command('make');
     makeCommand.description(spaceTrim("\n            Makes a new pipeline collection in given folder\n      "));
-    makeCommand.argument('<path>', 'Path to promptbook directory');
-    makeCommand.option('--project-name', "Name of the project for whom collection is", 'Project');
+    makeCommand.argument('[path]', 
+    // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
+    'Path to promptbook directory', './promptbook-collection');
+    makeCommand.option('--project-name', "Name of the project for whom collection is", 'Untitled Promptbook project');
     makeCommand.option('-f, --format <format>', spaceTrim("\n            Output format of builded collection \"javascript\", \"typescript\" or \"json\"\n\n            Note: You can use multiple formats separated by comma\n        "), 'javascript' /* <- Note: [🏳‍🌈] */);
     makeCommand.option('--no-validation', "Do not validate logic of pipelines in collection", true);
     makeCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
@@ -7728,7 +7835,7 @@ function initializeMakeCommand(program) {
     makeCommand.action(function (path, _a) {
         var projectName = _a.projectName, format = _a.format, validation = _a.validation, reloadCache = _a.reloadCache, verbose = _a.verbose, outFile = _a.outFile;
         return __awaiter(_this, void 0, void 0, function () {
-            var isCacheReloaded, isVerbose, formats, validations, llmTools, collection, validations_1, validations_1_1, validation_1, _b, _c, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, saveFile;
+            var isCacheReloaded, isVerbose, formats, validations, llmTools, collection, validations_1, validations_1_1, validation_1, _b, _c, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
             var e_2, _d, e_1, _e;
             var _this = this;
             return __generator(this, function (_f) {
@@ -7745,7 +7852,7 @@ function initializeMakeCommand(program) {
                             .map(function (_) { return _.trim(); })
                             .filter(function (_) { return _ !== ''; });
                         if (outFile !== PIPELINE_COLLECTION_BASE_FILENAME && formats.length !== 1) {
-                            console.error(colors.red("You can use only one format when saving to a file"));
+                            console.error(colors.red("You can only use one format if you specify --out-file"));
                             process.exit(1);
                         }
                         llmTools = getLlmToolsForCli({
@@ -7819,7 +7926,16 @@ function initializeMakeCommand(program) {
                     case 16: return [4 /*yield*/, collectionToJson(collection)];
                     case 17:
                         collectionJson = _f.sent();
-                        collectionJsonString = stringifyPipelineJson(collectionJson);
+                        collectionJsonString = stringifyPipelineJson(collectionJson).trim();
+                        collectionJsonItems = (function () {
+                            if (collectionJsonString.substring(0, 1) !== '{') {
+                                throw new UnexpectedError('Missing { at the beginning of serialized collection');
+                            }
+                            if (collectionJsonString.substring(-1) !== '}') {
+                                throw new UnexpectedError('Missing } at the end of serialized collection');
+                            }
+                            return spaceTrim(collectionJsonString.substring(1, collectionJsonString.length - 1));
+                        })();
                         saveFile = function (extension, content) { return __awaiter(_this, void 0, void 0, function () {
                             var filePath;
                             return __generator(this, function (_a) {
@@ -7852,18 +7968,14 @@ function initializeMakeCommand(program) {
                     case 19:
                         if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 21];
                         formats = formats.filter(function (format) { return format !== 'javascript' && format !== 'js'; });
-                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) {
-                                return "\n                        // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                        import { createCollectionFromJson } from '@promptbook/core';\n\n                        /**\n                         * Pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @private internal cache for `getPipelineCollection`\n                         */\n                        let pipelineCollection = null;\n\n\n                        /**\n                         * Get pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                         */\n                        export function getPipelineCollection(){\n                            if(pipelineCollection===null){\n                                pipelineCollection = createCollectionFromJson(").concat(collectionJsonString.substring(1, collectionJsonString.length - 1), ");\n                            }\n\n                            return pipelineCollection;\n                        }\n                    ") + '\n';
-                            }))];
+                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) { return "\n                        // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                        import { createCollectionFromJson } from '@promptbook/core';\n\n                        /**\n                         * Pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @private internal cache for `getPipelineCollection`\n                         */\n                        let pipelineCollection = null;\n\n\n                        /**\n                         * Get pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                         */\n                        export function getPipelineCollection(){\n                            if(pipelineCollection===null){\n                                pipelineCollection = createCollectionFromJson(\n                                    ").concat(block(collectionJsonItems), "\n                                );\n                            }\n\n                            return pipelineCollection;\n                        }\n                    "); }))];
                     case 20:
-                        _f.sent();
+                        (_f.sent()) + '\n';
                         _f.label = 21;
                     case 21:
                         if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 23];
                         formats = formats.filter(function (format) { return format !== 'typescript' && format !== 'ts'; });
-                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) {
-                                return "\n                        // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                        import { createCollectionFromJson } from '@promptbook/core';\n                        import type { PipelineCollection } from '@promptbook/types';\n\n                        /**\n                         * Pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @private internal cache for `getPipelineCollection`\n                         */\n                        let pipelineCollection: null | PipelineCollection = null;\n\n\n                        /**\n                         * Get pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                         */\n                        export function getPipelineCollection(): PipelineCollection{\n                            if(pipelineCollection===null){\n                                pipelineCollection = createCollectionFromJson(").concat(collectionJsonString.substring(1, collectionJsonString.length - 1), ");\n                            }\n\n                            return pipelineCollection as PipelineCollection;\n                        }\n                    ") + '\n';
-                            }))];
+                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) { return "\n                        // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                        import { createCollectionFromJson } from '@promptbook/core';\n                        import type { PipelineCollection } from '@promptbook/types';\n\n                        /**\n                         * Pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @private internal cache for `getPipelineCollection`\n                         */\n                        let pipelineCollection: null | PipelineCollection = null;\n\n\n                        /**\n                         * Get pipeline collection for ").concat(projectName, "\n                         *\n                         * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                         *\n                         * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                         */\n                        export function getPipelineCollection(): PipelineCollection{\n                            if(pipelineCollection===null){\n                                pipelineCollection = createCollectionFromJson(\n                                    ").concat(block(collectionJsonItems), "\n                                );\n                            }\n\n                            return pipelineCollection;\n                        }\n                    "); }) + '\n')];
                     case 22:
                         _f.sent();
                         _f.label = 23;
@@ -7883,7 +7995,10 @@ function initializeMakeCommand(program) {
     });
 }
 /**
+ * TODO: Maybe remove this command - "about" command should be enough?
+ * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
  * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */
 
 /**
@@ -8087,7 +8202,9 @@ function initializePrettifyCommand(program) {
     var _this = this;
     var prettifyCommand = program.command('prettify');
     prettifyCommand.description(spaceTrim("\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.argument('<filesGlob>', 
+    // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
+    'Promptbooks to prettify as glob pattern');
     prettifyCommand.option('-i, --ignore <glob>', "Ignore as glob pattern");
     prettifyCommand.action(function (filesGlob, _a) {
         var ignore = _a.ignore;
@@ -8163,6 +8280,7 @@ function initializePrettifyCommand(program) {
 }
 /**
  * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */
 
 /**
@@ -8179,8 +8297,10 @@ function promptbookCli() {
             }
             program = new commander.Command();
             program.name('promptbook');
+            program.alias('ptbk');
             program.version(PROMPTBOOK_VERSION);
             program.description(spaceTrim$1("\n            Promptbook utilities for enhancing workflow with promptbooks\n        "));
+            initializeAboutCommand(program);
             initializeHelloCommand(program);
             initializeMakeCommand(program);
             initializePrettifyCommand(program);