@promptbook/browser 0.112.0-34 → 0.112.0-35

package/esm/index.es.js

@@ -29,7 +29,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-34';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-35';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -39,16 +39,20 @@ const PROMPTBOOK_ENGINE_VERSION = '0.112.0-34';
  * 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;
 
 /**
- * @private util of `@promptbook/color`
+ * Class implementing take chain.
+ *
  * @de
+ *
+ * @private util of `@promptbook/color`
  */
 class TakeChain {
     constructor(value) {
@@ -65,9 +69,9 @@ class TakeChain {
  *
  * @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) {
@@ -245,9 +249,7 @@ const CSS_COLORS = {
     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.
@@ -277,7 +279,13 @@ function checkChannelValue(channelName, 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.
@@ -310,6 +318,9 @@ function parseHexColor(hex) {
     }
     return throwInvalidHex();
 }
+/**
+ * Parses short hex channel.
+ */
 function parseShortHexChannel(char, onError) {
     if (!char) {
         return onError();
@@ -320,6 +331,9 @@ function parseShortHexChannel(char, onError) {
     }
     return parsed * 16;
 }
+/**
+ * Parses long hex channel.
+ */
 function parseLongHexChannel(hex, start, onError) {
     const segment = hex.substr(start, 2);
     if (segment.length < 2) {
@@ -332,6 +346,9 @@ function parseLongHexChannel(hex, start, onError) {
     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.
@@ -357,6 +374,9 @@ function parseHslColor(hsl) {
         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));
@@ -395,7 +415,13 @@ function convertHslToRgb(h, s, l) {
     };
 }
 
+/**
+ * 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.
@@ -437,6 +463,9 @@ function parseRgbaColor(rgba) {
         alpha: parseAlphaValue(match[4]),
     };
 }
+/**
+ * Parses channel value.
+ */
 function parseChannelValue(value) {
     if (value.endsWith('%')) {
         const percent = parseFloat(value);
@@ -444,6 +473,9 @@ function parseChannelValue(value) {
     }
     return Math.round(parseFloat(value));
 }
+/**
+ * Parses alpha value.
+ */
 function parseAlphaValue(value) {
     if (value.endsWith('%')) {
         const percent = parseFloat(value);
@@ -456,8 +488,17 @@ function parseAlphaValue(value) {
     return Math.round(parsed);
 }
 
+/**
+ * Pattern matching hsl regex.
+ */
 const HSL_REGEX_PATTERN = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+/**
+ * Pattern matching RGB regex.
+ */
 const RGB_REGEX_PATTERN = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+/**
+ * Pattern matching rgba regex.
+ */
 const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
 /**
  * Color object represents an RGB color with alpha channel
@@ -823,9 +864,7 @@ function hslToRgb(hue, saturation, lightness) {
     }
     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
@@ -871,9 +910,7 @@ function rgbToHsl(red, green, blue) {
     }
     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
@@ -891,9 +928,7 @@ function lighten(amount) {
         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
@@ -911,9 +946,7 @@ function saturate(amount) {
         return Color.fromValues(r, g, b, alpha);
     };
 }
-/**
- * TODO: Maybe implement by mix+hsl
- */
+// TODO: Maybe implement by mix+hsl
 
 /**
  * Returns the same value that is passed as argument.
@@ -926,6 +959,7 @@ function saturate(amount) {
  *
  * @param value any values
  * @returns the same values
+ *
  * @private within the repository
  */
 function just(value) {
@@ -1492,9 +1526,7 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, actionSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Just says that the variable is not used but should be kept
@@ -1508,6 +1540,7 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
  *
  * @param value any values
  * @returns void
+ *
  * @private within the repository
  */
 function keepUnused(...valuesToKeep) {
@@ -1577,9 +1610,7 @@ class ClosedCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * COMPONENT commitment definition
@@ -1638,9 +1669,7 @@ class ComponentCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, componentSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * DELETE commitment definition
@@ -1762,9 +1791,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, deleteSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * DICTIONARY commitment definition
@@ -1868,9 +1895,7 @@ class DictionaryCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * FORMAT commitment definition
@@ -1949,14 +1974,13 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, formatSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Orders JSON object by keys
  *
  * @returns The same type of object as the input re-ordered
+ *
  * @public exported from `@promptbook/utils`
  */
 function orderJson(options) {
@@ -1975,6 +1999,7 @@ function orderJson(options) {
  * 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) {
@@ -1991,9 +2016,7 @@ function $deepFreeze(objectValue) {
     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
 
 /**
  * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
@@ -2061,6 +2084,7 @@ function assertsError(whatWasThrown) {
  * - And much more...
  *
  * @throws UnexpectedError if the value is not serializable as JSON
+ *
  * @public exported from `@promptbook/utils`
  */
 function checkSerializableAsJson(options) {
@@ -2175,11 +2199,9 @@ function checkSerializableAsJson(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
- */
+// 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
 
 /**
  * Creates a deep clone of the given object
@@ -2189,6 +2211,7 @@ function checkSerializableAsJson(options) {
  *
  * @param objectValue The object to clone.
  * @returns A deep, writable clone of the input object.
+ *
  * @public exported from `@promptbook/utils`
  */
 function deepClone(objectValue) {
@@ -2205,9 +2228,7 @@ function deepClone(objectValue) {
     > 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
@@ -2220,6 +2241,7 @@ function deepClone(objectValue) {
  * 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) {
@@ -2239,9 +2261,7 @@ function exportJson(options) {
     $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
 
 /**
  * Order of keys in the pipeline JSON
@@ -2352,9 +2372,7 @@ const LIMITS = {
      */
     SHORT_NAME_LENGTH: 6,
 };
-/**
- * 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.
@@ -2366,6 +2384,7 @@ const LIMITS = {
  * @returns The camelCase formatted string.
  * @example 'helloWorld'
  * @example 'iLovePromptbook'
+ *
  * @public exported from `@promptbook/utils`
  */
 function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -2406,14 +2425,13 @@ function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
     }
     return normalizedName;
 }
-/**
- * TODO: [🌺] Use some intermediate util splitWords
- */
+// TODO: [🌺] Use some intermediate util splitWords
 
 /**
  * Tests if given string is valid file path.
  *
  * Note: This does not check if the file exists only if the path is valid
+ *
  * @public exported from `@promptbook/utils`
  */
 function isValidFilePath(filename) {
@@ -2462,9 +2480,7 @@ function isValidFilePath(filename) {
     }
     return false;
 }
-/**
- * TODO: [🍏] Implement for MacOs
- */
+// TODO: [🍏] Implement for MacOs
 
 /**
  * Tests if given string is valid URL.
@@ -2497,6 +2513,9 @@ function isValidUrl(url) {
     }
 }
 
+/**
+ * Collection of default diacritics removal map.
+ */
 const defaultDiacriticsRemovalMap = [
     {
         base: 'A',
@@ -2748,6 +2767,7 @@ for (let i = 0; i < defaultDiacriticsRemovalMap.length; i++) {
  *
  * @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) {
@@ -2756,9 +2776,7 @@ function removeDiacritics(input) {
         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.
@@ -2769,6 +2787,7 @@ function removeDiacritics(input) {
  * @returns The kebab-case formatted string.
  * @example 'hello-world'
  * @example 'i-love-promptbook'
+ *
  * @public exported from `@promptbook/utils`
  */
 function normalizeToKebabCase(text) {
@@ -2809,9 +2828,7 @@ function normalizeToKebabCase(text) {
     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
@@ -2820,6 +2837,7 @@ function normalizeToKebabCase(text) {
  *
  * @param text with emojis
  * @returns text without emojis
+ *
  * @public exported from `@promptbook/utils`
  */
 function removeEmojis(text) {
@@ -2839,6 +2857,7 @@ function removeEmojis(text) {
  * @param value The title string to be converted to a name.
  * @returns A normalized name derived from the input title.
  * @example 'Hello World!' -> 'hello-world'
+ *
  * @public exported from `@promptbook/utils`
  */
 function titleToName(value) {
@@ -2938,9 +2957,7 @@ class DatabaseError extends Error {
         Object.setPrototypeOf(this, DatabaseError.prototype);
     }
 }
-/**
- * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
- */
+// TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
 
 /**
  * This error type indicates that you try to use a feature that is not available in the current environment
@@ -2958,10 +2975,11 @@ class EnvironmentMismatchError extends Error {
 /**
  * This error occurs when some expectation is not met in the execution of the pipeline
  *
- * @public exported from `@promptbook/core`
  * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
  * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
  * Note: This is a kindof subtype of PipelineExecutionError
+ *
+ * @public exported from `@promptbook/core`
  */
 class ExpectError extends Error {
     constructor(message) {
@@ -3076,9 +3094,7 @@ class ParseError extends Error {
         Object.setPrototypeOf(this, ParseError.prototype);
     }
 }
-/**
- * TODO: Maybe split `ParseError` and `ApplyError`
- */
+// TODO: Maybe split `ParseError` and `ApplyError`
 
 /**
  * Generates random token
@@ -3086,16 +3102,15 @@ class ParseError extends Error {
  * 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 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
@@ -3112,9 +3127,7 @@ class PipelineExecutionError extends Error {
         Object.setPrototypeOf(this, PipelineExecutionError.prototype);
     }
 }
-/**
- * TODO: [🧠][🌂] Add id to all errors
- */
+// TODO: [🧠][🌂] Add id to all errors
 
 /**
  * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
@@ -3216,9 +3229,7 @@ const ALL_ERRORS = {
     ...PROMPTBOOK_ERRORS,
     ...COMMON_JAVASCRIPT_ERRORS,
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Deserializes the error object
@@ -3281,8 +3292,9 @@ function serializeError(error) {
  * @param array - Array to iterate over
  * @param options - Options for the function
  * @param callbackfunction - Function to call for each item
- * @public exported from `@promptbook/utils`
  * @deprecated [🪂] Use queues instead
+ *
+ * @public exported from `@promptbook/utils`
  */
 async function forEachAsync(array, options, callbackfunction) {
     const { maxParallelCount = Infinity } = options;
@@ -3441,8 +3453,8 @@ function numberToString(value) {
  * 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
@@ -3493,12 +3505,13 @@ function valueToString(value) {
  * Replaces parameters in template with values from parameters object
  *
  * Note: This function is not places strings into string,
- *       It's more complex and can handle this operation specifically for LLM models
+ * It's more complex and can handle this operation specifically for LLM models
  *
  * @param template the template with parameters in {curly} braces
  * @param parameters the object with parameters
  * @returns the template with replaced parameters
  * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+ *
  * @public exported from `@promptbook/utils`
  */
 function templateParameters(template, parameters) {
@@ -3582,6 +3595,7 @@ const PROMPT_PARAMETER_ESCAPE_WITH_BRACES_PATTERN = /[{}$`]/g;
  * Normalizes a JSON string so it can be safely rendered without double escaping.
  *
  * @param value Candidate JSON string.
+ *
  * @private function of ParameterEscaping
  */
 function normalizeJsonString(value) {
@@ -3596,6 +3610,7 @@ function normalizeJsonString(value) {
  * Hides brackets in a string to avoid confusion with template parameters.
  *
  * @param value Input string with literal brackets.
+ *
  * @private function of ParameterEscaping
  */
 function hideBrackets(value) {
@@ -3605,6 +3620,7 @@ function hideBrackets(value) {
  * Restores hidden brackets.
  *
  * @param value String with hidden brackets.
+ *
  * @private function of ParameterEscaping
  */
 function restoreBrackets(value) {
@@ -3614,6 +3630,7 @@ function restoreBrackets(value) {
  * Decides whether a parameter can be inlined safely.
  *
  * @param value Parameter rendered as string.
+ *
  * @private function of ParameterEscaping
  */
 function shouldInlineParameterValue(value) {
@@ -3627,6 +3644,7 @@ function shouldInlineParameterValue(value) {
  *
  * @param value Parameter value to escape.
  * @param options Escape options for additional characters.
+ *
  * @private function of ParameterEscaping
  */
 function escapePromptParameterValue(value, options) {
@@ -3652,6 +3670,7 @@ const ParameterEscaping = {
  * Builds numeric parameter names (1, 2, ...).
  *
  * @param index Zero-based parameter index.
+ *
  * @private function of ParameterNaming
  */
 function buildNumericParameterName(index) {
@@ -3661,6 +3680,7 @@ function buildNumericParameterName(index) {
  * Builds alphabetic parameter names (a, b, ..., aa).
  *
  * @param index Zero-based parameter index.
+ *
  * @private function of ParameterNaming
  */
 function buildAlphabeticParameterName(index) {
@@ -3677,6 +3697,7 @@ function buildAlphabeticParameterName(index) {
  * Converts a positive integer into a Roman numeral string.
  *
  * @param value Positive integer value.
+ *
  * @private function of ParameterNaming
  */
 function toRomanNumeral(value) {
@@ -3709,6 +3730,7 @@ function toRomanNumeral(value) {
  * Builds Roman numeral parameter names (I, II, ...).
  *
  * @param index Zero-based parameter index.
+ *
  * @private function of ParameterNaming
  */
 function buildRomanParameterName(index) {
@@ -3719,6 +3741,7 @@ function buildRomanParameterName(index) {
  *
  * @param prefix Prefix string.
  * @param builder Base builder function.
+ *
  * @private function of ParameterNaming
  */
 function buildPrefixedParameterName(prefix, builder) {
@@ -3740,6 +3763,7 @@ const PARAMETER_NAME_STRATEGIES = [
  * Collects bracketed tokens from parameter values to avoid placeholder collisions.
  *
  * @param values Parameter values to scan.
+ *
  * @private function of ParameterNaming
  */
 function collectBracketedParameterTokens(values) {
@@ -3760,6 +3784,7 @@ function collectBracketedParameterTokens(values) {
  * Builds placeholder names while avoiding collisions with parameter content.
  *
  * @param values Parameter values to scan for conflicting tokens.
+ *
  * @private function of ParameterNaming
  */
 function buildParameterNames(values) {
@@ -3790,6 +3815,7 @@ const ParameterNaming = {
  * Formats the placeholder used in the prompt body for a parameter.
  *
  * @param name Parameter placeholder name.
+ *
  * @private function of ParameterSection
  */
 function formatParameterPlaceholder(name) {
@@ -3799,6 +3825,7 @@ function formatParameterPlaceholder(name) {
  * Formats a single line entry for structured parameters.
  *
  * @param item Parameter entry data.
+ *
  * @private function of ParameterSection
  */
 function formatParameterListItem(item) {
@@ -3810,6 +3837,7 @@ function formatParameterListItem(item) {
  * Builds the structured parameters section appended to the prompt.
  *
  * @param items Parameter entries to include.
+ *
  * @private function of ParameterSection
  */
 function buildParametersSection(items) {
@@ -3885,6 +3913,7 @@ function isPromptString(value) {
  * @param strings
  * @param values
  * @returns prompt content wrapped as a PromptString
+ *
  * @public exported from `@promptbook/utils`
  */
 function prompt(strings, ...values) {
@@ -3969,11 +3998,9 @@ function prompt(strings, ...values) {
     }
     return new PromptString(pipelineString);
 }
-/**
- * TODO: Maybe split into multiple files
- * TODO: [🧠][🈴] Where is the best location for this file
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// TODO: Maybe split into multiple files
+// TODO: [🧠][🈴] Where is the best location for this file
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * @@@
@@ -4010,9 +4037,7 @@ function attachClientVersionHeader(headers) {
         [CLIENT_VERSION_HEADER]: CLIENT_LATEST_VERSION,
     };
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Detects if the code is running in a browser environment in main thread (Not in a web worker)
@@ -4029,9 +4054,7 @@ function $isRunningInBrowser() {
         return false;
     }
 }
-/**
- * TODO: [🎺]
- */
+// TODO: [🎺]
 
 /**
  * Detects if the code is running in a web worker
@@ -4051,9 +4074,7 @@ function $isRunningInWebWorker() {
         return false;
     }
 }
-/**
- * TODO: [🎺]
- */
+// TODO: [🎺]
 
 /**
  * Number of characters per standard line with 11pt Arial font size.
@@ -4067,10 +4088,8 @@ const CHARACTERS_PER_STANDARD_LINE = 63;
  * @public exported from `@promptbook/utils`
  */
 const LINES_PER_STANDARD_PAGE = 44;
-/**
- * TODO: [🧠] Should be this `constants.ts` or `config.ts`?
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// TODO: [🧠] Should be this `constants.ts` or `config.ts`?
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Counts number of characters in the text
@@ -4086,10 +4105,8 @@ function countCharacters(text) {
     text = text.replace(/\p{Extended_Pictographic}(\u{200D}\p{Extended_Pictographic})*/gu, '-');
     return text.length;
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Counts number of lines in the text
@@ -4107,10 +4124,8 @@ function countLines(text) {
     const lines = text.split(/\r?\n/);
     return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Counts number of pages in the text
@@ -4122,10 +4137,8 @@ function countLines(text) {
 function countPages(text) {
     return Math.ceil(countLines(text) / LINES_PER_STANDARD_PAGE);
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Counts number of paragraphs in the text
@@ -4135,10 +4148,8 @@ function countPages(text) {
 function countParagraphs(text) {
     return text.split(/\n\s*\n/).filter((paragraph) => paragraph.trim() !== '').length;
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Split text into sentences
@@ -4156,10 +4167,8 @@ function splitIntoSentences(text) {
 function countSentences(text) {
     return splitIntoSentences(text).length;
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Counts number of words in the text
@@ -4173,11 +4182,9 @@ function countWords(text) {
     text = text.replace(/([a-z])([A-Z])/g, '$1 $2');
     return text.split(/[^a-zа-я0-9]+/i).filter((word) => word.length > 0).length;
 }
-/**
- * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- * TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
- */
+// TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+// TODO: [🧠][✌️] Make some Promptbook-native token system
+// TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
 
 /**
  * Index of all counter functions
@@ -4192,10 +4199,8 @@ const CountUtils = {
     LINES: countLines,
     PAGES: countPages,
 };
-/**
- * TODO: [🧠][🤠] This should be probably as part of `TextFormatParser`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// TODO: [🧠][🤠] This should be probably as part of `TextFormatParser`
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Computes SHA-256 hash of the given object
@@ -4205,9 +4210,7 @@ const CountUtils = {
 function computeHash(value) {
     return SHA256(hexEncoder.parse(spaceTrim$1(valueToString(value)))).toString( /* hex */);
 }
-/**
- * TODO: [🥬][🥬] Use this ACRY
- */
+// TODO: [🥬][🥬] Use this ACRY
 
 /**
  * Makes first letter of a string uppercase
@@ -4384,6 +4387,9 @@ const ADJECTIVES$1 = [
     'prvotní',
     'hbitý',
 ];
+/**
+ * Collection of nouns.
+ */
 const NOUNS$1 = [
     'jablko',
     'nebe',
@@ -4597,6 +4603,9 @@ const NOUNS$1 = [
     'okno',
     'chodba',
 ];
+/**
+ * Collection of verbs.
+ */
 const VERBS$1 = [
     'skáče',
     'tančí',
@@ -4769,9 +4778,7 @@ const LINGUISTIC_HASH_WORD_LISTS_CS = {
     noun: NOUNS$1,
     verb: VERBS$1,
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * @@@
@@ -5027,6 +5034,9 @@ const ADJECTIVES = [
     'macro',
     'mini',
 ];
+/**
+ * Collection of nouns.
+ */
 const NOUNS = [
     'apple',
     'sky',
@@ -5266,6 +5276,9 @@ const NOUNS = [
     'roof',
     'floor',
 ];
+/**
+ * Collection of verbs.
+ */
 const VERBS = [
     'jumping',
     'dancing',
@@ -5461,9 +5474,7 @@ const LINGUISTIC_HASH_WORD_LISTS_EN = {
     noun: NOUNS,
     verb: VERBS,
 };
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Default language used for linguistic hashes.
@@ -5638,8 +5649,9 @@ function normalizeLinguisticHashWordCount(wordCount) {
 /**
  * Creates a human-readable hash as a short, story-like phrase.
  *
- * @param wordCount how many words to include (defaults to {@link DEFAULT_LINGUISTIC_HASH_WORD_COUNT}, clamped to
  * {@link MIN_LINGUISTIC_HASH_WORD_COUNT}..{@link MAX_LINGUISTIC_HASH_WORD_COUNT})
+ *
+ * @param wordCount how many words to include (defaults to {@link DEFAULT_LINGUISTIC_HASH_WORD_COUNT}, clamped to
  * @param language optional language code (defaults to {@link DEFAULT_LINGUISTIC_HASH_LANGUAGE})
  *
  * @public exported from `@promptbook/utils`
@@ -5658,6 +5670,7 @@ async function linguisticHash(input, wordCount, language) {
  * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
  *
  * @returns string_date branded type
+ *
  * @public exported from `@promptbook/utils`
  */
 function $getCurrentDate() {
@@ -5673,6 +5686,7 @@ function $getCurrentDate() {
  * @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) {
@@ -5742,6 +5756,7 @@ function normalizeMessageText(text) {
  * @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) {
@@ -5770,6 +5785,7 @@ function normalizeWhitespaces(sentence) {
  *
  * @param text optionally quoted text
  * @returns text without quotes
+ *
  * @public exported from `@promptbook/utils`
  */
 function unwrapResult(text, options) {
@@ -5844,15 +5860,14 @@ function unwrapResult(text, options) {
         return processedText;
     }
 }
-/**
- * TODO: [🧠] Should this also unwrap the (parenthesis)
- */
+// TODO: [🧠] Should this also unwrap the (parenthesis)
 
 /**
  * Parses the task and returns the list of all parameter names
  *
  * @param template the string template with parameters in {curly} braces
  * @returns the list of parameter names
+ *
  * @public exported from `@promptbook/utils`
  */
 function extractParameterNames(template) {
@@ -5882,7 +5897,6 @@ function extractParameterNames(template) {
  * - `Symbol` objects are not serializable
  * - And much more...
  *
- *
  * @public exported from `@promptbook/utils`
  */
 function isSerializableAsJson(value) {
@@ -5894,14 +5908,12 @@ function isSerializableAsJson(value) {
         return false;
     }
 }
-/**
- * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
- * TODO: [🧠][💺] Can be done this on type-level?
- */
+// TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+// TODO: [🧠][💺] Can be done this on type-level?
 
 /**
  * Recursively converts JSON strings to JSON objects
-
+ *
  * @public exported from `@promptbook/utils`
  */
 function jsonStringsToJsons(object) {
@@ -5925,14 +5937,13 @@ function jsonStringsToJsons(object) {
     }
     return newObject;
 }
-/**
- * TODO: Type the return type correctly
- */
+// TODO: Type the return type correctly
 
 /**
  * Create difference set of two sets.
  *
  * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+ *
  * @public exported from `@promptbook/utils`
  */
 function difference(a, b, isEqual = (a, b) => a === b) {
@@ -5944,14 +5955,13 @@ function difference(a, b, isEqual = (a, b) => a === b) {
     }
     return diff;
 }
-/**
- * TODO: [🧠][💯] Maybe also implement symmetricDifference
- */
+// TODO: [🧠][💯] Maybe also implement symmetricDifference
 
 /**
  * Creates a new set with all elements that are present in either set
  *
  * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+ *
  * @public exported from `@promptbook/utils`
  */
 function union(...sets) {
@@ -6002,12 +6012,13 @@ function isValidSemanticVersion(version) {
  * Tests if given string is valid promptbook version
  * It looks into list of known promptbook versions.
  *
- * @see https://www.npmjs.com/package/promptbook?activeTab=versions
  * Note: When you are using for example promptbook 2.0.0 and there already is promptbook 3.0.0 it don`t know about it.
  * Note: There are two similar functions:
  * - `isValidSemanticVersion` which tests any semantic version
  * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
  *
+ * @see https://www.npmjs.com/package/promptbook?activeTab=versions
+ *
  * @public exported from `@promptbook/utils`
  */
 function isValidPromptbookVersion(version) {
@@ -6065,6 +6076,7 @@ function isHostnameOnPrivateNetwork(hostname, options = {}) {
  * @param {string} url - The URL to check.
  * @param {IsUrlOnPrivateNetworkOptions} options - Options for the check.
  * @returns {boolean} Returns true if the IP address is reserved for private networks or localhost, otherwise false.
+ *
  * @public exported from `@promptbook/utils`
  */
 function isUrlOnPrivateNetwork(url, options = {}) {
@@ -6103,9 +6115,7 @@ function isValidAgentUrl(url) {
     */
     return true;
 }
-/**
- * TODO: [🐠] Maybe more info why the URL is invalid
- */
+// TODO: [🐠] Maybe more info why the URL is invalid
 
 /**
  * Tests if given string is valid pipeline URL URL.
@@ -6136,10 +6146,11 @@ function isValidPipelineUrl(url) {
     */
     return true;
 }
+// TODO: [🐠] Maybe more info why the URL is invalid
+
 /**
- * TODO: [🐠] Maybe more info why the URL is invalid
+ * Collection of firstnames.
  */
-
 const FIRSTNAMES = [
     'Paul',
     'George',
@@ -6176,6 +6187,9 @@ const FIRSTNAMES = [
     'Anthony',
     'Christopher',
 ];
+/**
+ * Collection of lastnames with colors.
+ */
 const LASTNAMES_WITH_COLORS = [
     { lastname: 'Green', color: '#008000' },
     { lastname: 'Brown', color: '#A52A2A' },
@@ -6203,6 +6217,7 @@ function pickDeterministicItem(hash, startIndex, list) {
  *
  * @param seed - Input seed used to derive a stable pseudonym.
  * @returns Deterministic English full name with color metadata.
+ *
  * @private internal helper for deterministic pseudonym generation
  */
 function generateDeterministicEnglishName(seed) {
@@ -6244,6 +6259,9 @@ const VOID_PSEUDO_AGENT_ALIAS_KEYS = ['void', 'null', 'none', 'nil'];
  * Legacy aliases that historically behaved like `FROM VOID`.
  */
 const LEGACY_VOID_ALIASES = new Set(VOID_PSEUDO_AGENT_ALIAS_KEYS);
+/**
+ * Constant for void alias entries.
+ */
 const VOID_ALIAS_ENTRIES = VOID_PSEUDO_AGENT_ALIAS_KEYS.map((alias) => [
     alias,
     'VOID',
@@ -6292,6 +6310,7 @@ function normalizePseudoReferenceKey(rawReference) {
  *
  * @param rawReference - Raw reference token or payload.
  * @returns Pseudo-agent kind or `null` when the reference is not pseudo.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 function resolvePseudoAgentKindFromReference(rawReference) {
@@ -6306,6 +6325,7 @@ function resolvePseudoAgentKindFromReference(rawReference) {
  *
  * @param agentUrl - URL to inspect.
  * @returns Pseudo-agent kind or `null` when the URL is not pseudo.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 function resolvePseudoAgentKindFromUrl(agentUrl) {
@@ -6326,6 +6346,7 @@ function resolvePseudoAgentKindFromUrl(agentUrl) {
  *
  * @param teamCommitmentContent - TEAM commitment content after reference resolution.
  * @returns Deterministic English full name representing pseudo-user in that TEAM context.
+ *
  * @private internal utility of TEAM commitment rendering
  */
 function createPseudoUserTeammateLabel(teamCommitmentContent) {
@@ -6341,6 +6362,7 @@ function createPseudoUserTeammateLabel(teamCommitmentContent) {
  *
  * @param rawReference - Raw reference content.
  * @returns True when the reference maps to void.
+ *
  * @private internal utility of pseudo-agent resolution
  */
 function isVoidPseudoAgentReference(rawReference) {
@@ -6354,9 +6376,7 @@ function isVoidPseudoAgentReference(rawReference) {
     const normalizedReference = normalizePseudoReferenceKey(rawReference);
     return LEGACY_VOID_ALIASES.has(normalizedReference);
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * FROM commitment definition
@@ -6435,9 +6455,7 @@ class FromCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * GOAL commitment definition
@@ -6535,9 +6553,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToPromptSuffix(requirementsWithGoal, goalSection);
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * IMPORT commitment definition
@@ -6616,19 +6632,26 @@ class ImportCommitmentDefinition extends BaseCommitmentDefinition {
             `));
     }
 }
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
- * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Matches URL-like candidates inside arbitrary text.
+ *
+ * @private
  */
-
-/** @private Matches URL-like candidates inside arbitrary text. */
 const URL_CANDIDATE_PATTERN = /https?:\/\/[^\s<>"'`]+/g;
-/** @private Trims punctuation that commonly trails URLs in prose. */
+/**
+ * Trims punctuation that commonly trails URLs in prose.
+ *
+ * @private
+ */
 const TRAILING_PUNCTUATION_PATTERN = /[.,!?;:'"`]+$/;
 /**
  * Extracts all valid URLs from arbitrary text while removing common trailing punctuation.
  *
  * @param text - Input text that may contain one or more URLs.
  * @returns Unique URLs in their first-seen order.
+ *
  * @private utility of KNOWLEDGE parsing
  */
 function extractUrlsFromText(text) {
@@ -6658,7 +6681,9 @@ function extractUrlsFromText(text) {
     return urls;
 }
 /**
- * @private Normalizes one extracted URL candidate by stripping trailing punctuation and unmatched closing wrappers.
+ * Normalizes one extracted URL candidate by stripping trailing punctuation and unmatched closing wrappers.
+ *
+ * @private
  */
 function normalizeUrlCandidate(candidate) {
     let normalized = candidate.trim();
@@ -6678,7 +6703,9 @@ function normalizeUrlCandidate(candidate) {
     return normalized;
 }
 /**
- * @private Removes trailing closing wrappers when they are unmatched in the candidate.
+ * Removes trailing closing wrappers when they are unmatched in the candidate.
+ *
+ * @private
  */
 function stripTrailingUnmatchedClosing(candidate, openingChar, closingChar) {
     let normalized = candidate;
@@ -6693,7 +6720,9 @@ function stripTrailingUnmatchedClosing(candidate, openingChar, closingChar) {
     return normalized;
 }
 /**
- * @private Counts character occurrences in a string.
+ * Counts character occurrences in a string.
+ *
+ * @private
  */
 function countOccurrences(value, searchedChar) {
     let count = 0;
@@ -6705,14 +6734,28 @@ function countOccurrences(value, searchedChar) {
     return count;
 }
 
-/** @private The default base name for inline knowledge files when the content lacks identifying text */
+/**
+ * The default base name for inline knowledge files when the content lacks identifying text.
+ *
+ * @private
+ */
 const INLINE_KNOWLEDGE_BASE_NAME = 'inline-knowledge';
-/** @private The default file extension used for inline knowledge uploads */
+/**
+ * The default file extension used for inline knowledge uploads.
+ *
+ * @private
+ */
 const INLINE_KNOWLEDGE_EXTENSION = '.txt';
-/** @private Prefix that identifies base64 data URLs */
+/**
+ * Prefix that identifies base64 data URLs.
+ *
+ * @private
+ */
 const DATA_URL_PREFIX = 'data:';
 /**
- * @private Retrieves the first meaningful line from the inline content.
+ * Retrieves the first meaningful line from the inline content.
+ *
+ * @private
  */
 function getFirstNonEmptyLine(content) {
     const lines = content.split(/\r?\n/);
@@ -6725,7 +6768,9 @@ function getFirstNonEmptyLine(content) {
     return null;
 }
 /**
- * @private Determines the base file name by normalizing the first non-empty line.
+ * Determines the base file name by normalizing the first non-empty line.
+ *
+ * @private
  */
 function deriveBaseFilename(content) {
     const firstLine = getFirstNonEmptyLine(content);
@@ -6736,7 +6781,9 @@ function deriveBaseFilename(content) {
     return normalized || INLINE_KNOWLEDGE_BASE_NAME;
 }
 /**
- * @private Converts inline knowledge into the internal metadata form used for uploads.
+ * Converts inline knowledge into the internal metadata form used for uploads.
+ *
+ * @private
  */
 function createInlineKnowledgeSourceFile(content) {
     const trimmedContent = content.trim();
@@ -6759,7 +6806,9 @@ function isDataUrlKnowledgeSource(source) {
     return typeof source === 'string' && source.startsWith(DATA_URL_PREFIX);
 }
 /**
- * @private Converts a stored inline knowledge file into a data URL for backwards compatibility.
+ * Converts a stored inline knowledge file into a data URL for backwards compatibility.
+ *
+ * @private
  */
 function inlineKnowledgeSourceToDataUrl(source) {
     const base64 = source.buffer.toString('base64');
@@ -6819,9 +6868,7 @@ function parseDataUrlKnowledgeSource(source) {
         return null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * KNOWLEDGE commitment definition
@@ -7025,9 +7072,7 @@ class LanguageCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, languageSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * @@@
@@ -7293,6 +7338,7 @@ function serializeToolRuntimeContext(context) {
  *
  * @param listener - Listener notified about tool progress.
  * @returns Hidden token used to route progress updates.
+ *
  * @private internal runtime wiring for commitment tools
  */
 function registerToolCallProgressListener(listener) {
@@ -7305,14 +7351,13 @@ function registerToolCallProgressListener(listener) {
  * Unregisters one in-memory progress listener.
  *
  * @param token - Token previously created by `registerToolCallProgressListener`.
+ *
  * @private internal runtime wiring for commitment tools
  */
 function unregisterToolCallProgressListener(token) {
     toolCallProgressListeners.delete(token);
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Resolves runtime context from hidden tool arguments.
@@ -7673,9 +7718,7 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
         return createMemoryToolFunctions();
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * AGENT MESSAGE commitment definition
@@ -8005,9 +8048,7 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, messageSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USER MESSAGE commitment definition
@@ -8138,9 +8179,7 @@ class MessageSuffixCommitmentDefinition extends BaseCommitmentDefinition {
         return requirements;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META commitment definition
@@ -8287,9 +8326,7 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
         return knownTypes.includes(metaType.toUpperCase());
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META COLOR commitment definition
@@ -8385,9 +8422,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META DOMAIN commitment definition
@@ -8452,9 +8487,7 @@ class MetaDomainCommitmentDefinition extends BaseCommitmentDefinition {
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META DISCLAIMER commitment definition
@@ -8522,9 +8555,7 @@ class MetaDisclaimerCommitmentDefinition extends BaseCommitmentDefinition {
         return requirements;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META FONT commitment definition
@@ -8607,9 +8638,7 @@ class MetaFontCommitmentDefinition extends BaseCommitmentDefinition {
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META IMAGE commitment definition
@@ -8694,9 +8723,7 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META INPUT PLACEHOLDER commitment definition.
@@ -8759,9 +8786,7 @@ class MetaInputPlaceholderCommitmentDefinition extends BaseCommitmentDefinition
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META LINK commitment definition
@@ -8868,9 +8893,7 @@ class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
         }
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * META VOICE commitment definition
@@ -8939,9 +8962,7 @@ class MetaVoiceCommitmentDefinition extends BaseCommitmentDefinition {
         return trimmedContent || null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * MODEL commitment definition
@@ -9179,9 +9200,7 @@ class ModelCommitmentDefinition extends BaseCommitmentDefinition {
         return result;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * NOTE commitment definition
@@ -9343,9 +9362,7 @@ class OpenCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * PERSONA commitment definition
@@ -9484,9 +9501,7 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * RULE commitment definition
@@ -9567,15 +9582,14 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToPromptSuffix(requirementsWithRule, ruleSection);
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Creates the canonical system-message body for one writing-sample commitment.
  *
  * @param content - Explicit 1:1 sample text.
  * @returns Writing-sample guidance ready for one system-message section.
+ *
  * @private internal utility of writing commitments
  */
 function createWritingSampleSection(content) {
@@ -9593,6 +9607,7 @@ function createWritingSampleSection(content) {
  *
  * @param content - Writing-only instructions.
  * @returns Writing-rules guidance ready for one system-message section.
+ *
  * @private internal utility of writing commitments
  */
 function createWritingRulesSection(content) {
@@ -9605,9 +9620,7 @@ function createWritingRulesSection(content) {
         ${content}
     `);
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Legacy `SAMPLE` / `EXAMPLE` commitment definition.
@@ -9686,9 +9699,7 @@ class SampleCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, this.createSystemMessageSection('Writing sample', createWritingSampleSection(trimmedContent)), '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * SCENARIO commitment definition
@@ -9810,9 +9821,7 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, scenarioSection, '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * STYLE commitment definition
@@ -9909,6 +9918,7 @@ const TEAM_TOOL_FALLBACK_NAME = 'teammate';
  *
  * @param teammateLabel - Human-readable teammate label.
  * @returns Normalized teammate identifier for TEAM tool names.
+ *
  * @private internal helper of TEAM tool-name generation
  */
 function normalizeTeammateToolNamePart(teammateLabel) {
@@ -9924,6 +9934,7 @@ function normalizeTeammateToolNamePart(teammateLabel) {
  * @param _teammateUrl - Canonical teammate URL (kept for API compatibility, not used).
  * @param teammateLabel - Human-readable teammate label used as the basis for the name.
  * @returns TEAM tool name derived from the label.
+ *
  * @private internal utility of TEAM commitments and chat UI mapping
  */
 function createTeamToolName(_teammateUrl, teammateLabel) {
@@ -9931,9 +9942,21 @@ function createTeamToolName(_teammateUrl, teammateLabel) {
     return `${TEAM_TOOL_PREFIX}${normalizedLabel}`;
 }
 
+/**
+ * Pattern matching agent URLs inside TEAM commitment content.
+ */
 const urlRegex = /https?:\/\/[^\s]+/gi;
+/**
+ * Pattern matching punctuation that often trails teammate URLs in prose.
+ */
 const trailingPunctuationRegex = /[),.;!?]+$/;
+/**
+ * Clause separators used while splitting TEAM instruction context.
+ */
 const clauseSeparators = ['.', '?', '!', ';', ','];
+/**
+ * Conjunction separators used while splitting TEAM instruction context.
+ */
 const conjunctionSeparators = [' and ', ' or '];
 /**
  * Parses TEAM commitment content into teammates with instructions.
@@ -9981,6 +10004,9 @@ function parseTeamCommitmentContent(content, options = {}) {
     }
     return teammates;
 }
+/**
+ * Extracts the instruction fragment associated with one teammate URL.
+ */
 function extractInstructionContext(line, matches, matchIndex) {
     var _a;
     const match = matches[matchIndex];
@@ -10006,6 +10032,9 @@ function extractInstructionContext(line, matches, matchIndex) {
     }
     return `${prefix} ${suffix}`.trim();
 }
+/**
+ * Trims content after the last detected clause delimiter.
+ */
 function trimAfterLastDelimiter(text) {
     const match = findLastDelimiter(text);
     if (!match) {
@@ -10013,6 +10042,9 @@ function trimAfterLastDelimiter(text) {
     }
     return text.slice(match.index + match.length);
 }
+/**
+ * Trims content before the last detected clause delimiter.
+ */
 function trimBeforeLastDelimiter(text) {
     const cleaned = text.replace(/^[,;:]\s*/g, '');
     const match = findLastDelimiter(cleaned);
@@ -10021,6 +10053,9 @@ function trimBeforeLastDelimiter(text) {
     }
     return cleaned.slice(0, match.index);
 }
+/**
+ * Finds the last clause or conjunction delimiter in a string.
+ */
 function findLastDelimiter(text) {
     let bestIndex = -1;
     let bestLength = 0;
@@ -10044,6 +10079,9 @@ function findLastDelimiter(text) {
     }
     return { index: bestIndex, length: bestLength };
 }
+/**
+ * Normalizes teammate instruction text after URL extraction.
+ */
 function normalizeInstructionText(text) {
     if (!text) {
         return '';
@@ -10057,6 +10095,9 @@ function normalizeInstructionText(text) {
     normalized = normalizeWhitespaces(normalized).trim();
     return normalized;
 }
+/**
+ * Creates a readable teammate label from an agent URL.
+ */
 function createTeammateLabel(url) {
     try {
         const parsed = new URL(url);
@@ -10076,12 +10117,19 @@ function createTeammateLabel(url) {
         return url;
     }
 }
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
- * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Map of team tool functions.
  */
-
 const teamToolFunctions = {};
+/**
+ * Map of team tool titles.
+ */
 const teamToolTitles = {};
+/**
+ * Constant for remote agents by Url.
+ */
 const remoteAgentsByUrl = new Map();
 /**
  * TEAM commitment definition
@@ -10445,9 +10493,7 @@ function createTeamToolFunction(entry) {
         return JSON.stringify(result);
     };
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * TEMPLATE commitment definition
@@ -10568,9 +10614,7 @@ class TemplateCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USE commitment definition
@@ -10682,9 +10726,7 @@ class UseCommitmentDefinition extends BaseCommitmentDefinition {
         return knownTypes.includes(useType.toUpperCase());
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * All `USE` commitment types currently participating in final system-message aggregation.
@@ -10707,6 +10749,7 @@ const AGGREGATED_USE_COMMITMENT_PLACEHOLDER_PREFIX = '# AGGREGATED USE COMMITMEN
  *
  * @param type - Commitment type to check.
  * @returns `true` when the commitment participates in `USE` system-message aggregation.
+ *
  * @private internal utility of `aggregateUseCommitmentSystemMessages`
  */
 function isAggregatedUseCommitmentType(type) {
@@ -10717,6 +10760,7 @@ function isAggregatedUseCommitmentType(type) {
  *
  * @param type - Aggregated `USE` commitment type.
  * @returns Single-line placeholder comment stored in the interim system message.
+ *
  * @private internal utility of `appendAggregatedUseCommitmentPlaceholder`
  */
 function getAggregatedUseCommitmentPlaceholder(type) {
@@ -10727,6 +10771,7 @@ function getAggregatedUseCommitmentPlaceholder(type) {
  *
  * @param additionalInstructions - Deduplicated instruction blocks collected from the agent source.
  * @returns Combined instruction text ready for `formatOptionalInstructionBlock`.
+ *
  * @private internal utility of `createAggregatedUseCommitmentSystemMessage`
  */
 function combineAdditionalInstructions(additionalInstructions) {
@@ -10738,6 +10783,7 @@ function combineAdditionalInstructions(additionalInstructions) {
  * @param type - Aggregated `USE` commitment type.
  * @param additionalInstructions - Distinct additional instructions in source order.
  * @returns Final system-message block for the commitment type.
+ *
  * @private internal utility of `aggregateUseCommitmentSystemMessages`
  */
 function createAggregatedUseCommitmentSystemMessage(type, additionalInstructions) {
@@ -10776,6 +10822,7 @@ function createAggregatedUseCommitmentSystemMessage(type, additionalInstructions
  * @param requirements - Current model requirements.
  * @param type - Aggregated `USE` commitment type being applied.
  * @returns Requirements with the placeholder inserted when it was not already present.
+ *
  * @private internal utility of `USE` commitments
  */
 function appendAggregatedUseCommitmentPlaceholder(requirements, type) {
@@ -10799,6 +10846,7 @@ function appendAggregatedUseCommitmentPlaceholder(requirements, type) {
  * @param requirements - Model requirements produced by commitment-by-commitment application.
  * @param commitments - Filtered commitments in their original source order.
  * @returns Requirements with aggregated `USE` system-message sections.
+ *
  * @private internal utility of `createAgentModelRequirementsWithCommitments`
  */
 function aggregateUseCommitmentSystemMessages(requirements, commitments) {
@@ -11091,9 +11139,7 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Base Google Calendar API URL.
@@ -11364,9 +11410,7 @@ function removeTokenFromLine(line, token) {
     const filteredTokens = tokens.filter((lineToken) => lineToken.replace(/[),.;:!?]+$/g, '') !== token);
     return filteredTokens.join(' ').trim();
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Wallet metadata used by USE CALENDAR when resolving Google Calendar credentials.
@@ -12317,9 +12361,7 @@ function addConfiguredCalendarIfMissing(configuredCalendars, calendarReference)
         ...(calendarReference.tokenRef ? { tokenRef: calendarReference.tokenRef } : {}),
     });
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Lightweight email token matcher used for `USE EMAIL` first-line parsing.
@@ -12585,9 +12627,7 @@ function addUseEmailTools(existingTools) {
         },
     ];
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USE IMAGE GENERATOR commitment definition
@@ -12678,9 +12718,7 @@ class UseImageGeneratorCommitmentDefinition extends BaseCommitmentDefinition {
                 `));
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USE MCP commitment definition
@@ -12755,9 +12793,7 @@ class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USE POPUP commitment definition
@@ -12893,9 +12929,7 @@ class UsePopupCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Tool name used by the USE PRIVACY commitment.
@@ -13067,9 +13101,7 @@ class UsePrivacyCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /* eslint-disable no-magic-numbers */
 /**
@@ -13876,9 +13908,7 @@ function createGitHubRepositoryReference(owner, repository, defaultBranch) {
         defaultBranch,
     };
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Wallet metadata used by USE PROJECT when resolving GitHub credentials.
@@ -14737,9 +14767,7 @@ function addConfiguredProjectIfMissing(configuredProjects, repositoryReference)
         defaultBranch: repositoryReference.defaultBranch,
     });
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * A search engine implementation that uses the SerpApi to fetch Google search results.
@@ -14950,9 +14978,7 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Maximum allowed source length for create-agent payloads.
@@ -15149,9 +15175,7 @@ class UseSpawnCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Creates system-message instructions for `USE TIMEOUT`.
@@ -15216,9 +15240,7 @@ function parseToolExecutionEnvelope(rawValue) {
         return null;
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Builds a disabled timeout-tool payload.
@@ -15950,11 +15972,9 @@ class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition {
      */
     getToolFunctions() {
         return createTimeoutToolFunctions();
-    }
-}
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+    }
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * USE TIME commitment definition
@@ -16101,9 +16121,7 @@ class UseTimeCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Tool name used by the USE USER LOCATION commitment.
@@ -16316,9 +16334,7 @@ class UseUserLocationCommitmentDefinition extends BaseCommitmentDefinition {
         };
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * `WRITING RULES` commitment definition.
@@ -16394,9 +16410,7 @@ class WritingRulesCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, this.createSystemMessageSection('Writing rules', createWritingRulesSection(trimmedContent)), '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * `WRITING SAMPLE` commitment definition.
@@ -16466,9 +16480,7 @@ class WritingSampleCommitmentDefinition extends BaseCommitmentDefinition {
         return this.appendToSystemMessage(requirements, this.createSystemMessageSection('Writing sample', createWritingSampleSection(trimmedContent)), '\n\n');
     }
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Placeholder commitment definition for commitments that are not yet implemented
@@ -16630,13 +16642,12 @@ const COMMITMENT_REGISTRY = [
     new NotYetImplementedCommitmentDefinition('CONTEXT'),
     // <- TODO: Prompt: Leverage aliases instead of duplicating commitment definitions
 ];
-/**
- * TODO: [🧠] Maybe create through standardized $register
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// TODO: [🧠] Maybe create through standardized $register
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Gets all available commitment definitions
+ *
  * @returns Array of all commitment definitions
  *
  * @public exported from `@promptbook/core`
@@ -16649,6 +16660,7 @@ function getAllCommitmentDefinitions() {
  * Collects tool functions from all commitment definitions.
  *
  * @returns Map of tool function implementations.
+ *
  * @private internal helper for commitment tool registry
  */
 function collectCommitmentToolFunctions() {
@@ -16670,6 +16682,7 @@ function collectCommitmentToolFunctions() {
  *
  * @param getFunctions - Provider of current tool functions.
  * @returns Proxy exposing tool functions as properties.
+ *
  * @private internal helper for commitment tool registry
  */
 function createToolFunctionsProxy(getFunctions) {
@@ -16707,10 +16720,11 @@ function createToolFunctionsProxy(getFunctions) {
         },
     });
 }
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
- * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Constant for commitment tool functions proxy.
  */
-
 const commitmentToolFunctionsProxy = createToolFunctionsProxy(collectCommitmentToolFunctions);
 /**
  * Gets all function implementations provided by all commitments
@@ -16727,7 +16741,7 @@ function getAllCommitmentsToolFunctionsForBrowser() {
  * Wrapper around `window.prompt` synchronous function that interacts with the user via browser prompt
  *
  * Warning: It is used for testing and mocking
- *          **NOT intended to use in the production** due to its synchronous nature.
+ * **NOT intended to use in the production** due to its synchronous nature.
  *
  * @public exported from `@promptbook/browser`
  */
@@ -16756,7 +16770,7 @@ class SimplePromptInterfaceTools {
         return answer;
     }
 }
-/** Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Safely retrieves the global scope object (window in browser, global in Node.js)
@@ -16764,7 +16778,7 @@ class SimplePromptInterfaceTools {
  *
  * Note: `$` is used to indicate that this function is not a pure function - it access global scope
  *
- *  @private internal function of `$Register`
+ * @private internal function of `$Register`
  */
 function $getGlobalScope() {
     return Function('return this')();
@@ -16823,13 +16837,13 @@ class $Register {
  * Central point for registering and accessing different types of content scrapers.
  *
  * Note: `$` is used to indicate that this interacts with the global scope
+ *
  * @singleton Only one instance of each register is created per build, but there can be more than one in different build modules
+ *
  * @public exported from `@promptbook/core`
  */
 const $scrapersRegister = new $Register('scraper_constructors');
-/**
- * TODO: [®] DRY Register logic
- */
+// TODO: [®] DRY Register logic
 
 /**
  * Provides a collection of scrapers optimized for browser environments.
@@ -16955,12 +16969,13 @@ class BrowserSpeechRecognition {
         }
     }
 }
-/** Note: [🔵] Code for browser speech-recognition adapter [BrowserSpeechRecognition](src/speech-recognition/BrowserSpeechRecognition.ts) should never be published outside of `@promptbook/browser` */
-/** TODO: !!!! Search ACRY for `window` and put -> [🔵] */
+// Note: [🔵] Code for browser speech-recognition adapter [BrowserSpeechRecognition](src/speech-recognition/BrowserSpeechRecognition.ts) should never be published outside of `@promptbook/browser`
+// TODO: !!!! Search ACRY for `window` and put -> [🔵]
 
 /**
  * Creates a PromptbookStorage backed by IndexedDB.
  * Uses a single object store named 'promptbook'.
+ *
  * @private for `getIndexedDbStorage`
  */
 function makePromptbookStorageFromIndexedDb(options) {
@@ -17033,7 +17048,7 @@ function getIndexedDbStorage(options) {
     indexedDbStorageCache.set(cacheKey, storage);
     return storage;
 }
-/** Note: [🔵] Code for browser storage helper [getIndexedDbStorage](src/storage/local-storage/getIndexedDbStorage.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser storage helper [getIndexedDbStorage](src/storage/local-storage/getIndexedDbStorage.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Stringify the PipelineJson with proper formatting
@@ -17061,12 +17076,10 @@ function stringifyPipelineJson(pipeline) {
     pipelineJsonStringified += '\n';
     return pipelineJsonStringified;
 }
-/**
- * TODO: [🐝] Not Working properly @see https://promptbook.studio/examples/mixed-knowledge.book
- * TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
- * TODO: [🧠] Maybe more elegant solution than replacing via regex
- * TODO: [🍙] Make some standard order of json properties
- */
+// TODO: [🐝] Not Working properly @see https://promptbook.studio/examples/mixed-knowledge.book
+// TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
+// TODO: [🧠] Maybe more elegant solution than replacing via regex
+// TODO: [🍙] Make some standard order of json properties
 
 /**
  * Creates a Promptbook storage interface from a web storage object.
@@ -17097,10 +17110,8 @@ function makePromptbookStorageFromWebStorage(webStorage) {
         },
     };
 }
-/**
- * TODO: [🧠] Should this be named `makePromptbookStorageFromWebStorage` vs `createPromptbookStorageFromWebStorage`
- * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- */
+// TODO: [🧠] Should this be named `makePromptbookStorageFromWebStorage` vs `createPromptbookStorageFromWebStorage`
+// TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
 
 /**
  * Cache storage
@@ -17123,7 +17134,7 @@ function getLocalStorage() {
     promptbookLocalStorage = makePromptbookStorageFromWebStorage(localStorage);
     return promptbookLocalStorage;
 }
-/** Note: [🔵] Code for browser storage helper [getLocalStorage](src/storage/local-storage/getLocalStorage.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser storage helper [getLocalStorage](src/storage/local-storage/getLocalStorage.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Cache storage
@@ -17146,7 +17157,7 @@ function getSessionStorage() {
     promptbookSessionStorage = makePromptbookStorageFromWebStorage(sessionStorage);
     return promptbookSessionStorage;
 }
-/** Note: [🔵] Code for browser storage helper [getSessionStorage](src/storage/local-storage/getSessionStorage.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser storage helper [getSessionStorage](src/storage/local-storage/getSessionStorage.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Normalizes a domain-like string into a comparable hostname form.
@@ -17156,6 +17167,7 @@ function getSessionStorage() {
  *
  * @param rawDomain - Raw domain value (for example `my-agent.com` or `https://my-agent.com/path`).
  * @returns Normalized hostname or `null` when the value cannot be normalized.
+ *
  * @private utility for host/domain matching
  */
 function normalizeDomainForMatching(rawDomain) {
@@ -17178,6 +17190,7 @@ function normalizeDomainForMatching(rawDomain) {
  *
  * @param value - Raw value to inspect.
  * @returns True when the value starts with `http://` or `https://`.
+ *
  * @private utility for host/domain matching
  */
 function hasHttpProtocol(value) {
@@ -17223,6 +17236,7 @@ function createDefaultAgentName(agentSource) {
  *
  * @param agentSource - Raw agent source.
  * @returns Parsed prelude with shared line metadata.
+ *
  * @private internal utility of book agent-source parsing
  */
 function parseAgentSourcePrelude(agentSource) {
@@ -17398,6 +17412,7 @@ function parseAgentSourceWithCommitments(agentSource) {
  *
  * @param text - Text to extract parameters from
  * @returns Array of parsed parameters with unified representation
+ *
  * @public exported from `@promptbook/core`
  */
 function parseParameters(text) {
@@ -17826,9 +17841,7 @@ function normalizeMetaDomain(content) {
     const trimmed = spaceTrim$1(content);
     return normalizeDomainForMatching(trimmed) || trimmed.toLowerCase();
 }
-/**
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */
+// TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
 
 /**
  * Converts Blob, File or MediaSource to url using URL.createObjectURL
@@ -17901,7 +17914,7 @@ class ObjectUrl extends Registration {
         return new URL(this.src);
     }
 }
-/** Note: [🔵] Code for browser file helper [ObjectUrl](src/utils/files/ObjectUrl.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser file helper [ObjectUrl](src/utils/files/ObjectUrl.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Download a File in a browser
@@ -17921,7 +17934,7 @@ async function $induceFileDownload(fileOrBlobOrUrl) {
     link.click();
     await objectUrl.destroy();
 }
-/** Note: [🔵] Code for browser file helper [$induceFileDownload](src/utils/files/$induceFileDownload.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser file helper [$induceFileDownload](src/utils/files/$induceFileDownload.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Download a Book in a browser
@@ -17940,7 +17953,7 @@ async function $induceBookDownload(book) {
     });
     return /* not await */ $induceFileDownload(bookFile);
 }
-/** Note: [🔵] Code for browser file helper [$induceBookDownload](src/utils/files/$induceBookDownload.ts) should never be published outside of `@promptbook/browser` */
+// Note: [🔵] Code for browser file helper [$induceBookDownload](src/utils/files/$induceBookDownload.ts) should never be published outside of `@promptbook/browser`
 
 /**
  * Keep-alive helpers used for streaming chat responses.
@@ -17952,12 +17965,10 @@ async function $induceBookDownload(book) {
  * @private internal streaming helper for Promptbook chat connections
  */
 const CHAT_STREAM_KEEP_ALIVE_TOKEN = 'STREAM_KEEP_ALIVE';
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- *  Number of padding lines to add at the end of the book content
+ * Number of padding lines to add at the end of the book content
  *
  * @public exported from `@promptbook/core`
  */
@@ -17994,9 +18005,7 @@ function padBook(content) {
     const linesToAdd = PADDING_LINES - trailingEmptyLines;
     return (content + '\n'.repeat(linesToAdd));
 }
-/**
- * TODO: [🧠] Maybe export
- */
+// TODO: [🧠] Maybe export
 
 /**
  * Type guard to check if a string is a valid agent source
@@ -18026,6 +18035,7 @@ function validateBook(source) {
  * Default book
  *
  * @deprecated Use `$generateBookBoilerplate` instead
+ *
  * @public exported from `@promptbook/core`
  */
 padBook(validateBook(spaceTrim$1(`
@@ -18047,6 +18057,7 @@ padBook(validateBook(spaceTrim$1(`
  * @param {string} pipelineString the candidate for a pipeline string
  * @returns {PipelineString} the same string as input, but validated as valid
  * @throws {ParseError} if the string is not a valid pipeline string
+ *
  * @public exported from `@promptbook/core`
  */
 function validatePipelineString(pipelineString) {
@@ -18065,9 +18076,7 @@ function validatePipelineString(pipelineString) {
     // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
     return pipelineString;
 }
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- */
+// TODO: [🧠][🈴] Where is the best location for this file
 
 /**
  * Function `isValidPipelineString` will validate the if the string is a valid pipeline string
@@ -18075,6 +18084,7 @@ function validatePipelineString(pipelineString) {
  *
  * @param {string} pipelineString the candidate for a pipeline string
  * @returns {boolean} if the string is a valid pipeline string
+ *
  * @public exported from `@promptbook/core`
  */
 function isValidPipelineString(pipelineString) {
@@ -18087,9 +18097,7 @@ function isValidPipelineString(pipelineString) {
         return false;
     }
 }
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- */
+// TODO: [🧠][🈴] Where is the best location for this file
 
 /**
  * Tag function for notating a pipeline with a book\`...\ notation as template literal
@@ -18102,6 +18110,7 @@ function isValidPipelineString(pipelineString) {
  * @param strings The static string parts of the template literal
  * @param values The dynamic values embedded within the template literal used as data
  * @returns the pipeline string
+ *
  * @public exported from `@promptbook/core`
  */
 function book(strings, ...values) {
@@ -18128,10 +18137,8 @@ function book(strings, ...values) {
     }
     return padBook(bookString);
 }
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// TODO: [🧠][🈴] Where is the best location for this file
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Tool call name emitted while preparing a GPT assistant for an agent.
@@ -18176,9 +18183,7 @@ const CHAT_STREAM_WHITESPACE_DECODERS = [
     { token: CHAT_STREAM_WHITESPACE_TOKEN_TAB, value: '\t' },
     { token: CHAT_STREAM_WHITESPACE_TOKEN_SPACE, value: ' ' },
 ];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Converts encoded whitespace markers back into real whitespace so the UI can render the message
@@ -18196,6 +18201,9 @@ function decodeChatStreamWhitespaceFromTransport(content) {
     }, content);
 }
 
+/**
+ * Constant for raw tool call ID fields.
+ */
 const RAW_TOOL_CALL_ID_FIELDS = ['callId', 'call_id', 'id'];
 /**
  * Builds a deterministic idempotency key for tool calls so the UI can track updates.
@@ -18226,6 +18234,9 @@ function resolveToolCallIdempotencyKey(toolCall) {
     }
     return `fallback:${toolCall.name}`;
 }
+/**
+ * Gets arguments key.
+ */
 function getArgumentsKey(value) {
     if (typeof value === 'string') {
         return value;
@@ -18299,6 +18310,7 @@ function mergeToolCalls(existingToolCalls, incomingToolCalls) {
  * @param existingToolCall - Previous snapshot.
  * @param incomingToolCall - New snapshot.
  * @returns One merged snapshot.
+ *
  * @private helper of `mergeToolCalls`
  */
 function mergeToolCallSnapshot(existingToolCall, incomingToolCall) {
@@ -18321,6 +18333,7 @@ function mergeToolCallSnapshot(existingToolCall, incomingToolCall) {
  * @param existingToolCall - Previous snapshot.
  * @param incomingToolCall - New snapshot.
  * @returns Resolved lifecycle state or `undefined` when neither snapshot provides enough data.
+ *
  * @private helper of `mergeToolCalls`
  */
 function resolveMergedToolCallState(existingToolCall, incomingToolCall) {
@@ -18334,6 +18347,7 @@ function resolveMergedToolCallState(existingToolCall, incomingToolCall) {
  *
  * @param toolCall - Tool call snapshot to inspect.
  * @returns Inferred lifecycle state or `undefined`.
+ *
  * @private helper of `mergeToolCalls`
  */
 function inferToolCallState(toolCall) {
@@ -18357,6 +18371,7 @@ function inferToolCallState(toolCall) {
  * @param existingValues - Previous list.
  * @param incomingValues - Incoming list.
  * @returns Deduplicated merged list or `undefined`.
+ *
  * @private helper of `mergeToolCalls`
  */
 function mergeUnknownLists(existingValues, incomingValues) {
@@ -18383,6 +18398,7 @@ function mergeUnknownLists(existingValues, incomingValues) {
  *
  * @param value - Value to serialize.
  * @returns String signature.
+ *
  * @private helper of `mergeToolCalls`
  */
 function serializeValueForMerge(value) {
@@ -18400,6 +18416,7 @@ function serializeValueForMerge(value) {
  *
  * @param toolCalls - Mutable list to deduplicate in-place.
  * @returns The same array after removing redundant preparation entries.
+ *
  * @private helper of `mergeToolCalls`
  */
 function deduplicatePreparationToolCalls(toolCalls) {
@@ -18443,6 +18460,7 @@ function getAllCommitmentsToolTitles() {
  * Restricts an Updatable to a (2) BehaviorSubject variant
  *
  * @see Updatable
+ *
  * @private internal utility <- TODO: [🧠] Maybe export from `@promptbook/types`
  */
 function asUpdatableSubject(value) {
@@ -18467,9 +18485,7 @@ function asUpdatableSubject(value) {
         return new BehaviorSubject(value);
     }
 }
-/**
- * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
- */
+// TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
 
 /**
  * Takes an item or an array of items and returns an array of items
@@ -18502,6 +18518,7 @@ const MULTIPLE_PROVIDER_PROFILE = {
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
  * Note: Internal utility of `joinLlmExecutionTools` but exposed type
+ *
  * @public exported from `@promptbook/core`
  */
 class MultipleLlmExecutionTools {
@@ -18664,16 +18681,16 @@ class MultipleLlmExecutionTools {
  * `MultipleLlmExecutionTools` object. It provides failover and aggregation logic:
  *
  * 1.  **Failover**: When a model call is made, it tries providers in the order they were provided.
- *     If the first provider doesn't support the requested model or fails, it tries the next one.
+ * If the first provider doesn't support the requested model or fails, it tries the next one.
  * 2.  **Aggregation**: `listModels` returns a combined list of all models available from all providers.
  * 3.  **Empty case**: If no tools are provided, it logs a warning (as Promptbook requires LLMs to function).
  *
+ * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`.
+ *
  * @param title - A descriptive title for this collection of joined tools
  * @param llmExecutionTools - An array of execution tools to be joined
  * @returns A single unified execution tool wrapper
  *
- * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`.
- *
  * @public exported from `@promptbook/core`
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
@@ -18710,10 +18727,8 @@ function joinLlmExecutionTools(title, ...llmExecutionTools) {
     }
     return new MultipleLlmExecutionTools(title || 'Multiple LLM Providers joined by `joinLlmExecutionTools`', ...llmExecutionTools);
 }
-/**
- * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
- */
+// TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
+// TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
 
 /**
  * Just returns the given `LlmExecutionTools` or joins multiple into one
@@ -18727,10 +18742,8 @@ function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools) {
         : joinLlmExecutionTools('Multiple LLM Providers joined by `getSingleLlmExecutionTools`', ..._llms);
     return llmTools;
 }
-/**
- * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
- */
+// TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
+// TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
 
 var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
@@ -18739,8 +18752,9 @@ var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"
  *
  * @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 -->`);
@@ -18752,6 +18766,7 @@ function prettifyMarkdown(content) {
  * @deprecated TODO: [🥍][🧠] Backup original files in `PipelineJson` same as in Promptbook.studio
  * @param pipelineJson Promptbook in JSON format (.bookc)
  * @returns Promptbook in string format (.book.md)
+ *
  * @public exported from `@promptbook/core`
  */
 function pipelineJsonToString(pipelineJson) {
@@ -18868,6 +18883,8 @@ function pipelineJsonToString(pipelineJson) {
     return validatePipelineString(pipelineString);
 }
 /**
+ * Handles task parameter Json to string.
+ *
  * @private internal utility of `pipelineJsonToString`
  */
 function taskParameterJsonToString(taskParameterJson) {
@@ -18878,13 +18895,11 @@ function taskParameterJsonToString(taskParameterJson) {
     }
     return parameterString;
 }
-/**
- * TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
- * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
- * TODO: [🏛] Maybe make some markdown builder
- * TODO: [🏛] Escape all
- * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
- */
+// TODO: [🛋] Implement new features and commands into `pipelineJsonToString` + `taskParameterJsonToString` , use `stringifyCommand`
+// TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
+// TODO: [🏛] Maybe make some markdown builder
+// TODO: [🏛] Escape all
+// TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
 
 /**
  * Validates PipelineJson if it is logically valid
@@ -18901,6 +18916,7 @@ function taskParameterJsonToString(taskParameterJson) {
  * @param pipeline valid or invalid PipelineJson
  * @returns the same pipeline if it is logically valid
  * @throws {PipelineLogicError} on logical error in the pipeline
+ *
  * @public exported from `@promptbook/core`
  */
 function validatePipeline(pipeline) {
@@ -18925,6 +18941,8 @@ function validatePipeline(pipeline) {
     return pipeline;
 }
 /**
+ * Validates pipeline inner function.
+ *
  * @private internal function for `validatePipeline`
  */
 function validatePipeline_InnerFunction(pipeline) {
@@ -19169,20 +19187,19 @@ function validatePipeline_InnerFunction(pipeline) {
  *     >  * -   ...
  *     >  ex port function validatePipeline(promptbook: really_unknown): asserts promptbook is PipelineJson {
  */
-/**
- * TODO: [🧳][main] !!4 Validate that all examples match expectations
- * TODO: [🧳][🐝][main] !!4 Validate that knowledge is valid (non-void)
- * TODO: [🧳][main] !!4 Validate that persona can be used only with CHAT variant
- * TODO: [🧳][main] !!4 Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
- * TODO: [🧳][main] !!4 Validate that reserved parameter is not used as joker
- * TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- */
+// TODO: [🧳][main] !!4 Validate that all examples match expectations
+// TODO: [🧳][🐝][main] !!4 Validate that knowledge is valid (non-void)
+// TODO: [🧳][main] !!4 Validate that persona can be used only with CHAT variant
+// TODO: [🧳][main] !!4 Validate that parameter with reserved name not used RESERVED_PARAMETER_NAMES
+// TODO: [🧳][main] !!4 Validate that reserved parameter is not used as joker
+// TODO: [🧠] Validation not only logic itself but imports around - files and websites and rerefenced pipelines exists
+// TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
 
 /**
  * Unprepare just strips the preparation data of the pipeline
  *
  * @deprecated In future version this function will be removed or deprecated
+ *
  * @public exported from `@promptbook/core`
  */
 function unpreparePipeline(pipeline) {
@@ -19211,18 +19228,17 @@ function unpreparePipeline(pipeline) {
         },
     });
 }
-/**
- * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- * TODO: Write tests for `preparePipeline`
- * TODO: [🍙] Make some standard order of json properties
- */
+// TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
+// TODO: Write tests for `preparePipeline`
+// TODO: [🍙] Make some standard order of json properties
 
 /**
  * Library of pipelines that groups together pipelines for an application.
  * This implementation is a very thin wrapper around the Array / Map of pipelines.
  *
- * @private internal function of `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
  * @see https://github.com/webgptorg/pipeline#pipeline-collection
+ *
+ * @private internal function of `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
  */
 class SimplePipelineCollection {
     /**
@@ -19326,6 +19342,7 @@ class SimplePipelineCollection {
  *
  * @param promptbookSources
  * @returns PipelineCollection
+ *
  * @public exported from `@promptbook/core`
  */
 function createPipelineCollectionFromJson(...promptbooks) {
@@ -19379,6 +19396,7 @@ function isPipelinePrepared(pipeline) {
  *
  * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
+ *
  * @private internal helper function of `asPromise` method of `ExecutionTask`
  */
 function assertsTaskSuccessful(executionResult) {
@@ -19409,9 +19427,7 @@ function assertsTaskSuccessful(executionResult) {
                 `));
     }
 }
-/**
- * TODO: [🧠] Can this return type be better typed than void
- */
+// TODO: [🧠] Can this return type be better typed than void
 
 /**
  * Helper to create a new task
@@ -19602,10 +19618,8 @@ function createTask(options) {
         },
     };
 }
-/**
- * TODO: Maybe allow to terminate the task and add getter `isFinished` or `status`
- * TODO: [🐚] Split into more files and make `PrepareTask` & `RemoteTask` + split the function
- */
+// TODO: Maybe allow to terminate the task and add getter `isFinished` or `status`
+// TODO: [🐚] Split into more files and make `PrepareTask` & `RemoteTask` + split the function
 
 /**
  * Represents the uncertain value
@@ -19673,9 +19687,7 @@ const UNCERTAIN_USAGE = $deepFreeze({
         pagesCount: UNCERTAIN_ZERO_VALUE,
     },
 });
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Function `addUsage` will add multiple usages into one
@@ -19740,6 +19752,7 @@ function addUsage(...usageItems) {
  *
  * @param llmTools - The LLM tools to be intercepted and tracked
  * @returns Full proxy of the tools with added usage tracking capabilities
+ *
  * @public exported from `@promptbook/core`
  */
 function countUsage(llmTools) {
@@ -19837,13 +19850,13 @@ function countUsage(llmTools) {
  * Global registry for storing metadata about all available scrapers and converters.
  *
  * Note: `$` is used to indicate that this interacts with the global scope.
+ *
  * @singleton Only one instance of each register is created per build, but there can be more in different contexts (e.g., tests).
+ *
  * @public exported from `@promptbook/core`
  */
 const $scrapersMetadataRegister = new $Register('scrapers_metadata');
-/**
- * TODO: [®] DRY Register logic
- */
+// TODO: [®] DRY Register logic
 
 /**
  * Creates a message with all registered scrapers
@@ -19928,9 +19941,7 @@ function $registeredScrapersMessage(availableScrapers) {
 
         `);
 }
-/**
- * TODO: [®] DRY Register logic
- */
+// TODO: [®] DRY Register logic
 
 /**
  * Creates unique name for the source
@@ -19949,9 +19960,7 @@ function knowledgeSourceContentToName(knowledgeSourceContent) {
     // <- TODO: Use MAX_FILENAME_LENGTH
     return name;
 }
-/**
- * TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
- */
+// TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
 
 /**
  * Converts a name to a properly formatted subfolder path for cache storage.
@@ -19982,11 +19991,9 @@ async function isFileExisting(filename, fs) {
         .catch(() => false);
     return isFile;
 }
-/**
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
- * TODO: [🖇] What about symlinks?
- */
+// Note: Not [~🟢~] because it is not directly dependent on `fs
+// TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
+// TODO: [🖇] What about symlinks?
 
 /**
  * Convert mime type to file extension
@@ -20026,9 +20033,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
                 `));
     }
 };
-/**
- * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
- */
+// TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
 
 /**
  * Factory function that creates a handler for processing knowledge sources.
@@ -20248,6 +20253,7 @@ async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
  * Prepares the knowledge pieces
  *
  * @see https://github.com/webgptorg/promptbook/discussions/41
+ *
  * @public exported from `@promptbook/core`
  */
 async function prepareKnowledgePieces(knowledgeSources, tools, options) {
@@ -20389,25 +20395,24 @@ async function prepareTasks(pipeline, tools, options) {
     });
     return { tasksPrepared };
 }
-/**
- * TODO: [😂] Adding knowledge should be convert to async high-level abstractions, similar thing with expectations to sync high-level abstractions
- * TODO: [🧠] Add context to each task (if missing)
- * TODO: [🧠] What is better name `prepareTask` or `prepareTaskAndParameters`
- * TODO: [♨][main] !!3 Prepare index the examples and maybe tasks
- * TODO: Write tests for `preparePipeline`
- * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
- * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- */
+// TODO: [😂] Adding knowledge should be convert to async high-level abstractions, similar thing with expectations to sync high-level abstractions
+// TODO: [🧠] Add context to each task (if missing)
+// TODO: [🧠] What is better name `prepareTask` or `prepareTaskAndParameters`
+// TODO: [♨][main] !!3 Prepare index the examples and maybe tasks
+// TODO: Write tests for `preparePipeline`
+// TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+// TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
+// TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
 
 /**
  * Prepare pipeline locally
  *
- * @see https://github.com/webgptorg/promptbook/discussions/196
- *
  * Note: This function does not validate logic of the pipeline
  * Note: This function acts as part of compilation process
  * Note: When the pipeline is already prepared, it returns the same pipeline
+ *
+ * @see https://github.com/webgptorg/promptbook/discussions/196
+ *
  * @public exported from `@promptbook/core`
  */
 async function preparePipeline(pipeline, tools, options) {
@@ -20551,6 +20556,7 @@ async function preparePipeline(pipeline, tools, options) {
  * @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) {
@@ -20616,9 +20622,7 @@ function extractVariablesFromJavascript(script) {
     }
     return variables;
 }
-/**
- * TODO: [🔣] Support for multiple languages - python, java,...
- */
+// TODO: [🔣] Support for multiple languages - python, java,...
 
 /**
  * Parses the task and returns the set of all used parameters
@@ -20626,6 +20630,7 @@ function extractVariablesFromJavascript(script) {
  * @param task the task with used parameters
  * @returns the set of parameter names
  * @throws {ParseError} if the script is invalid
+ *
  * @public exported from `@promptbook/core` <- Note: [👖] This utility is so tightly interconnected with the Promptbook that it is not exported as util but in core
  */
 function extractParameterNamesFromTask(task) {
@@ -20666,9 +20671,7 @@ function extractParameterNamesFromTask(task) {
     }
     return parameterNames;
 }
-/**
- * TODO: [🔣] If script require contentLanguage
- */
+// TODO: [🔣] If script require contentLanguage
 
 /**
  * Contains configuration options for parsing and generating CSV files, such as delimiters and quoting rules.
@@ -20701,8 +20704,9 @@ function csvParse(value /* <- TODO: string_csv */, settings, schema /* <- TODO:
 /**
  * Definition for CSV spreadsheet
  *
+ * TODO: [🏢] Export from package `@promptbook/csv`
+ *
  * @public exported from `@promptbook/core`
- *                          <- TODO: [🏢] Export from package `@promptbook/csv`
  */
 const CsvFormatParser = {
     formatName: 'CSV',
@@ -20792,13 +20796,11 @@ const CsvFormatParser = {
         },
     ],
 };
-/**
- * TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
- * TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `CsvFormatParser` implement `heal
- * TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside CSV objects and other formats
- */
+// TODO: [🍓] In `CsvFormatParser` implement simple `isValid`
+// TODO: [🍓] In `CsvFormatParser` implement partial `canBeValid`
+// TODO: [🍓] In `CsvFormatParser` implement `heal
+// TODO: [🍓] In `CsvFormatParser` implement `subvalueParsers`
+// TODO: [🏢] Allow to expect something inside CSV objects and other formats
 
 /**
  * Definition for JSON format
@@ -20819,17 +20821,15 @@ const JsonFormatParser = {
     },
     subvalueParsers: [],
 };
-/**
- * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_json
- * TODO: [1] Make type for JSON Settings and Schema
- * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
- * TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
- * TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `JsonFormatParser` implement `heal
- * TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside JSON objects and other formats
- */
+// TODO: [🧠] Maybe proper instance of object
+// TODO: [0] Make string_serialized_json
+// TODO: [1] Make type for JSON Settings and Schema
+// TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
+// TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
+// TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
+// TODO: [🍓] In `JsonFormatParser` implement `heal
+// TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
+// TODO: [🏢] Allow to expect something inside JSON objects and other formats
 
 /**
  * Definition for any text - this will be always valid
@@ -20867,15 +20867,13 @@ const TextFormatParser = {
         // <- TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
     ],
 };
-/**
- * TODO: [1] Make type for XML Text and Schema
- * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
- * TODO: [🍓] In `TextFormatParser` implement simple `isValid`
- * TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `TextFormatParser` implement `heal
- * TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside each item of list and other formats
- */
+// TODO: [1] Make type for XML Text and Schema
+// TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
+// TODO: [🍓] In `TextFormatParser` implement simple `isValid`
+// TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
+// TODO: [🍓] In `TextFormatParser` implement `heal
+// TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
+// TODO: [🏢] Allow to expect something inside each item of list and other formats
 
 /**
  * Definition for XML format
@@ -20896,17 +20894,15 @@ const XmlFormatParser = {
     },
     subvalueParsers: [],
 };
-/**
- * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_xml
- * TODO: [1] Make type for XML Settings and Schema
- * TODO: [🧠] What to use for validating XMLs - XSD,...
- * TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
- * TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `XmlFormatParser` implement `heal
- * TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside XML and other formats
- */
+// TODO: [🧠] Maybe proper instance of object
+// TODO: [0] Make string_serialized_xml
+// TODO: [1] Make type for XML Settings and Schema
+// TODO: [🧠] What to use for validating XMLs - XSD,...
+// TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
+// TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
+// TODO: [🍓] In `XmlFormatParser` implement `heal
+// TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
+// TODO: [🏢] Allow to expect something inside XML and other formats
 
 /**
  * Definitions for all formats supported by Promptbook
@@ -20914,9 +20910,7 @@ const XmlFormatParser = {
  * @private internal index of `...` <- TODO [🏢]
  */
 const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser, CsvFormatParser];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
+// Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
  * Maps available parameters to expected parameters for a pipeline task.
@@ -20926,6 +20920,7 @@ const FORMAT_DEFINITIONS = [JsonFormatParser, XmlFormatParser, TextFormatParser,
  * 2) Then, if there are unmatched expected and available parameters, map them by order.
  *
  * @throws {PipelineExecutionError} If the number of unmatched expected and available parameters does not match, or mapping is ambiguous.
+ *
  * @private within the repository used in `createPipelineExecutor`
  */
 function mapAvailableToExpectedParameters(options) {
@@ -20996,6 +20991,7 @@ function mapAvailableToExpectedParameters(options) {
  * @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) {
@@ -21046,9 +21042,7 @@ function extractAllBlocksFromMarkdown(markdown) {
     }
     return codeBlocks;
 }
-/**
- * TODO: Maybe name for `blockNotation` instead of  '```' and '>'
- */
+// TODO: Maybe name for `blockNotation` instead of  '```' and '>'
 
 /**
  * Extracts  extracts exactly one valid JSON code block
@@ -21064,8 +21058,9 @@ function extractAllBlocksFromMarkdown(markdown) {
  * - `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 no valid JSON block in the markdown
+ *
+ * @public exported from `@promptbook/markdown-utils`
  */
 function extractJsonBlock(markdown) {
     if (isValidJsonString(markdown)) {
@@ -21081,10 +21076,8 @@ function extractJsonBlock(markdown) {
     }
     return jsonBlocks[0].content;
 }
-/**
- * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
- * TODO: [🏢] Make this logic part of `JsonFormatParser` or `isValidJsonString`
- */
+// TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
+// TODO: [🏢] Make this logic part of `JsonFormatParser` or `isValidJsonString`
 
 /**
  * Function checkExpectations will check if the expectations on given value are met
@@ -21095,6 +21088,7 @@ function extractJsonBlock(markdown) {
  *
  * @throws {ExpectError} if the expectations are not met
  * @returns {void} Nothing
+ *
  * @private internal function of `createPipelineExecutor`
  */
 function checkExpectations(expectations, value) {
@@ -21108,11 +21102,9 @@ function checkExpectations(expectations, value) {
         }
     }
 }
-/**
- * TODO: [💝] Unite object for expecting amount and format
- * TODO: [🧠][🤠] This should be part of `TextFormatParser`
- * Note: [💝] and [🤠] are interconnected together
- */
+// TODO: [💝] Unite object for expecting amount and format
+// TODO: [🧠][🤠] This should be part of `TextFormatParser`
+// Note: [💝] and [🤠] are interconnected together
 
 /**
  * Validates a prompt result against expectations and format requirements.
@@ -21123,6 +21115,7 @@ function checkExpectations(expectations, value) {
  *
  * @param options - The validation options including result string, expectations, and format
  * @returns Validation result with processed string and validity status
+ *
  * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
  */
 function validatePromptResult(options) {
@@ -21185,6 +21178,7 @@ function validatePromptResult(options) {
  *
  * @param options - The options for execution, including task, parameters, pipeline, and configuration.
  * @returns The result string of the executed task.
+ *
  * @private internal utility of `createPipelineExecutor`
  */
 async function executeAttempts(options) {
@@ -21508,9 +21502,7 @@ async function executeAttempts(options) {
     }
     return $ongoingTaskResult.$resultString;
 }
-/**
- * TODO: Break into smaller functions
- */
+// TODO: Break into smaller functions
 
 /**
  * Executes a pipeline task that requires mapping or iterating over subvalues of a parameter (such as rows in a CSV).
@@ -21653,6 +21645,7 @@ async function executeFormatSubvalues(options) {
  *
  * @param task - The task for which the context is being generated. This should be a deeply immutable TaskJson object.
  * @returns The context as a string, formatted as markdown and parameter value.
+ *
  * @private internal utility of `createPipelineExecutor`
  */
 async function getContextForTask(task) {
@@ -21690,7 +21683,6 @@ function computeCosineSimilarity(embeddingVector1, embeddingVector2) {
 }
 
 /**
- *
  * @param knowledgePieces
  * @returns
  *
@@ -21771,10 +21763,8 @@ async function getKnowledgeForTask(options) {
         return knowledgePiecesToString(preparedPipeline.knowledgePieces);
     }
 }
-/**
- * TODO: [♨] Implement Better - use keyword search
- * TODO: [♨] Examples of values
- */
+// TODO: [♨] Implement Better - use keyword search
+// TODO: [♨] Examples of values
 
 /**
  * Retrieves all reserved parameters for a given pipeline task, including context, knowledge, examples, and metadata.
@@ -21927,9 +21917,7 @@ async function executeTask(options) {
         resultString,
     });
 }
-/**
- * TODO: [🤹‍♂️]
- */
+// TODO: [🤹‍♂️]
 
 /**
  * Filters and returns only the output parameters from the provided pipeline execution options.
@@ -22259,6 +22247,7 @@ async function executePipeline(options) {
  *
  * @returns The executor function
  * @throws {PipelineLogicError} on logical error in the pipeline
+ *
  * @public exported from `@promptbook/core`
  */
 function createPipelineExecutor(options) {
@@ -22412,6 +22401,7 @@ function createPipelineExecutor(options) {
  * Prepares the persona for the pipeline
  *
  * @see https://github.com/webgptorg/promptbook/discussions/22
+ *
  * @public exported from `@promptbook/core`
  */
 async function preparePersona(personaDescription, tools, options) {
@@ -22468,13 +22458,11 @@ async function preparePersona(personaDescription, tools, options) {
         modelsRequirements,
     };
 }
-/**
- * TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
- * TODO: [🔃][main] If the persona was prepared with different version or different set of models, prepare it once again
- * TODO: [🏢] Check validity of `modelName` in pipeline
- * TODO: [🏢] Check validity of `systemMessage` in pipeline
- * TODO: [🏢] Check validity of `temperature` in pipeline
- */
+// TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
+// TODO: [🔃][main] If the persona was prepared with different version or different set of models, prepare it once again
+// TODO: [🏢] Check validity of `modelName` in pipeline
+// TODO: [🏢] Check validity of `systemMessage` in pipeline
+// TODO: [🏢] Check validity of `temperature` in pipeline
 
 /**
  * Creates an empty/basic agent model requirements object
@@ -22509,12 +22497,11 @@ function createBasicAgentModelRequirements(agentName) {
         systemMessage: `You are ${agentName || 'AI Agent'}`,
     };
 }
-/**
- * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
- */
+// TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
 
 /**
  * Gets a commitment definition by its type
+ *
  * @param type The commitment type to look up
  * @returns The commitment definition or null if not found
  *
@@ -22893,7 +22880,9 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     };
 }
 /**
- * @private Attempts to upload inline knowledge entries, falling back to legacy data URLs when the upload fails or is not configured.
+ * Attempts to upload inline knowledge entries, falling back to legacy data URLs when the upload fails or is not configured.
+ *
+ * @private
  */
 async function applyPendingInlineKnowledgeSources(requirements, uploader) {
     var _a;
@@ -22914,6 +22903,9 @@ async function applyPendingInlineKnowledgeSources(requirements, uploader) {
         _metadata: stripInlineKnowledgeMetadata(requirements._metadata),
     };
 }
+/**
+ * Handles upload inline knowledge source with fallback.
+ */
 async function uploadInlineKnowledgeSourceWithFallback(inlineSource, uploader) {
     try {
         return await uploader(inlineSource);
@@ -22926,6 +22918,9 @@ async function uploadInlineKnowledgeSourceWithFallback(inlineSource, uploader) {
         return inlineKnowledgeSourceToDataUrl(inlineSource);
     }
 }
+/**
+ * Extracts inline knowledge sources.
+ */
 function extractInlineKnowledgeSources(metadata) {
     if (!metadata) {
         return [];
@@ -22933,6 +22928,9 @@ function extractInlineKnowledgeSources(metadata) {
     const value = metadata.inlineKnowledgeSources;
     return Array.isArray(value) ? value : [];
 }
+/**
+ * Strips inline knowledge metadata.
+ */
 function stripInlineKnowledgeMetadata(metadata) {
     if (!metadata || !Object.prototype.hasOwnProperty.call(metadata, 'inlineKnowledgeSources')) {
         return metadata;
@@ -22983,6 +22981,7 @@ function isBinaryMimeType(mimeType) {
  * @param availableModels - Models that could fulfill the agent.
  * @param llmTools - Execution tools used when selecting a best model.
  * @param options - Optional hooks such as the agent reference resolver.
+ *
  * @public exported from `@promptbook/core`
  */
 async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools, options) {
@@ -23002,6 +23001,7 @@ async function createAgentModelRequirements(agentSource, modelName, availableMod
  * @param agentSource The agent source to derive persona description from
  * @param llmTools LLM tools for preparing persona
  * @returns The name of the best selected model
+ *
  * @private function of `createAgentModelRequirements`
  */
 async function selectBestModelUsingPersona(agentSource, llmTools) {
@@ -23137,6 +23137,7 @@ function normalizeChatAttachment(rawAttachment) {
  *
  * @param {unknown} rawAttachments - The raw attachments to normalize.
  * @returns {Array<ChatAttachment>} The normalized attachments.
+ *
  * @public exported from `@promptbook/core`
  */
 function normalizeChatAttachments(rawAttachments) {
@@ -23181,6 +23182,7 @@ function formatChatAttachmentLine(attachment) {
  *
  * @param {ReadonlyArray<ChatAttachment>} attachments - The attachments to format.
  * @returns {string} The formatted context.
+ *
  * @public exported from `@promptbook/core`
  */
 function formatChatAttachmentContext(attachments) {
@@ -23201,6 +23203,7 @@ function formatChatAttachmentContext(attachments) {
  * @param {number} maxBytes - Maximum number of bytes to capture.
  * @param {{ captureOverflowByte?: boolean }} [options] - Optional capture behavior.
  * @returns {Promise<{ bytes: Uint8Array }>} Captured bytes, optionally including one overflow byte.
+ *
  * @private internal utility for bounded response reads
  */
 async function readResponseBytes(response, maxBytes, options = {}) {
@@ -23297,6 +23300,7 @@ function createAttachmentContentFailure(attachment, reason, options = {}) {
  * @param {number} maxInlineCharacters - Maximum number of characters to inline.
  * @param {ResolveChatAttachmentOptions} options - Options for resolution.
  * @returns {Promise<ResolvedChatAttachmentContent>} The resolved content.
+ *
  * @private function of resolveChatAttachmentContents
  */
 async function resolveChatAttachmentContent(attachment, maxInlineCharacters, options = {}) {
@@ -23388,6 +23392,7 @@ const CHAT_ATTACHMENT_MAX_INLINE_CHARACTERS_TOTAL = 24000;
  * @param {ReadonlyArray<ChatAttachment>} attachments - The attachments to resolve.
  * @param {ResolveChatAttachmentOptions} options - Options for resolution.
  * @returns {Promise<Array<ResolvedChatAttachmentContent>>} The resolved contents.
+ *
  * @public exported from `@promptbook/core`
  */
 async function resolveChatAttachmentContents(attachments, options = {}) {
@@ -23453,6 +23458,7 @@ function formatResolvedChatAttachmentContent(contentResolution) {
  *
  * @param {ReadonlyArray<ResolvedChatAttachmentContent>} resolvedContents - The resolved contents to format.
  * @returns {string} The formatted context.
+ *
  * @public exported from `@promptbook/core`
  */
 function formatChatAttachmentContentContext(resolvedContents) {
@@ -23493,6 +23499,7 @@ function appendChatContextSections(messageContent, contextSections) {
  * @param {ReadonlyArray<ChatAttachment>} attachments - The attachments to append.
  * @param {ResolveChatAttachmentOptions} options - Options for resolution.
  * @returns {Promise<string>} The updated message content.
+ *
  * @public exported from `@promptbook/core`
  */
 async function appendChatAttachmentContextWithContent(messageContent, attachments, options = {}) {
@@ -23521,9 +23528,7 @@ async function appendChatAttachmentContextWithContent(messageContent, attachment
 function humanizeAiTextEllipsis(aiText) {
     return aiText.replace(/[…⋯]/g, '...').replace(/\.\s+\.\s+\./g, '...');
 }
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */
+// Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
 /**
  * Change dash-like characters to regular dashes `—` -> `-` and remove soft hyphens
@@ -23536,9 +23541,7 @@ function humanizeAiTextEllipsis(aiText) {
 function humanizeAiTextEmdashed(aiText) {
     return aiText.replace(/\u00AD/g, '').replace(/[‐‑‒–—―−⁃﹣－]/g, '-');
 }
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */
+// Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
 /**
  * Change smart quotes to regular quotes
@@ -23551,9 +23554,7 @@ function humanizeAiTextEmdashed(aiText) {
 function humanizeAiTextQuotes(aiText) {
     return aiText.replace(/[“”„‟«»❝❞〝〞〟＂]/g, '"').replace(/[‚‘’‛‹›❛❜＇ʼ]/g, "'");
 }
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */
+// Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
 /**
  * Remove bracketed source citation artifacts like `\u30105:1\u2020source\u3011`.
@@ -23566,9 +23567,7 @@ function humanizeAiTextQuotes(aiText) {
 function humanizeAiTextSources(aiText) {
     return aiText.replace(/[ \t]*\u3010\s*\d+(?:\s*:\s*\d+)?\s*\u2020source\s*\u3011/g, '');
 }
-/**
- * Note: [??] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */
+// Note: [??] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
 /**
  * Change unprintable hard spaces to regular spaces and drop zero-width spaces
@@ -23581,9 +23580,7 @@ function humanizeAiTextSources(aiText) {
 function humanizeAiTextWhitespace(aiText) {
     return aiText.replace(/[\u00A0\u1680\u2000-\u200A\u202F\u205F\u3000]/g, ' ').replace(/[\u200B\uFEFF\u2060]/g, '');
 }
-/**
- * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
- */
+// Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
 
 /**
  * Function `humanizeAiText` will remove traces of AI text generation artifacts
@@ -23602,11 +23599,11 @@ function humanizeAiText(aiText) {
     cleanedText = humanizeAiTextWhitespace(cleanedText);
     return cleanedText;
 }
-/**
- * TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
- */
+// TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
 
 /**
+ * Map of promptbook pseudotoken substitution.
+ *
  * @private
  */
 const PROMPTBOOK_PSEUDOTOKEN_SUBSTITUTION = {
@@ -23654,9 +23651,7 @@ function promptbookifyAiText(text) {
     }
     return promptbookifiedTextTokens.join('');
 }
-/**
- * TODO: [🧠][✌️] Make some Promptbook-native token system
- */
+// TODO: [🧠][✌️] Make some Promptbook-native token system
 
 /**
  * Make UncertainNumber
@@ -23712,6 +23707,7 @@ function pricing(value) {
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/
+ *
  * @public exported from `@promptbook/openai`
  */
 const OPENAI_MODELS = exportJson({
@@ -24388,6 +24384,7 @@ const OPENAI_MODELS = exportJson({
  * @param rawResponse The raw response from OpenAI API
  * @param duration The duration of the execution
  * @throws {PipelineExecutionError} If the usage is not defined in the response from OpenAI
+ *
  * @private internal utility of `OpenAiExecutionTools`
  */
 function computeOpenAiUsage(promptContent, // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
@@ -24430,15 +24427,14 @@ resultContent, rawResponse, duration = ZERO_VALUE) {
         },
     };
 }
-/**
- * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
- */
+// TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
 
 /**
  * Parses an OpenAI error message to identify which parameter is unsupported
  *
  * @param errorMessage The error message from OpenAI API
  * @returns The parameter name that is unsupported, or null if not an unsupported parameter error
+ *
  * @private utility of LLM Tools
  */
 function parseUnsupportedParameterError(errorMessage) {
@@ -24460,6 +24456,7 @@ function parseUnsupportedParameterError(errorMessage) {
  * @param modelRequirements Original model requirements
  * @param unsupportedParameter The parameter to remove
  * @returns New model requirements without the unsupported parameter
+ *
  * @private utility of LLM Tools
  */
 function removeUnsupportedModelRequirement(modelRequirements, unsupportedParameter) {
@@ -24479,8 +24476,10 @@ function removeUnsupportedModelRequirement(modelRequirements, unsupportedParamet
 }
 /**
  * Checks if an error is an "Unsupported value" error from OpenAI
+ *
  * @param error The error to check
  * @returns true if this is an unsupported parameter error
+ *
  * @private utility of LLM Tools
  */
 function isUnsupportedParameterError(error) {
@@ -25586,13 +25585,11 @@ class OpenAiCompatibleExecutionTools {
         return false;
     }
 }
-/**
- * TODO: [🛄] Some way how to re-wrap the errors from `OpenAiCompatibleExecutionTools`
- * TODO: [🛄] Maybe make custom `OpenAiCompatibleError`
- * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
- * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
- * TODO: [🧠][🦢] Make reverse adapter from LlmExecutionTools to OpenAI-compatible:
- */
+// TODO: [🛄] Some way how to re-wrap the errors from `OpenAiCompatibleExecutionTools`
+// TODO: [🛄] Maybe make custom `OpenAiCompatibleError`
+// TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+// TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+// TODO: [🧠][🦢] Make reverse adapter from LlmExecutionTools to OpenAI-compatible:
 
 /**
  * Profile for OpenAI provider
@@ -25660,9 +25657,21 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
     }
 }
 
+/**
+ * Constant for default knowledge source download timeout ms.
+ */
 const DEFAULT_KNOWLEDGE_SOURCE_DOWNLOAD_TIMEOUT_MS = 30000;
+/**
+ * Constant for default knowledge source upload timeout ms.
+ */
 const DEFAULT_KNOWLEDGE_SOURCE_UPLOAD_TIMEOUT_MS = 900000;
+/**
+ * Constant for vector store progress log interval min ms.
+ */
 const VECTOR_STORE_PROGRESS_LOG_INTERVAL_MIN_MS = 15000;
+/**
+ * Constant for vector store stall log threshold ms.
+ */
 const VECTOR_STORE_STALL_LOG_THRESHOLD_MS = 30000;
 /**
  * Base class for OpenAI execution tools that need hosted vector stores.
@@ -26429,6 +26438,9 @@ class OpenAiVectorStoreHandler extends OpenAiExecutionTools {
     }
 }
 
+/**
+ * Constant for default agent kit model name.
+ */
 const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-nano';
 /**
  * Creates one structured log entry for streamed tool-call updates.
@@ -26472,6 +26484,9 @@ function resolveFinalToolCallState$1(options) {
     }
     return 'COMPLETE';
 }
+/**
+ * Constant for default JSON schema name.
+ */
 const DEFAULT_JSON_SCHEMA_NAME = 'StructuredOutput';
 /**
  * File extensions considered image inputs when MIME type is missing or generic.
@@ -26627,6 +26642,7 @@ function buildJsonSchemaDefinition(jsonSchema) {
  *
  * @param responseFormat - The OpenAI `response_format` payload from the user request.
  * @returns An Agent output type compatible with the requested schema or `undefined` when no impact is required.
+ *
  * @private utility of Open AI
  */
 function mapResponseFormatToAgentOutputType(responseFormat) {
@@ -27385,6 +27401,7 @@ function resolveFinalToolCallState(options) {
  * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
  *
  * @deprecated Use `OpenAiAgentKitExecutionTools` instead.
+ *
  * @public exported from `@promptbook/openai`
  */
 class OpenAiAssistantExecutionTools extends OpenAiVectorStoreHandler {
@@ -28076,14 +28093,12 @@ class OpenAiAssistantExecutionTools extends OpenAiVectorStoreHandler {
  * @private const of `OpenAiAssistantExecutionTools`
  */
 const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
-/**
- * TODO: !!!!! [✨🥚] Knowledge should work both with and without scrapers
- * TODO: [🙎] In `OpenAiAssistantExecutionTools` Allow to create abstract assistants with `isCreatingNewAssistantsAllowed`
- * TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI
- * TODO: Maybe make custom OpenAiError
- * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
- * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
- */
+// TODO: !!!!! [✨🥚] Knowledge should work both with and without scrapers
+// TODO: [🙎] In `OpenAiAssistantExecutionTools` Allow to create abstract assistants with `isCreatingNewAssistantsAllowed`
+// TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI
+// TODO: Maybe make custom OpenAiError
+// TODO: [🧠][🈁] Maybe use `isDeterministic` from options
+// TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
 
 /**
  * Emits a progress update to signal assistant preparation before long setup work.
@@ -28560,10 +28575,8 @@ AgentLlmExecutionTools.assistantCache = new Map();
  * Cache of OpenAI vector stores to avoid creating duplicates
  */
 AgentLlmExecutionTools.vectorStoreCache = new Map();
-/**
- * TODO: [🍚] Implement Destroyable pattern to free resources
- * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
- */
+// TODO: [🍚] Implement Destroyable pattern to free resources
+// TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
 
 /**
  * Extracts the teacher-focused instructions from the latest `OPEN` commitment in the book.
@@ -28573,6 +28586,7 @@ AgentLlmExecutionTools.vectorStoreCache = new Map();
  *
  * @param agentSource - The raw agent book source
  * @returns The trimmed instructions or `null` when no instructive `OPEN` commitment exists.
+ *
  * @private Internal helper shared between self-learning and related features.
  */
 function extractOpenTeacherInstructions(agentSource) {
@@ -28780,6 +28794,7 @@ class SelfLearningManager {
  *
  * @param section Raw fragment from self-learning workflow.
  * @returns Trimmed fragment, or empty string when nothing remains.
+ *
  * @private function of Agent
  */
 function normalizeBookSection(section) {
@@ -28791,6 +28806,7 @@ function normalizeBookSection(section) {
  * @param agentSource Current source.
  * @param normalizedSection Candidate fragment expected to be normalized first.
  * @returns True when appending would duplicate an existing fragment.
+ *
  * @private function of Agent
  */
 function containsNormalizedBookSection(agentSource, normalizedSection) {
@@ -28805,6 +28821,7 @@ function containsNormalizedBookSection(agentSource, normalizedSection) {
  *
  * @param responseFormat Prompt response format requirements
  * @returns True when JSON schema mode is active
+ *
  * @private function of Agent
  */
 function isJsonSchemaResponseFormat(responseFormat) {
@@ -28816,6 +28833,7 @@ function isJsonSchemaResponseFormat(responseFormat) {
  * @param content Original agent answer content
  * @param isJsonMode Whether the interaction requested JSON schema output
  * @returns Agent answer, wrapped in a formatted JSON code block when possible
+ *
  * @private function of Agent
  */
 function formatAgentMessageForJsonMode(content, isJsonMode) {
@@ -28841,6 +28859,7 @@ function formatAgentMessageForJsonMode(content, isJsonMode) {
  *
  * @param content Text to parse as JSON
  * @returns Parsed JSON value or null when parsing fails
+ *
  * @private function of Agent
  */
 function tryParseJson(content) {
@@ -28856,6 +28875,7 @@ function tryParseJson(content) {
  *
  * @param options - Normalized sample parts.
  * @returns Book-language sample section ready to append into agent source.
+ *
  * @private function of Agent
  */
 function formatSelfLearningSample(options) {
@@ -28877,6 +28897,7 @@ function formatSelfLearningSample(options) {
  *
  * @param internalMessage Internal trace payload.
  * @returns Book-language INTERNAL MESSAGE block.
+ *
  * @private function of Agent
  */
 function formatInternalLearningMessage(internalMessage) {
@@ -28890,6 +28911,7 @@ function formatInternalLearningMessage(internalMessage) {
  *
  * @param result Final chat result used in self-learning.
  * @returns Internal payloads that capture request/response/tool-call context.
+ *
  * @private function of Agent
  */
 function buildInternalLearningMessages(result) {
@@ -28919,6 +28941,7 @@ function buildInternalLearningMessages(result) {
  *
  * @param toolCall Tool call produced during execution.
  * @returns Sanitized and serializable tool-call payload.
+ *
  * @private function of Agent
  */
 function sanitizeToolCallForLearning(toolCall) {
@@ -28938,6 +28961,7 @@ function sanitizeToolCallForLearning(toolCall) {
  *
  * @param payload Internal payload to serialize.
  * @returns Pretty JSON string that can be embedded in BOOK.
+ *
  * @private function of Agent
  */
 function stringifyInternalLearningPayload(payload) {
@@ -28987,6 +29011,7 @@ function createEmptySelfLearningCommitmentCounts() {
  * Normalizes teacher commitments into trimmed, display-ready lines.
  *
  * @param commitments Raw teacher output
+ *
  * @private function of Agent
  */
 function getTeacherCommitmentLines(commitments) {
@@ -28999,6 +29024,7 @@ function getTeacherCommitmentLines(commitments) {
  * Summarizes teacher commitment lines into user-friendly counts for self-learning.
  *
  * @param lines Parsed teacher commitment lines
+ *
  * @private function of Agent
  */
 function summarizeTeacherCommitmentLines(lines) {
@@ -29031,6 +29057,7 @@ function summarizeTeacherCommitmentLines(lines) {
  * @param commitments Raw teacher commitments
  * @param used Whether the teacher was invoked
  * @returns Summary of learned commitments
+ *
  * @private function of Agent
  */
 function buildTeacherSummary(commitments, used) {
@@ -29267,9 +29294,7 @@ class Agent extends AgentLlmExecutionTools {
         return finalResult;
     }
 }
-/**
- * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- */
+// TODO: [🧠][😰]Agent is not working with the parameters, should it be?
 
 /**
  * Parses one failed remote agent response into a structured error.
@@ -29735,10 +29760,8 @@ class RemoteAgent extends Agent {
         return agentResult;
     }
 }
-/**
- * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- * TODO: !!! Agent on remote server
- */
+// TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+// TODO: !!! Agent on remote server
 
 var RemoteAgent$1 = /*#__PURE__*/Object.freeze({
     __proto__: null,