@promptbook/node 0.66.0 → 0.67.0-1

package/esm/index.es.js

@@ -1,7 +1,7 @@
 import colors from 'colors';
 import { stat, access, constants, readdir, readFile, writeFile, mkdir, unlink } from 'fs/promises';
 import { join as join$1, dirname } from 'path';
-import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
 import hexEncoder from 'crypto-js/enc-hex';
@@ -13,7 +13,7 @@ import * as dotenv from 'dotenv';
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.66.0-9';
+var PROMPTBOOK_VERSION = '0.67.0-0';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
@@ -135,6 +135,26 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
+/**
+ * Returns the same value that is passed as argument.
+ * No side effects.
+ *
+ * Note: It can be usefull for:
+ *
+ * 1) Leveling indentation
+ * 2) Putting always-true or always-false conditions without getting eslint errors
+ *
+ * @param value any values
+ * @returns the same values
+ * @private within the repository
+ */
+function just(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value;
+}
+
 /**
  * @@@
  *
@@ -165,42 +185,169 @@ function $deepFreeze(objectValue) {
     }
     return Object.freeze(objectValue);
 }
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * 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`
+ */
+var UnexpectedError = /** @class */ (function (_super) {
+    __extends(UnexpectedError, _super);
+    function UnexpectedError(message) {
+        var _this = _super.call(this, spaceTrim(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                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\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
+ *
+ * - 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 checkSerializableAsJson(name, value) {
+    var e_1, _a;
+    if (value === undefined) {
+        throw new UnexpectedError("".concat(name, " is undefined"));
+    }
+    else if (value === null) {
+        return;
+    }
+    else if (typeof value === 'boolean') {
+        return;
+    }
+    else if (typeof value === 'number' && !isNaN(value)) {
+        return;
+    }
+    else if (typeof value === 'string') {
+        return;
+    }
+    else if (typeof value === 'symbol') {
+        throw new UnexpectedError("".concat(name, " is symbol"));
+    }
+    else if (typeof value === 'function') {
+        throw new UnexpectedError("".concat(name, " is function"));
+    }
+    else if (typeof value === 'object' && Array.isArray(value)) {
+        for (var i = 0; i < value.length; i++) {
+            checkSerializableAsJson("".concat(name, "[").concat(i, "]"), value[i]);
+        }
+    }
+    else if (typeof value === 'object') {
+        if (value instanceof Date) {
+            throw new UnexpectedError(spaceTrim$1("\n                    ".concat(name, " is Date\n\n                    Use `string_date_iso8601` instead\n                ")));
+        }
+        else if (value instanceof Map) {
+            throw new UnexpectedError("".concat(name, " is Map"));
+        }
+        else if (value instanceof Set) {
+            throw new UnexpectedError("".concat(name, " is Set"));
+        }
+        else if (value instanceof RegExp) {
+            throw new UnexpectedError("".concat(name, " is RegExp"));
+        }
+        else if (value instanceof Error) {
+            throw new UnexpectedError(spaceTrim$1("\n                    ".concat(name, " is unserialized Error\n\n                    Use function `serializeError`\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("".concat(name, ".").concat(subName), subValue);
+                }
+            }
+            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; }
+            }
+            try {
+                JSON.stringify(value); // <- TODO: [0]
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                            ".concat(name, " is not serializable\n\n                            ").concat(block(error.toString()), "\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 })));
+                    }
+                }
+            }
+            */
+            return;
+        }
+    }
+    else {
+        throw new UnexpectedError("".concat(name, " is unknown"));
+    }
+}
+/**
+ * TODO: [🧠][🛣] More elegant way to tracking than passing `name`
+ * TODO: [🧠] !!! 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
+ */
+
 /**
  * @@@
  * @@@
  *
  * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
  *
+ * @param name - Name of the object for debugging purposes
+ * @param objectValue - Object to be deeply frozen
  * @returns The same object as the input, but deeply frozen
  * @private this is in comparison to `deepFreeze` a more specific utility and maybe not very good practice to use without specific reason and considerations
  */
-function deepFreezeWithSameType(objectValue) {
+function $asDeeplyFrozenSerializableJson(name, objectValue) {
+    checkSerializableAsJson(name, objectValue);
     return $deepFreeze(objectValue);
 }
 /**
+ * TODO: [🧠][🛣] More elegant way to tracking than passing `name`
  * TODO: [🧠] Is there a way how to meaningfully test this utility
  */
 
-/**
- * Returns the same value that is passed as argument.
- * No side effects.
- *
- * Note: It can be usefull for:
- *
- * 1) Leveling indentation
- * 2) Putting always-true or always-false conditions without getting eslint errors
- *
- * @param value any values
- * @returns the same values
- * @private within the repository
- */
-function just(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value;
-}
-
 // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
 /**
  * The maximum number of iterations for a loops
@@ -243,7 +390,7 @@ var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
  *
  * @public exported from `@promptbook/core`
  */
-var RESERVED_PARAMETER_NAMES = $deepFreeze([
+var RESERVED_PARAMETER_NAMES = $asDeeplyFrozenSerializableJson('RESERVED_PARAMETER_NAMES', [
     'content',
     'context',
     'knowledge',
@@ -486,7 +633,7 @@ function pipelineJsonToString(pipelineJson) {
             pipelineString += '\n\n';
             pipelineString += '```' + contentLanguage;
             pipelineString += '\n';
-            pipelineString += spaceTrim(content);
+            pipelineString += spaceTrim$1(content);
             //                   <- TODO: !!! Escape
             //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
             pipelineString += '\n';
@@ -719,7 +866,7 @@ function forEachAsync(array, options, callbackfunction) {
     });
 }
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.66.0-9",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.66.0-9",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.66.0-9",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.66.0-9",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.67.0-0",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",dependentParameterNames:["knowledgeContent"],resultingParameterName:"knowledgePieces"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.67.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.67.0-0",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.67.0-0",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
 /**
  * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -753,22 +900,6 @@ var PipelineLogicError = /** @class */ (function (_super) {
     return PipelineLogicError;
 }(Error));
 
-/**
- * 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`
- */
-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                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
-        _this.name = 'UnexpectedError';
-        Object.setPrototypeOf(_this, UnexpectedError.prototype);
-        return _this;
-    }
-    return UnexpectedError;
-}(Error));
-
 /**
  * Tests if given string is valid semantic version
  *
@@ -954,36 +1085,36 @@ function validatePipeline(pipeline) {
     })();
     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                "); }));
+        throw new PipelineLogicError(spaceTrim(function (block) { return "\n                    Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     if (!isValidPromptbookVersion(pipeline.promptbookVersion)) {
         // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                    Invalid Promptbook Version \"".concat(pipeline.promptbookVersion, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+        throw new PipelineLogicError(spaceTrim(function (block) { return "\n                    Invalid Promptbook Version \"".concat(pipeline.promptbookVersion, "\"\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     // 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 ParsingError(spaceTrim$1(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+        throw new ParsingError(spaceTrim(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.parameters` expected to be an array, but got ".concat(typeof pipeline.parameters, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.promptTemplates)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParsingError(spaceTrim$1(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.promptTemplates` expected to be an array, but got ".concat(typeof pipeline.promptTemplates, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
+        throw new ParsingError(spaceTrim(function (block) { return "\n                    Promptbook is valid JSON but with wrong structure\n\n                    `promptbook.promptTemplates` expected to be an array, but got ".concat(typeof pipeline.promptTemplates, "\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
     }
     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                    "); }));
+            throw new PipelineLogicError(spaceTrim(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.promptTemplates.some(function (template) { return template.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                    "); }));
+            throw new PipelineLogicError(spaceTrim(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 template
         if (!parameter.isInput &&
             !pipeline.promptTemplates.some(function (template) { return template.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                        - Remove declaration of {").concat(parameter.name, "}\n                        - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+            throw new PipelineLogicError(spaceTrim(function (block) { return "\n                        Parameter {".concat(parameter.name, "} is declared but not defined\n\n                        You can do one of these:\n                        - Remove declaration of {").concat(parameter.name, "}\n                        - Add prompt template that results in -> {").concat(parameter.name, "}\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
         }
     };
     try {
@@ -1011,20 +1142,20 @@ function validatePipeline(pipeline) {
     var _loop_2 = function (template) {
         var e_4, _h, e_5, _j;
         if (definedParameters.has(template.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter {".concat(template.resultingParameterName, "} is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+            throw new PipelineLogicError(spaceTrim(function (block) { return "\n                        Parameter {".concat(template.resultingParameterName, "} is defined multiple times\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
         }
         if (RESERVED_PARAMETER_NAMES.includes(template.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                        Parameter name {".concat(template.resultingParameterName, "} is reserved, please use different name\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
+            throw new PipelineLogicError(spaceTrim(function (block) { return "\n                        Parameter name {".concat(template.resultingParameterName, "} is reserved, please use different name\n\n                        ").concat(block(pipelineIdentification), "\n                    "); }));
         }
         definedParameters.add(template.resultingParameterName);
         if (template.jokerParameterNames && template.jokerParameterNames.length > 0) {
             if (!template.expectFormat &&
                 !template.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(template.resultingParameterName, "} but no expectations are defined\n\n                            ").concat(block(pipelineIdentification), "\n                        "); }));
+                throw new PipelineLogicError(spaceTrim(function (block) { return "\n                            Joker parameters are used for {".concat(template.resultingParameterName, "} but no expectations are defined\n\n                            ").concat(block(pipelineIdentification), "\n                        "); }));
             }
             var _loop_4 = function (joker) {
                 if (!template.dependentParameterNames.includes(joker)) {
-                    throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n                                Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
+                    throw new PipelineLogicError(spaceTrim(function (block) { return "\n                                Parameter {".concat(joker, "} is used for {").concat(template.resultingParameterName, "} as joker but not in `dependentParameterNames`\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
                 }
             };
             try {
@@ -1044,13 +1175,13 @@ function validatePipeline(pipeline) {
         if (template.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                            "); }));
+                    throw new PipelineLogicError(spaceTrim(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                            "); }));
+                    throw new PipelineLogicError(spaceTrim(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                            "); }));
+                    throw new PipelineLogicError(spaceTrim(function (block) { return "\n                                Max expectation of ".concat(unit, " must be positive\n\n                                ").concat(block(pipelineIdentification), "\n                            "); }));
                 }
             };
             try {
@@ -1112,7 +1243,7 @@ function validatePipeline(pipeline) {
     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                    "); }));
+            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        Loop limit reached during detection of circular dependencies in `validatePipeline`\n\n                        ".concat(block(pipelineIdentification), "\n                    "); }));
         }
         var currentlyResovedTemplates = unresovedTemplates.filter(function (template) {
             return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
@@ -1120,7 +1251,7 @@ function validatePipeline(pipeline) {
         if (currentlyResovedTemplates.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                        Can not resolve:\n                        ".concat(block(unresovedTemplates
+            spaceTrim(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                        Can not resolve:\n                        ".concat(block(unresovedTemplates
                 .map(function (_a) {
                 var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
                 return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
@@ -1182,15 +1313,15 @@ var NotFoundError = /** @class */ (function (_super) {
  *
  * @public exported from `@promptbook/core`
  */
-var ReferenceError$1 = /** @class */ (function (_super) {
-    __extends(ReferenceError, _super);
-    function ReferenceError(message) {
+var PipelineUrlError = /** @class */ (function (_super) {
+    __extends(PipelineUrlError, _super);
+    function PipelineUrlError(message) {
         var _this = _super.call(this, message) || this;
-        _this.name = 'ReferenceError';
-        Object.setPrototypeOf(_this, ReferenceError.prototype);
+        _this.name = 'PipelineUrlError';
+        Object.setPrototypeOf(_this, PipelineUrlError.prototype);
         return _this;
     }
-    return ReferenceError;
+    return PipelineUrlError;
 }(Error));
 
 /**
@@ -1238,7 +1369,7 @@ function unpreparePipeline(pipeline) {
         delete promptTemplateUnprepared.preparedContent;
         return promptTemplateUnprepared;
     });
-    return __assign(__assign({}, pipeline), { promptTemplates: promptTemplates, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
+    return $asDeeplyFrozenSerializableJson('Unprepared PipelineJson', __assign(__assign({}, pipeline), { promptTemplates: promptTemplates, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] }));
 }
 /**
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
@@ -1274,7 +1405,7 @@ var SimplePipelineCollection = /** @class */ (function () {
                 var pipeline = pipelines_1_1.value;
                 // TODO: [👠] DRY
                 if (pipeline.pipelineUrl === undefined) {
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Pipeline with name \"".concat(pipeline.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines without URLs are called anonymous pipelines\n                              They can be used as standalone pipelines, but they cannot be referenced by other pipelines\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
+                    throw new PipelineUrlError(spaceTrim("\n                        Pipeline with name \"".concat(pipeline.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines without URLs are called anonymous pipelines\n                              They can be used as standalone pipelines, but they cannot be referenced by other pipelines\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
                 }
                 // Note: [🐨]
                 validatePipeline(pipeline);
@@ -1286,7 +1417,7 @@ var SimplePipelineCollection = /** @class */ (function () {
                     pipelineJsonToString(unpreparePipeline(pipeline)) !==
                         pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                     var existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection \uD83C\uDF4E\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                        Note: Pipelines with the same URL are not allowed\n                              Only exepction is when the pipelines are identical\n\n                    ")));
+                    throw new PipelineUrlError(spaceTrim("\n                        Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection \uD83C\uDF4E\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                        Note: Pipelines with the same URL are not allowed\n                              Only exepction is when the pipelines are identical\n\n                    ")));
                 }
                 // Note: [🧠] Overwrite existing pipeline with the same URL
                 this.collection.set(pipeline.pipelineUrl, pipeline);
@@ -1316,9 +1447,9 @@ var SimplePipelineCollection = /** @class */ (function () {
         var pipeline = this.collection.get(url);
         if (!pipeline) {
             if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim$1("\n                            Pipeline with url \"".concat(url, "\" not found\n\n                            No pipelines available\n                        ")));
+                throw new NotFoundError(spaceTrim("\n                            Pipeline with url \"".concat(url, "\" not found\n\n                            No pipelines available\n                        ")));
             }
-            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Pipeline with url \"".concat(url, "\" not found\n\n                        Available pipelines:\n                        ").concat(block(_this.listPipelines()
+            throw new NotFoundError(spaceTrim(function (block) { return "\n                        Pipeline with url \"".concat(url, "\" not found\n\n                        Available pipelines:\n                        ").concat(block(_this.listPipelines()
                 .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
                 .join('\n')), "\n\n                    "); }));
         }
@@ -1731,9 +1862,105 @@ var PipelineExecutionError = /** @class */ (function (_super) {
 }(Error));
 
 /**
- * Asserts that the execution of a promptnook is successful
+ * This error indicates that the pipeline collection cannot be propperly loaded
  *
- * @param executionResult - The partial result of the promptnook execution
+ * @public exported from `@promptbook/core`
+ */
+var CollectionError = /** @class */ (function (_super) {
+    __extends(CollectionError, _super);
+    function CollectionError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'CollectionError';
+        Object.setPrototypeOf(_this, CollectionError.prototype);
+        return _this;
+    }
+    return CollectionError;
+}(Error));
+
+/**
+ * This error type indicates that you try to use a feature that is not available in the current environment
+ *
+ * @public exported from `@promptbook/core`
+ */
+var EnvironmentMismatchError = /** @class */ (function (_super) {
+    __extends(EnvironmentMismatchError, _super);
+    function EnvironmentMismatchError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+        return _this;
+    }
+    return EnvironmentMismatchError;
+}(Error));
+
+/**
+ * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
+ */
+var LimitReachedError = /** @class */ (function (_super) {
+    __extends(LimitReachedError, _super);
+    function LimitReachedError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'LimitReachedError';
+        Object.setPrototypeOf(_this, LimitReachedError.prototype);
+        return _this;
+    }
+    return LimitReachedError;
+}(Error));
+
+/**
+ * This error type indicates that some part of the code is not implemented yet
+ *
+ * @public exported from `@promptbook/core`
+ */
+var NotYetImplementedError = /** @class */ (function (_super) {
+    __extends(NotYetImplementedError, _super);
+    function NotYetImplementedError(message) {
+        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+        _this.name = 'NotYetImplementedError';
+        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
+        return _this;
+    }
+    return NotYetImplementedError;
+}(Error));
+
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+var ERRORS = {
+    CollectionError: CollectionError,
+    EnvironmentMismatchError: EnvironmentMismatchError,
+    LimitReachedError: LimitReachedError,
+    NotFoundError: NotFoundError,
+    NotYetImplementedError: NotYetImplementedError,
+    ParsingError: ParsingError,
+    PipelineExecutionError: PipelineExecutionError,
+    PipelineLogicError: PipelineLogicError,
+    PipelineUrlError: PipelineUrlError,
+    UnexpectedError: UnexpectedError,
+    // TODO: [🪑]> VersionMismatchError,
+};
+
+/**
+ * Deserializes the error object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function deserializeError(error) {
+    if (error.name === 'Error') {
+        return new Error(error.message);
+    }
+    var CustomError = ERRORS[error.name];
+    return new CustomError(error.message);
+}
+
+/**
+ * Asserts that the execution of a Promptbook is successful
+ *
+ * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
  * @public exported from `@promptbook/core`
  */
@@ -1743,15 +1970,16 @@ function assertsExecutionSuccessful(executionResult) {
         return;
     }
     if (errors.length === 0) {
-        throw new PipelineExecutionError("Promptnook Execution failed because of unknown reason");
+        throw new PipelineExecutionError("Promptbook Execution failed because of unknown reason");
     }
     else if (errors.length === 1) {
-        throw errors[0];
+        throw deserializeError(errors[0]);
     }
     else {
-        throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors
-            .map(function (error, index) {
-            return spaceTrim$1(function (block) { return "\n                                        Error ".concat(index + 1, ":\n                                        ").concat(block(error.stack || error.message), "\n                                    "); });
+        throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                    Multiple errors occurred during Promptbook execution\n\n                    ".concat(block(errors
+            .map(function (_a, index) {
+            var name = _a.name, stack = _a.stack, message = _a.message;
+            return spaceTrim(function (block) { return "\n                                        ".concat(name, " ").concat(index + 1, ":\n                                        ").concat(block(stack || message), "\n                                    "); });
         })
             .join('\n')), "\n                "); }));
     }
@@ -1783,7 +2011,7 @@ function extractVariables(script) {
                 var undefinedName = error.message.split(' ')[0];
                 /*
                 Note: Parsing the error
-                      [ReferenceError: thing is not defined]
+                      [PipelineUrlError: thing is not defined]
                 */
                 if (!undefinedName) {
                     throw error;
@@ -1801,7 +2029,7 @@ function extractVariables(script) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new ParsingError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.name), ": ").concat(block(error.message), "\n                "); }));
+        throw new ParsingError(spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.toString()), "}\n                "); }));
     }
     return variables;
 }
@@ -1888,6 +2116,23 @@ var ExpectError = /** @class */ (function (_super) {
     return ExpectError;
 }(Error));
 
+/**
+ * Serializes an error into a [🚉] JSON-serializable object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function serializeError(error) {
+    var name = error.name, message = error.message, stack = error.stack;
+    if (!__spreadArray(['Error'], __read(Object.keys(ERRORS)), false).includes(name)) {
+        throw new UnexpectedError(spaceTrim$1(function (block) { return "\n          \n                    Cannot serialize error with name \"".concat(name, "\"\n\n                    ").concat(block(stack || message), "\n                \n                "); }));
+    }
+    return {
+        name: name,
+        message: message,
+        stack: stack,
+    };
+}
+
 /**
  * Function isValidJsonString will tell you if the string is valid JSON or not
  *
@@ -2127,7 +2372,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
                             //     1) OpenAI throw PipelineExecutionError: Parameter {knowledge} is not defined
                             //     2) AnthropicClaude throw PipelineExecutionError: Parameter {knowledge} is not defined
                             //     3) ...
-                            spaceTrim(function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors
+                            spaceTrim$1(function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors
                                 .map(function (error, i) { return "".concat(i + 1, ") **").concat(error.name || 'Error', ":** ").concat(error.message); })
                                 .join('\n')), "\n\n                    "); }));
                         }
@@ -2135,7 +2380,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
                             throw new PipelineExecutionError("You have not provided any `LlmExecutionTools`");
                         }
                         else {
-                            throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                          You have not provided any `LlmExecutionTools` that support model variant \"".concat(prompt.modelRequirements.modelVariant, "\n\n                          Available `LlmExecutionTools`:\n                          ").concat(block(_this.llmExecutionTools
+                            throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                          You have not provided any `LlmExecutionTools` that support model variant \"".concat(prompt.modelRequirements.modelVariant, "\n\n                          Available `LlmExecutionTools`:\n                          ").concat(block(_this.llmExecutionTools
                                 .map(function (tools) { return "- ".concat(tools.title, " ").concat(tools.description || ''); })
                                 .join('\n')), "\n\n                    "); }));
                         }
@@ -2172,7 +2417,7 @@ function joinLlmExecutionTools() {
         llmExecutionTools[_i] = arguments[_i];
     }
     if (llmExecutionTools.length === 0) {
-        var warningMessage = spaceTrim("\n            You have not provided any `LlmExecutionTools`\n            This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.\n\n            Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.\n        ");
+        var warningMessage = spaceTrim$1("\n            You have not provided any `LlmExecutionTools`\n            This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.\n\n            Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.\n        ");
         // TODO: [🟥] Detect browser / node and make it colorfull
         console.warn(warningMessage);
         /*
@@ -2225,6 +2470,7 @@ function isPipelinePrepared(pipeline) {
     return true;
 }
 /**
+ * TODO: [🔃] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
  * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
@@ -2269,22 +2515,6 @@ function TODO_USE() {
     }
 }
 
-/**
- * This error type indicates that some limit was reached
- *
- * @public exported from `@promptbook/core`
- */
-var LimitReachedError = /** @class */ (function (_super) {
-    __extends(LimitReachedError, _super);
-    function LimitReachedError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'LimitReachedError';
-        Object.setPrototypeOf(_this, LimitReachedError.prototype);
-        return _this;
-    }
-    return LimitReachedError;
-}(Error));
-
 /**
  * Replaces parameters in template with values from parameters object
  *
@@ -2584,7 +2814,7 @@ function createPipelineExecutor(options) {
         preparedPipeline = pipeline;
     }
     else if (isNotPreparedWarningSupressed !== true) {
-        console.warn(spaceTrim$1("\n                Pipeline ".concat(pipeline.pipelineUrl || pipeline.sourceFile || pipeline.title, " is not prepared\n\n                ").concat(pipeline.sourceFile, "\n\n                It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                But it is recommended to prepare the pipeline during collection preparation\n\n                @see more at https://ptbk.io/prepare-pipeline\n            ")));
+        console.warn(spaceTrim("\n                Pipeline ".concat(pipeline.pipelineUrl || pipeline.sourceFile || pipeline.title, " is not prepared\n\n                ").concat(pipeline.sourceFile, "\n\n                It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                But it is recommended to prepare the pipeline during collection preparation\n\n                @see more at https://ptbk.io/prepare-pipeline\n            ")));
     }
     var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
         // TODO: !!! Extract to separate functions and files - ALL FUNCTIONS BELOW
@@ -2670,7 +2900,6 @@ function createPipelineExecutor(options) {
             return __awaiter(this, void 0, void 0, function () {
                 var name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _d, _e, parameterName, prompt, chatResult, completionResult, embeddingResult, result, resultString, expectError, scriptPipelineExecutionErrors, maxAttempts, jokerParameterNames, preparedContent, attempt, isJokerAttempt, jokerParameterName, _f, _g, _h, _j, scriptTools, error_2, e_4_1, _k, _l, functionName, postprocessingError, _m, _o, scriptTools, error_3, e_5_1, e_6_1, error_4;
                 var e_7, _p, e_4, _q, e_6, _r, e_5, _s, _t;
-                var _this = this;
                 return __generator(this, function (_u) {
                     switch (_u.label) {
                         case 0:
@@ -2695,7 +2924,7 @@ function createPipelineExecutor(options) {
                             usedParameterNames = extractParameterNamesFromPromptTemplate(currentTemplate);
                             dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
                             if (union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)).size !== 0) {
-                                throw new UnexpectedError(spaceTrim$1("\n                        Dependent parameters are not consistent used parameters:\n\n                        Dependent parameters:\n                        ".concat(Array.from(dependentParameterNames).join(', '), "\n\n                        Used parameters:\n                        ").concat(Array.from(usedParameterNames).join(', '), "\n\n                    ")));
+                                throw new UnexpectedError(spaceTrim("\n                        Dependent parameters are not consistent used parameters:\n\n                        Dependent parameters:\n                        ".concat(Array.from(dependentParameterNames).join(', '), "\n\n                        Used parameters:\n                        ").concat(Array.from(usedParameterNames).join(', '), "\n\n                    ")));
                             }
                             _b = (_a = Object).freeze;
                             _c = [{}];
@@ -2720,7 +2949,7 @@ function createPipelineExecutor(options) {
                                     else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
                                         // Houston, we have a problem
                                         // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-                                        throw new UnexpectedError(spaceTrim$1("\n                            Parameter {".concat(parameterName, "} is NOT defined\n                            BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                            This should be catched in `validatePipeline`\n\n                        ")));
+                                        throw new UnexpectedError(spaceTrim("\n                            Parameter {".concat(parameterName, "} is NOT defined\n                            BUT used in template \"").concat(currentTemplate.title || currentTemplate.name, "\"\n\n                            This should be catched in `validatePipeline`\n\n                        ")));
                                     }
                                 }
                             }
@@ -2791,71 +3020,8 @@ function createPipelineExecutor(options) {
                                     return name === currentTemplate.personaName;
                                 }) || {})), currentTemplate.expectations),
                                 expectFormat: currentTemplate.expectFormat,
-                                postprocessing: (currentTemplate.postprocessingFunctionNames || []).map(function (functionName) { return function (result) { return __awaiter(_this, void 0, void 0, function () {
-                                    var errors, _a, _b, scriptTools, error_5, e_8_1;
-                                    var e_8, _c;
-                                    return __generator(this, function (_d) {
-                                        switch (_d.label) {
-                                            case 0:
-                                                errors = [];
-                                                _d.label = 1;
-                                            case 1:
-                                                _d.trys.push([1, 8, 9, 10]);
-                                                _a = __values(arrayableToArray(tools.script)), _b = _a.next();
-                                                _d.label = 2;
-                                            case 2:
-                                                if (!!_b.done) return [3 /*break*/, 7];
-                                                scriptTools = _b.value;
-                                                _d.label = 3;
-                                            case 3:
-                                                _d.trys.push([3, 5, , 6]);
-                                                return [4 /*yield*/, scriptTools.execute({
-                                                        scriptLanguage: "javascript" /* <- TODO: Try it in each languages; In future allow postprocessing with arbitrary combination of languages to combine */,
-                                                        script: "".concat(functionName, "(result)"),
-                                                        parameters: {
-                                                            result: result || '',
-                                                            // Note: No ...parametersForTemplate, because working with result only
-                                                        },
-                                                    })];
-                                            case 4: return [2 /*return*/, _d.sent()];
-                                            case 5:
-                                                error_5 = _d.sent();
-                                                if (!(error_5 instanceof Error)) {
-                                                    throw error_5;
-                                                }
-                                                if (error_5 instanceof UnexpectedError) {
-                                                    throw error_5;
-                                                }
-                                                errors.push(error_5);
-                                                return [3 /*break*/, 6];
-                                            case 6:
-                                                _b = _a.next();
-                                                return [3 /*break*/, 2];
-                                            case 7: return [3 /*break*/, 10];
-                                            case 8:
-                                                e_8_1 = _d.sent();
-                                                e_8 = { error: e_8_1 };
-                                                return [3 /*break*/, 10];
-                                            case 9:
-                                                try {
-                                                    if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
-                                                }
-                                                finally { if (e_8) throw e_8.error; }
-                                                return [7 /*endfinally*/];
-                                            case 10:
-                                                if (errors.length === 0) {
-                                                    throw new PipelineExecutionError('Postprocessing in LlmExecutionTools failed because no ScriptExecutionTools were provided');
-                                                }
-                                                else if (errors.length === 1) {
-                                                    throw errors[0];
-                                                }
-                                                else {
-                                                    throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                                        Postprocessing in LlmExecutionTools failed ".concat(errors.length, "x\n\n                                                        ").concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n\n')), "\n                                                      "); }));
-                                                }
-                                        }
-                                    });
-                                }); }; }),
-                            };
+                                postprocessingFunctionNames: currentTemplate.postprocessingFunctionNames,
+                            }; // <- TODO: Not very good type guard
                             _g = currentTemplate.modelRequirements.modelVariant;
                             switch (_g) {
                                 case 'CHAT': return [3 /*break*/, 8];
@@ -2944,7 +3110,7 @@ function createPipelineExecutor(options) {
                                 throw scriptPipelineExecutionErrors[0];
                             }
                             else {
-                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                                              Script execution failed ".concat(scriptPipelineExecutionErrors.length, " times\n\n                                              ").concat(block(scriptPipelineExecutionErrors
+                                throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                                              Script execution failed ".concat(scriptPipelineExecutionErrors.length, " times\n\n                                              ").concat(block(scriptPipelineExecutionErrors
                                     .map(function (error) { return '- ' + error.message; })
                                     .join('\n\n')), "\n                                          "); }));
                             }
@@ -3080,13 +3246,13 @@ function createPipelineExecutor(options) {
                                 executionReport.promptExecutions.push({
                                     prompt: __assign({}, prompt),
                                     result: result || undefined,
-                                    error: expectError || undefined,
+                                    error: expectError === null ? undefined : serializeError(expectError),
                                 });
                             }
                             return [7 /*endfinally*/];
                         case 50:
                             if (expectError !== null && attempt === maxAttempts - 1) {
-                                throw new PipelineExecutionError(spaceTrim$1(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ---\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block((expectError === null || expectError === void 0 ? void 0 : expectError.message) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
+                                throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                              LLM execution failed ".concat(maxExecutionAttempts, "x\n\n                              ---\n                              Last error ").concat((expectError === null || expectError === void 0 ? void 0 : expectError.name) || '', ":\n                              ").concat(block((expectError === null || expectError === void 0 ? void 0 : expectError.message) || ''), "\n\n                              Last result:\n                              ").concat(resultString, "\n                              ---\n                          "); }));
                             }
                             _u.label = 51;
                         case 51:
@@ -3115,7 +3281,7 @@ function createPipelineExecutor(options) {
             });
         }
         function filterJustOutputParameters() {
-            var e_9, _a;
+            var e_8, _a;
             var outputParameters = {};
             try {
                 // Note: Filter ONLY output parameters
@@ -3132,12 +3298,12 @@ function createPipelineExecutor(options) {
                     outputParameters[parameter.name] = parametersToPass[parameter.name] || '';
                 }
             }
-            catch (e_9_1) { e_9 = { error: e_9_1 }; }
+            catch (e_8_1) { e_8 = { error: e_8_1 }; }
             finally {
                 try {
                     if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
                 }
-                finally { if (e_9) throw e_9.error; }
+                finally { if (e_8) throw e_8.error; }
             }
             return outputParameters;
         }
@@ -3174,11 +3340,11 @@ function createPipelineExecutor(options) {
                         })), _b = _a.next(); !_b.done; _b = _a.next()) {
                             parameter = _b.value;
                             if (inputParameters[parameter.name] === undefined) {
-                                return [2 /*return*/, deepFreezeWithSameType({
+                                return [2 /*return*/, $asDeeplyFrozenSerializableJson("Unuccessful PipelineExecutorResult (with missing parameter {".concat(parameter.name, "}) PipelineExecutorResult"), {
                                         isSuccessful: false,
                                         errors: __spreadArray([
                                             new PipelineExecutionError("Parameter {".concat(parameter.name, "} is required as an input parameter"))
-                                        ], __read(errors), false),
+                                        ], __read(errors), false).map(serializeError),
                                         warnings: [],
                                         executionReport: executionReport,
                                         outputParameters: {},
@@ -3204,12 +3370,12 @@ function createPipelineExecutor(options) {
                             warnings.push(new PipelineExecutionError("Extra parameter {".concat(parameterName, "} is being passed which is not part of the pipeline.")));
                         }
                         else if (parameter.isInput === false) {
-                            return { value: deepFreezeWithSameType({
+                            return { value: $asDeeplyFrozenSerializableJson("Unuccessful PipelineExecutorResult (with extra parameter {".concat(parameter.name, "}) PipelineExecutorResult"), {
                                     isSuccessful: false,
                                     errors: __spreadArray([
                                         new PipelineExecutionError("Parameter {".concat(parameter.name, "} is passed as input parameter but it is not input"))
-                                    ], __read(errors), false),
-                                    warnings: warnings,
+                                    ], __read(errors), false).map(serializeError),
+                                    warnings: warnings.map(serializeError),
                                     executionReport: executionReport,
                                     outputParameters: {},
                                     usage: ZERO_USAGE,
@@ -3266,7 +3432,7 @@ function createPipelineExecutor(options) {
                                     if (!(!currentTemplate && resolving_1.length === 0)) return [3 /*break*/, 1];
                                     throw new UnexpectedError(
                                     // TODO: [🐎] DRY
-                                    spaceTrim$1(function (block) { return "\n                                Can not resolve some parameters:\n\n                                Can not resolve:\n                                ".concat(block(unresovedTemplates_1
+                                    spaceTrim(function (block) { return "\n                                Can not resolve some parameters:\n\n                                Can not resolve:\n                                ".concat(block(unresovedTemplates_1
                                         .map(function (_a) {
                                         var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
                                         return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
@@ -3316,10 +3482,10 @@ function createPipelineExecutor(options) {
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
                     outputParameters_1 = filterJustOutputParameters();
-                    return [2 /*return*/, deepFreezeWithSameType({
+                    return [2 /*return*/, $asDeeplyFrozenSerializableJson('Unuccessful PipelineExecutorResult (with misc errors) PipelineExecutorResult', {
                             isSuccessful: false,
-                            errors: __spreadArray([error_1], __read(errors), false),
-                            warnings: warnings,
+                            errors: __spreadArray([error_1], __read(errors), false).map(serializeError),
+                            warnings: warnings.map(serializeError),
                             usage: usage_1,
                             executionReport: executionReport,
                             outputParameters: outputParameters_1,
@@ -3331,10 +3497,10 @@ function createPipelineExecutor(options) {
                         return (result === null || result === void 0 ? void 0 : result.usage) || ZERO_USAGE;
                     })), false));
                     outputParameters = filterJustOutputParameters();
-                    return [2 /*return*/, deepFreezeWithSameType({
+                    return [2 /*return*/, $asDeeplyFrozenSerializableJson('Successful PipelineExecutorResult', {
                             isSuccessful: true,
-                            errors: errors,
-                            warnings: warnings,
+                            errors: errors.map(serializeError),
+                            warnings: warnings.map(serializeError),
                             usage: usage,
                             executionReport: executionReport,
                             outputParameters: outputParameters,
@@ -3420,8 +3586,8 @@ function prepareKnowledgeFromMarkdown(knowledgeContent /* <- TODO: [🖖] (?mayb
                                 switch (_c.label) {
                                     case 0:
                                         name = "piece-".concat(i);
-                                        title = spaceTrim(knowledgeTextPiece.substring(0, 100));
-                                        knowledgePieceContent = spaceTrim(knowledgeTextPiece);
+                                        title = spaceTrim$1(knowledgeTextPiece.substring(0, 100));
+                                        knowledgePieceContent = spaceTrim$1(knowledgeTextPiece);
                                         keywords = [];
                                         index = [];
                                         _c.label = 1;
@@ -3431,7 +3597,7 @@ function prepareKnowledgeFromMarkdown(knowledgeContent /* <- TODO: [🖖] (?mayb
                                     case 2:
                                         titleResult = _c.sent();
                                         _a = titleResult.outputParameters.title, titleRaw = _a === void 0 ? 'Untitled' : _a;
-                                        title = spaceTrim(titleRaw) /* <- TODO: Maybe do in pipeline */;
+                                        title = spaceTrim$1(titleRaw) /* <- TODO: Maybe do in pipeline */;
                                         name = titleToName(title);
                                         return [4 /*yield*/, prepareKeywordsExecutor({ knowledgePieceContent: knowledgePieceContent })];
                                     case 3:
@@ -3704,6 +3870,7 @@ function preparePersona(personaDescription, options) {
     });
 }
 /**
+ * TODO: [🔃] !!!!! If the persona was prepared with different version or different set of models, prepare it once again
  * TODO: [🏢] !! Check validity of `modelName` in pipeline
  * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
  * TODO: [🏢] !! Check validity of `temperature` in pipeline
@@ -3763,7 +3930,7 @@ function prepareTemplates(pipeline, options) {
                                 dependentParameterNames = template.dependentParameterNames;
                                 preparedContent = undefined;
                                 if (knowledgePiecesCount > 0 && !dependentParameterNames.includes('knowledge')) {
-                                    preparedContent = spaceTrim$1("\n                    {content}\n\n                    ## Knowledge\n\n                    {knowledge}\n                ");
+                                    preparedContent = spaceTrim("\n                    {content}\n\n                    ## Knowledge\n\n                    {knowledge}\n                ");
                                     // <- TODO: [🧠][🧻] Cutomize shape/language/formatting of the addition to the prompt
                                     dependentParameterNames = __spreadArray(__spreadArray([], __read(dependentParameterNames), false), [
                                         'knowledge',
@@ -3804,7 +3971,7 @@ function preparePipeline(pipeline, options) {
     return __awaiter(this, void 0, void 0, function () {
         var llmTools, _a, maxParallelCount, _b, isVerbose, parameters, promptTemplates, 
         /*
-        <- TODO: [🧠][0] `promptbookVersion` */
+        <- TODO: [🧠][🪑] `promptbookVersion` */
         knowledgeSources /*
         <- TODO: [🧊] `knowledgePieces` */, personas /*
         <- TODO: [🧊] `preparations` */, llmToolsWithUsage, currentPreparation, preparations, preparedPersonas, knowledgeSourcesPrepared, partialknowledgePiecesPrepared, knowledgePiecesPrepared, promptTemplatesPrepared /* TODO: parameters: parametersPrepared*/;
@@ -3874,7 +4041,7 @@ function preparePipeline(pipeline, options) {
                     // ----- /Templates preparation -----
                     // Note: Count total usage
                     currentPreparation.usage = llmToolsWithUsage.getTotalUsage();
-                    return [2 /*return*/, __assign(__assign({}, clonePipeline(pipeline)), { promptTemplates: promptTemplatesPrepared, knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations })];
+                    return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { promptTemplates: promptTemplatesPrepared, knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations }))];
             }
         });
     });
@@ -3950,7 +4117,7 @@ var knowledgeCommandParser = {
      */
     parse: function (input) {
         var args = input.args;
-        var sourceContent = spaceTrim(args[0] || '');
+        var sourceContent = spaceTrim$1(args[0] || '');
         if (sourceContent === '') {
             throw new ParsingError("Source is not defined");
         }
@@ -4066,8 +4233,8 @@ var personaCommandParser = {
             persona.description = personaDescription;
             return;
         }
-        console.warn(spaceTrim("\n\n                Persona \"".concat(personaName, "\" is defined multiple times with different description:\n\n                First definition:\n                ").concat(persona.description, "\n\n                Second definition:\n                ").concat(personaDescription, "\n\n            ")));
-        persona.description += spaceTrim('\n\n' + personaDescription);
+        console.warn(spaceTrim$1("\n\n                Persona \"".concat(personaName, "\" is defined multiple times with different description:\n\n                First definition:\n                ").concat(persona.description, "\n\n                Second definition:\n                ").concat(personaDescription, "\n\n            ")));
+        persona.description += spaceTrim$1('\n\n' + personaDescription);
     },
 };
 
@@ -4254,7 +4421,7 @@ var blockCommandParser = {
         normalized = normalized.split('EXAMPLE').join('SAMPLE');
         var blockTypes = BlockTypes.filter(function (blockType) { return normalized.includes(blockType); });
         if (blockTypes.length !== 1) {
-            throw new ParsingError(spaceTrim(function (block) { return "\n                        Unknown block type in BLOCK command\n\n                        Supported block types are:\n                        ".concat(block(BlockTypes.join(', ')), "\n                    "); }));
+            throw new ParsingError(spaceTrim$1(function (block) { return "\n                        Unknown block type in BLOCK command\n\n                        Supported block types are:\n                        ".concat(block(BlockTypes.join(', ')), "\n                    "); }));
         }
         var blockType = blockTypes[0];
         return {
@@ -4361,7 +4528,7 @@ var expectCommandParser = {
     /**
      * Description of the EXPECT command
      */
-    description: spaceTrim("\n        Expect command describes the desired output of the prompt template (after post-processing)\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
+    description: spaceTrim$1("\n        Expect command describes the desired output of the prompt template (after post-processing)\n        It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.\n    "),
     /**
      * Link to discussion
      */
@@ -4454,7 +4621,7 @@ var expectCommandParser = {
             if (!(error instanceof Error)) {
                 throw error;
             }
-            throw new ParsingError(spaceTrim(function (block) {
+            throw new ParsingError(spaceTrim$1(function (block) {
                 return "\n                            Invalid EXPECT command\n                            ".concat(block(error.message), ":\n                        ");
             }));
         }
@@ -4573,7 +4740,7 @@ var modelCommandParser = {
                 // <- Note: [🤖]
             }
             else {
-                throw new ParsingError(spaceTrim(function (block) { return "\n                            Unknown model variant in command:\n\n                            Supported variants are:\n                            ".concat(block(MODEL_VARIANTS.map(function (variantName) { return "- ".concat(variantName); }).join('\n')), "\n                        "); }));
+                throw new ParsingError(spaceTrim$1(function (block) { return "\n                            Unknown model variant in command:\n\n                            Supported variants are:\n                            ".concat(block(MODEL_VARIANTS.map(function (variantName) { return "- ".concat(variantName); }).join('\n')), "\n                        "); }));
             }
         }
         if (normalized.startsWith('MODEL_NAME')) {
@@ -4584,7 +4751,7 @@ var modelCommandParser = {
             };
         }
         else {
-            throw new ParsingError(spaceTrim(function (block) { return "\n                    Unknown model key in command.\n\n                    Supported model keys are:\n                    ".concat(block(['variant', 'name'].join(', ')), "\n\n                    Example:\n\n                    - MODEL VARIANT Chat\n                    - MODEL NAME gpt-4\n              "); }));
+            throw new ParsingError(spaceTrim$1(function (block) { return "\n                    Unknown model key in command.\n\n                    Supported model keys are:\n                    ".concat(block(['variant', 'name'].join(', ')), "\n\n                    Example:\n\n                    - MODEL VARIANT Chat\n                    - MODEL NAME gpt-4\n              "); }));
         }
     },
 };
@@ -5043,7 +5210,7 @@ function parseCommand(raw, usagePlace) {
         .map(removeMarkdownFormatting)
         .map(function (item) { return item.trim(); });
     if (items.length === 0 || items[0] === '') {
-        throw new ParsingError(spaceTrim$1(function (block) {
+        throw new ParsingError(spaceTrim(function (block) {
             return "\n                        Malformed command:\n\n                        - ".concat(raw, "\n\n                        Supported commands are:\n                        ").concat(block(getSupportedCommandsMessage()), "\n\n                    ");
         }));
     }
@@ -5070,7 +5237,7 @@ function parseCommand(raw, usagePlace) {
             return command;
         }
     }
-    throw new ParsingError(spaceTrim$1(function (block) {
+    throw new ParsingError(spaceTrim(function (block) {
         return "\n                  Malformed or unknown command:\n\n                  - ".concat(raw, "\n\n                  Supported commands are:\n                  ").concat(block(getSupportedCommandsMessage()), "\n\n              ");
     }));
 }
@@ -5103,7 +5270,7 @@ function parseCommandVariant(input) {
                 if (!(error instanceof ParsingError)) {
                     throw error;
                 }
-                throw new ParsingError(spaceTrim$1(function (block) {
+                throw new ParsingError(spaceTrim(function (block) {
                     return "\n                              Invalid ".concat(commandName, " command:\n                              ").concat(block(error.message), "\n\n                              - ").concat(raw, "\n\n                              Usage of ").concat(commandName, ":\n                              ").concat(block(commandParser.examples.map(function (example) { return "- ".concat(example); }).join('\n')), "\n\n                              All supported commands are:\n                              ").concat(block(getSupportedCommandsMessage()), "\n\n                          ");
                 }));
             }
@@ -5130,22 +5297,6 @@ function parseCommandVariant(input) {
     return null;
 }
 
-/**
- * This error type indicates that some part of the code is not implemented yet
- *
- * @public exported from `@promptbook/core`
- */
-var NotYetImplementedError = /** @class */ (function (_super) {
-    __extends(NotYetImplementedError, _super);
-    function NotYetImplementedError(message) {
-        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
-        _this.name = 'NotYetImplementedError';
-        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
-        return _this;
-    }
-    return NotYetImplementedError;
-}(Error));
-
 /**
  * Supported script languages
  *
@@ -5285,7 +5436,7 @@ function extractAllBlocksFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     var codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParsingError(spaceTrim(function (block) { return "\n                    There should be exactly 1 code block, found ".concat(codeBlocks.length, " code blocks\n\n                    ").concat(block(codeBlocks.map(function (block, i) { return "Block ".concat(i + 1, ":\n").concat(block.content); }).join('\n\n\n')), "\n                "); }));
+        throw new ParsingError(spaceTrim$1(function (block) { return "\n                    There should be exactly 1 code block, found ".concat(codeBlocks.length, " code blocks\n\n                    ").concat(block(codeBlocks.map(function (block, i) { return "Block ".concat(i + 1, ":\n").concat(block.content); }).join('\n\n\n')), "\n                "); }));
     }
     return codeBlocks[0];
 }
@@ -5306,7 +5457,7 @@ function parseMarkdownSection(value) {
     }
     var title = lines[0].replace(/^#+\s*/, '');
     var level = (_b = (_a = lines[0].match(/^#+/)) === null || _a === void 0 ? void 0 : _a[0].length) !== null && _b !== void 0 ? _b : 0;
-    var content = spaceTrim(lines.slice(1).join('\n'));
+    var content = spaceTrim$1(lines.slice(1).join('\n'));
     if (level < 1 || level > 6) {
         throw new ParsingError('Markdown section must have heading level between 1 and 6');
     }
@@ -5334,7 +5485,7 @@ function splitMarkdownIntoSections(markdown) {
         if (buffer.length === 0) {
             return;
         }
-        var section = spaceTrim(buffer.join('\n'));
+        var section = spaceTrim$1(buffer.join('\n'));
         if (section === '') {
             return;
         }
@@ -5430,7 +5581,7 @@ function flattenMarkdown(markdown) {
         }
         finally { if (e_1) throw e_1.error; }
     }
-    return spaceTrim(flattenedMarkdown);
+    return spaceTrim$1(flattenedMarkdown);
 }
 /**
  * TODO: [🏛] This can be part of markdown builder
@@ -5448,7 +5599,7 @@ function flattenMarkdown(markdown) {
  * @public exported from `@promptbook/markdown-utils`
  */
 function removeContentComments(content) {
-    return spaceTrim$1(content.replace(/<!--(.*?)-->/gs, ''));
+    return spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
 }
 
 /**
@@ -5489,13 +5640,13 @@ function pipelineStringToJsonSync(pipelineString) {
     pipelineString = pipelineString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
     var _c = __read(splitMarkdownIntoSections(pipelineString).map(parseMarkdownSection)), pipelineHead = _c[0], pipelineSections = _c.slice(1); /* <- Note: [🥞] */
     if (pipelineHead === undefined) {
-        throw new UnexpectedError(spaceTrim$1("\n                Pipeline head is not defined\n\n                This should never happen, because the pipeline already flattened\n            "));
+        throw new UnexpectedError(spaceTrim("\n                Pipeline head is not defined\n\n                This should never happen, because the pipeline already flattened\n            "));
     }
     if (pipelineHead.level !== 1) {
-        throw new UnexpectedError(spaceTrim$1("\n                Pipeline head is not h1\n\n                This should never happen, because the pipeline already flattened\n            "));
+        throw new UnexpectedError(spaceTrim("\n                Pipeline head is not h1\n\n                This should never happen, because the pipeline already flattened\n            "));
     }
     if (!pipelineSections.every(function (section) { return section.level === 2; })) {
-        throw new UnexpectedError(spaceTrim$1("\n                Not every pipeline section is h2\n\n                This should never happen, because the pipeline already flattened\n            "));
+        throw new UnexpectedError(spaceTrim("\n                Not every pipeline section is h2\n\n                This should never happen, because the pipeline already flattened\n            "));
     }
     // =============================================================
     ///Note: 2️⃣ Function for defining parameters
@@ -5509,7 +5660,7 @@ function pipelineStringToJsonSync(pipelineString) {
             existingParameter.description &&
             existingParameter.description !== parameterDescription &&
             parameterDescription) {
-            throw new ParsingError(spaceTrim$1(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description:\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
+            throw new ParsingError(spaceTrim(function (block) { return "\n                        Parameter {".concat(parameterName, "} is defined multiple times with different description:\n\n                        First definition:\n                        ").concat(block(existingParameter.description || '[undefined]'), "\n\n                        Second definition:\n                        ").concat(block(parameterDescription || '[undefined]'), "\n                    "); }));
         }
         if (existingParameter) {
             if (parameterDescription) {
@@ -5535,7 +5686,7 @@ function pipelineStringToJsonSync(pipelineString) {
     description = description.split(/^>.*$/gm).join('');
     //Note: Remove lists and return statement - TODO: [🎾] Make util  (exported from `@promptbool/utils`)
     description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-    description = spaceTrim$1(description);
+    description = spaceTrim(description);
     if (description === '') {
         description = undefined;
     }
@@ -5606,7 +5757,7 @@ function pipelineStringToJsonSync(pipelineString) {
             if (resultingParameterName !== null) {
                 return resultingParameterName;
             }
-            throw new ParsingError(spaceTrim$1(function (block) { return "\n                    Template section must end with -> {parameterName}\n\n                    Invalid section:\n                    ".concat(block(
+            throw new ParsingError(spaceTrim(function (block) { return "\n                    Template section must end with -> {parameterName}\n\n                    Invalid section:\n                    ".concat(block(
             // TODO: Show code of invalid sections each time + DRY
             section.content
                 .split('\n')
@@ -5621,7 +5772,7 @@ function pipelineStringToJsonSync(pipelineString) {
         description_1 = description_1.split(/^>.*$/gm).join('');
         //Note: Remove lists and return statement - TODO: [🎾]
         description_1 = description_1.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description_1 = spaceTrim$1(description_1);
+        description_1 = spaceTrim(description_1);
         if (description_1 === '') {
             description_1 = undefined;
         }
@@ -5705,7 +5856,7 @@ function pipelineStringToJsonSync(pipelineString) {
                         break;
                     case 'EXPECT_FORMAT':
                         if (templateJson.expectFormat !== undefined && command.format !== templateJson.expectFormat) {
-                            throw new ParsingError(spaceTrim$1("\n                                Expect format is already defined to \"".concat(templateJson.expectFormat, "\".\n                                Now you try to redefine it by \"").concat(command.format, "\".\n                            ")));
+                            throw new ParsingError(spaceTrim("\n                                Expect format is already defined to \"".concat(templateJson.expectFormat, "\".\n                                Now you try to redefine it by \"").concat(command.format, "\".\n                            ")));
                         }
                         templateJson.expectFormat = command.format;
                         break;
@@ -5762,7 +5913,7 @@ function pipelineStringToJsonSync(pipelineString) {
                 throw new ParsingError('You must specify the language of the script in the prompt template');
             }
             if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                throw new ParsingError(spaceTrim$1(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
+                throw new ParsingError(spaceTrim(function (block) { return "\n                            Script language ".concat(language, " is not supported.\n\n                            Supported languages are:\n                            ").concat(block(SUPPORTED_SCRIPT_LANGUAGES.join(', ')), "\n\n                        "); }));
             }
             templateJson.contentLanguage = language;
         }
@@ -5837,7 +5988,7 @@ function pipelineStringToJsonSync(pipelineString) {
         }
     });
     // =============================================================
-    return pipelineJson;
+    return $asDeeplyFrozenSerializableJson('pipelineJson', pipelineJson);
 }
 /**
  * TODO: !!!! Warn if used only sync version
@@ -5881,7 +6032,9 @@ function pipelineStringToJson(pipelineString, options) {
                 case 1:
                     pipelineJson = _a.sent();
                     _a.label = 2;
-                case 2: return [2 /*return*/, pipelineJson];
+                case 2: 
+                // Note: No need to use `$asDeeplyFrozenSerializableJson` because `pipelineStringToJsonSync` and `preparePipeline` already do that
+                return [2 /*return*/, pipelineJson];
             }
         });
     });
@@ -5892,22 +6045,6 @@ function pipelineStringToJson(pipelineString, options) {
  * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
  */
 
-/**
- * This error indicates that the pipeline collection cannot be propperly loaded
- *
- * @public exported from `@promptbook/core`
- */
-var CollectionError = /** @class */ (function (_super) {
-    __extends(CollectionError, _super);
-    function CollectionError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'CollectionError';
-        Object.setPrototypeOf(_this, CollectionError.prototype);
-        return _this;
-    }
-    return CollectionError;
-}(Error));
-
 /**
  * Detects if the code is running in a Node.js environment
  *
@@ -6273,7 +6410,7 @@ function createCollectionFromDirectory(path, options) {
                                                             }
                                                             else {
                                                                 existing = collection.get(pipeline.pipelineUrl);
-                                                                throw new ReferenceError(spaceTrim("\n                                  Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection \uD83C\uDF4F\n\n                                  Conflicting files:\n                                  ").concat(existing.sourceFile || 'Unknown', "\n                                  ").concat(pipeline.sourceFile || 'Unknown', "\n\n                                  Note: You have probably forgotten to run \"ptbk make\" to update the collection\n                                  Note: Pipelines with the same URL are not allowed\n                                        Only exepction is when the pipelines are identical\n\n                              ")));
+                                                                throw new PipelineUrlError(spaceTrim$1("\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                                ")));
                                                             }
                                                         }
                                                     }
@@ -6283,7 +6420,7 @@ function createCollectionFromDirectory(path, options) {
                                                     if (!(error_1 instanceof Error)) {
                                                         throw error_1;
                                                     }
-                                                    wrappedErrorMessage = spaceTrim(function (block) { return "\n                        ".concat(error_1.name, " in pipeline ").concat(fileName.split('\\').join('/'), "\u2060:\n\n                        ").concat(block(error_1.message), "\n\n                    "); });
+                                                    wrappedErrorMessage = spaceTrim$1(function (block) { return "\n                        ".concat(error_1.name, " in pipeline ").concat(fileName.split('\\').join('/'), "\u2060:\n\n                        ").concat(block(error_1.message), "\n\n                    "); });
                                                     if (isCrashedOnError) {
                                                         throw new CollectionError(wrappedErrorMessage);
                                                     }
@@ -6339,35 +6476,16 @@ function createCollectionFromDirectory(path, options) {
  * TODO: [🖇] What about symlinks? Maybe option isSymlinksFollowed
  */
 
-/**
- * This error type indicates that you try to use a feature that is not available in the current environment
- *
- * @public exported from `@promptbook/core`
- */
-var EnvironmentMismatchError = /** @class */ (function (_super) {
-    __extends(EnvironmentMismatchError, _super);
-    function EnvironmentMismatchError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'EnvironmentMismatchError';
-        Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
-        return _this;
-    }
-    return EnvironmentMismatchError;
-}(Error));
-
 /**
  * @@@
  *
  * Note: `$` is used to indicate that this function is not a pure function - it access global scope
  *
- * @public exported from `@promptbook/utils`
+ *  @private internal function of `$Register`
  */
 function $getGlobalScope() {
     return Function('return this')();
 }
-/***
- * TODO: !!!!! Make private and promptbook registry from this
- */
 
 /**
  * Register is @@@
@@ -6526,7 +6644,7 @@ function $registeredLlmToolsMessage() {
         });
         return __assign(__assign({}, metadata), { isMetadataAviailable: isMetadataAviailable, isInstalled: isInstalled });
     });
-    return spaceTrim(function (block) { return "\n            Available LLM providers are:\n            ".concat(block(metadata
+    return spaceTrim$1(function (block) { return "\n            Available LLM providers are:\n            ".concat(block(metadata
         .map(function (_a, i) {
         var packageName = _a.packageName, className = _a.className, isMetadataAviailable = _a.isMetadataAviailable, isInstalled = _a.isInstalled;
         var more;
@@ -6574,7 +6692,7 @@ function createLlmToolsFromConfiguration(configuration, options) {
             return llmConfiguration.packageName === packageName && llmConfiguration.className === className;
         });
         if (registeredItem === undefined) {
-            throw new Error(spaceTrim(function (block) { return "\n                        There is no constructor for LLM provider `".concat(llmConfiguration.className, "` from `").concat(llmConfiguration.packageName, "`\n\n                        You have probably forgotten install and import the provider package.\n                        To fix this issue, you can:\n\n                        Install:\n\n                        > npm install ").concat(llmConfiguration.packageName, "\n\n                        And import:\n\n                        > import '").concat(llmConfiguration.packageName, "';\n\n\n                        ").concat(block($registeredLlmToolsMessage()), "\n                    "); }));
+            throw new Error(spaceTrim$1(function (block) { return "\n                        There is no constructor for LLM provider `".concat(llmConfiguration.className, "` from `").concat(llmConfiguration.packageName, "`\n\n                        You have probably forgotten install and import the provider package.\n                        To fix this issue, you can:\n\n                        Install:\n\n                        > npm install ").concat(llmConfiguration.packageName, "\n\n                        And import:\n\n                        > import '").concat(llmConfiguration.packageName, "';\n\n\n                        ").concat(block($registeredLlmToolsMessage()), "\n                    "); }));
         }
         return registeredItem(__assign({ isVerbose: isVerbose }, llmConfiguration.options));
     });
@@ -6611,7 +6729,7 @@ function createLlmToolsFromEnv(options) {
     var configuration = createLlmToolsFromConfigurationFromEnv();
     if (configuration.length === 0) {
         // TODO: [🥃]
-        throw new Error(spaceTrim(function (block) { return "\n                    No LLM tools found in the environment\n\n                    Please set one of environment variables:\n                    - OPENAI_API_KEY\n                    - ANTHROPIC_CLAUDE_API_KEY\n\n                    ".concat(block($registeredLlmToolsMessage()), "}\n                "); }));
+        throw new Error(spaceTrim$1(function (block) { return "\n                    No LLM tools found in the environment\n\n                    Please set one of environment variables:\n                    - OPENAI_API_KEY\n                    - ANTHROPIC_CLAUDE_API_KEY\n\n                    ".concat(block($registeredLlmToolsMessage()), "}\n                "); }));
     }
     return createLlmToolsFromConfiguration(configuration, options);
 }
@@ -6624,6 +6742,39 @@ function createLlmToolsFromEnv(options) {
  * TODO: This should be maybe not under `_common` but under `utils`
  */
 
+/**
+ * Tests if the value is [🚉] serializable as JSON
+ *
+ * - 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...
+ *
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isSerializableAsJson(value) {
+    try {
+        checkSerializableAsJson('', value);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * TODO: [🧠] !!! In-memory cache of same values to prevent multiple checks
+ * TODO: [🧠][💺] Can be done this on type-level?
+ */
+
 /**
  * Stringify the PipelineJson with proper formatting
  *
@@ -6633,6 +6784,9 @@ function createLlmToolsFromEnv(options) {
  * @public exported from `@promptbook/core`
  */
 function stringifyPipelineJson(pipeline) {
+    if (!isSerializableAsJson(pipeline)) {
+        throw new UnexpectedError(spaceTrim$1("\n                Cannot stringify the pipeline, because it is not serializable as JSON\n\n                There can be multiple reasons:\n                1) The pipeline contains circular references\n                2) It is not a valid PipelineJson\n            "));
+    }
     var pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
     for (var i = 0; i < LOOP_LIMIT; i++) {
         pipelineJsonStringified = pipelineJsonStringified.replace(/(-?0\.\d+),[\n\s]+(-?0\.\d+)/gms, "$1".concat(REPLACING_NONCE, "$2"));
@@ -6713,6 +6867,9 @@ var FilesStorage = /** @class */ (function () {
                 switch (_a.label) {
                     case 0:
                         filename = this.getFilenameForKey(key);
+                        if (!isSerializableAsJson(value)) {
+                            throw new UnexpectedError("The \"".concat(key, "\" you want to store in JSON file is not serializable as JSON"));
+                        }
                         fileContent = stringifyPipelineJson(value);
                         return [4 /*yield*/, mkdir(dirname(filename), { recursive: true })];
                     case 1: