@promptbook/openai 0.72.0-0 → 0.72.0-10

package/esm/index.es.js

@@ -1,13 +1,13 @@
 import colors from 'colors';
-import OpenAI from 'openai';
 import spaceTrim$1, { spaceTrim } from 'spacetrim';
+import OpenAI from '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.68.5';
-// TODO:[main] !!!! List here all the versions and annotate + put into script
+var PROMPTBOOK_VERSION = '0.72.0-9';
+// TODO: [main] !!!! List here all the versions and annotate + put into script
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -147,46 +147,37 @@ var $isRunningInBrowser = new Function("\n    try {\n        return this === win
 var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
 
 /**
- * This error indicates errors during the execution of the pipeline
+ * This error type indicates that some part of the code is not implemented yet
  *
  * @public exported from `@promptbook/core`
  */
-var PipelineExecutionError = /** @class */ (function (_super) {
-    __extends(PipelineExecutionError, _super);
-    function PipelineExecutionError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'PipelineExecutionError';
-        Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
+var NotYetImplementedError = /** @class */ (function (_super) {
+    __extends(NotYetImplementedError, _super);
+    function NotYetImplementedError(message) {
+        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+        _this.name = 'NotYetImplementedError';
+        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
         return _this;
     }
-    return PipelineExecutionError;
+    return NotYetImplementedError;
 }(Error));
 
 /**
- * This error type indicates that the error should not happen and its last check before crashing with some other error
+ * This error indicates errors during the execution of the pipeline
  *
  * @public exported from `@promptbook/core`
  */
-var UnexpectedError = /** @class */ (function (_super) {
-    __extends(UnexpectedError, _super);
-    function UnexpectedError(message) {
-        var _this = _super.call(this, 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);
+var PipelineExecutionError = /** @class */ (function (_super) {
+    __extends(PipelineExecutionError, _super);
+    function PipelineExecutionError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PipelineExecutionError';
+        Object.setPrototypeOf(_this, PipelineExecutionError.prototype);
         return _this;
     }
-    return UnexpectedError;
+    return PipelineExecutionError;
 }(Error));
 
-/**
- * Get current date in ISO 8601 format
- *
- * @private internal utility
- */
-function getCurrentIsoDate() {
-    return new Date().toISOString();
-}
-
 /**
  * @@@
  *
@@ -221,6 +212,84 @@ function $deepFreeze(objectValue) {
  * TODO: [🧠] Is there a way how to meaningfully test this utility
  */
 
+/**
+ * Represents the usage with no resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+$deepFreeze({
+    price: { value: 0 },
+    input: {
+        tokensCount: { value: 0 },
+        charactersCount: { value: 0 },
+        wordsCount: { value: 0 },
+        sentencesCount: { value: 0 },
+        linesCount: { value: 0 },
+        paragraphsCount: { value: 0 },
+        pagesCount: { value: 0 },
+    },
+    output: {
+        tokensCount: { value: 0 },
+        charactersCount: { value: 0 },
+        wordsCount: { value: 0 },
+        sentencesCount: { value: 0 },
+        linesCount: { value: 0 },
+        paragraphsCount: { value: 0 },
+        pagesCount: { value: 0 },
+    },
+});
+/**
+ * Represents the usage with unknown resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+var UNCERTAIN_USAGE = $deepFreeze({
+    price: { value: 0, isUncertain: true },
+    input: {
+        tokensCount: { value: 0, isUncertain: true },
+        charactersCount: { value: 0, isUncertain: true },
+        wordsCount: { value: 0, isUncertain: true },
+        sentencesCount: { value: 0, isUncertain: true },
+        linesCount: { value: 0, isUncertain: true },
+        paragraphsCount: { value: 0, isUncertain: true },
+        pagesCount: { value: 0, isUncertain: true },
+    },
+    output: {
+        tokensCount: { value: 0, isUncertain: true },
+        charactersCount: { value: 0, isUncertain: true },
+        wordsCount: { value: 0, isUncertain: true },
+        sentencesCount: { value: 0, isUncertain: true },
+        linesCount: { value: 0, isUncertain: true },
+        paragraphsCount: { value: 0, isUncertain: true },
+        pagesCount: { value: 0, isUncertain: true },
+    },
+});
+
+/**
+ * Get current date in ISO 8601 format
+ *
+ * @private internal utility
+ */
+function getCurrentIsoDate() {
+    return new Date().toISOString();
+}
+
+/**
+ * This error type indicates that the error should not happen and its last check before crashing with some other error
+ *
+ * @public exported from `@promptbook/core`
+ */
+var UnexpectedError = /** @class */ (function (_super) {
+    __extends(UnexpectedError, _super);
+    function UnexpectedError(message) {
+        var _this = _super.call(this, 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));
+
 /**
  * Checks if the value is [🚉] serializable as JSON
  * If not, throws an UnexpectedError with a rich error message and tracking
@@ -389,6 +458,7 @@ $asDeeplyFrozenSerializableJson('RESERVED_PARAMETER_NAMES', [
     'samples',
     'modelName',
     'currentDate',
+    // <- TODO: !!!!! list here all command names
     // <- TODO: Add more like 'date', 'modelName',...
     // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
 ]);
@@ -404,6 +474,18 @@ var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
  * @private within the repository
  */
 var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
+// <- TODO: [🧜‍♂️]
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+Object.freeze({
+    delimiter: ',',
+    quoteChar: '"',
+    newline: '\n',
+    skipEmptyLines: true,
+});
 /**
  * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
  */
@@ -1196,7 +1278,7 @@ var OPENAI_MODELS = $asDeeplyFrozenSerializableJson('OPENAI_MODELS', [
             prompt: computeUsage("$5.00 / 1M tokens"),
             output: computeUsage("$15.00 / 1M tokens"),
         },
-        //TODO:[main] !!!!!! Add gpt-4o-mini-2024-07-18 and all others to be up to date
+        //TODO: [main] !!! Add gpt-4o-mini-2024-07-18 and all others to be up to date
     },
     /**/
     /**/
@@ -1226,7 +1308,7 @@ var OPENAI_MODELS = $asDeeplyFrozenSerializableJson('OPENAI_MODELS', [
         modelVariant: 'CHAT',
         modelTitle: 'o1-preview-2024-09-12',
         modelName: 'o1-preview-2024-09-12',
-        //             <- TODO:[main] !!!!!! Some better system to organize theese date suffixes and versions
+        //             <- TODO: [main] !!! Some better system to organize theese date suffixes and versions
         pricing: {
             prompt: computeUsage("$15.00 / 1M tokens"),
             output: computeUsage("$60.00 / 1M tokens"),
@@ -1331,7 +1413,6 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * @param options which are relevant are directly passed to the OpenAI client
      */
     function OpenAiExecutionTools(options) {
-        if (options === void 0) { options = {}; }
         this.options = options;
         /**
          * OpenAI API client.
@@ -1359,13 +1440,22 @@ var OpenAiExecutionTools = /** @class */ (function () {
                 if (this.client === null) {
                     openAiOptions = __assign({}, this.options);
                     delete openAiOptions.isVerbose;
-                    delete openAiOptions.user;
-                    this.client = new OpenAI(__assign({}, openAiOptions));
+                    delete openAiOptions.userId;
+                    this.client = new OpenAI(openAiOptions);
                 }
                 return [2 /*return*/, this.client];
             });
         });
     };
+    /**
+     * Create (sub)tools for calling OpenAI API Assistants
+     *
+     * @param assistantId Which assistant to use
+     * @returns Tools for calling OpenAI API Assistants with same token
+     */
+    OpenAiExecutionTools.prototype.createAssistantSubtools = function (assistantId) {
+        return new OpenAiAssistantExecutionTools(__assign(__assign({}, this.options), { assistantId: assistantId }));
+    };
     /**
      * Check the `options` passed to `constructor`
      */
@@ -1398,10 +1488,12 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * Calls OpenAI API to use a chat model.
      */
     OpenAiExecutionTools.prototype.callChatModel = function (prompt) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var content, parameters, modelRequirements, format, client, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         if (this.options.isVerbose) {
                             console.info('💬 OpenAI callChatModel call', { prompt: prompt });
@@ -1409,7 +1501,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements, format = prompt.format;
                         return [4 /*yield*/, this.getClient()];
                     case 1:
-                        client = _a.sent();
+                        client = _b.sent();
                         // TODO: [☂] Use here more modelRequirements
                         if (modelRequirements.modelVariant !== 'CHAT') {
                             throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
@@ -1441,14 +1533,19 @@ var OpenAiExecutionTools = /** @class */ (function () {
                                     role: 'user',
                                     content: rawPromptContent,
                                 },
-                            ], false), user: this.options.user });
+                            ], false), user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                         start = getCurrentIsoDate();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
                         }
-                        return [4 /*yield*/, client.chat.completions.create(rawRequest)];
+                        return [4 /*yield*/, client.chat.completions.create(rawRequest).catch(function (error) {
+                                if (_this.options.isVerbose) {
+                                    console.info(colors.bgRed('error'), error);
+                                }
+                                throw error;
+                            })];
                     case 2:
-                        rawResponse = _a.sent();
+                        rawResponse = _b.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -1462,7 +1559,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         resultContent = rawResponse.choices[0].message.content;
                         // eslint-disable-next-line prefer-const
                         complete = getCurrentIsoDate();
-                        usage = computeOpenAiUsage(content, resultContent || '', rawResponse);
+                        usage = computeOpenAiUsage(content || '', resultContent || '', rawResponse);
                         if (resultContent === null) {
                             throw new PipelineExecutionError('No response message from OpenAI');
                         }
@@ -1487,10 +1584,12 @@ var OpenAiExecutionTools = /** @class */ (function () {
      * Calls OpenAI API to use a complete model.
      */
     OpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var content, parameters, modelRequirements, client, modelName, modelSettings, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         if (this.options.isVerbose) {
                             console.info('🖋 OpenAI callCompletionModel call', { prompt: prompt });
@@ -1498,7 +1597,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
                         return [4 /*yield*/, this.getClient()];
                     case 1:
-                        client = _a.sent();
+                        client = _b.sent();
                         // TODO: [☂] Use here more modelRequirements
                         if (modelRequirements.modelVariant !== 'COMPLETION') {
                             throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
@@ -1513,14 +1612,19 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             // <- Note: [🧆]
                         };
                         rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
-                        rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: this.options.user });
+                        rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                         start = getCurrentIsoDate();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
                         }
-                        return [4 /*yield*/, client.completions.create(rawRequest)];
+                        return [4 /*yield*/, client.completions.create(rawRequest).catch(function (error) {
+                                if (_this.options.isVerbose) {
+                                    console.info(colors.bgRed('error'), error);
+                                }
+                                throw error;
+                            })];
                     case 2:
-                        rawResponse = _a.sent();
+                        rawResponse = _b.sent();
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
                         }
@@ -1534,7 +1638,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         resultContent = rawResponse.choices[0].text;
                         // eslint-disable-next-line prefer-const
                         complete = getCurrentIsoDate();
-                        usage = computeOpenAiUsage(content, resultContent || '', rawResponse);
+                        usage = computeOpenAiUsage(content || '', resultContent || '', rawResponse);
                         return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiExecutionTools CompletionPromptResult', {
                                 content: resultContent,
                                 modelName: rawResponse.model || modelName,
@@ -1558,6 +1662,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
     OpenAiExecutionTools.prototype.callEmbeddingModel = function (prompt) {
         return __awaiter(this, void 0, void 0, function () {
             var content, parameters, modelRequirements, client, modelName, rawPromptContent, rawRequest, start, complete, rawResponse, resultContent, usage;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -1582,7 +1687,12 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
                         }
-                        return [4 /*yield*/, client.embeddings.create(rawRequest)];
+                        return [4 /*yield*/, client.embeddings.create(rawRequest).catch(function (error) {
+                                if (_this.options.isVerbose) {
+                                    console.info(colors.bgRed('error'), error);
+                                }
+                                throw error;
+                            })];
                     case 2:
                         rawResponse = _a.sent();
                         if (this.options.isVerbose) {
@@ -1594,7 +1704,9 @@ var OpenAiExecutionTools = /** @class */ (function () {
                         resultContent = rawResponse.data[0].embedding;
                         // eslint-disable-next-line prefer-const
                         complete = getCurrentIsoDate();
-                        usage = computeOpenAiUsage(content, '', rawResponse);
+                        usage = computeOpenAiUsage(content || '', '', 
+                        // <- Note: Embedding does not have result content
+                        rawResponse);
                         return [2 /*return*/, $asDeeplyFrozenSerializableJson('OpenAiExecutionTools EmbeddingPromptResult', {
                                 content: resultContent,
                                 modelName: rawResponse.model || modelName,
@@ -1659,95 +1771,6 @@ var OpenAiExecutionTools = /** @class */ (function () {
  * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
  */
 
-/**
- * Execution Tools for calling OpenAI API
- *
- * @public exported from `@promptbook/openai`
- */
-var createOpenAiExecutionTools = Object.assign(function (options) {
-    // TODO: [🧠][main] !!!! If browser, auto add `dangerouslyAllowBrowser`
-    if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
-        options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
-    }
-    return new OpenAiExecutionTools(options);
-}, {
-    packageName: '@promptbook/openai',
-    className: 'OpenAiExecutionTools',
-});
-/**
- * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */
-
-/**
- * This error type indicates that some part of the code is not implemented yet
- *
- * @public exported from `@promptbook/core`
- */
-var NotYetImplementedError = /** @class */ (function (_super) {
-    __extends(NotYetImplementedError, _super);
-    function NotYetImplementedError(message) {
-        var _this = _super.call(this, spaceTrim(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This feature is not implemented yet but it will be soon.\n\n                    If you want speed up the implementation or just read more, look here:\n                    https://github.com/webgptorg/promptbook\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
-        _this.name = 'NotYetImplementedError';
-        Object.setPrototypeOf(_this, NotYetImplementedError.prototype);
-        return _this;
-    }
-    return NotYetImplementedError;
-}(Error));
-
-/**
- * Represents the usage with no resources consumed
- *
- * @public exported from `@promptbook/core`
- */
-$deepFreeze({
-    price: { value: 0 },
-    input: {
-        tokensCount: { value: 0 },
-        charactersCount: { value: 0 },
-        wordsCount: { value: 0 },
-        sentencesCount: { value: 0 },
-        linesCount: { value: 0 },
-        paragraphsCount: { value: 0 },
-        pagesCount: { value: 0 },
-    },
-    output: {
-        tokensCount: { value: 0 },
-        charactersCount: { value: 0 },
-        wordsCount: { value: 0 },
-        sentencesCount: { value: 0 },
-        linesCount: { value: 0 },
-        paragraphsCount: { value: 0 },
-        pagesCount: { value: 0 },
-    },
-});
-/**
- * Represents the usage with unknown resources consumed
- *
- * @public exported from `@promptbook/core`
- */
-var UNCERTAIN_USAGE = $deepFreeze({
-    price: { value: 0, isUncertain: true },
-    input: {
-        tokensCount: { value: 0, isUncertain: true },
-        charactersCount: { value: 0, isUncertain: true },
-        wordsCount: { value: 0, isUncertain: true },
-        sentencesCount: { value: 0, isUncertain: true },
-        linesCount: { value: 0, isUncertain: true },
-        paragraphsCount: { value: 0, isUncertain: true },
-        pagesCount: { value: 0, isUncertain: true },
-    },
-    output: {
-        tokensCount: { value: 0, isUncertain: true },
-        charactersCount: { value: 0, isUncertain: true },
-        wordsCount: { value: 0, isUncertain: true },
-        sentencesCount: { value: 0, isUncertain: true },
-        linesCount: { value: 0, isUncertain: true },
-        paragraphsCount: { value: 0, isUncertain: true },
-        pagesCount: { value: 0, isUncertain: true },
-    },
-});
-
 /**
  * Execution Tools for calling OpenAI API Assistants
  *
@@ -1763,8 +1786,9 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
      * @param options which are relevant are directly passed to the OpenAI client
      */
     function OpenAiAssistantExecutionTools(options) {
-        if (options === void 0) { options = {}; }
-        return _super.call(this, options) || this;
+        var _this = _super.call(this, options) || this;
+        _this.assistantId = options.assistantId;
+        return _this;
     }
     Object.defineProperty(OpenAiAssistantExecutionTools.prototype, "title", {
         get: function () {
@@ -1821,14 +1845,13 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                         }
                         rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: 'assistant' }));
                         rawRequest = {
-                            // [👨‍👨‍👧‍👧] ...modelSettings,
-                            assistant_id: 'asst_CJCZzFCbBL0f2D4OWMXVTdBB',
-                            //             <- Note: This is not a private information, just ID of the assistant which is accessible only with correct API key
+                            // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
+                            // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sence - combination of OpenAI assistants with Promptbook Personas
+                            assistant_id: this.assistantId,
                             thread: {
                                 messages: [
-                                    // TODO: !!!!!! Unhardcode
                                     // TODO: !!!!!! Allow threads to be passed
-                                    { role: 'user', content: 'What is the meaning of life? I want breathtaking speech.' },
+                                    { role: 'user', content: rawPromptContent },
                                 ],
                             },
                             // !!!!!! user: this.options.user,
@@ -1837,6 +1860,7 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                         if (this.options.isVerbose) {
                             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
                         }
+                        console.log('!!!!!! OpenAI client', client);
                         return [4 /*yield*/, client.beta.threads.createAndRunStream(rawRequest)];
                     case 2:
                         stream = _g.sent();
@@ -1918,6 +1942,46 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
  * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
  */
 
+/**
+ * Execution Tools for calling OpenAI API
+ *
+ * @public exported from `@promptbook/openai`
+ */
+var createOpenAiAssistantExecutionTools = Object.assign(function (options) {
+    // TODO: [🧠][main] !!!! If browser, auto add `dangerouslyAllowBrowser`
+    if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
+        options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
+    }
+    return new OpenAiAssistantExecutionTools(options);
+}, {
+    packageName: '@promptbook/openai',
+    className: 'OpenAiAssistantExecutionTools',
+});
+/**
+ * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ */
+
+/**
+ * Execution Tools for calling OpenAI API
+ *
+ * @public exported from `@promptbook/openai`
+ */
+var createOpenAiExecutionTools = Object.assign(function (options) {
+    // TODO: [🧠][main] !!!! If browser, auto add `dangerouslyAllowBrowser`
+    if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
+        options = __assign(__assign({}, options), { dangerouslyAllowBrowser: true });
+    }
+    return new OpenAiExecutionTools(options);
+}, {
+    packageName: '@promptbook/openai',
+    className: 'OpenAiExecutionTools',
+});
+/**
+ * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ */
+
 /**
  * @@@
  *
@@ -1929,6 +1993,85 @@ function $getGlobalScope() {
     return Function('return this')();
 }
 
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @returns @@@
+ * @example 'HELLO_WORLD'
+ * @example 'I_LOVE_PROMPTBOOK'
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_SCREAMING_CASE(text) {
+    var e_1, _a;
+    var charType;
+    var lastCharType = 'OTHER';
+    var normalizedName = '';
+    try {
+        for (var text_1 = __values(text), text_1_1 = text_1.next(); !text_1_1.done; text_1_1 = text_1.next()) {
+            var char = text_1_1.value;
+            var normalizedChar = void 0;
+            if (/^[a-z]$/.test(char)) {
+                charType = 'LOWERCASE';
+                normalizedChar = char.toUpperCase();
+            }
+            else if (/^[A-Z]$/.test(char)) {
+                charType = 'UPPERCASE';
+                normalizedChar = char;
+            }
+            else if (/^[0-9]$/.test(char)) {
+                charType = 'NUMBER';
+                normalizedChar = char;
+            }
+            else {
+                charType = 'OTHER';
+                normalizedChar = '_';
+            }
+            if (charType !== lastCharType &&
+                !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+                !(lastCharType === 'NUMBER') &&
+                !(charType === 'NUMBER')) {
+                normalizedName += '_';
+            }
+            normalizedName += normalizedChar;
+            lastCharType = charType;
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (text_1_1 && !text_1_1.done && (_a = text_1.return)) _a.call(text_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    normalizedName = normalizedName.replace(/_+/g, '_');
+    normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+    normalizedName = normalizedName.replace(/^_/, '');
+    normalizedName = normalizedName.replace(/_$/, '');
+    return normalizedName;
+}
+/**
+ * TODO: Tests
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+ * TODO: [🌺] Use some intermediate util splitWords
+ */
+
+/**
+ * @@@
+ *
+ * @param text @@@
+ * @returns @@@
+ * @example 'hello_world'
+ * @example 'i_love_promptbook'
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_snake_case(text) {
+    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+}
+
 /**
  * Register is @@@
  *
@@ -1937,9 +2080,9 @@ function $getGlobalScope() {
  * @private internal utility, exported are only signleton instances of this class
  */
 var $Register = /** @class */ (function () {
-    function $Register(storageName) {
-        this.storageName = storageName;
-        storageName = "_promptbook_".concat(storageName);
+    function $Register(registerName) {
+        this.registerName = registerName;
+        var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
         var globalScope = $getGlobalScope();
         if (globalScope[storageName] === undefined) {
             globalScope[storageName] = [];
@@ -1954,7 +2097,6 @@ var $Register = /** @class */ (function () {
         return this.storage;
     };
     $Register.prototype.register = function (registered) {
-        //                                    <- TODO: What to return here
         var packageName = registered.packageName, className = registered.className;
         var existingRegistrationIndex = this.storage.findIndex(function (item) { return item.packageName === packageName && item.className === className; });
         var existingRegistration = this.storage[existingRegistrationIndex];
@@ -1964,6 +2106,17 @@ var $Register = /** @class */ (function () {
         else {
             this.storage[existingRegistrationIndex] = registered;
         }
+        return {
+            registerName: this.registerName,
+            packageName: packageName,
+            className: className,
+            get isDestroyed() {
+                return false;
+            },
+            destroy: function () {
+                throw new NotYetImplementedError("Registration to ".concat(this.registerName, " is permanent in this version of Promptbook"));
+            },
+        };
     };
     return $Register;
 }());
@@ -1976,7 +2129,19 @@ var $Register = /** @class */ (function () {
  * @public exported from `@promptbook/core`
  */
 var $llmToolsRegister = new $Register('llm_execution_tools_constructors');
+/**
+ * TODO: [®] DRY Register logic
+ */
 
+/**
+ * Registration of LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/openai`
+ * @public exported from `@promptbook/cli`
+ */
+var _OpenAiRegistration = $llmToolsRegister.register(createOpenAiExecutionTools);
 /**
  * @@@ registration2
  *
@@ -1985,10 +2150,10 @@ var $llmToolsRegister = new $Register('llm_execution_tools_constructors');
  * @public exported from `@promptbook/openai`
  * @public exported from `@promptbook/cli`
  */
-var _OpenAiRegistration = $llmToolsRegister.register(createOpenAiExecutionTools);
+var _OpenAiAssistantRegistration = $llmToolsRegister.register(createOpenAiAssistantExecutionTools);
 /**
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
  */
 
-export { OPENAI_MODELS, OpenAiAssistantExecutionTools, OpenAiExecutionTools, PROMPTBOOK_VERSION, _OpenAiRegistration, createOpenAiExecutionTools };
+export { OPENAI_MODELS, OpenAiAssistantExecutionTools, OpenAiExecutionTools, PROMPTBOOK_VERSION, _OpenAiAssistantRegistration, _OpenAiRegistration, createOpenAiAssistantExecutionTools, createOpenAiExecutionTools };
 //# sourceMappingURL=index.es.js.map