@promptbook/remote-server 0.83.0 → 0.84.0-10

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('http'), require('socket.io'), require('spacetrim'), require('fs/promises'), require('child_process'), require('util'), require('path'), require('prettier'), require('prettier/parser-html'), require('waitasecond'), require('papaparse'), require('crypto-js'), require('crypto-js/enc-hex'), require('mime-types')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'http', 'socket.io', 'spacetrim', 'fs/promises', 'child_process', 'util', 'path', 'prettier', 'prettier/parser-html', 'waitasecond', 'papaparse', 'crypto-js', 'crypto-js/enc-hex', 'mime-types'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.colors, global.http, global.socket_io, global.spaceTrim, global.promises, global.child_process, global.util, global.path, global.prettier, global.parserHtml, global.waitasecond, global.papaparse, global.cryptoJs, global.hexEncoder, global.mimeTypes));
-})(this, (function (exports, colors, http, socket_io, spaceTrim, promises, child_process, util, path, prettier, parserHtml, waitasecond, papaparse, cryptoJs, hexEncoder, mimeTypes) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('http'), require('socket.io'), require('spacetrim'), require('child_process'), require('waitasecond'), require('fs/promises'), require('path'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('crypto-js/enc-hex'), require('mime-types')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'http', 'socket.io', 'spacetrim', 'child_process', 'waitasecond', 'fs/promises', 'path', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'crypto-js/enc-hex', 'mime-types'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.colors, global.http, global.socket_io, global.spaceTrim, global.child_process, global.waitasecond, global.promises, global.path, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.hexEncoder, global.mimeTypes));
+})(this, (function (exports, colors, http, socket_io, spaceTrim, child_process, waitasecond, promises, path, prettier, parserHtml, papaparse, cryptoJs, hexEncoder, mimeTypes) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -26,7 +26,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.82.0';
+    var PROMPTBOOK_ENGINE_VERSION = '0.84.0-9';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -184,7 +184,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var ADMIN_EMAIL = 'me@pavolhejny.com';
+    var ADMIN_EMAIL = 'pavol@ptbk.io';
     /**
      * Name of the responsible person for the Promptbook on GitHub
      *
@@ -295,311 +295,6 @@
      * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
      */
 
-    /**
-     * This error type indicates that you try to use a feature that is not available in the current environment
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var EnvironmentMismatchError = /** @class */ (function (_super) {
-        __extends(EnvironmentMismatchError, _super);
-        function EnvironmentMismatchError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'EnvironmentMismatchError';
-            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
-            return _this;
-        }
-        return EnvironmentMismatchError;
-    }(Error));
-
-    /**
-     * Detects if the code is running in a Node.js environment
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    var $isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
-
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $provideFilesystemForNode(options) {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
-        }
-        (options || {}).isVerbose;
-        return {
-            stat: promises.stat,
-            access: promises.access,
-            constants: promises.constants,
-            readFile: promises.readFile,
-            writeFile: promises.writeFile,
-            readdir: promises.readdir,
-        };
-    }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
-
-    /**
-     * This error type indicates that some part of the code is not implemented yet
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var NotYetImplementedError = /** @class */ (function (_super) {
-        __extends(NotYetImplementedError, _super);
-        function NotYetImplementedError(message) {
-            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
-            _this.name = 'NotYetImplementedError';
-            Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
-            return _this;
-        }
-        return NotYetImplementedError;
-    }(Error));
-
-    /**
-     * Make error report URL for the given error
-     *
-     * @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        "); }),
-        };
-        var 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);
-        reportUrl.searchParams.set('body', report.body);
-        return reportUrl;
-    }
-
-    /**
-     * This error type indicates that the error should not happen and its last check before crashing with some other error
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var UnexpectedError = /** @class */ (function (_super) {
-        __extends(UnexpectedError, _super);
-        function UnexpectedError(message) {
-            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").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;
-        }
-        return UnexpectedError;
-    }(Error));
-
-    /**
-     * @@@
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it access global scope
-     *
-     *  @private internal function of `$Register`
-     */
-    function $getGlobalScope() {
-        return Function('return this')();
-    }
-
-    /**
-     * @@@
-     *
-     * @param text @@@
-     * @returns @@@
-     * @example 'HELLO_WORLD'
-     * @example 'I_LOVE_PROMPTBOOK'
-     * @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;
-            }
-        }
-        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);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-        normalizedName = normalizedName.replace(/_+/g, '_');
-        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
-        normalizedName = normalizedName.replace(/^_/, '');
-        normalizedName = normalizedName.replace(/_$/, '');
-        return normalizedName;
-    }
-    /**
-     * TODO: Tests
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
-     * TODO: [🌺] Use some intermediate util splitWords
-     */
-
-    /**
-     * @@@
-     *
-     * @param text @@@
-     * @returns @@@
-     * @example 'hello_world'
-     * @example 'i_love_promptbook'
-     * @public exported from `@promptbook/utils`
-     */
-    function normalizeTo_snake_case(text) {
-        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
-    }
-
-    /**
-     * Register is @@@
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
-     *
-     * @private internal utility, exported are only signleton instances of this class
-     */
-    var $Register = /** @class */ (function () {
-        function $Register(registerName) {
-            this.registerName = registerName;
-            var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
-            var 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]));
-            }
-            this.storage = globalScope[storageName];
-        }
-        $Register.prototype.list = function () {
-            // <- 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];
-            if (!existingRegistration) {
-                this.storage.push(registered);
-            }
-            else {
-                this.storage[existingRegistrationIndex] = registered;
-            }
-            return {
-                registerName: this.registerName,
-                packageName: packageName,
-                className: className,
-                get isDestroyed() {
-                    return false;
-                },
-                destroy: function () {
-                    throw new NotYetImplementedError("Registration to ".concat(this.registerName, " is permanent in this version of Promptbook"));
-                },
-            };
-        };
-        return $Register;
-    }());
-
-    /**
-     * @@@
-     *
-     * Note: `$` is used to indicate that this interacts with the global scope
-     * @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');
-    /**
-     * TODO: [®] DRY Register logic
-     */
-
-    /**
-     * @@@
-     *
-     * 1) @@@
-     * 2) @@@
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $provideScrapersForNode(tools, options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _a, scrapers, _d, _e, scraperFactory, scraper, e_1_1;
-            var e_1, _f;
-            return __generator(this, function (_g) {
-                switch (_g.label) {
-                    case 0:
-                        if (!$isRunningInNode()) {
-                            throw new EnvironmentMismatchError('Function `$getScrapersForNode` works only in Node.js environment');
-                        }
-                        _a = options || {}, _a.isAutoInstalled, _a.isVerbose;
-                        scrapers = [];
-                        _g.label = 1;
-                    case 1:
-                        _g.trys.push([1, 6, 7, 8]);
-                        _d = __values($scrapersRegister.list()), _e = _d.next();
-                        _g.label = 2;
-                    case 2:
-                        if (!!_e.done) return [3 /*break*/, 5];
-                        scraperFactory = _e.value;
-                        return [4 /*yield*/, scraperFactory(tools, options || {})];
-                    case 3:
-                        scraper = _g.sent();
-                        scrapers.push(scraper);
-                        _g.label = 4;
-                    case 4:
-                        _e = _d.next();
-                        return [3 /*break*/, 2];
-                    case 5: return [3 /*break*/, 8];
-                    case 6:
-                        e_1_1 = _g.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 8];
-                    case 7:
-                        try {
-                            if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                        return [7 /*endfinally*/];
-                    case 8: return [2 /*return*/, scrapers];
-                }
-            });
-        });
-    }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
-
     /**
      * This error indicates errors during the execution of the pipeline
      *
@@ -668,6 +363,22 @@
         return CollectionError;
     }(Error));
 
+    /**
+     * This error type indicates that you try to use a feature that is not available in the current environment
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var EnvironmentMismatchError = /** @class */ (function (_super) {
+        __extends(EnvironmentMismatchError, _super);
+        function EnvironmentMismatchError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'EnvironmentMismatchError';
+            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+            return _this;
+        }
+        return EnvironmentMismatchError;
+    }(Error));
+
     /**
      * This error occurs when some expectation is not met in the execution of the pipeline
      *
@@ -751,6 +462,22 @@
         return NotFoundError;
     }(Error));
 
+    /**
+     * This error type indicates that some part of the code is not implemented yet
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var NotYetImplementedError = /** @class */ (function (_super) {
+        __extends(NotYetImplementedError, _super);
+        function NotYetImplementedError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on pavol@ptbk.io\n\n                "); })) || this;
+            _this.name = 'NotYetImplementedError';
+            Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
+            return _this;
+        }
+        return NotYetImplementedError;
+    }(Error));
+
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
      *
@@ -802,6 +529,40 @@
         return PipelineUrlError;
     }(Error));
 
+    /**
+     * Make error report URL for the given error
+     *
+     * @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        "); }),
+        };
+        var 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);
+        reportUrl.searchParams.set('body', report.body);
+        return reportUrl;
+    }
+
+    /**
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var UnexpectedError = /** @class */ (function (_super) {
+        __extends(UnexpectedError, _super);
+        function UnexpectedError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").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;
+        }
+        return UnexpectedError;
+    }(Error));
+
     /**
      * Index of all custom errors
      *
@@ -875,30 +636,196 @@
         };
     }
 
-    // Note: We want to use the `exec` as async function
-    var exec$1 = util.promisify(child_process.exec);
+    /**
+     * Detects if the code is running in a Node.js environment
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    var $isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
+
+    /**
+     * Normalize options for `execCommand` and `execCommands`
+     *
+     * Note: `$` is used to indicate that this function behaves differently according to `process.platform`
+     *
+     * @private internal utility of `execCommand` and `execCommands`
+     */
+    function $execCommandNormalizeOptions(options) {
+        var _a;
+        var _b, _c, _d, _e;
+        var command;
+        var cwd;
+        var crashOnError;
+        var args = [];
+        var timeout;
+        var isVerbose;
+        if (typeof options === 'string') {
+            // TODO: [1] DRY default values
+            command = options;
+            cwd = process.cwd();
+            crashOnError = true;
+            timeout = Infinity; // <- TODO: [⏳]
+            isVerbose = DEFAULT_IS_VERBOSE;
+        }
+        else {
+            /*
+            TODO:
+            if ((options as any).commands !== undefined) {
+                commands = (options as any).commands;
+            } else {
+                commands = [(options as any).command];
+            }
+            */
+            // TODO: [1] DRY default values
+            command = options.command;
+            cwd = (_b = options.cwd) !== null && _b !== void 0 ? _b : process.cwd();
+            crashOnError = (_c = options.crashOnError) !== null && _c !== void 0 ? _c : true;
+            timeout = (_d = options.timeout) !== null && _d !== void 0 ? _d : Infinity;
+            isVerbose = (_e = options.isVerbose) !== null && _e !== void 0 ? _e : DEFAULT_IS_VERBOSE;
+        }
+        // TODO: /(-[a-zA-Z0-9-]+\s+[^\s]*)|[^\s]*/g
+        var _ = Array.from(command.matchAll(/(".*")|([^\s]*)/g))
+            .map(function (_a) {
+            var _b = __read(_a, 1), match = _b[0];
+            return match;
+        })
+            .filter(function (arg) { return arg !== ''; });
+        if (_.length > 1) {
+            _a = __read(_), command = _a[0], args = _a.slice(1);
+        }
+        if (options.args) {
+            args = __spreadArray(__spreadArray([], __read(args), false), __read(options.args), false);
+        }
+        var humanReadableCommand = !['npx', 'npm'].includes(command) ? command : args[0];
+        if (['ts-node'].includes(humanReadableCommand)) {
+            humanReadableCommand += " ".concat(args[1]);
+        }
+        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
+            command = "".concat(command, ".cmd");
+        }
+        return { command: command, humanReadableCommand: humanReadableCommand, args: args, cwd: cwd, crashOnError: crashOnError, timeout: timeout, isVerbose: isVerbose };
+    }
+    // TODO: This should show type error> execCommandNormalizeOptions({ command: '', commands: [''] });
+
+    /**
+     * Run one command in a shell
+     *
+     *
+     * Note: There are 2 similar functions in the codebase:
+     * - `$execCommand` which runs a single command
+     * - `$execCommands` which runs multiple commands
+     * Note: `$` is used to indicate that this function is not a pure function - it runs a command in a shell
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $execCommand(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$execCommand` can run only in Node environment.js');
+        }
+        return new Promise(function (resolve, reject) {
+            // eslint-disable-next-line prefer-const
+            var _a = $execCommandNormalizeOptions(options), command = _a.command, humanReadableCommand = _a.humanReadableCommand, args = _a.args, cwd = _a.cwd, crashOnError = _a.crashOnError, timeout = _a.timeout, _b = _a.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
+            if (timeout !== Infinity) {
+                // TODO: In waitasecond forTime(Infinity) should be equivalent to forEver()
+                waitasecond.forTime(timeout).then(function () {
+                    if (crashOnError) {
+                        reject(new Error("Command \"".concat(humanReadableCommand, "\" exceeded time limit of ").concat(timeout, "ms")));
+                    }
+                    else {
+                        console.warn("Command \"".concat(humanReadableCommand, "\" exceeded time limit of ").concat(timeout, "ms but continues running"));
+                        resolve('Command exceeded time limit');
+                    }
+                });
+            }
+            if (isVerbose) {
+                console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
+            }
+            try {
+                var commandProcess = child_process.spawn(command, args, { cwd: cwd, shell: true });
+                if (isVerbose) {
+                    commandProcess.on('message', function (message) {
+                        console.info({ message: message });
+                    });
+                }
+                var output_1 = [];
+                commandProcess.stdout.on('data', function (stdout) {
+                    output_1.push(stdout.toString());
+                    if (isVerbose) {
+                        console.info(stdout.toString());
+                    }
+                });
+                commandProcess.stderr.on('data', function (stderr) {
+                    output_1.push(stderr.toString());
+                    if (isVerbose && stderr.toString().trim()) {
+                        console.warn(stderr.toString());
+                    }
+                });
+                var finishWithCode = function (code) {
+                    if (code !== 0) {
+                        if (crashOnError) {
+                            reject(new Error(output_1.join('\n').trim() ||
+                                "Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code)));
+                        }
+                        else {
+                            if (isVerbose) {
+                                console.warn("Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code));
+                            }
+                            resolve(spaceTrim.spaceTrim(output_1.join('\n')));
+                        }
+                    }
+                    else {
+                        resolve(spaceTrim.spaceTrim(output_1.join('\n')));
+                    }
+                };
+                commandProcess.on('close', finishWithCode);
+                commandProcess.on('exit', finishWithCode);
+                commandProcess.on('disconnect', function () {
+                    // Note: Unexpected disconnection should always result in rejection
+                    reject(new Error("Command \"".concat(humanReadableCommand, "\" disconnected")));
+                });
+                commandProcess.on('error', function (error) {
+                    if (crashOnError) {
+                        reject(new Error("Command \"".concat(humanReadableCommand, "\" failed: \n").concat(error.message)));
+                    }
+                    else {
+                        if (isVerbose) {
+                            console.warn(error);
+                        }
+                        resolve(spaceTrim.spaceTrim(output_1.join('\n')));
+                    }
+                });
+            }
+            catch (error) {
+                // Note: Unexpected error in sync code should always result in rejection
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
     /**
      * @@@
      *
      * @private within the repository
      */
     function locateAppOnLinux(_a) {
-        var appName = _a.appName, linuxWhich = _a.linuxWhich;
+        var linuxWhich = _a.linuxWhich;
         return __awaiter(this, void 0, void 0, function () {
-            var _b, stderr, stdout, error_1;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var result, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
-                        _c.trys.push([0, 2, , 3]);
-                        return [4 /*yield*/, exec$1("which ".concat(linuxWhich))];
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, $execCommand({ crashOnError: true, command: "which ".concat(linuxWhich) })];
                     case 1:
-                        _b = _c.sent(), stderr = _b.stderr, stdout = _b.stdout;
-                        if (!stderr && stdout) {
-                            return [2 /*return*/, stdout.trim()];
-                        }
-                        throw new Error("Can not locate app ".concat(appName, " on Linux.\n ").concat(stderr));
+                        result = _b.sent();
+                        return [2 /*return*/, result.trim()];
                     case 2:
-                        error_1 = _c.sent();
+                        error_1 = _b.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
@@ -913,6 +840,29 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideFilesystemForNode(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+        }
+        (options || {}).isVerbose;
+        return {
+            stat: promises.stat,
+            access: promises.access,
+            constants: promises.constants,
+            readFile: promises.readFile,
+            writeFile: promises.writeFile,
+            readdir: promises.readdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
     /**
      * Checks if the file is executable
      *
@@ -945,43 +895,41 @@
     //       @see https://stackoverflow.com/questions/37000981/how-to-import-node-module-in-typescript-without-type-definitions
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     var userhome = require('userhome');
-    // Note: We want to use the `exec` as async function
-    var exec = util.promisify(child_process.exec);
     /**
      * @@@
      *
      * @private within the repository
      */
     function locateAppOnMacOs(_a) {
-        var appName = _a.appName, macOsName = _a.macOsName;
+        var macOsName = _a.macOsName;
         return __awaiter(this, void 0, void 0, function () {
-            var toExec, regPath, altPath, _b, stderr, stdout, error_1;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var toExec, regPath, altPath, result, error_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
-                        _c.trys.push([0, 6, , 7]);
+                        _b.trys.push([0, 6, , 7]);
                         toExec = "/Contents/MacOS/".concat(macOsName);
                         regPath = "/Applications/".concat(macOsName, ".app") + toExec;
                         altPath = userhome(regPath.slice(1));
                         return [4 /*yield*/, isExecutable(regPath, $provideFilesystemForNode())];
                     case 1:
-                        if (!_c.sent()) return [3 /*break*/, 2];
+                        if (!_b.sent()) return [3 /*break*/, 2];
                         return [2 /*return*/, regPath];
                     case 2: return [4 /*yield*/, isExecutable(altPath, $provideFilesystemForNode())];
                     case 3:
-                        if (_c.sent()) {
+                        if (_b.sent()) {
                             return [2 /*return*/, altPath];
                         }
-                        _c.label = 4;
-                    case 4: return [4 /*yield*/, exec("mdfind 'kMDItemDisplayName == \"".concat(macOsName, "\" && kMDItemKind == Application'"))];
+                        _b.label = 4;
+                    case 4: return [4 /*yield*/, $execCommand({
+                            crashOnError: true,
+                            command: "mdfind 'kMDItemDisplayName == \"".concat(macOsName, "\" && kMDItemKind == Application'"),
+                        })];
                     case 5:
-                        _b = _c.sent(), stderr = _b.stderr, stdout = _b.stdout;
-                        if (!stderr && stdout) {
-                            return [2 /*return*/, stdout.trim() + toExec];
-                        }
-                        throw new Error("Can not locate app ".concat(appName, " on macOS.\n ").concat(stderr));
+                        result = _b.sent();
+                        return [2 /*return*/, result.trim() + toExec];
                     case 6:
-                        error_1 = _c.sent();
+                        error_1 = _b.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
@@ -1082,7 +1030,7 @@
         }
         else if (process.platform === 'darwin') {
             if (macOsName) {
-                return locateAppOnMacOs({ appName: appName, macOsName: macOsName });
+                return locateAppOnMacOs({ macOsName: macOsName });
             }
             else {
                 throw new Error("".concat(appName, " is not available on macOS."));
@@ -1090,7 +1038,7 @@
         }
         else {
             if (linuxWhich) {
-                return locateAppOnLinux({ appName: appName, linuxWhich: linuxWhich });
+                return locateAppOnLinux({ linuxWhich: linuxWhich });
             }
             else {
                 throw new Error("".concat(appName, " is not available on Linux."));
@@ -1462,6 +1410,145 @@
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
+    /**
+     * @@@
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it access global scope
+     *
+     *  @private internal function of `$Register`
+     */
+    function $getGlobalScope() {
+        return Function('return this')();
+    }
+
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @returns @@@
+     * @example 'HELLO_WORLD'
+     * @example 'I_LOVE_PROMPTBOOK'
+     * @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;
+            }
+        }
+        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);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        normalizedName = normalizedName.replace(/_+/g, '_');
+        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+        normalizedName = normalizedName.replace(/^_/, '');
+        normalizedName = normalizedName.replace(/_$/, '');
+        return normalizedName;
+    }
+    /**
+     * TODO: Tests
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+     * TODO: [🌺] Use some intermediate util splitWords
+     */
+
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @returns @@@
+     * @example 'hello_world'
+     * @example 'i_love_promptbook'
+     * @public exported from `@promptbook/utils`
+     */
+    function normalizeTo_snake_case(text) {
+        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+    }
+
+    /**
+     * Register is @@@
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
+     *
+     * @private internal utility, exported are only signleton instances of this class
+     */
+    var $Register = /** @class */ (function () {
+        function $Register(registerName) {
+            this.registerName = registerName;
+            var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
+            var 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]));
+            }
+            this.storage = globalScope[storageName];
+        }
+        $Register.prototype.list = function () {
+            // <- 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];
+            if (!existingRegistration) {
+                this.storage.push(registered);
+            }
+            else {
+                this.storage[existingRegistrationIndex] = registered;
+            }
+            return {
+                registerName: this.registerName,
+                packageName: packageName,
+                className: className,
+                get isDestroyed() {
+                    return false;
+                },
+                destroy: function () {
+                    throw new NotYetImplementedError("Registration to ".concat(this.registerName, " is permanent in this version of Promptbook"));
+                },
+            };
+        };
+        return $Register;
+    }());
+
     /**
      * @@@
      *
@@ -2216,7 +2303,7 @@
      *
      * @private within the repository
      */
-    var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
+    var REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
     /**
      * @@@
      *
@@ -5673,6 +5760,18 @@
      * TODO: [®] DRY Register logic
      */
 
+    /**
+     * @@@
+     *
+     * Note: `$` is used to indicate that this interacts with the global scope
+     * @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');
+    /**
+     * TODO: [®] DRY Register logic
+     */
+
     /**
      * Creates a message with all registered scrapers
      *
@@ -6472,6 +6571,62 @@
      *       @see https://docs.anthropic.com/en/docs/test-and-evaluate/strengthen-guardrails/increase-consistency#specify-the-desired-output-format
      */
 
+    /**
+     * @@@
+     *
+     * 1) @@@
+     * 2) @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideScrapersForNode(tools, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, scrapers, _d, _e, scraperFactory, scraper, e_1_1;
+            var e_1, _f;
+            return __generator(this, function (_g) {
+                switch (_g.label) {
+                    case 0:
+                        if (!$isRunningInNode()) {
+                            throw new EnvironmentMismatchError('Function `$getScrapersForNode` works only in Node.js environment');
+                        }
+                        _a = options || {}, _a.isAutoInstalled, _a.isVerbose;
+                        scrapers = [];
+                        _g.label = 1;
+                    case 1:
+                        _g.trys.push([1, 6, 7, 8]);
+                        _d = __values($scrapersRegister.list()), _e = _d.next();
+                        _g.label = 2;
+                    case 2:
+                        if (!!_e.done) return [3 /*break*/, 5];
+                        scraperFactory = _e.value;
+                        return [4 /*yield*/, scraperFactory(tools, options || {})];
+                    case 3:
+                        scraper = _g.sent();
+                        scrapers.push(scraper);
+                        _g.label = 4;
+                    case 4:
+                        _e = _d.next();
+                        return [3 /*break*/, 2];
+                    case 5: return [3 /*break*/, 8];
+                    case 6:
+                        e_1_1 = _g.sent();
+                        e_1 = { error: e_1_1 };
+                        return [3 /*break*/, 8];
+                    case 7:
+                        try {
+                            if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                        return [7 /*endfinally*/];
+                    case 8: return [2 /*return*/, scrapers];
+                }
+            });
+        });
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
     /**
      * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
      *