@promptbook/javascript 0.111.0-7 → 0.112.0-100

package/umd/index.umd.js

@@ -1,12 +1,12 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('path'), require('crypto'), require('crypto-js'), require('crypto-js/enc-hex')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'path', 'crypto', 'crypto-js', 'crypto-js/enc-hex'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-javascript"] = {}, global.spaceTrim$1, null, global.crypto));
-})(this, (function (exports, spaceTrim$1, path, crypto) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-javascript"] = {}, global._spaceTrim, null, global.crypto));
+})(this, (function (exports, _spaceTrim, path, crypto) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
+    var _spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(_spaceTrim);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
     /**
@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-7';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-100';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -32,16 +32,20 @@
      * 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
+     * Developed by same author @hejny as this package
      *
-     * @public exported from `@promptbook/utils`
      * @see https://github.com/hejny/spacetrim#usage
+     *
+     * @public exported from `@promptbook/utils`
      */
-    const spaceTrim = spaceTrim$1.spaceTrim;
+    const spaceTrim = _spaceTrim.spaceTrim;
 
     /**
-     * @private util of `@promptbook/color`
+     * Class implementing take chain.
+     *
      * @de
+     *
+     * @private util of `@promptbook/color`
      */
     class TakeChain {
         constructor(value) {
@@ -58,9 +62,9 @@
      *
      * @param {*} initialValue - The initial value.
      * @returns {Proxy<WithTake<TValue>>} - A proxy object with a `take` method.
+     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      *
      * @private util of `@promptbook/color`
-     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      */
     function take(initialValue) {
         if (initialValue instanceof TakeChain) {
@@ -238,9 +242,7 @@
         yellow: '#ffff00',
         yellowgreen: '#9acd32',
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Validates that a channel value is a valid number within the range of 0 to 255.
@@ -270,7 +272,118 @@
         }
     }
 
+    /**
+     * Shared immutable channel storage and serialization helpers for `Color`.
+     *
+     * @private base class of Color
+     */
+    class ColorValue {
+        constructor(red, green, blue, alpha = 255) {
+            this.red = red;
+            this.green = green;
+            this.blue = blue;
+            this.alpha = alpha;
+            checkChannelValue('Red', red);
+            checkChannelValue('Green', green);
+            checkChannelValue('Blue', blue);
+            checkChannelValue('Alpha', alpha);
+        }
+        /**
+         * Shortcut for `red` property
+         * Number from 0 to 255
+         * @alias red
+         */
+        get r() {
+            return this.red;
+        }
+        /**
+         * Shortcut for `green` property
+         * Number from 0 to 255
+         * @alias green
+         */
+        get g() {
+            return this.green;
+        }
+        /**
+         * Shortcut for `blue` property
+         * Number from 0 to 255
+         * @alias blue
+         */
+        get b() {
+            return this.blue;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get a() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get opacity() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for 1-`alpha` property
+         */
+        get transparency() {
+            return 255 - this.alpha;
+        }
+        clone() {
+            return take(this.createColor(this.red, this.green, this.blue, this.alpha));
+        }
+        toString() {
+            return this.toHex();
+        }
+        toHex() {
+            if (this.alpha === 255) {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}`;
+            }
+            else {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}${this.alpha.toString(16).padStart(2, '0')}`;
+            }
+        }
+        toRgb() {
+            if (this.alpha === 255) {
+                return `rgb(${this.red}, ${this.green}, ${this.blue})`;
+            }
+            else {
+                return `rgba(${this.red}, ${this.green}, ${this.blue}, ${Math.round((this.alpha / 255) * 100)}%)`;
+            }
+        }
+        toHsl() {
+            throw new Error(`Getting HSL is not implemented`);
+        }
+    }
+
+    /**
+     * Checks if the given value is a valid hex color string
+     *
+     * @param value - value to check
+     * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
+     *
+     * @private function of Color
+     */
+    function isHexColorString(value) {
+        return (typeof value === 'string' && /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
+    }
+
+    /**
+     * Constant for short hex lengths.
+     */
     const SHORT_HEX_LENGTHS = new Set([3, 4]);
+    /**
+     * Constant for long hex lengths.
+     */
     const LONG_HEX_LENGTHS = new Set([6, 8]);
     /**
      * Parses a hex string into RGBA channel values.
@@ -303,6 +416,9 @@
         }
         return throwInvalidHex();
     }
+    /**
+     * Parses short hex channel.
+     */
     function parseShortHexChannel(char, onError) {
         if (!char) {
             return onError();
@@ -313,6 +429,9 @@
         }
         return parsed * 16;
     }
+    /**
+     * Parses long hex channel.
+     */
     function parseLongHexChannel(hex, start, onError) {
         const segment = hex.substr(start, 2);
         if (segment.length < 2) {
@@ -325,6 +444,9 @@
         return parsed;
     }
 
+    /**
+     * Pattern matching hsl.
+     */
     const HSL_REGEX = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
     /**
      * Parses an HSL string into RGBA channel values.
@@ -350,6 +472,9 @@
             alpha: 255,
         };
     }
+    /**
+     * Handles convert hsl to Rgb.
+     */
     function convertHslToRgb(h, s, l) {
         const c = (1 - Math.abs(2 * l - 1)) * s;
         const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
@@ -388,7 +513,13 @@
         };
     }
 
+    /**
+     * Pattern matching RGB.
+     */
     const RGB_REGEX = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba.
+     */
     const RGBA_REGEX = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
     /**
      * Parses an RGB string into RGBA channel values.
@@ -430,6 +561,9 @@
             alpha: parseAlphaValue(match[4]),
         };
     }
+    /**
+     * Parses channel value.
+     */
     function parseChannelValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -437,6 +571,9 @@
         }
         return Math.round(parseFloat(value));
     }
+    /**
+     * Parses alpha value.
+     */
     function parseAlphaValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -449,9 +586,55 @@
         return Math.round(parsed);
     }
 
+    /**
+     * Pattern matching hsl regex.
+     *
+     * @private function of Color
+     */
     const HSL_REGEX_PATTERN = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+    /**
+     * Pattern matching RGB regex.
+     *
+     * @private function of Color
+     */
     const RGB_REGEX_PATTERN = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba regex.
+     *
+     * @private function of Color
+     */
     const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Parses a supported color string into RGBA channels.
+     *
+     * @param color as a string for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`, `red`, `darkgrey`,...
+     * @returns RGBA channel values.
+     *
+     * @private function of Color
+     */
+    function parseColorString(color) {
+        const trimmed = color.trim();
+        const cssColor = CSS_COLORS[trimmed];
+        if (cssColor) {
+            return parseColorString(cssColor);
+        }
+        else if (isHexColorString(trimmed)) {
+            return parseHexColor(trimmed);
+        }
+        if (HSL_REGEX_PATTERN.test(trimmed)) {
+            return parseHslColor(trimmed);
+        }
+        else if (RGB_REGEX_PATTERN.test(trimmed)) {
+            return parseRgbColor(trimmed);
+        }
+        else if (RGBA_REGEX_PATTERN.test(trimmed)) {
+            return parseRgbaColor(trimmed);
+        }
+        else {
+            throw new Error(`Can not create a new Color instance from string "${trimmed}".`);
+        }
+    }
+
     /**
      * Color object represents an RGB color with alpha channel
      *
@@ -459,7 +642,7 @@
      *
      * @public exported from `@promptbook/color`
      */
-    class Color {
+    class Color extends ColorValue {
         /**
          * Creates a new Color instance from miscellaneous formats
          * - It can receive Color instance and just return the same instance
@@ -532,25 +715,7 @@
          * @returns Color object
          */
         static fromString(color) {
-            const trimmed = color.trim();
-            if (CSS_COLORS[trimmed]) {
-                return Color.fromString(CSS_COLORS[trimmed]);
-            }
-            else if (Color.isHexColorString(trimmed)) {
-                return Color.fromHex(trimmed);
-            }
-            if (HSL_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromHsl(trimmed);
-            }
-            else if (RGB_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromRgbString(trimmed);
-            }
-            else if (RGBA_REGEX_PATTERN.test(trimmed)) {
-                return Color.fromRgbaString(trimmed);
-            }
-            else {
-                throw new Error(`Can not create a new Color instance from string "${trimmed}".`);
-            }
+            return Color.fromColorChannels(parseColorString(color));
         }
         /**
          * Gets common color
@@ -580,8 +745,7 @@
          * @returns Color object
          */
         static fromHex(hex) {
-            const { red, green, blue, alpha } = parseHexColor(hex);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseHexColor(hex));
         }
         /**
          * Creates a new Color instance from color in hsl format
@@ -590,8 +754,7 @@
          * @returns Color object
          */
         static fromHsl(hsl) {
-            const { red, green, blue, alpha } = parseHslColor(hsl);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseHslColor(hsl));
         }
         /**
          * Creates a new Color instance from color in rgb format
@@ -600,8 +763,7 @@
          * @returns Color object
          */
         static fromRgbString(rgb) {
-            const { red, green, blue, alpha } = parseRgbColor(rgb);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseRgbColor(rgb));
         }
         /**
          * Creates a new Color instance from color in rbga format
@@ -610,8 +772,7 @@
          * @returns Color object
          */
         static fromRgbaString(rgba) {
-            const { red, green, blue, alpha } = parseRgbaColor(rgba);
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels(parseRgbaColor(rgba));
         }
         /**
          * Creates a new Color for color channels values
@@ -623,7 +784,7 @@
          * @returns Color object
          */
         static fromValues(red, green, blue, alpha = 255) {
-            return take(new Color(red, green, blue, alpha));
+            return Color.fromColorChannels({ red, green, blue, alpha });
         }
         /**
          * Checks if the given value is a valid Color object.
@@ -656,8 +817,7 @@
          * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
          */
         static isHexColorString(value) {
-            return (typeof value === 'string' &&
-                /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
+            return isHexColorString(value);
         }
         /**
          * Creates new Color object
@@ -670,91 +830,13 @@
          * @param alpha number from 0 (transparent) to 255 (opaque)
          */
         constructor(red, green, blue, alpha = 255) {
-            this.red = red;
-            this.green = green;
-            this.blue = blue;
-            this.alpha = alpha;
-            checkChannelValue('Red', red);
-            checkChannelValue('Green', green);
-            checkChannelValue('Blue', blue);
-            checkChannelValue('Alpha', alpha);
-        }
-        /**
-         * Shortcut for `red` property
-         * Number from 0 to 255
-         * @alias red
-         */
-        get r() {
-            return this.red;
-        }
-        /**
-         * Shortcut for `green` property
-         * Number from 0 to 255
-         * @alias green
-         */
-        get g() {
-            return this.green;
-        }
-        /**
-         * Shortcut for `blue` property
-         * Number from 0 to 255
-         * @alias blue
-         */
-        get b() {
-            return this.blue;
-        }
-        /**
-         * Shortcut for `alpha` property
-         * Number from 0 (transparent) to 255 (opaque)
-         * @alias alpha
-         */
-        get a() {
-            return this.alpha;
+            super(red, green, blue, alpha);
         }
-        /**
-         * Shortcut for `alpha` property
-         * Number from 0 (transparent) to 255 (opaque)
-         * @alias alpha
-         */
-        get opacity() {
-            return this.alpha;
-        }
-        /**
-         * Shortcut for 1-`alpha` property
-         */
-        get transparency() {
-            return 255 - this.alpha;
+        createColor(red, green, blue, alpha) {
+            return new Color(red, green, blue, alpha);
         }
-        clone() {
-            return take(new Color(this.red, this.green, this.blue, this.alpha));
-        }
-        toString() {
-            return this.toHex();
-        }
-        toHex() {
-            if (this.alpha === 255) {
-                return `#${this.red.toString(16).padStart(2, '0')}${this.green
-                .toString(16)
-                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}`;
-            }
-            else {
-                return `#${this.red.toString(16).padStart(2, '0')}${this.green
-                .toString(16)
-                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}${this.alpha
-                .toString(16)
-                .padStart(2, '0')}`;
-            }
-        }
-        toRgb() {
-            if (this.alpha === 255) {
-                return `rgb(${this.red}, ${this.green}, ${this.blue})`;
-            }
-            else {
-                return `rgba(${this.red}, ${this.green}, ${this.blue}, ${Math.round((this.alpha / 255) * 100)}%)`;
-            }
-        }
-        toHsl() {
-            throw new Error(`Getting HSL is not implemented`);
+        static fromColorChannels({ red, green, blue, alpha }) {
+            return take(new Color(red, green, blue, alpha));
         }
     }
 
@@ -818,9 +900,7 @@
         }
         return [Math.round(red * 255), Math.round(green * 255), Math.round(blue * 255)];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Converts RGB values to HSL values
@@ -866,9 +946,7 @@
         }
         return [hue, saturation, lightness];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Makes color transformer which lighten the given color
@@ -886,9 +964,7 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
-    /**
-     * TODO: Maybe implement by mix+hsl
-     */
+    // TODO: Maybe implement by mix+hsl
 
     /**
      * Makes color transformer which saturate the given color
@@ -906,9 +982,36 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
+    // TODO: Maybe implement by mix+hsl
+
+    /**
+     * Stable root directory used for Promptbook-owned temporary files and caches.
+     *
+     * @private internal utility for Promptbook temporary folders
+     */
+    const PROMPTBOOK_TEMPORARY_DIRECTORY = '.promptbook';
+    /**
+     * Builds one normalized project-relative path inside Promptbook's dedicated temporary root.
+     *
+     * The returned path intentionally uses `/` separators so the same helper can be reused from
+     * Node.js and edge-safe code without depending on the Node `path` module.
+     *
+     * @private internal utility for Promptbook temporary folders
+     */
+    function getPromptbookTemporaryPath(...pathSegments) {
+        const normalizedPathSegments = pathSegments.flatMap(splitPathSegments).filter(Boolean);
+        return [PROMPTBOOK_TEMPORARY_DIRECTORY, ...normalizedPathSegments].join('/');
+    }
     /**
-     * TODO: Maybe implement by mix+hsl
+     * Normalizes one raw path segment into slash-delimited pieces without empty items.
      */
+    function splitPathSegments(pathSegment) {
+        return pathSegment
+            .split(/[\\/]+/u)
+            .map((segment) => segment.trim())
+            .filter(Boolean);
+    }
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Name for the Promptbook
@@ -952,6 +1055,9 @@
         LINE: Color.fromHex('#eeeeee'),
         SEPARATOR: Color.fromHex('#cccccc'),
         COMMITMENT: Color.fromHex('#DA0F78'),
+        NOTE_COMMITMENT: Color.fromHex('#8080807e'),
+        TODO_COMMITMENT_TEXT: Color.fromHex('#000000'),
+        TODO_COMMITMENT_BACKGROUND: Color.fromHex('#FFEB3B'),
         PARAMETER: Color.fromHex('#8e44ad'),
         CODE_BLOCK: Color.fromHex('#7700ffff'),
     });
@@ -1001,6 +1107,31 @@
      * @public exported from `@promptbook/utils`
      */
     const SMALL_NUMBER = 0.001;
+    // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
+    /**
+     * Where to store the temporary downloads
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('download-cache')}`;
+    /**
+     * Where to store the cache of executions for promptbook CLI
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('execution-cache')}`;
+    /**
+     * Where to store the scrape cache
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+`./${getPromptbookTemporaryPath('scrape-cache')}`;
     // <- TODO: [🧜‍♂️]
     /**
      * Default settings for parsing and generating CSV files in Promptbook.
@@ -1029,6 +1160,7 @@
      * Orders JSON object by keys
      *
      * @returns The same type of object as the input re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function orderJson(options) {
@@ -1047,6 +1179,7 @@
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
      *
      * @returns The same object as the input, but deeply frozen
+     *
      * @public exported from `@promptbook/utils`
      */
     function $deepFreeze(objectValue) {
@@ -1063,9 +1196,7 @@
         Object.freeze(objectValue);
         return objectValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Make error report URL for the given error
@@ -1075,7 +1206,7 @@
     function getErrorReportUrl(error) {
         const report = {
             title: `🐜 Error report from ${NAME}`,
-            body: spaceTrim__default["default"]((block) => `
+            body: _spaceTrim.spaceTrim((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1118,7 +1249,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim$1.spaceTrim((block) => `
+            super(_spaceTrim.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1144,7 +1275,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim$1.spaceTrim(`
+            super(_spaceTrim.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1201,125 +1332,187 @@
      * - And much more...
      *
      * @throws UnexpectedError if the value is not serializable as JSON
+     *
      * @public exported from `@promptbook/utils`
      */
     function checkSerializableAsJson(options) {
-        const { value, name, message } = options;
+        checkSerializableValue(options);
+    }
+    // TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
+    // TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+    // Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+    /**
+     * Checks one value and dispatches to the appropriate specialized validator.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableValue(options) {
+        const { value } = options;
+        if (isSerializablePrimitive(value)) {
+            return;
+        }
         if (value === undefined) {
-            throw new UnexpectedError(`${name} is undefined`);
+            throw new UnexpectedError(`${options.name} is undefined`);
         }
-        else if (value === null) {
-            return;
+        if (typeof value === 'symbol') {
+            throw new UnexpectedError(`${options.name} is symbol`);
         }
-        else if (typeof value === 'boolean') {
-            return;
+        if (typeof value === 'function') {
+            throw new UnexpectedError(`${options.name} is function`);
         }
-        else if (typeof value === 'number' && !isNaN(value)) {
+        if (Array.isArray(value)) {
+            checkSerializableArray(options, value);
             return;
         }
-        else if (typeof value === 'string') {
+        if (value !== null && typeof value === 'object') {
+            checkSerializableObject(options, value);
             return;
         }
-        else if (typeof value === 'symbol') {
-            throw new UnexpectedError(`${name} is symbol`);
-        }
-        else if (typeof value === 'function') {
-            throw new UnexpectedError(`${name} is function`);
-        }
-        else if (typeof value === 'object' && Array.isArray(value)) {
-            for (let i = 0; i < value.length; i++) {
-                checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
-            }
+        throwUnknownTypeError(options);
+    }
+    /**
+     * Checks the primitive values that are directly JSON serializable.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function isSerializablePrimitive(value) {
+        return (value === null ||
+            typeof value === 'boolean' ||
+            (typeof value === 'number' && !isNaN(value)) ||
+            typeof value === 'string');
+    }
+    /**
+     * Recursively checks JSON array items.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableArray(context, arrayValue) {
+        for (let index = 0; index < arrayValue.length; index++) {
+            checkSerializableAsJson({
+                ...context,
+                name: `${context.name}[${index}]`,
+                value: arrayValue[index],
+            });
         }
-        else if (typeof value === 'object') {
-            if (value instanceof Date) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is Date
+    }
+    /**
+     * Checks object-like values and dispatches special unsupported built-ins.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableObject(context, objectValue) {
+        checkUnsupportedObjectType(context, objectValue);
+        checkSerializableObjectEntries(context, objectValue);
+        assertJsonStringificationSucceeds(context, objectValue);
+    }
+    /**
+     * Rejects built-in objects that must be converted before JSON serialization.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkUnsupportedObjectType(context, objectValue) {
+        if (objectValue instanceof Date) {
+            throw new UnexpectedError(_spaceTrim.spaceTrim((block) => `
+                    \`${context.name}\` is Date
 
-                        Use \`string_date_iso8601\` instead
+                    Use \`string_date_iso8601\` instead
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
-                    `));
-            }
-            else if (value instanceof Map) {
-                throw new UnexpectedError(`${name} is Map`);
-            }
-            else if (value instanceof Set) {
-                throw new UnexpectedError(`${name} is Set`);
-            }
-            else if (value instanceof RegExp) {
-                throw new UnexpectedError(`${name} is RegExp`);
-            }
-            else if (value instanceof Error) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is unserialized Error
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
+                `));
+        }
+        if (objectValue instanceof Map) {
+            throw new UnexpectedError(`${context.name} is Map`);
+        }
+        if (objectValue instanceof Set) {
+            throw new UnexpectedError(`${context.name} is Set`);
+        }
+        if (objectValue instanceof RegExp) {
+            throw new UnexpectedError(`${context.name} is RegExp`);
+        }
+        if (objectValue instanceof Error) {
+            throw new UnexpectedError(_spaceTrim.spaceTrim((block) => `
+                    \`${context.name}\` is unserialized Error
 
-                        Use function \`serializeError\`
+                    Use function \`serializeError\`
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
 
-                    `));
+                `));
+        }
+    }
+    /**
+     * Recursively checks object properties while preserving omitted `undefined` keys.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function checkSerializableObjectEntries(context, objectValue) {
+        for (const [subName, subValue] of Object.entries(objectValue)) {
+            if (subValue === undefined) {
+                // Note: undefined in object is serializable - it is just omitted
+                continue;
             }
-            else {
-                for (const [subName, subValue] of Object.entries(value)) {
-                    if (subValue === undefined) {
-                        // Note: undefined in object is serializable - it is just omitted
-                        continue;
-                    }
-                    checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });
-                }
-                try {
-                    JSON.stringify(value); // <- TODO: [0]
-                }
-                catch (error) {
-                    assertsError(error);
-                    throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                            \`${name}\` is not serializable
+            checkSerializableAsJson({
+                ...context,
+                name: `${context.name}.${subName}`,
+                value: subValue,
+            });
+        }
+    }
+    /**
+     * Uses `JSON.stringify` as the final guard for cases like circular references.
+     *
+     * @private function of `checkSerializableAsJson`
+     */
+    function assertJsonStringificationSucceeds(context, objectValue) {
+        try {
+            JSON.stringify(objectValue); // <- TODO: [0]
+        }
+        catch (error) {
+            assertsError(error);
+            throw new UnexpectedError(_spaceTrim.spaceTrim((block) => `
+                    \`${context.name}\` is not serializable
 
-                            ${block(error.stack || error.message)}
+                    ${block(error.stack || error.message)}
 
-                            Additional message for \`${name}\`:
-                            ${block(message || '(nothing)')}
-                        `));
+                    Additional message for \`${context.name}\`:
+                    ${block(context.message || '(nothing)')}
+                `));
+        }
+        /*
+        TODO: [0] Is there some more elegant way to check circular references?
+        const seen = new Set();
+        const stack = [{ value }];
+        while (stack.length > 0) {
+            const { value } = stack.pop()!;
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value)) {
+                    throw new UnexpectedError(`${name} has circular reference`);
                 }
-                /*
-                TODO: [0] Is there some more elegant way to check circular references?
-                const seen = new Set();
-                const stack = [{ value }];
-                while (stack.length > 0) {
-                    const { value } = stack.pop()!;
-                    if (typeof value === 'object' && value !== null) {
-                        if (seen.has(value)) {
-                            throw new UnexpectedError(`${name} has circular reference`);
-                        }
-                        seen.add(value);
-                        if (Array.isArray(value)) {
-                            stack.push(...value.map((value) => ({ value })));
-                        } else {
-                            stack.push(...Object.values(value).map((value) => ({ value })));
-                        }
-                    }
+                seen.add(value);
+                if (Array.isArray(value)) {
+                    stack.push(...value.map((value) => ({ value })));
+                } else {
+                    stack.push(...Object.values(value).map((value) => ({ value })));
                 }
-                */
-                return;
             }
         }
-        else {
-            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                    \`${name}\` is unknown type
-
-                    Additional message for \`${name}\`:
-                    ${block(message || '(nothing)')}
-                `));
-        }
+        */
     }
     /**
-     * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
-     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
-     * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+     * Throws the fallback error for unsupported value types like `bigint` and `NaN`.
+     *
+     * @private function of `checkSerializableAsJson`
      */
+    function throwUnknownTypeError(context) {
+        throw new UnexpectedError(_spaceTrim.spaceTrim((block) => `
+                \`${context.name}\` is unknown type
+
+                Additional message for \`${context.name}\`:
+                ${block(context.message || '(nothing)')}
+            `));
+    }
 
     /**
      * Creates a deep clone of the given object
@@ -1329,6 +1522,7 @@
      *
      * @param objectValue The object to clone.
      * @returns A deep, writable clone of the input object.
+     *
      * @public exported from `@promptbook/utils`
      */
     function deepClone(objectValue) {
@@ -1345,9 +1539,7 @@
         > return Object.assign({}, objectValue);
         */
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Utility to export a JSON object from a function
@@ -1360,6 +1552,7 @@
      * Note: This function does not mutates the given object
      *
      * @returns The same type of object as the input but read-only and re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function exportJson(options) {
@@ -1379,9 +1572,7 @@
         $deepFreeze(orderedValue);
         return orderedValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * The names of the parameters that are reserved for special purposes
@@ -1403,9 +1594,7 @@
             // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
         ],
     });
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Normalizes a given text to camelCase format.
@@ -1417,6 +1606,7 @@
      * @returns The camelCase formatted string.
      * @example 'helloWorld'
      * @example 'iLovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -1457,10 +1647,11 @@
         }
         return normalizedName;
     }
+    // TODO: [🌺] Use some intermediate util splitWords
+
     /**
-     * TODO: [🌺] Use some intermediate util splitWords
+     * Collection of default diacritics removal map.
      */
-
     const defaultDiacriticsRemovalMap = [
         {
             base: 'A',
@@ -1712,6 +1903,7 @@
      *
      * @param input The string containing diacritics to be normalized.
      * @returns The string with diacritics removed or normalized.
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeDiacritics(input) {
@@ -1720,9 +1912,7 @@
             return DIACRITIC_VARIANTS_LETTERS[character] || character;
         });
     }
-    /**
-     * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
-     */
+    // TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
 
     /**
      * Converts a given text to kebab-case format.
@@ -1733,6 +1923,7 @@
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
      * @example 'i-love-promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeToKebabCase(text) {
@@ -1773,9 +1964,7 @@
         normalizedName = normalizedName.replace(/-$/, '');
         return normalizedName;
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Removes emojis from a string and fix whitespaces
@@ -1784,6 +1973,7 @@
      *
      * @param text with emojis
      * @returns text without emojis
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeEmojis(text) {
@@ -1807,9 +1997,7 @@
             Object.setPrototypeOf(this, ParseError.prototype);
         }
     }
-    /**
-     * TODO: Maybe split `ParseError` and `ApplyError`
-     */
+    // TODO: Maybe split `ParseError` and `ApplyError`
 
     /**
      * Generates random token
@@ -1817,16 +2005,15 @@
      * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
      * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
      *
-     * @private internal helper function
      * @returns secure random token
+     *
+     * @private internal helper function
      */
     function $randomToken(randomness) {
         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
-     */
+    // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+    // TODO: Maybe use nanoid instead https://github.com/ai/nanoid
 
     /**
      * This error indicates errors during the execution of the pipeline
@@ -1843,9 +2030,7 @@
             Object.setPrototypeOf(this, PipelineExecutionError.prototype);
         }
     }
-    /**
-     * TODO: [🧠][🌂] Add id to all errors
-     */
+    // TODO: [🧠][🌂] Add id to all errors
 
     /**
      * Index of all javascript errors
@@ -1870,9 +2055,7 @@
       > WebAssemblyRuntimeError,
       */
     });
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Format either small or big number
@@ -1907,8 +2090,8 @@
      * This is useful and used in the `templateParameters` function
      *
      * Note: This function is not just calling `toString` method
-     *       It's more complex and can handle this conversion specifically for LLM models
-     *       See `VALUE_STRINGS`
+     * It's more complex and can handle this conversion specifically for LLM models
+     * See `VALUE_STRINGS`
      *
      * Note: There are 2 similar functions
      * - `valueToString` converts value to string for LLM models as human-readable string
@@ -1986,6 +2169,7 @@
      * @returns The normalized text in SCREAMING_CASE format.
      * @example 'HELLO_WORLD'
      * @example 'I_LOVE_PROMPTBOOK'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_SCREAMING_CASE(text) {
@@ -2039,6 +2223,7 @@
      *
      * @param {string} input
      * @returns {Set} of keywords without diacritics in lowercase
+     *
      * @public exported from `@promptbook/utils`
      */
     function parseKeywordsFromString(input) {
@@ -2055,6 +2240,7 @@
      * @param name The string to be converted to a URI-compatible format.
      * @returns A URI-compatible string derived from the input name.
      * @example 'Hello World' -> 'hello-world'
+     *
      * @public exported from `@promptbook/utils`
      */
     function nameToUriPart(name) {
@@ -2073,6 +2259,7 @@
      * @param name The name to be converted into URI parts.
      * @returns An array of URI-compatible parts derived from the name.
      * @example 'Example Name' -> ['example', 'name']
+     *
      * @public exported from `@promptbook/utils`
      */
     function nameToUriParts(name) {
@@ -2090,6 +2277,7 @@
      * @returns
      * @example 'HelloWorld'
      * @example 'ILovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_PascalCase(text) {
@@ -2105,6 +2293,7 @@
      * @returns The normalized text in snake_case format.
      * @example 'hello_world'
      * @example 'i_love_promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_snake_case(text) {
@@ -2134,6 +2323,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeQuotes(text) {
@@ -2157,6 +2347,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function unwrapResult(text, options) {
@@ -2164,7 +2355,7 @@
         let trimmedText = text;
         // Remove leading and trailing spaces and newlines
         if (isTrimmed) {
-            trimmedText = spaceTrim$1.spaceTrim(trimmedText);
+            trimmedText = _spaceTrim.spaceTrim(trimmedText);
         }
         let processedText = trimmedText;
         // Check for markdown code block
@@ -2183,7 +2374,7 @@
                 // Remove the introduce sentence and quotes by replacing it with an empty string
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
-            processedText = spaceTrim$1.spaceTrim(processedText);
+            processedText = _spaceTrim.spaceTrim(processedText);
             // Check again for code block after removing introduce sentence
             const codeBlockMatch2 = processedText.match(codeBlockRegex);
             if (codeBlockMatch2 && codeBlockMatch2[1] !== undefined) {
@@ -2231,9 +2422,7 @@
             return processedText;
         }
     }
-    /**
-     * TODO: [🧠] Should this also unwrap the (parenthesis)
-     */
+    // TODO: [🧠] Should this also unwrap the (parenthesis)
 
     /**
      * Extracts all code blocks from markdown.
@@ -2247,6 +2436,7 @@
      * @param markdown any valid markdown
      * @returns code blocks with language and content
      * @throws {ParseError} if block is not closed properly
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function extractAllBlocksFromMarkdown(markdown) {
@@ -2297,9 +2487,7 @@
         }
         return codeBlocks;
     }
-    /**
-     * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
-     */
+    // TODO: Maybe name for `blockNotation` instead of  '```' and '>'
 
     /**
      * Extracts exactly ONE code block from markdown.
@@ -2314,13 +2502,14 @@
      *
      * @param markdown any valid markdown
      * @returns code block with language and content
-     * @public exported from `@promptbook/markdown-utils`
      * @throws {ParseError} if there is not exactly one code block in the markdown
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractOneBlockFromMarkdown(markdown) {
         const codeBlocks = extractAllBlocksFromMarkdown(markdown);
         if (codeBlocks.length !== 1) {
-            throw new ParseError(spaceTrim__default["default"]((block) => `
+            throw new ParseError(_spaceTrim.spaceTrim((block) => `
                     There should be exactly 1 code block in task section, found ${codeBlocks.length} code blocks
 
                     ${block(codeBlocks.map((block, i) => `Block ${i + 1}:\n${block.content}`).join('\n\n\n'))}
@@ -2328,9 +2517,7 @@
         }
         return codeBlocks[0];
     }
-    /***
-     * TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
-     */
+    // TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
 
     /**
      * Extracts code block from markdown.
@@ -2343,8 +2530,9 @@
      * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
      * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
      *
-     * @public exported from `@promptbook/markdown-utils`
      * @throws {ParseError} if there is not exactly one code block in the markdown
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractBlock(markdown) {
         const { content } = extractOneBlockFromMarkdown(markdown);
@@ -2356,8 +2544,9 @@
      *
      * @param content raw html code
      * @returns formatted html code
-     * @private withing the package because of HUGE size of prettier dependency
      * @deprecated Prettier removed from Promptbook due to package size
+     *
+     * @private withing the package because of HUGE size of prettier dependency
      */
     function prettifyMarkdown(content) {
         return (content + `\n\n<!-- Note: Prettier removed from Promptbook -->`);
@@ -2368,18 +2557,18 @@
      *
      * Note: [🔂] This function is idempotent.
      * Note: This is useful for post-processing of the result of the chat LLM model
-     *       when the model wraps the result in the (markdown) code block.
+     * when the model wraps the result in the (markdown) code block.
      *
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimCodeBlock(value) {
-        value = spaceTrim$1.spaceTrim(value);
+        value = _spaceTrim.spaceTrim(value);
         if (!/^```[a-z]*(.*)```$/is.test(value)) {
             return value;
         }
         value = value.replace(/^```[a-z]*/i, '');
         value = value.replace(/```$/i, '');
-        value = spaceTrim$1.spaceTrim(value);
+        value = _spaceTrim.spaceTrim(value);
         return value;
     }
 
@@ -2387,18 +2576,20 @@
      * Function trimEndOfCodeBlock will remove ending code block from the string if it is present.
      *
      * Note: This is useful for post-processing of the result of the completion LLM model
-     *       if you want to start code block in the prompt but you don't want to end it in the result.
+     * if you want to start code block in the prompt but you don't want to end it in the result.
      *
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimEndOfCodeBlock(value) {
-        value = spaceTrim$1.spaceTrim(value);
+        value = _spaceTrim.spaceTrim(value);
         value = value.replace(/```$/g, '');
-        value = spaceTrim$1.spaceTrim(value);
+        value = _spaceTrim.spaceTrim(value);
         return value;
     }
 
     /**
+     * Collection of preserved.
+     *
      * @private internal for `preserve`
      */
     const _preserved = [];
@@ -2408,21 +2599,20 @@
      *
      * @param value any function to preserve
      * @returns nothing
+     *
      * @private within the repository
      */
     function $preserve(...value) {
         _preserved.push(...value);
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     // Note: [💎]
     /**
      * ScriptExecutionTools for JavaScript implemented via eval
      *
      * Warning: It is used for testing and mocking
-     *          **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
+     * **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
      *
      * @public exported from `@promptbook/javascript`
      */
@@ -2441,7 +2631,7 @@
             }
             // Note: [💎]
             // Note: Using direct eval, following variables are in same scope as eval call so they are accessible from inside the evaluated script:
-            const spaceTrim = (_) => spaceTrim__default["default"](_);
+            const spaceTrim = (_) => _spaceTrim__default["default"](_);
             $preserve(spaceTrim);
             const removeQuotes$1 = removeQuotes;
             $preserve(removeQuotes$1);
@@ -2532,7 +2722,7 @@
                 .join('\n');
             // script = templateParameters(script, parameters);
             // <- TODO: [🧠][🥳] Should be this is one of two variants how to use parameters in script
-            const statementToEvaluate = spaceTrim__default["default"]((block) => `
+            const statementToEvaluate = _spaceTrim__default["default"]((block) => `
 
                 // Build-in functions:
                 ${block(buildinFunctionsStatement)}
@@ -2547,7 +2737,7 @@
                 (async ()=>{ ${script} })()
             `);
             if (this.options.isVerbose) {
-                console.info(spaceTrim__default["default"]((block) => `
+                console.info(_spaceTrim__default["default"]((block) => `
                         🚀 Evaluating ${scriptLanguage} script:
 
                         ${block(statementToEvaluate)}`));
@@ -2555,6 +2745,12 @@
             let result;
             try {
                 result = await eval(statementToEvaluate);
+                if (this.options.isVerbose) {
+                    console.info(_spaceTrim__default["default"]((block) => `
+                            🚀 Script evaluated successfully, result:   
+                            ${block(valueToString(result))}
+                        `));
+                }
                 if (typeof result !== 'string') {
                     throw new PipelineExecutionError(`Script must return a string, but returned ${valueToString(result)}`);
                 }
@@ -2569,7 +2765,7 @@
                           To:   [PipelineExecutionError: Parameter `{thing}` is not defined],
                     */
                     if (!statementToEvaluate.includes(undefinedName + '(')) {
-                        throw new PipelineExecutionError(spaceTrim__default["default"]((block) => `
+                        throw new PipelineExecutionError(_spaceTrim__default["default"]((block) => `
 
                                 Parameter \`{${undefinedName}}\` is not defined
 
@@ -2591,7 +2787,7 @@
                             `));
                     }
                     else {
-                        throw new PipelineExecutionError(spaceTrim__default["default"]((block) => `
+                        throw new PipelineExecutionError(_spaceTrim__default["default"]((block) => `
                                   Function ${undefinedName}() is not defined
 
                                   -  Make sure that the function is one of built-in functions
@@ -2611,25 +2807,33 @@
             return result;
         }
     }
-    /**
-     * TODO: Put predefined functions (like removeQuotes, spaceTrim, etc.) into annotation OR pass into constructor
-     * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
-     */
+    // TODO: Put predefined functions (like removeQuotes, spaceTrim, etc.) into annotation OR pass into constructor
+    // TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
 
     /**
      * Placeholder for better implementation of JavascriptExecutionTools - some proper sandboxing
      *
      * @alias JavascriptExecutionTools
+     *
      * @public exported from `@promptbook/javascript`
      */
     const JavascriptExecutionTools = JavascriptEvalExecutionTools;
 
+    /**
+     * Constant for parse keywords.
+     */
     const parseKeywords = (input) => 
     // TODO: DRY [🍯]
     Array.from(parseKeywordsFromString(input)).join(', '); /* <- TODO: [🧠] What is the best format comma list, bullet list,...? */
     // TODO: DRY [🍯]
+    /**
+     * Constant for trim.
+     */
     const trim = (str) => str.trim();
     // TODO: DRY [🍯]
+    /**
+     * Constant for reverse.
+     */
     const reverse = (str) => str.split('').reverse().join('');
     /**
      * Collection of utility functions that can be used for post-processing model outputs.
@@ -2641,7 +2845,7 @@
      * @public exported from `@promptbook/javascript`
      */
     const POSTPROCESSING_FUNCTIONS = {
-        spaceTrim: spaceTrim__default["default"],
+        spaceTrim: _spaceTrim.spaceTrim,
         removeQuotes,
         unwrapResult,
         trimEndOfCodeBlock,
@@ -2664,10 +2868,8 @@
         normalizeTo_SCREAMING_CASE,
         extractBlock, // <- [🍓] Remove balast in all other functions, use this one as example
     };
-    /**
-     * TODO: DRY [🍯], [🧠] Where should be POSTPROCESSING_FUNCTIONS located and how it should be named
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // TODO: DRY [🍯], [🧠] Where should be POSTPROCESSING_FUNCTIONS located and how it should be named
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Parses the given script and returns the list of all used variables that are not defined in the script
@@ -2675,6 +2877,7 @@
      * @param script from which to extract the variables
      * @returns the list of variable names
      * @throws {ParseError} if the script is invalid
+     *
      * @public exported from `@promptbook/javascript`
      */
     function extractVariablesFromJavascript(script) {
@@ -2721,7 +2924,7 @@
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
+            throw new ParseError(_spaceTrim.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -2740,9 +2943,7 @@
         }
         return variables;
     }
-    /**
-     * TODO: [🔣] Support for multiple languages - python, java,...
-     */
+    // TODO: [🔣] Support for multiple languages - python, java,...
 
     exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
     exports.JavascriptEvalExecutionTools = JavascriptEvalExecutionTools;