@promptbook/cli 0.72.0-14 → 0.72.0-15

package/umd/index.umd.js

@@ -39,7 +39,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.72.0-13';
+    var PROMPTBOOK_VERSION = '0.72.0-14';
     // TODO: [main] !!!! List here all the versions and annotate + put into script
 
     /*! *****************************************************************************
@@ -412,7 +412,8 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var CLAIM = "Supercharge LLM models with Promptbook";
+    var CLAIM = "Build responsible, controlled and transparent applications on top of LLM models!";
+    //            <- TODO: [🐊] Pick the best claim
     /**
      * Warning message for the generated sections and files files
      *
@@ -445,23 +446,30 @@
      */
     var IMMEDIATE_TIME = 10;
     /**
-     * The maximum number of (LLM) tasks running in parallel
+     * The maximum length of the (generated) filename
      *
      * @public exported from `@promptbook/core`
      */
-    var MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
+    var MAX_FILENAME_LENGTH = 30;
     /**
-     * The maximum number of attempts to execute LLM task before giving up
+     * Strategy for caching the intermediate results for knowledge sources
      *
      * @public exported from `@promptbook/core`
      */
-    var MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
+    var DEFAULT_INTERMEDIATE_FILES_STRATEGY = 'HIDE_AND_KEEP';
+    //                                                     <- TODO: [😡] Change to 'VISIBLE'
     /**
-     * The maximum length of the (generated) filename
+     * The maximum number of (LLM) tasks running in parallel
      *
      * @public exported from `@promptbook/core`
      */
-    var MAX_FILENAME_LENGTH = 30;
+    var DEFAULT_MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
+    /**
+     * The maximum number of attempts to execute LLM task before giving up
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var DEFAULT_MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
     /**
      * Where to store the cache of executions for promptbook CLI
      *
@@ -469,7 +477,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
+    var DEFAULT_EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
     /**
      * Where to store the scrape cache
      *
@@ -477,13 +485,13 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var SCRAPE_CACHE_DIRNAME = '/.promptbook/scrape-cache';
+    var DEFAULT_SCRAPE_CACHE_DIRNAME = '/.promptbook/scrape-cache';
     /**
      * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
      *
      * @public exported from `@promptbook/core`
      */
-    var PIPELINE_COLLECTION_BASE_FILENAME = "index";
+    var DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME = "index";
     /**
      * Nonce which is used for replacing things in strings
      *
@@ -547,13 +555,13 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var IS_VERBOSE = false;
+    var DEFAULT_IS_VERBOSE = false;
     /**
      * @@@
      *
      * @public exported from `@promptbook/core`
      */
-    var IS_AUTO_INSTALLED = false;
+    var DEFAULT_IS_AUTO_INSTALLED = false;
     /**
      * @@@
      *
@@ -626,271 +634,6 @@
      * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
      */
 
-    /**
-     * Just marks a place of place where should be something implemented
-     * No side effects.
-     *
-     * Note: It can be usefull suppressing eslint errors of unused variables
-     *
-     * @param value any values
-     * @returns void
-     * @private within the repository
-     */
-    function TODO_USE() {
-        var value = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            value[_i] = arguments[_i];
-        }
-    }
-
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $provideFilesystemForNode(options) {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
-        }
-        var _a = (options || {}).isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
-        TODO_USE(isVerbose);
-        return {
-            stat: promises.stat,
-            access: promises.access,
-            constants: promises.constants,
-            readFile: promises.readFile,
-            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));
-
-    /**
-     * @@@
-     *
-     * 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<Array<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, _b, isAutoInstalled, _c, isVerbose, 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 || {}, _b = _a.isAutoInstalled, isAutoInstalled = _b === void 0 ? IS_AUTO_INSTALLED : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? IS_VERBOSE : _c;
-                        TODO_USE(isAutoInstalled);
-                        TODO_USE(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
-     */
-
     /**
      * Converts PipelineCollection to serialized JSON
      *
@@ -976,7 +719,6 @@
             pipelineString += '\n\n';
             pipelineString += description;
         }
-        // TODO:> const commands: Array<Command>
         var commands = [];
         if (pipelineUrl) {
             commands.push("PIPELINE URL ".concat(pipelineUrl));
@@ -1032,7 +774,6 @@
                     pipelineString += '\n\n';
                     pipelineString += description_1;
                 }
-                // TODO:> const commands: Array<Command>
                 var commands_1 = [];
                 var contentLanguage = 'text';
                 if (templateType === 'PROMPT_TEMPLATE') {
@@ -1331,8 +1072,7 @@
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
      *
      * Note: Internal utility of `joinLlmExecutionTools` but exposed type
-     * @public exported from `@promptbook/types`
-     * TODO: !!!!!! Export as runtime class not just type
+     * @public exported from `@promptbook/core`
      */
     var MultipleLlmExecutionTools = /** @class */ (function () {
         /**
@@ -2491,6 +2231,22 @@
         return LimitReachedError;
     }(Error));
 
+    /**
+     * This error type indicates that some part of the code is not implemented yet
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var NotYetImplementedError = /** @class */ (function (_super) {
+        __extends(NotYetImplementedError, _super);
+        function NotYetImplementedError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+            _this.name = 'NotYetImplementedError';
+            Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
+            return _this;
+        }
+        return NotYetImplementedError;
+    }(Error));
+
     /**
      * Index of all custom errors
      *
@@ -2552,6 +2308,7 @@
         }
     }
     /**
+     * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
      * TODO: [🧠] Can this return type be better typed than void
      */
 
@@ -2809,6 +2566,23 @@
         return union;
     }
 
+    /**
+     * Just marks a place of place where should be something implemented
+     * No side effects.
+     *
+     * Note: It can be usefull suppressing eslint errors of unused variables
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function TODO_USE() {
+        var value = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            value[_i] = arguments[_i];
+        }
+    }
+
     /**
      * This error indicates problems parsing the format value
      *
@@ -3841,12 +3615,11 @@
      */
     function executeAttempts(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var jokerParameterNames, priority, maxAttempts, preparedContent, parameters, template, preparedPipeline, tools, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, $ongoingTemplateResult, _llms, llmTools, _loop_1, attempt, state_1;
+            var jokerParameterNames, priority, maxAttempts, preparedContent, parameters, template, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, $ongoingTemplateResult, _llms, llmTools, _loop_1, attempt, state_1;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        jokerParameterNames = options.jokerParameterNames, priority = options.priority, maxAttempts = options.maxAttempts, preparedContent = options.preparedContent, parameters = options.parameters, template = options.template, preparedPipeline = options.preparedPipeline, tools = options.tools, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
-                        maxExecutionAttempts = settings.maxExecutionAttempts;
+                        jokerParameterNames = options.jokerParameterNames, priority = options.priority, maxAttempts = options.maxAttempts, preparedContent = options.preparedContent, parameters = options.parameters, template = options.template, preparedPipeline = options.preparedPipeline, tools = options.tools, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, maxExecutionAttempts = options.maxExecutionAttempts;
                         $ongoingTemplateResult = {
                             $result: null,
                             $resultString: null,
@@ -4212,12 +3985,12 @@
      */
     function executeFormatSubvalues(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var template, jokerParameterNames, parameters, priority, pipelineIdentification, settings, parameterValue, formatDefinition, subvalueDefinition, formatSettings, resultString;
+            var template, jokerParameterNames, parameters, priority, csvSettings, pipelineIdentification, parameterValue, formatDefinition, subvalueDefinition, formatSettings, resultString;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        template = options.template, jokerParameterNames = options.jokerParameterNames, parameters = options.parameters, priority = options.priority, pipelineIdentification = options.pipelineIdentification, settings = options.settings;
+                        template = options.template, jokerParameterNames = options.jokerParameterNames, parameters = options.parameters, priority = options.priority, csvSettings = options.csvSettings, pipelineIdentification = options.pipelineIdentification;
                         if (template.foreach === undefined) {
                             return [2 /*return*/, /* not await */ executeAttempts(options)];
                         }
@@ -4247,7 +4020,7 @@
                                 .join('\n')), "\n\n                    [\u26F7] This should never happen because subformat name should be validated during parsing\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
                         }
                         if (formatDefinition.formatName === 'CSV') {
-                            formatSettings = settings.csvSettings;
+                            formatSettings = csvSettings;
                             // <- TODO: [🤹‍♂️] More universal, make simmilar pattern for other formats for example \n vs \r\n in text
                         }
                         return [4 /*yield*/, subvalueDefinition.mapValues(parameterValue, template.foreach.outputSubparameterName, formatSettings, function (subparameters, index) { return __awaiter(_this, void 0, void 0, function () {
@@ -4400,13 +4173,12 @@
      */
     function executeTemplate(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var currentTemplate, preparedPipeline, parametersToPass, tools, onProgress, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
-            var e_1, _f, _g;
-            return __generator(this, function (_h) {
-                switch (_h.label) {
+            var currentTemplate, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, _a, maxExecutionAttempts, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _b, _c, _d, definedParameterNames, parameters, _loop_1, _e, _f, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
+            var e_1, _g, _h;
+            return __generator(this, function (_j) {
+                switch (_j.label) {
                     case 0:
-                        currentTemplate = options.currentTemplate, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
-                        maxExecutionAttempts = settings.maxExecutionAttempts;
+                        currentTemplate = options.currentTemplate, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, _a = options.maxExecutionAttempts, maxExecutionAttempts = _a === void 0 ? DEFAULT_MAX_EXECUTION_ATTEMPTS : _a;
                         name = "pipeline-executor-frame-".concat(currentTemplate.name);
                         title = currentTemplate.title;
                         priority = preparedPipeline.templates.length - preparedPipeline.templates.indexOf(currentTemplate);
@@ -4421,7 +4193,7 @@
                                 // <- [🍸]
                             })];
                     case 1:
-                        _h.sent();
+                        _j.sent();
                         usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
                         dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
                         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -4432,15 +4204,15 @@
                                 .map(function (name) { return "{".concat(name, "}"); })
                                 .join(', '), "\n\n                    ").concat(block(pipelineIdentification), "\n\n                "); }));
                         }
-                        _b = (_a = Object).freeze;
-                        _c = [{}];
+                        _c = (_b = Object).freeze;
+                        _d = [{}];
                         return [4 /*yield*/, getReservedParametersForTemplate({
                                 preparedPipeline: preparedPipeline,
                                 template: currentTemplate,
                                 pipelineIdentification: pipelineIdentification,
                             })];
                     case 2:
-                        definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
+                        definedParameters = _c.apply(_b, [__assign.apply(void 0, [__assign.apply(void 0, _d.concat([(_j.sent())])), parametersToPass])]);
                         definedParameterNames = new Set(Object.keys(definedParameters));
                         parameters = {};
                         _loop_1 = function (parameterName) {
@@ -4460,15 +4232,15 @@
                         try {
                             // Note: [2] Check that all used parameters are defined and removing unused parameters for this template
                             // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
-                            for (_d = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _e = _d.next(); !_e.done; _e = _d.next()) {
-                                parameterName = _e.value;
+                            for (_e = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                                parameterName = _f.value;
                                 _loop_1(parameterName);
                             }
                         }
                         catch (e_1_1) { e_1 = { error: e_1_1 }; }
                         finally {
                             try {
-                                if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                                if (_f && !_f.done && (_g = _e.return)) _g.call(_e);
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
@@ -4488,12 +4260,11 @@
                                 template: currentTemplate,
                                 preparedPipeline: preparedPipeline,
                                 tools: tools,
-                                settings: settings,
                                 $executionReport: $executionReport,
                                 pipelineIdentification: pipelineIdentification,
                             })];
                     case 3:
-                        resultString = _h.sent();
+                        resultString = _j.sent();
                         return [4 /*yield*/, onProgress({
                                 name: name,
                                 title: title,
@@ -4505,12 +4276,12 @@
                                 // <- [🍸]
                             })];
                     case 4:
-                        _h.sent();
-                        return [2 /*return*/, Object.freeze((_g = {},
-                                _g[currentTemplate.resultingParameterName] = 
+                        _j.sent();
+                        return [2 /*return*/, Object.freeze((_h = {},
+                                _h[currentTemplate.resultingParameterName] = 
                                 // <- Note: [👩‍👩‍👧] No need to detect parameter collision here because pipeline checks logic consistency during construction
                                 resultString,
-                                _g))];
+                                _h))];
                 }
             });
         });
@@ -4569,13 +4340,12 @@
      */
     function executePipeline(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, settings, maxParallelCount, rootDirname, _a, isVerbose, preparedPipeline, errors, warnings, executionReport, isReturned, _b, _c, parameter, e_1_1, _loop_1, _d, _e, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
+            var inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, _a, isVerbose, preparedPipeline, errors, warnings, executionReport, isReturned, _b, _c, parameter, e_1_1, _loop_1, _d, _e, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
             var e_1, _f, e_2, _g;
             return __generator(this, function (_h) {
                 switch (_h.label) {
                     case 0:
-                        inputParameters = options.inputParameters, tools = options.tools, onProgress = options.onProgress, pipeline = options.pipeline, setPreparedPipeline = options.setPreparedPipeline, pipelineIdentification = options.pipelineIdentification, settings = options.settings;
-                        maxParallelCount = settings.maxParallelCount, rootDirname = settings.rootDirname, _a = settings.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
+                        inputParameters = options.inputParameters, tools = options.tools, onProgress = options.onProgress, pipeline = options.pipeline, setPreparedPipeline = options.setPreparedPipeline, pipelineIdentification = options.pipelineIdentification, maxParallelCount = options.maxParallelCount, rootDirname = options.rootDirname, _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
                         preparedPipeline = options.preparedPipeline;
                         if (!(preparedPipeline === undefined)) return [3 /*break*/, 2];
                         return [4 /*yield*/, preparePipeline(pipeline, tools, {
@@ -4760,12 +4530,7 @@
                                         return [3 /*break*/, 4];
                                     case 3:
                                         unresovedTemplates_1 = unresovedTemplates_1.filter(function (template) { return template !== currentTemplate; });
-                                        work_1 = executeTemplate({
-                                            currentTemplate: currentTemplate,
-                                            preparedPipeline: preparedPipeline,
-                                            parametersToPass: parametersToPass,
-                                            tools: tools,
-                                            onProgress: function (progress) {
+                                        work_1 = executeTemplate(__assign(__assign({}, options), { currentTemplate: currentTemplate, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (progress) {
                                                 if (isReturned) {
                                                     throw new UnexpectedError(spaceTrim.spaceTrim(function (block) { return "\n                                        Can not call `onProgress` after pipeline execution is finished\n\n                                        ".concat(block(pipelineIdentification), "\n\n                                        ").concat(block(JSON.stringify(progress, null, 4)
                                                         .split('\n')
@@ -4775,11 +4540,7 @@
                                                 if (onProgress) {
                                                     onProgress(progress);
                                                 }
-                                            },
-                                            settings: settings,
-                                            $executionReport: executionReport,
-                                            pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Template name: ").concat(currentTemplate.name, "\n                            Template title: ").concat(currentTemplate.title, "\n                        "); }),
-                                        })
+                                            }, $executionReport: executionReport, pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Template name: ").concat(currentTemplate.name, "\n                            Template title: ").concat(currentTemplate.title, "\n                        "); }) }))
                                             .then(function (newParametersToPass) {
                                             parametersToPass = __assign(__assign({}, newParametersToPass), parametersToPass);
                                             resovedParameterNames_1 = __spreadArray(__spreadArray([], __read(resovedParameterNames_1), false), [currentTemplate.resultingParameterName], false);
@@ -4883,8 +4644,7 @@
      */
     function createPipelineExecutor(options) {
         var _this = this;
-        var pipeline = options.pipeline, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
-        var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? MAX_EXECUTION_ATTEMPTS : _b, _c = settings.maxParallelCount, maxParallelCount = _c === void 0 ? MAX_PARALLEL_COUNT : _c, _d = settings.csvSettings, csvSettings = _d === void 0 ? DEFAULT_CSV_SETTINGS : _d, _e = settings.isVerbose, isVerbose = _e === void 0 ? IS_VERBOSE : _e, _f = settings.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _f === void 0 ? false : _f, _g = settings.rootDirname, rootDirname = _g === void 0 ? null : _g;
+        var pipeline = options.pipeline, tools = options.tools, _a = options.maxExecutionAttempts, maxExecutionAttempts = _a === void 0 ? DEFAULT_MAX_EXECUTION_ATTEMPTS : _a, _b = options.maxParallelCount, maxParallelCount = _b === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _b, _c = options.csvSettings, csvSettings = _c === void 0 ? DEFAULT_CSV_SETTINGS : _c, _d = options.isVerbose, isVerbose = _d === void 0 ? DEFAULT_IS_VERBOSE : _d, _e = options.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _e === void 0 ? false : _e, _f = options.rootDirname, rootDirname = _f === void 0 ? null : _f;
         validatePipeline(pipeline);
         var pipelineIdentification = (function () {
             // Note: This is a 😐 implementation of [🚞]
@@ -4918,14 +4678,12 @@
                         tools: tools,
                         onProgress: onProgress,
                         pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(pipelineIdentification), "\n                    ").concat(runCount === 1 ? '' : "Run #".concat(runCount), "\n                "); }),
-                        settings: {
-                            maxExecutionAttempts: maxExecutionAttempts,
-                            maxParallelCount: maxParallelCount,
-                            csvSettings: csvSettings,
-                            isVerbose: isVerbose,
-                            isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
-                            rootDirname: rootDirname,
-                        },
+                        maxExecutionAttempts: maxExecutionAttempts,
+                        maxParallelCount: maxParallelCount,
+                        csvSettings: csvSettings,
+                        isVerbose: isVerbose,
+                        isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
+                        rootDirname: rootDirname,
                     })];
             });
         }); };
@@ -4948,7 +4706,7 @@
             return __generator(this, function (_d) {
                 switch (_d.label) {
                     case 0:
-                        _a = options.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
+                        _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
                         if (tools === undefined || tools.llm === undefined) {
                             throw new MissingToolsError('LLM tools are required for preparing persona');
                         }
@@ -5004,20 +4762,171 @@
      */
 
     /**
-     * This error indicates that the promptbook can not retrieve knowledge from external sources
+     * This error indicates that the promptbook can not retrieve knowledge from external sources
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var KnowledgeScrapeError = /** @class */ (function (_super) {
+        __extends(KnowledgeScrapeError, _super);
+        function KnowledgeScrapeError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'KnowledgeScrapeError';
+            Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
+            return _this;
+        }
+        return KnowledgeScrapeError;
+    }(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 KnowledgeScrapeError = /** @class */ (function (_super) {
-        __extends(KnowledgeScrapeError, _super);
-        function KnowledgeScrapeError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'KnowledgeScrapeError';
-            Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
-            return _this;
-        }
-        return KnowledgeScrapeError;
-    }(Error));
+    var $scrapersMetadataRegister = new $Register('scrapers_metadata');
+    /**
+     * TODO: [®] DRY Register logic
+     */
 
     /**
      * @@@
@@ -5026,12 +4935,12 @@
      * @singleton Only one instance of each register is created per build, but thare can be more @@@
      * @public exported from `@promptbook/core`
      */
-    var $scrapersMetadataRegister = new $Register('scrapers_metadata');
+    var $scrapersRegister = new $Register('scraper_constructors');
     /**
      * TODO: [®] DRY Register logic
      */
 
-    // TODO: !!!!!! Maybe delete this function
+    // TODO: !!!!!!last - Maybe delete this function
     /**
      * Creates a message with all registered scrapers
      *
@@ -5198,7 +5107,6 @@
      * @private within the repository
      */
     function sourceContentToName(sourceContent) {
-        // TODO: !!!!!! Better name for source than gibberish hash
         var hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(JSON.stringify(sourceContent)))
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
             .toString( /* hex */)
@@ -5311,7 +5219,7 @@
                     case 0:
                         sourceContent = knowledgeSource.sourceContent;
                         name = knowledgeSource.name;
-                        _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _d = _b.isVerbose, isVerbose = _d === void 0 ? IS_VERBOSE : _d;
+                        _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _d = _b.isVerbose, isVerbose = _d === void 0 ? DEFAULT_IS_VERBOSE : _d;
                         TODO_USE(isVerbose);
                         if (!name) {
                             name = sourceContentToName(sourceContent);
@@ -5401,7 +5309,7 @@
                                                     content = _a.sent();
                                                     return [2 /*return*/, new Blob([
                                                             content,
-                                                            // <- TODO: !!!!!! Maybe not working
+                                                            // <- TODO: !!!!!! Test that this is working
                                                         ], { type: mimeType_1 })];
                                             }
                                         });
@@ -5464,7 +5372,7 @@
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a, rootDirname = options.rootDirname, _b = options.isVerbose, isVerbose = _b === void 0 ? IS_VERBOSE : _b;
+                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a, rootDirname = options.rootDirname, _b = options.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
                         knowledgePreparedUnflatten = new Array(knowledgeSources.length);
                         return [4 /*yield*/, forEachAsync(knowledgeSources, { maxParallelCount: maxParallelCount }, function (knowledgeSource, index) { return __awaiter(_this, void 0, void 0, function () {
                                 var partialPieces, sourceHandler, _a, _b, scraper, partialPiecesUnchecked, e_1_1, pieces;
@@ -5493,7 +5401,8 @@
                                         case 4:
                                             partialPiecesUnchecked = _d.sent();
                                             if (partialPiecesUnchecked !== null) {
-                                                partialPieces = partialPiecesUnchecked;
+                                                partialPieces = __spreadArray([], __read(partialPiecesUnchecked), false);
+                                                // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                                                 return [3 /*break*/, 6];
                                             }
                                             _d.label = 5;
@@ -5541,7 +5450,7 @@
     >   /**
     >    * Unprepared knowledge
     >    * /
-    >   readonly knowledgeSources: Array<KnowledgeSourceJson>;
+    >   readonly knowledgeSources: ReadonlyArray<KnowledgeSourceJson>;
     > };
     >
     > export async function prepareKnowledgePieces(
@@ -5599,7 +5508,7 @@
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
-                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a;
+                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a;
                         templates = pipeline.templates, parameters = pipeline.parameters, knowledgePiecesCount = pipeline.knowledgePiecesCount;
                         // TODO: [main] !!!!! Apply samples to each template (if missing and is for the template defined)
                         TODO_USE(parameters);
@@ -5661,7 +5570,7 @@
                         if (isPipelinePrepared(pipeline)) {
                             return [2 /*return*/, pipeline];
                         }
-                        rootDirname = options.rootDirname, _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a, _b = options.isVerbose, isVerbose = _b === void 0 ? IS_VERBOSE : _b;
+                        rootDirname = options.rootDirname, _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a, _b = options.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
                         parameters = pipeline.parameters, templates = pipeline.templates, knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                         if (tools === undefined || tools.llm === undefined) {
                             throw new MissingToolsError('LLM tools are required for preparing the pipeline');
@@ -5719,7 +5628,9 @@
                         // ----- /Templates preparation -----
                         // Note: Count total usage
                         currentPreparation.usage = llmToolsWithUsage.getTotalUsage();
-                        return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { templates: templatesPrepared, knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations }))];
+                        return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { templates: __spreadArray([], __read(templatesPrepared), false), 
+                                // <- TODO: [🪓] Here should be no need for spreading new array, just ` templates: templatesPrepared`
+                                knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: __spreadArray([], __read(preparations), false) }))];
                 }
             });
         });
@@ -8643,7 +8554,7 @@
      */
     function createLlmToolsFromConfiguration(configuration, options) {
         if (options === void 0) { options = {}; }
-        var _a = options.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a, userId = options.userId;
+        var _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a, userId = options.userId;
         var llmTools = configuration.map(function (llmConfiguration) {
             var registeredItem = $llmToolsRegister
                 .list()
@@ -8704,6 +8615,115 @@
      * TODO: [®] DRY Register logic
      */
 
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideExecutablesForNode(options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, isAutoInstalled, _c, isVerbose;
+            return __generator(this, function (_d) {
+                if (!$isRunningInNode()) {
+                    throw new EnvironmentMismatchError('Function `$getScrapersForNode` works only in Node.js environment');
+                }
+                _a = options || {}, _b = _a.isAutoInstalled, isAutoInstalled = _b === void 0 ? DEFAULT_IS_AUTO_INSTALLED : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c;
+                TODO_USE(isAutoInstalled);
+                TODO_USE(isVerbose);
+                return [2 /*return*/, {
+                        // TODO: !!!!!! use `locate-app` library here
+                        pandocPath: 'C:/Users/me/AppData/Local/Pandoc/pandoc.exe',
+                        libreOfficePath: 'C:/Program Files/LibreOffice/program/swriter.exe',
+                    }];
+            });
+        });
+    }
+    /**
+     * TODO: [🧠] THis should be maybe in different folder
+     * 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');
+        }
+        var _a = (options || {}).isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
+        TODO_USE(isVerbose);
+        return {
+            stat: promises.stat,
+            access: promises.access,
+            constants: promises.constants,
+            readFile: promises.readFile,
+            readdir: promises.readdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * @@@
+     *
+     * 1) @@@
+     * 2) @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideScrapersForNode(tools, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, isAutoInstalled, _c, isVerbose, 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 || {}, _b = _a.isAutoInstalled, isAutoInstalled = _b === void 0 ? DEFAULT_IS_AUTO_INSTALLED : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c;
+                        TODO_USE(isAutoInstalled);
+                        TODO_USE(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
+     */
+
     /**
      * Extracts code block from markdown.
      *
@@ -9158,7 +9178,7 @@
      */
     function $provideExecutionToolsForNode(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var fs, llm, tools;
+            var fs, llm, executables, tools;
             var _a;
             return __generator(this, function (_b) {
                 switch (_b.label) {
@@ -9168,12 +9188,16 @@
                         }
                         fs = $provideFilesystemForNode();
                         llm = $provideLlmToolsFromEnv(options);
+                        return [4 /*yield*/, $provideExecutablesForNode(options)];
+                    case 1:
+                        executables = _b.sent();
                         _a = {
                             llm: llm,
-                            fs: fs
+                            fs: fs,
+                            executables: executables
                         };
-                        return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm }, options)];
-                    case 1:
+                        return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, options)];
+                    case 2:
                         tools = (_a.scrapers = _b.sent(),
                             _a.script = [new JavascriptExecutionTools(options)],
                             _a);
@@ -9411,7 +9435,9 @@
                             throw new EnvironmentMismatchError('Can not create collection without filesystem tools');
                             //          <- TODO: [🧠] What is the best error type here`
                         }
-                        makedLibraryFilePath = path.join(path$1, "".concat(PIPELINE_COLLECTION_BASE_FILENAME, ".json"));
+                        makedLibraryFilePath = path.join(path$1, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
+                        // <- TODO: [🦒] Allow to override (pass different value into the function)
+                        , ".json"));
                         return [4 /*yield*/, isFileExisting(makedLibraryFilePath, tools.fs)];
                     case 3:
                         if (!(_f.sent())) {
@@ -9422,7 +9448,7 @@
                             // TODO: !! Implement;
                             // TODO: [🌗]
                         }
-                        _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? IS_VERBOSE : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e;
+                        _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e;
                         collection = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
                             var fileNames, collection, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
                             var e_1, _a;
@@ -9894,7 +9920,7 @@
     function cacheLlmTools(llmTools, options) {
         var _this = this;
         if (options === void 0) { options = {}; }
-        var _a = options.storage, storage = _a === void 0 ? new MemoryStorage() : _a, _b = options.isReloaded, isReloaded = _b === void 0 ? false : _b;
+        var _a = options.storage, storage = _a === void 0 ? new MemoryStorage() : _a, _b = options.isCacheReloaded, isCacheReloaded = _b === void 0 ? false : _b;
         var proxyTools = __assign(__assign({}, llmTools), { 
             // <- Note: [🥫]
             get title() {
@@ -9916,7 +9942,7 @@
                         key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
                             '-' +
                             sha256__default["default"](hexEncoder__default["default"].parse(JSON.stringify(prompt.parameters))).toString( /* hex */));
-                        if (!!isReloaded) return [3 /*break*/, 2];
+                        if (!!isCacheReloaded) return [3 /*break*/, 2];
                         return [4 /*yield*/, storage.getItem(key)];
                     case 1:
                         _a = _c.sent();
@@ -10002,12 +10028,14 @@
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsForTestingAndScriptsAndPlayground` works only in Node.js environment');
         }
-        var _a = (options !== null && options !== void 0 ? options : {}).isCacheCleaned, isCacheCleaned = _a === void 0 ? false : _a;
+        var isCacheReloaded = (options !== null && options !== void 0 ? options : {}).isCacheReloaded;
         return cacheLlmTools(countTotalUsage(
         //        <- Note: for example here we don`t want the [🌯]
         $provideLlmToolsFromEnv()), {
-            storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, { rootFolderPath: path.join(process.cwd(), EXECUTIONS_CACHE_DIRNAME) }),
-            isReloaded: isCacheCleaned,
+            storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
+                rootFolderPath: path.join(process.cwd(), DEFAULT_EXECUTIONS_CACHE_DIRNAME),
+            }),
+            isCacheReloaded: isCacheReloaded,
         });
     }
     /**
@@ -10034,13 +10062,13 @@
         makeCommand.option('-f, --format <format>', spaceTrim__default["default"]("\n            Output format of builded collection \"javascript\", \"typescript\" or \"json\"\n\n            Note: You can use multiple formats separated by comma\n        "), 'javascript' /* <- Note: [🏳‍🌈] */);
         makeCommand.option('--no-validation', "Do not validate logic of pipelines in collection", true);
         makeCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
-        makeCommand.option('--reload-cache', "Call LLM models even if same prompt with result is in the cache", false);
+        makeCommand.option('--reload', "Call LLM models even if same prompt with result is in the cache", false);
         makeCommand.option('--verbose', "Is output verbose", false);
-        makeCommand.option('-o, --out-file <path>', spaceTrim__default["default"]("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), PIPELINE_COLLECTION_BASE_FILENAME);
+        makeCommand.option('-o, --out-file <path>', spaceTrim__default["default"]("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
         makeCommand.action(function (path$1, _a) {
-            var projectName = _a.projectName, format = _a.format, validation = _a.validation, isCacheCleaned = _a.reloadCache, isVerbose = _a.verbose, outFile = _a.outFile;
+            var projectName = _a.projectName, format = _a.format, validation = _a.validation, isCacheReloaded = _a.reloadCache, isVerbose = _a.verbose, outFile = _a.outFile;
             return __awaiter(_this, void 0, void 0, function () {
-                var formats, validations, options, fs, llm, tools, collection, validations_1, validations_1_1, validation_1, _b, _c, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
+                var formats, validations, options, fs, llm, executables, tools, collection, validations_1, validations_1_1, validation_1, _b, _c, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
                 var _d, e_2, _e, e_1, _f;
                 var _this = this;
                 return __generator(this, function (_g) {
@@ -10054,22 +10082,25 @@
                                 .split(',')
                                 .map(function (_) { return _.trim(); })
                                 .filter(function (_) { return _ !== ''; });
-                            if (outFile !== PIPELINE_COLLECTION_BASE_FILENAME && formats.length !== 1) {
+                            if (outFile !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME && formats.length !== 1) {
                                 console.error(colors__default["default"].red("You can only use one format if you specify --out-file"));
                                 process.exit(1);
                             }
                             options = {
                                 isVerbose: isVerbose,
-                                isCacheCleaned: isCacheCleaned,
+                                isCacheReloaded: isCacheReloaded,
                             };
                             fs = $provideFilesystemForNode(options);
                             llm = $provideLlmToolsForCli(options);
+                            return [4 /*yield*/, $provideExecutablesForNode(options)];
+                        case 1:
+                            executables = _g.sent();
                             _d = {
                                 llm: llm,
                                 fs: fs
                             };
-                            return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm }, options)];
-                        case 1:
+                            return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, options)];
+                        case 2:
                             tools = (_d.scrapers = _g.sent(),
                                 _d.script = [
                                 /*new JavascriptExecutionTools(options)*/
@@ -10078,31 +10109,31 @@
                             return [4 /*yield*/, createCollectionFromDirectory(path$1, tools, {
                                     isVerbose: isVerbose,
                                     isRecursive: true,
-                                    // <- TODO: [🍖] isCacheReloaded
+                                    // <- TODO: [🍖] Add `intermediateFilesStrategy`
                                 })];
-                        case 2:
-                            collection = _g.sent();
-                            _g.label = 3;
                         case 3:
-                            _g.trys.push([3, 15, 16, 17]);
-                            validations_1 = __values(validations), validations_1_1 = validations_1.next();
+                            collection = _g.sent();
                             _g.label = 4;
                         case 4:
-                            if (!!validations_1_1.done) return [3 /*break*/, 14];
-                            validation_1 = validations_1_1.value;
+                            _g.trys.push([4, 16, 17, 18]);
+                            validations_1 = __values(validations), validations_1_1 = validations_1.next();
                             _g.label = 5;
                         case 5:
-                            _g.trys.push([5, 11, 12, 13]);
+                            if (!!validations_1_1.done) return [3 /*break*/, 15];
+                            validation_1 = validations_1_1.value;
+                            _g.label = 6;
+                        case 6:
+                            _g.trys.push([6, 12, 13, 14]);
                             e_1 = void 0;
                             return [4 /*yield*/, collection.listPipelines()];
-                        case 6:
-                            _b = (__values.apply(void 0, [_g.sent()])), _c = _b.next();
-                            _g.label = 7;
                         case 7:
-                            if (!!_c.done) return [3 /*break*/, 10];
+                            _b = (__values.apply(void 0, [_g.sent()])), _c = _b.next();
+                            _g.label = 8;
+                        case 8:
+                            if (!!_c.done) return [3 /*break*/, 11];
                             pipelineUrl = _c.value;
                             return [4 /*yield*/, collection.getPipelineByUrl(pipelineUrl)];
-                        case 8:
+                        case 9:
                             pipeline = _g.sent();
                             if (validation_1 === 'logic') {
                                 validatePipeline(pipeline);
@@ -10110,37 +10141,37 @@
                                     console.info(colors__default["default"].cyan("Validated logic of ".concat(pipeline.pipelineUrl)));
                                 }
                             }
-                            _g.label = 9;
-                        case 9:
+                            _g.label = 10;
+                        case 10:
                             _c = _b.next();
-                            return [3 /*break*/, 7];
-                        case 10: return [3 /*break*/, 13];
-                        case 11:
+                            return [3 /*break*/, 8];
+                        case 11: return [3 /*break*/, 14];
+                        case 12:
                             e_1_1 = _g.sent();
                             e_1 = { error: e_1_1 };
-                            return [3 /*break*/, 13];
-                        case 12:
+                            return [3 /*break*/, 14];
+                        case 13:
                             try {
                                 if (_c && !_c.done && (_f = _b.return)) _f.call(_b);
                             }
                             finally { if (e_1) throw e_1.error; }
                             return [7 /*endfinally*/];
-                        case 13:
+                        case 14:
                             validations_1_1 = validations_1.next();
-                            return [3 /*break*/, 4];
-                        case 14: return [3 /*break*/, 17];
-                        case 15:
+                            return [3 /*break*/, 5];
+                        case 15: return [3 /*break*/, 18];
+                        case 16:
                             e_2_1 = _g.sent();
                             e_2 = { error: e_2_1 };
-                            return [3 /*break*/, 17];
-                        case 16:
+                            return [3 /*break*/, 18];
+                        case 17:
                             try {
                                 if (validations_1_1 && !validations_1_1.done && (_e = validations_1.return)) _e.call(validations_1);
                             }
                             finally { if (e_2) throw e_2.error; }
                             return [7 /*endfinally*/];
-                        case 17: return [4 /*yield*/, collectionToJson(collection)];
-                        case 18:
+                        case 18: return [4 /*yield*/, collectionToJson(collection)];
+                        case 19:
                             collectionJson = _g.sent();
                             collectionJsonString = stringifyPipelineJson(collectionJson).trim();
                             collectionJsonItems = (function () {
@@ -10159,9 +10190,9 @@
                                 return __generator(this, function (_a) {
                                     switch (_a.label) {
                                         case 0:
-                                            filename = outFile !== PIPELINE_COLLECTION_BASE_FILENAME
+                                            filename = outFile !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                                                 ? outFile
-                                                : path.join(path$1, "".concat(PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
+                                                : path.join(path$1, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
                                             if (!outFile.endsWith(".".concat(extension))) {
                                                 console.warn(colors__default["default"].yellow("Warning: Extension of output file should be \"".concat(extension, "\"")));
                                             }
@@ -10177,27 +10208,27 @@
                                     }
                                 });
                             }); };
-                            if (!formats.includes('json')) return [3 /*break*/, 20];
+                            if (!formats.includes('json')) return [3 /*break*/, 21];
                             formats = formats.filter(function (format) { return format !== 'json'; });
                             return [4 /*yield*/, saveFile('json', collectionJsonString)];
-                        case 19:
-                            _g.sent();
-                            _g.label = 20;
                         case 20:
-                            if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 22];
+                            _g.sent();
+                            _g.label = 21;
+                        case 21:
+                            if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 23];
                             formats = formats.filter(function (format) { return format !== 'javascript' && format !== 'js'; });
                             return [4 /*yield*/, saveFile('js', spaceTrim__default["default"](function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `getPipelineCollection`\n                             */\n                            let pipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function getPipelineCollection(){\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }))];
-                        case 21:
-                            (_g.sent()) + '\n';
-                            _g.label = 22;
                         case 22:
-                            if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 24];
+                            (_g.sent()) + '\n';
+                            _g.label = 23;
+                        case 23:
+                            if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 25];
                             formats = formats.filter(function (format) { return format !== 'typescript' && format !== 'ts'; });
                             return [4 /*yield*/, saveFile('ts', spaceTrim__default["default"](function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n                            import type { PipelineCollection } from '@promptbook/types';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `getPipelineCollection`\n                             */\n                            let pipelineCollection: null | PipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function getPipelineCollection(): PipelineCollection{\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
-                        case 23:
-                            _g.sent();
-                            _g.label = 24;
                         case 24:
+                            _g.sent();
+                            _g.label = 25;
+                        case 25:
                             if (formats.length > 0) {
                                 console.warn(colors__default["default"].yellow("Format ".concat(formats.join(' and '), " is not supported")));
                             }
@@ -10459,76 +10490,79 @@
         // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
         'Pipelines to test as glob pattern');
         testCommand.option('-i, --ignore <glob>', "Ignore as glob pattern");
-        testCommand.option('--reload-cache', "Call LLM models even if same prompt with result is in the cache ", false);
+        testCommand.option('--reload', "Call LLM models even if same prompt with result is in the cache ", false);
         testCommand.option('-v, --verbose', "Is output verbose", false);
         testCommand.action(function (filesGlob, _a) {
-            var ignore = _a.ignore, isCacheCleaned = _a.reloadCache, isVerbose = _a.verbose;
+            var ignore = _a.ignore, isCacheReloaded = _a.reloadCache, isVerbose = _a.verbose;
             return __awaiter(_this, void 0, void 0, function () {
-                var options, fs, llm, tools, filenames, filenames_1, filenames_1_1, filename, pipeline, pipelineMarkdown, _b, _c, error_1, e_1_1;
+                var options, fs, llm, executables, tools, filenames, filenames_1, filenames_1_1, filename, pipeline, pipelineMarkdown, _b, _c, error_1, e_1_1;
                 var _d, e_1, _e;
                 return __generator(this, function (_f) {
                     switch (_f.label) {
                         case 0:
                             options = {
                                 isVerbose: isVerbose,
-                                isCacheCleaned: isCacheCleaned,
+                                isCacheReloaded: isCacheReloaded,
                             };
                             fs = $provideFilesystemForNode(options);
                             llm = $provideLlmToolsForCli(options);
+                            return [4 /*yield*/, $provideExecutablesForNode(options)];
+                        case 1:
+                            executables = _f.sent();
                             _d = {
                                 llm: llm,
                                 fs: fs
                             };
-                            return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm }, options)];
-                        case 1:
+                            return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, options)];
+                        case 2:
                             tools = (_d.scrapers = _f.sent(),
                                 _d.script = [
                                 /*new JavascriptExecutionTools(options)*/
                                 ],
                                 _d);
                             return [4 /*yield*/, glob__default["default"](filesGlob, { ignore: ignore })];
-                        case 2:
-                            filenames = _f.sent();
-                            _f.label = 3;
                         case 3:
-                            _f.trys.push([3, 15, 16, 17]);
-                            filenames_1 = __values(filenames), filenames_1_1 = filenames_1.next();
+                            filenames = _f.sent();
                             _f.label = 4;
                         case 4:
-                            if (!!filenames_1_1.done) return [3 /*break*/, 14];
-                            filename = filenames_1_1.value;
+                            _f.trys.push([4, 16, 17, 18]);
+                            filenames_1 = __values(filenames), filenames_1_1 = filenames_1.next();
                             _f.label = 5;
                         case 5:
-                            _f.trys.push([5, 12, , 13]);
+                            if (!!filenames_1_1.done) return [3 /*break*/, 15];
+                            filename = filenames_1_1.value;
+                            _f.label = 6;
+                        case 6:
+                            _f.trys.push([6, 13, , 14]);
                             pipeline = void 0;
-                            if (!filename.endsWith('.ptbk.md')) return [3 /*break*/, 8];
+                            if (!filename.endsWith('.ptbk.md')) return [3 /*break*/, 9];
                             return [4 /*yield*/, promises.readFile(filename, 'utf-8')];
-                        case 6:
+                        case 7:
                             pipelineMarkdown = (_f.sent());
                             return [4 /*yield*/, pipelineStringToJson(pipelineMarkdown, tools)];
-                        case 7:
+                        case 8:
                             pipeline = _f.sent();
                             if (isVerbose) {
                                 console.info(colors__default["default"].green("Parsed ".concat(filename)));
                             }
-                            _f.label = 8;
-                        case 8:
-                            if (!filename.endsWith('.ptbk.json')) return [3 /*break*/, 10];
+                            _f.label = 9;
+                        case 9:
+                            if (!filename.endsWith('.ptbk.json')) return [3 /*break*/, 11];
                             _c = (_b = JSON).parse;
                             return [4 /*yield*/, promises.readFile(filename, 'utf-8')];
-                        case 9:
-                            pipeline = _c.apply(_b, [_f.sent()]);
-                            return [3 /*break*/, 11];
                         case 10:
+                            pipeline = _c.apply(_b, [_f.sent()]);
+                            return [3 /*break*/, 12];
+                        case 11:
                             if (isVerbose) {
                                 console.info(colors__default["default"].gray("Skipping ".concat(filename)));
                             }
-                            return [3 /*break*/, 13];
-                        case 11:
+                            return [3 /*break*/, 14];
+                        case 12:
                             validatePipeline(pipeline);
                             console.info(colors__default["default"].green("Validated ".concat(filename)));
-                            return [3 /*break*/, 13];
-                        case 12:
+                            return [3 /*break*/, 14];
+                        case 13:
                             error_1 = _f.sent();
                             if (!(error_1 instanceof Error)) {
                                 throw error_1;
@@ -10537,22 +10571,22 @@
                             console.error(colors__default["default"].bgRed(error_1.name /* <- 11:11 */));
                             console.error(colors__default["default"].red(error_1.stack || error_1.message));
                             process.exit(1);
-                            return [3 /*break*/, 13];
-                        case 13:
+                            return [3 /*break*/, 14];
+                        case 14:
                             filenames_1_1 = filenames_1.next();
-                            return [3 /*break*/, 4];
-                        case 14: return [3 /*break*/, 17];
-                        case 15:
+                            return [3 /*break*/, 5];
+                        case 15: return [3 /*break*/, 18];
+                        case 16:
                             e_1_1 = _f.sent();
                             e_1 = { error: e_1_1 };
-                            return [3 /*break*/, 17];
-                        case 16:
+                            return [3 /*break*/, 18];
+                        case 17:
                             try {
                                 if (filenames_1_1 && !filenames_1_1.done && (_e = filenames_1.return)) _e.call(filenames_1);
                             }
                             finally { if (e_1) throw e_1.error; }
                             return [7 /*endfinally*/];
-                        case 17:
+                        case 18:
                             console.info(colors__default["default"].green("All pipelines are valid"));
                             process.exit(0);
                             return [2 /*return*/];
@@ -13023,12 +13057,12 @@
      */
     function getScraperIntermediateSource(source, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var sourceFilename, url, rootDirname, cacheDirname, isCacheCleaned, extension, isVerbose, hash, semanticName, pieces, name, cacheFilename, isDestroyed, fileHandler;
+            var sourceFilename, url, rootDirname, cacheDirname, intermediateFilesStrategy, extension, isVerbose, hash, semanticName, pieces, name, cacheFilename, isDestroyed, fileHandler;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         sourceFilename = source.filename, url = source.url;
-                        rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, isCacheCleaned = options.isCacheCleaned, extension = options.extension, isVerbose = options.isVerbose;
+                        rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, intermediateFilesStrategy = options.intermediateFilesStrategy, extension = options.extension, isVerbose = options.isVerbose;
                         hash = cryptoJs.SHA256(
                         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
                         hexEncoder__default["default"].parse(sourceFilename || url || 'untitled'))
@@ -13038,7 +13072,7 @@
                         pieces = ['intermediate', semanticName, hash].filter(function (piece) { return piece !== ''; });
                         name = pieces.join('-').split('--').join('-');
                         // <- TODO: Use MAX_FILENAME_LENGTH
-                        TODO_USE(rootDirname); // <- TODO: !!!!!!
+                        TODO_USE(rootDirname); // <- TODO: [😡]
                         cacheFilename = path.join.apply(void 0, __spreadArray(__spreadArray([process.cwd(),
                             cacheDirname], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), [name], false)).split('\\')
                             .join('/') +
@@ -13058,7 +13092,7 @@
                                     return __generator(this, function (_a) {
                                         switch (_a.label) {
                                             case 0:
-                                                if (!isCacheCleaned) return [3 /*break*/, 2];
+                                                if (!(intermediateFilesStrategy === 'HIDE_AND_CLEAN')) return [3 /*break*/, 2];
                                                 if (isVerbose) {
                                                     console.info('legacyDocumentScraper: Clening cache');
                                                 }
@@ -13082,7 +13116,7 @@
     /**
      * Note: Not using `FileCacheStorage` for two reasons:
      * 1) Need to store more than serialized JSONs
-     * 2) Need to switch between a `rootDirname` and `cacheDirname` <- TODO: !!!!
+     * 2) Need to switch between a `rootDirname` and `cacheDirname` <- TODO: [😡]
      * TODO: [🐱‍🐉][🧠] Make some smart crop
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
@@ -13099,7 +13133,7 @@
         mimeTypes: ['text/markdown', 'text/plain'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: true,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13143,7 +13177,7 @@
                 return __generator(this, function (_k) {
                     switch (_k.label) {
                         case 0:
-                            _a = this.options, _b = _a.maxParallelCount, maxParallelCount = _b === void 0 ? MAX_PARALLEL_COUNT : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? IS_VERBOSE : _c;
+                            _a = this.options, _b = _a.maxParallelCount, maxParallelCount = _b === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c;
                             llm = this.tools.llm;
                             if (llm === undefined) {
                                 throw new MissingToolsError('LLM tools are required for scraping external files');
@@ -13242,7 +13276,8 @@
                                                 embeddingResult = _c.sent();
                                                 index.push({
                                                     modelName: embeddingResult.modelName,
-                                                    position: embeddingResult.content,
+                                                    position: __spreadArray([], __read(embeddingResult.content), false),
+                                                    // <- TODO: [🪓] Here should be no need for spreading new array, just `position: embeddingResult.content`
                                                 });
                                                 _c.label = 6;
                                             case 6: return [3 /*break*/, 8];
@@ -13293,7 +13328,7 @@
         mimeTypes: ['application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: ['Pandoc'],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13333,12 +13368,13 @@
          * Note: `$` is used to indicate that this function is not a pure function - it leaves files on the disk and you are responsible for cleaning them by calling `destroy` method of returned object
          */
         DocumentScraper.prototype.$convert = function (source) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
-                var _a, _b, externalProgramsPaths, _c, rootDirname, _d, cacheDirname, _e, isCacheCleaned, _f, isVerbose, extension, cacheFilehandler, command_1;
+                var _b, _c, rootDirname, _d, cacheDirname, _e, intermediateFilesStrategy, _f, isVerbose, extension, cacheFilehandler, command_1;
                 return __generator(this, function (_g) {
                     switch (_g.label) {
                         case 0:
-                            _a = this.options, _b = _a.externalProgramsPaths, externalProgramsPaths = _b === void 0 ? {} : _b, _c = _a.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _a.cacheDirname, cacheDirname = _d === void 0 ? SCRAPE_CACHE_DIRNAME : _d, _e = _a.isCacheCleaned, isCacheCleaned = _e === void 0 ? false : _e, _f = _a.isVerbose, isVerbose = _f === void 0 ? IS_VERBOSE : _f;
+                            _b = this.options, _c = _b.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _b.cacheDirname, cacheDirname = _d === void 0 ? DEFAULT_SCRAPE_CACHE_DIRNAME : _d, _e = _b.intermediateFilesStrategy, intermediateFilesStrategy = _e === void 0 ? DEFAULT_INTERMEDIATE_FILES_STRATEGY : _e, _f = _b.isVerbose, isVerbose = _f === void 0 ? DEFAULT_IS_VERBOSE : _f;
                             if (!$isRunningInNode()) {
                                 throw new KnowledgeScrapeError('Scraping .docx files is only supported in Node environment');
                             }
@@ -13346,7 +13382,7 @@
                                 throw new EnvironmentMismatchError('Can not scrape documents without filesystem tools');
                                 //          <- TODO: [🧠] What is the best error type here`
                             }
-                            if (externalProgramsPaths.pandocPath === undefined) {
+                            if (((_a = this.tools.executables) === null || _a === void 0 ? void 0 : _a.pandocPath) === undefined) {
                                 throw new MissingToolsError('Pandoc is required for scraping .docx files');
                             }
                             if (source.filename === null) {
@@ -13357,7 +13393,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'md',
                                     isVerbose: isVerbose,
                                 })];
@@ -13366,11 +13402,9 @@
                             return [4 /*yield*/, isFileExisting(cacheFilehandler.filename, this.tools.fs)];
                         case 2:
                             if (!!(_g.sent())) return [3 /*break*/, 5];
-                            command_1 = "\"".concat(externalProgramsPaths.pandocPath, "\" -f ").concat(extension, " -t markdown \"").concat(source.filename, "\" -o \"").concat(cacheFilehandler.filename, "\"");
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook
+                            command_1 = "\"".concat(this.tools.executables.pandocPath, "\" -f ").concat(extension, " -t markdown \"").concat(source.filename, "\" -o \"").concat(cacheFilehandler.filename, "\"");
                             return [4 /*yield*/, $execCommand(command_1)];
                         case 3:
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook
                             _g.sent();
                             return [4 /*yield*/, isFileExisting(cacheFilehandler.filename, this.tools.fs)];
                         case 4:
@@ -13449,7 +13483,11 @@
         mimeTypes: ['application/msword', 'text/rtf'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [
+            'Pandoc',
+            'LibreOffice',
+            //    <- TODO: [🧠] Should be 'LibreOffice' here, its dependency of dependency
+        ],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13462,7 +13500,7 @@
     var _LegacyDocumentScraperMetadataRegistration = $scrapersMetadataRegister.register(legacyDocumentScraperMetadata);
 
     /**
-     * Scraper for .docx files
+     * Scraper for old document files (like .doc and .rtf)
      *
      * @see `documentationUrl` for more details
      * @public exported from `@promptbook/legacy-documents`
@@ -13489,12 +13527,13 @@
          * Note: `$` is used to indicate that this function is not a pure function - it leaves files on the disk and you are responsible for cleaning them by calling `destroy` method of returned object
          */
         LegacyDocumentScraper.prototype.$convert = function (source) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
-                var _a, _b, externalProgramsPaths, _c, rootDirname, _d, cacheDirname, _e, isCacheCleaned, _f, isVerbose, extension, cacheFilehandler, documentSourceOutdirPathForLibreOffice_1, command_1, files_1, file;
+                var _b, _c, rootDirname, _d, cacheDirname, _e, intermediateFilesStrategy, _f, isVerbose, extension, cacheFilehandler, documentSourceOutdirPathForLibreOffice_1, command_1, files_1, file;
                 return __generator(this, function (_g) {
                     switch (_g.label) {
                         case 0:
-                            _a = this.options, _b = _a.externalProgramsPaths, externalProgramsPaths = _b === void 0 ? {} : _b, _c = _a.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _a.cacheDirname, cacheDirname = _d === void 0 ? SCRAPE_CACHE_DIRNAME : _d, _e = _a.isCacheCleaned, isCacheCleaned = _e === void 0 ? false : _e, _f = _a.isVerbose, isVerbose = _f === void 0 ? IS_VERBOSE : _f;
+                            _b = this.options, _c = _b.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _b.cacheDirname, cacheDirname = _d === void 0 ? DEFAULT_SCRAPE_CACHE_DIRNAME : _d, _e = _b.intermediateFilesStrategy, intermediateFilesStrategy = _e === void 0 ? DEFAULT_INTERMEDIATE_FILES_STRATEGY : _e, _f = _b.isVerbose, isVerbose = _f === void 0 ? DEFAULT_IS_VERBOSE : _f;
                             if (!$isRunningInNode()) {
                                 throw new KnowledgeScrapeError('Scraping .doc files is only supported in Node environment');
                             }
@@ -13502,7 +13541,7 @@
                                 throw new EnvironmentMismatchError('Can not scrape (legacy) documents without filesystem tools');
                                 //          <- TODO: [🧠] What is the best error type here`
                             }
-                            if (externalProgramsPaths.libreOfficePath === undefined) {
+                            if (((_a = this.tools.executables) === null || _a === void 0 ? void 0 : _a.libreOfficePath) === undefined) {
                                 throw new MissingToolsError('LibreOffice is required for scraping .doc and .rtf files');
                             }
                             if (source.filename === null) {
@@ -13513,7 +13552,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'docx',
                                     isVerbose: isVerbose,
                                 })];
@@ -13528,11 +13567,9 @@
                             documentSourceOutdirPathForLibreOffice_1 = path.join(path.dirname(cacheFilehandler.filename), 'libreoffice')
                                 .split('\\')
                                 .join('/');
-                            command_1 = "\"".concat(externalProgramsPaths.libreOfficePath, "\" --headless --convert-to docx \"").concat(source.filename, "\"  --outdir \"").concat(documentSourceOutdirPathForLibreOffice_1, "\"");
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook - this should trigger build polution error
+                            command_1 = "\"".concat(this.tools.executables.libreOfficePath, "\" --headless --convert-to docx \"").concat(source.filename, "\"  --outdir \"").concat(documentSourceOutdirPathForLibreOffice_1, "\"");
                             return [4 /*yield*/, $execCommand(command_1)];
                         case 3:
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook - this should trigger build polution error
                             _g.sent();
                             return [4 /*yield*/, promises.readdir(documentSourceOutdirPathForLibreOffice_1)];
                         case 4:
@@ -13689,7 +13726,7 @@
         mimeTypes: ['application/pdf'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: true,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13702,7 +13739,7 @@
     var _PdfScraperMetadataRegistration = $scrapersMetadataRegister.register(pdfScraperMetadata);
 
     /**
-     * Scraper for .docx files
+     * Scraper for .pdf files
      *
      * @see `documentationUrl` for more details
      * @public exported from `@promptbook/pdf`
@@ -13745,9 +13782,8 @@
                     TODO_USE(this.options);
                     /*
                     const {
-                        externalProgramsPaths = {},
                         cacheDirname = SCRAPE_CACHE_DIRNAME,
-                        isCacheCleaned = false,
+                         intermediateFilesStrategy = DEFAULT_INTERMEDIATE_FILES_STRATEGY,
                         isVerbose = IS_VERBOSE,
                     } = options;
                     */
@@ -13800,7 +13836,7 @@
         mimeTypes: ['text/html'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13813,32 +13849,29 @@
     var _WebsiteScraperMetadataRegistration = $scrapersMetadataRegister.register(websiteScraperMetadata);
 
     /**
-     * A converter instance that uses showdown and highlight extensions
+     * Create a new showdown converter instance
      *
-     * @type {Converter}
-     * @private for markdown and html knowledge scrapers
-     */
-    var markdownConverter = new showdown.Converter({
-        flavor: 'github', // <- TODO: !!!!!! Explicitly specify the flavor of promptbook markdown
-        /*
-        > import showdownHighlight from 'showdown-highlight';
-        > extensions: [
-        >     showdownHighlight({
-        >         // Whether to add the classes to the <pre> tag, default is false
-        >         pre: true,
-        >         // Whether to use hljs' auto language detection, default is true
-        >         auto_detection: true,
-        >     }),
-        > ],
-        */
-    });
-    /**
-     * TODO: !!!!!! Figure out better name not to confuse with `Converter`
-     * TODO: !!!!!! Lazy-make converter
+     * @private utility of `WebsiteScraper`
      */
+    function createShowdownConverter() {
+        return new showdown.Converter({
+            flavor: 'github',
+            /*
+            > import showdownHighlight from 'showdown-highlight';
+            > extensions: [
+            >     showdownHighlight({
+            >         // Whether to add the classes to the <pre> tag, default is false
+            >         pre: true,
+            >         // Whether to use hljs' auto language detection, default is true
+            >         auto_detection: true,
+            >     }),
+            > ],
+            */
+        });
+    }
 
     /**
-     * Scraper for .docx files
+     * Scraper for websites
      *
      * @see `documentationUrl` for more details
      * @public exported from `@promptbook/website-crawler`
@@ -13848,6 +13881,7 @@
             this.tools = tools;
             this.options = options;
             this.markdownScraper = new MarkdownScraper(tools, options);
+            this.showdownConverter = createShowdownConverter();
         }
         Object.defineProperty(WebsiteScraper.prototype, "metadata", {
             /**
@@ -13868,12 +13902,11 @@
             return __awaiter(this, void 0, void 0, function () {
                 var _a, _b, 
                 // TODO: [🧠] Maybe in node use headless browser not just JSDOM
-                // externalProgramsPaths = {},
-                rootDirname, _c, cacheDirname, _d, isCacheCleaned, _e, isVerbose, jsdom$1, _f, reader, article, html, i, cacheFilehandler, markdown;
+                rootDirname, _c, cacheDirname, _d, intermediateFilesStrategy, _e, isVerbose, jsdom$1, _f, reader, article, html, i, cacheFilehandler, markdown;
                 return __generator(this, function (_g) {
                     switch (_g.label) {
                         case 0:
-                            _a = this.options, _b = _a.rootDirname, rootDirname = _b === void 0 ? process.cwd() : _b, _c = _a.cacheDirname, cacheDirname = _c === void 0 ? SCRAPE_CACHE_DIRNAME : _c, _d = _a.isCacheCleaned, isCacheCleaned = _d === void 0 ? false : _d, _e = _a.isVerbose, isVerbose = _e === void 0 ? IS_VERBOSE : _e;
+                            _a = this.options, _b = _a.rootDirname, rootDirname = _b === void 0 ? process.cwd() : _b, _c = _a.cacheDirname, cacheDirname = _c === void 0 ? DEFAULT_SCRAPE_CACHE_DIRNAME : _c, _d = _a.intermediateFilesStrategy, intermediateFilesStrategy = _d === void 0 ? DEFAULT_INTERMEDIATE_FILES_STRATEGY : _d, _e = _a.isVerbose, isVerbose = _e === void 0 ? DEFAULT_IS_VERBOSE : _e;
                             // TODO: !!!!!! Does this work in browser? Make it work.
                             if (source.url === null) {
                                 throw new KnowledgeScrapeError('Website scraper requires URL');
@@ -13886,10 +13919,6 @@
                                 }]))();
                             reader = new readability.Readability(jsdom$1.window.document);
                             article = reader.parse();
-                            console.log(article);
-                            return [4 /*yield*/, waitasecond.forTime(10000)];
-                        case 2:
-                            _g.sent();
                             html = (article === null || article === void 0 ? void 0 : article.content) || (article === null || article === void 0 ? void 0 : article.textContent) || jsdom$1.window.document.body.innerHTML;
                             // Note: Unwrap html such as it is convertable by `markdownConverter`
                             for (i = 0; i < 2; i++) {
@@ -13901,16 +13930,16 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'html',
                                     isVerbose: isVerbose,
                                 })];
-                        case 3:
+                        case 2:
                             cacheFilehandler = _g.sent();
                             return [4 /*yield*/, promises.writeFile(cacheFilehandler.filename, html, 'utf-8')];
-                        case 4:
+                        case 3:
                             _g.sent();
-                            markdown = markdownConverter.makeMarkdown(html, jsdom$1.window.document);
+                            markdown = this.showdownConverter.makeMarkdown(html, jsdom$1.window.document);
                             return [2 /*return*/, __assign(__assign({}, cacheFilehandler), { markdown: markdown })];
                     }
                 });
@@ -13954,7 +13983,6 @@
         return WebsiteScraper;
     }());
     /**
-     * TODO: !!!!!! Put into separate package
      * TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
      * TODO: [🪂] Do it in parallel 11:11
      * Note: No need to aggregate usage here, it is done by intercepting the llmTools