@promptbook/node 0.61.0-16 → 0.61.0-18

package/esm/index.es.js

@@ -4,6 +4,8 @@ import { join } from 'path';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
+import Anthropic from '@anthropic-ai/sdk';
+import OpenAI from 'openai';
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -393,7 +395,7 @@ function forEachAsync(array, options, callbackfunction) {
     });
 }
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"knowledge"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {content}",expectations:{words:{min:1,max:8}},dependentParameterNames:["content"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.61.0-15",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-15",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.61.0-17",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"knowledge"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-17",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-from-markdown.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.ptbk.md",promptbookVersion:"0.61.0-17",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {content}",dependentParameterNames:["content"],resultingParameterName:"keywords"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-17",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-keywords.ptbk.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.ptbk.md",promptbookVersion:"0.61.0-17",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"knowledge",title:"Knowledge",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {content}",expectations:{words:{min:1,max:8}},dependentParameterNames:["content"],resultingParameterName:"title"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-17",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-knowledge-title.ptbk.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.ptbk.md",promptbookVersion:"0.61.0-17",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],promptTemplates:[{blockType:"PROMPT_TEMPLATE",name:"make-model-requirements",title:"Make modelRequirements",modelRequirements:{modelVariant:"CHAT",modelName:"gpt-4-turbo"},content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Sample\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n### Option `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Option `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Option `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",expectFormat:"JSON",dependentParameterNames:["availableModelNames","personaDescription"],resultingParameterName:"modelRequirements"}],knowledgeSources:[],knowledgePieces:[],personas:[],preparations:[{id:1,promptbookVersion:"0.61.0-17",modelUsage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],sourceFile:"./promptbook-collection/prepare-persona.ptbk.md"}];
 
 /**
  * Prettify the html code
@@ -1002,11 +1004,11 @@ function validatePipeline(pipeline) {
             throw new PipelineLogicError(spaceTrim$1(function (block) { return "\n\n                        Can not resolve some parameters:\n                        Either you are using a parameter that is not defined, or there are some circular dependencies.\n\n                        Can not resolve:\n                        ".concat(block(unresovedTemplates
                 .map(function (_a) {
                 var resultingParameterName = _a.resultingParameterName, dependentParameterNames = _a.dependentParameterNames;
-                return "- {".concat(resultingParameterName, "} depends on ").concat(dependentParameterNames
+                return "- Parameter {".concat(resultingParameterName, "} which depends on ").concat(dependentParameterNames
                     .map(function (dependentParameterName) { return "{".concat(dependentParameterName, "}"); })
-                    .join(', '));
+                    .join(' and '));
             })
-                .join('\n')), "\n\n                        Resolved:\n                        ").concat(block(resovedParameters.map(function (name) { return "- {".concat(name, "}"); }).join('\n')), "\n                    "); }));
+                .join('\n')), "\n\n                        Resolved:\n                        ").concat(block(resovedParameters.map(function (name) { return "- Parameter {".concat(name, "}"); }).join('\n')), "\n                    "); }));
         }
         resovedParameters = __spreadArray(__spreadArray([], __read(resovedParameters), false), __read(currentlyResovedTemplates.map(function (_a) {
             var resultingParameterName = _a.resultingParameterName;
@@ -1069,79 +1071,94 @@ var ReferenceError$1 = /** @class */ (function (_super) {
 }(Error));
 
 /**
- * Library of promptbooks that groups together promptbooks for an application.
- * This implementation is a very thin wrapper around the Array / Map of promptbooks.
+ * Unprepare just strips the preparation data of the pipeline
+ */
+function unpreparePipeline(pipeline) {
+    var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources;
+    personas = personas.map(function (persona) { return (__assign(__assign({}, persona), { modelRequirements: undefined, preparationIds: undefined })); });
+    knowledgeSources = knowledgeSources.map(function (knowledgeSource) { return (__assign(__assign({}, knowledgeSource), { preparationIds: undefined })); });
+    return __assign(__assign({}, pipeline), { knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
+}
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/core`
+ * TODO: Write tests for `preparePipeline`
+ */
+
+/**
+ * Library of pipelines that groups together pipelines for an application.
+ * This implementation is a very thin wrapper around the Array / Map of pipelines.
  *
  * @private use `createCollectionFromJson` instead
- * @see https://github.com/webgptorg/promptbook#promptbook-collection
+ * @see https://github.com/webgptorg/pipeline#pipeline-collection
  */
 var SimplePipelineCollection = /** @class */ (function () {
     /**
-     * Constructs a pipeline collection from promptbooks
+     * Constructs a pipeline collection from pipelines
      *
-     * @param promptbooks @@@
+     * @param pipelines @@@
      *
      * @private Use instead `createCollectionFromJson`
-     * Note: During the construction logic of all promptbooks are validated
+     * Note: During the construction logic of all pipelines are validated
      * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
      */
     function SimplePipelineCollection() {
         var e_1, _a;
-        var promptbooks = [];
+        var pipelines = [];
         for (var _i = 0; _i < arguments.length; _i++) {
-            promptbooks[_i] = arguments[_i];
+            pipelines[_i] = arguments[_i];
         }
         this.collection = new Map();
         try {
-            for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
-                var promptbook = promptbooks_1_1.value;
-                if (promptbook.pipelineUrl === undefined) {
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(promptbook.sourceFile || 'Unknown', "\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
+            for (var pipelines_1 = __values(pipelines), pipelines_1_1 = pipelines_1.next(); !pipelines_1_1.done; pipelines_1_1 = pipelines_1.next()) {
+                var pipeline = pipelines_1_1.value;
+                if (pipeline.pipelineUrl === undefined) {
+                    throw new ReferenceError$1(spaceTrim$1("\n                        Pipeline with name \"".concat(pipeline.title, "\" does not have defined URL\n\n                        File:\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines without URLs are called anonymous pipelines\n                              They can be used as standalone pipelines, but they cannot be referenced by other pipelines\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
                 }
-                validatePipeline(promptbook);
+                validatePipeline(pipeline);
                 // Note: [🦄]
-                if (this.collection.has(promptbook.pipelineUrl) &&
-                    pipelineJsonToString(promptbook) !== pipelineJsonToString(this.collection.get(promptbook.pipelineUrl))) {
-                    var existing = this.collection.get(promptbook.pipelineUrl);
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with URL \"".concat(promptbook.pipelineUrl, "\" is already in the collection\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(promptbook.sourceFile || 'Unknown', "\n\n                        Note: Promptbooks with the same URL are not allowed\n                              Only exepction is when the promptbooks are identical\n\n                    ")));
+                if (this.collection.has(pipeline.pipelineUrl) &&
+                    pipelineJsonToString(unpreparePipeline(pipeline)) !==
+                        pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
+                    var existing = this.collection.get(pipeline.pipelineUrl);
+                    throw new ReferenceError$1(spaceTrim$1("\n                        Pipeline with URL \"".concat(pipeline.pipelineUrl, "\" is already in the collection\n\n                        Conflicting files:\n                        ").concat(existing.sourceFile || 'Unknown', "\n                        ").concat(pipeline.sourceFile || 'Unknown', "\n\n                        Note: Pipelines with the same URL are not allowed\n                              Only exepction is when the pipelines are identical\n\n                    ")));
                 }
-                this.collection.set(promptbook.pipelineUrl, promptbook);
+                this.collection.set(pipeline.pipelineUrl, pipeline);
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
         finally {
             try {
-                if (promptbooks_1_1 && !promptbooks_1_1.done && (_a = promptbooks_1.return)) _a.call(promptbooks_1);
+                if (pipelines_1_1 && !pipelines_1_1.done && (_a = pipelines_1.return)) _a.call(pipelines_1);
             }
             finally { if (e_1) throw e_1.error; }
         }
     }
     /**
-     * Gets all promptbooks in the collection
+     * Gets all pipelines in the collection
      */
     SimplePipelineCollection.prototype.listPipelines = function () {
         return Array.from(this.collection.keys());
     };
     /**
-     * Gets promptbook by its URL
+     * Gets pipeline by its URL
      *
      * Note: This is not a direct fetching from the URL, but a lookup in the collection
      */
     SimplePipelineCollection.prototype.getPipelineByUrl = function (url) {
         var _this = this;
-        var promptbook = this.collection.get(url);
-        if (!promptbook) {
+        var pipeline = this.collection.get(url);
+        if (!pipeline) {
             if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim$1("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
+                throw new NotFoundError(spaceTrim$1("\n                            Pipeline with url \"".concat(url, "\" not found\n\n                            No pipelines available\n                        ")));
             }
-            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPipelines()
+            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Pipeline with url \"".concat(url, "\" not found\n\n                        Available pipelines:\n                        ").concat(block(_this.listPipelines()
                 .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
                 .join('\n')), "\n\n                    "); }));
         }
-        return promptbook;
+        return pipeline;
     };
     /**
-     * Checks whether given prompt was defined in any promptbook in the collection
+     * Checks whether given prompt was defined in any pipeline in the collection
      */
     SimplePipelineCollection.prototype.isResponsibleForPrompt = function (prompt) {
         return true;
@@ -1916,7 +1933,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
                             throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors.map(function (error) { return "- ".concat(error.name || 'Error', ": ").concat(error.message); }).join('\n')), "\n\n                    "); }));
                         }
                         else {
-                            throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                          No execution tools available for model variant \"".concat(prompt.modelRequirements.modelVariant, "\".\n\n                          tl;dr\n\n                          You have provided no LLM Execution Tools that support model variant \"").concat(prompt.modelRequirements.modelVariant, ":\n                          ").concat(block(_this.llmExecutionTools
+                            throw new PipelineExecutionError(spaceTrim(function (block) { return "\n                          You have not provided any `LlmExecutionTools` that support model variant \"".concat(prompt.modelRequirements.modelVariant, "\n\n                          Available `LlmExecutionTools`:\n                          ").concat(block(_this.llmExecutionTools
                                 .map(function (tools) { return "- ".concat(tools.title, " ").concat(tools.description || ''); })
                                 .join('\n')), "\n\n                    "); }));
                         }
@@ -1995,7 +2012,7 @@ function joinLlmExecutionTools() {
         llmExecutionTools[_i] = arguments[_i];
     }
     if (llmExecutionTools.length === 0) {
-        var warningMessage = spaceTrim("\n            You have provided no LLM Execution Tools.\n            This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.\n\n            Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.\n        ");
+        var warningMessage = spaceTrim("\n            You have not provided any `LlmExecutionTools`\n            This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.\n\n            Technically, it's not an error, but it's probably not what you want because it does not make sense to use Promptbook without language models.\n        ");
         // TODO: [🟥] Detect browser / node and make it colorfull
         console.warn(warningMessage);
         /*
@@ -2029,9 +2046,11 @@ function isPipelinePrepared(pipeline) {
     // Note: Ignoring `pipeline.preparations` @@@
     // Note: Ignoring `pipeline.knowledgePieces` @@@
     if (!pipeline.personas.every(function (persona) { return persona.modelRequirements !== undefined; })) {
+        console.log('!!!!', 'Not all personas have modelRequirements');
         return false;
     }
     if (!pipeline.knowledgeSources.every(function (knowledgeSource) { return knowledgeSource.preparationIds !== undefined; })) {
+        console.log('!!!!', 'Not all knowledgeSources have preparationIds');
         return false;
     }
     // TODO: !!!!! Is context in each template
@@ -2040,6 +2059,7 @@ function isPipelinePrepared(pipeline) {
     return true;
 }
 /**
+ * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🔼] Export via core or utils
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  */
@@ -2155,7 +2175,7 @@ function replaceParameters(template, parameters) {
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.61.0-15';
+var PROMPTBOOK_VERSION = '0.61.0-17';
 // TODO: !!!! List here all the versions and annotate + put into script
 
 /**
@@ -5379,11 +5399,11 @@ function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
 }
 
 /**
- * Constructs Promptbook from given directory
+ * Constructs Pipeline from given directory
  *
  * Note: Works only in Node.js environment because it reads the file system
  *
- * @param path - path to the directory with promptbooks
+ * @param path - path to the directory with pipelines
  * @param options - Misc options for the collection
  * @returns PipelineCollection
  */
@@ -5413,20 +5433,31 @@ function createCollectionFromDirectory(path, options) {
                     }
                     _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? false : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashedOnError, isCrashedOnError = _e === void 0 ? true : _e;
                     collection = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
-                        var fileNames, promptbooks, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
+                        var fileNames, pipelines, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
                         var e_1, _a;
                         return __generator(this, function (_b) {
                             switch (_b.label) {
                                 case 0:
                                     if (isVerbose) {
-                                        console.info("Creating pipeline collection from path ".concat(path.split('\\').join('/')));
+                                        console.info(colors.cyan("Creating pipeline collection from path ".concat(path.split('\\').join('/'))));
                                     }
                                     return [4 /*yield*/, listAllFiles(path, isRecursive)];
                                 case 1:
                                     fileNames = _b.sent();
-                                    promptbooks = [];
+                                    // Note: First load all .ptbk.json and then .ptbk.md files
+                                    //       .ptbk.json can be prepared so it is faster to load
+                                    fileNames.sort(function (a, b) {
+                                        if (a.endsWith('.ptbk.json') && b.endsWith('.ptbk.md')) {
+                                            return -1;
+                                        }
+                                        if (a.endsWith('.ptbk.md') && b.endsWith('.ptbk.json')) {
+                                            return 1;
+                                        }
+                                        return 0;
+                                    });
+                                    pipelines = [];
                                     _loop_1 = function (fileName) {
-                                        var sourceFile, promptbook, pipelineString, _c, _d, error_1, wrappedErrorMessage;
+                                        var sourceFile, pipeline, pipelineString, _c, _d, error_1, wrappedErrorMessage;
                                         return __generator(this, function (_e) {
                                             switch (_e.label) {
                                                 case 0:
@@ -5434,53 +5465,52 @@ function createCollectionFromDirectory(path, options) {
                                                     _e.label = 1;
                                                 case 1:
                                                     _e.trys.push([1, 8, , 9]);
-                                                    promptbook = null;
+                                                    pipeline = null;
                                                     if (!fileName.endsWith('.ptbk.md')) return [3 /*break*/, 4];
                                                     return [4 /*yield*/, readFile(fileName, 'utf8')];
                                                 case 2:
                                                     pipelineString = (_e.sent());
                                                     return [4 /*yield*/, pipelineStringToJson(pipelineString, options)];
                                                 case 3:
-                                                    promptbook = _e.sent();
-                                                    promptbook = __assign(__assign({}, promptbook), { sourceFile: sourceFile });
+                                                    pipeline = _e.sent();
+                                                    pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
                                                 case 4:
                                                     if (!fileName.endsWith('.ptbk.json')) return [3 /*break*/, 6];
-                                                    if (isVerbose) {
-                                                        console.info("Loading ".concat(fileName.split('\\').join('/')));
-                                                    }
                                                     _d = (_c = JSON).parse;
                                                     return [4 /*yield*/, readFile(fileName, 'utf8')];
                                                 case 5:
                                                     // TODO: Handle non-valid JSON files
-                                                    promptbook = _d.apply(_c, [_e.sent()]);
+                                                    pipeline = _d.apply(_c, [_e.sent()]);
                                                     // TODO: [🌗]
-                                                    promptbook = __assign(__assign({}, promptbook), { sourceFile: sourceFile });
+                                                    pipeline = __assign(__assign({}, pipeline), { sourceFile: sourceFile });
                                                     return [3 /*break*/, 7];
                                                 case 6:
                                                     if (isVerbose) {
-                                                        console.info("Skipping file ".concat(fileName.split('\\').join('/')));
+                                                        console.info(colors.gray("Skipping file ".concat(fileName.split('\\').join('/'))));
                                                     }
                                                     _e.label = 7;
                                                 case 7:
                                                     // ---
-                                                    if (promptbook !== null) {
-                                                        if (!promptbook.pipelineUrl) {
+                                                    if (pipeline !== null) {
+                                                        if (!pipeline.pipelineUrl) {
                                                             if (isVerbose) {
-                                                                console.info("Not loading ".concat(fileName.split('\\').join('/'), " - missing URL"));
+                                                                console.info(colors.red("Can not load pipeline from ".concat(fileName
+                                                                    .split('\\')
+                                                                    .join('/'), " because of missing URL")));
                                                             }
                                                         }
                                                         else {
-                                                            if (isVerbose) {
-                                                                console.info("Loading ".concat(fileName.split('\\').join('/')));
-                                                            }
                                                             if (!isCrashedOnError) {
-                                                                // Note: Validate promptbook to check if it is logically correct to not crash on invalid promptbooks
+                                                                // Note: Validate pipeline to check if it is logically correct to not crash on invalid pipelines
                                                                 //       But be handled in current try-catch block
-                                                                validatePipeline(promptbook);
+                                                                validatePipeline(pipeline);
+                                                            }
+                                                            if (isVerbose) {
+                                                                console.info(colors.green("Loading ".concat(fileName.split('\\').join('/'))));
                                                             }
-                                                            // Note: [🦄] Promptbook with same url uniqueness will be checked automatically in SimplePipelineCollection
-                                                            promptbooks.push(promptbook);
+                                                            // Note: [🦄] Pipeline with same url uniqueness will be checked automatically in SimplePipelineCollection
+                                                            pipelines.push(pipeline);
                                                         }
                                                     }
                                                     return [3 /*break*/, 9];
@@ -5526,7 +5556,7 @@ function createCollectionFromDirectory(path, options) {
                                     }
                                     finally { if (e_1) throw e_1.error; }
                                     return [7 /*endfinally*/];
-                                case 9: return [2 /*return*/, promptbooks];
+                                case 9: return [2 /*return*/, pipelines];
                             }
                         });
                     }); });
@@ -5600,9 +5630,1090 @@ function listAllFiles(path, isRecursive) {
     });
 }
 /**
- * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+ * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json pipelines
+ * Note: [🟢] This code should never be published outside of `@pipeline/node`
+ */
+
+/**
+ * This error type indicates that you try to use a feature that is not available in the current environment
+ */
+var EnvironmentMismatchError = /** @class */ (function (_super) {
+    __extends(EnvironmentMismatchError, _super);
+    function EnvironmentMismatchError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+        return _this;
+    }
+    return EnvironmentMismatchError;
+}(Error));
+
+/**
+ * Helper of usage compute
+ *
+ * @param content the content of prompt or response
+ * @returns part of PromptResultUsageCounts
+ *
+ * @private internal util of LlmExecutionTools
+ */
+function computeUsageCounts(content) {
+    return {
+        charactersCount: { value: countCharacters(content) },
+        wordsCount: { value: countWords(content) },
+        sentencesCount: { value: countSentences(content) },
+        linesCount: { value: countLines(content) },
+        paragraphsCount: { value: countParagraphs(content) },
+        pagesCount: { value: countPages(content) },
+    };
+}
+
+/**
+ * Make UncertainNumber
+ *
+ * @param value
+ *
+ * @private utility for initializating UncertainNumber
+ */
+function uncertainNumber(value) {
+    if (value === null || value === undefined || Number.isNaN(NaN)) {
+        return { value: 0, isUncertain: true };
+    }
+    return { value: value };
+}
+
+/**
+ * Get current date in ISO 8601 format
+ *
+ * @private This is internal util of the promptbook
+ */
+function getCurrentIsoDate() {
+    return new Date().toISOString();
+}
+
+/**
+ * Function computeUsage will create price per one token based on the string value found on openai page
+ *
+ * @private within the repository, used only as internal helper for `OPENAI_MODELS`
+ */
+function computeUsage(value) {
+    var _a = __read(value.split(' / '), 2), price = _a[0], tokens = _a[1];
+    return parseFloat(price.replace('$', '')) / parseFloat(tokens.replace('M tokens', '')) / 1000000;
+}
+
+/**
+ * List of available Anthropic Claude models with pricing
+ *
+ * Note: Done at 2024-05-25
+ *
+ * @see https://docs.anthropic.com/en/docs/models-overview
+ */
+var ANTHROPIC_CLAUDE_MODELS = [
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'Claude 3 Opus',
+        modelName: 'claude-3-opus-20240229',
+        pricing: {
+            prompt: computeUsage("$15.00 / 1M tokens"),
+            output: computeUsage("$75.00 / 1M tokens"),
+        },
+    },
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'Claude 3 Sonnet',
+        modelName: 'claude-3-sonnet-20240229',
+        pricing: {
+            prompt: computeUsage("$3.00 / 1M tokens"),
+            output: computeUsage("$15.00 / 1M tokens"),
+        },
+    },
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'Claude 3 Haiku',
+        modelName: '	claude-3-haiku-20240307',
+        pricing: {
+            prompt: computeUsage("$0.25 / 1M tokens"),
+            output: computeUsage("$1.25 / 1M tokens"),
+        },
+    },
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'Claude 2.1',
+        modelName: 'claude-2.1',
+        pricing: {
+            prompt: computeUsage("$8.00 / 1M tokens"),
+            output: computeUsage("$24.00 / 1M tokens"),
+        },
+    },
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'Claude 2',
+        modelName: 'claude-2.0',
+        pricing: {
+            prompt: computeUsage("$8.00 / 1M tokens"),
+            output: computeUsage("$24.00 / 1M tokens"),
+        },
+    },
+    {
+        modelVariant: 'CHAT',
+        modelTitle: '	Claude Instant 1.2',
+        modelName: 'claude-instant-1.2',
+        pricing: {
+            prompt: computeUsage("$0.80 / 1M tokens"),
+            output: computeUsage("$2.40 / 1M tokens"),
+        },
+    },
+    // TODO: !!! Claude 1 and 2 has also completion versions - ask Hoagy
+];
+/**
+ * Note: [🤖] Add models of new variant
+ * TODO: [🧠] !!! Add embedding models OR Anthropic has only chat+completion models?
+ * TODO: [🧠] Some mechanism to propagate unsureness
+ * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+ * TODO: [🕚] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+ */
+
+/**
+ * Execution Tools for calling Anthropic Claude API.
+ */
+var AnthropicClaudeExecutionTools = /** @class */ (function () {
+    /**
+     * Creates Anthropic Claude Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the Anthropic Claude client
+     */
+    function AnthropicClaudeExecutionTools(options) {
+        if (options === void 0) { options = {}; }
+        this.options = options;
+        // Note: Passing only Anthropic Claude relevant options to Anthropic constructor
+        var anthropicOptions = __assign({}, options);
+        delete anthropicOptions.isVerbose;
+        this.client = new Anthropic(anthropicOptions);
+    }
+    Object.defineProperty(AnthropicClaudeExecutionTools.prototype, "title", {
+        get: function () {
+            return 'Anthropic Claude';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AnthropicClaudeExecutionTools.prototype, "description", {
+        get: function () {
+            return 'Use all models provided by Anthropic Claude';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Calls Anthropic Claude API to use a chat model.
+     */
+    AnthropicClaudeExecutionTools.prototype.callChatModel = function (prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var content, parameters, modelRequirements, rawRequest, start, complete, rawResponse, resultContent, usage;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.options.isVerbose) {
+                            console.info('💬 Anthropic Claude callChatModel call');
+                        }
+                        content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                        // TODO: [☂] Use here more modelRequirements
+                        if (modelRequirements.modelVariant !== 'CHAT') {
+                            throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                        }
+                        rawRequest = {
+                            model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
+                            max_tokens: modelRequirements.maxTokens || 4096,
+                            //                                            <- TODO: [🌾] Make some global max cap for maxTokens
+                            temperature: modelRequirements.temperature,
+                            system: modelRequirements.systemMessage,
+                            // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                            // <- Note: [🧆]
+                            messages: [
+                                {
+                                    role: 'user',
+                                    content: replaceParameters(content, parameters),
+                                },
+                            ],
+                            // TODO: Is here some equivalent of user identification?> user: this.options.user,
+                        };
+                        start = getCurrentIsoDate();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                        }
+                        return [4 /*yield*/, this.client.messages.create(rawRequest)];
+                    case 1:
+                        rawResponse = _a.sent();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                        }
+                        if (!rawResponse.content[0]) {
+                            throw new PipelineExecutionError('No content from Anthropic Claude');
+                        }
+                        if (rawResponse.content.length > 1) {
+                            throw new PipelineExecutionError('More than one content blocks from Anthropic Claude');
+                        }
+                        resultContent = rawResponse.content[0].text;
+                        // eslint-disable-next-line prefer-const
+                        complete = getCurrentIsoDate();
+                        usage = {
+                            price: { value: 0, isUncertain: true } /* <- TODO: [🐞] Compute usage */,
+                            input: __assign({ tokensCount: uncertainNumber(rawResponse.usage.input_tokens) }, computeUsageCounts(prompt.content)),
+                            output: __assign({ tokensCount: uncertainNumber(rawResponse.usage.output_tokens) }, computeUsageCounts(prompt.content)),
+                        };
+                        return [2 /*return*/, {
+                                content: resultContent,
+                                modelName: rawResponse.model,
+                                timing: {
+                                    start: start,
+                                    complete: complete,
+                                },
+                                usage: usage,
+                                rawResponse: rawResponse,
+                                // <- [🤹‍♂️]
+                            }];
+                }
+            });
+        });
+    };
+    /*
+    TODO: [👏]
+    public async callCompletionModel(
+        prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>,
+    ): Promise<PromptCompletionResult> {
+
+        if (this.options.isVerbose) {
+            console.info('🖋 Anthropic Claude callCompletionModel call');
+        }
+
+        const { content, parameters, modelRequirements } = prompt;
+
+        // TODO: [☂] Use here more modelRequirements
+        if (modelRequirements.modelVariant !== 'COMPLETION') {
+            throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+        }
+
+        const model = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+        const modelSettings = {
+            model: rawResponse.model || model,
+            max_tokens: modelRequirements.maxTokens || 2000, // <- Note: 2000 is for lagacy reasons
+            //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
+            // <- TODO: Use here `systemMessage`, `temperature` and `seed`
+        };
+
+        const rawRequest: xxxx.Completions.CompletionCreateParamsNonStreaming = {
+            ...modelSettings,
+            prompt: replaceParameters(content, parameters),
+            user: this.options.user,
+        };
+        const start: string_date_iso8601 = getCurrentIsoDate();
+        let complete: string_date_iso8601;
+
+        if (this.options.isVerbose) {
+            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+        }
+        const rawResponse = await this.client.completions.create(rawRequest);
+        if (this.options.isVerbose) {
+            console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+        }
+
+        if (!rawResponse.choices[0]) {
+            throw new PipelineExecutionError('No choises from Anthropic Claude');
+        }
+
+        if (rawResponse.choices.length > 1) {
+            // TODO: This should be maybe only warning
+            throw new PipelineExecutionError('More than one choise from Anthropic Claude');
+        }
+
+        const resultContent = rawResponse.choices[0].text;
+        // eslint-disable-next-line prefer-const
+        complete = getCurrentIsoDate();
+        const usage = { price: 'UNKNOWN', inputTokens: 0, outputTokens: 0 /* <- TODO: [🐞] Compute usage * / } satisfies PromptResultUsage;
+
+
+
+        return {
+            content: resultContent,
+            modelName: rawResponse.model || model,
+            timing: {
+                start,
+                complete,
+            },
+            usage,
+            rawResponse,
+            // <- [🤹‍♂️]
+        };
+    }
+    */
+    // <- Note: [🤖] callXxxModel
+    /**
+     * Get the model that should be used as default
+     */
+    AnthropicClaudeExecutionTools.prototype.getDefaultModel = function (defaultModelName) {
+        var model = ANTHROPIC_CLAUDE_MODELS.find(function (_a) {
+            var modelName = _a.modelName;
+            return modelName.startsWith(defaultModelName);
+        });
+        if (model === undefined) {
+            throw new UnexpectedError(spaceTrim(function (block) {
+                return "\n                          Cannot find model in OpenAI models with name \"".concat(defaultModelName, "\" which should be used as default.\n\n                          Available models:\n                          ").concat(block(ANTHROPIC_CLAUDE_MODELS.map(function (_a) {
+                    var modelName = _a.modelName;
+                    return "- \"".concat(modelName, "\"");
+                }).join('\n')), "\n\n                      ");
+            }));
+        }
+        return model;
+    };
+    /**
+     * Default model for chat variant.
+     */
+    AnthropicClaudeExecutionTools.prototype.getDefaultChatModel = function () {
+        return this.getDefaultModel('claude-3-opus');
+    };
+    // <- Note: [🤖] getDefaultXxxModel
+    /**
+     * List all available Anthropic Claude models that can be used
+     */
+    AnthropicClaudeExecutionTools.prototype.listModels = function () {
+        return ANTHROPIC_CLAUDE_MODELS;
+    };
+    return AnthropicClaudeExecutionTools;
+}());
+/**
+ * TODO: !!!! [🍆] JSON mode
+ * TODO: [🧠] Maybe handle errors via transformAnthropicError (like transformAzureError)
+ * TODO: Maybe Create some common util for callChatModel and callCompletionModel
+ * TODO: Maybe make custom OpenaiError
+ * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+ */
+
+/**
+ * List of available OpenAI models with pricing
+ *
+ * Note: Done at 2024-05-20
+ *
+ * @see https://platform.openai.com/docs/models/
+ * @see https://openai.com/api/pricing/
+ */
+var OPENAI_MODELS = [
+    /*/
+      {
+          modelTitle: 'dall-e-3',
+          modelName: 'dall-e-3',
+      },
+      /**/
+    /*/
+      {
+          modelTitle: 'whisper-1',
+          modelName: 'whisper-1',
+      },
+    /**/
+    /**/
+    {
+        modelVariant: 'COMPLETION',
+        modelTitle: 'davinci-002',
+        modelName: 'davinci-002',
+        pricing: {
+            prompt: computeUsage("$2.00 / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"), // <- not sure
+        },
+    },
+    /**/
+    /*/
+  {
+      modelTitle: 'dall-e-2',
+      modelName: 'dall-e-2',
+  },
+  /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-16k',
+        modelName: 'gpt-3.5-turbo-16k',
+        pricing: {
+            prompt: computeUsage("$3.00 / 1M tokens"),
+            output: computeUsage("$4.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /*/
+  {
+      modelTitle: 'tts-1-hd-1106',
+      modelName: 'tts-1-hd-1106',
+  },
+  /**/
+    /*/
+  {
+      modelTitle: 'tts-1-hd',
+      modelName: 'tts-1-hd',
+  },
+  /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4',
+        modelName: 'gpt-4',
+        pricing: {
+            prompt: computeUsage("$30.00 / 1M tokens"),
+            output: computeUsage("$60.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-32k',
+        modelName: 'gpt-4-32k',
+        pricing: {
+            prompt: computeUsage("$60.00 / 1M tokens"),
+            output: computeUsage("$120.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /*/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-0613',
+        modelName: 'gpt-4-0613',
+        pricing: {
+            prompt: computeUsage(` / 1M tokens`),
+            output: computeUsage(` / 1M tokens`),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-turbo-2024-04-09',
+        modelName: 'gpt-4-turbo-2024-04-09',
+        pricing: {
+            prompt: computeUsage("$10.00 / 1M tokens"),
+            output: computeUsage("$30.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-1106',
+        modelName: 'gpt-3.5-turbo-1106',
+        pricing: {
+            prompt: computeUsage("$1.00 / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-turbo',
+        modelName: 'gpt-4-turbo',
+        pricing: {
+            prompt: computeUsage("$10.00 / 1M tokens"),
+            output: computeUsage("$30.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'COMPLETION',
+        modelTitle: 'gpt-3.5-turbo-instruct-0914',
+        modelName: 'gpt-3.5-turbo-instruct-0914',
+        pricing: {
+            prompt: computeUsage("$1.50  / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"), // <- For gpt-3.5-turbo-instruct
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'COMPLETION',
+        modelTitle: 'gpt-3.5-turbo-instruct',
+        modelName: 'gpt-3.5-turbo-instruct',
+        pricing: {
+            prompt: computeUsage("$1.50  / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /*/
+  {
+      modelTitle: 'tts-1',
+      modelName: 'tts-1',
+  },
+  /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo',
+        modelName: 'gpt-3.5-turbo',
+        pricing: {
+            prompt: computeUsage("$3.00 / 1M tokens"),
+            output: computeUsage("$6.00 / 1M tokens"), // <- Not sure, refer to gpt-3.5-turbo in Fine-tuning models
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-0301',
+        modelName: 'gpt-3.5-turbo-0301',
+        pricing: {
+            prompt: computeUsage("$1.50 / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'COMPLETION',
+        modelTitle: 'babbage-002',
+        modelName: 'babbage-002',
+        pricing: {
+            prompt: computeUsage("$0.40 / 1M tokens"),
+            output: computeUsage("$0.40 / 1M tokens"), // <- Not sure
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-1106-preview',
+        modelName: 'gpt-4-1106-preview',
+        pricing: {
+            prompt: computeUsage("$10.00 / 1M tokens"),
+            output: computeUsage("$30.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-0125-preview',
+        modelName: 'gpt-4-0125-preview',
+        pricing: {
+            prompt: computeUsage("$10.00 / 1M tokens"),
+            output: computeUsage("$30.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /*/
+  {
+      modelTitle: 'tts-1-1106',
+      modelName: 'tts-1-1106',
+  },
+  /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-0125',
+        modelName: 'gpt-3.5-turbo-0125',
+        pricing: {
+            prompt: computeUsage("$0.50 / 1M tokens"),
+            output: computeUsage("$1.50  / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4-turbo-preview',
+        modelName: 'gpt-4-turbo-preview',
+        pricing: {
+            prompt: computeUsage("$10.00 / 1M tokens"),
+            output: computeUsage("$30.00 / 1M tokens"), // <- Not sure, just for gpt-4-turbo
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'EMBEDDING',
+        modelTitle: 'text-embedding-3-large',
+        modelName: 'text-embedding-3-large',
+        pricing: {
+            prompt: computeUsage("$0.13  / 1M tokens"),
+            // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+            output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'EMBEDDING',
+        modelTitle: 'text-embedding-3-small',
+        modelName: 'text-embedding-3-small',
+        pricing: {
+            prompt: computeUsage("$0.02 / 1M tokens"),
+            // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+            output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-0613',
+        modelName: 'gpt-3.5-turbo-0613',
+        pricing: {
+            prompt: computeUsage("$1.50 / 1M tokens"),
+            output: computeUsage("$2.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'EMBEDDING',
+        modelTitle: 'text-embedding-ada-002',
+        modelName: 'text-embedding-ada-002',
+        pricing: {
+            prompt: computeUsage("$0.1 / 1M tokens"),
+            // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
+            output: 0, // <- Note: [🆖] In Embedding models you dont pay for output
+        },
+    },
+    /**/
+    /*/
+  {
+      modelVariant: 'CHAT',
+      modelTitle: 'gpt-4-1106-vision-preview',
+      modelName: 'gpt-4-1106-vision-preview',
+  },
+  /**/
+    /*/
+  {
+      modelVariant: 'CHAT',
+      modelTitle: 'gpt-4-vision-preview',
+      modelName: 'gpt-4-vision-preview',
+      pricing: {
+          prompt: computeUsage(`$10.00 / 1M tokens`),
+          output: computeUsage(`$30.00 / 1M tokens`),
+      },
+  },
+  /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4o-2024-05-13',
+        modelName: 'gpt-4o-2024-05-13',
+        pricing: {
+            prompt: computeUsage("$5.00 / 1M tokens"),
+            output: computeUsage("$15.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-4o',
+        modelName: 'gpt-4o',
+        pricing: {
+            prompt: computeUsage("$5.00 / 1M tokens"),
+            output: computeUsage("$15.00 / 1M tokens"),
+        },
+    },
+    /**/
+    /**/
+    {
+        modelVariant: 'CHAT',
+        modelTitle: 'gpt-3.5-turbo-16k-0613',
+        modelName: 'gpt-3.5-turbo-16k-0613',
+        pricing: {
+            prompt: computeUsage("$3.00 / 1M tokens"),
+            output: computeUsage("$4.00 / 1M tokens"),
+        },
+    },
+    /**/
+];
+/**
+ * Note: [🤖] Add models of new variant
+ * TODO: [🧠] Some mechanism to propagate unsureness
+ * TODO: [🕚][👮‍♀️] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+ * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+ * @see https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4
+ * @see https://openai.com/api/pricing/
+ * @see /other/playground/playground.ts
+ * TODO: [🍓] Make better
+ * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
+ * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
+ */
+
+/**
+ * Computes the usage of the OpenAI API based on the response from OpenAI
+ *
+ * @param promptContent The content of the prompt
+ * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
+ * @param rawResponse The raw response from OpenAI API
+ * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
+ * @private internal util of `OpenAiExecutionTools`
+ */
+function computeOpenaiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
+resultContent, rawResponse) {
+    var _a, _b;
+    if (rawResponse.usage === undefined) {
+        throw new PipelineExecutionError('The usage is not defined in the response from OpenAI');
+    }
+    if (((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) === undefined) {
+        throw new PipelineExecutionError('In OpenAI response `usage.prompt_tokens` not defined');
+    }
+    var inputTokens = rawResponse.usage.prompt_tokens;
+    var outputTokens = ((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completion_tokens) || 0;
+    var modelInfo = OPENAI_MODELS.find(function (model) { return model.modelName === rawResponse.model; });
+    var price;
+    if (modelInfo === undefined || modelInfo.pricing === undefined) {
+        price = uncertainNumber();
+    }
+    else {
+        price = uncertainNumber(inputTokens * modelInfo.pricing.prompt + outputTokens * modelInfo.pricing.output);
+    }
+    return {
+        price: price,
+        input: __assign({ tokensCount: uncertainNumber(rawResponse.usage.prompt_tokens) }, computeUsageCounts(promptContent)),
+        output: __assign({ tokensCount: uncertainNumber(outputTokens) }, computeUsageCounts(resultContent)),
+    };
+}
+
+/**
+ * Execution Tools for calling OpenAI API.
+ */
+var OpenAiExecutionTools = /** @class */ (function () {
+    /**
+     * Creates OpenAI Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI client
+     */
+    function OpenAiExecutionTools(options) {
+        if (options === void 0) { options = {}; }
+        this.options = options;
+        // Note: Passing only OpenAI relevant options to OpenAI constructor
+        var openAiOptions = __assign({}, options);
+        delete openAiOptions.isVerbose;
+        delete openAiOptions.user;
+        this.client = new OpenAI(__assign({}, openAiOptions));
+    }
+    Object.defineProperty(OpenAiExecutionTools.prototype, "title", {
+        get: function () {
+            return 'OpenAI';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(OpenAiExecutionTools.prototype, "description", {
+        get: function () {
+            return 'Use all models provided by OpenAI';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Calls OpenAI API to use a chat model.
+     */
+    OpenAiExecutionTools.prototype.callChatModel = function (prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var content, parameters, modelRequirements, expectFormat, model, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.options.isVerbose) {
+                            console.info('💬 OpenAI callChatModel call', { prompt: prompt });
+                        }
+                        content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements, expectFormat = prompt.expectFormat;
+                        // TODO: [☂] Use here more modelRequirements
+                        if (modelRequirements.modelVariant !== 'CHAT') {
+                            throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+                        }
+                        model = modelRequirements.modelName || this.getDefaultChatModel().modelName;
+                        modelSettings = {
+                            model: model,
+                            max_tokens: modelRequirements.maxTokens,
+                            //                                   <- TODO: [🌾] Make some global max cap for maxTokens
+                            temperature: modelRequirements.temperature,
+                            // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                            // <- Note: [🧆]
+                        };
+                        if (expectFormat === 'JSON') {
+                            modelSettings.response_format = {
+                                type: 'json_object',
+                            };
+                        }
+                        rawRequest = __assign(__assign({}, modelSettings), { messages: __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
+                                ? []
+                                : [
+                                    {
+                                        role: 'system',
+                                        content: modelRequirements.systemMessage,
+                                    },
+                                ])), false), [
+                                {
+                                    role: 'user',
+                                    content: replaceParameters(content, parameters),
+                                },
+                            ], false), user: this.options.user });
+                        start = getCurrentIsoDate();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                        }
+                        return [4 /*yield*/, this.client.chat.completions.create(rawRequest)];
+                    case 1:
+                        rawResponse = _a.sent();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                        }
+                        if (!rawResponse.choices[0]) {
+                            throw new PipelineExecutionError('No choises from OpenAI');
+                        }
+                        if (rawResponse.choices.length > 1) {
+                            // TODO: This should be maybe only warning
+                            throw new PipelineExecutionError('More than one choise from OpenAI');
+                        }
+                        resultContent = rawResponse.choices[0].message.content;
+                        // eslint-disable-next-line prefer-const
+                        complete = getCurrentIsoDate();
+                        usage = computeOpenaiUsage(content, resultContent || '', rawResponse);
+                        if (resultContent === null) {
+                            throw new PipelineExecutionError('No response message from OpenAI');
+                        }
+                        return [2 /*return*/, {
+                                content: resultContent,
+                                modelName: rawResponse.model || model,
+                                timing: {
+                                    start: start,
+                                    complete: complete,
+                                },
+                                usage: usage,
+                                rawResponse: rawResponse,
+                                // <- [🤹‍♂️]
+                            }];
+                }
+            });
+        });
+    };
+    /**
+     * Calls OpenAI API to use a complete model.
+     */
+    OpenAiExecutionTools.prototype.callCompletionModel = function (prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var content, parameters, modelRequirements, model, modelSettings, rawRequest, start, complete, rawResponse, resultContent, usage;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.options.isVerbose) {
+                            console.info('🖋 OpenAI callCompletionModel call', { prompt: prompt });
+                        }
+                        content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                        // TODO: [☂] Use here more modelRequirements
+                        if (modelRequirements.modelVariant !== 'COMPLETION') {
+                            throw new PipelineExecutionError('Use callCompletionModel only for COMPLETION variant');
+                        }
+                        model = modelRequirements.modelName || this.getDefaultCompletionModel().modelName;
+                        modelSettings = {
+                            model: model,
+                            max_tokens: modelRequirements.maxTokens || 2000,
+                            //                                                  <- TODO: [🌾] Make some global max cap for maxTokens
+                            temperature: modelRequirements.temperature,
+                            // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
+                            // <- Note: [🧆]
+                        };
+                        rawRequest = __assign(__assign({}, modelSettings), { prompt: replaceParameters(content, parameters), user: this.options.user });
+                        start = getCurrentIsoDate();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                        }
+                        return [4 /*yield*/, this.client.completions.create(rawRequest)];
+                    case 1:
+                        rawResponse = _a.sent();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                        }
+                        if (!rawResponse.choices[0]) {
+                            throw new PipelineExecutionError('No choises from OpenAI');
+                        }
+                        if (rawResponse.choices.length > 1) {
+                            // TODO: This should be maybe only warning
+                            throw new PipelineExecutionError('More than one choise from OpenAI');
+                        }
+                        resultContent = rawResponse.choices[0].text;
+                        // eslint-disable-next-line prefer-const
+                        complete = getCurrentIsoDate();
+                        usage = computeOpenaiUsage(content, resultContent || '', rawResponse);
+                        return [2 /*return*/, {
+                                content: resultContent,
+                                modelName: rawResponse.model || model,
+                                timing: {
+                                    start: start,
+                                    complete: complete,
+                                },
+                                usage: usage,
+                                rawResponse: rawResponse,
+                                // <- [🤹‍♂️]
+                            }];
+                }
+            });
+        });
+    };
+    /**
+     * Calls OpenAI API to use a embedding model
+     */
+    OpenAiExecutionTools.prototype.callEmbeddingModel = function (prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var content, parameters, modelRequirements, model, rawRequest, start, complete, rawResponse, resultContent, usage;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.options.isVerbose) {
+                            console.info('🖋 OpenAI embedding call', { prompt: prompt });
+                        }
+                        content = prompt.content, parameters = prompt.parameters, modelRequirements = prompt.modelRequirements;
+                        // TODO: [☂] Use here more modelRequirements
+                        if (modelRequirements.modelVariant !== 'EMBEDDING') {
+                            throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
+                        }
+                        model = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
+                        rawRequest = {
+                            input: replaceParameters(content, parameters),
+                            model: model,
+                            // TODO: !!!! Test model 3 and dimensions
+                        };
+                        start = getCurrentIsoDate();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
+                        }
+                        return [4 /*yield*/, this.client.embeddings.create(rawRequest)];
+                    case 1:
+                        rawResponse = _a.sent();
+                        if (this.options.isVerbose) {
+                            console.info(colors.bgWhite('rawResponse'), JSON.stringify(rawResponse, null, 4));
+                        }
+                        if (rawResponse.data.length !== 1) {
+                            throw new PipelineExecutionError("Expected exactly 1 data item in response, got ".concat(rawResponse.data.length));
+                        }
+                        resultContent = rawResponse.data[0].embedding;
+                        // eslint-disable-next-line prefer-const
+                        complete = getCurrentIsoDate();
+                        usage = computeOpenaiUsage(content, '', rawResponse);
+                        return [2 /*return*/, {
+                                content: resultContent,
+                                modelName: rawResponse.model || model,
+                                timing: {
+                                    start: start,
+                                    complete: complete,
+                                },
+                                usage: usage,
+                                rawResponse: rawResponse,
+                                // <- [🤹‍♂️]
+                            }];
+                }
+            });
+        });
+    };
+    // <- Note: [🤖] callXxxModel
+    /**
+     * Get the model that should be used as default
+     */
+    OpenAiExecutionTools.prototype.getDefaultModel = function (defaultModelName) {
+        var model = OPENAI_MODELS.find(function (_a) {
+            var modelName = _a.modelName;
+            return modelName === defaultModelName;
+        });
+        if (model === undefined) {
+            throw new UnexpectedError(spaceTrim(function (block) {
+                return "\n                            Cannot find model in OpenAI models with name \"".concat(defaultModelName, "\" which should be used as default.\n\n                            Available models:\n                            ").concat(block(OPENAI_MODELS.map(function (_a) {
+                    var modelName = _a.modelName;
+                    return "- \"".concat(modelName, "\"");
+                }).join('\n')), "\n\n                        ");
+            }));
+        }
+        return model;
+    };
+    /**
+     * Default model for chat variant.
+     */
+    OpenAiExecutionTools.prototype.getDefaultChatModel = function () {
+        return this.getDefaultModel('gpt-4o');
+    };
+    /**
+     * Default model for completion variant.
+     */
+    OpenAiExecutionTools.prototype.getDefaultCompletionModel = function () {
+        return this.getDefaultModel('gpt-3.5-turbo-instruct');
+    };
+    /**
+     * Default model for completion variant.
+     */
+    OpenAiExecutionTools.prototype.getDefaultEmbeddingModel = function () {
+        return this.getDefaultModel('text-embedding-3-large');
+    };
+    // <- Note: [🤖] getDefaultXxxModel
+    /**
+     * List all available OpenAI models that can be used
+     */
+    OpenAiExecutionTools.prototype.listModels = function () {
+        /*
+        Note: Dynamic lising of the models
+        const models = await this.openai.models.list({});
+
+        console.log({ models });
+        console.log(models.data);
+        */
+        return OPENAI_MODELS;
+    };
+    return OpenAiExecutionTools;
+}());
+/**
+ * TODO: [🧠][🧙‍♂️] Maybe there can be some wizzard for thoose who want to use just OpenAI
+ * TODO: Maybe Create some common util for callChatModel and callCompletionModel
+ * TODO: Maybe make custom OpenaiError
+ * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+ */
+
+/**
+ * @@@
+ *
+ * Note: This function is not cached, every call creates new instance of `LlmExecutionTools`
+ *
+ * It looks for environment variables:
+ * - `process.env.OPENAI_API_KEY`
+ * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ *
+ * @returns @@@
+ */
+function createLlmToolsFromEnv(options) {
+    if (options === void 0) { options = {}; }
+    if (!isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `createLlmToolsFromEnv` works only in Node.js environment');
+    }
+    var _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
+    var llmTools = [];
+    if (typeof process.env.OPENAI_API_KEY === 'string') {
+        llmTools.push(new OpenAiExecutionTools({
+            isVerbose: isVerbose,
+            apiKey: process.env.OPENAI_API_KEY,
+        }));
+    }
+    if (typeof process.env.ANTHROPIC_CLAUDE_API_KEY === 'string') {
+        llmTools.push(new AnthropicClaudeExecutionTools({
+            isVerbose: isVerbose,
+            apiKey: process.env.ANTHROPIC_CLAUDE_API_KEY,
+        }));
+    }
+    if (llmTools.length === 0) {
+        throw new Error(spaceTrim("\n                No LLM tools found in the environment\n\n                Please set one of environment variables:\n                - OPENAI_API_KEY\n                - ANTHROPIC_CLAUDE_API_KEY\n            "));
+    }
+    else if (llmTools.length === 1) {
+        return llmTools[0];
+    }
+    else {
+        return joinLlmExecutionTools.apply(void 0, __spreadArray([], __read(llmTools), false));
+    }
+}
+/**
+ * TODO: [🔼] !!! Export via `@promptbook/node`
+ * TODO: @@@ write discussion about this - wizzard
+ * TODO: Add Azure
+ * TODO: [🧠] Which name is better `createLlmToolsFromEnv` or `createLlmToolsFromEnvironment`?
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠] Maybe pass env as argument
  * Note: [🟢] This code should never be published outside of `@promptbook/node`
  */
 
-export { PROMPTBOOK_VERSION, createCollectionFromDirectory };
+export { PROMPTBOOK_VERSION, createCollectionFromDirectory, createLlmToolsFromEnv };
 //# sourceMappingURL=index.es.js.map