@promptbook/cli 0.66.0 → 0.67.0-1

package/umd/index.umd.js

@@ -39,7 +39,7 @@
     /**
      * 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
 
     /*! *****************************************************************************
@@ -186,6 +186,26 @@
      */
     var $isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
 
+    /**
+     * 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;
+    }
+
     /**
      * @@@
      *
@@ -216,42 +236,169 @@
         }
         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.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__default["default"]("\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__default["default"]("\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__default["default"](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;
-    }
-
     /**
      * Warning message for the generated sections and files files
      *
@@ -320,7 +467,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var RESERVED_PARAMETER_NAMES = $deepFreeze([
+    var RESERVED_PARAMETER_NAMES = $asDeeplyFrozenSerializableJson('RESERVED_PARAMETER_NAMES', [
         'content',
         'context',
         'knowledge',
@@ -893,7 +1040,7 @@
         });
     }
 
-    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
@@ -927,22 +1074,6 @@
         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.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));
-
     /**
      * Tests if given string is valid semantic version
      *
@@ -1356,15 +1487,15 @@
      *
      * @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));
 
     /**
@@ -1412,7 +1543,7 @@
             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`
@@ -1448,7 +1579,7 @@
                     var pipeline = pipelines_1_1.value;
                     // TODO: [👠] DRY
                     if (pipeline.pipelineUrl === undefined) {
-                        throw new ReferenceError$1(spaceTrim.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                    ")));
+                        throw new PipelineUrlError(spaceTrim.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);
@@ -1460,7 +1591,7 @@
                         pipelineJsonToString(unpreparePipeline(pipeline)) !==
                             pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                         var existing = this.collection.get(pipeline.pipelineUrl);
-                        throw new ReferenceError$1(spaceTrim.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                    ")));
+                        throw new PipelineUrlError(spaceTrim.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);
@@ -1905,9 +2036,89 @@
     }(Error));
 
     /**
-     * Asserts that the execution of a promptnook is successful
+     * This error indicates that the pipeline collection cannot be propperly loaded
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var CollectionError = /** @class */ (function (_super) {
+        __extends(CollectionError, _super);
+        function CollectionError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'CollectionError';
+            Object.setPrototypeOf(_this, CollectionError.prototype);
+            return _this;
+        }
+        return CollectionError;
+    }(Error));
+
+    /**
+     * This error 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.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 promptnook execution
+     * @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`
      */
@@ -1917,15 +2128,16 @@
             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.spaceTrim(function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors
-                .map(function (error, index) {
-                return spaceTrim.spaceTrim(function (block) { return "\n                                        Error ".concat(index + 1, ":\n                                        ").concat(block(error.stack || error.message), "\n                                    "); });
+            throw new PipelineExecutionError(spaceTrim.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.spaceTrim(function (block) { return "\n                                        ".concat(name, " ").concat(index + 1, ":\n                                        ").concat(block(stack || message), "\n                                    "); });
             })
                 .join('\n')), "\n                "); }));
         }
@@ -1957,7 +2169,7 @@
                     var undefinedName = error.message.split(' ')[0];
                     /*
                     Note: Parsing the error
-                          [ReferenceError: thing is not defined]
+                          [PipelineUrlError: thing is not defined]
                     */
                     if (!undefinedName) {
                         throw error;
@@ -1975,7 +2187,7 @@
             if (!(error instanceof Error)) {
                 throw error;
             }
-            throw new ParsingError(spaceTrim.spaceTrim(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.spaceTrim(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.toString()), "}\n                "); }));
         }
         return variables;
     }
@@ -2062,6 +2274,23 @@
         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__default["default"](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
      *
@@ -2399,6 +2628,7 @@
         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`
@@ -2443,22 +2673,6 @@
         }
     }
 
-    /**
-     * 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
      *
@@ -2844,7 +3058,6 @@
                 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:
@@ -2965,71 +3178,8 @@
                                         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.spaceTrim(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];
@@ -3254,7 +3404,7 @@
                                     executionReport.promptExecutions.push({
                                         prompt: __assign({}, prompt),
                                         result: result || undefined,
-                                        error: expectError || undefined,
+                                        error: expectError === null ? undefined : serializeError(expectError),
                                     });
                                 }
                                 return [7 /*endfinally*/];
@@ -3289,7 +3439,7 @@
                 });
             }
             function filterJustOutputParameters() {
-                var e_9, _a;
+                var e_8, _a;
                 var outputParameters = {};
                 try {
                     // Note: Filter ONLY output parameters
@@ -3306,12 +3456,12 @@
                         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;
             }
@@ -3348,11 +3498,11 @@
                             })), _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: {},
@@ -3378,12 +3528,12 @@
                                 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,
@@ -3490,10 +3640,10 @@
                             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,
@@ -3505,10 +3655,10 @@
                             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,
@@ -3878,6 +4028,7 @@
         });
     }
     /**
+     * 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
@@ -3978,7 +4129,7 @@
         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*/;
@@ -4048,7 +4199,7 @@
                         // ----- /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 }))];
                 }
             });
         });
@@ -5304,22 +5455,6 @@
         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.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));
-
     /**
      * Supported script languages
      *
@@ -6011,7 +6146,7 @@
             }
         });
         // =============================================================
-        return pipelineJson;
+        return $asDeeplyFrozenSerializableJson('pipelineJson', pipelineJson);
     }
     /**
      * TODO: !!!! Warn if used only sync version
@@ -6055,7 +6190,9 @@
                     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];
                 }
             });
         });
@@ -6066,22 +6203,6 @@
      * 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));
-
     /**
      * Checks if the file exists
      *
@@ -6438,7 +6559,7 @@
                                                                 }
                                                                 else {
                                                                     existing = collection.get(pipeline.pipelineUrl);
-                                                                    throw new ReferenceError(spaceTrim__default["default"]("\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__default["default"]("\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                                ")));
                                                                 }
                                                             }
                                                         }
@@ -6504,6 +6625,39 @@
      * TODO: [🖇] What about symlinks? Maybe option isSymlinksFollowed
      */
 
+    /**
+     * 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
      *
@@ -6513,6 +6667,9 @@
      * @public exported from `@promptbook/core`
      */
     function stringifyPipelineJson(pipeline) {
+        if (!isSerializableAsJson(pipeline)) {
+            throw new UnexpectedError(spaceTrim__default["default"]("\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"));
@@ -6638,6 +6795,9 @@
                     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*/, promises.mkdir(path.dirname(filename), { recursive: true })];
                         case 1:
@@ -6682,14 +6842,11 @@
      *
      * 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 @@@
@@ -7770,13 +7927,13 @@
                                 socket.emit('listModels-request', {
                                     isAnonymous: true,
                                     llmToolsConfiguration: this.options.llmToolsConfiguration,
-                                });
+                                } /* <- TODO: [🤛] */);
                             }
                             else {
                                 socket.emit('listModels-request', {
                                     isAnonymous: false,
                                     clientId: this.options.clientId,
-                                });
+                                } /* <- TODO: [🤛] */);
                             }
                             return [4 /*yield*/, new Promise(function (resolve, reject) {
                                     socket.on('listModels-response', function (response) {
@@ -7784,7 +7941,7 @@
                                         socket.disconnect();
                                     });
                                     socket.on('error', function (error) {
-                                        reject(new Error(error.errorMessage));
+                                        reject(deserializeError(error));
                                         socket.disconnect();
                                     });
                                 })];
@@ -7863,16 +8020,14 @@
                                     isAnonymous: true,
                                     llmToolsConfiguration: this.options.llmToolsConfiguration,
                                     prompt: prompt,
-                                    // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
-                                });
+                                } /* <- TODO: [🤛] */);
                             }
                             else {
                                 socket.emit('prompt-request', {
                                     isAnonymous: false,
                                     clientId: this.options.clientId,
                                     prompt: prompt,
-                                    // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
-                                });
+                                } /* <- TODO: [🤛] */);
                             }
                             return [4 /*yield*/, new Promise(function (resolve, reject) {
                                     socket.on('prompt-response', function (response) {
@@ -7880,7 +8035,7 @@
                                         socket.disconnect();
                                     });
                                     socket.on('error', function (error) {
-                                        reject(new PipelineExecutionError(error.errorMessage));
+                                        reject(deserializeError(error));
                                         socket.disconnect();
                                     });
                                 })];
@@ -7895,6 +8050,7 @@
         return RemoteLlmExecutionTools;
     }());
     /**
+     * TODO: Maybe use `$asDeeplyFrozenSerializableJson`
      * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
      * TODO: [🍓] Allow to list compatible models with each variant
      * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable
@@ -7929,7 +8085,7 @@
      * @see https://docs.anthropic.com/en/docs/models-overview
      * @public exported from `@promptbook/anthropic-claude`
      */
-    var ANTHROPIC_CLAUDE_MODELS = [
+    var ANTHROPIC_CLAUDE_MODELS = $asDeeplyFrozenSerializableJson('ANTHROPIC_CLAUDE_MODELS', [
         {
             modelVariant: 'CHAT',
             modelTitle: 'Claude 3.5 Sonnet',
@@ -7994,7 +8150,7 @@
             },
         },
         // TODO: !!! Claude 1 and 2 has also completion versions - ask Hoagy
-    ];
+    ]);
     /**
      * Note: [🤖] Add models of new variant
      * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
@@ -8205,7 +8361,7 @@
                             // eslint-disable-next-line prefer-const
                             complete = getCurrentIsoDate();
                             usage = computeAnthropicClaudeUsage(content, '', rawResponse);
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('AnthropicClaudeExecutionTools ChatPromptResult', {
                                     content: resultContent,
                                     modelName: rawResponse.model,
                                     timing: {
@@ -8217,7 +8373,7 @@
                                     rawRequest: rawRequest,
                                     rawResponse: rawResponse,
                                     // <- [🗯]
-                                }];
+                                })];
                     }
                 });
             });
@@ -8226,7 +8382,7 @@
         TODO: [👏]
         public async callCompletionModel(
             prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>,
-        ): Promise<PromptCompletionResult> {
+        ): Promise<CompletionPromptResult> {
 
             if (this.options.isVerbose) {
                 console.info('🖋 Anthropic Claude callCompletionModel call');
@@ -8279,7 +8435,7 @@
 
 
 
-            return {
+            return $asDeeplyFrozenSerializableJson('AnthropicClaudeExecutionTools CompletionPromptResult',{
                 content: resultContent,
                 modelName: rawResponse.model || model,
                 timing: {
@@ -8289,7 +8445,7 @@
                 usage,
                 rawResponse,
                 // <- [🗯]
-            };
+            });
         }
         */
         // <- Note: [🤖] callXxxModel
@@ -8426,7 +8582,7 @@
      * @see https://openai.com/api/pricing/
      * @public exported from `@promptbook/openai`
      */
-    var OPENAI_MODELS = [
+    var OPENAI_MODELS = $asDeeplyFrozenSerializableJson('OPENAI_MODELS', [
         /*/
           {
               modelTitle: 'dall-e-3',
@@ -8754,7 +8910,7 @@
             },
         },
         /**/
-    ];
+    ]);
     /**
      * Note: [🤖] Add models of new variant
      * TODO: [🧠] Some mechanism to propagate unsureness
@@ -8922,7 +9078,7 @@
                                 input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
                                 output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
                             };
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('AzureOpenAiExecutionTools ChatPromptResult', {
                                     content: resultContent,
                                     modelName: modelName,
                                     timing: {
@@ -8932,9 +9088,9 @@
                                     usage: usage,
                                     rawPromptContent: rawPromptContent,
                                     rawRequest: rawRequest,
-                                    rawResponse: rawResponse,
+                                    rawResponse: __assign(__assign({}, rawResponse), { created: rawResponse.created.toISOString() }),
                                     // <- [🗯]
-                                }];
+                                })];
                         case 4:
                             error_1 = _c.sent();
                             throw this.transformAzureError(error_1);
@@ -9009,7 +9165,7 @@
                                 input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
                                 output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
                             };
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('AzureOpenAiExecutionTools CompletionPromptResult', {
                                     content: resultContent,
                                     modelName: modelName,
                                     timing: {
@@ -9019,9 +9175,9 @@
                                     usage: usage,
                                     rawPromptContent: rawPromptContent,
                                     rawRequest: rawRequest,
-                                    rawResponse: rawResponse,
+                                    rawResponse: __assign(__assign({}, rawResponse), { created: rawResponse.created.toISOString() }),
                                     // <- [🗯]
-                                }];
+                                })];
                         case 4:
                             error_2 = _c.sent();
                             throw this.transformAzureError(error_2);
@@ -9035,11 +9191,14 @@
          * Changes Azure error (which is not propper Error but object) to propper Error
          */
         AzureOpenAiExecutionTools.prototype.transformAzureError = function (azureError) {
+            if (azureError instanceof UnexpectedError) {
+                return azureError;
+            }
             if (typeof azureError !== 'object' || azureError === null) {
                 return new PipelineExecutionError("Unknown Azure OpenAI error");
             }
             var code = azureError.code, message = azureError.message;
-            return new PipelineExecutionError("".concat(code, ": ").concat(message));
+            return new PipelineExecutionError("".concat(code || '(No Azure error code)', ": ").concat(message));
         };
         return AzureOpenAiExecutionTools;
     }());
@@ -9116,6 +9275,24 @@
         },
     });
 
+    /**
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    var $isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
+
+    /**
+     * Detects if the code is running in a web worker
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
+
     /**
      * Computes the usage of the OpenAI API based on the response from OpenAI
      *
@@ -9301,7 +9478,7 @@
                             if (resultContent === null) {
                                 throw new PipelineExecutionError('No response message from OpenAI');
                             }
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiExecutionTools ChatPromptResult', {
                                     content: resultContent,
                                     modelName: rawResponse.model || modelName,
                                     timing: {
@@ -9313,7 +9490,7 @@
                                     rawRequest: rawRequest,
                                     rawResponse: rawResponse,
                                     // <- [🗯]
-                                }];
+                                })];
                     }
                 });
             });
@@ -9370,7 +9547,7 @@
                             // eslint-disable-next-line prefer-const
                             complete = getCurrentIsoDate();
                             usage = computeOpenAiUsage(content, resultContent || '', rawResponse);
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiExecutionTools CompletionPromptResult', {
                                     content: resultContent,
                                     modelName: rawResponse.model || modelName,
                                     timing: {
@@ -9382,7 +9559,7 @@
                                     rawRequest: rawRequest,
                                     rawResponse: rawResponse,
                                     // <- [🗯]
-                                }];
+                                })];
                     }
                 });
             });
@@ -9430,7 +9607,7 @@
                             // eslint-disable-next-line prefer-const
                             complete = getCurrentIsoDate();
                             usage = computeOpenAiUsage(content, '', rawResponse);
-                            return [2 /*return*/, {
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiExecutionTools EmbeddingPromptResult', {
                                     content: resultContent,
                                     modelName: rawResponse.model || modelName,
                                     timing: {
@@ -9442,7 +9619,7 @@
                                     rawRequest: rawRequest,
                                     rawResponse: rawResponse,
                                     // <- [🗯]
-                                }];
+                                })];
                     }
                 });
             });
@@ -9501,6 +9678,9 @@
      */
     var createOpenAiExecutionTools = Object.assign(function (options) {
         // TODO: [🧠] !!!! If browser, auto add `dangerouslyAllowBrowser`
+        if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
+            options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
+        }
         return new OpenAiExecutionTools(options);
     }, {
         packageName: '@promptbook/openai',