@promptbook/cli 0.77.0-0 → 0.77.0-4

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.76.0';
+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
@@ -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
  *
@@ -4773,178 +5063,39 @@ function preparePersona(personaDescription, tools, options) {
                         .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;
-}
-/**
- * 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;
-}());
+                    })
+                        .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
+ */
 
 /**
  * @@@
@@ -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,242 @@ 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
+ *
+ * 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/core`
+ * @public exported from `@promptbook/cli`
+ */
+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)',
+            packageName: '@promptbook/google',
+            className: 'GoogleExecutionTools',
+            options: {
+                apiKey: 'sk-ant-api03-',
+                isProxied: true,
+                remoteUrl: DEFAULT_REMOTE_URL,
+                path: DEFAULT_REMOTE_URL_PATH,
+            },
+        };
+    },
+    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_GENERATIVE_AI_API_KEY === 'string') {
+            return {
+                title: 'Google Gemini (from env)',
+                packageName: '@promptbook/google',
+                className: 'GoogleExecutionTools',
+                options: {
+                    apiKey: env.GOOGLE_GENERATIVE_AI_API_KEY,
+                },
+            };
+        }
+        return null;
+    },
+});
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * !!!!!!
+ *
+ * @public exported from `@promptbook/vercel`
+ */
+function createExecutionToolsFromVercelProvider(options) {
+    var vercelProvider = options.vercelProvider, availableModels = options.availableModels, userId = options.userId, _a = options.additionalChatSettings, additionalChatSettings = _a === void 0 ? {} : _a;
+    return {
+        title: '!!!',
+        description: "!!! (through Vercel)",
+        checkConfiguration: function () {
+            // TODO: !!!!!!
+            return Promise.resolve();
+        },
+        listModels: function () {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, availableModels];
+                });
+            });
+        },
+        callChatModel: function (prompt) {
+            var _a;
+            return __awaiter(this, void 0, void 0, function () {
+                var content, parameters, modelRequirements, modelName, model, rawPromptContent, rawRequest, start, rawResponse, complete, usage;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                            if (modelRequirements.modelVariant !== 'CHAT') {
+                                throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                            }
+                            modelName = modelRequirements.modelName ||
+                                ((_a = availableModels.find(function (_a) {
+                                    var modelVariant = _a.modelVariant;
+                                    return modelVariant === 'CHAT';
+                                })) === null || _a === void 0 ? void 0 : _a.modelName);
+                            if (!modelName) {
+                                throw new PipelineExecutionError(spaceTrim$1("\n                        Can not determine which model to use.\n\n                        You need to provide at least one of:\n                        1) In `createExecutionToolsFromVercelProvider` options, provide `availableModels` with at least one model\n                        2) In `prompt.modelRequirements`, provide `modelName` with the name of the model to use\n                  \n                    "));
+                            }
+                            return [4 /*yield*/, vercelProvider.chat(modelName, __assign({ user: (userId === null || userId === void 0 ? void 0 : userId.toString()) || undefined }, additionalChatSettings))];
+                        case 1:
+                            model = _b.sent();
+                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawRequest = {
+                                // <- TODO: [☂]
+                                inputFormat: 'messages',
+                                mode: {
+                                    type: 'regular',
+                                    tools: [
+                                    /* !!!!!! */
+                                    ],
+                                },
+                                prompt: __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
+                                    ? []
+                                    : [
+                                        {
+                                            role: 'system',
+                                            content: modelRequirements.systemMessage,
+                                        },
+                                    ])), false), [
+                                    {
+                                        role: 'user',
+                                        content: [
+                                            {
+                                                type: 'text',
+                                                text: rawPromptContent,
+                                            },
+                                        ],
+                                    },
+                                ], false),
+                            };
+                            start = $getCurrentDate();
+                            if (options.isVerbose) {
+                                console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                            }
+                            return [4 /*yield*/, model.doGenerate(rawRequest)];
+                        case 2:
+                            rawResponse = _b.sent();
+                            /*
+                            TODO: !!!!!! Handle errors
+                            .catch((error) => {
+                                if (options.isVerbose) {
+                                    console.info(colors.bgRed('error'), error);
+                                }
+                                throw error;
+                            });
+                            */
+                            if (options.isVerbose) {
+                                console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                            }
+                            if (rawResponse.text === undefined) {
+                                throw new PipelineExecutionError('No response message');
+                            }
+                            complete = $getCurrentDate();
+                            usage = UNCERTAIN_USAGE;
+                            return [2 /*return*/, $asDeeplyFrozenSerializableJson('createExecutionToolsFromVercelProvider ChatPromptResult', {
+                                    content: rawResponse.text,
+                                    modelName: modelName,
+                                    timing: {
+                                        start: start,
+                                        complete: complete,
+                                    },
+                                    usage: usage,
+                                    rawPromptContent: rawPromptContent,
+                                    rawRequest: rawRequest,
+                                    rawResponse: {
+                                    /* TODO: !!!!!! UnexpectedError: createExecutionToolsFromVercelProvider ChatPromptResult.rawResponse.response.timestamp is Date */
+                                    },
+                                    // <- [🗯]
+                                })];
+                    }
+                });
+            });
+        },
+    };
+}
+
+/**
+ * Execution Tools for calling Google Gemini API.
+ *
+ * @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;
+    var googleGeminiVercelProvider = createGoogleGenerativeAI(__assign({}, options));
+    return createExecutionToolsFromVercelProvider(__assign({ vercelProvider: googleGeminiVercelProvider, availableModels: [
+            // TODO: !!!!!! Maybe list models in same way as in other providers
+            'gemini-1.5-flash',
+            'gemini-1.5-flash-latest',
+            'gemini-1.5-flash-001',
+            'gemini-1.5-flash-002',
+            'gemini-1.5-flash-exp-0827',
+            'gemini-1.5-flash-8b',
+            'gemini-1.5-flash-8b-latest',
+            'gemini-1.5-flash-8b-exp-0924',
+            'gemini-1.5-flash-8b-exp-0827',
+            'gemini-1.5-pro-latest',
+            'gemini-1.5-pro',
+            'gemini-1.5-pro-001',
+            'gemini-1.5-pro-002',
+            'gemini-1.5-pro-exp-0827',
+            'gemini-1.0-pro',
+        ].map(function (modelName) { return ({ modelName: modelName, modelVariant: 'CHAT' }); }) }, options));
+}, {
+    packageName: '@promptbook/google',
+    className: 'GoogleExecutionTools',
+});
+/**
+ * TODO: [🧠][main] !!!! Make anonymous this with all LLM providers
+ * TODO: [🧠][🧱][main] !!!! Maybe change all `new GoogleExecutionTools` -> `createGoogleExecutionTools` in manual
+ * TODO: [🧠] Maybe auto-detect usage in browser and determine default value of `isProxied`
+ * 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"
+ */
+
+/**
+ * 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/google`
+ * @public exported from `@promptbook/cli`
+ */
+var _GoogleRegistration = $llmToolsRegister.register(createGoogleExecutionTools);
+/**
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Registration of LLM provider metadata
  *
@@ -13478,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)',
@@ -13515,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)',
@@ -15369,5 +15646,5 @@ var _WebsiteScraperRegistration = $scrapersRegister.register(createWebsiteScrape
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION, _AnthropicClaudeMetadataRegistration, _AnthropicClaudeRegistration, _AzureOpenAiMetadataRegistration, _AzureOpenAiRegistration, _CLI, _DocumentScraperMetadataRegistration, _DocumentScraperRegistration, _LegacyDocumentScraperMetadataRegistration, _LegacyDocumentScraperRegistration, _MarkdownScraperMetadataRegistration, _MarkdownScraperRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiAssistantRegistration, _OpenAiMetadataRegistration, _OpenAiRegistration, _PdfScraperMetadataRegistration, _PdfScraperRegistration, _WebsiteScraperMetadataRegistration, _WebsiteScraperRegistration };
+export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION, _AnthropicClaudeMetadataRegistration, _AnthropicClaudeRegistration, _AzureOpenAiMetadataRegistration, _AzureOpenAiRegistration, _CLI, _DocumentScraperMetadataRegistration, _DocumentScraperRegistration, _GoogleMetadataRegistration, _GoogleRegistration, _LegacyDocumentScraperMetadataRegistration, _LegacyDocumentScraperRegistration, _MarkdownScraperMetadataRegistration, _MarkdownScraperRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiAssistantRegistration, _OpenAiMetadataRegistration, _OpenAiRegistration, _PdfScraperMetadataRegistration, _PdfScraperRegistration, _WebsiteScraperMetadataRegistration, _WebsiteScraperRegistration };
 //# sourceMappingURL=index.es.js.map