@promptbook/cli 0.89.0-5 → 0.89.0-7

package/esm/index.es.js

@@ -2,11 +2,13 @@ import colors from 'colors';
 import commander from 'commander';
 import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { forTime, forEver } from 'waitasecond';
+import prompts from 'prompts';
 import { basename, join, dirname, relative } from 'path';
 import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink, rm, rename, rmdir } from 'fs/promises';
 import hexEncoder from 'crypto-js/enc-hex';
 import sha256 from 'crypto-js/sha256';
 import { randomBytes } from 'crypto';
+import { io } from 'socket.io-client';
 import { Subject } from 'rxjs';
 import * as dotenv from 'dotenv';
 import { spawn } from 'child_process';
@@ -17,12 +19,12 @@ import { parse, unparse } from 'papaparse';
 import { SHA256 } from 'crypto-js';
 import { lookup, extension } from 'mime-types';
 import glob from 'glob-promise';
-import prompts from 'prompts';
 import moment from 'moment';
 import express from 'express';
 import http from 'http';
 import { Server } from 'socket.io';
-import { io } from 'socket.io-client';
+import swaggerJsdoc from 'swagger-jsdoc';
+import swaggerUi from 'swagger-ui-express';
 import Anthropic from '@anthropic-ai/sdk';
 import { OpenAIClient, AzureKeyCredential } from '@azure/openai';
 import OpenAI from 'openai';
@@ -44,7 +46,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.89.0-5';
+const PROMPTBOOK_ENGINE_VERSION = '0.89.0-7';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -213,6 +215,7 @@ const DEFAULT_MAX_EXECUTION_ATTEMPTS = 10; // <- TODO: [🤹‍♂️]
  */
 const DEFAULT_BOOKS_DIRNAME = './books';
 // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+// TODO: !!!!!! Just .promptbook dir, hardocode others
 /**
  * Where to store the temporary downloads
  *
@@ -237,6 +240,21 @@ const DEFAULT_EXECUTION_CACHE_DIRNAME = './.promptbook/execution-cache';
  * @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`
  *
@@ -257,13 +275,7 @@ const MOMENT_ARG_THRESHOLDS = {
  *
  * @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: [🧜‍♂️]
 /**
  * @@@
@@ -305,7 +317,7 @@ const IS_PIPELINE_LOGIC_VALIDATED = just(
 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
  */
 
 /**
@@ -483,7 +495,8 @@ function $initializeHelloCommand(program) {
     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.cyan(`${greeting} ${name}`));
         await forTime(1000);
         console.info(colors.rainbow(`Nice to meet you!`));
@@ -497,40 +510,27 @@ function $initializeHelloCommand(program) {
  */
 
 /**
- * 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$1((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,
-        access,
-        constants,
-        readFile,
-        writeFile,
-        readdir,
-        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
@@ -601,120 +601,566 @@ class UnexpectedError extends Error {
 }
 
 /**
- * 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((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((block) => `
-                        \`${name}\` is unserialized Error
-
-                        Use function \`serializeError\`
+        return {
+            registerName: this.registerName,
+            packageName,
+            className,
+            get isDestroyed() {
+                return false;
+            },
+            destroy() {
+                throw new NotYetImplementedError(`Registration to ${this.registerName} is permanent in this version of Promptbook`);
+            },
+        };
+    }
+}
+
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this interacts with the global scope
+ * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @public exported from `@promptbook/core`
+ */
+const $llmToolsMetadataRegister = new $Register('llm_tools_metadata');
+/**
+ * TODO: [®] DRY Register logic
+ */
+
+/**
+ * @@@
+ *
+ * Note: `$` is used to indicate that this interacts with the global scope
+ * @singleton Only one instance of each register is created per build, but thare can be more @@@
+ * @public exported from `@promptbook/core`
+ */
+const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
+/**
+ * TODO: [®] DRY Register logic
+ */
+
+/**
+ * Path to the `.env` file which was used to configure LLM tools
+ *
+ * Note: `$` is used to indicate that this variable is changed by side effect in `$provideLlmToolsConfigurationFromEnv` through `$setUsedEnvFilename`
+ */
+let $usedEnvFilename = null;
+/**
+ * Pass the `.env` file which was used to configure LLM tools
+ *
+ * Note: `$` is used to indicate that this variable is making side effect
+ *
+ * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
+ */
+function $setUsedEnvFilename(filepath) {
+    $usedEnvFilename = filepath;
+}
+/**
+ * Creates a message with all registered LLM tools
+ *
+ * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
+ *
+ * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
+ */
+function $registeredLlmToolsMessage() {
+    let env;
+    if ($isRunningInNode()) {
+        env = process.env;
+        // <- TODO: [⚛] Some DRY way how to get to `process.env` and pass it into functions - ACRY search for `env`
+    }
+    else {
+        env = {};
+    }
+    /**
+     * Mixes registered LLM tools from $llmToolsMetadataRegister and $llmToolsRegister
+     */
+    const all = [];
+    for (const { title, packageName, className, envVariables } of $llmToolsMetadataRegister.list()) {
+        if (all.some((item) => item.packageName === packageName && item.className === className)) {
+            continue;
+        }
+        all.push({ title, packageName, className, envVariables });
+    }
+    for (const { packageName, className } of $llmToolsRegister.list()) {
+        if (all.some((item) => item.packageName === packageName && item.className === className)) {
+            continue;
+        }
+        all.push({ packageName, className });
+    }
+    const metadata = all.map((metadata) => {
+        var _a, _b;
+        const isMetadataAviailable = $llmToolsMetadataRegister
+            .list()
+            .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+        const isInstalled = $llmToolsRegister
+            .list()
+            .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+        const isFullyConfigured = ((_a = metadata.envVariables) === null || _a === void 0 ? void 0 : _a.every((envVariableName) => env[envVariableName] !== undefined)) || false;
+        const isPartiallyConfigured = ((_b = metadata.envVariables) === null || _b === void 0 ? void 0 : _b.some((envVariableName) => env[envVariableName] !== undefined)) || false;
+        // <- Note: [🗨]
+        return { ...metadata, isMetadataAviailable, isInstalled, isFullyConfigured, isPartiallyConfigured };
+    });
+    const usedEnvMessage = $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
+    if (metadata.length === 0) {
+        return spaceTrim((block) => `
+                No LLM providers are available.
+
+                ${block(usedEnvMessage)}
+          `);
+    }
+    return spaceTrim((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(`
+                                ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
+                                    ${morePieces.join('; ')}
+                            `);
+        if ($isRunningInNode) {
+            if (isInstalled && isFullyConfigured) {
+                providerMessage = colors.green(providerMessage);
+            }
+            else if (isInstalled && isPartiallyConfigured) {
+                providerMessage = colors.yellow(providerMessage);
+            }
+            else {
+                providerMessage = colors.gray(providerMessage);
+            }
+        }
+        return providerMessage;
+    })
+        .join('\n'))}
+        `);
+}
+/**
+ * TODO: [®] DRY Register logic
+ * TODO: [🧠][⚛] Maybe pass env as argument
+ */
+
+/**
+ * Just says that the variable is not used but should be kept
+ * No side effects.
+ *
+ * Note: It can be usefull for:
+ *
+ * 1) Suppressing eager optimization of unused imports
+ * 2) Suppressing eslint errors of unused variables in the tests
+ * 3) Keeping the type of the variable for type testing
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+function keepUnused(...valuesToKeep) {
+}
+
+/**
+ * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+function $sideEffect(...sideEffectSubjects) {
+    keepUnused(...sideEffectSubjects);
+}
+
+/**
+ * Checks if value is valid email
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidEmail(email) {
+    if (typeof email !== 'string') {
+        return false;
+    }
+    if (email.split('\n').length > 1) {
+        return false;
+    }
+    return /^.+@.+\..+$/.test(email);
+}
+
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: Dataurl are considered perfectly valid.
+ * Note: There are two simmilar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
+    }
+    try {
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
+        }
+        const urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+
+/**
+ * Stores data in memory (HEAP)
+ *
+ * @public exported from `@promptbook/core`
+ */
+class MemoryStorage {
+    constructor() {
+        this.storage = {};
+    }
+    /**
+     * Returns the number of key/value pairs currently present in the list associated with the object.
+     */
+    get length() {
+        return Object.keys(this.storage).length;
+    }
+    /**
+     * Empties the list associated with the object of all key/value pairs, if there are any.
+     */
+    clear() {
+        this.storage = {};
+    }
+    /**
+     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    getItem(key) {
+        return this.storage[key] || null;
+    }
+    /**
+     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+     */
+    key(index) {
+        return Object.keys(this.storage)[index] || null;
+    }
+    /**
+     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    setItem(key, value) {
+        this.storage[key] = value;
+    }
+    /**
+     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    removeItem(key) {
+        delete this.storage[key];
+    }
+}
+
+/**
+ * Just marks a place of place where should be something implemented
+ * No side effects.
+ *
+ * Note: It can be usefull suppressing eslint errors of unused variables
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+function TODO_USE(...value) {
+}
+
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/node`
+ */
+function $provideFilesystemForNode(options) {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+    }
+    return {
+        stat,
+        access,
+        constants,
+        readFile,
+        writeFile,
+        readdir,
+        mkdir,
+    };
+}
+/**
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
+
+/**
+ * Orders JSON object by keys
+ *
+ * @returns The same type of object as the input re-ordered
+ * @public exported from `@promptbook/utils`
+ */
+function orderJson(options) {
+    const { value, order } = options;
+    const orderedValue = {
+        ...(order === undefined ? {} : Object.fromEntries(order.map((key) => [key, undefined]))),
+        ...value,
+    };
+    return orderedValue;
+}
+
+/**
+ * Freezes the given object and all its nested objects recursively
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it mutates given object
+ * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
+ *
+ * @returns The same object as the input, but deeply frozen
+ * @public exported from `@promptbook/utils`
+ */
+function $deepFreeze(objectValue) {
+    if (Array.isArray(objectValue)) {
+        return Object.freeze(objectValue.map((item) => $deepFreeze(item)));
+    }
+    const propertyNames = Object.getOwnPropertyNames(objectValue);
+    for (const propertyName of propertyNames) {
+        const value = objectValue[propertyName];
+        if (value && typeof value === 'object') {
+            $deepFreeze(value);
+        }
+    }
+    Object.freeze(objectValue);
+    return objectValue;
+}
+/**
+ * TODO: [🧠] Is there a way how to meaningfully test this utility
+ */
+
+/**
+ * Checks if the value is [🚉] serializable as JSON
+ * If not, throws an UnexpectedError with a rich error message and tracking
+ *
+ * - Almost all primitives are serializable BUT:
+ * - `undefined` is not serializable
+ * - `NaN` is not serializable
+ * - Objects and arrays are serializable if all their properties are serializable
+ * - Functions are not serializable
+ * - Circular references are not serializable
+ * - `Date` objects are not serializable
+ * - `Map` and `Set` objects are not serializable
+ * - `RegExp` objects are not serializable
+ * - `Error` objects are not serializable
+ * - `Symbol` objects are not serializable
+ * - And much more...
+ *
+ * @throws UnexpectedError if the value is not serializable as JSON
+ * @public exported from `@promptbook/utils`
+ */
+function checkSerializableAsJson(options) {
+    const { value, name, message } = options;
+    if (value === undefined) {
+        throw new UnexpectedError(`${name} is undefined`);
+    }
+    else if (value === null) {
+        return;
+    }
+    else if (typeof value === 'boolean') {
+        return;
+    }
+    else if (typeof value === 'number' && !isNaN(value)) {
+        return;
+    }
+    else if (typeof value === 'string') {
+        return;
+    }
+    else if (typeof value === 'symbol') {
+        throw new UnexpectedError(`${name} is symbol`);
+    }
+    else if (typeof value === 'function') {
+        throw new UnexpectedError(`${name} is function`);
+    }
+    else if (typeof value === 'object' && Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            checkSerializableAsJson({ name: `${name}[${i}]`, value: value[i], message });
+        }
+    }
+    else if (typeof value === 'object') {
+        if (value instanceof Date) {
+            throw new UnexpectedError(spaceTrim((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((block) => `
+                        \`${name}\` is unserialized Error
+
+                        Use function \`serializeError\`
 
                         Additional message for \`${name}\`:
                         ${block(message || '(nothing)')}
@@ -1058,35 +1504,6 @@ function isValidFilePath(filename) {
  * 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',
@@ -1470,32 +1887,177 @@ class FileCacheStorage {
         // TODO: [🌗]
         return value;
     }
-    /**
-     * @@@ 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 filename = this.getFilenameForKey(key);
-        if (!isSerializableAsJson(value)) {
-            throw new UnexpectedError(`The "${key}" you want to store in JSON file is not serializable as JSON`);
-        }
-        const fileContent = stringifyPipelineJson(value);
-        await mkdir(dirname(filename), { recursive: true }); // <- [0]
-        await writeFile(filename, fileContent, 'utf-8');
+    /**
+     * @@@ 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 filename = this.getFilenameForKey(key);
+        if (!isSerializableAsJson(value)) {
+            throw new UnexpectedError(`The "${key}" you want to store in JSON file is not serializable as JSON`);
+        }
+        const fileContent = stringifyPipelineJson(value);
+        await mkdir(dirname(filename), { recursive: true }); // <- [0]
+        await writeFile(filename, fileContent, '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.
+     */
+    async removeItem(key) {
+        const filename = this.getFilenameForKey(key);
+        // TODO: [🧠] What to use `unlink` or `rm`
+        await unlink(filename);
+        // <- TODO: [🐿][🧠] Maybe remove empty folders
+        //          [0] When `setItem` and `removeItem` called, the state of the file system should be the same
+    }
+}
+/**
+ * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
+
+/**
+ * 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);
+    }
+}
+
+/**
+ * AuthenticationError is thrown from login function which is dependency of remote server
+ *
+ * @public exported from `@promptbook/core`
+ */
+class AuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+
+/**
+ * This error indicates that the pipeline collection cannot be propperly loaded
+ *
+ * @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);
+    }
+}
+
+/**
+ * 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$1((block) => `
+                    ${block(message)}
+
+                    Note: You have probbably forgot to provide some tools for pipeline execution or preparation
+
+                `));
+        this.name = 'MissingToolsError';
+        Object.setPrototypeOf(this, MissingToolsError.prototype);
+    }
+}
+
+/**
+ * This error indicates that promptbook not found in the collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotFoundError';
+        Object.setPrototypeOf(this, NotFoundError.prototype);
     }
-    /**
-     * @@@ 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.
-     */
-    async removeItem(key) {
-        const filename = this.getFilenameForKey(key);
-        // TODO: [🧠] What to use `unlink` or `rm`
-        await unlink(filename);
-        // <- TODO: [🐿][🧠] Maybe remove empty folders
-        //          [0] When `setItem` and `removeItem` called, the state of the file system should be the same
+}
+
+/**
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ *
+ * @public exported from `@promptbook/core`
+ */
+class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
     }
 }
 /**
- * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: Maybe split `ParseError` and `ApplyError`
  */
 
 /**
@@ -1533,51 +2095,260 @@ class PipelineExecutionError extends Error {
  */
 
 /**
- * Stores data in memory (HEAP)
+ * 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 MemoryStorage {
-    constructor() {
-        this.storage = {};
+class PipelineLogicError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PipelineLogicError';
+        Object.setPrototypeOf(this, PipelineLogicError.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);
+    }
+}
+
+/**
+ * Index of all custom errors
+ *
+ * @public exported from `@promptbook/core`
+ */
+const PROMPTBOOK_ERRORS = {
+    AbstractFormatError,
+    CsvFormatError,
+    CollectionError,
+    EnvironmentMismatchError,
+    ExpectError,
+    KnowledgeScrapeError,
+    LimitReachedError,
+    MissingToolsError,
+    NotFoundError,
+    NotYetImplementedError,
+    ParseError,
+    PipelineExecutionError,
+    PipelineLogicError,
+    PipelineUrlError,
+    UnexpectedError,
+    // TODO: [🪑]> VersionMismatchError,
+};
+/**
+ * Index of all javascript errors
+ *
+ * @private for internal usage
+ */
+const COMMON_JAVASCRIPT_ERRORS = {
+    Error,
+    EvalError,
+    RangeError,
+    ReferenceError,
+    SyntaxError,
+    TypeError,
+    URIError,
+    AggregateError,
+    AuthenticationError,
+    /*
+  Note: Not widely supported
+  > InternalError,
+  > ModuleError,
+  > HeapError,
+  > WebAssemblyCompileError,
+  > WebAssemblyRuntimeError,
+  */
+};
+/**
+ * Index of all errors
+ *
+ * @private for internal usage
+ */
+const ALL_ERRORS = {
+    ...PROMPTBOOK_ERRORS,
+    ...COMMON_JAVASCRIPT_ERRORS,
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * 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((block) => `
+                ${block(message)}
+
+                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: 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 { 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 = 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.
+ *
+ * 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';
     }
     /**
-     * Returns the number of key/value pairs currently present in the list associated with the object.
+     * Check the configuration of all execution tools
      */
-    get length() {
-        return Object.keys(this.storage).length;
+    async checkConfiguration() {
+        const socket = await createRemoteClient(this.options);
+        socket.disconnect();
+        // TODO: [main] !!3 Check version of the remote server and compatibility
+        // TODO: [🎍] Send checkConfiguration
     }
     /**
-     * Empties the list associated with the object of all key/value pairs, if there are any.
+     * List all available models that can be used
      */
-    clear() {
-        this.storage = {};
+    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;
     }
     /**
-     * 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.
+     * Calls remote proxy server to use a chat model
      */
-    getItem(key) {
-        return this.storage[key] || null;
+    callChatModel(prompt) {
+        if (this.options.isVerbose) {
+            console.info(`🖋 Remote callChatModel call`);
+        }
+        return /* not await */ this.callCommonModel(prompt);
     }
     /**
-     * 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.
+     * Calls remote proxy server to use a completion model
      */
-    key(index) {
-        return Object.keys(this.storage)[index] || null;
+    callCompletionModel(prompt) {
+        if (this.options.isVerbose) {
+            console.info(`💬 Remote callCompletionModel call`);
+        }
+        return /* not await */ this.callCommonModel(prompt);
     }
     /**
-     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     * Calls remote proxy server to use a embedding model
      */
-    setItem(key, value) {
-        this.storage[key] = value;
+    callEmbeddingModel(prompt) {
+        if (this.options.isVerbose) {
+            console.info(`💬 Remote callEmbeddingModel call`);
+        }
+        return /* not await */ this.callCommonModel(prompt);
     }
+    // <- Note: [🤖] callXxxModel
     /**
-     * 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.
+     * Calls remote proxy server to use both completion or chat model
      */
-    removeItem(key) {
-        delete this.storage[key];
+    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`
+ */
 
 /**
  * Simple wrapper `new Date().toISOString()`
@@ -1863,339 +2634,25 @@ function countUsage(llmTools) {
  * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
  *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
- */
-
-/**
- * This error type indicates that some part of the code is not implemented yet
- *
- * @public exported from `@promptbook/core`
- */
-class NotYetImplementedError extends Error {
-    constructor(message) {
-        super(spaceTrim$1((block) => `
-                    ${block(message)}
-
-                    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);
-    }
-}
-
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this function is not a pure function - it access global scope
- *
- *  @private internal function of `$Register`
- */
-function $getGlobalScope() {
-    return Function('return this')();
-}
-
-/**
- * @@@
- *
- * @param text @@@
- * @returns @@@
- * @example 'HELLO_WORLD'
- * @example 'I_LOVE_PROMPTBOOK'
- * @public exported from `@promptbook/utils`
- */
-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;
-    }
-    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`
- */
-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.
- *
- * @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 (!Array.isArray(globalScope[storageName])) {
-            throw new UnexpectedError(`Expected (global) ${storageName} to be an array, but got ${typeof globalScope[storageName]}`);
-        }
-        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 {
-            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`);
-            },
-        };
-    }
-}
-
-/**
- * @@@
- *
- * 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
- */
-
-/**
- * Determines if the given path is a root path.
- *
- * Note: This does not check if the file exists only if the path is valid
- * @public exported from `@promptbook/utils`
- */
-function isRootPath(value) {
-    if (value === '/') {
-        return true;
-    }
-    if (/^[A-Z]:\\$/i.test(value)) {
-        return true;
-    }
-    return false;
-}
-/**
- * TODO: [🍏] Make for MacOS paths
- */
-
-/**
- * @@@
- *
- * Note: `$` is used to indicate that this interacts with the global scope
- * @singleton Only one instance of each register is created per build, but thare can be more @@@
- * @public exported from `@promptbook/core`
- */
-const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
-/**
- * TODO: [®] DRY Register logic
- */
-
-/**
- * Path to the `.env` file which was used to configure LLM tools
- *
- * Note: `$` is used to indicate that this variable is changed by side effect in `$provideLlmToolsConfigurationFromEnv` through `$setUsedEnvFilename`
- */
-let $usedEnvFilename = null;
-/**
- * Pass the `.env` file which was used to configure LLM tools
- *
- * Note: `$` is used to indicate that this variable is making side effect
- *
- * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
- */
-function $setUsedEnvFilename(filepath) {
-    $usedEnvFilename = filepath;
-}
+ */
+
 /**
- * Creates a message with all registered LLM tools
- *
- * Note: This function is used to create a (error) message when there is no constructor for some LLM provider
+ * Determines if the given path is a root path.
  *
- * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
+ * Note: This does not check if the file exists only if the path is valid
+ * @public exported from `@promptbook/utils`
  */
-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 });
+function isRootPath(value) {
+    if (value === '/') {
+        return true;
     }
-    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((block) => `
-                No LLM providers are available.
-
-                ${block(usedEnvMessage)}
-          `);
+    if (/^[A-Z]:\\$/i.test(value)) {
+        return true;
     }
-    return spaceTrim((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(`
-                                ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
-                                    ${morePieces.join('; ')}
-                            `);
-        if ($isRunningInNode) {
-            if (isInstalled && isFullyConfigured) {
-                providerMessage = colors.green(providerMessage);
-            }
-            else if (isInstalled && isPartiallyConfigured) {
-                providerMessage = colors.yellow(providerMessage);
-            }
-            else {
-                providerMessage = colors.gray(providerMessage);
-            }
-        }
-        return providerMessage;
-    })
-        .join('\n'))}
-        `);
+    return false;
 }
 /**
- * TODO: [®] DRY Register logic
- * TODO: [🧠][⚛] Maybe pass env as argument
+ * TODO: [🍏] Make for MacOS paths
  */
 
 /**
@@ -2558,10 +3015,33 @@ 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 : {};
+    options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
+    const { strategy, isCacheReloaded } = options;
+    let llmExecutionTools;
+    if (strategy === 'REMOTE_SERVER') {
+        const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
+        const storage = new MemoryStorage(); // <- TODO: !!!!!! Save to `.promptbook` folder
+        const key = `${remoteServerUrl}-identification`;
+        let identification = await storage.getItem(key);
+        if (identification === null) {
+            identification = await loginPrompt();
+            await storage.setItem(key, identification);
+        }
+        llmExecutionTools = new RemoteLlmExecutionTools({
+            remoteServerUrl,
+            identification,
+        });
+    }
+    else if (strategy === 'BRING_YOUR_OWN_KEYS') {
+        llmExecutionTools = await $provideLlmToolsFromEnv();
+    }
+    else {
+        throw new UnexpectedError(`\`$provideLlmToolsForWizzardOrCli\` wrong strategy "${strategy}"`);
+    }
     return cacheLlmTools(countUsage(
+    //        <- TODO: [🌯] We dont use countUsage at all, maybe just unwrap it
     //        <- Note: for example here we don`t want the [🌯]
-    await $provideLlmToolsFromEnv()), {
+    llmExecutionTools), {
         storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
             rootFolderPath: join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
         }),
@@ -2577,31 +3057,88 @@ async function $provideLlmToolsForWizzardOrCli(options) {
  */
 
 /**
- * Just says that the variable is not used but should be kept
- * No side effects.
- *
- * Note: It can be usefull for:
- *
- * 1) Suppressing eager optimization of unused imports
- * 2) Suppressing eslint errors of unused variables in the tests
- * 3) Keeping the type of the variable for type testing
- *
- * @param value any values
- * @returns void
- * @private within the repository
- */
-function keepUnused(...valuesToKeep) {
-}
-
-/**
- * Just says that the variable is not used directlys but should be kept because the existence of the variable is important
- *
- * @param value any values
- * @returns void
- * @private within the repository
+ * @private utility of CLI
  */
-function $sideEffect(...sideEffectSubjects) {
-    keepUnused(...sideEffectSubjects);
+function $provideLlmToolsForCli(options) {
+    const { cliOptions: { 
+    /* TODO: Use verbose: isVerbose, */ interactive: isInteractive, provider, remoteServerUrl: remoteServerUrlRaw, }, } = options;
+    let strategy;
+    if (/^b/i.test(provider)) {
+        strategy = 'BRING_YOUR_OWN_KEYS';
+    }
+    else if (/^r/i.test(provider)) {
+        strategy = 'REMOTE_SERVER';
+    }
+    else {
+        console.log(colors.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.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.red(`You can not login to remote server in non-interactive mode`));
+                    process.exit(1);
+                }
+                const { username, password } = await prompts([
+                    {
+                        type: 'text',
+                        name: 'username',
+                        message: 'Enter your email:',
+                        validate: (value) => (isValidEmail(value) ? true : 'Valid email is required'),
+                    },
+                    {
+                        type: 'password',
+                        name: 'password',
+                        message: 'Enter your password:',
+                        validate: (value) => value.length /* <- TODO: [🧠] Better password validation */ > 0
+                            ? true
+                            : 'Password is required',
+                    },
+                ]);
+                const loginUrl = `${remoteServerUrl}/login`;
+                const response = await fetch(loginUrl, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({
+                        appId: CLI_APP_ID,
+                        username,
+                        password,
+                    }),
+                });
+                console.log('!!!', {
+                    loginUrl,
+                    username,
+                    password,
+                    // type: response.type,
+                    // text: await response.text(),
+                });
+                const body = (await response.json());
+                if ('error' in body) {
+                    console.log(colors.red(body.error.message));
+                    process.exit(1);
+                }
+                return body.identification;
+            },
+        });
+    }
+    else {
+        throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
+    }
 }
 
 /**
@@ -2618,8 +3155,10 @@ function $initializeListModelsCommand(program) {
         `));
     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());
@@ -3179,49 +3718,73 @@ function $initializeListScrapersCommand(program) {
  */
 
 /**
- * Converts PipelineCollection to serialized JSON
+ * Initializes `login` command for Promptbook CLI utilities
  *
- * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
  *
- * @public exported from `@promptbook/core`
- */
-async function collectionToJson(collection) {
-    const pipelineUrls = await collection.listPipelines();
-    const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
-    return promptbooks;
-}
-/**
- * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+ * @private internal function of `promptbookCli`
  */
+function $initializeLoginCommand(program) {
+    const loginCommand = program.command('login');
+    loginCommand.description(spaceTrim(`
+            Login to the remote Promptbook server
+        `));
+    loginCommand.action(handleActionErrors(async () => {
+        // @@@
+        console.error(colors.green(spaceTrim(`
+                        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([
+            {
+                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 forTime(1000);
+        console.error(colors.green(spaceTrim(`
+                        Your account ${email} was successfully created.
 
-/**
- * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
- *
- * @public exported from `@promptbook/core`
- */
-class ParseError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ParseError';
-        Object.setPrototypeOf(this, ParseError.prototype);
-    }
+                        Please verify your email:
+                        https://brj.app/api/v1/customer/register-account?apiKey=PRODdh003eNKaec7PoO1AzU244tsL4WO
+
+                        After verification, you will receive 500 000 credits for free 🎉
+                    `)));
+        return process.exit(0);
+    }));
 }
 /**
- * TODO: Maybe split `ParseError` and `ApplyError`
+ * TODO: Pass remote server URL (and path)
+ * TODO: Implement non-interactive login
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
  */
 
 /**
- * This error indicates that the promptbook object has valid syntax (=can be parsed) but contains logical errors (like circular dependencies)
+ * Converts PipelineCollection to serialized JSON
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
  *
  * @public exported from `@promptbook/core`
  */
-class PipelineLogicError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'PipelineLogicError';
-        Object.setPrototypeOf(this, PipelineLogicError.prototype);
-    }
+async function collectionToJson(collection) {
+    const pipelineUrls = await collection.listPipelines();
+    const promptbooks = await Promise.all(pipelineUrls.map((url) => collection.getPipelineByUrl(url)));
+    return promptbooks;
 }
+/**
+ * TODO: [🧠] Maybe clear `sourceFile` or clear when exposing through API or remote server
+ */
 
 /**
  * Tests if given string is valid semantic version
@@ -3619,21 +4182,6 @@ async function loadArchive(filePath, fs) {
 
 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
  *
@@ -3867,32 +4415,6 @@ function taskParameterJsonToString(taskParameterJson) {
  * 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
  *
@@ -4063,24 +4585,6 @@ function createCollectionFromJson(...promptbooks) {
     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$1((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
  *
@@ -4113,210 +4617,40 @@ function isPipelinePrepared(pipeline) {
  * TODO: [🐠] Maybe base this on `makeValidator`
  * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
  * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
- *     - [🏍] ? Is context in each task
- *     - [♨] Are examples prepared
- *     - [♨] Are tasks prepared
- */
-
-/**
- * Recursively converts JSON strings to JSON objects
-
- * @public exported from `@promptbook/utils`
- */
-function jsonStringsToJsons(object) {
-    if (object === null) {
-        return object;
-    }
-    if (Array.isArray(object)) {
-        return object.map(jsonStringsToJsons);
-    }
-    if (typeof object !== 'object') {
-        return object;
-    }
-    const newObject = { ...object };
-    for (const [key, value] of Object.entries(object)) {
-        if (typeof value === 'string' && isValidJsonString(value)) {
-            newObject[key] = JSON.parse(value);
-        }
-        else {
-            newObject[key] = jsonStringsToJsons(value);
-        }
-    }
-    return newObject;
-}
-/**
- * TODO: Type the return type correctly
- */
-
-/**
- * This error indicates problems parsing the format value
- *
- * For example, when the format value is not a valid JSON or CSV
- * This is not thrown directly but in extended classes
- *
- * @public exported from `@promptbook/core`
- */
-class AbstractFormatError extends Error {
-    // Note: To allow instanceof do not put here error `name`
-    // public readonly name = 'AbstractFormatError';
-    constructor(message) {
-        super(message);
-        Object.setPrototypeOf(this, AbstractFormatError.prototype);
-    }
-}
-
-/**
- * This error indicates problem with parsing of CSV
- *
- * @public exported from `@promptbook/core`
- */
-class CsvFormatError extends AbstractFormatError {
-    constructor(message) {
-        super(message);
-        this.name = 'CsvFormatError';
-        Object.setPrototypeOf(this, CsvFormatError.prototype);
-    }
-}
-
-/**
- * This error indicates that the pipeline collection cannot be propperly loaded
- *
- * @public exported from `@promptbook/core`
- */
-class CollectionError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'CollectionError';
-        Object.setPrototypeOf(this, CollectionError.prototype);
-    }
-}
-
-/**
- * This error occurs when some expectation is not met in the execution of the pipeline
- *
- * @public exported from `@promptbook/core`
- * Note: Do not throw this error, its reserved for `checkExpectations` and `createPipelineExecutor` and public ONLY to be serializable through remote server
- * Note: Always thrown in `checkExpectations` and catched in `createPipelineExecutor` and rethrown as `PipelineExecutionError`
- * Note: This is a kindof subtype of PipelineExecutionError
- */
-class ExpectError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ExpectError';
-        Object.setPrototypeOf(this, ExpectError.prototype);
-    }
-}
-
-/**
- * This error indicates that the promptbook can not retrieve knowledge from external sources
- *
- * @public exported from `@promptbook/core`
- */
-class KnowledgeScrapeError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'KnowledgeScrapeError';
-        Object.setPrototypeOf(this, KnowledgeScrapeError.prototype);
-    }
-}
-
-/**
- * This error type indicates that some limit was reached
- *
- * @public exported from `@promptbook/core`
- */
-class LimitReachedError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'LimitReachedError';
-        Object.setPrototypeOf(this, LimitReachedError.prototype);
-    }
-}
-
-/**
- * Index of all custom errors
- *
- * @public exported from `@promptbook/core`
- */
-const PROMPTBOOK_ERRORS = {
-    AbstractFormatError,
-    CsvFormatError,
-    CollectionError,
-    EnvironmentMismatchError,
-    ExpectError,
-    KnowledgeScrapeError,
-    LimitReachedError,
-    MissingToolsError,
-    NotFoundError,
-    NotYetImplementedError,
-    ParseError,
-    PipelineExecutionError,
-    PipelineLogicError,
-    PipelineUrlError,
-    UnexpectedError,
-    // TODO: [🪑]> VersionMismatchError,
-};
-/**
- * Index of all javascript errors
- *
- * @private for internal usage
- */
-const COMMON_JAVASCRIPT_ERRORS = {
-    Error,
-    EvalError,
-    RangeError,
-    ReferenceError,
-    SyntaxError,
-    TypeError,
-    URIError,
-    AggregateError,
-    /*
-  Note: Not widely supported
-  > InternalError,
-  > ModuleError,
-  > HeapError,
-  > WebAssemblyCompileError,
-  > WebAssemblyRuntimeError,
-  */
-};
-/**
- * Index of all errors
- *
- * @private for internal usage
- */
-const ALL_ERRORS = {
-    ...PROMPTBOOK_ERRORS,
-    ...COMMON_JAVASCRIPT_ERRORS,
-};
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
-/**
- * Deserializes the error object
- *
- * @public exported from `@promptbook/utils`
- */
-function deserializeError(error) {
-    const { name, stack, id } = error; // Added id
-    let { message } = error;
-    let ErrorClass = ALL_ERRORS[error.name];
-    if (ErrorClass === undefined) {
-        ErrorClass = Error;
-        message = `${name}: ${message}`;
-    }
-    if (stack !== undefined && stack !== '') {
-        message = spaceTrim((block) => `
-                ${block(message)}
+ *     - [🏍] ? Is context in each task
+ *     - [♨] Are examples prepared
+ *     - [♨] Are tasks prepared
+ */
 
-                Original stack trace:
-                ${block(stack || '')}
-            `);
+/**
+ * Recursively converts JSON strings to JSON objects
+
+ * @public exported from `@promptbook/utils`
+ */
+function jsonStringsToJsons(object) {
+    if (object === null) {
+        return object;
     }
-    const deserializedError = new ErrorClass(message);
-    deserializedError.id = id; // Assign id to the error object
-    return deserializedError;
+    if (Array.isArray(object)) {
+        return object.map(jsonStringsToJsons);
+    }
+    if (typeof object !== 'object') {
+        return object;
+    }
+    const newObject = { ...object };
+    for (const [key, value] of Object.entries(object)) {
+        if (typeof value === 'string' && isValidJsonString(value)) {
+            newObject[key] = JSON.parse(value);
+        }
+        else {
+            newObject[key] = jsonStringsToJsons(value);
+        }
+    }
+    return newObject;
 }
+/**
+ * TODO: Type the return type correctly
+ */
 
 /**
  * Asserts that the execution of a Promptbook is successful
@@ -4469,6 +4803,10 @@ function serializeError(error) {
 
                     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)}
 
                 `));
@@ -11379,7 +11717,6 @@ function $initializeMakeCommand(program) {
     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(`
             Where to save the builded collection
 
@@ -11393,7 +11730,8 @@ function $initializeMakeCommand(program) {
             Note: This can be used only with "javascript" or "typescript" format
 
         `), DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME);
-    makeCommand.action(handleActionErrors(async (path, { projectName, rootUrl, format, functionName, validation, reload: isCacheReloaded, verbose: isVerbose, output, }) => {
+    makeCommand.action(handleActionErrors(async (path, cliOptions) => {
+        const { projectName, rootUrl, format, functionName, validation, reload: isCacheReloaded, verbose: isVerbose, output, } = cliOptions;
         if (!isValidJavascriptName(functionName)) {
             console.error(colors.red(`Function name "${functionName}" is not valid javascript name`));
             return process.exit(1);
@@ -11421,7 +11759,10 @@ function $initializeMakeCommand(program) {
             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,
@@ -11689,8 +12030,8 @@ function $initializePrettifyCommand(program) {
     // <- 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(filesGlob, { ignore });
         //                       <- TODO: [😶]
         for (const filename of filenames) {
@@ -12291,13 +12632,12 @@ function $initializeRunCommand(program) {
     // 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.red(`""${pipelineSource}" is not a valid command or book. See 'ptbk --help'.`));
             return process.exit(1);
@@ -12322,7 +12662,7 @@ function $initializeRunCommand(program) {
         const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
         let llm;
         try {
-            llm = await $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
+            llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
         }
         catch (error) {
             if (!(error instanceof Error)) {
@@ -12379,7 +12719,7 @@ function $initializeRunCommand(program) {
             fs,
             fetch: scraperFetch,
             scrapers: await $provideScrapersForNode({ fs, llm, executables }, prepareAndScrapeOptions),
-            script: [new JavascriptExecutionTools(options)],
+            script: [new JavascriptExecutionTools(cliOptions)],
         };
         if (isVerbose) {
             console.info(colors.gray('--- Getting the book ---'));
@@ -12543,11 +12883,12 @@ function $initializeRunCommand(program) {
  * @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
@@ -12614,9 +12955,38 @@ function startRemoteServer(options) {
         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(swaggerOptions);
+    app.use([`/api-docs`, `${rootPath}/api-docs`], swaggerUi.serve, swaggerUi.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')) {
@@ -12653,9 +13023,12 @@ function startRemoteServer(options) {
 
                     ## 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'))}
 
@@ -12673,8 +13046,81 @@ function startRemoteServer(options) {
                     https://github.com/webgptorg/promptbook
                 `));
     });
-    // TODO: !!!!!! Add login route
-    app.get(`${rootPath}/books`, async (request, response) => {
+    /**
+     * @swagger
+     *
+     * /login:
+     *  post:
+     *   summary: Login to the server
+     *   description: Login to the server and get identification.
+     *   requestBody:
+     *    required: true
+     *    content:
+     *     application/json:
+     *      schema:
+     *       type: object
+     *       properties:
+     *        username:
+     *         type: string
+     *        password:
+     *         type: string
+     *        appId:
+     *         type: string
+     *   responses:
+     *    200:
+     *     description: Successful login
+     *     content:
+     *      application/json:
+     *       schema:
+     *        type: object
+     *        properties:
+     *         identification:
+     *          type: object
+     */
+    app.post([`/login`, `${rootPath}/login`], async (request, response) => {
+        if (!isApplicationModeAllowed || login === null) {
+            response.status(400).send('Application mode is not allowed');
+            return;
+        }
+        try {
+            const username = request.body.username;
+            const password = request.body.password;
+            const appId = request.body.appId;
+            const identification = await login({ username, password, appId });
+            response.status(201).send({ identification });
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (error instanceof AuthenticationError) {
+                response.status(401).send({ error: serializeError(error) });
+            }
+            console.warn(`Login function thrown different error than AuthenticationError`, {
+                error,
+                serializedError: serializeError(error),
+            });
+            response.status(400).send({ error: serializeError(error) });
+        }
+    });
+    /**
+     * @swagger
+     * /books:
+     *   get:
+     *     summary: List all books
+     *     description: Returns a list of all available books in the collection.
+     *     responses:
+     *       200:
+     *         description: A list of books.
+     *         content:
+     *           application/json:
+     *             schema:
+     *               type: array
+     *               items:
+     *                 type: string
+     */
+    app.get([`/books`, `${rootPath}/books`], async (request, response) => {
         if (collection === null) {
             response.status(500).send('No collection available');
             return;
@@ -12684,7 +13130,30 @@ function startRemoteServer(options) {
         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');
@@ -12738,10 +13207,26 @@ function startRemoteServer(options) {
             };
         }
     }
-    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');
@@ -12750,7 +13235,7 @@ function startRemoteServer(options) {
         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);
@@ -12762,7 +13247,36 @@ function startRemoteServer(options) {
         }
         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;
@@ -12998,12 +13512,12 @@ function $initializeStartServerCommand(program) {
         `));
     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(`
             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.red(`Invalid URL: ${rawUrl}`));
             return process.exit(1);
@@ -13032,7 +13546,7 @@ function $initializeStartServerCommand(program) {
             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,
@@ -13056,6 +13570,9 @@ function $initializeStartServerCommand(program) {
             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 });
@@ -13092,8 +13609,8 @@ function $initializeTestCommand(program) {
     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 [◽]
@@ -13102,7 +13619,7 @@ function $initializeTestCommand(program) {
                 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,
@@ -13163,56 +13680,16 @@ function $initializeTestCommand(program) {
  */
 
 /**
- * Initializes `login` command for Promptbook CLI utilities
- *
- * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
  *
- * @private internal function of `promptbookCli`
+ * @private utility of CLI
  */
-function $initializeLoginCommand(program) {
-    const loginCommand = program.command('login');
-    loginCommand.description(spaceTrim(`
-            Login to the remote Promptbook server
-        `));
-    loginCommand.action(handleActionErrors(async () => {
-        // @@@
-        console.error(colors.green(spaceTrim(`
-                        You will be logged in to https://promptbook.studio server.
-                        If you don't have an account, it will be created automatically.
-                    `)));
-        const { email, password } = await prompts([
-            {
-                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 forTime(1000);
-        console.error(colors.green(spaceTrim(`
-                        Your account ${email} was successfully created.
-
-                        Please verify your email:
-                        https://brj.app/api/v1/customer/register-account?apiKey=PRODdh003eNKaec7PoO1AzU244tsL4WO
-
-                        After verification, you will receive 500 000 credits for free 🎉
-                    `)));
-        return process.exit(0);
-    }));
+function $addGlobalOptionsToCommand(command) {
+    command.option('-v, --verbose', `Log more details`, false);
+    command.option('--no-interactive', `Input is not interactive, if true, no CLI input is prompted if required, so either defaults are used or the command fails with exit code 1`);
+    command.option('-p, --provider <provider>', `Which LLM provider to use: "BYOK" / "BRING_YOUR_OWN_KEYS" or "REMOTE_SERVER" / "RS"`, 'REMOTE_SERVER');
+    command.option('--remote-server-url <url>', `URL of remote server to use when `, DEFAULT_REMOTE_SERVER_URL);
 }
-/**
- * TODO: Pass remote server URL (and path)
- * TODO: Implement non-interactive login
- * Note: [💞] Ignore a discrepancy between file name and entity name
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */
 
 /**
  * Runs CLI utilities of Promptbook package
@@ -13238,6 +13715,7 @@ async function promptbookCli() {
     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);
@@ -13248,6 +13726,8 @@ async function promptbookCli() {
     $initializeListModelsCommand(program);
     $initializeListScrapersCommand(program);
     $initializeStartServerCommand(program);
+    // TODO: [🧠] Should it be here or not> $addGlobalOptionsToCommand(program);
+    program.commands.forEach($addGlobalOptionsToCommand);
     program.parse(process.argv);
 }
 /**
@@ -13297,8 +13777,7 @@ const _AnthropicClaudeMetadataRegistration = $llmToolsMetadataRegister.register(
             options: {
                 apiKey: 'sk-ant-api03-',
                 isProxied: true,
-                remoteUrl: DEFAULT_REMOTE_URL,
-                path: DEFAULT_REMOTE_URL_PATH,
+                remoteServerUrl: DEFAULT_REMOTE_SERVER_URL,
             },
         };
     },
@@ -13321,146 +13800,6 @@ const _AnthropicClaudeMetadataRegistration = $llmToolsMetadataRegister.register(
  * 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 = 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
  *