@promptbook/cli 0.89.0-9 → 0.92.0-10

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('bottleneck'), 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', 'bottleneck', '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.Bottleneck, 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, Bottleneck, OpenAI, readability, jsdom, showdown) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -28,18 +28,19 @@
     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 Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
@@ -56,12 +57,43 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.92.0-10';
     /**
      * 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 +148,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 +179,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 +205,7 @@
         infinity: '(infinity; ∞)',
         negativeInfinity: '(negative infinity; -∞)',
         unserializable: '(unserializable value)',
+        circular: '(circular JSON)',
     };
     /**
      * Small number limit
@@ -225,7 +265,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 +321,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 +459,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 +589,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 +696,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);
-        }
-    }
-
     /**
      * @@@
      *
@@ -929,6 +1015,79 @@
         keepUnused(...sideEffectSubjects);
     }
 
+    /**
+     * Converts a JavaScript Object Notation (JSON) string into an object.
+     *
+     * Note: This is wrapper around `JSON.parse()` with better error and type handling
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function jsonParse(value) {
+        if (value === undefined) {
+            throw new Error(`Can not parse JSON from undefined value.`);
+        }
+        else if (typeof value !== 'string') {
+            console.error('Can not parse JSON from non-string value.', { text: value });
+            throw new Error(spaceTrim__default["default"](`
+                    Can not parse JSON from non-string value.
+
+                    The value type: ${typeof value}
+                    See more in console.
+                `));
+        }
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            throw new Error(spaceTrim__default["default"]((block) => `
+                    ${block(error.message)}
+            
+                    The JSON text:
+                    ${block(value)}
+                `));
+        }
+    }
+    /**
+     * TODO: !!!! Use in Promptbook.studio
+     */
+
+    /**
+     * 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.
@@ -942,27 +1101,199 @@
     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');
+    /**
+     * @@@
+     *
+     * @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
+     */
+
+    /**
+     * Stores data in .env variables
+     *
+     * 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`
+     *
+     * @private within the repository - for CLI utils
+     */
+    class $EnvStorage {
+        constructor() {
+            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() {
+            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() {
+            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.
+         */
+        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) {
+            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.
+         */
+        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) {
+            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
      */
 
     /**
@@ -1098,9 +1429,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
 
@@ -1333,31 +1662,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
      *
@@ -1831,7 +2135,7 @@
                 return null;
             }
             const fileContent = await promises.readFile(filename, 'utf-8');
-            const value = JSON.parse(fileContent);
+            const value = jsonParse(fileContent);
             // TODO: [🌗]
             return value;
         }
@@ -1863,53 +2167,6 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
-    /**
-     * 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];
-        }
-    }
-
     /**
      * This error indicates problems parsing the format value
      *
@@ -2086,7 +2343,7 @@
         }
     }
     /**
-     * TODO: !!!!!! Add id to all errors
+     * TODO: [🧠][🌂] Add id to all errors
      */
 
     /**
@@ -2148,7 +2405,10 @@
         PipelineExecutionError,
         PipelineLogicError,
         PipelineUrlError,
+        AuthenticationError,
+        PromptbookFetchError,
         UnexpectedError,
+        WrappedError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -2165,8 +2425,6 @@
         TypeError,
         URIError,
         AggregateError,
-        AuthenticationError,
-        PromptbookFetchError,
         /*
       Note: Not widely supported
       > InternalError,
@@ -2224,17 +2482,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', () => {
@@ -2359,6 +2631,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()`
      *
@@ -2645,74 +2964,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
-     */
-
-    /**
-     * 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 $provideEnvFilepath() {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$provideEnvFilepath` 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
-     */
-
     /**
      * @@@
      *
      * @@@ .env
-     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access .env file
+     * 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`
@@ -2726,7 +2982,7 @@
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
         }
-        const envFilepath = await $provideEnvFilepath();
+        const envFilepath = await $provideEnvFilename();
         if (envFilepath !== null) {
             dotenv__namespace.config({ path: envFilepath });
         }
@@ -2834,14 +3090,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(
@@ -2988,7 +3245,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
+     * 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`
@@ -3033,7 +3290,7 @@
     /**
      * 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
+     * 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
      */
@@ -3042,18 +3299,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;
-            // TODO: !!!
-            // const envFilepath = await $provideEnvFilepath();
-            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,
@@ -3094,9 +3360,7 @@
             return await fetch(urlOrRequest, init);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             let url;
             if (typeof urlOrRequest === 'string') {
                 url = urlOrRequest;
@@ -3135,8 +3399,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)) {
@@ -3150,7 +3414,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)) {
@@ -3158,7 +3426,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,
@@ -3168,6 +3437,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',
@@ -3185,7 +3458,6 @@
                         },
                     ]);
                     const loginUrl = `${remoteServerUrl}/login`;
-                    console.log('!!!', { loginUrl });
                     // TODO: [🧠] Should we use normal `fetch` or `scraperFetch`
                     const response = await promptbookFetch(loginUrl, {
                         method: 'POST',
@@ -3198,20 +3470,7 @@
                             password,
                         }),
                     });
-                    console.log('!!!', {
-                        loginUrl,
-                        username,
-                        password,
-                        // type: response.type,
-                        // text: await response.text(),
-                    });
-                    const { isSuccess, message, error, identification } = (await response.json());
-                    console.log('!!!', {
-                        isSuccess,
-                        message,
-                        error,
-                        identification,
-                    });
+                    const { isSuccess, message, error, identification } = jsonParse(await response.text());
                     if (message) {
                         if (isSuccess) {
                             console.log(colors__default["default"].green(message));
@@ -3232,6 +3491,7 @@
                     return identification;
                 },
             });
+            return { strategy, llm };
         }
         else {
             throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
@@ -3253,11 +3513,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);
         }));
@@ -3440,9 +3701,7 @@
             return result.trim();
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3497,9 +3756,7 @@
             return result.trim() + toExec;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3530,9 +3787,7 @@
             throw new Error(`Can not locate app ${appName} on Windows.`);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return null;
         }
     }
@@ -3791,6 +4046,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) => `
@@ -3826,42 +4082,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`
@@ -4267,7 +4501,7 @@
         if (!indexFile) {
             throw new UnexpectedError(`Archive does not contain 'index.book.json' file`);
         }
-        const collectionJson = JSON.parse(await indexFile.async('text'));
+        const collectionJson = jsonParse(await indexFile.async('text'));
         for (const pipeline of collectionJson) {
             validatePipeline(pipeline);
         }
@@ -4277,11 +4511,14 @@
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModelNames}` List of available model names separated by comma (,)\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n\\`\\`\\`json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
     /**
      * 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 /* <- [👨‍⚖️] */) {
@@ -4290,9 +4527,7 @@
             return true;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             if (error.message.includes('Unexpected token')) {
                 return false;
             }
@@ -4537,7 +4772,7 @@
      */
     function unpreparePipeline(pipeline) {
         let { personas, knowledgeSources, tasks } = pipeline;
-        personas = personas.map((persona) => ({ ...persona, modelRequirements: undefined, preparationIds: undefined }));
+        personas = personas.map((persona) => ({ ...persona, modelsRequirements: undefined, preparationIds: undefined }));
         knowledgeSources = knowledgeSources.map((knowledgeSource) => ({ ...knowledgeSource, preparationIds: undefined }));
         tasks = tasks.map((task) => {
             let { dependentParameterNames } = task;
@@ -4695,7 +4930,7 @@
         if (pipeline.title === undefined || pipeline.title === '' || pipeline.title === DEFAULT_BOOK_TITLE) {
             return false;
         }
-        if (!pipeline.personas.every((persona) => persona.modelRequirements !== undefined)) {
+        if (!pipeline.personas.every((persona) => persona.modelsRequirements !== undefined)) {
             return false;
         }
         if (!pipeline.knowledgeSources.every((knowledgeSource) => knowledgeSource.preparationIds !== undefined)) {
@@ -4737,7 +4972,7 @@
         const newObject = { ...object };
         for (const [key, value] of Object.entries(object)) {
             if (typeof value === 'string' && isValidJsonString(value)) {
-                newObject[key] = JSON.parse(value);
+                newObject[key] = jsonParse(value);
             }
             else {
                 newObject[key] = jsonStringsToJsons(value);
@@ -4823,8 +5058,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);
@@ -4834,6 +5069,7 @@
                     partialResultSubject.next(executionResult);
                 }
                 catch (error) {
+                    assertsError(error);
                     status = 'ERROR';
                     errors.push(error);
                     partialResultSubject.error(error);
@@ -4979,13 +5215,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;
         }
@@ -5042,9 +5284,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)}
@@ -5163,6 +5403,46 @@
         // 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;
+        }
+    }
+
+    /**
+     * Converts a CSV string into an object
+     *
+     * Note: This is wrapper around `papaparse.parse()` with better autohealing
+     *
+     * @private - for now until `@promptbook/csv` is released
+     */
+    function csvParse(value /* <- TODO: string_csv */, settings, schema /* <- TODO: Make CSV Schemas */) {
+        settings = { ...settings, ...MANDATORY_CSV_SETTINGS };
+        // Note: Autoheal invalid '\n' characters
+        if (settings.newline && !settings.newline.includes('\r') && value.includes('\r')) {
+            console.warn('CSV string contains carriage return characters, but in the CSV settings the `newline` setting does not include them. Autohealing the CSV string.');
+            value = value.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+        }
+        const csv = papaparse.parse(value, settings);
+        return csv;
+    }
+
     /**
      * Definition for CSV spreadsheet
      *
@@ -5173,7 +5453,7 @@
         formatName: 'CSV',
         aliases: ['SPREADSHEET', 'TABLE'],
         isValid(value, settings, schema) {
-            return true;
+            return isValidCsvString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -5185,8 +5465,7 @@
             {
                 subvalueName: 'ROW',
                 async mapValues(value, outputParameterName, settings, mapCallback) {
-                    // TODO: [👨🏾‍🤝‍👨🏼] DRY csv parsing
-                    const csv = papaparse.parse(value, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                    const csv = csvParse(value, settings);
                     if (csv.errors.length !== 0) {
                         throw new CsvFormatError(spaceTrim__default["default"]((block) => `
                                 CSV parsing error
@@ -5216,8 +5495,7 @@
             {
                 subvalueName: 'CELL',
                 async mapValues(value, outputParameterName, settings, mapCallback) {
-                    // TODO: [👨🏾‍🤝‍👨🏼] DRY csv parsing
-                    const csv = papaparse.parse(value, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                    const csv = csvParse(value, settings);
                     if (csv.errors.length !== 0) {
                         throw new CsvFormatError(spaceTrim__default["default"]((block) => `
                                 CSV parsing error
@@ -5327,6 +5605,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
      *
@@ -5336,7 +5638,7 @@
         formatName: 'XML',
         mimeType: 'application/xml',
         isValid(value, settings, schema) {
-            return true;
+            return isValidXmlString(value);
         },
         canBeValid(partialValue, settings, schema) {
             return true;
@@ -5928,9 +6230,7 @@
                                     break scripts;
                                 }
                                 catch (error) {
-                                    if (!(error instanceof Error)) {
-                                        throw error;
-                                    }
+                                    assertsError(error);
                                     if (error instanceof UnexpectedError) {
                                         throw error;
                                     }
@@ -6000,9 +6300,7 @@
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -6245,13 +6543,79 @@
     /**
      * @@@
      *
+     * Here is the place where RAG (retrieval-augmented generation) happens
+     *
      * @private internal utility of `createPipelineExecutor`
      */
     async function getKnowledgeForTask(options) {
-        const { preparedPipeline, task } = options;
-        return preparedPipeline.knowledgePieces.map(({ content }) => `- ${content}`).join('\n');
+        const { tools, preparedPipeline, task } = options;
+        const firstKnowlegePiece = preparedPipeline.knowledgePieces[0];
+        const firstKnowlegeIndex = firstKnowlegePiece === null || firstKnowlegePiece === void 0 ? void 0 : firstKnowlegePiece.index[0];
+        // <- TODO: Do not use just first knowledge piece and first index to determine embedding model, use also keyword search
+        if (firstKnowlegePiece === undefined || firstKnowlegeIndex === undefined) {
+            return 'No knowledge pieces found';
+        }
+        // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
+        const _llms = arrayableToArray(tools.llm);
+        const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
+        const taskEmbeddingPrompt = {
+            title: 'Knowledge Search',
+            modelRequirements: {
+                modelVariant: 'EMBEDDING',
+                modelName: firstKnowlegeIndex.modelName,
+            },
+            content: task.content,
+            parameters: {
+            /* !!!!!!!! */
+            },
+        };
+        const taskEmbeddingResult = await llmTools.callEmbeddingModel(taskEmbeddingPrompt);
+        const knowledgePiecesWithRelevance = preparedPipeline.knowledgePieces.map((knowledgePiece) => {
+            const { index } = knowledgePiece;
+            const knowledgePieceIndex = index.find((i) => i.modelName === firstKnowlegeIndex.modelName);
+            // <- TODO: Do not use just first knowledge piece and first index to determine embedding model
+            if (knowledgePieceIndex === undefined) {
+                return {
+                    content: knowledgePiece.content,
+                    relevance: 0,
+                };
+            }
+            const relevance = computeCosineSimilarity(knowledgePieceIndex.position, taskEmbeddingResult.content);
+            return {
+                content: knowledgePiece.content,
+                relevance,
+            };
+        });
+        const knowledgePiecesSorted = knowledgePiecesWithRelevance.sort((a, b) => a.relevance - b.relevance);
+        const knowledgePiecesLimited = knowledgePiecesSorted.slice(0, 5);
+        console.log('!!! Embedding', {
+            task,
+            taskEmbeddingPrompt,
+            taskEmbeddingResult,
+            firstKnowlegePiece,
+            firstKnowlegeIndex,
+            knowledgePiecesWithRelevance,
+            knowledgePiecesSorted,
+            knowledgePiecesLimited,
+        });
+        return knowledgePiecesLimited.map(({ content }) => `- ${content}`).join('\n');
         //                                                      <- TODO: [🧠] Some smart aggregation of knowledge pieces, single-line vs multi-line vs mixed
     }
+    // TODO: !!!!!! Annotate + to new file
+    function computeCosineSimilarity(embeddingVector1, embeddingVector2) {
+        if (embeddingVector1.length !== embeddingVector2.length) {
+            throw new TypeError('Embedding vectors must have the same length');
+        }
+        const dotProduct = embeddingVector1.reduce((sum, value, index) => sum + value * embeddingVector2[index], 0);
+        const magnitude1 = Math.sqrt(embeddingVector1.reduce((sum, value) => sum + value * value, 0));
+        const magnitude2 = Math.sqrt(embeddingVector2.reduce((sum, value) => sum + value * value, 0));
+        return 1 - dotProduct / (magnitude1 * magnitude2);
+    }
+    /**
+     * TODO: !!!! Verify if this is working
+     * TODO: [♨] Implement Better - use keyword search
+     * TODO: [♨] Examples of values
+     */
 
     /**
      * @@@
@@ -6259,9 +6623,9 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function getReservedParametersForTask(options) {
-        const { preparedPipeline, task, pipelineIdentification } = options;
+        const { tools, preparedPipeline, task, pipelineIdentification } = options;
         const context = await getContextForTask(); // <- [🏍]
-        const knowledge = await getKnowledgeForTask({ preparedPipeline, task });
+        const knowledge = await getKnowledgeForTask({ tools, preparedPipeline, task });
         const examples = await getExamplesForTask();
         const currentDate = new Date().toISOString(); // <- TODO: [🧠][💩] Better
         const modelName = RESERVED_PARAMETER_MISSING_VALUE;
@@ -6323,6 +6687,7 @@
         }
         const definedParameters = Object.freeze({
             ...(await getReservedParametersForTask({
+                tools,
                 preparedPipeline,
                 task: currentTask,
                 pipelineIdentification,
@@ -6623,9 +6988,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 [🤹‍♂️]
@@ -6810,27 +7173,48 @@
             pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book'),
             tools,
         });
-        // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
         const _llms = arrayableToArray(tools.llm);
         const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
-        const availableModels = await llmTools.listModels();
-        const availableModelNames = availableModels
+        const availableModels = (await llmTools.listModels())
             .filter(({ modelVariant }) => modelVariant === 'CHAT')
-            .map(({ modelName }) => modelName)
-            .join(',');
-        const result = await preparePersonaExecutor({ availableModelNames, personaDescription }).asPromise();
+            .map(({ modelName, modelDescription }) => ({
+            modelName,
+            modelDescription,
+            // <- Note: `modelTitle` and `modelVariant` is not relevant for this task
+        }));
+        const result = await preparePersonaExecutor({
+            availableModels /* <- Note: Passing as JSON */,
+            personaDescription,
+        }).asPromise();
         const { outputParameters } = result;
-        const { modelRequirements: modelRequirementsRaw } = outputParameters;
-        const modelRequirements = JSON.parse(modelRequirementsRaw);
+        const { modelsRequirements: modelsRequirementsJson } = outputParameters;
+        let modelsRequirementsUnchecked = jsonParse(modelsRequirementsJson);
         if (isVerbose) {
-            console.info(`PERSONA ${personaDescription}`, modelRequirements);
+            console.info(`PERSONA ${personaDescription}`, modelsRequirementsUnchecked);
         }
-        const { modelName, systemMessage, temperature } = modelRequirements;
-        return {
+        if (!Array.isArray(modelsRequirementsUnchecked)) {
+            // <- TODO: Book should have syntax and system to enforce shape of JSON
+            modelsRequirementsUnchecked = [modelsRequirementsUnchecked];
+            /*
+            throw new UnexpectedError(
+                spaceTrim(
+                    (block) => `
+                        Invalid \`modelsRequirements\`:
+
+                        \`\`\`json
+                        ${block(JSON.stringify(modelsRequirementsUnchecked, null, 4))}
+                        \`\`\`
+                    `,
+                ),
+            );
+            */
+        }
+        const modelsRequirements = modelsRequirementsUnchecked.map((modelRequirements) => ({
             modelVariant: 'CHAT',
-            modelName,
-            systemMessage,
-            temperature,
+            ...modelRequirements,
+        }));
+        return {
+            modelsRequirements,
         };
     }
     /**
@@ -6999,7 +7383,7 @@
                     > },
                 */
                 async asJson() {
-                    return JSON.parse(await tools.fs.readFile(filename, 'utf-8'));
+                    return jsonParse(await tools.fs.readFile(filename, 'utf-8'));
                 },
                 async asText() {
                     return await tools.fs.readFile(filename, 'utf-8');
@@ -7101,9 +7485,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
             }
@@ -7259,14 +7641,14 @@
         // TODO: [🖌][🧠] Implement some `mapAsync` function
         const preparedPersonas = new Array(personas.length);
         await forEachAsync(personas, { maxParallelCount /* <- TODO: [🪂] When there are subtasks, this maximul limit can be broken */ }, async (persona, index) => {
-            const modelRequirements = await preparePersona(persona.description, { ...tools, llm: llmToolsWithUsage }, {
+            const { modelsRequirements } = await preparePersona(persona.description, { ...tools, llm: llmToolsWithUsage }, {
                 rootDirname,
                 maxParallelCount /* <- TODO:  [🪂] */,
                 isVerbose,
             });
             const preparedPersona = {
                 ...persona,
-                modelRequirements,
+                modelsRequirements,
                 preparationIds: [/* TODO: [🧊] -> */ currentPreparation.id],
                 // <- TODO: [🍙] Make some standard order of json properties
             };
@@ -7901,6 +8283,8 @@
      */
 
     /**
+    import { WrappedError } from '../../errors/WrappedError';
+    import { assertsError } from '../../errors/assertsError';
      * Parses the expect command
      *
      * @see `documentationUrl` for more details
@@ -7992,9 +8376,7 @@
                 };
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 throw new ParseError(spaceTrim__default["default"]((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
@@ -11242,9 +11624,7 @@
                 }
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 if (error instanceof ReferenceError) {
                     const undefinedName = error.message.split(' ')[0];
                     /*
@@ -11519,9 +11899,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('/')}⁠:
@@ -11612,9 +11990,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('/')}⁠:
@@ -11830,7 +12206,7 @@
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForCli({
+            const { llm } = await $provideLlmToolsForCli({
                 cliOptions,
                 ...prepareAndScrapeOptions,
             });
@@ -12123,9 +12499,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));
@@ -12445,9 +12819,7 @@
             return true;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             return false;
         }
     }
@@ -12672,9 +13044,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);
@@ -12707,7 +13077,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'.`));
@@ -12719,7 +13088,7 @@
             }
             let inputParameters = {};
             if (json) {
-                inputParameters = JSON.parse(json);
+                inputParameters = jsonParse(json);
                 //                <- TODO: Maybe check shape of passed JSON and if its valid parameters Record
             }
             // TODO: DRY [◽]
@@ -12733,12 +13102,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;
                 }
@@ -12936,12 +13303,610 @@
         }));
     }
     /**
-     * TODO: !!5 Catch and wrap all errors from CLI
-     * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
-     * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
+     * TODO: !!5 Catch and wrap all errors from CLI
+     * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
+     * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+     * 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 YML)',
+            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.',
+                            content: {
+                                'text/markdown': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/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: {
+                        '201': {
+                            description: 'Successful login',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            isSuccess: {
+                                                type: 'boolean',
+                                            },
+                                            message: {
+                                                type: 'string',
+                                            },
+                                            error: {
+                                                type: 'object',
+                                            },
+                                            identification: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '400': {
+                            description: 'Bad request or login failed',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            error: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '401': {
+                            description: 'Authentication error',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            isSuccess: {
+                                                type: 'boolean',
+                                                enum: [false],
+                                            },
+                                            message: {
+                                                type: 'string',
+                                            },
+                                            error: {
+                                                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',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '500': {
+                            description: 'No collection available',
+                            content: {
+                                'text/plain': {
+                                    schema: {
+                                        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.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            error: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '500': {
+                            description: 'No collection available',
+                            content: {
+                                'text/plain': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/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',
+                                            properties: {
+                                                nonce: {
+                                                    type: 'string',
+                                                },
+                                                taskId: {
+                                                    type: 'string',
+                                                },
+                                                taskType: {
+                                                    type: 'string',
+                                                },
+                                                status: {
+                                                    type: 'string',
+                                                },
+                                                createdAt: {
+                                                    type: 'string',
+                                                    format: 'date-time',
+                                                },
+                                                updatedAt: {
+                                                    type: 'string',
+                                                    format: 'date-time',
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/executions/last': {
+                get: {
+                    summary: 'Get the last execution',
+                    description: 'Returns details of the last execution task.',
+                    responses: {
+                        '200': {
+                            description: 'The last execution task with full details.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            nonce: {
+                                                type: 'string',
+                                            },
+                                            taskId: {
+                                                type: 'string',
+                                            },
+                                            taskType: {
+                                                type: 'string',
+                                            },
+                                            status: {
+                                                type: 'string',
+                                            },
+                                            errors: {
+                                                type: 'array',
+                                                items: {
+                                                    type: 'object',
+                                                },
+                                            },
+                                            warnings: {
+                                                type: 'array',
+                                                items: {
+                                                    type: 'object',
+                                                },
+                                            },
+                                            createdAt: {
+                                                type: 'string',
+                                                format: 'date-time',
+                                            },
+                                            updatedAt: {
+                                                type: 'string',
+                                                format: 'date-time',
+                                            },
+                                            currentValue: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '404': {
+                            description: 'No execution tasks found.',
+                            content: {
+                                'text/plain': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/executions/{taskId}': {
+                get: {
+                    summary: 'Get specific execution',
+                    description: 'Returns details of a specific execution task.',
+                    parameters: [
+                        {
+                            in: 'path',
+                            name: 'taskId',
+                            required: true,
+                            schema: {
+                                type: 'string',
+                            },
+                            description: 'The ID of the execution task to retrieve.',
+                        },
+                    ],
+                    responses: {
+                        '200': {
+                            description: 'The execution task with full details.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            nonce: {
+                                                type: 'string',
+                                            },
+                                            taskId: {
+                                                type: 'string',
+                                            },
+                                            taskType: {
+                                                type: 'string',
+                                            },
+                                            status: {
+                                                type: 'string',
+                                            },
+                                            errors: {
+                                                type: 'array',
+                                                items: {
+                                                    type: 'object',
+                                                },
+                                            },
+                                            warnings: {
+                                                type: 'array',
+                                                items: {
+                                                    type: 'object',
+                                                },
+                                            },
+                                            createdAt: {
+                                                type: 'string',
+                                                format: 'date-time',
+                                            },
+                                            updatedAt: {
+                                                type: 'string',
+                                                format: 'date-time',
+                                            },
+                                            currentValue: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '404': {
+                            description: 'Execution task not found.',
+                            content: {
+                                'text/plain': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/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',
+                                            description: 'URL of the pipeline to execute',
+                                        },
+                                        book: {
+                                            type: 'string',
+                                            description: 'Alternative field for pipelineUrl',
+                                        },
+                                        inputParameters: {
+                                            type: 'object',
+                                            description: 'Parameters for pipeline execution',
+                                        },
+                                        identification: {
+                                            type: 'object',
+                                            description: 'User identification data',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        '200': {
+                            description: 'The newly created execution task.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                    },
+                                },
+                            },
+                        },
+                        '400': {
+                            description: 'Invalid input.',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                        properties: {
+                                            error: {
+                                                type: 'object',
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        '404': {
+                            description: 'Pipeline not found.',
+                            content: {
+                                'text/plain': {
+                                    schema: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/api-docs': {
+                get: {
+                    summary: 'API documentation UI',
+                    description: 'Swagger UI for API documentation',
+                    responses: {
+                        '200': {
+                            description: 'HTML Swagger UI',
+                        },
+                    },
+                },
+            },
+            '/swagger': {
+                get: {
+                    summary: 'API documentation UI (alternative path)',
+                    description: 'Swagger UI for API documentation',
+                    responses: {
+                        '200': {
+                            description: 'HTML Swagger UI',
+                        },
+                    },
+                },
+            },
+            '/openapi': {
+                get: {
+                    summary: 'OpenAPI specification',
+                    description: 'Returns the OpenAPI JSON specification',
+                    responses: {
+                        '200': {
+                            description: 'OpenAPI specification',
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        type: 'object',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        components: {
+            schemas: {
+                Error: {
+                    type: 'object',
+                    properties: {
+                        error: {
+                            type: 'object',
+                        },
+                    },
+                },
+                ExecutionTaskSummary: {
+                    type: 'object',
+                    properties: {
+                        nonce: {
+                            type: 'string',
+                        },
+                        taskId: {
+                            type: 'string',
+                        },
+                        taskType: {
+                            type: 'string',
+                        },
+                        status: {
+                            type: 'string',
+                        },
+                        createdAt: {
+                            type: 'string',
+                            format: 'date-time',
+                        },
+                        updatedAt: {
+                            type: 'string',
+                            format: 'date-time',
+                        },
+                    },
+                },
+                ExecutionTaskFull: {
+                    type: 'object',
+                    properties: {
+                        nonce: {
+                            type: 'string',
+                        },
+                        taskId: {
+                            type: 'string',
+                        },
+                        taskType: {
+                            type: 'string',
+                        },
+                        status: {
+                            type: 'string',
+                        },
+                        errors: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                            },
+                        },
+                        warnings: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                            },
+                        },
+                        createdAt: {
+                            type: 'string',
+                            format: 'date-time',
+                        },
+                        updatedAt: {
+                            type: 'string',
+                            format: 'date-time',
+                        },
+                        currentValue: {
+                            type: 'object',
+                        },
+                    },
+                },
+            },
+        },
+        tags: [
+            {
+                name: 'Books',
+                description: 'Operations related to books and pipelines',
+            },
+            {
+                name: 'Executions',
+                description: 'Operations related to execution tasks',
+            },
+            {
+                name: 'Authentication',
+                description: 'Authentication operations',
+            },
+        ],
+    };
+    /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
-     * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
-     * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
      */
 
     /**
@@ -12954,7 +13919,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,
@@ -12962,22 +13927,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) {
@@ -13000,23 +13949,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;
         }
@@ -13026,39 +13977,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;
@@ -13077,8 +14016,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'}
@@ -13117,38 +14054,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;
@@ -13173,9 +14079,7 @@
                 return;
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 if (error instanceof AuthenticationError) {
                     response.status(401).send({
                         isSuccess: false,
@@ -13190,23 +14094,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;
@@ -13216,30 +14104,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');
@@ -13258,9 +14123,7 @@
                     .send(source.content);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 response
                     .status(404)
                     .send({ error: serializeError(error) });
@@ -13293,26 +14156,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');
@@ -13321,7 +14168,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);
@@ -13333,39 +14180,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) {
@@ -13379,7 +14199,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) {
@@ -13399,19 +14219,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) => {
@@ -13465,9 +14290,7 @@
                     socket.emit('prompt-response', { promptResult } /* <- Note: [🤛] */);
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     socket.emit('error', serializeError(error) /* <- Note: [🤛] */);
                 }
                 finally {
@@ -13489,9 +14312,7 @@
                     socket.emit('listModels-response', { models } /* <- Note: [🤛] */);
                 }
                 catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
+                    assertsError(error);
                     socket.emit('error', serializeError(error));
                 }
                 finally {
@@ -13512,9 +14333,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
                 }
@@ -13562,8 +14381,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'`
@@ -13622,9 +14440,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 = {
@@ -13632,7 +14450,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,
@@ -13651,7 +14469,6 @@
             });
             // console.log(path, await collection.listPipelines());
             const server = startRemoteServer({
-                rootPath,
                 port,
                 isAnonymousModeAllowed,
                 isApplicationModeAllowed: true,
@@ -13664,6 +14481,7 @@
                     TODO_USE({ appId, userId });
                     return llm;
                 },
+                // <- TODO: [🧠][0] Maybe pass here strategy
             });
             keepUnused(server);
             // Note: Already logged by `startRemoteServer`
@@ -13705,7 +14523,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,
@@ -13730,7 +14548,7 @@
                         }
                     }
                     if (filename.endsWith('.bookc')) {
-                        pipeline = JSON.parse(await promises.readFile(filename, 'utf-8'));
+                        pipeline = jsonParse(await promises.readFile(filename, 'utf-8'));
                     }
                     else {
                         if (isVerbose) {
@@ -13744,9 +14562,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));
@@ -13841,6 +14657,37 @@
      * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
      */
 
+    /**
+     * How is the model provider trusted?
+     *
+     * @public exported from `@promptbook/core`
+     */
+    // <- TODO: Maybe do better levels of trust
+    /**
+     * How is the model provider important?
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const MODEL_ORDER = {
+        /**
+         * Top-tier models, e.g. OpenAI, Anthropic,...
+         */
+        TOP_TIER: 333,
+        /**
+         * Mid-tier models, e.g. Llama, Mistral, etc.
+         */
+        NORMAL: 100,
+        /**
+         * Low-tier models, e.g. Phi, Tiny, etc.
+         */
+        LOW_TIER: 0,
+    };
+    /**
+     * TODO: Add configuration schema and maybe some documentation link
+     * TODO: Maybe constrain LlmToolsConfiguration[number] by generic to ensure that `createConfigurationFromEnv` and `getBoilerplateConfiguration` always create same `packageName` and `className`
+     * TODO: [®] DRY Register logic
+     */
+
     /**
      * Registration of LLM provider metadata
      *
@@ -13855,9 +14702,11 @@
         packageName: '@promptbook/anthropic-claude',
         className: 'AnthropicClaudeExecutionTools',
         envVariables: ['ANTHROPIC_CLAUDE_API_KEY'],
+        trustLevel: 'CLOSED',
+        order: MODEL_ORDER.TOP_TIER,
         getBoilerplateConfiguration() {
             return {
-                title: 'Anthropic Claude (boilerplate)',
+                title: 'Anthropic Claude',
                 packageName: '@promptbook/anthropic-claude',
                 className: 'AnthropicClaudeExecutionTools',
                 options: {
@@ -13911,6 +14760,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 3.5 Sonnet',
                 modelName: 'claude-3-5-sonnet-20240620',
+                modelDescription: 'Latest Claude model with great reasoning, coding, and language understanding capabilities. 200K context window. Optimized balance of intelligence and speed.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
@@ -13920,6 +14770,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 3 Opus',
                 modelName: 'claude-3-opus-20240229',
+                modelDescription: 'Most capable Claude model excelling at complex reasoning, coding, and detailed instruction following. 200K context window. Best for sophisticated tasks requiring nuanced understanding.',
                 pricing: {
                     prompt: computeUsage(`$15.00 / 1M tokens`),
                     output: computeUsage(`$75.00 / 1M tokens`),
@@ -13929,6 +14780,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 3 Sonnet',
                 modelName: 'claude-3-sonnet-20240229',
+                modelDescription: 'Strong general-purpose model with excellent performance across reasoning, conversation, and coding tasks. 200K context window. Good balance of intelligence and cost-efficiency.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
@@ -13938,6 +14790,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 3 Haiku',
                 modelName: '	claude-3-haiku-20240307',
+                modelDescription: 'Fastest and most compact Claude model optimized for responsiveness in interactive applications. 200K context window. Excellent for quick responses and lightweight applications.',
                 pricing: {
                     prompt: computeUsage(`$0.25 / 1M tokens`),
                     output: computeUsage(`$1.25 / 1M tokens`),
@@ -13947,6 +14800,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 2.1',
                 modelName: 'claude-2.1',
+                modelDescription: 'Improved version of Claude 2 with better performance across reasoning and truthfulness. 100K context window. Legacy model with strong reliability.',
                 pricing: {
                     prompt: computeUsage(`$8.00 / 1M tokens`),
                     output: computeUsage(`$24.00 / 1M tokens`),
@@ -13956,6 +14810,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'Claude 2',
                 modelName: 'claude-2.0',
+                modelDescription: 'Legacy model with strong general reasoning and language capabilities. 100K context window. Superseded by newer Claude 3 models.',
                 pricing: {
                     prompt: computeUsage(`$8.00 / 1M tokens`),
                     output: computeUsage(`$24.00 / 1M tokens`),
@@ -13963,14 +14818,35 @@
             },
             {
                 modelVariant: 'CHAT',
-                modelTitle: '	Claude Instant 1.2',
+                modelTitle: 'Claude Instant 1.2',
                 modelName: 'claude-instant-1.2',
+                modelDescription: 'Older, faster Claude model optimized for high throughput applications. Lower cost but less capable than newer models. 100K context window.',
                 pricing: {
                     prompt: computeUsage(`$0.80 / 1M tokens`),
                     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',
+                modelDescription: 'Latest generation Claude model with advanced reasoning and language understanding. Enhanced capabilities over 3.5 with improved domain knowledge. 200K context window.',
+                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',
+                modelDescription: 'Fast and efficient Claude 3.5 variant optimized for speed and cost-effectiveness. Great for interactive applications requiring quick responses. 200K context window.',
+                pricing: {
+                    prompt: computeUsage(`$0.25 / 1M tokens`),
+                    output: computeUsage(`$1.25 / 1M tokens`),
+                },
+            },
+            // <- [🕕]
         ],
     });
     /**
@@ -14366,9 +15242,11 @@
         packageName: '@promptbook/azure-openai',
         className: 'AzureOpenAiExecutionTools',
         envVariables: ['AZUREOPENAI_RESOURCE_NAME', 'AZUREOPENAI_DEPLOYMENT_NAME', 'AZUREOPENAI_API_KEY'],
+        trustLevel: 'CLOSED_BUSINESS',
+        order: MODEL_ORDER.NORMAL,
         getBoilerplateConfiguration() {
             return {
-                title: 'Azure Open AI (boilerplate)',
+                title: 'Azure Open AI',
                 packageName: '@promptbook/azure-openai',
                 className: 'AzureOpenAiExecutionTools',
                 options: {
@@ -14449,9 +15327,10 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'davinci-002',
                 modelName: 'davinci-002',
+                modelDescription: 'Legacy completion model with strong performance on text generation tasks. Optimized for complex instructions and longer outputs.',
                 pricing: {
                     prompt: computeUsage(`$2.00 / 1M tokens`),
-                    output: computeUsage(`$2.00 / 1M tokens`), // <- not sure
+                    output: computeUsage(`$2.00 / 1M tokens`),
                 },
             },
             /**/
@@ -14466,6 +15345,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-16k',
                 modelName: 'gpt-3.5-turbo-16k',
+                modelDescription: 'GPT-3.5 Turbo with extended 16k token context length for handling longer conversations and documents.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$4.00 / 1M tokens`),
@@ -14489,6 +15369,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4',
                 modelName: 'gpt-4',
+                modelDescription: 'GPT-4 is a powerful language model with enhanced reasoning, instruction-following capabilities, and 8K context window. Optimized for complex tasks requiring deep understanding.',
                 pricing: {
                     prompt: computeUsage(`$30.00 / 1M tokens`),
                     output: computeUsage(`$60.00 / 1M tokens`),
@@ -14500,6 +15381,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-32k',
                 modelName: 'gpt-4-32k',
+                modelDescription: 'Extended context version of GPT-4 with a 32K token window for processing very long inputs and generating comprehensive responses for complex tasks.',
                 pricing: {
                     prompt: computeUsage(`$60.00 / 1M tokens`),
                     output: computeUsage(`$120.00 / 1M tokens`),
@@ -14522,6 +15404,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo-2024-04-09',
                 modelName: 'gpt-4-turbo-2024-04-09',
+                modelDescription: 'Latest stable GPT-4 Turbo model from April 2024 with enhanced reasoning and context handling capabilities. Offers 128K context window and improved performance.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -14533,6 +15416,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-1106',
                 modelName: 'gpt-3.5-turbo-1106',
+                modelDescription: 'November 2023 version of GPT-3.5 Turbo with improved instruction following and a 16K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.00 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -14544,6 +15428,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo',
                 modelName: 'gpt-4-turbo',
+                modelDescription: 'More capable model than GPT-4 with improved instruction following, function calling and a 128K token context window for handling very large documents.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -14555,6 +15440,7 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'gpt-3.5-turbo-instruct-0914',
                 modelName: 'gpt-3.5-turbo-instruct-0914',
+                modelDescription: 'September 2023 version of GPT-3.5 Turbo optimized for completion-style instruction following with a 4K context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50  / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`), // <- For gpt-3.5-turbo-instruct
@@ -14566,6 +15452,7 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'gpt-3.5-turbo-instruct',
                 modelName: 'gpt-3.5-turbo-instruct',
+                modelDescription: 'Optimized version of GPT-3.5 for completion-style API with good instruction following and a 4K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50  / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -14583,9 +15470,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo',
                 modelName: 'gpt-3.5-turbo',
+                modelDescription: 'Latest version of GPT-3.5 Turbo with improved performance and instruction following capabilities. Default 4K context window with options for 16K.',
                 pricing: {
-                    prompt: computeUsage(`$3.00 / 1M tokens`),
-                    output: computeUsage(`$6.00 / 1M tokens`), // <- Not sure, refer to gpt-3.5-turbo in Fine-tuning models
+                    prompt: computeUsage(`$0.50 / 1M tokens`),
+                    output: computeUsage(`$1.50 / 1M tokens`),
                 },
             },
             /**/
@@ -14594,6 +15482,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0301',
                 modelName: 'gpt-3.5-turbo-0301',
+                modelDescription: 'March 2023 version of GPT-3.5 Turbo with a 4K token context window. Legacy model maintained for backward compatibility.',
                 pricing: {
                     prompt: computeUsage(`$1.50 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -14605,9 +15494,10 @@
                 modelVariant: 'COMPLETION',
                 modelTitle: 'babbage-002',
                 modelName: 'babbage-002',
+                modelDescription: 'Efficient legacy completion model with a good balance of performance and speed. Suitable for straightforward text generation tasks.',
                 pricing: {
                     prompt: computeUsage(`$0.40 / 1M tokens`),
-                    output: computeUsage(`$0.40 / 1M tokens`), // <- Not sure
+                    output: computeUsage(`$0.40 / 1M tokens`),
                 },
             },
             /**/
@@ -14616,6 +15506,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-1106-preview',
                 modelName: 'gpt-4-1106-preview',
+                modelDescription: 'November 2023 preview version of GPT-4 Turbo with improved instruction following and a 128K token context window.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -14627,6 +15518,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-0125-preview',
                 modelName: 'gpt-4-0125-preview',
+                modelDescription: 'January 2024 preview version of GPT-4 Turbo with improved reasoning capabilities and a 128K token context window.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
                     output: computeUsage(`$30.00 / 1M tokens`),
@@ -14644,6 +15536,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0125',
                 modelName: 'gpt-3.5-turbo-0125',
+                modelDescription: 'January 2024 version of GPT-3.5 Turbo with improved reasoning capabilities and a 16K token context window.',
                 pricing: {
                     prompt: computeUsage(`$0.50 / 1M tokens`),
                     output: computeUsage(`$1.50  / 1M tokens`),
@@ -14655,9 +15548,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4-turbo-preview',
                 modelName: 'gpt-4-turbo-preview',
+                modelDescription: 'Preview version of GPT-4 Turbo that points to the latest model version. Features improved instruction following, 128K token context window and lower latency.',
                 pricing: {
                     prompt: computeUsage(`$10.00 / 1M tokens`),
-                    output: computeUsage(`$30.00 / 1M tokens`), // <- Not sure, just for gpt-4-turbo
+                    output: computeUsage(`$30.00 / 1M tokens`),
                 },
             },
             /**/
@@ -14666,6 +15560,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-3-large',
                 modelName: 'text-embedding-3-large',
+                modelDescription: "OpenAI's most capable text embedding model designed for high-quality embeddings for complex similarity tasks and information retrieval.",
                 pricing: {
                     prompt: computeUsage(`$0.13  / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -14678,6 +15573,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-3-small',
                 modelName: 'text-embedding-3-small',
+                modelDescription: 'Cost-effective embedding model with good performance for simpler tasks like text similarity and retrieval. Good balance of quality and efficiency.',
                 pricing: {
                     prompt: computeUsage(`$0.02 / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -14690,6 +15586,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-0613',
                 modelName: 'gpt-3.5-turbo-0613',
+                modelDescription: 'June 2023 version of GPT-3.5 Turbo with function calling capabilities and a 4K token context window.',
                 pricing: {
                     prompt: computeUsage(`$1.50 / 1M tokens`),
                     output: computeUsage(`$2.00 / 1M tokens`),
@@ -14701,6 +15598,7 @@
                 modelVariant: 'EMBEDDING',
                 modelTitle: 'text-embedding-ada-002',
                 modelName: 'text-embedding-ada-002',
+                modelDescription: 'Legacy text embedding model suitable for text similarity and retrieval augmented generation use cases. Replaced by newer embedding-3 models.',
                 pricing: {
                     prompt: computeUsage(`$0.1 / 1M tokens`),
                     // TODO: [🏏] Leverage the batch API @see https://platform.openai.com/docs/guides/batch
@@ -14731,11 +15629,11 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4o-2024-05-13',
                 modelName: 'gpt-4o-2024-05-13',
+                modelDescription: 'May 2024 version of GPT-4o with enhanced multimodal capabilities, improved reasoning, and optimized for vision, audio and chat at lower latencies.',
                 pricing: {
                     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
             },
             /**/
             /**/
@@ -14743,6 +15641,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-4o',
                 modelName: 'gpt-4o',
+                modelDescription: "OpenAI's most advanced multimodal model optimized for performance, speed, and cost. Capable of vision, reasoning, and high quality text generation.",
                 pricing: {
                     prompt: computeUsage(`$5.00 / 1M tokens`),
                     output: computeUsage(`$15.00 / 1M tokens`),
@@ -14750,10 +15649,23 @@
             },
             /**/
             /**/
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'gpt-4o-mini',
+                modelName: 'gpt-4o-mini',
+                modelDescription: 'Smaller, more cost-effective version of GPT-4o with good performance across text, vision, and audio tasks at reduced complexity.',
+                pricing: {
+                    prompt: computeUsage(`$3.00 / 1M tokens`),
+                    output: computeUsage(`$9.00 / 1M tokens`),
+                },
+            },
+            /**/
+            /**/
             {
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-preview',
                 modelName: 'o1-preview',
+                modelDescription: 'Advanced reasoning model with exceptional performance on complex logical, mathematical, and analytical tasks. Built for deep reasoning and specialized professional tasks.',
                 pricing: {
                     prompt: computeUsage(`$15.00 / 1M tokens`),
                     output: computeUsage(`$60.00 / 1M tokens`),
@@ -14765,6 +15677,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-preview-2024-09-12',
                 modelName: 'o1-preview-2024-09-12',
+                modelDescription: 'September 2024 version of O1 preview with specialized reasoning capabilities for complex tasks requiring precise analytical thinking.',
                 //             <- TODO: [💩] Some better system to organize theese date suffixes and versions
                 pricing: {
                     prompt: computeUsage(`$15.00 / 1M tokens`),
@@ -14777,6 +15690,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-mini',
                 modelName: 'o1-mini',
+                modelDescription: 'Smaller, cost-effective version of the O1 model with good performance on reasoning tasks while maintaining efficiency for everyday analytical use.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -14788,10 +15702,10 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1',
                 modelName: 'o1',
+                modelDescription: "OpenAI's advanced reasoning model focused on logic and problem-solving. Designed for complex analytical tasks with rigorous step-by-step reasoning. 128K context window.",
                 pricing: {
-                    prompt: computeUsage(`$3.00 / 1M tokens`),
-                    output: computeUsage(`$12.00 / 1M tokens`),
-                    // <- TODO: !! Unsure, check the pricing
+                    prompt: computeUsage(`$15.00 / 1M tokens`),
+                    output: computeUsage(`$60.00 / 1M tokens`),
                 },
             },
             /**/
@@ -14800,6 +15714,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o3-mini',
                 modelName: 'o3-mini',
+                modelDescription: 'Cost-effective reasoning model optimized for academic and scientific problem-solving. Efficient performance on STEM tasks with deep mathematical and scientific knowledge. 128K context window.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -14812,6 +15727,7 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'o1-mini-2024-09-12',
                 modelName: 'o1-mini-2024-09-12',
+                modelDescription: "September 2024 version of O1-mini with balanced reasoning capabilities and cost-efficiency. Good for analytical tasks that don't require the full O1 model.",
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$12.00 / 1M tokens`),
@@ -14823,12 +15739,14 @@
                 modelVariant: 'CHAT',
                 modelTitle: 'gpt-3.5-turbo-16k-0613',
                 modelName: 'gpt-3.5-turbo-16k-0613',
+                modelDescription: 'June 2023 version of GPT-3.5 Turbo with extended 16k token context window for processing longer conversations and documents.',
                 pricing: {
                     prompt: computeUsage(`$3.00 / 1M tokens`),
                     output: computeUsage(`$4.00 / 1M tokens`),
                 },
             },
             /**/
+            // <- [🕕]
         ],
     });
     /**
@@ -14846,6 +15764,9 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    // Default rate limits (requests per minute) - adjust as needed based on Azure OpenAI tier
+    const DEFAULT_RPM$1 = 60;
+    // <- TODO: !!! Put in some better place
     /**
      * Execution Tools for calling Azure OpenAI API.
      *
@@ -14863,6 +15784,10 @@
              * OpenAI Azure API client.
              */
             this.client = null;
+            // TODO: Allow configuring rate limits via options
+            this.limiter = new Bottleneck__default["default"]({
+                minTime: 60000 / (this.options.maxRequestsPerMinute || DEFAULT_RPM$1),
+            });
         }
         get title() {
             return 'Azure OpenAI';
@@ -14940,7 +15865,9 @@
                     console.info(colors__default["default"].bgWhite('messages'), JSON.stringify(messages, null, 4));
                 }
                 const rawRequest = [modelName, messages, modelSettings];
-                const rawResponse = await this.withTimeout(client.getChatCompletions(...rawRequest)).catch((error) => {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.withTimeout(client.getChatCompletions(...rawRequest)))
+                    .catch((error) => {
                     if (this.options.isVerbose) {
                         console.info(colors__default["default"].bgRed('error'), error);
                     }
@@ -15036,7 +15963,9 @@
                     [rawPromptContent],
                     modelSettings,
                 ];
-                const rawResponse = await this.withTimeout(client.getCompletions(...rawRequest)).catch((error) => {
+                const rawResponse = await this.limiter
+                    .schedule(() => this.withTimeout(client.getCompletions(...rawRequest)))
+                    .catch((error) => {
                     if (this.options.isVerbose) {
                         console.info(colors__default["default"].bgRed('error'), error);
                     }
@@ -15176,9 +16105,11 @@
         packageName: '@promptbook/deepseek',
         className: 'DeepseekExecutionTools',
         envVariables: ['DEEPSEEK_GENERATIVE_AI_API_KEY'],
+        trustLevel: 'UNTRUSTED',
+        order: MODEL_ORDER.NORMAL,
         getBoilerplateConfiguration() {
             return {
-                title: 'Deepseek (boilerplate)',
+                title: 'Deepseek',
                 packageName: '@promptbook/deepseek',
                 className: 'DeepseekExecutionTools',
                 options: {
@@ -15375,6 +16306,67 @@
         };
     }
 
+    /**
+     * List of available Deepseek models with descriptions
+     *
+     * Note: Done at 2025-04-22
+     *
+     * @see https://www.deepseek.com/models
+     * @public exported from `@promptbook/deepseek`
+     */
+    const DEEPSEEK_MODELS = exportJson({
+        name: 'DEEPSEEK_MODELS',
+        value: [
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Deepseek Chat',
+                modelName: 'deepseek-chat',
+                modelDescription: 'General-purpose language model with strong performance across conversation, reasoning, and content generation. 128K context window with excellent instruction following capabilities.',
+                pricing: {
+                    prompt: computeUsage(`$1.00 / 1M tokens`),
+                    output: computeUsage(`$2.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Deepseek Reasoner',
+                modelName: 'deepseek-reasoner',
+                modelDescription: 'Specialized model focused on complex reasoning tasks like mathematical problem-solving and logical analysis. Enhanced step-by-step reasoning with explicit chain-of-thought processes. 128K context window.',
+                pricing: {
+                    prompt: computeUsage(`$4.00 / 1M tokens`),
+                    output: computeUsage(`$8.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'DeepSeek V3',
+                modelName: 'deepseek-v3-0324',
+                modelDescription: 'Advanced general-purpose model with improved reasoning, coding abilities, and multimodal understanding. Built on the latest DeepSeek architecture with enhanced knowledge representation.',
+                pricing: {
+                    prompt: computeUsage(`$1.50 / 1M tokens`),
+                    output: computeUsage(`$3.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'DeepSeek R1',
+                modelName: 'deepseek-r1',
+                modelDescription: 'Research-focused model optimized for scientific problem-solving and analytical tasks. Excellent performance on tasks requiring domain-specific expertise and critical thinking.',
+                pricing: {
+                    prompt: computeUsage(`$5.00 / 1M tokens`),
+                    output: computeUsage(`$10.00 / 1M tokens`),
+                },
+            },
+            // <- [🕕]
+        ],
+    });
+    /**
+     * TODO: [🧠] Add information about context window sizes, capabilities, and relative performance characteristics
+     * TODO: [🎰] Some mechanism to auto-update available models
+     * TODO: [🧠] Verify pricing information is current with Deepseek's official documentation
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Execution Tools for calling Deepseek API.
      *
@@ -15396,12 +16388,7 @@
             title: 'Deepseek',
             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',
-                // <- TODO: How picking of the default model looks like in `createExecutionToolsFromVercelProvider`
-            ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
+            availableModels: DEEPSEEK_MODELS,
             ...options,
         });
     }, {
@@ -15441,9 +16428,11 @@
         packageName: '@promptbook/google',
         className: 'GoogleExecutionTools',
         envVariables: ['GOOGLE_GENERATIVE_AI_API_KEY'],
+        trustLevel: 'CLOSED',
+        order: MODEL_ORDER.NORMAL,
         getBoilerplateConfiguration() {
             return {
-                title: 'Google Gemini (boilerplate)',
+                title: 'Google Gemini',
                 packageName: '@promptbook/google',
                 className: 'GoogleExecutionTools',
                 options: {
@@ -15476,6 +16465,173 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * List of available Google models with descriptions
+     *
+     * Note: Done at 2025-04-22
+     *
+     * @see https://ai.google.dev/models/gemini
+     * @public exported from `@promptbook/google`
+     */
+    const GOOGLE_MODELS = exportJson({
+        name: 'GOOGLE_MODELS',
+        value: [
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 2.5 Pro',
+                modelName: 'gemini-2.5-pro-preview-03-25',
+                modelDescription: 'Latest advanced multimodal model with exceptional reasoning, tool use, and instruction following. 1M token context window with improved vision capabilities for complex visual tasks.',
+                pricing: {
+                    prompt: computeUsage(`$7.00 / 1M tokens`),
+                    output: computeUsage(`$21.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 2.0 Flash',
+                modelName: 'gemini-2.0-flash',
+                modelDescription: 'Fast, efficient model optimized for rapid response times. Good balance between performance and cost, with strong capabilities across text, code, and reasoning tasks. 128K context window.',
+                pricing: {
+                    prompt: computeUsage(`$0.35 / 1M tokens`),
+                    output: computeUsage(`$1.05 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 2.0 Flash Lite',
+                modelName: 'gemini-2.0-flash-lite',
+                modelDescription: 'Streamlined version of Gemini 2.0 Flash, designed for extremely low-latency applications and edge deployments. Optimized for efficiency while maintaining core capabilities.',
+                pricing: {
+                    prompt: computeUsage(`$0.20 / 1M tokens`),
+                    output: computeUsage(`$0.60 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 2.0 Flash Thinking',
+                modelName: 'gemini-2.0-flash-thinking-exp-01-21',
+                modelDescription: 'Experimental model focused on enhanced reasoning with explicit chain-of-thought processes. Designed for tasks requiring structured thinking and problem-solving approaches.',
+                pricing: {
+                    prompt: computeUsage(`$0.35 / 1M tokens`),
+                    output: computeUsage(`$1.05 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash',
+                modelName: 'gemini-1.5-flash',
+                modelDescription: 'Efficient model balancing speed and quality for general-purpose applications. 1M token context window with good multimodal capabilities and quick response times.',
+                pricing: {
+                    prompt: computeUsage(`$0.35 / 1M tokens`),
+                    output: computeUsage(`$1.05 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash Latest',
+                modelName: 'gemini-1.5-flash-latest',
+                modelDescription: 'Points to the latest version of Gemini 1.5 Flash, ensuring access to the most recent improvements and bug fixes while maintaining stable interfaces.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 001',
+                modelName: 'gemini-1.5-flash-001',
+                modelDescription: 'First stable release of Gemini 1.5 Flash model with reliable performance characteristics for production applications. 1M token context window.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 002',
+                modelName: 'gemini-1.5-flash-002',
+                modelDescription: 'Improved version of Gemini 1.5 Flash with enhanced instruction following and more consistent outputs. Refined for better application integration.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash Exp',
+                modelName: 'gemini-1.5-flash-exp-0827',
+                modelDescription: 'Experimental version of Gemini 1.5 Flash with new capabilities being tested. May offer improved performance but with potential behavior differences from stable releases.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 8B',
+                modelName: 'gemini-1.5-flash-8b',
+                modelDescription: 'Compact 8B parameter model optimized for efficiency and deployment in resource-constrained environments. Good performance despite smaller size.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 8B Latest',
+                modelName: 'gemini-1.5-flash-8b-latest',
+                modelDescription: 'Points to the most recent version of the compact 8B parameter model, providing latest improvements while maintaining a small footprint.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 8B Exp',
+                modelName: 'gemini-1.5-flash-8b-exp-0924',
+                modelDescription: 'Experimental version of the 8B parameter model with new capabilities and optimizations being evaluated for future stable releases.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Flash 8B Exp',
+                modelName: 'gemini-1.5-flash-8b-exp-0827',
+                modelDescription: 'August experimental release of the efficient 8B parameter model with specific improvements to reasoning capabilities and response quality.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Pro Latest',
+                modelName: 'gemini-1.5-pro-latest',
+                modelDescription: 'Points to the most recent version of the flagship Gemini 1.5 Pro model, ensuring access to the latest capabilities and improvements.',
+                pricing: {
+                    prompt: computeUsage(`$7.00 / 1M tokens`),
+                    output: computeUsage(`$21.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Pro',
+                modelName: 'gemini-1.5-pro',
+                modelDescription: 'Flagship multimodal model with strong performance across text, code, vision, and audio tasks. 1M token context window with excellent reasoning capabilities.',
+                pricing: {
+                    prompt: computeUsage(`$7.00 / 1M tokens`),
+                    output: computeUsage(`$21.00 / 1M tokens`),
+                },
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Pro 001',
+                modelName: 'gemini-1.5-pro-001',
+                modelDescription: 'First stable release of Gemini 1.5 Pro with consistent performance characteristics and reliable behavior for production applications.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Pro 002',
+                modelName: 'gemini-1.5-pro-002',
+                modelDescription: 'Refined version of Gemini 1.5 Pro with improved instruction following, better multimodal understanding, and more consistent outputs.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.5 Pro Exp',
+                modelName: 'gemini-1.5-pro-exp-0827',
+                modelDescription: 'Experimental version of Gemini 1.5 Pro with new capabilities and optimizations being tested before wider release. May offer improved performance.',
+            },
+            {
+                modelVariant: 'CHAT',
+                modelTitle: 'Gemini 1.0 Pro',
+                modelName: 'gemini-1.0-pro',
+                modelDescription: 'Original Gemini series foundation model with solid multimodal capabilities. 32K context window with good performance on text, code, and basic vision tasks.',
+                pricing: {
+                    prompt: computeUsage(`$0.35 / 1M tokens`),
+                    output: computeUsage(`$1.05 / 1M tokens`),
+                },
+            },
+            // <- [🕕]
+        ],
+    });
+    /**
+     * TODO: [🧠] Add information about context window sizes, capabilities, and relative performance characteristics
+     * TODO: [🎰] Some mechanism to auto-update available models
+     * TODO: [🧠] Verify pricing information is current with Google's official documentation
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Execution Tools for calling Google Gemini API.
      *
@@ -15497,24 +16653,7 @@
             title: 'Google',
             description: 'Implementation of Google models',
             vercelProvider: googleGeminiVercelProvider,
-            availableModels: [
-                // TODO: [🕘] Maybe list models in same way as in other providers - in separate file with metadata
-                'gemini-1.5-flash',
-                'gemini-1.5-flash-latest',
-                'gemini-1.5-flash-001',
-                'gemini-1.5-flash-002',
-                'gemini-1.5-flash-exp-0827',
-                'gemini-1.5-flash-8b',
-                'gemini-1.5-flash-8b-latest',
-                'gemini-1.5-flash-8b-exp-0924',
-                'gemini-1.5-flash-8b-exp-0827',
-                'gemini-1.5-pro-latest',
-                'gemini-1.5-pro',
-                'gemini-1.5-pro-001',
-                'gemini-1.5-pro-002',
-                'gemini-1.5-pro-exp-0827',
-                'gemini-1.0-pro',
-            ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
+            availableModels: GOOGLE_MODELS,
             ...options,
         });
     }, {
@@ -15554,9 +16693,11 @@
         packageName: '@promptbook/openai',
         className: 'OpenAiExecutionTools',
         envVariables: ['OPENAI_API_KEY'],
+        trustLevel: 'CLOSED',
+        order: MODEL_ORDER.TOP_TIER,
         getBoilerplateConfiguration() {
             return {
-                title: 'Open AI (boilerplate)',
+                title: 'Open AI',
                 packageName: '@promptbook/openai',
                 className: 'OpenAiExecutionTools',
                 options: {
@@ -15594,9 +16735,11 @@
         className: 'OpenAiAssistantExecutionTools',
         envVariables: null,
         //            <- TODO: ['OPENAI_API_KEY', 'OPENAI_ASSISTANT_ID']
+        trustLevel: 'CLOSED',
+        order: MODEL_ORDER.NORMAL,
         getBoilerplateConfiguration() {
             return {
-                title: 'Open AI Assistant (boilerplate)',
+                title: 'Open AI Assistant',
                 packageName: '@promptbook/openai',
                 className: 'OpenAiAssistantExecutionTools',
                 options: {
@@ -15672,6 +16815,9 @@
      * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
      */
 
+    // Default rate limits (requests per minute) - adjust as needed based on OpenAI tier
+    const DEFAULT_RPM = 60;
+    // <- TODO: !!! Put in some better place
     /**
      * Execution Tools for calling OpenAI API
      *
@@ -15689,6 +16835,10 @@
              * OpenAI API client.
              */
             this.client = null;
+            // TODO: Allow configuring rate limits via options
+            this.limiter = new Bottleneck__default["default"]({
+                minTime: 60000 / (this.options.maxRequestsPerMinute || DEFAULT_RPM),
+            });
         }
         get title() {
             return 'OpenAI';
@@ -15792,7 +16942,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.chat.completions.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.chat.completions.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -15868,7 +17021,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.completions.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.completions.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }
@@ -15931,7 +17087,10 @@
             if (this.options.isVerbose) {
                 console.info(colors__default["default"].bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
             }
-            const rawResponse = await client.embeddings.create(rawRequest).catch((error) => {
+            const rawResponse = await this.limiter
+                .schedule(() => client.embeddings.create(rawRequest))
+                .catch((error) => {
+                assertsError(error);
                 if (this.options.isVerbose) {
                     console.info(colors__default["default"].bgRed('error'), error);
                 }