@promptbook/cli 0.89.0-8 → 0.89.0

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('waitasecond'), require('prompts'), require('path'), require('fs/promises'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto'), require('socket.io-client'), require('rxjs'), require('dotenv'), require('child_process'), require('jszip'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('moment'), require('express'), require('http'), require('socket.io'), require('swagger-jsdoc'), require('swagger-ui-express'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'waitasecond', 'prompts', 'path', 'fs/promises', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto', 'socket.io-client', 'rxjs', 'dotenv', 'child_process', 'jszip', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'moment', 'express', 'http', 'socket.io', 'swagger-jsdoc', 'swagger-ui-express', '@anthropic-ai/sdk', '@azure/openai', 'openai', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global.spaceTrim, global.waitasecond, global.prompts, global.path, global.promises, global.hexEncoder, global.sha256, global.crypto, global.socket_ioClient, global.rxjs, global.dotenv, global.child_process, global.JSZip, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.moment, global.express, global.http, global.socket_io, global.swaggerJsdoc, global.swaggerUi, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
-})(this, (function (exports, colors, commander, spaceTrim, waitasecond, prompts, path, promises, hexEncoder, sha256, crypto, socket_ioClient, rxjs, dotenv, child_process, JSZip, prettier, parserHtml, papaparse, cryptoJs, mimeTypes, glob, moment, express, http, socket_io, swaggerJsdoc, swaggerUi, Anthropic, openai, OpenAI, readability, jsdom, showdown) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('waitasecond'), require('prompts'), require('path'), require('fs/promises'), require('dotenv'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto'), require('socket.io-client'), require('rxjs'), require('child_process'), require('jszip'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('moment'), require('express'), require('http'), require('socket.io'), require('express-openapi-validator'), require('swagger-ui-express'), require('@anthropic-ai/sdk'), require('@azure/openai'), require('openai'), require('@mozilla/readability'), require('jsdom'), require('showdown')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'waitasecond', 'prompts', 'path', 'fs/promises', 'dotenv', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto', 'socket.io-client', 'rxjs', 'child_process', 'jszip', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'moment', 'express', 'http', 'socket.io', 'express-openapi-validator', 'swagger-ui-express', '@anthropic-ai/sdk', '@azure/openai', 'openai', '@mozilla/readability', 'jsdom', 'showdown'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global.spaceTrim, global.waitasecond, global.prompts, global.path, global.promises, global.dotenv, global.hexEncoder, global.sha256, global.crypto, global.socket_ioClient, global.rxjs, global.child_process, global.JSZip, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.moment, global.express, global.http, global.socket_io, global.OpenApiValidator, global.swaggerUi, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
+})(this, (function (exports, colors, commander, spaceTrim, waitasecond, prompts, path, promises, dotenv, hexEncoder, sha256, crypto, socket_ioClient, rxjs, child_process, JSZip, prettier, parserHtml, papaparse, cryptoJs, mimeTypes, glob, moment, express, http, socket_io, OpenApiValidator, swaggerUi, Anthropic, openai, OpenAI, readability, jsdom, showdown) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -28,16 +28,16 @@
     var commander__default = /*#__PURE__*/_interopDefaultLegacy(commander);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var prompts__default = /*#__PURE__*/_interopDefaultLegacy(prompts);
+    var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
-    var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
     var JSZip__default = /*#__PURE__*/_interopDefaultLegacy(JSZip);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
     var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
     var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
     var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
-    var swaggerJsdoc__default = /*#__PURE__*/_interopDefaultLegacy(swaggerJsdoc);
+    var OpenApiValidator__namespace = /*#__PURE__*/_interopNamespace(OpenApiValidator);
     var swaggerUi__default = /*#__PURE__*/_interopDefaultLegacy(swaggerUi);
     var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
@@ -56,12 +56,43 @@
      * @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
      */
 
+    /**
+     * Available remote servers for the Promptbook
+     *
+     * @public exported from `@promptbook/core`
+     */
+    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'],
+        },
+        */
+    ];
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Returns the same value that is passed as argument.
      * No side effects.
@@ -116,6 +147,7 @@
      * @public exported from `@promptbook/core`
      */
     const CLAIM = `It's time for a paradigm shift. The future of software in plain English, French or Latin`;
+    //            <- TODO: [🐊] Pick the best claim
     /**
      * When the title is not provided, the default title is used
      *
@@ -146,6 +178,12 @@
      * @private within the repository
      */
     const GENERATOR_WARNING_BY_PROMPTBOOK_CLI = `⚠️ WARNING: This code has been generated by \`@promptbook/cli\` so that any manual changes will be overwritten`;
+    /**
+     * Warning message for the automatically generated sections of `.env` files
+     *
+     * @private within the repository
+     */
+    const GENERATOR_WARNING_IN_ENV = `Note: Added by Promptbook`;
     // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
     /**
      * The maximum number of iterations for a loops
@@ -166,6 +204,7 @@
         infinity: '(infinity; ∞)',
         negativeInfinity: '(negative infinity; -∞)',
         unserializable: '(unserializable value)',
+        circular: '(circular JSON)',
     };
     /**
      * Small number limit
@@ -225,7 +264,7 @@
      */
     const DEFAULT_BOOKS_DIRNAME = './books';
     // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
-    // TODO: !!!!!! Just .promptbook dir, hardocode others
+    // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
      * Where to store the temporary downloads
      *
@@ -281,11 +320,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.
     };
     /**
-     * @@@
+     * Default remote server URL for the Promptbook
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_REMOTE_SERVER_URL = 'https://api.pavolhejny.com/promptbook';
+    const DEFAULT_REMOTE_SERVER_URL = REMOTE_SERVER_URLS[0].urls[0];
     // <- TODO: [🧜‍♂️]
     /**
      * @@@
@@ -419,6 +458,122 @@
      * TODO: [🎺]
      */
 
+    /**
+     * 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);
+    }
+
     /**
      * Wraps action to handle error console logging and exit process with error code
      *
@@ -433,9 +588,7 @@
                 return process.exit(0);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 // console.error(colors.bgRed(error.name));
                 console.error(colors__default["default"].red(/* error.stack || */ error.message));
                 return process.exit(1);
@@ -542,74 +695,6 @@
         }
     }
 
-    /**
-     * 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);
-        }
-    }
-
     /**
      * @@@
      *
@@ -897,119 +982,278 @@
         `);
     }
     /**
-     * TODO: [®] DRY Register logic
-     * TODO: [🧠][⚛] Maybe pass env as argument
-     */
-
-    /**
-     * Just says that the variable is not used but should be kept
-     * No side effects.
-     *
-     * 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
+     * TODO: [®] DRY Register logic
+     * TODO: [🧠][⚛] Maybe pass env as argument
+     */
+
+    /**
+     * Just says that the variable is not used but should be kept
+     * No side effects.
+     *
+     * 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
+     */
+    function keepUnused(...valuesToKeep) {
+    }
+
+    /**
+     * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function $sideEffect(...sideEffectSubjects) {
+        keepUnused(...sideEffectSubjects);
+    }
+
+    /**
+     * 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;
+    }
+
+    /**
+     * Just marks a place of place where should be something implemented
+     * No side effects.
+     *
+     * Note: It can be usefull suppressing eslint errors of unused variables
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function TODO_USE(...value) {
+    }
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideFilesystemForNode(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+        }
+        return {
+            stat: promises.stat,
+            access: promises.access,
+            constants: promises.constants,
+            readFile: promises.readFile,
+            writeFile: promises.writeFile,
+            readdir: promises.readdir,
+            mkdir: promises.mkdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Checks if the file exists
+     *
+     * @private within the repository
+     */
+    async function isFileExisting(filename, fs) {
+        const isReadAccessAllowed = await fs
+            .access(filename, fs.constants.R_OK)
+            .then(() => true)
+            .catch(() => false);
+        if (!isReadAccessAllowed) {
+            return false;
+        }
+        const isFile = await fs
+            .stat(filename)
+            .then((fileStat) => fileStat.isFile())
+            .catch(() => false);
+        return isFile;
+    }
+    /**
+     * Note: Not [~🟢~] because it is not directly dependent on `fs
+     * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
+     * TODO: [🖇] What about symlinks?
+     */
+
+    /**
+     * Determines if the given path is a root path.
+     *
+     * Note: This does not check if the file exists only if the path is valid
+     * @public exported from `@promptbook/utils`
+     */
+    function isRootPath(value) {
+        if (value === '/') {
+            return true;
+        }
+        if (/^[A-Z]:\\$/i.test(value)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * TODO: [🍏] Make for MacOS paths
+     */
+
+    /**
+     * Provides the path to the `.env` file
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
+     *
+     * @private within the repository - for CLI utils
+     */
+    async function $provideEnvFilename() {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideEnvFilename` works only in Node.js environment');
+        }
+        const envFilePatterns = [
+            '.env',
+            '.env.test',
+            '.env.local',
+            '.env.development.local',
+            '.env.development',
+            '.env.production.local',
+            '.env.production',
+            '.env.prod.local',
+            '.env.prod',
+            // <- TODO: Maybe add more patterns
+        ];
+        let rootDirname = process.cwd();
+        up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
+            for (const pattern of envFilePatterns) {
+                const envFilename = path.join(rootDirname, pattern);
+                if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
+                    $setUsedEnvFilename(envFilename);
+                    return envFilename;
+                }
+            }
+            if (isRootPath(rootDirname)) {
+                break up_to_root;
+            }
+            // Note: If the directory does not exist, try the parent directory
+            rootDirname = path.join(rootDirname, '..');
+        }
+        return null;
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
-    function keepUnused(...valuesToKeep) {
-    }
 
     /**
-     * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
+     * Stores data in .env variables
      *
-     * @param value any values
-     * @returns void
-     * @private within the repository
-     */
-    function $sideEffect(...sideEffectSubjects) {
-        keepUnused(...sideEffectSubjects);
-    }
-
-    /**
-     * Stores data in memory (HEAP)
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes to `process.env`
      *
-     * @public exported from `@promptbook/core`
+     * @private within the repository - for CLI utils
      */
-    class MemoryStorage {
+    class $EnvStorage {
         constructor() {
-            this.storage = {};
+            this.envFilename = null;
+        }
+        async $provideOrCreateEnvFile() {
+            if (this.envFilename !== null) {
+                return this.envFilename;
+            }
+            let envFilename = await $provideEnvFilename();
+            if (envFilename !== null) {
+                this.envFilename = envFilename;
+                return envFilename;
+            }
+            envFilename = path.join(process.cwd(), '.env');
+            await promises.writeFile(envFilename, '# This file was initialized by Promptbook', 'utf-8');
+            this.envFilename = envFilename;
+            return envFilename;
+        }
+        transformKey(key) {
+            return normalizeTo_SCREAMING_CASE(key);
         }
         /**
          * Returns the number of key/value pairs currently present in the list associated with the object.
          */
         get length() {
-            return Object.keys(this.storage).length;
+            throw new NotYetImplementedError('Method `$EnvStorage.length` not implemented.');
         }
         /**
          * Empties the list associated with the object of all key/value pairs, if there are any.
          */
         clear() {
-            this.storage = {};
+            throw new NotYetImplementedError('Method `$EnvStorage.clear` not implemented.');
         }
         /**
          * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
          */
-        getItem(key) {
-            return this.storage[key] || null;
+        async getItem(key) {
+            dotenv__namespace.config({ path: await this.$provideOrCreateEnvFile() });
+            return process.env[this.transformKey(key)] || null;
         }
         /**
          * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
          */
         key(index) {
-            return Object.keys(this.storage)[index] || null;
+            throw new NotYetImplementedError('Method `$EnvStorage.key` not implemented.');
         }
         /**
          * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
          */
-        setItem(key, value) {
-            this.storage[key] = value;
+        async setItem(key, value) {
+            const envFilename = await this.$provideOrCreateEnvFile();
+            const envContent = await promises.readFile(envFilename, 'utf-8');
+            const transformedKey = this.transformKey(key);
+            const updatedEnvContent = envContent
+                .split('\n')
+                .filter((line) => !line.startsWith(`# ${GENERATOR_WARNING_IN_ENV}`)) // Remove GENERATOR_WARNING_IN_ENV
+                .filter((line) => !line.startsWith(`${transformedKey}=`)) // Remove existing key if present
+                .join('\n');
+            const newEnvContent = spaceTrim__default["default"]((block) => `
+                ${block(updatedEnvContent)}
+
+                # ${GENERATOR_WARNING_IN_ENV}
+                ${transformedKey}=${JSON.stringify(value)}
+            `);
+            await promises.writeFile(envFilename, newEnvContent, 'utf-8');
         }
         /**
          * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
          */
         removeItem(key) {
-            delete this.storage[key];
-        }
-    }
-
-    /**
-     * Just marks a place of place where should be something implemented
-     * No side effects.
-     *
-     * Note: It can be usefull suppressing eslint errors of unused variables
-     *
-     * @param value any values
-     * @returns void
-     * @private within the repository
-     */
-    function TODO_USE(...value) {
-    }
-
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $provideFilesystemForNode(options) {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+            throw new NotYetImplementedError('Method `$EnvStorage.removeItem` not implemented.');
         }
-        return {
-            stat: promises.stat,
-            access: promises.access,
-            constants: promises.constants,
-            readFile: promises.readFile,
-            writeFile: promises.writeFile,
-            readdir: promises.readdir,
-            mkdir: promises.mkdir,
-        };
     }
     /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
      */
 
     /**
@@ -1145,9 +1389,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
 
@@ -1380,31 +1622,6 @@
      * TODO: [🍙] Make some standard order of json properties
      */
 
-    /**
-     * Checks if the file exists
-     *
-     * @private within the repository
-     */
-    async function isFileExisting(filename, fs) {
-        const isReadAccessAllowed = await fs
-            .access(filename, fs.constants.R_OK)
-            .then(() => true)
-            .catch(() => false);
-        if (!isReadAccessAllowed) {
-            return false;
-        }
-        const isFile = await fs
-            .stat(filename)
-            .then((fileStat) => fileStat.isFile())
-            .catch(() => false);
-        return isFile;
-    }
-    /**
-     * Note: Not [~🟢~] because it is not directly dependent on `fs
-     * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
-     * TODO: [🖇] What about symlinks?
-     */
-
     /**
      * Removes emojis from a string and fix whitespaces
      *
@@ -2086,7 +2303,7 @@
         }
     }
     /**
-     * TODO: !!!!!! Add id to all errors
+     * TODO: [🧠][🌂] Add id to all errors
      */
 
     /**
@@ -2115,6 +2332,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
      *
@@ -2135,7 +2365,10 @@
         PipelineExecutionError,
         PipelineLogicError,
         PipelineUrlError,
+        AuthenticationError,
+        PromptbookFetchError,
         UnexpectedError,
+        WrappedError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -2152,7 +2385,6 @@
         TypeError,
         URIError,
         AggregateError,
-        AuthenticationError,
         /*
       Note: Not widely supported
       > InternalError,
@@ -2210,17 +2442,31 @@
      */
     async function createRemoteClient(options) {
         const { remoteServerUrl } = options;
-        let path = new URL(remoteServerUrl).pathname;
-        if (path.endsWith('/')) {
-            path = path.slice(0, -1);
+        if (!isValidUrl(remoteServerUrl)) {
+            throw new Error(`Invalid \`remoteServerUrl\`: "${remoteServerUrl}"`);
+        }
+        const remoteServerUrlParsed = new URL(remoteServerUrl);
+        if (remoteServerUrlParsed.pathname !== '/' && remoteServerUrlParsed.pathname !== '') {
+            remoteServerUrlParsed.pathname = '/';
+            throw new Error(spaceTrim__default["default"]((block) => `
+                        Remote server requires root url \`/\`
+
+                        You have provided \`remoteServerUrl\`:
+                        ${block(remoteServerUrl)}
+
+                        But something like this is expected:
+                        ${block(remoteServerUrlParsed.href)}
+
+                        Note: If you need to run multiple services on the same server, use 3rd or 4th degree subdomain
+
+                    `));
         }
-        path = `${path}/socket.io`;
         return new Promise((resolve, reject) => {
             const socket = socket_ioClient.io(remoteServerUrl, {
                 retries: CONNECTION_RETRIES_LIMIT,
                 timeout: CONNECTION_TIMEOUT_MS,
-                path,
-                transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+                path: '/socket.io',
+                transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
             });
             // console.log('Connecting to', this.options.remoteServerUrl.href, { socket });
             socket.on('connect', () => {
@@ -2345,6 +2591,53 @@
      * TODO: [🧠] Maybe remove `@promptbook/remote-client` and just use `@promptbook/core`
      */
 
+    /**
+     * Stores data in memory (HEAP)
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class MemoryStorage {
+        constructor() {
+            this.storage = {};
+        }
+        /**
+         * Returns the number of key/value pairs currently present in the list associated with the object.
+         */
+        get length() {
+            return Object.keys(this.storage).length;
+        }
+        /**
+         * Empties the list associated with the object of all key/value pairs, if there are any.
+         */
+        clear() {
+            this.storage = {};
+        }
+        /**
+         * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+         */
+        getItem(key) {
+            return this.storage[key] || null;
+        }
+        /**
+         * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+         */
+        key(index) {
+            return Object.keys(this.storage)[index] || null;
+        }
+        /**
+         * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         */
+        setItem(key, value) {
+            this.storage[key] = value;
+        }
+        /**
+         * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+         */
+        removeItem(key) {
+            delete this.storage[key];
+        }
+    }
+
     /**
      * Simple wrapper `new Date().toISOString()`
      *
@@ -2631,29 +2924,11 @@
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
-    /**
-     * Determines if the given path is a root path.
-     *
-     * Note: This does not check if the file exists only if the path is valid
-     * @public exported from `@promptbook/utils`
-     */
-    function isRootPath(value) {
-        if (value === '/') {
-            return true;
-        }
-        if (/^[A-Z]:\\$/i.test(value)) {
-            return true;
-        }
-        return false;
-    }
-    /**
-     * TODO: [🍏] Make for MacOS paths
-     */
-
     /**
      * @@@
      *
      * @@@ .env
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
      *
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
@@ -2667,33 +2942,9 @@
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
         }
-        const envFilePatterns = [
-            '.env',
-            '.env.test',
-            '.env.local',
-            '.env.development.local',
-            '.env.development',
-            '.env.production.local',
-            '.env.production',
-            '.env.prod.local',
-            '.env.prod',
-            // <- TODO: Maybe add more patterns
-        ];
-        let rootDirname = process.cwd();
-        up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
-            for (const pattern of envFilePatterns) {
-                const envFilename = path.join(rootDirname, pattern);
-                if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
-                    $setUsedEnvFilename(envFilename);
-                    dotenv__namespace.config({ path: envFilename });
-                    break up_to_root;
-                }
-            }
-            if (isRootPath(rootDirname)) {
-                break up_to_root;
-            }
-            // Note: If the directory does not exist, try the parent directory
-            rootDirname = path.join(rootDirname, '..');
+        const envFilepath = await $provideEnvFilename();
+        if (envFilepath !== null) {
+            dotenv__namespace.config({ path: envFilepath });
         }
         const llmToolsConfiguration = $llmToolsMetadataRegister
             .list()
@@ -2702,15 +2953,8 @@
         return llmToolsConfiguration;
     }
     /**
-     * TODO: [🧠][🪁] Maybe do allow to do auto-install if package not registered and not found
-     * TODO: Add Azure OpenAI
-     * TODO: [🧠][🍛]
-     * TODO: [🧠] Is there some meaningfull way how to test this util
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
-     * TODO: This should be maybe not under `_common` but under `utils`
-     * TODO: [🧠][⚛] Maybe pass env as argument
-     * TODO: [®] DRY Register logic */
+     */
 
     /**
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
@@ -2806,14 +3050,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(
@@ -2960,6 +3205,7 @@
      * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
      *
      * @@@ .env
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
      *
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
@@ -3004,6 +3250,8 @@
     /**
      * Returns LLM tools for CLI
      *
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes this .env file
+     *
      * @private within the repository - for CLI utils
      */
     async function $provideLlmToolsForWizzardOrCli(options) {
@@ -3011,16 +3259,27 @@
             throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizzardOrCli` works only in Node.js environment');
         }
         options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
-        const { strategy, isCacheReloaded } = options;
+        const { isLoginloaded, strategy, isCacheReloaded } = options;
         let llmExecutionTools;
         if (strategy === 'REMOTE_SERVER') {
             const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
-            const storage = new MemoryStorage(); // <- TODO: !!!!!! Save to `.promptbook` folder
-            const key = `${remoteServerUrl}-identification`;
-            let identification = await storage.getItem(key);
-            if (identification === null) {
+            const storage = new $EnvStorage();
+            let key = `PROMPTBOOK_TOKEN`;
+            if (remoteServerUrl !== DEFAULT_REMOTE_SERVER_URL) {
+                key = `${key}_${remoteServerUrl.replace(/^https?:\/\//i, '')}`;
+            }
+            let identification = null;
+            let promptbookToken = await storage.getItem(key);
+            if (promptbookToken === null || isLoginloaded) {
                 identification = await loginPrompt();
-                await storage.setItem(key, identification);
+                // Note: When login prompt fails, `process.exit(1)` is called so no need to check for null
+                if (identification.isAnonymous === false) {
+                    promptbookToken = identificationToPromptbookToken(identification);
+                    await storage.setItem(key, promptbookToken);
+                }
+            }
+            else {
+                identification = promptbookTokenToIdentification(promptbookToken);
             }
             llmExecutionTools = new RemoteLlmExecutionTools({
                 remoteServerUrl,
@@ -3044,11 +3303,42 @@
         });
     }
     /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
-     * TODO: [🥃] Allow `ptbk make` without llm tools
-     * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
-     * TODO: [®] DRY Register logic
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     * TODO: [🥃] Allow `ptbk make` without llm tools
+     * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
+     * TODO: [®] DRY Register logic
+     */
+
+    /**
+     * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const promptbookFetch = async (urlOrRequest, init) => {
+        try {
+            return await fetch(urlOrRequest, init);
+        }
+        catch (error) {
+            assertsError(error);
+            let url;
+            if (typeof urlOrRequest === 'string') {
+                url = urlOrRequest;
+            }
+            else if (urlOrRequest instanceof Request) {
+                url = urlOrRequest.url;
+            }
+            throw new PromptbookFetchError(spaceTrim__default["default"]((block) => `
+                    Can not fetch "${url}"
+
+                    Fetch error:
+                    ${block(error.message)}
+
+                `));
+        }
+    };
+    /**
+     * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
      */
 
     /**
@@ -3069,8 +3359,8 @@
     /**
      * @private utility of CLI
      */
-    function $provideLlmToolsForCli(options) {
-        const { cliOptions: { 
+    async function $provideLlmToolsForCli(options) {
+        const { isLoginloaded, cliOptions: { 
         /* TODO: Use verbose: isVerbose, */ interactive: isInteractive, provider, remoteServerUrl: remoteServerUrlRaw, }, } = options;
         let strategy;
         if (/^b/i.test(provider)) {
@@ -3084,7 +3374,11 @@
             process.exit(1);
         }
         if (strategy === 'BRING_YOUR_OWN_KEYS') {
-            return /* not await */ $provideLlmToolsForWizzardOrCli({ strategy, ...options });
+            if (isLoginloaded) {
+                throw new UnexpectedError(`\`$provideLlmToolsForCli\` isLoginloaded is not supported for strategy "BRING_YOUR_OWN_KEYS"`);
+            }
+            const llm = await $provideLlmToolsForWizzardOrCli({ strategy, ...options });
+            return { strategy, llm };
         }
         else if (strategy === 'REMOTE_SERVER') {
             if (!isValidUrl(remoteServerUrlRaw)) {
@@ -3092,7 +3386,8 @@
                 process.exit(1);
             }
             const remoteServerUrl = remoteServerUrlRaw.endsWith('/') ? remoteServerUrlRaw.slice(0, -1) : remoteServerUrlRaw;
-            return /* not await */ $provideLlmToolsForWizzardOrCli({
+            const llm = await $provideLlmToolsForWizzardOrCli({
+                isLoginloaded,
                 strategy,
                 appId: CLI_APP_ID,
                 remoteServerUrl,
@@ -3102,6 +3397,10 @@
                         console.log(colors__default["default"].red(`You can not login to remote server in non-interactive mode`));
                         process.exit(1);
                     }
+                    console.info(colors__default["default"].cyan(spaceTrim__default["default"](`
+                          You will be logged in to ${remoteServerUrl}
+                          If you don't have an account, it will be created automatically.
+                      `)));
                     const { username, password } = await prompts__default["default"]([
                         {
                             type: 'text',
@@ -3119,7 +3418,8 @@
                         },
                     ]);
                     const loginUrl = `${remoteServerUrl}/login`;
-                    const response = await fetch(loginUrl, {
+                    // TODO: [🧠] Should we use normal `fetch` or `scraperFetch`
+                    const response = await promptbookFetch(loginUrl, {
                         method: 'POST',
                         headers: {
                             'Content-Type': 'application/json',
@@ -3130,13 +3430,6 @@
                             password,
                         }),
                     });
-                    console.log('!!!', {
-                        loginUrl,
-                        username,
-                        password,
-                        // type: response.type,
-                        // text: await response.text(),
-                    });
                     const { isSuccess, message, error, identification } = (await response.json());
                     if (message) {
                         if (isSuccess) {
@@ -3158,6 +3451,7 @@
                     return identification;
                 },
             });
+            return { strategy, llm };
         }
         else {
             throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
@@ -3179,11 +3473,12 @@
         listModelsCommand.alias('models');
         listModelsCommand.alias('llm');
         listModelsCommand.action(handleActionErrors(async (cliOptions) => {
-            console.log('!!!', cliOptions);
-            // TODO: !!!!!! Not relevant for remote server and also for `about` command
-            const llm = await $provideLlmToolsForCli({ cliOptions });
+            const { strategy, llm } = await $provideLlmToolsForCli({ cliOptions });
             $sideEffect(llm);
             // <- Note: Providing LLM tools will make a side effect of registering all available LLM tools to show the message
+            if (strategy !== 'BRING_YOUR_OWN_KEYS') {
+                console.warn(colors__default["default"].yellow(`You are using --strategy ${strategy} but models listed below are relevant for --strategy BRING_YOUR_OWN_KEYS`));
+            }
             console.info($registeredLlmToolsMessage());
             return process.exit(0);
         }));
@@ -3366,9 +3661,7 @@
             return result.trim();
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3423,9 +3716,7 @@
             return result.trim() + toExec;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3456,9 +3747,7 @@
             throw new Error(`Can not locate app ${appName} on Windows.`);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3717,6 +4006,7 @@
         `));
         listModelsCommand.alias('scrapers');
         listModelsCommand.action(handleActionErrors(async () => {
+            // TODO: [🌞] Do not allow on REMOTE_SERVER strategy
             const scrapers = await $provideScrapersForNode({});
             const executables = await $provideExecutablesForNode();
             console.info(spaceTrim__default["default"]((block) => `
@@ -3752,42 +4042,20 @@
         loginCommand.description(spaceTrim__default["default"](`
             Login to the remote Promptbook server
         `));
-        loginCommand.action(handleActionErrors(async () => {
-            // @@@
-            console.error(colors__default["default"].green(spaceTrim__default["default"](`
-                        You will be logged in to https://promptbook.studio server.
-                        If you don't have an account, it will be created automatically.
-                    `)));
-            // !!!!!!!!! Remove from here and use $provideLlmToolsForCli
-            const { email, password } = await prompts__default["default"]([
-                {
-                    type: 'text',
-                    name: 'email',
-                    message: 'Enter your email:',
-                    validate: (value) => (isValidEmail(value) ? true : 'Valid email is required'),
-                },
-                {
-                    type: 'password',
-                    name: 'password',
-                    message: 'Enter your password:',
-                    validate: (value) => value.length /* <- TODO: [🧠] Better password validation */ > 0 ? true : 'Password is required',
+        loginCommand.action(handleActionErrors(async (cliOptions) => {
+            // Note: Not interested in return value of this function but the side effect of logging in
+            await $provideLlmToolsForCli({
+                isLoginloaded: true,
+                cliOptions: {
+                    ...cliOptions,
+                    strategy: 'REMOTE_SERVER', // <- Note: Overriding strategy to `REMOTE_SERVER`
+                    //                               TODO: Do not allow flag `--strategy` in `login` command at all
                 },
-            ]);
-            TODO_USE(email, password);
-            await waitasecond.forTime(1000);
-            console.error(colors__default["default"].green(spaceTrim__default["default"](`
-                        Your account ${email} was successfully created.
-
-                        Please verify your email:
-                        https://brj.app/api/v1/customer/register-account?apiKey=PRODdh003eNKaec7PoO1AzU244tsL4WO
-
-                        After verification, you will receive 500 000 credits for free 🎉
-                    `)));
+            });
             return process.exit(0);
         }));
     }
     /**
-     * TODO: Pass remote server URL (and path)
      * TODO: Implement non-interactive login
      * Note: [💞] Ignore a discrepancy between file name and entity name
      * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
@@ -4208,6 +4476,9 @@
     /**
      * 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`
      */
     function isValidJsonString(value /* <- [👨‍⚖️] */) {
@@ -4216,9 +4487,7 @@
             return true;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             if (error.message.includes('Unexpected token')) {
                 return false;
             }
@@ -4749,8 +5018,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);
@@ -4760,6 +5029,7 @@
                     partialResultSubject.next(executionResult);
                 }
                 catch (error) {
+                    assertsError(error);
                     status = 'ERROR';
                     errors.push(error);
                     partialResultSubject.error(error);
@@ -4905,13 +5175,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;
         }
@@ -4968,9 +5244,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)}
@@ -5089,6 +5363,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
      *
@@ -5099,7 +5395,7 @@
         formatName: 'CSV',
         aliases: ['SPREADSHEET', 'TABLE'],
         isValid(value, settings, schema) {
-            return true;
+            return isValidCsvString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -5253,6 +5549,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
      *
@@ -5262,7 +5582,7 @@
         formatName: 'XML',
         mimeType: 'application/xml',
         isValid(value, settings, schema) {
-            return true;
+            return isValidXmlString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -5854,9 +6174,7 @@
                                     break scripts;
                                 }
                                 catch (error) {
-                                    if (!(error instanceof Error)) {
-                                        throw error;
-                                    }
+                                    assertsError(error);
                                     if (error instanceof UnexpectedError) {
                                         throw error;
                                     }
@@ -5926,9 +6244,7 @@
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -6549,9 +6865,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 [🤹‍♂️]
@@ -6817,32 +7131,6 @@
         return mimeTypes.extension(value) || null;
     }
 
-    /**
-     * 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
-     */
-    const scraperFetch = async (url, init) => {
-        try {
-            return await fetch(url, init);
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            throw new KnowledgeScrapeError(spaceTrim__default["default"]((block) => `
-                    Can not fetch "${url}"
-
-                    Fetch error:
-                    ${block(error.message)}
-
-                `));
-        }
-    };
-    /**
-     * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
-     */
-
     /**
      * @@@
      *
@@ -6851,7 +7139,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, 
@@ -7053,9 +7341,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
             }
@@ -7853,6 +8139,8 @@
      */
 
     /**
+    import { WrappedError } from '../../errors/WrappedError';
+    import { assertsError } from '../../errors/assertsError';
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
@@ -7944,9 +8232,7 @@
                 };
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 throw new ParseError(spaceTrim__default["default"]((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
@@ -11194,9 +11480,7 @@
                 }
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 if (error instanceof ReferenceError) {
                     const undefinedName = error.message.split(' ')[0];
                     /*
@@ -11471,9 +11755,7 @@
                     // ---
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     // TODO: [7] DRY
                     const wrappedErrorMessage = spaceTrim__default["default"]((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
@@ -11564,9 +11846,7 @@
                     }
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     // TODO: [7] DRY
                     const wrappedErrorMessage = spaceTrim__default["default"]((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
@@ -11782,7 +12062,7 @@
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForCli({
+            const { llm } = await $provideLlmToolsForCli({
                 cliOptions,
                 ...prepareAndScrapeOptions,
             });
@@ -12075,9 +12355,7 @@
                     }
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     console.info(colors__default["default"].red(`Prettify ${error.name} ${filename}`));
                     console.error(colors__default["default"].bgRed(`${error.name} in ${path.basename(__filename)}`));
                     console.error(colors__default["default"].red(error.stack || error.message));
@@ -12397,9 +12675,7 @@
             return true;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return false;
         }
     }
@@ -12624,9 +12900,7 @@
                 ongoingParameters = result.outputParameters;
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 // TODO: Allow to ressurect the chatbot after an error - prompt the user to continue
                 console.error(colors__default["default"].red(error.stack || error.message));
                 return process.exit(1);
@@ -12659,7 +12933,6 @@
         runCommand.option('-j, --json <json>', `Pass all or some input parameters as JSON record, if used the output is also returned as JSON`);
         runCommand.option('-s, --save-report <path>', `Save report to file`);
         runCommand.action(handleActionErrors(async (pipelineSource, cliOptions) => {
-            console.log('!!!', cliOptions);
             const { reload: isCacheReloaded, interactive: isInteractive, formfactor: isFormfactorUsed, json, verbose: isVerbose, saveReport, } = cliOptions;
             if (pipelineSource.includes('-') && normalizeToKebabCase(pipelineSource) === pipelineSource) {
                 console.error(colors__default["default"].red(`""${pipelineSource}" is not a valid command or book. See 'ptbk --help'.`));
@@ -12685,12 +12958,10 @@
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
             let llm;
             try {
-                llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+                llm = (await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions })).llm;
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 if (!error.message.includes('No LLM tools')) {
                     throw error;
                 }
@@ -12740,7 +13011,7 @@
             const tools = {
                 llm,
                 fs,
-                fetch: scraperFetch,
+                fetch: promptbookFetch,
                 scrapers: await $provideScrapersForNode({ fs, llm, executables }, prepareAndScrapeOptions),
                 script: [new JavascriptExecutionTools(cliOptions)],
             };
@@ -12896,6 +13167,198 @@
      * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
      */
 
+    // TODO: !!!! List running services from REMOTE_SERVER_URLS
+    // TODO: !!!! Import directly from YML
+    /**
+     * @private !!!! Decide how to expose this
+     */
+    const openapiJson = {
+        openapi: '3.0.0',
+        info: {
+            title: 'Promptbook Remote Server API (!!!! From TS)',
+            version: '1.0.0',
+            description: 'API documentation for the Promptbook Remote Server',
+        },
+        paths: {
+            '/': {
+                get: {
+                    summary: 'Get server details',
+                    description: 'Returns details about the Promptbook server.',
+                    responses: {
+                        '200': {
+                            description: 'Server details in markdown format.',
+                        },
+                    },
+                },
+            },
+            '/login': {
+                post: {
+                    summary: 'Login to the server',
+                    description: 'Login to the server and get identification.',
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        username: {
+                                            type: 'string',
+                                        },
+                                        password: {
+                                            type: 'string',
+                                        },
+                                        appId: {
+                                            type: 'string',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        '200': {
+                            description: 'Successful login',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            identification: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/books': {
+                get: {
+                    summary: 'List all books',
+                    description: 'Returns a list of all available books in the collection.',
+                    responses: {
+                        '200': {
+                            description: 'A list of books.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'string',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/books/{bookId}': {
+                get: {
+                    summary: 'Get book content',
+                    description: 'Returns the content of a specific book.',
+                    parameters: [
+                        {
+                            in: 'path',
+                            name: 'bookId',
+                            required: true,
+                            schema: {
+                                type: 'string',
+                            },
+                            description: 'The ID of the book to retrieve.',
+                        },
+                    ],
+                    responses: {
+                        '200': {
+                            description: 'The content of the book.',
+                            content: {
+                                'text/markdown': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                        '404': {
+                            description: 'Book not found.',
+                        },
+                    },
+                },
+            },
+            '/executions': {
+                get: {
+                    summary: 'List all executions',
+                    description: 'Returns a list of all running execution tasks.',
+                    responses: {
+                        '200': {
+                            description: 'A list of execution tasks.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'object',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/executions/new': {
+                post: {
+                    summary: 'Start a new execution',
+                    description: 'Starts a new execution task for a given pipeline.',
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        pipelineUrl: {
+                                            type: 'string',
+                                        },
+                                        inputParameters: {
+                                            type: 'object',
+                                        },
+                                        identification: {
+                                            type: 'object',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        '200': {
+                            description: 'The newly created execution task.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                    },
+                                },
+                            },
+                        },
+                        '400': {
+                            description: 'Invalid input.',
+                        },
+                    },
+                },
+            },
+        },
+        components: {},
+        tags: [],
+    };
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
      *
@@ -12906,7 +13369,7 @@
      * @public exported from `@promptbook/remote-server`
      */
     function startRemoteServer(options) {
-        const { port, collection, createLlmExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, login, } = {
+        const { port, collection, createLlmExecutionTools, createExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, login, } = {
             isAnonymousModeAllowed: false,
             isApplicationModeAllowed: false,
             collection: null,
@@ -12914,22 +13377,6 @@
             login: null,
             ...options,
         };
-        // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
-        let { rootPath = '/' } = options;
-        if (!rootPath.startsWith('/')) {
-            rootPath = `/${rootPath}`;
-        } /* not else */
-        if (rootPath.endsWith('/')) {
-            rootPath = rootPath.slice(0, -1);
-        } /* not else */
-        if (rootPath === '/') {
-            rootPath = '';
-        }
-        const socketioPath = '/' +
-            `${rootPath}/socket.io`
-                .split('/')
-                .filter((part) => part !== '')
-                .join('/');
         const startupDate = new Date();
         async function getExecutionToolsFromIdentification(identification) {
             if (identification === null || identification === undefined) {
@@ -12952,23 +13399,25 @@
             }
             else if (isAnonymous === false && createLlmExecutionTools !== null) {
                 // Note: Application mode
-                const { appId, userId, customOptions } = identification;
-                llm = await createLlmExecutionTools({
-                    appId,
-                    userId,
-                    customOptions,
-                });
+                llm = await createLlmExecutionTools(identification);
             }
             else {
                 throw new PipelineExecutionError(`You must provide either llmToolsConfiguration or non-anonymous mode must be propperly configured`);
             }
-            const fs = $provideFilesystemForNode();
-            const executables = await $provideExecutablesForNode();
+            const customExecutionTools = createExecutionTools ? await createExecutionTools(identification) : {};
+            const fs = customExecutionTools.fs || $provideFilesystemForNode();
+            const executables = customExecutionTools.executables || (await $provideExecutablesForNode());
+            const scrapers = customExecutionTools.scrapers || (await $provideScrapersForNode({ fs, llm, executables }));
+            const script = customExecutionTools.script || (await $provideScriptingForNode({}));
+            const fetch = customExecutionTools.fetch || promptbookFetch;
+            const userInterface = customExecutionTools.userInterface || undefined;
             const tools = {
                 llm,
                 fs,
-                scrapers: await $provideScrapersForNode({ fs, llm, executables }),
-                script: await $provideScriptingForNode({}),
+                scrapers,
+                script,
+                fetch,
+                userInterface,
             };
             return tools;
         }
@@ -12978,39 +13427,27 @@
             response.setHeader('X-Powered-By', 'Promptbook engine');
             next();
         });
-        const swaggerOptions = {
-            definition: {
-                openapi: '3.0.0',
-                info: {
-                    title: 'Promptbook Remote Server API',
-                    version: '1.0.0',
-                    description: 'API documentation for the Promptbook Remote Server',
-                },
-                servers: [
-                    {
-                        url: `http://localhost:${port}${rootPath}`,
-                        // <- TODO: !!!!! Probbably: Pass `remoteServerUrl` instead of `port` and `rootPath`
-                    },
-                ],
+        // TODO: !!!! Expose openapiJson to consumer and also allow to add new routes
+        app.use(OpenApiValidator__namespace.middleware({
+            apiSpec: openapiJson,
+            ignorePaths(path) {
+                return path.startsWith('/api-docs') || path.startsWith('/swagger') || path.startsWith('/openapi');
             },
-            apis: ['./src/remote-server/**/*.ts'], // Adjust path as needed
-        };
-        const swaggerSpec = swaggerJsdoc__default["default"](swaggerOptions);
-        app.use([`/api-docs`, `${rootPath}/api-docs`], swaggerUi__default["default"].serve, swaggerUi__default["default"].setup(swaggerSpec));
+            validateRequests: true,
+            validateResponses: true,
+        }));
+        app.use([`/api-docs`, `/swagger`], swaggerUi__default["default"].serve, swaggerUi__default["default"].setup(openapiJson, {
+        // customCss: '.swagger-ui .topbar { display: none }',
+        // customSiteTitle: 'BRJ API',
+        // customfavIcon: 'https://brj.app/favicon.ico',
+        }));
+        app.get(`/openapi`, (request, response) => {
+            response.json(openapiJson);
+        });
         const runningExecutionTasks = [];
         // <- TODO: [🤬] Identify the users
         // TODO: [🧠] Do here some garbage collection of finished tasks
-        /**
-         * @swagger
-         * /:
-         *   get:
-         *     summary: Get server details
-         *     description: Returns details about the Promptbook server.
-         *     responses:
-         *       200:
-         *         description: Server details in markdown format.
-         */
-        app.get(['/', rootPath], async (request, response) => {
+        app.get('/', async (request, response) => {
             var _a;
             if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.includes('socket.io')) {
                 return;
@@ -13029,8 +13466,6 @@
                     ## Details
 
                     **Server port:** ${port}
-                    **Server root path:** ${rootPath}
-                    **Socket.io path:** ${socketioPath}
                     **Startup date:** ${startupDate.toISOString()}
                     **Anonymouse mode:** ${isAnonymousModeAllowed ? 'enabled' : 'disabled'}
                     **Application mode:** ${isApplicationModeAllowed ? 'enabled' : 'disabled'}
@@ -13069,38 +13504,7 @@
                     https://github.com/webgptorg/promptbook
                 `));
         });
-        /**
-         * @swagger
-         *
-         * /login:
-         *  post:
-         *   summary: Login to the server
-         *   description: Login to the server and get identification.
-         *   requestBody:
-         *    required: true
-         *    content:
-         *     application/json:
-         *      schema:
-         *       type: object
-         *       properties:
-         *        username:
-         *         type: string
-         *        password:
-         *         type: string
-         *        appId:
-         *         type: string
-         *   responses:
-         *    200:
-         *     description: Successful login
-         *     content:
-         *      application/json:
-         *       schema:
-         *        type: object
-         *        properties:
-         *         identification:
-         *          type: object
-         */
-        app.post([`/login`, `${rootPath}/login`], async (request, response) => {
+        app.post(`/login`, async (request, response) => {
             if (!isApplicationModeAllowed || login === null) {
                 response.status(400).send('Application mode is not allowed');
                 return;
@@ -13125,9 +13529,7 @@
                 return;
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 if (error instanceof AuthenticationError) {
                     response.status(401).send({
                         isSuccess: false,
@@ -13142,23 +13544,7 @@
                 response.status(400).send({ error: serializeError(error) });
             }
         });
-        /**
-         * @swagger
-         * /books:
-         *   get:
-         *     summary: List all books
-         *     description: Returns a list of all available books in the collection.
-         *     responses:
-         *       200:
-         *         description: A list of books.
-         *         content:
-         *           application/json:
-         *             schema:
-         *               type: array
-         *               items:
-         *                 type: string
-         */
-        app.get([`/books`, `${rootPath}/books`], async (request, response) => {
+        app.get(`/books`, async (request, response) => {
             if (collection === null) {
                 response.status(500).send('No collection available');
                 return;
@@ -13168,30 +13554,7 @@
             response.send(pipelines);
         });
         // TODO: [🧠] Is it secure / good idea to expose source codes of hosted books
-        /**
-         * @swagger
-         * /books/{bookId}:
-         *   get:
-         *     summary: Get book content
-         *     description: Returns the content of a specific book.
-         *     parameters:
-         *       - in: path
-         *         name: bookId
-         *         required: true
-         *         schema:
-         *           type: string
-         *         description: The ID of the book to retrieve.
-         *     responses:
-         *       200:
-         *         description: The content of the book.
-         *         content:
-         *           text/markdown:
-         *             schema:
-         *               type: string
-         *       404:
-         *         description: Book not found.
-         */
-        app.get([`/books/*`, `${rootPath}/books/*`], async (request, response) => {
+        app.get(`/books/*`, async (request, response) => {
             try {
                 if (collection === null) {
                     response.status(500).send('No collection nor books available');
@@ -13210,9 +13573,7 @@
                     .send(source.content);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 response
                     .status(404)
                     .send({ error: serializeError(error) });
@@ -13245,26 +13606,10 @@
                 };
             }
         }
-        /**
-         * @swagger
-         * /executions:
-         *   get:
-         *     summary: List all executions
-         *     description: Returns a list of all running execution tasks.
-         *     responses:
-         *       200:
-         *         description: A list of execution tasks.
-         *         content:
-         *           application/json:
-         *             schema:
-         *               type: array
-         *               items:
-         *                 type: object
-         */
-        app.get([`/executions`, `${rootPath}/executions`], async (request, response) => {
-            response.send(runningExecutionTasks.map((runningExecutionTask) => exportExecutionTask(runningExecutionTask, false)));
+        app.get(`/executions`, async (request, response) => {
+            response.send(runningExecutionTasks.map((runningExecutionTask) => exportExecutionTask(runningExecutionTask, false)) /* <- TODO: satisfies paths['/executions']['get']['responses']['200']['content']['application/json'] */);
         });
-        app.get([`/executions/last`, `${rootPath}/executions/last`], async (request, response) => {
+        app.get(`/executions/last`, async (request, response) => {
             // TODO: [🤬] Filter only for user
             if (runningExecutionTasks.length === 0) {
                 response.status(404).send('No execution tasks found');
@@ -13273,7 +13618,7 @@
             const lastExecutionTask = runningExecutionTasks[runningExecutionTasks.length - 1];
             response.send(exportExecutionTask(lastExecutionTask, true));
         });
-        app.get([`/executions/:taskId`, `${rootPath}/executions/:taskId`], async (request, response) => {
+        app.get(`/executions/:taskId`, async (request, response) => {
             const { taskId } = request.params;
             // TODO: [🤬] Filter only for user
             const executionTask = runningExecutionTasks.find((executionTask) => executionTask.taskId === taskId);
@@ -13285,39 +13630,12 @@
             }
             response.send(exportExecutionTask(executionTask, true));
         });
-        /**
-         * @swagger
-         * /executions/new:
-         *   post:
-         *     summary: Start a new execution
-         *     description: Starts a new execution task for a given pipeline.
-         *     requestBody:
-         *       required: true
-         *       content:
-         *         application/json:
-         *           schema:
-         *             type: object
-         *             properties:
-         *               pipelineUrl:
-         *                 type: string
-         *               inputParameters:
-         *                 type: object
-         *               identification:
-         *                 type: object
-         *     responses:
-         *       200:
-         *         description: The newly created execution task.
-         *         content:
-         *           application/json:
-         *             schema:
-         *               type: object
-         *       400:
-         *         description: Invalid input.
-         */
-        app.post([`/executions/new`, `${rootPath}/executions/new`], async (request, response) => {
+        app.post(`/executions/new`, async (request, response) => {
             try {
                 const { inputParameters, identification /* <- [🤬] */ } = request.body;
-                const pipelineUrl = request.body.pipelineUrl || request.body.book;
+                const pipelineUrl = request.body
+                    .pipelineUrl /* <- TODO: as paths['/executions/new']['post']['requestBody']['content']['application/json'] */ ||
+                    request.body.book;
                 // TODO: [🧠] Check `pipelineUrl` and `inputParameters` here or it should be responsibility of `collection.getPipelineByUrl` and `pipelineExecutor`
                 const pipeline = await (collection === null || collection === void 0 ? void 0 : collection.getPipelineByUrl(pipelineUrl));
                 if (pipeline === undefined) {
@@ -13331,7 +13649,7 @@
                 await waitasecond.forTime(10);
                 // <- Note: Wait for a while to wait for quick responses or sudden but asynchronous errors
                 // <- TODO: Put this into configuration
-                response.send(executionTask);
+                response.send(executionTask /* <- TODO: satisfies paths['/executions/new']['post']['responses']['200']['content']['application/json'] */);
                 /*/
                 executionTask.asObservable().subscribe({
                     next(partialResult) {
@@ -13351,19 +13669,24 @@
                 */
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 response.status(400).send({ error: serializeError(error) });
             }
         });
+        /**
+         * Catch-all handler for unmatched routes
+         */
+        app.use((request, response) => {
+            response.status(404).send(`URL "${request.originalUrl}" was not found on Promptbook server.`);
+        });
         const httpServer = http__default["default"].createServer(app);
         const server = new socket_io.Server(httpServer, {
-            path: socketioPath,
-            transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+            path: '/socket.io',
+            transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
             cors: {
                 origin: '*',
                 methods: ['GET', 'POST'],
+                // <- TODO: [🌡] Allow to pass
             },
         });
         server.on('connection', (socket) => {
@@ -13417,9 +13740,7 @@
                     socket.emit('prompt-response', { promptResult } /* <- Note: [🤛] */);
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     socket.emit('error', serializeError(error) /* <- Note: [🤛] */);
                 }
                 finally {
@@ -13441,9 +13762,7 @@
                     socket.emit('listModels-response', { models } /* <- Note: [🤛] */);
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     socket.emit('error', serializeError(error));
                 }
                 finally {
@@ -13464,9 +13783,7 @@
                     socket.emit('preparePipeline-response', { preparedPipeline } /* <- Note: [🤛] */);
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     socket.emit('error', serializeError(error));
                     // <- TODO: [🚋] There is a problem with the remote server handling errors and sending them back to the client
                 }
@@ -13514,8 +13831,7 @@
         };
     }
     /**
-     * TODO: !! Add CORS and security - probbably via `helmet`
-     * TODO: [👩🏾‍🤝‍🧑🏾] Allow to pass custom fetch function here - PromptbookFetch
+     * TODO: [🌡] Add CORS and security - probbably via `helmet`
      * TODO: Split this file into multiple functions - handler for each request
      * TODO: Maybe use `$exportJson`
      * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
@@ -13574,9 +13890,9 @@
             if (url !== null) {
                 rootUrl = suffixUrl(url, '/books');
             }
-            let rootPath = '/';
-            if (url !== null) {
-                rootPath = url.pathname;
+            if (url !== null && url.pathname !== '/' && url.pathname !== '') {
+                console.error(colors__default["default"].red(`URL of the server can not have path, but got "${url.pathname}"`));
+                process.exit(1);
             }
             // TODO: DRY [◽]
             const prepareAndScrapeOptions = {
@@ -13584,7 +13900,7 @@
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+            const { /* [0] strategy,*/ llm } = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
             const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
             const tools = {
                 llm,
@@ -13603,7 +13919,6 @@
             });
             // console.log(path, await collection.listPipelines());
             const server = startRemoteServer({
-                rootPath,
                 port,
                 isAnonymousModeAllowed,
                 isApplicationModeAllowed: true,
@@ -13616,6 +13931,7 @@
                     TODO_USE({ appId, userId });
                     return llm;
                 },
+                // <- TODO: [🧠][0] Maybe pass here strategy
             });
             keepUnused(server);
             // Note: Already logged by `startRemoteServer`
@@ -13657,7 +13973,7 @@
                     isCacheReloaded,
                 }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
                 const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+                const { llm } = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
                 const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
                 tools = {
                     llm,
@@ -13696,9 +14012,7 @@
                     }
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     console.info(colors__default["default"].red(`Pipeline is not valid ${filename}`));
                     console.error(colors__default["default"].bgRed(`${error.name} in ${path.basename(__filename)}`));
                     console.error(colors__default["default"].red(error.stack || error.message));
@@ -13922,7 +14236,25 @@
                     output: computeUsage(`$2.40 / 1M tokens`),
                 },
             },
-            // TODO: [main] !!3 Claude 1 and 2 has also completion versions - ask Hoagy
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Claude 3.7 Sonnet',
+                modelName: 'claude-3-7-sonnet-20250219',
+                pricing: {
+                    prompt: computeUsage(`$3.00 / 1M tokens`),
+                    output: computeUsage(`$15.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Claude 3.5 Haiku',
+                modelName: 'claude-3-5-haiku-20241022',
+                pricing: {
+                    prompt: computeUsage(`$0.25 / 1M tokens`),
+                    output: computeUsage(`$1.25 / 1M tokens`),
+                },
+            },
+            // <- [🕕]
         ],
     });
     /**
@@ -14687,7 +15019,6 @@
                     prompt: computeUsage(`$5.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
                 },
-                //TODO: [main] !!3 Add gpt-4o-mini-2024-07-18 and all others to be up to date
             },
             /**/
             /**/
@@ -14702,6 +15033,17 @@
             },
             /**/
             /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o-mini',
+                modelName: 'gpt-4o-mini',
+                pricing: {
+                    prompt: computeUsage(`$3.00 / 1M tokens`),
+                    output: computeUsage(`$9.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
             {
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-preview',
@@ -14781,6 +15123,7 @@
                 },
             },
             /**/
+            // <- [🕕]
         ],
     });
     /**
@@ -15349,11 +15692,17 @@
             description: 'Implementation of Deepseek models',
             vercelProvider: deepseekVercelProvider,
             availableModels: [
-                // TODO: [🕘] Maybe list models in same way as in other providers - in separate file with metadata
-                'deepseek-chat',
-                'deepseek-reasoner',
+                {
+                    modelName: 'deepseek-chat',
+                    modelVariant: 'CHAT',
+                },
+                {
+                    modelName: 'deepseek-reasoner',
+                    modelVariant: 'CHAT',
+                },
+                // <- [🕕]
                 // <- TODO: How picking of the default model looks like in `createExecutionToolsFromVercelProvider`
-            ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
+            ],
             ...options,
         });
     }, {
@@ -15451,6 +15800,10 @@
             vercelProvider: googleGeminiVercelProvider,
             availableModels: [
                 // TODO: [🕘] Maybe list models in same way as in other providers - in separate file with metadata
+                'gemini-2.5-pro-preview-03-25',
+                'gemini-2.0-flash',
+                'gemini-2.0-flash-lite',
+                'gemini-2.0-flash-thinking-exp-01-21',
                 'gemini-1.5-flash',
                 'gemini-1.5-flash-latest',
                 'gemini-1.5-flash-001',
@@ -15466,6 +15819,7 @@
                 'gemini-1.5-pro-002',
                 'gemini-1.5-pro-exp-0827',
                 'gemini-1.0-pro',
+                // <- [🕕]
             ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
             ...options,
         });
@@ -15745,6 +16099,7 @@
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
             const rawResponse = await client.chat.completions.create(rawRequest).catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -15821,6 +16176,7 @@
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
             const rawResponse = await client.completions.create(rawRequest).catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -15884,6 +16240,7 @@
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
             const rawResponse = await client.embeddings.create(rawRequest).catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }