@promptbook/cli 0.77.0-3 → 0.77.0-4

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      *
      * @see https://github.com/webgptorg/promptbook
      */
-    var PROMPTBOOK_ENGINE_VERSION = '0.77.0-2';
+    var PROMPTBOOK_ENGINE_VERSION = '0.77.0-3';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -672,6 +672,312 @@
      * 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.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__default["default"](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__default["default"]("\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__default["default"]("\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
      *
@@ -2336,22 +2642,6 @@
         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.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
      *
@@ -4745,218 +5035,79 @@
                     })];
             });
         }); };
-        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;
-    }());
 
     /**
      * @@@
@@ -9093,18 +9244,6 @@
      * 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
-     */
-
     /**
      * @@@
      *
@@ -9113,6 +9252,7 @@
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
      * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+     * - ...
      *
      * @returns @@@
      * @public exported from `@promptbook/node`
@@ -9141,119 +9281,6 @@
      * 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__default["default"](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
-     */
-
     /**
      * @@@
      *
@@ -9299,6 +9326,7 @@
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
      * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+     * - ...
      *
      * @returns @@@
      * @public exported from `@promptbook/node`
@@ -11559,7 +11587,13 @@
                             if (!error.message.includes('No LLM tools')) {
                                 throw error;
                             }
-                            console.error(colors__default["default"].red(spaceTrim__default["default"]("\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__default["default"].red(spaceTrim__default["default"](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)];
@@ -11938,6 +11972,7 @@
                 initializeMakeCommand(program);
                 initializePrettifyCommand(program);
                 initializeTestCommand(program);
+                initializeListModelsCommand(program);
                 program.parse(process.argv);
                 return [2 /*return*/];
             });
@@ -11980,6 +12015,7 @@
         title: 'Anthropic Claude',
         packageName: '@promptbook/anthropic-claude',
         className: 'AnthropicClaudeExecutionTools',
+        envVariables: ['ANTHROPIC_CLAUDE_API_KEY'],
         getBoilerplateConfiguration: function () {
             return {
                 title: 'Anthropic Claude (boilerplate)',
@@ -12699,6 +12735,7 @@
         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)',
@@ -13478,6 +13515,15 @@
      * 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
      *
@@ -13490,6 +13536,7 @@
         title: 'Google Gemini',
         packageName: '@promptbook/google',
         className: 'GoogleExecutionTools',
+        envVariables: ['GOOGLE_GENERATIVE_AI_API_KEY'],
         getBoilerplateConfiguration: function () {
             return {
                 title: 'Google Gemini (boilerplate)',
@@ -13504,14 +13551,20 @@
             };
         },
         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,
                     },
                 };
             }
@@ -13646,6 +13699,10 @@
      * @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;
@@ -13706,6 +13763,7 @@
         title: 'Open AI',
         packageName: '@promptbook/openai',
         className: 'OpenAiExecutionTools',
+        envVariables: ['OPENAI_API_KEY'],
         getBoilerplateConfiguration: function () {
             return {
                 title: 'Open AI (boilerplate)',
@@ -13743,6 +13801,9 @@
         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)',