@promptbook/remote-client 0.82.0-0 → 0.82.0-3

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto-js'), require('crypto-js/enc-hex'), require('papaparse'), require('path'), require('socket.io-client')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto-js', 'crypto-js/enc-hex', 'papaparse', 'path', 'socket.io-client'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-client"] = {}, global.spaceTrim, global.cryptoJs, global.hexEncoder, global.papaparse, global.path, global.socket_ioClient));
-})(this, (function (exports, spaceTrim, cryptoJs, hexEncoder, papaparse, path, socket_ioClient) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('socket.io-client'), require('crypto-js'), require('crypto-js/enc-hex'), require('papaparse'), require('path')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'socket.io-client', 'crypto-js', 'crypto-js/enc-hex', 'papaparse', 'path'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-client"] = {}, global.spaceTrim, global.socket_ioClient, global.cryptoJs, global.hexEncoder, global.papaparse, global.path));
+})(this, (function (exports, spaceTrim, socket_ioClient, cryptoJs, hexEncoder, papaparse, path) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.81.0-23';
+    var PROMPTBOOK_ENGINE_VERSION = '0.82.0-2';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -149,24 +149,155 @@
     }
 
     /**
-     * Prepare pipeline on remote server
+     * This error indicates problems parsing the format value
      *
-     * @see https://github.com/webgptorg/promptbook/discussions/196
+     * For example, when the format value is not a valid JSON or CSV
+     * This is not thrown directly but in extended classes
      *
-     * Note: This function does not validate logic of the pipeline
-     * Note: This function acts as part of compilation process
-     * Note: When the pipeline is already prepared, it returns the same pipeline
+     * @public exported from `@promptbook/core`
+     */
+    var AbstractFormatError = /** @class */ (function (_super) {
+        __extends(AbstractFormatError, _super);
+        // Note: To allow instanceof do not put here error `name`
+        // public readonly name = 'AbstractFormatError';
+        function AbstractFormatError(message) {
+            var _this = _super.call(this, message) || this;
+            Object.setPrototypeOf(_this, AbstractFormatError.prototype);
+            return _this;
+        }
+        return AbstractFormatError;
+    }(Error));
+
+    /**
+     * This error indicates problem with parsing of CSV
      *
-     * @public exported from `@promptbook/remote-client`
+     * @public exported from `@promptbook/core`
      */
-    function preparePipelineOnRemoteServer(pipeline, options) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                // TODO: !!!!!!  do $exportJson
-                return [2 /*return*/, pipeline];
-            });
-        });
-    }
+    var CsvFormatError = /** @class */ (function (_super) {
+        __extends(CsvFormatError, _super);
+        function CsvFormatError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'CsvFormatError';
+            Object.setPrototypeOf(_this, CsvFormatError.prototype);
+            return _this;
+        }
+        return CsvFormatError;
+    }(AbstractFormatError));
+
+    /**
+     * This error indicates that the pipeline collection cannot be propperly loaded
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var CollectionError = /** @class */ (function (_super) {
+        __extends(CollectionError, _super);
+        function CollectionError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'CollectionError';
+            Object.setPrototypeOf(_this, CollectionError.prototype);
+            return _this;
+        }
+        return CollectionError;
+    }(Error));
+
+    /**
+     * This error type indicates that you try to use a feature that is not available in the current environment
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var EnvironmentMismatchError = /** @class */ (function (_super) {
+        __extends(EnvironmentMismatchError, _super);
+        function EnvironmentMismatchError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'EnvironmentMismatchError';
+            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+            return _this;
+        }
+        return EnvironmentMismatchError;
+    }(Error));
+
+    /**
+     * This error occurs when some expectation is not met in the execution of the pipeline
+     *
+     * @public exported from `@promptbook/core`
+     * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
+     * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
+     * Note: This is a kindof subtype of PipelineExecutionError
+     */
+    var ExpectError = /** @class */ (function (_super) {
+        __extends(ExpectError, _super);
+        function ExpectError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'ExpectError';
+            Object.setPrototypeOf(_this, ExpectError.prototype);
+            return _this;
+        }
+        return ExpectError;
+    }(Error));
+
+    /**
+     * This error indicates that the promptbook can not retrieve knowledge from external sources
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var KnowledgeScrapeError = /** @class */ (function (_super) {
+        __extends(KnowledgeScrapeError, _super);
+        function KnowledgeScrapeError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'KnowledgeScrapeError';
+            Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
+            return _this;
+        }
+        return KnowledgeScrapeError;
+    }(Error));
+
+    /**
+     * This error type indicates that some limit was reached
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var LimitReachedError = /** @class */ (function (_super) {
+        __extends(LimitReachedError, _super);
+        function LimitReachedError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'LimitReachedError';
+            Object.setPrototypeOf(_this, LimitReachedError.prototype);
+            return _this;
+        }
+        return LimitReachedError;
+    }(Error));
+
+    /**
+     * This error type indicates that some tools are missing for pipeline execution or preparation
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var MissingToolsError = /** @class */ (function (_super) {
+        __extends(MissingToolsError, _super);
+        function MissingToolsError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation\n\n                "); })) || this;
+            _this.name = 'MissingToolsError';
+            Object.setPrototypeOf(_this, MissingToolsError.prototype);
+            return _this;
+        }
+        return MissingToolsError;
+    }(Error));
+
+    /**
+     * This error indicates that promptbook not found in the collection
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var NotFoundError = /** @class */ (function (_super) {
+        __extends(NotFoundError, _super);
+        function NotFoundError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'NotFoundError';
+            Object.setPrototypeOf(_this, NotFoundError.prototype);
+            return _this;
+        }
+        return NotFoundError;
+    }(Error));
 
     /**
      * This error type indicates that some part of the code is not implemented yet
@@ -203,6 +334,54 @@
      * TODO: Maybe split `ParseError` and `ApplyError`
      */
 
+    /**
+     * This error indicates errors during the execution of the pipeline
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PipelineExecutionError = /** @class */ (function (_super) {
+        __extends(PipelineExecutionError, _super);
+        function PipelineExecutionError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PipelineExecutionError';
+            Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
+            return _this;
+        }
+        return PipelineExecutionError;
+    }(Error));
+
+    /**
+     * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PipelineLogicError = /** @class */ (function (_super) {
+        __extends(PipelineLogicError, _super);
+        function PipelineLogicError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PipelineLogicError';
+            Object.setPrototypeOf(_this, PipelineLogicError.prototype);
+            return _this;
+        }
+        return PipelineLogicError;
+    }(Error));
+
+    /**
+     * This error indicates errors in referencing promptbooks between each other
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PipelineUrlError = /** @class */ (function (_super) {
+        __extends(PipelineUrlError, _super);
+        function PipelineUrlError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'PipelineUrlError';
+            Object.setPrototypeOf(_this, PipelineUrlError.prototype);
+            return _this;
+        }
+        return PipelineUrlError;
+    }(Error));
+
     /**
      * Returns the same value that is passed as argument.
      * No side effects.
@@ -249,6 +428,12 @@
      * @public exported from `@promptbook/core`
      */
     var DEFAULT_BOOK_TITLE = "\u2728 Untitled Book";
+    /**
+     * When the title of task is not provided, the default title is used
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var DEFAULT_TASK_TITLE = "Task";
     /**
      * Timeout for the connections in milliseconds
      *
@@ -313,6 +498,161 @@
         return UnexpectedError;
     }(Error));
 
+    /**
+     * Index of all custom errors
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PROMPTBOOK_ERRORS = {
+        AbstractFormatError: AbstractFormatError,
+        CsvFormatError: CsvFormatError,
+        CollectionError: CollectionError,
+        EnvironmentMismatchError: EnvironmentMismatchError,
+        ExpectError: ExpectError,
+        KnowledgeScrapeError: KnowledgeScrapeError,
+        LimitReachedError: LimitReachedError,
+        MissingToolsError: MissingToolsError,
+        NotFoundError: NotFoundError,
+        NotYetImplementedError: NotYetImplementedError,
+        ParseError: ParseError,
+        PipelineExecutionError: PipelineExecutionError,
+        PipelineLogicError: PipelineLogicError,
+        PipelineUrlError: PipelineUrlError,
+        UnexpectedError: UnexpectedError,
+        // TODO: [🪑]> VersionMismatchError,
+    };
+    /**
+     * Index of all javascript errors
+     *
+     * @private for internal usage
+     */
+    var COMMON_JAVASCRIPT_ERRORS = {
+        Error: Error,
+        EvalError: EvalError,
+        RangeError: RangeError,
+        ReferenceError: ReferenceError,
+        SyntaxError: SyntaxError,
+        TypeError: TypeError,
+        URIError: URIError,
+        AggregateError: AggregateError,
+        /*
+      Note: Not widely supported
+      > InternalError,
+      > ModuleError,
+      > HeapError,
+      > WebAssemblyCompileError,
+      > WebAssemblyRuntimeError,
+      */
+    };
+    /**
+     * Index of all errors
+     *
+     * @private for internal usage
+     */
+    var ALL_ERRORS = __assign(__assign({}, PROMPTBOOK_ERRORS), COMMON_JAVASCRIPT_ERRORS);
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * Deserializes the error object
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function deserializeError(error) {
+        var name = error.name, stack = error.stack;
+        var message = error.message;
+        var ErrorClass = ALL_ERRORS[error.name];
+        if (ErrorClass === undefined) {
+            ErrorClass = Error;
+            message = "".concat(name, ": ").concat(message);
+        }
+        if (stack !== undefined && stack !== '') {
+            message = spaceTrim__default["default"](function (block) { return "\n                ".concat(block(message), "\n\n                Original stack trace:\n                ").concat(block(stack || ''), "\n            "); });
+        }
+        return new ErrorClass(message);
+    }
+
+    /**
+     * Creates a connection to the remote proxy server.
+     *
+     * Note: This function creates a connection to the remote server and returns a socket but responsibility of closing the connection is on the caller
+     *
+     * @private internal utility function
+     */
+    function createRemoteClient(options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var remoteUrl, path;
+            return __generator(this, function (_a) {
+                remoteUrl = options.remoteUrl, path = options.path;
+                return [2 /*return*/, new Promise(function (resolve, reject) {
+                        var socket = socket_ioClient.io(remoteUrl, {
+                            retries: CONNECTION_RETRIES_LIMIT,
+                            timeout: CONNECTION_TIMEOUT_MS,
+                            path: path,
+                            // path: `${this.remoteUrl.pathname}/socket.io`,
+                            transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+                        });
+                        // console.log('Connecting to', this.options.remoteUrl.href, { socket });
+                        socket.on('connect', function () {
+                            resolve(socket);
+                        });
+                        // TODO: [💩] Better timeout handling
+                        setTimeout(function () {
+                            reject(new Error("Timeout while connecting to ".concat(remoteUrl)));
+                        }, CONNECTION_TIMEOUT_MS);
+                    })];
+            });
+        });
+    }
+
+    /**
+     * Prepare pipeline on remote server
+     *
+     * @see https://github.com/webgptorg/promptbook/discussions/196
+     *
+     * Note: This function does not validate logic of the pipeline
+     * Note: This function acts as part of compilation process
+     * Note: When the pipeline is already prepared, it returns the same pipeline
+     *
+     * @public exported from `@promptbook/remote-client`
+     */
+    function preparePipelineOnRemoteServer(pipeline, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var socket, preparedPipeline;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        return [4 /*yield*/, createRemoteClient(options)];
+                    case 1:
+                        socket = _a.sent();
+                        socket.emit('preparePipeline-request', {
+                            identification: options.identification,
+                            pipeline: pipeline,
+                        } /* <- Note: [🤛] */);
+                        return [4 /*yield*/, new Promise(function (resolve, reject) {
+                                socket.on('preparePipeline-response', function (response) {
+                                    resolve(response.preparedPipeline);
+                                    socket.disconnect();
+                                });
+                                socket.on('error', function (error) {
+                                    reject(deserializeError(error));
+                                    socket.disconnect();
+                                });
+                            })];
+                    case 2:
+                        preparedPipeline = _a.sent();
+                        socket.disconnect();
+                        // TODO: !!!!!!  do $exportJson
+                        return [2 /*return*/, preparedPipeline];
+                }
+            });
+        });
+    }
+    /**
+     * TODO: !!!! Do not return Promise<PipelineJson> But PreparePipelineTask
+     */
+
     /**
      * All available task types
      *
@@ -1463,61 +1803,25 @@
                     throw new ParseError("Already defined maximum ".concat($taskJson.expectations[unit].max, " ").concat(command.unit.toLowerCase(), ", now trying to redefine it to ").concat(command.amount));
                 }
                 $taskJson.expectations[unit].max = command.amount;
-            }
-        },
-        /**
-         * Converts the FORMAT command back to string
-         *
-         * Note: This is used in `pipelineJsonToString` utility
-         */
-        stringify: function (command) {
-            return "---"; // <- TODO: [🛋] Implement
-        },
-        /**
-         * Reads the FORMAT command from the `TaskJson`
-         *
-         * Note: This is used in `pipelineJsonToString` utility
-         */
-        takeFromTaskJson: function ($taskJson) {
-            throw new NotYetImplementedError("[\uD83D\uDECB] Not implemented yet"); // <- TODO: [🛋] Implement
-        },
-    };
-
-    /**
-     * This error indicates problems parsing the format value
-     *
-     * For example, when the format value is not a valid JSON or CSV
-     * This is not thrown directly but in extended classes
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var AbstractFormatError = /** @class */ (function (_super) {
-        __extends(AbstractFormatError, _super);
-        // Note: To allow instanceof do not put here error `name`
-        // public readonly name = 'AbstractFormatError';
-        function AbstractFormatError(message) {
-            var _this = _super.call(this, message) || this;
-            Object.setPrototypeOf(_this, AbstractFormatError.prototype);
-            return _this;
-        }
-        return AbstractFormatError;
-    }(Error));
-
-    /**
-     * This error indicates problem with parsing of CSV
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var CsvFormatError = /** @class */ (function (_super) {
-        __extends(CsvFormatError, _super);
-        function CsvFormatError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'CsvFormatError';
-            Object.setPrototypeOf(_this, CsvFormatError.prototype);
-            return _this;
-        }
-        return CsvFormatError;
-    }(AbstractFormatError));
+            }
+        },
+        /**
+         * Converts the FORMAT command back to string
+         *
+         * Note: This is used in `pipelineJsonToString` utility
+         */
+        stringify: function (command) {
+            return "---"; // <- TODO: [🛋] Implement
+        },
+        /**
+         * Reads the FORMAT command from the `TaskJson`
+         *
+         * Note: This is used in `pipelineJsonToString` utility
+         */
+        takeFromTaskJson: function ($taskJson) {
+            throw new NotYetImplementedError("[\uD83D\uDECB] Not implemented yet"); // <- TODO: [🛋] Implement
+        },
+    };
 
     /**
      * @@@
@@ -4969,8 +5273,8 @@
                 isSectionTypeSet: false,
                 isTask: true,
                 taskType: undefined /* <- Note: [🍙] Putting here placeholder to keep `taskType` on top at final JSON */,
-                name: getUniqueSectionName(section.title),
-                title: section.title,
+                name: getUniqueSectionName(section.title || DEFAULT_TASK_TITLE),
+                title: section.title || DEFAULT_TASK_TITLE,
                 description: description_1,
                 content: content,
                 // <- TODO: [🍙] Some standard order of properties
@@ -5238,7 +5542,7 @@
      * Note: This function acts as compilation process
      *
      * @param pipelineString {Promptbook} in string markdown format (.book.md)
-     * @param options - Options for remote server compilation
+     * @param options - Configuration of the remote server
      * @returns {Promptbook} compiled in JSON format (.book.json)
      * @throws {ParseError} if the promptbook string is not valid
      * @public exported from `@promptbook/remote-client`
@@ -5250,7 +5554,7 @@
                 switch (_a.label) {
                     case 0:
                         pipelineJson = parsePipeline(pipelineString);
-                        return [4 /*yield*/, preparePipelineOnRemoteServer(pipelineJson)];
+                        return [4 /*yield*/, preparePipelineOnRemoteServer(pipelineJson, options)];
                     case 1:
                         pipelineJson = _a.sent();
                         // Note: No need to use `$exportJson` because `parsePipeline` and `preparePipeline` already do that
@@ -5259,238 +5563,9 @@
             });
         });
     }
-
-    /**
-     * This error indicates that the pipeline collection cannot be propperly loaded
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var CollectionError = /** @class */ (function (_super) {
-        __extends(CollectionError, _super);
-        function CollectionError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'CollectionError';
-            Object.setPrototypeOf(_this, CollectionError.prototype);
-            return _this;
-        }
-        return CollectionError;
-    }(Error));
-
-    /**
-     * This error type indicates that you try to use a feature that is not available in the current environment
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var EnvironmentMismatchError = /** @class */ (function (_super) {
-        __extends(EnvironmentMismatchError, _super);
-        function EnvironmentMismatchError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'EnvironmentMismatchError';
-            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
-            return _this;
-        }
-        return EnvironmentMismatchError;
-    }(Error));
-
-    /**
-     * This error occurs when some expectation is not met in the execution of the pipeline
-     *
-     * @public exported from `@promptbook/core`
-     * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
-     * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
-     * Note: This is a kindof subtype of PipelineExecutionError
-     */
-    var ExpectError = /** @class */ (function (_super) {
-        __extends(ExpectError, _super);
-        function ExpectError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'ExpectError';
-            Object.setPrototypeOf(_this, ExpectError.prototype);
-            return _this;
-        }
-        return ExpectError;
-    }(Error));
-
-    /**
-     * This error indicates that the promptbook can not retrieve knowledge from external sources
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var KnowledgeScrapeError = /** @class */ (function (_super) {
-        __extends(KnowledgeScrapeError, _super);
-        function KnowledgeScrapeError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'KnowledgeScrapeError';
-            Object.setPrototypeOf(_this, KnowledgeScrapeError.prototype);
-            return _this;
-        }
-        return KnowledgeScrapeError;
-    }(Error));
-
-    /**
-     * This error type indicates that some limit was reached
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var LimitReachedError = /** @class */ (function (_super) {
-        __extends(LimitReachedError, _super);
-        function LimitReachedError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'LimitReachedError';
-            Object.setPrototypeOf(_this, LimitReachedError.prototype);
-            return _this;
-        }
-        return LimitReachedError;
-    }(Error));
-
-    /**
-     * This error type indicates that some tools are missing for pipeline execution or preparation
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var MissingToolsError = /** @class */ (function (_super) {
-        __extends(MissingToolsError, _super);
-        function MissingToolsError(message) {
-            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation\n\n                "); })) || this;
-            _this.name = 'MissingToolsError';
-            Object.setPrototypeOf(_this, MissingToolsError.prototype);
-            return _this;
-        }
-        return MissingToolsError;
-    }(Error));
-
-    /**
-     * This error indicates that promptbook not found in the collection
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var NotFoundError = /** @class */ (function (_super) {
-        __extends(NotFoundError, _super);
-        function NotFoundError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'NotFoundError';
-            Object.setPrototypeOf(_this, NotFoundError.prototype);
-            return _this;
-        }
-        return NotFoundError;
-    }(Error));
-
-    /**
-     * This error indicates errors during the execution of the pipeline
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var PipelineExecutionError = /** @class */ (function (_super) {
-        __extends(PipelineExecutionError, _super);
-        function PipelineExecutionError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PipelineExecutionError';
-            Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
-            return _this;
-        }
-        return PipelineExecutionError;
-    }(Error));
-
-    /**
-     * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var PipelineLogicError = /** @class */ (function (_super) {
-        __extends(PipelineLogicError, _super);
-        function PipelineLogicError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PipelineLogicError';
-            Object.setPrototypeOf(_this, PipelineLogicError.prototype);
-            return _this;
-        }
-        return PipelineLogicError;
-    }(Error));
-
-    /**
-     * This error indicates errors in referencing promptbooks between each other
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var PipelineUrlError = /** @class */ (function (_super) {
-        __extends(PipelineUrlError, _super);
-        function PipelineUrlError(message) {
-            var _this = _super.call(this, message) || this;
-            _this.name = 'PipelineUrlError';
-            Object.setPrototypeOf(_this, PipelineUrlError.prototype);
-            return _this;
-        }
-        return PipelineUrlError;
-    }(Error));
-
-    /**
-     * Index of all custom errors
-     *
-     * @public exported from `@promptbook/core`
-     */
-    var PROMPTBOOK_ERRORS = {
-        AbstractFormatError: AbstractFormatError,
-        CsvFormatError: CsvFormatError,
-        CollectionError: CollectionError,
-        EnvironmentMismatchError: EnvironmentMismatchError,
-        ExpectError: ExpectError,
-        KnowledgeScrapeError: KnowledgeScrapeError,
-        LimitReachedError: LimitReachedError,
-        MissingToolsError: MissingToolsError,
-        NotFoundError: NotFoundError,
-        NotYetImplementedError: NotYetImplementedError,
-        ParseError: ParseError,
-        PipelineExecutionError: PipelineExecutionError,
-        PipelineLogicError: PipelineLogicError,
-        PipelineUrlError: PipelineUrlError,
-        UnexpectedError: UnexpectedError,
-        // TODO: [🪑]> VersionMismatchError,
-    };
-    /**
-     * Index of all javascript errors
-     *
-     * @private for internal usage
-     */
-    var COMMON_JAVASCRIPT_ERRORS = {
-        Error: Error,
-        EvalError: EvalError,
-        RangeError: RangeError,
-        ReferenceError: ReferenceError,
-        SyntaxError: SyntaxError,
-        TypeError: TypeError,
-        URIError: URIError,
-        AggregateError: AggregateError,
-        /*
-      Note: Not widely supported
-      > InternalError,
-      > ModuleError,
-      > HeapError,
-      > WebAssemblyCompileError,
-      > WebAssemblyRuntimeError,
-      */
-    };
-    /**
-     * Index of all errors
-     *
-     * @private for internal usage
-     */
-    var ALL_ERRORS = __assign(__assign({}, PROMPTBOOK_ERRORS), COMMON_JAVASCRIPT_ERRORS);
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
-     * Deserializes the error object
-     *
-     * @public exported from `@promptbook/utils`
+     * TODO: !!!! Do not return Promise<PipelineJson> But PreparePipelineTask
      */
-    function deserializeError(error) {
-        var ErrorClass = ALL_ERRORS[error.name];
-        if (ErrorClass === undefined) {
-            return new Error("".concat(error.name, ": ").concat(error.message));
-        }
-        return new ErrorClass(error.message);
-    }
 
     /**
      * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
@@ -5529,7 +5604,7 @@
                 var socket;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
-                        case 0: return [4 /*yield*/, this.makeConnection()];
+                        case 0: return [4 /*yield*/, createRemoteClient(this.options)];
                         case 1:
                             socket = _a.sent();
                             socket.disconnect();
@@ -5546,24 +5621,12 @@
                 var socket, promptResult;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
-                        case 0: return [4 /*yield*/, this.makeConnection()];
+                        case 0: return [4 /*yield*/, createRemoteClient(this.options)];
                         case 1:
                             socket = _a.sent();
-                            if (this.options.isAnonymous) {
-                                socket.emit('listModels-request', {
-                                    isAnonymous: true,
-                                    userId: this.options.userId,
-                                    llmToolsConfiguration: this.options.llmToolsConfiguration,
-                                } /* <- Note: [🤛] */);
-                            }
-                            else {
-                                socket.emit('listModels-request', {
-                                    isAnonymous: false,
-                                    appId: this.options.appId,
-                                    userId: this.options.userId,
-                                    customOptions: this.options.customOptions,
-                                } /* <- Note: [🤛] */);
-                            }
+                            socket.emit('listModels-request', {
+                                identification: this.options.identification,
+                            } /* <- Note: [🤛] */);
                             return [4 /*yield*/, new Promise(function (resolve, reject) {
                                     socket.on('listModels-response', function (response) {
                                         resolve(response.models);
@@ -5582,29 +5645,6 @@
                 });
             });
         };
-        /**
-         * Creates a connection to the remote proxy server.
-         */
-        RemoteLlmExecutionTools.prototype.makeConnection = function () {
-            var _this = this;
-            return new Promise(function (resolve, reject) {
-                var socket = socket_ioClient.io(_this.options.remoteUrl, {
-                    retries: CONNECTION_RETRIES_LIMIT,
-                    timeout: CONNECTION_TIMEOUT_MS,
-                    path: _this.options.path,
-                    // path: `${this.remoteUrl.pathname}/socket.io`,
-                    transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
-                });
-                // console.log('Connecting to', this.options.remoteUrl.href, { socket });
-                socket.on('connect', function () {
-                    resolve(socket);
-                });
-                // TODO: [💩] Better timeout handling
-                setTimeout(function () {
-                    reject(new Error("Timeout while connecting to ".concat(_this.options.remoteUrl)));
-                }, CONNECTION_TIMEOUT_MS);
-            });
-        };
         /**
          * Calls remote proxy server to use a chat model
          */
@@ -5641,26 +5681,13 @@
                 var socket, promptResult;
                 return __generator(this, function (_a) {
                     switch (_a.label) {
-                        case 0: return [4 /*yield*/, this.makeConnection()];
+                        case 0: return [4 /*yield*/, createRemoteClient(this.options)];
                         case 1:
                             socket = _a.sent();
-                            if (this.options.isAnonymous) {
-                                socket.emit('prompt-request', {
-                                    isAnonymous: true,
-                                    userId: this.options.userId,
-                                    llmToolsConfiguration: this.options.llmToolsConfiguration,
-                                    prompt: prompt,
-                                } /* <- Note: [🤛] */);
-                            }
-                            else {
-                                socket.emit('prompt-request', {
-                                    isAnonymous: false,
-                                    appId: this.options.appId,
-                                    userId: this.options.userId,
-                                    customOptions: this.options.customOptions,
-                                    prompt: prompt,
-                                } /* <- Note: [🤛] */);
-                            }
+                            socket.emit('prompt-request', {
+                                identification: this.options.identification,
+                                prompt: prompt,
+                            } /* <- Note: [🤛] */);
                             return [4 /*yield*/, new Promise(function (resolve, reject) {
                                     socket.on('prompt-response', function (response) {
                                         resolve(response.promptResult);