@promptbook/cli 0.89.0-9 → 0.89.0

package/esm/index.es.js

@@ -3,14 +3,14 @@ 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 { join, basename, dirname, relative } from 'path';
 import { stat, access, constants, readFile, writeFile, readdir, mkdir, unlink, rm, rename, rmdir } from 'fs/promises';
+import * as dotenv from 'dotenv';
 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';
 import JSZip from 'jszip';
 import { format } from 'prettier';
@@ -23,7 +23,7 @@ import moment from 'moment';
 import express from 'express';
 import http from 'http';
 import { Server } from 'socket.io';
-import swaggerJsdoc from 'swagger-jsdoc';
+import * as OpenApiValidator from 'express-openapi-validator';
 import swaggerUi from 'swagger-ui-express';
 import Anthropic from '@anthropic-ai/sdk';
 import { OpenAIClient, AzureKeyCredential } from '@azure/openai';
@@ -46,12 +46,43 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.89.0-9';
+const PROMPTBOOK_ENGINE_VERSION = '0.89.0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Available remote servers for the Promptbook
+ *
+ * @public exported from `@promptbook/core`
+ */
+const REMOTE_SERVER_URLS = [
+    {
+        title: 'Promptbook',
+        description: `Servers of Promptbook.studio`,
+        owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+        isAnonymousModeAllowed: true,
+        urls: [
+            'https://promptbook.s5.ptbk.io/',
+            // Note: Servers 1-4 are not running
+        ],
+    },
+    /*
+    Note: Working on older version of Promptbook and not supported anymore
+    {
+        title: 'Pavol Promptbook Server',
+        description: `Personal server of Pavol Hejný with simple testing server, DO NOT USE IT FOR PRODUCTION`,
+        owner: 'Pavol Hejný <pavol@ptbk.io> (https://www.pavolhejny.com/)',
+        isAnonymousModeAllowed: true,
+        urls: ['https://api.pavolhejny.com/promptbook'],
+    },
+    */
+];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Returns the same value that is passed as argument.
  * No side effects.
@@ -106,6 +137,7 @@ const ADMIN_GITHUB_NAME = 'hejny';
  * @public exported from `@promptbook/core`
  */
 const CLAIM = `It's time for a paradigm shift. The future of software in plain English, French or Latin`;
+//            <- TODO: [🐊] Pick the best claim
 /**
  * When the title is not provided, the default title is used
  *
@@ -136,6 +168,12 @@ const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
  * @private within the repository
  */
 const GENERATOR_WARNING_BY_PROMPTBOOK_CLI = `⚠️ WARNING: This code has been generated by \`@promptbook/cli\` so that any manual changes will be overwritten`;
+/**
+ * Warning message for the automatically generated sections of `.env` files
+ *
+ * @private within the repository
+ */
+const GENERATOR_WARNING_IN_ENV = `Note: Added by Promptbook`;
 // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
 /**
  * The maximum number of iterations for a loops
@@ -156,6 +194,7 @@ const VALUE_STRINGS = {
     infinity: '(infinity; ∞)',
     negativeInfinity: '(negative infinity; -∞)',
     unserializable: '(unserializable value)',
+    circular: '(circular JSON)',
 };
 /**
  * Small number limit
@@ -215,7 +254,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
+// TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
 /**
  * Where to store the temporary downloads
  *
@@ -271,11 +310,11 @@ const MOMENT_ARG_THRESHOLDS = {
     ss: 3, // <- least number of seconds to be counted in seconds, minus 1. Must be set after setting the `s` unit or without setting the `s` unit.
 };
 /**
- * @@@
+ * Default remote server URL for the Promptbook
  *
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_REMOTE_SERVER_URL = 'https://api.pavolhejny.com/promptbook';
+const DEFAULT_REMOTE_SERVER_URL = REMOTE_SERVER_URLS[0].urls[0];
 // <- TODO: [🧜‍♂️]
 /**
  * @@@
@@ -409,6 +448,122 @@ const $isRunningInWebWorker = new Function(`
  * TODO: [🎺]
  */
 
+/**
+ * Make error report URL for the given error
+ *
+ * @private private within the repository
+ */
+function getErrorReportUrl(error) {
+    const report = {
+        title: `🐜 Error report from ${NAME}`,
+        body: spaceTrim((block) => `
+
+
+            \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
+
+            \`\`\`
+            ${block(error.message || '(no error message)')}
+            \`\`\`
+
+
+            ## More info:
+
+            - **Promptbook engine version:** ${PROMPTBOOK_ENGINE_VERSION}
+            - **Book language version:** ${BOOK_LANGUAGE_VERSION}
+            - **Time:** ${new Date().toISOString()}
+
+            <details>
+            <summary>Stack trace:</summary>
+
+            ## Stack trace:
+
+            \`\`\`stacktrace
+            ${block(error.stack || '(empty)')}
+            \`\`\`
+            </details>
+
+        `),
+    };
+    const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);
+    reportUrl.searchParams.set('labels', 'bug');
+    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
+    reportUrl.searchParams.set('title', report.title);
+    reportUrl.searchParams.set('body', report.body);
+    return reportUrl;
+}
+
+/**
+ * This error type indicates that the error should not happen and its last check before crashing with some other error
+ *
+ * @public exported from `@promptbook/core`
+ */
+class UnexpectedError extends Error {
+    constructor(message) {
+        super(spaceTrim$1((block) => `
+                    ${block(message)}
+
+                    Note: This error should not happen.
+                    It's probbably a bug in the pipeline collection
+
+                    Please report issue:
+                    ${block(getErrorReportUrl(new Error(message)).href)}
+
+                    Or contact us on ${ADMIN_EMAIL}
+
+                `));
+        this.name = 'UnexpectedError';
+        Object.setPrototypeOf(this, UnexpectedError.prototype);
+    }
+}
+
+/**
+ * This error type indicates that somewhere in the code non-Error object was thrown and it was wrapped into the `WrappedError`
+ *
+ * @public exported from `@promptbook/core`
+ */
+class WrappedError extends Error {
+    constructor(whatWasThrown) {
+        const tag = `[🤮]`;
+        console.error(tag, whatWasThrown);
+        super(spaceTrim$1(`
+                Non-Error object was thrown
+
+                Note: Look for ${tag} in the console for more details
+                Please report issue on ${ADMIN_EMAIL}
+            `));
+        this.name = 'WrappedError';
+        Object.setPrototypeOf(this, WrappedError.prototype);
+    }
+}
+
+/**
+ * Helper used in catch blocks to assert that the error is an instance of `Error`
+ *
+ * @param whatWasThrown Any object that was thrown
+ * @returns Nothing if the error is an instance of `Error`
+ * @throws `WrappedError` or `UnexpectedError` if the error is not standard
+ *
+ * @private within the repository
+ */
+function assertsError(whatWasThrown) {
+    // Case 1: Handle error which was rethrown as `WrappedError`
+    if (whatWasThrown instanceof WrappedError) {
+        const wrappedError = whatWasThrown;
+        throw wrappedError;
+    }
+    // Case 2: Handle unexpected errors
+    if (whatWasThrown instanceof UnexpectedError) {
+        const unexpectedError = whatWasThrown;
+        throw unexpectedError;
+    }
+    // Case 3: Handle standard errors - keep them up to consumer
+    if (whatWasThrown instanceof Error) {
+        return;
+    }
+    // Case 4: Handle non-standard errors - wrap them into `WrappedError` and throw
+    throw new WrappedError(whatWasThrown);
+}
+
 /**
  * Wraps action to handle error console logging and exit process with error code
  *
@@ -423,9 +578,7 @@ function handleActionErrors(action) {
             return process.exit(0);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             // console.error(colors.bgRed(error.name));
             console.error(colors.red(/* error.stack || */ error.message));
             return process.exit(1);
@@ -532,74 +685,6 @@ class NotYetImplementedError extends Error {
     }
 }
 
-/**
- * Make error report URL for the given error
- *
- * @private private within the repository
- */
-function getErrorReportUrl(error) {
-    const report = {
-        title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim((block) => `
-
-
-            \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
-
-            \`\`\`
-            ${block(error.message || '(no error message)')}
-            \`\`\`
-
-
-            ## More info:
-
-            - **Promptbook engine version:** ${PROMPTBOOK_ENGINE_VERSION}
-            - **Book language version:** ${BOOK_LANGUAGE_VERSION}
-            - **Time:** ${new Date().toISOString()}
-
-            <details>
-            <summary>Stack trace:</summary>
-
-            ## Stack trace:
-
-            \`\`\`stacktrace
-            ${block(error.stack || '(empty)')}
-            \`\`\`
-            </details>
-
-        `),
-    };
-    const reportUrl = new URL(`https://github.com/webgptorg/promptbook/issues/new`);
-    reportUrl.searchParams.set('labels', 'bug');
-    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
-    reportUrl.searchParams.set('title', report.title);
-    reportUrl.searchParams.set('body', report.body);
-    return reportUrl;
-}
-
-/**
- * This error type indicates that the error should not happen and its last check before crashing with some other error
- *
- * @public exported from `@promptbook/core`
- */
-class UnexpectedError extends Error {
-    constructor(message) {
-        super(spaceTrim$1((block) => `
-                    ${block(message)}
-
-                    Note: This error should not happen.
-                    It's probbably a bug in the pipeline collection
-
-                    Please report issue:
-                    ${block(getErrorReportUrl(new Error(message)).href)}
-
-                    Or contact us on ${ADMIN_EMAIL}
-
-                `));
-        this.name = 'UnexpectedError';
-        Object.setPrototypeOf(this, UnexpectedError.prototype);
-    }
-}
-
 /**
  * @@@
  *
@@ -919,6 +1004,40 @@ function $sideEffect(...sideEffectSubjects) {
     keepUnused(...sideEffectSubjects);
 }
 
+/**
+ * Convert identification to Promptbook token
+ *
+ * @param identification
+ *
+ * @public exported from `@promptbook/core`
+ */
+function identificationToPromptbookToken(identification) {
+    const { appId, userId, userToken } = identification;
+    const promptbookToken = `${appId}-${userId}-${userToken}`;
+    return promptbookToken;
+}
+
+/**
+ * Convert Promptbook token to identification
+ *
+ * @param promptbookToken
+ *
+ * @public exported from `@promptbook/core`
+ */
+function promptbookTokenToIdentification(promptbookToken) {
+    const [appId, userId, userToken] = promptbookToken.split('-');
+    if (!appId || !userId || !userToken) {
+        throw new Error(`Invalid promptbook token: ${promptbookToken}`);
+    }
+    const identification = {
+        appId,
+        userId,
+        userToken,
+        isAnonymous: false,
+    };
+    return identification;
+}
+
 /**
  * Just marks a place of place where should be something implemented
  * No side effects.
@@ -932,27 +1051,199 @@ function $sideEffect(...sideEffectSubjects) {
 function TODO_USE(...value) {
 }
 
-/**
- * @@@
- *
- * @public exported from `@promptbook/node`
- */
-function $provideFilesystemForNode(options) {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/node`
+ */
+function $provideFilesystemForNode(options) {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$provideFilesystemForNode` works only in Node.js environment');
+    }
+    return {
+        stat,
+        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
+ */
+
+/**
+ * Checks if the file exists
+ *
+ * @private within the repository
+ */
+async function isFileExisting(filename, fs) {
+    const isReadAccessAllowed = await fs
+        .access(filename, fs.constants.R_OK)
+        .then(() => true)
+        .catch(() => false);
+    if (!isReadAccessAllowed) {
+        return false;
+    }
+    const isFile = await fs
+        .stat(filename)
+        .then((fileStat) => fileStat.isFile())
+        .catch(() => false);
+    return isFile;
+}
+/**
+ * Note: Not [~🟢~] because it is not directly dependent on `fs
+ * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
+ * TODO: [🖇] What about symlinks?
+ */
+
+/**
+ * Determines if the given path is a root path.
+ *
+ * Note: This does not check if the file exists only if the path is valid
+ * @public exported from `@promptbook/utils`
+ */
+function isRootPath(value) {
+    if (value === '/') {
+        return true;
+    }
+    if (/^[A-Z]:\\$/i.test(value)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * TODO: [🍏] Make for MacOS paths
+ */
+
+/**
+ * Provides the path to the `.env` file
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
+ *
+ * @private within the repository - for CLI utils
+ */
+async function $provideEnvFilename() {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$provideEnvFilename` works only in Node.js environment');
+    }
+    const envFilePatterns = [
+        '.env',
+        '.env.test',
+        '.env.local',
+        '.env.development.local',
+        '.env.development',
+        '.env.production.local',
+        '.env.production',
+        '.env.prod.local',
+        '.env.prod',
+        // <- TODO: Maybe add more patterns
+    ];
+    let rootDirname = process.cwd();
+    up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
+        for (const pattern of envFilePatterns) {
+            const envFilename = join(rootDirname, pattern);
+            if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
+                $setUsedEnvFilename(envFilename);
+                return envFilename;
+            }
+        }
+        if (isRootPath(rootDirname)) {
+            break up_to_root;
+        }
+        // Note: If the directory does not exist, try the parent directory
+        rootDirname = join(rootDirname, '..');
+    }
+    return null;
+}
+/**
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
+
+/**
+ * Stores data in .env variables
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes to `process.env`
+ *
+ * @private within the repository - for CLI utils
+ */
+class $EnvStorage {
+    constructor() {
+        this.envFilename = null;
+    }
+    async $provideOrCreateEnvFile() {
+        if (this.envFilename !== null) {
+            return this.envFilename;
+        }
+        let envFilename = await $provideEnvFilename();
+        if (envFilename !== null) {
+            this.envFilename = envFilename;
+            return envFilename;
+        }
+        envFilename = join(process.cwd(), '.env');
+        await writeFile(envFilename, '# This file was initialized by Promptbook', 'utf-8');
+        this.envFilename = envFilename;
+        return envFilename;
+    }
+    transformKey(key) {
+        return normalizeTo_SCREAMING_CASE(key);
+    }
+    /**
+     * Returns the number of key/value pairs currently present in the list associated with the object.
+     */
+    get length() {
+        throw new NotYetImplementedError('Method `$EnvStorage.length` not implemented.');
+    }
+    /**
+     * Empties the list associated with the object of all key/value pairs, if there are any.
+     */
+    clear() {
+        throw new NotYetImplementedError('Method `$EnvStorage.clear` not implemented.');
+    }
+    /**
+     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    async getItem(key) {
+        dotenv.config({ path: await this.$provideOrCreateEnvFile() });
+        return process.env[this.transformKey(key)] || null;
+    }
+    /**
+     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+     */
+    key(index) {
+        throw new NotYetImplementedError('Method `$EnvStorage.key` not implemented.');
+    }
+    /**
+     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    async setItem(key, value) {
+        const envFilename = await this.$provideOrCreateEnvFile();
+        const envContent = await readFile(envFilename, 'utf-8');
+        const transformedKey = this.transformKey(key);
+        const updatedEnvContent = envContent
+            .split('\n')
+            .filter((line) => !line.startsWith(`# ${GENERATOR_WARNING_IN_ENV}`)) // Remove GENERATOR_WARNING_IN_ENV
+            .filter((line) => !line.startsWith(`${transformedKey}=`)) // Remove existing key if present
+            .join('\n');
+        const newEnvContent = spaceTrim((block) => `
+                ${block(updatedEnvContent)}
+
+                # ${GENERATOR_WARNING_IN_ENV}
+                ${transformedKey}=${JSON.stringify(value)}
+            `);
+        await writeFile(envFilename, newEnvContent, 'utf-8');
+    }
+    /**
+     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    removeItem(key) {
+        throw new NotYetImplementedError('Method `$EnvStorage.removeItem` not implemented.');
     }
-    return {
-        stat,
-        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
+ * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
  */
 
 /**
@@ -1088,9 +1379,7 @@ function checkSerializableAsJson(options) {
                 JSON.stringify(value); // <- TODO: [0]
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 throw new UnexpectedError(spaceTrim((block) => `
                             \`${name}\` is not serializable
 
@@ -1323,31 +1612,6 @@ function stringifyPipelineJson(pipeline) {
  * TODO: [🍙] Make some standard order of json properties
  */
 
-/**
- * Checks if the file exists
- *
- * @private within the repository
- */
-async function isFileExisting(filename, fs) {
-    const isReadAccessAllowed = await fs
-        .access(filename, fs.constants.R_OK)
-        .then(() => true)
-        .catch(() => false);
-    if (!isReadAccessAllowed) {
-        return false;
-    }
-    const isFile = await fs
-        .stat(filename)
-        .then((fileStat) => fileStat.isFile())
-        .catch(() => false);
-    return isFile;
-}
-/**
- * Note: Not [~🟢~] because it is not directly dependent on `fs
- * TODO: [🐠] This can be a validator - with variants that return true/false and variants that throw errors with meaningless messages
- * TODO: [🖇] What about symlinks?
- */
-
 /**
  * Removes emojis from a string and fix whitespaces
  *
@@ -1853,53 +2117,6 @@ class FileCacheStorage {
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */
 
-/**
- * Stores data in memory (HEAP)
- *
- * @public exported from `@promptbook/core`
- */
-class MemoryStorage {
-    constructor() {
-        this.storage = {};
-    }
-    /**
-     * Returns the number of key/value pairs currently present in the list associated with the object.
-     */
-    get length() {
-        return Object.keys(this.storage).length;
-    }
-    /**
-     * Empties the list associated with the object of all key/value pairs, if there are any.
-     */
-    clear() {
-        this.storage = {};
-    }
-    /**
-     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
-     */
-    getItem(key) {
-        return this.storage[key] || null;
-    }
-    /**
-     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
-     */
-    key(index) {
-        return Object.keys(this.storage)[index] || null;
-    }
-    /**
-     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
-     */
-    setItem(key, value) {
-        this.storage[key] = value;
-    }
-    /**
-     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
-     */
-    removeItem(key) {
-        delete this.storage[key];
-    }
-}
-
 /**
  * This error indicates problems parsing the format value
  *
@@ -2076,7 +2293,7 @@ class PipelineExecutionError extends Error {
     }
 }
 /**
- * TODO: !!!!!! Add id to all errors
+ * TODO: [🧠][🌂] Add id to all errors
  */
 
 /**
@@ -2138,7 +2355,10 @@ const PROMPTBOOK_ERRORS = {
     PipelineExecutionError,
     PipelineLogicError,
     PipelineUrlError,
+    AuthenticationError,
+    PromptbookFetchError,
     UnexpectedError,
+    WrappedError,
     // TODO: [🪑]> VersionMismatchError,
 };
 /**
@@ -2155,8 +2375,6 @@ const COMMON_JAVASCRIPT_ERRORS = {
     TypeError,
     URIError,
     AggregateError,
-    AuthenticationError,
-    PromptbookFetchError,
     /*
   Note: Not widely supported
   > InternalError,
@@ -2214,17 +2432,31 @@ function deserializeError(error) {
  */
 async function createRemoteClient(options) {
     const { remoteServerUrl } = options;
-    let path = new URL(remoteServerUrl).pathname;
-    if (path.endsWith('/')) {
-        path = path.slice(0, -1);
+    if (!isValidUrl(remoteServerUrl)) {
+        throw new Error(`Invalid \`remoteServerUrl\`: "${remoteServerUrl}"`);
+    }
+    const remoteServerUrlParsed = new URL(remoteServerUrl);
+    if (remoteServerUrlParsed.pathname !== '/' && remoteServerUrlParsed.pathname !== '') {
+        remoteServerUrlParsed.pathname = '/';
+        throw new Error(spaceTrim((block) => `
+                        Remote server requires root url \`/\`
+
+                        You have provided \`remoteServerUrl\`:
+                        ${block(remoteServerUrl)}
+
+                        But something like this is expected:
+                        ${block(remoteServerUrlParsed.href)}
+
+                        Note: If you need to run multiple services on the same server, use 3rd or 4th degree subdomain
+
+                    `));
     }
-    path = `${path}/socket.io`;
     return new Promise((resolve, reject) => {
         const socket = io(remoteServerUrl, {
             retries: CONNECTION_RETRIES_LIMIT,
             timeout: CONNECTION_TIMEOUT_MS,
-            path,
-            transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+            path: '/socket.io',
+            transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
         });
         // console.log('Connecting to', this.options.remoteServerUrl.href, { socket });
         socket.on('connect', () => {
@@ -2349,6 +2581,53 @@ class RemoteLlmExecutionTools {
  * TODO: [🧠] Maybe remove `@promptbook/remote-client` and just use `@promptbook/core`
  */
 
+/**
+ * Stores data in memory (HEAP)
+ *
+ * @public exported from `@promptbook/core`
+ */
+class MemoryStorage {
+    constructor() {
+        this.storage = {};
+    }
+    /**
+     * Returns the number of key/value pairs currently present in the list associated with the object.
+     */
+    get length() {
+        return Object.keys(this.storage).length;
+    }
+    /**
+     * Empties the list associated with the object of all key/value pairs, if there are any.
+     */
+    clear() {
+        this.storage = {};
+    }
+    /**
+     * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+     */
+    getItem(key) {
+        return this.storage[key] || null;
+    }
+    /**
+     * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+     */
+    key(index) {
+        return Object.keys(this.storage)[index] || null;
+    }
+    /**
+     * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+     */
+    setItem(key, value) {
+        this.storage[key] = value;
+    }
+    /**
+     * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+     */
+    removeItem(key) {
+        delete this.storage[key];
+    }
+}
+
 /**
  * Simple wrapper `new Date().toISOString()`
  *
@@ -2608,101 +2887,38 @@ function countUsage(llmTools) {
     }
     if (llmTools.callCompletionModel !== undefined) {
         proxyTools.callCompletionModel = async (prompt) => {
-            // console.info('[🚕] callCompletionModel through countTotalUsage');
-            const promptResult = await llmTools.callCompletionModel(prompt);
-            totalUsage = addUsage(totalUsage, promptResult.usage);
-            spending.next(promptResult.usage);
-            return promptResult;
-        };
-    }
-    if (llmTools.callEmbeddingModel !== undefined) {
-        proxyTools.callEmbeddingModel = async (prompt) => {
-            // console.info('[🚕] callEmbeddingModel through countTotalUsage');
-            const promptResult = await llmTools.callEmbeddingModel(prompt);
-            totalUsage = addUsage(totalUsage, promptResult.usage);
-            spending.next(promptResult.usage);
-            return promptResult;
-        };
-    }
-    // <- Note: [🤖]
-    return proxyTools;
-}
-/**
- * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
- * TODO: [🧠] Is there some meaningfull way how to test this util
- * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
- *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
- */
-
-/**
- * Determines if the given path is a root path.
- *
- * Note: This does not check if the file exists only if the path is valid
- * @public exported from `@promptbook/utils`
- */
-function isRootPath(value) {
-    if (value === '/') {
-        return true;
-    }
-    if (/^[A-Z]:\\$/i.test(value)) {
-        return true;
-    }
-    return false;
-}
-/**
- * TODO: [🍏] Make for MacOS paths
- */
-
-/**
- * Provides the path to the `.env` file
- *
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access .env file
- *
- * @private within the repository - for CLI utils
- */
-async function $provideEnvFilepath() {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideEnvFilepath` works only in Node.js environment');
-    }
-    const envFilePatterns = [
-        '.env',
-        '.env.test',
-        '.env.local',
-        '.env.development.local',
-        '.env.development',
-        '.env.production.local',
-        '.env.production',
-        '.env.prod.local',
-        '.env.prod',
-        // <- TODO: Maybe add more patterns
-    ];
-    let rootDirname = process.cwd();
-    up_to_root: for (let i = 0; i < LOOP_LIMIT; i++) {
-        for (const pattern of envFilePatterns) {
-            const envFilename = join(rootDirname, pattern);
-            if (await isFileExisting(envFilename, $provideFilesystemForNode())) {
-                $setUsedEnvFilename(envFilename);
-                return envFilename;
-            }
-        }
-        if (isRootPath(rootDirname)) {
-            break up_to_root;
-        }
-        // Note: If the directory does not exist, try the parent directory
-        rootDirname = join(rootDirname, '..');
+            // console.info('[🚕] callCompletionModel through countTotalUsage');
+            const promptResult = await llmTools.callCompletionModel(prompt);
+            totalUsage = addUsage(totalUsage, promptResult.usage);
+            spending.next(promptResult.usage);
+            return promptResult;
+        };
     }
-    return null;
+    if (llmTools.callEmbeddingModel !== undefined) {
+        proxyTools.callEmbeddingModel = async (prompt) => {
+            // console.info('[🚕] callEmbeddingModel through countTotalUsage');
+            const promptResult = await llmTools.callEmbeddingModel(prompt);
+            totalUsage = addUsage(totalUsage, promptResult.usage);
+            spending.next(promptResult.usage);
+            return promptResult;
+        };
+    }
+    // <- Note: [🤖]
+    return proxyTools;
 }
 /**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+ *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */
 
 /**
  * @@@
  *
  * @@@ .env
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access .env file
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
@@ -2716,7 +2932,7 @@ async function $provideLlmToolsConfigurationFromEnv() {
     if (!$isRunningInNode()) {
         throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
     }
-    const envFilepath = await $provideEnvFilepath();
+    const envFilepath = await $provideEnvFilename();
     if (envFilepath !== null) {
         dotenv.config({ path: envFilepath });
     }
@@ -2824,14 +3040,15 @@ class MultipleLlmExecutionTools {
                 }
             }
             catch (error) {
-                if (!(error instanceof Error) || error instanceof UnexpectedError) {
+                assertsError(error);
+                if (error instanceof UnexpectedError) {
                     throw error;
                 }
                 errors.push({ llmExecutionTools, error });
             }
         }
         if (errors.length === 1) {
-            throw errors[0];
+            throw errors[0].error;
         }
         else if (errors.length > 1) {
             throw new PipelineExecutionError(
@@ -2978,7 +3195,7 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
  * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
  *
  * @@@ .env
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access .env file
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
@@ -3023,7 +3240,7 @@ async function $provideLlmToolsFromEnv(options = {}) {
 /**
  * Returns LLM tools for CLI
  *
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access .env file and also writes this .env file
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes this .env file
  *
  * @private within the repository - for CLI utils
  */
@@ -3032,18 +3249,27 @@ async function $provideLlmToolsForWizzardOrCli(options) {
         throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizzardOrCli` works only in Node.js environment');
     }
     options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
-    const { strategy, isCacheReloaded } = options;
+    const { isLoginloaded, strategy, isCacheReloaded } = options;
     let llmExecutionTools;
     if (strategy === 'REMOTE_SERVER') {
         const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
-        // TODO: !!!
-        // const envFilepath = await $provideEnvFilepath();
-        const storage = new MemoryStorage(); // <- TODO: !!!!!! Save to `.promptbook` folder
-        const key = `${remoteServerUrl}-identification`;
-        let identification = await storage.getItem(key);
-        if (identification === null) {
+        const storage = new $EnvStorage();
+        let key = `PROMPTBOOK_TOKEN`;
+        if (remoteServerUrl !== DEFAULT_REMOTE_SERVER_URL) {
+            key = `${key}_${remoteServerUrl.replace(/^https?:\/\//i, '')}`;
+        }
+        let identification = null;
+        let promptbookToken = await storage.getItem(key);
+        if (promptbookToken === null || isLoginloaded) {
             identification = await loginPrompt();
-            await storage.setItem(key, identification);
+            // Note: When login prompt fails, `process.exit(1)` is called so no need to check for null
+            if (identification.isAnonymous === false) {
+                promptbookToken = identificationToPromptbookToken(identification);
+                await storage.setItem(key, promptbookToken);
+            }
+        }
+        else {
+            identification = promptbookTokenToIdentification(promptbookToken);
         }
         llmExecutionTools = new RemoteLlmExecutionTools({
             remoteServerUrl,
@@ -3084,9 +3310,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         return await fetch(urlOrRequest, init);
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         let url;
         if (typeof urlOrRequest === 'string') {
             url = urlOrRequest;
@@ -3125,8 +3349,8 @@ function isValidEmail(email) {
 /**
  * @private utility of CLI
  */
-function $provideLlmToolsForCli(options) {
-    const { cliOptions: { 
+async function $provideLlmToolsForCli(options) {
+    const { isLoginloaded, cliOptions: { 
     /* TODO: Use verbose: isVerbose, */ interactive: isInteractive, provider, remoteServerUrl: remoteServerUrlRaw, }, } = options;
     let strategy;
     if (/^b/i.test(provider)) {
@@ -3140,7 +3364,11 @@ function $provideLlmToolsForCli(options) {
         process.exit(1);
     }
     if (strategy === 'BRING_YOUR_OWN_KEYS') {
-        return /* not await */ $provideLlmToolsForWizzardOrCli({ strategy, ...options });
+        if (isLoginloaded) {
+            throw new UnexpectedError(`\`$provideLlmToolsForCli\` isLoginloaded is not supported for strategy "BRING_YOUR_OWN_KEYS"`);
+        }
+        const llm = await $provideLlmToolsForWizzardOrCli({ strategy, ...options });
+        return { strategy, llm };
     }
     else if (strategy === 'REMOTE_SERVER') {
         if (!isValidUrl(remoteServerUrlRaw)) {
@@ -3148,7 +3376,8 @@ function $provideLlmToolsForCli(options) {
             process.exit(1);
         }
         const remoteServerUrl = remoteServerUrlRaw.endsWith('/') ? remoteServerUrlRaw.slice(0, -1) : remoteServerUrlRaw;
-        return /* not await */ $provideLlmToolsForWizzardOrCli({
+        const llm = await $provideLlmToolsForWizzardOrCli({
+            isLoginloaded,
             strategy,
             appId: CLI_APP_ID,
             remoteServerUrl,
@@ -3158,6 +3387,10 @@ function $provideLlmToolsForCli(options) {
                     console.log(colors.red(`You can not login to remote server in non-interactive mode`));
                     process.exit(1);
                 }
+                console.info(colors.cyan(spaceTrim(`
+                          You will be logged in to ${remoteServerUrl}
+                          If you don't have an account, it will be created automatically.
+                      `)));
                 const { username, password } = await prompts([
                     {
                         type: 'text',
@@ -3175,7 +3408,6 @@ function $provideLlmToolsForCli(options) {
                     },
                 ]);
                 const loginUrl = `${remoteServerUrl}/login`;
-                console.log('!!!', { loginUrl });
                 // TODO: [🧠] Should we use normal `fetch` or `scraperFetch`
                 const response = await promptbookFetch(loginUrl, {
                     method: 'POST',
@@ -3188,20 +3420,7 @@ function $provideLlmToolsForCli(options) {
                         password,
                     }),
                 });
-                console.log('!!!', {
-                    loginUrl,
-                    username,
-                    password,
-                    // type: response.type,
-                    // text: await response.text(),
-                });
                 const { isSuccess, message, error, identification } = (await response.json());
-                console.log('!!!', {
-                    isSuccess,
-                    message,
-                    error,
-                    identification,
-                });
                 if (message) {
                     if (isSuccess) {
                         console.log(colors.green(message));
@@ -3222,6 +3441,7 @@ function $provideLlmToolsForCli(options) {
                 return identification;
             },
         });
+        return { strategy, llm };
     }
     else {
         throw new UnexpectedError(`\`$provideLlmToolsForCli\` wrong strategy "${strategy}"`);
@@ -3243,11 +3463,12 @@ function $initializeListModelsCommand(program) {
     listModelsCommand.alias('models');
     listModelsCommand.alias('llm');
     listModelsCommand.action(handleActionErrors(async (cliOptions) => {
-        console.log('!!!', cliOptions);
-        // TODO: !!!!!! Not relevant for remote server and also for `about` command
-        const llm = await $provideLlmToolsForCli({ cliOptions });
+        const { strategy, llm } = await $provideLlmToolsForCli({ cliOptions });
         $sideEffect(llm);
         // <- Note: Providing LLM tools will make a side effect of registering all available LLM tools to show the message
+        if (strategy !== 'BRING_YOUR_OWN_KEYS') {
+            console.warn(colors.yellow(`You are using --strategy ${strategy} but models listed below are relevant for --strategy BRING_YOUR_OWN_KEYS`));
+        }
         console.info($registeredLlmToolsMessage());
         return process.exit(0);
     }));
@@ -3430,9 +3651,7 @@ async function locateAppOnLinux({ linuxWhich, }) {
         return result.trim();
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         return null;
     }
 }
@@ -3487,9 +3706,7 @@ async function locateAppOnMacOs({ macOsName, }) {
         return result.trim() + toExec;
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         return null;
     }
 }
@@ -3520,9 +3737,7 @@ async function locateAppOnWindows({ appName, windowsSuffix, }) {
         throw new Error(`Can not locate app ${appName} on Windows.`);
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         return null;
     }
 }
@@ -3781,6 +3996,7 @@ function $initializeListScrapersCommand(program) {
         `));
     listModelsCommand.alias('scrapers');
     listModelsCommand.action(handleActionErrors(async () => {
+        // TODO: [🌞] Do not allow on REMOTE_SERVER strategy
         const scrapers = await $provideScrapersForNode({});
         const executables = await $provideExecutablesForNode();
         console.info(spaceTrim((block) => `
@@ -3816,42 +4032,20 @@ function $initializeLoginCommand(program) {
     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',
+    loginCommand.action(handleActionErrors(async (cliOptions) => {
+        // Note: Not interested in return value of this function but the side effect of logging in
+        await $provideLlmToolsForCli({
+            isLoginloaded: true,
+            cliOptions: {
+                ...cliOptions,
+                strategy: 'REMOTE_SERVER', // <- Note: Overriding strategy to `REMOTE_SERVER`
+                //                               TODO: Do not allow flag `--strategy` in `login` command at all
             },
-        ]);
-        TODO_USE(email, password);
-        await 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);
     }));
 }
 /**
- * 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`
@@ -4272,6 +4466,9 @@ var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"
 /**
  * Function isValidJsonString will tell you if the string is valid JSON or not
  *
+ * @param value The string to check
+ * @returns True if the string is a valid JSON string, false otherwise
+ *
  * @public exported from `@promptbook/utils`
  */
 function isValidJsonString(value /* <- [👨‍⚖️] */) {
@@ -4280,9 +4477,7 @@ function isValidJsonString(value /* <- [👨‍⚖️] */) {
         return true;
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         if (error.message.includes('Unexpected token')) {
             return false;
         }
@@ -4813,8 +5008,8 @@ function createTask(options) {
                 updatedAt = new Date();
                 errors.push(...executionResult.errors);
                 warnings.push(...executionResult.warnings);
-                // <- TODO: !!! Only unique errors and warnings should be added (or filtered)
-                // TODO: [🧠] !!! errors, warning, isSuccessful  are redundant both in `ExecutionTask` and `ExecutionTask.currentValue`
+                // <- TODO: [🌂] Only unique errors and warnings should be added (or filtered)
+                // TODO: [🧠] !! errors, warning, isSuccessful  are redundant both in `ExecutionTask` and `ExecutionTask.currentValue`
                 //            Also maybe move `ExecutionTask.currentValue.usage` -> `ExecutionTask.usage`
                 //            And delete `ExecutionTask.currentValue.preparedPipeline`
                 assertsTaskSuccessful(executionResult);
@@ -4824,6 +5019,7 @@ function createTask(options) {
                 partialResultSubject.next(executionResult);
             }
             catch (error) {
+                assertsError(error);
                 status = 'ERROR';
                 errors.push(error);
                 partialResultSubject.error(error);
@@ -4969,13 +5165,19 @@ function valueToString(value) {
             return value.toISOString();
         }
         else {
-            return JSON.stringify(value);
+            try {
+                return JSON.stringify(value);
+            }
+            catch (error) {
+                if (error instanceof TypeError && error.message.includes('circular structure')) {
+                    return VALUE_STRINGS.circular;
+                }
+                throw error;
+            }
         }
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         console.error(error);
         return VALUE_STRINGS.unserializable;
     }
@@ -5032,9 +5234,7 @@ function extractVariablesFromJavascript(script) {
             }
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         throw new ParseError(spaceTrim$1((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
@@ -5153,6 +5353,28 @@ const MANDATORY_CSV_SETTINGS = Object.freeze({
     // encoding: 'utf-8',
 });
 
+/**
+ * Function to check if a string is valid CSV
+ *
+ * @param value The string to check
+ * @returns True if the string is a valid CSV string, false otherwise
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidCsvString(value) {
+    try {
+        // A simple check for CSV format: at least one comma and no invalid characters
+        if (value.includes(',') && /^[\w\s,"']+$/.test(value)) {
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        assertsError(error);
+        return false;
+    }
+}
+
 /**
  * Definition for CSV spreadsheet
  *
@@ -5163,7 +5385,7 @@ const CsvFormatDefinition = {
     formatName: 'CSV',
     aliases: ['SPREADSHEET', 'TABLE'],
     isValid(value, settings, schema) {
-        return true;
+        return isValidCsvString(value);
     },
     canBeValid(partialValue, settings, schema) {
         return true;
@@ -5317,6 +5539,30 @@ const TextFormatDefinition = {
  * TODO: [🏢] Allow to expect something inside each item of list and other formats
  */
 
+/**
+ * Function to check if a string is valid XML
+ *
+ * @param value
+ * @returns True if the string is a valid XML string, false otherwise
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isValidXmlString(value) {
+    try {
+        const parser = new DOMParser();
+        const parsedDocument = parser.parseFromString(value, 'application/xml');
+        const parserError = parsedDocument.getElementsByTagName('parsererror');
+        if (parserError.length > 0) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        assertsError(error);
+        return false;
+    }
+}
+
 /**
  * Definition for XML format
  *
@@ -5326,7 +5572,7 @@ const XmlFormatDefinition = {
     formatName: 'XML',
     mimeType: 'application/xml',
     isValid(value, settings, schema) {
-        return true;
+        return isValidXmlString(value);
     },
     canBeValid(partialValue, settings, schema) {
         return true;
@@ -5918,9 +6164,7 @@ async function executeAttempts(options) {
                                 break scripts;
                             }
                             catch (error) {
-                                if (!(error instanceof Error)) {
-                                    throw error;
-                                }
+                                assertsError(error);
                                 if (error instanceof UnexpectedError) {
                                     throw error;
                                 }
@@ -5990,9 +6234,7 @@ async function executeAttempts(options) {
                             break scripts;
                         }
                         catch (error) {
-                            if (!(error instanceof Error)) {
-                                throw error;
-                            }
+                            assertsError(error);
                             if (error instanceof UnexpectedError) {
                                 throw error;
                             }
@@ -6613,9 +6855,7 @@ async function executePipeline(options) {
         await Promise.all(resolving);
     }
     catch (error /* <- Note: [3] */) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         // Note: No need to rethrow UnexpectedError
         // if (error instanceof UnexpectedError) {
         // Note: Count usage, [🧠] Maybe put to separate function executionReportJsonToUsage + DRY [🤹‍♂️]
@@ -7091,9 +7331,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
             knowledgePreparedUnflatten[index] = pieces;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             console.warn(error);
             // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
         }
@@ -7891,6 +8129,8 @@ function parseNumber(value) {
  */
 
 /**
+import { WrappedError } from '../../errors/WrappedError';
+import { assertsError } from '../../errors/assertsError';
  * Parses the expect command
  *
  * @see `documentationUrl` for more details
@@ -7982,9 +8222,7 @@ const expectCommandParser = {
             };
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             throw new ParseError(spaceTrim((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
@@ -11232,9 +11470,7 @@ class JavascriptEvalExecutionTools {
             }
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             if (error instanceof ReferenceError) {
                 const undefinedName = error.message.split(' ')[0];
                 /*
@@ -11509,9 +11745,7 @@ async function createCollectionFromDirectory(rootPath, tools, options) {
                 // ---
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 // TODO: [7] DRY
                 const wrappedErrorMessage = spaceTrim((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
@@ -11602,9 +11836,7 @@ async function createCollectionFromDirectory(rootPath, tools, options) {
                 }
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 // TODO: [7] DRY
                 const wrappedErrorMessage = spaceTrim((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
@@ -11820,7 +12052,7 @@ function $initializeMakeCommand(program) {
             isCacheReloaded,
         }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
         const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-        const llm = await $provideLlmToolsForCli({
+        const { llm } = await $provideLlmToolsForCli({
             cliOptions,
             ...prepareAndScrapeOptions,
         });
@@ -12113,9 +12345,7 @@ function $initializePrettifyCommand(program) {
                 }
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 console.info(colors.red(`Prettify ${error.name} ${filename}`));
                 console.error(colors.bgRed(`${error.name} in ${basename(__filename)}`));
                 console.error(colors.red(error.stack || error.message));
@@ -12435,9 +12665,7 @@ function isValidPipelineString(pipelineString) {
         return true;
     }
     catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
+        assertsError(error);
         return false;
     }
 }
@@ -12662,9 +12890,7 @@ async function runInteractiveChatbot(options) {
             ongoingParameters = result.outputParameters;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             // TODO: Allow to ressurect the chatbot after an error - prompt the user to continue
             console.error(colors.red(error.stack || error.message));
             return process.exit(1);
@@ -12697,7 +12923,6 @@ function $initializeRunCommand(program) {
     runCommand.option('-j, --json <json>', `Pass all or some input parameters as JSON record, if used the output is also returned as JSON`);
     runCommand.option('-s, --save-report <path>', `Save report to file`);
     runCommand.action(handleActionErrors(async (pipelineSource, cliOptions) => {
-        console.log('!!!', cliOptions);
         const { reload: isCacheReloaded, interactive: isInteractive, formfactor: isFormfactorUsed, json, verbose: isVerbose, saveReport, } = cliOptions;
         if (pipelineSource.includes('-') && normalizeToKebabCase(pipelineSource) === pipelineSource) {
             console.error(colors.red(`""${pipelineSource}" is not a valid command or book. See 'ptbk --help'.`));
@@ -12723,12 +12948,10 @@ function $initializeRunCommand(program) {
         const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
         let llm;
         try {
-            llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+            llm = (await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions })).llm;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             if (!error.message.includes('No LLM tools')) {
                 throw error;
             }
@@ -12934,6 +13157,198 @@ function $initializeRunCommand(program) {
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */
 
+// TODO: !!!! List running services from REMOTE_SERVER_URLS
+// TODO: !!!! Import directly from YML
+/**
+ * @private !!!! Decide how to expose this
+ */
+const openapiJson = {
+    openapi: '3.0.0',
+    info: {
+        title: 'Promptbook Remote Server API (!!!! From TS)',
+        version: '1.0.0',
+        description: 'API documentation for the Promptbook Remote Server',
+    },
+    paths: {
+        '/': {
+            get: {
+                summary: 'Get server details',
+                description: 'Returns details about the Promptbook server.',
+                responses: {
+                    '200': {
+                        description: 'Server details in markdown format.',
+                    },
+                },
+            },
+        },
+        '/login': {
+            post: {
+                summary: 'Login to the server',
+                description: 'Login to the server and get identification.',
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    username: {
+                                        type: 'string',
+                                    },
+                                    password: {
+                                        type: 'string',
+                                    },
+                                    appId: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    '200': {
+                        description: 'Successful login',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        identification: {
+                                            type: 'object',
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        '/books': {
+            get: {
+                summary: 'List all books',
+                description: 'Returns a list of all available books in the collection.',
+                responses: {
+                    '200': {
+                        description: 'A list of books.',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'string',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        '/books/{bookId}': {
+            get: {
+                summary: 'Get book content',
+                description: 'Returns the content of a specific book.',
+                parameters: [
+                    {
+                        in: 'path',
+                        name: 'bookId',
+                        required: true,
+                        schema: {
+                            type: 'string',
+                        },
+                        description: 'The ID of the book to retrieve.',
+                    },
+                ],
+                responses: {
+                    '200': {
+                        description: 'The content of the book.',
+                        content: {
+                            'text/markdown': {
+                                schema: {
+                                    type: 'string',
+                                },
+                            },
+                        },
+                    },
+                    '404': {
+                        description: 'Book not found.',
+                    },
+                },
+            },
+        },
+        '/executions': {
+            get: {
+                summary: 'List all executions',
+                description: 'Returns a list of all running execution tasks.',
+                responses: {
+                    '200': {
+                        description: 'A list of execution tasks.',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        '/executions/new': {
+            post: {
+                summary: 'Start a new execution',
+                description: 'Starts a new execution task for a given pipeline.',
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    pipelineUrl: {
+                                        type: 'string',
+                                    },
+                                    inputParameters: {
+                                        type: 'object',
+                                    },
+                                    identification: {
+                                        type: 'object',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    '200': {
+                        description: 'The newly created execution task.',
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                },
+                            },
+                        },
+                    },
+                    '400': {
+                        description: 'Invalid input.',
+                    },
+                },
+            },
+        },
+    },
+    components: {},
+    tags: [],
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
  *
@@ -12944,7 +13359,7 @@ function $initializeRunCommand(program) {
  * @public exported from `@promptbook/remote-server`
  */
 function startRemoteServer(options) {
-    const { port, collection, createLlmExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, login, } = {
+    const { port, collection, createLlmExecutionTools, createExecutionTools, isAnonymousModeAllowed, isApplicationModeAllowed, isVerbose = DEFAULT_IS_VERBOSE, login, } = {
         isAnonymousModeAllowed: false,
         isApplicationModeAllowed: false,
         collection: null,
@@ -12952,22 +13367,6 @@ function startRemoteServer(options) {
         login: null,
         ...options,
     };
-    // <- TODO: [🦪] Some helper type to be able to use discriminant union types with destructuring
-    let { rootPath = '/' } = options;
-    if (!rootPath.startsWith('/')) {
-        rootPath = `/${rootPath}`;
-    } /* not else */
-    if (rootPath.endsWith('/')) {
-        rootPath = rootPath.slice(0, -1);
-    } /* not else */
-    if (rootPath === '/') {
-        rootPath = '';
-    }
-    const socketioPath = '/' +
-        `${rootPath}/socket.io`
-            .split('/')
-            .filter((part) => part !== '')
-            .join('/');
     const startupDate = new Date();
     async function getExecutionToolsFromIdentification(identification) {
         if (identification === null || identification === undefined) {
@@ -12990,23 +13389,25 @@ function startRemoteServer(options) {
         }
         else if (isAnonymous === false && createLlmExecutionTools !== null) {
             // Note: Application mode
-            const { appId, userId, customOptions } = identification;
-            llm = await createLlmExecutionTools({
-                appId,
-                userId,
-                customOptions,
-            });
+            llm = await createLlmExecutionTools(identification);
         }
         else {
             throw new PipelineExecutionError(`You must provide either llmToolsConfiguration or non-anonymous mode must be propperly configured`);
         }
-        const fs = $provideFilesystemForNode();
-        const executables = await $provideExecutablesForNode();
+        const customExecutionTools = createExecutionTools ? await createExecutionTools(identification) : {};
+        const fs = customExecutionTools.fs || $provideFilesystemForNode();
+        const executables = customExecutionTools.executables || (await $provideExecutablesForNode());
+        const scrapers = customExecutionTools.scrapers || (await $provideScrapersForNode({ fs, llm, executables }));
+        const script = customExecutionTools.script || (await $provideScriptingForNode({}));
+        const fetch = customExecutionTools.fetch || promptbookFetch;
+        const userInterface = customExecutionTools.userInterface || undefined;
         const tools = {
             llm,
             fs,
-            scrapers: await $provideScrapersForNode({ fs, llm, executables }),
-            script: await $provideScriptingForNode({}),
+            scrapers,
+            script,
+            fetch,
+            userInterface,
         };
         return tools;
     }
@@ -13016,39 +13417,27 @@ 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`
-                },
-            ],
+    // TODO: !!!! Expose openapiJson to consumer and also allow to add new routes
+    app.use(OpenApiValidator.middleware({
+        apiSpec: openapiJson,
+        ignorePaths(path) {
+            return path.startsWith('/api-docs') || path.startsWith('/swagger') || path.startsWith('/openapi');
         },
-        apis: ['./src/remote-server/**/*.ts'], // Adjust path as needed
-    };
-    const swaggerSpec = swaggerJsdoc(swaggerOptions);
-    app.use([`/api-docs`, `${rootPath}/api-docs`], swaggerUi.serve, swaggerUi.setup(swaggerSpec));
+        validateRequests: true,
+        validateResponses: true,
+    }));
+    app.use([`/api-docs`, `/swagger`], swaggerUi.serve, swaggerUi.setup(openapiJson, {
+    // customCss: '.swagger-ui .topbar { display: none }',
+    // customSiteTitle: 'BRJ API',
+    // customfavIcon: 'https://brj.app/favicon.ico',
+    }));
+    app.get(`/openapi`, (request, response) => {
+        response.json(openapiJson);
+    });
     const runningExecutionTasks = [];
     // <- TODO: [🤬] Identify the users
     // TODO: [🧠] Do here some garbage collection of finished tasks
-    /**
-     * @swagger
-     * /:
-     *   get:
-     *     summary: Get server details
-     *     description: Returns details about the Promptbook server.
-     *     responses:
-     *       200:
-     *         description: Server details in markdown format.
-     */
-    app.get(['/', rootPath], async (request, response) => {
+    app.get('/', async (request, response) => {
         var _a;
         if ((_a = request.url) === null || _a === void 0 ? void 0 : _a.includes('socket.io')) {
             return;
@@ -13067,8 +13456,6 @@ function startRemoteServer(options) {
                     ## Details
 
                     **Server port:** ${port}
-                    **Server root path:** ${rootPath}
-                    **Socket.io path:** ${socketioPath}
                     **Startup date:** ${startupDate.toISOString()}
                     **Anonymouse mode:** ${isAnonymousModeAllowed ? 'enabled' : 'disabled'}
                     **Application mode:** ${isApplicationModeAllowed ? 'enabled' : 'disabled'}
@@ -13107,38 +13494,7 @@ function startRemoteServer(options) {
                     https://github.com/webgptorg/promptbook
                 `));
     });
-    /**
-     * @swagger
-     *
-     * /login:
-     *  post:
-     *   summary: Login to the server
-     *   description: Login to the server and get identification.
-     *   requestBody:
-     *    required: true
-     *    content:
-     *     application/json:
-     *      schema:
-     *       type: object
-     *       properties:
-     *        username:
-     *         type: string
-     *        password:
-     *         type: string
-     *        appId:
-     *         type: string
-     *   responses:
-     *    200:
-     *     description: Successful login
-     *     content:
-     *      application/json:
-     *       schema:
-     *        type: object
-     *        properties:
-     *         identification:
-     *          type: object
-     */
-    app.post([`/login`, `${rootPath}/login`], async (request, response) => {
+    app.post(`/login`, async (request, response) => {
         if (!isApplicationModeAllowed || login === null) {
             response.status(400).send('Application mode is not allowed');
             return;
@@ -13163,9 +13519,7 @@ function startRemoteServer(options) {
             return;
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             if (error instanceof AuthenticationError) {
                 response.status(401).send({
                     isSuccess: false,
@@ -13180,23 +13534,7 @@ function startRemoteServer(options) {
             response.status(400).send({ error: serializeError(error) });
         }
     });
-    /**
-     * @swagger
-     * /books:
-     *   get:
-     *     summary: List all books
-     *     description: Returns a list of all available books in the collection.
-     *     responses:
-     *       200:
-     *         description: A list of books.
-     *         content:
-     *           application/json:
-     *             schema:
-     *               type: array
-     *               items:
-     *                 type: string
-     */
-    app.get([`/books`, `${rootPath}/books`], async (request, response) => {
+    app.get(`/books`, async (request, response) => {
         if (collection === null) {
             response.status(500).send('No collection available');
             return;
@@ -13206,30 +13544,7 @@ function startRemoteServer(options) {
         response.send(pipelines);
     });
     // TODO: [🧠] Is it secure / good idea to expose source codes of hosted books
-    /**
-     * @swagger
-     * /books/{bookId}:
-     *   get:
-     *     summary: Get book content
-     *     description: Returns the content of a specific book.
-     *     parameters:
-     *       - in: path
-     *         name: bookId
-     *         required: true
-     *         schema:
-     *           type: string
-     *         description: The ID of the book to retrieve.
-     *     responses:
-     *       200:
-     *         description: The content of the book.
-     *         content:
-     *           text/markdown:
-     *             schema:
-     *               type: string
-     *       404:
-     *         description: Book not found.
-     */
-    app.get([`/books/*`, `${rootPath}/books/*`], async (request, response) => {
+    app.get(`/books/*`, async (request, response) => {
         try {
             if (collection === null) {
                 response.status(500).send('No collection nor books available');
@@ -13248,9 +13563,7 @@ function startRemoteServer(options) {
                 .send(source.content);
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             response
                 .status(404)
                 .send({ error: serializeError(error) });
@@ -13283,26 +13596,10 @@ function startRemoteServer(options) {
             };
         }
     }
-    /**
-     * @swagger
-     * /executions:
-     *   get:
-     *     summary: List all executions
-     *     description: Returns a list of all running execution tasks.
-     *     responses:
-     *       200:
-     *         description: A list of execution tasks.
-     *         content:
-     *           application/json:
-     *             schema:
-     *               type: array
-     *               items:
-     *                 type: object
-     */
-    app.get([`/executions`, `${rootPath}/executions`], async (request, response) => {
-        response.send(runningExecutionTasks.map((runningExecutionTask) => exportExecutionTask(runningExecutionTask, false)));
+    app.get(`/executions`, async (request, response) => {
+        response.send(runningExecutionTasks.map((runningExecutionTask) => exportExecutionTask(runningExecutionTask, false)) /* <- TODO: satisfies paths['/executions']['get']['responses']['200']['content']['application/json'] */);
     });
-    app.get([`/executions/last`, `${rootPath}/executions/last`], async (request, response) => {
+    app.get(`/executions/last`, async (request, response) => {
         // TODO: [🤬] Filter only for user
         if (runningExecutionTasks.length === 0) {
             response.status(404).send('No execution tasks found');
@@ -13311,7 +13608,7 @@ function startRemoteServer(options) {
         const lastExecutionTask = runningExecutionTasks[runningExecutionTasks.length - 1];
         response.send(exportExecutionTask(lastExecutionTask, true));
     });
-    app.get([`/executions/:taskId`, `${rootPath}/executions/:taskId`], async (request, response) => {
+    app.get(`/executions/:taskId`, async (request, response) => {
         const { taskId } = request.params;
         // TODO: [🤬] Filter only for user
         const executionTask = runningExecutionTasks.find((executionTask) => executionTask.taskId === taskId);
@@ -13323,39 +13620,12 @@ function startRemoteServer(options) {
         }
         response.send(exportExecutionTask(executionTask, true));
     });
-    /**
-     * @swagger
-     * /executions/new:
-     *   post:
-     *     summary: Start a new execution
-     *     description: Starts a new execution task for a given pipeline.
-     *     requestBody:
-     *       required: true
-     *       content:
-     *         application/json:
-     *           schema:
-     *             type: object
-     *             properties:
-     *               pipelineUrl:
-     *                 type: string
-     *               inputParameters:
-     *                 type: object
-     *               identification:
-     *                 type: object
-     *     responses:
-     *       200:
-     *         description: The newly created execution task.
-     *         content:
-     *           application/json:
-     *             schema:
-     *               type: object
-     *       400:
-     *         description: Invalid input.
-     */
-    app.post([`/executions/new`, `${rootPath}/executions/new`], async (request, response) => {
+    app.post(`/executions/new`, async (request, response) => {
         try {
             const { inputParameters, identification /* <- [🤬] */ } = request.body;
-            const pipelineUrl = request.body.pipelineUrl || request.body.book;
+            const pipelineUrl = request.body
+                .pipelineUrl /* <- TODO: as paths['/executions/new']['post']['requestBody']['content']['application/json'] */ ||
+                request.body.book;
             // TODO: [🧠] Check `pipelineUrl` and `inputParameters` here or it should be responsibility of `collection.getPipelineByUrl` and `pipelineExecutor`
             const pipeline = await (collection === null || collection === void 0 ? void 0 : collection.getPipelineByUrl(pipelineUrl));
             if (pipeline === undefined) {
@@ -13369,7 +13639,7 @@ function startRemoteServer(options) {
             await forTime(10);
             // <- Note: Wait for a while to wait for quick responses or sudden but asynchronous errors
             // <- TODO: Put this into configuration
-            response.send(executionTask);
+            response.send(executionTask /* <- TODO: satisfies paths['/executions/new']['post']['responses']['200']['content']['application/json'] */);
             /*/
             executionTask.asObservable().subscribe({
                 next(partialResult) {
@@ -13389,19 +13659,24 @@ function startRemoteServer(options) {
             */
         }
         catch (error) {
-            if (!(error instanceof Error)) {
-                throw error;
-            }
+            assertsError(error);
             response.status(400).send({ error: serializeError(error) });
         }
     });
+    /**
+     * Catch-all handler for unmatched routes
+     */
+    app.use((request, response) => {
+        response.status(404).send(`URL "${request.originalUrl}" was not found on Promptbook server.`);
+    });
     const httpServer = http.createServer(app);
     const server = new Server(httpServer, {
-        path: socketioPath,
-        transports: [/*'websocket', <- TODO: [🌬] Make websocket transport work */ 'polling'],
+        path: '/socket.io',
+        transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
         cors: {
             origin: '*',
             methods: ['GET', 'POST'],
+            // <- TODO: [🌡] Allow to pass
         },
     });
     server.on('connection', (socket) => {
@@ -13455,9 +13730,7 @@ function startRemoteServer(options) {
                 socket.emit('prompt-response', { promptResult } /* <- Note: [🤛] */);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 socket.emit('error', serializeError(error) /* <- Note: [🤛] */);
             }
             finally {
@@ -13479,9 +13752,7 @@ function startRemoteServer(options) {
                 socket.emit('listModels-response', { models } /* <- Note: [🤛] */);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 socket.emit('error', serializeError(error));
             }
             finally {
@@ -13502,9 +13773,7 @@ function startRemoteServer(options) {
                 socket.emit('preparePipeline-response', { preparedPipeline } /* <- Note: [🤛] */);
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 socket.emit('error', serializeError(error));
                 // <- TODO: [🚋] There is a problem with the remote server handling errors and sending them back to the client
             }
@@ -13552,8 +13821,7 @@ function startRemoteServer(options) {
     };
 }
 /**
- * TODO: !! Add CORS and security - probbably via `helmet`
- * TODO: [👩🏾‍🤝‍🧑🏾] Allow to pass custom fetch function here - PromptbookFetch
+ * TODO: [🌡] Add CORS and security - probbably via `helmet`
  * TODO: Split this file into multiple functions - handler for each request
  * TODO: Maybe use `$exportJson`
  * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
@@ -13612,9 +13880,9 @@ function $initializeStartServerCommand(program) {
         if (url !== null) {
             rootUrl = suffixUrl(url, '/books');
         }
-        let rootPath = '/';
-        if (url !== null) {
-            rootPath = url.pathname;
+        if (url !== null && url.pathname !== '/' && url.pathname !== '') {
+            console.error(colors.red(`URL of the server can not have path, but got "${url.pathname}"`));
+            process.exit(1);
         }
         // TODO: DRY [◽]
         const prepareAndScrapeOptions = {
@@ -13622,7 +13890,7 @@ function $initializeStartServerCommand(program) {
             isCacheReloaded,
         }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
         const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-        const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+        const { /* [0] strategy,*/ llm } = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
         const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
         const tools = {
             llm,
@@ -13641,7 +13909,6 @@ function $initializeStartServerCommand(program) {
         });
         // console.log(path, await collection.listPipelines());
         const server = startRemoteServer({
-            rootPath,
             port,
             isAnonymousModeAllowed,
             isApplicationModeAllowed: true,
@@ -13654,6 +13921,7 @@ function $initializeStartServerCommand(program) {
                 TODO_USE({ appId, userId });
                 return llm;
             },
+            // <- TODO: [🧠][0] Maybe pass here strategy
         });
         keepUnused(server);
         // Note: Already logged by `startRemoteServer`
@@ -13695,7 +13963,7 @@ function $initializeTestCommand(program) {
                 isCacheReloaded,
             }; /* <- TODO: ` satisfies PrepareAndScrapeOptions` */
             const fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-            const llm = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
+            const { llm } = await $provideLlmToolsForCli({ cliOptions, ...prepareAndScrapeOptions });
             const executables = await $provideExecutablesForNode(prepareAndScrapeOptions);
             tools = {
                 llm,
@@ -13734,9 +14002,7 @@ function $initializeTestCommand(program) {
                 }
             }
             catch (error) {
-                if (!(error instanceof Error)) {
-                    throw error;
-                }
+                assertsError(error);
                 console.info(colors.red(`Pipeline is not valid ${filename}`));
                 console.error(colors.bgRed(`${error.name} in ${basename(__filename)}`));
                 console.error(colors.red(error.stack || error.message));
@@ -13960,7 +14226,25 @@ const ANTHROPIC_CLAUDE_MODELS = exportJson({
                 output: computeUsage(`$2.40 / 1M tokens`),
             },
         },
-        // TODO: [main] !!3 Claude 1 and 2 has also completion versions - ask Hoagy
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 3.7 Sonnet',
+            modelName: 'claude-3-7-sonnet-20250219',
+            pricing: {
+                prompt: computeUsage(`$3.00 / 1M tokens`),
+                output: computeUsage(`$15.00 / 1M tokens`),
+            },
+        },
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'Claude 3.5 Haiku',
+            modelName: 'claude-3-5-haiku-20241022',
+            pricing: {
+                prompt: computeUsage(`$0.25 / 1M tokens`),
+                output: computeUsage(`$1.25 / 1M tokens`),
+            },
+        },
+        // <- [🕕]
     ],
 });
 /**
@@ -14725,7 +15009,6 @@ const OPENAI_MODELS = exportJson({
                 prompt: computeUsage(`$5.00 / 1M tokens`),
                 output: computeUsage(`$15.00 / 1M tokens`),
             },
-            //TODO: [main] !!3 Add gpt-4o-mini-2024-07-18 and all others to be up to date
         },
         /**/
         /**/
@@ -14740,6 +15023,17 @@ const OPENAI_MODELS = exportJson({
         },
         /**/
         /**/
+        {
+            modelVariant: 'CHAT',
+            modelTitle: 'gpt-4o-mini',
+            modelName: 'gpt-4o-mini',
+            pricing: {
+                prompt: computeUsage(`$3.00 / 1M tokens`),
+                output: computeUsage(`$9.00 / 1M tokens`),
+            },
+        },
+        /**/
+        /**/
         {
             modelVariant: 'CHAT',
             modelTitle: 'o1-preview',
@@ -14819,6 +15113,7 @@ const OPENAI_MODELS = exportJson({
             },
         },
         /**/
+        // <- [🕕]
     ],
 });
 /**
@@ -15387,11 +15682,17 @@ const createDeepseekExecutionTools = Object.assign((options) => {
         description: 'Implementation of Deepseek models',
         vercelProvider: deepseekVercelProvider,
         availableModels: [
-            // TODO: [🕘] Maybe list models in same way as in other providers - in separate file with metadata
-            'deepseek-chat',
-            'deepseek-reasoner',
+            {
+                modelName: 'deepseek-chat',
+                modelVariant: 'CHAT',
+            },
+            {
+                modelName: 'deepseek-reasoner',
+                modelVariant: 'CHAT',
+            },
+            // <- [🕕]
             // <- TODO: How picking of the default model looks like in `createExecutionToolsFromVercelProvider`
-        ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
+        ],
         ...options,
     });
 }, {
@@ -15489,6 +15790,10 @@ const createGoogleExecutionTools = Object.assign((options) => {
         vercelProvider: googleGeminiVercelProvider,
         availableModels: [
             // TODO: [🕘] Maybe list models in same way as in other providers - in separate file with metadata
+            'gemini-2.5-pro-preview-03-25',
+            'gemini-2.0-flash',
+            'gemini-2.0-flash-lite',
+            'gemini-2.0-flash-thinking-exp-01-21',
             'gemini-1.5-flash',
             'gemini-1.5-flash-latest',
             'gemini-1.5-flash-001',
@@ -15504,6 +15809,7 @@ const createGoogleExecutionTools = Object.assign((options) => {
             'gemini-1.5-pro-002',
             'gemini-1.5-pro-exp-0827',
             'gemini-1.0-pro',
+            // <- [🕕]
         ].map((modelName) => ({ modelName, modelVariant: 'CHAT' })),
         ...options,
     });
@@ -15783,6 +16089,7 @@ class OpenAiExecutionTools {
             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
         }
         const rawResponse = await client.chat.completions.create(rawRequest).catch((error) => {
+            assertsError(error);
             if (this.options.isVerbose) {
                 console.info(colors.bgRed('error'), error);
             }
@@ -15859,6 +16166,7 @@ class OpenAiExecutionTools {
             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
         }
         const rawResponse = await client.completions.create(rawRequest).catch((error) => {
+            assertsError(error);
             if (this.options.isVerbose) {
                 console.info(colors.bgRed('error'), error);
             }
@@ -15922,6 +16230,7 @@ class OpenAiExecutionTools {
             console.info(colors.bgWhite('rawRequest'), JSON.stringify(rawRequest, null, 4));
         }
         const rawResponse = await client.embeddings.create(rawRequest).catch((error) => {
+            assertsError(error);
             if (this.options.isVerbose) {
                 console.info(colors.bgRed('error'), error);
             }