@promptbook/legacy-documents 0.72.0-9 → 0.73.0

package/umd/index.umd.js

@@ -15,7 +15,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.72.0-8';
+    var PROMPTBOOK_VERSION = '0.72.0';
     // TODO: [main] !!!! List here all the versions and annotate + put into script
 
     /*! *****************************************************************************
@@ -363,18 +363,25 @@
      * @private within the repository - too low-level in comparison with other `MAX_...`
      */
     var IMMEDIATE_TIME = 10;
+    /**
+     * Strategy for caching the intermediate results for knowledge sources
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var DEFAULT_INTERMEDIATE_FILES_STRATEGY = 'HIDE_AND_KEEP';
+    //                                                     <- TODO: [😡] Change to 'VISIBLE'
     /**
      * The maximum number of (LLM) tasks running in parallel
      *
      * @public exported from `@promptbook/core`
      */
-    var MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
+    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 MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
+    var DEFAULT_MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
     /**
      * Where to store the scrape cache
      *
@@ -382,7 +389,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var SCRAPE_CACHE_DIRNAME = '/.promptbook/scrape-cache';
+    var DEFAULT_SCRAPE_CACHE_DIRNAME = '/.promptbook/scrape-cache';
     /**
      * Nonce which is used for replacing things in strings
      *
@@ -398,10 +405,10 @@
         'content',
         'context',
         'knowledge',
-        'samples',
+        'examples',
         'modelName',
         'currentDate',
-        // <- TODO: !!!!! list here all command names
+        // <- TODO: list here all command names
         // <- TODO: Add more like 'date', 'modelName',...
         // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
     ]);
@@ -434,7 +441,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    var IS_VERBOSE = false;
+    var DEFAULT_IS_VERBOSE = false;
     /**
      * @@@
      *
@@ -508,22 +515,26 @@
     /**
      * Normalize options for `execCommand` and `execCommands`
      *
+     * Note: `$` is used to indicate that this function behaves differently according to `process.platform`
+     *
      * @private internal utility of `execCommand` and `execCommands`
      */
-    function execCommandNormalizeOptions(options) {
+    function $execCommandNormalizeOptions(options) {
         var _a;
-        var _b, _c, _d;
+        var _b, _c, _d, _e;
         var command;
         var cwd;
         var crashOnError;
         var args = [];
         var timeout;
+        var isVerbose;
         if (typeof options === 'string') {
             // TODO: [1] DRY default values
             command = options;
             cwd = process.cwd();
             crashOnError = true;
-            timeout = Infinity;
+            timeout = Infinity; // <- TODO: [⏳]
+            isVerbose = DEFAULT_IS_VERBOSE;
         }
         else {
             /*
@@ -539,6 +550,7 @@
             cwd = (_b = options.cwd) !== null && _b !== void 0 ? _b : process.cwd();
             crashOnError = (_c = options.crashOnError) !== null && _c !== void 0 ? _c : true;
             timeout = (_d = options.timeout) !== null && _d !== void 0 ? _d : Infinity;
+            isVerbose = (_e = options.isVerbose) !== null && _e !== void 0 ? _e : DEFAULT_IS_VERBOSE;
         }
         // TODO: /(-[a-zA-Z0-9-]+\s+[^\s]*)|[^\s]*/g
         var _ = Array.from(command.matchAll(/(".*")|([^\s]*)/g))
@@ -560,16 +572,21 @@
         if (['ts-node'].includes(humanReadableCommand)) {
             humanReadableCommand += " ".concat(args[1]);
         }
-        return { command: command, humanReadableCommand: humanReadableCommand, args: args, cwd: cwd, crashOnError: crashOnError, timeout: timeout };
+        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
+            command = "".concat(command, ".cmd");
+        }
+        return { command: command, humanReadableCommand: humanReadableCommand, args: args, cwd: cwd, crashOnError: crashOnError, timeout: timeout, isVerbose: isVerbose };
     }
     // TODO: This should show type error> execCommandNormalizeOptions({ command: '', commands: [''] });
 
     /**
      * Run one command in a shell
      *
+     *
      * Note: There are 2 similar functions in the codebase:
      * - `$execCommand` which runs a single command
      * - `$execCommands` which runs multiple commands
+     * Note: `$` is used to indicate that this function is not a pure function - it runs a command in a shell
      *
      * @public exported from `@promptbook/node`
      */
@@ -579,7 +596,7 @@
         }
         return new Promise(function (resolve, reject) {
             // eslint-disable-next-line prefer-const
-            var _a = execCommandNormalizeOptions(options), command = _a.command, humanReadableCommand = _a.humanReadableCommand, args = _a.args, cwd = _a.cwd, crashOnError = _a.crashOnError, timeout = _a.timeout;
+            var _a = $execCommandNormalizeOptions(options), command = _a.command, humanReadableCommand = _a.humanReadableCommand, args = _a.args, cwd = _a.cwd, crashOnError = _a.crashOnError, timeout = _a.timeout, _b = _a.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
             if (timeout !== Infinity) {
                 // TODO: In waitasecond forTime(Infinity) should be equivalent to forEver()
                 waitasecond.forTime(timeout).then(function () {
@@ -592,24 +609,26 @@
                     }
                 });
             }
-            if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
-                command = "".concat(command, ".cmd");
+            if (isVerbose) {
+                console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
             }
-            // !!!!!! Verbose mode - to all consoles
-            console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
             try {
                 var commandProcess = child_process.spawn(command, args, { cwd: cwd, shell: true });
-                commandProcess.on('message', function (message) {
-                    console.info({ message: message });
-                });
+                if (isVerbose) {
+                    commandProcess.on('message', function (message) {
+                        console.info({ message: message });
+                    });
+                }
                 var output_1 = [];
                 commandProcess.stdout.on('data', function (stdout) {
                     output_1.push(stdout.toString());
-                    console.info(stdout.toString());
+                    if (isVerbose) {
+                        console.info(stdout.toString());
+                    }
                 });
                 commandProcess.stderr.on('data', function (stderr) {
                     output_1.push(stderr.toString());
-                    if (stderr.toString().trim()) {
+                    if (isVerbose && stderr.toString().trim()) {
                         console.warn(stderr.toString());
                     }
                 });
@@ -620,7 +639,9 @@
                                 "Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code)));
                         }
                         else {
-                            console.warn("Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code));
+                            if (isVerbose) {
+                                console.warn("Command \"".concat(humanReadableCommand, "\" exited with code ").concat(code));
+                            }
                             resolve(spaceTrim.spaceTrim(output_1.join('\n')));
                         }
                     }
@@ -639,7 +660,9 @@
                         reject(new Error("Command \"".concat(humanReadableCommand, "\" failed: \n").concat(error.message)));
                     }
                     else {
-                        console.warn(error);
+                        if (isVerbose) {
+                            console.warn(error);
+                        }
                         resolve(spaceTrim.spaceTrim(output_1.join('\n')));
                     }
                 });
@@ -1150,12 +1173,12 @@
      */
     function getScraperIntermediateSource(source, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var sourceFilename, url, rootDirname, cacheDirname, isCacheCleaned, extension, isVerbose, hash, semanticName, pieces, name, cacheFilename, isDestroyed, fileHandler;
+            var sourceFilename, url, rootDirname, cacheDirname, intermediateFilesStrategy, extension, isVerbose, hash, semanticName, pieces, name, cacheFilename, isDestroyed, fileHandler;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         sourceFilename = source.filename, url = source.url;
-                        rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, isCacheCleaned = options.isCacheCleaned, extension = options.extension, isVerbose = options.isVerbose;
+                        rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, intermediateFilesStrategy = options.intermediateFilesStrategy, extension = options.extension, isVerbose = options.isVerbose;
                         hash = cryptoJs.SHA256(
                         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
                         hexEncoder__default["default"].parse(sourceFilename || url || 'untitled'))
@@ -1165,7 +1188,7 @@
                         pieces = ['intermediate', semanticName, hash].filter(function (piece) { return piece !== ''; });
                         name = pieces.join('-').split('--').join('-');
                         // <- TODO: Use MAX_FILENAME_LENGTH
-                        TODO_USE(rootDirname); // <- TODO: !!!!!!
+                        TODO_USE(rootDirname); // <- TODO: [😡]
                         cacheFilename = path.join.apply(void 0, __spreadArray(__spreadArray([process.cwd(),
                             cacheDirname], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), [name], false)).split('\\')
                             .join('/') +
@@ -1185,7 +1208,7 @@
                                     return __generator(this, function (_a) {
                                         switch (_a.label) {
                                             case 0:
-                                                if (!isCacheCleaned) return [3 /*break*/, 2];
+                                                if (!(intermediateFilesStrategy === 'HIDE_AND_CLEAN')) return [3 /*break*/, 2];
                                                 if (isVerbose) {
                                                     console.info('legacyDocumentScraper: Clening cache');
                                                 }
@@ -1209,12 +1232,12 @@
     /**
      * 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
      */
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],templates:[{templateType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
     /**
      * Prettify the html code
@@ -1274,7 +1297,6 @@
             pipelineString += '\n\n';
             pipelineString += description;
         }
-        // TODO:> const commands: Array<Command>
         var commands = [];
         if (pipelineUrl) {
             commands.push("PIPELINE URL ".concat(pipelineUrl));
@@ -1330,7 +1352,6 @@
                     pipelineString += '\n\n';
                     pipelineString += description_1;
                 }
-                // TODO:> const commands: Array<Command>
                 var commands_1 = [];
                 var contentLanguage = 'text';
                 if (templateType === 'PROMPT_TEMPLATE') {
@@ -1860,7 +1881,7 @@
         }
     }
     /**
-     * TODO: !!!!! [🧞‍♀️] Do not allow joker + foreach
+     * TODO: !! [🧞‍♀️] Do not allow joker + foreach
      * TODO: [🧠] Work with promptbookVersion
      * TODO: Use here some json-schema, Zod or something similar and change it to:
      *     > /**
@@ -1872,7 +1893,7 @@
      *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
      */
     /**
-     * TODO: [🧳][main] !!!! Validate that all samples match expectations
+     * TODO: [🧳][main] !!!! Validate that all examples match expectations
      * TODO: [🧳][🐝][main] !!!! Validate that knowledge is valid (non-void)
      * TODO: [🧳][main] !!!! Validate that persona can be used only with CHAT variant
      * TODO: [🧳][main] !!!! Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
@@ -2215,6 +2236,7 @@
         }
     }
     /**
+     * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
      * TODO: [🧠] Can this return type be better typed than void
      */
 
@@ -2241,12 +2263,12 @@
         return true;
     }
     /**
-     * TODO: [🔃][main] !!!!! If the pipeline was prepared with different version or different set of models, prepare it once again
+     * TODO: [🔃][main] !! If the pipeline was prepared with different version or different set of models, prepare it once again
      * TODO: [🐠] Maybe base this on `makeValidator`
      * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
      * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
      *     - [🏍] ? Is context in each template
-     *     - [♨] Are samples prepared
+     *     - [♨] Are examples prepared
      *     - [♨] Are templates prepared
      */
 
@@ -2400,8 +2422,7 @@
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
      *
      * Note: Internal utility of `joinLlmExecutionTools` but exposed type
-     * @public exported from `@promptbook/types`
-     * TODO: !!!!!! Export as runtime class not just type
+     * @public exported from `@promptbook/core`
      */
     var MultipleLlmExecutionTools = /** @class */ (function () {
         /**
@@ -2903,7 +2924,7 @@
             return __generator(this, function (_d) {
                 switch (_d.label) {
                     case 0:
-                        _a = options.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
+                        _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
                         if (tools === undefined || tools.llm === undefined) {
                             throw new MissingToolsError('LLM tools are required for preparing persona');
                         }
@@ -2952,7 +2973,7 @@
         });
     }
     /**
-     * TODO: [🔃][main] !!!!! If the persona was prepared with different version or different set of models, prepare it once again
+     * TODO: [🔃][main] !! If the persona was prepared with different version or different set of models, prepare it once again
      * TODO: [🏢] !! Check validity of `modelName` in pipeline
      * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
      * TODO: [🏢] !! Check validity of `temperature` in pipeline
@@ -3069,7 +3090,7 @@
             this.storage = globalScope[storageName];
         }
         $Register.prototype.list = function () {
-            // <- TODO: ReadonlyDeep<Array<TRegistered>>
+            // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
             return this.storage;
         };
         $Register.prototype.register = function (registered) {
@@ -3121,7 +3142,6 @@
      * TODO: [®] DRY Register logic
      */
 
-    // TODO: !!!!!! Maybe delete this function
     /**
      * Creates a message with all registered scrapers
      *
@@ -3229,7 +3249,6 @@
      * @private within the repository
      */
     function sourceContentToName(sourceContent) {
-        // TODO: !!!!!! Better name for source than gibberish hash
         var hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(JSON.stringify(sourceContent)))
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
             .toString( /* hex */)
@@ -3257,20 +3276,20 @@
     /**
      * @@@
      *
-     * @private for scraper utilities
+     * @public exported from `@promptbook/core`
      */
     function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
             var sourceContent, name, _b, _c, rootDirname, _d, 
             // <- TODO: process.cwd() if running in Node.js
-            isVerbose, url, response_1, mimeType, filename_1, fileExtension, mimeType_1;
+            isVerbose, url, response_1, mimeType, filename_1, fileExtension, mimeType;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
                         sourceContent = knowledgeSource.sourceContent;
                         name = knowledgeSource.name;
-                        _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _d = _b.isVerbose, isVerbose = _d === void 0 ? IS_VERBOSE : _d;
+                        _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _d = _b.isVerbose, isVerbose = _d === void 0 ? DEFAULT_IS_VERBOSE : _d;
                         TODO_USE(isVerbose);
                         if (!name) {
                             name = sourceContentToName(sourceContent);
@@ -3286,19 +3305,14 @@
                                 filename: null,
                                 url: url,
                                 mimeType: mimeType,
-                                asBlob: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, response_1.blob()];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, content];
-                                            }
-                                        });
-                                    });
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > async asBlob() {
+                                    >     // TODO: [👨🏻‍🤝‍👨🏻] This can be called multiple times BUT when called second time, response in already consumed
+                                    >     const content = await response.blob();
+                                    >     return content;
+                                    > },
+                                */
                                 asJson: function () {
                                     return __awaiter(this, void 0, void 0, function () {
                                         var content;
@@ -3338,34 +3352,31 @@
                         }
                         filename_1 = path.join(rootDirname, sourceContent).split('\\').join('/');
                         fileExtension = getFileExtension(filename_1);
-                        mimeType_1 = extensionToMimeType(fileExtension || '');
+                        mimeType = extensionToMimeType(fileExtension || '');
                         return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
                     case 3:
                         if (!(_e.sent())) {
                             throw new NotFoundError(spaceTrim__default["default"](function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(filename_1), "\n                      "); }));
                         }
-                        // TODO: !!!!!! Test security file - file is scoped to the project (maybe do this in `filesystemTools`)
+                        // TODO: [🧠][😿] Test security file - file is scoped to the project (BUT maybe do this in `filesystemTools`)
                         return [2 /*return*/, {
                                 source: name,
                                 filename: filename_1,
                                 url: null,
-                                mimeType: mimeType_1,
-                                asBlob: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, tools.fs.readFile(filename_1)];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, new Blob([
-                                                            content,
-                                                            // <- TODO: !!!!!! Maybe not working
-                                                        ], { type: mimeType_1 })];
-                                            }
-                                        });
-                                    });
-                                },
+                                mimeType: mimeType,
+                                /*
+                                TODO: [🥽]
+                                    > async asBlob() {
+                                    >     const content = await tools.fs!.readFile(filename);
+                                    >     return new Blob(
+                                    >         [
+                                    >             content,
+                                    >             // <- TODO: [🥽] This is NOT tested, test it
+                                    >         ],
+                                    >         { type: mimeType },
+                                    >     );
+                                    > },
+                                */
                                 asJson: function () {
                                     return __awaiter(this, void 0, void 0, function () {
                                         var _a, _b;
@@ -3401,9 +3412,14 @@
                             asJson: function () {
                                 throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
                             },
-                            asBlob: function () {
-                                throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asBlob`');
-                            },
+                            /*
+                            TODO: [🥽]
+                                > asBlob() {
+                                >     throw new UnexpectedError(
+                                >         'Did not expect that `markdownScraper` would need to get the content `asBlob`',
+                                >     );
+                                > },
+                            */
                         }];
                 }
             });
@@ -3423,7 +3439,7 @@
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a, rootDirname = options.rootDirname, _b = options.isVerbose, isVerbose = _b === void 0 ? IS_VERBOSE : _b;
+                        _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a, rootDirname = options.rootDirname, _b = options.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
                         knowledgePreparedUnflatten = new Array(knowledgeSources.length);
                         return [4 /*yield*/, forEachAsync(knowledgeSources, { maxParallelCount: maxParallelCount }, function (knowledgeSource, index) { return __awaiter(_this, void 0, void 0, function () {
                                 var partialPieces, sourceHandler, _a, _b, scraper, partialPiecesUnchecked, e_1_1, pieces;
@@ -3452,7 +3468,8 @@
                                         case 4:
                                             partialPiecesUnchecked = _d.sent();
                                             if (partialPiecesUnchecked !== null) {
-                                                partialPieces = partialPiecesUnchecked;
+                                                partialPieces = __spreadArray([], __read(partialPiecesUnchecked), false);
+                                                // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                                                 return [3 /*break*/, 6];
                                             }
                                             _d.label = 5;
@@ -3500,7 +3517,7 @@
     >   /**
     >    * Unprepared knowledge
     >    * /
-    >   readonly knowledgeSources: Array<KnowledgeSourceJson>;
+    >   readonly knowledgeSources: ReadonlyArray<KnowledgeSourceJson>;
     > };
     >
     > export async function prepareKnowledgePieces(
@@ -3558,9 +3575,9 @@
             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: [main] !! Apply examples to each template (if missing and is for the template defined)
                         TODO_USE(parameters);
                         templatesPrepared = new Array(templates.length);
                         return [4 /*yield*/, forEachAsync(templates, { maxParallelCount: maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, function (template, index) { return __awaiter(_this, void 0, void 0, function () {
@@ -3590,7 +3607,7 @@
     /**
      * TODO: [🧠] Add context to each template (if missing)
      * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
-     * TODO: [♨][main] !!! Prepare index the samples and maybe templates
+     * TODO: [♨][main] !!! Prepare index the examples and maybe templates
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
      * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
@@ -3620,7 +3637,7 @@
                         if (isPipelinePrepared(pipeline)) {
                             return [2 /*return*/, pipeline];
                         }
-                        rootDirname = options.rootDirname, _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? MAX_PARALLEL_COUNT : _a, _b = options.isVerbose, isVerbose = _b === void 0 ? IS_VERBOSE : _b;
+                        rootDirname = options.rootDirname, _a = options.maxParallelCount, maxParallelCount = _a === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _a, _b = options.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
                         parameters = pipeline.parameters, templates = pipeline.templates, knowledgeSources = pipeline.knowledgeSources, personas = pipeline.personas;
                         if (tools === undefined || tools.llm === undefined) {
                             throw new MissingToolsError('LLM tools are required for preparing the pipeline');
@@ -3678,7 +3695,9 @@
                         // ----- /Templates preparation -----
                         // Note: Count total usage
                         currentPreparation.usage = llmToolsWithUsage.getTotalUsage();
-                        return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { templates: templatesPrepared, knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: preparations }))];
+                        return [2 /*return*/, $asDeeplyFrozenSerializableJson('Prepared PipelineJson', __assign(__assign({}, clonePipeline(pipeline)), { templates: __spreadArray([], __read(templatesPrepared), false), 
+                                // <- TODO: [🪓] Here should be no need for spreading new array, just ` templates: templatesPrepared`
+                                knowledgeSources: knowledgeSourcesPrepared, knowledgePieces: knowledgePiecesPrepared, personas: preparedPersonas, preparations: __spreadArray([], __read(preparations), false) }))];
                 }
             });
         });
@@ -4649,12 +4668,11 @@
      */
     function executeAttempts(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var jokerParameterNames, priority, maxAttempts, preparedContent, parameters, template, preparedPipeline, tools, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, $ongoingTemplateResult, _llms, llmTools, _loop_1, attempt, state_1;
+            var jokerParameterNames, priority, maxAttempts, preparedContent, parameters, template, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, $ongoingTemplateResult, _llms, llmTools, _loop_1, attempt, state_1;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        jokerParameterNames = options.jokerParameterNames, priority = options.priority, maxAttempts = options.maxAttempts, preparedContent = options.preparedContent, parameters = options.parameters, template = options.template, preparedPipeline = options.preparedPipeline, tools = options.tools, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
-                        maxExecutionAttempts = settings.maxExecutionAttempts;
+                        jokerParameterNames = options.jokerParameterNames, priority = options.priority, maxAttempts = options.maxAttempts, preparedContent = options.preparedContent, parameters = options.parameters, template = options.template, preparedPipeline = options.preparedPipeline, tools = options.tools, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, maxExecutionAttempts = options.maxExecutionAttempts;
                         $ongoingTemplateResult = {
                             $result: null,
                             $resultString: null,
@@ -5020,12 +5038,12 @@
      */
     function executeFormatSubvalues(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var template, jokerParameterNames, parameters, priority, pipelineIdentification, settings, parameterValue, formatDefinition, subvalueDefinition, formatSettings, resultString;
+            var template, jokerParameterNames, parameters, priority, csvSettings, pipelineIdentification, parameterValue, formatDefinition, subvalueDefinition, formatSettings, resultString;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        template = options.template, jokerParameterNames = options.jokerParameterNames, parameters = options.parameters, priority = options.priority, pipelineIdentification = options.pipelineIdentification, settings = options.settings;
+                        template = options.template, jokerParameterNames = options.jokerParameterNames, parameters = options.parameters, priority = options.priority, csvSettings = options.csvSettings, pipelineIdentification = options.pipelineIdentification;
                         if (template.foreach === undefined) {
                             return [2 /*return*/, /* not await */ executeAttempts(options)];
                         }
@@ -5055,7 +5073,7 @@
                                 .join('\n')), "\n\n                    [\u26F7] This should never happen because subformat name should be validated during parsing\n\n                    ").concat(block(pipelineIdentification), "\n                "); }));
                         }
                         if (formatDefinition.formatName === 'CSV') {
-                            formatSettings = settings.csvSettings;
+                            formatSettings = csvSettings;
                             // <- TODO: [🤹‍♂️] More universal, make simmilar pattern for other formats for example \n vs \r\n in text
                         }
                         return [4 /*yield*/, subvalueDefinition.mapValues(parameterValue, template.foreach.outputSubparameterName, formatSettings, function (subparameters, index) { return __awaiter(_this, void 0, void 0, function () {
@@ -5119,7 +5137,7 @@
             var preparedPipeline, template;
             return __generator(this, function (_a) {
                 preparedPipeline = options.preparedPipeline, template = options.template;
-                // TODO: [♨] Implement Better - use real index and keyword search from `template` and {samples}
+                // TODO: [♨] Implement Better - use real index and keyword search from `template` and {examples}
                 TODO_USE(template);
                 return [2 /*return*/, preparedPipeline.knowledgePieces.map(function (_a) {
                         var content = _a.content;
@@ -5134,7 +5152,7 @@
      *
      * @private internal utility of `createPipelineExecutor`
      */
-    function getSamplesForTemplate(template) {
+    function getExamplesForTemplate(template) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 // TODO: [♨] Implement Better - use real index and keyword search
@@ -5151,7 +5169,7 @@
      */
     function getReservedParametersForTemplate(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var preparedPipeline, template, pipelineIdentification, context, knowledge, samples, currentDate, modelName, reservedParameters, _loop_1, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
+            var preparedPipeline, template, pipelineIdentification, context, knowledge, examples, currentDate, modelName, reservedParameters, _loop_1, RESERVED_PARAMETER_NAMES_1, RESERVED_PARAMETER_NAMES_1_1, parameterName;
             var e_1, _a;
             return __generator(this, function (_b) {
                 switch (_b.label) {
@@ -5163,16 +5181,16 @@
                         return [4 /*yield*/, getKnowledgeForTemplate({ preparedPipeline: preparedPipeline, template: template })];
                     case 2:
                         knowledge = _b.sent();
-                        return [4 /*yield*/, getSamplesForTemplate(template)];
+                        return [4 /*yield*/, getExamplesForTemplate(template)];
                     case 3:
-                        samples = _b.sent();
+                        examples = _b.sent();
                         currentDate = new Date().toISOString();
                         modelName = RESERVED_PARAMETER_MISSING_VALUE;
                         reservedParameters = {
                             content: RESERVED_PARAMETER_RESTRICTED,
                             context: context,
                             knowledge: knowledge,
-                            samples: samples,
+                            examples: examples,
                             currentDate: currentDate,
                             modelName: modelName,
                         };
@@ -5208,13 +5226,12 @@
      */
     function executeTemplate(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var currentTemplate, preparedPipeline, parametersToPass, tools, onProgress, settings, $executionReport, pipelineIdentification, maxExecutionAttempts, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
-            var e_1, _f, _g;
-            return __generator(this, function (_h) {
-                switch (_h.label) {
+            var currentTemplate, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, _a, maxExecutionAttempts, name, title, priority, usedParameterNames, dependentParameterNames, definedParameters, _b, _c, _d, definedParameterNames, parameters, _loop_1, _e, _f, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
+            var e_1, _g, _h;
+            return __generator(this, function (_j) {
+                switch (_j.label) {
                     case 0:
-                        currentTemplate = options.currentTemplate, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, settings = options.settings, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification;
-                        maxExecutionAttempts = settings.maxExecutionAttempts;
+                        currentTemplate = options.currentTemplate, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, _a = options.maxExecutionAttempts, maxExecutionAttempts = _a === void 0 ? DEFAULT_MAX_EXECUTION_ATTEMPTS : _a;
                         name = "pipeline-executor-frame-".concat(currentTemplate.name);
                         title = currentTemplate.title;
                         priority = preparedPipeline.templates.length - preparedPipeline.templates.indexOf(currentTemplate);
@@ -5229,7 +5246,7 @@
                                 // <- [🍸]
                             })];
                     case 1:
-                        _h.sent();
+                        _j.sent();
                         usedParameterNames = extractParameterNamesFromTemplate(currentTemplate);
                         dependentParameterNames = new Set(currentTemplate.dependentParameterNames);
                         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -5240,15 +5257,15 @@
                                 .map(function (name) { return "{".concat(name, "}"); })
                                 .join(', '), "\n\n                    ").concat(block(pipelineIdentification), "\n\n                "); }));
                         }
-                        _b = (_a = Object).freeze;
-                        _c = [{}];
+                        _c = (_b = Object).freeze;
+                        _d = [{}];
                         return [4 /*yield*/, getReservedParametersForTemplate({
                                 preparedPipeline: preparedPipeline,
                                 template: currentTemplate,
                                 pipelineIdentification: pipelineIdentification,
                             })];
                     case 2:
-                        definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
+                        definedParameters = _c.apply(_b, [__assign.apply(void 0, [__assign.apply(void 0, _d.concat([(_j.sent())])), parametersToPass])]);
                         definedParameterNames = new Set(Object.keys(definedParameters));
                         parameters = {};
                         _loop_1 = function (parameterName) {
@@ -5268,15 +5285,15 @@
                         try {
                             // Note: [2] Check that all used parameters are defined and removing unused parameters for this template
                             // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
-                            for (_d = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _e = _d.next(); !_e.done; _e = _d.next()) {
-                                parameterName = _e.value;
+                            for (_e = __values(Array.from(union(definedParameterNames, usedParameterNames, dependentParameterNames))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                                parameterName = _f.value;
                                 _loop_1(parameterName);
                             }
                         }
                         catch (e_1_1) { e_1 = { error: e_1_1 }; }
                         finally {
                             try {
-                                if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                                if (_f && !_f.done && (_g = _e.return)) _g.call(_e);
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
@@ -5296,12 +5313,11 @@
                                 template: currentTemplate,
                                 preparedPipeline: preparedPipeline,
                                 tools: tools,
-                                settings: settings,
                                 $executionReport: $executionReport,
                                 pipelineIdentification: pipelineIdentification,
                             })];
                     case 3:
-                        resultString = _h.sent();
+                        resultString = _j.sent();
                         return [4 /*yield*/, onProgress({
                                 name: name,
                                 title: title,
@@ -5313,12 +5329,12 @@
                                 // <- [🍸]
                             })];
                     case 4:
-                        _h.sent();
-                        return [2 /*return*/, Object.freeze((_g = {},
-                                _g[currentTemplate.resultingParameterName] = 
+                        _j.sent();
+                        return [2 /*return*/, Object.freeze((_h = {},
+                                _h[currentTemplate.resultingParameterName] = 
                                 // <- Note: [👩‍👩‍👧] No need to detect parameter collision here because pipeline checks logic consistency during construction
                                 resultString,
-                                _g))];
+                                _h))];
                 }
             });
         });
@@ -5377,13 +5393,12 @@
      */
     function executePipeline(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, settings, maxParallelCount, rootDirname, _a, isVerbose, preparedPipeline, errors, warnings, executionReport, isReturned, _b, _c, parameter, e_1_1, _loop_1, _d, _e, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
+            var inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, _a, isVerbose, preparedPipeline, errors, warnings, executionReport, isReturned, _b, _c, parameter, e_1_1, _loop_1, _d, _e, parameterName, state_1, e_2_1, parametersToPass, resovedParameterNames_1, unresovedTemplates_1, resolving_1, loopLimit, _loop_2, error_1, usage_1, outputParameters_1, usage, outputParameters;
             var e_1, _f, e_2, _g;
             return __generator(this, function (_h) {
                 switch (_h.label) {
                     case 0:
-                        inputParameters = options.inputParameters, tools = options.tools, onProgress = options.onProgress, pipeline = options.pipeline, setPreparedPipeline = options.setPreparedPipeline, pipelineIdentification = options.pipelineIdentification, settings = options.settings;
-                        maxParallelCount = settings.maxParallelCount, rootDirname = settings.rootDirname, _a = settings.isVerbose, isVerbose = _a === void 0 ? IS_VERBOSE : _a;
+                        inputParameters = options.inputParameters, tools = options.tools, onProgress = options.onProgress, pipeline = options.pipeline, setPreparedPipeline = options.setPreparedPipeline, pipelineIdentification = options.pipelineIdentification, maxParallelCount = options.maxParallelCount, rootDirname = options.rootDirname, _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
                         preparedPipeline = options.preparedPipeline;
                         if (!(preparedPipeline === undefined)) return [3 /*break*/, 2];
                         return [4 /*yield*/, preparePipeline(pipeline, tools, {
@@ -5568,12 +5583,7 @@
                                         return [3 /*break*/, 4];
                                     case 3:
                                         unresovedTemplates_1 = unresovedTemplates_1.filter(function (template) { return template !== currentTemplate; });
-                                        work_1 = executeTemplate({
-                                            currentTemplate: currentTemplate,
-                                            preparedPipeline: preparedPipeline,
-                                            parametersToPass: parametersToPass,
-                                            tools: tools,
-                                            onProgress: function (progress) {
+                                        work_1 = executeTemplate(__assign(__assign({}, options), { currentTemplate: currentTemplate, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (progress) {
                                                 if (isReturned) {
                                                     throw new UnexpectedError(spaceTrim.spaceTrim(function (block) { return "\n                                        Can not call `onProgress` after pipeline execution is finished\n\n                                        ".concat(block(pipelineIdentification), "\n\n                                        ").concat(block(JSON.stringify(progress, null, 4)
                                                         .split('\n')
@@ -5583,11 +5593,7 @@
                                                 if (onProgress) {
                                                     onProgress(progress);
                                                 }
-                                            },
-                                            settings: settings,
-                                            $executionReport: executionReport,
-                                            pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Template name: ").concat(currentTemplate.name, "\n                            Template title: ").concat(currentTemplate.title, "\n                        "); }),
-                                        })
+                                            }, $executionReport: executionReport, pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Template name: ").concat(currentTemplate.name, "\n                            Template title: ").concat(currentTemplate.title, "\n                        "); }) }))
                                             .then(function (newParametersToPass) {
                                             parametersToPass = __assign(__assign({}, newParametersToPass), parametersToPass);
                                             resovedParameterNames_1 = __spreadArray(__spreadArray([], __read(resovedParameterNames_1), false), [currentTemplate.resultingParameterName], false);
@@ -5691,8 +5697,7 @@
      */
     function createPipelineExecutor(options) {
         var _this = this;
-        var pipeline = options.pipeline, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
-        var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? MAX_EXECUTION_ATTEMPTS : _b, _c = settings.maxParallelCount, maxParallelCount = _c === void 0 ? MAX_PARALLEL_COUNT : _c, _d = settings.csvSettings, csvSettings = _d === void 0 ? DEFAULT_CSV_SETTINGS : _d, _e = settings.isVerbose, isVerbose = _e === void 0 ? IS_VERBOSE : _e, _f = settings.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _f === void 0 ? false : _f, _g = settings.rootDirname, rootDirname = _g === void 0 ? null : _g;
+        var pipeline = options.pipeline, tools = options.tools, _a = options.maxExecutionAttempts, maxExecutionAttempts = _a === void 0 ? DEFAULT_MAX_EXECUTION_ATTEMPTS : _a, _b = options.maxParallelCount, maxParallelCount = _b === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _b, _c = options.csvSettings, csvSettings = _c === void 0 ? DEFAULT_CSV_SETTINGS : _c, _d = options.isVerbose, isVerbose = _d === void 0 ? DEFAULT_IS_VERBOSE : _d, _e = options.isNotPreparedWarningSupressed, isNotPreparedWarningSupressed = _e === void 0 ? false : _e, _f = options.rootDirname, rootDirname = _f === void 0 ? null : _f;
         validatePipeline(pipeline);
         var pipelineIdentification = (function () {
             // Note: This is a 😐 implementation of [🚞]
@@ -5726,14 +5731,12 @@
                         tools: tools,
                         onProgress: onProgress,
                         pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(pipelineIdentification), "\n                    ").concat(runCount === 1 ? '' : "Run #".concat(runCount), "\n                "); }),
-                        settings: {
-                            maxExecutionAttempts: maxExecutionAttempts,
-                            maxParallelCount: maxParallelCount,
-                            csvSettings: csvSettings,
-                            isVerbose: isVerbose,
-                            isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
-                            rootDirname: rootDirname,
-                        },
+                        maxExecutionAttempts: maxExecutionAttempts,
+                        maxParallelCount: maxParallelCount,
+                        csvSettings: csvSettings,
+                        isVerbose: isVerbose,
+                        isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
+                        rootDirname: rootDirname,
                     })];
             });
         }); };
@@ -5755,7 +5758,7 @@
         mimeTypes: ['text/markdown', 'text/plain'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: true,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -5799,7 +5802,7 @@
                 return __generator(this, function (_k) {
                     switch (_k.label) {
                         case 0:
-                            _a = this.options, _b = _a.maxParallelCount, maxParallelCount = _b === void 0 ? MAX_PARALLEL_COUNT : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? IS_VERBOSE : _c;
+                            _a = this.options, _b = _a.maxParallelCount, maxParallelCount = _b === void 0 ? DEFAULT_MAX_PARALLEL_COUNT : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? DEFAULT_IS_VERBOSE : _c;
                             llm = this.tools.llm;
                             if (llm === undefined) {
                                 throw new MissingToolsError('LLM tools are required for scraping external files');
@@ -5846,7 +5849,7 @@
                             outputParameters = result.outputParameters;
                             knowledgePiecesRaw = outputParameters.knowledgePieces;
                             knowledgeTextPieces = (knowledgePiecesRaw || '').split('\n---\n');
-                            //                                                               <- TODO: [main] !!!!! Smarter split and filter out empty pieces
+                            //                                                               <- TODO: [main] !! Smarter split and filter out empty pieces
                             if (isVerbose) {
                                 console.info('knowledgeTextPieces:', knowledgeTextPieces);
                             }
@@ -5898,7 +5901,8 @@
                                                 embeddingResult = _c.sent();
                                                 index.push({
                                                     modelName: embeddingResult.modelName,
-                                                    position: embeddingResult.content,
+                                                    position: __spreadArray([], __read(embeddingResult.content), false),
+                                                    // <- TODO: [🪓] Here should be no need for spreading new array, just `position: embeddingResult.content`
                                                 });
                                                 _c.label = 6;
                                             case 6: return [3 /*break*/, 8];
@@ -5949,7 +5953,7 @@
         mimeTypes: ['application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: ['Pandoc'],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -5989,12 +5993,13 @@
          * Note: `$` is used to indicate that this function is not a pure function - it leaves files on the disk and you are responsible for cleaning them by calling `destroy` method of returned object
          */
         DocumentScraper.prototype.$convert = function (source) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
-                var _a, _b, externalProgramsPaths, _c, rootDirname, _d, cacheDirname, _e, isCacheCleaned, _f, isVerbose, extension, cacheFilehandler, command_1;
+                var _b, _c, rootDirname, _d, cacheDirname, _e, intermediateFilesStrategy, _f, isVerbose, extension, cacheFilehandler, command_1;
                 return __generator(this, function (_g) {
                     switch (_g.label) {
                         case 0:
-                            _a = this.options, _b = _a.externalProgramsPaths, externalProgramsPaths = _b === void 0 ? {} : _b, _c = _a.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _a.cacheDirname, cacheDirname = _d === void 0 ? SCRAPE_CACHE_DIRNAME : _d, _e = _a.isCacheCleaned, isCacheCleaned = _e === void 0 ? false : _e, _f = _a.isVerbose, isVerbose = _f === void 0 ? IS_VERBOSE : _f;
+                            _b = this.options, _c = _b.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _b.cacheDirname, cacheDirname = _d === void 0 ? DEFAULT_SCRAPE_CACHE_DIRNAME : _d, _e = _b.intermediateFilesStrategy, intermediateFilesStrategy = _e === void 0 ? DEFAULT_INTERMEDIATE_FILES_STRATEGY : _e, _f = _b.isVerbose, isVerbose = _f === void 0 ? DEFAULT_IS_VERBOSE : _f;
                             if (!$isRunningInNode()) {
                                 throw new KnowledgeScrapeError('Scraping .docx files is only supported in Node environment');
                             }
@@ -6002,7 +6007,7 @@
                                 throw new EnvironmentMismatchError('Can not scrape documents without filesystem tools');
                                 //          <- TODO: [🧠] What is the best error type here`
                             }
-                            if (externalProgramsPaths.pandocPath === undefined) {
+                            if (((_a = this.tools.executables) === null || _a === void 0 ? void 0 : _a.pandocPath) === undefined) {
                                 throw new MissingToolsError('Pandoc is required for scraping .docx files');
                             }
                             if (source.filename === null) {
@@ -6013,7 +6018,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'md',
                                     isVerbose: isVerbose,
                                 })];
@@ -6022,11 +6027,9 @@
                             return [4 /*yield*/, isFileExisting(cacheFilehandler.filename, this.tools.fs)];
                         case 2:
                             if (!!(_g.sent())) return [3 /*break*/, 5];
-                            command_1 = "\"".concat(externalProgramsPaths.pandocPath, "\" -f ").concat(extension, " -t markdown \"").concat(source.filename, "\" -o \"").concat(cacheFilehandler.filename, "\"");
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook
+                            command_1 = "\"".concat(this.tools.executables.pandocPath, "\" -f ").concat(extension, " -t markdown \"").concat(source.filename, "\" -o \"").concat(cacheFilehandler.filename, "\"");
                             return [4 /*yield*/, $execCommand(command_1)];
                         case 3:
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook
                             _g.sent();
                             return [4 /*yield*/, isFileExisting(cacheFilehandler.filename, this.tools.fs)];
                         case 4:
@@ -6071,9 +6074,14 @@
                                 asJson: function () {
                                     throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asJson`');
                                 },
-                                asBlob: function () {
-                                    throw new UnexpectedError('Did not expect that `markdownScraper` would need to get the content `asBlob`');
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > asBlob() {
+                                    >     throw new UnexpectedError(
+                                    >         'Did not expect that `markdownScraper` would need to get the content `asBlob`',
+                                    >     );
+                                    > },
+                                */
                             };
                             knowledge = this.markdownScraper.scrape(markdownSource);
                             return [4 /*yield*/, cacheFilehandler.destroy()];
@@ -6105,7 +6113,11 @@
         mimeTypes: ['application/msword', 'text/rtf'],
         documentationUrl: 'https://github.com/webgptorg/promptbook/discussions/@@',
         isAvilableInBrowser: false,
-        requiredExecutables: ['!!!!!!'],
+        requiredExecutables: [
+            'Pandoc',
+            'LibreOffice',
+            //    <- TODO: [🧠] Should be 'LibreOffice' here, its dependency of dependency
+        ],
     }); /* <- TODO: [🤛] */
     /**
      * Registration of known scraper metadata
@@ -6118,7 +6130,7 @@
     $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`
@@ -6145,12 +6157,13 @@
          * Note: `$` is used to indicate that this function is not a pure function - it leaves files on the disk and you are responsible for cleaning them by calling `destroy` method of returned object
          */
         LegacyDocumentScraper.prototype.$convert = function (source) {
+            var _a;
             return __awaiter(this, void 0, void 0, function () {
-                var _a, _b, externalProgramsPaths, _c, rootDirname, _d, cacheDirname, _e, isCacheCleaned, _f, isVerbose, extension, cacheFilehandler, documentSourceOutdirPathForLibreOffice_1, command_1, files_1, file;
+                var _b, _c, rootDirname, _d, cacheDirname, _e, intermediateFilesStrategy, _f, isVerbose, extension, cacheFilehandler, documentSourceOutdirPathForLibreOffice_1, command_1, files_1, file;
                 return __generator(this, function (_g) {
                     switch (_g.label) {
                         case 0:
-                            _a = this.options, _b = _a.externalProgramsPaths, externalProgramsPaths = _b === void 0 ? {} : _b, _c = _a.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _a.cacheDirname, cacheDirname = _d === void 0 ? SCRAPE_CACHE_DIRNAME : _d, _e = _a.isCacheCleaned, isCacheCleaned = _e === void 0 ? false : _e, _f = _a.isVerbose, isVerbose = _f === void 0 ? IS_VERBOSE : _f;
+                            _b = this.options, _c = _b.rootDirname, rootDirname = _c === void 0 ? process.cwd() : _c, _d = _b.cacheDirname, cacheDirname = _d === void 0 ? DEFAULT_SCRAPE_CACHE_DIRNAME : _d, _e = _b.intermediateFilesStrategy, intermediateFilesStrategy = _e === void 0 ? DEFAULT_INTERMEDIATE_FILES_STRATEGY : _e, _f = _b.isVerbose, isVerbose = _f === void 0 ? DEFAULT_IS_VERBOSE : _f;
                             if (!$isRunningInNode()) {
                                 throw new KnowledgeScrapeError('Scraping .doc files is only supported in Node environment');
                             }
@@ -6158,7 +6171,7 @@
                                 throw new EnvironmentMismatchError('Can not scrape (legacy) documents without filesystem tools');
                                 //          <- TODO: [🧠] What is the best error type here`
                             }
-                            if (externalProgramsPaths.libreOfficePath === undefined) {
+                            if (((_a = this.tools.executables) === null || _a === void 0 ? void 0 : _a.libreOfficePath) === undefined) {
                                 throw new MissingToolsError('LibreOffice is required for scraping .doc and .rtf files');
                             }
                             if (source.filename === null) {
@@ -6169,7 +6182,7 @@
                             return [4 /*yield*/, getScraperIntermediateSource(source, {
                                     rootDirname: rootDirname,
                                     cacheDirname: cacheDirname,
-                                    isCacheCleaned: isCacheCleaned,
+                                    intermediateFilesStrategy: intermediateFilesStrategy,
                                     extension: 'docx',
                                     isVerbose: isVerbose,
                                 })];
@@ -6184,11 +6197,9 @@
                             documentSourceOutdirPathForLibreOffice_1 = path.join(path.dirname(cacheFilehandler.filename), 'libreoffice')
                                 .split('\\')
                                 .join('/');
-                            command_1 = "\"".concat(externalProgramsPaths.libreOfficePath, "\" --headless --convert-to docx \"").concat(source.filename, "\"  --outdir \"").concat(documentSourceOutdirPathForLibreOffice_1, "\"");
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook - this should trigger build polution error
+                            command_1 = "\"".concat(this.tools.executables.libreOfficePath, "\" --headless --convert-to docx \"").concat(source.filename, "\"  --outdir \"").concat(documentSourceOutdirPathForLibreOffice_1, "\"");
                             return [4 /*yield*/, $execCommand(command_1)];
                         case 3:
-                            // TODO: !!!!!! [🕊] Make execCommand standard (?node-)util of the promptbook - this should trigger build polution error
                             _g.sent();
                             return [4 /*yield*/, promises.readdir(documentSourceOutdirPathForLibreOffice_1)];
                         case 4:
@@ -6236,9 +6247,14 @@
                                 asJson: function () {
                                     throw new UnexpectedError('Did not expect that `documentScraper` would need to get the content `asJson`');
                                 },
-                                asBlob: function () {
-                                    throw new UnexpectedError('Did not expect that `documentScraper` would need to get the content `asBlob`');
-                                },
+                                /*
+                                TODO: [🥽]
+                                    > asBlob() {
+                                    >     throw new UnexpectedError(
+                                    >         'Did not expect that `documentScraper` would need to get the content `asBlob`',
+                                    >     );
+                                    > },
+                                */
                             };
                             knowledge = this.documentScraper.scrape(markdownSource);
                             return [4 /*yield*/, cacheFilehandler.destroy()];