@promptbook/openai 0.105.0-8 → 0.105.0

package/esm/index.es.js

@@ -1,11 +1,11 @@
 import colors from 'colors';
+import { randomBytes } from 'crypto';
 import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import Bottleneck from 'bottleneck';
+import OpenAI from 'openai';
 import 'path';
-import { randomBytes } from 'crypto';
 import 'crypto-js';
 import 'crypto-js/enc-hex';
-import Bottleneck from 'bottleneck';
-import OpenAI from 'openai';
 import { io } from 'socket.io-client';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -22,7 +22,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.105.0-8';
+const PROMPTBOOK_ENGINE_VERSION = '0.105.0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -69,6 +69,149 @@ function $isRunningInWebWorker() {
  * TODO: [🎺]
  */
 
+/**
+ * Generates random token
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
+ * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
+ *
+ * @private internal helper function
+ * @returns secure random token
+ */
+function $randomToken(randomness) {
+    return randomBytes(randomness).toString('hex');
+}
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
+ */
+
+/**
+ * This error indicates errors during the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
+ */
+class PipelineExecutionError extends Error {
+    constructor(message) {
+        // Added id parameter
+        super(message);
+        this.name = 'PipelineExecutionError';
+        // TODO: [🐙] DRY - Maybe $randomId
+        this.id = `error-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid similar char conflicts   */)}`;
+        Object.setPrototypeOf(this, PipelineExecutionError.prototype);
+    }
+}
+/**
+ * TODO: [🧠][🌂] Add id to all errors
+ */
+
+/**
+ * Freezes the given object and all its nested objects recursively
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @public exported from `@promptbook/utils`
+ */
+function $deepFreeze(objectValue) {
+    if (Array.isArray(objectValue)) {
+        return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
+    }
+    const propertyNames = Object.getOwnPropertyNames(objectValue);
+    for (const propertyName of propertyNames) {
+        const value = objectValue[propertyName];
+        if (value && typeof value === 'object') {
+            $deepFreeze(value);
+        }
+    }
+    Object.freeze(objectValue);
+    return objectValue;
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * Represents the uncertain value
+ *
+ * @public exported from `@promptbook/core`
+ */
+const ZERO_VALUE = $deepFreeze({ value: 0 });
+/**
+ * Represents the uncertain value
+ *
+ * @public exported from `@promptbook/core`
+ */
+const UNCERTAIN_ZERO_VALUE = $deepFreeze({ value: 0, isUncertain: true });
+/**
+ * Represents the usage with no resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+const ZERO_USAGE = $deepFreeze({
+    price: ZERO_VALUE,
+    input: {
+        tokensCount: ZERO_VALUE,
+        charactersCount: ZERO_VALUE,
+        wordsCount: ZERO_VALUE,
+        sentencesCount: ZERO_VALUE,
+        linesCount: ZERO_VALUE,
+        paragraphsCount: ZERO_VALUE,
+        pagesCount: ZERO_VALUE,
+    },
+    output: {
+        tokensCount: ZERO_VALUE,
+        charactersCount: ZERO_VALUE,
+        wordsCount: ZERO_VALUE,
+        sentencesCount: ZERO_VALUE,
+        linesCount: ZERO_VALUE,
+        paragraphsCount: ZERO_VALUE,
+        pagesCount: ZERO_VALUE,
+    },
+});
+/**
+ * Represents the usage with unknown resources consumed
+ *
+ * @public exported from `@promptbook/core`
+ */
+const UNCERTAIN_USAGE = $deepFreeze({
+    price: UNCERTAIN_ZERO_VALUE,
+    input: {
+        tokensCount: UNCERTAIN_ZERO_VALUE,
+        charactersCount: UNCERTAIN_ZERO_VALUE,
+        wordsCount: UNCERTAIN_ZERO_VALUE,
+        sentencesCount: UNCERTAIN_ZERO_VALUE,
+        linesCount: UNCERTAIN_ZERO_VALUE,
+        paragraphsCount: UNCERTAIN_ZERO_VALUE,
+        pagesCount: UNCERTAIN_ZERO_VALUE,
+    },
+    output: {
+        tokensCount: UNCERTAIN_ZERO_VALUE,
+        charactersCount: UNCERTAIN_ZERO_VALUE,
+        wordsCount: UNCERTAIN_ZERO_VALUE,
+        sentencesCount: UNCERTAIN_ZERO_VALUE,
+        linesCount: UNCERTAIN_ZERO_VALUE,
+        paragraphsCount: UNCERTAIN_ZERO_VALUE,
+        pagesCount: UNCERTAIN_ZERO_VALUE,
+    },
+});
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Simple wrapper `new Date().toISOString()`
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
+ *
+ * @returns string_date branded type
+ * @public exported from `@promptbook/utils`
+ */
+function $getCurrentDate() {
+    return new Date().toISOString();
+}
+
 /**
  * Trims string from all 4 sides
  *
@@ -1096,33 +1239,6 @@ function orderJson(options) {
     return orderedValue;
 }
 
-/**
- * Freezes the given object and all its nested objects recursively
- *
- * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
- * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
- *
- * @returns The same object as the input, but deeply frozen
- * @public exported from `@promptbook/utils`
- */
-function $deepFreeze(objectValue) {
-    if (Array.isArray(objectValue)) {
-        return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
-    }
-    const propertyNames = Object.getOwnPropertyNames(objectValue);
-    for (const propertyName of propertyNames) {
-        const value = objectValue[propertyName];
-        if (value && typeof value === 'object') {
-            $deepFreeze(value);
-        }
-    }
-    Object.freeze(objectValue);
-    return objectValue;
-}
-/**
- * TODO: [🧠] Is there a way how to meaningfully test this utility
- */
-
 /**
  * Make error report URL for the given error
  *
@@ -1488,64 +1604,304 @@ exportJson({
  */
 
 /**
- * Tests if given string is valid URL.
+ * This error type indicates that some limit was reached
  *
- * Note: [🔂] This function is idempotent.
- * Note: Dataurl are considered perfectly valid.
- * Note: There are few similar functions:
- * - `isValidUrl` *(this one)* which tests any URL
- * - `isValidAgentUrl` which tests just agent URL
- * - `isValidPipelineUrl` which tests just pipeline URL
+ * @public exported from `@promptbook/core`
+ */
+class LimitReachedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LimitReachedError';
+        Object.setPrototypeOf(this, LimitReachedError.prototype);
+    }
+}
+
+/**
+ * Format either small or big number
  *
  * @public exported from `@promptbook/utils`
  */
-function isValidUrl(url) {
-    if (typeof url !== 'string') {
-        return false;
+function numberToString(value) {
+    if (value === 0) {
+        return '0';
     }
-    try {
-        if (url.startsWith('blob:')) {
-            url = url.replace(/^blob:/, '');
-        }
-        const urlObject = new URL(url /* because fail is handled */);
-        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-            return false;
-        }
-        return true;
+    else if (Number.isNaN(value)) {
+        return VALUE_STRINGS.nan;
     }
-    catch (error) {
-        return false;
+    else if (value === Infinity) {
+        return VALUE_STRINGS.infinity;
+    }
+    else if (value === -Infinity) {
+        return VALUE_STRINGS.negativeInfinity;
+    }
+    for (let exponent = 0; exponent < 15; exponent++) {
+        const factor = 10 ** exponent;
+        const valueRounded = Math.round(value * factor) / factor;
+        if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {
+            return valueRounded.toFixed(exponent);
+        }
     }
+    return value.toString();
 }
 
-const defaultDiacriticsRemovalMap = [
-    {
-        base: 'A',
-        letters: '\u0041\u24B6\uFF21\u00C0\u00C1\u00C2\u1EA6\u1EA4\u1EAA\u1EA8\u00C3\u0100\u0102\u1EB0\u1EAE\u1EB4\u1EB2\u0226\u01E0\u00C4\u01DE\u1EA2\u00C5\u01FA\u01CD\u0200\u0202\u1EA0\u1EAC\u1EB6\u1E00\u0104\u023A\u2C6F',
-    },
-    { base: 'AA', letters: '\uA732' },
-    { base: 'AE', letters: '\u00C6\u01FC\u01E2' },
-    { base: 'AO', letters: '\uA734' },
-    { base: 'AU', letters: '\uA736' },
-    { base: 'AV', letters: '\uA738\uA73A' },
-    { base: 'AY', letters: '\uA73C' },
-    {
-        base: 'B',
-        letters: '\u0042\u24B7\uFF22\u1E02\u1E04\u1E06\u0243\u0182\u0181',
-    },
-    {
-        base: 'C',
-        letters: '\u0043\u24B8\uFF23\u0106\u0108\u010A\u010C\u00C7\u1E08\u0187\u023B\uA73E',
-    },
-    {
-        base: 'D',
-        letters: '\u0044\u24B9\uFF24\u1E0A\u010E\u1E0C\u1E10\u1E12\u1E0E\u0110\u018B\u018A\u0189\uA779\u00D0',
-    },
-    { base: 'DZ', letters: '\u01F1\u01C4' },
-    { base: 'Dz', letters: '\u01F2\u01C5' },
-    {
-        base: 'E',
-        letters: '\u0045\u24BA\uFF25\u00C8\u00C9\u00CA\u1EC0\u1EBE\u1EC4\u1EC2\u1EBC\u0112\u1E14\u1E16\u0114\u0116\u00CB\u1EBA\u011A\u0204\u0206\u1EB8\u1EC6\u0228\u1E1C\u0118\u1E18\u1E1A\u0190\u018E',
+/**
+ * Function `valueToString` will convert the given value to string
+ * This is useful and used in the `templateParameters` function
+ *
+ * Note: This function is not just calling `toString` method
+ *       It's more complex and can handle this conversion specifically for LLM models
+ *       See `VALUE_STRINGS`
+ *
+ * Note: There are 2 similar functions
+ * - `valueToString` converts value to string for LLM models as human-readable string
+ * - `asSerializable` converts value to string to preserve full information to be able to convert it back
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function valueToString(value) {
+    try {
+        if (value === '') {
+            return VALUE_STRINGS.empty;
+        }
+        else if (value === null) {
+            return VALUE_STRINGS.null;
+        }
+        else if (value === undefined) {
+            return VALUE_STRINGS.undefined;
+        }
+        else if (typeof value === 'string') {
+            return value;
+        }
+        else if (typeof value === 'number') {
+            return numberToString(value);
+        }
+        else if (value instanceof Date) {
+            return value.toISOString();
+        }
+        else {
+            try {
+                return JSON.stringify(value);
+            }
+            catch (error) {
+                if (error instanceof TypeError && error.message.includes('circular structure')) {
+                    return VALUE_STRINGS.circular;
+                }
+                throw error;
+            }
+        }
+    }
+    catch (error) {
+        assertsError(error);
+        console.error(error);
+        return VALUE_STRINGS.unserializable;
+    }
+}
+
+/**
+ * Replaces parameters in template with values from parameters object
+ *
+ * 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`
+ */
+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(/\r?\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;
+}
+
+/**
+ * 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,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */
+
+/**
+ * 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) {
+    if (text === '') {
+        return 0;
+    }
+    text = text.replace('\r\n', '\n');
+    text = text.replace('\r', '\n');
+    const lines = text.split(/\r?\n/);
+    return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
+}
+/**
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */
+
+/**
+ * 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,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */
+
+/**
+ * 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,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */
+
+/**
+ * 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,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */
+
+const defaultDiacriticsRemovalMap = [
+    {
+        base: 'A',
+        letters: '\u0041\u24B6\uFF21\u00C0\u00C1\u00C2\u1EA6\u1EA4\u1EAA\u1EA8\u00C3\u0100\u0102\u1EB0\u1EAE\u1EB4\u1EB2\u0226\u01E0\u00C4\u01DE\u1EA2\u00C5\u01FA\u01CD\u0200\u0202\u1EA0\u1EAC\u1EB6\u1E00\u0104\u023A\u2C6F',
+    },
+    { base: 'AA', letters: '\uA732' },
+    { base: 'AE', letters: '\u00C6\u01FC\u01E2' },
+    { base: 'AO', letters: '\uA734' },
+    { base: 'AU', letters: '\uA736' },
+    { base: 'AV', letters: '\uA738\uA73A' },
+    { base: 'AY', letters: '\uA73C' },
+    {
+        base: 'B',
+        letters: '\u0042\u24B7\uFF22\u1E02\u1E04\u1E06\u0243\u0182\u0181',
+    },
+    {
+        base: 'C',
+        letters: '\u0043\u24B8\uFF23\u0106\u0108\u010A\u010C\u00C7\u1E08\u0187\u023B\uA73E',
+    },
+    {
+        base: 'D',
+        letters: '\u0044\u24B9\uFF24\u1E0A\u010E\u1E0C\u1E10\u1E12\u1E0E\u0110\u018B\u018A\u0189\uA779\u00D0',
+    },
+    { base: 'DZ', letters: '\u01F1\u01C4' },
+    { base: 'Dz', letters: '\u01F2\u01C5' },
+    {
+        base: 'E',
+        letters: '\u0045\u24BA\uFF25\u00C8\u00C9\u00CA\u1EC0\u1EBE\u1EC4\u1EC2\u1EBC\u0112\u1E14\u1E16\u0114\u0116\u00CB\u1EBA\u011A\u0204\u0206\u1EB8\u1EC6\u0228\u1E1C\u0118\u1E18\u1E1A\u0190\u018E',
     },
     { base: 'F', letters: '\u0046\u24BB\uFF26\u1E1E\u0191\uA77B' },
     {
@@ -1782,921 +2138,78 @@ function removeDiacritics(input) {
  */
 
 /**
- * This error indicates problems parsing the format value
- *
- * For example, when the format value is not a valid JSON or CSV
- * This is not thrown directly but in extended classes
- *
- * @public exported from `@promptbook/core`
- */
-class AbstractFormatError extends Error {
-    // Note: To allow instanceof do not put here error `name`
-    // public readonly name = 'AbstractFormatError';
-    constructor(message) {
-        super(message);
-        Object.setPrototypeOf(this, AbstractFormatError.prototype);
-    }
-}
-
-/**
- * This error indicates problem with parsing of CSV
- *
- * @public exported from `@promptbook/core`
- */
-class CsvFormatError extends AbstractFormatError {
-    constructor(message) {
-        super(message);
-        this.name = 'CsvFormatError';
-        Object.setPrototypeOf(this, CsvFormatError.prototype);
-    }
-}
-
-/**
- * AuthenticationError is thrown from login function which is dependency of remote server
- *
- * @public exported from `@promptbook/core`
- */
-class AuthenticationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'AuthenticationError';
-        Object.setPrototypeOf(this, AuthenticationError.prototype);
-    }
-}
-
-/**
- * This error indicates that the pipeline collection cannot be properly loaded
- *
- * @public exported from `@promptbook/core`
- */
-class CollectionError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'CollectionError';
-        Object.setPrototypeOf(this, CollectionError.prototype);
-    }
-}
-
-/**
- * This error indicates error from the database
- *
- * @public exported from `@promptbook/core`
- */
-class DatabaseError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'DatabaseError';
-        Object.setPrototypeOf(this, DatabaseError.prototype);
-    }
-}
-/**
- * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
- */
-
-/**
- * This error type indicates that you try to use a feature that is not available in the current environment
- *
- * @public exported from `@promptbook/core`
- */
-class EnvironmentMismatchError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'EnvironmentMismatchError';
-        Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
-    }
-}
-
-/**
- * This error occurs when some expectation is not met in the execution of the pipeline
+ * Counts number of words in the text
  *
- * @public exported from `@promptbook/core`
- * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
- * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
- * Note: This is a kindof subtype of PipelineExecutionError
+ * @public exported from `@promptbook/utils`
  */
-class ExpectError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ExpectError';
-        Object.setPrototypeOf(this, ExpectError.prototype);
-    }
+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;
 }
-
 /**
- * This error indicates that the promptbook can not retrieve knowledge from external sources
- *
- * @public exported from `@promptbook/core`
+ * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ * TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
  */
-class KnowledgeScrapeError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'KnowledgeScrapeError';
-        Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
-    }
-}
 
 /**
- * This error type indicates that some limit was reached
+ * Helper of usage compute
  *
- * @public exported from `@promptbook/core`
- */
-class LimitReachedError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'LimitReachedError';
-        Object.setPrototypeOf(this, LimitReachedError.prototype);
-    }
-}
-
-/**
- * This error type indicates that some tools are missing for pipeline execution or preparation
+ * @param content the content of prompt or response
+ * @returns part of UsageCounts
  *
- * @public exported from `@promptbook/core`
+ * @private internal utility of LlmExecutionTools
  */
-class MissingToolsError extends Error {
-    constructor(message) {
-        super(spaceTrim$1((block) => `
-                    ${block(message)}
-
-                    Note: You have probably forgot to provide some tools for pipeline execution or preparation
-
-                `));
-        this.name = 'MissingToolsError';
-        Object.setPrototypeOf(this, MissingToolsError.prototype);
-    }
+function computeUsageCounts(content) {
+    return {
+        charactersCount: { value: countCharacters(content) },
+        wordsCount: { value: countWords(content) },
+        sentencesCount: { value: countSentences(content) },
+        linesCount: { value: countLines(content) },
+        paragraphsCount: { value: countParagraphs(content) },
+        pagesCount: { value: countPages(content) },
+    };
 }
 
 /**
- * This error indicates that promptbook operation is not allowed
+ * Make UncertainNumber
  *
- * @public exported from `@promptbook/core`
- */
-class NotAllowed extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'NotAllowed';
-        Object.setPrototypeOf(this, NotAllowed.prototype);
-    }
-}
-
-/**
- * This error indicates that promptbook not found in the collection
+ * @param value value of the uncertain number, if `NaN` or `undefined`, it will be set to 0 and `isUncertain=true`
+ * @param isUncertain if `true`, the value is uncertain, otherwise depends on the value
  *
- * @public exported from `@promptbook/core`
+ * @private utility for initializating UncertainNumber
  */
-class NotFoundError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'NotFoundError';
-        Object.setPrototypeOf(this, NotFoundError.prototype);
+function uncertainNumber(value, isUncertain) {
+    if (value === null || value === undefined || Number.isNaN(value)) {
+        return UNCERTAIN_ZERO_VALUE;
     }
-}
-
-/**
- * This error type indicates that some part of the code is not implemented yet
- *
- * @public exported from `@promptbook/core`
- */
-class NotYetImplementedError extends Error {
-    constructor(message) {
-        super(spaceTrim$1((block) => `
-                    ${block(message)}
-
-                    Note: This feature is not implemented yet but it will be soon.
-
-                    If you want speed up the implementation or just read more, look here:
-                    https://github.com/webgptorg/promptbook
-
-                    Or contact us on pavol@ptbk.io
-
-                `));
-        this.name = 'NotYetImplementedError';
-        Object.setPrototypeOf(this, NotYetImplementedError.prototype);
+    if (isUncertain === true) {
+        return { value, isUncertain };
     }
+    return { value };
 }
 
 /**
- * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ * Create price per one token based on the string value found on openai page
  *
- * @public exported from `@promptbook/core`
+ * @private within the repository, used only as internal helper for `OPENAI_MODELS`
  */
-class ParseError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ParseError';
-        Object.setPrototypeOf(this, ParseError.prototype);
-    }
+function pricing(value) {
+    const [price, tokens] = value.split(' / ');
+    return parseFloat(price.replace('$', '')) / parseFloat(tokens.replace('M tokens', '')) / 1000000;
 }
-/**
- * TODO: Maybe split `ParseError` and `ApplyError`
- */
 
 /**
- * Generates random token
- *
- * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
- * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
+ * List of available OpenAI models with pricing
  *
- * @private internal helper function
- * @returns secure random token
- */
-function $randomToken(randomness) {
-    return randomBytes(randomness).toString('hex');
-}
-/**
- * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
- * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
- */
-
-/**
- * This error indicates errors during the execution of the pipeline
+ * Note: Synced with official API docs at 2025-11-19
  *
- * @public exported from `@promptbook/core`
- */
-class PipelineExecutionError extends Error {
-    constructor(message) {
-        // Added id parameter
-        super(message);
-        this.name = 'PipelineExecutionError';
-        // TODO: [🐙] DRY - Maybe $randomId
-        this.id = `error-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid similar char conflicts   */)}`;
-        Object.setPrototypeOf(this, PipelineExecutionError.prototype);
-    }
-}
-/**
- * TODO: [🧠][🌂] Add id to all errors
- */
-
-/**
- * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
- *
- * @public exported from `@promptbook/core`
- */
-class PipelineLogicError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'PipelineLogicError';
-        Object.setPrototypeOf(this, PipelineLogicError.prototype);
-    }
-}
-
-/**
- * This error indicates errors in referencing promptbooks between each other
- *
- * @public exported from `@promptbook/core`
- */
-class PipelineUrlError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'PipelineUrlError';
-        Object.setPrototypeOf(this, PipelineUrlError.prototype);
-    }
-}
-
-/**
- * Error thrown when a fetch request fails
- *
- * @public exported from `@promptbook/core`
- */
-class PromptbookFetchError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'PromptbookFetchError';
-        Object.setPrototypeOf(this, PromptbookFetchError.prototype);
-    }
-}
-
-/**
- * Index of all custom errors
- *
- * @public exported from `@promptbook/core`
- */
-const PROMPTBOOK_ERRORS = {
-    AbstractFormatError,
-    CsvFormatError,
-    CollectionError,
-    EnvironmentMismatchError,
-    ExpectError,
-    KnowledgeScrapeError,
-    LimitReachedError,
-    MissingToolsError,
-    NotFoundError,
-    NotYetImplementedError,
-    ParseError,
-    PipelineExecutionError,
-    PipelineLogicError,
-    PipelineUrlError,
-    AuthenticationError,
-    PromptbookFetchError,
-    UnexpectedError,
-    WrappedError,
-    NotAllowed,
-    DatabaseError,
-    // TODO: [🪑]> VersionMismatchError,
-};
-/**
- * Index of all javascript errors
- *
- * @private for internal usage
- */
-const COMMON_JAVASCRIPT_ERRORS = {
-    Error,
-    EvalError,
-    RangeError,
-    ReferenceError,
-    SyntaxError,
-    TypeError,
-    URIError,
-    AggregateError,
-    /*
-  Note: Not widely supported
-  > InternalError,
-  > ModuleError,
-  > HeapError,
-  > WebAssemblyCompileError,
-  > WebAssemblyRuntimeError,
-  */
-};
-/**
- * Index of all errors
- *
- * @private for internal usage
- */
-const ALL_ERRORS = {
-    ...PROMPTBOOK_ERRORS,
-    ...COMMON_JAVASCRIPT_ERRORS,
-};
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Deserializes the error object
- *
- * @public exported from `@promptbook/utils`
- */
-function deserializeError(error, isStackAddedToMessage = true) {
-    const { name, stack, id } = error; // Added id
-    let { message } = error;
-    let ErrorClass = ALL_ERRORS[error.name];
-    if (ErrorClass === undefined) {
-        ErrorClass = Error;
-        message = `${name}: ${message}`;
-    }
-    if (isStackAddedToMessage && stack !== undefined && stack !== '') {
-        message = spaceTrim$2((block) => `
-                ${block(message)}
-
-                Original stack trace:
-                ${block(stack || '')}
-            `);
-    }
-    const deserializedError = new ErrorClass(message);
-    deserializedError.id = id; // Assign id to the error object
-    return deserializedError;
-}
-
-/**
- * Serializes an error into a [🚉] JSON-serializable object
- *
- * @public exported from `@promptbook/utils`
- */
-function serializeError(error) {
-    const { name, message, stack } = error;
-    const { id } = error;
-    if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$2((block) => `
-
-                    Cannot serialize error with name "${name}"
-
-                    Authors of Promptbook probably forgot to add this error into the list of errors:
-                    https://github.com/webgptorg/promptbook/blob/main/src/errors/0-index.ts
-
-
-                    ${block(stack || message)}
-
-                `));
-    }
-    return {
-        name: name,
-        message,
-        stack,
-        id, // Include id in the serialized object
-    };
-}
-
-/**
- * Async version of Array.forEach
- *
- * @param array - Array to iterate over
- * @param options - Options for the function
- * @param callbackfunction - Function to call for each item
- * @public exported from `@promptbook/utils`
- * @deprecated [🪂] Use queues instead
- */
-async function forEachAsync(array, options, callbackfunction) {
-    const { maxParallelCount = Infinity } = options;
-    let index = 0;
-    let runningTasks = [];
-    const tasks = [];
-    for (const item of array) {
-        const currentIndex = index++;
-        const task = callbackfunction(item, currentIndex, array);
-        tasks.push(task);
-        runningTasks.push(task);
-        /* not await */ Promise.resolve(task).then(() => {
-            runningTasks = runningTasks.filter((runningTask) => runningTask !== task);
-        });
-        if (maxParallelCount < runningTasks.length) {
-            await Promise.race(runningTasks);
-        }
-    }
-    await Promise.all(tasks);
-}
-
-/**
- * Format either small or big number
- *
- * @public exported from `@promptbook/utils`
- */
-function numberToString(value) {
-    if (value === 0) {
-        return '0';
-    }
-    else if (Number.isNaN(value)) {
-        return VALUE_STRINGS.nan;
-    }
-    else if (value === Infinity) {
-        return VALUE_STRINGS.infinity;
-    }
-    else if (value === -Infinity) {
-        return VALUE_STRINGS.negativeInfinity;
-    }
-    for (let exponent = 0; exponent < 15; exponent++) {
-        const factor = 10 ** exponent;
-        const valueRounded = Math.round(value * factor) / factor;
-        if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {
-            return valueRounded.toFixed(exponent);
-        }
-    }
-    return value.toString();
-}
-
-/**
- * Function `valueToString` will convert the given value to string
- * This is useful and used in the `templateParameters` function
- *
- * Note: This function is not just calling `toString` method
- *       It's more complex and can handle this conversion specifically for LLM models
- *       See `VALUE_STRINGS`
- *
- * Note: There are 2 similar functions
- * - `valueToString` converts value to string for LLM models as human-readable string
- * - `asSerializable` converts value to string to preserve full information to be able to convert it back
- *
- * @public exported from `@promptbook/utils`
- */
-function valueToString(value) {
-    try {
-        if (value === '') {
-            return VALUE_STRINGS.empty;
-        }
-        else if (value === null) {
-            return VALUE_STRINGS.null;
-        }
-        else if (value === undefined) {
-            return VALUE_STRINGS.undefined;
-        }
-        else if (typeof value === 'string') {
-            return value;
-        }
-        else if (typeof value === 'number') {
-            return numberToString(value);
-        }
-        else if (value instanceof Date) {
-            return value.toISOString();
-        }
-        else {
-            try {
-                return JSON.stringify(value);
-            }
-            catch (error) {
-                if (error instanceof TypeError && error.message.includes('circular structure')) {
-                    return VALUE_STRINGS.circular;
-                }
-                throw error;
-            }
-        }
-    }
-    catch (error) {
-        assertsError(error);
-        console.error(error);
-        return VALUE_STRINGS.unserializable;
-    }
-}
-
-/**
- * Replaces parameters in template with values from parameters object
- *
- * 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`
- */
-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;
-}
-
-/**
- * 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 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,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
-
-/**
- * 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) {
-    if (text === '') {
-        return 0;
-    }
-    text = text.replace('\r\n', '\n');
-    text = text.replace('\r', '\n');
-    const lines = text.split('\n');
-    return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
-}
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
-
-/**
- * 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,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
-
-/**
- * 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,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
-
-/**
- * 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,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
-
-/**
- * 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,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- * TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
- */
-
-/**
- * Simple wrapper `new Date().toISOString()`
- *
- * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
- *
- * @returns string_date branded type
- * @public exported from `@promptbook/utils`
- */
-function $getCurrentDate() {
-    return new Date().toISOString();
-}
-
-/**
- * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
- *
- * Note: [🔂] This function is idempotent.
- *
- * @param text The text string to be converted to SCREAMING_CASE format.
- * @returns The normalized text in SCREAMING_CASE format.
- * @example 'HELLO_WORLD'
- * @example 'I_LOVE_PROMPTBOOK'
- * @public exported from `@promptbook/utils`
- */
-function normalizeTo_SCREAMING_CASE(text) {
-    let charType;
-    let lastCharType = 'OTHER';
-    let normalizedName = '';
-    for (const char of text) {
-        let normalizedChar;
-        if (/^[a-z]$/.test(char)) {
-            charType = 'LOWERCASE';
-            normalizedChar = char.toUpperCase();
-        }
-        else if (/^[A-Z]$/.test(char)) {
-            charType = 'UPPERCASE';
-            normalizedChar = char;
-        }
-        else if (/^[0-9]$/.test(char)) {
-            charType = 'NUMBER';
-            normalizedChar = char;
-        }
-        else {
-            charType = 'OTHER';
-            normalizedChar = '_';
-        }
-        if (charType !== lastCharType &&
-            !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
-            !(lastCharType === 'NUMBER') &&
-            !(charType === 'NUMBER')) {
-            normalizedName += '_';
-        }
-        normalizedName += normalizedChar;
-        lastCharType = charType;
-    }
-    normalizedName = normalizedName.replace(/_+/g, '_');
-    normalizedName = normalizedName.replace(/_?\/_?/g, '/');
-    normalizedName = normalizedName.replace(/^_/, '');
-    normalizedName = normalizedName.replace(/_$/, '');
-    return normalizedName;
-}
-/**
- * TODO: Tests
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
- *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
- * TODO: [🌺] Use some intermediate util splitWords
- */
-
-/**
- * Normalizes a text string to snake_case format.
- *
- * Note: [🔂] This function is idempotent.
- *
- * @param text The text string to be converted to snake_case format.
- * @returns The normalized text in snake_case format.
- * @example 'hello_world'
- * @example 'i_love_promptbook'
- * @public exported from `@promptbook/utils`
- */
-function normalizeTo_snake_case(text) {
-    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
-}
-
-/**
- * Represents the uncertain value
- *
- * @public exported from `@promptbook/core`
- */
-const ZERO_VALUE = $deepFreeze({ value: 0 });
-/**
- * Represents the uncertain value
- *
- * @public exported from `@promptbook/core`
- */
-const UNCERTAIN_ZERO_VALUE = $deepFreeze({ value: 0, isUncertain: true });
-/**
- * Represents the usage with no resources consumed
- *
- * @public exported from `@promptbook/core`
- */
-const ZERO_USAGE = $deepFreeze({
-    price: ZERO_VALUE,
-    input: {
-        tokensCount: ZERO_VALUE,
-        charactersCount: ZERO_VALUE,
-        wordsCount: ZERO_VALUE,
-        sentencesCount: ZERO_VALUE,
-        linesCount: ZERO_VALUE,
-        paragraphsCount: ZERO_VALUE,
-        pagesCount: ZERO_VALUE,
-    },
-    output: {
-        tokensCount: ZERO_VALUE,
-        charactersCount: ZERO_VALUE,
-        wordsCount: ZERO_VALUE,
-        sentencesCount: ZERO_VALUE,
-        linesCount: ZERO_VALUE,
-        paragraphsCount: ZERO_VALUE,
-        pagesCount: ZERO_VALUE,
-    },
-});
-/**
- * Represents the usage with unknown resources consumed
- *
- * @public exported from `@promptbook/core`
- */
-const UNCERTAIN_USAGE = $deepFreeze({
-    price: UNCERTAIN_ZERO_VALUE,
-    input: {
-        tokensCount: UNCERTAIN_ZERO_VALUE,
-        charactersCount: UNCERTAIN_ZERO_VALUE,
-        wordsCount: UNCERTAIN_ZERO_VALUE,
-        sentencesCount: UNCERTAIN_ZERO_VALUE,
-        linesCount: UNCERTAIN_ZERO_VALUE,
-        paragraphsCount: UNCERTAIN_ZERO_VALUE,
-        pagesCount: UNCERTAIN_ZERO_VALUE,
-    },
-    output: {
-        tokensCount: UNCERTAIN_ZERO_VALUE,
-        charactersCount: UNCERTAIN_ZERO_VALUE,
-        wordsCount: UNCERTAIN_ZERO_VALUE,
-        sentencesCount: UNCERTAIN_ZERO_VALUE,
-        linesCount: UNCERTAIN_ZERO_VALUE,
-        paragraphsCount: UNCERTAIN_ZERO_VALUE,
-        pagesCount: UNCERTAIN_ZERO_VALUE,
-    },
-});
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Helper of usage compute
- *
- * @param content the content of prompt or response
- * @returns part of UsageCounts
- *
- * @private internal utility of LlmExecutionTools
- */
-function computeUsageCounts(content) {
-    return {
-        charactersCount: { value: countCharacters(content) },
-        wordsCount: { value: countWords(content) },
-        sentencesCount: { value: countSentences(content) },
-        linesCount: { value: countLines(content) },
-        paragraphsCount: { value: countParagraphs(content) },
-        pagesCount: { value: countPages(content) },
-    };
-}
-
-/**
- * Make UncertainNumber
- *
- * @param value value of the uncertain number, if `NaN` or `undefined`, it will be set to 0 and `isUncertain=true`
- * @param isUncertain if `true`, the value is uncertain, otherwise depends on the value
- *
- * @private utility for initializating UncertainNumber
- */
-function uncertainNumber(value, isUncertain) {
-    if (value === null || value === undefined || Number.isNaN(value)) {
-        return UNCERTAIN_ZERO_VALUE;
-    }
-    if (isUncertain === true) {
-        return { value, isUncertain };
-    }
-    return { value };
-}
-
-/**
- * Create price per one token based on the string value found on openai page
- *
- * @private within the repository, used only as internal helper for `OPENAI_MODELS`
- */
-function pricing(value) {
-    const [price, tokens] = value.split(' / ');
-    return parseFloat(price.replace('$', '')) / parseFloat(tokens.replace('M tokens', '')) / 1000000;
-}
-
-/**
- * List of available OpenAI models with pricing
- *
- * Note: Synced with official API docs at 2025-11-19
- *
- * @see https://platform.openai.com/docs/models/
- * @see https://openai.com/api/pricing/
- * @public exported from `@promptbook/openai`
+ * @see https://platform.openai.com/docs/models/
+ * @see https://openai.com/api/pricing/
+ * @public exported from `@promptbook/openai`
  */
 const OPENAI_MODELS = exportJson({
     name: 'OPENAI_MODELS',
@@ -3290,71 +2803,558 @@ const OPENAI_MODELS = exportJson({
     ],
 });
 /**
- * Note: [🤖] Add models of new variant
- * TODO: [🧠] Some mechanism to propagate unsureness
- * TODO: [🎰] Some mechanism to auto-update available models
- * TODO: [🎰][👮‍♀️] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
- * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
- * @see https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4
- * @see https://openai.com/api/pricing/
- * @see /other/playground/playground.ts
- * TODO: [🍓][💩] Make better
- * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
- * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
- * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🤖] Add models of new variant
+ * TODO: [🧠] Some mechanism to propagate unsureness
+ * TODO: [🎰] Some mechanism to auto-update available models
+ * TODO: [🎰][👮‍♀️] Make this list dynamic - dynamically can be listed modelNames but not modelVariant, legacy status, context length and pricing
+ * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
+ * @see https://platform.openai.com/docs/models/gpt-4-turbo-and-gpt-4
+ * @see https://openai.com/api/pricing/
+ * @see /other/playground/playground.ts
+ * TODO: [🍓][💩] Make better
+ * TODO: Change model titles to human eg: "gpt-4-turbo-2024-04-09" -> "GPT-4 Turbo (2024-04-09)"
+ * TODO: [🚸] Not all models are compatible with JSON mode, add this information here and use it
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Computes the usage of the OpenAI API based on the response from OpenAI
+ *
+ * @param promptContent The content of the prompt
+ * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
+ * @param rawResponse The raw response from OpenAI API
+ * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
+ * @private internal utility of `OpenAiExecutionTools`
+ */
+function computeOpenAiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
+resultContent, rawResponse) {
+    var _a, _b;
+    if (rawResponse.usage === undefined) {
+        throw new PipelineExecutionError('The usage is not defined in the response from OpenAI');
+    }
+    if (((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) === undefined) {
+        throw new PipelineExecutionError('In OpenAI response `usage.prompt_tokens` not defined');
+    }
+    const inputTokens = rawResponse.usage.prompt_tokens;
+    const outputTokens = ((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completion_tokens) || 0;
+    let isUncertain = false;
+    let modelInfo = OPENAI_MODELS.find((model) => model.modelName === rawResponse.model);
+    if (modelInfo === undefined) {
+        // Note: Model is not in the list of known models, fallback to the family of the models and mark price as uncertain
+        modelInfo = OPENAI_MODELS.find((model) => (rawResponse.model || SALT_NONCE).startsWith(model.modelName));
+        if (modelInfo !== undefined) {
+            isUncertain = true;
+        }
+    }
+    let price;
+    if (modelInfo === undefined || modelInfo.pricing === undefined) {
+        price = uncertainNumber();
+    }
+    else {
+        price = uncertainNumber(inputTokens * modelInfo.pricing.prompt + outputTokens * modelInfo.pricing.output, isUncertain);
+    }
+    return {
+        price,
+        input: {
+            tokensCount: uncertainNumber(rawResponse.usage.prompt_tokens),
+            ...computeUsageCounts(promptContent),
+        },
+        output: {
+            tokensCount: uncertainNumber(outputTokens),
+            ...computeUsageCounts(resultContent),
+        },
+    };
+}
+/**
+ * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
+ */
+
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: [🔂] This function is idempotent.
+ * Note: Dataurl are considered perfectly valid.
+ * Note: There are few similar functions:
+ * - `isValidUrl` *(this one)* which tests any URL
+ * - `isValidAgentUrl` which tests just agent URL
+ * - `isValidPipelineUrl` which tests just pipeline URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
+    }
+    try {
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
+        }
+        const urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+
+/**
+ * This error indicates problems parsing the format value
+ *
+ * For example, when the format value is not a valid JSON or CSV
+ * This is not thrown directly but in extended classes
+ *
+ * @public exported from `@promptbook/core`
+ */
+class AbstractFormatError extends Error {
+    // Note: To allow instanceof do not put here error `name`
+    // public readonly name = 'AbstractFormatError';
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, AbstractFormatError.prototype);
+    }
+}
+
+/**
+ * This error indicates problem with parsing of CSV
+ *
+ * @public exported from `@promptbook/core`
+ */
+class CsvFormatError extends AbstractFormatError {
+    constructor(message) {
+        super(message);
+        this.name = 'CsvFormatError';
+        Object.setPrototypeOf(this, CsvFormatError.prototype);
+    }
+}
+
+/**
+ * AuthenticationError is thrown from login function which is dependency of remote server
+ *
+ * @public exported from `@promptbook/core`
+ */
+class AuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+
+/**
+ * This error indicates that the pipeline collection cannot be properly loaded
+ *
+ * @public exported from `@promptbook/core`
+ */
+class CollectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CollectionError';
+        Object.setPrototypeOf(this, CollectionError.prototype);
+    }
+}
+
+/**
+ * This error indicates error from the database
+ *
+ * @public exported from `@promptbook/core`
+ */
+class DatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DatabaseError';
+        Object.setPrototypeOf(this, DatabaseError.prototype);
+    }
+}
+/**
+ * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
+ */
+
+/**
+ * This error type indicates that you try to use a feature that is not available in the current environment
+ *
+ * @public exported from `@promptbook/core`
+ */
+class EnvironmentMismatchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
+    }
+}
+
+/**
+ * This error occurs when some expectation is not met in the execution of the pipeline
+ *
+ * @public exported from `@promptbook/core`
+ * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
+ * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
+ * Note: This is a kindof subtype of PipelineExecutionError
+ */
+class ExpectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ExpectError';
+        Object.setPrototypeOf(this, ExpectError.prototype);
+    }
+}
+
+/**
+ * This error indicates that the promptbook can not retrieve knowledge from external sources
+ *
+ * @public exported from `@promptbook/core`
+ */
+class KnowledgeScrapeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'KnowledgeScrapeError';
+        Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
+    }
+}
+
+/**
+ * This error type indicates that some tools are missing for pipeline execution or preparation
+ *
+ * @public exported from `@promptbook/core`
+ */
+class MissingToolsError extends Error {
+    constructor(message) {
+        super(spaceTrim$1((block) => `
+                    ${block(message)}
+
+                    Note: You have probably forgot to provide some tools for pipeline execution or preparation
+
+                `));
+        this.name = 'MissingToolsError';
+        Object.setPrototypeOf(this, MissingToolsError.prototype);
+    }
+}
+
+/**
+ * This error indicates that promptbook operation is not allowed
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotAllowed extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotAllowed';
+        Object.setPrototypeOf(this, NotAllowed.prototype);
+    }
+}
+
+/**
+ * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotFoundError';
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+
+/**
+ * This error type indicates that some part of the code is not implemented yet
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotYetImplementedError extends Error {
+    constructor(message) {
+        super(spaceTrim$1((block) => `
+                    ${block(message)}
+
+                    Note: This feature is not implemented yet but it will be soon.
+
+                    If you want speed up the implementation or just read more, look here:
+                    https://github.com/webgptorg/promptbook
+
+                    Or contact us on pavol@ptbk.io
+
+                `));
+        this.name = 'NotYetImplementedError';
+        Object.setPrototypeOf(this, NotYetImplementedError.prototype);
+    }
+}
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
+ */
+class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+/**
+ * TODO: Maybe split `ParseError` and `ApplyError`
+ */
+
+/**
+ * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ *
+ * @public exported from `@promptbook/core`
+ */
+class PipelineLogicError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PipelineLogicError';
+        Object.setPrototypeOf(this, PipelineLogicError.prototype);
+    }
+}
+
+/**
+ * This error indicates errors in referencing promptbooks between each other
+ *
+ * @public exported from `@promptbook/core`
+ */
+class PipelineUrlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PipelineUrlError';
+        Object.setPrototypeOf(this, PipelineUrlError.prototype);
+    }
+}
+
+/**
+ * Error thrown when a fetch request fails
+ *
+ * @public exported from `@promptbook/core`
+ */
+class PromptbookFetchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PromptbookFetchError';
+        Object.setPrototypeOf(this, PromptbookFetchError.prototype);
+    }
+}
+
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+const PROMPTBOOK_ERRORS = {
+    AbstractFormatError,
+    CsvFormatError,
+    CollectionError,
+    EnvironmentMismatchError,
+    ExpectError,
+    KnowledgeScrapeError,
+    LimitReachedError,
+    MissingToolsError,
+    NotFoundError,
+    NotYetImplementedError,
+    ParseError,
+    PipelineExecutionError,
+    PipelineLogicError,
+    PipelineUrlError,
+    AuthenticationError,
+    PromptbookFetchError,
+    UnexpectedError,
+    WrappedError,
+    NotAllowed,
+    DatabaseError,
+    // TODO: [🪑]> VersionMismatchError,
+};
+/**
+ * Index of all javascript errors
+ *
+ * @private for internal usage
+ */
+const COMMON_JAVASCRIPT_ERRORS = {
+    Error,
+    EvalError,
+    RangeError,
+    ReferenceError,
+    SyntaxError,
+    TypeError,
+    URIError,
+    AggregateError,
+    /*
+  Note: Not widely supported
+  > InternalError,
+  > ModuleError,
+  > HeapError,
+  > WebAssemblyCompileError,
+  > WebAssemblyRuntimeError,
+  */
+};
+/**
+ * Index of all errors
+ *
+ * @private for internal usage
+ */
+const ALL_ERRORS = {
+    ...PROMPTBOOK_ERRORS,
+    ...COMMON_JAVASCRIPT_ERRORS,
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Deserializes the error object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function deserializeError(error, isStackAddedToMessage = true) {
+    const { name, stack, id } = error; // Added id
+    let { message } = error;
+    let ErrorClass = ALL_ERRORS[error.name];
+    if (ErrorClass === undefined) {
+        ErrorClass = Error;
+        message = `${name}: ${message}`;
+    }
+    if (isStackAddedToMessage && stack !== undefined && stack !== '') {
+        message = spaceTrim$2((block) => `
+                ${block(message)}
+
+                Original stack trace:
+                ${block(stack || '')}
+            `);
+    }
+    const deserializedError = new ErrorClass(message);
+    deserializedError.id = id; // Assign id to the error object
+    return deserializedError;
+}
+
+/**
+ * Serializes an error into a [🚉] JSON-serializable object
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function serializeError(error) {
+    const { name, message, stack } = error;
+    const { id } = error;
+    if (!Object.keys(ALL_ERRORS).includes(name)) {
+        console.error(spaceTrim$2((block) => `
+
+                    Cannot serialize error with name "${name}"
+
+                    Authors of Promptbook probably forgot to add this error into the list of errors:
+                    https://github.com/webgptorg/promptbook/blob/main/src/errors/0-index.ts
+
+
+                    ${block(stack || message)}
+
+                `));
+    }
+    return {
+        name: name,
+        message,
+        stack,
+        id, // Include id in the serialized object
+    };
+}
+
+/**
+ * Async version of Array.forEach
+ *
+ * @param array - Array to iterate over
+ * @param options - Options for the function
+ * @param callbackfunction - Function to call for each item
+ * @public exported from `@promptbook/utils`
+ * @deprecated [🪂] Use queues instead
+ */
+async function forEachAsync(array, options, callbackfunction) {
+    const { maxParallelCount = Infinity } = options;
+    let index = 0;
+    let runningTasks = [];
+    const tasks = [];
+    for (const item of array) {
+        const currentIndex = index++;
+        const task = callbackfunction(item, currentIndex, array);
+        tasks.push(task);
+        runningTasks.push(task);
+        /* not await */ Promise.resolve(task).then(() => {
+            runningTasks = runningTasks.filter((runningTask) => runningTask !== task);
+        });
+        if (maxParallelCount < runningTasks.length) {
+            await Promise.race(runningTasks);
+        }
+    }
+    await Promise.all(tasks);
+}
+
+/**
+ * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param text The text string to be converted to SCREAMING_CASE format.
+ * @returns The normalized text in SCREAMING_CASE format.
+ * @example 'HELLO_WORLD'
+ * @example 'I_LOVE_PROMPTBOOK'
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeTo_SCREAMING_CASE(text) {
+    let charType;
+    let lastCharType = 'OTHER';
+    let normalizedName = '';
+    for (const char of text) {
+        let normalizedChar;
+        if (/^[a-z]$/.test(char)) {
+            charType = 'LOWERCASE';
+            normalizedChar = char.toUpperCase();
+        }
+        else if (/^[A-Z]$/.test(char)) {
+            charType = 'UPPERCASE';
+            normalizedChar = char;
+        }
+        else if (/^[0-9]$/.test(char)) {
+            charType = 'NUMBER';
+            normalizedChar = char;
+        }
+        else {
+            charType = 'OTHER';
+            normalizedChar = '_';
+        }
+        if (charType !== lastCharType &&
+            !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+            !(lastCharType === 'NUMBER') &&
+            !(charType === 'NUMBER')) {
+            normalizedName += '_';
+        }
+        normalizedName += normalizedChar;
+        lastCharType = charType;
+    }
+    normalizedName = normalizedName.replace(/_+/g, '_');
+    normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+    normalizedName = normalizedName.replace(/^_/, '');
+    normalizedName = normalizedName.replace(/_$/, '');
+    return normalizedName;
+}
+/**
+ * TODO: Tests
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+ *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+ * TODO: [🌺] Use some intermediate util splitWords
  */
 
 /**
- * Computes the usage of the OpenAI API based on the response from OpenAI
+ * Normalizes a text string to snake_case format.
  *
- * @param promptContent The content of the prompt
- * @param resultContent The content of the result (for embedding prompts or failed prompts pass empty string)
- * @param rawResponse The raw response from OpenAI API
- * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
- * @private internal utility of `OpenAiExecutionTools`
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param text The text string to be converted to snake_case format.
+ * @returns The normalized text in snake_case format.
+ * @example 'hello_world'
+ * @example 'i_love_promptbook'
+ * @public exported from `@promptbook/utils`
  */
-function computeOpenAiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
-resultContent, rawResponse) {
-    var _a, _b;
-    if (rawResponse.usage === undefined) {
-        throw new PipelineExecutionError('The usage is not defined in the response from OpenAI');
-    }
-    if (((_a = rawResponse.usage) === null || _a === void 0 ? void 0 : _a.prompt_tokens) === undefined) {
-        throw new PipelineExecutionError('In OpenAI response `usage.prompt_tokens` not defined');
-    }
-    const inputTokens = rawResponse.usage.prompt_tokens;
-    const outputTokens = ((_b = rawResponse.usage) === null || _b === void 0 ? void 0 : _b.completion_tokens) || 0;
-    let isUncertain = false;
-    let modelInfo = OPENAI_MODELS.find((model) => model.modelName === rawResponse.model);
-    if (modelInfo === undefined) {
-        // Note: Model is not in the list of known models, fallback to the family of the models and mark price as uncertain
-        modelInfo = OPENAI_MODELS.find((model) => (rawResponse.model || SALT_NONCE).startsWith(model.modelName));
-        if (modelInfo !== undefined) {
-            isUncertain = true;
-        }
-    }
-    let price;
-    if (modelInfo === undefined || modelInfo.pricing === undefined) {
-        price = uncertainNumber();
-    }
-    else {
-        price = uncertainNumber(inputTokens * modelInfo.pricing.prompt + outputTokens * modelInfo.pricing.output, isUncertain);
-    }
-    return {
-        price,
-        input: {
-            tokensCount: uncertainNumber(rawResponse.usage.prompt_tokens),
-            ...computeUsageCounts(promptContent),
-        },
-        output: {
-            tokensCount: uncertainNumber(outputTokens),
-            ...computeUsageCounts(resultContent),
-        },
-    };
+function normalizeTo_snake_case(text) {
+    return normalizeTo_SCREAMING_CASE(text).toLowerCase();
 }
-/**
- * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
- */
 
 /**
  * Function `addUsage` will add multiple usages into one
@@ -3617,11 +3617,35 @@ class OpenAiCompatibleExecutionTools {
                     },
                 ]),
             ...threadMessages,
-            {
+        ];
+        if ('files' in prompt && Array.isArray(prompt.files) && prompt.files.length > 0) {
+            const filesContent = await Promise.all(prompt.files.map(async (file) => {
+                const arrayBuffer = await file.arrayBuffer();
+                const base64 = Buffer.from(arrayBuffer).toString('base64');
+                return {
+                    type: 'image_url',
+                    image_url: {
+                        url: `data:${file.type};base64,${base64}`,
+                    },
+                };
+            }));
+            messages.push({
+                role: 'user',
+                content: [
+                    {
+                        type: 'text',
+                        text: rawPromptContent,
+                    },
+                    ...filesContent,
+                ],
+            });
+        }
+        else {
+            messages.push({
                 role: 'user',
                 content: rawPromptContent,
-            },
-        ];
+            });
+        }
         let totalUsage = {
             price: uncertainNumber(0),
             input: {
@@ -3678,18 +3702,26 @@ class OpenAiCompatibleExecutionTools {
                 const usage = this.computeUsage(content || '', responseMessage.content || '', rawResponse);
                 totalUsage = addUsage(totalUsage, usage);
                 if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {
+                    const toolCallStartedAt = new Map();
                     if (onProgress) {
                         onProgress({
                             content: responseMessage.content || '',
                             modelName: rawResponse.model || modelName,
                             timing: { start, complete: $getCurrentDate() },
                             usage: totalUsage,
-                            toolCalls: responseMessage.tool_calls.map((toolCall) => ({
-                                name: toolCall.function.name,
-                                arguments: toolCall.function.arguments,
-                                result: '',
-                                rawToolCall: toolCall,
-                            })),
+                            toolCalls: responseMessage.tool_calls.map((toolCall) => {
+                                const calledAt = $getCurrentDate();
+                                if (toolCall.id) {
+                                    toolCallStartedAt.set(toolCall.id, calledAt);
+                                }
+                                return {
+                                    name: toolCall.function.name,
+                                    arguments: toolCall.function.arguments,
+                                    result: '',
+                                    rawToolCall: toolCall,
+                                    createdAt: calledAt,
+                                };
+                            }),
                             rawPromptContent,
                             rawRequest,
                             rawResponse,
@@ -3698,6 +3730,9 @@ class OpenAiCompatibleExecutionTools {
                     await forEachAsync(responseMessage.tool_calls, {}, async (toolCall) => {
                         const functionName = toolCall.function.name;
                         const functionArgs = toolCall.function.arguments;
+                        const calledAt = toolCall.id
+                            ? toolCallStartedAt.get(toolCall.id) || $getCurrentDate()
+                            : $getCurrentDate();
                         const executionTools = this.options
                             .executionTools;
                         if (!executionTools || !executionTools.script) {
@@ -3708,6 +3743,7 @@ class OpenAiCompatibleExecutionTools {
                             ? executionTools.script
                             : [executionTools.script];
                         let functionResponse;
+                        let errors;
                         try {
                             const scriptTool = scriptTools[0]; // <- TODO: [🧠] Which script tool to use?
                             functionResponse = await scriptTool.execute({
@@ -3722,6 +3758,7 @@ class OpenAiCompatibleExecutionTools {
                         catch (error) {
                             assertsError(error);
                             functionResponse = `Error: ${error.message}`;
+                            errors = [serializeError(error)];
                         }
                         messages.push({
                             role: 'tool',
@@ -3733,6 +3770,8 @@ class OpenAiCompatibleExecutionTools {
                             arguments: functionArgs,
                             result: functionResponse,
                             rawToolCall: toolCall,
+                            createdAt: calledAt,
+                            errors,
                         });
                     });
                     continue;
@@ -4111,7 +4150,12 @@ class OpenAiCompatibleExecutionTools {
             quality: currentModelRequirements.quality,
             style: currentModelRequirements.style,
         };
-        const rawPromptContent = templateParameters(content, { ...parameters, modelName });
+        let rawPromptContent = templateParameters(content, { ...parameters, modelName });
+        if ('attachments' in prompt && Array.isArray(prompt.attachments) && prompt.attachments.length > 0) {
+            rawPromptContent +=
+                '\n\n' +
+                    prompt.attachments.map((attachment) => `Image attachment: ${attachment.url}`).join('\n');
+        }
         const rawRequest = {
             ...modelSettings,
             prompt: rawPromptContent,
@@ -4404,6 +4448,243 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
     }
 }
 
+/**
+ * Execution Tools for calling OpenAI API using the Responses API (Agents)
+ *
+ * @public exported from `@promptbook/openai`
+ */
+class OpenAiAgentExecutionTools extends OpenAiExecutionTools {
+    constructor(options) {
+        super(options);
+        this.vectorStoreId = options.vectorStoreId;
+    }
+    get title() {
+        return 'OpenAI Agent';
+    }
+    get description() {
+        return 'Use OpenAI Responses API (Agentic)';
+    }
+    /**
+     * Calls OpenAI API to use a chat model with streaming.
+     */
+    async callChatModelStream(prompt, onProgress) {
+        if (this.options.isVerbose) {
+            console.info('💬 OpenAI Agent callChatModel call', { prompt });
+        }
+        const { content, parameters, modelRequirements } = prompt;
+        const client = await this.getClient();
+        if (modelRequirements.modelVariant !== 'CHAT') {
+            throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
+        }
+        const rawPromptContent = templateParameters(content, {
+            ...parameters,
+            modelName: 'agent',
+        });
+        // Build input items
+        const input = []; // TODO: Type properly when OpenAI types are updated
+        // Add previous messages from thread (if any)
+        if ('thread' in prompt && Array.isArray(prompt.thread)) {
+            const previousMessages = prompt.thread.map((msg) => ({
+                role: msg.sender === 'assistant' ? 'assistant' : 'user',
+                content: msg.content,
+            }));
+            input.push(...previousMessages);
+        }
+        // Add current user message
+        input.push({
+            role: 'user',
+            content: rawPromptContent,
+        });
+        // Prepare tools
+        const tools = modelRequirements.tools ? mapToolsToOpenAi(modelRequirements.tools) : undefined;
+        // Add file_search if vector store is present
+        const agentTools = tools ? [...tools] : [];
+        let toolResources = undefined;
+        if (this.vectorStoreId) {
+            agentTools.push({ type: 'file_search' });
+            toolResources = {
+                file_search: {
+                    vector_store_ids: [this.vectorStoreId],
+                },
+            };
+        }
+        // Add file_search also if knowledgeSources are present in the prompt (passed via AgentLlmExecutionTools)
+        if (modelRequirements.knowledgeSources &&
+            modelRequirements.knowledgeSources.length > 0 &&
+            !this.vectorStoreId) {
+            // Note: Vector store should have been created by AgentLlmExecutionTools and passed via options.
+            // If we are here, it means we have knowledge sources but no vector store ID.
+            // We can't easily create one here without persisting it.
+            console.warn('Knowledge sources provided but no vector store ID. Creating temporary vector store is not implemented in callChatModelStream.');
+        }
+        const start = $getCurrentDate();
+        // Construct the request
+        const rawRequest = {
+            // TODO: Type properly as OpenAI.Responses.CreateResponseParams
+            model: modelRequirements.modelName || 'gpt-4o',
+            input,
+            instructions: modelRequirements.systemMessage,
+            tools: agentTools.length > 0 ? agentTools : undefined,
+            tool_resources: toolResources,
+            store: false, // Stateless by default as we pass full history
+        };
+        if (this.options.isVerbose) {
+            console.info(colors.bgWhite('rawRequest (Responses API)'), JSON.stringify(rawRequest, null, 4));
+        }
+        // Call Responses API
+        // Note: Using any cast because types might not be updated yet
+        const response = await client.responses.create(rawRequest);
+        if (this.options.isVerbose) {
+            console.info(colors.bgWhite('rawResponse'), JSON.stringify(response, null, 4));
+        }
+        const complete = $getCurrentDate();
+        let resultContent = '';
+        const toolCalls = [];
+        // Parse output items
+        if (response.output) {
+            for (const item of response.output) {
+                if (item.type === 'message' && item.role === 'assistant') {
+                    for (const contentPart of item.content) {
+                        if (contentPart.type === 'output_text') {
+                            // "output_text" based on migration guide, or "text"? Guide says "output_text" in example.
+                            resultContent += contentPart.text;
+                        }
+                        else if (contentPart.type === 'text') {
+                            resultContent += contentPart.text.value || contentPart.text;
+                        }
+                    }
+                }
+                else if (item.type === 'function_call') ;
+            }
+        }
+        // Use output_text helper if available (mentioned in guide)
+        if (response.output_text) {
+            resultContent = response.output_text;
+        }
+        // TODO: Handle tool calls properly (Requires clearer docs or experimentation)
+        onProgress({
+            content: resultContent,
+            modelName: response.model || 'agent',
+            timing: { start, complete },
+            usage: UNCERTAIN_USAGE,
+            rawPromptContent,
+            rawRequest,
+            rawResponse: response,
+        });
+        return exportJson({
+            name: 'promptResult',
+            message: `Result of \`OpenAiAgentExecutionTools.callChatModelStream\``,
+            order: [],
+            value: {
+                content: resultContent,
+                modelName: response.model || 'agent',
+                timing: { start, complete },
+                usage: UNCERTAIN_USAGE,
+                rawPromptContent,
+                rawRequest,
+                rawResponse: response,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+            },
+        });
+    }
+    /**
+     * Creates a vector store from knowledge sources
+     */
+    static async createVectorStore(client, name, knowledgeSources) {
+        // Create a vector store
+        const vectorStore = await client.beta.vectorStores.create({
+            name: `${name} Knowledge Base`,
+        });
+        const vectorStoreId = vectorStore.id;
+        // Upload files from knowledge sources to the vector store
+        const fileStreams = [];
+        for (const source of knowledgeSources) {
+            try {
+                // Check if it's a URL
+                if (source.startsWith('http://') || source.startsWith('https://')) {
+                    // Download the file
+                    const response = await fetch(source);
+                    if (!response.ok) {
+                        console.error(`Failed to download ${source}: ${response.statusText}`);
+                        continue;
+                    }
+                    const buffer = await response.arrayBuffer();
+                    const filename = source.split('/').pop() || 'downloaded-file';
+                    const blob = new Blob([buffer]);
+                    const file = new File([blob], filename);
+                    fileStreams.push(file);
+                }
+                else {
+                    // Local files not supported in browser env easily, same as before
+                }
+            }
+            catch (error) {
+                console.error(`Error processing knowledge source ${source}:`, error);
+            }
+        }
+        // Batch upload files to the vector store
+        if (fileStreams.length > 0) {
+            try {
+                await client.beta.vectorStores.fileBatches.uploadAndPoll(vectorStoreId, {
+                    files: fileStreams,
+                });
+            }
+            catch (error) {
+                console.error('Error uploading files to vector store:', error);
+            }
+        }
+        return vectorStoreId;
+    }
+    /**
+     * Discriminant for type guards
+     */
+    get discriminant() {
+        return 'OPEN_AI_AGENT';
+    }
+    /**
+     * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAgentExecutionTools`
+     */
+    static isOpenAiAgentExecutionTools(llmExecutionTools) {
+        return llmExecutionTools.discriminant === 'OPEN_AI_AGENT';
+    }
+}
+
+/**
+ * Execution Tools for calling OpenAI API using Responses API
+ *
+ * @public exported from `@promptbook/openai`
+ */
+const createOpenAiAgentExecutionTools = Object.assign((options) => {
+    if (($isRunningInBrowser() || $isRunningInWebWorker()) && !options.dangerouslyAllowBrowser) {
+        options = { ...options, dangerouslyAllowBrowser: true };
+    }
+    return new OpenAiAgentExecutionTools(options);
+}, {
+    packageName: '@promptbook/openai',
+    className: 'OpenAiAgentExecutionTools',
+});
+
+/**
+ * Uploads files to OpenAI and returns their IDs
+ *
+ * @private utility for `OpenAiAssistantExecutionTools` and `OpenAiCompatibleExecutionTools`
+ */
+async function uploadFilesToOpenAi(client, files) {
+    const fileIds = [];
+    for (const file of files) {
+        // Note: OpenAI API expects a File object or a ReadStream
+        // In browser environment, we can pass the File object directly
+        // In Node.js environment, we might need to convert it or use a different approach
+        // But since `Prompt.files` already contains `File` objects, we try to pass them directly
+        const uploadedFile = await client.files.create({
+            file: file,
+            purpose: 'assistants',
+        });
+        fileIds.push(uploadedFile.id);
+    }
+    return fileIds;
+}
+
 /**
  * Execution Tools for calling OpenAI API Assistants
  *
@@ -4417,6 +4698,7 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
  * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @public exported from `@promptbook/openai`
+ * @deprecated Use `OpenAiAgentExecutionTools` instead which uses the new OpenAI Responses API
  */
 class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
     /**
@@ -4455,7 +4737,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
      * Calls OpenAI API to use a chat model with streaming.
      */
     async callChatModelStream(prompt, onProgress) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f;
         if (this.options.isVerbose) {
             console.info('💬 OpenAI callChatModel call', { prompt });
         }
@@ -4500,16 +4782,26 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
         const threadMessages = [];
         // TODO: [🈹] Maybe this should not be here but in other place, look at commit 39d705e75e5bcf7a818c3af36bc13e1c8475c30c
         // Add previous messages from thread (if any)
-        if ('thread' in prompt &&
-            Array.isArray(prompt.thread)) {
+        if ('thread' in prompt && Array.isArray(prompt.thread)) {
             const previousMessages = prompt.thread.map((msg) => ({
-                role: (msg.role === 'assistant' ? 'assistant' : 'user'),
+                role: (msg.sender === 'assistant' ? 'assistant' : 'user'),
                 content: msg.content,
             }));
             threadMessages.push(...previousMessages);
         }
         // Always add the current user message
-        threadMessages.push({ role: 'user', content: rawPromptContent });
+        const currentUserMessage = {
+            role: 'user',
+            content: rawPromptContent,
+        };
+        if ('files' in prompt && Array.isArray(prompt.files) && prompt.files.length > 0) {
+            const fileIds = await uploadFilesToOpenAi(client, prompt.files);
+            currentUserMessage.attachments = fileIds.map((fileId) => ({
+                file_id: fileId,
+                tools: [{ type: 'file_search' }, { type: 'code_interpreter' }],
+            }));
+        }
+        threadMessages.push(currentUserMessage);
         // Check if tools are being used - if so, use non-streaming mode
         const hasTools = modelRequirements.tools !== undefined && modelRequirements.tools.length > 0;
         const start = $getCurrentDate();
@@ -4539,6 +4831,8 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             // Create thread and run
             const threadAndRun = await client.beta.threads.createAndRun(rawRequest);
             let run = threadAndRun;
+            const completedToolCalls = [];
+            const toolCallStartedAt = new Map();
             // Poll until run completes or requires action
             while (run.status === 'queued' || run.status === 'in_progress' || run.status === 'requires_action') {
                 if (run.status === 'requires_action' && ((_a = run.required_action) === null || _a === void 0 ? void 0 : _a.type) === 'submit_tool_outputs') {
@@ -4549,6 +4843,10 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                         if (toolCall.type === 'function') {
                             const functionName = toolCall.function.name;
                             const functionArgs = JSON.parse(toolCall.function.arguments);
+                            const calledAt = $getCurrentDate();
+                            if (toolCall.id) {
+                                toolCallStartedAt.set(toolCall.id, calledAt);
+                            }
                             onProgress({
                                 content: '',
                                 modelName: 'assistant',
@@ -4563,6 +4861,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                                         arguments: toolCall.function.arguments,
                                         result: '',
                                         rawToolCall: toolCall,
+                                        createdAt: calledAt,
                                     },
                                 ],
                             });
@@ -4580,6 +4879,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                                 ? executionTools.script
                                 : [executionTools.script];
                             let functionResponse;
+                            let errors;
                             try {
                                 const scriptTool = scriptTools[0]; // <- TODO: [🧠] Which script tool to use?
                                 functionResponse = await scriptTool.execute({
@@ -4596,12 +4896,14 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                             }
                             catch (error) {
                                 assertsError(error);
+                                const serializedError = serializeError(error);
+                                errors = [serializedError];
                                 functionResponse = spaceTrim$2((block) => `
                                     
                                         The invoked tool \`${functionName}\` failed with error:
                                         
                                         \`\`\`json
-                                        ${block(JSON.stringify(serializeError(error), null, 4))}
+                                        ${block(JSON.stringify(serializedError, null, 4))}
                                         \`\`\`
 
                                     `);
@@ -4612,6 +4914,14 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                                 tool_call_id: toolCall.id,
                                 output: functionResponse,
                             });
+                            completedToolCalls.push({
+                                name: functionName,
+                                arguments: toolCall.function.arguments,
+                                result: functionResponse,
+                                rawToolCall: toolCall,
+                                createdAt: toolCall.id ? toolCallStartedAt.get(toolCall.id) || calledAt : calledAt,
+                                errors,
+                            });
                         }
                     }
                     // Submit tool outputs
@@ -4651,6 +4961,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 rawPromptContent,
                 rawRequest,
                 rawResponse: { run, messages: messages.data },
+                toolCalls: completedToolCalls.length > 0 ? completedToolCalls : undefined,
             };
             onProgress(finalChunk);
             return exportJson({
@@ -4730,8 +5041,38 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
         if (((_b = rawResponse[0].content[0]) === null || _b === void 0 ? void 0 : _b.type) !== 'text') {
             throw new PipelineExecutionError(`There is NOT 'text' BUT ${(_c = rawResponse[0].content[0]) === null || _c === void 0 ? void 0 : _c.type} finalMessages content type from OpenAI`);
         }
-        const resultContent = (_d = rawResponse[0].content[0]) === null || _d === void 0 ? void 0 : _d.text.value;
-        //                                                     <- TODO: [🧠] There are also annotations, maybe use them
+        let resultContent = (_d = rawResponse[0].content[0]) === null || _d === void 0 ? void 0 : _d.text.value;
+        // Process annotations to replace file IDs with filenames
+        if ((_e = rawResponse[0].content[0]) === null || _e === void 0 ? void 0 : _e.text.annotations) {
+            const annotations = (_f = rawResponse[0].content[0]) === null || _f === void 0 ? void 0 : _f.text.annotations;
+            // Map to store file ID -> filename to avoid duplicate requests
+            const fileIdToName = new Map();
+            for (const annotation of annotations) {
+                if (annotation.type === 'file_citation') {
+                    const fileId = annotation.file_citation.file_id;
+                    let filename = fileIdToName.get(fileId);
+                    if (!filename) {
+                        try {
+                            const file = await client.files.retrieve(fileId);
+                            filename = file.filename;
+                            fileIdToName.set(fileId, filename);
+                        }
+                        catch (error) {
+                            console.error(`Failed to retrieve file info for ${fileId}`, error);
+                            // Fallback to "Source" or keep original if fetch fails
+                            filename = 'Source';
+                        }
+                    }
+                    if (filename && resultContent) {
+                        // Replace the citation marker with filename
+                        // Regex to match the second part of the citation: 【id†source】 -> 【id†filename】
+                        // Note: annotation.text contains the exact marker like 【4:0†source】
+                        const newText = annotation.text.replace(/†.*?】/, `†${filename}】`);
+                        resultContent = resultContent.replace(annotation.text, newText);
+                    }
+                }
+            }
+        }
         // eslint-disable-next-line prefer-const
         complete = $getCurrentDate();
         const usage = UNCERTAIN_USAGE;
@@ -4827,7 +5168,14 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                             continue;
                         }
                         const buffer = await response.arrayBuffer();
-                        const filename = source.split('/').pop() || 'downloaded-file';
+                        let filename = source.split('/').pop() || 'downloaded-file';
+                        try {
+                            const url = new URL(source);
+                            filename = url.pathname.split('/').pop() || filename;
+                        }
+                        catch (error) {
+                            // Keep default filename
+                        }
                         const blob = new Blob([buffer]);
                         const file = new File([blob], filename);
                         fileStreams.push(file);
@@ -4928,7 +5276,14 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                             continue;
                         }
                         const buffer = await response.arrayBuffer();
-                        const filename = source.split('/').pop() || 'downloaded-file';
+                        let filename = source.split('/').pop() || 'downloaded-file';
+                        try {
+                            const url = new URL(source);
+                            filename = url.pathname.split('/').pop() || filename;
+                        }
+                        catch (error) {
+                            // Keep default filename
+                        }
                         const blob = new Blob([buffer]);
                         const file = new File([blob], filename);
                         fileStreams.push(file);
@@ -5012,6 +5367,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
  */
 const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
 /**
+ * TODO: !!!!! [✨🥚] Knowledge should work both with and without scrapers
  * TODO: [🙎] In `OpenAiAssistantExecutionTools` Allow to create abstract assistants with `isCreatingNewAssistantsAllowed`
  * TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI
  * TODO: Maybe make custom OpenAiError
@@ -5455,5 +5811,5 @@ const _OpenAiCompatibleRegistration = $llmToolsRegister.register(createOpenAiCom
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-export { BOOK_LANGUAGE_VERSION, OPENAI_MODELS, OpenAiAssistantExecutionTools, OpenAiCompatibleExecutionTools, OpenAiExecutionTools, PROMPTBOOK_ENGINE_VERSION, _OpenAiAssistantRegistration, _OpenAiCompatibleRegistration, _OpenAiRegistration, createOpenAiAssistantExecutionTools, createOpenAiCompatibleExecutionTools, createOpenAiExecutionTools };
+export { BOOK_LANGUAGE_VERSION, OPENAI_MODELS, OpenAiAgentExecutionTools, OpenAiAssistantExecutionTools, OpenAiCompatibleExecutionTools, OpenAiExecutionTools, PROMPTBOOK_ENGINE_VERSION, _OpenAiAssistantRegistration, _OpenAiCompatibleRegistration, _OpenAiRegistration, createOpenAiAgentExecutionTools, createOpenAiAssistantExecutionTools, createOpenAiCompatibleExecutionTools, createOpenAiExecutionTools };
 //# sourceMappingURL=index.es.js.map