@promptbook/core 0.103.0-42 → 0.103.0-44

package/umd/index.umd.js

@@ -1,12 +1,12 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('rxjs'), require('waitasecond'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('path'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('colors'), require('bottleneck'), require('openai')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'rxjs', 'waitasecond', 'crypto-js/enc-hex', 'crypto-js/sha256', 'path', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'colors', 'bottleneck', 'openai'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
-})(this, (function (exports, spaceTrim, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim$1, global.crypto, global.rxjs, global.waitasecond, global.hexEncoder, global.sha256, global.path, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.colors, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, spaceTrim$1, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, moment, colors, Bottleneck, OpenAI) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
@@ -21,14 +21,14 @@
      * @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
@@ -842,6 +842,23 @@
      * 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
      *
@@ -957,102 +974,6 @@
      * 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
      *
@@ -1462,6 +1383,19 @@
     /**/
     // 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
@@ -1518,7 +1452,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1544,7 +1478,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim.spaceTrim(`
+            super(spaceTrim$1.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -2257,7 +2191,7 @@
                 if (!(error instanceof PipelineLogicError)) {
                     throw error;
                 }
-                console.error(spaceTrim.spaceTrim((block) => `
+                console.error(spaceTrim$1.spaceTrim((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -2284,7 +2218,7 @@
         })();
         if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -2292,7 +2226,7 @@
         }
         if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -2301,7 +2235,7 @@
         // 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.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -2312,7 +2246,7 @@
         // 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.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -2338,7 +2272,7 @@
         // Note: Check each parameter individually
         for (const parameter of pipeline.parameters) {
             if (parameter.isInput && parameter.isOutput) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -2349,7 +2283,7 @@
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -2361,7 +2295,7 @@
             }
             // 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.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -2377,14 +2311,14 @@
         // Note: Checking each task individually
         for (const task of pipeline.tasks) {
             if (definedParameters.has(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
             }
             if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -2394,7 +2328,7 @@
             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.spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -2402,7 +2336,7 @@
                 }
                 for (const joker of task.jokerParameterNames) {
                     if (!task.dependentParameterNames.includes(joker)) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -2413,21 +2347,21 @@
             if (task.expectations) {
                 for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                     if (min !== undefined && max !== undefined && min > max) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (min !== undefined && min < 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (max !== undefined && max <= 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -2449,7 +2383,7 @@
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -2459,7 +2393,7 @@
             if (currentlyResovedTasks.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim((block) => `
+                spaceTrim$1.spaceTrim((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -2623,7 +2557,7 @@
             for (const pipeline of pipelines) {
                 // TODO: [👠] DRY
                 if (pipeline.pipelineUrl === undefined) {
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -2645,7 +2579,7 @@
                     pipelineJsonToString(unpreparePipeline(pipeline)) !==
                         pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                     const existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -2677,13 +2611,13 @@
             const pipeline = this.collection.get(url);
             if (!pipeline) {
                 if (this.listPipelines().length === 0) {
-                    throw new NotFoundError(spaceTrim.spaceTrim(`
+                    throw new NotFoundError(spaceTrim$1.spaceTrim(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
                 }
-                throw new NotFoundError(spaceTrim.spaceTrim((block) => `
+                throw new NotFoundError(spaceTrim$1.spaceTrim((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -2724,7 +2658,7 @@
      */
     class MissingToolsError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -2831,6 +2765,22 @@
         }
     }
 
+    /**
+     * 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
      *
@@ -2906,7 +2856,7 @@
      */
     class NotYetImplementedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -2925,6 +2875,7 @@
     /**
      * 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
@@ -2934,6 +2885,7 @@
         return crypto.randomBytes(randomness).toString('hex');
     }
     /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
      * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
      */
 
@@ -2994,6 +2946,7 @@
         UnexpectedError,
         WrappedError,
         NotAllowed,
+        DatabaseError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -3178,11 +3131,11 @@
             throw deserializeError(errors[0]);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim.spaceTrim((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$1.spaceTrim((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -3830,6 +3783,7 @@
         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
      */
 
@@ -3846,6 +3800,7 @@
         return llmTools;
     }
     /**
+     * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
@@ -4908,7 +4863,7 @@
             if (task.taskType === 'PROMPT_TASK' &&
                 knowledgePiecesCount > 0 &&
                 !dependentParameterNames.includes('knowledge')) {
-                preparedContent = spaceTrim.spaceTrim(`
+                preparedContent = spaceTrim$1.spaceTrim(`
                     {content}
 
                     ## Knowledge
@@ -5221,7 +5176,7 @@
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -5777,18 +5732,6 @@
         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.
      *
@@ -6107,7 +6050,7 @@
                         }
                         catch (error) {
                             keepUnused(error);
-                            throw new ExpectError(spaceTrim.spaceTrim((block) => `
+                            throw new ExpectError(spaceTrim$1.spaceTrim((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -6156,7 +6099,7 @@
      */
     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,
@@ -6170,7 +6113,7 @@
             const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
             // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
             if (isJokerAttempt && !jokerParameterName) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -6181,7 +6124,7 @@
             $ongoingTaskResult.$expectError = null;
             if (isJokerAttempt) {
                 if (parameters[jokerParameterName] === undefined) {
-                    throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -6239,7 +6182,7 @@
                                         $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                         break variant;
                                     case 'EMBEDDING':
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -6250,7 +6193,7 @@
                                         break variant;
                                     // <- case [🤖]:
                                     default:
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -6261,14 +6204,14 @@
                             break;
                         case 'SCRIPT_TASK':
                             if (arrayableToArray(tools.script).length === 0) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                             }
                             if (!task.contentLanguage) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -6299,7 +6242,7 @@
                                 throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                             }
                             else {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -6313,7 +6256,7 @@
                             break taskType;
                         case 'DIALOG_TASK':
                             if (tools.userInterface === undefined) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -6331,7 +6274,7 @@
                             break taskType;
                         // <- case: [🅱]
                         default:
-                            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -6418,15 +6361,18 @@
                             : 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.spaceTrim((block) => {
+                    .map((failure) => spaceTrim$1.spaceTrim((block) => {
                     var _a, _b;
                     return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -6436,14 +6382,14 @@
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim.spaceTrim(failure.result)
+                    : spaceTrim$1.spaceTrim(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
                 }))
                     .join('\n\n---\n\n');
-                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => {
                     var _a;
                     return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -6463,7 +6409,7 @@
             }
         }
         if ($ongoingTaskResult.$resultString === null) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -6693,7 +6639,7 @@
                 },
                 content: task.content,
                 parameters,
-            };
+            }; /* <- Note: [🤛] */
             const taskEmbeddingResult = await llmTools.callEmbeddingModel(taskEmbeddingPrompt);
             const knowledgePiecesWithRelevance = preparedPipeline.knowledgePieces.map((knowledgePiece) => {
                 const { index } = knowledgePiece;
@@ -6769,7 +6715,7 @@
         // Note: Doublecheck that ALL reserved parameters are defined:
         for (const parameterName of RESERVED_PARAMETER_NAMES) {
             if (reservedParameters[parameterName] === undefined) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -6795,7 +6741,7 @@
         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.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -6839,7 +6785,7 @@
             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.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -6908,7 +6854,7 @@
         for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
             if (parametersToPass[parameter.name] === undefined) {
                 // [4]
-                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                $warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((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
@@ -7016,7 +6962,7 @@
         for (const parameterName of Object.keys(inputParameters)) {
             const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
             if (parameter === undefined) {
-                warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -7031,7 +6977,7 @@
                 // TODO: [🧠] This should be also non-critical error
                 return exportJson({
                     name: 'pipelineExecutorResult',
-                    message: spaceTrim.spaceTrim((block) => `
+                    message: spaceTrim$1.spaceTrim((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -7040,7 +6986,7 @@
                     value: {
                         isSuccessful: false,
                         errors: [
-                            new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -7067,7 +7013,7 @@
             while (unresovedTasks.length > 0) {
                 if (loopLimit-- < 0) {
                     // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                    throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                    throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -7077,7 +7023,7 @@
                 if (!currentTask && resolving.length === 0) {
                     throw new UnexpectedError(
                     // TODO: [🐎] DRY
-                    spaceTrim.spaceTrim((block) => `
+                    spaceTrim$1.spaceTrim((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -7117,7 +7063,7 @@
                         tools,
                         onProgress(newOngoingResult) {
                             if (isReturned) {
-                                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -7134,7 +7080,7 @@
                         },
                         logLlmCall,
                         $executionReport: executionReport,
-                        pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                        pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -7243,7 +7189,7 @@
             preparedPipeline = pipeline;
         }
         else if (isNotPreparedWarningSuppressed !== true) {
-            console.warn(spaceTrim.spaceTrim((block) => `
+            console.warn(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -7268,7 +7214,7 @@
                 tools,
                 onProgress,
                 logLlmCall,
-                pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -7599,7 +7545,7 @@
          * Markdown documentation for ACTION commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines specific actions or capabilities that the agent can perform.
@@ -7678,7 +7624,7 @@
          * Markdown documentation for DELETE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # 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.
@@ -7794,7 +7740,7 @@
          * Markdown documentation for FORMAT commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the specific output structure and formatting for responses (data formats, templates, structure).
@@ -7869,7 +7815,7 @@
          * Markdown documentation for GOAL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${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.
@@ -7965,7 +7911,7 @@
          * Markdown documentation for KNOWLEDGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds specific knowledge, facts, or context to the agent using a RAG (Retrieval-Augmented Generation) approach for external sources.
@@ -8082,7 +8028,7 @@
          * Markdown documentation for MEMORY commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${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.
@@ -8184,7 +8130,7 @@
          * Markdown documentation for MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${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.
@@ -8302,7 +8248,7 @@
          * Markdown documentation for META commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META
 
             Sets meta-information about the agent that is used for display and attribution purposes.
@@ -8438,7 +8384,7 @@
          * Markdown documentation for MODEL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Enforces technical parameters for the AI model, ensuring consistent behavior across different execution environments.
@@ -8673,7 +8619,7 @@
          * Markdown documentation for NOTE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds comments for documentation without changing agent behavior.
@@ -8775,7 +8721,7 @@
          * Markdown documentation for PERSONA commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines who the agent is, their background, expertise, and personality traits.
@@ -8901,7 +8847,7 @@
          * Markdown documentation for RULE/RULES commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds behavioral constraints and guidelines that the agent must follow.
@@ -8977,7 +8923,7 @@
          * Markdown documentation for SAMPLE/EXAMPLE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Provides examples of how the agent should respond or behave in certain situations.
@@ -9054,7 +9000,7 @@
          * Markdown documentation for SCENARIO commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${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.
@@ -9170,7 +9116,7 @@
          * Markdown documentation for STYLE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines how the agent should format and present its responses (tone, writing style, formatting).
@@ -9239,7 +9185,7 @@
          * Markdown documentation available at runtime.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             This commitment is not yet fully implemented.
@@ -9413,7 +9359,7 @@
                         const fullContent = currentCommitment.contentLines.join('\n');
                         commitments.push({
                             type: currentCommitment.type,
-                            content: spaceTrim.spaceTrim(fullContent),
+                            content: spaceTrim$1.spaceTrim(fullContent),
                             originalLine: currentCommitment.originalStartLine,
                             lineNumber: currentCommitment.startLineNumber,
                         });
@@ -9449,7 +9395,7 @@
             const fullContent = currentCommitment.contentLines.join('\n');
             commitments.push({
                 type: currentCommitment.type,
-                content: spaceTrim.spaceTrim(fullContent),
+                content: spaceTrim$1.spaceTrim(fullContent),
                 originalLine: currentCommitment.originalStartLine,
                 lineNumber: currentCommitment.startLineNumber,
             });
@@ -9933,6 +9879,7 @@
     /**
      * Default book
      *
+     * @deprecated Use `$generateBookBoilerplate` instead
      * @public exported from `@promptbook/core`
      */
     const DEFAULT_BOOK = padBook(validateBook(spaceTrim__default["default"](`
@@ -9941,9 +9888,204 @@
             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$1.spaceTrim;
+
+    /**
+     * 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 = exports.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 = exports.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 rxjs.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
@@ -10042,7 +10184,7 @@
         }
         async function getPipelineByUrl(url) {
             if (!predicate(url)) {
-                throw new NotFoundError(await spaceTrim.spaceTrim(async (block) => `
+                throw new NotFoundError(await spaceTrim$1.spaceTrim(async (block) => `
                         Promptbook with url "${url}" not found or not accessible
 
                         Available promptbooks:
@@ -12365,7 +12507,7 @@
     function getParserForCommand(command) {
         const commandParser = COMMANDS.find((commandParser) => commandParser.name === command.type);
         if (commandParser === undefined) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Command ${command.type} parser is not found
 
                     ${block(JSON.stringify(command, null, 4)
@@ -12441,7 +12583,7 @@
             .map(removeMarkdownFormatting)
             .map((item) => item.trim());
         if (items.length === 0 || items[0] === '') {
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Malformed command:
                         - ${raw}
 
@@ -12477,7 +12619,7 @@
                 return command;
             }
         }
-        throw new ParseError(spaceTrim.spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                   Malformed or unknown command:
                   - ${raw}
 
@@ -12528,7 +12670,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                               Invalid ${commandName} command:
 
                               Your command:
@@ -12802,7 +12944,7 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+        return spaceTrim$1.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
@@ -13118,7 +13260,7 @@
         if (pipelineString.startsWith('#!')) {
             const [shebangLine, ...restLines] = pipelineString.split('\n');
             if (!(shebangLine || '').includes('ptbk')) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((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'
 
@@ -13134,7 +13276,7 @@
             pipelineString = validatePipelineString(restLines.join('\n'));
         }
         pipelineString = removeMarkdownComments(pipelineString);
-        pipelineString = spaceTrim.spaceTrim(pipelineString);
+        pipelineString = spaceTrim$1.spaceTrim(pipelineString);
         // <- TODO: [😧] `spaceTrim` should preserve discriminated type *(or at lease `PipelineString`)*
         pipelineString = deflatePipeline(pipelineString);
         // ==============
@@ -13146,7 +13288,7 @@
         // ==============
         // Note: 1️⃣◽4️⃣ Check markdown structure
         if (pipelineHead === undefined) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline head is not defined
 
                     ${block(getPipelineIdentification())}
@@ -13155,7 +13297,7 @@
                 `));
         }
         if (pipelineHead.level !== 1) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline head is not h1
 
                     ${block(getPipelineIdentification())}
@@ -13164,7 +13306,7 @@
                 `));
         }
         if (!pipelineSections.every((section) => section.level === 2)) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Not every pipeline section is h2
 
                     ${block(getPipelineIdentification())}
@@ -13177,7 +13319,7 @@
         const defineParam = (parameterCommand) => {
             const { parameterName, parameterDescription, isInput, isOutput } = parameterCommand;
             if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${parameterName}} is reserved and cannot be used as resulting parameter name
 
                         ${block(getPipelineIdentification())}
@@ -13188,7 +13330,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is defined multiple times with different description:
 
                         ${block(getPipelineIdentification())}
@@ -13226,7 +13368,7 @@
         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.spaceTrim(description);
+        description = spaceTrim$1.spaceTrim(description);
         if (description === '') {
             description = undefined;
         }
@@ -13237,7 +13379,7 @@
             const command = parseCommand(listItem, 'PIPELINE_HEAD');
             const commandParser = getParserForCommand(command);
             if (commandParser.isUsedInPipelineHead !== true /* <- Note: [🦦][4] */) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Command \`${command.type}\` is not allowed in the head of the pipeline ONLY at the pipeline task
 
                         ${block(getPipelineIdentification())}
@@ -13251,7 +13393,7 @@
                 if (!(error instanceof ParseError)) {
                     throw error;
                 }
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Command ${command.type} failed to apply to the pipeline
 
                         The error:
@@ -13304,7 +13446,7 @@
             description = description.split(/^>.*$/gm).join('');
             //Note: Remove lists and return statement - TODO: [🎾]
             description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-            description = spaceTrim.spaceTrim(description);
+            description = spaceTrim$1.spaceTrim(description);
             if (description === '') {
                 description = undefined;
             }
@@ -13338,7 +13480,7 @@
             for (const { listItem, command } of commands) {
                 const commandParser = getParserForCommand(command);
                 if (commandParser.isUsedInPipelineTask !== true /* <- Note: [🦦][4] */) {
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Command \`${command.type}\` is not allowed in the task of the promptbook ONLY at the pipeline head
 
                             ${block(getPipelineIdentification())}
@@ -13353,7 +13495,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Command \`${command.type}\` failed to apply to the task
 
                             The error:
@@ -13384,14 +13526,14 @@
             // TODO: [🍧] Should be done in SECTION command
             if ($taskJson.taskType === 'SCRIPT_TASK') {
                 if (!language) {
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((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.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Script language ${language} is not supported.
 
                             Supported languages are:
@@ -13553,7 +13695,7 @@
         const warningLine = `<!-- ${GENERATOR_WARNING} -->`;
         const sectionRegex = new RegExp(`<!--${sectionName}-->([\\s\\S]*?)<!--/${sectionName}-->`, 'g');
         const sectionMatch = content.match(sectionRegex);
-        const contentToInsert = spaceTrim.spaceTrim((block) => `
+        const contentToInsert = spaceTrim$1.spaceTrim((block) => `
             <!--${sectionName}-->
             ${block(warningLine)}
             ${block(sectionContent)}
@@ -13566,7 +13708,7 @@
         const placeForSection = removeMarkdownComments(content).match(/^##.*$/im);
         if (placeForSection !== null) {
             const [heading] = placeForSection;
-            return content.replace(heading, spaceTrim.spaceTrim((block) => `
+            return content.replace(heading, spaceTrim$1.spaceTrim((block) => `
                     ${block(contentToInsert)}
 
                     ${block(heading)}
@@ -13575,7 +13717,7 @@
         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.spaceTrim((block) => `
+        return spaceTrim$1.spaceTrim((block) => `
             ${block(content)}
 
             ${block(contentToInsert)}
@@ -13651,7 +13793,7 @@
             .filter(([MERMAID_NAME]) => (inputAndIntermediateParametersMermaid + outputParametersMermaid).includes(MERMAID_NAME))
             .map(([MERMAID_NAME, title]) => `${MERMAID_NAME}((${title})):::${MERMAID_NAME}`)
             .join('\n');
-        const promptbookMermaid = spaceTrim.spaceTrim((block) => `
+        const promptbookMermaid = spaceTrim$1.spaceTrim((block) => `
 
             %% 🔮 Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually
 
@@ -13707,7 +13849,7 @@
                     return { href: `#${task.name}`, title: task.title };
                 },
             });
-            const promptbookMermaidBlock = spaceTrim.spaceTrim((block) => `
+            const promptbookMermaidBlock = spaceTrim$1.spaceTrim((block) => `
                 \`\`\`mermaid
                 ${block(promptbookMermaid)}
                 \`\`\`
@@ -13745,7 +13887,7 @@
         async promptDialog(options) {
             const answer = await this.options.callback(options);
             if (this.options.isVerbose) {
-                console.info(spaceTrim.spaceTrim((block) => `
+                console.info(spaceTrim$1.spaceTrim((block) => `
                         📖 ${block(options.promptTitle)}
                         👤 ${block(answer)}
                     `));
@@ -13886,7 +14028,7 @@
     function executionReportJsonToString(executionReportJson, options) {
         var _a, _b, _c, _d, _e, _f;
         const { taxRate, chartsWidth } = { ...ExecutionReportStringOptionsDefaults, ...(options || {}) };
-        let executionReportString = spaceTrim.spaceTrim((block) => `
+        let executionReportString = spaceTrim$1.spaceTrim((block) => `
             # ${executionReportJson.title || 'Execution report'}
 
             ${block(executionReportJson.description || '')}
@@ -14008,7 +14150,7 @@
             if (just(true)) {
                 executionReportString +=
                     '\n\n\n\n' +
-                        spaceTrim.spaceTrim((block) => {
+                        spaceTrim$1.spaceTrim((block) => {
                             var _a;
                             return `
 
@@ -14027,7 +14169,7 @@
                     executionReportString += '*No result*';
                 }
                 else if (typeof promptExecution.result.content === 'string') {
-                    executionReportString += spaceTrim.spaceTrim((block) => `
+                    executionReportString += spaceTrim$1.spaceTrim((block) => `
                           \`\`\`
                           ${block(escapeMarkdownBlock(promptExecution.result.content))}
                           \`\`\`
@@ -14040,7 +14182,7 @@
             if (promptExecution.error && promptExecution.error.message) {
                 executionReportString +=
                     '\n\n\n\n' +
-                        spaceTrim.spaceTrim((block) => `
+                        spaceTrim$1.spaceTrim((block) => `
 
                         ### Error
 
@@ -14799,66 +14941,6 @@
      * 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 `…` -> `...`
      *
@@ -15048,7 +15130,7 @@
     /**
      * 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/
@@ -15058,11 +15140,21 @@
         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`),
@@ -16623,11 +16715,11 @@
             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);
@@ -16671,8 +16763,8 @@
                 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,
@@ -16833,15 +16925,27 @@
             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,
@@ -16875,6 +16979,67 @@
      * 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
      *
@@ -18107,6 +18272,25 @@
         },
     };
 
+    /**
+     * 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, ...
      *
@@ -18116,7 +18300,7 @@
      * @public exported from `@promptbook/core`
      */
     function aboutPromptbookInformation(options) {
-        const { isServersInfoIncluded = true } = options || {};
+        const { isServersInfoIncluded = true, isRuntimeEnvironmentInfoIncluded = true } = options || {};
         const fullInfoPieces = [];
         const basicInfo = spaceTrim__default["default"](`
 
@@ -18140,6 +18324,22 @@
             `);
             fullInfoPieces.push(serversInfo);
         }
+        if (isRuntimeEnvironmentInfoIncluded) {
+            const runtimeEnvironment = $detectRuntimeEnvironment();
+            const environmentInfoRecord = {
+                ...runtimeEnvironment,
+                isCostPrevented: IS_COST_PREVENTED,
+            };
+            const environmentInfo = spaceTrim__default["default"]((block) => `
+
+                ## Environment
+
+                ${block(Object.entries(environmentInfoRecord)
+            .map(([key, value]) => `- **${key}:** ${valueToString(value)}`)
+            .join('\n'))}
+            `);
+            fullInfoPieces.push(environmentInfo);
+        }
         const fullInfo = spaceTrim__default["default"](fullInfoPieces.join('\n\n'));
         return fullInfo;
     }
@@ -18147,7 +18347,140 @@
      * TODO: [🗽] Unite branding and make single place for it
      */
 
+    /**
+     * 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__default["default"]((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
+     */
+
     exports.$bookTranspilersRegister = $bookTranspilersRegister;
+    exports.$generateBookBoilerplate = $generateBookBoilerplate;
     exports.$llmToolsMetadataRegister = $llmToolsMetadataRegister;
     exports.$llmToolsRegister = $llmToolsRegister;
     exports.$scrapersMetadataRegister = $scrapersMetadataRegister;
@@ -18157,6 +18490,7 @@
     exports.API_REQUEST_TIMEOUT = API_REQUEST_TIMEOUT;
     exports.AbstractFormatError = AbstractFormatError;
     exports.Agent = Agent;
+    exports.AgentCollectionInSupabase = AgentCollectionInSupabase;
     exports.AgentLlmExecutionTools = AgentLlmExecutionTools;
     exports.AuthenticationError = AuthenticationError;
     exports.BIG_DATASET_TRESHOLD = BIG_DATASET_TRESHOLD;
@@ -18195,6 +18529,7 @@
     exports.DEFAULT_SCRAPE_CACHE_DIRNAME = DEFAULT_SCRAPE_CACHE_DIRNAME;
     exports.DEFAULT_TASK_SIMULATED_DURATION_MS = DEFAULT_TASK_SIMULATED_DURATION_MS;
     exports.DEFAULT_TASK_TITLE = DEFAULT_TASK_TITLE;
+    exports.DatabaseError = DatabaseError;
     exports.EXPECTATION_UNITS = EXPECTATION_UNITS;
     exports.EnvironmentMismatchError = EnvironmentMismatchError;
     exports.ExecutionReportStringOptionsDefaults = ExecutionReportStringOptionsDefaults;