@promptbook/node 0.101.0-9 → 0.102.0-0

package/esm/typings/src/utils/markdown/promptbookifyAiText.d.ts

@@ -2,11 +2,11 @@ import { string_markdown } from '../../types/typeAliases';
 /**
  * Function `promptbookifyAiText` will slightly modify the text so we know it was processed by Promptbook
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function promptbookifyAiText(text: string_markdown): string_markdown;
 /**
- * TODO: !!!!! Make the function idempotent and add "Note: [🔂] This function is idempotent."
- * TODO: [🅾️]!!! Use this across the project where AI text is involved
  * TODO: [🧠][✌️] Make some Promptbook-native token system
  */

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.101.0-8`).
+ * It follows semantic versioning (e.g., `0.101.0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.101.0-9",
+    "version": "0.102.0-0",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-9"
+        "@promptbook/core": "0.102.0-0"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -45,7 +45,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.102.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3028,75 +3028,32 @@
     }
 
     /**
-     * Predefined profiles for LLM providers to maintain consistency across the application
-     * These profiles represent each provider as a virtual persona in chat interfaces
+     * Takes an item or an array of items and returns an array of items
      *
-     * @private !!!!
+     * 1) Any item except array and undefined returns array with that one item (also null)
+     * 2) Undefined returns empty array
+     * 3) Array returns itself
+     *
+     * @private internal utility
      */
-    const LLM_PROVIDER_PROFILES = {
-        OPENAI: {
-            name: 'OPENAI',
-            fullname: 'OpenAI GPT',
-            color: '#10a37f', // OpenAI's signature green
-            // Note: avatarSrc could be added when we have provider logos available
-        },
-        ANTHROPIC: {
-            name: 'ANTHROPIC',
-            fullname: 'Anthropic Claude',
-            color: '#d97706', // Anthropic's orange/amber color
-        },
-        AZURE_OPENAI: {
-            name: 'AZURE_OPENAI',
-            fullname: 'Azure OpenAI',
-            color: '#0078d4', // Microsoft Azure blue
-        },
-        GOOGLE: {
-            name: 'GOOGLE',
-            fullname: 'Google Gemini',
-            color: '#4285f4', // Google blue
-        },
-        DEEPSEEK: {
-            name: 'DEEPSEEK',
-            fullname: 'DeepSeek',
-            color: '#7c3aed', // Purple color for DeepSeek
-        },
-        OLLAMA: {
-            name: 'OLLAMA',
-            fullname: 'Ollama',
-            color: '#059669', // Emerald green for local models
-        },
-        REMOTE: {
-            name: 'REMOTE',
-            fullname: 'Remote Server',
-            color: '#6b7280', // Gray for remote/proxy connections
-        },
-        MOCKED_ECHO: {
-            name: 'MOCKED_ECHO',
-            fullname: 'Echo (Test)',
-            color: '#8b5cf6', // Purple for test/mock tools
-        },
-        MOCKED_FAKE: {
-            name: 'MOCKED_FAKE',
-            fullname: 'Fake LLM (Test)',
-            color: '#ec4899', // Pink for fake/test tools
-        },
-        VERCEL: {
-            name: 'VERCEL',
-            fullname: 'Vercel AI',
-            color: '#000000', // Vercel's black
-        },
-        MULTIPLE: {
-            name: 'MULTIPLE',
-            fullname: 'Multiple Providers',
-            color: '#6366f1', // Indigo for combined/multiple providers
-        },
-    };
+    function arrayableToArray(input) {
+        if (input === undefined) {
+            return [];
+        }
+        if (input instanceof Array) {
+            return input;
+        }
+        return [input];
+    }
+
     /**
-     * TODO: Refactor this - each profile must be alongside the provider definition
-     * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
-     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * Profile for Multiple providers aggregation
      */
-
+    const MULTIPLE_PROVIDER_PROFILE = {
+        name: 'MULTIPLE',
+        fullname: 'Multiple Providers',
+        color: '#6366f1',
+    };
     /**
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
      *
@@ -3107,12 +3064,10 @@
         /**
          * Gets array of execution tools in order of priority
          */
-        constructor(...llmExecutionTools) {
+        constructor(title, ...llmExecutionTools) {
+            this.title = title;
             this.llmExecutionTools = llmExecutionTools;
         }
-        get title() {
-            return 'Multiple LLM Providers';
-        }
         get description() {
             const innerModelsTitlesAndDescriptions = this.llmExecutionTools
                 .map(({ title, description }, index) => {
@@ -3134,7 +3089,7 @@
             `);
         }
         get profile() {
-            return LLM_PROVIDER_PROFILES.MULTIPLE;
+            return MULTIPLE_PROVIDER_PROFILE;
         }
         /**
          * Check the configuration of all execution tools
@@ -3198,7 +3153,7 @@
                             return await llmExecutionTools.callEmbeddingModel(prompt);
                         // <- case [🤖]:
                         default:
-                            throw new UnexpectedError(`Unknown model variant "${prompt.modelRequirements.modelVariant}"`);
+                            throw new UnexpectedError(`Unknown model variant "${prompt.modelRequirements.modelVariant}" in ${llmExecutionTools.title}`);
                     }
                 }
                 catch (error) {
@@ -3219,7 +3174,7 @@
                 //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
                 //     3) ...
                 spaceTrim__default["default"]((block) => `
-                          All execution tools failed:
+                          All execution tools of ${this.title} failed:
 
                           ${block(errors
                 .map(({ error, llmExecutionTools }, i) => `${i + 1}) **${llmExecutionTools.title}** thrown **${error.name || 'Error'}:** ${error.message}`)
@@ -3228,11 +3183,11 @@
                     `));
             }
             else if (this.llmExecutionTools.length === 0) {
-                throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\``);
+                throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
             }
             else {
                 throw new PipelineExecutionError(spaceTrim__default["default"]((block) => `
-                          You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}"
+                          You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}" into ${this.title}
 
                           Available \`LlmExecutionTools\`:
                           ${block(this.description)}
@@ -3262,7 +3217,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    function joinLlmExecutionTools(...llmExecutionTools) {
+    function joinLlmExecutionTools(title, ...llmExecutionTools) {
         if (llmExecutionTools.length === 0) {
             const warningMessage = spaceTrim__default["default"](`
             You have not provided any \`LlmExecutionTools\`
@@ -3294,30 +3249,27 @@
             };
             */
         }
-        return new MultipleLlmExecutionTools(...llmExecutionTools);
+        return new MultipleLlmExecutionTools(title || 'Multiple LLM Providers joined by `joinLlmExecutionTools`', ...llmExecutionTools);
     }
     /**
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
     /**
-     * Takes an item or an array of items and returns an array of items
-     *
-     * 1) Any item except array and undefined returns array with that one item (also null)
-     * 2) Undefined returns empty array
-     * 3) Array returns itself
+     * Just returns the given `LlmExecutionTools` or joins multiple into one
      *
-     * @private internal utility
+     * @public exported from `@promptbook/core`
      */
-    function arrayableToArray(input) {
-        if (input === undefined) {
-            return [];
-        }
-        if (input instanceof Array) {
-            return input;
-        }
-        return [input];
+    function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools) {
+        const _llms = arrayableToArray(oneOrMoreLlmExecutionTools);
+        const llmTools = _llms.length === 1
+            ? _llms[0]
+            : joinLlmExecutionTools('Multiple LLM Providers joined by `getSingleLlmExecutionTools`', ..._llms);
+        return llmTools;
     }
+    /**
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     */
 
     /**
      * Just says that the variable is not used but should be kept
@@ -4020,9 +3972,7 @@
             $scriptPipelineExecutionErrors: [],
             $failedResults: [], // Track all failed attempts
         };
-        // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
-        const _llms = arrayableToArray(tools.llm);
-        const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
+        const llmTools = getSingleLlmExecutionTools(tools.llm);
         attempts: for (let attemptIndex = -jokerParameterNames.length; attemptIndex < maxAttempts; attemptIndex++) {
             const isJokerAttempt = attemptIndex < 0;
             const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
@@ -4542,9 +4492,7 @@
             return ''; // <- Note: Np knowledge present, return empty string
         }
         try {
-            // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
-            const _llms = arrayableToArray(tools.llm);
-            const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
+            const llmTools = getSingleLlmExecutionTools(tools.llm);
             const taskEmbeddingPrompt = {
                 title: 'Knowledge Search',
                 modelRequirements: {
@@ -5145,13 +5093,13 @@
                         // Calculate and update tldr based on pipeline progress
                         const cv = newOngoingResult;
                         // Calculate progress based on parameters resolved vs total parameters
-                        const totalParameters = pipeline.parameters.filter(p => !p.isInput).length;
+                        const totalParameters = pipeline.parameters.filter((p) => !p.isInput).length;
                         let resolvedParameters = 0;
                         let currentTaskTitle = '';
                         // Get the resolved parameters from output parameters
                         if (cv === null || cv === void 0 ? void 0 : cv.outputParameters) {
                             // Count how many output parameters have non-empty values
-                            resolvedParameters = Object.values(cv.outputParameters).filter(value => value !== undefined && value !== null && String(value).trim() !== '').length;
+                            resolvedParameters = Object.values(cv.outputParameters).filter((value) => value !== undefined && value !== null && String(value).trim() !== '').length;
                         }
                         // Try to determine current task from execution report
                         if (((_a = cv === null || cv === void 0 ? void 0 : cv.executionReport) === null || _a === void 0 ? void 0 : _a.promptExecutions) && cv.executionReport.promptExecutions.length > 0) {
@@ -5324,8 +5272,7 @@
             pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book'),
             tools,
         });
-        const _llms = arrayableToArray(tools.llm);
-        const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
+        const llmTools = getSingleLlmExecutionTools(tools.llm);
         const availableModels = (await llmTools.listModels())
             .filter(({ modelVariant }) => modelVariant === 'CHAT')
             .map(({ modelName, modelDescription }) => ({
@@ -5369,6 +5316,7 @@
         };
     }
     /**
+     * TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
      * 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
@@ -6224,9 +6172,7 @@
         if (tools === undefined || tools.llm === undefined) {
             throw new MissingToolsError('LLM tools are required for preparing the pipeline');
         }
-        // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
-        const _llms = arrayableToArray(tools.llm);
-        const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
+        const llmTools = getSingleLlmExecutionTools(tools.llm);
         const llmToolsWithUsage = countUsage(llmTools);
         //    <- TODO: [🌯]
         /*
@@ -10581,7 +10527,7 @@
      * @public exported from `@promptbook/core`
      */
     function createLlmToolsFromConfiguration(configuration, options = {}) {
-        const { isVerbose = DEFAULT_IS_VERBOSE, userId } = options;
+        const { title = 'LLM Tools from Configuration', isVerbose = DEFAULT_IS_VERBOSE, userId } = options;
         const llmTools = configuration.map((llmConfiguration) => {
             const registeredItem = $llmToolsRegister
                 .list()
@@ -10613,7 +10559,7 @@
                 ...llmConfiguration.options,
             });
         });
-        return joinLlmExecutionTools(...llmTools);
+        return joinLlmExecutionTools(title, ...llmTools);
     }
     /**
      * TODO: [🎌] Together with `createLlmToolsFromConfiguration` + 'EXECUTION_TOOLS_CLASSES' gets to `@promptbook/core` ALL model providers, make this more efficient
@@ -11213,7 +11159,7 @@
             throw new EnvironmentMismatchError('Function `$getExecutionToolsForNode` works only in Node.js environment');
         }
         const fs = $provideFilesystemForNode();
-        const llm = await $provideLlmToolsFromEnv(options);
+        const llm = await $provideLlmToolsFromEnv({ title: 'LLM Tools for Node.js', ...options });
         const executables = await $provideExecutablesForNode();
         const tools = {
             llm,
@@ -11646,11 +11592,12 @@
             catch (error) {
                 // Note: If we can't write to cache, silently ignore the error
                 //       This handles read-only filesystems, permission issues, and missing parent directories
-                if (error instanceof Error && (error.message.includes('EROFS') ||
-                    error.message.includes('read-only') ||
-                    error.message.includes('EACCES') ||
-                    error.message.includes('EPERM') ||
-                    error.message.includes('ENOENT'))) {
+                if (error instanceof Error &&
+                    (error.message.includes('EROFS') ||
+                        error.message.includes('read-only') ||
+                        error.message.includes('EACCES') ||
+                        error.message.includes('EPERM') ||
+                        error.message.includes('ENOENT'))) {
                     // Silently ignore filesystem errors - caching is optional
                     return;
                 }