@promptbook/node 0.77.0-0 → 0.77.0-4

package/esm/typings/src/_packages/cli.index.d.ts

@@ -4,6 +4,8 @@ import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic
 import { _AnthropicClaudeRegistration } from '../llm-providers/anthropic-claude/register-constructor';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _AzureOpenAiRegistration } from '../llm-providers/azure-openai/register-constructor';
+import { _GoogleMetadataRegistration } from '../llm-providers/google/register-configuration';
+import { _GoogleRegistration } from '../llm-providers/google/register-constructor';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { _OpenAiAssistantMetadataRegistration } from '../llm-providers/openai/register-configuration';
 import { _OpenAiRegistration } from '../llm-providers/openai/register-constructor';
@@ -24,6 +26,8 @@ export { _AnthropicClaudeMetadataRegistration };
 export { _AnthropicClaudeRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _AzureOpenAiRegistration };
+export { _GoogleMetadataRegistration };
+export { _GoogleRegistration };
 export { _OpenAiMetadataRegistration };
 export { _OpenAiAssistantMetadataRegistration };
 export { _OpenAiRegistration };

package/esm/typings/src/_packages/core.index.d.ts

@@ -82,6 +82,7 @@ import { countTotalUsage } from '../llm-providers/_common/utils/count-total-usag
 import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usage/limitTotalUsage';
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
+import { _GoogleMetadataRegistration } from '../llm-providers/google/register-configuration';
 import { joinLlmExecutionTools } from '../llm-providers/multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/multiple/MultipleLlmExecutionTools';
 import { _OpenAiMetadataRegistration } from '../llm-providers/openai/register-configuration';
@@ -196,6 +197,7 @@ export { countTotalUsage };
 export { limitTotalUsage };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
+export { _GoogleMetadataRegistration };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };
 export { _OpenAiMetadataRegistration };

package/esm/typings/src/_packages/google.index.d.ts

@@ -0,0 +1,10 @@
+import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { createGoogleExecutionTools } from '../llm-providers/google/createGoogleExecutionTools';
+import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
+import { _GoogleRegistration } from '../llm-providers/google/register-constructor';
+import type { VercelExecutionToolsOptions } from '../llm-providers/vercel/VercelExecutionToolsOptions';
+export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { createGoogleExecutionTools };
+export type { GoogleExecutionToolsOptions };
+export { _GoogleRegistration };
+export type { VercelExecutionToolsOptions };

package/esm/typings/src/_packages/types.index.d.ts

@@ -55,6 +55,7 @@ import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anth
 import type { AnthropicClaudeExecutionToolsDirectOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions';
+import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiExecutionToolsOptions } from '../llm-providers/openai/OpenAiExecutionToolsOptions';
 import type { PromptbookServer_Error } from '../llm-providers/remote/interfaces/PromptbookServer_Error';
@@ -72,6 +73,8 @@ import type { RemoteServerOptions } from '../llm-providers/remote/interfaces/Rem
 import type { AnonymousRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { CollectionRemoteServerOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
 import type { CollectionRemoteServerClientOptions } from '../llm-providers/remote/interfaces/RemoteServerOptions';
+import type { VercelExecutionToolsOptions } from '../llm-providers/vercel/VercelExecutionToolsOptions';
+import type { VercelProvider } from '../llm-providers/vercel/VercelProvider';
 import type { IsPipelineImplementingInterfaceOptions } from '../pipeline/PipelineInterface/isPipelineImplementingInterface';
 import type { PipelineInterface } from '../pipeline/PipelineInterface/PipelineInterface';
 import type { CommonTaskJson } from '../pipeline/PipelineJson/CommonTaskJson';
@@ -309,6 +312,7 @@ export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsDirectOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
 export type { AzureOpenAiExecutionToolsOptions };
+export type { GoogleExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiExecutionToolsOptions };
 export type { PromptbookServer_Error };
@@ -326,6 +330,8 @@ export type { RemoteServerOptions };
 export type { AnonymousRemoteServerOptions };
 export type { CollectionRemoteServerOptions };
 export type { CollectionRemoteServerClientOptions };
+export type { VercelExecutionToolsOptions };
+export type { VercelProvider };
 export type { IsPipelineImplementingInterfaceOptions };
 export type { PipelineInterface };
 export type { CommonTaskJson };

package/esm/typings/src/_packages/utils.index.d.ts

@@ -10,6 +10,7 @@ import { forEachAsync } from '../execution/utils/forEachAsync';
 import { isValidJsonString } from '../formats/json/utils/isValidJsonString';
 import { $getCurrentDate } from '../utils/$getCurrentDate';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
+import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
 import { $isRunningInWebWorker } from '../utils/environment/$isRunningInWebWorker';
 import { CHARACTERS_PER_STANDARD_LINE } from '../utils/expectation-counters/constants';
@@ -84,6 +85,7 @@ export { forEachAsync };
 export { isValidJsonString };
 export { $getCurrentDate };
 export { $isRunningInBrowser };
+export { $isRunningInJest };
 export { $isRunningInNode };
 export { $isRunningInWebWorker };
 export { CHARACTERS_PER_STANDARD_LINE };

package/esm/typings/src/_packages/vercel.index.d.ts

@@ -1,4 +1,6 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createExecutionToolsFromVercelProvider } from '../llm-providers/vercel/createExecutionToolsFromVercelProvider';
+import type { VercelProvider } from '../llm-providers/vercel/VercelProvider';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createExecutionToolsFromVercelProvider };
+export type { VercelProvider };

package/esm/typings/src/cli/cli-commands/list-models.d.ts

@@ -0,0 +1,11 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `list-models` command for Promptbook CLI utilities
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function initializeListModelsCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/execution/AvailableModel.d.ts

@@ -8,7 +8,7 @@ export type AvailableModel = {
     /**
      * The model title
      */
-    readonly modelTitle: string_title;
+    readonly modelTitle?: string_title;
     /**
      * The model name aviailable
      */
@@ -18,3 +18,7 @@ export type AvailableModel = {
      */
     readonly modelVariant: ModelVariant;
 };
+/**
+ * TODO: !!!!!! Maybe remove `modelTitle`
+ * TODO: !!!!!! Put pricing information here
+ */

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -7,6 +7,7 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
  *
  * @returns @@@
  * @public exported from `@promptbook/node`

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts

@@ -10,6 +10,7 @@ import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFro
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
  * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
  *
  * @returns @@@
  * @public exported from `@promptbook/node`

package/esm/typings/src/llm-providers/_common/register/LlmToolsMetadata.d.ts

@@ -1,3 +1,4 @@
+import type { string_SCREAMING_CASE } from '../../../utils/normalization/normalizeTo_SCREAMING_CASE';
 import type { string_name } from '../../../types/typeAliases';
 import type { string_title } from '../../../types/typeAliases';
 import type { Registered } from '../../../utils/$Register';
@@ -12,6 +13,10 @@ export type LlmToolsMetadata = Registered & {
      * @@@
      */
     readonly title: string_title;
+    /**
+     * @@@
+     */
+    readonly envVariables: ReadonlyArray<string_name & string_SCREAMING_CASE>;
     /**
      * @@@
      */

package/esm/typings/src/llm-providers/azure-openai/register-configuration.d.ts

@@ -10,4 +10,4 @@ import type { Registration } from '../../utils/$Register';
 export declare const _AzureOpenAiMetadataRegistration: Registration;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
- */ 
+ */

package/esm/typings/src/llm-providers/google/GoogleExecutionToolsOptions.d.ts

@@ -0,0 +1,12 @@
+import type { createGoogleGenerativeAI } from '@ai-sdk/google';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+/**
+ * Options for `GoogleExecutionTools`
+ *
+ * !!!!!! This extends Google's `ClientOptions` with are directly passed to the Google generative AI client.
+ * @public exported from `@promptbook/google`
+ */
+export type GoogleExecutionToolsOptions = CommonToolsOptions & Parameters<typeof createGoogleGenerativeAI>[0];
+/**
+ * TODO: [🧠][🤺] Pass `userId`
+ */

package/esm/typings/src/llm-providers/google/createGoogleExecutionTools.d.ts

@@ -0,0 +1,18 @@
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { GoogleExecutionToolsOptions } from './GoogleExecutionToolsOptions';
+/**
+ * Execution Tools for calling Google Gemini API.
+ *
+ * @public exported from `@promptbook/google`
+ */
+export declare const createGoogleExecutionTools: ((options: GoogleExecutionToolsOptions) => LlmExecutionTools) & {
+    packageName: string;
+    className: string;
+};
+/**
+ * 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"
+ */

package/esm/typings/src/llm-providers/google/register-configuration.d.ts

@@ -0,0 +1,13 @@
+import type { Registration } from '../../utils/$Register';
+/**
+ * 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`
+ */
+export declare const _GoogleMetadataRegistration: Registration;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/llm-providers/google/register-constructor.d.ts

@@ -0,0 +1,14 @@
+import type { Registration } from '../../utils/$Register';
+/**
+ * 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`
+ */
+export declare const _GoogleRegistration: Registration;
+/**
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/llm-providers/openai/register-configuration.d.ts

@@ -19,4 +19,4 @@ export declare const _OpenAiMetadataRegistration: Registration;
 export declare const _OpenAiAssistantMetadataRegistration: Registration;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
- */ 
+ */

package/esm/typings/src/llm-providers/vercel/VercelExecutionToolsOptions.d.ts

@@ -0,0 +1,22 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { VercelProvider } from './VercelProvider';
+/**
+ * Options for `createExecutionToolsFromVercelProvider`
+ *
+ * @public exported from `@promptbook/google`
+ */
+export type VercelExecutionToolsOptions = CommonToolsOptions & {
+    /**
+     * Vercel provider for the execution tools
+     */
+    readonly vercelProvider: VercelProvider;
+    /**
+     * List of available models for given Vercel provider
+     */
+    readonly availableModels: ReadonlyArray<AvailableModel>;
+    /**
+     * Additional settings for chat models when calling `vercelProvider.chat('model-name', settings)`
+     */
+    readonly additionalChatSettings?: Partial<Parameters<VercelProvider['chat']>[1]>;
+};

package/esm/typings/src/llm-providers/vercel/VercelProvider.d.ts

@@ -0,0 +1,13 @@
+import type { createGoogleGenerativeAI } from '@ai-sdk/google';
+import type { createOpenAI } from '@ai-sdk/openai';
+/**
+ * This is common interface for all v1 Vercel providers
+ *
+ * @public exported from `@promptbook/vercel`
+ */
+export type VercelProvider = ReturnType<typeof createOpenAI> | ReturnType<typeof createGoogleGenerativeAI>;
+/**
+ * ^^^^
+ * TODO: Is there some way to get the type of the provider directly,
+ *       NOT this stupid way via inferring the return type from a specific vercel provider⁉
+ */

package/esm/typings/src/llm-providers/vercel/createExecutionToolsFromVercelProvider.d.ts

@@ -1,11 +1,8 @@
-import type { createOpenAI } from '@ai-sdk/openai';
-import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
-type ProviderV1 = ReturnType<typeof createOpenAI>;
+import type { VercelExecutionToolsOptions } from './VercelExecutionToolsOptions';
 /**
  * !!!!!!
  *
  * @public exported from `@promptbook/vercel`
  */
-export declare function createExecutionToolsFromVercelProvider(vercelProvider: ProviderV1, options?: CommonToolsOptions): LlmExecutionTools;
-export {};
+export declare function createExecutionToolsFromVercelProvider(options: VercelExecutionToolsOptions): LlmExecutionTools;

package/esm/typings/src/utils/environment/$isRunningInJest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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`
+ */
+export declare const $isRunningInJest: Function;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.77.0-0",
+    "version": "0.77.0-4",
     "description": "It's time for a paradigm shift. The future of software in plain English, French or Latin",
     "--note-0": "    <- [🐊]",
     "private": false,
@@ -54,7 +54,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.77.0-0"
+        "@promptbook/core": "0.77.0-4"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -43,7 +43,7 @@
      *
      * @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
@@ -8938,6 +8938,7 @@
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
      * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+     * - ...
      *
      * @returns @@@
      * @public exported from `@promptbook/node`
@@ -8991,16 +8992,16 @@
          * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
          */
         var all = [];
-        var _loop_1 = function (packageName, className) {
+        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 });
+            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;
-                _loop_1(packageName, className);
+                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 }; }
@@ -9049,7 +9050,7 @@
         }
         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 packageName = _a.packageName, className = _a.className, envVariables = _a.envVariables, isMetadataAviailable = _a.isMetadataAviailable, isInstalled = _a.isInstalled;
             var more;
             if (just(false)) {
                 more = '';
@@ -9071,7 +9072,12 @@
             else {
                 more = "(unknown state, looks like a unexpected behavior)";
             }
-            return "".concat(i + 1, ") `").concat(className, "` from `").concat(packageName, "` ").concat(more);
+            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        "); });
     }
@@ -9124,6 +9130,7 @@
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
      * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+     * - ...
      *
      * @returns @@@
      * @public exported from `@promptbook/node`