@promptbook/cli 0.77.0-3 → 0.77.0-5

package/esm/index.es.js

@@ -37,7 +37,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  *
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.77.0-2';
+var PROMPTBOOK_ENGINE_VERSION = '0.77.0-4';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -660,6 +660,312 @@ function initializeHelloCommand(program) {
  * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */
 
+/**
+ * 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));
+
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it access global scope
+ *
+ *  @private internal function of `$Register`
+ */
+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 @@@
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
+ *
+ * @private internal utility, exported are only signleton instances of this class
+ */
+var $Register = /** @class */ (function () {
+    function $Register(registerName) {
+        this.registerName = registerName;
+        var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
+        var globalScope = $getGlobalScope();
+        if (globalScope[storageName] === undefined) {
+            globalScope[storageName] = [];
+        }
+        else if (!Array.isArray(globalScope[storageName])) {
+            throw new UnexpectedError("Expected (global) ".concat(storageName, " to be an array, but got ").concat(typeof globalScope[storageName]));
+        }
+        this.storage = globalScope[storageName];
+    }
+    $Register.prototype.list = function () {
+        // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
+        return this.storage;
+    };
+    $Register.prototype.register = function (registered) {
+        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];
+        if (!existingRegistration) {
+            this.storage.push(registered);
+        }
+        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;
+}());
+
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this interacts with the global scope
+ * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @public exported from `@promptbook/core`
+ */
+var $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
+/**
+ * TODO: [®] DRY Register logic
+ */
+
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this interacts with the global scope
+ * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @public exported from `@promptbook/core`
+ */
+var $llmToolsRegister = new $Register('llm_execution_tools_constructors');
+/**
+ * TODO: [®] DRY Register logic
+ */
+
+/**
+ * Creates a message with all registered LLM tools
+ *
+ * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
+ *
+ * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
+ */
+function $registeredLlmToolsMessage() {
+    var e_1, _a, e_2, _b;
+    /**
+     * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
+     */
+    var all = [];
+    var _loop_1 = function (packageName, className, envVariables) {
+        if (all.some(function (item) { return item.packageName === packageName && item.className === className; })) {
+            return "continue";
+        }
+        all.push({ packageName: packageName, className: className, envVariables: envVariables });
+    };
+    try {
+        for (var _c = __values($llmToolsMetadataRegister.list()), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var _e = _d.value, packageName = _e.packageName, className = _e.className, envVariables = _e.envVariables;
+            _loop_1(packageName, className, envVariables);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var _loop_2 = function (packageName, className) {
+        if (all.some(function (item) { return item.packageName === packageName && item.className === className; })) {
+            return "continue";
+        }
+        all.push({ packageName: packageName, className: className });
+    };
+    try {
+        for (var _f = __values($llmToolsRegister.list()), _g = _f.next(); !_g.done; _g = _f.next()) {
+            var _h = _g.value, packageName = _h.packageName, className = _h.className;
+            _loop_2(packageName, className);
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    var metadata = all.map(function (metadata) {
+        var isMetadataAviailable = $llmToolsMetadataRegister
+            .list()
+            .find(function (_a) {
+            var packageName = _a.packageName, className = _a.className;
+            return metadata.packageName === packageName && metadata.className === className;
+        });
+        var isInstalled = $llmToolsRegister
+            .list()
+            .find(function (_a) {
+            var packageName = _a.packageName, className = _a.className;
+            return metadata.packageName === packageName && metadata.className === className;
+        });
+        return __assign(__assign({}, metadata), { isMetadataAviailable: isMetadataAviailable, isInstalled: isInstalled });
+    });
+    if (metadata.length === 0) {
+        return "No LLM providers are available.";
+    }
+    return spaceTrim$1(function (block) { return "\n            Available LLM providers are:\n            ".concat(block(metadata
+        .map(function (_a, i) {
+        var packageName = _a.packageName, className = _a.className, envVariables = _a.envVariables, isMetadataAviailable = _a.isMetadataAviailable, isInstalled = _a.isInstalled;
+        var more;
+        if (just(false)) {
+            more = '';
+        }
+        else if (!isMetadataAviailable && !isInstalled) {
+            // TODO: [�][�] Maybe do allow to do auto-install if package not registered and not found
+            more = "(not installed and no metadata, looks like a unexpected behavior)";
+        }
+        else if (isMetadataAviailable && !isInstalled) {
+            // TODO: [�][�]
+            more = "(not installed)";
+        }
+        else if (!isMetadataAviailable && isInstalled) {
+            more = "(no metadata, looks like a unexpected behavior)";
+        }
+        else if (isMetadataAviailable && isInstalled) {
+            more = "(installed)";
+        }
+        else {
+            more = "(unknown state, looks like a unexpected behavior)";
+        }
+        var envVariablesMessage = '';
+        if (envVariables) {
+            envVariablesMessage = 'Configured by ' + envVariables.join(' + ');
+        }
+        return spaceTrim$1("\n                            ".concat(i + 1, ") `").concat(className, "` from `").concat(packageName, "`\n                                      ").concat(more, "\n                                      ").concat(envVariablesMessage, "\n                        "));
+        // <- TODO: !!!!!! Is this indented correctly?
+    })
+        .join('\n')), "\n        "); });
+}
+/**
+ * TODO: [®] DRY Register logic
+ */
+
+/**
+ * Initializes `list-models` command for Promptbook CLI utilities
+ *
+ * @private internal function of `promptbookCli`
+ */
+function initializeListModelsCommand(program) {
+    var _this = this;
+    var listModelsCommand = program.command('list-models');
+    listModelsCommand.description(spaceTrim$1("\n            List all available and configured LLM models\n      "));
+    listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            console.info($registeredLlmToolsMessage());
+            return [2 /*return*/, process.exit(0)];
+        });
+    }); });
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */
+
 /**
  * Converts PipelineCollection to serialized JSON
  *
@@ -2324,22 +2630,6 @@ var LimitReachedError = /** @class */ (function (_super) {
     return LimitReachedError;
 }(Error));
 
-/**
- * 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));
-
 /**
  * Index of all custom errors
  *
@@ -4733,218 +5023,79 @@ function createPipelineExecutor(options) {
                 })];
         });
     }); };
-    return pipelineExecutor;
-}
-/**
- * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
- */
-
-/**
- * Prepares the persona for the pipeline
- *
- * @see https://github.com/webgptorg/promptbook/discussions/22
- * @public exported from `@promptbook/core`
- */
-function preparePersona(personaDescription, tools, options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var _a, isVerbose, collection, preparePersonaExecutor, _b, _llms, llmTools, availableModels, availableModelNames, result, outputParameters, modelRequirementsRaw, modelRequirements, modelName, systemMessage, temperature;
-        var _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
-                case 0:
-                    _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
-                    if (tools === undefined || tools.llm === undefined) {
-                        throw new MissingToolsError('LLM tools are required for preparing persona');
-                    }
-                    collection = createCollectionFromJson.apply(void 0, __spreadArray([], __read(PipelineCollection), false));
-                    _b = createPipelineExecutor;
-                    _c = {};
-                    return [4 /*yield*/, collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book.md')];
-                case 1:
-                    preparePersonaExecutor = _b.apply(void 0, [(_c.pipeline = _d.sent(),
-                            _c.tools = tools,
-                            _c)]);
-                    _llms = arrayableToArray(tools.llm);
-                    llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(_llms), false));
-                    return [4 /*yield*/, llmTools.listModels()];
-                case 2:
-                    availableModels = _d.sent();
-                    availableModelNames = availableModels
-                        .filter(function (_a) {
-                        var modelVariant = _a.modelVariant;
-                        return modelVariant === 'CHAT';
-                    })
-                        .map(function (_a) {
-                        var modelName = _a.modelName;
-                        return modelName;
-                    })
-                        .join(',');
-                    return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription })];
-                case 3:
-                    result = _d.sent();
-                    assertsExecutionSuccessful(result);
-                    outputParameters = result.outputParameters;
-                    modelRequirementsRaw = outputParameters.modelRequirements;
-                    modelRequirements = JSON.parse(modelRequirementsRaw);
-                    if (isVerbose) {
-                        console.info("PERSONA ".concat(personaDescription), modelRequirements);
-                    }
-                    modelName = modelRequirements.modelName, systemMessage = modelRequirements.systemMessage, temperature = modelRequirements.temperature;
-                    return [2 /*return*/, {
-                            modelVariant: 'CHAT',
-                            modelName: modelName,
-                            systemMessage: systemMessage,
-                            temperature: temperature,
-                        }];
-            }
-        });
-    });
-}
-/**
- * TODO: [🔃][main] !! If the persona was prepared with different version or different set of models, prepare it once again
- * TODO: [🏢] !! Check validity of `modelName` in pipeline
- * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
- * TODO: [🏢] !! Check validity of `temperature` in pipeline
- */
-
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this function is not a pure function - it access global scope
- *
- *  @private internal function of `$Register`
- */
-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;
+    return pipelineExecutor;
 }
 /**
- * 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
+ * TODO: [🐚] Change onProgress to object that represents the running execution, can be subscribed via RxJS to and also awaited
  */
 
 /**
- * @@@
+ * Prepares the persona for the pipeline
  *
- * @param text @@@
- * @returns @@@
- * @example 'hello_world'
- * @example 'i_love_promptbook'
- * @public exported from `@promptbook/utils`
+ * @see https://github.com/webgptorg/promptbook/discussions/22
+ * @public exported from `@promptbook/core`
  */
-function normalizeTo_snake_case(text) {
-    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+function preparePersona(personaDescription, tools, options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, isVerbose, collection, preparePersonaExecutor, _b, _llms, llmTools, availableModels, availableModelNames, result, outputParameters, modelRequirementsRaw, modelRequirements, modelName, systemMessage, temperature;
+        var _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    _a = options.isVerbose, isVerbose = _a === void 0 ? DEFAULT_IS_VERBOSE : _a;
+                    if (tools === undefined || tools.llm === undefined) {
+                        throw new MissingToolsError('LLM tools are required for preparing persona');
+                    }
+                    collection = createCollectionFromJson.apply(void 0, __spreadArray([], __read(PipelineCollection), false));
+                    _b = createPipelineExecutor;
+                    _c = {};
+                    return [4 /*yield*/, collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book.md')];
+                case 1:
+                    preparePersonaExecutor = _b.apply(void 0, [(_c.pipeline = _d.sent(),
+                            _c.tools = tools,
+                            _c)]);
+                    _llms = arrayableToArray(tools.llm);
+                    llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(_llms), false));
+                    return [4 /*yield*/, llmTools.listModels()];
+                case 2:
+                    availableModels = _d.sent();
+                    availableModelNames = availableModels
+                        .filter(function (_a) {
+                        var modelVariant = _a.modelVariant;
+                        return modelVariant === 'CHAT';
+                    })
+                        .map(function (_a) {
+                        var modelName = _a.modelName;
+                        return modelName;
+                    })
+                        .join(',');
+                    return [4 /*yield*/, preparePersonaExecutor({ availableModelNames: availableModelNames, personaDescription: personaDescription })];
+                case 3:
+                    result = _d.sent();
+                    assertsExecutionSuccessful(result);
+                    outputParameters = result.outputParameters;
+                    modelRequirementsRaw = outputParameters.modelRequirements;
+                    modelRequirements = JSON.parse(modelRequirementsRaw);
+                    if (isVerbose) {
+                        console.info("PERSONA ".concat(personaDescription), modelRequirements);
+                    }
+                    modelName = modelRequirements.modelName, systemMessage = modelRequirements.systemMessage, temperature = modelRequirements.temperature;
+                    return [2 /*return*/, {
+                            modelVariant: 'CHAT',
+                            modelName: modelName,
+                            systemMessage: systemMessage,
+                            temperature: temperature,
+                        }];
+            }
+        });
+    });
 }
-
 /**
- * Register is @@@
- *
- * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
- *
- * @private internal utility, exported are only signleton instances of this class
+ * TODO: [🔃][main] !! If the persona was prepared with different version or different set of models, prepare it once again
+ * TODO: [🏢] !! Check validity of `modelName` in pipeline
+ * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
+ * TODO: [🏢] !! Check validity of `temperature` in pipeline
  */
-var $Register = /** @class */ (function () {
-    function $Register(registerName) {
-        this.registerName = registerName;
-        var storageName = "_promptbook_".concat(normalizeTo_snake_case(registerName));
-        var globalScope = $getGlobalScope();
-        if (globalScope[storageName] === undefined) {
-            globalScope[storageName] = [];
-        }
-        else if (!Array.isArray(globalScope[storageName])) {
-            throw new UnexpectedError("Expected (global) ".concat(storageName, " to be an array, but got ").concat(typeof globalScope[storageName]));
-        }
-        this.storage = globalScope[storageName];
-    }
-    $Register.prototype.list = function () {
-        // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
-        return this.storage;
-    };
-    $Register.prototype.register = function (registered) {
-        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];
-        if (!existingRegistration) {
-            this.storage.push(registered);
-        }
-        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;
-}());
 
 /**
  * @@@
@@ -9081,18 +9232,6 @@ function $provideExecutablesForNode(options) {
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */
 
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but thare can be more @@@
- * @public exported from `@promptbook/core`
- */
-var $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
-/**
- * TODO: [®] DRY Register logic
- */
-
 /**
  * @@@
  *
@@ -9101,6 +9240,7 @@ var $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
  *
  * @returns @@@
  * @public exported from `@promptbook/node`
@@ -9129,119 +9269,6 @@ function $provideLlmToolsConfigurationFromEnv() {
  * TODO: [🧠] Maybe pass env as argument
  * TODO: [®] DRY Register logic */
 
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but thare can be more @@@
- * @public exported from `@promptbook/core`
- */
-var $llmToolsRegister = new $Register('llm_execution_tools_constructors');
-/**
- * TODO: [®] DRY Register logic
- */
-
-/**
- * Creates a message with all registered LLM tools
- *
- * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
- *
- * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
- */
-function $registeredLlmToolsMessage() {
-    var e_1, _a, e_2, _b;
-    /**
-     * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
-     */
-    var all = [];
-    var _loop_1 = function (packageName, className) {
-        if (all.some(function (item) { return item.packageName === packageName && item.className === className; })) {
-            return "continue";
-        }
-        all.push({ packageName: packageName, className: className });
-    };
-    try {
-        for (var _c = __values($llmToolsMetadataRegister.list()), _d = _c.next(); !_d.done; _d = _c.next()) {
-            var _e = _d.value, packageName = _e.packageName, className = _e.className;
-            _loop_1(packageName, className);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    var _loop_2 = function (packageName, className) {
-        if (all.some(function (item) { return item.packageName === packageName && item.className === className; })) {
-            return "continue";
-        }
-        all.push({ packageName: packageName, className: className });
-    };
-    try {
-        for (var _f = __values($llmToolsRegister.list()), _g = _f.next(); !_g.done; _g = _f.next()) {
-            var _h = _g.value, packageName = _h.packageName, className = _h.className;
-            _loop_2(packageName, className);
-        }
-    }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
-    finally {
-        try {
-            if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
-        }
-        finally { if (e_2) throw e_2.error; }
-    }
-    var metadata = all.map(function (metadata) {
-        var isMetadataAviailable = $llmToolsMetadataRegister
-            .list()
-            .find(function (_a) {
-            var packageName = _a.packageName, className = _a.className;
-            return metadata.packageName === packageName && metadata.className === className;
-        });
-        var isInstalled = $llmToolsRegister
-            .list()
-            .find(function (_a) {
-            var packageName = _a.packageName, className = _a.className;
-            return metadata.packageName === packageName && metadata.className === className;
-        });
-        return __assign(__assign({}, metadata), { isMetadataAviailable: isMetadataAviailable, isInstalled: isInstalled });
-    });
-    if (metadata.length === 0) {
-        return "No LLM providers are available.";
-    }
-    return spaceTrim$1(function (block) { return "\n            Available LLM providers are:\n            ".concat(block(metadata
-        .map(function (_a, i) {
-        var packageName = _a.packageName, className = _a.className, isMetadataAviailable = _a.isMetadataAviailable, isInstalled = _a.isInstalled;
-        var more;
-        if (just(false)) {
-            more = '';
-        }
-        else if (!isMetadataAviailable && !isInstalled) {
-            // TODO: [�][�] Maybe do allow to do auto-install if package not registered and not found
-            more = "(not installed and no metadata, looks like a unexpected behavior)";
-        }
-        else if (isMetadataAviailable && !isInstalled) {
-            // TODO: [�][�]
-            more = "(not installed)";
-        }
-        else if (!isMetadataAviailable && isInstalled) {
-            more = "(no metadata, looks like a unexpected behavior)";
-        }
-        else if (isMetadataAviailable && isInstalled) {
-            more = "(installed)";
-        }
-        else {
-            more = "(unknown state, looks like a unexpected behavior)";
-        }
-        return "".concat(i + 1, ") `").concat(className, "` from `").concat(packageName, "` ").concat(more);
-    })
-        .join('\n')), "\n        "); });
-}
-/**
- * TODO: [®] DRY Register logic
- */
-
 /**
  * @@@
  *
@@ -9287,6 +9314,7 @@ function createLlmToolsFromConfiguration(configuration, options) {
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
  *
  * @returns @@@
  * @public exported from `@promptbook/node`
@@ -11547,7 +11575,13 @@ function initializeRunCommand(program) {
                         if (!error.message.includes('No LLM tools')) {
                             throw error;
                         }
-                        console.error(colors.red(spaceTrim$1("\n                        You need to configure LLM tools first\n\n                        1) Create .env file\n                        2) Add OPENAI_API_KEY=...\n                        3) *(and/or)* Add ANTHROPIC_CLAUDE_API_KEY=...\n                    ")));
+                        console.error(colors.red(spaceTrim$1(function (block) { return "\n                            You need to configure LLM tools first\n\n                           \n                            1) Create .env file at the root of your project\n                            2) Configure API keys for LLM tools\n                            \n                            For example:\n                            ".concat(block($llmToolsMetadataRegister
+                            .list()
+                            .map(function (_a) {
+                            var title = _a.title, envVariables = _a.envVariables;
+                            return "- ".concat(envVariables.join(' + '), " (").concat(title, ")");
+                        })
+                            .join('\n')), "\n                        "); })));
                         return [2 /*return*/, process.exit(1)];
                     }
                     return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
@@ -11926,6 +11960,7 @@ function promptbookCli() {
             initializeMakeCommand(program);
             initializePrettifyCommand(program);
             initializeTestCommand(program);
+            initializeListModelsCommand(program);
             program.parse(process.argv);
             return [2 /*return*/];
         });
@@ -11968,6 +12003,7 @@ var _AnthropicClaudeMetadataRegistration = $llmToolsMetadataRegister.register({
     title: 'Anthropic Claude',
     packageName: '@promptbook/anthropic-claude',
     className: 'AnthropicClaudeExecutionTools',
+    envVariables: ['ANTHROPIC_CLAUDE_API_KEY'],
     getBoilerplateConfiguration: function () {
         return {
             title: 'Anthropic Claude (boilerplate)',
@@ -12687,6 +12723,7 @@ var _AzureOpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
     title: 'Azure Open AI',
     packageName: '@promptbook/azure-openai',
     className: 'AzureOpenAiExecutionTools',
+    envVariables: ['AZUREOPENAI_RESOURCE_NAME', 'AZUREOPENAI_DEPLOYMENT_NAME', 'AZUREOPENAI_API_KEY'],
     getBoilerplateConfiguration: function () {
         return {
             title: 'Azure Open AI (boilerplate)',
@@ -13466,6 +13503,15 @@ var _AzureOpenAiRegistration = $llmToolsRegister.register(createAzureOpenAiExecu
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Detects if the code is running in jest environment
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var $isRunningInJest = new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefined;\n    } catch (e) {\n        return false;\n    }\n");
+
 /**
  * Registration of LLM provider metadata
  *
@@ -13478,6 +13524,7 @@ var _GoogleMetadataRegistration = $llmToolsMetadataRegister.register({
     title: 'Google Gemini',
     packageName: '@promptbook/google',
     className: 'GoogleExecutionTools',
+    envVariables: ['GOOGLE_GENERATIVE_AI_API_KEY'],
     getBoilerplateConfiguration: function () {
         return {
             title: 'Google Gemini (boilerplate)',
@@ -13492,14 +13539,20 @@ var _GoogleMetadataRegistration = $llmToolsMetadataRegister.register({
         };
     },
     createConfigurationFromEnv: function (env) {
+        if ($isRunningInJest()
+        // <- TODO: Maybe check `env.JEST_WORKER_ID` directly here or pass `env` into `$isRunningInJest`
+        ) {
+            // Note: [🔘] Gemini makes problems in Jest environment
+            return null;
+        }
         // Note: Note using `process.env` BUT `env` to pass in the environment variables dynamically
-        if (typeof env.GOOGLE_GEMINI_API_KEY === 'string') {
+        if (typeof env.GOOGLE_GENERATIVE_AI_API_KEY === 'string') {
             return {
                 title: 'Google Gemini (from env)',
                 packageName: '@promptbook/google',
                 className: 'GoogleExecutionTools',
                 options: {
-                    apiKey: env.GOOGLE_GEMINI_API_KEY,
+                    apiKey: env.GOOGLE_GENERATIVE_AI_API_KEY,
                 },
             };
         }
@@ -13634,6 +13687,10 @@ function createExecutionToolsFromVercelProvider(options) {
  * @public exported from `@promptbook/google`
  */
 var createGoogleExecutionTools = Object.assign(function (options) {
+    if ($isRunningInJest()) {
+        // Note: [🔘]
+        throw new Error('GoogleExecutionTools are not supported in Jest environment');
+    }
     // Note: [🔘] There is a compatibility when using import from '@ai-sdk/google'
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     var createGoogleGenerativeAI = require('@ai-sdk/google').createGoogleGenerativeAI;
@@ -13694,6 +13751,7 @@ var _OpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
     title: 'Open AI',
     packageName: '@promptbook/openai',
     className: 'OpenAiExecutionTools',
+    envVariables: ['OPENAI_API_KEY'],
     getBoilerplateConfiguration: function () {
         return {
             title: 'Open AI (boilerplate)',
@@ -13731,6 +13789,9 @@ var _OpenAiAssistantMetadataRegistration = $llmToolsMetadataRegister.register({
     title: 'Open AI Assistant',
     packageName: '@promptbook/openai',
     className: 'OpenAiAssistantExecutionTools',
+    envVariables: [
+    /* TODO: 'OPENAI_API_KEY', 'OPENAI_ASSISTANT_ID' */
+    ],
     getBoilerplateConfiguration: function () {
         return {
             title: 'Open AI Assistant (boilerplate)',