@promptbook/ollama 0.112.0-13 → 0.112.0-16

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { randomBytes } from 'crypto';
 import Bottleneck from 'bottleneck';
 import colors from 'colors';
@@ -21,7 +21,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-13';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-16';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1201,7 +1201,7 @@ const API_REQUEST_TIMEOUT = parseInt(process.env.API_REQUEST_TIMEOUT || '90000')
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$2((block) => `
+        body: spaceTrim$1((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1359,7 +1359,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1378,7 +1378,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim$2((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1401,7 +1401,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim$2((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1433,7 +1433,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$2((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -2030,7 +2030,7 @@ function pricing(value) {
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/
@@ -2152,8 +2152,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1',
             modelDescription: 'Smartest non-reasoning model with 128K context window. Enhanced version of GPT-4 with improved instruction following, better factual accuracy, and reduced hallucinations. Features advanced function calling capabilities and superior performance on coding tasks. Ideal for applications requiring high intelligence without reasoning overhead.',
             pricing: {
-                prompt: pricing(`$3.00 / 1M tokens`),
-                output: pricing(`$12.00 / 1M tokens`),
+                prompt: pricing(`$2.00 / 1M tokens`),
+                output: pricing(`$8.00 / 1M tokens`),
             },
         },
         /**/
@@ -2164,8 +2164,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1-mini',
             modelDescription: 'Smaller, faster version of GPT-4.1 with 128K context window. Balances intelligence and efficiency with 3x faster inference than base GPT-4.1. Maintains strong capabilities across text generation, reasoning, and coding while offering better cost-performance ratio for most applications.',
             pricing: {
-                prompt: pricing(`$0.80 / 1M tokens`),
-                output: pricing(`$3.20 / 1M tokens`),
+                prompt: pricing(`$0.40 / 1M tokens`),
+                output: pricing(`$1.60 / 1M tokens`),
             },
         },
         /**/
@@ -2176,8 +2176,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4.1-nano',
             modelDescription: 'Fastest, most cost-efficient version of GPT-4.1 with 128K context window. Optimized for high-throughput applications requiring good quality at minimal cost. Features 5x faster inference than GPT-4.1 while maintaining adequate performance for most general-purpose tasks.',
             pricing: {
-                prompt: pricing(`$0.20 / 1M tokens`),
-                output: pricing(`$0.80 / 1M tokens`),
+                prompt: pricing(`$0.10 / 1M tokens`),
+                output: pricing(`$0.40 / 1M tokens`),
             },
         },
         /**/
@@ -2188,8 +2188,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3',
             modelDescription: 'Advanced reasoning model with 128K context window specializing in complex logical, mathematical, and analytical tasks. Successor to o1 with enhanced step-by-step problem-solving capabilities and superior performance on STEM-focused problems. Ideal for professional applications requiring deep analytical thinking and precise reasoning.',
             pricing: {
-                prompt: pricing(`$15.00 / 1M tokens`),
-                output: pricing(`$60.00 / 1M tokens`),
+                prompt: pricing(`$2.00 / 1M tokens`),
+                output: pricing(`$8.00 / 1M tokens`),
             },
         },
         /**/
@@ -2200,8 +2200,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3-pro',
             modelDescription: 'Enhanced version of o3 with more compute allocated for better responses on the most challenging problems. Features extended reasoning time and improved accuracy on complex analytical tasks. Designed for applications where maximum reasoning quality is more important than response speed.',
             pricing: {
-                prompt: pricing(`$30.00 / 1M tokens`),
-                output: pricing(`$120.00 / 1M tokens`),
+                prompt: pricing(`$20.00 / 1M tokens`),
+                output: pricing(`$80.00 / 1M tokens`),
             },
         },
         /**/
@@ -2212,8 +2212,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o4-mini',
             modelDescription: 'Fast, cost-efficient reasoning model with 128K context window. Successor to o1-mini with improved analytical capabilities while maintaining speed advantages. Features enhanced mathematical reasoning and logical problem-solving at significantly lower cost than full reasoning models.',
             pricing: {
-                prompt: pricing(`$4.00 / 1M tokens`),
-                output: pricing(`$16.00 / 1M tokens`),
+                prompt: pricing(`$1.10 / 1M tokens`),
+                output: pricing(`$4.40 / 1M tokens`),
             },
         },
         /**/
@@ -2571,8 +2571,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4o-2024-05-13',
             modelDescription: 'May 2024 version of GPT-4o with 128K context window. Features enhanced multimodal capabilities including superior image understanding (up to 20MP), audio processing, and improved reasoning. Optimized for 2x lower latency than GPT-4 Turbo while maintaining high performance. Includes knowledge up to October 2023. Ideal for production applications requiring reliable multimodal capabilities.',
             pricing: {
-                prompt: pricing(`$5.00 / 1M tokens`),
-                output: pricing(`$15.00 / 1M tokens`),
+                prompt: pricing(`$2.50 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
             },
         },
         /**/
@@ -2583,8 +2583,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'gpt-4o',
             modelDescription: "OpenAI's most advanced general-purpose multimodal model with 128K context window. Optimized for balanced performance, speed, and cost with 2x faster responses than GPT-4 Turbo. Features excellent vision processing, audio understanding, reasoning, and text generation quality. Represents optimal balance of capability and efficiency for most advanced applications.",
             pricing: {
-                prompt: pricing(`$5.00 / 1M tokens`),
-                output: pricing(`$15.00 / 1M tokens`),
+                prompt: pricing(`$2.50 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
             },
         },
         /**/
@@ -2655,8 +2655,8 @@ const OPENAI_MODELS = exportJson({
             modelName: 'o3-mini',
             modelDescription: 'Cost-effective reasoning model with 128K context window optimized for academic and scientific problem-solving. Features efficient performance on STEM tasks with specialized capabilities in mathematics, physics, chemistry, and computer science. Offers 80% of O1 performance on technical domains at significantly lower cost. Ideal for educational applications and research support.',
             pricing: {
-                prompt: pricing(`$3.00 / 1M tokens`),
-                output: pricing(`$12.00 / 1M tokens`),
+                prompt: pricing(`$1.10 / 1M tokens`),
+                output: pricing(`$4.40 / 1M tokens`),
             },
         },
         /**/
@@ -2757,116 +2757,130 @@ resultContent, rawResponse, duration = ZERO_VALUE) {
  */
 
 /**
- * Prompt parameter key used to pass hidden runtime context to tool execution.
- *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
-/**
- * Hidden argument key used to pass runtime context into individual tool calls.
+ * This error indicates problems parsing the format value
  *
- * @private internal runtime wiring for commitment tools
- */
-const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
-/**
- * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
+ * For example, when the format value is not a valid JSON or CSV
+ * This is not thrown directly but in extended classes
  *
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
+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);
+    }
+}
+
 /**
- * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
+ * This error indicates problem with parsing of CSV
  *
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
+class CsvFormatError extends AbstractFormatError {
+    constructor(message) {
+        super(message);
+        this.name = 'CsvFormatError';
+        Object.setPrototypeOf(this, CsvFormatError.prototype);
+    }
+}
+
 /**
- * Monotonic counter used for hidden progress-listener tokens.
+ * AuthenticationError is thrown from login function which is dependency of remote server
  *
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-let toolCallProgressListenerCounter = 0;
+class AuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+
 /**
- * Active tool-progress listeners keyed by hidden execution token.
+ * This error indicates that the pipeline collection cannot be properly loaded
  *
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-const toolCallProgressListeners = new Map();
+class CollectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CollectionError';
+        Object.setPrototypeOf(this, CollectionError.prototype);
+    }
+}
+
 /**
- * Registers one in-memory listener that receives progress updates emitted by a running tool.
- *
- * The returned token is passed into script execution as a hidden argument so tool implementations
- * can stream progress without exposing extra parameters to the model.
+ * Signals that the requested operation could not be completed because the target already exists.
  *
- * @param listener - Listener notified about tool progress.
- * @returns Hidden token used to route progress updates.
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-function registerToolCallProgressListener(listener) {
-    toolCallProgressListenerCounter += 1;
-    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
-    toolCallProgressListeners.set(token, listener);
-    return token;
+class ConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConflictError';
+        Object.setPrototypeOf(this, ConflictError.prototype);
+    }
 }
+
 /**
- * Unregisters one in-memory progress listener.
+ * This error indicates error from the database
  *
- * @param token - Token previously created by `registerToolCallProgressListener`.
- * @private internal runtime wiring for commitment tools
+ * @public exported from `@promptbook/core`
  */
-function unregisterToolCallProgressListener(token) {
-    toolCallProgressListeners.delete(token);
+class DatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DatabaseError';
+        Object.setPrototypeOf(this, DatabaseError.prototype);
+    }
 }
 /**
- * Note: [💞] Ignore a discrepancy between file name and entity name
+ * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
  */
 
 /**
- * Marker property stored inside serialized tool-execution envelopes.
+ * This error type indicates that you try to use a feature that is not available in the current environment
  *
- * @private internal tool-execution transport
+ * @public exported from `@promptbook/core`
  */
-const TOOL_EXECUTION_ENVELOPE_MARKER = '__promptbookToolExecutionEnvelope';
+class EnvironmentMismatchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnvironmentMismatchError';
+        Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
+    }
+}
+
 /**
- * Parses one serialized tool-execution envelope when present.
+ * This error occurs when some expectation is not met in the execution of the pipeline
  *
- * @private internal tool-execution transport
+ * @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
  */
-function parseToolExecutionEnvelope(rawValue) {
-    if (typeof rawValue !== 'string') {
-        return null;
-    }
-    try {
-        const parsedValue = JSON.parse(rawValue);
-        if (!parsedValue ||
-            typeof parsedValue !== 'object' ||
-            parsedValue[TOOL_EXECUTION_ENVELOPE_MARKER] !== true ||
-            typeof parsedValue.assistantMessage !== 'string') {
-            return null;
-        }
-        return {
-            assistantMessage: parsedValue.assistantMessage,
-            toolResult: parsedValue.toolResult,
-        };
-    }
-    catch (_a) {
-        return null;
+class ExpectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ExpectError';
+        Object.setPrototypeOf(this, ExpectError.prototype);
     }
 }
-/**
- * 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
+ * This error indicates that the promptbook can not retrieve knowledge from external sources
  *
- * @returns string_date branded type
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
  */
-function $getCurrentDate() {
-    return new Date().toISOString();
+class KnowledgeScrapeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'KnowledgeScrapeError';
+        Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
+    }
 }
 
 /**
@@ -2883,332 +2897,53 @@ class LimitReachedError extends Error {
 }
 
 /**
- * Format either small or big number
+ * This error type indicates that some tools are missing for pipeline execution or preparation
  *
- * @public exported from `@promptbook/utils`
+ * @public exported from `@promptbook/core`
  */
-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);
-        }
+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);
     }
-    return value.toString();
 }
 
 /**
- * Function `valueToString` will convert the given value to string
- * This is useful and used in the `templateParameters` function
+ * This error indicates that promptbook operation is not allowed
  *
- * 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`
+ * @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
  *
- * 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/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/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;
-}
-
-/**
- * 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);
-    }
-}
-
-/**
- * Signals that the requested operation could not be completed because the target already exists.
- *
- * @public exported from `@promptbook/core`
- */
-class ConflictError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ConflictError';
-        Object.setPrototypeOf(this, ConflictError.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`
+ * @public exported from `@promptbook/core`
  */
 class NotYetImplementedError extends Error {
     constructor(message) {
@@ -3357,7 +3092,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$2((block) => `
+        console.error(spaceTrim$1((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -3369,41 +3104,205 @@ function serializeError(error) {
 
                 `));
     }
-    return {
-        name: name,
-        message,
-        stack,
-        id, // Include id in the serialized object
-    };
+    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(/\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;
 }
 
 /**
- * Async version of Array.forEach
+ * Simple wrapper `new Date().toISOString()`
  *
- * @param array - Array to iterate over
- * @param options - Options for the function
- * @param callbackfunction - Function to call for each item
+ * 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`
- * @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);
+function $getCurrentDate() {
+    return new Date().toISOString();
 }
 
 /**
@@ -3478,6 +3377,107 @@ function normalizeTo_snake_case(text) {
     return normalizeTo_SCREAMING_CASE(text).toLowerCase();
 }
 
+/**
+ * Marker property stored inside serialized tool-execution envelopes.
+ *
+ * @private internal tool-execution transport
+ */
+const TOOL_EXECUTION_ENVELOPE_MARKER = '__promptbookToolExecutionEnvelope';
+/**
+ * Parses one serialized tool-execution envelope when present.
+ *
+ * @private internal tool-execution transport
+ */
+function parseToolExecutionEnvelope(rawValue) {
+    if (typeof rawValue !== 'string') {
+        return null;
+    }
+    try {
+        const parsedValue = JSON.parse(rawValue);
+        if (!parsedValue ||
+            typeof parsedValue !== 'object' ||
+            parsedValue[TOOL_EXECUTION_ENVELOPE_MARKER] !== true ||
+            typeof parsedValue.assistantMessage !== 'string') {
+            return null;
+        }
+        return {
+            assistantMessage: parsedValue.assistantMessage,
+            toolResult: parsedValue.toolResult,
+        };
+    }
+    catch (_a) {
+        return null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Prompt parameter key used to pass hidden runtime context to tool execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_PARAMETER = 'promptbookToolRuntimeContext';
+/**
+ * Hidden argument key used to pass runtime context into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_RUNTIME_CONTEXT_ARGUMENT = '__promptbookToolRuntimeContext';
+/**
+ * Prompt parameter key used to pass a hidden tool-progress listener token into script execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_PARAMETER = 'promptbookToolProgressToken';
+/**
+ * Hidden argument key used to pass a tool-progress listener token into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const TOOL_PROGRESS_TOKEN_ARGUMENT = '__promptbookToolProgressToken';
+/**
+ * Monotonic counter used for hidden progress-listener tokens.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+let toolCallProgressListenerCounter = 0;
+/**
+ * Active tool-progress listeners keyed by hidden execution token.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+const toolCallProgressListeners = new Map();
+/**
+ * Registers one in-memory listener that receives progress updates emitted by a running tool.
+ *
+ * The returned token is passed into script execution as a hidden argument so tool implementations
+ * can stream progress without exposing extra parameters to the model.
+ *
+ * @param listener - Listener notified about tool progress.
+ * @returns Hidden token used to route progress updates.
+ * @private internal runtime wiring for commitment tools
+ */
+function registerToolCallProgressListener(listener) {
+    toolCallProgressListenerCounter += 1;
+    const token = `tool-progress:${Date.now()}:${toolCallProgressListenerCounter}`;
+    toolCallProgressListeners.set(token, listener);
+    return token;
+}
+/**
+ * Unregisters one in-memory progress listener.
+ *
+ * @param token - Token previously created by `registerToolCallProgressListener`.
+ * @private internal runtime wiring for commitment tools
+ */
+function unregisterToolCallProgressListener(token) {
+    toolCallProgressListeners.delete(token);
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Function `addUsage` will add multiple usages into one
  *
@@ -3532,53 +3532,6 @@ function addUsage(...usageItems) {
     }, deepClone(ZERO_USAGE));
 }
 
-/**
- * Maps Promptbook tools to OpenAI tools.
- *
- * @private
- */
-function mapToolsToOpenAi(tools) {
-    return tools.map((tool) => ({
-        type: 'function',
-        function: {
-            name: tool.name,
-            description: tool.description,
-            parameters: tool.parameters,
-        },
-    }));
-}
-
-/**
- * Builds a tool invocation script that injects hidden runtime context into tool args.
- *
- * @private utility of OpenAI tool execution wrappers
- */
-function buildToolInvocationScript(options) {
-    const { functionName, functionArgsExpression } = options;
-    return `
-        const args = ${functionArgsExpression};
-        const runtimeContextRaw =
-            typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
-
-        if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
-        }
-
-        const toolProgressTokenRaw =
-            typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
-                ? undefined
-                : ${TOOL_PROGRESS_TOKEN_PARAMETER};
-
-        if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
-            args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
-        }
-
-        return await ${functionName}(args);
-    `;
-}
-
 /**
  * Parses an OpenAI error message to identify which parameter is unsupported
  *
@@ -3635,6 +3588,53 @@ function isUnsupportedParameterError(error) {
         errorMessage.includes('does not support'));
 }
 
+/**
+ * Builds a tool invocation script that injects hidden runtime context into tool args.
+ *
+ * @private utility of OpenAI tool execution wrappers
+ */
+function buildToolInvocationScript(options) {
+    const { functionName, functionArgsExpression } = options;
+    return `
+        const args = ${functionArgsExpression};
+        const runtimeContextRaw =
+            typeof ${TOOL_RUNTIME_CONTEXT_PARAMETER} === 'undefined'
+                ? undefined
+                : ${TOOL_RUNTIME_CONTEXT_PARAMETER};
+
+        if (runtimeContextRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+            args.${TOOL_RUNTIME_CONTEXT_ARGUMENT} = runtimeContextRaw;
+        }
+
+        const toolProgressTokenRaw =
+            typeof ${TOOL_PROGRESS_TOKEN_PARAMETER} === 'undefined'
+                ? undefined
+                : ${TOOL_PROGRESS_TOKEN_PARAMETER};
+
+        if (toolProgressTokenRaw !== undefined && args && typeof args === 'object' && !Array.isArray(args)) {
+            args.${TOOL_PROGRESS_TOKEN_ARGUMENT} = toolProgressTokenRaw;
+        }
+
+        return await ${functionName}(args);
+    `;
+}
+
+/**
+ * Maps Promptbook tools to OpenAI tools.
+ *
+ * @private
+ */
+function mapToolsToOpenAi(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+
 /**
  * Provides access to the structured clone implementation when available.
  */
@@ -4601,7 +4601,7 @@ class OpenAiCompatibleExecutionTools {
         // Note: Match exact or prefix for model families
         const model = this.HARDCODED_MODELS.find(({ modelName }) => modelName === defaultModelName || modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new PipelineExecutionError(spaceTrim$2((block) => `
+            throw new PipelineExecutionError(spaceTrim$1((block) => `
                             Cannot find model in ${this.title} models with name "${defaultModelName}" which should be used as default.
 
                             Available models: