@promptbook/core 0.89.0-11 → 0.89.0-14

package/esm/index.es.js

@@ -27,7 +27,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.89.0-11';
+const PROMPTBOOK_ENGINE_VERSION = '0.89.0-14';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -158,239 +158,6 @@ class ParseError extends Error {
  * TODO: Maybe split `ParseError` and `ApplyError`
  */
 
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @public exported from `@promptbook/utils`
- */
-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 `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`
- */
-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
- *
- * @param content raw html code
- * @returns formatted html code
- * @private withing the package because of HUGE size of prettier dependency
- */
-function prettifyMarkdown(content) {
-    try {
-        return format(content, {
-            parser: 'markdown',
-            plugins: [parserHtml],
-            // 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;
-    }
-}
-
-/**
- * Makes first letter of a string uppercase
- *
- * @public exported from `@promptbook/utils`
- */
-function capitalize(word) {
-    return word.substring(0, 1).toUpperCase() + word.substring(1);
-}
-
-/**
- * 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`
- */
-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(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
- */
-
 /**
  * Returns the same value that is passed as argument.
  * No side effects.
@@ -512,6 +279,7 @@ const VALUE_STRINGS = {
     infinity: '(infinity; ∞)',
     negativeInfinity: '(negative infinity; -∞)',
     unserializable: '(unserializable value)',
+    circular: '(circular JSON)',
 };
 /**
  * Small number limit
@@ -668,29 +436,378 @@ function SET_IS_VERBOSE(isVerbose) {
     DEFAULT_IS_VERBOSE = isVerbose;
 }
 /**
- * @@@
+ * @@@
+ *
+ * @public exported from `@promptbook/core`
+ */
+const DEFAULT_IS_AUTO_INSTALLED = false;
+/**
+ * Function name for generated function via `ptbk make` to get the pipeline collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+const DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME = `getPipelineCollection`;
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+const IS_PIPELINE_LOGIC_VALIDATED = just(
+/**/
+// Note: In normal situations, we check the pipeline logic:
+true);
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
+ */
+
+/**
+ * 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((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$1((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);
+    }
+}
+
+/**
+ * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
+ *
+ * @public exported from `@promptbook/core`
+ */
+class WrappedError extends Error {
+    constructor(whatWasThrown) {
+        const tag = `[🤮]`;
+        console.error(tag, whatWasThrown);
+        super(spaceTrim$1((block) => `
+                    ${ /* Fixing tests !!!  block(valueToString(whatWasThrown)) */block(`non-Error object was thrown`)}
+
+                    Note: Look for ${tag} in the console for more details
+                    !!! Note: \`WrappedError\` indicates that somewhere in the code non-Error object was thrown and it was wrapped
+
+                    Please report issue on ${ADMIN_EMAIL}
+
+                `));
+        this.name = 'WrappedError';
+        Object.setPrototypeOf(this, WrappedError.prototype);
+    }
+}
+
+/**
+ * !!!@@@
+ *
+ * @param whatWasThrown !!!@@@
+ * @returns !!!@@@
+ *
+ * @private within the repository
+ */
+function assertsError(whatWasThrown) {
+    // Case 1: !!!@@@
+    if (whatWasThrown instanceof WrappedError) {
+        const wrappedError = whatWasThrown;
+        throw wrappedError;
+    }
+    // Case 2: !!!@@@
+    if (whatWasThrown instanceof UnexpectedError) {
+        const unexpectedError = whatWasThrown;
+        throw unexpectedError;
+    }
+    // Case 3: !!!@@@
+    if (whatWasThrown instanceof Error) {
+        return;
+    }
+    // Case 4: !!!@@@
+    throw new WrappedError(whatWasThrown);
+}
+
+/**
+ * Function isValidJsonString will tell you if the string is valid JSON or not
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (error) {
+        assertsError(error);
+        if (error.message.includes('Unexpected token')) {
+            return false;
+        }
+        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`
+ */
+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
+ *
+ * @param content raw html code
+ * @returns formatted html code
+ * @private withing the package because of HUGE size of prettier dependency
+ */
+function prettifyMarkdown(content) {
+    try {
+        return format(content, {
+            parser: 'markdown',
+            plugins: [parserHtml],
+            // 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;
+    }
+}
+
+/**
+ * Makes first letter of a string uppercase
  *
- * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/utils`
  */
-const DEFAULT_IS_AUTO_INSTALLED = false;
+function capitalize(word) {
+    return word.substring(0, 1).toUpperCase() + word.substring(1);
+}
+
 /**
- * Function name for generated function via `ptbk make` to get the pipeline collection
+ * 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_GET_PIPELINE_COLLECTION_FUNCTION_NAME = `getPipelineCollection`;
+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(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
  */
 
 /**
@@ -735,74 +852,6 @@ function $deepFreeze(objectValue) {
  * 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((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$1((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
@@ -894,9 +943,7 @@ function checkSerializableAsJson(options) {
                 JSON.stringify(value); // <- TODO: [0]
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 throw new UnexpectedError(spaceTrim((block) => `
                             \`${name}\` is not serializable
 
@@ -2046,7 +2093,10 @@ const PROMPTBOOK_ERRORS = {
     PipelineExecutionError,
     PipelineLogicError,
     PipelineUrlError,
+    AuthenticationError,
+    PromptbookFetchError,
     UnexpectedError,
+    WrappedError,
     // TODO: [🪑]> VersionMismatchError,
 };
 /**
@@ -2063,8 +2113,6 @@ const COMMON_JAVASCRIPT_ERRORS = {
     TypeError,
     URIError,
     AggregateError,
-    AuthenticationError,
-    PromptbookFetchError,
     /*
   Note: Not widely supported
   > InternalError,
@@ -2198,6 +2246,7 @@ function createTask(options) {
                 partialResultSubject.next(executionResult);
             }
             catch (error) {
+                assertsError(error);
                 status = 'ERROR';
                 errors.push(error);
                 partialResultSubject.error(error);
@@ -2343,13 +2392,19 @@ function valueToString(value) {
             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;
     }
@@ -2521,9 +2576,7 @@ function extractVariablesFromJavascript(script) {
             }
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         throw new ParseError(spaceTrim$1((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
@@ -3012,14 +3065,15 @@ class MultipleLlmExecutionTools {
                 }
             }
             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(
@@ -3898,9 +3952,7 @@ async function executeAttempts(options) {
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -3970,9 +4022,7 @@ async function executeAttempts(options) {
                             break scripts;
                         }
                         catch (error) {
-                            if (!(error instanceof Error)) {
-                                throw error;
-                            }
+                            assertsError(error);
                             if (error instanceof UnexpectedError) {
                                 throw error;
                             }
@@ -4593,9 +4643,7 @@ async function executePipeline(options) {
         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 [🤹‍♂️]
@@ -5311,9 +5359,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         return await fetch(urlOrRequest, init);
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         let url;
         if (typeof urlOrRequest === 'string') {
             url = urlOrRequest;
@@ -5544,9 +5590,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
             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
         }
@@ -6344,6 +6388,8 @@ function parseNumber(value) {
  */
 
 /**
+import { WrappedError } from '../../errors/WrappedError';
+import { assertsError } from '../../errors/assertsError';
  * Parses the expect command
  *
  * @see `documentationUrl` for more details
@@ -6435,9 +6481,7 @@ const expectCommandParser = {
             };
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             throw new ParseError(spaceTrim((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
@@ -10531,9 +10575,7 @@ function isValidPipelineString(pipelineString) {
         return true;
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         return false;
     }
 }
@@ -10917,5 +10959,5 @@ class PrefixStorage {
     }
 }
 
-export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, AbstractFormatError, AuthenticationError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_TITLE, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LOGO_DARK_SRC, LOGO_LIGHT_SRC, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotFoundError, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, PLAYGROUND_APP_ID, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, UnexpectedError, ZERO_USAGE, ZERO_VALUE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, book, cacheLlmTools, collectionToJson, compilePipeline, countUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, parsePipeline, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, promptbookFetch, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline, validatePipelineString };
+export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, AbstractFormatError, AuthenticationError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_TITLE, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LOGO_DARK_SRC, LOGO_LIGHT_SRC, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotFoundError, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, PLAYGROUND_APP_ID, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, book, cacheLlmTools, collectionToJson, compilePipeline, countUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, parsePipeline, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, promptbookFetch, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map