@promptbook/cli 0.81.0-21 → 0.81.0-23

package/esm/index.es.js

@@ -39,7 +39,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.81.0-20';
+var PROMPTBOOK_ENGINE_VERSION = '0.81.0-22';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -520,7 +520,7 @@ function $provideFilesystemForNode(options) {
 /**
  * Make error report URL for the given error
  *
- * @private !!!!!!
+ * @private private within the repository
  */
 function getErrorReportUrl(error) {
     var report = {
@@ -721,7 +721,7 @@ function checkSerializableAsJson(options) {
 }
 /**
  * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
- * TODO: [🧠][main] !!! In-memory cache of same values to prevent multiple checks
+ * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
  * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
  */
 
@@ -874,7 +874,7 @@ function isSerializableAsJson(value) {
     }
 }
 /**
- * TODO: [🧠][main] !!! In-memory cache of same values to prevent multiple checks
+ * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
  * TODO: [🧠][💺] Can be done this on type-level?
  */
 
@@ -1639,7 +1639,7 @@ function cacheLlmTools(llmTools, options) {
                     return [3 /*break*/, 11];
                 case 10: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
                 case 11: 
-                // TODO: [🧠] !!!!! How to do timing in mixed cache / non-cache situation
+                // TODO: [🧠] !!5 How to do timing in mixed cache / non-cache situation
                 // promptResult.timing: FromtoItems
                 return [4 /*yield*/, storage.setItem(key, {
                         date: $getCurrentDate(),
@@ -1648,7 +1648,7 @@ function cacheLlmTools(llmTools, options) {
                         promptResult: promptResult,
                     })];
                 case 12:
-                    // TODO: [🧠] !!!!! How to do timing in mixed cache / non-cache situation
+                    // TODO: [🧠] !!5 How to do timing in mixed cache / non-cache situation
                     // promptResult.timing: FromtoItems
                     _c.sent();
                     return [2 /*return*/, promptResult];
@@ -2785,139 +2785,25 @@ function collectionToJson(collection) {
 var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou 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}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou 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}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book.md"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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 - Write maximum ideally 2 words, maximum 5 words\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book.md`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou 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 - Write maximum ideally 2 words, maximum 5 words\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book.md"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book.md",formfactorName:"GENERIC",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}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\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-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `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### Key `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}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book.md`\n-   INPUT PARAMETER `{availableModelNames}` List of available model names separated by comma (,)\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\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-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `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### Key `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}\n```\n\n`-> {modelRequirements}`\n"}],sourceFile:"./books/prepare-persona.book.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book.md",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the task:\n\n> {book}\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Title starts with emoticon",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book.md`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the task:\n\n> {book}\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Title starts with emoticon\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book.md"}];
 
 /**
- * This error indicates problems parsing the format value
- *
- * For example, when the format value is not a valid JSON or CSV
- * This is not thrown directly but in extended classes
- *
- * @public exported from `@promptbook/core`
- */
-var AbstractFormatError = /** @class */ (function (_super) {
-    __extends(AbstractFormatError, _super);
-    // Note: To allow instanceof do not put here error `name`
-    // public readonly name = 'AbstractFormatError';
-    function AbstractFormatError(message) {
-        var _this = _super.call(this, message) || this;
-        Object.setPrototypeOf(_this, AbstractFormatError.prototype);
-        return _this;
-    }
-    return AbstractFormatError;
-}(Error));
-
-/**
- * This error indicates problem with parsing of CSV
- *
- * @public exported from `@promptbook/core`
- */
-var CsvFormatError = /** @class */ (function (_super) {
-    __extends(CsvFormatError, _super);
-    function CsvFormatError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'CsvFormatError';
-        Object.setPrototypeOf(_this, CsvFormatError.prototype);
-        return _this;
-    }
-    return CsvFormatError;
-}(AbstractFormatError));
-
-/**
- * This error indicates that the pipeline collection cannot be propperly loaded
- *
- * @public exported from `@promptbook/core`
- */
-var CollectionError = /** @class */ (function (_super) {
-    __extends(CollectionError, _super);
-    function CollectionError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'CollectionError';
-        Object.setPrototypeOf(_this, CollectionError.prototype);
-        return _this;
-    }
-    return CollectionError;
-}(Error));
-
-/**
- * This error occurs when some expectation is not met in the execution of the pipeline
- *
- * @public exported from `@promptbook/core`
- * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
- * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
- * Note: This is a kindof subtype of PipelineExecutionError
- */
-var ExpectError = /** @class */ (function (_super) {
-    __extends(ExpectError, _super);
-    function ExpectError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'ExpectError';
-        Object.setPrototypeOf(_this, ExpectError.prototype);
-        return _this;
-    }
-    return ExpectError;
-}(Error));
-
-/**
- * This error indicates that the promptbook can not retrieve knowledge from external sources
- *
- * @public exported from `@promptbook/core`
- */
-var KnowledgeScrapeError = /** @class */ (function (_super) {
-    __extends(KnowledgeScrapeError, _super);
-    function KnowledgeScrapeError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'KnowledgeScrapeError';
-        Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
-        return _this;
-    }
-    return KnowledgeScrapeError;
-}(Error));
-
-/**
- * This error type indicates that some limit was reached
- *
- * @public exported from `@promptbook/core`
- */
-var LimitReachedError = /** @class */ (function (_super) {
-    __extends(LimitReachedError, _super);
-    function LimitReachedError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'LimitReachedError';
-        Object.setPrototypeOf(_this, LimitReachedError.prototype);
-        return _this;
-    }
-    return LimitReachedError;
-}(Error));
-
-/**
- * This error type indicates that some tools are missing for pipeline execution or preparation
+ * Function isValidJsonString will tell you if the string is valid JSON or not
  *
- * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/utils`
  */
-var MissingToolsError = /** @class */ (function (_super) {
-    __extends(MissingToolsError, _super);
-    function MissingToolsError(message) {
-        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation\n\n                "); })) || this;
-        _this.name = 'MissingToolsError';
-        Object.setPrototypeOf(_this, MissingToolsError.prototype);
-        return _this;
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
     }
-    return MissingToolsError;
-}(Error));
-
-/**
- * This error indicates that promptbook not found in the collection
- *
- * @public exported from `@promptbook/core`
- */
-var NotFoundError = /** @class */ (function (_super) {
-    __extends(NotFoundError, _super);
-    function NotFoundError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'NotFoundError';
-        Object.setPrototypeOf(_this, NotFoundError.prototype);
-        return _this;
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        return false;
     }
-    return NotFoundError;
-}(Error));
+}
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -2939,188 +2825,75 @@ var ParseError = /** @class */ (function (_super) {
  */
 
 /**
- * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ * Function `validatePipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
  *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {PipelineString} the same string as input, but validated as valid
+ * @throws {ParseError} if the string is not a valid pipeline string
  * @public exported from `@promptbook/core`
  */
-var PipelineLogicError = /** @class */ (function (_super) {
-    __extends(PipelineLogicError, _super);
-    function PipelineLogicError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'PipelineLogicError';
-        Object.setPrototypeOf(_this, PipelineLogicError.prototype);
-        return _this;
+function validatePipelineString(pipelineString) {
+    if (isValidJsonString(pipelineString)) {
+        throw new ParseError('Expected a book, but got a JSON string');
     }
-    return PipelineLogicError;
-}(Error));
-
+    // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
+    return pipelineString;
+}
 /**
- * This error indicates errors in referencing promptbooks between each other
- *
- * @public exported from `@promptbook/core`
+ * TODO: [🧠][🈴] Where is the best location for this file
  */
-var PipelineUrlError = /** @class */ (function (_super) {
-    __extends(PipelineUrlError, _super);
-    function PipelineUrlError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'PipelineUrlError';
-        Object.setPrototypeOf(_this, PipelineUrlError.prototype);
-        return _this;
-    }
-    return PipelineUrlError;
-}(Error));
 
 /**
- * Index of all custom errors
+ * Prettify the html code
  *
- * @public exported from `@promptbook/core`
+ * @param content raw html code
+ * @returns formatted html code
+ * @private withing the package because of HUGE size of prettier dependency
  */
-var PROMPTBOOK_ERRORS = {
-    AbstractFormatError: AbstractFormatError,
-    CsvFormatError: CsvFormatError,
-    CollectionError: CollectionError,
-    EnvironmentMismatchError: EnvironmentMismatchError,
-    ExpectError: ExpectError,
-    KnowledgeScrapeError: KnowledgeScrapeError,
-    LimitReachedError: LimitReachedError,
-    MissingToolsError: MissingToolsError,
-    NotFoundError: NotFoundError,
-    NotYetImplementedError: NotYetImplementedError,
-    ParseError: ParseError,
-    PipelineExecutionError: PipelineExecutionError,
-    PipelineLogicError: PipelineLogicError,
-    PipelineUrlError: PipelineUrlError,
-    UnexpectedError: UnexpectedError,
-    // TODO: [🪑]> VersionMismatchError,
-};
+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) {
+        // TODO: [🟥] Detect browser / node and make it colorfull
+        console.error('There was an error with prettifying the markdown, using the original as the fallback', {
+            error: error,
+            html: content,
+        });
+        return content;
+    }
+}
+
 /**
- * Index of all javascript errors
+ * Makes first letter of a string uppercase
  *
- * @private for internal usage
+ * @public exported from `@promptbook/utils`
  */
-var COMMON_JAVASCRIPT_ERRORS = {
-    Error: Error,
-    EvalError: EvalError,
-    RangeError: RangeError,
-    ReferenceError: ReferenceError,
-    SyntaxError: SyntaxError,
-    TypeError: TypeError,
-    URIError: URIError,
-    AggregateError: AggregateError,
-    /*
-  Note: Not widely supported
-  > InternalError,
-  > ModuleError,
-  > HeapError,
-  > WebAssemblyCompileError,
-  > WebAssemblyRuntimeError,
-  */
-};
+function capitalize(word) {
+    return word.substring(0, 1).toUpperCase() + word.substring(1);
+}
+
 /**
- * Index of all errors
+ * Converts promptbook in JSON format to string format
  *
- * @private for internal usage
- */
-var ALL_ERRORS = __assign(__assign({}, PROMPTBOOK_ERRORS), COMMON_JAVASCRIPT_ERRORS);
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Deserializes the error object
- *
- * @public exported from `@promptbook/utils`
- */
-function deserializeError(error) {
-    var ErrorClass = ALL_ERRORS[error.name];
-    if (ErrorClass === undefined) {
-        return new Error("".concat(error.name, ": ").concat(error.message));
-    }
-    return new ErrorClass(error.message);
-}
-
-/**
- * Asserts that the execution of a Promptbook is successful
- *
- * @param executionResult - The partial result of the Promptbook execution
- * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
- * @public exported from `@promptbook/core`
- */
-function assertsExecutionSuccessful(executionResult) {
-    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
-    if (isSuccessful === true) {
-        return;
-    }
-    if (errors.length === 0) {
-        throw new PipelineExecutionError("Promptbook Execution failed because of unknown reason");
-    }
-    else if (errors.length === 1) {
-        throw deserializeError(errors[0]);
-    }
-    else {
-        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                    Multiple errors occurred during Promptbook execution\n\n                    ".concat(block(errors
-            .map(function (_a, index) {
-            var name = _a.name, stack = _a.stack, message = _a.message;
-            return spaceTrim$1(function (block) { return "\n                                        ".concat(name, " ").concat(index + 1, ":\n                                        ").concat(block(stack || message), "\n                                    "); });
-        })
-            .join('\n')), "\n                "); }));
-    }
-}
-/**
- * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
- * TODO: [🧠] Can this return type be better typed than void
- */
-
-/**
- * Prettify the html code
- *
- * @param content raw html code
- * @returns formatted html code
- * @private withing the package because of HUGE size of prettier dependency
- */
-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) {
-        // TODO: [🟥] Detect browser / node and make it colorfull
-        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
- *
- * @public exported from `@promptbook/utils`
- */
-function capitalize(word) {
-    return word.substring(0, 1).toUpperCase() + word.substring(1);
-}
-
-/**
- * Converts promptbook in JSON format to string format
- *
- * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
- * @param pipelineJson Promptbook in JSON format (.book.json)
- * @returns Promptbook in string format (.book.md)
- * @public exported from `@promptbook/core`
+ * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
+ * @param pipelineJson Promptbook in JSON format (.book.json)
+ * @returns Promptbook in string format (.book.md)
+ * @public exported from `@promptbook/core`
  */
 function pipelineJsonToString(pipelineJson) {
     var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e, e_6, _f;
@@ -3137,7 +2910,7 @@ function pipelineJsonToString(pipelineJson) {
     if (bookVersion !== "undefined") {
         commands.push("BOOK VERSION ".concat(bookVersion));
     }
-    // TODO: [main] !!!!! This increases size of the bundle and is probbably not necessary
+    // TODO: [main] !!5 This increases size of the bundle and is probbably not necessary
     pipelineString = prettifyMarkdown(pipelineString);
     try {
         for (var _g = __values(parameters.filter(function (_a) {
@@ -3285,12 +3058,12 @@ function pipelineJsonToString(pipelineJson) {
             pipelineString += '```' + contentLanguage;
             pipelineString += '\n';
             pipelineString += spaceTrim(content);
-            //                   <- TODO: [main] !!! Escape
+            //                   <- TODO: [main] !!3 Escape
             //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
             pipelineString += '\n';
             pipelineString += '```';
             pipelineString += '\n\n';
-            pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: [main] !!! If the parameter here has description, add it and use taskParameterJsonToString
+            pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
         }
     }
     catch (e_3_1) { e_3 = { error: e_3_1 }; }
@@ -3300,7 +3073,7 @@ function pipelineJsonToString(pipelineJson) {
         }
         finally { if (e_3) throw e_3.error; }
     }
-    return pipelineString;
+    return validatePipelineString(pipelineString);
 }
 /**
  * @private internal utility of `pipelineJsonToString`
@@ -3321,6 +3094,22 @@ function taskParameterJsonToString(taskParameterJson) {
  * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
  */
 
+/**
+ * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
+ */
+var PipelineLogicError = /** @class */ (function (_super) {
+    __extends(PipelineLogicError, _super);
+    function PipelineLogicError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PipelineLogicError';
+        Object.setPrototypeOf(_this, PipelineLogicError.prototype);
+        return _this;
+    }
+    return PipelineLogicError;
+}(Error));
+
 /**
  * Tests if given string is valid semantic version
  *
@@ -3359,7 +3148,7 @@ function isValidPromptbookVersion(version) {
     if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
         return false;
     }
-    // <- TODO: [main] !!! Check isValidPromptbookVersion against PROMPTBOOK_ENGINE_VERSIONS
+    // <- TODO: [main] !!3 Check isValidPromptbookVersion against PROMPTBOOK_ENGINE_VERSIONS
     return true;
 }
 
@@ -3460,11 +3249,11 @@ function isValidPipelineUrl(url) {
  */
 function validatePipeline(pipeline) {
     if (IS_PIPELINE_LOGIC_VALIDATED) {
-        validatePipelineCore(pipeline);
+        validatePipeline_InnerFunction(pipeline);
     }
     else {
         try {
-            validatePipelineCore(pipeline);
+            validatePipeline_InnerFunction(pipeline);
         }
         catch (error) {
             if (!(error instanceof PipelineLogicError)) {
@@ -3478,7 +3267,7 @@ function validatePipeline(pipeline) {
 /**
  * @private internal function for `validatePipeline`
  */
-function validatePipelineCore(pipeline) {
+function validatePipeline_InnerFunction(pipeline) {
     // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
     var e_1, _a, e_2, _b, e_3, _c;
     var pipelineIdentification = (function () {
@@ -3702,11 +3491,11 @@ function validatePipelineCore(pipeline) {
         _loop_3();
     }
     // Note: Check that formfactor is corresponding to the pipeline interface
-    // TODO: !!!!!! Implement this
+    // TODO: !!6 Implement this
     // pipeline.formfactorName
 }
 /**
- * TODO: !! [🧞‍♀️] Do not allow joker + foreach
+ * TODO: [🧞‍♀️] Do not allow joker + foreach
  * TODO: [🧠] Work with promptbookVersion
  * TODO: Use here some json-schema, Zod or something similar and change it to:
  *     > /**
@@ -3718,178 +3507,430 @@ function validatePipelineCore(pipeline) {
  *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
  */
 /**
- * TODO: [🧳][main] !!!! Validate that all examples match expectations
- * TODO: [🧳][🐝][main] !!!! Validate that knowledge is valid (non-void)
- * TODO: [🧳][main] !!!! Validate that persona can be used only with CHAT variant
- * TODO: [🧳][main] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
- * TODO: [🧳][main] !!!! Validate that reserved parameter is not used as joker
- * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: [🧳][main] !!4 Validate that all examples match expectations
+ * TODO: [🧳][🐝][main] !!4 Validate that knowledge is valid (non-void)
+ * TODO: [🧳][main] !!4 Validate that persona can be used only with CHAT variant
+ * TODO: [🧳][main] !!4 Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+ * TODO: [🧳][main] !!4 Validate that reserved parameter is not used as joker
+ * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ */
+
+/**
+ * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+var NotFoundError = /** @class */ (function (_super) {
+    __extends(NotFoundError, _super);
+    function NotFoundError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'NotFoundError';
+        Object.setPrototypeOf(_this, NotFoundError.prototype);
+        return _this;
+    }
+    return NotFoundError;
+}(Error));
+
+/**
+ * This error indicates errors in referencing promptbooks between each other
+ *
+ * @public exported from `@promptbook/core`
+ */
+var PipelineUrlError = /** @class */ (function (_super) {
+    __extends(PipelineUrlError, _super);
+    function PipelineUrlError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PipelineUrlError';
+        Object.setPrototypeOf(_this, PipelineUrlError.prototype);
+        return _this;
+    }
+    return PipelineUrlError;
+}(Error));
+
+/**
+ * Parses the task and returns the list of all parameter names
+ *
+ * @param template the string template with parameters in {curly} braces
+ * @returns the list of parameter names
+ * @public exported from `@promptbook/utils`
+ */
+function extractParameterNames(template) {
+    var e_1, _a;
+    var matches = template.matchAll(/{\w+}/g);
+    var parameterNames = new Set();
+    try {
+        for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
+            var match = matches_1_1.value;
+            var parameterName = match[0].slice(1, -1);
+            parameterNames.add(parameterName);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return parameterNames;
+}
+
+/**
+ * Unprepare just strips the preparation data of the pipeline
+ *
+ * @deprecated In future version this function will be removed or deprecated
+ * @public exported from `@promptbook/core`
+ */
+function unpreparePipeline(pipeline) {
+    var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources, tasks = pipeline.tasks;
+    personas = personas.map(function (persona) { return (__assign(__assign({}, persona), { modelRequirements: undefined, preparationIds: undefined })); });
+    knowledgeSources = knowledgeSources.map(function (knowledgeSource) { return (__assign(__assign({}, knowledgeSource), { preparationIds: undefined })); });
+    tasks = tasks.map(function (task) {
+        var dependentParameterNames = task.dependentParameterNames;
+        var parameterNames = extractParameterNames(task.preparedContent || '');
+        dependentParameterNames = dependentParameterNames.filter(function (dependentParameterName) { return !parameterNames.has(dependentParameterName); });
+        var taskUnprepared = __assign(__assign({}, task), { dependentParameterNames: dependentParameterNames });
+        delete taskUnprepared.preparedContent;
+        return taskUnprepared;
+    });
+    return exportJson({
+        name: 'pipelineJson',
+        message: "Result of `unpreparePipeline`",
+        order: ORDER_OF_PIPELINE_JSON,
+        value: __assign(__assign({}, pipeline), { tasks: tasks, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] }),
+    });
+}
+/**
+ * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
+ * TODO: Write tests for `preparePipeline`
+ * TODO: [🍙] Make some standard order of json properties
+ */
+
+/**
+ * Library of pipelines that groups together pipelines for an application.
+ * This implementation is a very thin wrapper around the Array / Map of pipelines.
+ *
+ * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
+ * @see https://github.com/webgptorg/pipeline#pipeline-collection
+ */
+var SimplePipelineCollection = /** @class */ (function () {
+    /**
+     * Constructs a pipeline collection from pipelines
+     *
+     * @param pipelines @@@
+     *
+     * Note: During the construction logic of all pipelines are validated
+     * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
+     */
+    function SimplePipelineCollection() {
+        var e_1, _a;
+        var pipelines = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            pipelines[_i] = arguments[_i];
+        }
+        this.collection = new Map();
+        try {
+            for (var pipelines_1 = __values(pipelines), pipelines_1_1 = pipelines_1.next(); !pipelines_1_1.done; pipelines_1_1 = pipelines_1.next()) {
+                var pipeline = pipelines_1_1.value;
+                // TODO: [👠] DRY
+                if (pipeline.pipelineUrl === undefined) {
+                    throw new PipelineUrlError(spaceTrim$1("\n                        Pipeline with name \"".concat(pipeline.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines without URLs are called anonymous pipelines\n                              They can be used as standalone pipelines, but they cannot be referenced by other pipelines\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
+                }
+                // Note: [🐨]
+                validatePipeline(pipeline);
+                // TODO: [🦄] DRY
+                // Note: [🦄]
+                if (
+                // TODO: [🐽]
+                this.collection.has(pipeline.pipelineUrl) &&
+                    pipelineJsonToString(unpreparePipeline(pipeline)) !==
+                        pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
+                    var existing = this.collection.get(pipeline.pipelineUrl);
+                    throw new PipelineUrlError(spaceTrim$1("\n                        Pipeline with URL ".concat(pipeline.pipelineUrl, " is already in the collection \uD83C\uDF4E\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                        Note: Pipelines with the same URL are not allowed\n                              Only exepction is when the pipelines are identical\n\n                    ")));
+                }
+                // Note: [🧠] Overwrite existing pipeline with the same URL
+                this.collection.set(pipeline.pipelineUrl, pipeline);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (pipelines_1_1 && !pipelines_1_1.done && (_a = pipelines_1.return)) _a.call(pipelines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    /**
+     * Gets all pipelines in the collection
+     */
+    SimplePipelineCollection.prototype.listPipelines = function () {
+        return Array.from(this.collection.keys());
+    };
+    /**
+     * Gets pipeline by its URL
+     *
+     * Note: This is not a direct fetching from the URL, but a lookup in the collection
+     */
+    SimplePipelineCollection.prototype.getPipelineByUrl = function (url) {
+        var _this = this;
+        var pipeline = this.collection.get(url);
+        if (!pipeline) {
+            if (this.listPipelines().length === 0) {
+                throw new NotFoundError(spaceTrim$1("\n                            Pipeline with url \"".concat(url, "\" not found\n\n                            No pipelines available\n                        ")));
+            }
+            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Pipeline with url \"".concat(url, "\" not found\n\n                        Available pipelines:\n                        ").concat(block(_this.listPipelines()
+                .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
+                .join('\n')), "\n\n                    "); }));
+        }
+        return pipeline;
+    };
+    /**
+     * Checks whether given prompt was defined in any pipeline in the collection
+     */
+    SimplePipelineCollection.prototype.isResponsibleForPrompt = function (prompt) {
+        return true;
+    };
+    return SimplePipelineCollection;
+}());
+
+/**
+ * Creates PipelineCollection from array of PipelineJson or PipelineString
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ * Note: Syntax, parsing, and logic consistency checks are performed on all sources during build
+ *
+ * @param promptbookSources
+ * @returns PipelineCollection
+ * @public exported from `@promptbook/core`
+ */
+function createCollectionFromJson() {
+    var promptbooks = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        promptbooks[_i] = arguments[_i];
+    }
+    return new (SimplePipelineCollection.bind.apply(SimplePipelineCollection, __spreadArray([void 0], __read(promptbooks), false)))();
+}
+
+/**
+ * This error type indicates that some tools are missing for pipeline execution or preparation
+ *
+ * @public exported from `@promptbook/core`
+ */
+var MissingToolsError = /** @class */ (function (_super) {
+    __extends(MissingToolsError, _super);
+    function MissingToolsError(message) {
+        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation\n\n                "); })) || this;
+        _this.name = 'MissingToolsError';
+        Object.setPrototypeOf(_this, MissingToolsError.prototype);
+        return _this;
+    }
+    return MissingToolsError;
+}(Error));
+
+/**
+ * This error indicates problems parsing the format value
+ *
+ * For example, when the format value is not a valid JSON or CSV
+ * This is not thrown directly but in extended classes
+ *
+ * @public exported from `@promptbook/core`
+ */
+var AbstractFormatError = /** @class */ (function (_super) {
+    __extends(AbstractFormatError, _super);
+    // Note: To allow instanceof do not put here error `name`
+    // public readonly name = 'AbstractFormatError';
+    function AbstractFormatError(message) {
+        var _this = _super.call(this, message) || this;
+        Object.setPrototypeOf(_this, AbstractFormatError.prototype);
+        return _this;
+    }
+    return AbstractFormatError;
+}(Error));
+
+/**
+ * This error indicates problem with parsing of CSV
+ *
+ * @public exported from `@promptbook/core`
+ */
+var CsvFormatError = /** @class */ (function (_super) {
+    __extends(CsvFormatError, _super);
+    function CsvFormatError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'CsvFormatError';
+        Object.setPrototypeOf(_this, CsvFormatError.prototype);
+        return _this;
+    }
+    return CsvFormatError;
+}(AbstractFormatError));
+
+/**
+ * This error indicates that the pipeline collection cannot be propperly loaded
+ *
+ * @public exported from `@promptbook/core`
+ */
+var CollectionError = /** @class */ (function (_super) {
+    __extends(CollectionError, _super);
+    function CollectionError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'CollectionError';
+        Object.setPrototypeOf(_this, CollectionError.prototype);
+        return _this;
+    }
+    return CollectionError;
+}(Error));
+
+/**
+ * This error occurs when some expectation is not met in the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
+ * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
+ * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
+ * Note: This is a kindof subtype of PipelineExecutionError
+ */
+var ExpectError = /** @class */ (function (_super) {
+    __extends(ExpectError, _super);
+    function ExpectError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'ExpectError';
+        Object.setPrototypeOf(_this, ExpectError.prototype);
+        return _this;
+    }
+    return ExpectError;
+}(Error));
+
+/**
+ * This error indicates that the promptbook can not retrieve knowledge from external sources
+ *
+ * @public exported from `@promptbook/core`
+ */
+var KnowledgeScrapeError = /** @class */ (function (_super) {
+    __extends(KnowledgeScrapeError, _super);
+    function KnowledgeScrapeError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'KnowledgeScrapeError';
+        Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
+        return _this;
+    }
+    return KnowledgeScrapeError;
+}(Error));
+
+/**
+ * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
+ */
+var LimitReachedError = /** @class */ (function (_super) {
+    __extends(LimitReachedError, _super);
+    function LimitReachedError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'LimitReachedError';
+        Object.setPrototypeOf(_this, LimitReachedError.prototype);
+        return _this;
+    }
+    return LimitReachedError;
+}(Error));
+
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+var PROMPTBOOK_ERRORS = {
+    AbstractFormatError: AbstractFormatError,
+    CsvFormatError: CsvFormatError,
+    CollectionError: CollectionError,
+    EnvironmentMismatchError: EnvironmentMismatchError,
+    ExpectError: ExpectError,
+    KnowledgeScrapeError: KnowledgeScrapeError,
+    LimitReachedError: LimitReachedError,
+    MissingToolsError: MissingToolsError,
+    NotFoundError: NotFoundError,
+    NotYetImplementedError: NotYetImplementedError,
+    ParseError: ParseError,
+    PipelineExecutionError: PipelineExecutionError,
+    PipelineLogicError: PipelineLogicError,
+    PipelineUrlError: PipelineUrlError,
+    UnexpectedError: UnexpectedError,
+    // TODO: [🪑]> VersionMismatchError,
+};
+/**
+ * Index of all javascript errors
+ *
+ * @private for internal usage
+ */
+var COMMON_JAVASCRIPT_ERRORS = {
+    Error: Error,
+    EvalError: EvalError,
+    RangeError: RangeError,
+    ReferenceError: ReferenceError,
+    SyntaxError: SyntaxError,
+    TypeError: TypeError,
+    URIError: URIError,
+    AggregateError: AggregateError,
+    /*
+  Note: Not widely supported
+  > InternalError,
+  > ModuleError,
+  > HeapError,
+  > WebAssemblyCompileError,
+  > WebAssemblyRuntimeError,
+  */
+};
+/**
+ * Index of all errors
+ *
+ * @private for internal usage
+ */
+var ALL_ERRORS = __assign(__assign({}, PROMPTBOOK_ERRORS), COMMON_JAVASCRIPT_ERRORS);
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
 /**
- * Parses the task and returns the list of all parameter names
+ * Deserializes the error object
  *
- * @param template the string template with parameters in {curly} braces
- * @returns the list of parameter names
  * @public exported from `@promptbook/utils`
  */
-function extractParameterNames(template) {
-    var e_1, _a;
-    var matches = template.matchAll(/{\w+}/g);
-    var parameterNames = new Set();
-    try {
-        for (var matches_1 = __values(matches), matches_1_1 = matches_1.next(); !matches_1_1.done; matches_1_1 = matches_1.next()) {
-            var match = matches_1_1.value;
-            var parameterName = match[0].slice(1, -1);
-            parameterNames.add(parameterName);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (matches_1_1 && !matches_1_1.done && (_a = matches_1.return)) _a.call(matches_1);
-        }
-        finally { if (e_1) throw e_1.error; }
+function deserializeError(error) {
+    var ErrorClass = ALL_ERRORS[error.name];
+    if (ErrorClass === undefined) {
+        return new Error("".concat(error.name, ": ").concat(error.message));
     }
-    return parameterNames;
+    return new ErrorClass(error.message);
 }
 
 /**
- * Unprepare just strips the preparation data of the pipeline
+ * Asserts that the execution of a Promptbook is successful
  *
- * @deprecated In future version this function will be removed or deprecated
+ * @param executionResult - The partial result of the Promptbook execution
+ * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
  * @public exported from `@promptbook/core`
  */
-function unpreparePipeline(pipeline) {
-    var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources, tasks = pipeline.tasks;
-    personas = personas.map(function (persona) { return (__assign(__assign({}, persona), { modelRequirements: undefined, preparationIds: undefined })); });
-    knowledgeSources = knowledgeSources.map(function (knowledgeSource) { return (__assign(__assign({}, knowledgeSource), { preparationIds: undefined })); });
-    tasks = tasks.map(function (task) {
-        var dependentParameterNames = task.dependentParameterNames;
-        var parameterNames = extractParameterNames(task.preparedContent || '');
-        dependentParameterNames = dependentParameterNames.filter(function (dependentParameterName) { return !parameterNames.has(dependentParameterName); });
-        var taskUnprepared = __assign(__assign({}, task), { dependentParameterNames: dependentParameterNames });
-        delete taskUnprepared.preparedContent;
-        return taskUnprepared;
-    });
-    return exportJson({
-        name: 'pipelineJson',
-        message: "Result of `unpreparePipeline`",
-        order: ORDER_OF_PIPELINE_JSON,
-        value: __assign(__assign({}, pipeline), { tasks: tasks, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] }),
-    });
-}
-/**
- * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- * TODO: Write tests for `preparePipeline`
- * TODO: [🍙] Make some standard order of json properties
- */
-
-/**
- * Library of pipelines that groups together pipelines for an application.
- * This implementation is a very thin wrapper around the Array / Map of pipelines.
- *
- * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
- * @see https://github.com/webgptorg/pipeline#pipeline-collection
- */
-var SimplePipelineCollection = /** @class */ (function () {
-    /**
-     * Constructs a pipeline collection from pipelines
-     *
-     * @param pipelines @@@
-     *
-     * Note: During the construction logic of all pipelines are validated
-     * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
-     */
-    function SimplePipelineCollection() {
-        var e_1, _a;
-        var pipelines = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            pipelines[_i] = arguments[_i];
-        }
-        this.collection = new Map();
-        try {
-            for (var pipelines_1 = __values(pipelines), pipelines_1_1 = pipelines_1.next(); !pipelines_1_1.done; pipelines_1_1 = pipelines_1.next()) {
-                var pipeline = pipelines_1_1.value;
-                // TODO: [👠] DRY
-                if (pipeline.pipelineUrl === undefined) {
-                    throw new PipelineUrlError(spaceTrim$1("\n                        Pipeline with name \"".concat(pipeline.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines without URLs are called anonymous pipelines\n                              They can be used as standalone pipelines, but they cannot be referenced by other pipelines\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
-                }
-                // Note: [🐨]
-                validatePipeline(pipeline);
-                // TODO: [🦄] DRY
-                // Note: [🦄]
-                if (
-                // TODO: [🐽]
-                this.collection.has(pipeline.pipelineUrl) &&
-                    pipelineJsonToString(unpreparePipeline(pipeline)) !==
-                        pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
-                    var existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new PipelineUrlError(spaceTrim$1("\n                        Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection \uD83C\uDF4E\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                        Note: Pipelines with the same URL are not allowed\n                              Only exepction is when the pipelines are identical\n\n                    ")));
-                }
-                // Note: [🧠] Overwrite existing pipeline with the same URL
-                this.collection.set(pipeline.pipelineUrl, pipeline);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (pipelines_1_1 && !pipelines_1_1.done && (_a = pipelines_1.return)) _a.call(pipelines_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
+function assertsExecutionSuccessful(executionResult) {
+    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
+    if (isSuccessful === true) {
+        return;
     }
-    /**
-     * Gets all pipelines in the collection
-     */
-    SimplePipelineCollection.prototype.listPipelines = function () {
-        return Array.from(this.collection.keys());
-    };
-    /**
-     * Gets pipeline by its URL
-     *
-     * Note: This is not a direct fetching from the URL, but a lookup in the collection
-     */
-    SimplePipelineCollection.prototype.getPipelineByUrl = function (url) {
-        var _this = this;
-        var pipeline = this.collection.get(url);
-        if (!pipeline) {
-            if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim$1("\n                            Pipeline with url \"".concat(url, "\" not found\n\n                            No pipelines available\n                        ")));
-            }
-            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Pipeline with url \"".concat(url, "\" not found\n\n                        Available pipelines:\n                        ").concat(block(_this.listPipelines()
-                .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
-                .join('\n')), "\n\n                    "); }));
-        }
-        return pipeline;
-    };
-    /**
-     * Checks whether given prompt was defined in any pipeline in the collection
-     */
-    SimplePipelineCollection.prototype.isResponsibleForPrompt = function (prompt) {
-        return true;
-    };
-    return SimplePipelineCollection;
-}());
-
-/**
- * Creates PipelineCollection from array of PipelineJson or PipelineString
- *
- * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
- * Note: Syntax, parsing, and logic consistency checks are performed on all sources during build
- *
- * @param promptbookSources
- * @returns PipelineCollection
- * @public exported from `@promptbook/core`
- */
-function createCollectionFromJson() {
-    var promptbooks = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        promptbooks[_i] = arguments[_i];
+    if (errors.length === 0) {
+        throw new PipelineExecutionError("Promptbook Execution failed because of unknown reason");
+    }
+    else if (errors.length === 1) {
+        throw deserializeError(errors[0]);
+    }
+    else {
+        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                    Multiple errors occurred during Promptbook execution\n\n                    ".concat(block(errors
+            .map(function (_a, index) {
+            var name = _a.name, stack = _a.stack, message = _a.message;
+            return spaceTrim$1(function (block) { return "\n                                        ".concat(name, " ").concat(index + 1, ":\n                                        ").concat(block(stack || message), "\n                                    "); });
+        })
+            .join('\n')), "\n                "); }));
     }
-    return new (SimplePipelineCollection.bind.apply(SimplePipelineCollection, __spreadArray([void 0], __read(promptbooks), false)))();
 }
+/**
+ * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
+ * TODO: [🧠] Can this return type be better typed than void
+ */
 
 /**
  * Determine if the pipeline is fully prepared
@@ -3919,7 +3960,7 @@ function isPipelinePrepared(pipeline) {
     return true;
 }
 /**
- * TODO: [🔃][main] !! If the pipeline was prepared with different version or different set of models, prepare it once again
+ * TODO: [🔃][main] If the pipeline was prepared with different version or different set of models, prepare it once again
  * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
@@ -4354,27 +4395,6 @@ var CsvFormatDefinition = {
  * TODO: [🏢] Allow to expect something inside CSV objects and other formats
  */
 
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
-    }
-}
-
 /**
  * Definition for JSON format
  *
@@ -4768,6 +4788,8 @@ function templateParameters(template, parameters) {
             throw new PipelineExecutionError("Parameter `{".concat(parameterName, "}` is not defined"));
         }
         parameterValue = valueToString(parameterValue);
+        // Escape curly braces in parameter values to prevent prompt-injection
+        parameterValue = parameterValue.replace(/[{}]/g, '\\$&');
         if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
             parameterValue = parameterValue
                 .split('\n')
@@ -5127,7 +5149,7 @@ function executeAttempts(options) {
                                             promptTitle: task.title,
                                             promptMessage: templateParameters(task.description || '', parameters),
                                             defaultValue: templateParameters(preparedContent, parameters),
-                                            // TODO: [🧠] !! Figure out how to define placeholder in .book.md file
+                                            // TODO: [🧠] Figure out how to define placeholder in .book.md file
                                             placeholder: undefined,
                                             priority: priority,
                                         }))];
@@ -6203,10 +6225,10 @@ function preparePersona(personaDescription, tools, options) {
     });
 }
 /**
- * TODO: [🔃][main] !! If the persona was prepared with different version or different set of models, prepare it once again
- * TODO: [🏢] !! Check validity of `modelName` in pipeline
- * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
- * TODO: [🏢] !! Check validity of `temperature` in pipeline
+ * TODO: [🔃][main] If the persona was prepared with different version or different set of models, prepare it once again
+ * TODO: [🏢] Check validity of `modelName` in pipeline
+ * TODO: [🏢] Check validity of `systemMessage` in pipeline
+ * TODO: [🏢] Check validity of `temperature` in pipeline
  */
 
 /**
@@ -6743,7 +6765,7 @@ function prepareTasks(pipeline, tools, options) {
  * TODO: [😂] Adding knowledge should be convert to async high-level abstractions, simmilar thing with expectations to sync high-level abstractions
  * TODO: [🧠] Add context to each task (if missing)
  * TODO: [🧠] What is better name `prepareTask` or `prepareTaskAndParameters`
- * TODO: [♨][main] !!! Prepare index the examples and maybe tasks
+ * TODO: [♨][main] !!3 Prepare index the examples and maybe tasks
  * TODO: Write tests for `preparePipeline`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
@@ -6806,17 +6828,10 @@ function preparePipeline(pipeline, tools, options) {
                             _d.tools = tools,
                             _d)]);
                     return [4 /*yield*/, prepareTitleExecutor({
-                            book: sources
-                                .map(function (_a) {
+                            book: sources.map(function (_a) {
                                 var content = _a.content;
                                 return content;
-                            })
-                                .join('\n\n')
-                                // TODO: !!!!!!! Parameters in parameters - DO NOT ALLOW, ESCAPE:
-                                .split('{')
-                                .join('[')
-                                .split('}')
-                                .join(']'),
+                            }).join('\n\n'),
                         })];
                 case 2:
                     result = _e.sent();
@@ -6970,7 +6985,7 @@ var knowledgeCommandParser = {
         if (sourceContent === '') {
             throw new ParseError("Source is not defined");
         }
-        // TODO: [main] !!!! Following checks should be applied every link in the `sourceContent`
+        // TODO: [main] !!4 Following checks should be applied every link in the `sourceContent`
         if (sourceContent.startsWith('http://')) {
             throw new ParseError("Source is not secure");
         }
@@ -7142,7 +7157,7 @@ var sectionCommandParser = {
             expectResultingParameterName();
             var parameter = $pipelineJson.parameters.find(function (param) { return param.name === $taskJson.resultingParameterName; });
             if (parameter === undefined) {
-                // TODO: !!!!!! Change to logic error for higher level abstraction of chatbot to work
+                // TODO: !!6 Change to logic error for higher level abstraction of chatbot to work
                 throw new ParseError("Parameter `{".concat($taskJson.resultingParameterName, "}` is not defined so can not define example value of it"));
             }
             parameter.exampleValues = parameter.exampleValues || [];
@@ -7153,7 +7168,7 @@ var sectionCommandParser = {
         if (command.taskType === 'KNOWLEDGE') {
             knowledgeCommandParser.$applyToPipelineJson({
                 type: 'KNOWLEDGE',
-                sourceContent: $taskJson.content, // <- TODO: [🐝][main] !!! Work with KNOWLEDGE which not referring to the source file or website, but its content itself
+                sourceContent: $taskJson.content, // <- TODO: [🐝][main] !!3 Work with KNOWLEDGE which not referring to the source file or website, but its content itself
             }, $pipelineJson);
             $taskJson.isTask = false;
             return;
@@ -9098,7 +9113,7 @@ var COMMANDS = [
     instrumentCommandParser,
     personaCommandParser,
     foreachCommandParser,
-    boilerplateCommandParser, // <- TODO: !! Only in development, remove in production
+    boilerplateCommandParser, // <- TODO: Only in development, remove in production
     // <- Note: [♓️][💩] This is the order of the commands in the pipeline, BUT its not used in parsing and before usage maybe it should be done better
 ];
 /**
@@ -9844,7 +9859,7 @@ function parsePipeline(pipelineString) {
             {
                 type: 'BOOK',
                 path: null,
-                // <- TODO: !!!!!! Pass here path of the file
+                // <- TODO: !!6 Pass here path of the file
                 content: pipelineString,
             },
         ],
@@ -9869,10 +9884,11 @@ function parsePipeline(pipelineString) {
         if (!(shebangLine_1 || '').includes('ptbk')) {
             throw new ParseError(spaceTrim$1(function (block) { return "\n                        It seems that you try to parse a book file which has non-standard shebang line for book files:\n                        Shebang line must contain 'ptbk'\n\n                        You have:\n                        ".concat(block(shebangLine_1 || '(empty line)'), "\n\n                        It should look like this:\n                        #!/usr/bin/env ptbk\n\n                        ").concat(block(getPipelineIdentification()), "\n                    "); }));
         }
-        pipelineString = restLines.join('\n');
+        pipelineString = validatePipelineString(restLines.join('\n'));
     }
     pipelineString = removeMarkdownComments(pipelineString);
     pipelineString = spaceTrim$1(pipelineString);
+    // <- TODO: [😧] `spaceTrim` should preserve discriminated type *(or at lease `PipelineString`)*
     // ==============
     // Note: 1️⃣◽2️⃣ Process flat pipeline
     var isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
@@ -9887,8 +9903,8 @@ function parsePipeline(pipelineString) {
         var pipelineStringLines = pipelineString.split('\n');
         var returnStatement_1 = pipelineStringLines.pop();
         var prompt_1 = spaceTrim$1(pipelineStringLines.join('\n'));
-        pipelineString = spaceTrim$1(function (block) { return "\n                # ".concat(DEFAULT_BOOK_TITLE, "\n\n                ## Prompt\n\n                ```\n                ").concat(block(prompt_1), "\n                ```\n\n                ").concat(returnStatement_1, "\n            "); });
-        // <- TODO: !!!!!! Use book` notation
+        pipelineString = validatePipelineString(spaceTrim$1(function (block) { return "\n                    # ".concat(DEFAULT_BOOK_TITLE, "\n\n                    ## Prompt\n\n                    ```\n                    ").concat(block(prompt_1), "\n                    ```\n\n                    ").concat(returnStatement_1, "\n                "); }));
+        // <- TODO: Maybe use book` notation
         // console.log(pipelineString);
     }
     // ==============
@@ -10289,7 +10305,7 @@ function parsePipeline(pipelineString) {
 }
 /**
  * TODO: [🧠] Maybe more things here can be refactored as high-level abstractions
- * TODO: [main] !!!! Warn if used only sync version
+ * TODO: [main] !!4 Warn if used only sync version
  * TODO: [🚞] Report here line/column of error
  * TODO: Use spaceTrim more effectively
  * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
@@ -10705,7 +10721,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
         var parameter = pipelineJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
         if (!parameter) {
             throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
-            // <- TODO: !!!!!! This causes problems when {knowledge} and other reserved parameters are used
+            // <- TODO: !!6 This causes problems when {knowledge} and other reserved parameters are used
         }
         if (parameter.isInput) {
             return 'input';
@@ -10749,9 +10765,9 @@ function renderPromptbookMermaid(pipelineJson, options) {
     return promptbookMermaid;
 }
 /**
- * TODO: [🧠] !! FOREACH in mermaid graph
- * TODO: [🧠] !! Knowledge in mermaid graph
- * TODO: [🧠] !! Personas in mermaid graph
+ * TODO: [🧠] FOREACH in mermaid graph
+ * TODO: [🧠] Knowledge in mermaid graph
+ * TODO: [🧠] Personas in mermaid graph
  * TODO: Maybe use some Mermaid package instead of string templating
  * TODO: [🕌] When more than 2 functionalities, split into separate functions
  */
@@ -11020,7 +11036,7 @@ function preserve(func) {
 }
 /**
  * TODO: Probbably remove in favour of `keepImported`
- * TODO: !! [1] This maybe does memory leak
+ * TODO: [1] This maybe does memory leak
  */
 
 /**
@@ -11454,7 +11470,7 @@ function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
  */
 function createCollectionFromDirectory(path, tools, options) {
     return __awaiter(this, void 0, void 0, function () {
-        var madeLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, collection;
+        var madeLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, rootUrl, collection;
         var _this = this;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -11477,10 +11493,10 @@ function createCollectionFromDirectory(path, tools, options) {
                     if (!(_f.sent())) ;
                     else {
                         colors.green("(In future, not implemented yet) Using your compiled pipeline collection ".concat(madeLibraryFilePath));
-                        // TODO: !! Implement;
+                        // TODO: Implement;
                         // TODO: [🌗]
                     }
-                    _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e;
+                    _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e, rootUrl = _a.rootUrl;
                     collection = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
                         var fileNames, collection, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
                         var e_1, _a;
@@ -11506,34 +11522,35 @@ function createCollectionFromDirectory(path, tools, options) {
                                     });
                                     collection = new Map();
                                     _loop_1 = function (fileName) {
-                                        var sourceFile, rootDirname, pipeline, pipelineString, _c, _d, existing, error_1, wrappedErrorMessage;
-                                        return __generator(this, function (_e) {
-                                            switch (_e.label) {
+                                        var sourceFile, rootDirname, pipeline, pipelineString, _c, _d, _e, pipelineUrl, existing, error_1, wrappedErrorMessage;
+                                        return __generator(this, function (_f) {
+                                            switch (_f.label) {
                                                 case 0:
                                                     sourceFile = './' + fileName.split('\\').join('/');
                                                     rootDirname = dirname(sourceFile).split('\\').join('/');
-                                                    _e.label = 1;
+                                                    _f.label = 1;
                                                 case 1:
-                                                    _e.trys.push([1, 8, , 9]);
+                                                    _f.trys.push([1, 8, , 9]);
                                                     pipeline = null;
                                                     if (!fileName.endsWith('.book.md')) return [3 /*break*/, 4];
+                                                    _c = validatePipelineString;
                                                     return [4 /*yield*/, readFile(fileName, 'utf-8')];
                                                 case 2:
-                                                    pipelineString = (_e.sent());
+                                                    pipelineString = _c.apply(void 0, [_f.sent()]);
                                                     return [4 /*yield*/, compilePipeline(pipelineString, tools, {
                                                             rootDirname: rootDirname,
                                                         })];
                                                 case 3:
-                                                    pipeline = _e.sent();
+                                                    pipeline = _f.sent();
                                                     pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
                                                 case 4:
                                                     if (!fileName.endsWith('.book.json')) return [3 /*break*/, 6];
-                                                    _d = (_c = JSON).parse;
+                                                    _e = (_d = JSON).parse;
                                                     return [4 /*yield*/, readFile(fileName, 'utf-8')];
                                                 case 5:
                                                     // TODO: Handle non-valid JSON files
-                                                    pipeline = _d.apply(_c, [_e.sent()]);
+                                                    pipeline = _e.apply(_d, [_f.sent()]);
                                                     // TODO: [🌗]
                                                     pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
@@ -11541,10 +11558,24 @@ function createCollectionFromDirectory(path, tools, options) {
                                                     if (isVerbose) {
                                                         console.info(colors.gray("Skipped file ".concat(fileName.split('\\').join('/'), " \u2013\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060 Not a book")));
                                                     }
-                                                    _e.label = 7;
+                                                    _f.label = 7;
                                                 case 7:
                                                     // ---
                                                     if (pipeline !== null) {
+                                                        if (rootUrl !== undefined) {
+                                                            if (pipeline.pipelineUrl === undefined) {
+                                                                pipelineUrl = rootUrl + '/' + fileName.split('\\').join('/');
+                                                                if (isVerbose) {
+                                                                    console.info(colors.yellow("Implicitly set pipeline URL to ".concat(pipelineUrl, " from ").concat(fileName
+                                                                        .split('\\')
+                                                                        .join('/'))));
+                                                                }
+                                                                pipeline = __assign(__assign({}, pipeline), { pipelineUrl: pipelineUrl });
+                                                            }
+                                                            else if (!pipeline.pipelineUrl.startsWith(rootUrl)) {
+                                                                throw new PipelineUrlError(spaceTrim("\n                                    Pipeline with URL ".concat(pipeline.pipelineUrl, " is not a child of the root URL ").concat(rootUrl, " \uD83C\uDF4F\n\n                                    File:\n                                    ").concat(sourceFile || 'Unknown', "\n\n                                ")));
+                                                            }
+                                                        }
                                                         // TODO: [👠] DRY
                                                         if (pipeline.pipelineUrl === undefined) {
                                                             if (isVerbose) {
@@ -11576,17 +11607,17 @@ function createCollectionFromDirectory(path, tools, options) {
                                                             }
                                                             else {
                                                                 existing = collection.get(pipeline.pipelineUrl);
-                                                                throw new PipelineUrlError(spaceTrim("\n                                    Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection \uD83C\uDF4F\n\n                                    Conflicting files:\n                                    ").concat(existing.sourceFile || 'Unknown', "\n                                    ").concat(pipeline.sourceFile || 'Unknown', "\n\n                                    Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                                    Note: Pipelines with the same URL are not allowed\n                                          Only exepction is when the pipelines are identical\n\n                                ")));
+                                                                throw new PipelineUrlError(spaceTrim("\n                                    Pipeline with URL ".concat(pipeline.pipelineUrl, " is already in the collection \uD83C\uDF4F\n\n                                    Conflicting files:\n                                    ").concat(existing.sourceFile || 'Unknown', "\n                                    ").concat(pipeline.sourceFile || 'Unknown', "\n\n                                    Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                                    Note: Pipelines with the same URL are not allowed\n                                          Only exepction is when the pipelines are identical\n\n                                ")));
                                                             }
                                                         }
                                                     }
                                                     return [3 /*break*/, 9];
                                                 case 8:
-                                                    error_1 = _e.sent();
+                                                    error_1 = _f.sent();
                                                     if (!(error_1 instanceof Error)) {
                                                         throw error_1;
                                                     }
-                                                    wrappedErrorMessage = spaceTrim(function (block) { return "\n                        ".concat(error_1.name, " in pipeline ").concat(fileName.split('\\').join('/'), "\u2060:\n\n                        Original error message:\n                        ").concat(block(error_1.message), "\n\n                        Original stack trace:\n                        ").concat(block(error_1.stack || ''), "\n\n                        ---\n\n                    "); }) + '\n';
+                                                    wrappedErrorMessage = spaceTrim(function (block) { return "\n                            ".concat(error_1.name, " in pipeline ").concat(fileName.split('\\').join('/'), "\u2060:\n\n                            Original error message:\n                            ").concat(block(error_1.message), "\n\n                            Original stack trace:\n                            ").concat(block(error_1.stack || ''), "\n\n                            ---\n\n                        "); }) + '\n';
                                                     if (isCrashedOnError) {
                                                         throw new CollectionError(wrappedErrorMessage);
                                                     }
@@ -11721,6 +11752,7 @@ function initializeMakeCommand(program) {
     // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
     'Path to promptbook collection directory', DEFAULT_BOOKS_DIRNAME);
     makeCommand.option('--project-name', "Name of the project for whom collection is", 'Untitled Promptbook project');
+    makeCommand.option('--root-url <url>', "Root URL of all pipelines to make", undefined);
     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');
@@ -11729,7 +11761,7 @@ function initializeMakeCommand(program) {
     makeCommand.option('-o, --output <path>', spaceTrim("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
     makeCommand.option('-fn, --function-name <functionName>', spaceTrim("\n            Name of the function to get pipeline collection\n\n            Note: This can be used only with \"javascript\" or \"typescript\" format\n\n        "), DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME);
     makeCommand.action(function (path, _a) {
-        var projectName = _a.projectName, format = _a.format, functionName = _a.functionName, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, output = _a.output;
+        var projectName = _a.projectName, rootUrl = _a.rootUrl, format = _a.format, functionName = _a.functionName, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, output = _a.output;
         return __awaiter(_this, void 0, void 0, function () {
             var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, pipelinesUrls, validations_1, validations_1_1, validation_1, pipelinesUrls_1, pipelinesUrls_1_1, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
             var _b, e_2, _c, e_1, _d;
@@ -11741,6 +11773,10 @@ function initializeMakeCommand(program) {
                             console.error(colors.red("Function name \"".concat(functionName, "\" is not valid javascript name")));
                             return [2 /*return*/, process.exit(1)];
                         }
+                        if (!isValidUrl(rootUrl) /* <- Note: Not using `isValidPipelineUrl` because this is root url not book url */) {
+                            console.error(colors.red("Root URL ".concat(rootUrl, " is not valid URL")));
+                            return [2 /*return*/, process.exit(1)];
+                        }
                         formats = (format || '')
                             .split(',')
                             .map(function (_) { return _.trim(); })
@@ -11777,7 +11813,10 @@ function initializeMakeCommand(program) {
                             _b);
                         return [4 /*yield*/, createCollectionFromDirectory(path, tools, {
                                 isVerbose: isVerbose,
+                                rootUrl: rootUrl,
                                 isRecursive: true,
+                                isLazyLoaded: false,
+                                isCrashedOnError: true,
                                 // <- TODO: [🍖] Add `intermediateFilesStrategy`
                             })];
                     case 4:
@@ -11897,7 +11936,7 @@ function initializeMakeCommand(program) {
                     case 24:
                         if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 26];
                         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 `").concat(functionName, "`\n                             * @generated\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                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(): PipelineCollection{\n                                if(pipelineCollection===null){\n\n                                    // TODO: !!!!!! Use book string literal notation\n                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                                    pipelineCollection = (createCollectionFromJson as (..._: any) => PipelineCollection)(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return 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 `").concat(functionName, "`\n                             * @generated\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                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(): PipelineCollection{\n                                if(pipelineCollection===null){\n\n                                    // TODO: !!6 Use book string literal notation\n                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                                    pipelineCollection = (createCollectionFromJson as (..._: any) => PipelineCollection)(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
                     case 25:
                         _e.sent();
                         _e.label = 26;
@@ -11916,7 +11955,7 @@ function initializeMakeCommand(program) {
     });
 }
 /**
- * TODO: [🥃][main] !!! Allow `ptbk make` without configuring any llm tools
+ * TODO: [🥃][main] !!3 Allow `ptbk make` without configuring any llm tools
  * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
@@ -11981,6 +12020,7 @@ function prettifyPipelineString(pipelineString, options) {
                 case 2:
                     if (isPrettifyed) {
                         pipelineString = prettifyMarkdown(pipelineString);
+                        // <- TODO: [😧] `prettifyMarkdown` should preserve discriminated type *(or at lease `PipelineString`)*
                     }
                     return [2 /*return*/, pipelineString];
             }
@@ -12009,18 +12049,18 @@ function initializePrettifyCommand(program) {
     prettifyCommand.action(function (filesGlob, _a) {
         var ignore = _a.ignore, isVerbose = _a.verbose;
         return __awaiter(_this, void 0, void 0, function () {
-            var filenames, filenames_1, filenames_1_1, filename, pipelineMarkdown, error_1, e_1_1;
-            var e_1, _b;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var filenames, filenames_1, filenames_1_1, filename, pipelineMarkdown, _b, error_1, e_1_1;
+            var e_1, _c;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
                     case 0: return [4 /*yield*/, glob(filesGlob, { ignore: ignore })];
                     case 1:
-                        filenames = _c.sent();
-                        _c.label = 2;
+                        filenames = _d.sent();
+                        _d.label = 2;
                     case 2:
-                        _c.trys.push([2, 11, 12, 13]);
+                        _d.trys.push([2, 11, 12, 13]);
                         filenames_1 = __values(filenames), filenames_1_1 = filenames_1.next();
-                        _c.label = 3;
+                        _d.label = 3;
                     case 3:
                         if (!!filenames_1_1.done) return [3 /*break*/, 10];
                         filename = filenames_1_1.value;
@@ -12028,28 +12068,29 @@ function initializePrettifyCommand(program) {
                             console.info(colors.gray("Skipping ".concat(filename)));
                             return [3 /*break*/, 9];
                         }
+                        _b = validatePipelineString;
                         return [4 /*yield*/, readFile(filename, 'utf-8')];
                     case 4:
-                        pipelineMarkdown = (_c.sent());
-                        _c.label = 5;
+                        pipelineMarkdown = _b.apply(void 0, [_d.sent()]);
+                        _d.label = 5;
                     case 5:
-                        _c.trys.push([5, 8, , 9]);
+                        _d.trys.push([5, 8, , 9]);
                         return [4 /*yield*/, prettifyPipelineString(pipelineMarkdown, {
                                 isGraphAdded: true,
                                 isPrettifyed: true,
                                 // <- [🕌]
                             })];
                     case 6:
-                        pipelineMarkdown = _c.sent();
+                        pipelineMarkdown = _d.sent();
                         return [4 /*yield*/, writeFile(filename, pipelineMarkdown)];
                     case 7:
-                        _c.sent();
+                        _d.sent();
                         if (isVerbose) {
                             console.info(colors.green("Prettify ".concat(filename)));
                         }
                         return [3 /*break*/, 9];
                     case 8:
-                        error_1 = _c.sent();
+                        error_1 = _d.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
@@ -12062,12 +12103,12 @@ function initializePrettifyCommand(program) {
                         return [3 /*break*/, 3];
                     case 10: return [3 /*break*/, 13];
                     case 11:
-                        e_1_1 = _c.sent();
+                        e_1_1 = _d.sent();
                         e_1 = { error: e_1_1 };
                         return [3 /*break*/, 13];
                     case 12:
                         try {
-                            if (filenames_1_1 && !filenames_1_1.done && (_b = filenames_1.return)) _b.call(filenames_1);
+                            if (filenames_1_1 && !filenames_1_1.done && (_c = filenames_1.return)) _c.call(filenames_1);
                         }
                         finally { if (e_1) throw e_1.error; }
                         return [7 /*endfinally*/];
@@ -12393,6 +12434,30 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Should be in generated file GENERATOR_WARNING
  */
 
+/**
+ * Function `isValidPipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {boolean} if the string is a valid pipeline string
+ * @public exported from `@promptbook/core`
+ */
+function isValidPipelineString(pipelineString) {
+    try {
+        validatePipelineString(pipelineString);
+        return true;
+    }
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        return false;
+    }
+}
+/**
+ * TODO: [🧠][🈴] Where is the best location for this file
+ */
+
 /**
  * @see ./wizzard.ts `getPipeline` method
  *
@@ -12400,11 +12465,11 @@ function executionReportJsonToString(executionReportJson, options) {
  */
 function $getCompiledBook(tools, pipelineSource, options) {
     return __awaiter(this, void 0, void 0, function () {
-        var fs, fetch, filePathRaw, filePath, filePathCandidates, filePathCandidates_1, filePathCandidates_1_1, filePathCandidate, pipelineString, pipelineJson, e_1_1, rootDirname, _loop_1, i, state_1, response_1, pipelineString, pipelineJson, pipelineJson;
-        var e_1, _a;
+        var fs, fetch, filePathRaw, filePath, filePathCandidates, filePathCandidates_1, filePathCandidates_1_1, filePathCandidate, pipelineString, _a, pipelineJson, e_1_1, rootDirname, _loop_1, i, state_1, response_1, pipelineString, pipelineJson, pipelineJson;
+        var e_1, _b;
         var _this = this;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
+        return __generator(this, function (_c) {
+            switch (_c.label) {
                 case 0:
                     fs = tools.fs, fetch = tools.fetch;
                     if (!isValidFilePath(pipelineSource)) return [3 /*break*/, 10];
@@ -12412,11 +12477,11 @@ function $getCompiledBook(tools, pipelineSource, options) {
                     filePath = null;
                     filePathCandidates = [filePathRaw, "".concat(filePathRaw, ".md"), "".concat(filePathRaw, ".book.md"), "".concat(filePathRaw, ".book.md")];
                     filePathCandidates = __spreadArray(__spreadArray([], __read(filePathCandidates), false), __read(filePathCandidates.map(function (path) { return path.split('\\').join('/'); })), false);
-                    _b.label = 1;
+                    _c.label = 1;
                 case 1:
-                    _b.trys.push([1, 8, 9, 10]);
+                    _c.trys.push([1, 8, 9, 10]);
                     filePathCandidates_1 = __values(filePathCandidates), filePathCandidates_1_1 = filePathCandidates_1.next();
-                    _b.label = 2;
+                    _c.label = 2;
                 case 2:
                     if (!!filePathCandidates_1_1.done) return [3 /*break*/, 7];
                     filePathCandidate = filePathCandidates_1_1.value;
@@ -12424,26 +12489,27 @@ function $getCompiledBook(tools, pipelineSource, options) {
                         // <- TODO: Also test that among the candidates the file is book not just any file
                     ];
                 case 3:
-                    if (!_b.sent()) return [3 /*break*/, 6];
+                    if (!_c.sent()) return [3 /*break*/, 6];
                     filePath = filePathCandidate;
+                    _a = validatePipelineString;
                     return [4 /*yield*/, fs.readFile(filePath, 'utf-8')];
                 case 4:
-                    pipelineString = (_b.sent());
+                    pipelineString = _a.apply(void 0, [_c.sent()]);
                     return [4 /*yield*/, compilePipeline(pipelineString, tools, __assign({ rootDirname: process.cwd() }, options))];
                 case 5:
-                    pipelineJson = _b.sent();
+                    pipelineJson = _c.sent();
                     return [2 /*return*/, pipelineJson];
                 case 6:
                     filePathCandidates_1_1 = filePathCandidates_1.next();
                     return [3 /*break*/, 2];
                 case 7: return [3 /*break*/, 10];
                 case 8:
-                    e_1_1 = _b.sent();
+                    e_1_1 = _c.sent();
                     e_1 = { error: e_1_1 };
                     return [3 /*break*/, 10];
                 case 9:
                     try {
-                        if (filePathCandidates_1_1 && !filePathCandidates_1_1.done && (_a = filePathCandidates_1.return)) _a.call(filePathCandidates_1);
+                        if (filePathCandidates_1_1 && !filePathCandidates_1_1.done && (_b = filePathCandidates_1.return)) _b.call(filePathCandidates_1);
                     }
                     finally { if (e_1) throw e_1.error; }
                     return [7 /*endfinally*/];
@@ -12452,16 +12518,16 @@ function $getCompiledBook(tools, pipelineSource, options) {
                     rootDirname = process.cwd();
                     _loop_1 = function (i) {
                         var booksDirname, collection_1, pipeline;
-                        return __generator(this, function (_c) {
-                            switch (_c.label) {
+                        return __generator(this, function (_d) {
+                            switch (_d.label) {
                                 case 0:
                                     booksDirname = join(rootDirname, DEFAULT_BOOKS_DIRNAME /* <- TODO: [🕝] Make here more candidates */);
                                     return [4 /*yield*/, isDirectoryExisting(booksDirname, fs)];
                                 case 1:
-                                    if (!_c.sent()) return [3 /*break*/, 4];
+                                    if (!_d.sent()) return [3 /*break*/, 4];
                                     return [4 /*yield*/, createCollectionFromDirectory(booksDirname, tools, __assign({ isRecursive: true, rootDirname: booksDirname }, options))];
                                 case 2:
-                                    collection_1 = _c.sent();
+                                    collection_1 = _d.sent();
                                     return [4 /*yield*/, (function () { return __awaiter(_this, void 0, void 0, function () {
                                             var error_1;
                                             return __generator(this, function (_a) {
@@ -12482,12 +12548,12 @@ function $getCompiledBook(tools, pipelineSource, options) {
                                             });
                                         }); })()];
                                 case 3:
-                                    pipeline = _c.sent();
+                                    pipeline = _d.sent();
                                     // console.log({ pipeline });
                                     if (pipeline !== null) {
                                         return [2 /*return*/, { value: pipeline }];
                                     }
-                                    _c.label = 4;
+                                    _d.label = 4;
                                 case 4:
                                     if (isRootPath(rootDirname)) {
                                         return [2 /*return*/, "break-up_to_root"];
@@ -12499,18 +12565,18 @@ function $getCompiledBook(tools, pipelineSource, options) {
                         });
                     };
                     i = 0;
-                    _b.label = 11;
+                    _c.label = 11;
                 case 11:
                     if (!(i < LOOP_LIMIT)) return [3 /*break*/, 14];
                     return [5 /*yield**/, _loop_1(i)];
                 case 12:
-                    state_1 = _b.sent();
+                    state_1 = _c.sent();
                     if (typeof state_1 === "object")
                         return [2 /*return*/, state_1.value];
                     switch (state_1) {
                         case "break-up_to_root": return [3 /*break*/, 14];
                     }
-                    _b.label = 13;
+                    _c.label = 13;
                 case 13:
                     i++;
                     return [3 /*break*/, 11];
@@ -12518,21 +12584,26 @@ function $getCompiledBook(tools, pipelineSource, options) {
                     if (!isValidPipelineUrl(pipelineSource)) return [3 /*break*/, 18];
                     return [4 /*yield*/, fetch(pipelineSource)];
                 case 15:
-                    response_1 = _b.sent();
+                    response_1 = _c.sent();
                     if (response_1.status >= 300) {
                         throw new NotFoundError(spaceTrim(function (block) { return "\n                        Book not found on URL:\n                        ".concat(block(pipelineSource), "\n\n                        Request failed with status ").concat(block(response_1.status.toString()), " ").concat(block(response_1.statusText), "\n                    "); }));
                     }
                     return [4 /*yield*/, response_1.text()];
                 case 16:
-                    pipelineString = _b.sent();
+                    pipelineString = _c.sent();
+                    // console.log({ pipelineString });
+                    if (!isValidPipelineString(pipelineString)) {
+                        throw new NotFoundError(spaceTrim(function (block) { return "\n                        Book not found on URL:\n                        ".concat(block(pipelineSource), "\n\n                        Requested URL does not seem to contain a valid book\n                    "); }));
+                    }
                     return [4 /*yield*/, compilePipeline(pipelineString, tools, __assign({ rootDirname: null }, options))];
                 case 17:
-                    pipelineJson = _b.sent();
+                    pipelineJson = _c.sent();
                     return [2 /*return*/, pipelineJson];
                 case 18:
+                    if (!isValidPipelineString(pipelineSource)) return [3 /*break*/, 20];
                     return [4 /*yield*/, compilePipeline(pipelineSource, tools, __assign({ rootDirname: null }, options))];
                 case 19:
-                    pipelineJson = _b.sent();
+                    pipelineJson = _c.sent();
                     return [2 /*return*/, pipelineJson];
                 case 20: /* not else */ throw new NotFoundError(spaceTrim(function (block) { return "\n                Book not found:\n                ".concat(block(pipelineSource), "\n\n                Pipelines can be loaded from:\n                1) As a file ./books/write-cv.book.md\n                2) As a URL https://promptbook.studio/hejny/write-cv.book.md found in ./books folder recursively\n                2) As a URL https://promptbook.studio/hejny/write-cv.book.md fetched from the internet\n                3) As a string\n\n\n            "); }));
             }
@@ -12944,9 +13015,9 @@ function initializeRunCommand(program) {
     }); });
 }
 /**
- * TODO: !!!!! Catch and wrap all errors from CLI
+ * TODO: !!5 Catch and wrap all errors from CLI
  * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
- * TODO: [🥃][main] !!! Allow `ptbk run` without configuring any llm tools
+ * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
@@ -12970,10 +13041,10 @@ function initializeTestCommand(program) {
     testCommand.action(function (filesGlob, _a) {
         var ignore = _a.ignore, isCacheReloaded = _a.reload, isVerbose = _a.verbose;
         return __awaiter(_this, void 0, void 0, function () {
-            var prepareAndScrapeOptions, fs, llm, executables, tools, filenames, filenames_1, filenames_1_1, filename, pipeline, pipelineMarkdown, _b, _c, error_1, e_1_1;
-            var _d, e_1, _e;
-            return __generator(this, function (_f) {
-                switch (_f.label) {
+            var prepareAndScrapeOptions, fs, llm, executables, tools, filenames, filenames_1, filenames_1_1, filename, pipeline, pipelineMarkdown, _b, _c, _d, error_1, e_1_1;
+            var _e, e_1, _f;
+            return __generator(this, function (_g) {
+                switch (_g.label) {
                     case 0:
                         prepareAndScrapeOptions = {
                             isVerbose: isVerbose,
@@ -12982,53 +13053,54 @@ function initializeTestCommand(program) {
                         fs = $provideFilesystemForNode(prepareAndScrapeOptions);
                         return [4 /*yield*/, $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions)];
                     case 1:
-                        llm = _f.sent();
+                        llm = _g.sent();
                         return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
                     case 2:
-                        executables = _f.sent();
-                        _d = {
+                        executables = _g.sent();
+                        _e = {
                             llm: llm,
                             fs: fs
                         };
                         return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, prepareAndScrapeOptions)];
                     case 3:
-                        tools = (_d.scrapers = _f.sent(),
-                            _d.script = [
+                        tools = (_e.scrapers = _g.sent(),
+                            _e.script = [
                             /*new JavascriptExecutionTools(options)*/
                             ],
-                            _d);
+                            _e);
                         return [4 /*yield*/, glob(filesGlob, { ignore: ignore })];
                     case 4:
-                        filenames = _f.sent();
-                        _f.label = 5;
+                        filenames = _g.sent();
+                        _g.label = 5;
                     case 5:
-                        _f.trys.push([5, 17, 18, 19]);
+                        _g.trys.push([5, 17, 18, 19]);
                         filenames_1 = __values(filenames), filenames_1_1 = filenames_1.next();
-                        _f.label = 6;
+                        _g.label = 6;
                     case 6:
                         if (!!filenames_1_1.done) return [3 /*break*/, 16];
                         filename = filenames_1_1.value;
-                        _f.label = 7;
+                        _g.label = 7;
                     case 7:
-                        _f.trys.push([7, 14, , 15]);
+                        _g.trys.push([7, 14, , 15]);
                         pipeline = void 0;
                         if (!filename.endsWith('.book.md')) return [3 /*break*/, 10];
+                        _b = validatePipelineString;
                         return [4 /*yield*/, readFile(filename, 'utf-8')];
                     case 8:
-                        pipelineMarkdown = (_f.sent());
+                        pipelineMarkdown = _b.apply(void 0, [_g.sent()]);
                         return [4 /*yield*/, compilePipeline(pipelineMarkdown, tools)];
                     case 9:
-                        pipeline = _f.sent();
+                        pipeline = _g.sent();
                         if (isVerbose) {
                             console.info(colors.green("Parsed ".concat(filename)));
                         }
-                        _f.label = 10;
+                        _g.label = 10;
                     case 10:
                         if (!filename.endsWith('.book.json')) return [3 /*break*/, 12];
-                        _c = (_b = JSON).parse;
+                        _d = (_c = JSON).parse;
                         return [4 /*yield*/, readFile(filename, 'utf-8')];
                     case 11:
-                        pipeline = _c.apply(_b, [_f.sent()]);
+                        pipeline = _d.apply(_c, [_g.sent()]);
                         return [3 /*break*/, 13];
                     case 12:
                         if (isVerbose) {
@@ -13040,7 +13112,7 @@ function initializeTestCommand(program) {
                         console.info(colors.green("Validated ".concat(filename)));
                         return [3 /*break*/, 15];
                     case 14:
-                        error_1 = _f.sent();
+                        error_1 = _g.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
@@ -13053,12 +13125,12 @@ function initializeTestCommand(program) {
                         return [3 /*break*/, 6];
                     case 16: return [3 /*break*/, 19];
                     case 17:
-                        e_1_1 = _f.sent();
+                        e_1_1 = _g.sent();
                         e_1 = { error: e_1_1 };
                         return [3 /*break*/, 19];
                     case 18:
                         try {
-                            if (filenames_1_1 && !filenames_1_1.done && (_e = filenames_1.return)) _e.call(filenames_1);
+                            if (filenames_1_1 && !filenames_1_1.done && (_f = filenames_1.return)) _f.call(filenames_1);
                         }
                         finally { if (e_1) throw e_1.error; }
                         return [7 /*endfinally*/];
@@ -13465,12 +13537,12 @@ var ANTHROPIC_CLAUDE_MODELS = exportJson({
                 output: computeUsage("$2.40 / 1M tokens"),
             },
         },
-        // TODO: [main] !!! Claude 1 and 2 has also completion versions - ask Hoagy
+        // TODO: [main] !!3 Claude 1 and 2 has also completion versions - ask Hoagy
     ],
 });
 /**
  * Note: [🤖] Add models of new variant
- * TODO: [🧠][main] !!! Add embedding models OR Anthropic has only chat+completion models?
+ * TODO: [🧠][main] !!3 Add embedding models OR Anthropic has only chat+completion models?
  * TODO: [🧠] Some mechanism to propagate unsureness
  * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
  * TODO: [🎰] Some mechanism to auto-update available models
@@ -13845,8 +13917,8 @@ var createAnthropicClaudeExecutionTools = Object.assign(function (options) {
     className: 'AnthropicClaudeExecutionTools',
 });
 /**
- * TODO: [🧠][main] !!!! Make anonymous this with all LLM providers
- * TODO: [🧠][🧱][main] !!!! Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
+ * TODO: [🧠][main] !!4 Make anonymous this with all LLM providers
+ * TODO: [🧠][🧱][main] !!4 Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
  * TODO: [🧠] Maybe auto-detect usage in browser and determine default value of `isProxied`
  * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
@@ -14251,7 +14323,7 @@ var OPENAI_MODELS = exportJson({
                 prompt: computeUsage("$5.00 / 1M tokens"),
                 output: computeUsage("$15.00 / 1M tokens"),
             },
-            //TODO: [main] !!! Add gpt-4o-mini-2024-07-18 and all others to be up to date
+            //TODO: [main] !!3 Add gpt-4o-mini-2024-07-18 and all others to be up to date
         },
         /**/
         /**/
@@ -14401,7 +14473,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
     AzureOpenAiExecutionTools.prototype.listModels = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                // TODO: [main] !!! Do here some filtering which models are really available as deployment
+                // TODO: [main] !!3 Do here some filtering which models are really available as deployment
                 //       @see https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments?api-version=2023-05-01
                 return [2 /*return*/, OPENAI_MODELS.map(function (_a) {
                         var modelTitle = _a.modelTitle, modelName = _a.modelName, modelVariant = _a.modelVariant;
@@ -15555,7 +15627,7 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                             assistant_id: this.assistantId,
                             thread: {
                                 messages: [
-                                    // TODO:  [🗯] !! Allow threads to be passed
+                                    // TODO:  [🗯] Allow threads to be passed
                                     { role: 'user', content: rawPromptContent },
                                 ],
                             },
@@ -15658,7 +15730,7 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
  * @public exported from `@promptbook/openai`
  */
 var createOpenAiAssistantExecutionTools = Object.assign(function (options) {
-    // TODO: [🧠][main] !!!! If browser, auto add `dangerouslyAllowBrowser`
+    // TODO: [🧠][main] !!4 If browser, auto add `dangerouslyAllowBrowser`
     if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
         options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
     }
@@ -15678,7 +15750,7 @@ var createOpenAiAssistantExecutionTools = Object.assign(function (options) {
  * @public exported from `@promptbook/openai`
  */
 var createOpenAiExecutionTools = Object.assign(function (options) {
-    // TODO: [🧠][main] !!!! If browser, auto add `dangerouslyAllowBrowser`
+    // TODO: [🧠][main] !!4 If browser, auto add `dangerouslyAllowBrowser`
     if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
         options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
     }
@@ -16057,12 +16129,12 @@ var MarkdownScraper = /** @class */ (function () {
                         outputParameters = result.outputParameters;
                         knowledgePiecesRaw = outputParameters.knowledgePieces;
                         knowledgeTextPieces = (knowledgePiecesRaw || '').split('\n---\n');
-                        //                                                               <- TODO: [main] !! Smarter split and filter out empty pieces
+                        //                                                               <- TODO: [main] Smarter split and filter out empty pieces
                         if (isVerbose) {
                             console.info('knowledgeTextPieces:', knowledgeTextPieces);
                         }
                         return [4 /*yield*/, Promise.all(
-                            // TODO: [🪂] !! Do not send all at once but in chunks
+                            // TODO: [🪂] Do not send all at once but in chunks
                             knowledgeTextPieces.map(function (knowledgeTextPiece, i) { return __awaiter(_this, void 0, void 0, function () {
                                 var name, title, knowledgePieceContent, keywords, index, titleResult, _a, titleRaw, keywordsResult, _b, keywordsRaw, embeddingResult, error_1;
                                 return __generator(this, function (_c) {