@promptbook/markdown-utils 0.89.0-8 → 0.89.0

package/umd/index.umd.js

@@ -25,7 +25,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-8';
+    const PROMPTBOOK_ENGINE_VERSION = '0.89.0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -173,547 +173,666 @@
     }
 
     /**
-     * Function isValidJsonString will tell you if the string is valid JSON or not
+     * Returns the same value that is passed as argument.
+     * No side effects.
      *
-     * @public exported from `@promptbook/utils`
+     * Note: It can be usefull for:
+     *
+     * 1) Leveling indentation
+     * 2) Putting always-true or always-false conditions without getting eslint errors
+     *
+     * @param value any values
+     * @returns the same values
+     * @private within the repository
      */
-    function isValidJsonString(value /* <- [👨‍⚖️] */) {
-        try {
-            JSON.parse(value);
-            return true;
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            if (error.message.includes('Unexpected token')) {
-                return false;
-            }
-            return false;
+    function just(value) {
+        if (value === undefined) {
+            return undefined;
         }
+        return value;
     }
 
     /**
-     * Extracts  extracts exactly one valid JSON code block
+     * Warning message for the generated sections and files files
      *
-     * - When given string is a valid JSON as it is, it just returns it
-     * - When there is no JSON code block the function throws a `ParseError`
-     * - When there are multiple JSON code blocks the function throws a `ParseError`
+     * @private within the repository
+     */
+    const GENERATOR_WARNING = `⚠️ WARNING: This code has been generated so that any manual changes will be overwritten`;
+    /**
+     * Name for the Promptbook
      *
-     * Note: It is not important if marked as ```json BUT if it is VALID JSON
-     * Note: There are multiple simmilar function:
-     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
-     * - `extractJsonBlock` extracts exactly one valid JSON code block
-     * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
-     * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+     * TODO: [🗽] Unite branding and make single place for it
      *
-     * @public exported from `@promptbook/markdown-utils`
-     * @throws {ParseError} if there is no valid JSON block in the markdown
+     * @public exported from `@promptbook/core`
      */
-    function extractJsonBlock(markdown) {
-        if (isValidJsonString(markdown)) {
-            return markdown;
-        }
-        const codeBlocks = extractAllBlocksFromMarkdown(markdown);
-        const jsonBlocks = codeBlocks.filter(({ content }) => isValidJsonString(content));
-        if (jsonBlocks.length === 0) {
-            throw new Error('There is no valid JSON block in the markdown');
-        }
-        if (jsonBlocks.length > 1) {
-            throw new Error('There are multiple JSON code blocks in the markdown');
-        }
-        return jsonBlocks[0].content;
-    }
+    const NAME = `Promptbook`;
     /**
-     * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
-     * TODO: [🏢] Make this logic part of `JsonFormatDefinition` or `isValidJsonString`
+     * Email of the responsible person
+     *
+     * @public exported from `@promptbook/core`
      */
-
+    const ADMIN_EMAIL = 'pavol@ptbk.io';
     /**
-     * Just says that the variable is not used but should be kept
-     * No side effects.
+     * Name of the responsible person for the Promptbook on GitHub
      *
-     * Note: It can be usefull for:
+     * @public exported from `@promptbook/core`
+     */
+    const ADMIN_GITHUB_NAME = 'hejny';
+    //            <- TODO: [🐊] Pick the best claim
+    /**
+     * When the title is not provided, the default title is used
      *
-     * 1) Suppressing eager optimization of unused imports
-     * 2) Suppressing eslint errors of unused variables in the tests
-     * 3) Keeping the type of the variable for type testing
+     * @public exported from `@promptbook/core`
+     */
+    const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
+    /**
+     * Maximum file size limit
      *
-     * @param value any values
-     * @returns void
-     * @private within the repository
+     * @public exported from `@promptbook/core`
      */
-    function keepUnused(...valuesToKeep) {
-    }
-
-    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:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","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 `{availableModelNames}` List of available model names separated by comma (,)\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n\\`\\`\\`json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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`-> {modelRequirements}`\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"}];
-
+    const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
+    // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
     /**
-     * Checks if value is valid email
+     * The maximum number of iterations for a loops
+     *
+     * @private within the repository - too low-level in comparison with other `MAX_...`
+     */
+    const LOOP_LIMIT = 1000;
+    /**
+     * Strings to represent various values in the context of parameter values
      *
      * @public exported from `@promptbook/utils`
      */
-    function isValidEmail(email) {
-        if (typeof email !== 'string') {
-            return false;
-        }
-        if (email.split('\n').length > 1) {
-            return false;
-        }
-        return /^.+@.+\..+$/.test(email);
-    }
-
+    const VALUE_STRINGS = {
+        empty: '(nothing; empty string)',
+        null: '(no value; null)',
+        undefined: '(unknown value; undefined)',
+        nan: '(not a number; NaN)',
+        infinity: '(infinity; ∞)',
+        negativeInfinity: '(negative infinity; -∞)',
+        unserializable: '(unserializable value)',
+        circular: '(circular JSON)',
+    };
     /**
-     * Tests if given string is valid URL.
+     * Small number limit
      *
-     * Note: This does not check if the file exists only if the path is valid
      * @public exported from `@promptbook/utils`
      */
-    function isValidFilePath(filename) {
-        if (typeof filename !== 'string') {
-            return false;
-        }
-        if (filename.split('\n').length > 1) {
-            return false;
-        }
-        if (filename.split(' ').length >
-            5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
-            return false;
-        }
-        const filenameSlashes = filename.split('\\').join('/');
-        // Absolute Unix path: /hello.txt
-        if (/^(\/)/i.test(filenameSlashes)) {
-            // console.log(filename, 'Absolute Unix path: /hello.txt');
-            return true;
-        }
-        // Absolute Windows path: /hello.txt
-        if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
-            // console.log(filename, 'Absolute Windows path: /hello.txt');
-            return true;
-        }
-        // Relative path: ./hello.txt
-        if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
-            // console.log(filename, 'Relative path: ./hello.txt');
-            return true;
-        }
-        // Allow paths like foo/hello
-        if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
-            // console.log(filename, 'Allow paths like foo/hello');
-            return true;
-        }
-        // Allow paths like hello.book
-        if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-            // console.log(filename, 'Allow paths like hello.book');
-            return true;
-        }
-        return false;
-    }
+    const SMALL_NUMBER = 0.001;
     /**
-     * TODO: [🍏] Implement for MacOs
+     * Short time interval to prevent race conditions in milliseconds
+     *
+     * @private within the repository - too low-level in comparison with other `MAX_...`
      */
-
+    const IMMEDIATE_TIME = 10;
     /**
-     * Tests if given string is valid URL.
+     * The maximum length of the (generated) filename
      *
-     * Note: Dataurl are considered perfectly valid.
-     * Note: There are two simmilar functions:
-     * - `isValidUrl` which tests any URL
-     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     * @public exported from `@promptbook/core`
+     */
+    const MAX_FILENAME_LENGTH = 30;
+    /**
+     * Strategy for caching the intermediate results for knowledge sources
      *
-     * @public exported from `@promptbook/utils`
+     * @public exported from `@promptbook/core`
      */
-    function isValidUrl(url) {
-        if (typeof url !== 'string') {
-            return false;
-        }
-        try {
-            if (url.startsWith('blob:')) {
-                url = url.replace(/^blob:/, '');
-            }
-            const urlObject = new URL(url /* because fail is handled */);
-            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-                return false;
-            }
-            return true;
-        }
-        catch (error) {
-            return false;
-        }
-    }
-
+    const DEFAULT_INTERMEDIATE_FILES_STRATEGY = 'HIDE_AND_KEEP';
+    //                                                     <- TODO: [😡] Change to 'VISIBLE'
     /**
-     * Function `validatePipelineString` will validate the if the string is a valid pipeline string
-     * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+     * The maximum number of (LLM) tasks running in parallel
      *
-     * @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) {
-        if (isValidJsonString(pipelineString)) {
-            throw new ParseError('Expected a book, but got a JSON string');
-        }
-        else if (isValidUrl(pipelineString)) {
-            throw new ParseError(`Expected a book, but got just the URL "${pipelineString}"`);
-        }
-        else if (isValidFilePath(pipelineString)) {
-            throw new ParseError(`Expected a book, but got just the file path "${pipelineString}"`);
-        }
-        else if (isValidEmail(pipelineString)) {
-            throw new ParseError(`Expected a book, but got just the email "${pipelineString}"`);
-        }
-        // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
-        return pipelineString;
-    }
+    const DEFAULT_MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
     /**
-     * TODO: [🧠][🈴] Where is the best location for this file
+     * The maximum number of attempts to execute LLM task before giving up
+     *
+     * @public exported from `@promptbook/core`
      */
-
+    const DEFAULT_MAX_EXECUTION_ATTEMPTS = 10; // <- TODO: [🤹‍♂️]
+    // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+    // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
-     * Prettify the html code
+     * Where to store the temporary downloads
      *
-     * @param content raw html code
-     * @returns formatted html code
-     * @private withing the package because of HUGE size of prettier dependency
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
      */
-    function prettifyMarkdown(content) {
-        try {
-            return prettier.format(content, {
-                parser: 'markdown',
-                plugins: [parserHtml__default["default"]],
-                // TODO: DRY - make some import or auto-copy of .prettierrc
-                endOfLine: 'lf',
-                tabWidth: 4,
-                singleQuote: true,
-                trailingComma: 'all',
-                arrowParens: 'always',
-                printWidth: 120,
-                htmlWhitespaceSensitivity: 'ignore',
-                jsxBracketSameLine: false,
-                bracketSpacing: true,
-            });
-        }
-        catch (error) {
-            // TODO: [🟥] Detect browser / node and make it colorfull
-            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
-                error,
-                html: content,
-            });
-            return content;
-        }
-    }
-
+    const DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
     /**
-     * Converts promptbook in JSON format to string format
+     * Where to store the scrape cache
+     *
+     * Note: When the folder does not exist, it is created recursively
      *
-     * @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) {
-        const { title, pipelineUrl, bookVersion, description, parameters, tasks } = pipelineJson;
-        let pipelineString = `# ${title}`;
-        if (description) {
-            pipelineString += '\n\n';
-            pipelineString += description;
-        }
-        const commands = [];
-        if (pipelineUrl) {
-            commands.push(`PIPELINE URL ${pipelineUrl}`);
-        }
-        if (bookVersion !== `undefined`) {
-            commands.push(`BOOK VERSION ${bookVersion}`);
-        }
-        // TODO: [main] !!5 This increases size of the bundle and is probbably not necessary
-        pipelineString = prettifyMarkdown(pipelineString);
-        for (const parameter of parameters.filter(({ isInput }) => isInput)) {
-            commands.push(`INPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
-        }
-        for (const parameter of parameters.filter(({ isOutput }) => isOutput)) {
-            commands.push(`OUTPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
-        }
-        pipelineString += '\n\n';
-        pipelineString += commands.map((command) => `- ${command}`).join('\n');
-        for (const task of tasks) {
-            const { 
-            /* Note: Not using:> name, */
-            title, description, 
-            /* Note: dependentParameterNames, */
-            jokerParameterNames: jokers, taskType, content, postprocessingFunctionNames: postprocessing, expectations, format, resultingParameterName, } = task;
-            pipelineString += '\n\n';
-            pipelineString += `## ${title}`;
-            if (description) {
-                pipelineString += '\n\n';
-                pipelineString += description;
-            }
-            const commands = [];
-            let contentLanguage = 'text';
-            if (taskType === 'PROMPT_TASK') {
-                const { modelRequirements } = task;
-                const { modelName, modelVariant } = modelRequirements || {};
-                // Note: Do nothing, it is default
-                // commands.push(`PROMPT`);
-                if (modelVariant) {
-                    commands.push(`MODEL VARIANT ${capitalize(modelVariant)}`);
-                }
-                if (modelName) {
-                    commands.push(`MODEL NAME \`${modelName}\``);
-                }
-            }
-            else if (taskType === 'SIMPLE_TASK') {
-                commands.push(`SIMPLE TEMPLATE`);
-                // Note: Nothing special here
-            }
-            else if (taskType === 'SCRIPT_TASK') {
-                commands.push(`SCRIPT`);
-                if (task.contentLanguage) {
-                    contentLanguage = task.contentLanguage;
-                }
-                else {
-                    contentLanguage = '';
-                }
-            }
-            else if (taskType === 'DIALOG_TASK') {
-                commands.push(`DIALOG`);
-                // Note: Nothing special here
-            } // <- }else if([🅱]
-            if (jokers) {
-                for (const joker of jokers) {
-                    commands.push(`JOKER {${joker}}`);
-                }
-            } /* not else */
-            if (postprocessing) {
-                for (const postprocessingFunctionName of postprocessing) {
-                    commands.push(`POSTPROCESSING \`${postprocessingFunctionName}\``);
-                }
-            } /* not else */
-            if (expectations) {
-                for (const [unit, { min, max }] of Object.entries(expectations)) {
-                    if (min === max) {
-                        commands.push(`EXPECT EXACTLY ${min} ${capitalize(unit + (min > 1 ? 's' : ''))}`);
-                    }
-                    else {
-                        if (min !== undefined) {
-                            commands.push(`EXPECT MIN ${min} ${capitalize(unit + (min > 1 ? 's' : ''))}`);
-                        } /* not else */
-                        if (max !== undefined) {
-                            commands.push(`EXPECT MAX ${max} ${capitalize(unit + (max > 1 ? 's' : ''))}`);
-                        }
-                    }
-                }
-            } /* not else */
-            if (format) {
-                if (format === 'JSON') {
-                    // TODO: @deprecated remove
-                    commands.push(`FORMAT JSON`);
-                }
-            } /* not else */
-            pipelineString += '\n\n';
-            pipelineString += commands.map((command) => `- ${command}`).join('\n');
-            pipelineString += '\n\n';
-            pipelineString += '```' + contentLanguage;
-            pipelineString += '\n';
-            pipelineString += spaceTrim__default["default"](content);
-            //                   <- TODO: [main] !!3 Escape
-            //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
-            pipelineString += '\n';
-            pipelineString += '```';
-            pipelineString += '\n\n';
-            pipelineString += `\`-> {${resultingParameterName}}\``; // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
-        }
-        return validatePipelineString(pipelineString);
-    }
-    /**
-     * @private internal utility of `pipelineJsonToString`
-     */
-    function taskParameterJsonToString(taskParameterJson) {
-        const { name, description } = taskParameterJson;
-        let parameterString = `{${name}}`;
-        if (description) {
-            parameterString = `${parameterString} ${description}`;
-        }
-        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
-     */
-
+    const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
+    // <- TODO: [🧜‍♂️]
     /**
-     * Returns the same value that is passed as argument.
-     * No side effects.
-     *
-     * Note: It can be usefull for:
-     *
-     * 1) Leveling indentation
-     * 2) Putting always-true or always-false conditions without getting eslint errors
+     * @@@
      *
-     * @param value any values
-     * @returns the same values
-     * @private within the repository
+     * @public exported from `@promptbook/core`
      */
-    function just(value) {
-        if (value === undefined) {
-            return undefined;
-        }
-        return value;
-    }
-
+    const DEFAULT_CSV_SETTINGS = Object.freeze({
+        delimiter: ',',
+        quoteChar: '"',
+        newline: '\n',
+        skipEmptyLines: true,
+    });
     /**
-     * Warning message for the generated sections and files files
+     * @@@
      *
-     * @private within the repository
+     * @public exported from `@promptbook/core`
      */
-    const GENERATOR_WARNING = `⚠️ WARNING: This code has been generated so that any manual changes will be overwritten`;
+    let DEFAULT_IS_VERBOSE = false;
     /**
-     * Name for the Promptbook
-     *
-     * TODO: [🗽] Unite branding and make single place for it
+     * @@@
      *
      * @public exported from `@promptbook/core`
      */
-    const NAME = `Promptbook`;
+    const DEFAULT_IS_AUTO_INSTALLED = false;
     /**
-     * Email of the responsible person
+     * @@@
      *
-     * @public exported from `@promptbook/core`
+     * @private within the repository
      */
-    const ADMIN_EMAIL = 'pavol@ptbk.io';
+    const IS_PIPELINE_LOGIC_VALIDATED = just(
+    /**/
+    // Note: In normal situations, we check the pipeline logic:
+    true);
     /**
-     * Name of the responsible person for the Promptbook on GitHub
-     *
-     * @public exported from `@promptbook/core`
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
      */
-    const ADMIN_GITHUB_NAME = 'hejny';
+
     /**
-     * When the title is not provided, the default title is used
+     * Make error report URL for the given error
      *
-     * @public exported from `@promptbook/core`
+     * @private private within the repository
      */
-    const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
+    function getErrorReportUrl(error) {
+        const report = {
+            title: `🐜 Error report from ${NAME}`,
+            body: spaceTrim__default["default"]((block) => `
+
+
+            \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
+
+            \`\`\`
+            ${block(error.message || '(no error message)')}
+            \`\`\`
+
+
+            ## More info:
+
+            - **Promptbook engine version:** ${PROMPTBOOK_ENGINE_VERSION}
+            - **Book language version:** ${BOOK_LANGUAGE_VERSION}
+            - **Time:** ${new Date().toISOString()}
+
+            <details>
+            <summary>Stack trace:</summary>
+
+            ## Stack trace:
+
+            \`\`\`stacktrace
+            ${block(error.stack || '(empty)')}
+            \`\`\`
+            </details>
+
+        `),
+        };
+        const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);
+        reportUrl.searchParams.set('labels', 'bug');
+        reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
+        reportUrl.searchParams.set('title', report.title);
+        reportUrl.searchParams.set('body', report.body);
+        return reportUrl;
+    }
+
     /**
-     * Maximum file size limit
+     * This error type indicates that the error should not happen and its last check before crashing with some other error
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
-    // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
+    class UnexpectedError extends Error {
+        constructor(message) {
+            super(spaceTrim.spaceTrim((block) => `
+                    ${block(message)}
+
+                    Note: This error should not happen.
+                    It's probbably a bug in the pipeline collection
+
+                    Please report issue:
+                    ${block(getErrorReportUrl(new Error(message)).href)}
+
+                    Or contact us on ${ADMIN_EMAIL}
+
+                `));
+            this.name = 'UnexpectedError';
+            Object.setPrototypeOf(this, UnexpectedError.prototype);
+        }
+    }
+
     /**
-     * The maximum number of iterations for a loops
+     * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
      *
-     * @private within the repository - too low-level in comparison with other `MAX_...`
+     * @public exported from `@promptbook/core`
      */
-    const LOOP_LIMIT = 1000;
+    class WrappedError extends Error {
+        constructor(whatWasThrown) {
+            const tag = `[🤮]`;
+            console.error(tag, whatWasThrown);
+            super(spaceTrim.spaceTrim(`
+                Non-Error object was thrown
+
+                Note: Look for ${tag} in the console for more details
+                Please report issue on ${ADMIN_EMAIL}
+            `));
+            this.name = 'WrappedError';
+            Object.setPrototypeOf(this, WrappedError.prototype);
+        }
+    }
+
     /**
-     * Strings to represent various values in the context of parameter values
+     * Helper used in catch blocks to assert that the error is an instance of `Error`
      *
-     * @public exported from `@promptbook/utils`
+     * @param whatWasThrown Any object that was thrown
+     * @returns Nothing if the error is an instance of `Error`
+     * @throws `WrappedError` or `UnexpectedError` if the error is not standard
+     *
+     * @private within the repository
      */
-    const VALUE_STRINGS = {
-        empty: '(nothing; empty string)',
-        null: '(no value; null)',
-        undefined: '(unknown value; undefined)',
-        nan: '(not a number; NaN)',
-        infinity: '(infinity; ∞)',
-        negativeInfinity: '(negative infinity; -∞)',
-        unserializable: '(unserializable value)',
-    };
+    function assertsError(whatWasThrown) {
+        // Case 1: Handle error which was rethrown as `WrappedError`
+        if (whatWasThrown instanceof WrappedError) {
+            const wrappedError = whatWasThrown;
+            throw wrappedError;
+        }
+        // Case 2: Handle unexpected errors
+        if (whatWasThrown instanceof UnexpectedError) {
+            const unexpectedError = whatWasThrown;
+            throw unexpectedError;
+        }
+        // Case 3: Handle standard errors - keep them up to consumer
+        if (whatWasThrown instanceof Error) {
+            return;
+        }
+        // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw
+        throw new WrappedError(whatWasThrown);
+    }
+
     /**
-     * Small number limit
+     * Function isValidJsonString will tell you if the string is valid JSON or not
+     *
+     * @param value The string to check
+     * @returns True if the string is a valid JSON string, false otherwise
      *
      * @public exported from `@promptbook/utils`
      */
-    const SMALL_NUMBER = 0.001;
+    function isValidJsonString(value /* <- [👨‍⚖️] */) {
+        try {
+            JSON.parse(value);
+            return true;
+        }
+        catch (error) {
+            assertsError(error);
+            if (error.message.includes('Unexpected token')) {
+                return false;
+            }
+            return false;
+        }
+    }
+
     /**
-     * Short time interval to prevent race conditions in milliseconds
+     * Extracts  extracts exactly one valid JSON code block
      *
-     * @private within the repository - too low-level in comparison with other `MAX_...`
+     * - When given string is a valid JSON as it is, it just returns it
+     * - When there is no JSON code block the function throws a `ParseError`
+     * - When there are multiple JSON code blocks the function throws a `ParseError`
+     *
+     * Note: It is not important if marked as ```json BUT if it is VALID JSON
+     * Note: There are multiple simmilar function:
+     * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+     * - `extractJsonBlock` extracts exactly one valid JSON code block
+     * - `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
      */
-    const IMMEDIATE_TIME = 10;
+    function extractJsonBlock(markdown) {
+        if (isValidJsonString(markdown)) {
+            return markdown;
+        }
+        const codeBlocks = extractAllBlocksFromMarkdown(markdown);
+        const jsonBlocks = codeBlocks.filter(({ content }) => isValidJsonString(content));
+        if (jsonBlocks.length === 0) {
+            throw new Error('There is no valid JSON block in the markdown');
+        }
+        if (jsonBlocks.length > 1) {
+            throw new Error('There are multiple JSON code blocks in the markdown');
+        }
+        return jsonBlocks[0].content;
+    }
     /**
-     * The maximum length of the (generated) filename
-     *
-     * @public exported from `@promptbook/core`
+     * TODO: Add some auto-healing logic + extract YAML, JSON5, TOML, etc.
+     * TODO: [🏢] Make this logic part of `JsonFormatDefinition` or `isValidJsonString`
      */
-    const MAX_FILENAME_LENGTH = 30;
+
     /**
-     * Strategy for caching the intermediate results for knowledge sources
+     * Just says that the variable is not used but should be kept
+     * No side effects.
      *
-     * @public exported from `@promptbook/core`
+     * Note: It can be usefull for:
+     *
+     * 1) Suppressing eager optimization of unused imports
+     * 2) Suppressing eslint errors of unused variables in the tests
+     * 3) Keeping the type of the variable for type testing
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
      */
-    const DEFAULT_INTERMEDIATE_FILES_STRATEGY = 'HIDE_AND_KEEP';
-    //                                                     <- TODO: [😡] Change to 'VISIBLE'
+    function keepUnused(...valuesToKeep) {
+    }
+
+    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:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","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 `{availableModelNames}` List of available model names separated by comma (,)\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n\\`\\`\\`json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the 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\nPick from the following models:\n\n-   {availableModelNames}\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`-> {modelRequirements}`\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"}];
+
     /**
-     * The maximum number of (LLM) tasks running in parallel
+     * Checks if value is valid email
      *
-     * @public exported from `@promptbook/core`
+     * @public exported from `@promptbook/utils`
      */
-    const DEFAULT_MAX_PARALLEL_COUNT = 5; // <- TODO: [🤹‍♂️]
+    function isValidEmail(email) {
+        if (typeof email !== 'string') {
+            return false;
+        }
+        if (email.split('\n').length > 1) {
+            return false;
+        }
+        return /^.+@.+\..+$/.test(email);
+    }
+
     /**
-     * The maximum number of attempts to execute LLM task before giving up
+     * Tests if given string is valid URL.
      *
-     * @public exported from `@promptbook/core`
+     * Note: This does not check if the file exists only if the path is valid
+     * @public exported from `@promptbook/utils`
      */
-    const DEFAULT_MAX_EXECUTION_ATTEMPTS = 10; // <- TODO: [🤹‍♂️]
-    // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
-    // TODO: !!!!!! Just .promptbook dir, hardocode others
+    function isValidFilePath(filename) {
+        if (typeof filename !== 'string') {
+            return false;
+        }
+        if (filename.split('\n').length > 1) {
+            return false;
+        }
+        if (filename.split(' ').length >
+            5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
+            return false;
+        }
+        const filenameSlashes = filename.split('\\').join('/');
+        // Absolute Unix path: /hello.txt
+        if (/^(\/)/i.test(filenameSlashes)) {
+            // console.log(filename, 'Absolute Unix path: /hello.txt');
+            return true;
+        }
+        // Absolute Windows path: /hello.txt
+        if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
+            // console.log(filename, 'Absolute Windows path: /hello.txt');
+            return true;
+        }
+        // Relative path: ./hello.txt
+        if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
+            // console.log(filename, 'Relative path: ./hello.txt');
+            return true;
+        }
+        // Allow paths like foo/hello
+        if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
+            // console.log(filename, 'Allow paths like foo/hello');
+            return true;
+        }
+        // Allow paths like hello.book
+        if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
+            // console.log(filename, 'Allow paths like hello.book');
+            return true;
+        }
+        return false;
+    }
     /**
-     * Where to store the temporary downloads
-     *
-     * Note: When the folder does not exist, it is created recursively
-     *
-     * @public exported from `@promptbook/core`
+     * TODO: [🍏] Implement for MacOs
      */
-    const DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
+
     /**
-     * Where to store the scrape cache
+     * Tests if given string is valid URL.
      *
-     * Note: When the folder does not exist, it is created recursively
+     * Note: Dataurl are considered perfectly valid.
+     * Note: There are two simmilar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
      *
-     * @public exported from `@promptbook/core`
+     * @public exported from `@promptbook/utils`
      */
-    const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
-    // <- TODO: [🧜‍♂️]
+    function isValidUrl(url) {
+        if (typeof url !== 'string') {
+            return false;
+        }
+        try {
+            if (url.startsWith('blob:')) {
+                url = url.replace(/^blob:/, '');
+            }
+            const urlObject = new URL(url /* because fail is handled */);
+            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+
     /**
-     * @@@
+     * Function `validatePipelineString` will validate the if the string is a valid pipeline string
+     * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
      *
+     * @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`
      */
-    const DEFAULT_CSV_SETTINGS = Object.freeze({
-        delimiter: ',',
-        quoteChar: '"',
-        newline: '\n',
-        skipEmptyLines: true,
-    });
+    function validatePipelineString(pipelineString) {
+        if (isValidJsonString(pipelineString)) {
+            throw new ParseError('Expected a book, but got a JSON string');
+        }
+        else if (isValidUrl(pipelineString)) {
+            throw new ParseError(`Expected a book, but got just the URL "${pipelineString}"`);
+        }
+        else if (isValidFilePath(pipelineString)) {
+            throw new ParseError(`Expected a book, but got just the file path "${pipelineString}"`);
+        }
+        else if (isValidEmail(pipelineString)) {
+            throw new ParseError(`Expected a book, but got just the email "${pipelineString}"`);
+        }
+        // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
+        return pipelineString;
+    }
     /**
-     * @@@
+     * TODO: [🧠][🈴] Where is the best location for this file
+     */
+
+    /**
+     * Prettify the html code
      *
-     * @public exported from `@promptbook/core`
+     * @param content raw html code
+     * @returns formatted html code
+     * @private withing the package because of HUGE size of prettier dependency
      */
-    let DEFAULT_IS_VERBOSE = false;
+    function prettifyMarkdown(content) {
+        try {
+            return prettier.format(content, {
+                parser: 'markdown',
+                plugins: [parserHtml__default["default"]],
+                // TODO: DRY - make some import or auto-copy of .prettierrc
+                endOfLine: 'lf',
+                tabWidth: 4,
+                singleQuote: true,
+                trailingComma: 'all',
+                arrowParens: 'always',
+                printWidth: 120,
+                htmlWhitespaceSensitivity: 'ignore',
+                jsxBracketSameLine: false,
+                bracketSpacing: true,
+            });
+        }
+        catch (error) {
+            // TODO: [🟥] Detect browser / node and make it colorfull
+            console.error('There was an error with prettifying the markdown, using the original as the fallback', {
+                error,
+                html: content,
+            });
+            return content;
+        }
+    }
+
     /**
-     * @@@
+     * Converts promptbook in JSON format to string format
      *
+     * @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`
      */
-    const DEFAULT_IS_AUTO_INSTALLED = false;
+    function pipelineJsonToString(pipelineJson) {
+        const { title, pipelineUrl, bookVersion, description, parameters, tasks } = pipelineJson;
+        let pipelineString = `# ${title}`;
+        if (description) {
+            pipelineString += '\n\n';
+            pipelineString += description;
+        }
+        const commands = [];
+        if (pipelineUrl) {
+            commands.push(`PIPELINE URL ${pipelineUrl}`);
+        }
+        if (bookVersion !== `undefined`) {
+            commands.push(`BOOK VERSION ${bookVersion}`);
+        }
+        // TODO: [main] !!5 This increases size of the bundle and is probbably not necessary
+        pipelineString = prettifyMarkdown(pipelineString);
+        for (const parameter of parameters.filter(({ isInput }) => isInput)) {
+            commands.push(`INPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
+        }
+        for (const parameter of parameters.filter(({ isOutput }) => isOutput)) {
+            commands.push(`OUTPUT PARAMETER ${taskParameterJsonToString(parameter)}`);
+        }
+        pipelineString += '\n\n';
+        pipelineString += commands.map((command) => `- ${command}`).join('\n');
+        for (const task of tasks) {
+            const { 
+            /* Note: Not using:> name, */
+            title, description, 
+            /* Note: dependentParameterNames, */
+            jokerParameterNames: jokers, taskType, content, postprocessingFunctionNames: postprocessing, expectations, format, resultingParameterName, } = task;
+            pipelineString += '\n\n';
+            pipelineString += `## ${title}`;
+            if (description) {
+                pipelineString += '\n\n';
+                pipelineString += description;
+            }
+            const commands = [];
+            let contentLanguage = 'text';
+            if (taskType === 'PROMPT_TASK') {
+                const { modelRequirements } = task;
+                const { modelName, modelVariant } = modelRequirements || {};
+                // Note: Do nothing, it is default
+                // commands.push(`PROMPT`);
+                if (modelVariant) {
+                    commands.push(`MODEL VARIANT ${capitalize(modelVariant)}`);
+                }
+                if (modelName) {
+                    commands.push(`MODEL NAME \`${modelName}\``);
+                }
+            }
+            else if (taskType === 'SIMPLE_TASK') {
+                commands.push(`SIMPLE TEMPLATE`);
+                // Note: Nothing special here
+            }
+            else if (taskType === 'SCRIPT_TASK') {
+                commands.push(`SCRIPT`);
+                if (task.contentLanguage) {
+                    contentLanguage = task.contentLanguage;
+                }
+                else {
+                    contentLanguage = '';
+                }
+            }
+            else if (taskType === 'DIALOG_TASK') {
+                commands.push(`DIALOG`);
+                // Note: Nothing special here
+            } // <- }else if([🅱]
+            if (jokers) {
+                for (const joker of jokers) {
+                    commands.push(`JOKER {${joker}}`);
+                }
+            } /* not else */
+            if (postprocessing) {
+                for (const postprocessingFunctionName of postprocessing) {
+                    commands.push(`POSTPROCESSING \`${postprocessingFunctionName}\``);
+                }
+            } /* not else */
+            if (expectations) {
+                for (const [unit, { min, max }] of Object.entries(expectations)) {
+                    if (min === max) {
+                        commands.push(`EXPECT EXACTLY ${min} ${capitalize(unit + (min > 1 ? 's' : ''))}`);
+                    }
+                    else {
+                        if (min !== undefined) {
+                            commands.push(`EXPECT MIN ${min} ${capitalize(unit + (min > 1 ? 's' : ''))}`);
+                        } /* not else */
+                        if (max !== undefined) {
+                            commands.push(`EXPECT MAX ${max} ${capitalize(unit + (max > 1 ? 's' : ''))}`);
+                        }
+                    }
+                }
+            } /* not else */
+            if (format) {
+                if (format === 'JSON') {
+                    // TODO: @deprecated remove
+                    commands.push(`FORMAT JSON`);
+                }
+            } /* not else */
+            pipelineString += '\n\n';
+            pipelineString += commands.map((command) => `- ${command}`).join('\n');
+            pipelineString += '\n\n';
+            pipelineString += '```' + contentLanguage;
+            pipelineString += '\n';
+            pipelineString += spaceTrim__default["default"](content);
+            //                   <- TODO: [main] !!3 Escape
+            //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
+            pipelineString += '\n';
+            pipelineString += '```';
+            pipelineString += '\n\n';
+            pipelineString += `\`-> {${resultingParameterName}}\``; // <- TODO: [main] !!3 If the parameter here has description, add it and use taskParameterJsonToString
+        }
+        return validatePipelineString(pipelineString);
+    }
     /**
-     * @@@
-     *
-     * @private within the repository
+     * @private internal utility of `pipelineJsonToString`
      */
-    const IS_PIPELINE_LOGIC_VALIDATED = just(
-    /**/
-    // Note: In normal situations, we check the pipeline logic:
-    true);
+    function taskParameterJsonToString(taskParameterJson) {
+        const { name, description } = taskParameterJson;
+        let parameterString = `{${name}}`;
+        if (description) {
+            parameterString = `${parameterString} ${description}`;
+        }
+        return parameterString;
+    }
     /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
+     * 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
      */
 
     /**
@@ -758,74 +877,6 @@
      * TODO: [🧠] Is there a way how to meaningfully test this utility
      */
 
-    /**
-     * Make error report URL for the given error
-     *
-     * @private private within the repository
-     */
-    function getErrorReportUrl(error) {
-        const report = {
-            title: `🐜 Error report from ${NAME}`,
-            body: spaceTrim__default["default"]((block) => `
-
-
-            \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
-
-            \`\`\`
-            ${block(error.message || '(no error message)')}
-            \`\`\`
-
-
-            ## More info:
-
-            - **Promptbook engine version:** ${PROMPTBOOK_ENGINE_VERSION}
-            - **Book language version:** ${BOOK_LANGUAGE_VERSION}
-            - **Time:** ${new Date().toISOString()}
-
-            <details>
-            <summary>Stack trace:</summary>
-
-            ## Stack trace:
-
-            \`\`\`stacktrace
-            ${block(error.stack || '(empty)')}
-            \`\`\`
-            </details>
-
-        `),
-        };
-        const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);
-        reportUrl.searchParams.set('labels', 'bug');
-        reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
-        reportUrl.searchParams.set('title', report.title);
-        reportUrl.searchParams.set('body', report.body);
-        return reportUrl;
-    }
-
-    /**
-     * This error type indicates that the error should not happen and its last check before crashing with some other error
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class UnexpectedError extends Error {
-        constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
-                    ${block(message)}
-
-                    Note: This error should not happen.
-                    It's probbably a bug in the pipeline collection
-
-                    Please report issue:
-                    ${block(getErrorReportUrl(new Error(message)).href)}
-
-                    Or contact us on ${ADMIN_EMAIL}
-
-                `));
-            this.name = 'UnexpectedError';
-            Object.setPrototypeOf(this, UnexpectedError.prototype);
-        }
-    }
-
     /**
      * Checks if the value is [🚉] serializable as JSON
      * If not, throws an UnexpectedError with a rich error message and tracking
@@ -917,9 +968,7 @@
                     JSON.stringify(value); // <- TODO: [0]
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     throw new UnexpectedError(spaceTrim__default["default"]((block) => `
                             \`${name}\` is not serializable
 
@@ -1708,7 +1757,7 @@
         }
     }
     /**
-     * TODO: !!!!!! Add id to all errors
+     * TODO: [🧠][🌂] Add id to all errors
      */
 
     /**
@@ -1912,6 +1961,19 @@
         }
     }
 
+    /**
+     * Error thrown when a fetch request fails
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class PromptbookFetchError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'PromptbookFetchError';
+            Object.setPrototypeOf(this, PromptbookFetchError.prototype);
+        }
+    }
+
     /**
      * Index of all custom errors
      *
@@ -1932,7 +1994,10 @@
         PipelineExecutionError,
         PipelineLogicError,
         PipelineUrlError,
+        AuthenticationError,
+        PromptbookFetchError,
         UnexpectedError,
+        WrappedError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -1949,7 +2014,6 @@
         TypeError,
         URIError,
         AggregateError,
-        AuthenticationError,
         /*
       Note: Not widely supported
       > InternalError,
@@ -2072,8 +2136,8 @@
                     updatedAt = new Date();
                     errors.push(...executionResult.errors);
                     warnings.push(...executionResult.warnings);
-                    // <- TODO: !!! Only unique errors and warnings should be added (or filtered)
-                    // TODO: [🧠] !!! errors, warning, isSuccessful  are redundant both in `ExecutionTask` and `ExecutionTask.currentValue`
+                    // <- TODO: [🌂] Only unique errors and warnings should be added (or filtered)
+                    // TODO: [🧠] !! errors, warning, isSuccessful  are redundant both in `ExecutionTask` and `ExecutionTask.currentValue`
                     //            Also maybe move `ExecutionTask.currentValue.usage` -> `ExecutionTask.usage`
                     //            And delete `ExecutionTask.currentValue.preparedPipeline`
                     assertsTaskSuccessful(executionResult);
@@ -2083,6 +2147,7 @@
                     partialResultSubject.next(executionResult);
                 }
                 catch (error) {
+                    assertsError(error);
                     status = 'ERROR';
                     errors.push(error);
                     partialResultSubject.error(error);
@@ -2474,14 +2539,15 @@
                     }
                 }
                 catch (error) {
-                    if (!(error instanceof Error) || error instanceof UnexpectedError) {
+                    assertsError(error);
+                    if (error instanceof UnexpectedError) {
                         throw error;
                     }
                     errors.push({ llmExecutionTools, error });
                 }
             }
             if (errors.length === 1) {
-                throw errors[0];
+                throw errors[0].error;
             }
             else if (errors.length > 1) {
                 throw new PipelineExecutionError(
@@ -3315,17 +3381,22 @@
     /**
      * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
      *
-     * @private as default `fetch` function used in Promptbook scrapers
+     * @public exported from `@promptbook/core`
      */
-    const scraperFetch = async (url, init) => {
+    const promptbookFetch = async (urlOrRequest, init) => {
         try {
-            return await fetch(url, init);
+            return await fetch(urlOrRequest, init);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
+            assertsError(error);
+            let url;
+            if (typeof urlOrRequest === 'string') {
+                url = urlOrRequest;
+            }
+            else if (urlOrRequest instanceof Request) {
+                url = urlOrRequest.url;
             }
-            throw new KnowledgeScrapeError(spaceTrim__default["default"]((block) => `
+            throw new PromptbookFetchError(spaceTrim__default["default"]((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -3346,7 +3417,7 @@
     async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         // console.log('!! makeKnowledgeSourceHandler', knowledgeSource);
         var _a;
-        const { fetch = scraperFetch } = tools;
+        const { fetch = promptbookFetch } = tools;
         const { knowledgeSourceContent } = knowledgeSource;
         let { name } = knowledgeSource;
         const { rootDirname = null, 
@@ -3548,9 +3619,7 @@
                 knowledgePreparedUnflatten[index] = pieces;
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 console.warn(error);
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
@@ -3842,13 +3911,19 @@
                 return value.toISOString();
             }
             else {
-                return JSON.stringify(value);
+                try {
+                    return JSON.stringify(value);
+                }
+                catch (error) {
+                    if (error instanceof TypeError && error.message.includes('circular structure')) {
+                        return VALUE_STRINGS.circular;
+                    }
+                    throw error;
+                }
             }
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             console.error(error);
             return VALUE_STRINGS.unserializable;
         }
@@ -3905,9 +3980,7 @@
                 }
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             throw new ParseError(spaceTrim.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
@@ -4026,6 +4099,28 @@
         // encoding: 'utf-8',
     });
 
+    /**
+     * Function to check if a string is valid CSV
+     *
+     * @param value The string to check
+     * @returns True if the string is a valid CSV string, false otherwise
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidCsvString(value) {
+        try {
+            // A simple check for CSV format: at least one comma and no invalid characters
+            if (value.includes(',') && /^[\w\s,"']+$/.test(value)) {
+                return true;
+            }
+            return false;
+        }
+        catch (error) {
+            assertsError(error);
+            return false;
+        }
+    }
+
     /**
      * Definition for CSV spreadsheet
      *
@@ -4036,7 +4131,7 @@
         formatName: 'CSV',
         aliases: ['SPREADSHEET', 'TABLE'],
         isValid(value, settings, schema) {
-            return true;
+            return isValidCsvString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -4190,6 +4285,30 @@
      * TODO: [🏢] Allow to expect something inside each item of list and other formats
      */
 
+    /**
+     * Function to check if a string is valid XML
+     *
+     * @param value
+     * @returns True if the string is a valid XML string, false otherwise
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidXmlString(value) {
+        try {
+            const parser = new DOMParser();
+            const parsedDocument = parser.parseFromString(value, 'application/xml');
+            const parserError = parsedDocument.getElementsByTagName('parsererror');
+            if (parserError.length > 0) {
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            assertsError(error);
+            return false;
+        }
+    }
+
     /**
      * Definition for XML format
      *
@@ -4199,7 +4318,7 @@
         formatName: 'XML',
         mimeType: 'application/xml',
         isValid(value, settings, schema) {
-            return true;
+            return isValidXmlString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -4670,9 +4789,7 @@
                                     break scripts;
                                 }
                                 catch (error) {
-                                    if (!(error instanceof Error)) {
-                                        throw error;
-                                    }
+                                    assertsError(error);
                                     if (error instanceof UnexpectedError) {
                                         throw error;
                                     }
@@ -4742,9 +4859,7 @@
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -5365,9 +5480,7 @@
             await Promise.all(resolving);
         }
         catch (error /* <- Note: [3] */) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             // Note: No need to rethrow UnexpectedError
             // if (error instanceof UnexpectedError) {
             // Note: Count usage, [🧠] Maybe put to separate function executionReportJsonToUsage + DRY [🤹‍♂️]