@promptbook/cli 0.84.0 → 0.85.0-0

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('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('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('prompts'), require('moment'), 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', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'prompts', 'moment', '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.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.prompts, global.moment, 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, papaparse, cryptoJs, mimeTypes, glob, prompts, moment, 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 }; }
 
@@ -34,6 +34,8 @@
     var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
     var prompts__default = /*#__PURE__*/_interopDefaultLegacy(prompts);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
+    var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
+    var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
     var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
@@ -51,7 +53,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.84.0-21';
+    var PROMPTBOOK_ENGINE_VERSION = '0.84.0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -459,7 +461,7 @@
      */
     var $isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * TODO: [☑]
+     * TODO: [🎺]
      */
 
     /**
@@ -471,7 +473,7 @@
      */
     var $isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * TODO: [☑]
+     * TODO: [🎺]
      */
 
     /**
@@ -483,7 +485,7 @@
      */
     var $isRunningInJest = new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefined;\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * TODO: [☑]
+     * TODO: [🎺]
      */
 
     /**
@@ -495,7 +497,7 @@
      */
     var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
     /**
-     * TODO: [☑]
+     * TODO: [🎺]
      */
 
     /**
@@ -508,7 +510,7 @@
     function $initializeAboutCommand(program) {
         var _this = this;
         var makeCommand = program.command('about');
-        makeCommand.description(spaceTrim__default["default"]("\n            Tells about Promptbook CLI and its abilities\n      "));
+        makeCommand.description(spaceTrim__default["default"]("\n            Tells about Promptbook CLI and its abilities\n        "));
         makeCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 console.info(colors__default["default"].bold(colors__default["default"].blue("Promptbook: ".concat(CLAIM))));
@@ -517,7 +519,7 @@
                 if ($isRunningInNode()) {
                     console.info(colors__default["default"].cyan("Environment: Node.js"));
                     console.info(colors__default["default"].cyan("Node.js version: ".concat(process.version)));
-                    // <- TODO: [🧠][☑] Make robust system to check platform requirements like browser/node environment, version of node, available memory, disk space, ...
+                    // <- TODO: [🧠][🎺] Make robust system to check platform requirements like browser/node environment, version of node, available memory, disk space, ...
                     console.info(colors__default["default"].cyan("Platform type: ".concat(process.platform)));
                     console.info(colors__default["default"].cyan("Platform architecture: ".concat(process.arch)));
                     // console.info(colors.cyan(`Available memory: ${process.availableMemory()}`));
@@ -557,7 +559,7 @@
     function $initializeHelloCommand(program) {
         var _this = this;
         var helloCommand = program.command('hello');
-        helloCommand.description(spaceTrim__default["default"]("\n            Just command for testing\n      "));
+        helloCommand.description(spaceTrim__default["default"]("\n            Just command for testing\n        "));
         helloCommand.argument('[name]', 'Your name', 'Paul');
         helloCommand.option('-g, --greeting <greeting>', "Greeting", 'Hello');
         helloCommand.action(function (name, _a) {
@@ -2930,7 +2932,7 @@
     function $initializeListModelsCommand(program) {
         var _this = this;
         var listModelsCommand = program.command('list-models');
-        listModelsCommand.description(spaceTrim__default["default"]("\n            List all available and configured LLM models\n      "));
+        listModelsCommand.description(spaceTrim__default["default"]("\n            List all available and configured LLM models\n        "));
         listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
             var llm;
             return __generator(this, function (_a) {
@@ -3615,7 +3617,7 @@
     function $initializeListScrapersCommand(program) {
         var _this = this;
         var listModelsCommand = program.command('list-scrapers');
-        listModelsCommand.description(spaceTrim__default["default"]("\n            List all available and configured scrapers and executables\n      "));
+        listModelsCommand.description(spaceTrim__default["default"]("\n            List all available and configured scrapers and executables\n        "));
         listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
             var scrapers, executables;
             return __generator(this, function (_a) {
@@ -4644,6 +4646,58 @@
         return MissingToolsError;
     }(Error));
 
+    /**
+     * Determine if the pipeline is fully prepared
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/196
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function isPipelinePrepared(pipeline) {
+        // Note: Ignoring `pipeline.preparations` @@@
+        // Note: Ignoring `pipeline.knowledgePieces` @@@
+        if (pipeline.title === undefined || pipeline.title === '' || pipeline.title === DEFAULT_BOOK_TITLE) {
+            return false;
+        }
+        if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
+            return false;
+        }
+        if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
+            return false;
+        }
+        /*
+        TODO: [🧠][🍫] `tasks` can not be determined if they are fully prepared SO ignoring them
+        > if (!pipeline.tasks.every(({ preparedContent }) => preparedContent === undefined)) {
+        >     return false;
+        > }
+        */
+        return true;
+    }
+    /**
+     * 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 task
+     *     - [♨] Are examples prepared
+     *     - [♨] Are tasks prepared
+     */
+
+    /**
+     * Generates random token
+     *
+     * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
+     *
+     * @private internal helper function
+     * @returns secure random token
+     */
+    function $randomToken(randomness) {
+        return crypto.randomBytes(randomness).toString('hex');
+    }
+    /**
+     * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
+     */
+
     /**
      * This error indicates problems parsing the format value
      *
@@ -4829,9 +4883,9 @@
      *
      * @param executionResult - The partial result of the Promptbook execution
      * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
-     * @public exported from `@promptbook/core`
+     * @private internal helper function of `asPromise` method of `ExecutionTask`
      */
-    function assertsExecutionSuccessful(executionResult) {
+    function assertsTaskSuccessful(executionResult) {
         var e_1, _a;
         var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors, warnings = executionResult.warnings;
         try {
@@ -4866,47 +4920,72 @@
         }
     }
     /**
-     * TODO: [🐚] This function should be removed OR changed OR be completely rewritten
      * TODO: [🧠] Can this return type be better typed than void
      */
 
     /**
-     * Determine if the pipeline is fully prepared
-     *
-     * @see https://github.com/webgptorg/promptbook/discussions/196
+     * Helper to create a new task
      *
-     * @public exported from `@promptbook/core`
+     * @private internal helper function
      */
-    function isPipelinePrepared(pipeline) {
-        // Note: Ignoring `pipeline.preparations` @@@
-        // Note: Ignoring `pipeline.knowledgePieces` @@@
-        if (pipeline.title === undefined || pipeline.title === '' || pipeline.title === DEFAULT_BOOK_TITLE) {
-            return false;
-        }
-        if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
-            return false;
-        }
-        if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
-            return false;
+    function createTask(options) {
+        var taskType = options.taskType, taskProcessCallback = options.taskProcessCallback;
+        var taskId = "".concat(taskType.toLowerCase(), "-").concat($randomToken(256 /* <- TODO: !!! To global config */));
+        var resultSubject = new rxjs.BehaviorSubject({});
+        var finalResultPromise = /* not await */ taskProcessCallback(function (newOngoingResult) {
+            resultSubject.next(newOngoingResult);
+        });
+        function asPromise(options) {
+            return __awaiter(this, void 0, void 0, function () {
+                var _a, isCrashedOnError, finalResult;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            _a = (options || {}).isCrashedOnError, isCrashedOnError = _a === void 0 ? true : _a;
+                            return [4 /*yield*/, finalResultPromise];
+                        case 1:
+                            finalResult = _b.sent();
+                            if (isCrashedOnError) {
+                                assertsTaskSuccessful(finalResult);
+                            }
+                            return [2 /*return*/, finalResult];
+                    }
+                });
+            });
         }
-        /*
-        TODO: [🧠][🍫] `tasks` can not be determined if they are fully prepared SO ignoring them
-        > if (!pipeline.tasks.every(({ preparedContent }) => preparedContent === undefined)) {
-        >     return false;
-        > }
-        */
-        return true;
+        return {
+            taskType: taskType,
+            taskId: taskId,
+            asPromise: asPromise,
+            asObservable: function () {
+                return rxjs.concat(resultSubject.asObservable(), rxjs.from(asPromise({
+                    isCrashedOnError: true,
+                })));
+            },
+        };
     }
     /**
-     * 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 task
-     *     - [♨] Are examples prepared
-     *     - [♨] Are tasks prepared
+     * TODO: Maybe allow to terminate the task and add getter `isFinished` or `status`
+     * TODO: [🐚] Split into more files and make `PrepareTask` & `RemoteTask` + split the function
      */
 
+    /**
+     * Serializes an error into a [🚉] JSON-serializable object
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function serializeError(error) {
+        var name = error.name, message = error.message, stack = error.stack;
+        if (!Object.keys(ALL_ERRORS).includes(name)) {
+            console.error(spaceTrim__default["default"](function (block) { return "\n          \n                    Cannot serialize error with name \"".concat(name, "\"\n\n                    ").concat(block(stack || message), "\n                \n                "); }));
+        }
+        return {
+            name: name,
+            message: message,
+            stack: stack,
+        };
+    }
+
     /**
      * Format either small or big number
      *
@@ -4982,23 +5061,6 @@
         }
     }
 
-    /**
-     * Serializes an error into a [🚉] JSON-serializable object
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function serializeError(error) {
-        var name = error.name, message = error.message, stack = error.stack;
-        if (!Object.keys(ALL_ERRORS).includes(name)) {
-            console.error(spaceTrim__default["default"](function (block) { return "\n          \n                    Cannot serialize error with name \"".concat(name, "\"\n\n                    ").concat(block(stack || message), "\n                \n                "); }));
-        }
-        return {
-            name: name,
-            message: message,
-            stack: stack,
-        };
-    }
-
     /**
      * Parses the given script and returns the list of all used variables that are not defined in the script
      *
@@ -6462,27 +6524,20 @@
      */
     function executeTask(options) {
         return __awaiter(this, void 0, void 0, function () {
-            var currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSupressed, 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 currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSupressed, priority, usedParameterNames, dependentParameterNames, definedParameters, _a, _b, _c, definedParameterNames, parameters, _loop_1, _d, _e, parameterName, maxAttempts, jokerParameterNames, preparedContent, resultString;
+            var _f, e_1, _g, _h, _j;
+            return __generator(this, function (_k) {
+                switch (_k.label) {
                     case 0:
                         currentTask = options.currentTask, preparedPipeline = options.preparedPipeline, parametersToPass = options.parametersToPass, tools = options.tools, onProgress = options.onProgress, $executionReport = options.$executionReport, pipelineIdentification = options.pipelineIdentification, maxExecutionAttempts = options.maxExecutionAttempts, maxParallelCount = options.maxParallelCount, csvSettings = options.csvSettings, isVerbose = options.isVerbose, rootDirname = options.rootDirname, cacheDirname = options.cacheDirname, intermediateFilesStrategy = options.intermediateFilesStrategy, isAutoInstalled = options.isAutoInstalled, isNotPreparedWarningSupressed = options.isNotPreparedWarningSupressed;
-                        name = "pipeline-executor-frame-".concat(currentTask.name);
-                        title = currentTask.title;
                         priority = preparedPipeline.tasks.length - preparedPipeline.tasks.indexOf(currentTask);
                         return [4 /*yield*/, onProgress({
-                                name: name,
-                                title: title,
-                                isStarted: false,
-                                isDone: false,
-                                taskType: currentTask.taskType,
-                                parameterName: currentTask.resultingParameterName,
-                                parameterValue: null,
-                                // <- [🍸]
+                                outputParameters: (_f = {},
+                                    _f[currentTask.resultingParameterName] = '',
+                                    _f),
                             })];
                     case 1:
-                        _h.sent();
+                        _k.sent();
                         usedParameterNames = extractParameterNamesFromTask(currentTask);
                         dependentParameterNames = new Set(currentTask.dependentParameterNames);
                         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
@@ -6501,7 +6556,7 @@
                                 pipelineIdentification: pipelineIdentification,
                             })];
                     case 2:
-                        definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), parametersToPass])]);
+                        definedParameters = _b.apply(_a, [__assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_k.sent())])), parametersToPass])]);
                         definedParameterNames = new Set(Object.keys(definedParameters));
                         parameters = {};
                         _loop_1 = function (parameterName) {
@@ -6529,7 +6584,7 @@
                         catch (e_1_1) { e_1 = { error: e_1_1 }; }
                         finally {
                             try {
-                                if (_e && !_e.done && (_f = _d.return)) _f.call(_d);
+                                if (_e && !_e.done && (_g = _d.return)) _g.call(_d);
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
@@ -6560,24 +6615,19 @@
                                 isNotPreparedWarningSupressed: isNotPreparedWarningSupressed,
                             })];
                     case 3:
-                        resultString = _h.sent();
+                        resultString = _k.sent();
                         return [4 /*yield*/, onProgress({
-                                name: name,
-                                title: title,
-                                isStarted: true,
-                                isDone: true,
-                                taskType: currentTask.taskType,
-                                parameterName: currentTask.resultingParameterName,
-                                parameterValue: resultString,
-                                // <- [🍸]
+                                outputParameters: (_h = {},
+                                    _h[currentTask.resultingParameterName] = resultString,
+                                    _h),
                             })];
                     case 4:
-                        _h.sent();
-                        return [2 /*return*/, Object.freeze((_g = {},
-                                _g[currentTask.resultingParameterName] = 
+                        _k.sent();
+                        return [2 /*return*/, Object.freeze((_j = {},
+                                _j[currentTask.resultingParameterName] = 
                                 // <- Note: [👩‍👩‍👧] No need to detect parameter collision here because pipeline checks logic consistency during construction
                                 resultString,
-                                _g))];
+                                _j))];
                 }
             });
         });
@@ -6585,9 +6635,6 @@
     /**
      * TODO: [🤹‍♂️]
      */
-    /**
-     * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
-     */
 
     /**
      * @@@
@@ -6849,15 +6896,15 @@
                                         return [3 /*break*/, 4];
                                     case 3:
                                         unresovedTasks_1 = unresovedTasks_1.filter(function (task) { return task !== currentTask; });
-                                        work_1 = executeTask(__assign(__assign({}, options), { currentTask: currentTask, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (progress) {
+                                        work_1 = executeTask(__assign(__assign({}, options), { currentTask: currentTask, preparedPipeline: preparedPipeline, parametersToPass: parametersToPass, tools: tools, onProgress: function (newOngoingResult) {
                                                 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)
+                                                    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(newOngoingResult, null, 4)
                                                         .split('\n')
                                                         .map(function (line) { return "> ".concat(line); })
                                                         .join('\n')), "\n                                    "); }));
                                                 }
                                                 if (onProgress) {
-                                                    onProgress(progress);
+                                                    onProgress(newOngoingResult);
                                                 }
                                             }, $executionReport: executionReport, pipelineIdentification: spaceTrim.spaceTrim(function (block) { return "\n                            ".concat(block(pipelineIdentification), "\n                            Task name: ").concat(currentTask.name, "\n                            Task title: ").concat(currentTask.title, "\n                        "); }) }))
                                             .then(function (newParametersToPass) {
@@ -6960,9 +7007,6 @@
             });
         });
     }
-    /**
-     * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
-     */
 
     /**
      * Creates executor function from pipeline and execution tools.
@@ -6994,7 +7038,7 @@
             console.warn(spaceTrim.spaceTrim(function (block) { return "\n                    Pipeline is not prepared\n\n                    ".concat(block(pipelineIdentification), "\n\n                    It will be prepared ad-hoc before the first execution and **returned as `preparedPipeline` in `PipelineExecutorResult`**\n                    But it is recommended to prepare the pipeline during collection preparation\n\n                    @see more at https://ptbk.io/prepare-pipeline\n                "); }));
         }
         var runCount = 0;
-        var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+        var pipelineExecutorWithCallback = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 runCount++;
                 return [2 /*return*/, /* not await */ executePipeline({
@@ -7019,11 +7063,23 @@
                     })];
             });
         }); };
+        var pipelineExecutor = function (inputParameters) {
+            return createTask({
+                taskType: 'EXECUTION',
+                taskProcessCallback: function (updateOngoingResult) {
+                    var _this = this;
+                    return pipelineExecutorWithCallback(inputParameters, function (newOngoingResult) { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            updateOngoingResult(newOngoingResult);
+                            return [2 /*return*/];
+                        });
+                    }); });
+                },
+            });
+        };
+        //        <- TODO: Make types such as there is no need to do `as` for `createTask`
         return pipelineExecutor;
     }
-    /**
-     * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
-     */
 
     /**
      * Async version of Array.forEach
@@ -7141,10 +7197,9 @@
                             return modelName;
                         })
                             .join(',');
-                        return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription })];
+                        return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription }).asPromise()];
                     case 3:
                         result = _d.sent();
-                        assertsExecutionSuccessful(result);
                         outputParameters = result.outputParameters;
                         modelRequirementsRaw = outputParameters.modelRequirements;
                         modelRequirements = JSON.parse(modelRequirementsRaw);
@@ -7659,10 +7714,9 @@
                                     var content = _a.content;
                                     return content;
                                 }).join('\n\n'),
-                            })];
+                            }).asPromise()];
                     case 2:
                         result = _e.sent();
-                        assertsExecutionSuccessful(result);
                         outputParameters = result.outputParameters;
                         titleRaw = outputParameters.title;
                         if (isVerbose) {
@@ -12244,7 +12298,7 @@
     function $initializeMakeCommand(program) {
         var _this = this;
         var makeCommand = program.command('make');
-        makeCommand.description(spaceTrim__default["default"]("\n            Makes a new pipeline collection in given folder\n      "));
+        makeCommand.description(spaceTrim__default["default"]("\n            Makes a new pipeline collection in given folder\n        "));
         // TODO: [🧅] DRY command arguments
         makeCommand.argument('[path]', 
         // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
@@ -12541,7 +12595,7 @@
     function $initializePrettifyCommand(program) {
         var _this = this;
         var prettifyCommand = program.command('prettify');
-        prettifyCommand.description(spaceTrim__default["default"]("\n            Iterates over `.book.md` files and does multiple enhancing operations on them:\n\n            1) Adds Mermaid graph\n            2) Prettifies the markdown\n      "));
+        prettifyCommand.description(spaceTrim__default["default"]("\n            Iterates over `.book.md` files and does multiple enhancing operations on them:\n\n            1) Adds Mermaid graph\n            2) Prettifies the markdown\n        "));
         prettifyCommand.argument('<filesGlob>', 
         // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
         'Pipelines to prettify as glob pattern');
@@ -13192,10 +13246,9 @@
                                             previousConversationSummary: conversationSummary_1,
                                             userMessage: userMessage_1,
                                         };
-                                        return [4 /*yield*/, pipelineExecutor(inputParameters)];
+                                        return [4 /*yield*/, pipelineExecutor(inputParameters).asPromise()];
                                     case 3:
                                         result_1 = _c.sent();
-                                        assertsExecutionSuccessful(result_1);
                                         console.info("\n");
                                         console.info(spaceTrim__default["default"](function (block) { return "\n\n                        ".concat(colors__default["default"].bold(colors__default["default"].green('Chatbot:')), "\n                        ").concat(block(colors__default["default"].green(result_1.outputParameters.chatbotResponse)), "\n\n                    "); }));
                                         ongoingParameters = result_1.outputParameters;
@@ -13242,7 +13295,7 @@
     function $initializeRunCommand(program) {
         var _this = this;
         var runCommand = program.command('run', { isDefault: true });
-        runCommand.description(spaceTrim__default["default"]("\n            Runs a pipeline\n      "));
+        runCommand.description(spaceTrim__default["default"]("\n            Runs a pipeline\n        "));
         // TODO: [🧅] DRY command arguments
         runCommand.argument('[pipelineSource]', 'Path to book file OR URL to book file, if not provided it will be asked');
         runCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
@@ -13252,10 +13305,10 @@
         runCommand.option('-j, --json <json>', "Pass all or some input parameters as JSON record, if used the output is also returned as JSON");
         runCommand.option('-s, --save-report <path>', "Save report to file");
         runCommand.action(function (pipelineSource, options) { return __awaiter(_this, void 0, void 0, function () {
-            var isCacheReloaded, isInteractive, isFormfactorUsed, json, isVerbose, saveReport, inputParameters, prepareAndScrapeOptions, fs, llm, error_1, response_1, executables, tools, pipeline, error_2, pipelineExecutor, questions, response, result, isSuccessful, errors, warnings, outputParameters, executionReport, executionReportString, _a, _b, error, _c, _d, warning, _e, _f, key, value, separator;
-            var _g, e_1, _h, e_2, _j, e_3, _k;
-            return __generator(this, function (_l) {
-                switch (_l.label) {
+            var isCacheReloaded, isInteractive, isFormfactorUsed, json, isVerbose, saveReport, inputParameters, prepareAndScrapeOptions, fs, llm, error_1, response_1, executables, tools, pipeline, error_2, pipelineExecutor, questions, response, executionTask, _a, isSuccessful, errors, warnings, outputParameters, executionReport, usage, executionReportString, _b, _c, error, _d, _e, warning, _f, _g, key, value, separator;
+            var _h, e_1, _j, e_2, _k, e_3, _l;
+            return __generator(this, function (_m) {
+                switch (_m.label) {
                     case 0:
                         isCacheReloaded = options.reload, isInteractive = options.interactive, isFormfactorUsed = options.formfactor, json = options.json, isVerbose = options.verbose, saveReport = options.saveReport;
                         if (saveReport && !saveReport.endsWith('.json') && !saveReport.endsWith('.md')) {
@@ -13275,15 +13328,15 @@
                             console.info(colors__default["default"].gray('--- Preparing tools ---'));
                         }
                         fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                        _l.label = 1;
+                        _m.label = 1;
                     case 1:
-                        _l.trys.push([1, 3, , 7]);
+                        _m.trys.push([1, 3, , 7]);
                         return [4 /*yield*/, $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions)];
                     case 2:
-                        llm = _l.sent();
+                        llm = _m.sent();
                         return [3 /*break*/, 7];
                     case 3:
-                        error_1 = _l.sent();
+                        error_1 = _m.sent();
                         if (!(error_1 instanceof Error)) {
                             throw error_1;
                         }
@@ -13299,7 +13352,7 @@
                             .join('\n')), "\n\n                            ").concat(block($registeredLlmToolsMessage()), "\n                        "); })));
                         return [4 /*yield*/, isFileExisting('.env', fs)];
                     case 4:
-                        if (!!(_l.sent())) return [3 /*break*/, 6];
+                        if (!!(_m.sent())) return [3 /*break*/, 6];
                         return [4 /*yield*/, promises.writeFile(path.join(process.cwd(), '.env'), $llmToolsMetadataRegister
                                 .list()
                                 .flatMap(function (_a) {
@@ -13310,8 +13363,8 @@
                             })
                                 .join('\n'), 'utf8')];
                     case 5:
-                        _l.sent();
-                        _l.label = 6;
+                        _m.sent();
+                        _m.label = 6;
                     case 6: 
                     // TODO: If the cwd is git repository, auto-create .gitignore and add .env to it
                     return [2 /*return*/, process.exit(1)];
@@ -13324,44 +13377,44 @@
                                 validate: function (value) { return (value.length > 0 ? true : 'Pipeline source is required'); },
                             })];
                     case 8:
-                        response_1 = _l.sent();
+                        response_1 = _m.sent();
                         if (!response_1.pipelineSource) {
                             console.error(colors__default["default"].red('Pipeline source is required'));
                             return [2 /*return*/, process.exit(1)];
                         }
                         pipelineSource = response_1.pipelineSource;
-                        _l.label = 9;
+                        _m.label = 9;
                     case 9:
                         if (isVerbose) {
                             console.info(colors__default["default"].gray('--- Getting the tools ---'));
                         }
                         return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
                     case 10:
-                        executables = _l.sent();
-                        _g = {
+                        executables = _m.sent();
+                        _h = {
                             llm: llm,
                             fs: fs,
                             fetch: scraperFetch
                         };
                         return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, prepareAndScrapeOptions)];
                     case 11:
-                        tools = (_g.scrapers = _l.sent(),
-                            _g.script = [
+                        tools = (_h.scrapers = _m.sent(),
+                            _h.script = [
                             /*new JavascriptExecutionTools(options)*/
                             ],
-                            _g);
+                            _h);
                         if (isVerbose) {
                             console.info(colors__default["default"].gray('--- Getting the book ---'));
                         }
-                        _l.label = 12;
+                        _m.label = 12;
                     case 12:
-                        _l.trys.push([12, 14, , 15]);
+                        _m.trys.push([12, 14, , 15]);
                         return [4 /*yield*/, $getCompiledBook(tools, pipelineSource, prepareAndScrapeOptions)];
                     case 13:
-                        pipeline = _l.sent();
+                        pipeline = _m.sent();
                         return [3 /*break*/, 15];
                     case 14:
-                        error_2 = _l.sent();
+                        error_2 = _m.sent();
                         if (!(error_2 instanceof ParseError)) {
                             throw error_2;
                         }
@@ -13454,80 +13507,85 @@
                         }
                         return [4 /*yield*/, prompts__default["default"](questions)];
                     case 16:
-                        response = _l.sent();
+                        response = _m.sent();
                         //                     <- TODO: [🧠][🍼] Change behavior according to the formfactor
                         inputParameters = __assign(__assign({}, inputParameters), response);
                         // TODO: Maybe do some validation of the response (and --json argument which is passed)
                         if (isVerbose) {
                             console.info(colors__default["default"].gray('--- Executing ---'));
                         }
-                        return [4 /*yield*/, pipelineExecutor(inputParameters, function (taskProgress) {
-                                if (isVerbose) {
-                                    console.info(colors__default["default"].gray('--- Progress ---'));
-                                    console.info(taskProgress);
-                                }
-                            })];
+                        return [4 /*yield*/, pipelineExecutor(inputParameters)];
                     case 17:
-                        result = _l.sent();
-                        isSuccessful = result.isSuccessful, errors = result.errors, warnings = result.warnings, outputParameters = result.outputParameters, executionReport = result.executionReport;
+                        executionTask = _m.sent();
+                        if (isVerbose) {
+                            executionTask.asObservable().subscribe(function (progress) {
+                                console.info(colors__default["default"].gray('--- Progress ---'));
+                                console.info(progress);
+                            });
+                        }
+                        return [4 /*yield*/, executionTask.asPromise({
+                                isCrashedOnError: false,
+                            })];
+                    case 18:
+                        _a = _m.sent(), isSuccessful = _a.isSuccessful, errors = _a.errors, warnings = _a.warnings, outputParameters = _a.outputParameters, executionReport = _a.executionReport, usage = _a.usage;
                         if (isVerbose) {
                             console.info(colors__default["default"].gray('--- Detailed Result ---'));
                             console.info({ isSuccessful: isSuccessful, errors: errors, warnings: warnings, outputParameters: outputParameters, executionReport: executionReport });
                         }
-                        if (!(saveReport && saveReport.endsWith('.json'))) return [3 /*break*/, 19];
+                        if (!(saveReport && saveReport.endsWith('.json'))) return [3 /*break*/, 20];
                         return [4 /*yield*/, promises.writeFile(saveReport, JSON.stringify(executionReport, null, 4) + '\n', 'utf-8')];
-                    case 18:
-                        _l.sent();
-                        return [3 /*break*/, 21];
                     case 19:
-                        if (!(saveReport && saveReport.endsWith('.md'))) return [3 /*break*/, 21];
+                        _m.sent();
+                        return [3 /*break*/, 22];
+                    case 20:
+                        if (!(saveReport && saveReport.endsWith('.md'))) return [3 /*break*/, 22];
                         executionReportString = executionReportJsonToString(executionReport);
                         return [4 /*yield*/, promises.writeFile(saveReport, executionReportString, 'utf-8')];
-                    case 20:
-                        _l.sent();
-                        _l.label = 21;
                     case 21:
+                        _m.sent();
+                        _m.label = 22;
+                    case 22:
                         if (saveReport && isVerbose) {
                             console.info(colors__default["default"].green("Report saved to ".concat(saveReport)));
                         }
                         if (isVerbose) {
                             console.info(colors__default["default"].gray('--- Usage ---'));
-                            console.info(colors__default["default"].cyan(usageToHuman(result.usage)));
+                            console.info(colors__default["default"].cyan(usageToHuman(usage)));
                         }
                         if (json === undefined || isVerbose === true) {
                             console.info(colors__default["default"].gray('--- Result ---'));
                         }
                         try {
                             // TODO: [🧠] Should be errors or warnings shown first
-                            for (_a = __values(errors || []), _b = _a.next(); !_b.done; _b = _a.next()) {
-                                error = _b.value;
+                            for (_b = __values(errors || []), _c = _b.next(); !_c.done; _c = _b.next()) {
+                                error = _c.value;
                                 console.error(colors__default["default"].red(colors__default["default"].bold(error.name) + ': ' + error.message));
                             }
                         }
                         catch (e_1_1) { e_1 = { error: e_1_1 }; }
                         finally {
                             try {
-                                if (_b && !_b.done && (_h = _a.return)) _h.call(_a);
+                                if (_c && !_c.done && (_j = _b.return)) _j.call(_b);
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
                         try {
-                            for (_c = __values(warnings || []), _d = _c.next(); !_d.done; _d = _c.next()) {
-                                warning = _d.value;
+                            for (_d = __values(warnings || []), _e = _d.next(); !_e.done; _e = _d.next()) {
+                                warning = _e.value;
                                 console.error(colors__default["default"].red(colors__default["default"].bold(warning.name) + ': ' + warning.message));
                             }
                         }
                         catch (e_2_1) { e_2 = { error: e_2_1 }; }
                         finally {
                             try {
-                                if (_d && !_d.done && (_j = _c.return)) _j.call(_c);
+                                if (_e && !_e.done && (_k = _d.return)) _k.call(_d);
                             }
                             finally { if (e_2) throw e_2.error; }
                         }
                         if (json === undefined) {
                             try {
-                                for (_e = __values(Object.keys(outputParameters)), _f = _e.next(); !_f.done; _f = _e.next()) {
-                                    key = _f.value;
+                                for (_f = __values(Object.keys(outputParameters)), _g = _f.next(); !_g.done; _g = _f.next()) {
+                                    key = _g.value;
                                     value = outputParameters[key] || colors__default["default"].grey(colors__default["default"].italic('(nothing)'));
                                     separator = countLines(value) > 1 || countWords(value) > 100 ? ':\n' : ': ';
                                     console.info(colors__default["default"].green(colors__default["default"].bold(key) + separator + value));
@@ -13536,7 +13594,7 @@
                             catch (e_3_1) { e_3 = { error: e_3_1 }; }
                             finally {
                                 try {
-                                    if (_f && !_f.done && (_k = _e.return)) _k.call(_e);
+                                    if (_g && !_g.done && (_l = _f.return)) _l.call(_f);
                                 }
                                 finally { if (e_3) throw e_3.error; }
                             }
@@ -13687,6 +13745,419 @@
      * Note: This is named "test-command.ts" to avoid name collision with jest unit test files
      */
 
+    /**
+     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
+     *
+     * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
+     * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
+     *
+     * @see https://github.com/webgptorg/promptbook#remote-server
+     * @public exported from `@promptbook/remote-server`
+     */
+    function startRemoteServer(options) {
+        var _this = this;
+        var _a = __assign({ isAnonymousModeAllowed: false, isApplicationModeAllowed: false, collection: null, createLlmExecutionTools: null }, options), port = _a.port, path = _a.path, collection = _a.collection, createLlmExecutionTools = _a.createLlmExecutionTools, isAnonymousModeAllowed = _a.isAnonymousModeAllowed, isApplicationModeAllowed = _a.isApplicationModeAllowed, _b = _a.isVerbose, isVerbose = _b === void 0 ? DEFAULT_IS_VERBOSE : _b;
+        // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
+        var app = express__default["default"]();
+        app.use(express__default["default"].json());
+        app.get('/', function (request, response) { return __awaiter(_this, void 0, void 0, function () {
+            var _a, _b;
+            var _this = this;
+            var _c;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        if ((_c = request.url) === null || _c === void 0 ? void 0 : _c.includes('socket.io')) {
+                            return [2 /*return*/];
+                        }
+                        _b = (_a = response).send;
+                        // TODO: !!!!!! Make this either valid html or text - http://localhost:4460/
+                        return [4 /*yield*/, spaceTrim.spaceTrim(function (block) { return __awaiter(_this, void 0, void 0, function () {
+                                var _a, _b, _c, _d, _e;
+                                return __generator(this, function (_f) {
+                                    switch (_f.label) {
+                                        case 0:
+                                            _b = (_a = "\n                    Server for processing promptbook remote requests is running.\n\n                    Version: ".concat(PROMPTBOOK_ENGINE_VERSION, "\n                    Socket.io path: ").concat(path, "/socket.io\n                    Anonymouse mode: ").concat(isAnonymousModeAllowed ? 'enabled' : 'disabled', "\n                    Application mode: ").concat(isApplicationModeAllowed ? 'enabled' : 'disabled', "\n                    ")).concat;
+                                            _c = block;
+                                            if (!(!isApplicationModeAllowed || collection === null)) return [3 /*break*/, 1];
+                                            _d = '';
+                                            return [3 /*break*/, 3];
+                                        case 1:
+                                            _e = 'Pipelines in collection:\n';
+                                            return [4 /*yield*/, collection.listPipelines()];
+                                        case 2:
+                                            _d = _e +
+                                                (_f.sent())
+                                                    .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
+                                                    .join('\n');
+                                            _f.label = 3;
+                                        case 3: return [2 /*return*/, _b.apply(_a, [_c.apply(void 0, [_d]), "\n\n                    For more information look at:\n                    https://github.com/webgptorg/promptbook\n            "])];
+                                    }
+                                });
+                            }); })];
+                    case 1:
+                        _b.apply(_a, [
+                            // TODO: !!!!!! Make this either valid html or text - http://localhost:4460/
+                            _d.sent()]);
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        var runningExecutionTasks = [];
+        // TODO: !!!!!! Do here some garbage collection of finished tasks
+        app.get('/executions', function (request, response) { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                response.send(runningExecutionTasks);
+                return [2 /*return*/];
+            });
+        }); });
+        app.get('/executions/:taskId', function (request, response) { return __awaiter(_this, void 0, void 0, function () {
+            var taskId, execution;
+            return __generator(this, function (_a) {
+                taskId = request.query.taskId;
+                execution = runningExecutionTasks.find(function (executionTask) { return executionTask.taskId === taskId; });
+                if (execution === undefined) {
+                    response.status(404).send("Execution \"".concat(taskId, "\" not found"));
+                    return [2 /*return*/];
+                }
+                response.send(execution);
+                return [2 /*return*/];
+            });
+        }); });
+        app.post('/executions/new', function (request, response) { return __awaiter(_this, void 0, void 0, function () {
+            var _a, pipelineUrl, inputParameters, pipeline, llm, fs, executables, tools, pipelineExecutor, executionTask;
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        _a = request.body, pipelineUrl = _a.pipelineUrl, inputParameters = _a.inputParameters;
+                        return [4 /*yield*/, (collection === null || collection === void 0 ? void 0 : collection.getPipelineByUrl(pipelineUrl))];
+                    case 1:
+                        pipeline = _c.sent();
+                        if (pipeline === undefined) {
+                            response.status(404).send("Pipeline \"".concat(pipelineUrl, "\" not found"));
+                            return [2 /*return*/];
+                        }
+                        return [4 /*yield*/, createLlmExecutionTools({
+                                appId: '!!!!',
+                                userId: '!!!!',
+                                customOptions: {},
+                            })];
+                    case 2:
+                        llm = _c.sent();
+                        fs = $provideFilesystemForNode();
+                        return [4 /*yield*/, $provideExecutablesForNode()];
+                    case 3:
+                        executables = _c.sent();
+                        _b = {
+                            llm: llm,
+                            fs: fs
+                        };
+                        return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables })];
+                    case 4:
+                        tools = (_b.scrapers = _c.sent(),
+                            _b);
+                        pipelineExecutor = createPipelineExecutor(__assign({ pipeline: pipeline, tools: tools }, options));
+                        executionTask = pipelineExecutor(inputParameters);
+                        runningExecutionTasks.push(executionTask);
+                        response.send(executionTask);
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        var httpServer = http__default["default"].createServer(app);
+        var server = new socket_io.Server(httpServer, {
+            path: path,
+            transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+            cors: {
+                origin: '*',
+                methods: ['GET', 'POST'],
+            },
+        });
+        server.on('connection', function (socket) {
+            if (isVerbose) {
+                console.info(colors__default["default"].gray("Client connected"), socket.id);
+            }
+            var getExecutionToolsFromIdentification = function (identification) { return __awaiter(_this, void 0, void 0, function () {
+                var isAnonymous, llm, llmToolsConfiguration, appId, userId, customOptions, fs, executables, tools;
+                var _a;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            isAnonymous = identification.isAnonymous;
+                            if (isAnonymous === true && !isAnonymousModeAllowed) {
+                                throw new PipelineExecutionError("Anonymous mode is not allowed"); // <- TODO: [main] !!3 Test
+                            }
+                            if (isAnonymous === false && !isApplicationModeAllowed) {
+                                throw new PipelineExecutionError("Application mode is not allowed"); // <- TODO: [main] !!3 Test
+                            }
+                            if (!(isAnonymous === true)) return [3 /*break*/, 1];
+                            llmToolsConfiguration = identification.llmToolsConfiguration;
+                            llm = createLlmToolsFromConfiguration(llmToolsConfiguration, { isVerbose: isVerbose });
+                            return [3 /*break*/, 4];
+                        case 1:
+                            if (!(isAnonymous === false && createLlmExecutionTools !== null)) return [3 /*break*/, 3];
+                            appId = identification.appId, userId = identification.userId, customOptions = identification.customOptions;
+                            return [4 /*yield*/, createLlmExecutionTools({
+                                    appId: appId,
+                                    userId: userId,
+                                    customOptions: customOptions,
+                                })];
+                        case 2:
+                            llm = _b.sent();
+                            return [3 /*break*/, 4];
+                        case 3: throw new PipelineExecutionError("You must provide either llmToolsConfiguration or non-anonymous mode must be propperly configured");
+                        case 4:
+                            fs = $provideFilesystemForNode();
+                            return [4 /*yield*/, $provideExecutablesForNode()];
+                        case 5:
+                            executables = _b.sent();
+                            _a = {
+                                llm: llm,
+                                fs: fs
+                            };
+                            return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables })];
+                        case 6:
+                            tools = (_a.scrapers = _b.sent(),
+                                _a);
+                            return [2 /*return*/, tools];
+                    }
+                });
+            }); };
+            // -----------
+            socket.on('prompt-request', function (request) { return __awaiter(_this, void 0, void 0, function () {
+                var identification, prompt, executionTools, llm, _a, promptResult, _b, error_1;
+                return __generator(this, function (_c) {
+                    switch (_c.label) {
+                        case 0:
+                            identification = request.identification, prompt = request.prompt;
+                            if (isVerbose) {
+                                console.info(colors__default["default"].bgWhite("Prompt:"), colors__default["default"].gray(JSON.stringify(request, null, 4)));
+                            }
+                            _c.label = 1;
+                        case 1:
+                            _c.trys.push([1, 13, 14, 15]);
+                            return [4 /*yield*/, getExecutionToolsFromIdentification(identification)];
+                        case 2:
+                            executionTools = _c.sent();
+                            llm = executionTools.llm;
+                            _a = identification.isAnonymous === false &&
+                                collection !== null;
+                            if (!_a) return [3 /*break*/, 4];
+                            return [4 /*yield*/, collection.isResponsibleForPrompt(prompt)];
+                        case 3:
+                            _a = !(_c.sent());
+                            _c.label = 4;
+                        case 4:
+                            if (_a) {
+                                throw new PipelineExecutionError("Pipeline is not in the collection of this server");
+                            }
+                            promptResult = void 0;
+                            _b = prompt.modelRequirements.modelVariant;
+                            switch (_b) {
+                                case 'CHAT': return [3 /*break*/, 5];
+                                case 'COMPLETION': return [3 /*break*/, 7];
+                                case 'EMBEDDING': return [3 /*break*/, 9];
+                            }
+                            return [3 /*break*/, 11];
+                        case 5:
+                            if (llm.callChatModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Chat model is not available");
+                            }
+                            return [4 /*yield*/, llm.callChatModel(prompt)];
+                        case 6:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 12];
+                        case 7:
+                            if (llm.callCompletionModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Completion model is not available");
+                            }
+                            return [4 /*yield*/, llm.callCompletionModel(prompt)];
+                        case 8:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 12];
+                        case 9:
+                            if (llm.callEmbeddingModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Embedding model is not available");
+                            }
+                            return [4 /*yield*/, llm.callEmbeddingModel(prompt)];
+                        case 10:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 12];
+                        case 11: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
+                        case 12:
+                            if (isVerbose) {
+                                console.info(colors__default["default"].bgGreen("PromptResult:"), colors__default["default"].green(JSON.stringify(promptResult, null, 4)));
+                            }
+                            socket.emit('prompt-response', { promptResult: promptResult } /* <- Note: [🤛] */);
+                            return [3 /*break*/, 15];
+                        case 13:
+                            error_1 = _c.sent();
+                            if (!(error_1 instanceof Error)) {
+                                throw error_1;
+                            }
+                            socket.emit('error', serializeError(error_1) /* <- Note: [🤛] */);
+                            return [3 /*break*/, 15];
+                        case 14:
+                            socket.disconnect();
+                            return [7 /*endfinally*/];
+                        case 15: return [2 /*return*/];
+                    }
+                });
+            }); });
+            // -----------
+            // TODO: [👒] Listing models (and checking configuration) probbably should go through REST API not Socket.io
+            socket.on('listModels-request', function (request) { return __awaiter(_this, void 0, void 0, function () {
+                var identification, executionTools, llm, models, error_2;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            identification = request.identification;
+                            if (isVerbose) {
+                                console.info(colors__default["default"].bgWhite("Listing models"));
+                            }
+                            _a.label = 1;
+                        case 1:
+                            _a.trys.push([1, 4, 5, 6]);
+                            return [4 /*yield*/, getExecutionToolsFromIdentification(identification)];
+                        case 2:
+                            executionTools = _a.sent();
+                            llm = executionTools.llm;
+                            return [4 /*yield*/, llm.listModels()];
+                        case 3:
+                            models = _a.sent();
+                            socket.emit('listModels-response', { models: models } /* <- Note: [🤛] */);
+                            return [3 /*break*/, 6];
+                        case 4:
+                            error_2 = _a.sent();
+                            if (!(error_2 instanceof Error)) {
+                                throw error_2;
+                            }
+                            socket.emit('error', serializeError(error_2));
+                            return [3 /*break*/, 6];
+                        case 5:
+                            socket.disconnect();
+                            return [7 /*endfinally*/];
+                        case 6: return [2 /*return*/];
+                    }
+                });
+            }); });
+            // -----------
+            // TODO: [👒] Listing models (and checking configuration) probbably should go through REST API not Socket.io
+            socket.on('preparePipeline-request', function (request) { return __awaiter(_this, void 0, void 0, function () {
+                var identification, pipeline, executionTools, preparedPipeline, error_3;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            identification = request.identification, pipeline = request.pipeline;
+                            if (isVerbose) {
+                                console.info(colors__default["default"].bgWhite("Prepare pipeline"));
+                            }
+                            _a.label = 1;
+                        case 1:
+                            _a.trys.push([1, 4, 5, 6]);
+                            return [4 /*yield*/, getExecutionToolsFromIdentification(identification)];
+                        case 2:
+                            executionTools = _a.sent();
+                            return [4 /*yield*/, preparePipeline(pipeline, executionTools, options)];
+                        case 3:
+                            preparedPipeline = _a.sent();
+                            socket.emit('preparePipeline-response', { preparedPipeline: preparedPipeline } /* <- Note: [🤛] */);
+                            return [3 /*break*/, 6];
+                        case 4:
+                            error_3 = _a.sent();
+                            if (!(error_3 instanceof Error)) {
+                                throw error_3;
+                            }
+                            socket.emit('error', serializeError(error_3));
+                            return [3 /*break*/, 6];
+                        case 5:
+                            socket.disconnect();
+                            return [7 /*endfinally*/];
+                        case 6: return [2 /*return*/];
+                    }
+                });
+            }); });
+            // -----------
+            socket.on('disconnect', function () {
+                // TODO: Destroy here executionToolsForClient
+                if (isVerbose) {
+                    console.info(colors__default["default"].gray("Client disconnected"), socket.id);
+                }
+            });
+        });
+        httpServer.listen(port);
+        // Note: We want to log this also in non-verbose mode
+        console.info(colors__default["default"].bgGreen("PROMPTBOOK server listening on port ".concat(port)));
+        if (isVerbose) {
+            console.info(colors__default["default"].gray("Verbose mode is enabled"));
+        }
+        var isDestroyed = false;
+        return {
+            get isDestroyed() {
+                return isDestroyed;
+            },
+            destroy: function () {
+                if (isDestroyed) {
+                    return;
+                }
+                isDestroyed = true;
+                httpServer.close();
+                server.close();
+            },
+        };
+    }
+    /**
+     * TODO: [👩🏾‍🤝‍🧑🏾] Allow to pass custom fetch function here - PromptbookFetch
+     * TODO: Split this file into multiple functions - handler for each request
+     * TODO: Maybe use `$exportJson`
+     * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
+     * TODO: [⚖] Expose the collection to be able to connect to same collection via createCollectionFromUrl
+     * TODO: Handle progress - support streaming
+     * TODO: [🗯] Do not hang up immediately but wait until client closes OR timeout
+     * TODO: [🗯] Timeout on chat to free up resources
+     * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
+     * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
+     * TODO: Allow to constrain anonymous mode for specific models / providers
+     */
+
+    /**
+     * Initializes `start-server` command for Promptbook CLI utilities
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+     *
+     * @private internal function of `promptbookCli`
+     */
+    function $initializeStartServerCommand(program) {
+        var _this = this;
+        var startServerCommand = program.command('start-server');
+        startServerCommand.option('--port <port>', "Port to start the server on", '4460');
+        startServerCommand.description(spaceTrim__default["default"]("\n            @@@\n        "));
+        startServerCommand.action(function (_a) {
+            var port = _a.port;
+            return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_b) {
+                    startRemoteServer({
+                        path: '/promptbook',
+                        port: parseInt(port, 10),
+                        isAnonymousModeAllowed: true,
+                        isApplicationModeAllowed: true,
+                        // <- TODO: !!!!!!
+                    });
+                    console.error(colors__default["default"].green("Server started on port ".concat(port)));
+                    return [2 /*return*/];
+                });
+            });
+        });
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+     */
+
     /**
      * Runs CLI utilities of Promptbook package
      *
@@ -13717,6 +14188,7 @@
                 $initializeTestCommand(program);
                 $initializeListModelsCommand(program);
                 $initializeListScrapersCommand(program);
+                $initializeStartServerCommand(program);
                 program.parse(process.argv);
                 return [2 /*return*/];
             });
@@ -16602,10 +17074,9 @@
                             return [4 /*yield*/, source.asText()];
                         case 4:
                             knowledgeContent = _k.sent();
-                            return [4 /*yield*/, prepareKnowledgeFromMarkdownExecutor({ knowledgeContent: knowledgeContent })];
+                            return [4 /*yield*/, prepareKnowledgeFromMarkdownExecutor({ knowledgeContent: knowledgeContent }).asPromise()];
                         case 5:
                             result = _k.sent();
-                            assertsExecutionSuccessful(result);
                             outputParameters = result.outputParameters;
                             knowledgePiecesRaw = outputParameters.knowledgePieces;
                             knowledgeTextPieces = (knowledgePiecesRaw || '').split('\n---\n');
@@ -16628,13 +17099,13 @@
                                                 _c.label = 1;
                                             case 1:
                                                 _c.trys.push([1, 7, , 8]);
-                                                return [4 /*yield*/, prepareTitleExecutor({ knowledgePieceContent: knowledgePieceContent })];
+                                                return [4 /*yield*/, prepareTitleExecutor({ knowledgePieceContent: knowledgePieceContent }).asPromise()];
                                             case 2:
                                                 titleResult = _c.sent();
                                                 _a = titleResult.outputParameters.title, titleRaw = _a === void 0 ? 'Untitled' : _a;
                                                 title = spaceTrim__default["default"](titleRaw) /* <- TODO: Maybe do in pipeline */;
                                                 name = titleToName(title);
-                                                return [4 /*yield*/, prepareKeywordsExecutor({ knowledgePieceContent: knowledgePieceContent })];
+                                                return [4 /*yield*/, prepareKeywordsExecutor({ knowledgePieceContent: knowledgePieceContent }).asPromise()];
                                             case 3:
                                                 keywordsResult = _c.sent();
                                                 _b = keywordsResult.outputParameters.keywords, keywordsRaw = _b === void 0 ? '' : _b;