@promptbook/core 0.103.0-42 → 0.103.0-43

package/umd/index.umd.js

@@ -1,16 +1,16 @@
 (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';
+    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('colors'), require('moment'), 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', 'colors', 'moment', 'bottleneck', 'openai'], factory) :
+    (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.colors, global.moment, global.Bottleneck, global.OpenAI));
+})(this, (function (exports, spaceTrim$1, crypto, rxjs, waitasecond, hexEncoder, sha256, path, cryptoJs, mimeTypes, papaparse, colors, moment, 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);
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
+    var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
     var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-42';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-43';
     /**
      * 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,19 @@
         }
     }
 
+    /**
+     * 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);
+        }
+    }
+
     /**
      * This error type indicates that you try to use a feature that is not available in the current environment
      *
@@ -2906,7 +2853,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 +2872,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
@@ -2994,6 +2942,7 @@
         UnexpectedError,
         WrappedError,
         NotAllowed,
+        DatabaseError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -3178,11 +3127,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)}
                                     `))
@@ -4908,7 +4857,7 @@
             if (task.taskType === 'PROMPT_TASK' &&
                 knowledgePiecesCount > 0 &&
                 !dependentParameterNames.includes('knowledge')) {
-                preparedContent = spaceTrim.spaceTrim(`
+                preparedContent = spaceTrim$1.spaceTrim(`
                     {content}
 
                     ## Knowledge
@@ -5221,7 +5170,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 +5726,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 +6044,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 +6093,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 +6107,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 +6118,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 +6176,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 +6187,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 +6198,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 +6236,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 +6250,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 +6268,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 +6355,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 +6376,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 +6403,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 +6633,7 @@
                 },
                 content: task.content,
                 parameters,
-            };
+            }; /* <- Note: [🤛] */
             const taskEmbeddingResult = await llmTools.callEmbeddingModel(taskEmbeddingPrompt);
             const knowledgePiecesWithRelevance = preparedPipeline.knowledgePieces.map((knowledgePiece) => {
                 const { index } = knowledgePiece;
@@ -6769,7 +6709,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 +6735,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 +6779,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 +6848,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 +6956,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 +6971,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 +6980,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 +7007,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 +7017,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 +7057,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 +7074,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 +7183,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 +7208,7 @@
                 tools,
                 onProgress,
                 logLlmCall,
-                pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -7599,7 +7539,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 +7618,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 +7734,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 +7809,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 +7905,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 +8022,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 +8124,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 +8242,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 +8378,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 +8613,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 +8715,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 +8841,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 +8917,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 +8994,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 +9110,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 +9179,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 +9353,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 +9389,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 +9873,7 @@
     /**
      * Default book
      *
+     * @deprecated Use `$generateBookBoilerplate` instead
      * @public exported from `@promptbook/core`
      */
     const DEFAULT_BOOK = padBook(validateBook(spaceTrim__default["default"](`
@@ -9941,9 +9882,180 @@
             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 {
+        /**
+         * @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, tools, options) {
+            this.supabaseClient = supabaseClient;
+            this.tools = tools;
+            this.options = options;
+            /**
+             * Cached defined execution tools
+             */
+            this._definedTools = null;
+            const { isVerbose = exports.DEFAULT_IS_VERBOSE } = options || {};
+            if (isVerbose) {
+                console.info(colors__default["default"].cyan(`Creating pipeline collection from supabase`));
+            }
+        }
+        /*
+        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);
+        }
+        /**
+         * !!!
+         */
+        async spawnAgent(agentName) {
+            throw new NotYetImplementedError('Method not implemented.');
+            /*
+            // <- 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;
+            */
+        }
+        /**
+         * 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: Write unit test
+     * TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention
+     */
 
     /**
      * Constructs `PipelineCollection` from async sources
@@ -10042,7 +10154,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 +12477,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 +12553,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 +12589,7 @@
                 return command;
             }
         }
-        throw new ParseError(spaceTrim.spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                   Malformed or unknown command:
                   - ${raw}
 
@@ -12528,7 +12640,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 +12914,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 +13230,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 +13246,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 +13258,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 +13267,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 +13276,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 +13289,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 +13300,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 +13338,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 +13349,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 +13363,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 +13416,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 +13450,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 +13465,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 +13496,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 +13665,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 +13678,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 +13687,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 +13763,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 +13819,7 @@
                     return { href: `#${task.name}`, title: task.title };
                 },
             });
-            const promptbookMermaidBlock = spaceTrim.spaceTrim((block) => `
+            const promptbookMermaidBlock = spaceTrim$1.spaceTrim((block) => `
                 \`\`\`mermaid
                 ${block(promptbookMermaid)}
                 \`\`\`
@@ -13745,7 +13857,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 +13998,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 +14120,7 @@
             if (just(true)) {
                 executionReportString +=
                     '\n\n\n\n' +
-                        spaceTrim.spaceTrim((block) => {
+                        spaceTrim$1.spaceTrim((block) => {
                             var _a;
                             return `
 
@@ -14027,7 +14139,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 +14152,7 @@
             if (promptExecution.error && promptExecution.error.message) {
                 executionReportString +=
                     '\n\n\n\n' +
-                        spaceTrim.spaceTrim((block) => `
+                        spaceTrim$1.spaceTrim((block) => `
 
                         ### Error
 
@@ -14799,66 +14911,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 `…` -> `...`
      *
@@ -16875,6 +16927,66 @@
      * 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({
+                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 +18219,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 +18247,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 +18271,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 +18294,34 @@
      * TODO: [🗽] Unite branding and make single place for it
      */
 
+    /**
+     * 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 || {};
+        if (!agentName) {
+            agentName = 'Agent ' + $randomToken(20);
+            // <- TODO: !!! Supercool random name generator
+        }
+        if (!personaDescription) {
+            personaDescription = 'Friendly and helpful AI agent.';
+        }
+        const agentSource = validateBook(spaceTrim__default["default"]((block) => `
+                ${agentName}
+    
+                PERSONA ${block(personaDescription)}
+            `));
+        return agentSource;
+    }
+
     exports.$bookTranspilersRegister = $bookTranspilersRegister;
+    exports.$generateBookBoilerplate = $generateBookBoilerplate;
     exports.$llmToolsMetadataRegister = $llmToolsMetadataRegister;
     exports.$llmToolsRegister = $llmToolsRegister;
     exports.$scrapersMetadataRegister = $scrapersMetadataRegister;
@@ -18157,6 +18331,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 +18370,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;