@promptbook/node 0.86.6 → 0.86.10

package/esm/index.es.js

@@ -2,6 +2,7 @@ import colors from 'colors';
 import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink } from 'fs/promises';
 import { basename, join, dirname, relative } from 'path';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import JSZip from 'jszip';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
 import { BehaviorSubject } from 'rxjs';
@@ -29,7 +30,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.86.6';
+var PROMPTBOOK_ENGINE_VERSION = '0.86.10';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -337,1119 +338,1174 @@ true);
  * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
  */
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",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`\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"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",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`\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"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",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-   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`\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-   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"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",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`\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"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",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 workflow:\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-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",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`\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 workflow:\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-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
-
 /**
- * Checks if value is valid email
+ * Make error report URL for the given error
  *
- * @public exported from `@promptbook/utils`
+ * @private private within the repository
  */
-function isValidEmail(email) {
-    if (typeof email !== 'string') {
-        return false;
-    }
-    if (email.split('\n').length > 1) {
-        return false;
-    }
-    return /^.+@.+\..+$/.test(email);
+function getErrorReportUrl(error) {
+    var report = {
+        title: "\uD83D\uDC1C Error report from ".concat(NAME),
+        body: spaceTrim(function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
+    };
+    var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
+    reportUrl.searchParams.set('labels', 'bug');
+    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
+    reportUrl.searchParams.set('title', report.title);
+    reportUrl.searchParams.set('body', report.body);
+    return reportUrl;
 }
 
 /**
- * Tests if given string is valid URL.
+ * This error type indicates that the error should not happen and its last check before crashing with some other error
  *
- * Note: This does not check if the file exists only if the path is valid
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
  */
-function isValidFilePath(filename) {
-    if (typeof filename !== 'string') {
-        return false;
-    }
-    if (filename.split('\n').length > 1) {
-        return false;
-    }
-    if (filename.split(' ').length >
-        5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
-        return false;
-    }
-    var filenameSlashes = filename.split('\\').join('/');
-    // Absolute Unix path: /hello.txt
-    if (/^(\/)/i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Unix path: /hello.txt');
-        return true;
-    }
-    // Absolute Windows path: /hello.txt
-    if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Windows path: /hello.txt');
-        return true;
-    }
-    // Relative path: ./hello.txt
-    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Relative path: ./hello.txt');
-        return true;
-    }
-    // Allow paths like foo/hello
-    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like foo/hello');
-        return true;
-    }
-    // Allow paths like hello.book
-    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like hello.book');
-        return true;
+var UnexpectedError = /** @class */ (function (_super) {
+    __extends(UnexpectedError, _super);
+    function UnexpectedError(message) {
+        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
+        _this.name = 'UnexpectedError';
+        Object.setPrototypeOf(_this, UnexpectedError.prototype);
+        return _this;
     }
-    return false;
-}
+    return UnexpectedError;
+}(Error));
+
 /**
- * TODO: [🍏] Implement for MacOs
+ * Orders JSON object by keys
+ *
+ * @returns The same type of object as the input re-ordered
+ * @public exported from `@promptbook/utils`
  */
+function orderJson(options) {
+    var value = options.value, order = options.order;
+    var orderedValue = __assign(__assign({}, (order === undefined ? {} : Object.fromEntries(order.map(function (key) { return [key, undefined]; })))), value);
+    return orderedValue;
+}
 
 /**
- * Tests if given string is valid URL.
+ * Freezes the given object and all its nested objects recursively
  *
- * Note: Dataurl are considered perfectly valid.
- * Note: There are two simmilar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
  *
+ * @returns The same object as the input, but deeply frozen
  * @public exported from `@promptbook/utils`
  */
-function isValidUrl(url) {
-    if (typeof url !== 'string') {
-        return false;
+function $deepFreeze(objectValue) {
+    var e_1, _a;
+    if (Array.isArray(objectValue)) {
+        return Object.freeze(objectValue.map(function (item) { return $deepFreeze(item); }));
     }
+    var propertyNames = Object.getOwnPropertyNames(objectValue);
     try {
-        if (url.startsWith('blob:')) {
-            url = url.replace(/^blob:/, '');
-        }
-        var urlObject = new URL(url /* because fail is handled */);
-        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-            return false;
+        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
+            var propertyName = propertyNames_1_1.value;
+            var value = objectValue[propertyName];
+            if (value && typeof value === 'object') {
+                $deepFreeze(value);
+            }
         }
-        return true;
     }
-    catch (error) {
-        return false;
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+        }
+        finally { if (e_1) throw e_1.error; }
     }
+    Object.freeze(objectValue);
+    return objectValue;
 }
-
-/**
- * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
- *
- * @public exported from `@promptbook/core`
- */
-var ParseError = /** @class */ (function (_super) {
-    __extends(ParseError, _super);
-    function ParseError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'ParseError';
-        Object.setPrototypeOf(_this, ParseError.prototype);
-        return _this;
-    }
-    return ParseError;
-}(Error));
 /**
- * TODO: Maybe split `ParseError` and `ApplyError`
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
  */
 
 /**
- * Function isValidJsonString will tell you if the string is valid JSON or not
+ * Checks if the value is [🚉] serializable as JSON
+ * If not, throws an UnexpectedError with a rich error message and tracking
+ *
+ * - Almost all primitives are serializable BUT:
+ * - `undefined` is not serializable
+ * - `NaN` is not serializable
+ * - Objects and arrays are serializable if all their properties are serializable
+ * - Functions are not serializable
+ * - Circular references are not serializable
+ * - `Date` objects are not serializable
+ * - `Map` and `Set` objects are not serializable
+ * - `RegExp` objects are not serializable
+ * - `Error` objects are not serializable
+ * - `Symbol` objects are not serializable
+ * - And much more...
  *
+ * @throws UnexpectedError if the value is not serializable as JSON
  * @public exported from `@promptbook/utils`
  */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
+function checkSerializableAsJson(options) {
+    var e_1, _a;
+    var value = options.value, name = options.name, message = options.message;
+    if (value === undefined) {
+        throw new UnexpectedError("".concat(name, " is undefined"));
     }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
+    else if (value === null) {
+        return;
     }
-}
-
-/**
- * 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`
- */
-function validatePipelineString(pipelineString) {
-    if (isValidJsonString(pipelineString)) {
-        throw new ParseError('Expected a book, but got a JSON string');
+    else if (typeof value === 'boolean') {
+        return;
     }
-    else if (isValidUrl(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the URL \"".concat(pipelineString, "\""));
+    else if (typeof value === 'number' && !isNaN(value)) {
+        return;
     }
-    else if (isValidFilePath(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the file path \"".concat(pipelineString, "\""));
+    else if (typeof value === 'string') {
+        return;
     }
-    else if (isValidEmail(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the email \"".concat(pipelineString, "\""));
+    else if (typeof value === 'symbol') {
+        throw new UnexpectedError("".concat(name, " is symbol"));
     }
-    // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
-    return pipelineString;
-}
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- */
-
-/**
- * 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,
-        });
+    else if (typeof value === 'function') {
+        throw new UnexpectedError("".concat(name, " is function"));
     }
-    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;
+    else if (typeof value === 'object' && Array.isArray(value)) {
+        for (var i = 0; i < value.length; i++) {
+            checkSerializableAsJson({ name: "".concat(name, "[").concat(i, "]"), value: value[i], message: message });
+        }
     }
-}
-
-/**
- * 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 (.bookc)
- * @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;
-    var title = pipelineJson.title, pipelineUrl = pipelineJson.pipelineUrl, bookVersion = pipelineJson.bookVersion, description = pipelineJson.description, parameters = pipelineJson.parameters, tasks = pipelineJson.tasks;
-    var pipelineString = "# ".concat(title);
-    if (description) {
-        pipelineString += '\n\n';
-        pipelineString += description;
-    }
-    var commands = [];
-    if (pipelineUrl) {
-        commands.push("PIPELINE URL ".concat(pipelineUrl));
-    }
-    if (bookVersion !== "undefined") {
-        commands.push("BOOK VERSION ".concat(bookVersion));
-    }
-    // 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) {
-            var isInput = _a.isInput;
-            return isInput;
-        })), _h = _g.next(); !_h.done; _h = _g.next()) {
-            var parameter = _h.value;
-            commands.push("INPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
+    else if (typeof value === 'object') {
+        if (value instanceof Date) {
+            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        `".concat(name, "` is Date\n\n                        Use `string_date_iso8601` instead\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n                    "); }));
         }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
+        else if (value instanceof Map) {
+            throw new UnexpectedError("".concat(name, " is Map"));
         }
-        finally { if (e_1) throw e_1.error; }
-    }
-    try {
-        for (var _j = __values(parameters.filter(function (_a) {
-            var isOutput = _a.isOutput;
-            return isOutput;
-        })), _k = _j.next(); !_k.done; _k = _j.next()) {
-            var parameter = _k.value;
-            commands.push("OUTPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
+        else if (value instanceof Set) {
+            throw new UnexpectedError("".concat(name, " is Set"));
         }
-    }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
-    finally {
-        try {
-            if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
+        else if (value instanceof RegExp) {
+            throw new UnexpectedError("".concat(name, " is RegExp"));
         }
-        finally { if (e_2) throw e_2.error; }
-    }
-    pipelineString += '\n\n';
-    pipelineString += commands.map(function (command) { return "- ".concat(command); }).join('\n');
-    try {
-        for (var tasks_1 = __values(tasks), tasks_1_1 = tasks_1.next(); !tasks_1_1.done; tasks_1_1 = tasks_1.next()) {
-            var task = tasks_1_1.value;
-            var 
-            /* Note: Not using:> name, */
-            title_1 = task.title, description_1 = task.description, 
-            /* Note: dependentParameterNames, */
-            jokers = task.jokerParameterNames, taskType = task.taskType, content = task.content, postprocessing = task.postprocessingFunctionNames, expectations = task.expectations, format = task.format, resultingParameterName = task.resultingParameterName;
-            pipelineString += '\n\n';
-            pipelineString += "## ".concat(title_1);
-            if (description_1) {
-                pipelineString += '\n\n';
-                pipelineString += description_1;
-            }
-            var commands_1 = [];
-            var contentLanguage = 'text';
-            if (taskType === 'PROMPT_TASK') {
-                var modelRequirements = task.modelRequirements;
-                var _l = modelRequirements || {}, modelName = _l.modelName, modelVariant = _l.modelVariant;
-                // Note: Do nothing, it is default
-                // commands.push(`PROMPT`);
-                if (modelVariant) {
-                    commands_1.push("MODEL VARIANT ".concat(capitalize(modelVariant)));
+        else if (value instanceof Error) {
+            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        `".concat(name, "` is unserialized Error\n\n                        Use function `serializeError`\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n\n                    "); }));
+        }
+        else {
+            try {
+                for (var _b = __values(Object.entries(value)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                    var _d = __read(_c.value, 2), subName = _d[0], subValue = _d[1];
+                    if (subValue === undefined) {
+                        // Note: undefined in object is serializable - it is just omited
+                        continue;
+                    }
+                    checkSerializableAsJson({ name: "".concat(name, ".").concat(subName), value: subValue, message: message });
                 }
-                if (modelName) {
-                    commands_1.push("MODEL NAME `".concat(modelName, "`"));
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
                 }
+                finally { if (e_1) throw e_1.error; }
             }
-            else if (taskType === 'SIMPLE_TASK') {
-                commands_1.push("SIMPLE TEMPLATE");
-                // Note: Nothing special here
+            try {
+                JSON.stringify(value); // <- TODO: [0]
             }
-            else if (taskType === 'SCRIPT_TASK') {
-                commands_1.push("SCRIPT");
-                if (task.contentLanguage) {
-                    contentLanguage = task.contentLanguage;
-                }
-                else {
-                    contentLanguage = '';
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
                 }
+                throw new UnexpectedError(spaceTrim(function (block) { return "\n                            `".concat(name, "` is not serializable\n\n                            ").concat(block(error.stack || error.message), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
             }
-            else if (taskType === 'DIALOG_TASK') {
-                commands_1.push("DIALOG");
-                // Note: Nothing special here
-            } // <- }else if([🅱]
-            if (jokers) {
-                try {
-                    for (var jokers_1 = (e_4 = void 0, __values(jokers)), jokers_1_1 = jokers_1.next(); !jokers_1_1.done; jokers_1_1 = jokers_1.next()) {
-                        var joker = jokers_1_1.value;
-                        commands_1.push("JOKER {".concat(joker, "}"));
-                    }
-                }
-                catch (e_4_1) { e_4 = { error: e_4_1 }; }
-                finally {
-                    try {
-                        if (jokers_1_1 && !jokers_1_1.done && (_d = jokers_1.return)) _d.call(jokers_1);
-                    }
-                    finally { if (e_4) throw e_4.error; }
-                }
-            } /* not else */
-            if (postprocessing) {
-                try {
-                    for (var postprocessing_1 = (e_5 = void 0, __values(postprocessing)), postprocessing_1_1 = postprocessing_1.next(); !postprocessing_1_1.done; postprocessing_1_1 = postprocessing_1.next()) {
-                        var postprocessingFunctionName = postprocessing_1_1.value;
-                        commands_1.push("POSTPROCESSING `".concat(postprocessingFunctionName, "`"));
-                    }
-                }
-                catch (e_5_1) { e_5 = { error: e_5_1 }; }
-                finally {
-                    try {
-                        if (postprocessing_1_1 && !postprocessing_1_1.done && (_e = postprocessing_1.return)) _e.call(postprocessing_1);
-                    }
-                    finally { if (e_5) throw e_5.error; }
-                }
-            } /* not else */
-            if (expectations) {
-                try {
-                    for (var _m = (e_6 = void 0, __values(Object.entries(expectations))), _o = _m.next(); !_o.done; _o = _m.next()) {
-                        var _p = __read(_o.value, 2), unit = _p[0], _q = _p[1], min = _q.min, max = _q.max;
-                        if (min === max) {
-                            commands_1.push("EXPECT EXACTLY ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
-                        }
-                        else {
-                            if (min !== undefined) {
-                                commands_1.push("EXPECT MIN ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
-                            } /* not else */
-                            if (max !== undefined) {
-                                commands_1.push("EXPECT MAX ".concat(max, " ").concat(capitalize(unit + (max > 1 ? 's' : ''))));
-                            }
-                        }
+            /*
+            TODO: [0] Is there some more elegant way to check circular references?
+            const seen = new Set();
+            const stack = [{ value }];
+            while (stack.length > 0) {
+                const { value } = stack.pop()!;
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value)) {
+                        throw new UnexpectedError(`${name} has circular reference`);
                     }
-                }
-                catch (e_6_1) { e_6 = { error: e_6_1 }; }
-                finally {
-                    try {
-                        if (_o && !_o.done && (_f = _m.return)) _f.call(_m);
+                    seen.add(value);
+                    if (Array.isArray(value)) {
+                        stack.push(...value.map((value) => ({ value })));
+                    } else {
+                        stack.push(...Object.values(value).map((value) => ({ value })));
                     }
-                    finally { if (e_6) throw e_6.error; }
                 }
-            } /* not else */
-            if (format) {
-                if (format === 'JSON') {
-                    // TODO: @deprecated remove
-                    commands_1.push("FORMAT JSON");
-                }
-            } /* not else */
-            pipelineString += '\n\n';
-            pipelineString += commands_1.map(function (command) { return "- ".concat(command); }).join('\n');
-            pipelineString += '\n\n';
-            pipelineString += '```' + contentLanguage;
-            pipelineString += '\n';
-            pipelineString += spaceTrim(content);
-            //                   <- TODO: [main] !!3 Escape
-            //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
-            pipelineString += '\n';
-            pipelineString += '```';
-            pipelineString += '\n\n';
-            pipelineString += "`-> {".concat(resultingParameterName, "}`"); // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+            }
+            */
+            return;
         }
     }
-    catch (e_3_1) { e_3 = { error: e_3_1 }; }
-    finally {
-        try {
-            if (tasks_1_1 && !tasks_1_1.done && (_c = tasks_1.return)) _c.call(tasks_1);
-        }
-        finally { if (e_3) throw e_3.error; }
+    else {
+        throw new UnexpectedError(spaceTrim(function (block) { return "\n                    `".concat(name, "` is unknown type\n\n                    Additional message for `").concat(name, "`:\n                    ").concat(block(message || '(nothing)'), "\n                "); }));
+    }
+}
+/**
+ * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
+ * 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
+ */
+
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function deepClone(objectValue) {
+    return JSON.parse(JSON.stringify(objectValue));
+    /*
+    TODO: [🧠] Is there a better implementation?
+    > const propertyNames = Object.getOwnPropertyNames(objectValue);
+    > for (const propertyName of propertyNames) {
+    >     const value = (objectValue as really_any)[propertyName];
+    >     if (value && typeof value === 'object') {
+    >         deepClone(value);
+    >     }
+    > }
+    > return Object.assign({}, objectValue);
+    */
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * Utility to export a JSON object from a function
+ *
+ * 1) Checks if the value is serializable as JSON
+ * 2) Makes a deep clone of the object
+ * 2) Orders the object properties
+ * 2) Deeply freezes the cloned object
+ *
+ * Note: This function does not mutates the given object
+ *
+ * @returns The same type of object as the input but read-only and re-ordered
+ * @public exported from `@promptbook/utils`
+ */
+function exportJson(options) {
+    var name = options.name, value = options.value, order = options.order, message = options.message;
+    checkSerializableAsJson({ name: name, value: value, message: message });
+    var orderedValue = 
+    // TODO: Fix error "Type instantiation is excessively deep and possibly infinite."
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    order === undefined
+        ? deepClone(value)
+        : orderJson({
+            value: value,
+            // <- Note: checkSerializableAsJson asserts that the value is serializable as JSON
+            order: order,
+        });
+    $deepFreeze(orderedValue);
+    return orderedValue;
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * Order of keys in the pipeline JSON
+ *
+ * @public exported from `@promptbook/core`
+ */
+var ORDER_OF_PIPELINE_JSON = [
+    // Note: [🍙] In this order will be pipeline serialized
+    'title',
+    'pipelineUrl',
+    'bookVersion',
+    'description',
+    'formfactorName',
+    'parameters',
+    'tasks',
+    'personas',
+    'preparations',
+    'knowledgeSources',
+    'knowledgePieces',
+    'sources', // <- TODO: [🧠] Where should the `sources` be
+];
+/**
+ * Nonce which is used for replacing things in strings
+ *
+ * @private within the repository
+ */
+var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
+/**
+ * The names of the parameters that are reserved for special purposes
+ *
+ * @public exported from `@promptbook/core`
+ */
+var RESERVED_PARAMETER_NAMES = exportJson({
+    name: 'RESERVED_PARAMETER_NAMES',
+    message: "The names of the parameters that are reserved for special purposes",
+    value: [
+        'content',
+        'context',
+        'knowledge',
+        'examples',
+        'modelName',
+        'currentDate',
+        // <- TODO: list here all command names
+        // <- TODO: Add more like 'date', 'modelName',...
+        // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
+    ],
+});
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
+ */
+var ParseError = /** @class */ (function (_super) {
+    __extends(ParseError, _super);
+    function ParseError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'ParseError';
+        Object.setPrototypeOf(_this, ParseError.prototype);
+        return _this;
     }
-    return validatePipelineString(pipelineString);
-}
+    return ParseError;
+}(Error));
 /**
- * @private internal utility of `pipelineJsonToString`
+ * TODO: Maybe split `ParseError` and `ApplyError`
  */
-function taskParameterJsonToString(taskParameterJson) {
-    var name = taskParameterJson.name, description = taskParameterJson.description;
-    var parameterString = "{".concat(name, "}");
-    if (description) {
-        parameterString = "".concat(parameterString, " ").concat(description);
+
+/**
+ * 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 parameterString;
-}
+    return PipelineLogicError;
+}(Error));
+
 /**
- * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
- * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
- * TODO: [🏛] Maybe make some markdown builder
- * TODO: [🏛] Escape all
- * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
+ * Tests if given string is valid semantic version
+ *
+ * Note: There are two simmilar functions:
+ * - `isValidSemanticVersion` which tests any semantic version
+ * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+ *
+ * @public exported from `@promptbook/utils`
  */
+function isValidSemanticVersion(version) {
+    if (typeof version !== 'string') {
+        return false;
+    }
+    if (version.startsWith('0.0.0')) {
+        return false;
+    }
+    return /^\d+\.\d+\.\d+(-\d+)?$/i.test(version);
+}
 
 /**
- * Orders JSON object by keys
+ * Tests if given string is valid promptbook version
+ * It looks into list of known promptbook versions.
+ *
+ * @see https://www.npmjs.com/package/promptbook?activeTab=versions
+ * Note: When you are using for example promptbook 2.0.0 and there already is promptbook 3.0.0 it don`t know about it.
+ * Note: There are two simmilar functions:
+ * - `isValidSemanticVersion` which tests any semantic version
+ * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
  *
- * @returns The same type of object as the input re-ordered
  * @public exported from `@promptbook/utils`
  */
-function orderJson(options) {
-    var value = options.value, order = options.order;
-    var orderedValue = __assign(__assign({}, (order === undefined ? {} : Object.fromEntries(order.map(function (key) { return [key, undefined]; })))), value);
-    return orderedValue;
+function isValidPromptbookVersion(version) {
+    if (!isValidSemanticVersion(version)) {
+        return false;
+    }
+    if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
+        return false;
+    }
+    // <- TODO: [main] !!3 Check isValidPromptbookVersion against PROMPTBOOK_ENGINE_VERSIONS
+    return true;
 }
 
 /**
- * Freezes the given object and all its nested objects recursively
+ * Tests if given string is valid URL.
  *
- * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
- * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ * Note: Dataurl are considered perfectly valid.
+ * Note: There are two simmilar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
  *
- * @returns The same object as the input, but deeply frozen
  * @public exported from `@promptbook/utils`
  */
-function $deepFreeze(objectValue) {
-    var e_1, _a;
-    if (Array.isArray(objectValue)) {
-        return Object.freeze(objectValue.map(function (item) { return $deepFreeze(item); }));
+function isValidUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
     }
-    var propertyNames = Object.getOwnPropertyNames(objectValue);
     try {
-        for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
-            var propertyName = propertyNames_1_1.value;
-            var value = objectValue[propertyName];
-            if (value && typeof value === 'object') {
-                $deepFreeze(value);
-            }
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
         }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+        var urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
         }
-        finally { if (e_1) throw e_1.error; }
+        return true;
+    }
+    catch (error) {
+        return false;
     }
-    Object.freeze(objectValue);
-    return objectValue;
 }
-/**
- * TODO: [🧠] Is there a way how to meaningfully test this utility
- */
 
 /**
- * Make error report URL for the given error
+ * Tests if given string is valid pipeline URL URL.
  *
- * @private private within the repository
+ * Note: There are two simmilar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
+ *
+ * @public exported from `@promptbook/utils`
  */
-function getErrorReportUrl(error) {
-    var report = {
-        title: "\uD83D\uDC1C Error report from ".concat(NAME),
-        body: spaceTrim(function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
-    };
-    var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
-    reportUrl.searchParams.set('labels', 'bug');
-    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
-    reportUrl.searchParams.set('title', report.title);
-    reportUrl.searchParams.set('body', report.body);
-    return reportUrl;
+function isValidPipelineUrl(url) {
+    if (!isValidUrl(url)) {
+        return false;
+    }
+    if (!url.startsWith('https://') && !url.startsWith('http://') /* <- Note: [👣] */) {
+        return false;
+    }
+    if (url.includes('#')) {
+        // TODO: [🐠]
+        return false;
+    }
+    /*
+    Note: [👣][🧠] Is it secure to allow pipeline URLs on private and unsecured networks?
+    if (isUrlOnPrivateNetwork(url)) {
+        return false;
+    }
+    */
+    return true;
 }
-
 /**
- * This error type indicates that the error should not happen and its last check before crashing with some other error
- *
- * @public exported from `@promptbook/core`
+ * TODO: [🐠] Maybe more info why the URL is invalid
  */
-var UnexpectedError = /** @class */ (function (_super) {
-    __extends(UnexpectedError, _super);
-    function UnexpectedError(message) {
-        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
-        _this.name = 'UnexpectedError';
-        Object.setPrototypeOf(_this, UnexpectedError.prototype);
-        return _this;
-    }
-    return UnexpectedError;
-}(Error));
 
 /**
- * Checks if the value is [🚉] serializable as JSON
- * If not, throws an UnexpectedError with a rich error message and tracking
+ * Validates PipelineJson if it is logically valid
  *
- * - Almost all primitives are serializable BUT:
- * - `undefined` is not serializable
- * - `NaN` is not serializable
- * - Objects and arrays are serializable if all their properties are serializable
- * - Functions are not serializable
- * - Circular references are not serializable
- * - `Date` objects are not serializable
- * - `Map` and `Set` objects are not serializable
- * - `RegExp` objects are not serializable
- * - `Error` objects are not serializable
- * - `Symbol` objects are not serializable
- * - And much more...
+ * It checks:
+ * -   if it has correct parameters dependency
  *
- * @throws UnexpectedError if the value is not serializable as JSON
- * @public exported from `@promptbook/utils`
+ * It does NOT check:
+ * -   if it is valid json
+ * -   if it is meaningful
+ *
+ * @param pipeline valid or invalid PipelineJson
+ * @returns the same pipeline if it is logically valid
+ * @throws {PipelineLogicError} on logical error in the pipeline
+ * @public exported from `@promptbook/core`
  */
-function checkSerializableAsJson(options) {
-    var e_1, _a;
-    var value = options.value, name = options.name, message = options.message;
-    if (value === undefined) {
-        throw new UnexpectedError("".concat(name, " is undefined"));
-    }
-    else if (value === null) {
-        return;
+function validatePipeline(pipeline) {
+    if (IS_PIPELINE_LOGIC_VALIDATED) {
+        validatePipeline_InnerFunction(pipeline);
     }
-    else if (typeof value === 'boolean') {
-        return;
+    else {
+        try {
+            validatePipeline_InnerFunction(pipeline);
+        }
+        catch (error) {
+            if (!(error instanceof PipelineLogicError)) {
+                throw error;
+            }
+            console.error(spaceTrim$1(function (block) { return "\n                        Pipeline is not valid but logic errors are temporarily disabled via `IS_PIPELINE_LOGIC_VALIDATED`\n\n                        ".concat(block(error.message), "\n                    "); }));
+        }
     }
-    else if (typeof value === 'number' && !isNaN(value)) {
-        return;
+    return pipeline;
+}
+/**
+ * @private internal function for `validatePipeline`
+ */
+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 () {
+        // Note: This is a 😐 implementation of [🚞]
+        var _ = [];
+        if (pipeline.sourceFile !== undefined) {
+            _.push("File: ".concat(pipeline.sourceFile));
+        }
+        if (pipeline.pipelineUrl !== undefined) {
+            _.push("Url: ".concat(pipeline.pipelineUrl));
+        }
+        return _.join('\n');
+    })();
+    if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
+        // <- Note: [🚲]
+        throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                    Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
-    else if (typeof value === 'string') {
-        return;
+    if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
+        // <- Note: [🚲]
+        throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                    Invalid Promptbook Version \"".concat(pipeline.bookVersion, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
-    else if (typeof value === 'symbol') {
-        throw new UnexpectedError("".concat(name, " is symbol"));
+    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+    if (!Array.isArray(pipeline.parameters)) {
+        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
-    else if (typeof value === 'function') {
-        throw new UnexpectedError("".concat(name, " is function"));
+    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+    if (!Array.isArray(pipeline.tasks)) {
+        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.tasks` expected to be an array, but got ".concat(typeof pipeline.tasks, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
-    else if (typeof value === 'object' && Array.isArray(value)) {
-        for (var i = 0; i < value.length; i++) {
-            checkSerializableAsJson({ name: "".concat(name, "[").concat(i, "]"), value: value[i], message: message });
+    var _loop_1 = function (parameter) {
+        if (parameter.isInput && parameter.isOutput) {
+            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n\n                        Parameter `{".concat(parameter.name, "}` can not be both input and output\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
         }
-    }
-    else if (typeof value === 'object') {
-        if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        `".concat(name, "` is Date\n\n                        Use `string_date_iso8601` instead\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n                    "); }));
+        // Note: Testing that parameter is either intermediate or output BUT not created and unused
+        if (!parameter.isInput &&
+            !parameter.isOutput &&
+            !pipeline.tasks.some(function (task) { return task.dependentParameterNames.includes(parameter.name); })) {
+            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is created but not used\n\n                        You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                        - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
         }
-        else if (value instanceof Map) {
-            throw new UnexpectedError("".concat(name, " is Map"));
+        // Note: Testing that parameter is either input or result of some task
+        if (!parameter.isInput && !pipeline.tasks.some(function (task) { return task.resultingParameterName === parameter.name; })) {
+            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is declared but not defined\n\n                        You can do one of these:\n                        1) Remove declaration of `{").concat(parameter.name, "}`\n                        2) Add task that results in `-> {").concat(parameter.name, "}`\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
         }
-        else if (value instanceof Set) {
-            throw new UnexpectedError("".concat(name, " is Set"));
+    };
+    try {
+        /*
+        TODO: [🧠][🅾] Should be empty pipeline valid or not
+        // Note: Check that pipeline has some tasks
+        if (pipeline.tasks.length === 0) {
+            throw new PipelineLogicError(
+                spaceTrim(
+                    (block) => `
+                      Pipeline must have at least one task
+    
+                      ${block(pipelineIdentification)}
+                  `,
+                ),
+            );
         }
-        else if (value instanceof RegExp) {
-            throw new UnexpectedError("".concat(name, " is RegExp"));
+        */
+        // Note: Check each parameter individually
+        for (var _d = __values(pipeline.parameters), _e = _d.next(); !_e.done; _e = _d.next()) {
+            var parameter = _e.value;
+            _loop_1(parameter);
         }
-        else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        `".concat(name, "` is unserialized Error\n\n                        Use function `serializeError`\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n\n                    "); }));
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
         }
-        else {
+        finally { if (e_1) throw e_1.error; }
+    }
+    // Note: All input parameters are defined - so that they can be used as result of some task
+    var definedParameters = new Set(pipeline.parameters.filter(function (_a) {
+        var isInput = _a.isInput;
+        return isInput;
+    }).map(function (_a) {
+        var name = _a.name;
+        return name;
+    }));
+    var _loop_2 = function (task) {
+        var e_4, _h, e_5, _j;
+        if (definedParameters.has(task.resultingParameterName)) {
+            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(task.resultingParameterName, "}` is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+        }
+        if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
+            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter name {".concat(task.resultingParameterName, "} is reserved, please use different name\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+        }
+        definedParameters.add(task.resultingParameterName);
+        if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
+            if (!task.format &&
+                !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
+                throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                            Joker parameters are used for {".concat(task.resultingParameterName, "} but no expectations are defined\n\n                            ").concat(block(pipelineIdentification), "\n                        "); }));
+            }
+            var _loop_4 = function (joker) {
+                if (!task.dependentParameterNames.includes(joker)) {
+                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Parameter `{".concat(joker, "}` is used for {").concat(task.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                }
+            };
             try {
-                for (var _b = __values(Object.entries(value)), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var _d = __read(_c.value, 2), subName = _d[0], subValue = _d[1];
-                    if (subValue === undefined) {
-                        // Note: undefined in object is serializable - it is just omited
-                        continue;
-                    }
-                    checkSerializableAsJson({ name: "".concat(name, ".").concat(subName), value: subValue, message: message });
+                for (var _k = (e_4 = void 0, __values(task.jokerParameterNames)), _l = _k.next(); !_l.done; _l = _k.next()) {
+                    var joker = _l.value;
+                    _loop_4(joker);
                 }
             }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
             finally {
                 try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                    if (_l && !_l.done && (_h = _k.return)) _h.call(_k);
                 }
-                finally { if (e_1) throw e_1.error; }
+                finally { if (e_4) throw e_4.error; }
             }
+        }
+        if (task.expectations) {
+            var _loop_5 = function (unit, min, max) {
+                if (min !== undefined && max !== undefined && min > max) {
+                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Min expectation (=".concat(min, ") of ").concat(unit, " is higher than max expectation (=").concat(max, ")\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                }
+                if (min !== undefined && min < 0) {
+                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Min expectation of ".concat(unit, " must be zero or positive\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                }
+                if (max !== undefined && max <= 0) {
+                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Max expectation of ".concat(unit, " must be positive\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                }
+            };
             try {
-                JSON.stringify(value); // <- TODO: [0]
-            }
-            catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
+                for (var _m = (e_5 = void 0, __values(Object.entries(task.expectations))), _o = _m.next(); !_o.done; _o = _m.next()) {
+                    var _p = __read(_o.value, 2), unit = _p[0], _q = _p[1], min = _q.min, max = _q.max;
+                    _loop_5(unit, min, max);
                 }
-                throw new UnexpectedError(spaceTrim(function (block) { return "\n                            `".concat(name, "` is not serializable\n\n                            ").concat(block(error.stack || error.message), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
             }
-            /*
-            TODO: [0] Is there some more elegant way to check circular references?
-            const seen = new Set();
-            const stack = [{ value }];
-            while (stack.length > 0) {
-                const { value } = stack.pop()!;
-                if (typeof value === 'object' && value !== null) {
-                    if (seen.has(value)) {
-                        throw new UnexpectedError(`${name} has circular reference`);
-                    }
-                    seen.add(value);
-                    if (Array.isArray(value)) {
-                        stack.push(...value.map((value) => ({ value })));
-                    } else {
-                        stack.push(...Object.values(value).map((value) => ({ value })));
-                    }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (_o && !_o.done && (_j = _m.return)) _j.call(_m);
                 }
+                finally { if (e_5) throw e_5.error; }
             }
-            */
-            return;
+        }
+    };
+    try {
+        // Note: Checking each task individually
+        for (var _f = __values(pipeline.tasks), _g = _f.next(); !_g.done; _g = _f.next()) {
+            var task = _g.value;
+            _loop_2(task);
         }
     }
-    else {
-        throw new UnexpectedError(spaceTrim(function (block) { return "\n                    `".concat(name, "` is unknown type\n\n                    Additional message for `").concat(name, "`:\n                    ").concat(block(message || '(nothing)'), "\n                "); }));
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    // Note: Detect circular dependencies
+    var resovedParameters = pipeline.parameters
+        .filter(function (_a) {
+        var isInput = _a.isInput;
+        return isInput;
+    })
+        .map(function (_a) {
+        var name = _a.name;
+        return name;
+    });
+    try {
+        // Note: All reserved parameters are resolved
+        for (var RESERVED_PARAMETER_NAMES_1 = __values(RESERVED_PARAMETER_NAMES), RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next(); !RESERVED_PARAMETER_NAMES_1_1.done; RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next()) {
+            var reservedParameterName = RESERVED_PARAMETER_NAMES_1_1.value;
+            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), [reservedParameterName], false);
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (RESERVED_PARAMETER_NAMES_1_1 && !RESERVED_PARAMETER_NAMES_1_1.done && (_c = RESERVED_PARAMETER_NAMES_1.return)) _c.call(RESERVED_PARAMETER_NAMES_1);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    var unresovedTasks = __spreadArray([], __read(pipeline.tasks), false);
+    var loopLimit = LOOP_LIMIT;
+    var _loop_3 = function () {
+        if (loopLimit-- < 0) {
+            // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
+            throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                        Loop limit reached during detection of circular dependencies in `validatePipeline`\n\n                        ".concat(block(pipelineIdentification), "\n                    "); }));
+        }
+        var currentlyResovedTasks = unresovedTasks.filter(function (task) {
+            return task.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
+        });
+        if (currentlyResovedTasks.length === 0) {
+            throw new PipelineLogicError(
+            // TODO: [🐎] DRY
+            spaceTrim$1(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        **Can not resolve:**\n                        ").concat(block(unresovedTasks
+                .map(function (_a) {
+                var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
+                return "- Parameter `{".concat(resultingParameterName, "}` which depends on ").concat(dependentParameterNames
+                    .map(function (dependentParameterName) { return "`{".concat(dependentParameterName, "}`"); })
+                    .join(' and '));
+            })
+                .join('\n')), "\n\n                        **Resolved:**\n                        ").concat(block(resovedParameters
+                .filter(function (name) {
+                return !RESERVED_PARAMETER_NAMES.includes(name);
+            })
+                .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                .join('\n')), "\n\n\n                        **Reserved (which are available):**\n                        ").concat(block(resovedParameters
+                .filter(function (name) {
+                return RESERVED_PARAMETER_NAMES.includes(name);
+            })
+                .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
+                .join('\n')), "\n\n\n                    "); }));
+        }
+        resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTasks.map(function (_a) {
+            var resultingParameterName = _a.resultingParameterName;
+            return resultingParameterName;
+        })), false);
+        unresovedTasks = unresovedTasks.filter(function (task) { return !currentlyResovedTasks.includes(task); });
+    };
+    while (unresovedTasks.length > 0) {
+        _loop_3();
     }
+    // Note: Check that formfactor is corresponding to the pipeline interface
+    // TODO: !!6 Implement this
+    // pipeline.formfactorName
 }
 /**
- * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
- * 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
- */
-
-/**
- * @@@
- *
- * @public exported from `@promptbook/utils`
+ * TODO: [🧞‍♀️] Do not allow joker + foreach
+ * TODO: [🧠] Work with promptbookVersion
+ * TODO: Use here some json-schema, Zod or something similar and change it to:
+ *     > /**
+ *     >  * Validates PipelineJson if it is logically valid.
+ *     >  *
+ *     >  * It checks:
+ *     >  * -   it has a valid structure
+ *     >  * -   ...
+ *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
  */
-function deepClone(objectValue) {
-    return JSON.parse(JSON.stringify(objectValue));
-    /*
-    TODO: [🧠] Is there a better implementation?
-    > const propertyNames = Object.getOwnPropertyNames(objectValue);
-    > for (const propertyName of propertyNames) {
-    >     const value = (objectValue as really_any)[propertyName];
-    >     if (value && typeof value === 'object') {
-    >         deepClone(value);
-    >     }
-    > }
-    > return Object.assign({}, objectValue);
-    */
-}
 /**
- * TODO: [🧠] Is there a way how to meaningfully test this utility
+ * 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
  */
 
 /**
- * Utility to export a JSON object from a function
- *
- * 1) Checks if the value is serializable as JSON
- * 2) Makes a deep clone of the object
- * 2) Orders the object properties
- * 2) Deeply freezes the cloned object
+ * Loads the books from the archive file with `.bookc` extension
  *
- * Note: This function does not mutates the given object
+ * @param filePath Path to the archive file with `.bookc` extension
+ * @param fs Filesystem tools
+ * @returns Pipelines loaded from the archive
  *
- * @returns The same type of object as the input but read-only and re-ordered
- * @public exported from `@promptbook/utils`
+ * @private utility of Prompbook
  */
-function exportJson(options) {
-    var name = options.name, value = options.value, order = options.order, message = options.message;
-    checkSerializableAsJson({ name: name, value: value, message: message });
-    var orderedValue = 
-    // TODO: Fix error "Type instantiation is excessively deep and possibly infinite."
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-ignore
-    order === undefined
-        ? deepClone(value)
-        : orderJson({
-            value: value,
-            // <- Note: checkSerializableAsJson asserts that the value is serializable as JSON
-            order: order,
+function loadArchive(filePath, fs) {
+    return __awaiter(this, void 0, void 0, function () {
+        var data, archive, indexFile, collectionJson, _a, _b, collectionJson_1, collectionJson_1_1, pipeline;
+        var e_1, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    if (!filePath.endsWith('.bookc')) {
+                        throw new UnexpectedError("Archive file must have '.bookc' extension");
+                    }
+                    return [4 /*yield*/, fs.readFile(filePath)];
+                case 1:
+                    data = _d.sent();
+                    return [4 /*yield*/, JSZip.loadAsync(data)];
+                case 2:
+                    archive = _d.sent();
+                    indexFile = archive.file('index.book.json');
+                    if (!indexFile) {
+                        throw new UnexpectedError("Archive does not contain 'index.book.json' file");
+                    }
+                    _b = (_a = JSON).parse;
+                    return [4 /*yield*/, indexFile.async('text')];
+                case 3:
+                    collectionJson = _b.apply(_a, [_d.sent()]);
+                    try {
+                        for (collectionJson_1 = __values(collectionJson), collectionJson_1_1 = collectionJson_1.next(); !collectionJson_1_1.done; collectionJson_1_1 = collectionJson_1.next()) {
+                            pipeline = collectionJson_1_1.value;
+                            validatePipeline(pipeline);
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (collectionJson_1_1 && !collectionJson_1_1.done && (_c = collectionJson_1.return)) _c.call(collectionJson_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    return [2 /*return*/, collectionJson];
+            }
         });
-    $deepFreeze(orderedValue);
-    return orderedValue;
+    });
 }
 /**
- * TODO: [🧠] Is there a way how to meaningfully test this utility
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */
 
-/**
- * Order of keys in the pipeline JSON
- *
- * @public exported from `@promptbook/core`
- */
-var ORDER_OF_PIPELINE_JSON = [
-    // Note: [🍙] In this order will be pipeline serialized
-    'title',
-    'pipelineUrl',
-    'bookVersion',
-    'description',
-    'formfactorName',
-    'parameters',
-    'tasks',
-    'personas',
-    'preparations',
-    'knowledgeSources',
-    'knowledgePieces',
-    'sources', // <- TODO: [🧠] Where should the `sources` be
-];
-/**
- * Nonce which is used for replacing things in strings
- *
- * @private within the repository
- */
-var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
-/**
- * @@@
- *
- * @private within the repository
- */
-var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
-/**
- * @@@
- *
- * @private within the repository
- */
-var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
-/**
- * The names of the parameters that are reserved for special purposes
- *
- * @public exported from `@promptbook/core`
- */
-var RESERVED_PARAMETER_NAMES = exportJson({
-    name: 'RESERVED_PARAMETER_NAMES',
-    message: "The names of the parameters that are reserved for special purposes",
-    value: [
-        'content',
-        'context',
-        'knowledge',
-        'examples',
-        'modelName',
-        'currentDate',
-        // <- TODO: list here all command names
-        // <- TODO: Add more like 'date', 'modelName',...
-        // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
-    ],
-});
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",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`\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"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",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`\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"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",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-   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`\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-   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"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",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`\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"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",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 workflow:\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-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",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`\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 workflow:\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-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
 /**
- * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ * Checks if value is valid email
  *
- * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/utils`
  */
-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 isValidEmail(email) {
+    if (typeof email !== 'string') {
+        return false;
     }
-    return PipelineLogicError;
-}(Error));
+    if (email.split('\n').length > 1) {
+        return false;
+    }
+    return /^.+@.+\..+$/.test(email);
+}
 
 /**
- * Tests if given string is valid semantic version
- *
- * Note: There are two simmilar functions:
- * - `isValidSemanticVersion` which tests any semantic version
- * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+ * Tests if given string is valid URL.
  *
+ * Note: This does not check if the file exists only if the path is valid
  * @public exported from `@promptbook/utils`
  */
-function isValidSemanticVersion(version) {
-    if (typeof version !== 'string') {
+function isValidFilePath(filename) {
+    if (typeof filename !== 'string') {
         return false;
     }
-    if (version.startsWith('0.0.0')) {
+    if (filename.split('\n').length > 1) {
         return false;
     }
-    return /^\d+\.\d+\.\d+(-\d+)?$/i.test(version);
+    if (filename.split(' ').length >
+        5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
+        return false;
+    }
+    var filenameSlashes = filename.split('\\').join('/');
+    // Absolute Unix path: /hello.txt
+    if (/^(\/)/i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Unix path: /hello.txt');
+        return true;
+    }
+    // Absolute Windows path: /hello.txt
+    if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Windows path: /hello.txt');
+        return true;
+    }
+    // Relative path: ./hello.txt
+    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Relative path: ./hello.txt');
+        return true;
+    }
+    // Allow paths like foo/hello
+    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like foo/hello');
+        return true;
+    }
+    // Allow paths like hello.book
+    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like hello.book');
+        return true;
+    }
+    return false;
 }
+/**
+ * TODO: [🍏] Implement for MacOs
+ */
 
 /**
- * Tests if given string is valid promptbook version
- * It looks into list of known promptbook versions.
- *
- * @see https://www.npmjs.com/package/promptbook?activeTab=versions
- * Note: When you are using for example promptbook 2.0.0 and there already is promptbook 3.0.0 it don`t know about it.
- * Note: There are two simmilar functions:
- * - `isValidSemanticVersion` which tests any semantic version
- * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+ * Function isValidJsonString will tell you if the string is valid JSON or not
  *
  * @public exported from `@promptbook/utils`
  */
-function isValidPromptbookVersion(version) {
-    if (!isValidSemanticVersion(version)) {
-        return false;
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
     }
-    if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
         return false;
     }
-    // <- TODO: [main] !!3 Check isValidPromptbookVersion against PROMPTBOOK_ENGINE_VERSIONS
-    return true;
 }
-
-/**
- * Tests if given string is valid pipeline URL URL.
- *
- * Note: There are two simmilar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
+
+/**
+ * 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.
  *
- * @public exported from `@promptbook/utils`
+ * @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`
  */
-function isValidPipelineUrl(url) {
-    if (!isValidUrl(url)) {
-        return false;
+function validatePipelineString(pipelineString) {
+    if (isValidJsonString(pipelineString)) {
+        throw new ParseError('Expected a book, but got a JSON string');
     }
-    if (!url.startsWith('https://') && !url.startsWith('http://') /* <- Note: [👣] */) {
-        return false;
+    else if (isValidUrl(pipelineString)) {
+        throw new ParseError("Expected a book, but got just the URL \"".concat(pipelineString, "\""));
     }
-    if (url.includes('#')) {
-        // TODO: [🐠]
-        return false;
+    else if (isValidFilePath(pipelineString)) {
+        throw new ParseError("Expected a book, but got just the file path \"".concat(pipelineString, "\""));
     }
-    /*
-    Note: [👣][🧠] Is it secure to allow pipeline URLs on private and unsecured networks?
-    if (isUrlOnPrivateNetwork(url)) {
-        return false;
+    else if (isValidEmail(pipelineString)) {
+        throw new ParseError("Expected a book, but got just the email \"".concat(pipelineString, "\""));
     }
-    */
-    return true;
+    // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
+    return pipelineString;
 }
 /**
- * TODO: [🐠] Maybe more info why the URL is invalid
+ * TODO: [🧠][🈴] Where is the best location for this file
  */
 
 /**
- * Validates PipelineJson if it is logically valid
- *
- * It checks:
- * -   if it has correct parameters dependency
- *
- * It does NOT check:
- * -   if it is valid json
- * -   if it is meaningful
+ * Prettify the html code
  *
- * @param pipeline valid or invalid PipelineJson
- * @returns the same pipeline if it is logically valid
- * @throws {PipelineLogicError} on logical error in the pipeline
- * @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
  */
-function validatePipeline(pipeline) {
-    if (IS_PIPELINE_LOGIC_VALIDATED) {
-        validatePipeline_InnerFunction(pipeline);
+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,
+        });
     }
-    else {
-        try {
-            validatePipeline_InnerFunction(pipeline);
-        }
-        catch (error) {
-            if (!(error instanceof PipelineLogicError)) {
-                throw error;
-            }
-            console.error(spaceTrim$1(function (block) { return "\n                        Pipeline is not valid but logic errors are temporarily disabled via `IS_PIPELINE_LOGIC_VALIDATED`\n\n                        ".concat(block(error.message), "\n                    "); }));
-        }
+    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;
     }
-    return pipeline;
 }
+
 /**
- * @private internal function for `validatePipeline`
+ * Makes first letter of a string uppercase
+ *
+ * @public exported from `@promptbook/utils`
  */
-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 () {
-        // Note: This is a 😐 implementation of [🚞]
-        var _ = [];
-        if (pipeline.sourceFile !== undefined) {
-            _.push("File: ".concat(pipeline.sourceFile));
-        }
-        if (pipeline.pipelineUrl !== undefined) {
-            _.push("Url: ".concat(pipeline.pipelineUrl));
-        }
-        return _.join('\n');
-    })();
-    if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
-        // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                    Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
-    }
-    if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
-        // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                    Invalid Promptbook Version \"".concat(pipeline.bookVersion, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+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 (.bookc)
+ * @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;
+    var title = pipelineJson.title, pipelineUrl = pipelineJson.pipelineUrl, bookVersion = pipelineJson.bookVersion, description = pipelineJson.description, parameters = pipelineJson.parameters, tasks = pipelineJson.tasks;
+    var pipelineString = "# ".concat(title);
+    if (description) {
+        pipelineString += '\n\n';
+        pipelineString += description;
     }
-    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
-    if (!Array.isArray(pipeline.parameters)) {
-        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+    var commands = [];
+    if (pipelineUrl) {
+        commands.push("PIPELINE URL ".concat(pipelineUrl));
     }
-    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
-    if (!Array.isArray(pipeline.tasks)) {
-        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Pipeline is valid JSON but with wrong structure\n\n                    `PipelineJson.tasks` expected to be an array, but got ".concat(typeof pipeline.tasks, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+    if (bookVersion !== "undefined") {
+        commands.push("BOOK VERSION ".concat(bookVersion));
     }
-    var _loop_1 = function (parameter) {
-        if (parameter.isInput && parameter.isOutput) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n\n                        Parameter `{".concat(parameter.name, "}` can not be both input and output\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
-        }
-        // Note: Testing that parameter is either intermediate or output BUT not created and unused
-        if (!parameter.isInput &&
-            !parameter.isOutput &&
-            !pipeline.tasks.some(function (task) { return task.dependentParameterNames.includes(parameter.name); })) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is created but not used\n\n                        You can declare {").concat(parameter.name, "} as output parameter by adding in the header:\n                        - OUTPUT PARAMETER `{").concat(parameter.name, "}` ").concat(parameter.description || '', "\n\n                        ").concat(block(pipelineIdentification), "\n\n                    "); }));
-        }
-        // Note: Testing that parameter is either input or result of some task
-        if (!parameter.isInput && !pipeline.tasks.some(function (task) { return task.resultingParameterName === parameter.name; })) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(parameter.name, "}` is declared but not defined\n\n                        You can do one of these:\n                        1) Remove declaration of `{").concat(parameter.name, "}`\n                        2) Add task that results in `-> {").concat(parameter.name, "}`\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
-        }
-    };
+    // TODO: [main] !!5 This increases size of the bundle and is probbably not necessary
+    pipelineString = prettifyMarkdown(pipelineString);
     try {
-        /*
-        TODO: [🧠][🅾] Should be empty pipeline valid or not
-        // Note: Check that pipeline has some tasks
-        if (pipeline.tasks.length === 0) {
-            throw new PipelineLogicError(
-                spaceTrim(
-                    (block) => `
-                      Pipeline must have at least one task
-    
-                      ${block(pipelineIdentification)}
-                  `,
-                ),
-            );
-        }
-        */
-        // Note: Check each parameter individually
-        for (var _d = __values(pipeline.parameters), _e = _d.next(); !_e.done; _e = _d.next()) {
-            var parameter = _e.value;
-            _loop_1(parameter);
+        for (var _g = __values(parameters.filter(function (_a) {
+            var isInput = _a.isInput;
+            return isInput;
+        })), _h = _g.next(); !_h.done; _h = _g.next()) {
+            var parameter = _h.value;
+            commands.push("INPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+            if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    // Note: All input parameters are defined - so that they can be used as result of some task
-    var definedParameters = new Set(pipeline.parameters.filter(function (_a) {
-        var isInput = _a.isInput;
-        return isInput;
-    }).map(function (_a) {
-        var name = _a.name;
-        return name;
-    }));
-    var _loop_2 = function (task) {
-        var e_4, _h, e_5, _j;
-        if (definedParameters.has(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter `{".concat(task.resultingParameterName, "}` is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+    try {
+        for (var _j = __values(parameters.filter(function (_a) {
+            var isOutput = _a.isOutput;
+            return isOutput;
+        })), _k = _j.next(); !_k.done; _k = _j.next()) {
+            var parameter = _k.value;
+            commands.push("OUTPUT PARAMETER ".concat(taskParameterJsonToString(parameter)));
         }
-        if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter name {".concat(task.resultingParameterName, "} is reserved, please use different name\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
         }
-        definedParameters.add(task.resultingParameterName);
-        if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
-            if (!task.format &&
-                !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                            Joker parameters are used for {".concat(task.resultingParameterName, "} but no expectations are defined\n\n                            ").concat(block(pipelineIdentification), "\n                        "); }));
+        finally { if (e_2) throw e_2.error; }
+    }
+    pipelineString += '\n\n';
+    pipelineString += commands.map(function (command) { return "- ".concat(command); }).join('\n');
+    try {
+        for (var tasks_1 = __values(tasks), tasks_1_1 = tasks_1.next(); !tasks_1_1.done; tasks_1_1 = tasks_1.next()) {
+            var task = tasks_1_1.value;
+            var 
+            /* Note: Not using:> name, */
+            title_1 = task.title, description_1 = task.description, 
+            /* Note: dependentParameterNames, */
+            jokers = task.jokerParameterNames, taskType = task.taskType, content = task.content, postprocessing = task.postprocessingFunctionNames, expectations = task.expectations, format = task.format, resultingParameterName = task.resultingParameterName;
+            pipelineString += '\n\n';
+            pipelineString += "## ".concat(title_1);
+            if (description_1) {
+                pipelineString += '\n\n';
+                pipelineString += description_1;
+            }
+            var commands_1 = [];
+            var contentLanguage = 'text';
+            if (taskType === 'PROMPT_TASK') {
+                var modelRequirements = task.modelRequirements;
+                var _l = modelRequirements || {}, modelName = _l.modelName, modelVariant = _l.modelVariant;
+                // Note: Do nothing, it is default
+                // commands.push(`PROMPT`);
+                if (modelVariant) {
+                    commands_1.push("MODEL VARIANT ".concat(capitalize(modelVariant)));
+                }
+                if (modelName) {
+                    commands_1.push("MODEL NAME `".concat(modelName, "`"));
+                }
+            }
+            else if (taskType === 'SIMPLE_TASK') {
+                commands_1.push("SIMPLE TEMPLATE");
+                // Note: Nothing special here
             }
-            var _loop_4 = function (joker) {
-                if (!task.dependentParameterNames.includes(joker)) {
-                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Parameter `{".concat(joker, "}` is used for {").concat(task.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+            else if (taskType === 'SCRIPT_TASK') {
+                commands_1.push("SCRIPT");
+                if (task.contentLanguage) {
+                    contentLanguage = task.contentLanguage;
                 }
-            };
-            try {
-                for (var _k = (e_4 = void 0, __values(task.jokerParameterNames)), _l = _k.next(); !_l.done; _l = _k.next()) {
-                    var joker = _l.value;
-                    _loop_4(joker);
+                else {
+                    contentLanguage = '';
                 }
             }
-            catch (e_4_1) { e_4 = { error: e_4_1 }; }
-            finally {
+            else if (taskType === 'DIALOG_TASK') {
+                commands_1.push("DIALOG");
+                // Note: Nothing special here
+            } // <- }else if([🅱]
+            if (jokers) {
                 try {
-                    if (_l && !_l.done && (_h = _k.return)) _h.call(_k);
-                }
-                finally { if (e_4) throw e_4.error; }
-            }
-        }
-        if (task.expectations) {
-            var _loop_5 = function (unit, min, max) {
-                if (min !== undefined && max !== undefined && min > max) {
-                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Min expectation (=".concat(min, ") of ").concat(unit, " is higher than max expectation (=").concat(max, ")\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                    for (var jokers_1 = (e_4 = void 0, __values(jokers)), jokers_1_1 = jokers_1.next(); !jokers_1_1.done; jokers_1_1 = jokers_1.next()) {
+                        var joker = jokers_1_1.value;
+                        commands_1.push("JOKER {".concat(joker, "}"));
+                    }
                 }
-                if (min !== undefined && min < 0) {
-                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Min expectation of ".concat(unit, " must be zero or positive\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                finally {
+                    try {
+                        if (jokers_1_1 && !jokers_1_1.done && (_d = jokers_1.return)) _d.call(jokers_1);
+                    }
+                    finally { if (e_4) throw e_4.error; }
                 }
-                if (max !== undefined && max <= 0) {
-                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Max expectation of ".concat(unit, " must be positive\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+            } /* not else */
+            if (postprocessing) {
+                try {
+                    for (var postprocessing_1 = (e_5 = void 0, __values(postprocessing)), postprocessing_1_1 = postprocessing_1.next(); !postprocessing_1_1.done; postprocessing_1_1 = postprocessing_1.next()) {
+                        var postprocessingFunctionName = postprocessing_1_1.value;
+                        commands_1.push("POSTPROCESSING `".concat(postprocessingFunctionName, "`"));
+                    }
                 }
-            };
-            try {
-                for (var _m = (e_5 = void 0, __values(Object.entries(task.expectations))), _o = _m.next(); !_o.done; _o = _m.next()) {
-                    var _p = __read(_o.value, 2), unit = _p[0], _q = _p[1], min = _q.min, max = _q.max;
-                    _loop_5(unit, min, max);
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                finally {
+                    try {
+                        if (postprocessing_1_1 && !postprocessing_1_1.done && (_e = postprocessing_1.return)) _e.call(postprocessing_1);
+                    }
+                    finally { if (e_5) throw e_5.error; }
                 }
-            }
-            catch (e_5_1) { e_5 = { error: e_5_1 }; }
-            finally {
+            } /* not else */
+            if (expectations) {
                 try {
-                    if (_o && !_o.done && (_j = _m.return)) _j.call(_m);
+                    for (var _m = (e_6 = void 0, __values(Object.entries(expectations))), _o = _m.next(); !_o.done; _o = _m.next()) {
+                        var _p = __read(_o.value, 2), unit = _p[0], _q = _p[1], min = _q.min, max = _q.max;
+                        if (min === max) {
+                            commands_1.push("EXPECT EXACTLY ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                        }
+                        else {
+                            if (min !== undefined) {
+                                commands_1.push("EXPECT MIN ".concat(min, " ").concat(capitalize(unit + (min > 1 ? 's' : ''))));
+                            } /* not else */
+                            if (max !== undefined) {
+                                commands_1.push("EXPECT MAX ".concat(max, " ").concat(capitalize(unit + (max > 1 ? 's' : ''))));
+                            }
+                        }
+                    }
                 }
-                finally { if (e_5) throw e_5.error; }
-            }
-        }
-    };
-    try {
-        // Note: Checking each task individually
-        for (var _f = __values(pipeline.tasks), _g = _f.next(); !_g.done; _g = _f.next()) {
-            var task = _g.value;
-            _loop_2(task);
-        }
-    }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
-    finally {
-        try {
-            if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
-        }
-        finally { if (e_2) throw e_2.error; }
-    }
-    // Note: Detect circular dependencies
-    var resovedParameters = pipeline.parameters
-        .filter(function (_a) {
-        var isInput = _a.isInput;
-        return isInput;
-    })
-        .map(function (_a) {
-        var name = _a.name;
-        return name;
-    });
-    try {
-        // Note: All reserved parameters are resolved
-        for (var RESERVED_PARAMETER_NAMES_1 = __values(RESERVED_PARAMETER_NAMES), RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next(); !RESERVED_PARAMETER_NAMES_1_1.done; RESERVED_PARAMETER_NAMES_1_1 = RESERVED_PARAMETER_NAMES_1.next()) {
-            var reservedParameterName = RESERVED_PARAMETER_NAMES_1_1.value;
-            resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), [reservedParameterName], false);
+                catch (e_6_1) { e_6 = { error: e_6_1 }; }
+                finally {
+                    try {
+                        if (_o && !_o.done && (_f = _m.return)) _f.call(_m);
+                    }
+                    finally { if (e_6) throw e_6.error; }
+                }
+            } /* not else */
+            if (format) {
+                if (format === 'JSON') {
+                    // TODO: @deprecated remove
+                    commands_1.push("FORMAT JSON");
+                }
+            } /* not else */
+            pipelineString += '\n\n';
+            pipelineString += commands_1.map(function (command) { return "- ".concat(command); }).join('\n');
+            pipelineString += '\n\n';
+            pipelineString += '```' + contentLanguage;
+            pipelineString += '\n';
+            pipelineString += spaceTrim(content);
+            //                   <- TODO: [main] !!3 Escape
+            //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
+            pipelineString += '\n';
+            pipelineString += '```';
+            pipelineString += '\n\n';
+            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 }; }
     finally {
         try {
-            if (RESERVED_PARAMETER_NAMES_1_1 && !RESERVED_PARAMETER_NAMES_1_1.done && (_c = RESERVED_PARAMETER_NAMES_1.return)) _c.call(RESERVED_PARAMETER_NAMES_1);
+            if (tasks_1_1 && !tasks_1_1.done && (_c = tasks_1.return)) _c.call(tasks_1);
         }
         finally { if (e_3) throw e_3.error; }
     }
-    var unresovedTasks = __spreadArray([], __read(pipeline.tasks), false);
-    var loopLimit = LOOP_LIMIT;
-    var _loop_3 = function () {
-        if (loopLimit-- < 0) {
-            // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-            throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                        Loop limit reached during detection of circular dependencies in `validatePipeline`\n\n                        ".concat(block(pipelineIdentification), "\n                    "); }));
-        }
-        var currentlyResovedTasks = unresovedTasks.filter(function (task) {
-            return task.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
-        });
-        if (currentlyResovedTasks.length === 0) {
-            throw new PipelineLogicError(
-            // TODO: [🐎] DRY
-            spaceTrim$1(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        ".concat(block(pipelineIdentification), "\n\n                        **Can not resolve:**\n                        ").concat(block(unresovedTasks
-                .map(function (_a) {
-                var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
-                return "- Parameter `{".concat(resultingParameterName, "}` which depends on ").concat(dependentParameterNames
-                    .map(function (dependentParameterName) { return "`{".concat(dependentParameterName, "}`"); })
-                    .join(' and '));
-            })
-                .join('\n')), "\n\n                        **Resolved:**\n                        ").concat(block(resovedParameters
-                .filter(function (name) {
-                return !RESERVED_PARAMETER_NAMES.includes(name);
-            })
-                .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
-                .join('\n')), "\n\n\n                        **Reserved (which are available):**\n                        ").concat(block(resovedParameters
-                .filter(function (name) {
-                return RESERVED_PARAMETER_NAMES.includes(name);
-            })
-                .map(function (name) { return "- Parameter `{".concat(name, "}`"); })
-                .join('\n')), "\n\n\n                    "); }));
-        }
-        resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTasks.map(function (_a) {
-            var resultingParameterName = _a.resultingParameterName;
-            return resultingParameterName;
-        })), false);
-        unresovedTasks = unresovedTasks.filter(function (task) { return !currentlyResovedTasks.includes(task); });
-    };
-    while (unresovedTasks.length > 0) {
-        _loop_3();
-    }
-    // Note: Check that formfactor is corresponding to the pipeline interface
-    // TODO: !!6 Implement this
-    // pipeline.formfactorName
+    return validatePipelineString(pipelineString);
 }
 /**
- * TODO: [🧞‍♀️] Do not allow joker + foreach
- * TODO: [🧠] Work with promptbookVersion
- * TODO: Use here some json-schema, Zod or something similar and change it to:
- *     > /**
- *     >  * Validates PipelineJson if it is logically valid.
- *     >  *
- *     >  * It checks:
- *     >  * -   it has a valid structure
- *     >  * -   ...
- *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
+ * @private internal utility of `pipelineJsonToString`
  */
+function taskParameterJsonToString(taskParameterJson) {
+    var name = taskParameterJson.name, description = taskParameterJson.description;
+    var parameterString = "{".concat(name, "}");
+    if (description) {
+        parameterString = "".concat(parameterString, " ").concat(description);
+    }
+    return parameterString;
+}
 /**
- * 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
+ * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
+ * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
+ * TODO: [🏛] Maybe make some markdown builder
+ * TODO: [🏛] Escape all
+ * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
  */
 
 /**
@@ -11279,17 +11335,17 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                     }
                     _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;
-                        return __generator(this, function (_b) {
-                            switch (_b.label) {
+                        var fileNames, collection, pipelinesWithFilenames, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1, _loop_2, pipelinesWithFilenames_1, pipelinesWithFilenames_1_1, pipelineWithFilenames;
+                        var e_1, _a, e_2, _b;
+                        return __generator(this, function (_c) {
+                            switch (_c.label) {
                                 case 0:
                                     if (isVerbose) {
                                         console.info(colors.cyan("Creating pipeline collection from path ".concat(rootPath.split('\\').join('/'))));
                                     }
                                     return [4 /*yield*/, listAllFiles(rootPath, isRecursive, tools.fs)];
                                 case 1:
-                                    fileNames = _b.sent();
+                                    fileNames = _c.sent();
                                     // Note: First load compiled `.bookc` files and then source `.book` files
                                     //       `.bookc` are already compiled and can be used faster
                                     fileNames.sort(function (a, b) {
@@ -11302,100 +11358,54 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                         return 0;
                                     });
                                     collection = new Map();
+                                    pipelinesWithFilenames = [];
                                     _loop_1 = function (fileName) {
-                                        var sourceFile, rootDirname, pipeline, pipelineString, _c, _d, _e, pipelineUrl, existing, error_1, wrappedErrorMessage;
-                                        return __generator(this, function (_f) {
-                                            switch (_f.label) {
+                                        var sourceFile, rootDirname, pipelineString, _d, pipeline, _e, _f, _g, _h, error_1, wrappedErrorMessage;
+                                        return __generator(this, function (_j) {
+                                            switch (_j.label) {
                                                 case 0:
                                                     sourceFile = './' + fileName.split('\\').join('/');
                                                     rootDirname = dirname(sourceFile).split('\\').join('/');
-                                                    _f.label = 1;
+                                                    _j.label = 1;
                                                 case 1:
-                                                    _f.trys.push([1, 8, , 9]);
-                                                    pipeline = null;
+                                                    _j.trys.push([1, 8, , 9]);
                                                     if (!(fileName.endsWith('.book') || fileName.endsWith('.book.md'))) return [3 /*break*/, 4];
-                                                    _c = validatePipelineString;
+                                                    _d = validatePipelineString;
                                                     return [4 /*yield*/, readFile(fileName, 'utf-8')];
                                                 case 2:
-                                                    pipelineString = _c.apply(void 0, [_f.sent()]);
+                                                    pipelineString = _d.apply(void 0, [_j.sent()]);
                                                     return [4 /*yield*/, compilePipeline(pipelineString, tools, {
                                                             rootDirname: rootDirname,
                                                         })];
                                                 case 3:
-                                                    pipeline = _f.sent();
-                                                    pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
+                                                    pipeline = _j.sent();
+                                                    pipelinesWithFilenames.push({ fileName: fileName, sourceFile: sourceFile, pipeline: __assign(__assign({}, pipeline), { sourceFile: sourceFile }) });
                                                     return [3 /*break*/, 7];
                                                 case 4:
                                                     if (!(fileName.endsWith('.bookc') || fileName.endsWith('.book.json'))) return [3 /*break*/, 6];
-                                                    _e = (_d = JSON).parse;
-                                                    return [4 /*yield*/, readFile(fileName, 'utf-8')];
+                                                    _f = 
+                                                    // TODO: Handle non-valid JSON files
+                                                    (_e = pipelinesWithFilenames.push).apply;
+                                                    _g = [
+                                                        // TODO: Handle non-valid JSON files
+                                                        pipelinesWithFilenames];
+                                                    _h = [[]];
+                                                    return [4 /*yield*/, loadArchive(fileName, tools.fs)];
                                                 case 5:
                                                     // TODO: Handle non-valid JSON files
-                                                    pipeline = _e.apply(_d, [_f.sent()]);
-                                                    // TODO: [🌗]
-                                                    pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
+                                                    _f.apply(_e, _g.concat([__spreadArray.apply(void 0, _h.concat([__read.apply(void 0, [(_j.sent()).map(function (pipeline) {
+                                                                    // TODO: [🌗]
+                                                                    return ({ fileName: fileName, sourceFile: sourceFile, pipeline: __assign(__assign({}, pipeline), { sourceFile: sourceFile }) });
+                                                                })]), false]))]));
                                                     return [3 /*break*/, 7];
                                                 case 6:
                                                     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")));
                                                     }
-                                                    _f.label = 7;
-                                                case 7:
-                                                    // ---
-                                                    if (pipeline !== null) {
-                                                        if (rootUrl !== undefined) {
-                                                            if (pipeline.pipelineUrl === undefined) {
-                                                                pipelineUrl = rootUrl + '/' + relative(rootPath, fileName).split('\\').join('/');
-                                                                // console.log({ pipelineUrl, rootPath, rootUrl, fileName });
-                                                                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) {
-                                                                console.info(colors.yellow("Can not load pipeline from ".concat(fileName
-                                                                    .split('\\')
-                                                                    .join('/'), " because of missing URL")));
-                                                            }
-                                                        }
-                                                        else {
-                                                            // Note: [🐨] Pipeline is checked multiple times
-                                                            // TODO: Maybe once is enough BUT be sure to check it - better to check it multiple times than not at all
-                                                            validatePipeline(pipeline);
-                                                            if (
-                                                            // TODO: [🐽] comparePipelines(pipeline1,pipeline2): 'IDENTICAL' |'IDENTICAL_UNPREPARED' | 'IDENTICAL_INTERFACE' | 'DIFFERENT'
-                                                            !collection.has(pipeline.pipelineUrl)) {
-                                                                if (isVerbose) {
-                                                                    console.info(colors.green("Loaded pipeline ".concat(fileName.split('\\').join('/'), "\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060")));
-                                                                }
-                                                                // Note: [🦄] Pipeline with same url uniqueness will be double-checked automatically in SimplePipelineCollection
-                                                                collection.set(pipeline.pipelineUrl, pipeline);
-                                                            }
-                                                            else if (pipelineJsonToString(unpreparePipeline(pipeline)) ===
-                                                                pipelineJsonToString(unpreparePipeline(collection.get(pipeline.pipelineUrl)))) {
-                                                                if (isVerbose) {
-                                                                    console.info(colors.gray("Skipped pipeline ".concat(fileName
-                                                                        .split('\\')
-                                                                        .join('/'), " \u2013\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060 Already identical pipeline in the collection")));
-                                                                }
-                                                            }
-                                                            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                                ")));
-                                                            }
-                                                        }
-                                                    }
-                                                    return [3 /*break*/, 9];
+                                                    _j.label = 7;
+                                                case 7: return [3 /*break*/, 9];
                                                 case 8:
-                                                    error_1 = _f.sent();
+                                                    error_1 = _j.sent();
                                                     if (!(error_1 instanceof Error)) {
                                                         throw error_1;
                                                     }
@@ -11410,24 +11420,24 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                             }
                                         });
                                     };
-                                    _b.label = 2;
+                                    _c.label = 2;
                                 case 2:
-                                    _b.trys.push([2, 7, 8, 9]);
+                                    _c.trys.push([2, 7, 8, 9]);
                                     fileNames_1 = __values(fileNames), fileNames_1_1 = fileNames_1.next();
-                                    _b.label = 3;
+                                    _c.label = 3;
                                 case 3:
                                     if (!!fileNames_1_1.done) return [3 /*break*/, 6];
                                     fileName = fileNames_1_1.value;
                                     return [5 /*yield**/, _loop_1(fileName)];
                                 case 4:
-                                    _b.sent();
-                                    _b.label = 5;
+                                    _c.sent();
+                                    _c.label = 5;
                                 case 5:
                                     fileNames_1_1 = fileNames_1.next();
                                     return [3 /*break*/, 3];
                                 case 6: return [3 /*break*/, 9];
                                 case 7:
-                                    e_1_1 = _b.sent();
+                                    e_1_1 = _c.sent();
                                     e_1 = { error: e_1_1 };
                                     return [3 /*break*/, 9];
                                 case 8:
@@ -11436,7 +11446,86 @@ function createCollectionFromDirectory(rootPath, tools, options) {
                                     }
                                     finally { if (e_1) throw e_1.error; }
                                     return [7 /*endfinally*/];
-                                case 9: return [2 /*return*/, Array.from(collection.values())];
+                                case 9:
+                                    _loop_2 = function (pipelineWithFilenames) {
+                                        var fileName = pipelineWithFilenames.fileName, sourceFile = pipelineWithFilenames.sourceFile;
+                                        var pipeline = pipelineWithFilenames.pipeline;
+                                        try {
+                                            if (rootUrl !== undefined) {
+                                                if (pipeline.pipelineUrl === undefined) {
+                                                    var pipelineUrl = rootUrl + '/' + relative(rootPath, fileName).split('\\').join('/');
+                                                    // console.log({ pipelineUrl, rootPath, rootUrl, fileName });
+                                                    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) {
+                                                    console.info(colors.yellow("Can not load pipeline from ".concat(fileName.split('\\').join('/'), " because of missing URL")));
+                                                }
+                                            }
+                                            else {
+                                                // Note: [🐨] Pipeline is checked multiple times
+                                                // TODO: Maybe once is enough BUT be sure to check it - better to check it multiple times than not at all
+                                                validatePipeline(pipeline);
+                                                if (
+                                                // TODO: [🐽] comparePipelines(pipeline1,pipeline2): 'IDENTICAL' |'IDENTICAL_UNPREPARED' | 'IDENTICAL_INTERFACE' | 'DIFFERENT'
+                                                !collection.has(pipeline.pipelineUrl)) {
+                                                    if (isVerbose) {
+                                                        console.info(colors.green("Loaded pipeline ".concat(fileName.split('\\').join('/'), "\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060")));
+                                                    }
+                                                    // Note: [🦄] Pipeline with same url uniqueness will be double-checked automatically in SimplePipelineCollection
+                                                    collection.set(pipeline.pipelineUrl, pipeline);
+                                                }
+                                                else if (pipelineJsonToString(unpreparePipeline(pipeline)) ===
+                                                    pipelineJsonToString(unpreparePipeline(collection.get(pipeline.pipelineUrl)))) {
+                                                    if (isVerbose) {
+                                                        console.info(colors.gray("Skipped pipeline ".concat(fileName
+                                                            .split('\\')
+                                                            .join('/'), " \u2013\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060\u2060 Already identical pipeline in the collection")));
+                                                    }
+                                                }
+                                                else {
+                                                    var 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                            ")));
+                                                }
+                                            }
+                                        }
+                                        catch (error) {
+                                            if (!(error instanceof Error)) {
+                                                throw error;
+                                            }
+                                            // TODO: [7] DRY
+                                            var wrappedErrorMessage = spaceTrim(function (block) { return "\n                            ".concat(error.name, " in pipeline ").concat(fileName.split('\\').join('/'), "\u2060:\n\n                            Original error message:\n                            ").concat(block(error.message), "\n\n                            Original stack trace:\n                            ").concat(block(error.stack || ''), "\n\n                            ---\n\n                        "); }) + '\n';
+                                            if (isCrashedOnError) {
+                                                throw new CollectionError(wrappedErrorMessage);
+                                            }
+                                            // TODO: [🟥] Detect browser / node and make it colorfull
+                                            console.error(wrappedErrorMessage);
+                                        }
+                                    };
+                                    try {
+                                        for (pipelinesWithFilenames_1 = __values(pipelinesWithFilenames), pipelinesWithFilenames_1_1 = pipelinesWithFilenames_1.next(); !pipelinesWithFilenames_1_1.done; pipelinesWithFilenames_1_1 = pipelinesWithFilenames_1.next()) {
+                                            pipelineWithFilenames = pipelinesWithFilenames_1_1.value;
+                                            _loop_2(pipelineWithFilenames);
+                                        }
+                                    }
+                                    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                                    finally {
+                                        try {
+                                            if (pipelinesWithFilenames_1_1 && !pipelinesWithFilenames_1_1.done && (_b = pipelinesWithFilenames_1.return)) _b.call(pipelinesWithFilenames_1);
+                                        }
+                                        finally { if (e_2) throw e_2.error; }
+                                    }
+                                    return [2 /*return*/, Array.from(collection.values())];
                             }
                         });
                     }); });
@@ -11501,9 +11590,11 @@ var FileCacheStorage = /** @class */ (function () {
     FileCacheStorage.prototype.getFilenameForKey = function (key) {
         // TODO: [👬] DRY
         var name = titleToName(key);
+        var nameStart = name.split('-', 2)[0] || 'unnamed';
         var hash = sha256(hexEncoder.parse(name)).toString( /* hex */);
         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
-        return join.apply(void 0, __spreadArray(__spreadArray([this.options.rootFolderPath], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(name.substring(0, MAX_FILENAME_LENGTH), ".json")], false));
+        return join.apply(void 0, __spreadArray(__spreadArray([this.options.rootFolderPath,
+            nameStart], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(name.substring(0, MAX_FILENAME_LENGTH), ".json")], false));
     };
     /**
      * @@@ Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.