@promptbook/cli 0.72.0-9 → 0.72.0

package/esm/index.es.js

@@ -2,7 +2,7 @@ import commander from 'commander';
 import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import colors from 'colors';
 import { forTime } from 'waitasecond';
-import { stat, access, constants, readFile, readdir, writeFile, mkdir, unlink, rm, rmdir, rename } from 'fs/promises';
+import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink, rm, rmdir, rename } from 'fs/promises';
 import { join, basename, dirname } from 'path';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
@@ -10,6 +10,8 @@ import { unparse, parse } from 'papaparse';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import { lookup } from 'mime-types';
+import { exec as exec$2, spawn } from 'child_process';
+import { promisify } from 'util';
 import * as dotenv from 'dotenv';
 import sha256 from 'crypto-js/sha256';
 import glob from 'glob-promise';
@@ -17,7 +19,6 @@ import { io } from 'socket.io-client';
 import Anthropic from '@anthropic-ai/sdk';
 import { OpenAIClient, AzureKeyCredential } from '@azure/openai';
 import OpenAI from 'openai';
-import { spawn } from 'child_process';
 import { Readability } from '@mozilla/readability';
 import { JSDOM } from 'jsdom';
 import { Converter } from 'showdown';
@@ -26,7 +27,7 @@ import { Converter } from 'showdown';
 /**
  * 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
 
 /*! *****************************************************************************
@@ -399,7 +400,8 @@ var GENERATOR_WARNING = "\u26A0\uFE0F WARNING: This code has been generated so t
  *
  * @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
  *
@@ -419,6 +421,7 @@ var LOOP_LIMIT = 1000;
  * @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
  *
@@ -432,23 +435,30 @@ var CONNECTION_RETRIES_LIMIT = 5;
  */
 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
  *
@@ -456,7 +466,7 @@ var MAX_FILENAME_LENGTH = 30;
  *
  * @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
  *
@@ -464,13 +474,13 @@ var EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
  *
  * @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
  *
@@ -534,13 +544,13 @@ var DEFAULT_CSV_SETTINGS = Object.freeze({
  *
  * @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;
 /**
  * @@@
  *
@@ -613,271 +623,6 @@ function initializeHelloCommand(program) {
  * 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: stat,
-        access: access,
-        constants: constants,
-        readFile: readFile,
-        readdir: 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(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
  *
@@ -963,7 +708,6 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += description;
     }
-    // TODO:> const commands: Array<Command>
     var commands = [];
     if (pipelineUrl) {
         commands.push("PIPELINE URL ".concat(pipelineUrl));
@@ -1019,7 +763,6 @@ function pipelineJsonToString(pipelineJson) {
                 pipelineString += '\n\n';
                 pipelineString += description_1;
             }
-            // TODO:> const commands: Array<Command>
             var commands_1 = [];
             var contentLanguage = 'text';
             if (templateType === 'PROMPT_TEMPLATE') {
@@ -1318,8 +1061,7 @@ var PipelineExecutionError = /** @class */ (function (_super) {
  * 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 () {
     /**
@@ -2478,6 +2220,22 @@ var LimitReachedError = /** @class */ (function (_super) {
     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(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
  *
@@ -2539,6 +2297,7 @@ function assertsExecutionSuccessful(executionResult) {
     }
 }
 /**
+ * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
  * TODO: [🧠] Can this return type be better typed than void
  */
 
@@ -2796,6 +2555,23 @@ function union() {
     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
  *
@@ -3828,12 +3604,11 @@ function checkExpectations(expectations, value) {
  */
 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,
@@ -4199,12 +3974,12 @@ function executeAttempts(options) {
  */
 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)];
                     }
@@ -4234,7 +4009,7 @@ function executeFormatSubvalues(options) {
                             .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 () {
@@ -4387,13 +4162,12 @@ function getReservedParametersForTemplate(options) {
  */
 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);
@@ -4408,7 +4182,7 @@ function executeTemplate(options) {
                             // <- [🍸]
                         })];
                 case 1:
-                    _h.sent();
+                    _j.sent();
                     usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
                     dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
                     // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -4419,15 +4193,15 @@ function executeTemplate(options) {
                             .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) {
@@ -4447,15 +4221,15 @@ function executeTemplate(options) {
                     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; }
                     }
@@ -4475,12 +4249,11 @@ function executeTemplate(options) {
                             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,
@@ -4492,12 +4265,12 @@ function executeTemplate(options) {
                             // <- [🍸]
                         })];
                 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))];
             }
         });
     });
@@ -4556,13 +4329,12 @@ function filterJustOutputParameters(options) {
  */
 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, {
@@ -4747,12 +4519,7 @@ function executePipeline(options) {
                                     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(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')
@@ -4762,11 +4529,7 @@ function executePipeline(options) {
                                             if (onProgress) {
                                                 onProgress(progress);
                                             }
-                                        },
-                                        settings: settings,
-                                        $executionReport: executionReport,
-                                        pipelineIdentification: 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(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);
@@ -4870,8 +4633,7 @@ function executePipeline(options) {
  */
 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 [🚞]
@@ -4905,14 +4667,12 @@ function createPipelineExecutor(options) {
                     tools: tools,
                     onProgress: onProgress,
                     pipelineIdentification: 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,
                 })];
         });
     }); };
@@ -4935,7 +4695,7 @@ function preparePersona(personaDescription, tools, options) {
         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');
                     }
@@ -4991,20 +4751,171 @@ function preparePersona(personaDescription, tools, options) {
  */
 
 /**
- * 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
+ */
 
 /**
  * @@@
@@ -5013,12 +4924,11 @@ var KnowledgeScrapeError = /** @class */ (function (_super) {
  * @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
  *
@@ -5185,7 +5095,6 @@ function normalizeToKebabCase(text) {
  * @private within the repository
  */
 function sourceContentToName(sourceContent) {
-    // TODO: !!!!!! Better name for source than gibberish hash
     var hash = SHA256(hexEncoder.parse(JSON.stringify(sourceContent)))
         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
         .toString( /* hex */)
@@ -5285,20 +5194,20 @@ function isValidFilePath(filename) {
 /**
  * @@@
  *
- * @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);
@@ -5314,19 +5223,14 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                             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;
@@ -5366,34 +5270,31 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                     }
                     filename_1 = 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$1(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;
@@ -5429,9 +5330,14 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                         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`',
+                            >     );
+                            > },
+                        */
                     }];
             }
         });
@@ -5451,7 +5357,7 @@ function prepareKnowledgePieces(knowledgeSources, tools, options) {
         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;
@@ -5480,7 +5386,8 @@ function prepareKnowledgePieces(knowledgeSources, tools, options) {
                                     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;
@@ -5528,7 +5435,7 @@ TODO: [🧊] This is how it can look in future
 >   /**
 >    * Unprepared knowledge
 >    * /
->   readonly knowledgeSources: Array<KnowledgeSourceJson>;
+>   readonly knowledgeSources: ReadonlyArray<KnowledgeSourceJson>;
 > };
 >
 > export async function prepareKnowledgePieces(
@@ -5586,7 +5493,7 @@ function prepareTemplates(pipeline, tools, options) {
         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);
@@ -5648,7 +5555,7 @@ function preparePipeline(pipeline, tools, options) {
                     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');
@@ -5706,7 +5613,9 @@ function preparePipeline(pipeline, tools, options) {
                     // ----- /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) }))];
             }
         });
     });
@@ -5753,6 +5662,7 @@ var knowledgeCommandParser = {
         '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
@@ -8427,38 +8337,359 @@ function pipelineStringToJsonSync(pipelineString) {
  * 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 = promisify(exec$2);
+/**
+ * @@@
+ *
+ * @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: stat,
+        access: access,
+        constants: constants,
+        readFile: readFile,
+        writeFile: writeFile,
+        readdir: 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 = promisify(exec$2);
+/**
+ * @@@
+ *
+ * @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, 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,
+                        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 = prefix + windowsSuffix;
+                    return [4 /*yield*/, isExecutable(path, $provideFilesystemForNode())];
+                case 3:
+                    if (_c.sent()) {
+                        return [2 /*return*/, path];
+                    }
+                    _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
  */
 
 /**
@@ -8630,7 +8861,7 @@ function $registeredLlmToolsMessage() {
  */
 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()
@@ -8641,7 +8872,7 @@ function createLlmToolsFromConfiguration(configuration, options) {
         if (registeredItem === undefined) {
             throw new Error(spaceTrim$1(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));
 }
@@ -8691,6 +8922,64 @@ function $provideLlmToolsFromEnv(options) {
  * 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.
  *
@@ -9145,7 +9434,7 @@ var JavascriptExecutionTools = JavascriptEvalExecutionTools;
  */
 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) {
@@ -9155,12 +9444,16 @@ function $provideExecutionToolsForNode(options) {
                     }
                     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);
@@ -9398,7 +9691,9 @@ function createCollectionFromDirectory(path, tools, options) {
                         throw new EnvironmentMismatchError('Can not create collection without filesystem tools');
                         //          <- TODO: [🧠] What is the best error type here`
                     }
-                    makedLibraryFilePath = join(path, "".concat(PIPELINE_COLLECTION_BASE_FILENAME, ".json"));
+                    makedLibraryFilePath = join(path, "".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())) {
@@ -9409,7 +9704,7 @@ function createCollectionFromDirectory(path, tools, options) {
                         // 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;
@@ -9881,7 +10176,7 @@ function $currentDate() {
 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() {
@@ -9903,7 +10198,7 @@ function cacheLlmTools(llmTools, options) {
                     key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
                         '-' +
                         sha256(hexEncoder.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();
@@ -9989,12 +10284,14 @@ function $provideLlmToolsForCli(options) {
     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: join(process.cwd(), EXECUTIONS_CACHE_DIRNAME) }),
-        isReloaded: isCacheCleaned,
+        storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
+            rootFolderPath: join(process.cwd(), DEFAULT_EXECUTIONS_CACHE_DIRNAME),
+        }),
+        isCacheReloaded: isCacheReloaded,
     });
 }
 /**
@@ -10021,13 +10318,13 @@ function initializeMakeCommand(program) {
     makeCommand.option('-f, --format <format>', spaceTrim$1("\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$1("\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$1("\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, _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) {
@@ -10041,22 +10338,25 @@ function initializeMakeCommand(program) {
                             .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.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)*/
@@ -10065,31 +10365,31 @@ function initializeMakeCommand(program) {
                         return [4 /*yield*/, createCollectionFromDirectory(path, 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);
@@ -10097,37 +10397,37 @@ function initializeMakeCommand(program) {
                                 console.info(colors.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 () {
@@ -10146,9 +10446,9 @@ function initializeMakeCommand(program) {
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
-                                        filename = outFile !== PIPELINE_COLLECTION_BASE_FILENAME
+                                        filename = outFile !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                                             ? outFile
-                                            : join(path, "".concat(PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
+                                            : join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
                                         if (!outFile.endsWith(".".concat(extension))) {
                                             console.warn(colors.yellow("Warning: Extension of output file should be \"".concat(extension, "\"")));
                                         }
@@ -10164,27 +10464,27 @@ function initializeMakeCommand(program) {
                                 }
                             });
                         }); };
-                        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$1(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$1(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.yellow("Format ".concat(formats.join(' and '), " is not supported")));
                         }
@@ -10446,76 +10746,79 @@ function initializeTestCommand(program) {
     // <- 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(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*/, 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.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*/, 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.gray("Skipping ".concat(filename)));
                         }
-                        return [3 /*break*/, 13];
-                    case 11:
+                        return [3 /*break*/, 14];
+                    case 12:
                         validatePipeline(pipeline);
                         console.info(colors.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;
@@ -10524,22 +10827,22 @@ function initializeTestCommand(program) {
                         console.error(colors.bgRed(error_1.name /* <- 11:11 */));
                         console.error(colors.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.green("All pipelines are valid"));
                         process.exit(0);
                         return [2 /*return*/];
@@ -10653,6 +10956,7 @@ var _AnthropicClaudeMetadataRegistration = $llmToolsMetadataRegister.register({
  * @public exported from `@promptbook/remote-client`
  */
 var RemoteLlmExecutionTools = /** @class */ (function () {
+    /* <- TODO: [🍚] `, Destroyable` */
     function RemoteLlmExecutionTools(options) {
         this.options = options;
     }
@@ -10702,12 +11006,16 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                         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) {
@@ -10801,7 +11109,9 @@ var RemoteLlmExecutionTools = /** @class */ (function () {
                         else {
                             socket.emit('prompt-request', {
                                 isAnonymous: false,
+                                appId: this.options.appId,
                                 userId: this.options.userId,
+                                customOptions: this.options.customOptions,
                                 prompt: prompt,
                             } /* <- TODO: [🤛] */);
                         }
@@ -11283,7 +11593,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
  */
 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',
@@ -11843,12 +12153,12 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
      * 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');
@@ -11856,20 +12166,20 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                         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: [🧆]
                         };
@@ -11900,7 +12210,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                                 throw error;
                             })];
                     case 3:
-                        rawResponse = _c.sent();
+                        rawResponse = _d.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -11919,8 +12229,8 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                         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,
@@ -11936,7 +12246,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                                 // <- [🗯]
                             })];
                     case 4:
-                        error_1 = _c.sent();
+                        error_1 = _d.sent();
                         throw this.transformAzureError(error_1);
                     case 5: return [2 /*return*/];
                 }
@@ -11947,12 +12257,12 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
      * 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');
@@ -11960,20 +12270,20 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                         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: [🧆]
                         };
@@ -11996,7 +12306,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                                 throw error;
                             })];
                     case 3:
-                        rawResponse = _c.sent();
+                        rawResponse = _d.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -12012,8 +12322,8 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                         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,
@@ -12029,7 +12339,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                                 // <- [🗯]
                             })];
                     case 4:
-                        error_2 = _c.sent();
+                        error_2 = _d.sent();
                         throw this.transformAzureError(error_2);
                     case 5: return [2 /*return*/];
                 }
@@ -12254,7 +12564,6 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * @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.
@@ -12282,8 +12591,8 @@ var OpenAiExecutionTools = /** @class */ (function () {
                 if (this.client === null) {
                     openAiOptions = __assign({}, this.options);
                     delete openAiOptions.isVerbose;
-                    delete openAiOptions.user;
-                    this.client = new OpenAI(__assign({}, openAiOptions));
+                    delete openAiOptions.userId;
+                    this.client = new OpenAI(openAiOptions);
                 }
                 return [2 /*return*/, this.client];
             });
@@ -12330,11 +12639,12 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * 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 });
@@ -12342,7 +12652,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         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');
@@ -12374,7 +12684,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                                     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.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
@@ -12386,7 +12696,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                                 throw error;
                             })];
                     case 2:
-                        rawResponse = _a.sent();
+                        rawResponse = _b.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -12425,11 +12735,12 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * 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 });
@@ -12437,7 +12748,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         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');
@@ -12452,7 +12763,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             // <- 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.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
@@ -12464,7 +12775,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                                 throw error;
                             })];
                     case 2:
-                        rawResponse = _a.sent();
+                        rawResponse = _b.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -12690,17 +13001,16 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                             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.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();
@@ -12718,7 +13028,7 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                                 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) {
@@ -12746,18 +13056,20 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                             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,
@@ -12775,7 +13087,6 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
     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
@@ -12847,22 +13158,26 @@ var _OpenAiAssistantRegistration = $llmToolsRegister.register(createOpenAiAssist
 /**
  * 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 {
         /*
@@ -12878,6 +13193,7 @@ function execCommandNormalizeOptions(options) {
         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))
@@ -12899,16 +13215,21 @@ function execCommandNormalizeOptions(options) {
     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`
  */
@@ -12918,7 +13239,7 @@ function $execCommand(options) {
     }
     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()
             forTime(timeout).then(function () {
@@ -12931,24 +13252,26 @@ function $execCommand(options) {
                 }
             });
         }
-        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
-            command = "".concat(command, ".cmd");
+        if (isVerbose) {
+            console.info(colors.yellow(cwd) + ' ' + colors.green(command) + ' ' + colors.blue(args.join(' ')));
         }
-        // !!!!!! Verbose mode - to all consoles
-        console.info(colors.yellow(cwd) + ' ' + colors.green(command) + ' ' + colors.blue(args.join(' ')));
         try {
             var commandProcess = 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());
                 }
             });
@@ -12959,7 +13282,9 @@ function $execCommand(options) {
                             "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(output_1.join('\n')));
                     }
                 }
@@ -12978,7 +13303,9 @@ function $execCommand(options) {
                     reject(new Error("Command \"".concat(humanReadableCommand, "\" failed: \n").concat(error.message)));
                 }
                 else {
-                    console.warn(error);
+                    if (isVerbose) {
+                        console.warn(error);
+                    }
                     resolve(spaceTrim(output_1.join('\n')));
                 }
             });
@@ -13002,12 +13329,12 @@ function $execCommand(options) {
  */
 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 = SHA256(
                     //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
                     hexEncoder.parse(sourceFilename || url || 'untitled'))
@@ -13017,7 +13344,7 @@ function getScraperIntermediateSource(source, options) {
                     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 = join.apply(void 0, __spreadArray(__spreadArray([process.cwd(),
                         cacheDirname], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), [name], false)).split('\\')
                         .join('/') +
@@ -13037,7 +13364,7 @@ function getScraperIntermediateSource(source, options) {
                                 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');
                                             }
@@ -13061,7 +13388,7 @@ function getScraperIntermediateSource(source, options) {
 /**
  * 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
  */
@@ -13078,7 +13405,7 @@ var markdownScraperMetadata = $deepFreeze({
     mimeTypes: ['text/markdown', 'text/plain'],
     documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
     isAvilableInBrowser: true,
-    requiredExecutables: ['!!!!!!'],
+    requiredExecutables: [],
 }); /* <- TODO: [🤛] */
 /**
  * Registration of known scraper metadata
@@ -13122,7 +13449,7 @@ var MarkdownScraper = /** @class */ (function () {
             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');
@@ -13221,7 +13548,8 @@ var MarkdownScraper = /** @class */ (function () {
                                             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];
@@ -13272,7 +13600,7 @@ var documentScraperMetadata = $deepFreeze({
     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
@@ -13312,12 +13640,13 @@ var DocumentScraper = /** @class */ (function () {
      * 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');
                         }
@@ -13325,7 +13654,7 @@ var DocumentScraper = /** @class */ (function () {
                             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) {
@@ -13336,7 +13665,7 @@ var DocumentScraper = /** @class */ (function () {
                         return [4 /*yield*/, getScraperIntermediateSource(source, {
                                 rootDirname: rootDirname,
                                 cacheDirname: cacheDirname,
-                                isCacheCleaned: isCacheCleaned,
+                                intermediateFilesStrategy: intermediateFilesStrategy,
                                 extension: 'md',
                                 isVerbose: isVerbose,
                             })];
@@ -13345,11 +13674,9 @@ var DocumentScraper = /** @class */ (function () {
                         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:
@@ -13394,9 +13721,14 @@ var DocumentScraper = /** @class */ (function () {
                             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()];
@@ -13428,7 +13760,11 @@ var legacyDocumentScraperMetadata = $deepFreeze({
     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
@@ -13441,7 +13777,7 @@ var legacyDocumentScraperMetadata = $deepFreeze({
 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`
@@ -13468,12 +13804,13 @@ var LegacyDocumentScraper = /** @class */ (function () {
      * 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');
                         }
@@ -13481,7 +13818,7 @@ var LegacyDocumentScraper = /** @class */ (function () {
                             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) {
@@ -13492,7 +13829,7 @@ var LegacyDocumentScraper = /** @class */ (function () {
                         return [4 /*yield*/, getScraperIntermediateSource(source, {
                                 rootDirname: rootDirname,
                                 cacheDirname: cacheDirname,
-                                isCacheCleaned: isCacheCleaned,
+                                intermediateFilesStrategy: intermediateFilesStrategy,
                                 extension: 'docx',
                                 isVerbose: isVerbose,
                             })];
@@ -13507,11 +13844,9 @@ var LegacyDocumentScraper = /** @class */ (function () {
                         documentSourceOutdirPathForLibreOffice_1 = join(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*/, readdir(documentSourceOutdirPathForLibreOffice_1)];
                     case 4:
@@ -13559,9 +13894,14 @@ var LegacyDocumentScraper = /** @class */ (function () {
                             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()];
@@ -13668,7 +14008,7 @@ var pdfScraperMetadata = $deepFreeze({
     mimeTypes: ['application/pdf'],
     documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
     isAvilableInBrowser: true,
-    requiredExecutables: ['!!!!!!'],
+    requiredExecutables: [],
 }); /* <- TODO: [🤛] */
 /**
  * Registration of known scraper metadata
@@ -13681,7 +14021,7 @@ var pdfScraperMetadata = $deepFreeze({
 var _PdfScraperMetadataRegistration = $scrapersMetadataRegister.register(pdfScraperMetadata);
 
 /**
- * Scraper for .docx files
+ * Scraper for .pdf files
  *
  * @see `documentationUrl` for more details
  * @public exported from `@promptbook/pdf`
@@ -13724,9 +14064,8 @@ var PdfScraper = /** @class */ (function () {
                 TODO_USE(this.options);
                 /*
                 const {
-                    externalProgramsPaths = {},
                     cacheDirname = SCRAPE_CACHE_DIRNAME,
-                    isCacheCleaned = false,
+                     intermediateFilesStrategy = DEFAULT_INTERMEDIATE_FILES_STRATEGY,
                     isVerbose = IS_VERBOSE,
                 } = options;
                 */
@@ -13779,7 +14118,7 @@ var websiteScraperMetadata = $deepFreeze({
     mimeTypes: ['text/html'],
     documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
     isAvilableInBrowser: false,
-    requiredExecutables: ['!!!!!!'],
+    requiredExecutables: [],
 }); /* <- TODO: [🤛] */
 /**
  * Registration of known scraper metadata
@@ -13792,32 +14131,29 @@ var websiteScraperMetadata = $deepFreeze({
 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 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 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`
@@ -13827,6 +14163,7 @@ var WebsiteScraper = /** @class */ (function () {
         this.tools = tools;
         this.options = options;
         this.markdownScraper = new MarkdownScraper(tools, options);
+        this.showdownConverter = createShowdownConverter();
     }
     Object.defineProperty(WebsiteScraper.prototype, "metadata", {
         /**
@@ -13847,16 +14184,17 @@ var WebsiteScraper = /** @class */ (function () {
         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, _f, reader, article, html, i, cacheFilehandler, markdown;
+            rootDirname, _c, cacheDirname, _d, intermediateFilesStrategy, _e, isVerbose, jsdom, _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.bind;
                         return [4 /*yield*/, source.asText()];
                     case 1:
@@ -13865,10 +14203,6 @@ var WebsiteScraper = /** @class */ (function () {
                             }]))();
                         reader = new Readability(jsdom.window.document);
                         article = reader.parse();
-                        console.log(article);
-                        return [4 /*yield*/, 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.window.document.body.innerHTML;
                         // Note: Unwrap html such as it is convertable by `markdownConverter`
                         for (i = 0; i < 2; i++) {
@@ -13880,16 +14214,16 @@ var WebsiteScraper = /** @class */ (function () {
                         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*/, 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.window.document);
+                        markdown = this.showdownConverter.makeMarkdown(html, jsdom.window.document);
                         return [2 /*return*/, __assign(__assign({}, cacheFilehandler), { markdown: markdown })];
                 }
             });
@@ -13917,9 +14251,14 @@ var WebsiteScraper = /** @class */ (function () {
                             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()];
@@ -13933,7 +14272,6 @@ var WebsiteScraper = /** @class */ (function () {
     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