@promptbook/cli 0.98.0-5 → 0.98.0-8

package/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.98.0-5';
+const PROMPTBOOK_ENGINE_VERSION = '0.98.0-8';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -261,7 +261,7 @@ const DEFAULT_MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_MAX_EXECUTION_ATTEMPTS = 3; // <- TODO: [🤹‍♂️]
+const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
 // <- TODO: [🐝]
 /**
  * Where to store your books
@@ -1060,7 +1060,7 @@ function jsonParse(value) {
         throw new Error(spaceTrim((block) => `
                     ${block(error.message)}
 
-                    The JSON text:
+                    The expected JSON text:
                     ${block(value)}
                 `));
     }
@@ -2758,6 +2758,361 @@ function extractParameterNames(template) {
     return parameterNames;
 }
 
+/**
+ * Function isValidJsonString will tell you if the string is valid JSON or not
+ *
+ * @param value The string to check
+ * @returns `true` if the string is a valid JSON string, false otherwise
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (error) {
+        assertsError(error);
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        return false;
+    }
+}
+
+/**
+ * Makes first letter of a string uppercase
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function capitalize(word) {
+    return word.substring(0, 1).toUpperCase() + word.substring(1);
+}
+
+/**
+ * Extracts all code blocks from markdown.
+ *
+ * Note: There are multiple similar functions:
+ * - `extractBlock` just extracts the content of the code block which is also used as built-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @param markdown any valid markdown
+ * @returns code blocks with language and content
+ * @throws {ParseError} if block is not closed properly
+ * @public exported from `@promptbook/markdown-utils`
+ */
+function extractAllBlocksFromMarkdown(markdown) {
+    const codeBlocks = [];
+    const lines = markdown.split('\n');
+    // Note: [0] Ensure that the last block notated by gt > will be closed
+    lines.push('');
+    let currentCodeBlock = null;
+    for (const line of lines) {
+        if (line.startsWith('> ') || line === '>') {
+            if (currentCodeBlock === null) {
+                currentCodeBlock = { blockNotation: '>', language: null, content: '' };
+            } /* not else */
+            if (currentCodeBlock.blockNotation === '>') {
+                if (currentCodeBlock.content !== '') {
+                    currentCodeBlock.content += '\n';
+                }
+                currentCodeBlock.content += line.slice(2);
+            }
+        }
+        else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
+            codeBlocks.push(currentCodeBlock);
+            currentCodeBlock = null;
+        }
+        /* not else */
+        if (line.startsWith('```')) {
+            const language = line.slice(3).trim() || null;
+            if (currentCodeBlock === null) {
+                currentCodeBlock = { blockNotation: '```', language, content: '' };
+            }
+            else {
+                if (language !== null) {
+                    throw new ParseError(`${capitalize(currentCodeBlock.language || 'the')} code block was not closed and already opening new ${language} code block`);
+                }
+                codeBlocks.push(currentCodeBlock);
+                currentCodeBlock = null;
+            }
+        }
+        else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
+            if (currentCodeBlock.content !== '') {
+                currentCodeBlock.content += '\n';
+            }
+            currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make proper unescape */;
+        }
+    }
+    if (currentCodeBlock !== null) {
+        throw new ParseError(`${capitalize(currentCodeBlock.language || 'the')} code block was not closed at the end of the markdown`);
+    }
+    return codeBlocks;
+}
+/**
+ * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
+ */
+
+/**
+ * Extracts  extracts exactly one valid JSON code block
+ *
+ * - When given string is a valid JSON as it is, it just returns it
+ * - When there is no JSON code block the function throws a `ParseError`
+ * - When there are multiple JSON code blocks the function throws a `ParseError`
+ *
+ * Note: It is not important if marked as ```json BUT if it is VALID JSON
+ * Note: There are multiple similar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ * @throws {ParseError} if there is no valid JSON block in the markdown
+ */
+function extractJsonBlock(markdown) {
+    if (isValidJsonString(markdown)) {
+        return markdown;
+    }
+    const codeBlocks = extractAllBlocksFromMarkdown(markdown);
+    const jsonBlocks = codeBlocks.filter(({ content }) => isValidJsonString(content));
+    if (jsonBlocks.length === 0) {
+        throw new Error('There is no valid JSON block in the markdown');
+    }
+    if (jsonBlocks.length > 1) {
+        throw new Error('There are multiple JSON code blocks in the markdown');
+    }
+    return jsonBlocks[0].content;
+}
+/**
+ * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
+ * TODO: [🏢] Make this logic part of `JsonFormatParser` or `isValidJsonString`
+ */
+
+/**
+ * Counts number of characters in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countCharacters(text) {
+    // Remove null characters
+    text = text.replace(/\0/g, '');
+    // Replace emojis (and also ZWJ sequence) with hyphens
+    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+    text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
+    return text.length;
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Number of characters per standard line with 11pt Arial font size.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+const CHARACTERS_PER_STANDARD_LINE = 63;
+/**
+ * Number of lines per standard A4 page with 11pt Arial font size and standard margins and spacing.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+const LINES_PER_STANDARD_PAGE = 44;
+/**
+ * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Counts number of lines in the text
+ *
+ * Note: This does not check only for the presence of newlines, but also for the length of the standard line.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countLines(text) {
+    text = text.replace('\r\n', '\n');
+    text = text.replace('\r', '\n');
+    const lines = text.split('\n');
+    return lines.reduce((count, line) => count + Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 0);
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Counts number of pages in the text
+ *
+ * Note: This does not check only for the count of newlines, but also for the length of the standard line and length of the standard page.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countPages(text) {
+    return Math.ceil(countLines(text) / LINES_PER_STANDARD_PAGE);
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Counts number of paragraphs in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countParagraphs(text) {
+    return text.split(/\n\s*\n/).filter((paragraph) => paragraph.trim() !== '').length;
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Split text into sentences
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function splitIntoSentences(text) {
+    return text.split(/[.!?]+/).filter((sentence) => sentence.trim() !== '');
+}
+/**
+ * Counts number of sentences in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countSentences(text) {
+    return splitIntoSentences(text).length;
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Counts number of words in the text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function countWords(text) {
+    text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
+    text = removeDiacritics(text);
+    // Add spaces before uppercase letters preceded by lowercase letters (for camelCase)
+    text = text.replace(/([a-z])([A-Z])/g, '$1 $2');
+    return text.split(/[^a-zа-я0-9]+/i).filter((word) => word.length > 0).length;
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ */
+
+/**
+ * Index of all counter functions
+ *
+ * @public exported from `@promptbook/utils`
+ */
+const CountUtils = {
+    CHARACTERS: countCharacters,
+    WORDS: countWords,
+    SENTENCES: countSentences,
+    PARAGRAPHS: countParagraphs,
+    LINES: countLines,
+    PAGES: countPages,
+};
+/**
+ * TODO: [🧠][🤠] This should be probably as part of `TextFormatParser`
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Function checkExpectations will check if the expectations on given value are met
+ *
+ * Note: There are two similar functions:
+ * - `checkExpectations` which throws an error if the expectations are not met
+ * - `isPassingExpectations` which returns a boolean
+ *
+ * @throws {ExpectError} if the expectations are not met
+ * @returns {void} Nothing
+ * @private internal function of `createPipelineExecutor`
+ */
+function checkExpectations(expectations, value) {
+    for (const [unit, { max, min }] of Object.entries(expectations)) {
+        const amount = CountUtils[unit.toUpperCase()](value);
+        if (min && amount < min) {
+            throw new ExpectError(`Expected at least ${min} ${unit} but got ${amount}`);
+        } /* not else */
+        if (max && amount > max) {
+            throw new ExpectError(`Expected at most ${max} ${unit} but got ${amount}`);
+        }
+    }
+}
+/**
+ * TODO: [💝] Unite object for expecting amount and format
+ * TODO: [🧠][🤠] This should be part of `TextFormatParser`
+ * Note: [💝] and [🤠] are interconnected together
+ */
+
+/**
+ * Validates a prompt result against expectations and format requirements.
+ * This function provides a common abstraction for result validation that can be used
+ * by both execution logic and caching logic to ensure consistency.
+ *
+ * @param options - The validation options including result string, expectations, and format
+ * @returns Validation result with processed string and validity status
+ * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
+ */
+function validatePromptResult(options) {
+    const { resultString, expectations, format } = options;
+    let processedResultString = resultString;
+    let validationError;
+    try {
+        // TODO: [💝] Unite object for expecting amount and format
+        if (format) {
+            if (format === 'JSON') {
+                if (!isValidJsonString(processedResultString)) {
+                    // TODO: [🏢] Do more universally via `FormatParser`
+                    try {
+                        processedResultString = extractJsonBlock(processedResultString);
+                    }
+                    catch (error) {
+                        keepUnused(error);
+                        throw new ExpectError(spaceTrim$1((block) => `
+                                    Expected valid JSON string
+
+                                    The expected JSON text:
+                                    ${block(processedResultString)}
+                                `));
+                    }
+                }
+            }
+            else {
+                throw new UnexpectedError(`Unknown format "${format}"`);
+            }
+        }
+        // TODO: [💝] Unite object for expecting amount and format
+        if (expectations) {
+            checkExpectations(expectations, processedResultString);
+        }
+        return {
+            isValid: true,
+            processedResultString,
+        };
+    }
+    catch (error) {
+        if (error instanceof ExpectError) {
+            validationError = error;
+        }
+        else {
+            // Re-throw non-ExpectError errors (like UnexpectedError)
+            throw error;
+        }
+        return {
+            isValid: false,
+            processedResultString,
+            error: validationError,
+        };
+    }
+}
+
 /**
  * Intercepts LLM tools and counts total usage of the tools
  *
@@ -2788,6 +3143,7 @@ function cacheLlmTools(llmTools, options = {}) {
         },
     };
     const callCommonModel = async (prompt) => {
+        var _a;
         const { parameters, content, modelRequirements } = prompt;
         // <- Note: These are relevant things from the prompt that the cache key should depend on.
         // TODO: Maybe some standalone function for normalization of content for cache
@@ -2843,11 +3199,42 @@ function cacheLlmTools(llmTools, options = {}) {
         // 1. It has a content property that is null or undefined
         // 2. It has an error property that is truthy
         // 3. It has a success property that is explicitly false
-        const isFailedResult = promptResult.content === null ||
+        // 4. It doesn't meet the prompt's expectations or format requirements
+        const isBasicFailedResult = promptResult.content === null ||
             promptResult.content === undefined ||
             promptResult.error ||
             promptResult.success === false;
-        if (!isFailedResult) {
+        let shouldCache = !isBasicFailedResult;
+        // If the basic result is valid, check against expectations and format
+        if (shouldCache && promptResult.content) {
+            try {
+                const validationResult = validatePromptResult({
+                    resultString: promptResult.content,
+                    expectations: prompt.expectations,
+                    format: prompt.format,
+                });
+                shouldCache = validationResult.isValid;
+                if (!shouldCache && isVerbose) {
+                    console.info('Not caching result that fails expectations/format validation for key:', key, {
+                        content: promptResult.content,
+                        expectations: prompt.expectations,
+                        format: prompt.format,
+                        validationError: (_a = validationResult.error) === null || _a === void 0 ? void 0 : _a.message,
+                    });
+                }
+            }
+            catch (error) {
+                // If validation throws an unexpected error, don't cache
+                shouldCache = false;
+                if (isVerbose) {
+                    console.info('Not caching result due to validation error for key:', key, {
+                        content: promptResult.content,
+                        validationError: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        }
+        if (shouldCache) {
             await storage.setItem(key, {
                 date: $getCurrentDate(),
                 promptbookVersion: PROMPTBOOK_ENGINE_VERSION,
@@ -2864,7 +3251,7 @@ function cacheLlmTools(llmTools, options = {}) {
                 promptResult,
             });
         }
-        else if (isVerbose) {
+        else if (isVerbose && isBasicFailedResult) {
             console.info('Not caching failed result for key:', key, {
                 content: promptResult.content,
                 error: promptResult.error,
@@ -4677,28 +5064,6 @@ async function loadArchive(filePath, fs) {
 
 var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou 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> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",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> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou 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> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `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### Key `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}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `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### Key `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}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @param value The string to check
- * @returns `true` if the string is a valid JSON string, false otherwise
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
-    }
-    catch (error) {
-        assertsError(error);
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
-    }
-}
-
 /**
  * Function `validatePipelineString` will validate the if the string is a valid pipeline string
  * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
@@ -4762,15 +5127,6 @@ function prettifyMarkdown(content) {
     }
 }
 
-/**
- * Makes first letter of a string uppercase
- *
- * @public exported from `@promptbook/utils`
- */
-function capitalize(word) {
-    return word.substring(0, 1).toUpperCase() + word.substring(1);
-}
-
 /**
  * Converts promptbook in JSON format to string format
  *
@@ -5682,142 +6038,41 @@ const CsvFormatParser = {
                                 ${block(csv.errors.map((error) => error.message).join('\n\n'))}
 
                                 The CSV setings:
-                                ${block(JSON.stringify({ ...settings, ...MANDATORY_CSV_SETTINGS }, null, 2))}
-
-                                The CSV data:
-                                ${block(value)}
-                            `));
-                }
-                const mappedData = await Promise.all(csv.data.map(async (row, rowIndex) => {
-                    return /* not await */ Promise.all(Object.entries(row).map(async ([key, value], columnIndex, array) => {
-                        const index = rowIndex * Object.keys(row).length + columnIndex;
-                        return /* not await */ mapCallback({ [key]: value }, index, array.length);
-                    }));
-                }));
-                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
-            },
-        },
-    ],
-};
-/**
- * TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
- * TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `CsvFormatParser` implement `heal
- * TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside CSV objects and other formats
- */
-
-/**
- * Definition for JSON format
- *
- * @private still in development [🏢]
- */
-const JsonFormatParser = {
-    formatName: 'JSON',
-    mimeType: 'application/json',
-    isValid(value, settings, schema) {
-        return isValidJsonString(value);
-    },
-    canBeValid(partialValue, settings, schema) {
-        return true;
-    },
-    heal(value, settings, schema) {
-        throw new Error('Not implemented');
-    },
-    subvalueParsers: [],
-};
-/**
- * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_json
- * TODO: [1] Make type for JSON Settings and Schema
- * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
- * TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
- * TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `JsonFormatParser` implement `heal
- * TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside JSON objects and other formats
- */
-
-/**
- * Definition for any text - this will be always valid
- *
- * Note: This is not useful for validation, but for splitting and mapping with `subvalueParsers`
- *
- * @public exported from `@promptbook/core`
- */
-const TextFormatParser = {
-    formatName: 'TEXT',
-    isValid(value) {
-        return typeof value === 'string';
-    },
-    canBeValid(partialValue) {
-        return typeof partialValue === 'string';
-    },
-    heal() {
-        throw new UnexpectedError('It does not make sense to call `TextFormatParser.heal`');
-    },
-    subvalueParsers: [
-        {
-            subvalueName: 'LINE',
-            async mapValues(options) {
-                const { value, mapCallback, onProgress } = options;
-                const lines = value.split('\n');
-                const mappedLines = await Promise.all(lines.map((lineContent, lineNumber, array) => 
-                // TODO: [🧠] Maybe option to skip empty line
-                /* not await */ mapCallback({
-                    lineContent,
-                    // TODO: [🧠] Maybe also put here `lineNumber`
-                }, lineNumber, array.length)));
-                return mappedLines.join('\n');
+                                ${block(JSON.stringify({ ...settings, ...MANDATORY_CSV_SETTINGS }, null, 2))}
+
+                                The CSV data:
+                                ${block(value)}
+                            `));
+                }
+                const mappedData = await Promise.all(csv.data.map(async (row, rowIndex) => {
+                    return /* not await */ Promise.all(Object.entries(row).map(async ([key, value], columnIndex, array) => {
+                        const index = rowIndex * Object.keys(row).length + columnIndex;
+                        return /* not await */ mapCallback({ [key]: value }, index, array.length);
+                    }));
+                }));
+                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
             },
         },
-        // <- TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
     ],
 };
 /**
- * TODO: [1] Make type for XML Text and Schema
- * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
- * TODO: [🍓] In `TextFormatParser` implement simple `isValid`
- * TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `TextFormatParser` implement `heal
- * TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside each item of list and other formats
- */
-
-/**
- * Function to check if a string is valid XML
- *
- * @param value
- * @returns `true` if the string is a valid XML string, false otherwise
- *
- * @public exported from `@promptbook/utils`
+ * TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
+ * TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
+ * TODO: [🍓] In `CsvFormatParser` implement `heal
+ * TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
+ * TODO: [🏢] Allow to expect something inside CSV objects and other formats
  */
-function isValidXmlString(value) {
-    try {
-        const parser = new DOMParser();
-        const parsedDocument = parser.parseFromString(value, 'application/xml');
-        const parserError = parsedDocument.getElementsByTagName('parsererror');
-        if (parserError.length > 0) {
-            return false;
-        }
-        return true;
-    }
-    catch (error) {
-        assertsError(error);
-        return false;
-    }
-}
 
 /**
- * Definition for XML format
+ * Definition for JSON format
  *
  * @private still in development [🏢]
  */
-const XmlFormatParser = {
-    formatName: 'XML',
-    mimeType: 'application/xml',
+const JsonFormatParser = {
+    formatName: 'JSON',
+    mimeType: 'application/json',
     isValid(value, settings, schema) {
-        return isValidXmlString(value);
+        return isValidJsonString(value);
     },
     canBeValid(partialValue, settings, schema) {
         return true;
@@ -5829,443 +6084,282 @@ const XmlFormatParser = {
 };
 /**
  * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_xml
- * TODO: [1] Make type for XML Settings and Schema
- * TODO: [🧠] What to use for validating XMLs - XSD,...
- * TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
- * TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `XmlFormatParser` implement `heal
- * TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside XML and other formats
- */
-
-/**
- * Definitions for all formats supported by Promptbook
- *
- * @private internal index of `...` <- TODO [🏢]
- */
-const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser, CsvFormatParser];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Maps available parameters to expected parameters for a pipeline task.
- *
- * The strategy is:
- * 1) First, match parameters by name where both available and expected.
- * 2) Then, if there are unmatched expected and available parameters, map them by order.
- *
- * @throws {PipelineExecutionError} If the number of unmatched expected and available parameters does not match, or mapping is ambiguous.
- * @private within the repository used in `createPipelineExecutor`
- */
-function mapAvailableToExpectedParameters(options) {
-    const { expectedParameters, availableParameters } = options;
-    const availableParametersNames = new Set(Object.keys(availableParameters));
-    const expectedParameterNames = new Set(Object.keys(expectedParameters));
-    const mappedParameters = {};
-    // Phase 1️⃣: Matching mapping
-    for (const parameterName of Array.from(union(availableParametersNames, expectedParameterNames))) {
-        // Situation: Parameter is available and expected
-        if (availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) {
-            mappedParameters[parameterName] = availableParameters[parameterName];
-            // <- Note: [👩‍👩‍👧] Maybe detect parameter collision here?
-            availableParametersNames.delete(parameterName);
-            expectedParameterNames.delete(parameterName);
-        }
-        // Situation: Parameter is available but NOT expected
-        else if (availableParametersNames.has(parameterName) && !expectedParameterNames.has(parameterName)) ;
-        // Situation: Parameter is NOT available BUT expected
-        else if (!availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) ;
-    }
-    if (expectedParameterNames.size === 0) {
-        // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent accidental modifications after mapping
-        Object.freeze(mappedParameters);
-        return mappedParameters;
-    }
-    // Phase 2️⃣: Non-matching mapping
-    if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim((block) => `
-                    Can not map available parameters to expected parameters
-
-                    Mapped parameters:
-                    ${block(Object.keys(mappedParameters)
-            .map((parameterName) => `- {${parameterName}}`)
-            .join('\n'))}
-
-                    Expected parameters which can not be mapped:
-                    ${block(Array.from(expectedParameterNames)
-            .map((parameterName) => `- {${parameterName}}`)
-            .join('\n'))}
-
-                    Remaining available parameters:
-                    ${block(Array.from(availableParametersNames)
-            .map((parameterName) => `- {${parameterName}}`)
-            .join('\n'))}
-
-                `));
-    }
-    const expectedParameterNamesArray = Array.from(expectedParameterNames);
-    const availableParametersNamesArray = Array.from(availableParametersNames);
-    for (let i = 0; i < expectedParameterNames.size; i++) {
-        mappedParameters[expectedParameterNamesArray[i]] = availableParameters[availableParametersNamesArray[i]];
-    }
-    // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent accidental modifications after mapping
-    Object.freeze(mappedParameters);
-    return mappedParameters;
-}
-
-/**
- * Extracts all code blocks from markdown.
- *
- * Note: There are multiple similar functions:
- * - `extractBlock` just extracts the content of the code block which is also used as built-in function for postprocessing
- * - `extractJsonBlock` extracts exactly one valid JSON code block
- * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
- * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
- *
- * @param markdown any valid markdown
- * @returns code blocks with language and content
- * @throws {ParseError} if block is not closed properly
- * @public exported from `@promptbook/markdown-utils`
- */
-function extractAllBlocksFromMarkdown(markdown) {
-    const codeBlocks = [];
-    const lines = markdown.split('\n');
-    // Note: [0] Ensure that the last block notated by gt > will be closed
-    lines.push('');
-    let currentCodeBlock = null;
-    for (const line of lines) {
-        if (line.startsWith('> ') || line === '>') {
-            if (currentCodeBlock === null) {
-                currentCodeBlock = { blockNotation: '>', language: null, content: '' };
-            } /* not else */
-            if (currentCodeBlock.blockNotation === '>') {
-                if (currentCodeBlock.content !== '') {
-                    currentCodeBlock.content += '\n';
-                }
-                currentCodeBlock.content += line.slice(2);
-            }
-        }
-        else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '>' /* <- Note: [0] */) {
-            codeBlocks.push(currentCodeBlock);
-            currentCodeBlock = null;
-        }
-        /* not else */
-        if (line.startsWith('```')) {
-            const language = line.slice(3).trim() || null;
-            if (currentCodeBlock === null) {
-                currentCodeBlock = { blockNotation: '```', language, content: '' };
-            }
-            else {
-                if (language !== null) {
-                    throw new ParseError(`${capitalize(currentCodeBlock.language || 'the')} code block was not closed and already opening new ${language} code block`);
-                }
-                codeBlocks.push(currentCodeBlock);
-                currentCodeBlock = null;
-            }
-        }
-        else if (currentCodeBlock !== null && currentCodeBlock.blockNotation === '```') {
-            if (currentCodeBlock.content !== '') {
-                currentCodeBlock.content += '\n';
-            }
-            currentCodeBlock.content += line.split('\\`\\`\\`').join('```') /* <- TODO: Maybe make proper unescape */;
-        }
-    }
-    if (currentCodeBlock !== null) {
-        throw new ParseError(`${capitalize(currentCodeBlock.language || 'the')} code block was not closed at the end of the markdown`);
-    }
-    return codeBlocks;
-}
-/**
- * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
- */
-
-/**
- * Extracts  extracts exactly one valid JSON code block
- *
- * - When given string is a valid JSON as it is, it just returns it
- * - When there is no JSON code block the function throws a `ParseError`
- * - When there are multiple JSON code blocks the function throws a `ParseError`
- *
- * Note: It is not important if marked as ```json BUT if it is VALID JSON
- * Note: There are multiple similar function:
- * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
- * - `extractJsonBlock` extracts exactly one valid JSON code block
- * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
- * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
- *
- * @public exported from `@promptbook/markdown-utils`
- * @throws {ParseError} if there is no valid JSON block in the markdown
- */
-function extractJsonBlock(markdown) {
-    if (isValidJsonString(markdown)) {
-        return markdown;
-    }
-    const codeBlocks = extractAllBlocksFromMarkdown(markdown);
-    const jsonBlocks = codeBlocks.filter(({ content }) => isValidJsonString(content));
-    if (jsonBlocks.length === 0) {
-        throw new Error('There is no valid JSON block in the markdown');
-    }
-    if (jsonBlocks.length > 1) {
-        throw new Error('There are multiple JSON code blocks in the markdown');
-    }
-    return jsonBlocks[0].content;
-}
-/**
- * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
- * TODO: [🏢] Make this logic part of `JsonFormatParser` or `isValidJsonString`
+ * TODO: [0] Make string_serialized_json
+ * TODO: [1] Make type for JSON Settings and Schema
+ * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
+ * TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
+ * TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
+ * TODO: [🍓] In `JsonFormatParser` implement `heal
+ * TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
+ * TODO: [🏢] Allow to expect something inside JSON objects and other formats
  */
 
 /**
- * Takes an item or an array of items and returns an array of items
+ * Definition for any text - this will be always valid
  *
- * 1) Any item except array and undefined returns array with that one item (also null)
- * 2) Undefined returns empty array
- * 3) Array returns itself
+ * Note: This is not useful for validation, but for splitting and mapping with `subvalueParsers`
  *
- * @private internal utility
+ * @public exported from `@promptbook/core`
+ */
+const TextFormatParser = {
+    formatName: 'TEXT',
+    isValid(value) {
+        return typeof value === 'string';
+    },
+    canBeValid(partialValue) {
+        return typeof partialValue === 'string';
+    },
+    heal() {
+        throw new UnexpectedError('It does not make sense to call `TextFormatParser.heal`');
+    },
+    subvalueParsers: [
+        {
+            subvalueName: 'LINE',
+            async mapValues(options) {
+                const { value, mapCallback, onProgress } = options;
+                const lines = value.split('\n');
+                const mappedLines = await Promise.all(lines.map((lineContent, lineNumber, array) => 
+                // TODO: [🧠] Maybe option to skip empty line
+                /* not await */ mapCallback({
+                    lineContent,
+                    // TODO: [🧠] Maybe also put here `lineNumber`
+                }, lineNumber, array.length)));
+                return mappedLines.join('\n');
+            },
+        },
+        // <- TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
+    ],
+};
+/**
+ * TODO: [1] Make type for XML Text and Schema
+ * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
+ * TODO: [🍓] In `TextFormatParser` implement simple `isValid`
+ * TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
+ * TODO: [🍓] In `TextFormatParser` implement `heal
+ * TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
+ * TODO: [🏢] Allow to expect something inside each item of list and other formats
  */
-function arrayableToArray(input) {
-    if (input === undefined) {
-        return [];
-    }
-    if (input instanceof Array) {
-        return input;
-    }
-    return [input];
-}
 
 /**
- * Replaces parameters in template with values from parameters object
+ * Function to check if a string is valid XML
  *
- * Note: This function is not places strings into string,
- *       It's more complex and can handle this operation specifically for LLM models
+ * @param value
+ * @returns `true` if the string is a valid XML string, false otherwise
  *
- * @param template the template with parameters in {curly} braces
- * @param parameters the object with parameters
- * @returns the template with replaced parameters
- * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
  * @public exported from `@promptbook/utils`
  */
-function templateParameters(template, parameters) {
-    for (const [parameterName, parameterValue] of Object.entries(parameters)) {
-        if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
-            throw new UnexpectedError(`Parameter \`{${parameterName}}\` has missing value`);
-        }
-        else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
-            // TODO: [🍵]
-            throw new UnexpectedError(`Parameter \`{${parameterName}}\` is restricted to use`);
-        }
-    }
-    let replacedTemplates = template;
-    let match;
-    let loopLimit = LOOP_LIMIT;
-    while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
-        .exec(replacedTemplates))) {
-        if (loopLimit-- < 0) {
-            throw new LimitReachedError('Loop limit reached during parameters replacement in `templateParameters`');
-        }
-        const precol = match.groups.precol;
-        const parameterName = match.groups.parameterName;
-        if (parameterName === '') {
-            // Note: Skip empty placeholders. It's used to avoid confusion with JSON-like strings
-            continue;
-        }
-        if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
-            throw new PipelineExecutionError('Parameter is already opened or not closed');
-        }
-        if (parameters[parameterName] === undefined) {
-            throw new PipelineExecutionError(`Parameter \`{${parameterName}}\` is not defined`);
-        }
-        let parameterValue = parameters[parameterName];
-        if (parameterValue === undefined) {
-            throw new PipelineExecutionError(`Parameter \`{${parameterName}}\` is not defined`);
-        }
-        parameterValue = valueToString(parameterValue);
-        // Escape curly braces in parameter values to prevent prompt-injection
-        parameterValue = parameterValue.replace(/[{}]/g, '\\$&');
-        if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
-            parameterValue = parameterValue
-                .split('\n')
-                .map((line, index) => (index === 0 ? line : `${precol}${line}`))
-                .join('\n');
+function isValidXmlString(value) {
+    try {
+        const parser = new DOMParser();
+        const parsedDocument = parser.parseFromString(value, 'application/xml');
+        const parserError = parsedDocument.getElementsByTagName('parsererror');
+        if (parserError.length > 0) {
+            return false;
         }
-        replacedTemplates =
-            replacedTemplates.substring(0, match.index + precol.length) +
-                parameterValue +
-                replacedTemplates.substring(match.index + precol.length + parameterName.length + 2);
-    }
-    // [💫] Check if there are parameters that are not closed properly
-    if (/{\w+$/.test(replacedTemplates)) {
-        throw new PipelineExecutionError('Parameter is not closed');
+        return true;
     }
-    // [💫] Check if there are parameters that are not opened properly
-    if (/^\w+}/.test(replacedTemplates)) {
-        throw new PipelineExecutionError('Parameter is not opened');
+    catch (error) {
+        assertsError(error);
+        return false;
     }
-    return replacedTemplates;
 }
 
 /**
- * Counts number of characters in the text
+ * Definition for XML format
  *
- * @public exported from `@promptbook/utils`
+ * @private still in development [🏢]
  */
-function countCharacters(text) {
-    // Remove null characters
-    text = text.replace(/\0/g, '');
-    // Replace emojis (and also ZWJ sequence) with hyphens
-    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-    text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
-    return text.length;
-}
+const XmlFormatParser = {
+    formatName: 'XML',
+    mimeType: 'application/xml',
+    isValid(value, settings, schema) {
+        return isValidXmlString(value);
+    },
+    canBeValid(partialValue, settings, schema) {
+        return true;
+    },
+    heal(value, settings, schema) {
+        throw new Error('Not implemented');
+    },
+    subvalueParsers: [],
+};
 /**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ * TODO: [🧠] Maybe proper instance of object
+ * TODO: [0] Make string_serialized_xml
+ * TODO: [1] Make type for XML Settings and Schema
+ * TODO: [🧠] What to use for validating XMLs - XSD,...
+ * TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
+ * TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
+ * TODO: [🍓] In `XmlFormatParser` implement `heal
+ * TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
+ * TODO: [🏢] Allow to expect something inside XML and other formats
  */
 
 /**
- * Number of characters per standard line with 11pt Arial font size.
- *
- * @public exported from `@promptbook/utils`
- */
-const CHARACTERS_PER_STANDARD_LINE = 63;
-/**
- * Number of lines per standard A4 page with 11pt Arial font size and standard margins and spacing.
+ * Definitions for all formats supported by Promptbook
  *
- * @public exported from `@promptbook/utils`
+ * @private internal index of `...` <- TODO [🏢]
  */
-const LINES_PER_STANDARD_PAGE = 44;
+const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser, CsvFormatParser];
 /**
- * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
 /**
- * Counts number of lines in the text
+ * Maps available parameters to expected parameters for a pipeline task.
  *
- * Note: This does not check only for the presence of newlines, but also for the length of the standard line.
+ * The strategy is:
+ * 1) First, match parameters by name where both available and expected.
+ * 2) Then, if there are unmatched expected and available parameters, map them by order.
  *
- * @public exported from `@promptbook/utils`
- */
-function countLines(text) {
-    text = text.replace('\r\n', '\n');
-    text = text.replace('\r', '\n');
-    const lines = text.split('\n');
-    return lines.reduce((count, line) => count + Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 0);
-}
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ * @throws {PipelineExecutionError} If the number of unmatched expected and available parameters does not match, or mapping is ambiguous.
+ * @private within the repository used in `createPipelineExecutor`
  */
+function mapAvailableToExpectedParameters(options) {
+    const { expectedParameters, availableParameters } = options;
+    const availableParametersNames = new Set(Object.keys(availableParameters));
+    const expectedParameterNames = new Set(Object.keys(expectedParameters));
+    const mappedParameters = {};
+    // Phase 1️⃣: Matching mapping
+    for (const parameterName of Array.from(union(availableParametersNames, expectedParameterNames))) {
+        // Situation: Parameter is available and expected
+        if (availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) {
+            mappedParameters[parameterName] = availableParameters[parameterName];
+            // <- Note: [👩‍👩‍👧] Maybe detect parameter collision here?
+            availableParametersNames.delete(parameterName);
+            expectedParameterNames.delete(parameterName);
+        }
+        // Situation: Parameter is available but NOT expected
+        else if (availableParametersNames.has(parameterName) && !expectedParameterNames.has(parameterName)) ;
+        // Situation: Parameter is NOT available BUT expected
+        else if (!availableParametersNames.has(parameterName) && expectedParameterNames.has(parameterName)) ;
+    }
+    if (expectedParameterNames.size === 0) {
+        // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent accidental modifications after mapping
+        Object.freeze(mappedParameters);
+        return mappedParameters;
+    }
+    // Phase 2️⃣: Non-matching mapping
+    if (expectedParameterNames.size !== availableParametersNames.size) {
+        throw new PipelineExecutionError(spaceTrim((block) => `
+                    Can not map available parameters to expected parameters
 
-/**
- * Counts number of pages in the text
- *
- * Note: This does not check only for the count of newlines, but also for the length of the standard line and length of the standard page.
- *
- * @public exported from `@promptbook/utils`
- */
-function countPages(text) {
-    return Math.ceil(countLines(text) / LINES_PER_STANDARD_PAGE);
-}
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */
+                    Mapped parameters:
+                    ${block(Object.keys(mappedParameters)
+            .map((parameterName) => `- {${parameterName}}`)
+            .join('\n'))}
 
-/**
- * Counts number of paragraphs in the text
- *
- * @public exported from `@promptbook/utils`
- */
-function countParagraphs(text) {
-    return text.split(/\n\s*\n/).filter((paragraph) => paragraph.trim() !== '').length;
+                    Expected parameters which can not be mapped:
+                    ${block(Array.from(expectedParameterNames)
+            .map((parameterName) => `- {${parameterName}}`)
+            .join('\n'))}
+
+                    Remaining available parameters:
+                    ${block(Array.from(availableParametersNames)
+            .map((parameterName) => `- {${parameterName}}`)
+            .join('\n'))}
+
+                `));
+    }
+    const expectedParameterNamesArray = Array.from(expectedParameterNames);
+    const availableParametersNamesArray = Array.from(availableParametersNames);
+    for (let i = 0; i < expectedParameterNames.size; i++) {
+        mappedParameters[expectedParameterNamesArray[i]] = availableParameters[availableParametersNamesArray[i]];
+    }
+    // Note: [👨‍👨‍👧] Now we can freeze `mappedParameters` to prevent accidental modifications after mapping
+    Object.freeze(mappedParameters);
+    return mappedParameters;
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */
 
 /**
- * Split text into sentences
+ * Takes an item or an array of items and returns an array of items
  *
- * @public exported from `@promptbook/utils`
- */
-function splitIntoSentences(text) {
-    return text.split(/[.!?]+/).filter((sentence) => sentence.trim() !== '');
-}
-/**
- * Counts number of sentences in the text
+ * 1) Any item except array and undefined returns array with that one item (also null)
+ * 2) Undefined returns empty array
+ * 3) Array returns itself
  *
- * @public exported from `@promptbook/utils`
+ * @private internal utility
  */
-function countSentences(text) {
-    return splitIntoSentences(text).length;
+function arrayableToArray(input) {
+    if (input === undefined) {
+        return [];
+    }
+    if (input instanceof Array) {
+        return input;
+    }
+    return [input];
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */
 
 /**
- * Counts number of words in the text
+ * Replaces parameters in template with values from parameters object
  *
- * @public exported from `@promptbook/utils`
- */
-function countWords(text) {
-    text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
-    text = removeDiacritics(text);
-    // Add spaces before uppercase letters preceded by lowercase letters (for camelCase)
-    text = text.replace(/([a-z])([A-Z])/g, '$1 $2');
-    return text.split(/[^a-zа-я0-9]+/i).filter((word) => word.length > 0).length;
-}
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */
-
-/**
- * Index of all counter functions
+ * Note: This function is not places strings into string,
+ *       It's more complex and can handle this operation specifically for LLM models
  *
+ * @param template the template with parameters in {curly} braces
+ * @param parameters the object with parameters
+ * @returns the template with replaced parameters
+ * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
  * @public exported from `@promptbook/utils`
  */
-const CountUtils = {
-    CHARACTERS: countCharacters,
-    WORDS: countWords,
-    SENTENCES: countSentences,
-    PARAGRAPHS: countParagraphs,
-    LINES: countLines,
-    PAGES: countPages,
-};
-/**
- * TODO: [🧠][🤠] This should be probably as part of `TextFormatParser`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Function checkExpectations will check if the expectations on given value are met
- *
- * Note: There are two similar functions:
- * - `checkExpectations` which throws an error if the expectations are not met
- * - `isPassingExpectations` which returns a boolean
- *
- * @throws {ExpectError} if the expectations are not met
- * @returns {void} Nothing
- * @private internal function of `createPipelineExecutor`
- */
-function checkExpectations(expectations, value) {
-    for (const [unit, { max, min }] of Object.entries(expectations)) {
-        const amount = CountUtils[unit.toUpperCase()](value);
-        if (min && amount < min) {
-            throw new ExpectError(`Expected at least ${min} ${unit} but got ${amount}`);
-        } /* not else */
-        if (max && amount > max) {
-            throw new ExpectError(`Expected at most ${max} ${unit} but got ${amount}`);
+function templateParameters(template, parameters) {
+    for (const [parameterName, parameterValue] of Object.entries(parameters)) {
+        if (parameterValue === RESERVED_PARAMETER_MISSING_VALUE) {
+            throw new UnexpectedError(`Parameter \`{${parameterName}}\` has missing value`);
+        }
+        else if (parameterValue === RESERVED_PARAMETER_RESTRICTED) {
+            // TODO: [🍵]
+            throw new UnexpectedError(`Parameter \`{${parameterName}}\` is restricted to use`);
+        }
+    }
+    let replacedTemplates = template;
+    let match;
+    let loopLimit = LOOP_LIMIT;
+    while ((match = /^(?<precol>.*){(?<parameterName>\w+)}(.*)/m /* <- Not global */
+        .exec(replacedTemplates))) {
+        if (loopLimit-- < 0) {
+            throw new LimitReachedError('Loop limit reached during parameters replacement in `templateParameters`');
+        }
+        const precol = match.groups.precol;
+        const parameterName = match.groups.parameterName;
+        if (parameterName === '') {
+            // Note: Skip empty placeholders. It's used to avoid confusion with JSON-like strings
+            continue;
+        }
+        if (parameterName.indexOf('{') !== -1 || parameterName.indexOf('}') !== -1) {
+            throw new PipelineExecutionError('Parameter is already opened or not closed');
+        }
+        if (parameters[parameterName] === undefined) {
+            throw new PipelineExecutionError(`Parameter \`{${parameterName}}\` is not defined`);
+        }
+        let parameterValue = parameters[parameterName];
+        if (parameterValue === undefined) {
+            throw new PipelineExecutionError(`Parameter \`{${parameterName}}\` is not defined`);
+        }
+        parameterValue = valueToString(parameterValue);
+        // Escape curly braces in parameter values to prevent prompt-injection
+        parameterValue = parameterValue.replace(/[{}]/g, '\\$&');
+        if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
+            parameterValue = parameterValue
+                .split('\n')
+                .map((line, index) => (index === 0 ? line : `${precol}${line}`))
+                .join('\n');
         }
+        replacedTemplates =
+            replacedTemplates.substring(0, match.index + precol.length) +
+                parameterValue +
+                replacedTemplates.substring(match.index + precol.length + parameterName.length + 2);
+    }
+    // [💫] Check if there are parameters that are not closed properly
+    if (/{\w+$/.test(replacedTemplates)) {
+        throw new PipelineExecutionError('Parameter is not closed');
+    }
+    // [💫] Check if there are parameters that are not opened properly
+    if (/^\w+}/.test(replacedTemplates)) {
+        throw new PipelineExecutionError('Parameter is not opened');
     }
+    return replacedTemplates;
 }
-/**
- * TODO: [💝] Unite object for expecting amount and format
- * TODO: [🧠][🤠] This should be part of `TextFormatParser`
- * Note: [💝] and [🤠] are interconnected together
- */
 
 /**
  * Executes a pipeline task with multiple attempts, including joker and retry logic. Handles different task types
@@ -6289,13 +6383,13 @@ async function executeAttempts(options) {
     // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
     const _llms = arrayableToArray(tools.llm);
     const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
-    attempts: for (let attempt = -jokerParameterNames.length; attempt < maxAttempts; attempt++) {
-        const isJokerAttempt = attempt < 0;
-        const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attempt];
+    attempts: for (let attemptIndex = -jokerParameterNames.length; attemptIndex < maxAttempts; attemptIndex++) {
+        const isJokerAttempt = attemptIndex < 0;
+        const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
         // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
         if (isJokerAttempt && !jokerParameterName) {
             throw new UnexpectedError(spaceTrim$1((block) => `
-                        Joker not found in attempt ${attempt}
+                        Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
                     `));
@@ -6493,35 +6587,18 @@ async function executeAttempts(options) {
                 }
             }
             // TODO: [💝] Unite object for expecting amount and format
-            if (task.format) {
-                if (task.format === 'JSON') {
-                    if (!isValidJsonString($ongoingTaskResult.$resultString || '')) {
-                        // TODO: [🏢] Do more universally via `FormatParser`
-                        try {
-                            $ongoingTaskResult.$resultString = extractJsonBlock($ongoingTaskResult.$resultString || '');
-                        }
-                        catch (error) {
-                            keepUnused(error);
-                            throw new ExpectError(spaceTrim$1((block) => `
-                                        Expected valid JSON string
-
-                                        ${block(
-                            /*<- Note: No need for `pipelineIdentification`, it will be catched and added later */ '')}
-                                    `));
-                        }
-                    }
-                }
-                else {
-                    throw new UnexpectedError(spaceTrim$1((block) => `
-                                Unknown format "${task.format}"
-
-                                ${block(pipelineIdentification)}
-                            `));
+            // Use the common validation function for both format and expectations
+            if (task.format || task.expectations) {
+                const validationResult = validatePromptResult({
+                    resultString: $ongoingTaskResult.$resultString || '',
+                    expectations: task.expectations,
+                    format: task.format,
+                });
+                if (!validationResult.isValid) {
+                    throw validationResult.error;
                 }
-            }
-            // TODO: [💝] Unite object for expecting amount and format
-            if (task.expectations) {
-                checkExpectations(task.expectations, $ongoingTaskResult.$resultString || '');
+                // Update the result string in case format processing modified it (e.g., JSON extraction)
+                $ongoingTaskResult.$resultString = validationResult.processedResultString;
             }
             break attempts;
         }
@@ -6535,6 +6612,7 @@ async function executeAttempts(options) {
                 $ongoingTaskResult.$failedResults = [];
             }
             $ongoingTaskResult.$failedResults.push({
+                attemptIndex,
                 result: $ongoingTaskResult.$resultString,
                 error: error,
             });
@@ -6559,19 +6637,13 @@ async function executeAttempts(options) {
                 });
             }
         }
-        if ($ongoingTaskResult.$expectError !== null && attempt === maxAttempts - 1) {
-            // Store the current failure before throwing
-            $ongoingTaskResult.$failedResults = $ongoingTaskResult.$failedResults || [];
-            $ongoingTaskResult.$failedResults.push({
-                result: $ongoingTaskResult.$resultString,
-                error: $ongoingTaskResult.$expectError,
-            });
-            // Create a summary of all failures
+        if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
+            // Note: Create a summary of all failures
             const failuresSummary = $ongoingTaskResult.$failedResults
-                .map((failure, index) => spaceTrim$1((block) => {
+                .map((failure) => spaceTrim$1((block) => {
                 var _a, _b;
                 return `
-                            Attempt ${index + 1}:
+                            Attempt ${failure.attemptIndex + 1}:
                             Error ${((_a = failure.error) === null || _a === void 0 ? void 0 : _a.name) || ''}:
                             ${block((_b = failure.error) === null || _b === void 0 ? void 0 : _b.message.split('\n').map((line) => `> ${line}`).join('\n'))}
 
@@ -17323,7 +17395,7 @@ resultContent, rawResponse) {
  */
 
 /**
- * Execution Tools for calling OpenAI API or other OpeenAI compatible provider
+ * Execution Tools for calling OpenAI API or other OpenAI compatible provider
  *
  * @public exported from `@promptbook/openai`
  */
@@ -17893,6 +17965,7 @@ class OllamaExecutionTools extends OpenAiCompatibleExecutionTools {
             baseURL: DEFAULT_OLLAMA_BASE_URL,
             ...ollamaOptions,
             apiKey: 'ollama',
+            isProxied: false, // <- Note: Ollama is always local
         };
         super(openAiCompatibleOptions);
     }
@@ -18079,7 +18152,7 @@ const _OpenAiCompatibleMetadataRegistration = $llmToolsMetadataRegister.register
     title: 'Open AI Compatible',
     packageName: '@promptbook/openai',
     className: 'OpenAiCompatibleExecutionTools',
-    envVariables: ['OPENAI_API_KEY'],
+    envVariables: ['OPENAI_API_KEY', 'OPENAI_BASE_URL'],
     trustLevel: 'CLOSED',
     order: MODEL_ORDERS.TOP_TIER,
     getBoilerplateConfiguration() {
@@ -18089,11 +18162,35 @@ const _OpenAiCompatibleMetadataRegistration = $llmToolsMetadataRegister.register
             className: 'OpenAiCompatibleExecutionTools',
             options: {
                 apiKey: 'sk-',
+                baseURL: 'https://api.openai.com/v1',
+                isProxied: false,
+                remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
                 maxRequestsPerMinute: DEFAULT_MAX_REQUESTS_PER_MINUTE,
             },
         };
     },
     createConfigurationFromEnv(env) {
+        // Note: OpenAiCompatibleExecutionTools is an abstract class and cannot be instantiated directly
+        // However, we can provide configuration for users who want to manually instantiate it
+        if (typeof env.OPENAI_API_KEY === 'string') {
+            const options = {
+                apiKey: env.OPENAI_API_KEY,
+                isProxied: false,
+                remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
+                maxRequestsPerMinute: DEFAULT_MAX_REQUESTS_PER_MINUTE,
+                defaultModelName: 'gpt-4-turbo',
+            };
+            // Add baseURL if provided in environment
+            if (typeof env.OPENAI_BASE_URL === 'string') {
+                options.baseURL = env.OPENAI_BASE_URL;
+            }
+            return {
+                title: 'Open AI Compatible (from env)',
+                packageName: '@promptbook/openai',
+                className: 'OpenAiCompatibleExecutionTools',
+                options,
+            };
+        }
         return null;
     },
 });
@@ -18146,7 +18243,7 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
      * Default model for chat variant.
      */
     getDefaultChatModel() {
-        return this.getDefaultModel('gpt-4o');
+        return this.getDefaultModel('gpt-4-turbo');
     }
     /**
      * Default model for completion variant.
@@ -18176,6 +18273,9 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
      * @param options which are relevant are directly passed to the OpenAI client
      */
     constructor(options) {
+        if (options.isProxied) {
+            throw new NotYetImplementedError(`Proxy mode is not yet implemented for OpenAI assistants`);
+        }
         super(options);
         this.assistantId = options.assistantId;
         // TODO: [👱] Make limiter same as in `OpenAiExecutionTools`
@@ -18357,14 +18457,97 @@ const createOpenAiAssistantExecutionTools = Object.assign((options) => {
  * @public exported from `@promptbook/openai`
  */
 const createOpenAiCompatibleExecutionTools = Object.assign((options) => {
+    if (options.isProxied) {
+        return new RemoteLlmExecutionTools({
+            ...options,
+            identification: {
+                isAnonymous: true,
+                llmToolsConfiguration: [
+                    {
+                        title: 'OpenAI Compatible (proxied)',
+                        packageName: '@promptbook/openai',
+                        className: 'OpenAiCompatibleExecutionTools',
+                        options: {
+                            ...options,
+                            isProxied: false,
+                        },
+                    },
+                ],
+            },
+        });
+    }
     if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
         options = { ...options, dangerouslyAllowBrowser: true };
     }
-    return new OpenAiExecutionTools(options);
+    return new HardcodedOpenAiCompatibleExecutionTools(options.defaultModelName, options);
 }, {
     packageName: '@promptbook/openai',
     className: 'OpenAiCompatibleExecutionTools',
 });
+/**
+ * Execution Tools for calling ONE SPECIFIC PRECONFIGURED OpenAI compatible provider
+ *
+ * @private for `createOpenAiCompatibleExecutionTools`
+ */
+class HardcodedOpenAiCompatibleExecutionTools extends OpenAiCompatibleExecutionTools {
+    /**
+     * Creates OpenAI compatible Execution Tools.
+     *
+     * @param options which are relevant are directly passed to the OpenAI compatible client
+     */
+    constructor(defaultModelName, options) {
+        super(options);
+        this.defaultModelName = defaultModelName;
+        this.options = options;
+    }
+    get title() {
+        return `${this.defaultModelName} on ${this.options.baseURL}`;
+    }
+    get description() {
+        return `OpenAI compatible connected to "${this.options.baseURL}" model "${this.defaultModelName}"`;
+    }
+    /**
+     * List all available models (non dynamically)
+     *
+     * Note: Purpose of this is to provide more information about models than standard listing from API
+     */
+    get HARDCODED_MODELS() {
+        return [
+            {
+                modelName: this.defaultModelName,
+                modelVariant: 'CHAT',
+                modelDescription: '', // <- TODO: What is the best value here, maybe `this.description`?
+            },
+        ];
+    }
+    /**
+     * Computes the usage
+     */
+    computeUsage(...args) {
+        return {
+            ...computeOpenAiUsage(...args),
+            price: UNCERTAIN_ZERO_VALUE, // <- TODO: Maybe in future pass this counting mechanism, but for now, we dont know
+        };
+    }
+    /**
+     * Default model for chat variant.
+     */
+    getDefaultChatModel() {
+        return this.getDefaultModel(this.defaultModelName);
+    }
+    /**
+     * Default model for completion variant.
+     */
+    getDefaultCompletionModel() {
+        throw new PipelineExecutionError(`${this.title} does not support COMPLETION model variant`);
+    }
+    /**
+     * Default model for completion variant.
+     */
+    getDefaultEmbeddingModel() {
+        throw new PipelineExecutionError(`${this.title} does not support EMBEDDING model variant`);
+    }
+}
 /**
  * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
  * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
@@ -18381,6 +18564,9 @@ const createOpenAiExecutionTools = Object.assign((options) => {
     if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
         options = { ...options, dangerouslyAllowBrowser: true };
     }
+    if (options.isProxied) {
+        throw new NotYetImplementedError(`Proxy mode is not yet implemented in createOpenAiExecutionTools`);
+    }
     return new OpenAiExecutionTools(options);
 }, {
     packageName: '@promptbook/openai',