@promptbook/cli 0.88.0 → 0.89.0-11

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('dotenv'), require('child_process'), require('jszip'), require('prettier'), require('prettier/parser-html'), require('rxjs'), 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', 'dotenv', 'child_process', 'jszip', 'prettier', 'prettier/parser-html', 'rxjs', '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.dotenv, global.child_process, global.JSZip, global.prettier, global.parserHtml, global.rxjs, 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, dotenv, child_process, JSZip, prettier, parserHtml, rxjs, 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('dotenv'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto'), require('socket.io-client'), require('rxjs'), require('child_process'), require('jszip'), require('prettier'), require('prettier/parser-html'), require('papaparse'), require('crypto-js'), require('mime-types'), require('glob-promise'), require('moment'), require('express'), require('http'), require('socket.io'), require('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', 'dotenv', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto', 'socket.io-client', 'rxjs', 'child_process', 'jszip', 'prettier', 'prettier/parser-html', 'papaparse', 'crypto-js', 'mime-types', 'glob-promise', 'moment', 'express', 'http', 'socket.io', '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.dotenv, global.hexEncoder, global.sha256, global.crypto, global.socket_ioClient, global.rxjs, global.child_process, global.JSZip, global.prettier, global.parserHtml, global.papaparse, global.cryptoJs, global.mimeTypes, global.glob, global.moment, global.express, global.http, global.socket_io, global.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, dotenv, hexEncoder, sha256, crypto, socket_ioClient, rxjs, 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 dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
-    var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
     var JSZip__default = /*#__PURE__*/_interopDefaultLegacy(JSZip);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
     var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
-    var 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.88.0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.89.0-11';
     /**
      * 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,375 +611,362 @@
     }
 
     /**
-     * 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\`
-
-                        Additional message for \`${name}\`:
-                        ${block(message || '(nothing)')}
-
-                    `));
-            }
-            else {
-                for (const [subName, subValue] of Object.entries(value)) {
-                    if (subValue === undefined) {
-                        // Note: undefined in object is serializable - it is just omited
-                        continue;
-                    }
-                    checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });
-                }
-                try {
-                    JSON.stringify(value); // <- TODO: [0]
-                }
-                catch (error) {
-                    if (!(error instanceof Error)) {
-                        throw error;
-                    }
-                    throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                            \`${name}\` is not serializable
-
-                            ${block(error.stack || error.message)}
-
-                            Additional message for \`${name}\`:
-                            ${block(message || '(nothing)')}
-                        `));
-                }
-                /*
-                TODO: [0] Is there some more elegant way to check circular references?
-                const seen = new Set();
-                const stack = [{ value }];
-                while (stack.length > 0) {
-                    const { value } = stack.pop()!;
-                    if (typeof value === 'object' && value !== null) {
-                        if (seen.has(value)) {
-                            throw new UnexpectedError(`${name} has circular reference`);
-                        }
-                        seen.add(value);
-                        if (Array.isArray(value)) {
-                            stack.push(...value.map((value) => ({ value })));
-                        } else {
-                            stack.push(...Object.values(value).map((value) => ({ value })));
-                        }
-                    }
-                }
-                */
-                return;
-            }
-        }
-        else {
-            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
-                    \`${name}\` is unknown type
-
-                    Additional message for \`${name}\`:
-                    ${block(message || '(nothing)')}
-                `));
-        }
-    }
-    /**
-     * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
-     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
-     * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
-     */
+            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`);
+                },
+            };
+        }
+    }
 
     /**
      * @@@
      *
-     * @public exported from `@promptbook/utils`
-     */
-    function deepClone(objectValue) {
-        return JSON.parse(JSON.stringify(objectValue));
-        /*
-        TODO: [🧠] Is there a better implementation?
-        > const propertyNames = Object.getOwnPropertyNames(objectValue);
-        > for (const propertyName of propertyNames) {
-        >     const value = (objectValue as really_any)[propertyName];
-        >     if (value && typeof value === 'object') {
-        >         deepClone(value);
-        >     }
-        > }
-        > return Object.assign({}, objectValue);
-        */
-    }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
-
-    /**
-     * Utility to export a JSON object from a function
-     *
-     * 1) Checks if the value is serializable as JSON
-     * 2) Makes a deep clone of the object
-     * 2) Orders the object properties
-     * 2) Deeply freezes the cloned object
-     *
-     * Note: This function does not mutates the given object
-     *
-     * @returns The same type of object as the input but read-only and re-ordered
-     * @public exported from `@promptbook/utils`
-     */
-    function exportJson(options) {
-        const { name, value, order, message } = options;
-        checkSerializableAsJson({ name, value, message });
-        const orderedValue = 
-        // TODO: Fix error "Type instantiation is excessively deep and possibly infinite."
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        order === undefined
-            ? deepClone(value)
-            : orderJson({
-                value: value,
-                // <- Note: checkSerializableAsJson asserts that the value is serializable as JSON
-                order: order,
-            });
-        $deepFreeze(orderedValue);
-        return orderedValue;
-    }
-    /**
-     * TODO: [🧠] Is there a way how to meaningfully test this utility
-     */
-
-    /**
-     * Order of keys in the pipeline JSON
-     *
+     * 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 ORDER_OF_PIPELINE_JSON = [
-        // Note: [🍙] In this order will be pipeline serialized
-        'title',
-        'pipelineUrl',
-        'bookVersion',
-        'description',
-        'formfactorName',
-        'parameters',
-        'tasks',
-        'personas',
-        'preparations',
-        'knowledgeSources',
-        'knowledgePieces',
-        'sources', // <- TODO: [🧠] Where should the `sources` be
-    ];
-    /**
-     * Nonce which is used for replacing things in strings
-     *
-     * @private within the repository
-     */
-    const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+    const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
     /**
-     * @@@
-     *
-     * @private within the repository
+     * TODO: [®] DRY Register logic
      */
-    const RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
+
     /**
      * @@@
      *
-     * @private within the repository
-     */
-    const RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
-    /**
-     * The names of the parameters that are reserved for special purposes
-     *
+     * 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 RESERVED_PARAMETER_NAMES = exportJson({
-        name: 'RESERVED_PARAMETER_NAMES',
-        message: `The names of the parameters that are reserved for special purposes`,
-        value: [
-            'content',
-            'context',
-            'knowledge',
-            'examples',
-            'modelName',
-            'currentDate',
-            // <- TODO: list here all command names
-            // <- TODO: Add more like 'date', 'modelName',...
-            // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
-        ],
-    });
+    const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
     /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * TODO: [®] DRY Register logic
      */
 
-    // <- TODO: Auto convert to type `import { ... } from 'type-fest';`
     /**
-     * Tests if the value is [🚉] serializable as JSON
+     * Path to the `.env` file which was used to configure LLM tools
      *
-     * - 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...
+     * 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
      *
-     * @public exported from `@promptbook/utils`
+     * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
      */
-    function isSerializableAsJson(value) {
-        try {
-            checkSerializableAsJson({ value });
-            return true;
-        }
-        catch (error) {
-            return false;
-        }
+    function $setUsedEnvFilename(filepath) {
+        $usedEnvFilename = filepath;
     }
     /**
-     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
-     * TODO: [🧠][💺] Can be done this on type-level?
-     */
-
-    /**
-     * Stringify the PipelineJson with proper formatting
+     * Creates a message with all registered LLM tools
      *
-     * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
-     * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
+     * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
      *
-     * @public exported from `@promptbook/editable`
+     * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
      */
-    function stringifyPipelineJson(pipeline) {
-        if (!isSerializableAsJson(pipeline)) {
-            throw new UnexpectedError(spaceTrim__default["default"](`
-                Cannot stringify the pipeline, because it is not serializable as JSON
-
-                There can be multiple reasons:
-                1) The pipeline contains circular references
-                2) It is not a valid PipelineJson
-            `));
+    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`
         }
-        let pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
-        for (let i = 0; i < LOOP_LIMIT; i++) {
-            pipelineJsonStringified = pipelineJsonStringified.replace(/(-?0\.\d+),[\n\s]+(-?0\.\d+)/gms, `$1${REPLACING_NONCE}$2`);
+        else {
+            env = {};
         }
-        pipelineJsonStringified = pipelineJsonStringified.split(REPLACING_NONCE).join(', ');
-        pipelineJsonStringified += '\n';
-        return pipelineJsonStringified;
-    }
-    /**
-     * TODO: [🐝] Not Working propperly @see https://promptbook.studio/examples/mixed-knowledge.book
-     * TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
-     * TODO: [🧠] Maybe more elegant solution than replacing via regex
-     * TODO: [🍙] Make some standard order of json properties
-     */
-
-    /**
-     * Checks if the file exists
+        /**
+         * 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);
+    }
+
+    /**
+     * Just marks a place of place where should be something implemented
+     * No side effects.
+     *
+     * Note: It can be usefull suppressing eslint errors of unused variables
+     *
+     * @param value any values
+     * @returns void
+     * @private within the repository
+     */
+    function TODO_USE(...value) {
+    }
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $provideFilesystemForNode(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+        }
+        return {
+            stat: promises.stat,
+            access: promises.access,
+            constants: promises.constants,
+            readFile: promises.readFile,
+            writeFile: promises.writeFile,
+            readdir: promises.readdir,
+            mkdir: promises.mkdir,
+        };
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Checks if the file exists
      *
      * @private within the repository
      */
@@ -1004,99 +991,607 @@
      */
 
     /**
-     * Removes emojis from a string and fix whitespaces
-     *
-     * @param text with emojis
-     * @returns text without emojis
-     * @public exported from `@promptbook/utils`
-     */
-    function removeEmojis(text) {
-        // Replace emojis (and also ZWJ sequence) with hyphens
-        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-        text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
-        text = text.replace(/\p{Extended_Pictographic}/gu, '');
-        return text;
-    }
-
-    /**
-     * Tests if given string is valid URL.
+     * 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 isValidFilePath(filename) {
-        if (typeof filename !== 'string') {
-            return false;
-        }
-        if (filename.split('\n').length > 1) {
-            return false;
-        }
-        if (filename.split(' ').length >
-            5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
-            return false;
-        }
-        const filenameSlashes = filename.split('\\').join('/');
-        // Absolute Unix path: /hello.txt
-        if (/^(\/)/i.test(filenameSlashes)) {
-            // console.log(filename, 'Absolute Unix path: /hello.txt');
-            return true;
-        }
-        // Absolute Windows path: /hello.txt
-        if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
-            // console.log(filename, 'Absolute Windows path: /hello.txt');
-            return true;
-        }
-        // Relative path: ./hello.txt
-        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');
+    function isRootPath(value) {
+        if (value === '/') {
             return true;
         }
-        // Allow paths like hello.book
-        if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-            // console.log(filename, 'Allow paths like hello.book');
+        if (/^[A-Z]:\\$/i.test(value)) {
             return true;
         }
         return false;
     }
     /**
-     * TODO: [🍏] Implement for MacOs
+     * TODO: [🍏] Make for MacOS paths
      */
 
     /**
-     * Tests if given string is valid URL.
+     * Provides the path to the `.env` file
      *
-     * 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
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
      *
-     * @public exported from `@promptbook/utils`
+     * @private within the repository - for CLI 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;
+    async function $provideEnvFilename() {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$provideEnvFilename` works only in Node.js environment');
         }
-    }
-
+        const envFilePatterns = [
+            '.env',
+            '.env.test',
+            '.env.local',
+            '.env.development.local',
+            '.env.development',
+            '.env.production.local',
+            '.env.production',
+            '.env.prod.local',
+            '.env.prod',
+            // <- TODO: Maybe add more patterns
+        ];
+        let rootDirname = process.cwd();
+        up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
+            for (const pattern of envFilePatterns) {
+                const envFilename = path.join(rootDirname, pattern);
+                if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
+                    $setUsedEnvFilename(envFilename);
+                    return envFilename;
+                }
+            }
+            if (isRootPath(rootDirname)) {
+                break up_to_root;
+            }
+            // Note: If the directory does not exist, try the parent directory
+            rootDirname = path.join(rootDirname, '..');
+        }
+        return null;
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+     */
+
+    /**
+     * Stores data in .env variables (Remove !!! nonce 1)
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes to `process.env`
+     *
+     * @private within the repository - for CLI utils
+     */
+    class $EnvStorage {
+        constructor() {
+            this.envFilename = null;
+        }
+        async $provideOrCreateEnvFile() {
+            if (this.envFilename !== null) {
+                return this.envFilename;
+            }
+            let envFilename = await $provideEnvFilename();
+            if (envFilename !== null) {
+                this.envFilename = envFilename;
+                return envFilename;
+            }
+            envFilename = path.join(process.cwd(), '.env');
+            await promises.writeFile(envFilename, '# This file was initialized by Promptbook', 'utf-8');
+            this.envFilename = envFilename;
+            return envFilename;
+        }
+        transformKey(key) {
+            return normalizeTo_SCREAMING_CASE(key);
+        }
+        /**
+         * Returns the number of key/value pairs currently present in the list associated with the object.
+         */
+        get length() {
+            throw new NotYetImplementedError('Method `$EnvStorage.length` not implemented.');
+        }
+        /**
+         * Empties the list associated with the object of all key/value pairs, if there are any.
+         */
+        clear() {
+            throw new NotYetImplementedError('Method `$EnvStorage.clear` not implemented.');
+        }
+        /**
+         * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+         */
+        async getItem(key) {
+            dotenv__namespace.config({ path: await this.$provideOrCreateEnvFile() });
+            return process.env[this.transformKey(key)] || null;
+        }
+        /**
+         * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+         */
+        key(index) {
+            throw new NotYetImplementedError('Method `$EnvStorage.key` not implemented.');
+        }
+        /**
+         * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         */
+        async setItem(key, value) {
+            const envFilename = await this.$provideOrCreateEnvFile();
+            const envContent = await promises.readFile(envFilename, 'utf-8');
+            const newEnvContent = spaceTrim__default["default"]((block) => `
+                ${block(envContent)}
+
+                # Note: Added by Promptbook
+                ${this.transformKey(key)}=${JSON.stringify(value)}
+
+            `);
+            // <- TODO: !!! Add note and use spacetrim
+            promises.writeFile(envFilename, newEnvContent, 'utf-8');
+        }
+        /**
+         * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+         */
+        removeItem(key) {
+            throw new NotYetImplementedError('Method `$EnvStorage.removeItem` not implemented.');
+        }
+    }
+
+    /**
+     * 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)')}
+
+                    `));
+            }
+            else {
+                for (const [subName, subValue] of Object.entries(value)) {
+                    if (subValue === undefined) {
+                        // Note: undefined in object is serializable - it is just omited
+                        continue;
+                    }
+                    checkSerializableAsJson({ name: `${name}.${subName}`, value: subValue, message });
+                }
+                try {
+                    JSON.stringify(value); // <- TODO: [0]
+                }
+                catch (error) {
+                    if (!(error instanceof Error)) {
+                        throw error;
+                    }
+                    throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                            \`${name}\` is not serializable
+
+                            ${block(error.stack || error.message)}
+
+                            Additional message for \`${name}\`:
+                            ${block(message || '(nothing)')}
+                        `));
+                }
+                /*
+                TODO: [0] Is there some more elegant way to check circular references?
+                const seen = new Set();
+                const stack = [{ value }];
+                while (stack.length > 0) {
+                    const { value } = stack.pop()!;
+                    if (typeof value === 'object' && value !== null) {
+                        if (seen.has(value)) {
+                            throw new UnexpectedError(`${name} has circular reference`);
+                        }
+                        seen.add(value);
+                        if (Array.isArray(value)) {
+                            stack.push(...value.map((value) => ({ value })));
+                        } else {
+                            stack.push(...Object.values(value).map((value) => ({ value })));
+                        }
+                    }
+                }
+                */
+                return;
+            }
+        }
+        else {
+            throw new UnexpectedError(spaceTrim__default["default"]((block) => `
+                    \`${name}\` is unknown type
+
+                    Additional message for \`${name}\`:
+                    ${block(message || '(nothing)')}
+                `));
+        }
+    }
+    /**
+     * TODO: Can be return type more type-safe? like `asserts options.value is JsonValue`
+     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+     * Note: [🐠] This is how `checkSerializableAsJson` + `isSerializableAsJson` together can just retun true/false or rich error message
+     */
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function deepClone(objectValue) {
+        return JSON.parse(JSON.stringify(objectValue));
+        /*
+        TODO: [🧠] Is there a better implementation?
+        > const propertyNames = Object.getOwnPropertyNames(objectValue);
+        > for (const propertyName of propertyNames) {
+        >     const value = (objectValue as really_any)[propertyName];
+        >     if (value && typeof value === 'object') {
+        >         deepClone(value);
+        >     }
+        > }
+        > return Object.assign({}, objectValue);
+        */
+    }
+    /**
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
+
+    /**
+     * Utility to export a JSON object from a function
+     *
+     * 1) Checks if the value is serializable as JSON
+     * 2) Makes a deep clone of the object
+     * 2) Orders the object properties
+     * 2) Deeply freezes the cloned object
+     *
+     * Note: This function does not mutates the given object
+     *
+     * @returns The same type of object as the input but read-only and re-ordered
+     * @public exported from `@promptbook/utils`
+     */
+    function exportJson(options) {
+        const { name, value, order, message } = options;
+        checkSerializableAsJson({ name, value, message });
+        const orderedValue = 
+        // TODO: Fix error "Type instantiation is excessively deep and possibly infinite."
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        order === undefined
+            ? deepClone(value)
+            : orderJson({
+                value: value,
+                // <- Note: checkSerializableAsJson asserts that the value is serializable as JSON
+                order: order,
+            });
+        $deepFreeze(orderedValue);
+        return orderedValue;
+    }
+    /**
+     * TODO: [🧠] Is there a way how to meaningfully test this utility
+     */
+
+    /**
+     * Order of keys in the pipeline JSON
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const ORDER_OF_PIPELINE_JSON = [
+        // Note: [🍙] In this order will be pipeline serialized
+        'title',
+        'pipelineUrl',
+        'bookVersion',
+        'description',
+        'formfactorName',
+        'parameters',
+        'tasks',
+        'personas',
+        'preparations',
+        'knowledgeSources',
+        'knowledgePieces',
+        'sources', // <- TODO: [🧠] Where should the `sources` be
+    ];
+    /**
+     * Nonce which is used for replacing things in strings
+     *
+     * @private within the repository
+     */
+    const REPLACING_NONCE = 'ptbkauk42kV2dzao34faw7FudQUHYPtW';
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    const RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
+    /**
+     * @@@
+     *
+     * @private within the repository
+     */
+    const RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
+    /**
+     * The names of the parameters that are reserved for special purposes
+     *
+     * @public exported from `@promptbook/core`
+     */
+    const RESERVED_PARAMETER_NAMES = exportJson({
+        name: 'RESERVED_PARAMETER_NAMES',
+        message: `The names of the parameters that are reserved for special purposes`,
+        value: [
+            'content',
+            'context',
+            'knowledge',
+            'examples',
+            'modelName',
+            'currentDate',
+            // <- TODO: list here all command names
+            // <- TODO: Add more like 'date', 'modelName',...
+            // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
+        ],
+    });
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    // <- TODO: Auto convert to type `import { ... } from 'type-fest';`
+    /**
+     * Tests if the value is [🚉] serializable as JSON
+     *
+     * - 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...
+     *
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isSerializableAsJson(value) {
+        try {
+            checkSerializableAsJson({ value });
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+     * TODO: [🧠][💺] Can be done this on type-level?
+     */
+
+    /**
+     * Stringify the PipelineJson with proper formatting
+     *
+     * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
+     * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
+     *
+     * @public exported from `@promptbook/editable`
+     */
+    function stringifyPipelineJson(pipeline) {
+        if (!isSerializableAsJson(pipeline)) {
+            throw new UnexpectedError(spaceTrim__default["default"](`
+                Cannot stringify the pipeline, because it is not serializable as JSON
+
+                There can be multiple reasons:
+                1) The pipeline contains circular references
+                2) It is not a valid PipelineJson
+            `));
+        }
+        let pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
+        for (let i = 0; i < LOOP_LIMIT; i++) {
+            pipelineJsonStringified = pipelineJsonStringified.replace(/(-?0\.\d+),[\n\s]+(-?0\.\d+)/gms, `$1${REPLACING_NONCE}$2`);
+        }
+        pipelineJsonStringified = pipelineJsonStringified.split(REPLACING_NONCE).join(', ');
+        pipelineJsonStringified += '\n';
+        return pipelineJsonStringified;
+    }
+    /**
+     * TODO: [🐝] Not Working propperly @see https://promptbook.studio/examples/mixed-knowledge.book
+     * TODO: [🧠][0] Maybe rename to `stringifyPipelineJson`, `stringifyIndexedJson`,...
+     * TODO: [🧠] Maybe more elegant solution than replacing via regex
+     * TODO: [🍙] Make some standard order of json properties
+     */
+
+    /**
+     * Removes emojis from a string and fix whitespaces
+     *
+     * @param text with emojis
+     * @returns text without emojis
+     * @public exported from `@promptbook/utils`
+     */
+    function removeEmojis(text) {
+        // Replace emojis (and also ZWJ sequence) with hyphens
+        text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+        text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
+        text = text.replace(/\p{Extended_Pictographic}/gu, '');
+        return text;
+    }
+
+    /**
+     * Tests if given string is valid URL.
+     *
+     * Note: This does not check if the file exists only if the path is valid
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidFilePath(filename) {
+        if (typeof filename !== 'string') {
+            return false;
+        }
+        if (filename.split('\n').length > 1) {
+            return false;
+        }
+        if (filename.split(' ').length >
+            5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
+            return false;
+        }
+        const filenameSlashes = filename.split('\\').join('/');
+        // Absolute Unix path: /hello.txt
+        if (/^(\/)/i.test(filenameSlashes)) {
+            // console.log(filename, 'Absolute Unix path: /hello.txt');
+            return true;
+        }
+        // Absolute Windows path: /hello.txt
+        if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
+            // console.log(filename, 'Absolute Windows path: /hello.txt');
+            return true;
+        }
+        // Relative path: ./hello.txt
+        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;
+            }
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+
     const defaultDiacriticsRemovalMap = [
         {
             base: 'A',
@@ -1509,690 +2004,792 @@
      */
 
     /**
-     * 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 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 errors during the execution of the pipeline
+     * AuthenticationError is thrown from login function which is dependency of remote server
      *
      * @public exported from `@promptbook/core`
      */
-    class PipelineExecutionError extends Error {
+    class AuthenticationError 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);
+            this.name = 'AuthenticationError';
+            Object.setPrototypeOf(this, AuthenticationError.prototype);
         }
     }
+
     /**
-     * TODO: !!!!!! Add id to all errors
+     * 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);
+        }
+    }
 
     /**
-     * Stores data in memory (HEAP)
+     * 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 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 ExpectError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'ExpectError';
+            Object.setPrototypeOf(this, ExpectError.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 promptbook can not retrieve knowledge from external sources
      *
-     * @returns string_date branded type
-     * @public exported from `@promptbook/utils`
+     * @public exported from `@promptbook/core`
      */
-    function $getCurrentDate() {
-        return new Date().toISOString();
+    class KnowledgeScrapeError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'KnowledgeScrapeError';
+            Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
+        }
     }
 
     /**
-     * Intercepts LLM tools and counts total usage of the tools
-     *
-     * Note: It can take extended `LlmExecutionTools` and cache the
+     * This error type indicates that some limit was reached
      *
-     * @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`
      */
-    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 LimitReachedError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'LimitReachedError';
+            Object.setPrototypeOf(this, LimitReachedError.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
+     * 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);
+        }
+    }
 
     /**
-     * Represents the usage with no resources consumed
+     * This error indicates that promptbook not found in the collection
      *
      * @public exported from `@promptbook/core`
      */
-    const ZERO_USAGE = $deepFreeze({
-        price: { value: 0 },
-        input: {
-            tokensCount: { value: 0 },
-            charactersCount: { value: 0 },
-            wordsCount: { value: 0 },
-            sentencesCount: { value: 0 },
-            linesCount: { value: 0 },
-            paragraphsCount: { value: 0 },
-            pagesCount: { value: 0 },
-        },
-        output: {
-            tokensCount: { value: 0 },
-            charactersCount: { value: 0 },
-            wordsCount: { value: 0 },
-            sentencesCount: { value: 0 },
-            linesCount: { value: 0 },
-            paragraphsCount: { value: 0 },
-            pagesCount: { value: 0 },
-        },
-    });
+    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: { value: 0, isUncertain: true },
-        input: {
-            tokensCount: { value: 0, isUncertain: true },
-            charactersCount: { value: 0, isUncertain: true },
-            wordsCount: { value: 0, isUncertain: true },
-            sentencesCount: { value: 0, isUncertain: true },
-            linesCount: { value: 0, isUncertain: true },
-            paragraphsCount: { value: 0, isUncertain: true },
-            pagesCount: { value: 0, isUncertain: true },
-        },
-        output: {
-            tokensCount: { value: 0, isUncertain: true },
-            charactersCount: { value: 0, isUncertain: true },
-            wordsCount: { value: 0, isUncertain: true },
-            sentencesCount: { value: 0, isUncertain: true },
-            linesCount: { value: 0, isUncertain: true },
-            paragraphsCount: { value: 0, isUncertain: true },
-            pagesCount: { value: 0, isUncertain: true },
-        },
-    });
+    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 countTotalUsage(llmTools) {
-        let totalUsage = ZERO_USAGE;
-        const proxyTools = {
-            get title() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.title;
-            },
-            get description() {
-                // TODO: [🧠] Maybe put here some suffix
-                return llmTools.description;
-            },
-            async checkConfiguration() {
-                return /* not await */ llmTools.checkConfiguration();
-            },
-            listModels() {
-                return /* not await */ llmTools.listModels();
-            },
-            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);
-                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);
-                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);
-                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
+    /**
+     * Error thrown when a fetch request fails
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class PromptbookFetchError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'PromptbookFetchError';
+            Object.setPrototypeOf(this, PromptbookFetchError.prototype);
+        }
+    }
 
-                    Or contact us on pavol@ptbk.io
+    /**
+     * 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,
+        PromptbookFetchError,
+        /*
+      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)}
 
-                `));
-            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
-     */
-
-    /**
-     * @@@
-     *
-     * @param text @@@
-     * @returns @@@
-     * @example 'hello_world'
-     * @example 'i_love_promptbook'
-     * @public exported from `@promptbook/utils`
+     * 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 normalizeTo_snake_case(text) {
-        return normalizeTo_SCREAMING_CASE(text).toLowerCase();
-    }
 
     /**
-     * Register is @@@
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it accesses and adds variables in global scope.
+     * Stores data in memory (HEAP)
      *
-     * @private internal utility, exported are only signleton instances of this class
+     * @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] = [];
-            }
-            else if (!Array.isArray(globalScope[storageName])) {
-                throw new UnexpectedError(`Expected (global) ${storageName} to be an array, but got ${typeof globalScope[storageName]}`);
-            }
-            this.storage = globalScope[storageName];
+    class MemoryStorage {
+        constructor() {
+            this.storage = {};
         }
-        list() {
-            // <- TODO: ReadonlyDeep<ReadonlyArray<TRegistered>>
-            return 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;
         }
-        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`);
-                },
-            };
+        /**
+         * Empties the list associated with the object of all key/value pairs, if there are any.
+         */
+        clear() {
+            this.storage = {};
+        }
+        /**
+         * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+         */
+        getItem(key) {
+            return this.storage[key] || null;
+        }
+        /**
+         * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+         */
+        key(index) {
+            return Object.keys(this.storage)[index] || null;
+        }
+        /**
+         * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         */
+        setItem(key, value) {
+            this.storage[key] = value;
+        }
+        /**
+         * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+         */
+        removeItem(key) {
+            delete this.storage[key];
         }
     }
 
     /**
-     * @@@
+     * Simple wrapper `new Date().toISOString()`
      *
-     * 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 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 $getCurrentDate() {
+        return new Date().toISOString();
+    }
 
     /**
-     * Determines if the given path is a root path.
+     * Intercepts LLM tools and counts total usage of the tools
      *
-     * Note: This does not check if the file exists only if the path is valid
-     * @public exported from `@promptbook/utils`
+     * Note: It can take extended `LlmExecutionTools` and cache the
+     *
+     * @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`
      */
-    function isRootPath(value) {
-        if (value === '/') {
-            return true;
+    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 (/^[A-Z]:\\$/i.test(value)) {
-            return true;
+        if (llmTools.callCompletionModel !== undefined) {
+            proxyTools.callCompletionModel = async (prompt) => {
+                return /* not await */ callCommonModel(prompt);
+            };
         }
-        return false;
+        if (llmTools.callEmbeddingModel !== undefined) {
+            proxyTools.callEmbeddingModel = async (prompt) => {
+                return /* not await */ callCommonModel(prompt);
+            };
+        }
+        // <- Note: [🤖]
+        return proxyTools;
     }
     /**
-     * TODO: [🍏] Make for MacOS paths
+     * 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
      *
-     * 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 ZERO_VALUE = $deepFreeze({ value: 0 });
     /**
-     * TODO: [®] DRY Register logic
+     * Represents the uncertain value
+     *
+     * @public exported from `@promptbook/core`
      */
-
+    const UNCERTAIN_ZERO_VALUE = $deepFreeze({ value: 0, isUncertain: true });
     /**
-     * Path to the `.env` file which was used to configure LLM tools
+     * Represents the usage with no 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 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,
+        },
+    });
     /**
-     * Pass the `.env` file which was used to configure LLM tools
-     *
-     * Note: `$` is used to indicate that this variable is making side effect
+     * Represents the usage with unknown resources consumed
      *
-     * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
+     * @public exported from `@promptbook/core`
      */
-    function $setUsedEnvFilename(filepath) {
-        $usedEnvFilename = filepath;
-    }
+    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,
+        },
+    });
     /**
-     * Creates a message with all registered LLM tools
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * 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;
-            }
-            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(' + ')}`);
+    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;
+                    }
+                }
             }
-            else {
-                morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
+            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;
+            };
         }
-        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 (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;
+            };
         }
-        return providerMessage;
-    })
-        .join('\n'))}
-        `);
+        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;
+            };
+        }
+        // <- Note: [🤖]
+        return proxyTools;
     }
     /**
-     * TODO: [®] DRY Register logic
-     * TODO: [🧠][⚛] Maybe pass env as argument
+     * 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
      */
 
     /**
      * @@@
      *
      * @@@ .env
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
      *
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
@@ -2206,33 +2803,9 @@
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
         }
-        const envFilePatterns = [
-            '.env',
-            '.env.test',
-            '.env.local',
-            '.env.development.local',
-            '.env.development',
-            '.env.production.local',
-            '.env.production',
-            '.env.prod.local',
-            '.env.prod',
-            // <- TODO: Maybe add more patterns
-        ];
-        let rootDirname = process.cwd();
-        up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
-            for (const pattern of envFilePatterns) {
-                const envFilename = path.join(rootDirname, pattern);
-                if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
-                    $setUsedEnvFilename(envFilename);
-                    dotenv__namespace.config({ path: envFilename });
-                    break up_to_root;
-                }
-            }
-            if (isRootPath(rootDirname)) {
-                break up_to_root;
-            }
-            // Note: If the directory does not exist, try the parent directory
-            rootDirname = path.join(rootDirname, '..');
+        const envFilepath = await $provideEnvFilename();
+        if (envFilepath !== null) {
+            dotenv__namespace.config({ path: envFilepath });
         }
         const llmToolsConfiguration = $llmToolsMetadataRegister
             .list()
@@ -2241,15 +2814,8 @@
         return llmToolsConfiguration;
     }
     /**
-     * TODO: [🧠][🪁] Maybe do allow to do auto-install if package not registered and not found
-     * TODO: Add Azure OpenAI
-     * TODO: [🧠][🍛]
-     * TODO: [🧠] Is there some meaningfull way how to test this util
      * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
-     * TODO: This should be maybe not under `_common` but under `utils`
-     * TODO: [🧠][⚛] Maybe pass env as argument
-     * TODO: [®] DRY Register logic */
+     */
 
     /**
      * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
@@ -2414,6 +2980,7 @@
         `);
             // TODO: [🟥] Detect browser / node and make it colorfull
             console.warn(warningMessage);
+            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             /*
             return {
                 async listModels() {
@@ -2498,6 +3065,7 @@
      * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
      *
      * @@@ .env
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
      *
      * It looks for environment variables:
      * - `process.env.OPENAI_API_KEY`
@@ -2542,16 +3110,44 @@
     /**
      * Returns LLM tools for CLI
      *
+     * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes this .env file
+     *
      * @private within the repository - for CLI utils
      */
     async function $provideLlmToolsForWizzardOrCli(options) {
         if (!$isRunningInNode()) {
             throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizzardOrCli` works only in Node.js environment');
         }
-        const { isCacheReloaded } = options !== null && options !== void 0 ? options : {};
-        return cacheLlmTools(countTotalUsage(
+        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 $EnvStorage(); // <- TODO: !!!!!! Save to `.promptbook` folder
+            let key = `PROMPTBOOK_TOKEN`;
+            if (remoteServerUrl !== DEFAULT_REMOTE_SERVER_URL) {
+                key = `${key}_${remoteServerUrl.replace(/^https?:\/\//i, '')}`;
+            }
+            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),
             }),
@@ -2567,31 +3163,157 @@
      */
 
     /**
-     * Just says that the variable is not used but should be kept
-     * No side effects.
-     *
-     * Note: It can be usefull for:
+     * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
      *
-     * 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
+     * @public exported from `@promptbook/core`
+     */
+    const promptbookFetch = async (urlOrRequest, init) => {
+        try {
+            return await fetch(urlOrRequest, init);
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            let url;
+            if (typeof urlOrRequest === 'string') {
+                url = urlOrRequest;
+            }
+            else if (urlOrRequest instanceof Request) {
+                url = urlOrRequest.url;
+            }
+            throw new PromptbookFetchError(spaceTrim__default["default"]((block) => `
+                    Can not fetch "${url}"
+
+                    Fetch error:
+                    ${block(error.message)}
+
+                `));
+        }
+    };
+    /**
+     * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
+     */
+
+    /**
+     * Checks if value is valid email
      *
-     * @param value any values
-     * @returns void
-     * @private within the repository
+     * @public exported from `@promptbook/utils`
      */
-    function keepUnused(...valuesToKeep) {
+    function isValidEmail(email) {
+        if (typeof email !== 'string') {
+            return false;
+        }
+        if (email.split('\n').length > 1) {
+            return false;
+        }
+        return /^.+@.+\..+$/.test(email);
     }
 
     /**
-     * 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`;
+                    console.log('!!!', { loginUrl });
+                    // TODO: [🧠] Should we use normal `fetch` or `scraperFetch`
+                    const response = await promptbookFetch(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 { isSuccess, message, error, identification } = (await response.json());
+                    console.log('!!!', {
+                        isSuccess,
+                        message,
+                        error,
+                        identification,
+                    });
+                    if (message) {
+                        if (isSuccess) {
+                            console.log(colors__default["default"].green(message));
+                        }
+                        else {
+                            console.log(colors__default["default"].red(message));
+                        }
+                    }
+                    if (!isSuccess) {
+                        // Note: Login failed
+                        process.exit(1);
+                    }
+                    if (!identification) {
+                        // Note: Do not get identification here, but server signalizes the success so exiting but with code 0
+                        //       This can mean for example that user needs to verify email
+                        process.exit(0);
+                    }
+                    return identification;
+                },
+            });
+        }
+        else {
+            throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
+        }
     }
 
     /**
@@ -2608,8 +3330,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());
@@ -2707,6 +3431,7 @@
                     }
                     else {
                         console.warn(`Command "${humanReadableCommand}" exceeded time limit of ${timeout}ms but continues running`);
+                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                         resolve('Command exceeded time limit');
                     }
                 });
@@ -2732,6 +3457,7 @@
                     output.push(stderr.toString());
                     if (isVerbose && stderr.toString().trim()) {
                         console.warn(stderr.toString());
+                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                     }
                 });
                 const finishWithCode = (code) => {
@@ -2743,6 +3469,7 @@
                         else {
                             if (isVerbose) {
                                 console.warn(`Command "${humanReadableCommand}" exited with code ${code}`);
+                                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                             }
                             resolve(spaceTrim.spaceTrim(output.join('\n')));
                         }
@@ -2764,6 +3491,7 @@
                     else {
                         if (isVerbose) {
                             console.warn(error);
+                            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                         }
                         resolve(spaceTrim.spaceTrim(output.join('\n')));
                     }
@@ -3165,49 +3893,73 @@
      */
 
     /**
-     * Converts PipelineCollection to serialized JSON
-     *
-     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     * Initializes `login` command for Promptbook CLI utilities
      *
-     * @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
-     */
-
-    /**
-     * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+     * 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`
+     * @private internal function of `promptbookCli`
      */
-    class ParseError extends Error {
-        constructor(message) {
-            super(message);
-            this.name = 'ParseError';
-            Object.setPrototypeOf(this, ParseError.prototype);
-        }
+    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.
+
+                        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
@@ -3605,21 +4357,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
      *
@@ -3853,32 +4590,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
      *
@@ -4049,24 +4760,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
      *
@@ -4132,177 +4825,7 @@
     }
     /**
      * 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)}
-
-                Original stack trace:
-                ${block(stack || '')}
-            `);
-        }
-        const deserializedError = new ErrorClass(message);
-        deserializedError.id = id; // Assign id to the error object
-        return deserializedError;
-    }
+     */
 
     /**
      * Asserts that the execution of a Promptbook is successful
@@ -4317,6 +4840,7 @@
         const { isSuccessful, errors, warnings } = executionResult;
         for (const warning of warnings) {
             console.warn(warning.message);
+            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
         }
         if (isSuccessful === true) {
             return;
@@ -4454,6 +4978,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)}
 
                 `));
@@ -4658,7 +5186,7 @@
                 if (parameterNames.has(subparameterName)) {
                     parameterNames.delete(subparameterName);
                     parameterNames.add(foreach.parameterName);
-                    // <- TODO: [🚎] Warn/logic error when `subparameterName` not used
+                    // <- TODO: [🏮] Warn/logic error when `subparameterName` not used
                 }
             }
         }
@@ -6273,6 +6801,7 @@
 
                     @see more at https://ptbk.io/prepare-pipeline
                 `));
+            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
         }
         let runCount = 0;
         const pipelineExecutorWithCallback = async (inputParameters, onProgress) => {
@@ -6440,32 +6969,6 @@
         return mimeTypes.extension(value) || null;
     }
 
-    /**
-     * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
-     *
-     * @private as default `fetch` function used in Promptbook scrapers
-     */
-    const scraperFetch = async (url, init) => {
-        try {
-            return await fetch(url, init);
-        }
-        catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
-            throw new KnowledgeScrapeError(spaceTrim__default["default"]((block) => `
-                    Can not fetch "${url}"
-
-                    Fetch error:
-                    ${block(error.message)}
-
-                `));
-        }
-    };
-    /**
-     * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
-     */
-
     /**
      * @@@
      *
@@ -6474,7 +6977,7 @@
     async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         // console.log('!! makeKnowledgeSourceHandler', knowledgeSource);
         var _a;
-        const { fetch = scraperFetch } = tools;
+        const { fetch = promptbookFetch } = tools;
         const { knowledgeSourceContent } = knowledgeSource;
         let { name } = knowledgeSource;
         const { rootDirname = null, 
@@ -6615,63 +7118,73 @@
         const { maxParallelCount = DEFAULT_MAX_PARALLEL_COUNT, rootDirname, isVerbose = DEFAULT_IS_VERBOSE } = options;
         const knowledgePreparedUnflatten = new Array(knowledgeSources.length);
         await forEachAsync(knowledgeSources, { maxParallelCount }, async (knowledgeSource, index) => {
-            let partialPieces = null;
-            const sourceHandler = await makeKnowledgeSourceHandler(knowledgeSource, tools, { rootDirname, isVerbose });
-            const scrapers = arrayableToArray(tools.scrapers);
-            for (const scraper of scrapers) {
-                if (!scraper.metadata.mimeTypes.includes(sourceHandler.mimeType)
-                // <- TODO: [🦔] Implement mime-type wildcards
-                ) {
-                    continue;
-                }
-                const partialPiecesUnchecked = await scraper.scrape(sourceHandler);
-                if (partialPiecesUnchecked !== null) {
-                    partialPieces = [...partialPiecesUnchecked];
-                    // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
-                    break;
-                }
-                console.warn(spaceTrim__default["default"]((block) => `
-                        Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
+            try {
+                let partialPieces = null;
+                const sourceHandler = await makeKnowledgeSourceHandler(knowledgeSource, tools, { rootDirname, isVerbose });
+                const scrapers = arrayableToArray(tools.scrapers);
+                for (const scraper of scrapers) {
+                    if (!scraper.metadata.mimeTypes.includes(sourceHandler.mimeType)
+                    // <- TODO: [🦔] Implement mime-type wildcards
+                    ) {
+                        continue;
+                    }
+                    const partialPiecesUnchecked = await scraper.scrape(sourceHandler);
+                    if (partialPiecesUnchecked !== null) {
+                        partialPieces = [...partialPiecesUnchecked];
+                        // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
+                        break;
+                    }
+                    console.warn(spaceTrim__default["default"]((block) => `
+                            Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
 
-                        The source:
-                        ${block(knowledgeSource.knowledgeSourceContent
-                .split('\n')
-                .map((line) => `> ${line}`)
-                .join('\n'))}
+                            The source:
+                            ${block(knowledgeSource.knowledgeSourceContent
+                    .split('\n')
+                    .map((line) => `> ${line}`)
+                    .join('\n'))}
 
-                        ${block($registeredScrapersMessage(scrapers))}
+                            ${block($registeredScrapersMessage(scrapers))}
 
 
-                    `));
-            }
-            if (partialPieces === null) {
-                throw new KnowledgeScrapeError(spaceTrim__default["default"]((block) => `
-                        Cannot scrape knowledge
+                        `));
+                    // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+                }
+                if (partialPieces === null) {
+                    throw new KnowledgeScrapeError(spaceTrim__default["default"]((block) => `
+                            Cannot scrape knowledge
 
-                        The source:
-                        > ${block(knowledgeSource.knowledgeSourceContent
-                .split('\n')
-                .map((line) => `> ${line}`)
-                .join('\n'))}
+                            The source:
+                            > ${block(knowledgeSource.knowledgeSourceContent
+                    .split('\n')
+                    .map((line) => `> ${line}`)
+                    .join('\n'))}
 
-                        No scraper found for the mime type "${sourceHandler.mimeType}"
+                            No scraper found for the mime type "${sourceHandler.mimeType}"
 
-                        ${block($registeredScrapersMessage(scrapers))}
+                            ${block($registeredScrapersMessage(scrapers))}
 
 
-                    `));
+                        `));
+                }
+                const pieces = partialPieces.map((partialPiece) => ({
+                    ...partialPiece,
+                    sources: [
+                        {
+                            name: knowledgeSource.name,
+                            // line, column <- TODO: [☀]
+                            // <- TODO: [❎]
+                        },
+                    ],
+                }));
+                knowledgePreparedUnflatten[index] = pieces;
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                console.warn(error);
+                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
-            const pieces = partialPieces.map((partialPiece) => ({
-                ...partialPiece,
-                sources: [
-                    {
-                        name: knowledgeSource.name,
-                        // line, column <- TODO: [☀]
-                        // <- TODO: [❎]
-                    },
-                ],
-            }));
-            knowledgePreparedUnflatten[index] = pieces;
         });
         const knowledgePrepared = knowledgePreparedUnflatten.flat();
         return knowledgePrepared;
@@ -6777,7 +7290,7 @@
         // TODO: [🚐] Make arrayable LLMs -> single LLM DRY
         const _llms = arrayableToArray(tools.llm);
         const llmTools = _llms.length === 1 ? _llms[0] : joinLlmExecutionTools(..._llms);
-        const llmToolsWithUsage = countTotalUsage(llmTools);
+        const llmToolsWithUsage = countUsage(llmTools);
         //    <- TODO: [🌯]
         /*
         TODO: [🧠][🪑][🔃] Should this be done or not
@@ -8496,7 +9009,8 @@
             if ($pipelineJson.defaultModelRequirements[command.key] !== undefined) {
                 if ($pipelineJson.defaultModelRequirements[command.key] === command.value) {
                     console.warn(`Multiple commands \`MODEL ${command.key} ${command.value}\` in the pipeline head`);
-                    // <- TODO: [🚎][💩] Some better way how to get warnings from pipeline parsing / logic
+                    // <- TODO: [🏮] Some better way how to get warnings from pipeline parsing / logic
+                    // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                 }
                 else {
                     throw new ParseError(spaceTrim__default["default"](`
@@ -8528,6 +9042,7 @@
                     modelVariant: 'VARIANT',
                     maxTokens: '???',
                 }[command.key]} ${command.value}\` in the task "${$taskJson.title || $taskJson.name}"`);
+                    // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                 }
                 else {
                     throw new ParseError(spaceTrim__default["default"](`
@@ -8807,15 +9322,15 @@
         }
         console.warn(spaceTrim__default["default"](`
 
-         Persona "${personaName}" is defined multiple times with different description:
+            Persona "${personaName}" is defined multiple times with different description:
 
-         First definition:
-         ${persona.description}
+            First definition:
+            ${persona.description}
 
-         Second definition:
-         ${personaDescription}
+            Second definition:
+            ${personaDescription}
 
-     `));
+        `));
         persona.description += spaceTrim__default["default"]('\n\n' + personaDescription);
     }
 
@@ -11351,7 +11866,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
 
@@ -11365,7 +11879,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);
@@ -11393,7 +11908,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,
@@ -11446,6 +11964,7 @@
                     : path.join(path$1, `${DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME}.${extension}`);
                 if (!output.endsWith(`.${extension}`)) {
                     console.warn(colors__default["default"].yellow(`Warning: Extension of output file should be "${extension}"`));
+                    // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                 }
                 await promises.mkdir(path.dirname(filename), { recursive: true });
                 if (typeof content === 'string') {
@@ -11546,6 +12065,7 @@
             }
             if (formats.length > 0) {
                 console.warn(colors__default["default"].yellow(`Format ${formats.join(' and ')} is not supported`));
+                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             console.info(colors__default["default"].green(`Collection builded successfully`));
             if (isVerbose) {
@@ -11592,7 +12112,8 @@
                 `));
         }
         console.warn(`No place where to put the section <!--${sectionName}-->, using the end of the file`);
-        // <- TODO: [🚎][💩] Some better way how to get warnings from pipeline parsing / logic
+        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+        // <- TODO: [🏮] Some better way how to get warnings from pipeline parsing / logic
         return spaceTrim.spaceTrim((block) => `
             ${block(content)}
 
@@ -11658,8 +12179,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) {
@@ -12260,13 +12781,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);
@@ -12291,7 +12811,7 @@
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
             let llm;
             try {
-                llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+                llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
             }
             catch (error) {
                 if (!(error instanceof Error)) {
@@ -12346,9 +12866,9 @@
             const tools = {
                 llm,
                 fs,
-                fetch: scraperFetch,
+                fetch: promptbookFetch,
                 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 ---'));
@@ -12512,11 +13032,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
@@ -12583,9 +13104,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')) {
@@ -12622,9 +13172,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'))}
 
@@ -12642,7 +13195,96 @@
                     https://github.com/webgptorg/promptbook
                 `));
         });
-        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 { isSuccess, error, message, identification } = await login({
+                    username,
+                    password,
+                    appId,
+                    rawRequest: request,
+                    rawResponse: response,
+                });
+                response.status(201).send({
+                    isSuccess,
+                    message,
+                    error: error ? serializeError(error) : undefined,
+                    identification,
+                });
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                if (error instanceof AuthenticationError) {
+                    response.status(401).send({
+                        isSuccess: false,
+                        message: error.message,
+                        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;
@@ -12652,7 +13294,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');
@@ -12706,10 +13371,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');
@@ -12718,7 +13399,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);
@@ -12730,7 +13411,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;
@@ -12907,6 +13617,15 @@
         }
         let isDestroyed = false;
         return {
+            get httpServer() {
+                return httpServer;
+            },
+            get expressApp() {
+                return app;
+            },
+            get socketIoServer() {
+                return server;
+            },
             get isDestroyed() {
                 return isDestroyed;
             },
@@ -12957,12 +13676,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);
@@ -12975,6 +13694,7 @@
             const url = !rawUrl ? null : new URL(rawUrl);
             if (url !== null && url.port !== port.toString()) {
                 console.warn(colors__default["default"].yellow(`Port in --url is different from --port which the server will listen on, this is ok only if you proxy from one port to another, for exaple via nginx or docker`));
+                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             let rootUrl = undefined;
             if (url !== null) {
@@ -12990,7 +13710,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,
@@ -13014,6 +13734,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 });
@@ -13050,8 +13773,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 [◽]
@@ -13060,7 +13783,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,
@@ -13120,6 +13843,18 @@
      * Note: This is named "test-command.ts" to avoid name collision with jest unit test files
      */
 
+    /**
+     * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
+     *
+     * @private utility of CLI
+     */
+    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);
+    }
+
     /**
      * Runs CLI utilities of Promptbook package
      *
@@ -13144,8 +13879,10 @@
         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);
         $initializeHelloCommand(program);
         $initializeMakeCommand(program);
         $initializePrettifyCommand(program);
@@ -13153,6 +13890,8 @@
         $initializeListModelsCommand(program);
         $initializeListScrapersCommand(program);
         $initializeStartServerCommand(program);
+        // TODO: [🧠] Should it be here or not> $addGlobalOptionsToCommand(program);
+        program.commands.forEach($addGlobalOptionsToCommand);
         program.parse(process.argv);
     }
     /**
@@ -13202,8 +13941,7 @@
                 options: {
                     apiKey: 'sk-ant-api03-',
                     isProxied: true,
-                    remoteUrl: DEFAULT_REMOTE_URL,
-                    path: DEFAULT_REMOTE_URL_PATH,
+                    remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
                 },
             };
         },
@@ -13226,146 +13964,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
      *
@@ -13466,7 +14064,7 @@
      * Helper of usage compute
      *
      * @param content the content of prompt or response
-     * @returns part of PromptResultUsageCounts
+     * @returns part of UsageCounts
      *
      * @private internal utility of LlmExecutionTools
      */
@@ -13490,7 +14088,7 @@
      */
     function uncertainNumber(value) {
         if (value === null || value === undefined || Number.isNaN(value)) {
-            return { value: 0, isUncertain: true };
+            return UNCERTAIN_ZERO_VALUE;
         }
         return { value };
     }
@@ -13727,7 +14325,7 @@
             const resultContent = rawResponse.choices[0].text;
             // eslint-disable-next-line prefer-const
             complete = $getCurrentDate();
-            const usage = { price: 'UNKNOWN', inputTokens: 0, outputTokens: 0 /* <- TODO: [🐞] Compute usage * / } satisfies PromptResultUsage;
+            const usage = { price: 'UNKNOWN', inputTokens: 0, outputTokens: 0 /* <- TODO: [🐞] Compute usage * / } satisfies Usage;
 
 
 
@@ -14823,11 +15421,17 @@
                     throw new PipelineExecutionError('No response message');
                 }
                 const complete = $getCurrentDate();
-                /*
-                TODO: [🕘] Usage count
-                const usage = computeOpenAiUsage(content || '', resultContent || '', rawResponse);
-                */
-                const usage = UNCERTAIN_USAGE;
+                const usage = {
+                    price: UNCERTAIN_ZERO_VALUE,
+                    input: {
+                        tokensCount: uncertainNumber(rawResponse.usage.promptTokens),
+                        ...computeUsageCounts(rawPromptContent),
+                    },
+                    output: {
+                        tokensCount: uncertainNumber(rawResponse.usage.completionTokens),
+                        ...computeUsageCounts(rawResponse.text),
+                    },
+                };
                 return exportJson({
                     name: 'promptResult',
                     message: `Result of \`createExecutionToolsFromVercelProvider.callChatModel\``,
@@ -15180,15 +15784,18 @@
             }
             return this.client;
         }
+        /*
+        Note: Commenting this out to avoid circular dependency
         /**
          * Create (sub)tools for calling OpenAI API Assistants
          *
          * @param assistantId Which assistant to use
          * @returns Tools for calling OpenAI API Assistants with same token
-         */
-        createAssistantSubtools(assistantId) {
+         * /
+        public createAssistantSubtools(assistantId: string_token): OpenAiAssistantExecutionTools {
             return new OpenAiAssistantExecutionTools({ ...this.options, assistantId });
         }
+        */
         /**
          * Check the `options` passed to `constructor`
          */