@promptbook/core 0.103.0-42 → 0.103.0-44

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import spaceTrim$1, { spaceTrim as spaceTrim$2 } from 'spacetrim';
 import { randomBytes } from 'crypto';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { forTime, forEver } from 'waitasecond';
@@ -20,14 +20,14 @@ import OpenAI from 'openai';
  * @generated
  * @see https://github.com/webgptorg/book
  */
-const BOOK_LANGUAGE_VERSION = '1.0.0';
+const BOOK_LANGUAGE_VERSION = '2.0.0';
 /**
  * The version of the Promptbook engine
  *
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-42';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-44';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -841,6 +841,23 @@ class Color {
  * TODO: Maybe connect with textures
  */
 
+/**
+ * Makes color transformer which returns a grayscale version of the color
+ *
+ * @param amount from 0 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+function grayscale(amount) {
+    return ({ red, green, blue, alpha }) => {
+        const average = (red + green + blue) / 3;
+        red = Math.round(average * amount + red * (1 - amount));
+        green = Math.round(average * amount + green * (1 - amount));
+        blue = Math.round(average * amount + blue * (1 - amount));
+        return Color.fromValues(red, green, blue, alpha);
+    };
+}
+
 /**
  * Converts HSL values to RGB values
  *
@@ -956,102 +973,6 @@ function lighten(amount) {
  * TODO: Maybe implement by mix+hsl
  */
 
-/**
- * Calculates distance between two colors
- *
- * @param color1 first color
- * @param color2 second color
- *
- * Note: This function is inefficient. Use colorDistanceSquared instead if possible.
- *
- * @public exported from `@promptbook/color`
- */
-/**
- * Calculates distance between two colors without square root
- *
- * @param color1 first color
- * @param color2 second color
- *
- * @public exported from `@promptbook/color`
- */
-function colorDistanceSquared(color1, color2) {
-    const rmean = (color1.red + color2.red) / 2;
-    const r = color1.red - color2.red;
-    const g = color1.green - color2.green;
-    const b = color1.blue - color2.blue;
-    const weightR = 2 + rmean / 256;
-    const weightG = 4.0;
-    const weightB = 2 + (255 - rmean) / 256;
-    const distance = weightR * r * r + weightG * g * g + weightB * b * b;
-    return distance;
-}
-
-/**
- * Makes color transformer which finds the nearest color from the given list
- *
- * @param colors array of colors to choose from
- *
- * @public exported from `@promptbook/color`
- */
-function nearest(...colors) {
-    return (color) => {
-        const distances = colors.map((c) => colorDistanceSquared(c, color));
-        const minDistance = Math.min(...distances);
-        const minIndex = distances.indexOf(minDistance);
-        const nearestColor = colors[minIndex];
-        return nearestColor;
-    };
-}
-
-/**
- * Color transformer which returns the negative color
- *
- * @public exported from `@promptbook/color`
- */
-function negative(color) {
-    const r = 255 - color.red;
-    const g = 255 - color.green;
-    const b = 255 - color.blue;
-    return Color.fromValues(r, g, b, color.alpha);
-}
-
-/**
- * Makes color transformer which finds the furthest color from the given list
- *
- * @param colors array of colors to choose from
- *
- * @public exported from `@promptbook/color`
- */
-function furthest(...colors) {
-    return (color) => {
-        const furthestColor = negative(nearest(...colors.map(negative))(color));
-        return furthestColor;
-    };
-}
-/**
- * Makes color transformer which finds the best text color (black or white) for the given background color
- *
- * @public exported from `@promptbook/color`
- */
-furthest(Color.get('white'), Color.from('black'));
-
-/**
- * Makes color transformer which returns a grayscale version of the color
- *
- * @param amount from 0 to 1
- *
- * @public exported from `@promptbook/color`
- */
-function grayscale(amount) {
-    return ({ red, green, blue, alpha }) => {
-        const average = (red + green + blue) / 3;
-        red = Math.round(average * amount + red * (1 - amount));
-        green = Math.round(average * amount + green * (1 - amount));
-        blue = Math.round(average * amount + blue * (1 - amount));
-        return Color.fromValues(red, green, blue, alpha);
-    };
-}
-
 /**
  * Makes color transformer which saturate the given color
  *
@@ -1461,6 +1382,19 @@ const IS_PIPELINE_LOGIC_VALIDATED = just(
 /**/
 // Note: In normal situations, we check the pipeline logic:
 true);
+/**
+ * Indicates whether cost-prevention is enabled. When true, real API keys are prevented from being used in tests.
+ *
+ * @private within the repository
+ */
+const IS_COST_PREVENTED = just(
+/*/
+// Note: In normal situations, we prevent ability to use real API keys in tests:
+true,
+/**/
+/**/
+// When working on preparations, you can temporarily turn off the prevention:
+false);
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
@@ -1474,7 +1408,7 @@ true);
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim((block) => `
+        body: spaceTrim$1((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1517,7 +1451,7 @@ function getErrorReportUrl(error) {
  */
 class UnexpectedError extends Error {
     constructor(message) {
-        super(spaceTrim$1((block) => `
+        super(spaceTrim$2((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1543,7 +1477,7 @@ class WrappedError extends Error {
     constructor(whatWasThrown) {
         const tag = `[🤮]`;
         console.error(tag, whatWasThrown);
-        super(spaceTrim$1(`
+        super(spaceTrim$2(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1767,7 +1701,7 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += '```' + contentLanguage;
         pipelineString += '\n';
-        pipelineString += spaceTrim(content);
+        pipelineString += spaceTrim$1(content);
         //                   <- TODO: [main] !!3 Escape
         //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         pipelineString += '\n';
@@ -1888,7 +1822,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1907,7 +1841,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1930,7 +1864,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1962,7 +1896,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -2256,7 +2190,7 @@ function validatePipeline(pipeline) {
             if (!(error instanceof PipelineLogicError)) {
                 throw error;
             }
-            console.error(spaceTrim$1((block) => `
+            console.error(spaceTrim$2((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -2283,7 +2217,7 @@ function validatePipeline_InnerFunction(pipeline) {
     })();
     if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
         // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim$1((block) => `
+        throw new PipelineLogicError(spaceTrim$2((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -2291,7 +2225,7 @@ function validatePipeline_InnerFunction(pipeline) {
     }
     if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
         // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim$1((block) => `
+        throw new PipelineLogicError(spaceTrim$2((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -2300,7 +2234,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.parameters)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -2311,7 +2245,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.tasks)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim$1((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -2337,7 +2271,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // Note: Check each parameter individually
     for (const parameter of pipeline.parameters) {
         if (parameter.isInput && parameter.isOutput) {
-            throw new PipelineLogicError(spaceTrim$1((block) => `
+            throw new PipelineLogicError(spaceTrim$2((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -2348,7 +2282,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (!parameter.isInput &&
             !parameter.isOutput &&
             !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-            throw new PipelineLogicError(spaceTrim$1((block) => `
+            throw new PipelineLogicError(spaceTrim$2((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -2360,7 +2294,7 @@ function validatePipeline_InnerFunction(pipeline) {
         }
         // Note: Testing that parameter is either input or result of some task
         if (!parameter.isInput && !pipeline.tasks.some((task) => task.resultingParameterName === parameter.name)) {
-            throw new PipelineLogicError(spaceTrim$1((block) => `
+            throw new PipelineLogicError(spaceTrim$2((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -2376,14 +2310,14 @@ function validatePipeline_InnerFunction(pipeline) {
     // Note: Checking each task individually
     for (const task of pipeline.tasks) {
         if (definedParameters.has(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1((block) => `
+            throw new PipelineLogicError(spaceTrim$2((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
         }
         if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim$1((block) => `
+            throw new PipelineLogicError(spaceTrim$2((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -2393,7 +2327,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
             if (!task.format &&
                 !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                throw new PipelineLogicError(spaceTrim$1((block) => `
+                throw new PipelineLogicError(spaceTrim$2((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -2401,7 +2335,7 @@ function validatePipeline_InnerFunction(pipeline) {
             }
             for (const joker of task.jokerParameterNames) {
                 if (!task.dependentParameterNames.includes(joker)) {
-                    throw new PipelineLogicError(spaceTrim$1((block) => `
+                    throw new PipelineLogicError(spaceTrim$2((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -2412,21 +2346,21 @@ function validatePipeline_InnerFunction(pipeline) {
         if (task.expectations) {
             for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                 if (min !== undefined && max !== undefined && min > max) {
-                    throw new PipelineLogicError(spaceTrim$1((block) => `
+                    throw new PipelineLogicError(spaceTrim$2((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                 }
                 if (min !== undefined && min < 0) {
-                    throw new PipelineLogicError(spaceTrim$1((block) => `
+                    throw new PipelineLogicError(spaceTrim$2((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                 }
                 if (max !== undefined && max <= 0) {
-                    throw new PipelineLogicError(spaceTrim$1((block) => `
+                    throw new PipelineLogicError(spaceTrim$2((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -2448,7 +2382,7 @@ function validatePipeline_InnerFunction(pipeline) {
     while (unresovedTasks.length > 0) {
         if (loopLimit-- < 0) {
             // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -2458,7 +2392,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (currentlyResovedTasks.length === 0) {
             throw new PipelineLogicError(
             // TODO: [🐎] DRY
-            spaceTrim$1((block) => `
+            spaceTrim$2((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -2622,7 +2556,7 @@ class SimplePipelineCollection {
         for (const pipeline of pipelines) {
             // TODO: [👠] DRY
             if (pipeline.pipelineUrl === undefined) {
-                throw new PipelineUrlError(spaceTrim$1(`
+                throw new PipelineUrlError(spaceTrim$2(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -2644,7 +2578,7 @@ class SimplePipelineCollection {
                 pipelineJsonToString(unpreparePipeline(pipeline)) !==
                     pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                 const existing = this.collection.get(pipeline.pipelineUrl);
-                throw new PipelineUrlError(spaceTrim$1(`
+                throw new PipelineUrlError(spaceTrim$2(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -2676,13 +2610,13 @@ class SimplePipelineCollection {
         const pipeline = this.collection.get(url);
         if (!pipeline) {
             if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim$1(`
+                throw new NotFoundError(spaceTrim$2(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
             }
-            throw new NotFoundError(spaceTrim$1((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -2723,7 +2657,7 @@ function createPipelineCollectionFromJson(...promptbooks) {
  */
 class MissingToolsError extends Error {
     constructor(message) {
-        super(spaceTrim$1((block) => `
+        super(spaceTrim$2((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -2830,6 +2764,22 @@ class CollectionError extends Error {
     }
 }
 
+/**
+ * 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
  *
@@ -2905,7 +2855,7 @@ class NotAllowed extends Error {
  */
 class NotYetImplementedError extends Error {
     constructor(message) {
-        super(spaceTrim$1((block) => `
+        super(spaceTrim$2((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -2924,6 +2874,7 @@ class NotYetImplementedError extends Error {
 /**
  * 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
@@ -2933,6 +2884,7 @@ 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
  */
 
@@ -2993,6 +2945,7 @@ const PROMPTBOOK_ERRORS = {
     UnexpectedError,
     WrappedError,
     NotAllowed,
+    DatabaseError,
     // TODO: [🪑]> VersionMismatchError,
 };
 /**
@@ -3040,7 +2993,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim((block) => `
+        console.error(spaceTrim$1((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -3073,7 +3026,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$1(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -3087,7 +3040,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim((block) => `
+        throw new Error(spaceTrim$1((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -3140,7 +3093,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim((block) => `
+        message = spaceTrim$1((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -3177,11 +3130,11 @@ function assertsTaskSuccessful(executionResult) {
         throw deserializeError(errors[0]);
     }
     else {
-        throw new PipelineExecutionError(spaceTrim$1((block) => `
+        throw new PipelineExecutionError(spaceTrim$2((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim$1((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$2((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -3652,14 +3605,14 @@ class MultipleLlmExecutionTools {
             if (description === undefined) {
                 return headLine;
             }
-            return spaceTrim((block) => `
+            return spaceTrim$1((block) => `
                         ${headLine}
 
                           ${ /* <- Note: Indenting the description: */block(description)}
                     `);
         })
             .join('\n\n');
-        return spaceTrim((block) => `
+        return spaceTrim$1((block) => `
                 Multiple LLM Providers:
 
                 ${block(innerModelsTitlesAndDescriptions)}
@@ -3750,7 +3703,7 @@ class MultipleLlmExecutionTools {
             //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     3) ...
-            spaceTrim((block) => `
+            spaceTrim$1((block) => `
                           All execution tools of ${this.title} failed:
 
                           ${block(errors
@@ -3763,7 +3716,7 @@ class MultipleLlmExecutionTools {
             throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$1((block) => `
                           You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}" into ${this.title}
 
                           Available \`LlmExecutionTools\`:
@@ -3796,7 +3749,7 @@ class MultipleLlmExecutionTools {
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
     if (llmExecutionTools.length === 0) {
-        const warningMessage = spaceTrim(`
+        const warningMessage = spaceTrim$1(`
             You have not provided any \`LlmExecutionTools\`
             This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.
 
@@ -3829,6 +3782,7 @@ function joinLlmExecutionTools(title, ...llmExecutionTools) {
     return new MultipleLlmExecutionTools(title || 'Multiple LLM Providers joined by `joinLlmExecutionTools`', ...llmExecutionTools);
 }
 /**
+ * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */
 
@@ -3845,6 +3799,7 @@ function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools) {
     return llmTools;
 }
 /**
+ * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */
 
@@ -4049,14 +4004,14 @@ function $registeredScrapersMessage(availableScrapers) {
         return { ...metadata, isMetadataAviailable, isInstalled, isAvailableInTools };
     });
     if (metadata.length === 0) {
-        return spaceTrim(`
+        return spaceTrim$1(`
             **No scrapers are available**
 
             This is a unexpected behavior, you are probably using some broken version of Promptbook
             At least there should be available the metadata of the scrapers
         `);
     }
-    return spaceTrim((block) => `
+    return spaceTrim$1((block) => `
             Available scrapers are:
             ${block(metadata
         .map(({ packageName, className, isMetadataAviailable, isInstalled, mimeTypes, isAvailableInBrowser, isAvailableInTools, }, i) => {
@@ -4558,7 +4513,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         else if (urlOrRequest instanceof Request) {
             url = urlOrRequest.url;
         }
-        throw new PromptbookFetchError(spaceTrim((block) => `
+        throw new PromptbookFetchError(spaceTrim$1((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -4719,7 +4674,7 @@ async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         const fileExtension = getFileExtension(filename);
         const mimeType = extensionToMimeType(fileExtension || '');
         if (!(await isFileExisting(filename, tools.fs))) {
-            throw new NotFoundError(spaceTrim((block) => `
+            throw new NotFoundError(spaceTrim$1((block) => `
                           Can not make source handler for file which does not exist:
 
                           File:
@@ -4812,7 +4767,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                     // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                     break;
                 }
-                console.warn(spaceTrim((block) => `
+                console.warn(spaceTrim$1((block) => `
                             Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
 
                             The source:
@@ -4828,7 +4783,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             if (partialPieces === null) {
-                throw new KnowledgeScrapeError(spaceTrim((block) => `
+                throw new KnowledgeScrapeError(spaceTrim$1((block) => `
                             Cannot scrape knowledge
 
                             The source:
@@ -4907,7 +4862,7 @@ async function prepareTasks(pipeline, tools, options) {
         if (task.taskType === 'PROMPT_TASK' &&
             knowledgePiecesCount > 0 &&
             !dependentParameterNames.includes('knowledge')) {
-            preparedContent = spaceTrim$1(`
+            preparedContent = spaceTrim$2(`
                     {content}
 
                     ## Knowledge
@@ -5220,7 +5175,7 @@ function extractVariablesFromJavascript(script) {
     }
     catch (error) {
         assertsError(error);
-        throw new ParseError(spaceTrim$1((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -5403,7 +5358,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -5448,7 +5403,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$1((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -5658,7 +5613,7 @@ function mapAvailableToExpectedParameters(options) {
     }
     // Phase 2️⃣: Non-matching mapping
     if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim((block) => `
+        throw new PipelineExecutionError(spaceTrim$1((block) => `
                     Can not map available parameters to expected parameters
 
                     Mapped parameters:
@@ -5776,18 +5731,6 @@ function templateParameters(template, parameters) {
     return replacedTemplates;
 }
 
-/**
- * Logs an LLM call with the given report.
- *
- * @private internal utility of `createPipelineExecutor`
- */
-function logLlmCall(logLlmCall, report) {
-    logLlmCall({
-        modelName: 'model' /* <- TODO: How to get model name from the report */,
-        report,
-    });
-}
-
 /**
  * Extracts all code blocks from markdown.
  *
@@ -6106,7 +6049,7 @@ function validatePromptResult(options) {
                     }
                     catch (error) {
                         keepUnused(error);
-                        throw new ExpectError(spaceTrim$1((block) => `
+                        throw new ExpectError(spaceTrim$2((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -6155,7 +6098,7 @@ function validatePromptResult(options) {
  */
 async function executeAttempts(options) {
     const { jokerParameterNames, priority, maxAttempts, // <- Note: [💂]
-    preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, logLlmCall: logLlmCall$1, } = options;
+    preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, logLlmCall, } = options;
     const $ongoingTaskResult = {
         $result: null,
         $resultString: null,
@@ -6169,7 +6112,7 @@ async function executeAttempts(options) {
         const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
         // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
         if (isJokerAttempt && !jokerParameterName) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -6180,7 +6123,7 @@ async function executeAttempts(options) {
         $ongoingTaskResult.$expectError = null;
         if (isJokerAttempt) {
             if (parameters[jokerParameterName] === undefined) {
-                throw new PipelineExecutionError(spaceTrim$1((block) => `
+                throw new PipelineExecutionError(spaceTrim$2((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -6238,7 +6181,7 @@ async function executeAttempts(options) {
                                     $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                     break variant;
                                 case 'EMBEDDING':
-                                    throw new PipelineExecutionError(spaceTrim$1((block) => `
+                                    throw new PipelineExecutionError(spaceTrim$2((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -6249,7 +6192,7 @@ async function executeAttempts(options) {
                                     break variant;
                                 // <- case [🤖]:
                                 default:
-                                    throw new PipelineExecutionError(spaceTrim$1((block) => `
+                                    throw new PipelineExecutionError(spaceTrim$2((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -6260,14 +6203,14 @@ async function executeAttempts(options) {
                         break;
                     case 'SCRIPT_TASK':
                         if (arrayableToArray(tools.script).length === 0) {
-                            throw new PipelineExecutionError(spaceTrim$1((block) => `
+                            throw new PipelineExecutionError(spaceTrim$2((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                         }
                         if (!task.contentLanguage) {
-                            throw new PipelineExecutionError(spaceTrim$1((block) => `
+                            throw new PipelineExecutionError(spaceTrim$2((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -6298,7 +6241,7 @@ async function executeAttempts(options) {
                             throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                         }
                         else {
-                            throw new PipelineExecutionError(spaceTrim$1((block) => `
+                            throw new PipelineExecutionError(spaceTrim$2((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -6312,7 +6255,7 @@ async function executeAttempts(options) {
                         break taskType;
                     case 'DIALOG_TASK':
                         if (tools.userInterface === undefined) {
-                            throw new PipelineExecutionError(spaceTrim$1((block) => `
+                            throw new PipelineExecutionError(spaceTrim$2((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -6330,7 +6273,7 @@ async function executeAttempts(options) {
                         break taskType;
                     // <- case: [🅱]
                     default:
-                        throw new PipelineExecutionError(spaceTrim$1((block) => `
+                        throw new PipelineExecutionError(spaceTrim$2((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -6417,15 +6360,18 @@ async function executeAttempts(options) {
                         : serializeError($ongoingTaskResult.$expectError),
                 };
                 $executionReport.promptExecutions.push(executionPromptReport);
-                if (logLlmCall$1) {
-                    logLlmCall(logLlmCall$1, executionPromptReport);
+                if (logLlmCall) {
+                    logLlmCall({
+                        modelName: 'model' /* <- TODO: How to get model name from the report */,
+                        report: executionPromptReport,
+                    });
                 }
             }
         }
         if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
             // Note: Create a summary of all failures
             const failuresSummary = $ongoingTaskResult.$failedResults
-                .map((failure) => spaceTrim$1((block) => {
+                .map((failure) => spaceTrim$2((block) => {
                 var _a, _b;
                 return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -6435,14 +6381,14 @@ async function executeAttempts(options) {
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim$1(failure.result)
+                    : spaceTrim$2(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
             }))
                 .join('\n\n---\n\n');
-            throw new PipelineExecutionError(spaceTrim$1((block) => {
+            throw new PipelineExecutionError(spaceTrim$2((block) => {
                 var _a;
                 return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -6462,7 +6408,7 @@ async function executeAttempts(options) {
         }
     }
     if ($ongoingTaskResult.$resultString === null) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -6489,7 +6435,7 @@ async function executeFormatSubvalues(options) {
         return /* not await */ executeAttempts({ ...options, logLlmCall });
     }
     if (jokerParameterNames.length !== 0) {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     JOKER parameters are not supported together with FOREACH command
 
                     [🧞‍♀️] This should be prevented in \`validatePipeline\`
@@ -6502,7 +6448,7 @@ async function executeFormatSubvalues(options) {
     if (formatDefinition === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim((block) => `
+        spaceTrim$1((block) => `
                     Unsupported format "${task.foreach.formatName}"
 
                     Available formats:
@@ -6519,7 +6465,7 @@ async function executeFormatSubvalues(options) {
     if (subvalueParser === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim((block) => `
+        spaceTrim$1((block) => `
                     Unsupported subformat name "${task.foreach.subformatName}" for format "${task.foreach.formatName}"
 
                     Available subformat names for format "${formatDefinition.formatName}":
@@ -6559,7 +6505,7 @@ async function executeFormatSubvalues(options) {
                 if (!(error instanceof PipelineExecutionError)) {
                     throw error;
                 }
-                const highLevelError = new PipelineExecutionError(spaceTrim((block) => `
+                const highLevelError = new PipelineExecutionError(spaceTrim$1((block) => `
                             ${error.message}
 
                             This is error in FOREACH command when mapping ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -6583,7 +6529,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim((block) => `
+                    pipelineIdentification: spaceTrim$1((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -6592,7 +6538,7 @@ async function executeFormatSubvalues(options) {
             }
             catch (error) {
                 if (length > BIG_DATASET_TRESHOLD) {
-                    console.error(spaceTrim((block) => `
+                    console.error(spaceTrim$1((block) => `
                               ${error.message}
 
                               This is error in FOREACH command when processing ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -6692,7 +6638,7 @@ async function getKnowledgeForTask(options) {
             },
             content: task.content,
             parameters,
-        };
+        }; /* <- Note: [🤛] */
         const taskEmbeddingResult = await llmTools.callEmbeddingModel(taskEmbeddingPrompt);
         const knowledgePiecesWithRelevance = preparedPipeline.knowledgePieces.map((knowledgePiece) => {
             const { index } = knowledgePiece;
@@ -6768,7 +6714,7 @@ async function getReservedParametersForTask(options) {
     // Note: Doublecheck that ALL reserved parameters are defined:
     for (const parameterName of RESERVED_PARAMETER_NAMES) {
         if (reservedParameters[parameterName] === undefined) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -6794,7 +6740,7 @@ async function executeTask(options) {
     const dependentParameterNames = new Set(currentTask.dependentParameterNames);
     // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
     if (difference(union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)), new Set(RESERVED_PARAMETER_NAMES)).size !== 0) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -6838,7 +6784,7 @@ async function executeTask(options) {
         else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
             // Houston, we have a problem
             // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -6907,7 +6853,7 @@ function filterJustOutputParameters(options) {
     for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
         if (parametersToPass[parameter.name] === undefined) {
             // [4]
-            $warnings.push(new PipelineExecutionError(spaceTrim$1((block) => `
+            $warnings.push(new PipelineExecutionError(spaceTrim$2((block) => `
                             Parameter \`{${parameter.name}}\` should be an output parameter, but it was not generated during pipeline execution
 
                             Note: This is a warning which happened after the pipeline was executed, and \`{${parameter.name}}\` was not for some reason defined in output parameters
@@ -7015,7 +6961,7 @@ async function executePipeline(options) {
     for (const parameterName of Object.keys(inputParameters)) {
         const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
         if (parameter === undefined) {
-            warnings.push(new PipelineExecutionError(spaceTrim$1((block) => `
+            warnings.push(new PipelineExecutionError(spaceTrim$2((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -7030,7 +6976,7 @@ async function executePipeline(options) {
             // TODO: [🧠] This should be also non-critical error
             return exportJson({
                 name: 'pipelineExecutorResult',
-                message: spaceTrim$1((block) => `
+                message: spaceTrim$2((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -7039,7 +6985,7 @@ async function executePipeline(options) {
                 value: {
                     isSuccessful: false,
                     errors: [
-                        new PipelineExecutionError(spaceTrim$1((block) => `
+                        new PipelineExecutionError(spaceTrim$2((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -7066,7 +7012,7 @@ async function executePipeline(options) {
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                throw new UnexpectedError(spaceTrim$1((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -7076,7 +7022,7 @@ async function executePipeline(options) {
             if (!currentTask && resolving.length === 0) {
                 throw new UnexpectedError(
                 // TODO: [🐎] DRY
-                spaceTrim$1((block) => `
+                spaceTrim$2((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -7116,7 +7062,7 @@ async function executePipeline(options) {
                     tools,
                     onProgress(newOngoingResult) {
                         if (isReturned) {
-                            throw new UnexpectedError(spaceTrim$1((block) => `
+                            throw new UnexpectedError(spaceTrim$2((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -7133,7 +7079,7 @@ async function executePipeline(options) {
                     },
                     logLlmCall,
                     $executionReport: executionReport,
-                    pipelineIdentification: spaceTrim$1((block) => `
+                    pipelineIdentification: spaceTrim$2((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -7242,7 +7188,7 @@ function createPipelineExecutor(options) {
         preparedPipeline = pipeline;
     }
     else if (isNotPreparedWarningSuppressed !== true) {
-        console.warn(spaceTrim$1((block) => `
+        console.warn(spaceTrim$2((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -7267,7 +7213,7 @@ function createPipelineExecutor(options) {
             tools,
             onProgress,
             logLlmCall,
-            pipelineIdentification: spaceTrim$1((block) => `
+            pipelineIdentification: spaceTrim$2((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -7598,7 +7544,7 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for ACTION commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines specific actions or capabilities that the agent can perform.
@@ -7677,7 +7623,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for DELETE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # DELETE (CANCEL, DISCARD, REMOVE)
 
             A commitment to remove or disregard certain information or context. This can be useful for overriding previous commitments or removing unwanted behaviors.
@@ -7793,7 +7739,7 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for FORMAT commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines the specific output structure and formatting for responses (data formats, templates, structure).
@@ -7868,7 +7814,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for GOAL commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
@@ -7964,7 +7910,7 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for KNOWLEDGE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Adds specific knowledge, facts, or context to the agent using a RAG (Retrieval-Augmented Generation) approach for external sources.
@@ -8081,7 +8027,7 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for MEMORY commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Similar to KNOWLEDGE but focuses on remembering past interactions and user preferences. This commitment helps the agent maintain context about the user's history, preferences, and previous conversations.
@@ -8183,7 +8129,7 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for MESSAGE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Contains 1:1 text of the message which AI assistant already sent during the conversation. Later messages are later in the conversation. It is similar to EXAMPLE but it is not example, it is the real message which AI assistant already sent.
@@ -8301,7 +8247,7 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for META commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # META
 
             Sets meta-information about the agent that is used for display and attribution purposes.
@@ -8437,7 +8383,7 @@ class ModelCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for MODEL commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Enforces technical parameters for the AI model, ensuring consistent behavior across different execution environments.
@@ -8672,7 +8618,7 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for NOTE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Adds comments for documentation without changing agent behavior.
@@ -8774,7 +8720,7 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for PERSONA commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines who the agent is, their background, expertise, and personality traits.
@@ -8900,7 +8846,7 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for RULE/RULES commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Adds behavioral constraints and guidelines that the agent must follow.
@@ -8976,7 +8922,7 @@ class SampleCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for SAMPLE/EXAMPLE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Provides examples of how the agent should respond or behave in certain situations.
@@ -9053,7 +8999,7 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for SCENARIO commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines a specific situation or context in which the AI assistant should operate. It helps to set the scene for the AI's responses. Later scenarios are more important than earlier scenarios.
@@ -9169,7 +9115,7 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation for STYLE commitment.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             Defines how the agent should format and present its responses (tone, writing style, formatting).
@@ -9238,7 +9184,7 @@ class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
      * Markdown documentation available at runtime.
      */
     get documentation() {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             # ${this.type}
 
             This commitment is not yet fully implemented.
@@ -9412,7 +9358,7 @@ function parseAgentSourceWithCommitments(agentSource) {
                     const fullContent = currentCommitment.contentLines.join('\n');
                     commitments.push({
                         type: currentCommitment.type,
-                        content: spaceTrim$1(fullContent),
+                        content: spaceTrim$2(fullContent),
                         originalLine: currentCommitment.originalStartLine,
                         lineNumber: currentCommitment.startLineNumber,
                     });
@@ -9448,7 +9394,7 @@ function parseAgentSourceWithCommitments(agentSource) {
         const fullContent = currentCommitment.contentLines.join('\n');
         commitments.push({
             type: currentCommitment.type,
-            content: spaceTrim$1(fullContent),
+            content: spaceTrim$2(fullContent),
             originalLine: currentCommitment.originalStartLine,
             lineNumber: currentCommitment.startLineNumber,
         });
@@ -9762,7 +9708,7 @@ function parseAgentSource(agentSource) {
         // Parse META commitments - format is "META TYPE content"
         const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
         const metaType = normalizeTo_camelCase(metaTypeRaw);
-        meta[metaType] = spaceTrim(commitment.content.substring(metaTypeRaw.length));
+        meta[metaType] = spaceTrim$1(commitment.content.substring(metaTypeRaw.length));
     }
     // Generate gravatar fallback if no meta image specified
     if (!meta.image) {
@@ -9932,17 +9878,213 @@ function validateBook(source) {
 /**
  * Default book
  *
+ * @deprecated Use `$generateBookBoilerplate` instead
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_BOOK = padBook(validateBook(spaceTrim(`
+const DEFAULT_BOOK = padBook(validateBook(spaceTrim$1(`
             AI Avatar
 
             PERSONA A friendly AI assistant that helps you with your tasks
         `)));
 // <- Note: Not using book`...` notation to avoid strange error in jest unit tests `TypeError: (0 , book_notation_1.book) is not a function`
-// <- TODO: !!! GENESIS_BOOK
+// <- TODO: !!! `GENESIS_BOOK` / `ADAM_BOOK` in `/agents/adam.book`
 //                  <- !!! Buttons into genesis book
-// <- TODO: !!! createBookBoilerplate and deprecate `DEFAULT_BOOK`
+// <- TODO: !!! generateBookBoilerplate and deprecate `DEFAULT_BOOK`
+
+/**
+ * Trims string from all 4 sides
+ *
+ * Note: This is a re-exported function from the `spacetrim` package which is
+ *       Developed by same author @hejny as this package
+ *
+ * @public exported from `@promptbook/utils`
+ * @see https://github.com/hejny/spacetrim#usage
+ */
+const spaceTrim = spaceTrim$2;
+
+/**
+ * Agent collection stored in Supabase table
+ *
+ * Note: This object can work both from Node.js and browser environment depending on the Supabase client provided
+ *
+ * @public exported from `@promptbook/core`
+ * <- TODO: !!! Move to `@promptbook/supabase` package
+ */
+class AgentCollectionInSupabase /* TODO: !!!! implements AgentCollection */ {
+    /**
+     * @param rootPath - path to the directory with agents
+     * @param tools - Execution tools to be used in !!! `Agent` itself and listing the agents
+     * @param options - Options for the collection creation
+     */
+    constructor(supabaseClient, 
+    /// TODO: !!! Remove> private readonly tools?: Pick<ExecutionTools, 'llm' | 'fs' | 'scrapers'>,
+    options) {
+        this.supabaseClient = supabaseClient;
+        this.options = options;
+        const { isVerbose = DEFAULT_IS_VERBOSE } = options || {};
+        if (isVerbose) {
+            console.info(`Creating pipeline collection from supabase...`);
+        }
+    }
+    /**
+     * Cached defined execution tools
+     */
+    // !!! private _definedTools: ExecutionTools | null = null;
+    /*
+    TODO: !!! Use or remove
+    /**
+     * Gets or creates execution tools for the collection
+     * /
+    private async getTools(): Promise<ExecutionTools> {
+        if (this._definedTools !== null) {
+            return this._definedTools;
+        }
+
+        this._definedTools = {
+            ...(this.tools === undefined || this.tools.fs === undefined ? await $provideExecutionToolsForNode() : {}),
+            ...this.tools,
+        };
+        return this._definedTools;
+    }
+    // <- TODO: [👪] Maybe create some common abstraction *(or parent abstract class)*
+    */
+    /**
+     * Gets all agents in the collection
+     */
+    async listAgents( /* TODO: [🧠] Allow to pass some condition here */) {
+        const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
+        const result = await this.supabaseClient
+            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+            .select('agentProfile');
+        if (result.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                
+                        Error fetching agents from Supabase:
+                        
+                        ${block(result.error.message)}
+                    `));
+        }
+        if (isVerbose) {
+            console.info(`Found ${result.data.length} agents in directory`);
+        }
+        return result.data.map((row) => row.agentProfile);
+    }
+    /**
+     * !!!
+     * /
+    public async spawnAgent(agentName: string_agent_name): Promise<Agent> {
+   
+        // <- TODO: !!! ENOENT: no such file or directory, open 'C:\Users\me\work\ai\promptbook\agents\examples\Asistent pro LŠVP.book
+        const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
+        const tools = await this.getTools();
+
+        const agentSourceValue = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
+        const agentSource = new BehaviorSubject(agentSourceValue);
+
+        // Note: Write file whenever agent source changes
+        agentSource.subscribe(async (newSource) => {
+            if (isVerbose) {
+                console.info(colors.cyan(`Writing agent source to file ${agentSourcePath}`));
+            }
+            await forTime(500); // <- TODO: [🙌] !!! Remove
+            await tools.fs!.writeFile(agentSourcePath, newSource, 'utf-8');
+        });
+
+        // Note: Watch file for external changes
+        for await (const event of tools.fs!.watch(agentSourcePath)) {
+            // <- TODO: !!!! Solve the memory freeing when the watching is no longer needed
+
+            if (event.eventType !== 'change') {
+                continue;
+            }
+
+            if (isVerbose) {
+                console.info(
+                    colors.cyan(`Detected external change in agent source file ${agentSourcePath}, reloading`),
+                );
+            }
+            await forTime(500); // <- TODO: [🙌] !!! Remove
+            const newSource = validateBook(await tools.fs!.readFile(agentSourcePath, 'utf-8'));
+            agentSource.next(newSource);
+        }
+
+        // TODO: [🙌] !!!! Debug the infinite loop when file is changed externally and agent source is updated which causes file to be written again
+
+        const agent = new Agent({
+            ...this.options,
+            agentSource,
+            executionTools: this.tools || {},
+        });
+
+        if (isVerbose) {
+            console.info(colors.cyan(`Created agent "${agent.agentName}" from source file ${agentSourcePath}`));
+        }
+
+        return agent;
+        * /
+    }
+    */
+    /**
+     * !!!@@@
+     */
+    async getAgentSource(agentName) {
+        const result = await this.supabaseClient
+            .from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */)
+            .select('agentSource')
+            .eq('agentName', agentName)
+            .single();
+        if (result.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                
+                        Error fetching agent "${agentName}" from Supabase:
+                        
+                        ${block(result.error.message)}
+                    `));
+            // <- TODO: !!! First check if the error is "not found" and throw `NotFoundError` instead then throw `DatabaseError`
+        }
+        const agentSource = new BehaviorSubject(result.data.agentSource);
+        // <- TODO: !!!! Dynamic updates
+        return agentSource;
+    }
+    /**
+     * Creates a new agent in the collection
+     *
+     * Note: You can set 'PARENT' in the agent source to inherit from another agent in the collection.
+     */
+    async createAgent(agentSource) {
+        const agentProfile = parseAgentSource(agentSource);
+        //     <- TODO: [🕛]
+        const result = await this.supabaseClient.from('AgentCollection' /* <- TODO: !!!! Change to `Agent` */).insert({
+            agentName: agentProfile.agentName || '!!!!!' /* <- TODO: !!!! Remove */,
+            agentProfile,
+            createdAt: new Date().toISOString(),
+            updatedAt: null,
+            agentVersion: 0,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            usage: ZERO_USAGE,
+            agentSource: agentSource,
+        });
+        if (result.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                        Error creating agent "${agentProfile.agentName}" in Supabase:
+                        
+                        ${block(result.error.message)}
+                    `));
+        }
+        return agentProfile;
+    }
+    /**
+     * Deletes an agent from the collection
+     */
+    async deleteAgent(agentName) {
+        throw new NotYetImplementedError('Method not implemented.');
+    }
+}
+/**
+ * TODO: !!!! Implement it here correctly and update JSDoc comments here, and on interface + other implementations
+ * TODO: Write unit test
+ * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
+ */
 
 /**
  * Constructs `PipelineCollection` from async sources
@@ -10041,7 +10183,7 @@ function createPipelineSubcollection(collection, predicate) {
     }
     async function getPipelineByUrl(url) {
         if (!predicate(url)) {
-            throw new NotFoundError(await spaceTrim$1(async (block) => `
+            throw new NotFoundError(await spaceTrim$2(async (block) => `
                         Promptbook with url "${url}" not found or not accessible
 
                         Available promptbooks:
@@ -10160,7 +10302,7 @@ const knowledgeCommandParser = {
      */
     parse(input) {
         const { args } = input;
-        const knowledgeSourceContent = spaceTrim(args[0] || '');
+        const knowledgeSourceContent = spaceTrim$1(args[0] || '');
         if (knowledgeSourceContent === '') {
             throw new ParseError(`Source is not defined`);
         }
@@ -10304,7 +10446,7 @@ const sectionCommandParser = {
         normalized = normalized.split('DIALOGUE').join('DIALOG');
         const taskTypes = SectionTypes.filter((sectionType) => normalized.includes(sectionType.split('_TASK').join('')));
         if (taskTypes.length !== 1) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown section type "${normalized}"
 
                         Supported section types are:
@@ -10324,7 +10466,7 @@ const sectionCommandParser = {
      */
     $applyToTaskJson(command, $taskJson, $pipelineJson) {
         if ($taskJson.isSectionTypeSet === true) {
-            throw new ParseError(spaceTrim(`
+            throw new ParseError(spaceTrim$1(`
                     Section type is already defined in the section.
                     It can be defined only once.
                 `));
@@ -10673,7 +10815,7 @@ const expectCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim(`
+    description: spaceTrim$1(`
         Expect command describes the desired output of the task *(after post-processing)*
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -10747,7 +10889,7 @@ const expectCommandParser = {
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
                         `));
@@ -10881,7 +11023,7 @@ function validateParameterName(parameterName) {
         if (!(error instanceof ParseError)) {
             throw error;
         }
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     ${block(error.message)}
 
                     Tried to validate parameter name:
@@ -10940,7 +11082,7 @@ const foreachCommandParser = {
         const assignSign = args[3];
         const formatDefinition = FORMAT_DEFINITIONS.find((formatDefinition) => [formatDefinition.formatName, ...(formatDefinition.aliases || [])].includes(formatName));
         if (formatDefinition === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported format "${formatName}"
 
                         Available formats:
@@ -10952,7 +11094,7 @@ const foreachCommandParser = {
         }
         const subvalueParser = formatDefinition.subvalueParsers.find((subvalueParser) => [subvalueParser.subvalueName, ...(subvalueParser.aliases || [])].includes(subformatName));
         if (subvalueParser === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unsupported subformat name "${subformatName}" for format "${formatName}"
 
                         Available subformat names for format "${formatDefinition.formatName}":
@@ -11000,7 +11142,7 @@ const foreachCommandParser = {
                 outputSubparameterName = 'newLine';
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$1(`
                         FOREACH ${formatName} ${subformatName} must specify output subparameter
 
                         Correct example:
@@ -11076,7 +11218,7 @@ const formatCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim(`
+    description: spaceTrim$1(`
         Format command describes the desired output of the task (after post-processing)
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -11448,7 +11590,7 @@ const formfactorCommandParser = {
         const formfactorNameCandidate = args[0].toUpperCase();
         const formfactor = FORMFACTOR_DEFINITIONS.find((definition) => [definition.name, ...{ aliasNames: [], ...definition }.aliasNames].includes(formfactorNameCandidate));
         if (formfactor === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Unknown formfactor name "${formfactorNameCandidate}"
 
                         Available formfactors:
@@ -11467,7 +11609,7 @@ const formfactorCommandParser = {
      */
     $applyToPipelineJson(command, $pipelineJson) {
         if ($pipelineJson.formfactorName !== undefined && $pipelineJson.formfactorName !== command.formfactorName) {
-            throw new ParseError(spaceTrim(`
+            throw new ParseError(spaceTrim$1(`
                     Redefinition of \`FORMFACTOR\` in the pipeline head
 
                     You have used:
@@ -11610,7 +11752,7 @@ const modelCommandParser = {
      */
     parse(input) {
         const { args, normalized } = input;
-        const availableVariantsMessage = spaceTrim((block) => `
+        const availableVariantsMessage = spaceTrim$1((block) => `
               Available variants are:
               ${block(MODEL_VARIANTS.map((variantName) => `- ${variantName}${variantName !== 'EMBEDDING' ? '' : ' (Not available in pipeline)'}`).join('\n'))}
           `);
@@ -11632,14 +11774,14 @@ const modelCommandParser = {
                 // <- Note: [🤖]
             }
             else if (normalized.startsWith('MODEL_VARIANT_EMBED')) {
-                spaceTrim((block) => `
+                spaceTrim$1((block) => `
                         Embedding model can not be used in pipeline
 
                         ${block(availableVariantsMessage)}
                     `);
             }
             else {
-                throw new ParseError(spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1((block) => `
                             Unknown model variant in command:
 
                             ${block(availableVariantsMessage)}
@@ -11654,7 +11796,7 @@ const modelCommandParser = {
             };
         }
         else {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                     Unknown model key in command.
 
                     Supported model keys are:
@@ -11681,7 +11823,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$1(`
                         Redefinition of \`MODEL ${command.key}\` in the pipeline head
 
                         You have used:
@@ -11713,7 +11855,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$1(`
                               Redefinition of MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}"
 
                               You have used:
@@ -11723,7 +11865,7 @@ const modelCommandParser = {
             }
         }
         if (command.value === ($pipelineJson.defaultModelRequirements || {})[command.key]) {
-            console.log(spaceTrim(`
+            console.log(spaceTrim$1(`
                     Setting MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}" to the same value as in the pipeline head
 
                     In pipeline head:
@@ -11806,7 +11948,7 @@ const parameterCommandParser = {
         // <- TODO: When [🥶] fixed, change to:
         //        >   const parameterDescriptionRaw = rawArgs.split(parameterNameRaw).join('').trim();
         if (parameterDescriptionRaw && parameterDescriptionRaw.match(/\{(?<embeddedParameterName>[a-z0-9_]+)\}/im)) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1((block) => `
                         Parameter \`{${parameterNameRaw}}\` can not contain another parameter in description
 
                         The description:
@@ -11988,7 +12130,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
         persona.description = personaDescription;
         return;
     }
-    console.warn(spaceTrim(`
+    console.warn(spaceTrim$1(`
 
             Persona "${personaName}" is defined multiple times with different description:
 
@@ -11999,7 +12141,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
             ${personaDescription}
 
         `));
-    persona.description += spaceTrim('\n\n' + personaDescription);
+    persona.description += spaceTrim$1('\n\n' + personaDescription);
 }
 
 /**
@@ -12364,7 +12506,7 @@ const COMMANDS = [
 function getParserForCommand(command) {
     const commandParser = COMMANDS.find((commandParser) => commandParser.name === command.type);
     if (commandParser === undefined) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Command ${command.type} parser is not found
 
                     ${block(JSON.stringify(command, null, 4)
@@ -12440,7 +12582,7 @@ function parseCommand(raw, usagePlace) {
         .map(removeMarkdownFormatting)
         .map((item) => item.trim());
     if (items.length === 0 || items[0] === '') {
-        throw new ParseError(spaceTrim$1((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                         Malformed command:
                         - ${raw}
 
@@ -12476,7 +12618,7 @@ function parseCommand(raw, usagePlace) {
             return command;
         }
     }
-    throw new ParseError(spaceTrim$1((block) => `
+    throw new ParseError(spaceTrim$2((block) => `
                   Malformed or unknown command:
                   - ${raw}
 
@@ -12527,7 +12669,7 @@ function parseCommandVariant(input) {
                 if (!(error instanceof ParseError)) {
                     throw error;
                 }
-                throw new ParseError(spaceTrim$1((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                               Invalid ${commandName} command:
 
                               Your command:
@@ -12801,7 +12943,7 @@ const SUPPORTED_SCRIPT_LANGUAGES = ['javascript', 'typescript', 'python'];
  * @public exported from `@promptbook/markdown-utils`
  */
 function removeMarkdownComments(content) {
-    return spaceTrim$1(content.replace(/<!--(.*?)-->/gs, ''));
+    return spaceTrim$2(content.replace(/<!--(.*?)-->/gs, ''));
 }
 
 /**
@@ -12812,7 +12954,7 @@ function removeMarkdownComments(content) {
  */
 function isFlatPipeline(pipelineString) {
     pipelineString = removeMarkdownComments(pipelineString);
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
     //const isLastLineReturnStatement = pipelineString.split('\n').pop()!.split('`').join('').startsWith('->');
     const isBacktickBlockUsed = pipelineString.includes('```');
@@ -12838,7 +12980,7 @@ function deflatePipeline(pipelineString) {
     if (!isFlatPipeline(pipelineString)) {
         return pipelineString;
     }
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     const pipelineStringLines = pipelineString.split('\n');
     const potentialReturnStatement = pipelineStringLines.pop();
     let returnStatement;
@@ -12851,19 +12993,19 @@ function deflatePipeline(pipelineString) {
         returnStatement = `-> {${DEFAULT_BOOK_OUTPUT_PARAMETER_NAME}}`;
         pipelineStringLines.push(potentialReturnStatement);
     }
-    const prompt = spaceTrim(pipelineStringLines.join('\n'));
+    const prompt = spaceTrim$1(pipelineStringLines.join('\n'));
     let quotedPrompt;
     if (prompt.split('\n').length <= 1) {
         quotedPrompt = `> ${prompt}`;
     }
     else {
-        quotedPrompt = spaceTrim((block) => `
+        quotedPrompt = spaceTrim$1((block) => `
                 \`\`\`
                 ${block(prompt.split('`').join('\\`'))}
                 \`\`\`
             `);
     }
-    pipelineString = validatePipelineString(spaceTrim((block) => `
+    pipelineString = validatePipelineString(spaceTrim$1((block) => `
                 # ${DEFAULT_BOOK_TITLE}
 
                 ## Prompt
@@ -12927,7 +13069,7 @@ function extractAllListItemsFromMarkdown(markdown) {
 function extractOneBlockFromMarkdown(markdown) {
     const codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     There should be exactly 1 code block in task section, found ${codeBlocks.length} code blocks
 
                     ${block(codeBlocks.map((block, i) => `Block ${i + 1}:\n${block.content}`).join('\n\n\n'))}
@@ -12952,7 +13094,7 @@ function parseMarkdownSection(value) {
     }
     const title = lines[0].replace(/^#+\s*/, '');
     const level = (_b = (_a = lines[0].match(/^#+/)) === null || _a === void 0 ? void 0 : _a[0].length) !== null && _b !== void 0 ? _b : 0;
-    const content = spaceTrim(lines.slice(1).join('\n'));
+    const content = spaceTrim$1(lines.slice(1).join('\n'));
     if (level < 1 || level > 6) {
         throw new ParseError('Markdown section must have heading level between 1 and 6');
     }
@@ -12980,7 +13122,7 @@ function splitMarkdownIntoSections(markdown) {
         if (buffer.length === 0) {
             return;
         }
-        let section = spaceTrim(buffer.join('\n'));
+        let section = spaceTrim$1(buffer.join('\n'));
         if (section === '') {
             return;
         }
@@ -13055,7 +13197,7 @@ function flattenMarkdown(markdown) {
         flattenedMarkdown += `## ${title}` + `\n\n`;
         flattenedMarkdown += content + `\n\n`; // <- [🧠] Maybe 3 new lines?
     }
-    return spaceTrim(flattenedMarkdown);
+    return spaceTrim$1(flattenedMarkdown);
 }
 /**
  * TODO: [🏛] This can be part of markdown builder
@@ -13117,7 +13259,7 @@ function parsePipeline(pipelineString) {
     if (pipelineString.startsWith('#!')) {
         const [shebangLine, ...restLines] = pipelineString.split('\n');
         if (!(shebangLine || '').includes('ptbk')) {
-            throw new ParseError(spaceTrim$1((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         It seems that you try to parse a book file which has non-standard shebang line for book files:
                         Shebang line must contain 'ptbk'
 
@@ -13133,7 +13275,7 @@ function parsePipeline(pipelineString) {
         pipelineString = validatePipelineString(restLines.join('\n'));
     }
     pipelineString = removeMarkdownComments(pipelineString);
-    pipelineString = spaceTrim$1(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     // <- TODO: [😧] `spaceTrim` should preserve discriminated type *(or at lease `PipelineString`)*
     pipelineString = deflatePipeline(pipelineString);
     // ==============
@@ -13145,7 +13287,7 @@ function parsePipeline(pipelineString) {
     // ==============
     // Note: 1️⃣◽4️⃣ Check markdown structure
     if (pipelineHead === undefined) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Pipeline head is not defined
 
                     ${block(getPipelineIdentification())}
@@ -13154,7 +13296,7 @@ function parsePipeline(pipelineString) {
                 `));
     }
     if (pipelineHead.level !== 1) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Pipeline head is not h1
 
                     ${block(getPipelineIdentification())}
@@ -13163,7 +13305,7 @@ function parsePipeline(pipelineString) {
                 `));
     }
     if (!pipelineSections.every((section) => section.level === 2)) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Not every pipeline section is h2
 
                     ${block(getPipelineIdentification())}
@@ -13176,7 +13318,7 @@ function parsePipeline(pipelineString) {
     const defineParam = (parameterCommand) => {
         const { parameterName, parameterDescription, isInput, isOutput } = parameterCommand;
         if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
-            throw new ParseError(spaceTrim$1((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Parameter name {${parameterName}} is reserved and cannot be used as resulting parameter name
 
                         ${block(getPipelineIdentification())}
@@ -13187,7 +13329,7 @@ function parsePipeline(pipelineString) {
             existingParameter.description &&
             existingParameter.description !== parameterDescription &&
             parameterDescription) {
-            throw new ParseError(spaceTrim$1((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Parameter \`{${parameterName}}\` is defined multiple times with different description:
 
                         ${block(getPipelineIdentification())}
@@ -13225,7 +13367,7 @@ function parsePipeline(pipelineString) {
     description = description.split(/^>.*$/gm).join('');
     //Note: Remove lists and return statement - TODO: [🎾] Make util  (exported from `@promptbool/utils`)
     description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-    description = spaceTrim$1(description);
+    description = spaceTrim$2(description);
     if (description === '') {
         description = undefined;
     }
@@ -13236,7 +13378,7 @@ function parsePipeline(pipelineString) {
         const command = parseCommand(listItem, 'PIPELINE_HEAD');
         const commandParser = getParserForCommand(command);
         if (commandParser.isUsedInPipelineHead !== true /* <- Note: [🦦][4] */) {
-            throw new ParseError(spaceTrim$1((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Command \`${command.type}\` is not allowed in the head of the pipeline ONLY at the pipeline task
 
                         ${block(getPipelineIdentification())}
@@ -13250,7 +13392,7 @@ function parsePipeline(pipelineString) {
             if (!(error instanceof ParseError)) {
                 throw error;
             }
-            throw new ParseError(spaceTrim$1((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Command ${command.type} failed to apply to the pipeline
 
                         The error:
@@ -13303,7 +13445,7 @@ function parsePipeline(pipelineString) {
         description = description.split(/^>.*$/gm).join('');
         //Note: Remove lists and return statement - TODO: [🎾]
         description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description = spaceTrim$1(description);
+        description = spaceTrim$2(description);
         if (description === '') {
             description = undefined;
         }
@@ -13337,7 +13479,7 @@ function parsePipeline(pipelineString) {
         for (const { listItem, command } of commands) {
             const commandParser = getParserForCommand(command);
             if (commandParser.isUsedInPipelineTask !== true /* <- Note: [🦦][4] */) {
-                throw new ParseError(spaceTrim$1((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                             Command \`${command.type}\` is not allowed in the task of the promptbook ONLY at the pipeline head
 
                             ${block(getPipelineIdentification())}
@@ -13352,7 +13494,7 @@ function parsePipeline(pipelineString) {
                 if (!(error instanceof ParseError)) {
                     throw error;
                 }
-                throw new ParseError(spaceTrim$1((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                             Command \`${command.type}\` failed to apply to the task
 
                             The error:
@@ -13383,14 +13525,14 @@ function parsePipeline(pipelineString) {
         // TODO: [🍧] Should be done in SECTION command
         if ($taskJson.taskType === 'SCRIPT_TASK') {
             if (!language) {
-                throw new ParseError(spaceTrim$1((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                             You must specify the language of the script in the \`SCRIPT\` task
 
                             ${block(getPipelineIdentification())}
                         `));
             }
             if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                throw new ParseError(spaceTrim$1((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                             Script language ${language} is not supported.
 
                             Supported languages are:
@@ -13552,7 +13694,7 @@ function addAutoGeneratedSection(content, options) {
     const warningLine = `<!-- ${GENERATOR_WARNING} -->`;
     const sectionRegex = new RegExp(`<!--${sectionName}-->([\\s\\S]*?)<!--/${sectionName}-->`, 'g');
     const sectionMatch = content.match(sectionRegex);
-    const contentToInsert = spaceTrim$1((block) => `
+    const contentToInsert = spaceTrim$2((block) => `
             <!--${sectionName}-->
             ${block(warningLine)}
             ${block(sectionContent)}
@@ -13565,7 +13707,7 @@ function addAutoGeneratedSection(content, options) {
     const placeForSection = removeMarkdownComments(content).match(/^##.*$/im);
     if (placeForSection !== null) {
         const [heading] = placeForSection;
-        return content.replace(heading, spaceTrim$1((block) => `
+        return content.replace(heading, spaceTrim$2((block) => `
                     ${block(contentToInsert)}
 
                     ${block(heading)}
@@ -13574,7 +13716,7 @@ function addAutoGeneratedSection(content, options) {
     console.warn(`No place where to put the section <!--${sectionName}-->, using the end of the file`);
     // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
     // <- TODO: [🏮] Some better way how to get warnings from pipeline parsing / logic
-    return spaceTrim$1((block) => `
+    return spaceTrim$2((block) => `
             ${block(content)}
 
             ${block(contentToInsert)}
@@ -13650,7 +13792,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
         .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
         .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
         .join('\n');
-    const promptbookMermaid = spaceTrim$1((block) => `
+    const promptbookMermaid = spaceTrim$2((block) => `
 
             %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
 
@@ -13706,7 +13848,7 @@ async function prettifyPipelineString(pipelineString, options) {
                 return { href: `#${task.name}`, title: task.title };
             },
         });
-        const promptbookMermaidBlock = spaceTrim$1((block) => `
+        const promptbookMermaidBlock = spaceTrim$2((block) => `
                 \`\`\`mermaid
                 ${block(promptbookMermaid)}
                 \`\`\`
@@ -13744,7 +13886,7 @@ class CallbackInterfaceTools {
     async promptDialog(options) {
         const answer = await this.options.callback(options);
         if (this.options.isVerbose) {
-            console.info(spaceTrim$1((block) => `
+            console.info(spaceTrim$2((block) => `
                         📖 ${block(options.promptTitle)}
                         👤 ${block(answer)}
                     `));
@@ -13885,7 +14027,7 @@ function countWorkingDuration(items) {
 function executionReportJsonToString(executionReportJson, options) {
     var _a, _b, _c, _d, _e, _f;
     const { taxRate, chartsWidth } = { ...ExecutionReportStringOptionsDefaults, ...(options || {}) };
-    let executionReportString = spaceTrim$1((block) => `
+    let executionReportString = spaceTrim$2((block) => `
             # ${executionReportJson.title || 'Execution report'}
 
             ${block(executionReportJson.description || '')}
@@ -14007,7 +14149,7 @@ function executionReportJsonToString(executionReportJson, options) {
         if (just(true)) {
             executionReportString +=
                 '\n\n\n\n' +
-                    spaceTrim$1((block) => {
+                    spaceTrim$2((block) => {
                         var _a;
                         return `
 
@@ -14026,7 +14168,7 @@ function executionReportJsonToString(executionReportJson, options) {
                 executionReportString += '*No result*';
             }
             else if (typeof promptExecution.result.content === 'string') {
-                executionReportString += spaceTrim$1((block) => `
+                executionReportString += spaceTrim$2((block) => `
                           \`\`\`
                           ${block(escapeMarkdownBlock(promptExecution.result.content))}
                           \`\`\`
@@ -14039,7 +14181,7 @@ function executionReportJsonToString(executionReportJson, options) {
         if (promptExecution.error && promptExecution.error.message) {
             executionReportString +=
                 '\n\n\n\n' +
-                    spaceTrim$1((block) => `
+                    spaceTrim$2((block) => `
 
                         ### Error
 
@@ -14115,7 +14257,7 @@ function usageToHuman(usage) {
         // Note: For negligible usage, we report at least something
         reportItems.push('Negligible');
     }
-    return spaceTrim((block) => `
+    return spaceTrim$1((block) => `
             Usage:
             ${block(reportItems.map((item) => `- ${item}`).join('\n'))}
         `);
@@ -14357,13 +14499,13 @@ function $registeredLlmToolsMessage() {
     });
     const usedEnvMessage = `Unknown \`.env\` file` ;
     if (metadata.length === 0) {
-        return spaceTrim((block) => `
+        return spaceTrim$1((block) => `
                 No LLM providers are available.
 
                 ${block(usedEnvMessage)}
           `);
     }
-    return spaceTrim((block) => `
+    return spaceTrim$1((block) => `
 
             ${block(usedEnvMessage)}
 
@@ -14409,7 +14551,7 @@ function $registeredLlmToolsMessage() {
                 morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
             }
         }
-        let providerMessage = spaceTrim(`
+        let providerMessage = spaceTrim$1(`
                                 ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
                                     ${morePieces.join('; ')}
                             `);
@@ -14455,7 +14597,7 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
             .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
         if (registeredItem === undefined) {
             // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
-            throw new Error(spaceTrim((block) => `
+            throw new Error(spaceTrim$1((block) => `
                         There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
                         Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
 
@@ -14592,7 +14734,7 @@ function cacheLlmTools(llmTools, options = {}) {
         let normalizedContent = content;
         normalizedContent = normalizedContent.replace(/\s+/g, ' ');
         normalizedContent = normalizedContent.split('\r\n').join('\n');
-        normalizedContent = spaceTrim(normalizedContent);
+        normalizedContent = spaceTrim$1(normalizedContent);
         // Note: Do not need to save everything in the cache, just the relevant parameters
         const relevantParameterNames = extractParameterNames(content);
         const relevantParameters = Object.fromEntries(Object.entries(parameters).filter(([key]) => relevantParameterNames.has(key)));
@@ -14798,66 +14940,6 @@ function asUpdatableSubject(value) {
  * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
  */
 
-/**
- * Represents one AI Agent
- *
- * Note: [🦖] There are several different things in Promptbook:
- * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
- * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
- * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
- * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
- *
- * @public exported from `@promptbook/core`
- */
-class Agent {
-    /**
-     * Not used in Agent, always returns empty array
-     */
-    get parameters() {
-        return [
-        /* [😰] */
-        ];
-    }
-    constructor(options) {
-        this.options = options;
-        /**
-         * Name of the agent
-         */
-        this.agentName = null;
-        /**
-         * Description of the agent
-         */
-        this.personaDescription = null;
-        /**
-         * Metadata like image or color
-         */
-        this.meta = {};
-        this.agentSource = asUpdatableSubject(options.agentSource);
-        this.agentSource.subscribe((source) => {
-            const { agentName, personaDescription, meta } = parseAgentSource(source);
-            this.agentName = agentName;
-            this.personaDescription = personaDescription;
-            this.meta = { ...this.meta, ...meta };
-        });
-    }
-    /**
-     * Creates LlmExecutionTools which exposes the agent as a model
-     */
-    getLlmExecutionTools() {
-        const llmTools = new AgentLlmExecutionTools({
-            llmTools: getSingleLlmExecutionTools(this.options.executionTools.llm),
-            agentSource: this.agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
-        });
-        // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
-        // TODO: !!!! Add `Agent` learning by promptbookAgent
-        return llmTools;
-    }
-}
-/**
- * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- * TODO: !!! Agent on remote server
- */
-
 /**
  * Change ellipsis character to three dots `…` -> `...`
  *
@@ -15047,7 +15129,7 @@ function pricing(value) {
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2025-11-19
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/
@@ -15057,11 +15139,21 @@ const OPENAI_MODELS = exportJson({
     name: 'OPENAI_MODELS',
     value: [
         /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-5.1',
+            modelName: 'gpt-5.1',
+            modelDescription: 'The best model for coding and agentic tasks with configurable reasoning effort.',
+            pricing: {
+                prompt: pricing(`$1.25 / 1M tokens`),
+                output: pricing(`$10.00 / 1M tokens`),
+            },
+        },
         {
             modelVariant: 'CHAT',
             modelTitle: 'gpt-5',
             modelName: 'gpt-5',
-            modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities.",
+            modelDescription: "OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window. Features revolutionary improvements in complex problem-solving, scientific reasoning, and creative tasks. Demonstrates human-level performance across diverse domains with enhanced safety measures and alignment. Represents the next generation of AI with superior understanding, nuanced responses, and advanced multimodal capabilities. DEPRECATED: Use gpt-5.1 instead.",
             pricing: {
                 prompt: pricing(`$1.25 / 1M tokens`),
                 output: pricing(`$10.00 / 1M tokens`),
@@ -16259,7 +16351,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((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:
@@ -16622,11 +16714,11 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
         if (!this.isCreatingNewAssistantsAllowed) {
             throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
         }
-        await this.playground();
+        // await this.playground();
         const { name, instructions } = options;
         const client = await this.getClient();
-        /*
-        TODO: !!!
+        /*/
+        //TODO: !!!
         async function downloadFile(url: string, folder = './tmp'): Promise<string> {
             const filename = path.basename(url.split('?')[0]);
             const filepath = path.join(folder, filename);
@@ -16670,8 +16762,8 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             const file = await uploadFileToOpenAI(filepath);
             uploadedFiles.push(file.id);
         }
-        */
-        alert('!!!! Creating new OpenAI assistant');
+        /**/
+        // alert('!!!! Creating new OpenAI assistant');
         // 3️⃣ Create assistant with uploaded files
         const assistant = await client.beta.assistants.create({
             name,
@@ -16832,15 +16924,27 @@ class AgentLlmExecutionTools {
         const chatPrompt = prompt;
         let underlyingLlmResult;
         if (OpenAiAssistantExecutionTools.isOpenAiAssistantExecutionTools(this.options.llmTools)) {
+            if (this.options.isVerbose) {
+                console.log(`Creating new OpenAI Assistant for agent ${this.title}...`);
+            }
             // <- TODO: !!! Check also `isCreatingNewAssistantsAllowed` and warn about it
             const assistant = await this.options.llmTools.createNewAssistant({
                 name: this.title,
                 instructions: modelRequirements.systemMessage,
+                /*
+                !!!
+                metadata: {
+                    agentModelName: this.modelName,
+                }
+                */
             });
             // <- TODO: !!! Cache the assistant in prepareCache
             underlyingLlmResult = await assistant.callChatModel(chatPrompt);
         }
         else {
+            if (this.options.isVerbose) {
+                console.log(`Creating Assistant ${this.title} on generic LLM execution tools...`);
+            }
             // Create modified chat prompt with agent system message
             const modifiedChatPrompt = {
                 ...chatPrompt,
@@ -16874,6 +16978,67 @@ class AgentLlmExecutionTools {
  * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
  */
 
+/**
+ * Represents one AI Agent
+ *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ *
+ * @public exported from `@promptbook/core`
+ */
+class Agent {
+    /**
+     * Not used in Agent, always returns empty array
+     */
+    get parameters() {
+        return [
+        /* [😰] */
+        ];
+    }
+    constructor(options) {
+        this.options = options;
+        /**
+         * Name of the agent
+         */
+        this.agentName = null;
+        /**
+         * Description of the agent
+         */
+        this.personaDescription = null;
+        /**
+         * Metadata like image or color
+         */
+        this.meta = {};
+        this.agentSource = asUpdatableSubject(options.agentSource);
+        this.agentSource.subscribe((source) => {
+            const { agentName, personaDescription, meta } = parseAgentSource(source);
+            this.agentName = agentName;
+            this.personaDescription = personaDescription;
+            this.meta = { ...this.meta, ...meta };
+        });
+    }
+    /**
+     * Creates LlmExecutionTools which exposes the agent as a model
+     */
+    getLlmExecutionTools() {
+        const llmTools = new AgentLlmExecutionTools({
+            isVerbose: this.options.isVerbose,
+            llmTools: getSingleLlmExecutionTools(this.options.executionTools.llm),
+            agentSource: this.agentSource.value, // <- TODO: !!!! Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+        });
+        // TODO: !!!! Add `Agent` simple "mocked" learning by appending to agent source
+        // TODO: !!!! Add `Agent` learning by promptbookAgent
+        return llmTools;
+    }
+}
+/**
+ * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+ * TODO: !!! Agent on remote server
+ */
+
 /**
  * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
  *
@@ -17440,7 +17605,7 @@ function isValidPipelineString(pipelineString) {
  */
 function prompt(strings, ...values) {
     if (values.length === 0) {
-        return spaceTrim(strings.join(''));
+        return spaceTrim$1(strings.join(''));
     }
     const stringsWithHiddenParameters = strings.map((stringsItem) => 
     // TODO: [0] DRY
@@ -17451,7 +17616,7 @@ function prompt(strings, ...values) {
     let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
         ? `${result}${stringsItem}`
         : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
     try {
         pipelineString = templateParameters(pipelineString, parameters);
     }
@@ -17460,7 +17625,7 @@ function prompt(strings, ...values) {
             throw error;
         }
         console.error({ pipelineString, parameters, placeholderParameterNames, error });
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     Internal error in prompt template literal
                   
                     ${block(JSON.stringify({ strings, values }, null, 4))}}
@@ -17497,7 +17662,7 @@ function book(strings, ...values) {
     const bookString = prompt(strings, ...values);
     if (!isValidPipelineString(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$1(`
                 The string is not a valid pipeline string
 
                 book\`
@@ -17507,7 +17672,7 @@ function book(strings, ...values) {
     }
     if (!isValidBook(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$1(`
                 The string is not a valid book
 
                 book\`
@@ -17929,7 +18094,7 @@ const OpenAiSdkTranspiler = {
         });
         const KNOWLEDGE_THRESHOLD = 1000;
         if (directKnowledge.join('\n').length > KNOWLEDGE_THRESHOLD || knowledgeSources.length > 0) {
-            return spaceTrim((block) => `
+            return spaceTrim$1((block) => `
                     #!/usr/bin/env node
 
                     import * as dotenv from 'dotenv';
@@ -17994,7 +18159,7 @@ const OpenAiSdkTranspiler = {
                         }
 
                         const userMessage = spaceTrim(\`
-                            ${block(spaceTrim(`
+                            ${block(spaceTrim$1(`
                                     Here is some additional context to help you answer the question:
                                     \${context}
 
@@ -18039,7 +18204,7 @@ const OpenAiSdkTranspiler = {
                     })();
                 `);
         }
-        const source = spaceTrim((block) => `
+        const source = spaceTrim$1((block) => `
 
                 #!/usr/bin/env node
 
@@ -18106,6 +18271,25 @@ const OpenAiSdkTranspiler = {
     },
 };
 
+/**
+ * Returns information about the current runtime environment
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environments
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function $detectRuntimeEnvironment() {
+    return {
+        isRunningInBrowser: $isRunningInBrowser(),
+        isRunningInJest: $isRunningInJest(),
+        isRunningInNode: $isRunningInNode(),
+        isRunningInWebWorker: $isRunningInWebWorker(),
+    };
+}
+/**
+ * TODO: [🎺] Also detect and report node version here
+ */
+
 /**
  * Provide information about Promptbook, engine version, book language version, servers, ...
  *
@@ -18115,9 +18299,9 @@ const OpenAiSdkTranspiler = {
  * @public exported from `@promptbook/core`
  */
 function aboutPromptbookInformation(options) {
-    const { isServersInfoIncluded = true } = options || {};
+    const { isServersInfoIncluded = true, isRuntimeEnvironmentInfoIncluded = true } = options || {};
     const fullInfoPieces = [];
-    const basicInfo = spaceTrim(`
+    const basicInfo = spaceTrim$1(`
 
             # ${NAME}
 
@@ -18129,7 +18313,7 @@ function aboutPromptbookInformation(options) {
         `);
     fullInfoPieces.push(basicInfo);
     if (isServersInfoIncluded) {
-        const serversInfo = spaceTrim((block) => `
+        const serversInfo = spaceTrim$1((block) => `
 
                 ## Servers
 
@@ -18139,12 +18323,160 @@ function aboutPromptbookInformation(options) {
             `);
         fullInfoPieces.push(serversInfo);
     }
-    const fullInfo = spaceTrim(fullInfoPieces.join('\n\n'));
+    if (isRuntimeEnvironmentInfoIncluded) {
+        const runtimeEnvironment = $detectRuntimeEnvironment();
+        const environmentInfoRecord = {
+            ...runtimeEnvironment,
+            isCostPrevented: IS_COST_PREVENTED,
+        };
+        const environmentInfo = spaceTrim$1((block) => `
+
+                ## Environment
+
+                ${block(Object.entries(environmentInfoRecord)
+            .map(([key, value]) => `- **${key}:** ${valueToString(value)}`)
+            .join('\n'))}
+            `);
+        fullInfoPieces.push(environmentInfo);
+    }
+    const fullInfo = spaceTrim$1(fullInfoPieces.join('\n\n'));
     return fullInfo;
 }
 /**
  * TODO: [🗽] Unite branding and make single place for it
  */
 
-export { $bookTranspilersRegister, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
+/**
+ * Pick random item from the received array
+ *
+ * @private internal helper function
+ */
+function $randomItem(...items) {
+    if (items.length === 0) {
+        throw new Error(`Not enough items`);
+    }
+    return items[Math.floor(Math.random( /* <- TODO: [🐉] Probably use seed random */) * items.length)];
+}
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */
+
+const FIRSTNAMES = [
+    'Paul',
+    'George',
+    'Adam',
+    'Lucy',
+    'Sophia',
+    'Emma',
+    'Olivia',
+    'Noah',
+    'Liam',
+    'Ethan',
+    'Ava',
+    'Mia',
+    'Isabella',
+    'James',
+    'Benjamin',
+    'Elijah',
+    'Sophia',
+    'Charlotte',
+    'Amelia',
+    'Harper',
+    'Alexander',
+    'William',
+    'Michael',
+    'Daniel',
+    'Matthew',
+    'Joseph',
+    'David',
+    'Samuel',
+    'Henry',
+    'Jack',
+    'Sebastian',
+    'Gabriel',
+    'Anthony',
+    'Christopher',
+];
+const LASTNAMES_WITH_COLORS = [
+    { lastname: 'Green', color: '#008000' },
+    { lastname: 'Brown', color: '#A52A2A' },
+    { lastname: 'Black', color: '#000000' },
+    { lastname: 'White', color: '#FFFFFF' },
+    { lastname: 'Gray', color: '#808080' },
+    { lastname: 'Blue', color: '#0000FF' },
+];
+/**
+ *
+ * @private internal helper function
+ */
+function $randomFullnameWithColor() {
+    const firstname = $randomItem(...FIRSTNAMES);
+    const { lastname, color } = $randomItem(...LASTNAMES_WITH_COLORS);
+    return {
+        fullname: `${firstname} ${lastname}`,
+        color,
+    };
+}
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */
+
+const PERSONALITIES = [
+    'Friendly and helpful AI agent.',
+    'Professional and efficient virtual assistant.',
+    'Creative and imaginative digital companion.',
+    'Knowledgeable and informative AI guide.',
+    'Empathetic and understanding support bot.',
+    'Energetic and enthusiastic conversational partner.',
+    'Calm and patient virtual helper.',
+    'Curious and inquisitive AI explorer.',
+    'Witty and humorous digital friend.',
+    'Serious and focused AI consultant.',
+];
+/**
+ * @@@@
+ *
+ * @private internal helper function
+ */
+function $randomAgentPersona() {
+    return $randomItem(...PERSONALITIES);
+}
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */
+
+/**
+ * Generates boilerplate for a new agent book
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
+ * Note: This function is using cryptographically secure components internally
+ *
+ * @public exported from `@promptbook/core`
+ */
+function $generateBookBoilerplate(options) {
+    // eslint-disable-next-line prefer-const
+    let { agentName, parentAgentName = 'Adam', personaDescription, meta } = options || {};
+    // eslint-disable-next-line prefer-const
+    let { image, color, ...restMeta } = meta || {};
+    if (!agentName) {
+        const randomFullnameWithColor = $randomFullnameWithColor();
+        agentName = randomFullnameWithColor.fullname;
+        color = color || randomFullnameWithColor.color;
+    }
+    if (!personaDescription) {
+        personaDescription = $randomAgentPersona();
+    }
+    const agentSource = validateBook(spaceTrim$1((block) => `
+                ${agentName}
+    
+                META COLOR ${color || '#3498db' /* <- TODO: !!!! Best default color */}
+                PERSONA ${block(personaDescription)}
+            `));
+    return agentSource;
+}
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */
+
+export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map