@promptbook/cli 0.89.0-5 → 0.89.0-7

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('path'), require('fs/promises'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto'), 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('prompts'), require('moment'), require('express'), require('http'), require('socket.io'), require('socket.io-client'), 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', 'path', 'fs/promises', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto', 'rxjs', 'dotenv', 'child_process', 'jszip', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'prompts', 'moment', 'express', 'http', 'socket.io', 'socket.io-client', '@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.path, global.promises, global.hexEncoder, global.sha256, global.crypto, global.rxjs, global.dotenv, global.child_process, global.JSZip, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.prompts, global.moment, global.express, global.http, global.socket_io, global.socket_ioClient, global.Anthropic, global.openai, global.OpenAI, global.readability, global.jsdom, global.showdown));
-})(this, (function (exports, colors, commander, spaceTrim, waitasecond, path, promises, hexEncoder, sha256, crypto, rxjs, dotenv, child_process, JSZip, prettier, parserHtml, papaparse, cryptoJs, mimeTypes, glob, prompts, moment, express, http, socket_io, socket_ioClient, 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('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';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -27,16 +27,18 @@
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
     var commander__default = /*#__PURE__*/_interopDefaultLegacy(commander);
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var prompts__default = /*#__PURE__*/_interopDefaultLegacy(prompts);
     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 prompts__default = /*#__PURE__*/_interopDefaultLegacy(prompts);
     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 swaggerUi__default = /*#__PURE__*/_interopDefaultLegacy(swaggerUi);
     var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
 
@@ -54,7 +56,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-5';
+    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-7';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -223,6 +225,7 @@
      */
     const DEFAULT_BOOKS_DIRNAME = './books';
     // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+    // TODO: !!!!!! Just .promptbook dir, hardocode others
     /**
      * Where to store the temporary downloads
      *
@@ -247,6 +250,21 @@
      * @public exported from `@promptbook/core`
      */
     const DEFAULT_SCRAPE_CACHE_DIRNAME = './.promptbook/scrape-cache';
+    /**
+     * Id of application for the CLI when using remote server
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const CLI_APP_ID = 'cli';
+    /*
+    TODO: [🌃]
+    /**
+     * Id of application for the wizzard when using remote server
+     *
+     * @public exported from `@promptbook/core`
+     * /
+    ex-port const WIZZARD_APP_ID: string_app_id = 'wizzard';
+    */
     /**
      * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
      *
@@ -267,13 +285,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_REMOTE_URL = 'https://api.pavolhejny.com/';
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const DEFAULT_REMOTE_URL_PATH = '/promptbook/socket.io';
+    const DEFAULT_REMOTE_SERVER_URL = 'https://api.pavolhejny.com/promptbook';
     // <- TODO: [🧜‍♂️]
     /**
      * @@@
@@ -315,7 +327,7 @@
     true);
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
-     * TODO: [🧠][🧜‍♂️] Maybe join remoteUrl and path into single value
+     * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
      */
 
     /**
@@ -493,7 +505,8 @@
         helloCommand.alias('hi');
         helloCommand.argument('[name]', 'Your name', 'Paul');
         helloCommand.option('-g, --greeting <greeting>', `Greeting`, 'Hello');
-        helloCommand.action(handleActionErrors(async (name, { greeting }) => {
+        helloCommand.action(handleActionErrors(async (name, cliOptions) => {
+            const { greeting } = cliOptions;
             console.info(colors__default["default"].cyan(`${greeting} ${name}`));
             await waitasecond.forTime(1000);
             console.info(colors__default["default"].rainbow(`Nice to meet you!`));
@@ -507,40 +520,27 @@
      */
 
     /**
-     * Just marks a place of place where should be something implemented
-     * No side effects.
-     *
-     * Note: It can be usefull suppressing eslint errors of unused variables
+     * This error type indicates that some part of the code is not implemented yet
      *
-     * @param value any values
-     * @returns void
-     * @private within the repository
+     * @public exported from `@promptbook/core`
      */
-    function TODO_USE(...value) {
-    }
+    class NotYetImplementedError extends Error {
+        constructor(message) {
+            super(spaceTrim.spaceTrim((block) => `
+                    ${block(message)}
 
-    /**
-     * @@@
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $provideFilesystemForNode(options) {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+                    Note: This feature is not implemented yet but it will be soon.
+
+                    If you want speed up the implementation or just read more, look here:
+                    https://github.com/webgptorg/promptbook
+
+                    Or contact us on pavol@ptbk.io
+
+                `));
+            this.name = 'NotYetImplementedError';
+            Object.setPrototypeOf(this, NotYetImplementedError.prototype);
         }
-        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
-     */
 
     /**
      * Make error report URL for the given error
@@ -611,123 +611,569 @@
     }
 
     /**
-     * Orders JSON object by keys
+     * @@@
      *
-     * @returns The same type of object as the input re-ordered
-     * @public exported from `@promptbook/utils`
+     * Note: `$` is used to indicate that this function is not a pure function - it access global scope
+     *
+     *  @private internal function of `$Register`
      */
-    function orderJson(options) {
-        const { value, order } = options;
-        const orderedValue = {
-            ...(order === undefined ? {} : Object.fromEntries(order.map((key) => [key, undefined]))),
-            ...value,
-        };
-        return orderedValue;
+    function $getGlobalScope() {
+        return Function('return this')();
     }
 
     /**
-     * Freezes the given object and all its nested objects recursively
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
-     * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     * @@@
      *
-     * @returns The same object as the input, but deeply frozen
+     * @param text @@@
+     * @returns @@@
+     * @example 'HELLO_WORLD'
+     * @example 'I_LOVE_PROMPTBOOK'
      * @public exported from `@promptbook/utils`
      */
-    function $deepFreeze(objectValue) {
-        if (Array.isArray(objectValue)) {
-            return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
-        }
-        const propertyNames = Object.getOwnPropertyNames(objectValue);
-        for (const propertyName of propertyNames) {
-            const value = objectValue[propertyName];
-            if (value && typeof value === 'object') {
-                $deepFreeze(value);
+    function normalizeTo_SCREAMING_CASE(text) {
+        let charType;
+        let lastCharType = 'OTHER';
+        let normalizedName = '';
+        for (const char of text) {
+            let normalizedChar;
+            if (/^[a-z]$/.test(char)) {
+                charType = 'LOWERCASE';
+                normalizedChar = char.toUpperCase();
+            }
+            else if (/^[A-Z]$/.test(char)) {
+                charType = 'UPPERCASE';
+                normalizedChar = char;
+            }
+            else if (/^[0-9]$/.test(char)) {
+                charType = 'NUMBER';
+                normalizedChar = char;
+            }
+            else {
+                charType = 'OTHER';
+                normalizedChar = '_';
+            }
+            if (charType !== lastCharType &&
+                !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
+                !(lastCharType === 'NUMBER') &&
+                !(charType === 'NUMBER')) {
+                normalizedName += '_';
             }
+            normalizedName += normalizedChar;
+            lastCharType = charType;
         }
-        Object.freeze(objectValue);
-        return objectValue;
+        normalizedName = normalizedName.replace(/_+/g, '_');
+        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
+        normalizedName = normalizedName.replace(/^_/, '');
+        normalizedName = normalizedName.replace(/_$/, '');
+        return normalizedName;
     }
     /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     * TODO: Tests
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
+     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
+     * TODO: [🌺] Use some intermediate util splitWords
      */
 
     /**
-     * Checks if the value is [🚉] serializable as JSON
-     * If not, throws an UnexpectedError with a rich error message and tracking
-     *
-     * - Almost all primitives are serializable BUT:
-     * - `undefined` is not serializable
-     * - `NaN` is not serializable
-     * - Objects and arrays are serializable if all their properties are serializable
-     * - Functions are not serializable
-     * - Circular references are not serializable
-     * - `Date` objects are not serializable
-     * - `Map` and `Set` objects are not serializable
-     * - `RegExp` objects are not serializable
-     * - `Error` objects are not serializable
-     * - `Symbol` objects are not serializable
-     * - And much more...
+     * @@@
      *
-     * @throws UnexpectedError if the value is not serializable as JSON
+     * @param text @@@
+     * @returns @@@
+     * @example 'hello_world'
+     * @example 'i_love_promptbook'
      * @public exported from `@promptbook/utils`
      */
-    function checkSerializableAsJson(options) {
-        const { value, name, message } = options;
-        if (value === undefined) {
-            throw new UnexpectedError(`${name} is undefined`);
-        }
-        else if (value === null) {
-            return;
-        }
-        else if (typeof value === 'boolean') {
-            return;
-        }
-        else if (typeof value === 'number' && !isNaN(value)) {
-            return;
-        }
-        else if (typeof value === 'string') {
-            return;
-        }
-        else if (typeof value === 'symbol') {
-            throw new UnexpectedError(`${name} is symbol`);
-        }
-        else if (typeof value === 'function') {
-            throw new UnexpectedError(`${name} is function`);
-        }
-        else if (typeof value === 'object' && Array.isArray(value)) {
-            for (let i = 0; i < value.length; i++) {
-                checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
-            }
-        }
-        else if (typeof value === 'object') {
-            if (value instanceof Date) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is Date
-
-                        Use \`string_date_iso8601\` instead
+    function normalizeTo_snake_case(text) {
+        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+    }
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
-                    `));
+    /**
+     * Register is @@@
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
+     *
+     * @private internal utility, exported are only signleton instances of this class
+     */
+    class $Register {
+        constructor(registerName) {
+            this.registerName = registerName;
+            const storageName = `_promptbook_${normalizeTo_snake_case(registerName)}`;
+            const globalScope = $getGlobalScope();
+            if (globalScope[storageName] === undefined) {
+                globalScope[storageName] = [];
             }
-            else if (value instanceof Map) {
-                throw new UnexpectedError(`${name} is Map`);
+            else if (!Array.isArray(globalScope[storageName])) {
+                throw new UnexpectedError(`Expected (global) ${storageName} to be an array, but got ${typeof globalScope[storageName]}`);
             }
-            else if (value instanceof Set) {
-                throw new UnexpectedError(`${name} is Set`);
+            this.storage = globalScope[storageName];
+        }
+        list() {
+            // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
+            return this.storage;
+        }
+        register(registered) {
+            const { packageName, className } = registered;
+            const existingRegistrationIndex = this.storage.findIndex((item) => item.packageName === packageName && item.className === className);
+            const existingRegistration = this.storage[existingRegistrationIndex];
+            if (!existingRegistration) {
+                this.storage.push(registered);
             }
-            else if (value instanceof RegExp) {
-                throw new UnexpectedError(`${name} is RegExp`);
+            else {
+                this.storage[existingRegistrationIndex] = registered;
             }
-            else if (value instanceof Error) {
-                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                        \`${name}\` is unserialized Error
-
-                        Use function \`serializeError\`
+            return {
+                registerName: this.registerName,
+                packageName,
+                className,
+                get isDestroyed() {
+                    return false;
+                },
+                destroy() {
+                    throw new NotYetImplementedError(`Registration to ${this.registerName} is permanent in this version of Promptbook`);
+                },
+            };
+        }
+    }
 
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
+    /**
+     * @@@
+     *
+     * Note: `$` is used to indicate that this interacts with the global scope
+     * @singleton Only one instance of each register is created per build, but thare can be more @@@
+     * @public exported from `@promptbook/core`
+     */
+    const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
+    /**
+     * TODO: [®] DRY Register logic
+     */
+
+    /**
+     * @@@
+     *
+     * Note: `$` is used to indicate that this interacts with the global scope
+     * @singleton Only one instance of each register is created per build, but thare can be more @@@
+     * @public exported from `@promptbook/core`
+     */
+    const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
+    /**
+     * TODO: [®] DRY Register logic
+     */
+
+    /**
+     * Path to the `.env` file which was used to configure LLM tools
+     *
+     * Note: `$` is used to indicate that this variable is changed by side effect in `$provideLlmToolsConfigurationFromEnv` through `$setUsedEnvFilename`
+     */
+    let $usedEnvFilename = null;
+    /**
+     * Pass the `.env` file which was used to configure LLM tools
+     *
+     * Note: `$` is used to indicate that this variable is making side effect
+     *
+     * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
+     */
+    function $setUsedEnvFilename(filepath) {
+        $usedEnvFilename = filepath;
+    }
+    /**
+     * Creates a message with all registered LLM tools
+     *
+     * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
+     *
+     * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
+     */
+    function $registeredLlmToolsMessage() {
+        let env;
+        if ($isRunningInNode()) {
+            env = process.env;
+            // <- TODO: [⚛] Some DRY way how to get to `process.env` and pass it into functions - ACRY search for `env`
+        }
+        else {
+            env = {};
+        }
+        /**
+         * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
+         */
+        const all = [];
+        for (const { title, packageName, className, envVariables } of $llmToolsMetadataRegister.list()) {
+            if (all.some((item) => item.packageName === packageName && item.className === className)) {
+                continue;
+            }
+            all.push({ title, packageName, className, envVariables });
+        }
+        for (const { packageName, className } of $llmToolsRegister.list()) {
+            if (all.some((item) => item.packageName === packageName && item.className === className)) {
+                continue;
+            }
+            all.push({ packageName, className });
+        }
+        const metadata = all.map((metadata) => {
+            var _a, _b;
+            const isMetadataAviailable = $llmToolsMetadataRegister
+                .list()
+                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+            const isInstalled = $llmToolsRegister
+                .list()
+                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+            const isFullyConfigured = ((_a = metadata.envVariables) === null || _a === void 0 ? void 0 : _a.every((envVariableName) => env[envVariableName] !== undefined)) || false;
+            const isPartiallyConfigured = ((_b = metadata.envVariables) === null || _b === void 0 ? void 0 : _b.some((envVariableName) => env[envVariableName] !== undefined)) || false;
+            // <- Note: [🗨]
+            return { ...metadata, isMetadataAviailable, isInstalled, isFullyConfigured, isPartiallyConfigured };
+        });
+        const usedEnvMessage = $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
+        if (metadata.length === 0) {
+            return spaceTrim__default["default"]((block) => `
+                No LLM providers are available.
+
+                ${block(usedEnvMessage)}
+          `);
+        }
+        return spaceTrim__default["default"]((block) => `
+
+            ${block(usedEnvMessage)}
+
+            Relevant environment variables:
+            ${block(Object.keys(env)
+        .filter((envVariableName) => metadata.some(({ envVariables }) => envVariables === null || envVariables === void 0 ? void 0 : envVariables.includes(envVariableName)))
+        .map((envVariableName) => `- \`${envVariableName}\``)
+        .join('\n'))}
+
+            Available LLM providers are:
+            ${block(metadata
+        .map(({ title, packageName, className, envVariables, isMetadataAviailable, isInstalled, isFullyConfigured, isPartiallyConfigured, }, i) => {
+        const morePieces = [];
+        if (just(false)) ;
+        else if (!isMetadataAviailable && !isInstalled) {
+            // TODO: [�][�] Maybe do allow to do auto-install if package not registered and not found
+            morePieces.push(`Not installed and no metadata, looks like a unexpected behavior`);
+        }
+        else if (isMetadataAviailable && !isInstalled) {
+            // TODO: [�][�]
+            morePieces.push(`Not installed`);
+        }
+        else if (!isMetadataAviailable && isInstalled) {
+            morePieces.push(`No metadata but installed, looks like a unexpected behavior`);
+        }
+        else if (isMetadataAviailable && isInstalled) {
+            morePieces.push(`Installed`);
+        }
+        else {
+            morePieces.push(`unknown state, looks like a unexpected behavior`);
+        } /* not else */
+        if (isFullyConfigured) {
+            morePieces.push(`Configured`);
+        }
+        else if (isPartiallyConfigured) {
+            morePieces.push(`Partially confugured, missing ${envVariables === null || envVariables === void 0 ? void 0 : envVariables.filter((envVariable) => env[envVariable] === undefined).join(' + ')}`);
+        }
+        else {
+            if (envVariables !== null) {
+                morePieces.push(`Not configured, to configure set env ${envVariables === null || envVariables === void 0 ? void 0 : envVariables.join(' + ')}`);
+            }
+            else {
+                morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
+            }
+        }
+        let providerMessage = spaceTrim__default["default"](`
+                                ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
+                                    ${morePieces.join('; ')}
+                            `);
+        if ($isRunningInNode) {
+            if (isInstalled && isFullyConfigured) {
+                providerMessage = colors__default["default"].green(providerMessage);
+            }
+            else if (isInstalled && isPartiallyConfigured) {
+                providerMessage = colors__default["default"].yellow(providerMessage);
+            }
+            else {
+                providerMessage = colors__default["default"].gray(providerMessage);
+            }
+        }
+        return providerMessage;
+    })
+        .join('\n'))}
+        `);
+    }
+    /**
+     * TODO: [®] DRY Register logic
+     * TODO: [🧠][⚛] Maybe pass env as argument
+     */
+
+    /**
+     * Just says that the variable is not used but should be kept
+     * No side effects.
+     *
+     * Note: It can be usefull for:
+     *
+     * 1) Suppressing eager optimization of unused imports
+     * 2) Suppressing eslint errors of unused variables in the tests
+     * 3) Keeping the type of the variable for type testing
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function keepUnused(...valuesToKeep) {
+    }
+
+    /**
+     * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function $sideEffect(...sideEffectSubjects) {
+        keepUnused(...sideEffectSubjects);
+    }
+
+    /**
+     * Checks if value is valid email
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidEmail(email) {
+        if (typeof email !== 'string') {
+            return false;
+        }
+        if (email.split('\n').length > 1) {
+            return false;
+        }
+        return /^.+@.+\..+$/.test(email);
+    }
+
+    /**
+     * Tests if given string is valid URL.
+     *
+     * Note: Dataurl are considered perfectly valid.
+     * Note: There are two simmilar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidUrl(url) {
+        if (typeof url !== 'string') {
+            return false;
+        }
+        try {
+            if (url.startsWith('blob:')) {
+                url = url.replace(/^blob:/, '');
+            }
+            const urlObject = new URL(url /* because fail is handled */);
+            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+
+    /**
+     * 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];
+        }
+    }
+
+    /**
+     * Just marks a place of place where should be something implemented
+     * No side effects.
+     *
+     * Note: It can be usefull suppressing eslint errors of unused variables
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function TODO_USE(...value) {
+    }
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideFilesystemForNode(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+        }
+        return {
+            stat: promises.stat,
+            access: promises.access,
+            constants: promises.constants,
+            readFile: promises.readFile,
+            writeFile: promises.writeFile,
+            readdir: promises.readdir,
+            mkdir: promises.mkdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Orders JSON object by keys
+     *
+     * @returns The same type of object as the input re-ordered
+     * @public exported from `@promptbook/utils`
+     */
+    function orderJson(options) {
+        const { value, order } = options;
+        const orderedValue = {
+            ...(order === undefined ? {} : Object.fromEntries(order.map((key) => [key, undefined]))),
+            ...value,
+        };
+        return orderedValue;
+    }
+
+    /**
+     * Freezes the given object and all its nested objects recursively
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
+     * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+     *
+     * @returns The same object as the input, but deeply frozen
+     * @public exported from `@promptbook/utils`
+     */
+    function $deepFreeze(objectValue) {
+        if (Array.isArray(objectValue)) {
+            return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
+        }
+        const propertyNames = Object.getOwnPropertyNames(objectValue);
+        for (const propertyName of propertyNames) {
+            const value = objectValue[propertyName];
+            if (value && typeof value === 'object') {
+                $deepFreeze(value);
+            }
+        }
+        Object.freeze(objectValue);
+        return objectValue;
+    }
+    /**
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
+
+    /**
+     * Checks if the value is [🚉] serializable as JSON
+     * If not, throws an UnexpectedError with a rich error message and tracking
+     *
+     * - Almost all primitives are serializable BUT:
+     * - `undefined` is not serializable
+     * - `NaN` is not serializable
+     * - Objects and arrays are serializable if all their properties are serializable
+     * - Functions are not serializable
+     * - Circular references are not serializable
+     * - `Date` objects are not serializable
+     * - `Map` and `Set` objects are not serializable
+     * - `RegExp` objects are not serializable
+     * - `Error` objects are not serializable
+     * - `Symbol` objects are not serializable
+     * - And much more...
+     *
+     * @throws UnexpectedError if the value is not serializable as JSON
+     * @public exported from `@promptbook/utils`
+     */
+    function checkSerializableAsJson(options) {
+        const { value, name, message } = options;
+        if (value === undefined) {
+            throw new UnexpectedError(`${name} is undefined`);
+        }
+        else if (value === null) {
+            return;
+        }
+        else if (typeof value === 'boolean') {
+            return;
+        }
+        else if (typeof value === 'number' && !isNaN(value)) {
+            return;
+        }
+        else if (typeof value === 'string') {
+            return;
+        }
+        else if (typeof value === 'symbol') {
+            throw new UnexpectedError(`${name} is symbol`);
+        }
+        else if (typeof value === 'function') {
+            throw new UnexpectedError(`${name} is function`);
+        }
+        else if (typeof value === 'object' && Array.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
+            }
+        }
+        else if (typeof value === 'object') {
+            if (value instanceof Date) {
+                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                        \`${name}\` is Date
+
+                        Use \`string_date_iso8601\` instead
+
+                        Additional message for \`${name}\`:
+                        ${block(message || '(nothing)')}
+                    `));
+            }
+            else if (value instanceof Map) {
+                throw new UnexpectedError(`${name} is Map`);
+            }
+            else if (value instanceof Set) {
+                throw new UnexpectedError(`${name} is Set`);
+            }
+            else if (value instanceof RegExp) {
+                throw new UnexpectedError(`${name} is RegExp`);
+            }
+            else if (value instanceof Error) {
+                throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                        \`${name}\` is unserialized Error
+
+                        Use function \`serializeError\`
+
+                        Additional message for \`${name}\`:
+                        ${block(message || '(nothing)')}
 
                     `));
             }
@@ -1051,51 +1497,22 @@
         if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
             // console.log(filename, 'Relative path: ./hello.txt');
             return true;
-        }
-        // Allow paths like foo/hello
-        if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
-            // console.log(filename, 'Allow paths like foo/hello');
-            return true;
-        }
-        // Allow paths like hello.book
-        if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-            // console.log(filename, 'Allow paths like hello.book');
-            return true;
-        }
-        return false;
-    }
-    /**
-     * TODO: [🍏] Implement for MacOs
-     */
-
-    /**
-     * Tests if given string is valid URL.
-     *
-     * Note: Dataurl are considered perfectly valid.
-     * Note: There are two simmilar functions:
-     * - `isValidUrl` which tests any URL
-     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function isValidUrl(url) {
-        if (typeof url !== 'string') {
-            return false;
-        }
-        try {
-            if (url.startsWith('blob:')) {
-                url = url.replace(/^blob:/, '');
-            }
-            const urlObject = new URL(url /* because fail is handled */);
-            if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
-                return false;
-            }
+        }
+        // Allow paths like foo/hello
+        if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
+            // console.log(filename, 'Allow paths like foo/hello');
             return true;
         }
-        catch (error) {
-            return false;
+        // Allow paths like hello.book
+        if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
+            // console.log(filename, 'Allow paths like hello.book');
+            return true;
         }
+        return false;
     }
+    /**
+     * TODO: [🍏] Implement for MacOs
+     */
 
     const defaultDiacriticsRemovalMap = [
         {
@@ -1509,703 +1926,743 @@
      */
 
     /**
-     * Generates random token
+     * This error indicates problems parsing the format value
      *
-     * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
+     * For example, when the format value is not a valid JSON or CSV
+     * This is not thrown directly but in extended classes
      *
-     * @private internal helper function
-     * @returns secure random token
+     * @public exported from `@promptbook/core`
      */
-    function $randomToken(randomness) {
-        return crypto.randomBytes(randomness).toString('hex');
+    class AbstractFormatError extends Error {
+        // Note: To allow instanceof do not put here error `name`
+        // public readonly name = 'AbstractFormatError';
+        constructor(message) {
+            super(message);
+            Object.setPrototypeOf(this, AbstractFormatError.prototype);
+        }
     }
-    /**
-     * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
-     */
 
     /**
-     * This error indicates errors during the execution of the pipeline
+     * This error indicates problem with parsing of CSV
      *
      * @public exported from `@promptbook/core`
      */
-    class PipelineExecutionError extends Error {
+    class CsvFormatError extends AbstractFormatError {
         constructor(message) {
-            // Added id parameter
             super(message);
-            this.name = 'PipelineExecutionError';
-            // TODO: [🐙] DRY - Maybe $randomId
-            this.id = `error-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid simmilar char conflicts   */)}`;
-            Object.setPrototypeOf(this, PipelineExecutionError.prototype);
+            this.name = 'CsvFormatError';
+            Object.setPrototypeOf(this, CsvFormatError.prototype);
         }
     }
-    /**
-     * TODO: !!!!!! Add id to all errors
-     */
 
     /**
-     * Stores data in memory (HEAP)
+     * AuthenticationError is thrown from login function which is dependency of remote server
      *
      * @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];
+    class AuthenticationError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'AuthenticationError';
+            Object.setPrototypeOf(this, AuthenticationError.prototype);
         }
     }
 
     /**
-     * Simple wrapper `new Date().toISOString()`
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
+     * This error indicates that the pipeline collection cannot be propperly loaded
      *
-     * @returns string_date branded type
-     * @public exported from `@promptbook/utils`
+     * @public exported from `@promptbook/core`
      */
-    function $getCurrentDate() {
-        return new Date().toISOString();
+    class CollectionError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'CollectionError';
+            Object.setPrototypeOf(this, CollectionError.prototype);
+        }
     }
 
     /**
-     * Intercepts LLM tools and counts total usage of the tools
-     *
-     * Note: It can take extended `LlmExecutionTools` and cache the
+     * This error occurs when some expectation is not met in the execution of the pipeline
      *
-     * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
-     * @returns LLM tools with same functionality with added total cost counting
      * @public exported from `@promptbook/core`
+     * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
+     * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
+     * Note: This is a kindof subtype of PipelineExecutionError
      */
-    function cacheLlmTools(llmTools, options = {}) {
-        const { storage = new MemoryStorage(), isCacheReloaded = false } = options;
-        const proxyTools = {
-            ...llmTools,
-            // <- Note: [🥫]
-            get title() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.title;
-            },
-            get description() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.description;
-            },
-            listModels() {
-                // TODO: [🧠] Should be model listing also cached?
-                return /* not await */ llmTools.listModels();
-            },
-        };
-        const callCommonModel = async (prompt) => {
-            const { parameters, content, modelRequirements } = prompt;
-            // <- Note: These are relevant things from the prompt that the cache key should depend on.
-            const key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
-                '-' +
-                sha256__default["default"](hexEncoder__default["default"].parse(JSON.stringify({ parameters, content, modelRequirements }))).toString( /* hex */));
-            const cacheItem = !isCacheReloaded ? await storage.getItem(key) : null;
-            if (cacheItem) {
-                return cacheItem.promptResult;
-            }
-            let promptResult;
-            variant: switch (prompt.modelRequirements.modelVariant) {
-                case 'CHAT':
-                    promptResult = await llmTools.callChatModel(prompt);
-                    break variant;
-                case 'COMPLETION':
-                    promptResult = await llmTools.callCompletionModel(prompt);
-                    break variant;
-                case 'EMBEDDING':
-                    promptResult = await llmTools.callEmbeddingModel(prompt);
-                    break variant;
-                // <- case [🤖]:
-                default:
-                    throw new PipelineExecutionError(`Unknown model variant "${prompt.modelRequirements.modelVariant}"`);
-            }
-            // TODO: [🧠] !!5 How to do timing in mixed cache / non-cache situation
-            // promptResult.timing: FromtoItems
-            await storage.setItem(key, {
-                date: $getCurrentDate(),
-                promptbookVersion: PROMPTBOOK_ENGINE_VERSION,
-                prompt,
-                promptResult,
-            });
-            return promptResult;
-        };
-        if (llmTools.callChatModel !== undefined) {
-            proxyTools.callChatModel = async (prompt) => {
-                return /* not await */ callCommonModel(prompt);
-            };
-        }
-        if (llmTools.callCompletionModel !== undefined) {
-            proxyTools.callCompletionModel = async (prompt) => {
-                return /* not await */ callCommonModel(prompt);
-            };
-        }
-        if (llmTools.callEmbeddingModel !== undefined) {
-            proxyTools.callEmbeddingModel = async (prompt) => {
-                return /* not await */ callCommonModel(prompt);
-            };
+    class ExpectError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'ExpectError';
+            Object.setPrototypeOf(this, ExpectError.prototype);
         }
-        // <- Note: [🤖]
-        return proxyTools;
     }
-    /**
-     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
-     * TODO: [🧠] Is there some meaningfull way how to test this util
-     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
-     *            @@@ write discussion about this and storages
-     *            @@@ write how to combine multiple interceptors
-     */
 
     /**
-     * Represents the uncertain value
+     * This error indicates that the promptbook can not retrieve knowledge from external sources
      *
      * @public exported from `@promptbook/core`
      */
-    const ZERO_VALUE = $deepFreeze({ value: 0 });
+    class KnowledgeScrapeError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'KnowledgeScrapeError';
+            Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
+        }
+    }
+
     /**
-     * Represents the uncertain value
+     * This error type indicates that some limit was reached
      *
      * @public exported from `@promptbook/core`
      */
-    const UNCERTAIN_ZERO_VALUE = $deepFreeze({ value: 0, isUncertain: true });
+    class LimitReachedError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'LimitReachedError';
+            Object.setPrototypeOf(this, LimitReachedError.prototype);
+        }
+    }
+
     /**
-     * Represents the usage with no resources consumed
+     * This error type indicates that some tools are missing for pipeline execution or preparation
      *
      * @public exported from `@promptbook/core`
      */
-    const ZERO_USAGE = $deepFreeze({
-        price: ZERO_VALUE,
-        input: {
-            tokensCount: ZERO_VALUE,
-            charactersCount: ZERO_VALUE,
-            wordsCount: ZERO_VALUE,
-            sentencesCount: ZERO_VALUE,
-            linesCount: ZERO_VALUE,
-            paragraphsCount: ZERO_VALUE,
-            pagesCount: ZERO_VALUE,
-        },
-        output: {
-            tokensCount: ZERO_VALUE,
-            charactersCount: ZERO_VALUE,
-            wordsCount: ZERO_VALUE,
-            sentencesCount: ZERO_VALUE,
-            linesCount: ZERO_VALUE,
-            paragraphsCount: ZERO_VALUE,
-            pagesCount: ZERO_VALUE,
-        },
-    });
+    class MissingToolsError extends Error {
+        constructor(message) {
+            super(spaceTrim.spaceTrim((block) => `
+                    ${block(message)}
+
+                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation
+
+                `));
+            this.name = 'MissingToolsError';
+            Object.setPrototypeOf(this, MissingToolsError.prototype);
+        }
+    }
+
+    /**
+     * This error indicates that promptbook not found in the collection
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class NotFoundError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'NotFoundError';
+            Object.setPrototypeOf(this, NotFoundError.prototype);
+        }
+    }
+
     /**
-     * Represents the usage with unknown resources consumed
+     * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
      *
      * @public exported from `@promptbook/core`
      */
-    const UNCERTAIN_USAGE = $deepFreeze({
-        price: UNCERTAIN_ZERO_VALUE,
-        input: {
-            tokensCount: UNCERTAIN_ZERO_VALUE,
-            charactersCount: UNCERTAIN_ZERO_VALUE,
-            wordsCount: UNCERTAIN_ZERO_VALUE,
-            sentencesCount: UNCERTAIN_ZERO_VALUE,
-            linesCount: UNCERTAIN_ZERO_VALUE,
-            paragraphsCount: UNCERTAIN_ZERO_VALUE,
-            pagesCount: UNCERTAIN_ZERO_VALUE,
-        },
-        output: {
-            tokensCount: UNCERTAIN_ZERO_VALUE,
-            charactersCount: UNCERTAIN_ZERO_VALUE,
-            wordsCount: UNCERTAIN_ZERO_VALUE,
-            sentencesCount: UNCERTAIN_ZERO_VALUE,
-            linesCount: UNCERTAIN_ZERO_VALUE,
-            paragraphsCount: UNCERTAIN_ZERO_VALUE,
-            pagesCount: UNCERTAIN_ZERO_VALUE,
-        },
-    });
+    class ParseError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'ParseError';
+            Object.setPrototypeOf(this, ParseError.prototype);
+        }
+    }
     /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * TODO: Maybe split `ParseError` and `ApplyError`
      */
 
     /**
-     * Function `addUsage` will add multiple usages into one
+     * Generates random token
      *
-     * Note: If you provide 0 values, it returns ZERO_USAGE
+     * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
      *
-     * @public exported from `@promptbook/core`
+     * @private internal helper function
+     * @returns secure random token
      */
-    function addUsage(...usageItems) {
-        return usageItems.reduce((acc, item) => {
-            var _a;
-            acc.price.value += ((_a = item.price) === null || _a === void 0 ? void 0 : _a.value) || 0;
-            for (const key of Object.keys(acc.input)) {
-                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                //@ts-ignore
-                if (item.input[key]) {
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    acc.input[key].value += item.input[key].value || 0;
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    if (item.input[key].isUncertain) {
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        acc.input[key].isUncertain = true;
-                    }
-                }
-            }
-            for (const key of Object.keys(acc.output)) {
-                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                //@ts-ignore
-                if (item.output[key]) {
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    acc.output[key].value += item.output[key].value || 0;
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    //@ts-ignore
-                    if (item.output[key].isUncertain) {
-                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                        //@ts-ignore
-                        acc.output[key].isUncertain = true;
-                    }
-                }
-            }
-            return acc;
-        }, deepClone(ZERO_USAGE));
+    function $randomToken(randomness) {
+        return crypto.randomBytes(randomness).toString('hex');
     }
+    /**
+     * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
+     */
 
     /**
-     * Intercepts LLM tools and counts total usage of the tools
+     * This error indicates errors during the execution of the pipeline
      *
-     * @param llmTools LLM tools to be intercepted with usage counting
-     * @returns LLM tools with same functionality with added total cost counting
      * @public exported from `@promptbook/core`
      */
-    function countUsage(llmTools) {
-        let totalUsage = ZERO_USAGE;
-        const spending = new rxjs.Subject();
-        const proxyTools = {
-            get title() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.title;
-            },
-            get description() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.description;
-            },
-            checkConfiguration() {
-                return /* not await */ llmTools.checkConfiguration();
-            },
-            listModels() {
-                return /* not await */ llmTools.listModels();
-            },
-            spending() {
-                return spending.asObservable();
-            },
-            getTotalUsage() {
-                // <- Note: [🥫] Not using getter `get totalUsage` but `getTotalUsage` to allow this object to be proxied
-                return totalUsage;
-            },
-        };
-        if (llmTools.callChatModel !== undefined) {
-            proxyTools.callChatModel = async (prompt) => {
-                // console.info('[🚕] callChatModel through countTotalUsage');
-                const promptResult = await llmTools.callChatModel(prompt);
-                totalUsage = addUsage(totalUsage, promptResult.usage);
-                spending.next(promptResult.usage);
-                return promptResult;
-            };
-        }
-        if (llmTools.callCompletionModel !== undefined) {
-            proxyTools.callCompletionModel = async (prompt) => {
-                // console.info('[🚕] callCompletionModel through countTotalUsage');
-                const promptResult = await llmTools.callCompletionModel(prompt);
-                totalUsage = addUsage(totalUsage, promptResult.usage);
-                spending.next(promptResult.usage);
-                return promptResult;
-            };
-        }
-        if (llmTools.callEmbeddingModel !== undefined) {
-            proxyTools.callEmbeddingModel = async (prompt) => {
-                // console.info('[🚕] callEmbeddingModel through countTotalUsage');
-                const promptResult = await llmTools.callEmbeddingModel(prompt);
-                totalUsage = addUsage(totalUsage, promptResult.usage);
-                spending.next(promptResult.usage);
-                return promptResult;
-            };
+    class PipelineExecutionError extends Error {
+        constructor(message) {
+            // Added id parameter
+            super(message);
+            this.name = 'PipelineExecutionError';
+            // TODO: [🐙] DRY - Maybe $randomId
+            this.id = `error-${$randomToken(8 /* <- TODO: To global config + Use Base58 to avoid simmilar char conflicts   */)}`;
+            Object.setPrototypeOf(this, PipelineExecutionError.prototype);
         }
-        // <- Note: [🤖]
-        return proxyTools;
     }
     /**
-     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
-     * TODO: [🧠] Is there some meaningfull way how to test this util
-     * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
-     *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
-     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     * TODO: !!!!!! Add id to all errors
      */
 
     /**
-     * This error type indicates that some part of the code is not implemented yet
+     * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
      *
      * @public exported from `@promptbook/core`
      */
-    class NotYetImplementedError extends Error {
+    class PipelineLogicError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
-                    ${block(message)}
+            super(message);
+            this.name = 'PipelineLogicError';
+            Object.setPrototypeOf(this, PipelineLogicError.prototype);
+        }
+    }
 
-                    Note: This feature is not implemented yet but it will be soon.
+    /**
+     * This error indicates errors in referencing promptbooks between each other
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class PipelineUrlError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'PipelineUrlError';
+            Object.setPrototypeOf(this, PipelineUrlError.prototype);
+        }
+    }
 
-                    If you want speed up the implementation or just read more, look here:
-                    https://github.com/webgptorg/promptbook
+    /**
+     * Index of all custom errors
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const PROMPTBOOK_ERRORS = {
+        AbstractFormatError,
+        CsvFormatError,
+        CollectionError,
+        EnvironmentMismatchError,
+        ExpectError,
+        KnowledgeScrapeError,
+        LimitReachedError,
+        MissingToolsError,
+        NotFoundError,
+        NotYetImplementedError,
+        ParseError,
+        PipelineExecutionError,
+        PipelineLogicError,
+        PipelineUrlError,
+        UnexpectedError,
+        // TODO: [🪑]> VersionMismatchError,
+    };
+    /**
+     * Index of all javascript errors
+     *
+     * @private for internal usage
+     */
+    const COMMON_JAVASCRIPT_ERRORS = {
+        Error,
+        EvalError,
+        RangeError,
+        ReferenceError,
+        SyntaxError,
+        TypeError,
+        URIError,
+        AggregateError,
+        AuthenticationError,
+        /*
+      Note: Not widely supported
+      > InternalError,
+      > ModuleError,
+      > HeapError,
+      > WebAssemblyCompileError,
+      > WebAssemblyRuntimeError,
+      */
+    };
+    /**
+     * Index of all errors
+     *
+     * @private for internal usage
+     */
+    const ALL_ERRORS = {
+        ...PROMPTBOOK_ERRORS,
+        ...COMMON_JAVASCRIPT_ERRORS,
+    };
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
 
-                    Or contact us on pavol@ptbk.io
+    /**
+     * Deserializes the error object
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function deserializeError(error) {
+        const { name, stack, id } = error; // Added id
+        let { message } = error;
+        let ErrorClass = ALL_ERRORS[error.name];
+        if (ErrorClass === undefined) {
+            ErrorClass = Error;
+            message = `${name}: ${message}`;
+        }
+        if (stack !== undefined && stack !== '') {
+            message = spaceTrim__default["default"]((block) => `
+                ${block(message)}
 
-                `));
-            this.name = 'NotYetImplementedError';
-            Object.setPrototypeOf(this, NotYetImplementedError.prototype);
+                Original stack trace:
+                ${block(stack || '')}
+            `);
         }
+        const deserializedError = new ErrorClass(message);
+        deserializedError.id = id; // Assign id to the error object
+        return deserializedError;
     }
 
     /**
-     * @@@
+     * Creates a connection to the remote proxy server.
      *
-     * Note: `$` is used to indicate that this function is not a pure function - it access global scope
+     * Note: This function creates a connection to the remote server and returns a socket but responsibility of closing the connection is on the caller
      *
-     *  @private internal function of `$Register`
+     * @private internal utility function
      */
-    function $getGlobalScope() {
-        return Function('return this')();
+    async function createRemoteClient(options) {
+        const { remoteServerUrl } = options;
+        let path = new URL(remoteServerUrl).pathname;
+        if (path.endsWith('/')) {
+            path = path.slice(0, -1);
+        }
+        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'],
+            });
+            // console.log('Connecting to', this.options.remoteServerUrl.href, { socket });
+            socket.on('connect', () => {
+                resolve(socket);
+            });
+            // TODO: [💩] Better timeout handling
+            setTimeout(() => {
+                reject(new Error(`Timeout while connecting to ${remoteServerUrl}`));
+            }, CONNECTION_TIMEOUT_MS);
+        });
     }
 
     /**
-     * @@@
+     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
      *
-     * @param text @@@
-     * @returns @@@
-     * @example 'HELLO_WORLD'
-     * @example 'I_LOVE_PROMPTBOOK'
-     * @public exported from `@promptbook/utils`
+     * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
+     * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
+     *
+     * @see https://github.com/webgptorg/promptbook#remote-server
+     * @public exported from `@promptbook/remote-client`
      */
-    function normalizeTo_SCREAMING_CASE(text) {
-        let charType;
-        let lastCharType = 'OTHER';
-        let normalizedName = '';
-        for (const char of text) {
-            let normalizedChar;
-            if (/^[a-z]$/.test(char)) {
-                charType = 'LOWERCASE';
-                normalizedChar = char.toUpperCase();
-            }
-            else if (/^[A-Z]$/.test(char)) {
-                charType = 'UPPERCASE';
-                normalizedChar = char;
-            }
-            else if (/^[0-9]$/.test(char)) {
-                charType = 'NUMBER';
-                normalizedChar = char;
+    class RemoteLlmExecutionTools {
+        /* <- TODO: [🍚] `, Destroyable` */
+        constructor(options) {
+            this.options = options;
+        }
+        get title() {
+            // TODO: [🧠] Maybe fetch title+description from the remote server (as well as if model methods are defined)
+            return 'Remote server';
+        }
+        get description() {
+            return 'Use all models by your remote server';
+        }
+        /**
+         * Check the configuration of all execution tools
+         */
+        async checkConfiguration() {
+            const socket = await createRemoteClient(this.options);
+            socket.disconnect();
+            // TODO: [main] !!3 Check version of the remote server and compatibility
+            // TODO: [🎍] Send checkConfiguration
+        }
+        /**
+         * List all available models that can be used
+         */
+        async listModels() {
+            // TODO: [👒] Listing models (and checking configuration) probbably should go through REST API not Socket.io
+            const socket = await createRemoteClient(this.options);
+            socket.emit('listModels-request', {
+                identification: this.options.identification,
+            } /* <- Note: [🤛] */);
+            const promptResult = await new Promise((resolve, reject) => {
+                socket.on('listModels-response', (response) => {
+                    resolve(response.models);
+                    socket.disconnect();
+                });
+                socket.on('error', (error) => {
+                    reject(deserializeError(error));
+                    socket.disconnect();
+                });
+            });
+            socket.disconnect();
+            return promptResult;
+        }
+        /**
+         * Calls remote proxy server to use a chat model
+         */
+        callChatModel(prompt) {
+            if (this.options.isVerbose) {
+                console.info(`🖋 Remote callChatModel call`);
             }
-            else {
-                charType = 'OTHER';
-                normalizedChar = '_';
+            return /* not await */ this.callCommonModel(prompt);
+        }
+        /**
+         * Calls remote proxy server to use a completion model
+         */
+        callCompletionModel(prompt) {
+            if (this.options.isVerbose) {
+                console.info(`💬 Remote callCompletionModel call`);
             }
-            if (charType !== lastCharType &&
-                !(lastCharType === 'UPPERCASE' && charType === 'LOWERCASE') &&
-                !(lastCharType === 'NUMBER') &&
-                !(charType === 'NUMBER')) {
-                normalizedName += '_';
+            return /* not await */ this.callCommonModel(prompt);
+        }
+        /**
+         * Calls remote proxy server to use a embedding model
+         */
+        callEmbeddingModel(prompt) {
+            if (this.options.isVerbose) {
+                console.info(`💬 Remote callEmbeddingModel call`);
             }
-            normalizedName += normalizedChar;
-            lastCharType = charType;
+            return /* not await */ this.callCommonModel(prompt);
+        }
+        // <- Note: [🤖] callXxxModel
+        /**
+         * Calls remote proxy server to use both completion or chat model
+         */
+        async callCommonModel(prompt) {
+            const socket = await createRemoteClient(this.options);
+            socket.emit('prompt-request', {
+                identification: this.options.identification,
+                prompt,
+            } /* <- Note: [🤛] */);
+            const promptResult = await new Promise((resolve, reject) => {
+                socket.on('prompt-response', (response) => {
+                    resolve(response.promptResult);
+                    socket.disconnect();
+                });
+                socket.on('error', (error) => {
+                    reject(deserializeError(error));
+                    socket.disconnect();
+                });
+            });
+            socket.disconnect();
+            return promptResult;
         }
-        normalizedName = normalizedName.replace(/_+/g, '_');
-        normalizedName = normalizedName.replace(/_?\/_?/g, '/');
-        normalizedName = normalizedName.replace(/^_/, '');
-        normalizedName = normalizedName.replace(/_$/, '');
-        return normalizedName;
     }
     /**
-     * TODO: Tests
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'Moje tabule' })).toEqual('/VtG7sR9rRJqwNEdM2/Moje tabule');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: 'ěščřžžýáíúů' })).toEqual('/VtG7sR9rRJqwNEdM2/escrzyaieuu');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj');
-     *     > expect(encodeRoutePath({ uriId: 'VtG7sR9rRJqwNEdM2', name: '  ahoj_ahojAhoj    ahoj  ' })).toEqual('/VtG7sR9rRJqwNEdM2/ahoj-ahoj-ahoj-ahoj');
-     * TODO: [🌺] Use some intermediate util splitWords
+     * TODO: Maybe use `$exportJson`
+     * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
+     * TODO: [🍓] Allow to list compatible models with each variant
+     * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable
+     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
+     * TODO: [🧠] Maybe remove `@promptbook/remote-client` and just use `@promptbook/core`
      */
 
     /**
-     * @@@
+     * Simple wrapper `new Date().toISOString()`
      *
-     * @param text @@@
-     * @returns @@@
-     * @example 'hello_world'
-     * @example 'i_love_promptbook'
+     * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
+     *
+     * @returns string_date branded type
      * @public exported from `@promptbook/utils`
      */
-    function normalizeTo_snake_case(text) {
-        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
+    function $getCurrentDate() {
+        return new Date().toISOString();
     }
 
     /**
-     * Register is @@@
+     * Intercepts LLM tools and counts total usage of the tools
      *
-     * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
+     * Note: It can take extended `LlmExecutionTools` and cache the
      *
-     * @private internal utility, exported are only signleton instances of this class
+     * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
+     * @returns LLM tools with same functionality with added total cost counting
+     * @public exported from `@promptbook/core`
      */
-    class $Register {
-        constructor(registerName) {
-            this.registerName = registerName;
-            const storageName = `_promptbook_${normalizeTo_snake_case(registerName)}`;
-            const globalScope = $getGlobalScope();
-            if (globalScope[storageName] === undefined) {
-                globalScope[storageName] = [];
+    function cacheLlmTools(llmTools, options = {}) {
+        const { storage = new MemoryStorage(), isCacheReloaded = false } = options;
+        const proxyTools = {
+            ...llmTools,
+            // <- Note: [🥫]
+            get title() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.title;
+            },
+            get description() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.description;
+            },
+            listModels() {
+                // TODO: [🧠] Should be model listing also cached?
+                return /* not await */ llmTools.listModels();
+            },
+        };
+        const callCommonModel = async (prompt) => {
+            const { parameters, content, modelRequirements } = prompt;
+            // <- Note: These are relevant things from the prompt that the cache key should depend on.
+            const key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
+                '-' +
+                sha256__default["default"](hexEncoder__default["default"].parse(JSON.stringify({ parameters, content, modelRequirements }))).toString( /* hex */));
+            const cacheItem = !isCacheReloaded ? await storage.getItem(key) : null;
+            if (cacheItem) {
+                return cacheItem.promptResult;
             }
-            else if (!Array.isArray(globalScope[storageName])) {
-                throw new UnexpectedError(`Expected (global) ${storageName} to be an array, but got ${typeof globalScope[storageName]}`);
+            let promptResult;
+            variant: switch (prompt.modelRequirements.modelVariant) {
+                case 'CHAT':
+                    promptResult = await llmTools.callChatModel(prompt);
+                    break variant;
+                case 'COMPLETION':
+                    promptResult = await llmTools.callCompletionModel(prompt);
+                    break variant;
+                case 'EMBEDDING':
+                    promptResult = await llmTools.callEmbeddingModel(prompt);
+                    break variant;
+                // <- case [🤖]:
+                default:
+                    throw new PipelineExecutionError(`Unknown model variant "${prompt.modelRequirements.modelVariant}"`);
             }
-            this.storage = globalScope[storageName];
+            // TODO: [🧠] !!5 How to do timing in mixed cache / non-cache situation
+            // promptResult.timing: FromtoItems
+            await storage.setItem(key, {
+                date: $getCurrentDate(),
+                promptbookVersion: PROMPTBOOK_ENGINE_VERSION,
+                prompt,
+                promptResult,
+            });
+            return promptResult;
+        };
+        if (llmTools.callChatModel !== undefined) {
+            proxyTools.callChatModel = async (prompt) => {
+                return /* not await */ callCommonModel(prompt);
+            };
         }
-        list() {
-            // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
-            return this.storage;
+        if (llmTools.callCompletionModel !== undefined) {
+            proxyTools.callCompletionModel = async (prompt) => {
+                return /* not await */ callCommonModel(prompt);
+            };
         }
-        register(registered) {
-            const { packageName, className } = registered;
-            const existingRegistrationIndex = this.storage.findIndex((item) => item.packageName === packageName && item.className === className);
-            const existingRegistration = this.storage[existingRegistrationIndex];
-            if (!existingRegistration) {
-                this.storage.push(registered);
-            }
-            else {
-                this.storage[existingRegistrationIndex] = registered;
-            }
-            return {
-                registerName: this.registerName,
-                packageName,
-                className,
-                get isDestroyed() {
-                    return false;
-                },
-                destroy() {
-                    throw new NotYetImplementedError(`Registration to ${this.registerName} is permanent in this version of Promptbook`);
-                },
+        if (llmTools.callEmbeddingModel !== undefined) {
+            proxyTools.callEmbeddingModel = async (prompt) => {
+                return /* not await */ callCommonModel(prompt);
             };
         }
+        // <- Note: [🤖]
+        return proxyTools;
     }
-
-    /**
-     * @@@
-     *
-     * Note: `$` is used to indicate that this interacts with the global scope
-     * @singleton Only one instance of each register is created per build, but thare can be more @@@
-     * @public exported from `@promptbook/core`
-     */
-    const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
     /**
-     * TODO: [®] DRY Register logic
+     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+     * TODO: [🧠] Is there some meaningfull way how to test this util
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     *            @@@ write discussion about this and storages
+     *            @@@ write how to combine multiple interceptors
      */
 
     /**
-     * Determines if the given path is a root path.
+     * Represents the uncertain value
      *
-     * 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
+     * @public exported from `@promptbook/core`
      */
-
+    const ZERO_VALUE = $deepFreeze({ value: 0 });
     /**
-     * @@@
+     * Represents the uncertain value
      *
-     * Note: `$` is used to indicate that this interacts with the global scope
-     * @singleton Only one instance of each register is created per build, but thare can be more @@@
      * @public exported from `@promptbook/core`
      */
-    const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
+    const UNCERTAIN_ZERO_VALUE = $deepFreeze({ value: 0, isUncertain: true });
     /**
-     * TODO: [®] DRY Register logic
+     * Represents the usage with no resources consumed
+     *
+     * @public exported from `@promptbook/core`
      */
-
+    const ZERO_USAGE = $deepFreeze({
+        price: ZERO_VALUE,
+        input: {
+            tokensCount: ZERO_VALUE,
+            charactersCount: ZERO_VALUE,
+            wordsCount: ZERO_VALUE,
+            sentencesCount: ZERO_VALUE,
+            linesCount: ZERO_VALUE,
+            paragraphsCount: ZERO_VALUE,
+            pagesCount: ZERO_VALUE,
+        },
+        output: {
+            tokensCount: ZERO_VALUE,
+            charactersCount: ZERO_VALUE,
+            wordsCount: ZERO_VALUE,
+            sentencesCount: ZERO_VALUE,
+            linesCount: ZERO_VALUE,
+            paragraphsCount: ZERO_VALUE,
+            pagesCount: ZERO_VALUE,
+        },
+    });
     /**
-     * Path to the `.env` file which was used to configure LLM tools
+     * Represents the usage with unknown resources consumed
      *
-     * Note: `$` is used to indicate that this variable is changed by side effect in `$provideLlmToolsConfigurationFromEnv` through `$setUsedEnvFilename`
+     * @public exported from `@promptbook/core`
      */
-    let $usedEnvFilename = null;
+    const UNCERTAIN_USAGE = $deepFreeze({
+        price: UNCERTAIN_ZERO_VALUE,
+        input: {
+            tokensCount: UNCERTAIN_ZERO_VALUE,
+            charactersCount: UNCERTAIN_ZERO_VALUE,
+            wordsCount: UNCERTAIN_ZERO_VALUE,
+            sentencesCount: UNCERTAIN_ZERO_VALUE,
+            linesCount: UNCERTAIN_ZERO_VALUE,
+            paragraphsCount: UNCERTAIN_ZERO_VALUE,
+            pagesCount: UNCERTAIN_ZERO_VALUE,
+        },
+        output: {
+            tokensCount: UNCERTAIN_ZERO_VALUE,
+            charactersCount: UNCERTAIN_ZERO_VALUE,
+            wordsCount: UNCERTAIN_ZERO_VALUE,
+            sentencesCount: UNCERTAIN_ZERO_VALUE,
+            linesCount: UNCERTAIN_ZERO_VALUE,
+            paragraphsCount: UNCERTAIN_ZERO_VALUE,
+            pagesCount: UNCERTAIN_ZERO_VALUE,
+        },
+    });
     /**
-     * Pass the `.env` file which was used to configure LLM tools
-     *
-     * Note: `$` is used to indicate that this variable is making side effect
-     *
-     * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
+     * Note: [💞] Ignore a discrepancy between file name and entity name
      */
-    function $setUsedEnvFilename(filepath) {
-        $usedEnvFilename = filepath;
-    }
+
     /**
-     * Creates a message with all registered LLM tools
+     * Function `addUsage` will add multiple usages into one
      *
-     * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
+     * Note: If you provide 0 values, it returns ZERO_USAGE
      *
-     * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
+     * @public exported from `@promptbook/core`
      */
-    function $registeredLlmToolsMessage() {
-        let env;
-        if ($isRunningInNode()) {
-            env = process.env;
-            // <- TODO: [⚛] Some DRY way how to get to `process.env` and pass it into functions - ACRY search for `env`
-        }
-        else {
-            env = {};
-        }
-        /**
-         * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
-         */
-        const all = [];
-        for (const { title, packageName, className, envVariables } of $llmToolsMetadataRegister.list()) {
-            if (all.some((item) => item.packageName === packageName && item.className === className)) {
-                continue;
-            }
-            all.push({ title, packageName, className, envVariables });
-        }
-        for (const { packageName, className } of $llmToolsRegister.list()) {
-            if (all.some((item) => item.packageName === packageName && item.className === className)) {
-                continue;
+    function addUsage(...usageItems) {
+        return usageItems.reduce((acc, item) => {
+            var _a;
+            acc.price.value += ((_a = item.price) === null || _a === void 0 ? void 0 : _a.value) || 0;
+            for (const key of Object.keys(acc.input)) {
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                //@ts-ignore
+                if (item.input[key]) {
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    acc.input[key].value += item.input[key].value || 0;
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    if (item.input[key].isUncertain) {
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        acc.input[key].isUncertain = true;
+                    }
+                }
             }
-            all.push({ packageName, className });
-        }
-        const metadata = all.map((metadata) => {
-            var _a, _b;
-            const isMetadataAviailable = $llmToolsMetadataRegister
-                .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
-            const isInstalled = $llmToolsRegister
-                .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
-            const isFullyConfigured = ((_a = metadata.envVariables) === null || _a === void 0 ? void 0 : _a.every((envVariableName) => env[envVariableName] !== undefined)) || false;
-            const isPartiallyConfigured = ((_b = metadata.envVariables) === null || _b === void 0 ? void 0 : _b.some((envVariableName) => env[envVariableName] !== undefined)) || false;
-            // <- Note: [🗨]
-            return { ...metadata, isMetadataAviailable, isInstalled, isFullyConfigured, isPartiallyConfigured };
-        });
-        const usedEnvMessage = $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
-        if (metadata.length === 0) {
-            return spaceTrim__default["default"]((block) => `
-                No LLM providers are available.
-
-                ${block(usedEnvMessage)}
-          `);
-        }
-        return spaceTrim__default["default"]((block) => `
-
-            ${block(usedEnvMessage)}
-
-            Relevant environment variables:
-            ${block(Object.keys(env)
-        .filter((envVariableName) => metadata.some(({ envVariables }) => envVariables === null || envVariables === void 0 ? void 0 : envVariables.includes(envVariableName)))
-        .map((envVariableName) => `- \`${envVariableName}\``)
-        .join('\n'))}
-
-            Available LLM providers are:
-            ${block(metadata
-        .map(({ title, packageName, className, envVariables, isMetadataAviailable, isInstalled, isFullyConfigured, isPartiallyConfigured, }, i) => {
-        const morePieces = [];
-        if (just(false)) ;
-        else if (!isMetadataAviailable && !isInstalled) {
-            // TODO: [�][�] Maybe do allow to do auto-install if package not registered and not found
-            morePieces.push(`Not installed and no metadata, looks like a unexpected behavior`);
-        }
-        else if (isMetadataAviailable && !isInstalled) {
-            // TODO: [�][�]
-            morePieces.push(`Not installed`);
-        }
-        else if (!isMetadataAviailable && isInstalled) {
-            morePieces.push(`No metadata but installed, looks like a unexpected behavior`);
-        }
-        else if (isMetadataAviailable && isInstalled) {
-            morePieces.push(`Installed`);
+            for (const key of Object.keys(acc.output)) {
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                //@ts-ignore
+                if (item.output[key]) {
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    acc.output[key].value += item.output[key].value || 0;
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    //@ts-ignore
+                    if (item.output[key].isUncertain) {
+                        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                        //@ts-ignore
+                        acc.output[key].isUncertain = true;
+                    }
+                }
+            }
+            return acc;
+        }, deepClone(ZERO_USAGE));
+    }
+
+    /**
+     * Intercepts LLM tools and counts total usage of the tools
+     *
+     * @param llmTools LLM tools to be intercepted with usage counting
+     * @returns LLM tools with same functionality with added total cost counting
+     * @public exported from `@promptbook/core`
+     */
+    function countUsage(llmTools) {
+        let totalUsage = ZERO_USAGE;
+        const spending = new rxjs.Subject();
+        const proxyTools = {
+            get title() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.title;
+            },
+            get description() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.description;
+            },
+            checkConfiguration() {
+                return /* not await */ llmTools.checkConfiguration();
+            },
+            listModels() {
+                return /* not await */ llmTools.listModels();
+            },
+            spending() {
+                return spending.asObservable();
+            },
+            getTotalUsage() {
+                // <- Note: [🥫] Not using getter `get totalUsage` but `getTotalUsage` to allow this object to be proxied
+                return totalUsage;
+            },
+        };
+        if (llmTools.callChatModel !== undefined) {
+            proxyTools.callChatModel = async (prompt) => {
+                // console.info('[🚕] callChatModel through countTotalUsage');
+                const promptResult = await llmTools.callChatModel(prompt);
+                totalUsage = addUsage(totalUsage, promptResult.usage);
+                spending.next(promptResult.usage);
+                return promptResult;
+            };
         }
-        else {
-            morePieces.push(`unknown state, looks like a unexpected behavior`);
-        } /* not else */
-        if (isFullyConfigured) {
-            morePieces.push(`Configured`);
+        if (llmTools.callCompletionModel !== undefined) {
+            proxyTools.callCompletionModel = async (prompt) => {
+                // console.info('[🚕] callCompletionModel through countTotalUsage');
+                const promptResult = await llmTools.callCompletionModel(prompt);
+                totalUsage = addUsage(totalUsage, promptResult.usage);
+                spending.next(promptResult.usage);
+                return promptResult;
+            };
         }
-        else if (isPartiallyConfigured) {
-            morePieces.push(`Partially confugured, missing ${envVariables === null || envVariables === void 0 ? void 0 : envVariables.filter((envVariable) => env[envVariable] === undefined).join(' + ')}`);
+        if (llmTools.callEmbeddingModel !== undefined) {
+            proxyTools.callEmbeddingModel = async (prompt) => {
+                // console.info('[🚕] callEmbeddingModel through countTotalUsage');
+                const promptResult = await llmTools.callEmbeddingModel(prompt);
+                totalUsage = addUsage(totalUsage, promptResult.usage);
+                spending.next(promptResult.usage);
+                return promptResult;
+            };
         }
-        else {
-            if (envVariables !== null) {
-                morePieces.push(`Not configured, to configure set env ${envVariables === null || envVariables === void 0 ? void 0 : envVariables.join(' + ')}`);
-            }
-            else {
-                morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
-            }
+        // <- Note: [🤖]
+        return proxyTools;
+    }
+    /**
+     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+     * TODO: [🧠] Is there some meaningfull way how to test this util
+     * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+     *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
+     * 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;
         }
-        let providerMessage = spaceTrim__default["default"](`
-                                ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
-                                    ${morePieces.join('; ')}
-                            `);
-        if ($isRunningInNode) {
-            if (isInstalled && isFullyConfigured) {
-                providerMessage = colors__default["default"].green(providerMessage);
-            }
-            else if (isInstalled && isPartiallyConfigured) {
-                providerMessage = colors__default["default"].yellow(providerMessage);
-            }
-            else {
-                providerMessage = colors__default["default"].gray(providerMessage);
-            }
+        if (/^[A-Z]:\\$/i.test(value)) {
+            return true;
         }
-        return providerMessage;
-    })
-        .join('\n'))}
-        `);
+        return false;
     }
     /**
-     * TODO: [®] DRY Register logic
-     * TODO: [🧠][⚛] Maybe pass env as argument
+     * TODO: [🍏] Make for MacOS paths
      */
 
     /**
@@ -2568,10 +3025,33 @@
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizzardOrCli` works only in Node.js environment');
         }
-        const { isCacheReloaded } = options !== null && options !== void 0 ? options : {};
+        options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
+        const { strategy, isCacheReloaded } = options;
+        let llmExecutionTools;
+        if (strategy === 'REMOTE_SERVER') {
+            const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
+            const storage = new MemoryStorage(); // <- TODO: !!!!!! Save to `.promptbook` folder
+            const key = `${remoteServerUrl}-identification`;
+            let identification = await storage.getItem(key);
+            if (identification === null) {
+                identification = await loginPrompt();
+                await storage.setItem(key, identification);
+            }
+            llmExecutionTools = new RemoteLlmExecutionTools({
+                remoteServerUrl,
+                identification,
+            });
+        }
+        else if (strategy === 'BRING_YOUR_OWN_KEYS') {
+            llmExecutionTools = await $provideLlmToolsFromEnv();
+        }
+        else {
+            throw new UnexpectedError(`\`$provideLlmToolsForWizzardOrCli\` wrong strategy "${strategy}"`);
+        }
         return cacheLlmTools(countUsage(
+        //        <- TODO: [🌯] We dont use countUsage at all, maybe just unwrap it
         //        <- Note: for example here we don`t want the [🌯]
-        await $provideLlmToolsFromEnv()), {
+        llmExecutionTools), {
             storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
                 rootFolderPath: path.join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
             }),
@@ -2587,31 +3067,88 @@
      */
 
     /**
-     * Just says that the variable is not used but should be kept
-     * No side effects.
-     *
-     * Note: It can be usefull for:
-     *
-     * 1) Suppressing eager optimization of unused imports
-     * 2) Suppressing eslint errors of unused variables in the tests
-     * 3) Keeping the type of the variable for type testing
-     *
-     * @param value any values
-     * @returns void
-     * @private within the repository
-     */
-    function keepUnused(...valuesToKeep) {
-    }
-
-    /**
-     * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
-     *
-     * @param value any values
-     * @returns void
-     * @private within the repository
+     * @private utility of CLI
      */
-    function $sideEffect(...sideEffectSubjects) {
-        keepUnused(...sideEffectSubjects);
+    function $provideLlmToolsForCli(options) {
+        const { cliOptions: { 
+        /* TODO: Use verbose: isVerbose, */ interactive: isInteractive, provider, remoteServerUrl: remoteServerUrlRaw, }, } = options;
+        let strategy;
+        if (/^b/i.test(provider)) {
+            strategy = 'BRING_YOUR_OWN_KEYS';
+        }
+        else if (/^r/i.test(provider)) {
+            strategy = 'REMOTE_SERVER';
+        }
+        else {
+            console.log(colors__default["default"].red(`Unknown provider: "${provider}", please use "BRING_YOUR_OWN_KEYS" or "REMOTE_SERVER"`));
+            process.exit(1);
+        }
+        if (strategy === 'BRING_YOUR_OWN_KEYS') {
+            return /* not await */ $provideLlmToolsForWizzardOrCli({ strategy, ...options });
+        }
+        else if (strategy === 'REMOTE_SERVER') {
+            if (!isValidUrl(remoteServerUrlRaw)) {
+                console.log(colors__default["default"].red(`Invalid URL of remote server: "${remoteServerUrlRaw}"`));
+                process.exit(1);
+            }
+            const remoteServerUrl = remoteServerUrlRaw.endsWith('/') ? remoteServerUrlRaw.slice(0, -1) : remoteServerUrlRaw;
+            return /* not await */ $provideLlmToolsForWizzardOrCli({
+                strategy,
+                appId: CLI_APP_ID,
+                remoteServerUrl,
+                ...options,
+                async loginPrompt() {
+                    if (!isInteractive) {
+                        console.log(colors__default["default"].red(`You can not login to remote server in non-interactive mode`));
+                        process.exit(1);
+                    }
+                    const { username, password } = await prompts__default["default"]([
+                        {
+                            type: 'text',
+                            name: 'username',
+                            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',
+                        },
+                    ]);
+                    const loginUrl = `${remoteServerUrl}/login`;
+                    const response = await fetch(loginUrl, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                        },
+                        body: JSON.stringify({
+                            appId: CLI_APP_ID,
+                            username,
+                            password,
+                        }),
+                    });
+                    console.log('!!!', {
+                        loginUrl,
+                        username,
+                        password,
+                        // type: response.type,
+                        // text: await response.text(),
+                    });
+                    const body = (await response.json());
+                    if ('error' in body) {
+                        console.log(colors__default["default"].red(body.error.message));
+                        process.exit(1);
+                    }
+                    return body.identification;
+                },
+            });
+        }
+        else {
+            throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
+        }
     }
 
     /**
@@ -2628,8 +3165,10 @@
         `));
         listModelsCommand.alias('models');
         listModelsCommand.alias('llm');
-        listModelsCommand.action(handleActionErrors(async () => {
-            const llm = await $provideLlmToolsForWizzardOrCli({});
+        listModelsCommand.action(handleActionErrors(async (cliOptions) => {
+            console.log('!!!', cliOptions);
+            // TODO: !!!!!! Not relevant for remote server and also for `about` command
+            const 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
             console.info($registeredLlmToolsMessage());
@@ -3189,49 +3728,73 @@
      */
 
     /**
-     * Converts PipelineCollection to serialized JSON
+     * Initializes `login` command for Promptbook CLI utilities
      *
-     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
      *
-     * @public exported from `@promptbook/core`
-     */
-    async function collectionToJson(collection) {
-        const pipelineUrls = await collection.listPipelines();
-        const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
-        return promptbooks;
-    }
-    /**
-     * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+     * @private internal function of `promptbookCli`
      */
+    function $initializeLoginCommand(program) {
+        const loginCommand = program.command('login');
+        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',
+                },
+            ]);
+            TODO_USE(email, password);
+            await waitasecond.forTime(1000);
+            console.error(colors__default["default"].green(spaceTrim__default["default"](`
+                        Your account ${email} was successfully created.
 
-    /**
-     * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class ParseError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'ParseError';
-            Object.setPrototypeOf(this, ParseError.prototype);
-        }
+                        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: Maybe split `ParseError` and `ApplyError`
+     * 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`
      */
 
     /**
-     * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+     * Converts PipelineCollection to serialized JSON
+     *
+     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
      *
      * @public exported from `@promptbook/core`
      */
-    class PipelineLogicError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'PipelineLogicError';
-            Object.setPrototypeOf(this, PipelineLogicError.prototype);
-        }
+    async function collectionToJson(collection) {
+        const pipelineUrls = await collection.listPipelines();
+        const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
+        return promptbooks;
     }
+    /**
+     * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+     */
 
     /**
      * Tests if given string is valid semantic version
@@ -3629,21 +4192,6 @@
 
     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"}];
 
-    /**
-     * Checks if value is valid email
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function isValidEmail(email) {
-        if (typeof email !== 'string') {
-            return false;
-        }
-        if (email.split('\n').length > 1) {
-            return false;
-        }
-        return /^.+@.+\..+$/.test(email);
-    }
-
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
      *
@@ -3877,32 +4425,6 @@
      * TODO: [🧠] Should be in generated .book.md file GENERATOR_WARNING
      */
 
-    /**
-     * This error indicates that promptbook not found in the collection
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class NotFoundError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'NotFoundError';
-            Object.setPrototypeOf(this, NotFoundError.prototype);
-        }
-    }
-
-    /**
-     * This error indicates errors in referencing promptbooks between each other
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class PipelineUrlError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'PipelineUrlError';
-            Object.setPrototypeOf(this, PipelineUrlError.prototype);
-        }
-    }
-
     /**
      * Parses the task and returns the list of all parameter names
      *
@@ -4073,24 +4595,6 @@
         return new SimplePipelineCollection(...promptbooks);
     }
 
-    /**
-     * This error type indicates that some tools are missing for pipeline execution or preparation
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class MissingToolsError extends Error {
-        constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
-                    ${block(message)}
-
-                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation
-
-                `));
-            this.name = 'MissingToolsError';
-            Object.setPrototypeOf(this, MissingToolsError.prototype);
-        }
-    }
-
     /**
      * Determine if the pipeline is fully prepared
      *
@@ -4123,210 +4627,40 @@
      * TODO: [🐠] Maybe base this on `makeValidator`
      * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
      * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
-     *     - [🏍] ? Is context in each task
-     *     - [♨] Are examples prepared
-     *     - [♨] Are tasks prepared
-     */
-
-    /**
-     * Recursively converts JSON strings to JSON objects
-
-     * @public exported from `@promptbook/utils`
-     */
-    function jsonStringsToJsons(object) {
-        if (object === null) {
-            return object;
-        }
-        if (Array.isArray(object)) {
-            return object.map(jsonStringsToJsons);
-        }
-        if (typeof object !== 'object') {
-            return object;
-        }
-        const newObject = { ...object };
-        for (const [key, value] of Object.entries(object)) {
-            if (typeof value === 'string' && isValidJsonString(value)) {
-                newObject[key] = JSON.parse(value);
-            }
-            else {
-                newObject[key] = jsonStringsToJsons(value);
-            }
-        }
-        return newObject;
-    }
-    /**
-     * TODO: Type the return type correctly
-     */
-
-    /**
-     * This error indicates problems parsing the format value
-     *
-     * For example, when the format value is not a valid JSON or CSV
-     * This is not thrown directly but in extended classes
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class AbstractFormatError extends Error {
-        // Note: To allow instanceof do not put here error `name`
-        // public readonly name = 'AbstractFormatError';
-        constructor(message) {
-            super(message);
-            Object.setPrototypeOf(this, AbstractFormatError.prototype);
-        }
-    }
-
-    /**
-     * This error indicates problem with parsing of CSV
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class CsvFormatError extends AbstractFormatError {
-        constructor(message) {
-            super(message);
-            this.name = 'CsvFormatError';
-            Object.setPrototypeOf(this, CsvFormatError.prototype);
-        }
-    }
-
-    /**
-     * This error indicates that the pipeline collection cannot be propperly loaded
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class CollectionError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'CollectionError';
-            Object.setPrototypeOf(this, CollectionError.prototype);
-        }
-    }
-
-    /**
-     * This error occurs when some expectation is not met in the execution of the pipeline
-     *
-     * @public exported from `@promptbook/core`
-     * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
-     * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
-     * Note: This is a kindof subtype of PipelineExecutionError
-     */
-    class ExpectError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'ExpectError';
-            Object.setPrototypeOf(this, ExpectError.prototype);
-        }
-    }
-
-    /**
-     * This error indicates that the promptbook can not retrieve knowledge from external sources
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class KnowledgeScrapeError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'KnowledgeScrapeError';
-            Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
-        }
-    }
-
-    /**
-     * This error type indicates that some limit was reached
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class LimitReachedError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'LimitReachedError';
-            Object.setPrototypeOf(this, LimitReachedError.prototype);
-        }
-    }
-
-    /**
-     * Index of all custom errors
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const PROMPTBOOK_ERRORS = {
-        AbstractFormatError,
-        CsvFormatError,
-        CollectionError,
-        EnvironmentMismatchError,
-        ExpectError,
-        KnowledgeScrapeError,
-        LimitReachedError,
-        MissingToolsError,
-        NotFoundError,
-        NotYetImplementedError,
-        ParseError,
-        PipelineExecutionError,
-        PipelineLogicError,
-        PipelineUrlError,
-        UnexpectedError,
-        // TODO: [🪑]> VersionMismatchError,
-    };
-    /**
-     * Index of all javascript errors
-     *
-     * @private for internal usage
-     */
-    const COMMON_JAVASCRIPT_ERRORS = {
-        Error,
-        EvalError,
-        RangeError,
-        ReferenceError,
-        SyntaxError,
-        TypeError,
-        URIError,
-        AggregateError,
-        /*
-      Note: Not widely supported
-      > InternalError,
-      > ModuleError,
-      > HeapError,
-      > WebAssemblyCompileError,
-      > WebAssemblyRuntimeError,
-      */
-    };
-    /**
-     * Index of all errors
-     *
-     * @private for internal usage
-     */
-    const ALL_ERRORS = {
-        ...PROMPTBOOK_ERRORS,
-        ...COMMON_JAVASCRIPT_ERRORS,
-    };
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
-    /**
-     * Deserializes the error object
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    function deserializeError(error) {
-        const { name, stack, id } = error; // Added id
-        let { message } = error;
-        let ErrorClass = ALL_ERRORS[error.name];
-        if (ErrorClass === undefined) {
-            ErrorClass = Error;
-            message = `${name}: ${message}`;
-        }
-        if (stack !== undefined && stack !== '') {
-            message = spaceTrim__default["default"]((block) => `
-                ${block(message)}
+     *     - [🏍] ? Is context in each task
+     *     - [♨] Are examples prepared
+     *     - [♨] Are tasks prepared
+     */
 
-                Original stack trace:
-                ${block(stack || '')}
-            `);
+    /**
+     * Recursively converts JSON strings to JSON objects
+
+     * @public exported from `@promptbook/utils`
+     */
+    function jsonStringsToJsons(object) {
+        if (object === null) {
+            return object;
         }
-        const deserializedError = new ErrorClass(message);
-        deserializedError.id = id; // Assign id to the error object
-        return deserializedError;
+        if (Array.isArray(object)) {
+            return object.map(jsonStringsToJsons);
+        }
+        if (typeof object !== 'object') {
+            return object;
+        }
+        const newObject = { ...object };
+        for (const [key, value] of Object.entries(object)) {
+            if (typeof value === 'string' && isValidJsonString(value)) {
+                newObject[key] = JSON.parse(value);
+            }
+            else {
+                newObject[key] = jsonStringsToJsons(value);
+            }
+        }
+        return newObject;
     }
+    /**
+     * TODO: Type the return type correctly
+     */
 
     /**
      * Asserts that the execution of a Promptbook is successful
@@ -4479,6 +4813,10 @@
 
                     Cannot serialize error with name "${name}"
 
+                    Authors of Promptbook probably forgot to add this error into the list of errors:
+                    https://github.com/webgptorg/promptbook/blob/main/src/errors/0-index.ts
+
+
                     ${block(stack || message)}
 
                 `));
@@ -11389,7 +11727,6 @@
         makeCommand.option('--no-validation', `Do not validate logic of pipelines in collection`, true);
         makeCommand.option('--validation', `Types of validations separated by comma (options "logic","imports")`, 'logic,imports');
         makeCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
-        makeCommand.option('-v, --verbose', `Is output verbose`, false);
         makeCommand.option('-o, --output <path>', spaceTrim__default["default"](`
             Where to save the builded collection
 
@@ -11403,7 +11740,8 @@
             Note: This can be used only with "javascript" or "typescript" format
 
         `), DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME);
-        makeCommand.action(handleActionErrors(async (path$1, { projectName, rootUrl, format, functionName, validation, reload: isCacheReloaded, verbose: isVerbose, output, }) => {
+        makeCommand.action(handleActionErrors(async (path$1, cliOptions) => {
+            const { projectName, rootUrl, format, functionName, validation, reload: isCacheReloaded, verbose: isVerbose, output, } = cliOptions;
             if (!isValidJavascriptName(functionName)) {
                 console.error(colors__default["default"].red(`Function name "${functionName}" is not valid javascript name`));
                 return process.exit(1);
@@ -11431,7 +11769,10 @@
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+            const llm = await $provideLlmToolsForCli({
+                cliOptions,
+                ...prepareAndScrapeOptions,
+            });
             const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
             const tools = {
                 llm,
@@ -11699,8 +12040,8 @@
         // <- TODO: [🧟‍♂️] Unite path to promptbook collection argument
         'Pipelines to prettify as glob pattern');
         prettifyCommand.option('-i, --ignore <glob>', `Ignore as glob pattern`);
-        prettifyCommand.option('-v, --verbose', `Is output verbose`, false);
-        prettifyCommand.action(handleActionErrors(async (filesGlob, { ignore, verbose: isVerbose }) => {
+        prettifyCommand.action(handleActionErrors(async (filesGlob, cliOptions) => {
+            const { ignore, verbose: isVerbose } = cliOptions;
             const filenames = await glob__default["default"](filesGlob, { ignore });
             //                       <- TODO: [😶]
             for (const filename of filenames) {
@@ -12301,13 +12642,12 @@
         // TODO: [🧅] DRY command arguments
         runCommand.argument('[pipelineSource]', 'Path to book file OR URL to book file, if not provided it will be asked');
         runCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
-        runCommand.option('-v, --verbose', `Is output verbose`, false);
-        runCommand.option('--no-interactive', `Input is not interactive, if true you need to pass all the input parameters through --json`);
         runCommand.option('--no-formfactor', `When set, behavior of the interactive mode is not changed by the formfactor of the pipeline`);
         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, options) => {
-            const { reload: isCacheReloaded, interactive: isInteractive, formfactor: isFormfactorUsed, json, verbose: isVerbose, saveReport, } = options;
+        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'.`));
                 return process.exit(1);
@@ -12332,7 +12672,7 @@
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
             let llm;
             try {
-                llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+                llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
             }
             catch (error) {
                 if (!(error instanceof Error)) {
@@ -12389,7 +12729,7 @@
                 fs,
                 fetch: scraperFetch,
                 scrapers: await $provideScrapersForNode({ fs, llm, executables }, prepareAndScrapeOptions),
-                script: [new JavascriptExecutionTools(options)],
+                script: [new JavascriptExecutionTools(cliOptions)],
             };
             if (isVerbose) {
                 console.info(colors__default["default"].gray('--- Getting the book ---'));
@@ -12553,11 +12893,12 @@
      * @public exported from `@promptbook/remote-server`
      */
     function startRemoteServer(options) {
-        const { port, collection, createLlmExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, } = {
+        const { port, collection, createLlmExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, login, } = {
             isAnonymousModeAllowed: false,
             isApplicationModeAllowed: false,
             collection: null,
             createLlmExecutionTools: null,
+            login: null,
             ...options,
         };
         // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
@@ -12624,9 +12965,38 @@
             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`
+                    },
+                ],
+            },
+            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));
         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) => {
             var _a;
             if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.includes('socket.io')) {
@@ -12663,9 +13033,12 @@
 
                     ## Paths
 
-                    ${block(app._router.stack
-            .map(({ route }) => (route === null || route === void 0 ? void 0 : route.path) || null)
-            .filter((path) => path !== null)
+                    ${block([
+            ...app._router.stack
+                .map(({ route }) => (route === null || route === void 0 ? void 0 : route.path) || null)
+                .filter((path) => path !== null),
+            '/api-docs',
+        ]
             .map((path) => `- ${path}`)
             .join('\n'))}
 
@@ -12683,8 +13056,81 @@
                     https://github.com/webgptorg/promptbook
                 `));
         });
-        // TODO: !!!!!! Add login route
-        app.get(`${rootPath}/books`, async (request, response) => {
+        /**
+         * @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) => {
+            if (!isApplicationModeAllowed || login === null) {
+                response.status(400).send('Application mode is not allowed');
+                return;
+            }
+            try {
+                const username = request.body.username;
+                const password = request.body.password;
+                const appId = request.body.appId;
+                const identification = await login({ username, password, appId });
+                response.status(201).send({ identification });
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                if (error instanceof AuthenticationError) {
+                    response.status(401).send({ error: serializeError(error) });
+                }
+                console.warn(`Login function thrown different error than AuthenticationError`, {
+                    error,
+                    serializedError: serializeError(error),
+                });
+                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) => {
             if (collection === null) {
                 response.status(500).send('No collection available');
                 return;
@@ -12694,7 +13140,30 @@
             response.send(pipelines);
         });
         // TODO: [🧠] Is it secure / good idea to expose source codes of hosted books
-        app.get(`${rootPath}/books/*`, async (request, response) => {
+        /**
+         * @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) => {
             try {
                 if (collection === null) {
                     response.status(500).send('No collection nor books available');
@@ -12748,10 +13217,26 @@
                 };
             }
         }
-        app.get(`${rootPath}/executions`, async (request, response) => {
+        /**
+         * @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(`${rootPath}/executions/last`, async (request, response) => {
+        app.get([`/executions/last`, `${rootPath}/executions/last`], async (request, response) => {
             // TODO: [🤬] Filter only for user
             if (runningExecutionTasks.length === 0) {
                 response.status(404).send('No execution tasks found');
@@ -12760,7 +13245,7 @@
             const lastExecutionTask = runningExecutionTasks[runningExecutionTasks.length - 1];
             response.send(exportExecutionTask(lastExecutionTask, true));
         });
-        app.get(`${rootPath}/executions/:taskId`, async (request, response) => {
+        app.get([`/executions/:taskId`, `${rootPath}/executions/:taskId`], async (request, response) => {
             const { taskId } = request.params;
             // TODO: [🤬] Filter only for user
             const executionTask = runningExecutionTasks.find((executionTask) => executionTask.taskId === taskId);
@@ -12772,7 +13257,36 @@
             }
             response.send(exportExecutionTask(executionTask, true));
         });
-        app.post(`${rootPath}/executions/new`, async (request, response) => {
+        /**
+         * @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) => {
             try {
                 const { inputParameters, identification /* <- [🤬] */ } = request.body;
                 const pipelineUrl = request.body.pipelineUrl || request.body.book;
@@ -13008,12 +13522,12 @@
         `));
         startServerCommand.option('--allow-anonymous', `Is anonymous mode allowed`, false);
         startServerCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache`, false);
-        startServerCommand.option('-v, --verbose', `Is output verbose`, false);
         startServerCommand.description(spaceTrim__default["default"](`
             Starts a remote server to execute books
         `));
         startServerCommand.alias('server');
-        startServerCommand.action(handleActionErrors(async (path, { port: portRaw, url: rawUrl, allowAnonymous: isAnonymousModeAllowed, reload: isCacheReloaded, verbose: isVerbose, }) => {
+        startServerCommand.action(handleActionErrors(async (path, cliOptions) => {
+            const { port: portRaw, url: rawUrl, allowAnonymous: isAnonymousModeAllowed, reload: isCacheReloaded, verbose: isVerbose, } = cliOptions;
             if (rawUrl && !isValidUrl(rawUrl)) {
                 console.error(colors__default["default"].red(`Invalid URL: ${rawUrl}`));
                 return process.exit(1);
@@ -13042,7 +13556,7 @@
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+            const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
             const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
             const tools = {
                 llm,
@@ -13066,6 +13580,9 @@
                 isAnonymousModeAllowed,
                 isApplicationModeAllowed: true,
                 collection,
+                async login() {
+                    throw new AuthenticationError('You can not login to the server started by `ptbk start-server` in cli, use `startRemoteServer` function instead.');
+                },
                 createLlmExecutionTools(options) {
                     const { appId, userId } = options;
                     TODO_USE({ appId, userId });
@@ -13102,8 +13619,8 @@
         testCommand.option('--no-validation', `Do not validate logic of pipelines in collection`, true);
         testCommand.option('--no-prepare', `Do not prepare the pipelines, ideal when no LLM tools or scrapers available`, true);
         testCommand.option('-r, --reload', `Call LLM models even if same prompt with result is in the cache `, false);
-        testCommand.option('-v, --verbose', `Is output verbose`, false);
-        testCommand.action(handleActionErrors(async (filesGlob, { ignore: ignoreRaw = '', validation: isValidated, prepare: isPrepared, reload: isCacheReloaded, verbose: isVerbose, }) => {
+        testCommand.action(handleActionErrors(async (filesGlob, cliOptions) => {
+            const { ignore: ignoreRaw = '', validation: isValidated, prepare: isPrepared, reload: isCacheReloaded, verbose: isVerbose, } = cliOptions;
             let tools = undefined;
             if (isPrepared) {
                 // TODO: DRY [◽]
@@ -13112,7 +13629,7 @@
                     isCacheReloaded,
                 }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
                 const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                const llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+                const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
                 const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
                 tools = {
                     llm,
@@ -13173,56 +13690,16 @@
      */
 
     /**
-     * Initializes `login` command for Promptbook CLI utilities
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+     * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
      *
-     * @private internal function of `promptbookCli`
+     * @private utility of CLI
      */
-    function $initializeLoginCommand(program) {
-        const loginCommand = program.command('login');
-        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.
-                    `)));
-            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',
-                },
-            ]);
-            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);
-        }));
+    function $addGlobalOptionsToCommand(command) {
+        command.option('-v, --verbose', `Log more details`, false);
+        command.option('--no-interactive', `Input is not interactive, if true, no CLI input is prompted if required, so either defaults are used or the command fails with exit code 1`);
+        command.option('-p, --provider <provider>', `Which LLM provider to use: "BYOK" / "BRING_YOUR_OWN_KEYS" or "REMOTE_SERVER" / "RS"`, 'REMOTE_SERVER');
+        command.option('--remote-server-url <url>', `URL of remote server to use when `, DEFAULT_REMOTE_SERVER_URL);
     }
-    /**
-     * 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`
-     */
 
     /**
      * Runs CLI utilities of Promptbook package
@@ -13248,6 +13725,7 @@
         program.alias('ptbk');
         program.version(PROMPTBOOK_ENGINE_VERSION);
         program.description(CLAIM);
+        // Note: Theese options are valid for all commands
         $initializeAboutCommand(program);
         $initializeRunCommand(program);
         $initializeLoginCommand(program);
@@ -13258,6 +13736,8 @@
         $initializeListModelsCommand(program);
         $initializeListScrapersCommand(program);
         $initializeStartServerCommand(program);
+        // TODO: [🧠] Should it be here or not> $addGlobalOptionsToCommand(program);
+        program.commands.forEach($addGlobalOptionsToCommand);
         program.parse(process.argv);
     }
     /**
@@ -13307,8 +13787,7 @@
                 options: {
                     apiKey: 'sk-ant-api03-',
                     isProxied: true,
-                    remoteUrl: DEFAULT_REMOTE_URL,
-                    path: DEFAULT_REMOTE_URL_PATH,
+                    remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
                 },
             };
         },
@@ -13331,146 +13810,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Creates a connection to the remote proxy server.
-     *
-     * Note: This function creates a connection to the remote server and returns a socket but responsibility of closing the connection is on the caller
-     *
-     * @private internal utility function
-     */
-    async function createRemoteClient(options) {
-        const { remoteUrl, path } = options;
-        return new Promise((resolve, reject) => {
-            const socket = socket_ioClient.io(remoteUrl, {
-                retries: CONNECTION_RETRIES_LIMIT,
-                timeout: CONNECTION_TIMEOUT_MS,
-                path,
-                // path: `${this.remoteUrl.pathname}/socket.io`,
-                transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
-            });
-            // console.log('Connecting to', this.options.remoteUrl.href, { socket });
-            socket.on('connect', () => {
-                resolve(socket);
-            });
-            // TODO: [💩] Better timeout handling
-            setTimeout(() => {
-                reject(new Error(`Timeout while connecting to ${remoteUrl}`));
-            }, CONNECTION_TIMEOUT_MS);
-        });
-    }
-
-    /**
-     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
-     *
-     * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
-     * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
-     *
-     * @see https://github.com/webgptorg/promptbook#remote-server
-     * @public exported from `@promptbook/remote-client`
-     */
-    class RemoteLlmExecutionTools {
-        /* <- TODO: [🍚] `, Destroyable` */
-        constructor(options) {
-            this.options = options;
-        }
-        get title() {
-            // TODO: [🧠] Maybe fetch title+description from the remote server (as well as if model methods are defined)
-            return 'Remote server';
-        }
-        get description() {
-            return 'Use all models by your remote server';
-        }
-        /**
-         * Check the configuration of all execution tools
-         */
-        async checkConfiguration() {
-            const socket = await createRemoteClient(this.options);
-            socket.disconnect();
-            // TODO: [main] !!3 Check version of the remote server and compatibility
-            // TODO: [🎍] Send checkConfiguration
-        }
-        /**
-         * List all available models that can be used
-         */
-        async listModels() {
-            // TODO: [👒] Listing models (and checking configuration) probbably should go through REST API not Socket.io
-            const socket = await createRemoteClient(this.options);
-            socket.emit('listModels-request', {
-                identification: this.options.identification,
-            } /* <- Note: [🤛] */);
-            const promptResult = await new Promise((resolve, reject) => {
-                socket.on('listModels-response', (response) => {
-                    resolve(response.models);
-                    socket.disconnect();
-                });
-                socket.on('error', (error) => {
-                    reject(deserializeError(error));
-                    socket.disconnect();
-                });
-            });
-            socket.disconnect();
-            return promptResult;
-        }
-        /**
-         * Calls remote proxy server to use a chat model
-         */
-        callChatModel(prompt) {
-            if (this.options.isVerbose) {
-                console.info(`🖋 Remote callChatModel call`);
-            }
-            return /* not await */ this.callCommonModel(prompt);
-        }
-        /**
-         * Calls remote proxy server to use a completion model
-         */
-        callCompletionModel(prompt) {
-            if (this.options.isVerbose) {
-                console.info(`💬 Remote callCompletionModel call`);
-            }
-            return /* not await */ this.callCommonModel(prompt);
-        }
-        /**
-         * Calls remote proxy server to use a embedding model
-         */
-        callEmbeddingModel(prompt) {
-            if (this.options.isVerbose) {
-                console.info(`💬 Remote callEmbeddingModel call`);
-            }
-            return /* not await */ this.callCommonModel(prompt);
-        }
-        // <- Note: [🤖] callXxxModel
-        /**
-         * Calls remote proxy server to use both completion or chat model
-         */
-        async callCommonModel(prompt) {
-            const socket = await createRemoteClient(this.options);
-            socket.emit('prompt-request', {
-                identification: this.options.identification,
-                prompt,
-            } /* <- Note: [🤛] */);
-            const promptResult = await new Promise((resolve, reject) => {
-                socket.on('prompt-response', (response) => {
-                    resolve(response.promptResult);
-                    socket.disconnect();
-                });
-                socket.on('error', (error) => {
-                    reject(deserializeError(error));
-                    socket.disconnect();
-                });
-            });
-            socket.disconnect();
-            return promptResult;
-        }
-    }
-    /**
-     * TODO: Maybe use `$exportJson`
-     * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
-     * TODO: [🍓] Allow to list compatible models with each variant
-     * TODO: [🗯] RemoteLlmExecutionTools should extend Destroyable and implement IDestroyable
-     * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
-     * TODO: [🧠] Maybe remove `@promptbook/remote-client` and just use `@promptbook/core`
-     */
-
     /**
      * Function computeUsage will create price per one token based on the string value found on openai page
      *