@promptbook/core 0.89.0-3 → 0.89.0-30

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-3';
+    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-30';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -159,236 +159,34 @@
      */
 
     /**
-     * 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.
+     * Available remote servers for the Promptbook
      *
-     * @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 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;
-        }
-    }
-
-    /**
-     * 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__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;
-    }
+    const REMOTE_SERVER_URLS = [
+        {
+            title: 'Promptbook',
+            description: `Servers of Promptbook.studio`,
+            owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+            isAnonymousModeAllowed: true,
+            urls: [
+                'https://promptbook.s5.ptbk.io/',
+                // Note: Servers 1-4 are not running
+            ],
+        },
+        /*
+        Note: Working on older version of Promptbook and not supported anymore
+        {
+            title: 'Pavol Promptbook Server',
+            description: `Personal server of Pavol Hejný with simple testing server, DO NOT USE IT FOR PRODUCTION`,
+            owner: 'Pavol Hejný <pavol@ptbk.io> (https://www.pavolhejny.com/)',
+            isAnonymousModeAllowed: true,
+            urls: ['https://api.pavolhejny.com/promptbook'],
+        },
+        */
+    ];
     /**
-     * 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
+     * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
     /**
@@ -446,22 +244,6 @@
      */
     const CLAIM = `It's time for a paradigm shift. The future of software in plain English, French or Latin`;
     //            <- TODO: [🐊] Pick the best claim
-    /**
-     * Logo for the light theme
-     *
-     * TODO: [🗽] Unite branding and make single place for it
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const LOGO_LIGHT_SRC = `https://promptbook.studio/_next/static/media/promptbook-logo.b21f0c70.png`; // <- TODO: !!! Auto-update or remove
-    /**
-     * Logo for the dark theme
-     *
-     * TODO: [🗽] Unite branding and make single place for it
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const LOGO_DARK_SRC = `https://promptbook.studio/_next/static/media/promptbook-logo-white.09887cbc.png`; // <- TODO: !!! Auto-update or remove
     /**
      * When the title is not provided, the default title is used
      *
@@ -512,6 +294,7 @@
         infinity: '(infinity; ∞)',
         negativeInfinity: '(negative infinity; -∞)',
         unserializable: '(unserializable value)',
+        circular: '(circular JSON)',
     };
     /**
      * Small number limit
@@ -572,6 +355,7 @@
      */
     const DEFAULT_BOOKS_DIRNAME = './books';
     // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+    // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
      * Where to store the temporary downloads
      *
@@ -596,6 +380,27 @@
      * @public exported from `@promptbook/core`
      */
     const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
+    /**
+     * Id of application for the CLI when using remote server
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const CLI_APP_ID = 'cli';
+    /**
+     * Id of application for the playground
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const PLAYGROUND_APP_ID = 'playground';
+    /*
+    TODO: [🌃]
+    /**
+     * Id of application for the wizzard when using remote server
+     *
+     * @public exported from `@promptbook/core`
+     * /
+    ex-port const WIZZARD_APP_ID: string_app_id = 'wizzard';
+    */
     /**
      * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
      *
@@ -612,17 +417,11 @@
         ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
     };
     /**
-     * @@@
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const DEFAULT_REMOTE_URL = 'https://api.pavolhejny.com/';
-    /**
-     * @@@
+     * Default remote server URL for the Promptbook
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_REMOTE_URL_PATH = '/promptbook/socket.io';
+    const DEFAULT_REMOTE_SERVER_URL = REMOTE_SERVER_URLS[0].urls[0];
     // <- TODO: [🧜‍♂️]
     /**
      * @@@
@@ -652,29 +451,376 @@
         exports.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
+     * @@@
+     *
+     * @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__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);
+        }
+    }
+
+    /**
+     * 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.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);
+        }
+    }
+
+    /**
+     * Helper used in catch blocks to assert that the error is an instance of `Error`
+     *
+     * @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
+     */
+    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);
+    }
+
+    /**
+     * 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 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;
+        }
+    }
+
+    /**
+     * 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__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`
      */
-    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 remoteUrl 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
      */
 
     /**
@@ -719,74 +865,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
@@ -878,9 +956,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
 
@@ -1860,7 +1936,7 @@
         }
     }
     /**
-     * TODO: !!!!!! Add id to all errors
+     * TODO: [🧠][🌂] Add id to all errors
      */
 
     /**
@@ -1893,6 +1969,19 @@
         }
     }
 
+    /**
+     * AuthenticationError is thrown from login function which is dependency of remote server
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class AuthenticationError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'AuthenticationError';
+            Object.setPrototypeOf(this, AuthenticationError.prototype);
+        }
+    }
+
     /**
      * This error indicates that the pipeline collection cannot be propperly loaded
      *
@@ -1984,6 +2073,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
      *
@@ -2004,7 +2106,10 @@
         PipelineExecutionError,
         PipelineLogicError,
         PipelineUrlError,
+        AuthenticationError,
+        PromptbookFetchError,
         UnexpectedError,
+        WrappedError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -2143,8 +2248,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);
@@ -2154,6 +2259,7 @@
                     partialResultSubject.next(executionResult);
                 }
                 catch (error) {
+                    assertsError(error);
                     status = 'ERROR';
                     errors.push(error);
                     partialResultSubject.error(error);
@@ -2220,6 +2326,10 @@
 
                     Cannot serialize error with name "${name}"
 
+                    Authors of Promptbook probably forgot to add this error into the list of errors:
+                    https://github.com/webgptorg/promptbook/blob/main/src/errors/0-index.ts
+
+
                     ${block(stack || message)}
 
                 `));
@@ -2295,13 +2405,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;
         }
@@ -2473,9 +2589,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)}
@@ -2964,14 +3078,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(
@@ -3850,9 +3965,7 @@
                                     break scripts;
                                 }
                                 catch (error) {
-                                    if (!(error instanceof Error)) {
-                                        throw error;
-                                    }
+                                    assertsError(error);
                                     if (error instanceof UnexpectedError) {
                                         throw error;
                                     }
@@ -3922,9 +4035,7 @@
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -4545,9 +4656,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 [🤹‍♂️]
@@ -5256,17 +5365,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:
@@ -5287,7 +5401,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, 
@@ -5489,9 +5603,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
             }
@@ -6289,6 +6401,8 @@
      */
 
     /**
+    import { WrappedError } from '../../errors/WrappedError';
+    import { assertsError } from '../../errors/assertsError';
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
@@ -6380,9 +6494,7 @@
                 };
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 throw new ParseError(spaceTrim__default["default"]((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
@@ -10167,8 +10279,7 @@
                 options: {
                     apiKey: 'sk-ant-api03-',
                     isProxied: true,
-                    remoteUrl: DEFAULT_REMOTE_URL,
-                    path: DEFAULT_REMOTE_URL_PATH,
+                    remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
                 },
             };
         },
@@ -10477,9 +10588,7 @@
             return true;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return false;
         }
     }
@@ -10574,6 +10683,40 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Convert identification to Promptbook token
+     *
+     * @param identification
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function identificationToPromptbookToken(identification) {
+        const { appId, userId, userToken } = identification;
+        const promptbookToken = `${appId}-${userId}-${userToken}`;
+        return promptbookToken;
+    }
+
+    /**
+     * Convert Promptbook token to identification
+     *
+     * @param promptbookToken
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function promptbookTokenToIdentification(promptbookToken) {
+        const [appId, userId, userToken] = promptbookToken.split('-');
+        if (!appId || !userId || !userToken) {
+            throw new Error(`Invalid promptbook token: ${promptbookToken}`);
+        }
+        const identification = {
+            appId,
+            userId,
+            userToken,
+            isAnonymous: false,
+        };
+        return identification;
+    }
+
     /**
      * Metadata of the scraper
      *
@@ -10870,11 +11013,13 @@
     exports.ADMIN_EMAIL = ADMIN_EMAIL;
     exports.ADMIN_GITHUB_NAME = ADMIN_GITHUB_NAME;
     exports.AbstractFormatError = AbstractFormatError;
+    exports.AuthenticationError = AuthenticationError;
     exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
     exports.BlackholeStorage = BlackholeStorage;
     exports.BoilerplateError = BoilerplateError;
     exports.BoilerplateFormfactorDefinition = BoilerplateFormfactorDefinition;
     exports.CLAIM = CLAIM;
+    exports.CLI_APP_ID = CLI_APP_ID;
     exports.CallbackInterfaceTools = CallbackInterfaceTools;
     exports.ChatbotFormfactorDefinition = ChatbotFormfactorDefinition;
     exports.CollectionError = CollectionError;
@@ -10896,8 +11041,7 @@
     exports.DEFAULT_MAX_PARALLEL_COUNT = DEFAULT_MAX_PARALLEL_COUNT;
     exports.DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME = DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME;
     exports.DEFAULT_PROMPT_TASK_TITLE = DEFAULT_PROMPT_TASK_TITLE;
-    exports.DEFAULT_REMOTE_URL = DEFAULT_REMOTE_URL;
-    exports.DEFAULT_REMOTE_URL_PATH = DEFAULT_REMOTE_URL_PATH;
+    exports.DEFAULT_REMOTE_SERVER_URL = DEFAULT_REMOTE_SERVER_URL;
     exports.DEFAULT_SCRAPE_CACHE_DIRNAME = DEFAULT_SCRAPE_CACHE_DIRNAME;
     exports.DEFAULT_TASK_TITLE = DEFAULT_TASK_TITLE;
     exports.EXPECTATION_UNITS = EXPECTATION_UNITS;
@@ -10910,8 +11054,6 @@
     exports.GenericFormfactorDefinition = GenericFormfactorDefinition;
     exports.ImageGeneratorFormfactorDefinition = ImageGeneratorFormfactorDefinition;
     exports.KnowledgeScrapeError = KnowledgeScrapeError;
-    exports.LOGO_DARK_SRC = LOGO_DARK_SRC;
-    exports.LOGO_LIGHT_SRC = LOGO_LIGHT_SRC;
     exports.LimitReachedError = LimitReachedError;
     exports.MANDATORY_CSV_SETTINGS = MANDATORY_CSV_SETTINGS;
     exports.MAX_FILENAME_LENGTH = MAX_FILENAME_LENGTH;
@@ -10925,6 +11067,7 @@
     exports.NotFoundError = NotFoundError;
     exports.NotYetImplementedError = NotYetImplementedError;
     exports.ORDER_OF_PIPELINE_JSON = ORDER_OF_PIPELINE_JSON;
+    exports.PLAYGROUND_APP_ID = PLAYGROUND_APP_ID;
     exports.PROMPTBOOK_ENGINE_VERSION = PROMPTBOOK_ENGINE_VERSION;
     exports.PROMPTBOOK_ERRORS = PROMPTBOOK_ERRORS;
     exports.ParseError = ParseError;
@@ -10932,6 +11075,8 @@
     exports.PipelineLogicError = PipelineLogicError;
     exports.PipelineUrlError = PipelineUrlError;
     exports.PrefixStorage = PrefixStorage;
+    exports.PromptbookFetchError = PromptbookFetchError;
+    exports.REMOTE_SERVER_URLS = REMOTE_SERVER_URLS;
     exports.RESERVED_PARAMETER_NAMES = RESERVED_PARAMETER_NAMES;
     exports.SET_IS_VERBOSE = SET_IS_VERBOSE;
     exports.SectionTypes = SectionTypes;
@@ -10942,6 +11087,7 @@
     exports.UNCERTAIN_USAGE = UNCERTAIN_USAGE;
     exports.UNCERTAIN_ZERO_VALUE = UNCERTAIN_ZERO_VALUE;
     exports.UnexpectedError = UnexpectedError;
+    exports.WrappedError = WrappedError;
     exports.ZERO_USAGE = ZERO_USAGE;
     exports.ZERO_VALUE = ZERO_VALUE;
     exports._AnthropicClaudeMetadataRegistration = _AnthropicClaudeMetadataRegistration;
@@ -10973,6 +11119,7 @@
     exports.executionReportJsonToString = executionReportJsonToString;
     exports.extractParameterNamesFromTask = extractParameterNamesFromTask;
     exports.getPipelineInterface = getPipelineInterface;
+    exports.identificationToPromptbookToken = identificationToPromptbookToken;
     exports.isPassingExpectations = isPassingExpectations;
     exports.isPipelineImplementingInterface = isPipelineImplementingInterface;
     exports.isPipelineInterfacesEqual = isPipelineInterfacesEqual;
@@ -10988,6 +11135,8 @@
     exports.preparePipeline = preparePipeline;
     exports.prepareTasks = prepareTasks;
     exports.prettifyPipelineString = prettifyPipelineString;
+    exports.promptbookFetch = promptbookFetch;
+    exports.promptbookTokenToIdentification = promptbookTokenToIdentification;
     exports.unpreparePipeline = unpreparePipeline;
     exports.usageToHuman = usageToHuman;
     exports.usageToWorktime = usageToWorktime;