@promptbook/node 0.112.0-32 → 0.112.0-35

package/umd/index.umd.js

@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
+    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
@@ -58,16 +58,20 @@
      * Trims string from all 4 sides
      *
      * Note: This is a re-exported function from the `spacetrim` package which is
-     *       Developed by same author @hejny as this package
+     * Developed by same author @hejny as this package
      *
-     * @public exported from `@promptbook/utils`
      * @see https://github.com/hejny/spacetrim#usage
+     *
+     * @public exported from `@promptbook/utils`
      */
     const spaceTrim = _spaceTrim.spaceTrim;
 
     /**
-     * @private util of `@promptbook/color`
+     * Class implementing take chain.
+     *
      * @de
+     *
+     * @private util of `@promptbook/color`
      */
     class TakeChain {
         constructor(value) {
@@ -84,9 +88,9 @@
      *
      * @param {*} initialValue - The initial value.
      * @returns {Proxy<WithTake<TValue>>} - A proxy object with a `take` method.
+     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      *
      * @private util of `@promptbook/color`
-     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
      */
     function take(initialValue) {
         if (initialValue instanceof TakeChain) {
@@ -264,9 +268,7 @@
         yellow: '#ffff00',
         yellowgreen: '#9acd32',
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Validates that a channel value is a valid number within the range of 0 to 255.
@@ -296,7 +298,13 @@
         }
     }
 
+    /**
+     * 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.
@@ -329,6 +337,9 @@
         }
         return throwInvalidHex();
     }
+    /**
+     * Parses short hex channel.
+     */
     function parseShortHexChannel(char, onError) {
         if (!char) {
             return onError();
@@ -339,6 +350,9 @@
         }
         return parsed * 16;
     }
+    /**
+     * Parses long hex channel.
+     */
     function parseLongHexChannel(hex, start, onError) {
         const segment = hex.substr(start, 2);
         if (segment.length < 2) {
@@ -351,6 +365,9 @@
         return parsed;
     }
 
+    /**
+     * Pattern matching hsl.
+     */
     const HSL_REGEX = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
     /**
      * Parses an HSL string into RGBA channel values.
@@ -376,6 +393,9 @@
             alpha: 255,
         };
     }
+    /**
+     * Handles convert hsl to Rgb.
+     */
     function convertHslToRgb(h, s, l) {
         const c = (1 - Math.abs(2 * l - 1)) * s;
         const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
@@ -414,7 +434,13 @@
         };
     }
 
+    /**
+     * Pattern matching RGB.
+     */
     const RGB_REGEX = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+    /**
+     * Pattern matching rgba.
+     */
     const RGBA_REGEX = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
     /**
      * Parses an RGB string into RGBA channel values.
@@ -456,6 +482,9 @@
             alpha: parseAlphaValue(match[4]),
         };
     }
+    /**
+     * Parses channel value.
+     */
     function parseChannelValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -463,6 +492,9 @@
         }
         return Math.round(parseFloat(value));
     }
+    /**
+     * Parses alpha value.
+     */
     function parseAlphaValue(value) {
         if (value.endsWith('%')) {
             const percent = parseFloat(value);
@@ -475,8 +507,17 @@
         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
@@ -842,9 +883,7 @@
         }
         return [Math.round(red * 255), Math.round(green * 255), Math.round(blue * 255)];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Converts RGB values to HSL values
@@ -890,9 +929,7 @@
         }
         return [hue, saturation, lightness];
     }
-    /**
-     * TODO: Properly name all used internal variables
-     */
+    // TODO: Properly name all used internal variables
 
     /**
      * Makes color transformer which lighten the given color
@@ -910,9 +947,7 @@
             return Color.fromValues(r, g, b, alpha);
         };
     }
-    /**
-     * TODO: Maybe implement by mix+hsl
-     */
+    // TODO: Maybe implement by mix+hsl
 
     /**
      * Makes color transformer which saturate the given color
@@ -930,9 +965,7 @@
             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.
@@ -945,6 +978,7 @@
      *
      * @param value any values
      * @returns the same values
+     *
      * @private within the repository
      */
     function just(value) {
@@ -1326,6 +1360,7 @@
      * Orders JSON object by keys
      *
      * @returns The same type of object as the input re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function orderJson(options) {
@@ -1344,6 +1379,7 @@
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
      *
      * @returns The same object as the input, but deeply frozen
+     *
      * @public exported from `@promptbook/utils`
      */
     function $deepFreeze(objectValue) {
@@ -1360,9 +1396,7 @@
         Object.freeze(objectValue);
         return objectValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
@@ -1430,6 +1464,7 @@
      * - And much more...
      *
      * @throws UnexpectedError if the value is not serializable as JSON
+     *
      * @public exported from `@promptbook/utils`
      */
     function checkSerializableAsJson(options) {
@@ -1544,11 +1579,9 @@
                 `));
         }
     }
-    /**
-     * 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
@@ -1558,6 +1591,7 @@
      *
      * @param objectValue The object to clone.
      * @returns A deep, writable clone of the input object.
+     *
      * @public exported from `@promptbook/utils`
      */
     function deepClone(objectValue) {
@@ -1574,9 +1608,7 @@
         > return Object.assign({}, objectValue);
         */
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Utility to export a JSON object from a function
@@ -1589,6 +1621,7 @@
      * Note: This function does not mutates the given object
      *
      * @returns The same type of object as the input but read-only and re-ordered
+     *
      * @public exported from `@promptbook/utils`
      */
     function exportJson(options) {
@@ -1608,9 +1641,7 @@
         $deepFreeze(orderedValue);
         return orderedValue;
     }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
+    // TODO: [🧠] Is there a way how to meaningfully test this utility
 
     /**
      * Order of keys in the pipeline JSON
@@ -1721,9 +1752,7 @@
          */
         SHORT_NAME_LENGTH: 6,
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
@@ -1737,9 +1766,7 @@
             Object.setPrototypeOf(this, ParseError.prototype);
         }
     }
-    /**
-     * TODO: Maybe split `ParseError` and `ApplyError`
-     */
+    // TODO: Maybe split `ParseError` and `ApplyError`
 
     /**
      * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
@@ -1777,12 +1804,13 @@
      * 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) {
@@ -1856,9 +1884,7 @@
         */
         return true;
     }
-    /**
-     * TODO: [🐠] Maybe more info why the URL is invalid
-     */
+    // TODO: [🐠] Maybe more info why the URL is invalid
 
     /**
      * Validates PipelineJson if it is logically valid
@@ -1875,6 +1901,7 @@
      * @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) {
@@ -1899,6 +1926,8 @@
         return pipeline;
     }
     /**
+     * Validates pipeline inner function.
+     *
      * @private internal function for `validatePipeline`
      */
     function validatePipeline_InnerFunction(pipeline) {
@@ -2143,15 +2172,13 @@
      *     >  * -   ...
      *     >  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
 
     /**
      * Loads the books from the archive file with `.bookc` extension
@@ -2178,9 +2205,7 @@
         }
         return collectionJson;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node archive helper [loadArchive](src/conversion/archive/loadArchive.ts) should never be published into packages that could be imported into browser environment
 
     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"}];
 
@@ -2203,6 +2228,7 @@
      * 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) {
@@ -2251,9 +2277,7 @@
         }
         return false;
     }
-    /**
-     * TODO: [🍏] Implement for MacOs
-     */
+    // TODO: [🍏] Implement for MacOs
 
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
@@ -2286,6 +2310,7 @@
      * @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) {
@@ -2304,17 +2329,16 @@
         // <- 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
 
     /**
      * Prettify the html code
      *
      * @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 -->`);
@@ -2337,6 +2361,7 @@
      * @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) {
@@ -2453,6 +2478,8 @@
         return validatePipelineString(pipelineString);
     }
     /**
+     * Handles task parameter Json to string.
+     *
      * @private internal utility of `pipelineJsonToString`
      */
     function taskParameterJsonToString(taskParameterJson) {
@@ -2463,13 +2490,11 @@
         }
         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
 
     /**
      * This error indicates that promptbook not found in the collection
@@ -2502,6 +2527,7 @@
      *
      * @param template the string template with parameters in {curly} braces
      * @returns the list of parameter names
+     *
      * @public exported from `@promptbook/utils`
      */
     function extractParameterNames(template) {
@@ -2518,6 +2544,7 @@
      * 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) {
@@ -2546,18 +2573,17 @@
             },
         });
     }
-    /**
-     * 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 {
         /**
@@ -2661,6 +2687,7 @@
      *
      * @param promptbookSources
      * @returns PipelineCollection
+     *
      * @public exported from `@promptbook/core`
      */
     function createPipelineCollectionFromJson(...promptbooks) {
@@ -2806,9 +2833,7 @@
             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
@@ -2826,10 +2851,11 @@
     /**
      * 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) {
@@ -2907,16 +2933,15 @@
      * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
      * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
      *
-     * @private internal helper function
      * @returns secure random token
+     *
+     * @private internal helper function
      */
     function $randomToken(randomness) {
         return crypto.randomBytes(randomness).toString('hex');
     }
-    /**
-     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
-     * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
-     */
+    // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+    // TODO: Maybe use nanoid instead https://github.com/ai/nanoid
 
     /**
      * This error indicates errors during the execution of the pipeline
@@ -2933,9 +2958,7 @@
             Object.setPrototypeOf(this, PipelineExecutionError.prototype);
         }
     }
-    /**
-     * TODO: [🧠][🌂] Add id to all errors
-     */
+    // TODO: [🧠][🌂] Add id to all errors
 
     /**
      * Error thrown when a fetch request fails
@@ -3011,9 +3034,7 @@
         ...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
 
     /**
      * Serializes an error into a [🚉] JSON-serializable object
@@ -3046,7 +3067,7 @@
 
     /**
      * Recursively converts JSON strings to JSON objects
-
+     *
      * @public exported from `@promptbook/utils`
      */
     function jsonStringsToJsons(object) {
@@ -3070,9 +3091,7 @@
         }
         return newObject;
     }
-    /**
-     * TODO: Type the return type correctly
-     */
+    // TODO: Type the return type correctly
 
     /**
      * Deserializes the error object
@@ -3107,6 +3126,7 @@
      *
      * @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) {
@@ -3137,9 +3157,7 @@
                 `));
         }
     }
-    /**
-     * 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
@@ -3330,10 +3348,8 @@
             },
         };
     }
-    /**
-     * 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
@@ -3401,9 +3417,7 @@
             pagesCount: UNCERTAIN_ZERO_VALUE,
         },
     });
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Format either small or big number
@@ -3438,8 +3452,8 @@
      * This is useful and used in the `templateParameters` function
      *
      * Note: This function is not just calling `toString` method
-     *       It's more complex and can handle this conversion specifically for LLM models
-     *       See `VALUE_STRINGS`
+     * It's more complex and can handle this conversion specifically for LLM models
+     * See `VALUE_STRINGS`
      *
      * Note: There are 2 similar functions
      * - `valueToString` converts value to string for LLM models as human-readable string
@@ -3546,6 +3560,7 @@
      * @param script from which to extract the variables
      * @returns the list of variable names
      * @throws {ParseError} if the script is invalid
+     *
      * @public exported from `@promptbook/javascript`
      */
     function extractVariablesFromJavascript(script) {
@@ -3611,9 +3626,7 @@
         }
         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
@@ -3621,6 +3634,7 @@
      * @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) {
@@ -3661,14 +3675,13 @@
         }
         return parameterNames;
     }
-    /**
-     * TODO: [🔣] If script require contentLanguage
-     */
+    // TODO: [🔣] If script require contentLanguage
 
     /**
      * 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) {
@@ -3680,14 +3693,13 @@
         }
         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) {
@@ -3753,8 +3765,9 @@
     /**
      * 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',
@@ -3844,13 +3857,11 @@
             },
         ],
     };
-    /**
-     * 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
@@ -3871,17 +3882,15 @@
         },
         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
@@ -3919,15 +3928,13 @@
             // <- 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
 
     /**
      * Function to check if a string is valid XML
@@ -3972,17 +3979,15 @@
         },
         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
@@ -3990,9 +3995,7 @@
      * @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.
@@ -4002,6 +4005,7 @@
      * 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) {
@@ -4091,6 +4095,7 @@
      * 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 {
@@ -4253,16 +4258,16 @@
      * `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) {
@@ -4299,10 +4304,8 @@
         }
         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
@@ -4316,10 +4319,8 @@
             : 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
 
     /**
      * Just says that the variable is not used but should be kept
@@ -4333,6 +4334,7 @@
      *
      * @param value any values
      * @returns void
+     *
      * @private within the repository
      */
     function keepUnused(...valuesToKeep) {
@@ -4342,12 +4344,13 @@
      * 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) {
@@ -4421,6 +4424,7 @@
      * @param markdown any valid markdown
      * @returns code blocks with language and content
      * @throws {ParseError} if block is not closed properly
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function extractAllBlocksFromMarkdown(markdown) {
@@ -4471,9 +4475,7 @@
         }
         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
@@ -4489,8 +4491,9 @@
      * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
      * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
      *
-     * @public exported from `@promptbook/markdown-utils`
      * @throws {ParseError} if there is no valid JSON block in the markdown
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractJsonBlock(markdown) {
         if (isValidJsonString(markdown)) {
@@ -4506,10 +4509,8 @@
         }
         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`
 
     /**
      * Counts number of characters in the text
@@ -4525,10 +4526,8 @@
         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
 
     /**
      * Number of characters per standard line with 11pt Arial font size.
@@ -4542,10 +4541,8 @@
      * @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 lines in the text
@@ -4563,10 +4560,8 @@
         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
@@ -4578,10 +4573,8 @@
     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
@@ -4591,10 +4584,8 @@
     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
@@ -4612,11 +4603,12 @@
     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
+     * Collection of default diacritics removal map.
      */
-
     const defaultDiacriticsRemovalMap = [
         {
             base: 'A',
@@ -4868,6 +4860,7 @@
      *
      * @param input The string containing diacritics to be normalized.
      * @returns The string with diacritics removed or normalized.
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeDiacritics(input) {
@@ -4876,9 +4869,7 @@
             return DIACRITIC_VARIANTS_LETTERS[character] || character;
         });
     }
-    /**
-     * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
-     */
+    // TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
 
     /**
      * Counts number of words in the text
@@ -4892,11 +4883,9 @@
         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
@@ -4911,10 +4900,8 @@
         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
 
     /**
      * Function checkExpectations will check if the expectations on given value are met
@@ -4925,6 +4912,7 @@
      *
      * @throws {ExpectError} if the expectations are not met
      * @returns {void} Nothing
+     *
      * @private internal function of `createPipelineExecutor`
      */
     function checkExpectations(expectations, value) {
@@ -4938,11 +4926,9 @@
             }
         }
     }
-    /**
-     * 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.
@@ -4953,6 +4939,7 @@
      *
      * @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) {
@@ -5015,6 +5002,7 @@
      *
      * @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) {
@@ -5338,9 +5326,7 @@
         }
         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).
@@ -5483,6 +5469,7 @@
      *
      * @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) {
@@ -5520,7 +5507,6 @@
     }
 
     /**
-     *
      * @param knowledgePieces
      * @returns
      *
@@ -5601,10 +5587,8 @@
             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.
@@ -5757,9 +5741,7 @@
             resultString,
         });
     }
-    /**
-     * TODO: [🤹‍♂️]
-     */
+    // TODO: [🤹‍♂️]
 
     /**
      * Filters and returns only the output parameters from the provided pipeline execution options.
@@ -6089,6 +6071,7 @@
      *
      * @returns The executor function
      * @throws {PipelineLogicError} on logical error in the pipeline
+     *
      * @public exported from `@promptbook/core`
      */
     function createPipelineExecutor(options) {
@@ -6244,8 +6227,9 @@
      * @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;
@@ -6276,6 +6260,7 @@
      *
      * @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) {
@@ -6373,6 +6358,7 @@
      * 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) {
@@ -6429,13 +6415,11 @@
             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
 
     /**
      * Safely retrieves the global scope object (window in browser, global in Node.js)
@@ -6443,7 +6427,7 @@
      *
      * 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')();
@@ -6458,6 +6442,7 @@
      * @returns The normalized text in SCREAMING_CASE format.
      * @example 'HELLO_WORLD'
      * @example 'I_LOVE_PROMPTBOOK'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_SCREAMING_CASE(text) {
@@ -6515,6 +6500,7 @@
      * @returns The normalized text in snake_case format.
      * @example 'hello_world'
      * @example 'i_love_promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_snake_case(text) {
@@ -6573,26 +6559,26 @@
      * 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
 
     /**
      * Registry for all available scrapers in the system.
      * 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
 
     /**
      * Creates a message with all registered scrapers
@@ -6677,9 +6663,7 @@
 
         `);
     }
-    /**
-     * TODO: [®] DRY Register logic
-     */
+    // TODO: [®] DRY Register logic
 
     /**
      * Converts a given text to kebab-case format.
@@ -6690,6 +6674,7 @@
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
      * @example 'i-love-promptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeToKebabCase(text) {
@@ -6730,9 +6715,7 @@
         normalizedName = normalizedName.replace(/-$/, '');
         return normalizedName;
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Creates unique name for the source
@@ -6751,9 +6734,7 @@
         // <- 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.
@@ -6803,11 +6784,9 @@
             .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
@@ -6827,6 +6806,7 @@
      *
      * @param text with emojis
      * @returns text without emojis
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeEmojis(text) {
@@ -6846,6 +6826,7 @@
      * @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) {
@@ -6891,9 +6872,7 @@
                 `));
         }
     };
-    /**
-     * 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.
@@ -7113,6 +7092,7 @@
      * Prepares the knowledge pieces
      *
      * @see https://github.com/webgptorg/promptbook/discussions/41
+     *
      * @public exported from `@promptbook/core`
      */
     async function prepareKnowledgePieces(knowledgeSources, tools, options) {
@@ -7254,25 +7234,24 @@
         });
         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) {
@@ -7451,6 +7430,7 @@
      * Parses the knowledge command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const knowledgeCommandParser = {
@@ -7537,14 +7517,13 @@
             throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
         },
     };
-    /**
-     * Note: [⛱] There are two types of KNOWLEDGE commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of KNOWLEDGE commands *...(read more in [⛱])*
 
     /**
      * Parses the section command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const sectionCommandParser = {
@@ -7736,6 +7715,7 @@
      * Note: @@ This command is used as boilerplate for new commands - it should NOT be used in any `.book` file
      *
      * @see `documentationUrl` for more details
+     *
      * @private within the commands folder
      */
     const boilerplateCommandParser = {
@@ -7827,6 +7807,7 @@
      * Parses the BOOK_VERSION command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const bookVersionCommandParser = {
@@ -7903,12 +7884,11 @@
      * Units of text measurement
      *
      * @see https://github.com/webgptorg/promptbook/discussions/30
+     *
      * @public exported from `@promptbook/core`
      */
     const EXPECTATION_UNITS = ['CHARACTERS', 'WORDS', 'SENTENCES', 'LINES', 'PARAGRAPHS', 'PAGES'];
-    /**
-     * TODO: [💝] Unite object for expecting amount and format - remove format
-     */
+    // TODO: [💝] Unite object for expecting amount and format - remove format
 
     /**
      * Function parseNumber will parse number from string
@@ -7977,17 +7957,16 @@
         }
         return num;
     }
-    /**
-     * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
-     * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
-     */
+    // TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+    // TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
 
     /**
-    import { WrappedError } from '../../errors/WrappedError';
-    import { assertsError } from '../../errors/assertsError';
+     * import { WrappedError } from '../../errors/WrappedError';
+     * import { assertsError } from '../../errors/assertsError';
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const expectCommandParser = {
@@ -8134,6 +8113,7 @@
      * @returns The camelCase formatted string.
      * @example 'helloWorld'
      * @example 'iLovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_camelCase(text, _isFirstLetterCapital = false) {
@@ -8174,9 +8154,7 @@
         }
         return normalizedName;
     }
-    /**
-     * TODO: [🌺] Use some intermediate util splitWords
-     */
+    // TODO: [🌺] Use some intermediate util splitWords
 
     /**
      * Removes quotes from a string
@@ -8190,6 +8168,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function removeQuotes(text) {
@@ -8211,6 +8190,7 @@
      * @param parameterName The parameter name to validate and normalize.
      * @returns The validated and normalized parameter name.
      * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.
+     *
      * @private within the repository
      */
     function validateParameterName(parameterName) {
@@ -8281,6 +8261,7 @@
      * Parses the foreach command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const foreachCommandParser = {
@@ -8439,14 +8420,13 @@
             throw new NotYetImplementedError(`[🛋] Not implemented yet`); // <- TODO: [🛋] Implement
         },
     };
-    /**
-     * TODO: [🍭] Make .book.md file with examples of the FOREACH with wrong parsing and logic
-     */
+    // TODO: [🍭] Make .book.md file with examples of the FOREACH with wrong parsing and logic
 
     /**
      * Parses the format command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const formatCommandParser = {
@@ -8631,9 +8611,7 @@
         inputParameters: [],
         outputParameters: [],
     };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * A generic pipeline
@@ -8785,9 +8763,7 @@
         CompletionFormfactorDefinition,
         // <- [🛬] When making new formfactor, copy the _boilerplate and link it here
     ];
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Parses the formfactor command
@@ -8795,6 +8771,7 @@
      * Note: This command is used as a formfactor for new commands and defines the app type format - it should NOT be used in any `.book` file
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const formfactorCommandParser = {
@@ -8890,6 +8867,7 @@
      * Parses the joker command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const jokerCommandParser = {
@@ -8957,7 +8935,10 @@
     };
 
     /**
+     * Constant for model variants.
+     *
      * @see {@link ModelVariant}
+     *
      * @public exported from `@promptbook/core`
      */
     const MODEL_VARIANTS = [
@@ -8972,6 +8953,7 @@
      *
      * @see `documentationUrl` for more details
      * @deprecated Option to manually set the model requirements is not recommended to use, use `PERSONA` instead
+     *
      * @public exported from `@promptbook/editable`
      */
     const modelCommandParser = {
@@ -9152,6 +9134,7 @@
      * Parses the parameter command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const parameterCommandParser = {
@@ -9262,6 +9245,7 @@
      * Parses the persona command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const personaCommandParser = {
@@ -9394,6 +9378,7 @@
      *
      * @param javascriptName The value to check for JavaScript identifier validity.
      * @returns `true` if the value is a valid JavaScript name, false otherwise.
+     *
      * @public exported from `@promptbook/utils`
      */
     function isValidJavascriptName(javascriptName) {
@@ -9407,6 +9392,7 @@
      * Parses the postprocess command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const postprocessCommandParser = {
@@ -9485,6 +9471,7 @@
      * Parses the url command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const urlCommandParser = {
@@ -9586,6 +9573,7 @@
      * Parses the action command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const actionCommandParser = {
@@ -9643,14 +9631,13 @@
             throw new NotYetImplementedError('[🛠] Actions are not implemented yet');
         },
     };
-    /**
-     * Note: [⛱] There are two types of ACTION commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of ACTION commands *...(read more in [⛱])*
 
     /**
      * Parses the instrument command
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/editable`
      */
     const instrumentCommandParser = {
@@ -9708,9 +9695,7 @@
             throw new NotYetImplementedError('[🛠] Instruments are not implemented yet');
         },
     };
-    /**
-     * Note: [⛱] There are two types of INSTRUMENT commands *...(read more in [⛱])*
-     */
+    // Note: [⛱] There are two types of INSTRUMENT commands *...(read more in [⛱])*
 
     /**
      * All available command parsers
@@ -9736,9 +9721,7 @@
         boilerplateCommandParser, // <- TODO: Only in development, remove in production
         // <- Note: [♓️][💩] This is the order of the commands in the pipeline, BUT its not used in parsing and before usage maybe it should be done better
     ];
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Gets the parser for the command
@@ -9768,6 +9751,7 @@
      *
      * @param {string} str - The string to remove Markdown tags from.
      * @returns {string} The input string with all Markdown tags removed.
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownFormatting(str) {
@@ -10153,9 +10137,7 @@
             });
         },
     };
-    /**
-     * TODO: [🧠][📛] Should this be here?
-     */
+    // TODO: [🧠][📛] Should this be here?
 
     /**
      * All high-level abstractions
@@ -10167,10 +10149,8 @@
         QuickChatbotHla,
         // <- Note: [♓️][💩] This is the order of the application of high-level abstractions application on pipeline JSON
     ];
-    /**
-     * TODO: Test that all sync high-level abstractions are before async high-level abstractions
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // TODO: Test that all sync high-level abstractions are before async high-level abstractions
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Supported script languages
@@ -10181,7 +10161,7 @@
     //          <- TODO: [🏥] DRY
 
     /**
-     *  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`
      */
@@ -10218,15 +10198,14 @@
         const linesToAdd = PADDING_LINES - trailingEmptyLines;
         return (content + '\n'.repeat(linesToAdd));
     }
-    /**
-     * TODO: [🧠] Maybe export
-     */
+    // TODO: [🧠] Maybe export
 
     /**
      * Removes Markdown (or HTML) comments
      *
      * @param {string} content - The string to remove comments from.
      * @returns {string} The input string with all comments removed.
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownComments(content) {
@@ -10304,9 +10283,7 @@
         // <- TODO: Maybe use book` notation
         return padBook(pipelineString);
     }
-    /**
-     * TODO: Unit test
-     */
+    // TODO: Unit test
 
     /**
      * Utility function to extract all list items from markdown
@@ -10318,6 +10295,7 @@
      *
      * @param markdown any valid markdown
      * @returns An array of strings, each representing an individual list item found in the markdown
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     function extractAllListItemsFromMarkdown(markdown) {
@@ -10350,8 +10328,9 @@
      *
      * @param markdown any valid markdown
      * @returns code block with language and content
-     * @public exported from `@promptbook/markdown-utils`
      * @throws {ParseError} if there is not exactly one code block in the markdown
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractOneBlockFromMarkdown(markdown) {
         const codeBlocks = extractAllBlocksFromMarkdown(markdown);
@@ -10364,9 +10343,7 @@
         }
         return codeBlocks[0];
     }
-    /***
-     * TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
-     */
+    // TODO: [🍓][🌻] Decide of this is internal utility, external util OR validator/postprocessor
 
     /**
      * Parses markdown section to title its level and content
@@ -10508,6 +10485,7 @@
      * @param pipelineString {Promptbook} in string markdown format (.book.md)
      * @returns {Promptbook} compiled in JSON format (.bookc)
      * @throws {ParseError} if the promptbook string is not valid
+     *
      * @public exported from `@promptbook/core`
      */
     function parsePipeline(pipelineString) {
@@ -10928,31 +10906,29 @@
             },
         });
     }
-    /**
-     * TODO: [🧠] Maybe more things here can be refactored as high-level abstractions
-     * TODO: [main] !!4 Warn if used only sync version
-     * TODO: [🚞] Report here line/column of error
-     * TODO: Use spaceTrim more effectively
-     * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
-     * TODO: [🥞] Not optimal parsing because `splitMarkdownIntoSections` is executed twice with same string, once through `flattenMarkdown` and second directly here
-     * TODO: [♈] Probably move expectations from tasks to parameters
-     * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
-     * TODO: [🍙] Make some standard order of json properties
-     */
+    // TODO: [🧠] Maybe more things here can be refactored as high-level abstractions
+    // TODO: [main] !!4 Warn if used only sync version
+    // TODO: [🚞] Report here line/column of error
+    // TODO: Use spaceTrim more effectively
+    // TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
+    // TODO: [🥞] Not optimal parsing because `splitMarkdownIntoSections` is executed twice with same string, once through `flattenMarkdown` and second directly here
+    // TODO: [♈] Probably move expectations from tasks to parameters
+    // TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+    // TODO: [🍙] Make some standard order of json properties
 
     /**
      * Compile pipeline from string (markdown) format to JSON format
      *
-     * @see https://github.com/webgptorg/promptbook/discussions/196
-     *
      * Note: This function does not validate logic of the pipeline only the parsing
      * Note: This function acts as compilation process
      *
+     * @see https://github.com/webgptorg/promptbook/discussions/196
      * @param pipelineString {Promptbook} in string markdown format (.book.md)
      * @param tools - Tools for the preparation and scraping - if not provided together with `llm`, the preparation will be skipped
      * @param options - Options and tools for the compilation
      * @returns {Promptbook} compiled in JSON format (.bookc)
      * @throws {ParseError} if the promptbook string is not valid
+     *
      * @public exported from `@promptbook/core`
      */
     async function compilePipeline(pipelineString, tools, options) {
@@ -10965,11 +10941,9 @@
         // Note: No need to use `$exportJson` because `parsePipeline` and `preparePipeline` already do that
         return pipelineJson;
     }
-    /**
-     * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
-     * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
-     * TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
-     */
+    // TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
+    // TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+    // TODO: [🧠] Should be in generated JSON file GENERATOR_WARNING
 
     /**
      * Unsafe characters that prevent an inline parameter.
@@ -10993,6 +10967,7 @@
      * 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) {
@@ -11007,6 +10982,7 @@
      * 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) {
@@ -11016,6 +10992,7 @@
      * Restores hidden brackets.
      *
      * @param value String with hidden brackets.
+     *
      * @private function of ParameterEscaping
      */
     function restoreBrackets(value) {
@@ -11025,6 +11002,7 @@
      * Decides whether a parameter can be inlined safely.
      *
      * @param value Parameter rendered as string.
+     *
      * @private function of ParameterEscaping
      */
     function shouldInlineParameterValue(value) {
@@ -11038,6 +11016,7 @@
      *
      * @param value Parameter value to escape.
      * @param options Escape options for additional characters.
+     *
      * @private function of ParameterEscaping
      */
     function escapePromptParameterValue(value, options) {
@@ -11063,6 +11042,7 @@
      * Builds numeric parameter names (1, 2, ...).
      *
      * @param index Zero-based parameter index.
+     *
      * @private function of ParameterNaming
      */
     function buildNumericParameterName(index) {
@@ -11072,6 +11052,7 @@
      * Builds alphabetic parameter names (a, b, ..., aa).
      *
      * @param index Zero-based parameter index.
+     *
      * @private function of ParameterNaming
      */
     function buildAlphabeticParameterName(index) {
@@ -11088,6 +11069,7 @@
      * Converts a positive integer into a Roman numeral string.
      *
      * @param value Positive integer value.
+     *
      * @private function of ParameterNaming
      */
     function toRomanNumeral(value) {
@@ -11120,6 +11102,7 @@
      * Builds Roman numeral parameter names (I, II, ...).
      *
      * @param index Zero-based parameter index.
+     *
      * @private function of ParameterNaming
      */
     function buildRomanParameterName(index) {
@@ -11130,6 +11113,7 @@
      *
      * @param prefix Prefix string.
      * @param builder Base builder function.
+     *
      * @private function of ParameterNaming
      */
     function buildPrefixedParameterName(prefix, builder) {
@@ -11151,6 +11135,7 @@
      * Collects bracketed tokens from parameter values to avoid placeholder collisions.
      *
      * @param values Parameter values to scan.
+     *
      * @private function of ParameterNaming
      */
     function collectBracketedParameterTokens(values) {
@@ -11171,6 +11156,7 @@
      * 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) {
@@ -11201,6 +11187,7 @@
      * Formats the placeholder used in the prompt body for a parameter.
      *
      * @param name Parameter placeholder name.
+     *
      * @private function of ParameterSection
      */
     function formatParameterPlaceholder(name) {
@@ -11210,6 +11197,7 @@
      * Formats a single line entry for structured parameters.
      *
      * @param item Parameter entry data.
+     *
      * @private function of ParameterSection
      */
     function formatParameterListItem(item) {
@@ -11221,6 +11209,7 @@
      * Builds the structured parameters section appended to the prompt.
      *
      * @param items Parameter entries to include.
+     *
      * @private function of ParameterSection
      */
     function buildParametersSection(items) {
@@ -11296,6 +11285,7 @@
      * @param strings
      * @param values
      * @returns prompt content wrapped as a PromptString
+     *
      * @public exported from `@promptbook/utils`
      */
     function prompt(strings, ...values) {
@@ -11380,11 +11370,9 @@
         }
         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
 
     /**
      * @@@
@@ -11421,9 +11409,7 @@
             [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)
@@ -11440,9 +11426,7 @@
             return false;
         }
     }
-    /**
-     * TODO: [🎺]
-     */
+    // TODO: [🎺]
 
     /**
      * Detects if the code is running in a Node.js environment
@@ -11459,9 +11443,7 @@
             return false;
         }
     }
-    /**
-     * TODO: [🎺]
-     */
+    // TODO: [🎺]
 
     /**
      * Detects if the code is running in a web worker
@@ -11481,9 +11463,7 @@
             return false;
         }
     }
-    /**
-     * TODO: [🎺]
-     */
+    // TODO: [🎺]
 
     /**
      * Computes SHA-256 hash of the given object
@@ -11493,9 +11473,7 @@
     function computeHash(value) {
         return cryptoJs.SHA256(hexEncoder__default["default"].parse(_spaceTrim.spaceTrim(valueToString(value)))).toString( /* hex */);
     }
-    /**
-     * TODO: [🥬][🥬] Use this ACRY
-     */
+    // TODO: [🥬][🥬] Use this ACRY
 
     // spell-checker: disable
     /**
@@ -11661,6 +11639,9 @@
         'prvotní',
         'hbitý',
     ];
+    /**
+     * Collection of nouns.
+     */
     const NOUNS$1 = [
         'jablko',
         'nebe',
@@ -11874,6 +11855,9 @@
         'okno',
         'chodba',
     ];
+    /**
+     * Collection of verbs.
+     */
     const VERBS$1 = [
         'skáče',
         'tančí',
@@ -12046,9 +12030,7 @@
         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
 
     /**
      * @@@
@@ -12304,6 +12286,9 @@
         'macro',
         'mini',
     ];
+    /**
+     * Collection of nouns.
+     */
     const NOUNS = [
         'apple',
         'sky',
@@ -12543,6 +12528,9 @@
         'roof',
         'floor',
     ];
+    /**
+     * Collection of verbs.
+     */
     const VERBS = [
         'jumping',
         'dancing',
@@ -12738,9 +12726,7 @@
         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.
@@ -12915,8 +12901,9 @@
     /**
      * 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`
@@ -12935,6 +12922,7 @@
      * 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() {
@@ -12957,6 +12945,7 @@
      *
      * @param {string} input
      * @returns {Set} of keywords without diacritics in lowercase
+     *
      * @public exported from `@promptbook/utils`
      */
     function parseKeywordsFromString(input) {
@@ -12973,6 +12962,7 @@
      * @param name The string to be converted to a URI-compatible format.
      * @returns A URI-compatible string derived from the input name.
      * @example 'Hello World' -> 'hello-world'
+     *
      * @public exported from `@promptbook/utils`
      */
     function nameToUriPart(name) {
@@ -12991,6 +12981,7 @@
      * @param name The name to be converted into URI parts.
      * @returns An array of URI-compatible parts derived from the name.
      * @example 'Example Name' -> ['example', 'name']
+     *
      * @public exported from `@promptbook/utils`
      */
     function nameToUriParts(name) {
@@ -13020,6 +13011,7 @@
      * @returns
      * @example 'HelloWorld'
      * @example 'ILovePromptbook'
+     *
      * @public exported from `@promptbook/utils`
      */
     function normalizeTo_PascalCase(text) {
@@ -13048,6 +13040,7 @@
      *
      * @param text optionally quoted text
      * @returns text without quotes
+     *
      * @public exported from `@promptbook/utils`
      */
     function unwrapResult(text, options) {
@@ -13122,9 +13115,7 @@
             return processedText;
         }
     }
-    /**
-     * TODO: [🧠] Should this also unwrap the (parenthesis)
-     */
+    // TODO: [🧠] Should this also unwrap the (parenthesis)
 
     // <- TODO: Auto convert to type `import { ... } from 'type-fest';`
     /**
@@ -13143,7 +13134,6 @@
      * - `Symbol` objects are not serializable
      * - And much more...
      *
-     *
      * @public exported from `@promptbook/utils`
      */
     function isSerializableAsJson(value) {
@@ -13155,15 +13145,14 @@
             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?
 
     /**
      * Determines if the given path is a root path.
      *
      * Note: This does not check if the file exists only if the path is valid
+     *
      * @public exported from `@promptbook/utils`
      */
     function isRootPath(value) {
@@ -13175,9 +13164,7 @@
         }
         return false;
     }
-    /**
-     * TODO: [🍏] Make for MacOS paths
-     */
+    // TODO: [🍏] Make for MacOS paths
 
     /**
      * Checks if an URL is reserved for private networks or localhost.
@@ -13223,6 +13210,7 @@
      * @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 = {}) {
@@ -13261,9 +13249,7 @@
         */
         return true;
     }
-    /**
-     * TODO: [🐠] Maybe more info why the URL is invalid
-     */
+    // TODO: [🐠] Maybe more info why the URL is invalid
 
     /**
      * Provides filesystem access (for example for Node.js-based scrapers)
@@ -13286,10 +13272,8 @@
             watch: promises.watch,
         };
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [🟢] Code for Node scraper registration helper [$provideFilesystemForNode](src/scrapers/_common/register/$provideFilesystemForNode.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Retrieves an intermediate source for a scraper based on the knowledge source.
@@ -13353,13 +13337,11 @@
         };
         return fileHandler;
     }
-    /**
-     * Note: Not using `FileCacheStorage` for two reasons:
-     * 1) Need to store more than serialized JSONs
-     * 2) Need to switch between a `rootDirname` and `cacheDirname` <- TODO: [😡]
-     * TODO: [🐱‍🐉][🧠] Make some smart crop
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node scraper helper [getScraperIntermediateSource](src/scrapers/_common/utils/getScraperIntermediateSource.ts) should never be published into packages that could be imported into browser environment
+    // Note: Not using `FileCacheStorage` for two reasons:
+    // 1. Need to store more than serialized JSONs.
+    // 2. Need to switch between a `rootDirname` and `cacheDirname` <- TODO: [😡]
+    // TODO: [🐱‍🐉][🧠] Make some smart crop
 
     /**
      * Metadata of the scraper
@@ -13386,14 +13368,13 @@
      * @public exported from `@promptbook/cli`
      */
     $scrapersMetadataRegister.register(markdownScraperMetadata);
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Scraper for markdown files
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/markdown-utils`
      */
     class MarkdownScraper {
@@ -13526,10 +13507,8 @@
             return knowledge;
         }
     }
-    /**
-     * TODO: [🪂] Do it in parallel 11:11
-     * Note: No need to aggregate usage here, it is done by intercepting the llmTools
-     */
+    // TODO: [🪂] Do it in parallel 11:11
+    // Note: No need to aggregate usage here, it is done by intercepting the llmTools
 
     /**
      * Metadata of the scraper
@@ -13556,9 +13535,7 @@
      * @public exported from `@promptbook/cli`
      */
     $scrapersMetadataRegister.register(websiteScraperMetadata);
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * Create a new showdown converter instance
@@ -13587,6 +13564,7 @@
      * Scraper for websites
      *
      * @see `documentationUrl` for more details
+     *
      * @public exported from `@promptbook/website-crawler`
      */
     class WebsiteScraper {
@@ -13690,12 +13668,10 @@
             return knowledge;
         }
     }
-    /**
-     * TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
-     * TODO: [🪂] Do it in parallel 11:11
-     * Note: No need to aggregate usage here, it is done by intercepting the llmTools
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node scraper implementation [WebsiteScraper](src/scrapers/website/WebsiteScraper.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
+    // TODO: [🪂] Do it in parallel 11:11
+    // Note: No need to aggregate usage here, it is done by intercepting the llmTools
 
     /**
      * Fetches and scrapes content from a URL (SERVER-SIDE ONLY)
@@ -13706,14 +13682,14 @@
      * 3. Uses the appropriate scraper to convert to markdown
      * 4. Returns the scraped markdown content
      *
+     * WARNING: This function should NOT be used directly in browser environments.
+     * For browser environments, use fetchUrlContentViaBrowser which proxies through
+     * the Agents Server API endpoint at /api/scrape
+     *
      * @param url The URL to fetch and scrape
      * @returns Markdown content from the URL
      *
      * @private internal utility for USE BROWSER commitment
-     *
-     * WARNING: This function should NOT be used directly in browser environments.
-     * For browser environments, use fetchUrlContentViaBrowser which proxies through
-     * the Agents Server API endpoint at /api/scrape
      */
     async function fetchUrlContent(url) {
         try {
@@ -13817,9 +13793,7 @@
         `);
         }
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node browser-fetch helper [fetchUrlContent](src/commitments/USE_BROWSER/fetchUrlContent.ts) should never be published into packages that could be imported into browser environment
 
     /**
      * Cached implementation of `run_browser` when it can be resolved.
@@ -13837,6 +13811,7 @@
      * Attempts to load the server-side `run_browser` tool lazily.
      *
      * @returns Loaded `run_browser` implementation
+     *
      * @private internal utility for USE BROWSER commitment
      */
     function loadRunBrowserToolForNode() {
@@ -14206,9 +14181,7 @@
             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
 
     /**
      * CLOSED commitment definition
@@ -14274,9 +14247,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * COMPONENT commitment definition
@@ -14335,9 +14306,7 @@
             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
@@ -14459,9 +14428,7 @@
             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
@@ -14565,9 +14532,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * FORMAT commitment definition
@@ -14646,10 +14611,11 @@
             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
+     * Collection of firstnames.
      */
-
     const FIRSTNAMES = [
         'Paul',
         'George',
@@ -14686,6 +14652,9 @@
         'Anthony',
         'Christopher',
     ];
+    /**
+     * Collection of lastnames with colors.
+     */
     const LASTNAMES_WITH_COLORS = [
         { lastname: 'Green', color: '#008000' },
         { lastname: 'Brown', color: '#A52A2A' },
@@ -14713,6 +14682,7 @@
      *
      * @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) {
@@ -14754,6 +14724,9 @@
      * 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',
@@ -14802,6 +14775,7 @@
      *
      * @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) {
@@ -14816,6 +14790,7 @@
      *
      * @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) {
@@ -14836,6 +14811,7 @@
      *
      * @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) {
@@ -14851,6 +14827,7 @@
      *
      * @param rawReference - Raw reference content.
      * @returns True when the reference maps to void.
+     *
      * @private internal utility of pseudo-agent resolution
      */
     function isVoidPseudoAgentReference(rawReference) {
@@ -14864,9 +14841,7 @@
         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
@@ -14945,9 +14920,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * GOAL commitment definition
@@ -15045,9 +15018,7 @@
             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
@@ -15126,19 +15097,26 @@
             `));
         }
     }
+    // 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) {
@@ -15168,7 +15146,9 @@
         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();
@@ -15188,7 +15168,9 @@
         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;
@@ -15203,7 +15185,9 @@
         return normalized;
     }
     /**
-     * @private Counts character occurrences in a string.
+     * Counts character occurrences in a string.
+     *
+     * @private
      */
     function countOccurrences(value, searchedChar) {
         let count = 0;
@@ -15215,14 +15199,28 @@
         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/);
@@ -15235,7 +15233,9 @@
         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);
@@ -15246,7 +15246,9 @@
         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();
@@ -15269,7 +15271,9 @@
         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');
@@ -15329,9 +15333,7 @@
             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
@@ -15535,9 +15537,7 @@
             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
 
     /**
      * @@@
@@ -15803,6 +15803,7 @@
      *
      * @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) {
@@ -15815,14 +15816,13 @@
      * 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.
@@ -16183,9 +16183,7 @@
             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
@@ -16515,9 +16513,7 @@
             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
@@ -16648,9 +16644,7 @@
             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
@@ -16797,9 +16791,7 @@
             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
@@ -16895,9 +16887,7 @@
             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
@@ -16962,9 +16952,7 @@
             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
@@ -17032,9 +17020,7 @@
             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
@@ -17117,9 +17103,7 @@
             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
@@ -17204,9 +17188,7 @@
             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.
@@ -17269,9 +17251,7 @@
             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
@@ -17378,9 +17358,7 @@
             }
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * META VOICE commitment definition
@@ -17449,9 +17427,7 @@
             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
@@ -17689,9 +17665,7 @@
             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
@@ -17853,9 +17827,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * PERSONA commitment definition
@@ -17994,9 +17966,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * RULE commitment definition
@@ -18077,15 +18047,14 @@
             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) {
@@ -18103,6 +18072,7 @@
      *
      * @param content - Writing-only instructions.
      * @returns Writing-rules guidance ready for one system-message section.
+     *
      * @private internal utility of writing commitments
      */
     function createWritingRulesSection(content) {
@@ -18115,9 +18085,7 @@
         ${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.
@@ -18196,9 +18164,7 @@
             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
@@ -18320,9 +18286,7 @@
             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
@@ -18419,6 +18383,7 @@
      *
      * @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) {
@@ -18434,6 +18399,7 @@
      * @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) {
@@ -18441,9 +18407,21 @@
         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.
@@ -18491,6 +18469,9 @@
         }
         return teammates;
     }
+    /**
+     * Extracts the instruction fragment associated with one teammate URL.
+     */
     function extractInstructionContext(line, matches, matchIndex) {
         var _a;
         const match = matches[matchIndex];
@@ -18516,6 +18497,9 @@
         }
         return `${prefix} ${suffix}`.trim();
     }
+    /**
+     * Trims content after the last detected clause delimiter.
+     */
     function trimAfterLastDelimiter(text) {
         const match = findLastDelimiter(text);
         if (!match) {
@@ -18523,6 +18507,9 @@
         }
         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);
@@ -18531,6 +18518,9 @@
         }
         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;
@@ -18554,6 +18544,9 @@
         }
         return { index: bestIndex, length: bestLength };
     }
+    /**
+     * Normalizes teammate instruction text after URL extraction.
+     */
     function normalizeInstructionText(text) {
         if (!text) {
             return '';
@@ -18567,6 +18560,9 @@
         normalized = normalizeWhitespaces(normalized).trim();
         return normalized;
     }
+    /**
+     * Creates a readable teammate label from an agent URL.
+     */
     function createTeammateLabel(url) {
         try {
             const parsed = new URL(url);
@@ -18586,12 +18582,19 @@
             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
@@ -18955,9 +18958,7 @@
             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
@@ -19078,9 +19079,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * USE commitment definition
@@ -19192,9 +19191,7 @@
             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.
@@ -19217,6 +19214,7 @@
      *
      * @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) {
@@ -19227,6 +19225,7 @@
      *
      * @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) {
@@ -19237,6 +19236,7 @@
      *
      * @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) {
@@ -19248,6 +19248,7 @@
      * @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) {
@@ -19286,6 +19287,7 @@
      * @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) {
@@ -19309,6 +19311,7 @@
      * @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) {
@@ -19601,9 +19604,7 @@
             };
         }
     }
-    /**
-     * 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.
@@ -19874,9 +19875,7 @@
         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.
@@ -20827,9 +20826,7 @@
             ...(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.
@@ -21095,9 +21092,7 @@
             },
         ];
     }
-    /**
-     * 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
@@ -21188,9 +21183,7 @@
                 `));
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * USE MCP commitment definition
@@ -21265,9 +21258,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * USE POPUP commitment definition
@@ -21403,9 +21394,7 @@
             };
         }
     }
-    /**
-     * 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.
@@ -21577,9 +21566,7 @@
             };
         }
     }
-    /**
-     * 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 */
     /**
@@ -22367,9 +22354,7 @@
             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.
@@ -23228,9 +23213,7 @@
             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.
@@ -23441,9 +23424,7 @@
             };
         }
     }
-    /**
-     * 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.
@@ -23640,9 +23621,7 @@
             };
         }
     }
-    /**
-     * 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`.
@@ -23707,9 +23686,7 @@
             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.
@@ -24443,9 +24420,7 @@
             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
@@ -24592,9 +24567,7 @@
             };
         }
     }
-    /**
-     * 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.
@@ -24807,9 +24780,7 @@
             };
         }
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     /**
      * `WRITING RULES` commitment definition.
@@ -24885,9 +24856,7 @@
             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.
@@ -24957,9 +24926,7 @@
             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
@@ -25121,13 +25088,12 @@
         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`
@@ -25140,6 +25106,7 @@
      * Collects tool functions from all commitment definitions.
      *
      * @returns Map of tool function implementations.
+     *
      * @private internal helper for commitment tool registry
      */
     function collectCommitmentToolFunctions() {
@@ -25161,6 +25128,7 @@
      *
      * @param getFunctions - Provider of current tool functions.
      * @returns Proxy exposing tool functions as properties.
+     *
      * @private internal helper for commitment tool registry
      */
     function createToolFunctionsProxy(getFunctions) {
@@ -25198,10 +25166,11 @@
             },
         });
     }
+    // Note: [💞] Ignore a discrepancy between file name and entity name
+
     /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * Map of node tool functions.
      */
-
     const nodeToolFunctions = {
         /**
          * @@@
@@ -25233,6 +25202,9 @@
         spawn_agent: resolveSpawnAgentToolForNode(),
         // TODO: !!!! Unhardcode, make proper server function register from definitions
     };
+    /**
+     * Constant for node tool functions proxy.
+     */
     const nodeToolFunctionsProxy = createToolFunctionsProxy(() => ({
         ...collectCommitmentToolFunctions(),
         ...nodeToolFunctions,
@@ -25256,10 +25228,8 @@
         }
         return nodeToolFunctionsProxy;
     }
-    /**
-     * Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
+    // TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Normalize options for `execCommand` and `execCommands`
@@ -25327,7 +25297,6 @@
     /**
      * Run one command in a shell
      *
-     *
      * Note: There are 2 similar functions in the codebase:
      * - `$execCommand` which runs a single command
      * - `$execCommands` which runs multiple commands
@@ -25426,9 +25395,7 @@
             }
         });
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node command-execution helper [$execCommand](src/utils/execCommand/$execCommand.ts) should never be published into packages that could be imported into browser environment
 
     /**
      * Attempts to locate the specified application on a Linux system using the 'which' command.
@@ -25446,10 +25413,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locateAppOnLinux](src/executables/platforms/locateAppOnLinux.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node`
 
     /**
      * Checks if the file is executable
@@ -25465,15 +25430,15 @@
             return false;
         }
     }
-    /**
-     * Note: Not [~🟢~] because it is not directly dependent on `fs
-     * TODO: [🖇] What about symlinks?
-     */
+    // Note: Not [~🟢~] because it is not directly dependent on `fs
+    // TODO: [🖇] What about symlinks?
 
     // Note: Module `userhome` has no types available, so it is imported using `require`
     //       @see https://stackoverflow.com/questions/37000981/how-to-import-node-module-in-typescript-without-type-definitions
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const userhome = require('userhome');
+    /**
+     * Constant for userhome.
+     */
+    const userhome = require('userhome'); // eslint-disable-line @typescript-eslint/no-var-requires
     /**
      * Attempts to locate the specified application on a macOS system by checking standard application paths and using mdfind.
      * Returns the path to the executable if found, or null otherwise.
@@ -25502,10 +25467,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locateAppOnMacOs](src/executables/platforms/locateAppOnMacOs.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node`
 
     /**
      * Attempts to locate the specified application on a Windows system by searching common installation directories.
@@ -25534,10 +25497,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locateAppOnWindows](src/executables/platforms/locateAppOnWindows.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node`
 
     /**
      * Locates an application on the system
@@ -25574,10 +25535,8 @@
             }
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locateApp](src/executables/locateApp.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node`
 
     /**
      * Locates the LibreOffice executable on the current system by searching platform-specific paths.
@@ -25593,10 +25552,8 @@
             macOsName: 'LibreOffice',
         });
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locateLibreoffice](src/executables/apps/locateLibreoffice.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
 
     /**
      * Locates the Pandoc executable on the current system by searching platform-specific paths.
@@ -25612,10 +25569,8 @@
             macOsName: 'Pandoc',
         });
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node executable locator [locatePandoc](src/executables/apps/locatePandoc.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
 
     /**
      * Provides paths to required executables (i.e. as Pandoc and LibreOffice) for Node.js environments.
@@ -25632,35 +25587,33 @@
             //                                              <- TODO: [🧠] `null` vs `undefined`
         };
     }
-    /**
-     * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [🟢] Code for Node executable locator [$provideExecutablesForNode](src/executables/$provideExecutablesForNode.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
+    // TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Register for LLM tools metadata.
      *
      * 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 instances across different builds or environments.
+     *
      * @public exported from `@promptbook/core`
      */
     const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
-    /**
-     * TODO: [®] DRY Register logic
-     */
+    // TODO: [®] DRY Register logic
 
     /**
      * Register for LLM tools.
      *
      * 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 instances across different builds or environments.
+     *
      * @public exported from `@promptbook/core`
      */
     const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
-    /**
-     * TODO: [®] DRY Register logic
-     */
+    // TODO: [®] DRY Register logic
 
     /**
      * Path to the `.env` file which was used to configure LLM tools
@@ -25797,10 +25750,8 @@
         .join('\n'))}
         `);
     }
-    /**
-     * TODO: [®] DRY Register logic
-     * TODO: [🧠][⚛] Maybe pass env as argument
-     */
+    // TODO: [®] DRY Register logic
+    // TODO: [🧠][⚛] Maybe pass env as argument
 
     /**
      * Provides the path to the `.env` file
@@ -25842,9 +25793,7 @@
         }
         return null;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node environment helper [$provideEnvFilename](src/llm-providers/_common/register/$provideEnvFilename.ts) should never be published into packages that could be imported into browser environment
 
     /**
      * Provides LLM tools configuration by reading environment variables.
@@ -25858,6 +25807,7 @@
      *
      * @see Environment variables documentation or .env file for required variables.
      * @returns A promise that resolves to the LLM tools configuration, or null if configuration is incomplete or missing.
+     *
      * @public exported from `@promptbook/node`
      */
     async function $provideLlmToolsConfigurationFromEnv() {
@@ -25874,9 +25824,7 @@
             .filter((configuration) => configuration !== null);
         return llmToolsConfiguration;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node environment helper [$provideLlmToolsConfigurationFromEnv](src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.ts) should never be published into packages that could be imported into browser environment
 
     /**
      * Creates LLM execution tools from provided configuration objects
@@ -25889,6 +25837,7 @@
      * @param configuration Array of LLM tool configurations to instantiate
      * @param options Additional options for configuring the LLM tools
      * @returns A unified interface combining all successfully instantiated LLM tools
+     *
      * @public exported from `@promptbook/core`
      */
     function createLlmToolsFromConfiguration(configuration, options = {}) {
@@ -25958,6 +25907,7 @@
      *
      * @param options Configuration options for the LLM tools
      * @returns A unified interface containing all detected and configured LLM tools
+     *
      * @public exported from `@promptbook/node`
      */
     async function $provideLlmToolsFromEnv(options = {}) {
@@ -25982,29 +25932,26 @@
         }
         return createLlmToolsFromConfiguration(configuration, options);
     }
-    /**
-     * TODO: The architecture for LLM tools configuration consists of three key functions:
-     * 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
-     * 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
-     * 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
-     *
-     * This layered approach allows flexibility in how tools are configured:
-     * - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
-     * - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
-     * - Use createLlmToolsFromConfiguration for explicit control over tool configurations
-     *
-     * TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
-     * TODO: [🧠] Is there some meaningfull way how to test this util
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🥃] Allow `ptbk make` without llm tools
-     * TODO: This should be maybe not under `_common` but under `utils`
-     * TODO: [®] DRY Register logic
-     */
+    // Note: [🟢] Code for Node environment helper [$provideLlmToolsFromEnv](src/llm-providers/_common/register/$provideLlmToolsFromEnv.ts) should never be published into packages that could be imported into browser environment
+    // TODO: The architecture for LLM tools configuration consists of three key functions:
+    // 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
+    // 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
+    // 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
+    // This layered approach allows flexibility in how tools are configured:
+    // - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
+    // - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
+    // - Use createLlmToolsFromConfiguration for explicit control over tool configurations
+    // TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
+    // TODO: [🧠] Is there some meaningfull way how to test this util
+    // TODO: [🥃] Allow `ptbk make` without llm tools
+    // TODO: This should be maybe not under `_common` but under `utils`
+    // TODO: [®] DRY Register logic
 
     /**
      * Provides a collection of scrapers optimized for Node.js environment.
      * 1) `provideScrapersForNode` use as default
      * 2) `provideScrapersForBrowser` use in limited browser environment *
+     *
      * @public exported from `@promptbook/node`
      */
     async function $provideScrapersForNode(tools, options) {
@@ -26024,10 +25971,8 @@
         }
         return scrapers;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [🟢] Code for Node scraper registration helper [$provideScrapersForNode](src/scrapers/_common/register/$provideScrapersForNode.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Extracts code block from markdown.
@@ -26040,8 +25985,9 @@
      * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
      * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
      *
-     * @public exported from `@promptbook/markdown-utils`
      * @throws {ParseError} if there is not exactly one code block in the markdown
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractBlock(markdown) {
         const { content } = extractOneBlockFromMarkdown(markdown);
@@ -26053,7 +25999,7 @@
      *
      * Note: [🔂] This function is idempotent.
      * Note: This is useful for post-processing of the result of the chat LLM model
-     *       when the model wraps the result in the (markdown) code block.
+     * when the model wraps the result in the (markdown) code block.
      *
      * @public exported from `@promptbook/markdown-utils`
      */
@@ -26072,7 +26018,7 @@
      * Function trimEndOfCodeBlock will remove ending code block from the string if it is present.
      *
      * Note: This is useful for post-processing of the result of the completion LLM model
-     *       if you want to start code block in the prompt but you don't want to end it in the result.
+     * if you want to start code block in the prompt but you don't want to end it in the result.
      *
      * @public exported from `@promptbook/markdown-utils`
      */
@@ -26084,6 +26030,8 @@
     }
 
     /**
+     * Collection of preserved.
+     *
      * @private internal for `preserve`
      */
     const _preserved = [];
@@ -26093,21 +26041,20 @@
      *
      * @param value any function to preserve
      * @returns nothing
+     *
      * @private within the repository
      */
     function $preserve(...value) {
         _preserved.push(...value);
     }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
+    // Note: [💞] Ignore a discrepancy between file name and entity name
 
     // Note: [💎]
     /**
      * ScriptExecutionTools for JavaScript implemented via eval
      *
      * Warning: It is used for testing and mocking
-     *          **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
+     * **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
      *
      * @public exported from `@promptbook/javascript`
      */
@@ -26302,23 +26249,22 @@
             return result;
         }
     }
-    /**
-     * TODO: Put predefined functions (like removeQuotes, spaceTrim, etc.) into annotation OR pass into constructor
-     * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
-     */
+    // TODO: Put predefined functions (like removeQuotes, spaceTrim, etc.) into annotation OR pass into constructor
+    // TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
 
     /**
      * Placeholder for better implementation of JavascriptExecutionTools - some proper sandboxing
      *
      * @alias JavascriptExecutionTools
+     *
      * @public exported from `@promptbook/javascript`
      */
     const JavascriptExecutionTools = JavascriptEvalExecutionTools;
 
     /**
      * Note: There is unfortunately no equivalent for this function in the browser environment
-     *       because it is not possible automatically detect configured LLM providers
-     *       you need to provide them manually BUT you can help by utilities like `$provideScrapersForBrowser`
+     * because it is not possible automatically detect configured LLM providers
+     * you need to provide them manually BUT you can help by utilities like `$provideScrapersForBrowser`
      *
      * @public exported from `@promptbook/node`
      */
@@ -26343,10 +26289,8 @@
         };
         return tools;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [🟢] Code for Node execution helper [$provideExecutionToolsForNode](src/execution/utils/$provideExecutionToolsForNode.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Checks if the directory exists
@@ -26367,12 +26311,10 @@
             .catch(() => false);
         return isDirectory;
     }
-    /**
-     * 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: [🧠][📂] "directory" vs "folder"
-     * 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: [🧠][📂] "directory" vs "folder"
+    // TODO: [🖇] What about symlinks?
 
     /**
      * Reads all files in the directory
@@ -26380,6 +26322,7 @@
      * @param path
      * @param isRecursive
      * @returns List of all files in the directory
+     *
      * @private internal function of `AgentCollectionInDirectory` and `createPipelineCollectionFromDirectory`
      */
     async function listAllFiles(path$1, isRecursive, fs) {
@@ -26401,11 +26344,9 @@
         }
         return fileNames;
     }
-    /**
-     * TODO: [😶] Unite folder listing
-     * Note: Not [~🟢~] because it is not directly dependent on `fs
-     * TODO: [🖇] What about symlinks?
-     */
+    // TODO: [😶] Unite folder listing
+    // Note: Not [~🟢~] because it is not directly dependent on `fs
+    // TODO: [🖇] What about symlinks?
 
     /**
      * Constructs `PipelineCollection` from async sources
@@ -26415,17 +26356,18 @@
      * - Factory function that returns Promise of array of PipelineJson or PipelineString
      *
      * Note: This is useful as internal tool for other constructor functions like
-     *       `createPipelineCollectionFromUrl` or `createPipelineCollectionFromDirectory`
-     *       Consider using those functions instead of this one
+     * `createPipelineCollectionFromUrl` or `createPipelineCollectionFromDirectory`
+     * Consider using those functions instead of this one
      *
      * Note: The function does NOT return promise it returns the collection directly which waits for the sources to be resolved
-     *       when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
+     * when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
      *
      * Note: Consider using  `createPipelineCollectionFromDirectory` or `createPipelineCollectionFromUrl`
      *
      * @param promptbookSourcesPromiseOrFactory
      * @returns PipelineCollection
      * @deprecated Do not use, it will became internal tool for other constructor functions
+     *
      * @public exported from `@promptbook/core`
      */
     function createPipelineCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
@@ -26469,6 +26411,7 @@
      * @param tools - Execution tools to be used for pipeline preparation if needed - If not provided, `$provideExecutionToolsForNode` will be used
      * @param options - Options for the collection creation
      * @returns PipelineCollection
+     *
      * @public exported from `@promptbook/node`
      */
     async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
@@ -26652,10 +26595,8 @@
         }
         return collection;
     }
-    /**
-     * TODO: [🖇] What about symlinks? Maybe option `isSymlinksFollowed`
-     * TODO: Maybe move from `@promptbook/node` to `@promptbook/core` as we removes direct dependency on `fs`
-     */
+    // TODO: [🖇] What about symlinks? Maybe option `isSymlinksFollowed`
+    // TODO: Maybe move from `@promptbook/node` to `@promptbook/core` as we removes direct dependency on `fs`
 
     /**
      * Provides script execution tools
@@ -26669,10 +26610,8 @@
         // TODO: [🔱] Do here auto-installation
         return [new JavascriptExecutionTools({ ...options, functions: getAllCommitmentsToolFunctionsForNode() })];
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    // Note: [🟢] Code for Node scraper registration helper [$provideScriptingForNode](src/scrapers/_common/register/$provideScriptingForNode.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
 
     /**
      * Stringify the PipelineJson with proper formatting
@@ -26700,12 +26639,10 @@
         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
 
     /**
      * A storage implementation that caches data in files organized in a directory structure.
@@ -26795,10 +26732,8 @@
             //          [0] When `setItem` and `removeItem` called, the state of the file system should be the same
         }
     }
-    /**
-     * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node file-cache storage [FileCacheStorage](src/storage/file-cache-storage/FileCacheStorage.ts) should never be published into packages that could be imported into browser environment
+    // TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
 
     /**
      * Run multiple commands in a shell in sequence
@@ -26815,9 +26750,7 @@
             await $execCommand({ command, cwd, crashOnError });
         }
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    // Note: [🟢] Code for Node command-execution helper [$execCommands](src/utils/execCommand/$execCommands.ts) should never be published into packages that could be imported into browser environment
 
     /**
      * Keep-alive helpers used for streaming chat responses.
@@ -26829,9 +26762,7 @@
      * @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
 
     /**
      * Type guard to check if a string is a valid agent source
@@ -26861,6 +26792,7 @@
      * Default book
      *
      * @deprecated Use `$generateBookBoilerplate` instead
+     *
      * @public exported from `@promptbook/core`
      */
     padBook(validateBook(_spaceTrim.spaceTrim(`
@@ -26879,6 +26811,7 @@
      *
      * @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) {
@@ -26891,9 +26824,7 @@
             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
@@ -26906,6 +26837,7 @@
      * @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) {
@@ -26932,10 +26864,8 @@
         }
         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.
@@ -26980,9 +26910,7 @@
         { 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
@@ -27000,6 +26928,9 @@
         }, 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.
@@ -27030,6 +26961,9 @@
         }
         return `fallback:${toolCall.name}`;
     }
+    /**
+     * Gets arguments key.
+     */
     function getArgumentsKey(value) {
         if (typeof value === 'string') {
             return value;
@@ -27103,6 +27037,7 @@
      * @param existingToolCall - Previous snapshot.
      * @param incomingToolCall - New snapshot.
      * @returns One merged snapshot.
+     *
      * @private helper of `mergeToolCalls`
      */
     function mergeToolCallSnapshot(existingToolCall, incomingToolCall) {
@@ -27125,6 +27060,7 @@
      * @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) {
@@ -27138,6 +27074,7 @@
      *
      * @param toolCall - Tool call snapshot to inspect.
      * @returns Inferred lifecycle state or `undefined`.
+     *
      * @private helper of `mergeToolCalls`
      */
     function inferToolCallState(toolCall) {
@@ -27161,6 +27098,7 @@
      * @param existingValues - Previous list.
      * @param incomingValues - Incoming list.
      * @returns Deduplicated merged list or `undefined`.
+     *
      * @private helper of `mergeToolCalls`
      */
     function mergeUnknownLists(existingValues, incomingValues) {
@@ -27187,6 +27125,7 @@
      *
      * @param value - Value to serialize.
      * @returns String signature.
+     *
      * @private helper of `mergeToolCalls`
      */
     function serializeValueForMerge(value) {
@@ -27204,6 +27143,7 @@
      *
      * @param toolCalls - Mutable list to deduplicate in-place.
      * @returns The same array after removing redundant preparation entries.
+     *
      * @private helper of `mergeToolCalls`
      */
     function deduplicatePreparationToolCalls(toolCalls) {
@@ -27261,6 +27201,7 @@
      *
      * @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) {
@@ -27283,6 +27224,7 @@
      *
      * @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) {
@@ -27298,6 +27240,7 @@
      *
      * @param agentSource - Raw agent source.
      * @returns Parsed prelude with shared line metadata.
+     *
      * @private internal utility of book agent-source parsing
      */
     function parseAgentSourcePrelude(agentSource) {
@@ -27473,6 +27416,7 @@
      *
      * @param text - Text to extract parameters from
      * @returns Array of parsed parameters with unified representation
+     *
      * @public exported from `@promptbook/core`
      */
     function parseParameters(text) {
@@ -27901,9 +27845,7 @@
         const trimmed = _spaceTrim.spaceTrim(content);
         return normalizeDomainForMatching(trimmed) || trimmed.toLowerCase();
     }
-    /**
-     * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
-     */
+    // TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
 
     /**
      * Gets all tool titles provided by all commitments
@@ -27929,6 +27871,7 @@
      * Restricts an Updatable to a (2) BehaviorSubject variant
      *
      * @see Updatable
+     *
      * @private internal utility <- TODO: [🧠] Maybe export from `@promptbook/types`
      */
     function asUpdatableSubject(value) {
@@ -27953,9 +27896,7 @@
             return new rxjs.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
 
     /**
      * Creates an empty/basic agent model requirements object
@@ -27990,12 +27931,11 @@
             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
      *
@@ -28374,7 +28314,9 @@
         };
     }
     /**
-     * @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;
@@ -28395,6 +28337,9 @@
             _metadata: stripInlineKnowledgeMetadata(requirements._metadata),
         };
     }
+    /**
+     * Handles upload inline knowledge source with fallback.
+     */
     async function uploadInlineKnowledgeSourceWithFallback(inlineSource, uploader) {
         try {
             return await uploader(inlineSource);
@@ -28407,6 +28352,9 @@
             return inlineKnowledgeSourceToDataUrl(inlineSource);
         }
     }
+    /**
+     * Extracts inline knowledge sources.
+     */
     function extractInlineKnowledgeSources(metadata) {
         if (!metadata) {
             return [];
@@ -28414,6 +28362,9 @@
         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;
@@ -28464,6 +28415,7 @@
      * @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) {
@@ -28483,6 +28435,7 @@
      * @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) {
@@ -28618,6 +28571,7 @@
      *
      * @param {unknown} rawAttachments - The raw attachments to normalize.
      * @returns {Array<ChatAttachment>} The normalized attachments.
+     *
      * @public exported from `@promptbook/core`
      */
     function normalizeChatAttachments(rawAttachments) {
@@ -28662,6 +28616,7 @@
      *
      * @param {ReadonlyArray<ChatAttachment>} attachments - The attachments to format.
      * @returns {string} The formatted context.
+     *
      * @public exported from `@promptbook/core`
      */
     function formatChatAttachmentContext(attachments) {
@@ -28682,6 +28637,7 @@
      * @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 = {}) {
@@ -28778,6 +28734,7 @@
      * @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 = {}) {
@@ -28869,6 +28826,7 @@
      * @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 = {}) {
@@ -28934,6 +28892,7 @@
      *
      * @param {ReadonlyArray<ResolvedChatAttachmentContent>} resolvedContents - The resolved contents to format.
      * @returns {string} The formatted context.
+     *
      * @public exported from `@promptbook/core`
      */
     function formatChatAttachmentContentContext(resolvedContents) {
@@ -28974,6 +28933,7 @@
      * @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 = {}) {
@@ -29002,9 +28962,7 @@
     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
@@ -29017,9 +28975,7 @@
     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
@@ -29032,9 +28988,7 @@
     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`.
@@ -29047,9 +29001,7 @@
     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
@@ -29062,9 +29014,7 @@
     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
@@ -29083,11 +29033,11 @@
         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 = {
@@ -29135,9 +29085,7 @@
         }
         return promptbookifiedTextTokens.join('');
     }
-    /**
-     * TODO: [🧠][✌️] Make some Promptbook-native token system
-     */
+    // TODO: [🧠][✌️] Make some Promptbook-native token system
 
     /**
      * Make UncertainNumber
@@ -29193,6 +29141,7 @@
      *
      * @see https://platform.openai.com/docs/models/
      * @see https://openai.com/api/pricing/
+     *
      * @public exported from `@promptbook/openai`
      */
     const OPENAI_MODELS = exportJson({
@@ -29869,6 +29818,7 @@
      * @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
@@ -29911,15 +29861,14 @@
             },
         };
     }
-    /**
-     * 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) {
@@ -29941,6 +29890,7 @@
      * @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) {
@@ -29960,8 +29910,10 @@
     }
     /**
      * 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) {
@@ -31067,13 +31019,11 @@
             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
@@ -31141,9 +31091,21 @@
         }
     }
 
+    /**
+     * 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.
@@ -31910,6 +31872,9 @@
         }
     }
 
+    /**
+     * 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.
@@ -31953,6 +31918,9 @@
         }
         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.
@@ -32108,6 +32076,7 @@
      *
      * @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) {
@@ -32866,6 +32835,7 @@
      * - `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 {
@@ -33557,14 +33527,12 @@
      * @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.
@@ -34041,10 +34009,8 @@
      * 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.
@@ -34054,6 +34020,7 @@
      *
      * @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) {
@@ -34261,6 +34228,7 @@
      *
      * @param section Raw fragment from self-learning workflow.
      * @returns Trimmed fragment, or empty string when nothing remains.
+     *
      * @private function of Agent
      */
     function normalizeBookSection(section) {
@@ -34272,6 +34240,7 @@
      * @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) {
@@ -34286,6 +34255,7 @@
      *
      * @param responseFormat Prompt response format requirements
      * @returns True when JSON schema mode is active
+     *
      * @private function of Agent
      */
     function isJsonSchemaResponseFormat(responseFormat) {
@@ -34297,6 +34267,7 @@
      * @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) {
@@ -34322,6 +34293,7 @@
      *
      * @param content Text to parse as JSON
      * @returns Parsed JSON value or null when parsing fails
+     *
      * @private function of Agent
      */
     function tryParseJson(content) {
@@ -34337,6 +34309,7 @@
      *
      * @param options - Normalized sample parts.
      * @returns Book-language sample section ready to append into agent source.
+     *
      * @private function of Agent
      */
     function formatSelfLearningSample(options) {
@@ -34358,6 +34331,7 @@
      *
      * @param internalMessage Internal trace payload.
      * @returns Book-language INTERNAL MESSAGE block.
+     *
      * @private function of Agent
      */
     function formatInternalLearningMessage(internalMessage) {
@@ -34371,6 +34345,7 @@
      *
      * @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) {
@@ -34400,6 +34375,7 @@
      *
      * @param toolCall Tool call produced during execution.
      * @returns Sanitized and serializable tool-call payload.
+     *
      * @private function of Agent
      */
     function sanitizeToolCallForLearning(toolCall) {
@@ -34419,6 +34395,7 @@
      *
      * @param payload Internal payload to serialize.
      * @returns Pretty JSON string that can be embedded in BOOK.
+     *
      * @private function of Agent
      */
     function stringifyInternalLearningPayload(payload) {
@@ -34468,6 +34445,7 @@
      * Normalizes teacher commitments into trimmed, display-ready lines.
      *
      * @param commitments Raw teacher output
+     *
      * @private function of Agent
      */
     function getTeacherCommitmentLines(commitments) {
@@ -34480,6 +34458,7 @@
      * Summarizes teacher commitment lines into user-friendly counts for self-learning.
      *
      * @param lines Parsed teacher commitment lines
+     *
      * @private function of Agent
      */
     function summarizeTeacherCommitmentLines(lines) {
@@ -34512,6 +34491,7 @@
      * @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) {
@@ -34748,9 +34728,7 @@
             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.
@@ -35216,10 +35194,8 @@
             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,