@promptbook/browser 0.86.10 → 0.86.22

package/esm/index.es.js

@@ -8,143 +8,31 @@ import { isRunningInBrowser } from 'openai/core';
  * @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
@@ -154,31 +42,31 @@ var PipelineExecutionError = /** @class */ (function (_super) {
  *
  * @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(function (block) { return "\n                    ".concat(block(options.promptTitle), "\n\n                    ").concat(block(options.promptMessage), "\n                "); }));
-                if (this.options.isVerbose) {
-                    console.info(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((block) => `
+                    ${block(options.promptTitle)}
+
+                    ${block(options.promptMessage)}
+                `));
+        if (this.options.isVerbose) {
+            console.info(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`
  */
@@ -188,16 +76,13 @@ var SimplePromptInterfaceTools = /** @class */ (function () {
  *
  * @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)
@@ -206,7 +91,13 @@ var EnvironmentMismatchError = /** @class */ (function (_super) {
  *
  * @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: [🎺]
  */
@@ -218,7 +109,17 @@ var $isRunningInBrowser = new Function("\n    try {\n        return this === win
  *
  * @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: [🎺]
  */
@@ -230,26 +131,26 @@ var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof Worker
  *
  * @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: [🧜‍♂️]
 /**
  * @@@
@@ -272,16 +173,23 @@ Object.freeze({
  *
  * @public exported from `@promptbook/core`
  */
-var NotYetImplementedError = /** @class */ (function (_super) {
-    __extends(NotYetImplementedError, _super);
-    function NotYetImplementedError(message) {
-        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on pavol@ptbk.io\n\n                "); })) || this;
-        _this.name = 'NotYetImplementedError';
-        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
-        return _this;
+class NotYetImplementedError extends Error {
+    constructor(message) {
+        super(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
@@ -289,11 +197,37 @@ var NotYetImplementedError = /** @class */ (function (_super) {
  * @private private within the repository
  */
 function getErrorReportUrl(error) {
-    var report = {
-        title: "\uD83D\uDC1C Error report from ".concat(NAME),
-        body: spaceTrim$1(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$1((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);
@@ -306,16 +240,24 @@ function getErrorReportUrl(error) {
  *
  * @public exported from `@promptbook/core`
  */
-var UnexpectedError = /** @class */ (function (_super) {
-    __extends(UnexpectedError, _super);
-    function UnexpectedError(message) {
-        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").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((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));
+}
 
 /**
  * @@@
@@ -338,46 +280,35 @@ function $getGlobalScope() {
  * @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;
         }
-        finally { if (e_1) throw e_1.error; }
+        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;
     }
     normalizedName = normalizedName.replace(/_+/g, '_');
     normalizedName = normalizedName.replace(/_?\/_?/g, '/');
@@ -414,27 +345,27 @@ function normalizeTo_snake_case(text) {
  *
  * @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);
         }
@@ -443,18 +374,17 @@ var $Register = /** @class */ (function () {
         }
         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;
-}());
+    }
+}
 
 /**
  * @@@
@@ -463,7 +393,7 @@ var $Register = /** @class */ (function () {
  * @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
  */
@@ -476,52 +406,20 @@ var $scrapersRegister = new $Register('scraper_constructors');
  *
  * @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;
 }
 
 /**
@@ -531,8 +429,11 @@ function $provideScrapersForBrowser(tools, options) {
  * @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;
 }
 
@@ -546,26 +447,15 @@ function orderJson(options) {
  * @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;
@@ -595,10 +485,9 @@ function $deepFreeze(objectValue) {
  * @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;
@@ -613,49 +502,54 @@ function checkSerializableAsJson(options) {
         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$1(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$1((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$1(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$1((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]
@@ -664,7 +558,14 @@ function checkSerializableAsJson(options) {
                 if (!(error instanceof Error)) {
                     throw error;
                 }
-                throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                            `".concat(name, "` is not serializable\n\n                            ").concat(block(error.stack || error.message), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
+                throw new UnexpectedError(spaceTrim$1((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?
@@ -689,7 +590,12 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$1(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$1((block) => `
+                    \`${name}\` is unknown type
+
+                    Additional message for \`${name}\`:
+                    ${block(message || '(nothing)')}
+                `));
     }
 }
 /**
@@ -735,9 +641,9 @@ function deepClone(objectValue) {
  * @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
@@ -760,7 +666,7 @@ function exportJson(options) {
  *
  * @private within the repository
  */
-var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
 /**
  * The names of the parameters that are reserved for special purposes
  *
@@ -768,7 +674,7 @@ var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
  */
 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',
@@ -807,7 +713,7 @@ exportJson({
  */
 function isSerializableAsJson(value) {
     try {
-        checkSerializableAsJson({ value: value });
+        checkSerializableAsJson({ value });
         return true;
     }
     catch (error) {
@@ -829,11 +735,17 @@ function isSerializableAsJson(value) {
  */
 function stringifyPipelineJson(pipeline) {
     if (!isSerializableAsJson(pipeline)) {
-        throw new UnexpectedError(spaceTrim$1("\n                Cannot stringify the pipeline, because it is not serializable as JSON\n\n                There can be multiple reasons:\n                1) The pipeline contains circular references\n                2) It is not a valid PipelineJson\n            "));
+        throw new UnexpectedError(spaceTrim$1(`
+                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';
@@ -853,23 +765,23 @@ function stringifyPipelineJson(pipeline) {
  */
 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);
         },
     };
@@ -886,7 +798,7 @@ function makePromptbookStorageFromWebStorage(webStorage) {
  */
 function getLocalStorage() {
     if (!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);
 }
@@ -901,7 +813,7 @@ function getLocalStorage() {
  */
 function getSessionStorage() {
     if (!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);
 }