@promptbook/cli 0.72.0-9 → 0.72.0

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('commander'), require('spacetrim'), require('colors'), require('waitasecond'), require('fs/promises'), require('path'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('crypto-js/enc-hex'), require('mime-types'), require('dotenv'), require('crypto-js/sha256'), require('glob-promise'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('child_process'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'commander', 'spacetrim', 'colors', 'waitasecond', 'fs/promises', 'path', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'crypto-js/enc-hex', 'mime-types', 'dotenv', 'crypto-js/sha256', 'glob-promise', 'socket.io-client', '@anthropic-ai/sdk', '@azure/openai', 'openai', 'child_process', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.commander, global.spaceTrim, global.colors, global.waitasecond, global.promises, global.path, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.hexEncoder, global.mimeTypes, global.dotenv, global.sha256, global.glob, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI, global.child_process, global.readability, global.jsdom, global.showdown));
-})(this, (function (exports, commander, spaceTrim, colors, waitasecond, promises, path, prettier, parserHtml, papaparse, cryptoJs, hexEncoder, mimeTypes, dotenv, sha256, glob, socket_ioClient, Anthropic, openai, OpenAI, child_process, readability, jsdom, showdown) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('commander'), require('spacetrim'), require('colors'), require('waitasecond'), require('fs/promises'), require('path'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('crypto-js/enc-hex'), require('mime-types'), require('child_process'), require('util'), require('dotenv'), require('crypto-js/sha256'), require('glob-promise'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'commander', 'spacetrim', 'colors', 'waitasecond', 'fs/promises', 'path', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'crypto-js/enc-hex', 'mime-types', 'child_process', 'util', 'dotenv', 'crypto-js/sha256', 'glob-promise', 'socket.io-client', '@anthropic-ai/sdk', '@azure/openai', 'openai', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.commander, global.spaceTrim, global.colors, global.waitasecond, global.promises, global.path, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.hexEncoder, global.mimeTypes, global.child_process, global.util, global.dotenv, global.sha256, global.glob, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
+})(this, (function (exports, commander, spaceTrim, colors, waitasecond, promises, path, prettier, parserHtml, papaparse, cryptoJs, hexEncoder, mimeTypes, child_process, util, dotenv, sha256, glob, socket_ioClient, Anthropic, openai, OpenAI, readability, jsdom, showdown) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -39,7 +39,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.72.0-8';
+    var PROMPTBOOK_VERSION = '0.72.0-34';
     // 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
      *
@@ -432,6 +433,7 @@
      * @private within the repository - too low-level in comparison with other `MAX_...`
      */
     var CONNECTION_TIMEOUT_MS = 7 * 1000;
+    // <- TODO: [⏳] Standartize timeouts, Make DEFAULT_TIMEOUT_MS as global constant
     /**
      * How many times to retry the connections
      *
@@ -445,23 +447,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 +478,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 +486,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 +556,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 +635,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 +720,6 @@
             pipelineString += '\n\n';
             pipelineString += description;
         }
-        // TODO:> const commands: Array<Command>
         var commands = [];
         if (pipelineUrl) {
             commands.push("PIPELINE URL ".concat(pipelineUrl));
@@ -1032,7 +775,6 @@
                     pipelineString += '\n\n';
                     pipelineString += description_1;
                 }
-                // TODO:> const commands: Array<Command>
                 var commands_1 = [];
                 var contentLanguage = 'text';
                 if (templateType === 'PROMPT_TEMPLATE') {
@@ -1331,8 +1073,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 +2232,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 +2309,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 +2567,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 +3616,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 +3986,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 +4021,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 +4174,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 +4194,7 @@
                                 // <- [🍸]
                             })];
                     case 1:
-                        _h.sent();
+                        _j.sent();
                         usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
                         dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
                         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -4432,15 +4205,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 +4233,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 +4261,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 +4277,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 +4341,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 +4531,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 +4541,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 +4645,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 +4679,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 +4707,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 +4763,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 +4936,11 @@
      * @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
     /**
      * 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 */)
@@ -5298,20 +5206,20 @@
     /**
      * @@@
      *
-     * @private for scraper utilities
+     * @public exported from `@promptbook/core`
      */
     function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
             var sourceContent, name, _b, _c, rootDirname, _d, 
             // <- TODO: process.cwd() if running in Node.js
-            isVerbose, url, response_1, mimeType, filename_1, fileExtension, mimeType_1;
+            isVerbose, url, response_1, mimeType, filename_1, fileExtension, mimeType;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     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);
@@ -5327,19 +5235,14 @@
                                 filename: null,
                                 url: url,
                                 mimeType: mimeType,
-                                asBlob: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, response_1.blob()];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, content];
-                                            }
-                                        });
-                                    });
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > async asBlob() {
+                                    >     // TODO: [👨🏻‍🤝‍👨🏻] This can be called multiple times BUT when called second time, response in already consumed
+                                    >     const content = await response.blob();
+                                    >     return content;
+                                    > },
+                                */
                                 asJson: function () {
                                     return __awaiter(this, void 0, void 0, function () {
                                         var content;
@@ -5379,34 +5282,31 @@
                         }
                         filename_1 = path.join(rootDirname, sourceContent).split('\\').join('/');
                         fileExtension = getFileExtension(filename_1);
-                        mimeType_1 = extensionToMimeType(fileExtension || '');
+                        mimeType = extensionToMimeType(fileExtension || '');
                         return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
                     case 3:
                         if (!(_e.sent())) {
                             throw new NotFoundError(spaceTrim__default["default"](function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(filename_1), "\n                      "); }));
                         }
-                        // TODO: !!!!!! Test security file - file is scoped to the project (maybe do this in `filesystemTools`)
+                        // TODO: [🧠][😿] Test security file - file is scoped to the project (BUT maybe do this in `filesystemTools`)
                         return [2 /*return*/, {
                                 source: name,
                                 filename: filename_1,
                                 url: null,
-                                mimeType: mimeType_1,
-                                asBlob: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, tools.fs.readFile(filename_1)];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, new Blob([
-                                                            content,
-                                                            // <- TODO: !!!!!! Maybe not working
-                                                        ], { type: mimeType_1 })];
-                                            }
-                                        });
-                                    });
-                                },
+                                mimeType: mimeType,
+                                /*
+                                TODO: [🥽]
+                                    > async asBlob() {
+                                    >     const content = await tools.fs!.readFile(filename);
+                                    >     return new Blob(
+                                    >         [
+                                    >             content,
+                                    >             // <- TODO: [🥽] This is NOT tested, test it
+                                    >         ],
+                                    >         { type: mimeType },
+                                    >     );
+                                    > },
+                                */
                                 asJson: function () {
                                     return __awaiter(this, void 0, void 0, function () {
                                         var _a, _b;
@@ -5442,9 +5342,14 @@
                             asJson: function () {
                                 throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
                             },
-                            asBlob: function () {
-                                throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asBlob`');
-                            },
+                            /*
+                            TODO: [🥽]
+                                > asBlob() {
+                                >     throw new UnexpectedError(
+                                >         'Did not expect that `markdownScraper` would need to get the content `asBlob`',
+                                >     );
+                                > },
+                            */
                         }];
                 }
             });
@@ -5464,7 +5369,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 +5398,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 +5447,7 @@
     >   /**
     >    * Unprepared knowledge
     >    * /
-    >   readonly knowledgeSources: Array<KnowledgeSourceJson>;
+    >   readonly knowledgeSources: ReadonlyArray<KnowledgeSourceJson>;
     > };
     >
     > export async function prepareKnowledgePieces(
@@ -5599,7 +5505,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 +5567,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 +5625,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) }))];
                 }
             });
         });
@@ -5766,6 +5674,7 @@
             'KNOWLEDGE ./hejny-cv.md',
             'KNOWLEDGE ./hejny-cv.pdf',
             'KNOWLEDGE ./hejny-cv.docx',
+            //          <- TODO: [😿] Allow ONLY files scoped in the (sub)directory NOT ../ and test it
         ],
         /**
          * Parses the KNOWLEDGE command
@@ -8440,38 +8349,359 @@
      * Note: This function does not validate logic of the pipeline only the parsing
      * Note: This function acts as compilation process
      *
-     * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
-     * @param tools - Tools for the preparation and scraping - if not provided together with `llm`, the preparation will be skipped
-     * @param options - Options and tools for the compilation
-     * @returns {Promptbook} compiled in JSON format (.ptbk.json)
-     * @throws {ParseError} if the promptbook string is not valid
-     * @public exported from `@promptbook/core`
+     * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
+     * @param tools - Tools for the preparation and scraping - if not provided together with `llm`, the preparation will be skipped
+     * @param options - Options and tools for the compilation
+     * @returns {Promptbook} compiled in JSON format (.ptbk.json)
+     * @throws {ParseError} if the promptbook string is not valid
+     * @public exported from `@promptbook/core`
+     */
+    function pipelineStringToJson(pipelineString, tools, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var pipelineJson;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        pipelineJson = pipelineStringToJsonSync(pipelineString);
+                        if (!(tools !== undefined && tools.llm !== undefined)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, preparePipeline(pipelineJson, tools, options || {
+                                rootDirname: null,
+                            })];
+                    case 1:
+                        pipelineJson = _a.sent();
+                        _a.label = 2;
+                    case 2: 
+                    // Note: No need to use `$asDeeplyFrozenSerializableJson` because `pipelineStringToJsonSync` and `preparePipeline` already do that
+                    return [2 /*return*/, pipelineJson];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+     * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+     * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
+     */
+
+    // Note: We want to use the `exec` as async function
+    var exec$1 = util.promisify(child_process.exec);
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    function locateAppOnLinux(_a) {
+        var appName = _a.appName, linuxWhich = _a.linuxWhich;
+        return __awaiter(this, void 0, void 0, function () {
+            var _b, stderr, stdout, error_1;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _c.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, exec$1("which ".concat(linuxWhich))];
+                    case 1:
+                        _b = _c.sent(), stderr = _b.stderr, stdout = _b.stdout;
+                        if (!stderr && stdout) {
+                            return [2 /*return*/, stdout.trim()];
+                        }
+                        throw new Error("Can not locate app ".concat(appName, " on Linux.\n ").concat(stderr));
+                    case 2:
+                        error_1 = _c.sent();
+                        if (!(error_1 instanceof Error)) {
+                            throw error_1;
+                        }
+                        return [2 /*return*/, null];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+     * 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,
+            writeFile: promises.writeFile,
+            readdir: promises.readdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Checks if the file is executable
+     *
+     * @private within the repository
+     */
+    function isExecutable(path, fs) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, fs.access(path, fs.constants.X_OK)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, true];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/, false];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * Note: Not [~🟢~] because it is not directly dependent on `fs
+     * TODO: [🖇] What about symlinks?
+     */
+
+    // Note: Module `userhome` has no types available, so it is imported using `require`
+    //       @see https://stackoverflow.com/questions/37000981/how-to-import-node-module-in-typescript-without-type-definitions
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    var userhome = require('userhome');
+    // Note: We want to use the `exec` as async function
+    var exec = util.promisify(child_process.exec);
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    function locateAppOnMacOs(_a) {
+        var appName = _a.appName, macOsName = _a.macOsName;
+        return __awaiter(this, void 0, void 0, function () {
+            var toExec, regPath, altPath, _b, stderr, stdout, error_1;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _c.trys.push([0, 6, , 7]);
+                        toExec = "/Contents/MacOS/".concat(macOsName);
+                        regPath = "/Applications/".concat(macOsName, ".app") + toExec;
+                        altPath = userhome(regPath.slice(1));
+                        return [4 /*yield*/, isExecutable(regPath, $provideFilesystemForNode())];
+                    case 1:
+                        if (!_c.sent()) return [3 /*break*/, 2];
+                        return [2 /*return*/, regPath];
+                    case 2: return [4 /*yield*/, isExecutable(altPath, $provideFilesystemForNode())];
+                    case 3:
+                        if (_c.sent()) {
+                            return [2 /*return*/, altPath];
+                        }
+                        _c.label = 4;
+                    case 4: return [4 /*yield*/, exec("mdfind 'kMDItemDisplayName == \"".concat(macOsName, "\" && kMDItemKind == Application'"))];
+                    case 5:
+                        _b = _c.sent(), stderr = _b.stderr, stdout = _b.stdout;
+                        if (!stderr && stdout) {
+                            return [2 /*return*/, stdout.trim() + toExec];
+                        }
+                        throw new Error("Can not locate app ".concat(appName, " on macOS.\n ").concat(stderr));
+                    case 6:
+                        error_1 = _c.sent();
+                        if (!(error_1 instanceof Error)) {
+                            throw error_1;
+                        }
+                        return [2 /*return*/, null];
+                    case 7: return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    function locateAppOnWindows(_a) {
+        var appName = _a.appName, windowsSuffix = _a.windowsSuffix;
+        return __awaiter(this, void 0, void 0, function () {
+            var prefixes, prefixes_1, prefixes_1_1, prefix, path$1, e_1_1, error_1;
+            var e_1, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _c.trys.push([0, 9, , 10]);
+                        prefixes = [
+                            process.env.LOCALAPPDATA,
+                            path.join(process.env.LOCALAPPDATA || '', 'Programs'),
+                            process.env.PROGRAMFILES,
+                            process.env['PROGRAMFILES(X86)'],
+                        ];
+                        _c.label = 1;
+                    case 1:
+                        _c.trys.push([1, 6, 7, 8]);
+                        prefixes_1 = __values(prefixes), prefixes_1_1 = prefixes_1.next();
+                        _c.label = 2;
+                    case 2:
+                        if (!!prefixes_1_1.done) return [3 /*break*/, 5];
+                        prefix = prefixes_1_1.value;
+                        path$1 = prefix + windowsSuffix;
+                        return [4 /*yield*/, isExecutable(path$1, $provideFilesystemForNode())];
+                    case 3:
+                        if (_c.sent()) {
+                            return [2 /*return*/, path$1];
+                        }
+                        _c.label = 4;
+                    case 4:
+                        prefixes_1_1 = prefixes_1.next();
+                        return [3 /*break*/, 2];
+                    case 5: return [3 /*break*/, 8];
+                    case 6:
+                        e_1_1 = _c.sent();
+                        e_1 = { error: e_1_1 };
+                        return [3 /*break*/, 8];
+                    case 7:
+                        try {
+                            if (prefixes_1_1 && !prefixes_1_1.done && (_b = prefixes_1.return)) _b.call(prefixes_1);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                        return [7 /*endfinally*/];
+                    case 8: throw new Error("Can not locate app ".concat(appName, " on Windows."));
+                    case 9:
+                        error_1 = _c.sent();
+                        if (!(error_1 instanceof Error)) {
+                            throw error_1;
+                        }
+                        return [2 /*return*/, null];
+                    case 10: return [2 /*return*/];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Locates an application on the system
+     *
+     * @private within the repository
+     */
+    function locateApp(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Locating apps works only in Node.js environment');
+        }
+        var appName = options.appName, linuxWhich = options.linuxWhich, windowsSuffix = options.windowsSuffix, macOsName = options.macOsName;
+        if (process.platform === 'win32') {
+            if (windowsSuffix) {
+                return locateAppOnWindows({ appName: appName, windowsSuffix: windowsSuffix });
+            }
+            else {
+                throw new Error("".concat(appName, " is not available on Windows."));
+            }
+        }
+        else if (process.platform === 'darwin') {
+            if (macOsName) {
+                return locateAppOnMacOs({ appName: appName, macOsName: macOsName });
+            }
+            else {
+                throw new Error("".concat(appName, " is not available on macOS."));
+            }
+        }
+        else {
+            if (linuxWhich) {
+                return locateAppOnLinux({ appName: appName, linuxWhich: linuxWhich });
+            }
+            else {
+                throw new Error("".concat(appName, " is not available on Linux."));
+            }
+        }
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    function locateLibreoffice() {
+        return locateApp({
+            appName: 'Libreoffice',
+            linuxWhich: 'libreoffice',
+            windowsSuffix: '\\LibreOffice\\program\\soffice.exe',
+            macOsName: 'LibreOffice',
+        });
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    function locatePandoc() {
+        return locateApp({
+            appName: 'Pandoc',
+            linuxWhich: 'pandoc',
+            windowsSuffix: '\\Pandoc\\pandoc.exe',
+            macOsName: 'Pandoc',
+        });
+    }
+    /**
+     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
+     * 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 pipelineStringToJson(pipelineString, tools, options) {
+    function $provideExecutablesForNode(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var pipelineJson;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var _a, _b, isAutoInstalled, _c, isVerbose;
+            var _d;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
                     case 0:
-                        pipelineJson = pipelineStringToJsonSync(pipelineString);
-                        if (!(tools !== undefined && tools.llm !== undefined)) return [3 /*break*/, 2];
-                        return [4 /*yield*/, preparePipeline(pipelineJson, tools, options || {
-                                rootDirname: null,
-                            })];
+                        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: [🔱][🧠] Auto-install the executables
+                        TODO_USE(isVerbose);
+                        _d = {};
+                        return [4 /*yield*/, locatePandoc()];
                     case 1:
-                        pipelineJson = _a.sent();
-                        _a.label = 2;
-                    case 2: 
-                    // Note: No need to use `$asDeeplyFrozenSerializableJson` because `pipelineStringToJsonSync` and `preparePipeline` already do that
-                    return [2 /*return*/, pipelineJson];
+                        _d.pandocPath = (_e.sent()) || undefined;
+                        return [4 /*yield*/, locateLibreoffice()];
+                    case 2: return [2 /*return*/, (_d.libreOfficePath = (_e.sent()) || undefined,
+                            _d)];
                 }
             });
         });
     }
     /**
-     * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
-     * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
-     * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
+     * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**
@@ -8643,7 +8873,7 @@
      */
     function createLlmToolsFromConfiguration(configuration, options) {
         if (options === void 0) { options = {}; }
-        var _a = options.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
+        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()
@@ -8654,7 +8884,7 @@
             if (registeredItem === undefined) {
                 throw new Error(spaceTrim__default["default"](function (block) { return "\n                        There is no constructor for LLM provider `".concat(llmConfiguration.className, "` from `").concat(llmConfiguration.packageName, "`\n\n                        You have probably forgotten install and import the provider package.\n                        To fix this issue, you can:\n\n                        Install:\n\n                        > npm install ").concat(llmConfiguration.packageName, "\n\n                        And import:\n\n                        > import '").concat(llmConfiguration.packageName, "';\n\n\n                        ").concat(block($registeredLlmToolsMessage()), "\n                    "); }));
             }
-            return registeredItem(__assign({ isVerbose: isVerbose }, llmConfiguration.options));
+            return registeredItem(__assign({ isVerbose: isVerbose, userId: userId }, llmConfiguration.options));
         });
         return joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(llmTools), false));
     }
@@ -8704,6 +8934,64 @@
      * 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 ? 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 +9446,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 +9456,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 +9703,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 +9716,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 +10188,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 +10210,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 +10296,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 +10330,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 +10350,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 +10377,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 +10409,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 +10458,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 +10476,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 +10758,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 +10839,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*/];
@@ -10666,6 +10968,7 @@
      * @public exported from `@promptbook/remote-client`
      */
     var RemoteLlmExecutionTools = /** @class */ (function () {
+        /* <- TODO: [🍚] `, Destroyable` */
         function RemoteLlmExecutionTools(options) {
             this.options = options;
         }
@@ -10715,12 +11018,16 @@
                             if (this.options.isAnonymous) {
                                 socket.emit('listModels-request', {
                                     isAnonymous: true,
+                                    userId: this.options.userId,
                                     llmToolsConfiguration: this.options.llmToolsConfiguration,
                                 } /* <- TODO: [🤛] */);
                             }
                             else {
                                 socket.emit('listModels-request', {
                                     isAnonymous: false,
+                                    appId: this.options.appId,
+                                    userId: this.options.userId,
+                                    customOptions: this.options.customOptions,
                                 } /* <- TODO: [🤛] */);
                             }
                             return [4 /*yield*/, new Promise(function (resolve, reject) {
@@ -10814,7 +11121,9 @@
                             else {
                                 socket.emit('prompt-request', {
                                     isAnonymous: false,
+                                    appId: this.options.appId,
                                     userId: this.options.userId,
+                                    customOptions: this.options.customOptions,
                                     prompt: prompt,
                                 } /* <- TODO: [🤛] */);
                             }
@@ -11296,7 +11605,7 @@
      */
     var createAnthropicClaudeExecutionTools = Object.assign(function (options) {
         if (options.isProxied) {
-            return new RemoteLlmExecutionTools(__assign(__assign({}, options), { isAnonymous: true, llmToolsConfiguration: [
+            return new RemoteLlmExecutionTools(__assign(__assign({}, options), { userId: null, isAnonymous: true, llmToolsConfiguration: [
                     {
                         title: 'Anthropic Claude (proxied)',
                         packageName: '@promptbook/anthropic-claude',
@@ -11856,12 +12165,12 @@
          * Calls OpenAI API to use a chat model.
          */
         AzureOpenAiExecutionTools.prototype.callChatModel = function (prompt) {
-            var _a, _b;
+            var _a, _b, _c;
             return __awaiter(this, void 0, void 0, function () {
                 var content, parameters, modelRequirements, client, modelName, modelSettings, rawPromptContent, messages, start, complete, rawRequest, rawResponse, resultContent, usage, error_1;
                 var _this = this;
-                return __generator(this, function (_c) {
-                    switch (_c.label) {
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
                         case 0:
                             if (this.options.isVerbose) {
                                 console.info('💬 OpenAI callChatModel call');
@@ -11869,20 +12178,20 @@
                             content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
                             return [4 /*yield*/, this.getClient()];
                         case 1:
-                            client = _c.sent();
+                            client = _d.sent();
                             // TODO: [☂] Use here more modelRequirements
                             if (modelRequirements.modelVariant !== 'CHAT') {
                                 throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
                             }
-                            _c.label = 2;
+                            _d.label = 2;
                         case 2:
-                            _c.trys.push([2, 4, , 5]);
+                            _d.trys.push([2, 4, , 5]);
                             modelName = prompt.modelRequirements.modelName || this.options.deploymentName;
                             modelSettings = {
                                 maxTokens: modelRequirements.maxTokens,
                                 //                                      <- TODO: [🌾] Make some global max cap for maxTokens
                                 temperature: modelRequirements.temperature,
-                                user: this.options.user,
+                                user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
                                 // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                                 // <- Note: [🧆]
                             };
@@ -11913,7 +12222,7 @@
                                     throw error;
                                 })];
                         case 3:
-                            rawResponse = _c.sent();
+                            rawResponse = _d.sent();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                             }
@@ -11932,8 +12241,8 @@
                             complete = getCurrentIsoDate();
                             usage = {
                                 price: uncertainNumber() /* <- TODO: [🐞] Compute usage */,
-                                input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
-                                output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
+                                input: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.promptTokens) }, computeUsageCounts(prompt.content)),
+                                output: __assign({ tokensCount: uncertainNumber((_c = rawResponse.usage) === null || _c === void 0 ? void 0 : _c.completionTokens) }, computeUsageCounts(prompt.content)),
                             };
                             return [2 /*return*/, $asDeeplyFrozenSerializableJson('AzureOpenAiExecutionTools ChatPromptResult', {
                                     content: resultContent,
@@ -11949,7 +12258,7 @@
                                     // <- [🗯]
                                 })];
                         case 4:
-                            error_1 = _c.sent();
+                            error_1 = _d.sent();
                             throw this.transformAzureError(error_1);
                         case 5: return [2 /*return*/];
                     }
@@ -11960,12 +12269,12 @@
          * Calls Azure OpenAI API to use a complete model.
          */
         AzureOpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
-            var _a, _b;
+            var _a, _b, _c;
             return __awaiter(this, void 0, void 0, function () {
                 var content, parameters, modelRequirements, client, modelName, modelSettings, start, complete, rawPromptContent, rawRequest, rawResponse, resultContent, usage, error_2;
                 var _this = this;
-                return __generator(this, function (_c) {
-                    switch (_c.label) {
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
                         case 0:
                             if (this.options.isVerbose) {
                                 console.info('🖋 OpenAI callCompletionModel call');
@@ -11973,20 +12282,20 @@
                             content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
                             return [4 /*yield*/, this.getClient()];
                         case 1:
-                            client = _c.sent();
+                            client = _d.sent();
                             // TODO: [☂] Use here more modelRequirements
                             if (modelRequirements.modelVariant !== 'COMPLETION') {
                                 throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
                             }
-                            _c.label = 2;
+                            _d.label = 2;
                         case 2:
-                            _c.trys.push([2, 4, , 5]);
+                            _d.trys.push([2, 4, , 5]);
                             modelName = prompt.modelRequirements.modelName || this.options.deploymentName;
                             modelSettings = {
                                 maxTokens: modelRequirements.maxTokens || 2000,
                                 //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
                                 temperature: modelRequirements.temperature,
-                                user: this.options.user,
+                                user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString(),
                                 // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                                 // <- Note: [🧆]
                             };
@@ -12009,7 +12318,7 @@
                                     throw error;
                                 })];
                         case 3:
-                            rawResponse = _c.sent();
+                            rawResponse = _d.sent();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                             }
@@ -12025,8 +12334,8 @@
                             complete = getCurrentIsoDate();
                             usage = {
                                 price: uncertainNumber() /* <- TODO: [🐞] Compute usage */,
-                                input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
-                                output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
+                                input: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.promptTokens) }, computeUsageCounts(prompt.content)),
+                                output: __assign({ tokensCount: uncertainNumber((_c = rawResponse.usage) === null || _c === void 0 ? void 0 : _c.completionTokens) }, computeUsageCounts(prompt.content)),
                             };
                             return [2 /*return*/, $asDeeplyFrozenSerializableJson('AzureOpenAiExecutionTools CompletionPromptResult', {
                                     content: resultContent,
@@ -12042,7 +12351,7 @@
                                     // <- [🗯]
                                 })];
                         case 4:
-                            error_2 = _c.sent();
+                            error_2 = _d.sent();
                             throw this.transformAzureError(error_2);
                         case 5: return [2 /*return*/];
                     }
@@ -12267,7 +12576,6 @@
          * @param options which are relevant are directly passed to the OpenAI client
          */
         function OpenAiExecutionTools(options) {
-            if (options === void 0) { options = {}; }
             this.options = options;
             /**
              * OpenAI API client.
@@ -12295,8 +12603,8 @@
                     if (this.client === null) {
                         openAiOptions = __assign({}, this.options);
                         delete openAiOptions.isVerbose;
-                        delete openAiOptions.user;
-                        this.client = new OpenAI__default["default"](__assign({}, openAiOptions));
+                        delete openAiOptions.userId;
+                        this.client = new OpenAI__default["default"](openAiOptions);
                     }
                     return [2 /*return*/, this.client];
                 });
@@ -12343,11 +12651,12 @@
          * Calls OpenAI API to use a chat model.
          */
         OpenAiExecutionTools.prototype.callChatModel = function (prompt) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
                 var content, parameters, modelRequirements, format, client, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
                 var _this = this;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
                         case 0:
                             if (this.options.isVerbose) {
                                 console.info('💬 OpenAI callChatModel call', { prompt: prompt });
@@ -12355,7 +12664,7 @@
                             content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements, format = prompt.format;
                             return [4 /*yield*/, this.getClient()];
                         case 1:
-                            client = _a.sent();
+                            client = _b.sent();
                             // TODO: [☂] Use here more modelRequirements
                             if (modelRequirements.modelVariant !== 'CHAT') {
                                 throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
@@ -12387,7 +12696,7 @@
                                         role: 'user',
                                         content: rawPromptContent,
                                     },
-                                ], false), user: this.options.user });
+                                ], false), user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                             start = getCurrentIsoDate();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
@@ -12399,7 +12708,7 @@
                                     throw error;
                                 })];
                         case 2:
-                            rawResponse = _a.sent();
+                            rawResponse = _b.sent();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                             }
@@ -12438,11 +12747,12 @@
          * Calls OpenAI API to use a complete model.
          */
         OpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
                 var content, parameters, modelRequirements, client, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
                 var _this = this;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
                         case 0:
                             if (this.options.isVerbose) {
                                 console.info('🖋 OpenAI callCompletionModel call', { prompt: prompt });
@@ -12450,7 +12760,7 @@
                             content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
                             return [4 /*yield*/, this.getClient()];
                         case 1:
-                            client = _a.sent();
+                            client = _b.sent();
                             // TODO: [☂] Use here more modelRequirements
                             if (modelRequirements.modelVariant !== 'COMPLETION') {
                                 throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
@@ -12465,7 +12775,7 @@
                                 // <- Note: [🧆]
                             };
                             rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
-                            rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: this.options.user });
+                            rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                             start = getCurrentIsoDate();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
@@ -12477,7 +12787,7 @@
                                     throw error;
                                 })];
                         case 2:
-                            rawResponse = _a.sent();
+                            rawResponse = _b.sent();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                             }
@@ -12703,17 +13013,16 @@
                                 assistant_id: this.assistantId,
                                 thread: {
                                     messages: [
-                                        // TODO: !!!!!! Allow threads to be passed
+                                        // TODO:  [🗯] !! Allow threads to be passed
                                         { role: 'user', content: rawPromptContent },
                                     ],
                                 },
-                                // !!!!!! user: this.options.user,
+                                // <- TODO: Add user identification here> user: this.options.user,
                             };
                             start = getCurrentIsoDate();
                             if (this.options.isVerbose) {
                                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
                             }
-                            console.log('!!!!!! OpenAI client', client);
                             return [4 /*yield*/, client.beta.threads.createAndRunStream(rawRequest)];
                         case 2:
                             stream = _g.sent();
@@ -12731,7 +13040,7 @@
                                     messageDelta.content[0].type === 'text') {
                                     console.info('messageDelta', (_a = messageDelta.content[0].text) === null || _a === void 0 ? void 0 : _a.value);
                                 }
-                                // TODO: !!!!!! report progress
+                                // <- TODO: [🐚] Make streaming and running tasks working
                             });
                             stream.on('messageCreated', function (message) {
                                 if (_this.options.isVerbose) {
@@ -12759,18 +13068,20 @@
                                 throw new PipelineExecutionError("There is NOT 'text' BUT ".concat((_b = rawResponse[0].content[0]) === null || _b === void 0 ? void 0 : _b.type, " finalMessages content type from OpenAI"));
                             }
                             resultContent = (_c = rawResponse[0].content[0]) === null || _c === void 0 ? void 0 : _c.text.value;
-                            //                                                     <- TODO: !!!!!! There are also annotations, maybe use them
+                            //                                                     <- TODO: [🧠] There are also annotations, maybe use them
                             // eslint-disable-next-line prefer-const
                             complete = getCurrentIsoDate();
                             usage = UNCERTAIN_USAGE;
-                            // TODO: !!!!!!> = computeOpenAiUsage(content, resultContent || '', rawResponse);
+                            // <- TODO: [🥘] Compute real usage for assistant
+                            //       ?> const usage = computeOpenAiUsage(content, resultContent || '', rawResponse);
                             if (resultContent === null) {
                                 throw new PipelineExecutionError('No response message from OpenAI');
                             }
                             return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiAssistantExecutionTools ChatPromptResult', {
                                     content: resultContent,
                                     modelName: 'assistant',
-                                    //          <- TODO: !!!!!! Can we detect really used model: rawResponse.model || modelName,
+                                    // <- TODO: [🥘] Detect used model in assistant
+                                    //       ?> model: rawResponse.model || modelName,
                                     timing: {
                                         start: start,
                                         complete: complete,
@@ -12788,7 +13099,6 @@
         return OpenAiAssistantExecutionTools;
     }(OpenAiExecutionTools));
     /**
-     * TODO: !!!!!! DO not use colors - can be used in browser
      * TODO: [🧠][🧙‍♂️] Maybe there can be some wizzard for thoose who want to use just OpenAI
      * TODO: Maybe make custom OpenAiError
      * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
@@ -12860,22 +13170,26 @@
     /**
      * Normalize options for `execCommand` and `execCommands`
      *
+     * Note: `$` is used to indicate that this function behaves differently according to `process.platform`
+     *
      * @private internal utility of `execCommand` and `execCommands`
      */
-    function execCommandNormalizeOptions(options) {
+    function $execCommandNormalizeOptions(options) {
         var _a;
-        var _b, _c, _d;
+        var _b, _c, _d, _e;
         var command;
         var cwd;
         var crashOnError;
         var args = [];
         var timeout;
+        var isVerbose;
         if (typeof options === 'string') {
             // TODO: [1] DRY default values
             command = options;
             cwd = process.cwd();
             crashOnError = true;
-            timeout = Infinity;
+            timeout = Infinity; // <- TODO: [⏳]
+            isVerbose = DEFAULT_IS_VERBOSE;
         }
         else {
             /*
@@ -12891,6 +13205,7 @@
             cwd = (_b = options.cwd) !== null && _b !== void 0 ? _b : process.cwd();
             crashOnError = (_c = options.crashOnError) !== null && _c !== void 0 ? _c : true;
             timeout = (_d = options.timeout) !== null && _d !== void 0 ? _d : Infinity;
+            isVerbose = (_e = options.isVerbose) !== null && _e !== void 0 ? _e : DEFAULT_IS_VERBOSE;
         }
         // TODO: /(-[a-zA-Z0-9-]+\s+[^\s]*)|[^\s]*/g
         var _ = Array.from(command.matchAll(/(".*")|([^\s]*)/g))
@@ -12912,16 +13227,21 @@
         if (['ts-node'].includes(humanReadableCommand)) {
             humanReadableCommand += " ".concat(args[1]);
         }
-        return { command: command, humanReadableCommand: humanReadableCommand, args: args, cwd: cwd, crashOnError: crashOnError, timeout: timeout };
+        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
+            command = "".concat(command, ".cmd");
+        }
+        return { command: command, humanReadableCommand: humanReadableCommand, args: args, cwd: cwd, crashOnError: crashOnError, timeout: timeout, isVerbose: isVerbose };
     }
     // TODO: This should show type error> execCommandNormalizeOptions({ command: '', commands: [''] });
 
     /**
      * Run one command in a shell
      *
+     *
      * Note: There are 2 similar functions in the codebase:
      * - `$execCommand` which runs a single command
      * - `$execCommands` which runs multiple commands
+     * Note: `$` is used to indicate that this function is not a pure function - it runs a command in a shell
      *
      * @public exported from `@promptbook/node`
      */
@@ -12931,7 +13251,7 @@
         }
         return new Promise(function (resolve, reject) {
             // eslint-disable-next-line prefer-const
-            var _a = execCommandNormalizeOptions(options), command = _a.command, humanReadableCommand = _a.humanReadableCommand, args = _a.args, cwd = _a.cwd, crashOnError = _a.crashOnError, timeout = _a.timeout;
+            var _a = $execCommandNormalizeOptions(options), command = _a.command, humanReadableCommand = _a.humanReadableCommand, args = _a.args, cwd = _a.cwd, crashOnError = _a.crashOnError, timeout = _a.timeout, _b = _a.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
             if (timeout !== Infinity) {
                 // TODO: In waitasecond forTime(Infinity) should be equivalent to forEver()
                 waitasecond.forTime(timeout).then(function () {
@@ -12944,24 +13264,26 @@
                     }
                 });
             }
-            if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
-                command = "".concat(command, ".cmd");
+            if (isVerbose) {
+                console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
             }
-            // !!!!!! Verbose mode - to all consoles
-            console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
             try {
                 var commandProcess = child_process.spawn(command, args, { cwd: cwd, shell: true });
-                commandProcess.on('message', function (message) {
-                    console.info({ message: message });
-                });
+                if (isVerbose) {
+                    commandProcess.on('message', function (message) {
+                        console.info({ message: message });
+                    });
+                }
                 var output_1 = [];
                 commandProcess.stdout.on('data', function (stdout) {
                     output_1.push(stdout.toString());
-                    console.info(stdout.toString());
+                    if (isVerbose) {
+                        console.info(stdout.toString());
+                    }
                 });
                 commandProcess.stderr.on('data', function (stderr) {
                     output_1.push(stderr.toString());
-                    if (stderr.toString().trim()) {
+                    if (isVerbose && stderr.toString().trim()) {
                         console.warn(stderr.toString());
                     }
                 });
@@ -12972,7 +13294,9 @@
                                 "Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code)));
                         }
                         else {
-                            console.warn("Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code));
+                            if (isVerbose) {
+                                console.warn("Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code));
+                            }
                             resolve(spaceTrim.spaceTrim(output_1.join('\n')));
                         }
                     }
@@ -12991,7 +13315,9 @@
                         reject(new Error("Command \"".concat(humanReadableCommand, "\" failed: \n").concat(error.message)));
                     }
                     else {
-                        console.warn(error);
+                        if (isVerbose) {
+                            console.warn(error);
+                        }
                         resolve(spaceTrim.spaceTrim(output_1.join('\n')));
                     }
                 });
@@ -13015,12 +13341,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'))
@@ -13030,7 +13356,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('/') +
@@ -13050,7 +13376,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');
                                                 }
@@ -13074,7 +13400,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
      */
@@ -13091,7 +13417,7 @@
         mimeTypes: ['text/markdown', 'text/plain'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: true,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13135,7 +13461,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');
@@ -13234,7 +13560,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];
@@ -13285,7 +13612,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
@@ -13325,12 +13652,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');
                             }
@@ -13338,7 +13666,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) {
@@ -13349,7 +13677,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'md',
                                     isVerbose: isVerbose,
                                 })];
@@ -13358,11 +13686,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:
@@ -13407,9 +13733,14 @@
                                 asJson: function () {
                                     throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
                                 },
-                                asBlob: function () {
-                                    throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asBlob`');
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > asBlob() {
+                                    >     throw new UnexpectedError(
+                                    >         'Did not expect that `markdownScraper` would need to get the content `asBlob`',
+                                    >     );
+                                    > },
+                                */
                             };
                             knowledge = this.markdownScraper.scrape(markdownSource);
                             return [4 /*yield*/, cacheFilehandler.destroy()];
@@ -13441,7 +13772,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
@@ -13454,7 +13789,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`
@@ -13481,12 +13816,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');
                             }
@@ -13494,7 +13830,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) {
@@ -13505,7 +13841,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'docx',
                                     isVerbose: isVerbose,
                                 })];
@@ -13520,11 +13856,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:
@@ -13572,9 +13906,14 @@
                                 asJson: function () {
                                     throw new UnexpectedError('Did not expect that `documentScraper` would need to get the content `asJson`');
                                 },
-                                asBlob: function () {
-                                    throw new UnexpectedError('Did not expect that `documentScraper` would need to get the content `asBlob`');
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > asBlob() {
+                                    >     throw new UnexpectedError(
+                                    >         'Did not expect that `documentScraper` would need to get the content `asBlob`',
+                                    >     );
+                                    > },
+                                */
                             };
                             knowledge = this.documentScraper.scrape(markdownSource);
                             return [4 /*yield*/, cacheFilehandler.destroy()];
@@ -13681,7 +14020,7 @@
         mimeTypes: ['application/pdf'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: true,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13694,7 +14033,7 @@
     var _PdfScraperMetadataRegistration = $scrapersMetadataRegister.register(pdfScraperMetadata);
 
     /**
-     * Scraper for .docx files
+     * Scraper for .pdf files
      *
      * @see `documentationUrl` for more details
      * @public exported from `@promptbook/pdf`
@@ -13737,9 +14076,8 @@
                     TODO_USE(this.options);
                     /*
                     const {
-                        externalProgramsPaths = {},
                         cacheDirname = SCRAPE_CACHE_DIRNAME,
-                        isCacheCleaned = false,
+                         intermediateFilesStrategy = DEFAULT_INTERMEDIATE_FILES_STRATEGY,
                         isVerbose = IS_VERBOSE,
                     } = options;
                     */
@@ -13792,7 +14130,7 @@
         mimeTypes: ['text/html'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -13805,32 +14143,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`
@@ -13840,6 +14175,7 @@
             this.tools = tools;
             this.options = options;
             this.markdownScraper = new MarkdownScraper(tools, options);
+            this.showdownConverter = createShowdownConverter();
         }
         Object.defineProperty(WebsiteScraper.prototype, "metadata", {
             /**
@@ -13860,16 +14196,17 @@
             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;
-                            // TODO: !!!!!! Does this work in browser? Make it work.
+                            _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;
                             if (source.url === null) {
                                 throw new KnowledgeScrapeError('Website scraper requires URL');
                             }
+                            if (this.tools.fs === undefined) {
+                                throw new EnvironmentMismatchError('Can not scrape websites without filesystem tools');
+                            }
                             _f = jsdom.JSDOM.bind;
                             return [4 /*yield*/, source.asText()];
                         case 1:
@@ -13878,10 +14215,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++) {
@@ -13893,16 +14226,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:
+                            return [4 /*yield*/, this.tools.fs.writeFile(cacheFilehandler.filename, html, 'utf-8')];
+                        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 })];
                     }
                 });
@@ -13930,9 +14263,14 @@
                                 asJson: function () {
                                     throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
                                 },
-                                asBlob: function () {
-                                    throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asBlob`');
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > asBlob() {
+                                    >     throw new UnexpectedError(
+                                    >         'Did not expect that `markdownScraper` would need to get the content `asBlob`',
+                                    >     );
+                                    > },
+                                */
                             };
                             knowledge = this.markdownScraper.scrape(markdownSource);
                             return [4 /*yield*/, cacheFilehandler.destroy()];
@@ -13946,7 +14284,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