@promptbook/browser 0.86.10 → 0.86.22

package/umd/index.umd.js

@@ -15,143 +15,31 @@
      * @generated
      * @see https://github.com/webgptorg/book
      */
-    var BOOK_LANGUAGE_VERSION = '1.0.0';
+    const BOOK_LANGUAGE_VERSION = '1.0.0';
     /**
      * The version of the Promptbook engine
      *
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.86.10';
+    const PROMPTBOOK_ENGINE_VERSION = '0.86.22';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /*! *****************************************************************************
-    Copyright (c) Microsoft Corporation.
-
-    Permission to use, copy, modify, and/or distribute this software for any
-    purpose with or without fee is hereby granted.
-
-    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-    PERFORMANCE OF THIS SOFTWARE.
-    ***************************************************************************** */
-    /* global Reflect, Promise */
-
-    var extendStatics = function(d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-
-    function __extends(d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    }
-
-    var __assign = function() {
-        __assign = Object.assign || function __assign(t) {
-            for (var s, i = 1, n = arguments.length; i < n; i++) {
-                s = arguments[i];
-                for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
-            }
-            return t;
-        };
-        return __assign.apply(this, arguments);
-    };
-
-    function __awaiter(thisArg, _arguments, P, generator) {
-        function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-        return new (P || (P = Promise))(function (resolve, reject) {
-            function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-            function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-            function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-            step((generator = generator.apply(thisArg, _arguments || [])).next());
-        });
-    }
-
-    function __generator(thisArg, body) {
-        var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-        return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-        function verb(n) { return function (v) { return step([n, v]); }; }
-        function step(op) {
-            if (f) throw new TypeError("Generator is already executing.");
-            while (_) try {
-                if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-                if (y = 0, t) op = [op[0] & 2, t.value];
-                switch (op[0]) {
-                    case 0: case 1: t = op; break;
-                    case 4: _.label++; return { value: op[1], done: false };
-                    case 5: _.label++; y = op[1]; op = [0]; continue;
-                    case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                    default:
-                        if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                        if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                        if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                        if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                        if (t[2]) _.ops.pop();
-                        _.trys.pop(); continue;
-                }
-                op = body.call(thisArg, _);
-            } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-            if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-        }
-    }
-
-    function __values(o) {
-        var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-        if (m) return m.call(o);
-        if (o && typeof o.length === "number") return {
-            next: function () {
-                if (o && i >= o.length) o = void 0;
-                return { value: o && o[i++], done: !o };
-            }
-        };
-        throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-    }
-
-    function __read(o, n) {
-        var m = typeof Symbol === "function" && o[Symbol.iterator];
-        if (!m) return o;
-        var i = m.call(o), r, ar = [], e;
-        try {
-            while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-        }
-        catch (error) { e = { error: error }; }
-        finally {
-            try {
-                if (r && !r.done && (m = i["return"])) m.call(i);
-            }
-            finally { if (e) throw e.error; }
-        }
-        return ar;
-    }
-
     /**
      * This error indicates errors during the execution of the pipeline
      *
      * @public exported from `@promptbook/core`
      */
-    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;
+    class PipelineExecutionError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'PipelineExecutionError';
+            Object.setPrototypeOf(this, PipelineExecutionError.prototype);
         }
-        return PipelineExecutionError;
-    }(Error));
+    }
 
     /**
      * Wrapper around `window.prompt` synchronous function that interacts with the user via browser prompt
@@ -161,31 +49,31 @@
      *
      * @public exported from `@promptbook/browser`
      */
-    var SimplePromptInterfaceTools = /** @class */ (function () {
-        function SimplePromptInterfaceTools(options) {
-            if (options === void 0) { options = {}; }
+    class SimplePromptInterfaceTools {
+        constructor(options = {}) {
             this.options = options;
         }
         /**
          * Trigger window.prompt dialog
          */
-        SimplePromptInterfaceTools.prototype.promptDialog = function (options) {
-            return __awaiter(this, void 0, void 0, function () {
-                var answer;
-                return __generator(this, function (_a) {
-                    answer = window.prompt(spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(options.promptTitle), "\n\n                    ").concat(block(options.promptMessage), "\n                "); }));
-                    if (this.options.isVerbose) {
-                        console.info(spaceTrim.spaceTrim(function (block) { return "\n                        \uD83D\uDCD6 ".concat(block(options.promptTitle), "\n                        \uD83D\uDC64 ").concat(block(answer || '🚫 User cancelled prompt'), "\n                    "); }));
-                    }
-                    if (answer === null) {
-                        throw new PipelineExecutionError('User cancelled prompt');
-                    }
-                    return [2 /*return*/, answer];
-                });
-            });
-        };
-        return SimplePromptInterfaceTools;
-    }());
+        async promptDialog(options) {
+            const answer = window.prompt(spaceTrim.spaceTrim((block) => `
+                    ${block(options.promptTitle)}
+
+                    ${block(options.promptMessage)}
+                `));
+            if (this.options.isVerbose) {
+                console.info(spaceTrim.spaceTrim((block) => `
+                        📖 ${block(options.promptTitle)}
+                        👤 ${block(answer || '🚫 User cancelled prompt')}
+                    `));
+            }
+            if (answer === null) {
+                throw new PipelineExecutionError('User cancelled prompt');
+            }
+            return answer;
+        }
+    }
     /**
      * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
      */
@@ -195,16 +83,13 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var EnvironmentMismatchError = /** @class */ (function (_super) {
-        __extends(EnvironmentMismatchError, _super);
-        function EnvironmentMismatchError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'EnvironmentMismatchError';
-            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
-            return _this;
+    class EnvironmentMismatchError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'EnvironmentMismatchError';
+            Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
         }
-        return EnvironmentMismatchError;
-    }(Error));
+    }
 
     /**
      * Detects if the code is running in a browser environment in main thread (Not in a web worker)
@@ -213,7 +98,13 @@
      *
      * @public exported from `@promptbook/utils`
      */
-    var $isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
+    const $isRunningInBrowser = new Function(`
+    try {
+        return this === window;
+    } catch (e) {
+        return false;
+    }
+`);
     /**
      * TODO: [🎺]
      */
@@ -225,7 +116,17 @@
      *
      * @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");
+    const $isRunningInWebWorker = new Function(`
+    try {
+        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {
+            return true;
+        } else {
+            return false;
+        }
+    } catch (e) {
+        return false;
+    }
+`);
     /**
      * TODO: [🎺]
      */
@@ -237,26 +138,26 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var NAME = "Promptbook";
+    const NAME = `Promptbook`;
     /**
      * Email of the responsible person
      *
      * @public exported from `@promptbook/core`
      */
-    var ADMIN_EMAIL = 'pavol@ptbk.io';
+    const ADMIN_EMAIL = 'pavol@ptbk.io';
     /**
      * Name of the responsible person for the Promptbook on GitHub
      *
      * @public exported from `@promptbook/core`
      */
-    var ADMIN_GITHUB_NAME = 'hejny';
+    const ADMIN_GITHUB_NAME = 'hejny';
     // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
     /**
      * The maximum number of iterations for a loops
      *
      * @private within the repository - too low-level in comparison with other `MAX_...`
      */
-    var LOOP_LIMIT = 1000;
+    const LOOP_LIMIT = 1000;
     // <- TODO: [🧜‍♂️]
     /**
      * @@@
@@ -279,16 +180,23 @@
      *
      * @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 pavol@ptbk.io\n\n                "); })) || this;
-            _this.name = 'NotYetImplementedError';
-            Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
-            return _this;
+    class NotYetImplementedError extends Error {
+        constructor(message) {
+            super(spaceTrim.spaceTrim((block) => `
+                    ${block(message)}
+
+                    Note: This feature is not implemented yet but it will be soon.
+
+                    If you want speed up the implementation or just read more, look here:
+                    https://github.com/webgptorg/promptbook
+
+                    Or contact us on pavol@ptbk.io
+
+                `));
+            this.name = 'NotYetImplementedError';
+            Object.setPrototypeOf(this, NotYetImplementedError.prototype);
         }
-        return NotYetImplementedError;
-    }(Error));
+    }
 
     /**
      * Make error report URL for the given error
@@ -296,11 +204,37 @@
      * @private private within the repository
      */
     function getErrorReportUrl(error) {
-        var report = {
-            title: "\uD83D\uDC1C Error report from ".concat(NAME),
-            body: spaceTrim__default["default"](function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
+        const report = {
+            title: `🐜 Error report from ${NAME}`,
+            body: spaceTrim__default["default"]((block) => `
+
+
+            \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
+
+            \`\`\`
+            ${block(error.message || '(no error message)')}
+            \`\`\`
+
+
+            ## More info:
+
+            - **Promptbook engine version:** ${PROMPTBOOK_ENGINE_VERSION}
+            - **Book language version:** ${BOOK_LANGUAGE_VERSION}
+            - **Time:** ${new Date().toISOString()}
+
+            <details>
+            <summary>Stack trace:</summary>
+
+            ## Stack trace:
+
+            \`\`\`stacktrace
+            ${block(error.stack || '(empty)')}
+            \`\`\`
+            </details>
+
+        `),
         };
-        var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
+        const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);
         reportUrl.searchParams.set('labels', 'bug');
         reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
         reportUrl.searchParams.set('title', report.title);
@@ -313,16 +247,24 @@
      *
      * @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                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
-            _this.name = 'UnexpectedError';
-            Object.setPrototypeOf(_this, UnexpectedError.prototype);
-            return _this;
+    class UnexpectedError extends Error {
+        constructor(message) {
+            super(spaceTrim.spaceTrim((block) => `
+                    ${block(message)}
+
+                    Note: This error should not happen.
+                    It's probbably a bug in the pipeline collection
+
+                    Please report issue:
+                    ${block(getErrorReportUrl(new Error(message)).href)}
+
+                    Or contact us on ${ADMIN_EMAIL}
+
+                `));
+            this.name = 'UnexpectedError';
+            Object.setPrototypeOf(this, UnexpectedError.prototype);
         }
-        return UnexpectedError;
-    }(Error));
+    }
 
     /**
      * @@@
@@ -345,46 +287,35 @@
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_SCREAMING_CASE(text) {
-        var e_1, _a;
-        var charType;
-        var lastCharType = 'OTHER';
-        var normalizedName = '';
-        try {
-            for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
-                var char = text_1_1.value;
-                var normalizedChar = void 0;
-                if (/^[a-z]$/.test(char)) {
-                    charType = 'LOWERCASE';
-                    normalizedChar = char.toUpperCase();
-                }
-                else if (/^[A-Z]$/.test(char)) {
-                    charType = 'UPPERCASE';
-                    normalizedChar = char;
-                }
-                else if (/^[0-9]$/.test(char)) {
-                    charType = 'NUMBER';
-                    normalizedChar = char;
-                }
-                else {
-                    charType = 'OTHER';
-                    normalizedChar = '_';
-                }
-                if (charType !== lastCharType &&
-                    !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
-                    !(lastCharType === 'NUMBER') &&
-                    !(charType === 'NUMBER')) {
-                    normalizedName += '_';
-                }
-                normalizedName += normalizedChar;
-                lastCharType = charType;
+        let charType;
+        let lastCharType = 'OTHER';
+        let normalizedName = '';
+        for (const char of text) {
+            let normalizedChar;
+            if (/^[a-z]$/.test(char)) {
+                charType = 'LOWERCASE';
+                normalizedChar = char.toUpperCase();
             }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
+            else if (/^[A-Z]$/.test(char)) {
+                charType = 'UPPERCASE';
+                normalizedChar = char;
+            }
+            else if (/^[0-9]$/.test(char)) {
+                charType = 'NUMBER';
+                normalizedChar = char;
             }
-            finally { if (e_1) throw e_1.error; }
+            else {
+                charType = 'OTHER';
+                normalizedChar = '_';
+            }
+            if (charType !== lastCharType &&
+                !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+                !(lastCharType === 'NUMBER') &&
+                !(charType === 'NUMBER')) {
+                normalizedName += '_';
+            }
+            normalizedName += normalizedChar;
+            lastCharType = charType;
         }
         normalizedName = normalizedName.replace(/_+/g, '_');
         normalizedName = normalizedName.replace(/_?\/_?/g, '/');
@@ -421,27 +352,27 @@
      *
      * @private internal utility, exported are only signleton instances of this class
      */
-    var $Register = /** @class */ (function () {
-        function $Register(registerName) {
+    class $Register {
+        constructor(registerName) {
             this.registerName = registerName;
-            var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
-            var globalScope = $getGlobalScope();
+            const storageName = `_promptbook_${normalizeTo_snake_case(registerName)}`;
+            const globalScope = $getGlobalScope();
             if (globalScope[storageName] === undefined) {
                 globalScope[storageName] = [];
             }
             else if (!Array.isArray(globalScope[storageName])) {
-                throw new UnexpectedError("Expected (global) ".concat(storageName, " to be an array, but got ").concat(typeof globalScope[storageName]));
+                throw new UnexpectedError(`Expected (global) ${storageName} to be an array, but got ${typeof globalScope[storageName]}`);
             }
             this.storage = globalScope[storageName];
         }
-        $Register.prototype.list = function () {
+        list() {
             // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
             return this.storage;
-        };
-        $Register.prototype.register = function (registered) {
-            var packageName = registered.packageName, className = registered.className;
-            var existingRegistrationIndex = this.storage.findIndex(function (item) { return item.packageName === packageName && item.className === className; });
-            var existingRegistration = this.storage[existingRegistrationIndex];
+        }
+        register(registered) {
+            const { packageName, className } = registered;
+            const existingRegistrationIndex = this.storage.findIndex((item) => item.packageName === packageName && item.className === className);
+            const existingRegistration = this.storage[existingRegistrationIndex];
             if (!existingRegistration) {
                 this.storage.push(registered);
             }
@@ -450,18 +381,17 @@
             }
             return {
                 registerName: this.registerName,
-                packageName: packageName,
-                className: className,
+                packageName,
+                className,
                 get isDestroyed() {
                     return false;
                 },
-                destroy: function () {
-                    throw new NotYetImplementedError("Registration to ".concat(this.registerName, " is permanent in this version of Promptbook"));
+                destroy() {
+                    throw new NotYetImplementedError(`Registration to ${this.registerName} is permanent in this version of Promptbook`);
                 },
             };
-        };
-        return $Register;
-    }());
+        }
+    }
 
     /**
      * @@@
@@ -470,7 +400,7 @@
      * @singleton Only one instance of each register is created per build, but thare can be more @@@
      * @public exported from `@promptbook/core`
      */
-    var $scrapersRegister = new $Register('scraper_constructors');
+    const $scrapersRegister = new $Register('scraper_constructors');
     /**
      * TODO: [®] DRY Register logic
      */
@@ -483,52 +413,20 @@
      *
      * @public exported from `@promptbook/browser`
      */
-    function $provideScrapersForBrowser(tools, options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var isAutoInstalled /* Note: [0] Intentionally not assigning a default value = IS_AUTO_INSTALLED */, scrapers, _a, _b, scraperFactory, scraper, e_1_1;
-            var e_1, _c;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        if (!$isRunningInBrowser() || $isRunningInWebWorker()) {
-                            throw new EnvironmentMismatchError('Function `$provideScrapersForBrowser` works only in browser environment');
-                        }
-                        isAutoInstalled = (options || {}).isAutoInstalled;
-                        if (isAutoInstalled === true /* <- Note: [0] Ignoring undefined, just checking EXPLICIT requirement for install */) {
-                            throw new EnvironmentMismatchError('Auto-installing is not supported in browser environment');
-                        }
-                        scrapers = [];
-                        _d.label = 1;
-                    case 1:
-                        _d.trys.push([1, 6, 7, 8]);
-                        _a = __values($scrapersRegister.list()), _b = _a.next();
-                        _d.label = 2;
-                    case 2:
-                        if (!!_b.done) return [3 /*break*/, 5];
-                        scraperFactory = _b.value;
-                        return [4 /*yield*/, scraperFactory(tools, options || {})];
-                    case 3:
-                        scraper = _d.sent();
-                        scrapers.push(scraper);
-                        _d.label = 4;
-                    case 4:
-                        _b = _a.next();
-                        return [3 /*break*/, 2];
-                    case 5: return [3 /*break*/, 8];
-                    case 6:
-                        e_1_1 = _d.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 8];
-                    case 7:
-                        try {
-                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                        return [7 /*endfinally*/];
-                    case 8: return [2 /*return*/, scrapers];
-                }
-            });
-        });
+    async function $provideScrapersForBrowser(tools, options) {
+        if (!$isRunningInBrowser() || $isRunningInWebWorker()) {
+            throw new EnvironmentMismatchError('Function `$provideScrapersForBrowser` works only in browser environment');
+        }
+        const { isAutoInstalled /* Note: [0] Intentionally not assigning a default value = IS_AUTO_INSTALLED */ } = options || {};
+        if (isAutoInstalled === true /* <- Note: [0] Ignoring undefined, just checking EXPLICIT requirement for install */) {
+            throw new EnvironmentMismatchError('Auto-installing is not supported in browser environment');
+        }
+        const scrapers = [];
+        for (const scraperFactory of $scrapersRegister.list()) {
+            const scraper = await scraperFactory(tools, options || {});
+            scrapers.push(scraper);
+        }
+        return scrapers;
     }
 
     /**
@@ -538,8 +436,11 @@
      * @public exported from `@promptbook/utils`
      */
     function orderJson(options) {
-        var value = options.value, order = options.order;
-        var orderedValue = __assign(__assign({}, (order === undefined ? {} : Object.fromEntries(order.map(function (key) { return [key, undefined]; })))), value);
+        const { value, order } = options;
+        const orderedValue = {
+            ...(order === undefined ? {} : Object.fromEntries(order.map((key) => [key, undefined]))),
+            ...value,
+        };
         return orderedValue;
     }
 
@@ -553,26 +454,15 @@
      * @public exported from `@promptbook/utils`
      */
     function $deepFreeze(objectValue) {
-        var e_1, _a;
         if (Array.isArray(objectValue)) {
-            return Object.freeze(objectValue.map(function (item) { return $deepFreeze(item); }));
-        }
-        var propertyNames = Object.getOwnPropertyNames(objectValue);
-        try {
-            for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
-                var propertyName = propertyNames_1_1.value;
-                var value = objectValue[propertyName];
-                if (value && typeof value === 'object') {
-                    $deepFreeze(value);
-                }
-            }
+            return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+        const propertyNames = Object.getOwnPropertyNames(objectValue);
+        for (const propertyName of propertyNames) {
+            const value = objectValue[propertyName];
+            if (value && typeof value === 'object') {
+                $deepFreeze(value);
             }
-            finally { if (e_1) throw e_1.error; }
         }
         Object.freeze(objectValue);
         return objectValue;
@@ -602,10 +492,9 @@
      * @public exported from `@promptbook/utils`
      */
     function checkSerializableAsJson(options) {
-        var e_1, _a;
-        var value = options.value, name = options.name, message = options.message;
+        const { value, name, message } = options;
         if (value === undefined) {
-            throw new UnexpectedError("".concat(name, " is undefined"));
+            throw new UnexpectedError(`${name} is undefined`);
         }
         else if (value === null) {
             return;
@@ -620,49 +509,54 @@
             return;
         }
         else if (typeof value === 'symbol') {
-            throw new UnexpectedError("".concat(name, " is symbol"));
+            throw new UnexpectedError(`${name} is symbol`);
         }
         else if (typeof value === 'function') {
-            throw new UnexpectedError("".concat(name, " is function"));
+            throw new UnexpectedError(`${name} is function`);
         }
         else if (typeof value === 'object' && Array.isArray(value)) {
-            for (var i = 0; i < value.length; i++) {
-                checkSerializableAsJson({ name: "".concat(name, "[").concat(i, "]"), value: value[i], message: message });
+            for (let i = 0; i < value.length; i++) {
+                checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
             }
         }
         else if (typeof value === 'object') {
             if (value instanceof Date) {
-                throw new UnexpectedError(spaceTrim__default["default"](function (block) { return "\n                        `".concat(name, "` is Date\n\n                        Use `string_date_iso8601` instead\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n                    "); }));
+                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                        \`${name}\` is Date
+
+                        Use \`string_date_iso8601\` instead
+
+                        Additional message for \`${name}\`:
+                        ${block(message || '(nothing)')}
+                    `));
             }
             else if (value instanceof Map) {
-                throw new UnexpectedError("".concat(name, " is Map"));
+                throw new UnexpectedError(`${name} is Map`);
             }
             else if (value instanceof Set) {
-                throw new UnexpectedError("".concat(name, " is Set"));
+                throw new UnexpectedError(`${name} is Set`);
             }
             else if (value instanceof RegExp) {
-                throw new UnexpectedError("".concat(name, " is RegExp"));
+                throw new UnexpectedError(`${name} is RegExp`);
             }
             else if (value instanceof Error) {
-                throw new UnexpectedError(spaceTrim__default["default"](function (block) { return "\n                        `".concat(name, "` is unserialized Error\n\n                        Use function `serializeError`\n\n                        Additional message for `").concat(name, "`:\n                        ").concat(block(message || '(nothing)'), "\n\n                    "); }));
+                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                        \`${name}\` is unserialized Error
+
+                        Use function \`serializeError\`
+
+                        Additional message for \`${name}\`:
+                        ${block(message || '(nothing)')}
+
+                    `));
             }
             else {
-                try {
-                    for (var _b = __values(Object.entries(value)), _c = _b.next(); !_c.done; _c = _b.next()) {
-                        var _d = __read(_c.value, 2), subName = _d[0], subValue = _d[1];
-                        if (subValue === undefined) {
-                            // Note: undefined in object is serializable - it is just omited
-                            continue;
-                        }
-                        checkSerializableAsJson({ name: "".concat(name, ".").concat(subName), value: subValue, message: message });
-                    }
-                }
-                catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                finally {
-                    try {
-                        if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                for (const [subName, subValue] of Object.entries(value)) {
+                    if (subValue === undefined) {
+                        // Note: undefined in object is serializable - it is just omited
+                        continue;
                     }
-                    finally { if (e_1) throw e_1.error; }
+                    checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });
                 }
                 try {
                     JSON.stringify(value); // <- TODO: [0]
@@ -671,7 +565,14 @@
                     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.stack || error.message), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
+                    throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                            \`${name}\` is not serializable
+
+                            ${block(error.stack || error.message)}
+
+                            Additional message for \`${name}\`:
+                            ${block(message || '(nothing)')}
+                        `));
                 }
                 /*
                 TODO: [0] Is there some more elegant way to check circular references?
@@ -696,7 +597,12 @@
             }
         }
         else {
-            throw new UnexpectedError(spaceTrim__default["default"](function (block) { return "\n                    `".concat(name, "` is unknown type\n\n                    Additional message for `").concat(name, "`:\n                    ").concat(block(message || '(nothing)'), "\n                "); }));
+            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                    \`${name}\` is unknown type
+
+                    Additional message for \`${name}\`:
+                    ${block(message || '(nothing)')}
+                `));
         }
     }
     /**
@@ -742,9 +648,9 @@
      * @public exported from `@promptbook/utils`
      */
     function exportJson(options) {
-        var name = options.name, value = options.value, order = options.order, message = options.message;
-        checkSerializableAsJson({ name: name, value: value, message: message });
-        var orderedValue = 
+        const { name, value, order, message } = options;
+        checkSerializableAsJson({ name, value, message });
+        const orderedValue = 
         // TODO: Fix error "Type instantiation is excessively deep and possibly infinite."
         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
         // @ts-ignore
@@ -767,7 +673,7 @@
      *
      * @private within the repository
      */
-    var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+    const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
     /**
      * The names of the parameters that are reserved for special purposes
      *
@@ -775,7 +681,7 @@
      */
     exportJson({
         name: 'RESERVED_PARAMETER_NAMES',
-        message: "The names of the parameters that are reserved for special purposes",
+        message: `The names of the parameters that are reserved for special purposes`,
         value: [
             'content',
             'context',
@@ -814,7 +720,7 @@
      */
     function isSerializableAsJson(value) {
         try {
-            checkSerializableAsJson({ value: value });
+            checkSerializableAsJson({ value });
             return true;
         }
         catch (error) {
@@ -836,11 +742,17 @@
      */
     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            "));
+            throw new UnexpectedError(spaceTrim__default["default"](`
+                Cannot stringify the pipeline, because it is not serializable as JSON
+
+                There can be multiple reasons:
+                1) The pipeline contains circular references
+                2) It is not a valid PipelineJson
+            `));
         }
-        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"));
+        let pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
+        for (let i = 0; i < LOOP_LIMIT; i++) {
+            pipelineJsonStringified = pipelineJsonStringified.replace(/(-?0\.\d+),[\n\s]+(-?0\.\d+)/gms, `$1${REPLACING_NONCE}$2`);
         }
         pipelineJsonStringified = pipelineJsonStringified.split(REPLACING_NONCE).join(', ');
         pipelineJsonStringified += '\n';
@@ -860,23 +772,23 @@
      */
     function makePromptbookStorageFromWebStorage(webStorage) {
         return {
-            getItem: function (key) {
-                var stringValue = webStorage.getItem(key);
+            getItem(key) {
+                const stringValue = webStorage.getItem(key);
                 if (stringValue === null) {
                     return null;
                 }
-                var value = JSON.parse(stringValue);
+                const value = JSON.parse(stringValue);
                 // TODO: [🌗]
                 return value;
             },
-            setItem: function (key, value) {
+            setItem(key, value) {
                 if (!isSerializableAsJson(value)) {
-                    throw new UnexpectedError("The \"".concat(key, "\" you want to store in web storage is not serializable as JSON"));
+                    throw new UnexpectedError(`The "${key}" you want to store in web storage is not serializable as JSON`);
                 }
-                var stringValue = stringifyPipelineJson(value);
+                const stringValue = stringifyPipelineJson(value);
                 webStorage.setItem(key, stringValue);
             },
-            removeItem: function (key) {
+            removeItem(key) {
                 webStorage.removeItem(key);
             },
         };
@@ -893,7 +805,7 @@
      */
     function getLocalStorage() {
         if (!core.isRunningInBrowser()) {
-            throw new EnvironmentMismatchError("You can get localStorage works only in browser environment");
+            throw new EnvironmentMismatchError(`You can get localStorage works only in browser environment`);
         }
         return makePromptbookStorageFromWebStorage(localStorage);
     }
@@ -908,7 +820,7 @@
      */
     function getSessionStorage() {
         if (!core.isRunningInBrowser()) {
-            throw new EnvironmentMismatchError("You can get sessionStorage works only in browser environment");
+            throw new EnvironmentMismatchError(`You can get sessionStorage works only in browser environment`);
         }
         return makePromptbookStorageFromWebStorage(sessionStorage);
     }