@promptbook/remote-server 0.65.0-2 → 0.65.0-3

package/umd/index.umd.js

@@ -1,19 +1,41 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('http'), require('socket.io'), require('spacetrim')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'http', 'socket.io', 'spacetrim'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.colors, global.http, global.socket_io, global.spacetrim));
-})(this, (function (exports, colors, http, socket_io, spacetrim) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('http'), require('socket.io'), require('spacetrim'), require('dotenv'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'http', 'socket.io', 'spacetrim', 'dotenv', 'socket.io-client', '@anthropic-ai/sdk', '@azure/openai', 'openai'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.colors, global.http, global.socket_io, global.spaceTrim, global.dotenv, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI));
+})(this, (function (exports, colors, http, socket_io, spaceTrim, dotenv, socket_ioClient, Anthropic, openai, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
+    function _interopNamespace(e) {
+        if (e && e.__esModule) return e;
+        var n = Object.create(null);
+        if (e) {
+            Object.keys(e).forEach(function (k) {
+                if (k !== 'default') {
+                    var d = Object.getOwnPropertyDescriptor(e, k);
+                    Object.defineProperty(n, k, d.get ? d : {
+                        enumerable: true,
+                        get: function () { return e[k]; }
+                    });
+                }
+            });
+        }
+        n["default"] = e;
+        return Object.freeze(n);
+    }
+
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
+    var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
+    var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.65.0-1';
+    var PROMPTBOOK_VERSION = '0.65.0-2';
     // TODO: !!!! List here all the versions and annotate + put into script
 
     /*! *****************************************************************************
@@ -47,6 +69,17 @@
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     }
 
+    var __assign = function() {
+        __assign = Object.assign || function __assign(t) {
+            for (var s, i = 1, n = arguments.length; i < n; i++) {
+                s = arguments[i];
+                for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+            }
+            return t;
+        };
+        return __assign.apply(this, arguments);
+    };
+
     function __awaiter(thisArg, _arguments, P, generator) {
         function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
         return new (P || (P = Promise))(function (resolve, reject) {
@@ -83,6 +116,45 @@
             } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
             if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
         }
+    }
+
+    function __values(o) {
+        var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+        if (m) return m.call(o);
+        if (o && typeof o.length === "number") return {
+            next: function () {
+                if (o && i >= o.length) o = void 0;
+                return { value: o && o[i++], done: !o };
+            }
+        };
+        throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+    }
+
+    function __read(o, n) {
+        var m = typeof Symbol === "function" && o[Symbol.iterator];
+        if (!m) return o;
+        var i = m.call(o), r, ar = [], e;
+        try {
+            while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+        }
+        catch (error) { e = { error: error }; }
+        finally {
+            try {
+                if (r && !r.done && (m = i["return"])) m.call(i);
+            }
+            finally { if (e) throw e.error; }
+        }
+        return ar;
+    }
+
+    function __spreadArray(to, from, pack) {
+        if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+            if (ar || !(i in from)) {
+                if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+                ar[i] = from[i];
+            }
+        }
+        return to.concat(ar || Array.prototype.slice.call(from));
     }
 
     /**
@@ -102,107 +174,2433 @@
     }(Error));
 
     /**
-     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
      *
-     * 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.
+     * @public exported from `@promptbook/core`
+     */
+    var UnexpectedError = /** @class */ (function (_super) {
+        __extends(UnexpectedError, _super);
+        function UnexpectedError(message) {
+            var _this = _super.call(this, spaceTrim.spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+            _this.name = 'UnexpectedError';
+            Object.setPrototypeOf(_this, UnexpectedError.prototype);
+            return _this;
+        }
+        return UnexpectedError;
+    }(Error));
+
+    /**
+     * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
      *
-     * @see https://github.com/webgptorg/promptbook#remote-server
-     * @public exported from `@promptbook/remote-server`
+     * Note: Internal utility of `joinLlmExecutionTools` but exposed type
+     * @public exported from `@promptbook/types`
      */
-    function startRemoteServer(options) {
-        var _this = this;
-        var port = options.port, path = options.path, collection = options.collection, createLlmExecutionTools = options.createLlmExecutionTools, _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
-        var httpServer = http__default["default"].createServer({}, function (request, response) {
-            var _a;
-            if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.includes('socket.io')) {
-                return;
-            }
-            response.write(spacetrim.spaceTrim("\n                Server for processing promptbook remote requests is running.\n\n                Version: ".concat(PROMPTBOOK_VERSION, "\n\n                For more information look at:\n                https://github.com/webgptorg/promptbook\n\n            ")));
-            response.end();
+    var MultipleLlmExecutionTools = /** @class */ (function () {
+        /**
+         * Gets array of execution tools in order of priority
+         */
+        function MultipleLlmExecutionTools() {
+            var llmExecutionTools = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                llmExecutionTools[_i] = arguments[_i];
+            }
+            this.llmExecutionTools = llmExecutionTools;
+        }
+        Object.defineProperty(MultipleLlmExecutionTools.prototype, "title", {
+            get: function () {
+                return 'Multiple LLM Providers';
+            },
+            enumerable: false,
+            configurable: true
         });
-        var server = new socket_io.Server(httpServer, {
-            path: path,
-            transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
-            cors: {
-                origin: '*',
-                methods: ['GET', 'POST'],
+        Object.defineProperty(MultipleLlmExecutionTools.prototype, "description", {
+            get: function () {
+                return this.llmExecutionTools
+                    .map(function (tools, index) { return "".concat(index + 1, ") ").concat(tools.title, " ").concat(tools.description || ''); })
+                    .join('\n');
             },
+            enumerable: false,
+            configurable: true
         });
-        server.on('connection', function (socket) {
-            console.info(colors__default["default"].gray("Client connected"), socket.id);
-            socket.on('request', function (request) { return __awaiter(_this, void 0, void 0, function () {
-                var prompt, clientId, executionToolsForClient, promptResult, _a, error_1;
-                return __generator(this, function (_b) {
-                    switch (_b.label) {
+        /**
+         * Calls the best available chat model
+         */
+        MultipleLlmExecutionTools.prototype.callChatModel = function (prompt) {
+            return this.callCommonModel(prompt);
+        };
+        /**
+         * Calls the best available completion model
+         */
+        MultipleLlmExecutionTools.prototype.callCompletionModel = function (prompt) {
+            return this.callCommonModel(prompt);
+        };
+        /**
+         * Calls the best available embedding model
+         */
+        MultipleLlmExecutionTools.prototype.callEmbeddingModel = function (prompt) {
+            return this.callCommonModel(prompt);
+        };
+        // <- Note: [🤖]
+        /**
+         * Calls the best available model
+         *
+         * Note: This should be private or protected but is public to be usable with duck typing
+         */
+        MultipleLlmExecutionTools.prototype.callCommonModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var errors, _a, _b, llmExecutionTools, _c, error_1, e_1_1;
+                var e_1, _d;
+                var _this = this;
+                return __generator(this, function (_e) {
+                    switch (_e.label) {
                         case 0:
-                            prompt = request.prompt, clientId = request.clientId;
-                            // TODO: !! Validate here clientId (pass validator as dependency)
-                            if (isVerbose) {
-                                console.info(colors__default["default"].bgWhite("Prompt:"), colors__default["default"].gray(JSON.stringify(request, null, 4)));
-                            }
-                            _b.label = 1;
+                            errors = [];
+                            _e.label = 1;
                         case 1:
-                            _b.trys.push([1, 11, 12, 13]);
-                            executionToolsForClient = createLlmExecutionTools(clientId);
-                            return [4 /*yield*/, collection.isResponsibleForPrompt(prompt)];
+                            _e.trys.push([1, 15, 16, 17]);
+                            _a = __values(this.llmExecutionTools), _b = _a.next();
+                            _e.label = 2;
                         case 2:
-                            if (!(_b.sent())) {
-                                throw new PipelineExecutionError("Pipeline is not in the collection of this server");
-                            }
-                            promptResult = void 0;
-                            _a = prompt.modelRequirements.modelVariant;
-                            switch (_a) {
-                                case 'CHAT': return [3 /*break*/, 3];
-                                case 'COMPLETION': return [3 /*break*/, 5];
-                                case 'EMBEDDING': return [3 /*break*/, 7];
-                            }
-                            return [3 /*break*/, 9];
+                            if (!!_b.done) return [3 /*break*/, 14];
+                            llmExecutionTools = _b.value;
+                            _e.label = 3;
                         case 3:
-                            if (executionToolsForClient.callChatModel === undefined) {
-                                // Note: [0] This check should not be a thing
-                                throw new PipelineExecutionError("Chat model is not available");
+                            _e.trys.push([3, 12, , 13]);
+                            _c = prompt.modelRequirements.modelVariant;
+                            switch (_c) {
+                                case 'CHAT': return [3 /*break*/, 4];
+                                case 'COMPLETION': return [3 /*break*/, 6];
+                                case 'EMBEDDING': return [3 /*break*/, 8];
                             }
-                            return [4 /*yield*/, executionToolsForClient.callChatModel(prompt)];
-                        case 4:
-                            promptResult = _b.sent();
                             return [3 /*break*/, 10];
-                        case 5:
-                            if (executionToolsForClient.callCompletionModel === undefined) {
-                                // Note: [0] This check should not be a thing
-                                throw new PipelineExecutionError("Completion model is not available");
+                        case 4:
+                            if (llmExecutionTools.callChatModel === undefined) {
+                                return [3 /*break*/, 13];
                             }
-                            return [4 /*yield*/, executionToolsForClient.callCompletionModel(prompt)];
+                            return [4 /*yield*/, llmExecutionTools.callChatModel(prompt)];
+                        case 5: return [2 /*return*/, _e.sent()];
                         case 6:
-                            promptResult = _b.sent();
-                            return [3 /*break*/, 10];
-                        case 7:
-                            if (executionToolsForClient.callEmbeddingModel === undefined) {
-                                // Note: [0] This check should not be a thing
-                                throw new PipelineExecutionError("Embedding model is not available");
+                            if (llmExecutionTools.callCompletionModel === undefined) {
+                                return [3 /*break*/, 13];
                             }
-                            return [4 /*yield*/, executionToolsForClient.callEmbeddingModel(prompt)];
+                            return [4 /*yield*/, llmExecutionTools.callCompletionModel(prompt)];
+                        case 7: return [2 /*return*/, _e.sent()];
                         case 8:
-                            promptResult = _b.sent();
-                            return [3 /*break*/, 10];
-                        case 9: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
-                        case 10:
-                            if (isVerbose) {
-                                console.info(colors__default["default"].bgGreen("PromptResult:"), colors__default["default"].green(JSON.stringify(promptResult, null, 4)));
+                            if (llmExecutionTools.callEmbeddingModel === undefined) {
+                                return [3 /*break*/, 13];
                             }
-                            socket.emit('response', { promptResult: promptResult });
-                            return [3 /*break*/, 13];
-                        case 11:
-                            error_1 = _b.sent();
-                            if (!(error_1 instanceof Error)) {
+                            return [4 /*yield*/, llmExecutionTools.callEmbeddingModel(prompt)];
+                        case 9: return [2 /*return*/, _e.sent()];
+                        case 10: throw new UnexpectedError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
+                        case 11: return [3 /*break*/, 13];
+                        case 12:
+                            error_1 = _e.sent();
+                            if (!(error_1 instanceof Error) || error_1 instanceof UnexpectedError) {
                                 throw error_1;
                             }
-                            socket.emit('error', { errorMessage: error_1.message });
+                            errors.push(error_1);
                             return [3 /*break*/, 13];
-                        case 12:
+                        case 13:
+                            _b = _a.next();
+                            return [3 /*break*/, 2];
+                        case 14: return [3 /*break*/, 17];
+                        case 15:
+                            e_1_1 = _e.sent();
+                            e_1 = { error: e_1_1 };
+                            return [3 /*break*/, 17];
+                        case 16:
+                            try {
+                                if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                            return [7 /*endfinally*/];
+                        case 17:
+                            if (errors.length === 1) {
+                                throw errors[0];
+                            }
+                            else if (errors.length > 1) {
+                                throw new PipelineExecutionError(
+                                // TODO: Tell which execution tools failed like
+                                //     1) OpenAI throw PipelineExecutionError: Parameter {knowledge} is not defined
+                                //     2) AnthropicClaude throw PipelineExecutionError: Parameter {knowledge} is not defined
+                                //     3) ...
+                                spaceTrim__default["default"](function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors
+                                    .map(function (error, i) { return "".concat(i + 1, ") **").concat(error.name || 'Error', ":** ").concat(error.message); })
+                                    .join('\n')), "\n\n                    "); }));
+                            }
+                            else if (this.llmExecutionTools.length === 0) {
+                                throw new PipelineExecutionError("You have not provided any `LlmExecutionTools`");
+                            }
+                            else {
+                                throw new PipelineExecutionError(spaceTrim__default["default"](function (block) { return "\n                          You have not provided any `LlmExecutionTools` that support model variant \"".concat(prompt.modelRequirements.modelVariant, "\n\n                          Available `LlmExecutionTools`:\n                          ").concat(block(_this.llmExecutionTools
+                                    .map(function (tools) { return "- ".concat(tools.title, " ").concat(tools.description || ''); })
+                                    .join('\n')), "\n\n                    "); }));
+                            }
+                    }
+                });
+            });
+        };
+        /**
+         * List all available models that can be used
+         * This lists is a combination of all available models from all execution tools
+         */
+        MultipleLlmExecutionTools.prototype.listModels = function () {
+            return __awaiter(this, void 0, void 0, function () {
+                var availableModels, _a, _b, llmExecutionTools, models, e_2_1;
+                var e_2, _c;
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
+                        case 0:
+                            availableModels = [];
+                            _d.label = 1;
+                        case 1:
+                            _d.trys.push([1, 6, 7, 8]);
+                            _a = __values(this.llmExecutionTools), _b = _a.next();
+                            _d.label = 2;
+                        case 2:
+                            if (!!_b.done) return [3 /*break*/, 5];
+                            llmExecutionTools = _b.value;
+                            return [4 /*yield*/, llmExecutionTools.listModels()];
+                        case 3:
+                            models = _d.sent();
+                            availableModels.push.apply(availableModels, __spreadArray([], __read(models), false));
+                            _d.label = 4;
+                        case 4:
+                            _b = _a.next();
+                            return [3 /*break*/, 2];
+                        case 5: return [3 /*break*/, 8];
+                        case 6:
+                            e_2_1 = _d.sent();
+                            e_2 = { error: e_2_1 };
+                            return [3 /*break*/, 8];
+                        case 7:
+                            try {
+                                if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                            }
+                            finally { if (e_2) throw e_2.error; }
+                            return [7 /*endfinally*/];
+                        case 8: return [2 /*return*/, availableModels];
+                    }
+                });
+            });
+        };
+        return MultipleLlmExecutionTools;
+    }());
+    /**
+     * TODO: [🧠][🎛] Aggregating multiple models - have result not only from one first aviable model BUT all of them
+     * TODO: [🏖] If no llmTools have for example not defined `callCompletionModel` this will still return object with defined `callCompletionModel` which just throws `PipelineExecutionError`, make it undefined instead
+     *       Look how `countTotalUsage` (and `cacheLlmTools`) implements it
+     */
+
+    /**
+     * Joins multiple LLM Execution Tools into one
+     *
+     * @returns {LlmExecutionTools} Single wrapper for multiple LlmExecutionTools
+     *
+     * 0) If there is no LlmExecutionTools, it warns and returns valid but empty LlmExecutionTools
+     * 1) If there is only one LlmExecutionTools, it returns it wrapped in a proxy object
+     * 2) If there are multiple LlmExecutionTools, first will be used first, second will be used if the first hasn`t defined model variant or fails, etc.
+     * 3) When all LlmExecutionTools fail, it throws an error with a list of all errors merged into one
+     *
+     *
+     * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function joinLlmExecutionTools() {
+        var llmExecutionTools = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            llmExecutionTools[_i] = arguments[_i];
+        }
+        if (llmExecutionTools.length === 0) {
+            var warningMessage = spaceTrim__default["default"]("\n            You have not provided any `LlmExecutionTools`\n            This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.\n\n            Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.\n        ");
+            // TODO: [🟥] Detect browser / node and make it colorfull
+            console.warn(warningMessage);
+            /*
+            return {
+                async listModels() {
+                    // TODO: [🟥] Detect browser / node and make it colorfull
+                    console.warn(
+                        spaceTrim(
+                            (block) => `
+
+                                You can't list models because you have no LLM Execution Tools defined:
+
+                                tl;dr
+
+                                ${block(warningMessage)}
+                            `,
+                        ),
+                    );
+                    return [];
+                },
+            };
+            */
+        }
+        return new (MultipleLlmExecutionTools.bind.apply(MultipleLlmExecutionTools, __spreadArray([void 0], __read(llmExecutionTools), false)))();
+    }
+    /**
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     */
+
+    /**
+     * 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-client`
+     */
+    var RemoteLlmExecutionTools = /** @class */ (function () {
+        function RemoteLlmExecutionTools(options) {
+            this.options = options;
+        }
+        Object.defineProperty(RemoteLlmExecutionTools.prototype, "title", {
+            get: function () {
+                // TODO: [🧠] Maybe fetch title+description from the remote server (as well as if model methods are defined)
+                return 'Remote server';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(RemoteLlmExecutionTools.prototype, "description", {
+            get: function () {
+                return 'Use all models by your remote server';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * 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, {
+                    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);
+                });
+                setTimeout(function () {
+                    reject(new Error("Timeout while connecting to ".concat(_this.options.remoteUrl)));
+                }, 60000 /* <- TODO: Timeout to config */);
+            });
+        };
+        /**
+         * Calls remote proxy server to use a chat model
+         */
+        RemoteLlmExecutionTools.prototype.callChatModel = function (prompt) {
+            if (this.options.isVerbose) {
+                console.info("\uD83D\uDD8B Remote callChatModel call");
+            }
+            return /* not await */ this.callCommonModel(prompt);
+        };
+        /**
+         * Calls remote proxy server to use a completion model
+         */
+        RemoteLlmExecutionTools.prototype.callCompletionModel = function (prompt) {
+            if (this.options.isVerbose) {
+                console.info("\uD83D\uDCAC Remote callCompletionModel call");
+            }
+            return /* not await */ this.callCommonModel(prompt);
+        };
+        /**
+         * Calls remote proxy server to use a embedding model
+         */
+        RemoteLlmExecutionTools.prototype.callEmbeddingModel = function (prompt) {
+            if (this.options.isVerbose) {
+                console.info("\uD83D\uDCAC Remote callEmbeddingModel call");
+            }
+            return /* not await */ this.callCommonModel(prompt);
+        };
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Calls remote proxy server to use both completion or chat model
+         */
+        RemoteLlmExecutionTools.prototype.callCommonModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var socket, promptResult;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, this.makeConnection()];
+                        case 1:
+                            socket = _a.sent();
+                            if (this.options.isAnonymous) {
+                                socket.emit('request', {
+                                    llmToolsConfiguration: this.options.llmToolsConfiguration,
+                                    prompt: prompt,
+                                    // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
+                                });
+                            }
+                            else {
+                                socket.emit('request', {
+                                    clientId: this.options.clientId,
+                                    prompt: prompt,
+                                    // <- TODO: [🛫] `prompt` is NOT fully serializable as JSON, it contains functions which are not serializable
+                                });
+                            }
+                            return [4 /*yield*/, new Promise(function (resolve, reject) {
+                                    socket.on('response', function (response) {
+                                        resolve(response.promptResult);
+                                        socket.disconnect();
+                                    });
+                                    socket.on('error', function (error) {
+                                        reject(new PipelineExecutionError(error.errorMessage));
+                                        socket.disconnect();
+                                    });
+                                })];
+                        case 2:
+                            promptResult = _a.sent();
+                            socket.disconnect();
+                            return [2 /*return*/, promptResult];
+                    }
+                });
+            });
+        };
+        /**
+         * List all available models that can be used
+         */
+        RemoteLlmExecutionTools.prototype.listModels = function () {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, [
+                        /* !!! */
+                        ]];
+                });
+            });
+        };
+        return RemoteLlmExecutionTools;
+    }());
+    /**
+     * TODO: [🍜] !!!!!! Default remote remoteUrl and path for anonymous server
+     * TODO: [🍓] Allow to list compatible models with each variant
+     * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     * TODO: [🧠] Maybe remove `@promptbook/remote-client` and just use `@promptbook/core`
+     */
+
+    /**
+     * Counts number of characters in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countCharacters(text) {
+        // Remove null characters
+        text = text.replace(/\0/g, '');
+        // Replace emojis (and also ZWJ sequence) with hyphens
+        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+        text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
+        return text.length;
+    }
+
+    /**
+     * Counts number of lines in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countLines(text) {
+        if (text === '') {
+            return 0;
+        }
+        return text.split('\n').length;
+    }
+
+    /**
+     * Counts number of pages in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countPages(text) {
+        var sentencesPerPage = 5; // Assuming each page has 5 sentences
+        var sentences = text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+        var pageCount = Math.ceil(sentences.length / sentencesPerPage);
+        return pageCount;
+    }
+
+    /**
+     * Counts number of paragraphs in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countParagraphs(text) {
+        return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
+    }
+
+    /**
+     * Split text into sentences
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function splitIntoSentences(text) {
+        return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
+    }
+    /**
+     * Counts number of sentences in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countSentences(text) {
+        return splitIntoSentences(text).length;
+    }
+
+    var defaultDiacriticsRemovalMap = [
+        {
+            base: 'A',
+            letters: '\u0041\u24B6\uFF21\u00C0\u00C1\u00C2\u1EA6\u1EA4\u1EAA\u1EA8\u00C3\u0100\u0102\u1EB0\u1EAE\u1EB4\u1EB2\u0226\u01E0\u00C4\u01DE\u1EA2\u00C5\u01FA\u01CD\u0200\u0202\u1EA0\u1EAC\u1EB6\u1E00\u0104\u023A\u2C6F',
+        },
+        { base: 'AA', letters: '\uA732' },
+        { base: 'AE', letters: '\u00C6\u01FC\u01E2' },
+        { base: 'AO', letters: '\uA734' },
+        { base: 'AU', letters: '\uA736' },
+        { base: 'AV', letters: '\uA738\uA73A' },
+        { base: 'AY', letters: '\uA73C' },
+        {
+            base: 'B',
+            letters: '\u0042\u24B7\uFF22\u1E02\u1E04\u1E06\u0243\u0182\u0181',
+        },
+        {
+            base: 'C',
+            letters: '\u0043\u24B8\uFF23\u0106\u0108\u010A\u010C\u00C7\u1E08\u0187\u023B\uA73E',
+        },
+        {
+            base: 'D',
+            letters: '\u0044\u24B9\uFF24\u1E0A\u010E\u1E0C\u1E10\u1E12\u1E0E\u0110\u018B\u018A\u0189\uA779\u00D0',
+        },
+        { base: 'DZ', letters: '\u01F1\u01C4' },
+        { base: 'Dz', letters: '\u01F2\u01C5' },
+        {
+            base: 'E',
+            letters: '\u0045\u24BA\uFF25\u00C8\u00C9\u00CA\u1EC0\u1EBE\u1EC4\u1EC2\u1EBC\u0112\u1E14\u1E16\u0114\u0116\u00CB\u1EBA\u011A\u0204\u0206\u1EB8\u1EC6\u0228\u1E1C\u0118\u1E18\u1E1A\u0190\u018E',
+        },
+        { base: 'F', letters: '\u0046\u24BB\uFF26\u1E1E\u0191\uA77B' },
+        {
+            base: 'G',
+            letters: '\u0047\u24BC\uFF27\u01F4\u011C\u1E20\u011E\u0120\u01E6\u0122\u01E4\u0193\uA7A0\uA77D\uA77E',
+        },
+        {
+            base: 'H',
+            letters: '\u0048\u24BD\uFF28\u0124\u1E22\u1E26\u021E\u1E24\u1E28\u1E2A\u0126\u2C67\u2C75\uA78D',
+        },
+        {
+            base: 'I',
+            letters: '\u0049\u24BE\uFF29\u00CC\u00CD\u00CE\u0128\u012A\u012C\u0130\u00CF\u1E2E\u1EC8\u01CF\u0208\u020A\u1ECA\u012E\u1E2C\u0197',
+        },
+        { base: 'J', letters: '\u004A\u24BF\uFF2A\u0134\u0248' },
+        {
+            base: 'K',
+            letters: '\u004B\u24C0\uFF2B\u1E30\u01E8\u1E32\u0136\u1E34\u0198\u2C69\uA740\uA742\uA744\uA7A2',
+        },
+        {
+            base: 'L',
+            letters: '\u004C\u24C1\uFF2C\u013F\u0139\u013D\u1E36\u1E38\u013B\u1E3C\u1E3A\u0141\u023D\u2C62\u2C60\uA748\uA746\uA780',
+        },
+        { base: 'LJ', letters: '\u01C7' },
+        { base: 'Lj', letters: '\u01C8' },
+        { base: 'M', letters: '\u004D\u24C2\uFF2D\u1E3E\u1E40\u1E42\u2C6E\u019C' },
+        {
+            base: 'N',
+            letters: '\u004E\u24C3\uFF2E\u01F8\u0143\u00D1\u1E44\u0147\u1E46\u0145\u1E4A\u1E48\u0220\u019D\uA790\uA7A4',
+        },
+        { base: 'NJ', letters: '\u01CA' },
+        { base: 'Nj', letters: '\u01CB' },
+        {
+            base: 'O',
+            letters: '\u004F\u24C4\uFF2F\u00D2\u00D3\u00D4\u1ED2\u1ED0\u1ED6\u1ED4\u00D5\u1E4C\u022C\u1E4E\u014C\u1E50\u1E52\u014E\u022E\u0230\u00D6\u022A\u1ECE\u0150\u01D1\u020C\u020E\u01A0\u1EDC\u1EDA\u1EE0\u1EDE\u1EE2\u1ECC\u1ED8\u01EA\u01EC\u00D8\u01FE\u0186\u019F\uA74A\uA74C',
+        },
+        { base: 'OI', letters: '\u01A2' },
+        { base: 'OO', letters: '\uA74E' },
+        { base: 'OU', letters: '\u0222' },
+        { base: 'OE', letters: '\u008C\u0152' },
+        { base: 'oe', letters: '\u009C\u0153' },
+        {
+            base: 'P',
+            letters: '\u0050\u24C5\uFF30\u1E54\u1E56\u01A4\u2C63\uA750\uA752\uA754',
+        },
+        { base: 'Q', letters: '\u0051\u24C6\uFF31\uA756\uA758\u024A' },
+        {
+            base: 'R',
+            letters: '\u0052\u24C7\uFF32\u0154\u1E58\u0158\u0210\u0212\u1E5A\u1E5C\u0156\u1E5E\u024C\u2C64\uA75A\uA7A6\uA782',
+        },
+        {
+            base: 'S',
+            letters: '\u0053\u24C8\uFF33\u1E9E\u015A\u1E64\u015C\u1E60\u0160\u1E66\u1E62\u1E68\u0218\u015E\u2C7E\uA7A8\uA784',
+        },
+        {
+            base: 'T',
+            letters: '\u0054\u24C9\uFF34\u1E6A\u0164\u1E6C\u021A\u0162\u1E70\u1E6E\u0166\u01AC\u01AE\u023E\uA786',
+        },
+        { base: 'TZ', letters: '\uA728' },
+        {
+            base: 'U',
+            letters: '\u0055\u24CA\uFF35\u00D9\u00DA\u00DB\u0168\u1E78\u016A\u1E7A\u016C\u00DC\u01DB\u01D7\u01D5\u01D9\u1EE6\u016E\u0170\u01D3\u0214\u0216\u01AF\u1EEA\u1EE8\u1EEE\u1EEC\u1EF0\u1EE4\u1E72\u0172\u1E76\u1E74\u0244',
+        },
+        { base: 'V', letters: '\u0056\u24CB\uFF36\u1E7C\u1E7E\u01B2\uA75E\u0245' },
+        { base: 'VY', letters: '\uA760' },
+        {
+            base: 'W',
+            letters: '\u0057\u24CC\uFF37\u1E80\u1E82\u0174\u1E86\u1E84\u1E88\u2C72',
+        },
+        { base: 'X', letters: '\u0058\u24CD\uFF38\u1E8A\u1E8C' },
+        {
+            base: 'Y',
+            letters: '\u0059\u24CE\uFF39\u1EF2\u00DD\u0176\u1EF8\u0232\u1E8E\u0178\u1EF6\u1EF4\u01B3\u024E\u1EFE',
+        },
+        {
+            base: 'Z',
+            letters: '\u005A\u24CF\uFF3A\u0179\u1E90\u017B\u017D\u1E92\u1E94\u01B5\u0224\u2C7F\u2C6B\uA762',
+        },
+        {
+            base: 'a',
+            letters: '\u0061\u24D0\uFF41\u1E9A\u00E0\u00E1\u00E2\u1EA7\u1EA5\u1EAB\u1EA9\u00E3\u0101\u0103\u1EB1\u1EAF\u1EB5\u1EB3\u0227\u01E1\u00E4\u01DF\u1EA3\u00E5\u01FB\u01CE\u0201\u0203\u1EA1\u1EAD\u1EB7\u1E01\u0105\u2C65\u0250',
+        },
+        { base: 'aa', letters: '\uA733' },
+        { base: 'ae', letters: '\u00E6\u01FD\u01E3' },
+        { base: 'ao', letters: '\uA735' },
+        { base: 'au', letters: '\uA737' },
+        { base: 'av', letters: '\uA739\uA73B' },
+        { base: 'ay', letters: '\uA73D' },
+        {
+            base: 'b',
+            letters: '\u0062\u24D1\uFF42\u1E03\u1E05\u1E07\u0180\u0183\u0253',
+        },
+        {
+            base: 'c',
+            letters: '\u0063\u24D2\uFF43\u0107\u0109\u010B\u010D\u00E7\u1E09\u0188\u023C\uA73F\u2184',
+        },
+        {
+            base: 'd',
+            letters: '\u0064\u24D3\uFF44\u1E0B\u010F\u1E0D\u1E11\u1E13\u1E0F\u0111\u018C\u0256\u0257\uA77A',
+        },
+        { base: 'dz', letters: '\u01F3\u01C6' },
+        {
+            base: 'e',
+            letters: '\u0065\u24D4\uFF45\u00E8\u00E9\u00EA\u1EC1\u1EBF\u1EC5\u1EC3\u1EBD\u0113\u1E15\u1E17\u0115\u0117\u00EB\u1EBB\u011B\u0205\u0207\u1EB9\u1EC7\u0229\u1E1D\u0119\u1E19\u1E1B\u0247\u025B\u01DD',
+        },
+        { base: 'f', letters: '\u0066\u24D5\uFF46\u1E1F\u0192\uA77C' },
+        {
+            base: 'g',
+            letters: '\u0067\u24D6\uFF47\u01F5\u011D\u1E21\u011F\u0121\u01E7\u0123\u01E5\u0260\uA7A1\u1D79\uA77F',
+        },
+        {
+            base: 'h',
+            letters: '\u0068\u24D7\uFF48\u0125\u1E23\u1E27\u021F\u1E25\u1E29\u1E2B\u1E96\u0127\u2C68\u2C76\u0265',
+        },
+        { base: 'hv', letters: '\u0195' },
+        {
+            base: 'i',
+            letters: '\u0069\u24D8\uFF49\u00EC\u00ED\u00EE\u0129\u012B\u012D\u00EF\u1E2F\u1EC9\u01D0\u0209\u020B\u1ECB\u012F\u1E2D\u0268\u0131',
+        },
+        { base: 'j', letters: '\u006A\u24D9\uFF4A\u0135\u01F0\u0249' },
+        {
+            base: 'k',
+            letters: '\u006B\u24DA\uFF4B\u1E31\u01E9\u1E33\u0137\u1E35\u0199\u2C6A\uA741\uA743\uA745\uA7A3',
+        },
+        {
+            base: 'l',
+            letters: '\u006C\u24DB\uFF4C\u0140\u013A\u013E\u1E37\u1E39\u013C\u1E3D\u1E3B\u017F\u0142\u019A\u026B\u2C61\uA749\uA781\uA747',
+        },
+        { base: 'lj', letters: '\u01C9' },
+        { base: 'm', letters: '\u006D\u24DC\uFF4D\u1E3F\u1E41\u1E43\u0271\u026F' },
+        {
+            base: 'n',
+            letters: '\u006E\u24DD\uFF4E\u01F9\u0144\u00F1\u1E45\u0148\u1E47\u0146\u1E4B\u1E49\u019E\u0272\u0149\uA791\uA7A5',
+        },
+        { base: 'nj', letters: '\u01CC' },
+        {
+            base: 'o',
+            letters: '\u006F\u24DE\uFF4F\u00F2\u00F3\u00F4\u1ED3\u1ED1\u1ED7\u1ED5\u00F5\u1E4D\u022D\u1E4F\u014D\u1E51\u1E53\u014F\u022F\u0231\u00F6\u022B\u1ECF\u0151\u01D2\u020D\u020F\u01A1\u1EDD\u1EDB\u1EE1\u1EDF\u1EE3\u1ECD\u1ED9\u01EB\u01ED\u00F8\u01FF\u0254\uA74B\uA74D\u0275',
+        },
+        { base: 'oi', letters: '\u01A3' },
+        { base: 'ou', letters: '\u0223' },
+        { base: 'oo', letters: '\uA74F' },
+        {
+            base: 'p',
+            letters: '\u0070\u24DF\uFF50\u1E55\u1E57\u01A5\u1D7D\uA751\uA753\uA755',
+        },
+        { base: 'q', letters: '\u0071\u24E0\uFF51\u024B\uA757\uA759' },
+        {
+            base: 'r',
+            letters: '\u0072\u24E1\uFF52\u0155\u1E59\u0159\u0211\u0213\u1E5B\u1E5D\u0157\u1E5F\u024D\u027D\uA75B\uA7A7\uA783',
+        },
+        {
+            base: 's',
+            letters: '\u0073\u24E2\uFF53\u00DF\u015B\u1E65\u015D\u1E61\u0161\u1E67\u1E63\u1E69\u0219\u015F\u023F\uA7A9\uA785\u1E9B',
+        },
+        {
+            base: 't',
+            letters: '\u0074\u24E3\uFF54\u1E6B\u1E97\u0165\u1E6D\u021B\u0163\u1E71\u1E6F\u0167\u01AD\u0288\u2C66\uA787',
+        },
+        { base: 'tz', letters: '\uA729' },
+        {
+            base: 'u',
+            letters: '\u0075\u24E4\uFF55\u00F9\u00FA\u00FB\u0169\u1E79\u016B\u1E7B\u016D\u00FC\u01DC\u01D8\u01D6\u01DA\u1EE7\u016F\u0171\u01D4\u0215\u0217\u01B0\u1EEB\u1EE9\u1EEF\u1EED\u1EF1\u1EE5\u1E73\u0173\u1E77\u1E75\u0289',
+        },
+        { base: 'v', letters: '\u0076\u24E5\uFF56\u1E7D\u1E7F\u028B\uA75F\u028C' },
+        { base: 'vy', letters: '\uA761' },
+        {
+            base: 'w',
+            letters: '\u0077\u24E6\uFF57\u1E81\u1E83\u0175\u1E87\u1E85\u1E98\u1E89\u2C73',
+        },
+        { base: 'x', letters: '\u0078\u24E7\uFF58\u1E8B\u1E8D' },
+        {
+            base: 'y',
+            letters: '\u0079\u24E8\uFF59\u1EF3\u00FD\u0177\u1EF9\u0233\u1E8F\u00FF\u1EF7\u1E99\u1EF5\u01B4\u024F\u1EFF',
+        },
+        {
+            base: 'z',
+            letters: '\u007A\u24E9\uFF5A\u017A\u1E91\u017C\u017E\u1E93\u1E95\u01B6\u0225\u0240\u2C6C\uA763',
+        },
+    ];
+    /**
+     * Map of letters from diacritic variant to diacritless variant
+     * Contains lowercase and uppercase separatelly
+     *
+     * > "á" => "a"
+     * > "ě" => "e"
+     * > "Ă" => "A"
+     * > ...
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    var DIACRITIC_VARIANTS_LETTERS = {};
+    // tslint:disable-next-line: prefer-for-of
+    for (var i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
+        var letters = defaultDiacriticsRemovalMap[i].letters;
+        // tslint:disable-next-line: prefer-for-of
+        for (var j = 0; j < letters.length; j++) {
+            DIACRITIC_VARIANTS_LETTERS[letters[j]] = defaultDiacriticsRemovalMap[i].base;
+        }
+    }
+    // <- TODO: [🍓] Put to maker function to save execution time if not needed
+    /*
+      @see https://stackoverflow.com/questions/990904/remove-accents-diacritics-in-a-string-in-javascript
+       Licensed under the Apache License, Version 2.0 (the "License");
+       you may not use this file except in compliance with the License.
+       You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing, software
+       distributed under the License is distributed on an "AS IS" BASIS,
+       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+       See the License for the specific language governing permissions and
+       limitations under the License.
+    */
+
+    /**
+     * @@@
+     *
+     * @param input @@@
+     * @returns @@@
+     * @public exported from `@promptbook/utils`
+     */
+    function removeDiacritics(input) {
+        /*eslint no-control-regex: "off"*/
+        return input.replace(/[^\u0000-\u007E]/g, function (a) {
+            return DIACRITIC_VARIANTS_LETTERS[a] || a;
+        });
+    }
+    /**
+     * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
+     */
+
+    /**
+     * Counts number of words in the text
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function countWords(text) {
+        text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
+        text = removeDiacritics(text);
+        return text.split(/[^a-zа-я0-9]+/i).filter(function (word) { return word.length > 0; }).length;
+    }
+
+    /**
+     * Helper of usage compute
+     *
+     * @param content the content of prompt or response
+     * @returns part of PromptResultUsageCounts
+     *
+     * @private internal utility of LlmExecutionTools
+     */
+    function computeUsageCounts(content) {
+        return {
+            charactersCount: { value: countCharacters(content) },
+            wordsCount: { value: countWords(content) },
+            sentencesCount: { value: countSentences(content) },
+            linesCount: { value: countLines(content) },
+            paragraphsCount: { value: countParagraphs(content) },
+            pagesCount: { value: countPages(content) },
+        };
+    }
+
+    /**
+     * Make UncertainNumber
+     *
+     * @param value
+     *
+     * @private utility for initializating UncertainNumber
+     */
+    function uncertainNumber(value) {
+        if (value === null || value === undefined || Number.isNaN(value)) {
+            return { value: 0, isUncertain: true };
+        }
+        return { value: value };
+    }
+
+    /**
+     * Get current date in ISO 8601 format
+     *
+     * @private internal utility
+     */
+    function getCurrentIsoDate() {
+        return new Date().toISOString();
+    }
+
+    /**
+     * @@@
+     *
+     * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     *
+     * @returns The same object as the input, but deeply frozen
+     * @public exported from `@promptbook/utils`
+     */
+    function deepFreeze(objectValue) {
+        var e_1, _a;
+        var propertyNames = Object.getOwnPropertyNames(objectValue);
+        try {
+            for (var propertyNames_1 = __values(propertyNames), propertyNames_1_1 = propertyNames_1.next(); !propertyNames_1_1.done; propertyNames_1_1 = propertyNames_1.next()) {
+                var propertyName = propertyNames_1_1.value;
+                var value = objectValue[propertyName];
+                if (value && typeof value === 'object') {
+                    deepFreeze(value);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (propertyNames_1_1 && !propertyNames_1_1.done && (_a = propertyNames_1.return)) _a.call(propertyNames_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return Object.freeze(objectValue);
+    }
+    /**
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
+
+    // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
+    /**
+     * The maximum number of iterations for a loops
+     *
+     * @private within the repository - too low-level in comparison with other `MAX_...`
+     */
+    var LOOP_LIMIT = 1000;
+    /**
+     * Nonce which is used for replacing things in strings
+     *
+     * @private within the repository
+     */
+    var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
+    /**
+     * The names of the parameters that are reserved for special purposes
+     *
+     * @public exported from `@promptbook/core`
+     */
+    deepFreeze([
+        'content',
+        'context',
+        'knowledge',
+        'samples',
+        'modelName',
+        'currentDate',
+        // <- TODO: Add more like 'date', 'modelName',...
+        // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
+    ]);
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
+
+    /**
+     * 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));
+
+    /**
+     * Replaces parameters in template with values from parameters object
+     *
+     * @param template the template with parameters in {curly} braces
+     * @param parameters the object with parameters
+     * @returns the template with replaced parameters
+     * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+     * @public exported from `@promptbook/utils`
+     */
+    function replaceParameters(template, parameters) {
+        var e_1, _a;
+        try {
+            for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), parameterName = _d[0], parameterValue = _d[1];
+                if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
+                    throw new UnexpectedError("Parameter {".concat(parameterName, "} has missing value"));
+                }
+                else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
+                    // TODO: [🍵]
+                    throw new UnexpectedError("Parameter {".concat(parameterName, "} is restricted to use"));
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var replacedTemplate = template;
+        var match;
+        var loopLimit = LOOP_LIMIT;
+        var _loop_1 = function () {
+            if (loopLimit-- < 0) {
+                throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
+            }
+            var precol = match.groups.precol;
+            var parameterName = match.groups.parameterName;
+            if (parameterName === '') {
+                return "continue";
+            }
+            if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+                throw new PipelineExecutionError('Parameter is already opened or not closed');
+            }
+            if (parameters[parameterName] === undefined) {
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            var parameterValue = parameters[parameterName];
+            if (parameterValue === undefined) {
+                throw new PipelineExecutionError("Parameter {".concat(parameterName, "} is not defined"));
+            }
+            parameterValue = parameterValue.toString();
+            if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+                parameterValue = parameterValue
+                    .split('\n')
+                    .map(function (line, index) { return (index === 0 ? line : "".concat(precol).concat(line)); })
+                    .join('\n');
+            }
+            replacedTemplate =
+                replacedTemplate.substring(0, match.index + precol.length) +
+                    parameterValue +
+                    replacedTemplate.substring(match.index + precol.length + parameterName.length + 2);
+        };
+        while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+            .exec(replacedTemplate))) {
+            _loop_1();
+        }
+        // [💫] Check if there are parameters that are not closed properly
+        if (/{\w+$/.test(replacedTemplate)) {
+            throw new PipelineExecutionError('Parameter is not closed');
+        }
+        // [💫] Check if there are parameters that are not opened properly
+        if (/^\w+}/.test(replacedTemplate)) {
+            throw new PipelineExecutionError('Parameter is not opened');
+        }
+        return replacedTemplate;
+    }
+
+    /**
+     * Function computeUsage will create price per one token based on the string value found on openai page
+     *
+     * @private within the repository, used only as internal helper for `OPENAI_MODELS`
+     */
+    function computeUsage(value) {
+        var _a = __read(value.split(' / '), 2), price = _a[0], tokens = _a[1];
+        return parseFloat(price.replace('$', '')) / parseFloat(tokens.replace('M tokens', '')) / 1000000;
+    }
+
+    /**
+     * List of available Anthropic Claude models with pricing
+     *
+     * Note: Done at 2024-05-25
+     *
+     * @see https://docs.anthropic.com/en/docs/models-overview
+     * @public exported from `@promptbook/anthropic-claude`
+     */
+    var ANTHROPIC_CLAUDE_MODELS = [
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 3 Opus',
+            modelName: 'claude-3-opus-20240229',
+            pricing: {
+                prompt: computeUsage("$15.00 / 1M tokens"),
+                output: computeUsage("$75.00 / 1M tokens"),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 3 Sonnet',
+            modelName: 'claude-3-sonnet-20240229',
+            pricing: {
+                prompt: computeUsage("$3.00 / 1M tokens"),
+                output: computeUsage("$15.00 / 1M tokens"),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 3 Haiku',
+            modelName: '	claude-3-haiku-20240307',
+            pricing: {
+                prompt: computeUsage("$0.25 / 1M tokens"),
+                output: computeUsage("$1.25 / 1M tokens"),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 2.1',
+            modelName: 'claude-2.1',
+            pricing: {
+                prompt: computeUsage("$8.00 / 1M tokens"),
+                output: computeUsage("$24.00 / 1M tokens"),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 2',
+            modelName: 'claude-2.0',
+            pricing: {
+                prompt: computeUsage("$8.00 / 1M tokens"),
+                output: computeUsage("$24.00 / 1M tokens"),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: '	Claude Instant 1.2',
+            modelName: 'claude-instant-1.2',
+            pricing: {
+                prompt: computeUsage("$0.80 / 1M tokens"),
+                output: computeUsage("$2.40 / 1M tokens"),
+            },
+        },
+        // TODO: !!! Claude 1 and 2 has also completion versions - ask Hoagy
+    ];
+    /**
+     * Note: [🤖] Add models of new variant
+     * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
+     * TODO: [🧠] Some mechanism to propagate unsureness
+     * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+     * TODO: [🕚] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+     */
+
+    /**
+     * Execution Tools for calling Anthropic Claude API.
+     *
+     * @public exported from `@promptbook/anthropic-claude`
+     * @deprecated use `createAnthropicClaudeExecutionTools` instead
+     */
+    var AnthropicClaudeExecutionTools = /** @class */ (function () {
+        /**
+         * Creates Anthropic Claude Execution Tools.
+         *
+         * @param options which are relevant are directly passed to the Anthropic Claude client
+         */
+        function AnthropicClaudeExecutionTools(options) {
+            if (options === void 0) { options = { isProxied: false }; }
+            this.options = options;
+            // Note: Passing only Anthropic Claude relevant options to Anthropic constructor
+            var anthropicOptions = __assign({}, options);
+            delete anthropicOptions.isVerbose;
+            delete anthropicOptions.isProxied;
+            this.client = new Anthropic__default["default"](anthropicOptions);
+        }
+        Object.defineProperty(AnthropicClaudeExecutionTools.prototype, "title", {
+            get: function () {
+                return 'Anthropic Claude';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(AnthropicClaudeExecutionTools.prototype, "description", {
+            get: function () {
+                return 'Use all models provided by Anthropic Claude';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * Calls Anthropic Claude API to use a chat model.
+         */
+        AnthropicClaudeExecutionTools.prototype.callChatModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('💬 Anthropic Claude callChatModel call');
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'CHAT') {
+                                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                            }
+                            modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = {
+                                model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
+                                max_tokens: modelRequirements.maxTokens || 4096,
+                                //                                            <- TODO: [🌾] Make some global max cap for maxTokens
+                                temperature: modelRequirements.temperature,
+                                system: modelRequirements.systemMessage,
+                                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                                // <- Note: [🧆]
+                                messages: [
+                                    {
+                                        role: 'user',
+                                        content: rawPromptContent,
+                                    },
+                                ],
+                                // TODO: Is here some equivalent of user identification?> user: this.options.user,
+                            };
+                            start = getCurrentIsoDate();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                            }
+                            return [4 /*yield*/, this.client.messages.create(rawRequest)];
+                        case 1:
+                            rawResponse = _a.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (!rawResponse.content[0]) {
+                                throw new PipelineExecutionError('No content from Anthropic Claude');
+                            }
+                            if (rawResponse.content.length > 1) {
+                                throw new PipelineExecutionError('More than one content blocks from Anthropic Claude');
+                            }
+                            resultContent = rawResponse.content[0].text;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = {
+                                price: { value: 0, isUncertain: true } /* <- TODO: [🐞] Compute usage */,
+                                input: __assign({ tokensCount: uncertainNumber(rawResponse.usage.input_tokens) }, computeUsageCounts(prompt.content)),
+                                output: __assign({ tokensCount: uncertainNumber(rawResponse.usage.output_tokens) }, computeUsageCounts(prompt.content)),
+                            };
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: rawResponse.model,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                    }
+                });
+            });
+        };
+        /*
+        TODO: [👏]
+        public async callCompletionModel(
+            prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>,
+        ): Promise<PromptCompletionResult> {
+
+            if (this.options.isVerbose) {
+                console.info('🖋 Anthropic Claude callCompletionModel call');
+            }
+
+            const { content, parameters, modelRequirements } = prompt;
+
+            // TODO: [☂] Use here more modelRequirements
+            if (modelRequirements.modelVariant !== 'COMPLETION') {
+                throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+            }
+
+            const modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+            const modelSettings = {
+                model: modelName,
+                max_tokens: modelRequirements.maxTokens || 2000, // <- Note: 2000 is for lagacy reasons
+                //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
+                // <- TODO: Use here `systemMessage`, `temperature` and `seed`
+            };
+
+            const rawRequest: xxxx.Completions.CompletionCreateParamsNonStreaming = {
+                ...modelSettings,
+                prompt: rawPromptContent,
+                user: this.options.user,
+            };
+            const start: string_date_iso8601 = getCurrentIsoDate();
+            let complete: string_date_iso8601;
+
+            if (this.options.isVerbose) {
+                console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+            }
+            const rawResponse = await this.client.completions.create(rawRequest);
+            if (this.options.isVerbose) {
+                console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+            }
+
+            if (!rawResponse.choices[0]) {
+                throw new PipelineExecutionError('No choises from Anthropic Claude');
+            }
+
+            if (rawResponse.choices.length > 1) {
+                // TODO: This should be maybe only warning
+                throw new PipelineExecutionError('More than one choise from Anthropic Claude');
+            }
+
+            const resultContent = rawResponse.choices[0].text;
+            // eslint-disable-next-line prefer-const
+            complete = getCurrentIsoDate();
+            const usage = { price: 'UNKNOWN', inputTokens: 0, outputTokens: 0 /* <- TODO: [🐞] Compute usage * / } satisfies PromptResultUsage;
+
+
+
+            return {
+                content: resultContent,
+                modelName: rawResponse.model || model,
+                timing: {
+                    start,
+                    complete,
+                },
+                usage,
+                rawResponse,
+                // <- [🗯]
+            };
+        }
+        */
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Get the model that should be used as default
+         */
+        AnthropicClaudeExecutionTools.prototype.getDefaultModel = function (defaultModelName) {
+            var model = ANTHROPIC_CLAUDE_MODELS.find(function (_a) {
+                var modelName = _a.modelName;
+                return modelName.startsWith(defaultModelName);
+            });
+            if (model === undefined) {
+                throw new UnexpectedError(spaceTrim__default["default"](function (block) {
+                    return "\n                          Cannot find model in OpenAI models with name \"".concat(defaultModelName, "\" which should be used as default.\n\n                          Available models:\n                          ").concat(block(ANTHROPIC_CLAUDE_MODELS.map(function (_a) {
+                        var modelName = _a.modelName;
+                        return "- \"".concat(modelName, "\"");
+                    }).join('\n')), "\n\n                      ");
+                }));
+            }
+            return model;
+        };
+        /**
+         * Default model for chat variant.
+         */
+        AnthropicClaudeExecutionTools.prototype.getDefaultChatModel = function () {
+            return this.getDefaultModel('claude-3-opus');
+        };
+        // <- Note: [🤖] getDefaultXxxModel
+        /**
+         * List all available Anthropic Claude models that can be used
+         */
+        AnthropicClaudeExecutionTools.prototype.listModels = function () {
+            return ANTHROPIC_CLAUDE_MODELS;
+        };
+        return AnthropicClaudeExecutionTools;
+    }());
+    /**
+     * TODO:  [🍆] JSON mode
+     * TODO: [🧠] Maybe handle errors via transformAnthropicError (like transformAzureError)
+     * TODO: Maybe Create some common util for callChatModel and callCompletionModel
+     * TODO: Maybe make custom OpenaiError
+     * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+     * TODO: [🍜] !!!!!! Auto use anonymous server in browser
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     * TODO: [📅] Maybe instead of `RemoteLlmExecutionToolsOptions` use `proxyWithAnonymousRemoteServer` (if implemented)
+     */
+
+    /**
+     * Execution Tools for calling Anthropic Claude API.
+     *
+     * @public exported from `@promptbook/anthropic-claude`
+     */
+    function createAnthropicClaudeExecutionTools(options) {
+        if (options.isProxied) {
+            return new RemoteLlmExecutionTools(__assign(__assign({}, options), { isAnonymous: true, llmToolsConfiguration: [
+                    {
+                        title: 'Anthropic Claude (proxied)',
+                        packageName: '@promptbook/anthropic-claude',
+                        className: 'AnthropicClaudeExecutionTools',
+                        options: __assign(__assign({}, options), { isProxied: false }),
+                    },
+                ] }));
+        }
+        return new AnthropicClaudeExecutionTools(options);
+    }
+    /**
+     * TODO: !!!!!! Make this with all LLM providers
+     * TODO: !!!!!! Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
+     */
+
+    /**
+     * List of available OpenAI models with pricing
+     *
+     * Note: Done at 2024-05-20
+     *
+     * @see https://platform.openai.com/docs/models/
+     * @see https://openai.com/api/pricing/
+     * @public exported from `@promptbook/openai`
+     */
+    var OPENAI_MODELS = [
+        /*/
+          {
+              modelTitle: 'dall-e-3',
+              modelName: 'dall-e-3',
+          },
+          /**/
+        /*/
+          {
+              modelTitle: 'whisper-1',
+              modelName: 'whisper-1',
+          },
+        /**/
+        /**/
+        {
+            modelVariant: 'COMPLETION',
+            modelTitle: 'davinci-002',
+            modelName: 'davinci-002',
+            pricing: {
+                prompt: computeUsage("$2.00 / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"), // <- not sure
+            },
+        },
+        /**/
+        /*/
+      {
+          modelTitle: 'dall-e-2',
+          modelName: 'dall-e-2',
+      },
+      /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-16k',
+            modelName: 'gpt-3.5-turbo-16k',
+            pricing: {
+                prompt: computeUsage("$3.00 / 1M tokens"),
+                output: computeUsage("$4.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /*/
+      {
+          modelTitle: 'tts-1-hd-1106',
+          modelName: 'tts-1-hd-1106',
+      },
+      /**/
+        /*/
+      {
+          modelTitle: 'tts-1-hd',
+          modelName: 'tts-1-hd',
+      },
+      /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4',
+            modelName: 'gpt-4',
+            pricing: {
+                prompt: computeUsage("$30.00 / 1M tokens"),
+                output: computeUsage("$60.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-32k',
+            modelName: 'gpt-4-32k',
+            pricing: {
+                prompt: computeUsage("$60.00 / 1M tokens"),
+                output: computeUsage("$120.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /*/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-0613',
+            modelName: 'gpt-4-0613',
+            pricing: {
+                prompt: computeUsage(` / 1M tokens`),
+                output: computeUsage(` / 1M tokens`),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-turbo-2024-04-09',
+            modelName: 'gpt-4-turbo-2024-04-09',
+            pricing: {
+                prompt: computeUsage("$10.00 / 1M tokens"),
+                output: computeUsage("$30.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-1106',
+            modelName: 'gpt-3.5-turbo-1106',
+            pricing: {
+                prompt: computeUsage("$1.00 / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-turbo',
+            modelName: 'gpt-4-turbo',
+            pricing: {
+                prompt: computeUsage("$10.00 / 1M tokens"),
+                output: computeUsage("$30.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'COMPLETION',
+            modelTitle: 'gpt-3.5-turbo-instruct-0914',
+            modelName: 'gpt-3.5-turbo-instruct-0914',
+            pricing: {
+                prompt: computeUsage("$1.50  / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"), // <- For gpt-3.5-turbo-instruct
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'COMPLETION',
+            modelTitle: 'gpt-3.5-turbo-instruct',
+            modelName: 'gpt-3.5-turbo-instruct',
+            pricing: {
+                prompt: computeUsage("$1.50  / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /*/
+      {
+          modelTitle: 'tts-1',
+          modelName: 'tts-1',
+      },
+      /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo',
+            modelName: 'gpt-3.5-turbo',
+            pricing: {
+                prompt: computeUsage("$3.00 / 1M tokens"),
+                output: computeUsage("$6.00 / 1M tokens"), // <- Not sure, refer to gpt-3.5-turbo in Fine-tuning models
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-0301',
+            modelName: 'gpt-3.5-turbo-0301',
+            pricing: {
+                prompt: computeUsage("$1.50 / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'COMPLETION',
+            modelTitle: 'babbage-002',
+            modelName: 'babbage-002',
+            pricing: {
+                prompt: computeUsage("$0.40 / 1M tokens"),
+                output: computeUsage("$0.40 / 1M tokens"), // <- Not sure
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-1106-preview',
+            modelName: 'gpt-4-1106-preview',
+            pricing: {
+                prompt: computeUsage("$10.00 / 1M tokens"),
+                output: computeUsage("$30.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-0125-preview',
+            modelName: 'gpt-4-0125-preview',
+            pricing: {
+                prompt: computeUsage("$10.00 / 1M tokens"),
+                output: computeUsage("$30.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /*/
+      {
+          modelTitle: 'tts-1-1106',
+          modelName: 'tts-1-1106',
+      },
+      /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-0125',
+            modelName: 'gpt-3.5-turbo-0125',
+            pricing: {
+                prompt: computeUsage("$0.50 / 1M tokens"),
+                output: computeUsage("$1.50  / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4-turbo-preview',
+            modelName: 'gpt-4-turbo-preview',
+            pricing: {
+                prompt: computeUsage("$10.00 / 1M tokens"),
+                output: computeUsage("$30.00 / 1M tokens"), // <- Not sure, just for gpt-4-turbo
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'EMBEDDING',
+            modelTitle: 'text-embedding-3-large',
+            modelName: 'text-embedding-3-large',
+            pricing: {
+                prompt: computeUsage("$0.13  / 1M tokens"),
+                // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+                output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'EMBEDDING',
+            modelTitle: 'text-embedding-3-small',
+            modelName: 'text-embedding-3-small',
+            pricing: {
+                prompt: computeUsage("$0.02 / 1M tokens"),
+                // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+                output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-0613',
+            modelName: 'gpt-3.5-turbo-0613',
+            pricing: {
+                prompt: computeUsage("$1.50 / 1M tokens"),
+                output: computeUsage("$2.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'EMBEDDING',
+            modelTitle: 'text-embedding-ada-002',
+            modelName: 'text-embedding-ada-002',
+            pricing: {
+                prompt: computeUsage("$0.1 / 1M tokens"),
+                // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+                output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+            },
+        },
+        /**/
+        /*/
+      {
+          modelVariant: 'CHAT',
+          modelTitle: 'gpt-4-1106-vision-preview',
+          modelName: 'gpt-4-1106-vision-preview',
+      },
+      /**/
+        /*/
+      {
+          modelVariant: 'CHAT',
+          modelTitle: 'gpt-4-vision-preview',
+          modelName: 'gpt-4-vision-preview',
+          pricing: {
+              prompt: computeUsage(`$10.00 / 1M tokens`),
+              output: computeUsage(`$30.00 / 1M tokens`),
+          },
+      },
+      /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4o-2024-05-13',
+            modelName: 'gpt-4o-2024-05-13',
+            pricing: {
+                prompt: computeUsage("$5.00 / 1M tokens"),
+                output: computeUsage("$15.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4o',
+            modelName: 'gpt-4o',
+            pricing: {
+                prompt: computeUsage("$5.00 / 1M tokens"),
+                output: computeUsage("$15.00 / 1M tokens"),
+            },
+        },
+        /**/
+        /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-3.5-turbo-16k-0613',
+            modelName: 'gpt-3.5-turbo-16k-0613',
+            pricing: {
+                prompt: computeUsage("$3.00 / 1M tokens"),
+                output: computeUsage("$4.00 / 1M tokens"),
+            },
+        },
+        /**/
+    ];
+    /**
+     * Note: [🤖] Add models of new variant
+     * TODO: [🧠] Some mechanism to propagate unsureness
+     * TODO: [🕚][👮‍♀️] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+     * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+     * @see https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4
+     * @see https://openai.com/api/pricing/
+     * @see /other/playground/playground.ts
+     * TODO: [🍓] Make better
+     * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
+     * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
+     */
+
+    /**
+     * Execution Tools for calling Azure OpenAI API.
+     *
+     * @public exported from `@promptbook/azure-openai`
+     */
+    var AzureOpenAiExecutionTools = /** @class */ (function () {
+        /**
+         * Creates OpenAI Execution Tools.
+         *
+         * @param options which are relevant are directly passed to the OpenAI client
+         */
+        function AzureOpenAiExecutionTools(options) {
+            this.options = options;
+            this.client = new openai.OpenAIClient("https://".concat(options.resourceName, ".openai.azure.com/"), new openai.AzureKeyCredential(options.apiKey));
+        }
+        Object.defineProperty(AzureOpenAiExecutionTools.prototype, "title", {
+            get: function () {
+                return 'Azure OpenAI';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(AzureOpenAiExecutionTools.prototype, "description", {
+            get: function () {
+                return 'Use all models trained by OpenAI provided by Azure';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * Calls OpenAI API to use a chat model.
+         */
+        AzureOpenAiExecutionTools.prototype.callChatModel = function (prompt) {
+            var _a, _b;
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, modelSettings, rawPromptContent, messages, start, complete, rawRequest, rawResponse, resultContent, usage, error_1;
+                var _c;
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('💬 OpenAI callChatModel call');
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'CHAT') {
+                                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                            }
+                            _d.label = 1;
+                        case 1:
+                            _d.trys.push([1, 3, , 4]);
+                            modelName = prompt.modelRequirements.modelName || this.options.deploymentName;
+                            modelSettings = {
+                                maxTokens: modelRequirements.maxTokens,
+                                //                                      <- TODO: [🌾] Make some global max cap for maxTokens
+                                temperature: modelRequirements.temperature,
+                                user: this.options.user,
+                                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                                // <- Note: [🧆]
+                            };
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            messages = __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
+                                ? []
+                                : [
+                                    {
+                                        role: 'system',
+                                        content: modelRequirements.systemMessage,
+                                    },
+                                ])), false), [
+                                {
+                                    role: 'user',
+                                    content: rawPromptContent,
+                                },
+                            ], false);
+                            start = getCurrentIsoDate();
+                            complete = void 0;
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('messages'), JSON.stringify(messages, null, 4));
+                            }
+                            rawRequest = [modelName, messages, modelSettings];
+                            return [4 /*yield*/, (_c = this.client).getChatCompletions.apply(_c, __spreadArray([], __read(rawRequest), false))];
+                        case 2:
+                            rawResponse = _d.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (!rawResponse.choices[0]) {
+                                throw new PipelineExecutionError('No choises from Azure OpenAI');
+                            }
+                            if (rawResponse.choices.length > 1) {
+                                // TODO: This should be maybe only warning
+                                throw new PipelineExecutionError('More than one choise from Azure OpenAI');
+                            }
+                            if (!rawResponse.choices[0].message || !rawResponse.choices[0].message.content) {
+                                throw new PipelineExecutionError('Empty response from Azure OpenAI');
+                            }
+                            resultContent = rawResponse.choices[0].message.content;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = {
+                                price: uncertainNumber() /* <- TODO: [🐞] Compute usage */,
+                                input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
+                                output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
+                            };
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                        case 3:
+                            error_1 = _d.sent();
+                            throw this.transformAzureError(error_1);
+                        case 4: return [2 /*return*/];
+                    }
+                });
+            });
+        };
+        /**
+         * Calls Azure OpenAI API to use a complete model.
+         */
+        AzureOpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
+            var _a, _b;
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, modelSettings, start, complete, rawPromptContent, rawRequest, rawResponse, resultContent, usage, error_2;
+                var _c;
+                return __generator(this, function (_d) {
+                    switch (_d.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('🖋 OpenAI callCompletionModel call');
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'COMPLETION') {
+                                throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+                            }
+                            _d.label = 1;
+                        case 1:
+                            _d.trys.push([1, 3, , 4]);
+                            modelName = prompt.modelRequirements.modelName || this.options.deploymentName;
+                            modelSettings = {
+                                maxTokens: modelRequirements.maxTokens || 2000,
+                                //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
+                                temperature: modelRequirements.temperature,
+                                user: this.options.user,
+                                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                                // <- Note: [🧆]
+                            };
+                            start = getCurrentIsoDate();
+                            complete = void 0;
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('content'), JSON.stringify(content, null, 4));
+                                console.info(colors__default["default"].bgWhite('parameters'), JSON.stringify(parameters, null, 4));
+                            }
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = [
+                                modelName,
+                                [rawPromptContent],
+                                modelSettings,
+                            ];
+                            return [4 /*yield*/, (_c = this.client).getCompletions.apply(_c, __spreadArray([], __read(rawRequest), false))];
+                        case 2:
+                            rawResponse = _d.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (!rawResponse.choices[0]) {
+                                throw new PipelineExecutionError('No choises from OpenAI');
+                            }
+                            if (rawResponse.choices.length > 1) {
+                                // TODO: This should be maybe only warning
+                                throw new PipelineExecutionError('More than one choise from OpenAI');
+                            }
+                            resultContent = rawResponse.choices[0].text;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = {
+                                price: uncertainNumber() /* <- TODO: [🐞] Compute usage */,
+                                input: __assign({ tokensCount: uncertainNumber((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.promptTokens) }, computeUsageCounts(prompt.content)),
+                                output: __assign({ tokensCount: uncertainNumber((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completionTokens) }, computeUsageCounts(prompt.content)),
+                            };
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                        case 3:
+                            error_2 = _d.sent();
+                            throw this.transformAzureError(error_2);
+                        case 4: return [2 /*return*/];
+                    }
+                });
+            });
+        };
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Changes Azure error (which is not propper Error but object) to propper Error
+         */
+        AzureOpenAiExecutionTools.prototype.transformAzureError = function (azureError) {
+            if (typeof azureError !== 'object' || azureError === null) {
+                return new PipelineExecutionError("Unknown Azure OpenAI error");
+            }
+            var code = azureError.code, message = azureError.message;
+            return new PipelineExecutionError("".concat(code, ": ").concat(message));
+        };
+        /**
+         * List all available Azure OpenAI models that can be used
+         */
+        AzureOpenAiExecutionTools.prototype.listModels = function () {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    // TODO: !!! Do here some filtering which models are really available as deployment
+                    //       @see https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/deployments?api-version=2023-05-01
+                    return [2 /*return*/, OPENAI_MODELS.map(function (_a) {
+                            var modelTitle = _a.modelTitle, modelName = _a.modelName, modelVariant = _a.modelVariant;
+                            return ({
+                                modelTitle: "Azure ".concat(modelTitle),
+                                modelName: modelName,
+                                modelVariant: modelVariant,
+                            });
+                        })];
+                });
+            });
+        };
+        return AzureOpenAiExecutionTools;
+    }());
+    /**
+     * TODO: Maybe Create some common util for callChatModel and callCompletionModel
+     * TODO: Maybe make custom AzureOpenaiError
+     * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     */
+
+    /**
+     * Computes the usage of the OpenAI API based on the response from OpenAI
+     *
+     * @param promptContent The content of the prompt
+     * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
+     * @param rawResponse The raw response from OpenAI API
+     * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
+     * @private internal utility of `OpenAiExecutionTools`
+     */
+    function computeOpenaiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
+    resultContent, rawResponse) {
+        var _a, _b;
+        if (rawResponse.usage === undefined) {
+            throw new PipelineExecutionError('The usage is not defined in the response from OpenAI');
+        }
+        if (((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) === undefined) {
+            throw new PipelineExecutionError('In OpenAI response `usage.prompt_tokens` not defined');
+        }
+        var inputTokens = rawResponse.usage.prompt_tokens;
+        var outputTokens = ((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completion_tokens) || 0;
+        var modelInfo = OPENAI_MODELS.find(function (model) { return model.modelName === rawResponse.model; });
+        var price;
+        if (modelInfo === undefined || modelInfo.pricing === undefined) {
+            price = uncertainNumber();
+        }
+        else {
+            price = uncertainNumber(inputTokens * modelInfo.pricing.prompt + outputTokens * modelInfo.pricing.output);
+        }
+        return {
+            price: price,
+            input: __assign({ tokensCount: uncertainNumber(rawResponse.usage.prompt_tokens) }, computeUsageCounts(promptContent)),
+            output: __assign({ tokensCount: uncertainNumber(outputTokens) }, computeUsageCounts(resultContent)),
+        };
+    }
+
+    /**
+     * Execution Tools for calling OpenAI API.
+     *
+     * @public exported from `@promptbook/openai`
+     */
+    var OpenAiExecutionTools = /** @class */ (function () {
+        /**
+         * Creates OpenAI Execution Tools.
+         *
+         * @param options which are relevant are directly passed to the OpenAI client
+         */
+        function OpenAiExecutionTools(options) {
+            if (options === void 0) { options = {}; }
+            this.options = options;
+            // Note: Passing only OpenAI relevant options to OpenAI constructor
+            var openAiOptions = __assign({}, options);
+            delete openAiOptions.isVerbose;
+            delete openAiOptions.user;
+            this.client = new OpenAI__default["default"](__assign({}, openAiOptions));
+        }
+        Object.defineProperty(OpenAiExecutionTools.prototype, "title", {
+            get: function () {
+                return 'OpenAI';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(OpenAiExecutionTools.prototype, "description", {
+            get: function () {
+                return 'Use all models provided by OpenAI';
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * Calls OpenAI API to use a chat model.
+         */
+        OpenAiExecutionTools.prototype.callChatModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, expectFormat, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('💬 OpenAI callChatModel call', { prompt: prompt });
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements, expectFormat = prompt.expectFormat;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'CHAT') {
+                                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                            }
+                            modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+                            modelSettings = {
+                                model: modelName,
+                                max_tokens: modelRequirements.maxTokens,
+                                //                                   <- TODO: [🌾] Make some global max cap for maxTokens
+                                temperature: modelRequirements.temperature,
+                                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                                // <- Note: [🧆]
+                            };
+                            if (expectFormat === 'JSON') {
+                                modelSettings.response_format = {
+                                    type: 'json_object',
+                                };
+                            }
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = __assign(__assign({}, modelSettings), { messages: __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
+                                    ? []
+                                    : [
+                                        {
+                                            role: 'system',
+                                            content: modelRequirements.systemMessage,
+                                        },
+                                    ])), false), [
+                                    {
+                                        role: 'user',
+                                        content: rawPromptContent,
+                                    },
+                                ], false), user: this.options.user });
+                            start = getCurrentIsoDate();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                            }
+                            return [4 /*yield*/, this.client.chat.completions.create(rawRequest)];
+                        case 1:
+                            rawResponse = _a.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (!rawResponse.choices[0]) {
+                                throw new PipelineExecutionError('No choises from OpenAI');
+                            }
+                            if (rawResponse.choices.length > 1) {
+                                // TODO: This should be maybe only warning
+                                throw new PipelineExecutionError('More than one choise from OpenAI');
+                            }
+                            resultContent = rawResponse.choices[0].message.content;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = computeOpenaiUsage(content, resultContent || '', rawResponse);
+                            if (resultContent === null) {
+                                throw new PipelineExecutionError('No response message from OpenAI');
+                            }
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: rawResponse.model || modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                    }
+                });
+            });
+        };
+        /**
+         * Calls OpenAI API to use a complete model.
+         */
+        OpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('🖋 OpenAI callCompletionModel call', { prompt: prompt });
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'COMPLETION') {
+                                throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+                            }
+                            modelName = modelRequirements.modelName || this.getDefaultCompletionModel().modelName;
+                            modelSettings = {
+                                model: modelName,
+                                max_tokens: modelRequirements.maxTokens || 2000,
+                                //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
+                                temperature: modelRequirements.temperature,
+                                // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                                // <- Note: [🧆]
+                            };
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: this.options.user });
+                            start = getCurrentIsoDate();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                            }
+                            return [4 /*yield*/, this.client.completions.create(rawRequest)];
+                        case 1:
+                            rawResponse = _a.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (!rawResponse.choices[0]) {
+                                throw new PipelineExecutionError('No choises from OpenAI');
+                            }
+                            if (rawResponse.choices.length > 1) {
+                                // TODO: This should be maybe only warning
+                                throw new PipelineExecutionError('More than one choise from OpenAI');
+                            }
+                            resultContent = rawResponse.choices[0].text;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = computeOpenaiUsage(content, resultContent || '', rawResponse);
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: rawResponse.model || modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                    }
+                });
+            });
+        };
+        /**
+         * Calls OpenAI API to use a embedding model
+         */
+        OpenAiExecutionTools.prototype.callEmbeddingModel = function (prompt) {
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (this.options.isVerbose) {
+                                console.info('🖋 OpenAI embedding call', { prompt: prompt });
+                            }
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            // TODO: [☂] Use here more modelRequirements
+                            if (modelRequirements.modelVariant !== 'EMBEDDING') {
+                                throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
+                            }
+                            modelName = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = {
+                                input: rawPromptContent,
+                                model: modelName,
+                            };
+                            start = getCurrentIsoDate();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                            }
+                            return [4 /*yield*/, this.client.embeddings.create(rawRequest)];
+                        case 1:
+                            rawResponse = _a.sent();
+                            if (this.options.isVerbose) {
+                                console.info(colors__default["default"].bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (rawResponse.data.length !== 1) {
+                                throw new PipelineExecutionError("Expected exactly 1 data item in response, got ".concat(rawResponse.data.length));
+                            }
+                            resultContent = rawResponse.data[0].embedding;
+                            // eslint-disable-next-line prefer-const
+                            complete = getCurrentIsoDate();
+                            usage = computeOpenaiUsage(content, '', rawResponse);
+                            return [2 /*return*/, {
+                                    content: resultContent,
+                                    modelName: rawResponse.model || modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: rawResponse,
+                                    // <- [🗯]
+                                }];
+                    }
+                });
+            });
+        };
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Get the model that should be used as default
+         */
+        OpenAiExecutionTools.prototype.getDefaultModel = function (defaultModelName) {
+            var model = OPENAI_MODELS.find(function (_a) {
+                var modelName = _a.modelName;
+                return modelName === defaultModelName;
+            });
+            if (model === undefined) {
+                throw new UnexpectedError(spaceTrim__default["default"](function (block) {
+                    return "\n                            Cannot find model in OpenAI models with name \"".concat(defaultModelName, "\" which should be used as default.\n\n                            Available models:\n                            ").concat(block(OPENAI_MODELS.map(function (_a) {
+                        var modelName = _a.modelName;
+                        return "- \"".concat(modelName, "\"");
+                    }).join('\n')), "\n\n                        ");
+                }));
+            }
+            return model;
+        };
+        /**
+         * Default model for chat variant.
+         */
+        OpenAiExecutionTools.prototype.getDefaultChatModel = function () {
+            return this.getDefaultModel('gpt-4o');
+        };
+        /**
+         * Default model for completion variant.
+         */
+        OpenAiExecutionTools.prototype.getDefaultCompletionModel = function () {
+            return this.getDefaultModel('gpt-3.5-turbo-instruct');
+        };
+        /**
+         * Default model for completion variant.
+         */
+        OpenAiExecutionTools.prototype.getDefaultEmbeddingModel = function () {
+            return this.getDefaultModel('text-embedding-3-large');
+        };
+        // <- Note: [🤖] getDefaultXxxModel
+        /**
+         * List all available OpenAI models that can be used
+         */
+        OpenAiExecutionTools.prototype.listModels = function () {
+            /*
+            Note: Dynamic lising of the models
+            const models = await this.openai.models.list({});
+
+            console.log({ models });
+            console.log(models.data);
+            */
+            return OPENAI_MODELS;
+        };
+        return OpenAiExecutionTools;
+    }());
+    /**
+     * TODO: [🧠][🧙‍♂️] Maybe there can be some wizzard for thoose who want to use just OpenAI
+     * TODO: Maybe Create some common util for callChatModel and callCompletionModel
+     * TODO: Maybe make custom OpenaiError
+     * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     */
+
+    /**
+     * @private internal type for `createLlmToolsFromConfiguration`
+     */
+    var EXECUTION_TOOLS_CLASSES = {
+        createOpenAiExecutionTools: function (options) {
+            return new OpenAiExecutionTools(__assign(__assign({}, options), { dangerouslyAllowBrowser: true /* <- TODO: [🧠] !!! Some mechanism for auto-detection of browser, maybe hide in `OpenAiExecutionTools` */ }));
+        },
+        createAnthropicClaudeExecutionTools: createAnthropicClaudeExecutionTools,
+        createAzureOpenAiExecutionTools: function (options) { return new AzureOpenAiExecutionTools(options); },
+        // <- Note: [🦑] Add here new LLM provider
+    };
+    /**
+     * TODO: [🧠] Better file name than `config.ts` + maybe move to two separate files
+     * TODO: [🧠][🎌] Adding this should be responsibility of each provider package NOT this one central place
+     */
+
+    /**
+     * @@@
+     *
+     * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
+     *
+     * @returns @@@
+     * @public exported from `@promptbook/core`
+     */
+    function createLlmToolsFromConfiguration(configuration, options) {
+        if (options === void 0) { options = {}; }
+        var _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
+        dotenv__namespace.config();
+        var llmTools = configuration.map(function (llmConfiguration) {
+            return EXECUTION_TOOLS_CLASSES["create".concat(llmConfiguration.className)](__assign({ isVerbose: isVerbose }, llmConfiguration.options));
+        });
+        return joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(llmTools), false));
+    }
+    /**
+     * TODO: [🎌] Togethere with `createLlmToolsFromConfiguration` + 'EXECUTION_TOOLS_CLASSES' gets to `@promptbook/core` ALL model providers, make this more efficient
+     * TODO: [🧠][🎌] Dynamically install required providers
+     * TODO: @@@ write discussion about this - wizzard
+     * TODO: [🧠][🍛] Which name is better `createLlmToolsFromConfig` or `createLlmToolsFromConfiguration`?
+     * TODO: [🧠] Is there some meaningfull way how to test this util
+     * TODO: This should be maybe not under `_common` but under `utils`
+     */
+
+    /**
+     * 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, isCollectionModeAllowed: false, collection: null, createLlmExecutionTools: null }, options), port = _a.port, path = _a.path, collection = _a.collection, createLlmExecutionTools = _a.createLlmExecutionTools, 
+        //    <- TODO: [🧠][🤺] Remove `createLlmExecutionTools`, pass just `llmExecutionTools`
+        isAnonymousModeAllowed = _a.isAnonymousModeAllowed, isCollectionModeAllowed = _a.isCollectionModeAllowed, _b = _a.isVerbose, isVerbose = _b === void 0 ? false : _b;
+        // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
+        var httpServer = http__default["default"].createServer({}, 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).write;
+                        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_VERSION, "\n                    Anonymouse mode: ").concat(isAnonymousModeAllowed ? 'enabled' : 'disabled', "\n                    Collection mode: ").concat(isCollectionModeAllowed ? 'enabled' : 'disabled', "\n                    ")).concat;
+                                            _c = block;
+                                            if (!!isCollectionModeAllowed) 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, [_d.sent()]);
+                        response.end();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        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) {
+            console.info(colors__default["default"].gray("Client connected"), socket.id);
+            socket.on('request', function (request) { return __awaiter(_this, void 0, void 0, function () {
+                var _a, prompt, clientId, llmToolsConfiguration, llmExecutionTools, promptResult, _b, error_1;
+                return __generator(this, function (_c) {
+                    switch (_c.label) {
+                        case 0:
+                            _a = __assign({ clientId: null, llmToolsConfiguration: null }, request), prompt = _a.prompt, clientId = _a.clientId, llmToolsConfiguration = _a.llmToolsConfiguration;
+                            // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
+                            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, 14, 15, 16]);
+                            if (llmToolsConfiguration !== null && !isAnonymousModeAllowed) {
+                                throw new PipelineExecutionError("Anonymous mode is not allowed"); // <- TODO: !!!!!! Test
+                            }
+                            if (clientId !== null && !isCollectionModeAllowed) {
+                                throw new PipelineExecutionError("Collection mode is not allowed"); // <- TODO: !!!!!! Test
+                            }
+                            llmExecutionTools = void 0;
+                            if (!(llmToolsConfiguration !== null)) return [3 /*break*/, 2];
+                            // Note: Anonymouse mode
+                            // TODO: Maybe check that configuration is not empty
+                            llmExecutionTools = createLlmToolsFromConfiguration(llmToolsConfiguration);
+                            return [3 /*break*/, 5];
+                        case 2:
+                            if (!(createLlmExecutionTools !== null)) return [3 /*break*/, 4];
+                            // Note: Collection mode
+                            llmExecutionTools = createLlmExecutionTools(clientId);
+                            return [4 /*yield*/, collection.isResponsibleForPrompt(prompt)];
+                        case 3:
+                            if (!(_c.sent())) {
+                                throw new PipelineExecutionError("Pipeline is not in the collection of this server");
+                            }
+                            return [3 /*break*/, 5];
+                        case 4: throw new PipelineExecutionError("You must provide either llmToolsConfiguration or createLlmExecutionTools");
+                        case 5:
+                            promptResult = void 0;
+                            _b = prompt.modelRequirements.modelVariant;
+                            switch (_b) {
+                                case 'CHAT': return [3 /*break*/, 6];
+                                case 'COMPLETION': return [3 /*break*/, 8];
+                                case 'EMBEDDING': return [3 /*break*/, 10];
+                            }
+                            return [3 /*break*/, 12];
+                        case 6:
+                            if (llmExecutionTools.callChatModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Chat model is not available");
+                            }
+                            return [4 /*yield*/, llmExecutionTools.callChatModel(prompt)];
+                        case 7:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 13];
+                        case 8:
+                            if (llmExecutionTools.callCompletionModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Completion model is not available");
+                            }
+                            return [4 /*yield*/, llmExecutionTools.callCompletionModel(prompt)];
+                        case 9:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 13];
+                        case 10:
+                            if (llmExecutionTools.callEmbeddingModel === undefined) {
+                                // Note: [0] This check should not be a thing
+                                throw new PipelineExecutionError("Embedding model is not available");
+                            }
+                            return [4 /*yield*/, llmExecutionTools.callEmbeddingModel(prompt)];
+                        case 11:
+                            promptResult = _c.sent();
+                            return [3 /*break*/, 13];
+                        case 12: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
+                        case 13:
+                            if (isVerbose) {
+                                console.info(colors__default["default"].bgGreen("PromptResult:"), colors__default["default"].green(JSON.stringify(promptResult, null, 4)));
+                            }
+                            socket.emit('response', { promptResult: promptResult });
+                            return [3 /*break*/, 16];
+                        case 14:
+                            error_1 = _c.sent();
+                            if (!(error_1 instanceof Error)) {
+                                throw error_1;
+                            }
+                            socket.emit('error', { errorMessage: error_1.message });
+                            return [3 /*break*/, 16];
+                        case 15:
                             socket.disconnect();
                             return [7 /*endfinally*/];
-                        case 13: return [2 /*return*/];
+                        case 16: return [2 /*return*/];
                     }
                 });
             }); });
@@ -235,13 +2633,14 @@
         };
     }
     /**
-     * TODO: [🍜] Add anonymous option
+     * TODO: [🍜] !!!!!! Add anonymous option
      * 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: Constrain anonymous mode for specific models / providers
      */
 
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;