@promptbook/utils 0.61.0-9 → 0.61.0

package/umd/index.umd.js

@@ -1,8 +1,12 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.spacetrim));
-})(this, (function (exports, spacetrim) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-utils"] = {}, global.spaceTrim));
+})(this, (function (exports, spaceTrim) { 'use strict';
+
+    function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
 
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -129,7 +133,7 @@
     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;
+            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;
@@ -516,6 +520,14 @@
      * Function normalizes title to name which can be used as identifier
      */
     function titleToName(value) {
+        if (value.startsWith('http://') || value.startsWith('https://')) {
+            // TODO: Maybe check against some list unallowed characters
+            return value;
+        }
+        if (value.startsWith('./') || value.startsWith('../')) {
+            // TODO: Maybe check against some list unallowed characters
+            return value;
+        }
         value = removeEmojis(value);
         value = normalizeToKebabCase(value);
         // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
@@ -543,7 +555,7 @@
             }
             return normalizeTo_camelCase('template-' + titleToName(template.title));
         };
-        var promptbookMermaid = spacetrim.spaceTrim(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(pipelineJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(pipelineJson.promptTemplates
+        var promptbookMermaid = spaceTrim.spaceTrim(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(pipelineJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(pipelineJson.promptTemplates
             .flatMap(function (_a) {
             var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
             return __spreadArray([
@@ -586,7 +598,7 @@
      * @param template the template with parameters in {curly} braces
      * @returns the list of parameter names
      */
-    function extractParameters(template) {
+    function extractParameterNames(template) {
         var e_1, _a;
         var matches = template.matchAll(/{\w+}/g);
         var parameterNames = new Set();
@@ -661,7 +673,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.name), ": ").concat(block(error.message), "\n                "); }));
         }
         return variables;
     }
@@ -676,37 +688,53 @@
      * @returns the set of parameter names
      * @throws {ParsingError} if the script is invalid
      */
-    function extractParametersFromPromptTemplate(promptTemplate) {
-        var e_1, _a, e_2, _b;
+    function extractParameterNamesFromPromptTemplate(promptTemplate) {
+        var e_1, _a, e_2, _b, e_3, _c;
+        var title = promptTemplate.title, description = promptTemplate.description, blockType = promptTemplate.blockType, content = promptTemplate.content, preparedContent = promptTemplate.preparedContent, jokerParameterNames = promptTemplate.jokerParameterNames;
         var parameterNames = new Set();
         try {
-            for (var _c = __values(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameters(promptTemplate.title)), false), __read(extractParameters(promptTemplate.description || '')), false), __read(extractParameters(promptTemplate.content)), false)), _d = _c.next(); !_d.done; _d = _c.next()) {
-                var parameterName = _d.value;
+            for (var _d = __values(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(extractParameterNames(title)), false), __read(extractParameterNames(description || '')), false), __read(extractParameterNames(content)), false), __read(extractParameterNames(preparedContent || '')), false)), _e = _d.next(); !_e.done; _e = _d.next()) {
+                var parameterName = _e.value;
                 parameterNames.add(parameterName);
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
             }
             finally { if (e_1) throw e_1.error; }
         }
-        if (promptTemplate.blockType === 'SCRIPT') {
+        if (blockType === 'SCRIPT') {
             try {
-                for (var _e = __values(extractVariables(promptTemplate.content)), _f = _e.next(); !_f.done; _f = _e.next()) {
-                    var parameterName = _f.value;
+                for (var _f = __values(extractVariables(content)), _g = _f.next(); !_g.done; _g = _f.next()) {
+                    var parameterName = _g.value;
                     parameterNames.add(parameterName);
                 }
             }
             catch (e_2_1) { e_2 = { error: e_2_1 }; }
             finally {
                 try {
-                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                    if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
                 }
                 finally { if (e_2) throw e_2.error; }
             }
         }
+        try {
+            for (var _h = __values(jokerParameterNames || []), _j = _h.next(); !_j.done; _j = _h.next()) {
+                var jokerName = _j.value;
+                parameterNames.add(jokerName);
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (_j && !_j.done && (_c = _h.return)) _c.call(_h);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+        parameterNames.delete('content');
+        //                      <- Note {websiteContent} is used in `preparedContent`
         return parameterNames;
     }
     /**
@@ -792,12 +820,12 @@
      */
     function forEachAsync(array, options, callbackfunction) {
         return __awaiter(this, void 0, void 0, function () {
-            var _a, inParallelCount, index, runningTasks, tasks, _loop_1, _b, _c, item, e_1_1;
+            var _a, maxParallelCount, index, runningTasks, tasks, _loop_1, _b, _c, item, e_1_1;
             var e_1, _d;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
-                        _a = options.inParallelCount, inParallelCount = _a === void 0 ? Infinity : _a;
+                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? Infinity : _a;
                         index = 0;
                         runningTasks = [];
                         tasks = [];
@@ -813,7 +841,7 @@
                                         /* not await */ Promise.resolve(task).then(function () {
                                             runningTasks = runningTasks.filter(function (t) { return t !== task; });
                                         });
-                                        if (!(inParallelCount < runningTasks.length)) return [3 /*break*/, 2];
+                                        if (!(maxParallelCount < runningTasks.length)) return [3 /*break*/, 2];
                                         return [4 /*yield*/, Promise.race(runningTasks)];
                                     case 1:
                                         _f.sent();
@@ -858,101 +886,154 @@
     }
 
     /**
-     * The maximum number of iterations for a loops
+     * Function isValidJsonString will tell you if the string is valid JSON or not
      */
-    var LOOP_LIMIT = 1000;
+    function isValidJsonString(value /* <- [👨‍⚖️] */) {
+        try {
+            JSON.parse(value);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (error.message.includes('Unexpected token')) {
+                return false;
+            }
+            return false;
+        }
+    }
 
     /**
-     * This error indicates errors during the execution of the pipeline
+     * Makes first letter of a string uppercase
+     *
      */
-    var PipelineExecutionError = /** @class */ (function (_super) {
-        __extends(PipelineExecutionError, _super);
-        function PipelineExecutionError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PipelineExecutionError';
-            Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
-            return _this;
-        }
-        return PipelineExecutionError;
-    }(Error));
+    function capitalize(word) {
+        return word.substring(0, 1).toUpperCase() + word.substring(1);
+    }
 
     /**
-     * Replaces parameters in template with values from parameters object
+     * Extracts all code blocks from markdown.
      *
-     * @param template the template with parameters in {curly} braces
-     * @param parameters the object with parameters
-     * @returns the template with replaced parameters
-     * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code blocks with language and content
      *
-     * @private within the createPipelineExecutor
      */
-    function replaceParameters(template, parameters) {
-        var replacedTemplate = template;
-        var match;
-        var loopLimit = LOOP_LIMIT;
-        var _loop_1 = function () {
-            if (loopLimit-- < 0) {
-                throw new UnexpectedError('Loop limit reached during parameters replacement in `replaceParameters`');
-            }
-            var precol = match.groups.precol;
-            var parameterName = match.groups.parameterName;
-            if (parameterName === '') {
-                return "continue";
-            }
-            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-                throw new PipelineExecutionError('Parameter is already opened or not closed');
-            }
-            if (parameters[parameterName] === undefined) {
-                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
-            }
-            var parameterValue = parameters[parameterName];
-            if (parameterValue === undefined) {
-                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
-            }
-            parameterValue = parameterValue.toString();
-            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
-                parameterValue = parameterValue
-                    .split('\n')
-                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
-                    .join('\n');
+    function extractAllBlocksFromMarkdown(markdown) {
+        var e_1, _a;
+        var codeBlocks = [];
+        var lines = markdown.split('\n');
+        // Note: [0] Ensure that the last block notated by gt > will be closed
+        lines.push('');
+        var currentCodeBlock = null;
+        try {
+            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
+                var line = lines_1_1.value;
+                if (line.startsWith('> ') || line === '>') {
+                    if (currentCodeBlock === null) {
+                        currentCodeBlock = { blockNotation: '>', language: null, content: '' };
+                    } /* not else */
+                    if (currentCodeBlock.blockNotation === '>') {
+                        if (currentCodeBlock.content !== '') {
+                            currentCodeBlock.content += '\n';
+                        }
+                        currentCodeBlock.content += line.slice(2);
+                    }
+                }
+                else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
+                    codeBlocks.push(currentCodeBlock);
+                    currentCodeBlock = null;
+                }
+                /* not else */
+                if (line.startsWith('```')) {
+                    var language = line.slice(3).trim() || null;
+                    if (currentCodeBlock === null) {
+                        currentCodeBlock = { blockNotation: '```', language: language, content: '' };
+                    }
+                    else {
+                        if (language !== null) {
+                            throw new ParsingError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
+                        }
+                        codeBlocks.push(currentCodeBlock);
+                        currentCodeBlock = null;
+                    }
+                }
+                else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
+                    if (currentCodeBlock.content !== '') {
+                        currentCodeBlock.content += '\n';
+                    }
+                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
+                }
             }
-            replacedTemplate =
-                replacedTemplate.substring(0, match.index + precol.length) +
-                    parameterValue +
-                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
-        };
-        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
-            .exec(replacedTemplate))) {
-            _loop_1();
         }
-        // [💫] Check if there are parameters that are not closed properly
-        if (/{\w+$/.test(replacedTemplate)) {
-            throw new PipelineExecutionError('Parameter is not closed');
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+            }
+            finally { if (e_1) throw e_1.error; }
         }
-        // [💫] Check if there are parameters that are not opened properly
-        if (/^\w+}/.test(replacedTemplate)) {
-            throw new PipelineExecutionError('Parameter is not opened');
+        if (currentCodeBlock !== null) {
+            throw new ParsingError("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
         }
-        return replacedTemplate;
+        return codeBlocks;
     }
+    /**
+     * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
+     */
 
     /**
-     * Function isValidJsonString will tell you if the string is valid JSON or not
+     * Extracts exactly ONE code block from markdown.
+     *
+     * Note: If there are multiple or no code blocks the function throws an error
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     *
+     * @param markdown any valid markdown
+     * @returns code block with language and content
      */
-    function isValidJsonString(value /* <-[👨‍⚖️] */) {
-        try {
-            JSON.parse(value);
-            return true;
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            if (error.message.includes('Unexpected token')) {
-                return false;
-            }
-            return false;
+    function extractOneBlockFromMarkdown(markdown) {
+        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
+        if (codeBlocks.length !== 1) {
+            throw new ParsingError(spaceTrim__default["default"](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];
+    }
+    /***
+     * TODO: [🍓][🌻] Decide of this is internal util, external util OR validator/postprocessor
+     */
+
+    /**
+     * Extracts code block from markdown.
+     *
+     * Note: If there are multiple or no code blocks the function throws an error
+     *
+     * Note: There are 3 simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     */
+    function extractBlock(markdown) {
+        var content = extractOneBlockFromMarkdown(markdown).content;
+        return content;
+    }
+    //
+
+    /**
+     * Simple wrapper `new Date().toISOString()`
+     *
+     * @returns string_date branded type
+     */
+    function $currentDate() {
+        return new Date().toISOString();
     }
 
     /**
@@ -1029,14 +1110,6 @@
         PAGES: countPages,
     };
 
-    /**
-     * Makes first letter of a string uppercase
-     *
-     */
-    function capitalize(word) {
-        return word.substring(0, 1).toUpperCase() + word.substring(1);
-    }
-
     /**
      * Makes first letter of a string uppercase
      *
@@ -1295,122 +1368,210 @@
      */
 
     /**
-     * Extracts all code blocks from markdown.
+     * Generates random seed
      *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     * Warning: This function is not cryptographically secure (it uses Math.random internally)
+     */
+    function $randomSeed() {
+        return Math.random();
+    }
+
+    /**
+     * Removes quotes from a string
      *
-     * @param markdown any valid markdown
-     * @returns code blocks with language and content
+     * Tip: This is very usefull for post-processing of the result of the LLM model
+     * Note: This function removes only the same quotes from the beginning and the end of the string
+     * Note: There are two simmilar functions:
+     * - `removeQuotes` which removes only bounding quotes
+     * - `unwrapResult` which removes whole introduce sentence
      *
+     * @param text optionally quoted text
+     * @returns text without quotes
      */
-    function extractAllBlocksFromMarkdown(markdown) {
+    function removeQuotes(text) {
+        if (text.startsWith('"') && text.endsWith('"')) {
+            return text.slice(1, -1);
+        }
+        if (text.startsWith('\'') && text.endsWith('\'')) {
+            return text.slice(1, -1);
+        }
+        return text;
+    }
+
+    /**
+     * @@@
+     *
+     * @returns The same object as the input, but deeply frozen
+     *
+     * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     */
+    function deepFreeze(objectValue) {
         var e_1, _a;
-        var codeBlocks = [];
-        var lines = markdown.split('\n');
-        var currentCodeBlock = null;
+        var propertyNames = Object.getOwnPropertyNames(objectValue);
         try {
-            for (var lines_1 = __values(lines), lines_1_1 = lines_1.next(); !lines_1_1.done; lines_1_1 = lines_1.next()) {
-                var line = lines_1_1.value;
-                if (line.startsWith('```')) {
-                    var language = line.slice(3).trim() || null;
-                    if (currentCodeBlock === null) {
-                        currentCodeBlock = { language: language, content: '' };
-                    }
-                    else {
-                        if (language !== null) {
-                            // [🌻]
-                            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed and already opening new ").concat(language, " code block"));
-                        }
-                        codeBlocks.push(currentCodeBlock);
-                        currentCodeBlock = null;
-                    }
-                }
-                else if (currentCodeBlock !== null) {
-                    if (currentCodeBlock.content !== '') {
-                        currentCodeBlock.content += '\n';
-                    }
-                    currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make propper unescape */;
+            for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
+                var propertyName = propertyNames_1_1.value;
+                var value = objectValue[propertyName];
+                if (value && typeof value === 'object') {
+                    deepFreeze(value);
                 }
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (lines_1_1 && !lines_1_1.done && (_a = lines_1.return)) _a.call(lines_1);
+                if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
-        if (currentCodeBlock !== null) {
-            // [🌻]
-            throw new Error("".concat(capitalize(currentCodeBlock.language || 'the'), " code block was not closed at the end of the markdown"));
-        }
-        return codeBlocks;
+        return Object.freeze(objectValue);
     }
+    /**
+     * TODO: [🔼] Export from `@promptbook/utils`
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
 
     /**
-     * Extracts exactly ONE code block from markdown.
-     *
-     * Note: If there are multiple or no code blocks the function throws an error
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
-     *
-     * @param markdown any valid markdown
-     * @returns code block with language and content
+     * The maximum number of iterations for a loops
      */
-    function extractOneBlockFromMarkdown(markdown) {
-        var codeBlocks = extractAllBlocksFromMarkdown(markdown);
-        if (codeBlocks.length !== 1) {
-            // TODO: Report more specific place where the error happened
-            throw new Error(/* <- [🌻] */ 'There should be exactly one code block in the markdown');
-        }
-        return codeBlocks[0];
-    }
-    /***
-     * TODO: [🍓][🌻] !!! Decide of this is internal util, external util OR validator/postprocessor
+    var LOOP_LIMIT = 1000;
+    /**
+     * Nonce which is used for replacing things in strings
+     */
+    var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
+    /**
+     * The names of the parameters that are reserved for special purposes
+     */
+    deepFreeze([
+        'content',
+        'context',
+        'knowledge',
+        'samples',
+        'modelName',
+        'currentDate',
+        // <- TODO: Add more like 'date', 'modelName',...
+        // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
+    ]);
+    /**
+     * @@@
+     */
+    var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
+    /**
+     * @@@
+     */
+    var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
+    /*
+    TODO: !!! Just testing false-negative detection of [🟡][🟢][🔵][⚪] leak
+    */
+    // [🟡][🟢][🔵][⚪]
+    /**
+     * TODO: [🔼] Export all to core
      */
 
     /**
-     * Extracts code block from markdown.
-     *
-     * Note: If there are multiple or no code blocks the function throws an error
-     *
-     * Note: There are 3 simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     * This error type indicates that some limit was reached
      */
-    function extractBlock(markdown) {
-        var content = extractOneBlockFromMarkdown(markdown).content;
-        return content;
-    }
-    //
+    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));
 
     /**
-     * Removes quotes from a string
-     *
-     * Tip: This is very usefull for post-processing of the result of the LLM model
-     * Note: This function removes only the same quotes from the beginning and the end of the string
-     * Note: There are two simmilar functions:
-     * - `removeQuotes` which removes only bounding quotes
-     * - `unwrapResult` which removes whole introduce sentence
+     * This error indicates errors during the execution of the pipeline
+     */
+    var PipelineExecutionError = /** @class */ (function (_super) {
+        __extends(PipelineExecutionError, _super);
+        function PipelineExecutionError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PipelineExecutionError';
+            Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
+            return _this;
+        }
+        return PipelineExecutionError;
+    }(Error));
+
+    /**
+     * Replaces parameters in template with values from parameters object
      *
-     * @param text optionally quoted text
-     * @returns text without quotes
+     * @param template the template with parameters in {curly} braces
+     * @param parameters the object with parameters
+     * @returns the template with replaced parameters
+     * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
      */
-    function removeQuotes(text) {
-        if (text.startsWith('"') && text.endsWith('"')) {
-            return text.slice(1, -1);
+    function replaceParameters(template, parameters) {
+        var e_1, _a;
+        try {
+            for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
+                if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
+                    throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
+                }
+                else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
+                    // TODO: [🍵]
+                    throw new UnexpectedError("Parameter {".concat(parameterName, "} is restricted to use"));
+                }
+            }
         }
-        if (text.startsWith('\'') && text.endsWith('\'')) {
-            return text.slice(1, -1);
+        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; }
         }
-        return text;
+        var replacedTemplate = template;
+        var match;
+        var loopLimit = LOOP_LIMIT;
+        var _loop_1 = function () {
+            if (loopLimit-- < 0) {
+                throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
+            }
+            var precol = match.groups.precol;
+            var parameterName = match.groups.parameterName;
+            if (parameterName === '') {
+                return "continue";
+            }
+            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+                throw new PipelineExecutionError('Parameter is already opened or not closed');
+            }
+            if (parameters[parameterName] === undefined) {
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            var parameterValue = parameters[parameterName];
+            if (parameterValue === undefined) {
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            parameterValue = parameterValue.toString();
+            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+                parameterValue = parameterValue
+                    .split('\n')
+                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
+                    .join('\n');
+            }
+            replacedTemplate =
+                replacedTemplate.substring(0, match.index + precol.length) +
+                    parameterValue +
+                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
+        };
+        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+            .exec(replacedTemplate))) {
+            _loop_1();
+        }
+        // [💫] Check if there are parameters that are not closed properly
+        if (/{\w+$/.test(replacedTemplate)) {
+            throw new PipelineExecutionError('Parameter is not closed');
+        }
+        // [💫] Check if there are parameters that are not opened properly
+        if (/^\w+}/.test(replacedTemplate)) {
+            throw new PipelineExecutionError('Parameter is not opened');
+        }
+        return replacedTemplate;
     }
 
     /**
@@ -1442,6 +1603,9 @@
         }
         return diff;
     }
+    /**
+     * TODO: [🧠][💯] Maybe also implement symmetricDifference
+     */
 
     /**
      * Creates a new set with all elements that are present in all sets
@@ -1530,13 +1694,13 @@
      *
      */
     function trimCodeBlock(value) {
-        value = spacetrim.spaceTrim(value);
+        value = spaceTrim.spaceTrim(value);
         if (!/^```[a-z]*(.*)```$/is.test(value)) {
             return value;
         }
         value = value.replace(/^```[a-z]*/i, '');
         value = value.replace(/```$/i, '');
-        value = spacetrim.spaceTrim(value);
+        value = spaceTrim.spaceTrim(value);
         return value;
     }
 
@@ -1547,9 +1711,9 @@
      *       if you want to start code block in the prompt but you don't want to end it in the result.
      */
     function trimEndOfCodeBlock(value) {
-        value = spacetrim.spaceTrim(value);
+        value = spaceTrim.spaceTrim(value);
         value = value.replace(/```$/g, '');
-        value = spacetrim.spaceTrim(value);
+        value = spaceTrim.spaceTrim(value);
         return value;
     }
 
@@ -1570,7 +1734,7 @@
         var trimmedText = text;
         // Remove leading and trailing spaces and newlines
         if (isTrimmed) {
-            trimmedText = spacetrim.spaceTrim(trimmedText);
+            trimmedText = spaceTrim.spaceTrim(trimmedText);
         }
         var processedText = trimmedText;
         if (isIntroduceSentenceRemoved) {
@@ -1579,7 +1743,7 @@
                 // Remove the introduce sentence and quotes by replacing it with an empty string
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
-            processedText = spacetrim.spaceTrim(processedText);
+            processedText = spaceTrim.spaceTrim(processedText);
         }
         if (processedText.length < 3) {
             return trimmedText;
@@ -1690,7 +1854,7 @@
         if ( /* version === '1.0.0' || */version === '2.0.0' || version === '3.0.0') {
             return false;
         }
-        // <- TODO: !!!! Check isValidPromptbookVersion against PROMPTBOOK_VERSIONS
+        // <- TODO: !!! Check isValidPromptbookVersion against PROMPTBOOK_VERSIONS
         return true;
     }
 
@@ -1812,7 +1976,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.61.0-8';
+    var PROMPTBOOK_VERSION = '0.61.0-30';
     // TODO: !!!! List here all the versions and annotate + put into script
 
     // @promptbook/utils
@@ -1832,8 +1996,10 @@
 
     Object.defineProperty(exports, 'spaceTrim', {
         enumerable: true,
-        get: function () { return spacetrim.spaceTrim; }
+        get: function () { return spaceTrim.spaceTrim; }
     });
+    exports.$currentDate = $currentDate;
+    exports.$randomSeed = $randomSeed;
     exports.CountUtils = CountUtils;
     exports.DIACRITIC_VARIANTS_LETTERS = DIACRITIC_VARIANTS_LETTERS;
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;
@@ -1847,8 +2013,8 @@
     exports.decapitalize = decapitalize;
     exports.difference = difference;
     exports.extractBlock = extractBlock;
-    exports.extractParameters = extractParameters;
-    exports.extractParametersFromPromptTemplate = extractParametersFromPromptTemplate;
+    exports.extractParameterNames = extractParameterNames;
+    exports.extractParameterNamesFromPromptTemplate = extractParameterNamesFromPromptTemplate;
     exports.extractVariables = extractVariables;
     exports.forEachAsync = forEachAsync;
     exports.intersection = intersection;