@promptbook/cli 0.85.0-4 → 0.85.0-5

package/esm/typings/src/execution/FilesystemTools.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import type fs from 'node:fs/promises';
+import type fs from 'fs/promises';
 /**
  * Container for all the tools needed to manipulate with filesystem
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.85.0-4",
+    "version": "0.85.0-5",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('waitasecond'), require('node:path'), require('node:fs/promises'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('dotenv'), require('node:child_process'), require('prettier'), require('prettier/parser-html'), require('rxjs'), require('crypto'), require('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('prompts'), require('moment'), require('express'), require('node:http'), require('socket.io'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'waitasecond', 'node:path', 'node:fs/promises', 'crypto-js/enc-hex', 'crypto-js/sha256', 'dotenv', 'node:child_process', 'prettier', 'prettier/parser-html', 'rxjs', 'crypto', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'prompts', 'moment', 'express', 'node:http', 'socket.io', 'socket.io-client', '@anthropic-ai/sdk', '@azure/openai', 'openai', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global.spaceTrim, global.waitasecond, global.node_path, global.promises, global.hexEncoder, global.sha256, global.dotenv, global.node_child_process, global.prettier, global.parserHtml, global.rxjs, global.crypto, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.prompts, global.moment, global.express, global.http, global.socket_io, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
-})(this, (function (exports, colors, commander, spaceTrim, waitasecond, node_path, promises, hexEncoder, sha256, dotenv, node_child_process, prettier, parserHtml, rxjs, crypto, papaparse, cryptoJs, mimeTypes, glob, prompts, moment, express, http, socket_io, socket_ioClient, Anthropic, openai, OpenAI, readability, jsdom, showdown) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('waitasecond'), require('path'), require('fs/promises'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('dotenv'), require('child_process'), require('prettier'), require('prettier/parser-html'), require('rxjs'), require('crypto'), require('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('prompts'), require('moment'), require('express'), require('http'), require('socket.io'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'waitasecond', 'path', 'fs/promises', 'crypto-js/enc-hex', 'crypto-js/sha256', 'dotenv', 'child_process', 'prettier', 'prettier/parser-html', 'rxjs', 'crypto', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'prompts', 'moment', 'express', 'http', 'socket.io', 'socket.io-client', '@anthropic-ai/sdk', '@azure/openai', 'openai', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global.spaceTrim, global.waitasecond, global.path, global.promises, global.hexEncoder, global.sha256, global.dotenv, global.child_process, global.prettier, global.parserHtml, global.rxjs, global.crypto, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.prompts, global.moment, global.express, global.http, global.socket_io, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
+})(this, (function (exports, colors, commander, spaceTrim, waitasecond, path, promises, hexEncoder, sha256, dotenv, child_process, prettier, parserHtml, rxjs, crypto, papaparse, cryptoJs, mimeTypes, glob, prompts, moment, express, http, socket_io, socket_ioClient, Anthropic, openai, OpenAI, readability, jsdom, showdown) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -53,7 +53,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.85.0-3';
+    var PROMPTBOOK_ENGINE_VERSION = '0.85.0-4';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1477,7 +1477,7 @@
             value = value.replace(/\.html$/, '');
         }
         else if (isValidFilePath(value)) {
-            value = node_path.basename(value);
+            value = path.basename(value);
             // Note: Keeping extension in the name
         }
         value = value.split('/').join('-');
@@ -1517,7 +1517,7 @@
             var name = titleToName(key);
             var hash = sha256__default["default"](hexEncoder__default["default"].parse(name)).toString( /* hex */);
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
-            return node_path.join.apply(void 0, __spreadArray(__spreadArray([this.options.rootFolderPath], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(name.substring(0, MAX_FILENAME_LENGTH), ".json")], false));
+            return path.join.apply(void 0, __spreadArray(__spreadArray([this.options.rootFolderPath], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(name.substring(0, MAX_FILENAME_LENGTH), ".json")], false));
         };
         /**
          * @@@ Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
@@ -1558,7 +1558,7 @@
                                 throw new UnexpectedError("The \"".concat(key, "\" you want to store in JSON file is not serializable as JSON"));
                             }
                             fileContent = stringifyPipelineJson(value);
-                            return [4 /*yield*/, promises.mkdir(node_path.dirname(filename), { recursive: true })];
+                            return [4 /*yield*/, promises.mkdir(path.dirname(filename), { recursive: true })];
                         case 1:
                             _a.sent(); // <- [0]
                             return [4 /*yield*/, promises.writeFile(filename, fileContent, 'utf-8')];
@@ -2416,7 +2416,7 @@
                     case 3:
                         if (!!envFilePatterns_1_1.done) return [3 /*break*/, 6];
                         pattern = envFilePatterns_1_1.value;
-                        envFilename = node_path.join(rootDirname, pattern);
+                        envFilename = path.join(rootDirname, pattern);
                         return [4 /*yield*/, isFileExisting(envFilename, $provideFilesystemForNode())];
                     case 4:
                         if (_b.sent()) {
@@ -2444,7 +2444,7 @@
                             return [3 /*break*/, 11];
                         }
                         // Note: If the directory does not exist, try the parent directory
-                        rootDirname = node_path.join(rootDirname, '..');
+                        rootDirname = path.join(rootDirname, '..');
                         _b.label = 10;
                     case 10:
                         i++;
@@ -2874,7 +2874,7 @@
                                 _c.sent()]),
                             {
                                 storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
-                                    rootFolderPath: node_path.join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
+                                    rootFolderPath: path.join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
                                 }),
                                 isCacheReloaded: isCacheReloaded,
                             }])];
@@ -3051,7 +3051,7 @@
                 console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
             }
             try {
-                var commandProcess = node_child_process.spawn(command, args, { cwd: cwd, shell: true });
+                var commandProcess = child_process.spawn(command, args, { cwd: cwd, shell: true });
                 if (isVerbose) {
                     commandProcess.on('message', function (message) {
                         console.info({ message: message });
@@ -3237,7 +3237,7 @@
     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 prefixes, prefixes_1, prefixes_1_1, prefix, path$1, e_1_1, error_1;
             var e_1, _b;
             return __generator(this, function (_c) {
                 switch (_c.label) {
@@ -3245,7 +3245,7 @@
                         _c.trys.push([0, 9, , 10]);
                         prefixes = [
                             process.env.LOCALAPPDATA,
-                            node_path.join(process.env.LOCALAPPDATA || '', 'Programs'),
+                            path.join(process.env.LOCALAPPDATA || '', 'Programs'),
                             process.env.PROGRAMFILES,
                             process.env['PROGRAMFILES(X86)'],
                         ];
@@ -3257,11 +3257,11 @@
                     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())];
+                        path$1 = prefix + windowsSuffix;
+                        return [4 /*yield*/, isExecutable(path$1, $provideFilesystemForNode())];
                     case 3:
                         if (_c.sent()) {
-                            return [2 /*return*/, path];
+                            return [2 /*return*/, path$1];
                         }
                         _c.label = 4;
                     case 4:
@@ -4935,6 +4935,24 @@
         var finalResultPromise = /* not await */ taskProcessCallback(function (newOngoingResult) {
             partialResultSubject.next(newOngoingResult);
         });
+        finalResultPromise
+            .catch(function (error) {
+            // console.error('!!!!! Task failed:', error);
+            partialResultSubject.error(error);
+        })
+            .then(function (value) {
+            // console.error('!!!!! Task finished:', value);
+            if (value) {
+                try {
+                    assertsTaskSuccessful(value);
+                    partialResultSubject.next(value);
+                }
+                catch (error) {
+                    partialResultSubject.error(error);
+                }
+            }
+            partialResultSubject.complete();
+        });
         function asPromise(options) {
             return __awaiter(this, void 0, void 0, function () {
                 var _a, isCrashedOnError, finalResult;
@@ -4945,7 +4963,9 @@
                             return [4 /*yield*/, finalResultPromise];
                         case 1:
                             finalResult = _b.sent();
+                            console.error('!!!!! finalResult:', finalResult);
                             if (isCrashedOnError) {
+                                console.error('!!!!! isCrashedOnError:', finalResult);
                                 assertsTaskSuccessful(finalResult);
                             }
                             return [2 /*return*/, finalResult];
@@ -4958,9 +4978,7 @@
             taskId: taskId,
             asPromise: asPromise,
             asObservable: function () {
-                return rxjs.concat(partialResultSubject.asObservable(), rxjs.from(asPromise({
-                    isCrashedOnError: true,
-                })));
+                return partialResultSubject.asObservable();
             },
             get currentValue() {
                 return partialResultSubject.value;
@@ -7374,9 +7392,9 @@
                         }
                         basename = url.split('/').pop() || titleToName(url);
                         hash = sha256__default["default"](hexEncoder__default["default"].parse(url)).toString( /* hex */);
-                        rootDirname_1 = node_path.join(process.cwd(), DEFAULT_DOWNLOAD_CACHE_DIRNAME);
-                        filepath = node_path.join.apply(void 0, __spreadArray(__spreadArray([], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(basename.substring(0, MAX_FILENAME_LENGTH), ".").concat(mimeTypeToExtension(mimeType))], false));
-                        return [4 /*yield*/, tools.fs.mkdir(node_path.dirname(node_path.join(rootDirname_1, filepath)), { recursive: true })];
+                        rootDirname_1 = path.join(process.cwd(), DEFAULT_DOWNLOAD_CACHE_DIRNAME);
+                        filepath = path.join.apply(void 0, __spreadArray(__spreadArray([], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(basename.substring(0, MAX_FILENAME_LENGTH), ".").concat(mimeTypeToExtension(mimeType))], false));
+                        return [4 /*yield*/, tools.fs.mkdir(path.dirname(path.join(rootDirname_1, filepath)), { recursive: true })];
                     case 2:
                         _h.sent();
                         _g = (_f = Buffer).from;
@@ -7386,7 +7404,7 @@
                         if (fileContent.length > DEFAULT_MAX_FILE_SIZE /* <- TODO: Allow to pass different value to remote server */) {
                             throw new LimitReachedError("File is too large (".concat(Math.round(fileContent.length / 1024 / 1024), "MB). Maximum allowed size is ").concat(Math.round(DEFAULT_MAX_FILE_SIZE / 1024 / 1024), "MB."));
                         }
-                        return [4 /*yield*/, tools.fs.writeFile(node_path.join(rootDirname_1, filepath), fileContent)];
+                        return [4 /*yield*/, tools.fs.writeFile(path.join(rootDirname_1, filepath), fileContent)];
                     case 4:
                         _h.sent();
                         // TODO: [💵] Check the file security
@@ -7402,7 +7420,7 @@
                             throw new EnvironmentMismatchError('Can not import file knowledge in non-file pipeline');
                             //          <- TODO: [🧠] What is the best error type here`
                         }
-                        filename_1 = node_path.join(rootDirname, knowledgeSourceContent).split('\\').join('/');
+                        filename_1 = path.join(rootDirname, knowledgeSourceContent).split('\\').join('/');
                         fileExtension = getFileExtension(filename_1);
                         mimeType = extensionToMimeType(fileExtension || '');
                         return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
@@ -11869,19 +11887,19 @@
      * @returns List of all files in the directory
      * @private internal function of `createCollectionFromDirectory`
      */
-    function listAllFiles(path, isRecursive, fs) {
+    function listAllFiles(path$1, isRecursive, fs) {
         return __awaiter(this, void 0, void 0, function () {
             var dirents, fileNames, _a, _b, dirent, subPath, _c, _d, _e, _f, e_1_1;
             var e_1, _g;
             return __generator(this, function (_h) {
                 switch (_h.label) {
-                    case 0: return [4 /*yield*/, isDirectoryExisting(path, fs)];
+                    case 0: return [4 /*yield*/, isDirectoryExisting(path$1, fs)];
                     case 1:
                         if (!(_h.sent())) {
-                            throw new Error("Directory \"".concat(path, "\" does not exist or is not readable"));
+                            throw new Error("Directory \"".concat(path$1, "\" does not exist or is not readable"));
                             //           <- TODO: Use some custom error class
                         }
-                        return [4 /*yield*/, fs.readdir(path, {
+                        return [4 /*yield*/, fs.readdir(path$1, {
                                 withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
                             })];
                     case 2:
@@ -11890,7 +11908,7 @@
                             .filter(function (dirent) { return dirent.isFile(); })
                             .map(function (_a) {
                             var name = _a.name;
-                            return node_path.join(path, name).split('\\').join('/');
+                            return path.join(path$1, name).split('\\').join('/');
                         });
                         if (!isRecursive) return [3 /*break*/, 10];
                         _h.label = 3;
@@ -11901,7 +11919,7 @@
                     case 4:
                         if (!!_b.done) return [3 /*break*/, 7];
                         dirent = _b.value;
-                        subPath = node_path.join(path, dirent.name);
+                        subPath = path.join(path$1, dirent.name);
                         _d = (_c = fileNames.push).apply;
                         _e = [fileNames];
                         _f = [[]];
@@ -12032,7 +12050,7 @@
      * @returns PipelineCollection
      * @public exported from `@promptbook/node`
      */
-    function createCollectionFromDirectory(path, tools, options) {
+    function createCollectionFromDirectory(path$1, tools, options) {
         return __awaiter(this, void 0, void 0, function () {
             var madeLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, rootUrl, collection;
             var _this = this;
@@ -12049,7 +12067,7 @@
                             throw new EnvironmentMismatchError('Can not create collection without filesystem tools');
                             //          <- TODO: [🧠] What is the best error type here`
                         }
-                        madeLibraryFilePath = node_path.join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
+                        madeLibraryFilePath = path.join(path$1, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                         // <- TODO: [🦒] Allow to override (pass different value into the function)
                         , ".json"));
                         return [4 /*yield*/, isFileExisting(madeLibraryFilePath, tools.fs)];
@@ -12068,9 +12086,9 @@
                                 switch (_b.label) {
                                     case 0:
                                         if (isVerbose) {
-                                            console.info(colors__default["default"].cyan("Creating pipeline collection from path ".concat(path.split('\\').join('/'))));
+                                            console.info(colors__default["default"].cyan("Creating pipeline collection from path ".concat(path$1.split('\\').join('/'))));
                                         }
-                                        return [4 /*yield*/, listAllFiles(path, isRecursive, tools.fs)];
+                                        return [4 /*yield*/, listAllFiles(path$1, isRecursive, tools.fs)];
                                     case 1:
                                         fileNames = _b.sent();
                                         // Note: First load all .book.json and then .book.md files
@@ -12091,7 +12109,7 @@
                                                 switch (_f.label) {
                                                     case 0:
                                                         sourceFile = './' + fileName.split('\\').join('/');
-                                                        rootDirname = node_path.dirname(sourceFile).split('\\').join('/');
+                                                        rootDirname = path.dirname(sourceFile).split('\\').join('/');
                                                         _f.label = 1;
                                                     case 1:
                                                         _f.trys.push([1, 8, , 9]);
@@ -12326,7 +12344,7 @@
         makeCommand.option('-v, --verbose', "Is output verbose", false);
         makeCommand.option('-o, --output <path>', spaceTrim__default["default"]("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
         makeCommand.option('-fn, --function-name <functionName>', spaceTrim__default["default"]("\n            Name of the function to get pipeline collection\n\n            Note: This can be used only with \"javascript\" or \"typescript\" format\n\n        "), DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME);
-        makeCommand.action(function (path, _a) {
+        makeCommand.action(function (path$1, _a) {
             var projectName = _a.projectName, rootUrl = _a.rootUrl, format = _a.format, functionName = _a.functionName, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, output = _a.output;
             return __awaiter(_this, void 0, void 0, function () {
                 var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, pipelinesUrls, validations_1, validations_1_1, validation_1, pipelinesUrls_1, pipelinesUrls_1_1, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
@@ -12378,7 +12396,7 @@
                                 /*new JavascriptExecutionTools(options)*/
                                 ],
                                 _b);
-                            return [4 /*yield*/, createCollectionFromDirectory(path, tools, {
+                            return [4 /*yield*/, createCollectionFromDirectory(path$1, tools, {
                                     isVerbose: isVerbose,
                                     rootUrl: rootUrl,
                                     isRecursive: true,
@@ -12392,7 +12410,7 @@
                         case 5:
                             pipelinesUrls = _e.sent();
                             if (pipelinesUrls.length === 0) {
-                                console.error(colors__default["default"].red("No books found in \"".concat(path, "\"")));
+                                console.error(colors__default["default"].red("No books found in \"".concat(path$1, "\"")));
                                 return [2 /*return*/, process.exit(1)];
                             }
                             _e.label = 6;
@@ -12471,11 +12489,11 @@
                                         case 0:
                                             filename = output !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                                                 ? output
-                                                : node_path.join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
+                                                : path.join(path$1, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
                                             if (!output.endsWith(".".concat(extension))) {
                                                 console.warn(colors__default["default"].yellow("Warning: Extension of output file should be \"".concat(extension, "\"")));
                                             }
-                                            return [4 /*yield*/, promises.mkdir(node_path.dirname(filename), { recursive: true })];
+                                            return [4 /*yield*/, promises.mkdir(path.dirname(filename), { recursive: true })];
                                         case 1:
                                             _a.sent();
                                             return [4 /*yield*/, promises.writeFile(filename, content, 'utf-8')];
@@ -13090,7 +13108,7 @@
                             return __generator(this, function (_d) {
                                 switch (_d.label) {
                                     case 0:
-                                        booksDirname = node_path.join(rootDirname, DEFAULT_BOOKS_DIRNAME /* <- TODO: [🕝] Make here more candidates */);
+                                        booksDirname = path.join(rootDirname, DEFAULT_BOOKS_DIRNAME /* <- TODO: [🕝] Make here more candidates */);
                                         return [4 /*yield*/, isDirectoryExisting(booksDirname, fs)];
                                     case 1:
                                         if (!_d.sent()) return [3 /*break*/, 4];
@@ -13128,7 +13146,7 @@
                                             return [2 /*return*/, "break-up_to_root"];
                                         }
                                         // Note: If the directory does not exist, try the parent directory
-                                        rootDirname = node_path.join(rootDirname, '..');
+                                        rootDirname = path.join(rootDirname, '..');
                                         return [2 /*return*/];
                                 }
                             });
@@ -13367,7 +13385,7 @@
                         return [4 /*yield*/, isFileExisting('.env', fs)];
                     case 4:
                         if (!!(_m.sent())) return [3 /*break*/, 6];
-                        return [4 /*yield*/, promises.writeFile(node_path.join(process.cwd(), '.env'), $llmToolsMetadataRegister
+                        return [4 /*yield*/, promises.writeFile(path.join(process.cwd(), '.env'), $llmToolsMetadataRegister
                                 .list()
                                 .flatMap(function (_a) {
                                 var title = _a.title, envVariables = _a.envVariables;
@@ -13795,7 +13813,7 @@
             next();
         });
         var runningExecutionTasks = [];
-        // TODO: !!!!!! Do here some garbage collection of finished tasks
+        // TODO: [🧠] Do here some garbage collection of finished tasks
         app.get(['/', rootPath], function (request, response) { return __awaiter(_this, void 0, void 0, function () {
             var _a, _b;
             var _this = this;
@@ -13844,20 +13862,19 @@
             });
         }); });
         app.get("".concat(rootPath, "/books"), function (request, response) { return __awaiter(_this, void 0, void 0, function () {
-            var _a, _b, _c;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
+            var pipelines;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
                     case 0:
-                        _b = (_a = response).send;
-                        if (!(collection === null)) return [3 /*break*/, 1];
-                        _c = [];
-                        return [3 /*break*/, 3];
-                    case 1: return [4 /*yield*/, collection.listPipelines()];
-                    case 2:
-                        _c = _d.sent();
-                        _d.label = 3;
-                    case 3:
-                        _b.apply(_a, [_c]);
+                        if (collection === null) {
+                            response.status(500).send('No collection available');
+                            return [2 /*return*/];
+                        }
+                        return [4 /*yield*/, collection.listPipelines()];
+                    case 1:
+                        pipelines = _a.sent();
+                        // <- TODO: [🧠][👩🏾‍🤝‍🧑🏿] List `inputParameters` required for the execution
+                        response.send(pipelines);
                         return [2 /*return*/];
                 }
             });
@@ -13887,13 +13904,12 @@
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
-                        _b.trys.push([0, 5, , 6]);
+                        _b.trys.push([0, 6, , 7]);
                         inputParameters = request.body.inputParameters;
                         pipelineUrl = request.body.pipelineUrl || request.body.book;
                         return [4 /*yield*/, (collection === null || collection === void 0 ? void 0 : collection.getPipelineByUrl(pipelineUrl))];
                     case 1:
                         pipeline = _b.sent();
-                        // <- TODO: !!!!!! NotFoundError
                         if (pipeline === undefined) {
                             response.status(404).send("Pipeline \"".concat(pipelineUrl, "\" not found"));
                             return [2 /*return*/];
@@ -13920,20 +13936,21 @@
                         pipelineExecutor = createPipelineExecutor(__assign({ pipeline: pipeline, tools: tools }, options));
                         executionTask = pipelineExecutor(inputParameters);
                         runningExecutionTasks.push(executionTask);
-                        response.send(executionTask);
-                        // TODO: !!!!!! Remove this:
-                        executionTask.asObservable().subscribe(function (_) {
-                            console.log('!!!', _);
-                        });
-                        return [3 /*break*/, 6];
+                        return [4 /*yield*/, waitasecond.forTime(10)];
                     case 5:
+                        _b.sent();
+                        // <- Note: Wait for a while to wait for quick responses or sudden but asynchronous errors
+                        // <- TODO: Put this into configuration
+                        response.send(executionTask);
+                        return [3 /*break*/, 7];
+                    case 6:
                         error_1 = _b.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
                         response.status(400).send({ error: serializeError(error_1) });
-                        return [3 /*break*/, 6];
-                    case 6: return [2 /*return*/];
+                        return [3 /*break*/, 7];
+                    case 7: return [2 /*return*/];
                 }
             });
         }); });
@@ -14212,21 +14229,30 @@
         // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
         'Path to promptbook collection directory', DEFAULT_BOOKS_DIRNAME);
         startServerCommand.option('--port <port>', "Port to start the server on", '4460');
-        startServerCommand.option('-u, --url', spaceTrim__default["default"]("\n            Public root url of the server\n            It is used for following purposes:\n\n            1) It is suffixed with /books and used as rootUrl for all served books\n            2) Path (if not just /) is used as rootPath for the server\n        "));
+        startServerCommand.option('-u, --url <url>', spaceTrim__default["default"]("\n            Public root url of the server\n            It is used for following purposes:\n\n            1) It is suffixed with /books and used as rootUrl for all served books\n            2) Path (if not just /) is used as rootPath for the server\n        "));
         startServerCommand.option('--allow-anonymous', "Is anonymous mode allowed", false);
         startServerCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
         startServerCommand.option('-v, --verbose', "Is output verbose", false);
         startServerCommand.description(spaceTrim__default["default"]("\n            Starts a remote server to execute books\n        "));
         startServerCommand.action(function (path, _a) {
-            var port = _a.port, rawUrl = _a.url, isAnonymousModeAllowed = _a.allowAnonymous, isCacheReloaded = _a.reload, isVerbose = _a.verbose;
+            var portRaw = _a.port, rawUrl = _a.url, isAnonymousModeAllowed = _a.allowAnonymous, isCacheReloaded = _a.reload, isVerbose = _a.verbose;
             return __awaiter(_this, void 0, void 0, function () {
-                var url, rootUrl, rootPath, prepareAndScrapeOptions, fs, llm, executables, tools, collection;
+                var port, url, rootUrl, rootPath, prepareAndScrapeOptions, fs, llm, executables, tools, collection;
                 var _b;
                 return __generator(this, function (_c) {
                     switch (_c.label) {
                         case 0:
+                            if (rawUrl && !isValidUrl(rawUrl)) {
+                                console.error(colors__default["default"].red("Invalid URL: ".concat(rawUrl)));
+                                return [2 /*return*/, process.exit(1)];
+                            }
+                            port = parseInt(portRaw, 10);
+                            if (isNaN(port) || port <= 0 || port > 65535) {
+                                console.error(colors__default["default"].red("Invalid port number: ".concat(portRaw)));
+                                return [2 /*return*/, process.exit(1)];
+                            }
                             url = !rawUrl ? null : new URL(rawUrl);
-                            if (url !== null && url.port !== port) {
+                            if (url !== null && url.port !== port.toString()) {
                                 console.warn(colors__default["default"].yellow("Port in --url is different from --port which the server will listen on, this is ok only if you proxy from one port to another, for exaple via nginx or docker"));
                             }
                             rootUrl = undefined;
@@ -14271,7 +14297,7 @@
                             collection = _c.sent();
                             startRemoteServer({
                                 rootPath: rootPath,
-                                port: parseInt(port, 10),
+                                port: port,
                                 isAnonymousModeAllowed: isAnonymousModeAllowed,
                                 isApplicationModeAllowed: true,
                                 collection: collection,
@@ -14280,7 +14306,11 @@
                                     return llm;
                                 },
                             });
-                            return [2 /*return*/];
+                            return [4 /*yield*/, waitasecond.forEver()];
+                        case 5: 
+                        // Note: Already logged by `startRemoteServer`
+                        // console.error(colors.green(`Server started on port ${port}`));
+                        return [2 /*return*/, _c.sent()];
                     }
                 });
             });
@@ -17059,12 +17089,12 @@
                         semanticName = normalizeToKebabCase(titleToName((sourceFilename || url || '').split('intermediate').join(''))).substring(0, 20);
                         pieces = ['intermediate', semanticName, hash].filter(function (piece) { return piece !== ''; });
                         name = pieces.join('-').split('--').join('-');
-                        cacheFilename = node_path.join.apply(void 0, __spreadArray(__spreadArray([process.cwd(),
+                        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('/') +
                             '.' +
                             extension;
-                        return [4 /*yield*/, promises.mkdir(node_path.dirname(cacheFilename), { recursive: true })];
+                        return [4 /*yield*/, promises.mkdir(path.dirname(cacheFilename), { recursive: true })];
                     case 1:
                         _a.sent();
                         isDestroyed = true;
@@ -17769,7 +17799,7 @@
                             return [4 /*yield*/, isFileExisting(cacheFilehandler.filename, this.tools.fs)];
                         case 2:
                             if (!!(_g.sent())) return [3 /*break*/, 8];
-                            documentSourceOutdirPathForLibreOffice_1 = node_path.join(node_path.dirname(cacheFilehandler.filename), 'libreoffice')
+                            documentSourceOutdirPathForLibreOffice_1 = path.join(path.dirname(cacheFilehandler.filename), 'libreoffice')
                                 .split('\\')
                                 .join('/');
                             command_1 = "\"".concat(this.tools.executables.libreOfficePath, "\" --headless --convert-to docx \"").concat(source.filename, "\"  --outdir \"").concat(documentSourceOutdirPathForLibreOffice_1, "\"");
@@ -17783,7 +17813,7 @@
                                 throw new UnexpectedError(spaceTrim__default["default"](function (block) { return "\n                            Expected exactly 1 file in the LibreOffice output directory, got ".concat(files_1.length, "\n\n                            The temporary folder:\n                            ").concat(block(documentSourceOutdirPathForLibreOffice_1), "\n\n                            Command:\n                            > ").concat(block(command_1), "\n                        "); }));
                             }
                             file = files_1[0];
-                            return [4 /*yield*/, promises.rename(node_path.join(documentSourceOutdirPathForLibreOffice_1, file), cacheFilehandler.filename)];
+                            return [4 /*yield*/, promises.rename(path.join(documentSourceOutdirPathForLibreOffice_1, file), cacheFilehandler.filename)];
                         case 5:
                             _g.sent();
                             return [4 /*yield*/, promises.rmdir(documentSourceOutdirPathForLibreOffice_1)];