@promptbook/cli 0.98.0-6 → 0.98.0-9

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-6';
+const PROMPTBOOK_ENGINE_VERSION = '0.98.0-9';
 /**
  * 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,
@@ -3342,6 +3729,7 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
             .list()
             .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
         if (registeredItem === undefined) {
+            console.log('!!! $llmToolsRegister.list()', $llmToolsRegister.list());
             throw new Error(spaceTrim((block) => `
                         There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
 
@@ -4677,28 +5065,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 +5128,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
  *
@@ -5911,111 +6268,9 @@ function mapAvailableToExpectedParameters(options) {
         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;
+    Object.freeze(mappedParameters);
+    return mappedParameters;
 }
-/**
- * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
- * TODO: [🏢] Make this logic part of `JsonFormatParser` or `isValidJsonString`
- */
 
 /**
  * Takes an item or an array of items and returns an array of items
@@ -6107,166 +6362,6 @@ function templateParameters(template, parameters) {
     return replacedTemplates;
 }
 
-/**
- * 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
- */
-
 /**
  * Executes a pipeline task with multiple attempts, including joker and retry logic. Handles different task types
  * (prompt, script, dialog, etc.), applies postprocessing, checks expectations, and updates the execution report.
@@ -6289,13 +6384,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 +6588,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 +6613,7 @@ async function executeAttempts(options) {
                 $ongoingTaskResult.$failedResults = [];
             }
             $ongoingTaskResult.$failedResults.push({
+                attemptIndex,
                 result: $ongoingTaskResult.$resultString,
                 error: error,
             });
@@ -6559,19 +6638,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 +17396,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 +17966,7 @@ class OllamaExecutionTools extends OpenAiCompatibleExecutionTools {
             baseURL: DEFAULT_OLLAMA_BASE_URL,
             ...ollamaOptions,
             apiKey: 'ollama',
+            isProxied: false, // <- Note: Ollama is always local
         };
         super(openAiCompatibleOptions);
     }
@@ -18079,7 +18153,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,6 +18163,9 @@ 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,
             },
         };
@@ -18146,7 +18223,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 +18253,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 +18437,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 +18544,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',