@promptbook/wizard 0.103.0-46 → 0.103.0-48

package/esm/index.es.js

@@ -6,9 +6,9 @@ import Bottleneck from 'bottleneck';
 import colors from 'colors';
 import { OpenAIClient, AzureKeyCredential } from '@azure/openai';
 import OpenAI from 'openai';
-import { forEver, forTime } from 'waitasecond';
 import { mkdir, rm, readFile, readdir, rename, rmdir, stat, access, constants, writeFile, watch, unlink } from 'fs/promises';
 import { spawn } from 'child_process';
+import { forTime } from 'waitasecond';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import { basename, join, dirname, isAbsolute, relative } from 'path';
@@ -36,7 +36,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-46';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-48';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -49,15 +49,20 @@ const PROMPTBOOK_ENGINE_VERSION = '0.103.0-46';
  */
 const REMOTE_SERVER_URLS = [
     {
-        title: 'Promptbook',
-        description: `Servers of Promptbook.studio`,
+        title: 'Promptbook.Studio',
+        description: `Server 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
         ],
     },
+    {
+        title: 'Testing Agents',
+        description: `Testing Agents server on Vercel`,
+        owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+        urls: ['https://s6.ptbk.io/'],
+    },
     /*
     Note: Working on older version of Promptbook and not supported anymore
     {
@@ -315,9 +320,6 @@ function checkChannelValue(channelName, value) {
         throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
     }
 }
-/**
- * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
- */
 
 /**
  * Color object represents an RGB color with alpha channel
@@ -3857,17 +3859,17 @@ const OPENAI_MODELS = exportJson({
         },
         /**/
         /*/
-      {
-          modelTitle: 'tts-1-hd-1106',
-          modelName: 'tts-1-hd-1106',
-      },
-      /**/
+        {
+            modelTitle: 'tts-1-hd-1106',
+            modelName: 'tts-1-hd-1106',
+        },
+        /**/
         /*/
-      {
-          modelTitle: 'tts-1-hd',
-          modelName: 'tts-1-hd',
-      },
-      /**/
+        {
+            modelTitle: 'tts-1-hd',
+            modelName: 'tts-1-hd',
+        },
+        /**/
         /**/
         {
             modelVariant: 'CHAT',
@@ -5205,26 +5207,6 @@ const GOOGLE_MODELS = exportJson({
                 output: pricing(`$0.45 / 1M tokens`),
             },
         },
-        {
-            modelVariant: 'CHAT',
-            modelTitle: 'Gemini 2.0 Flash',
-            modelName: 'gemini-2.0-flash',
-            modelDescription: 'Fast, efficient model with 128K context window optimized for rapid response times. Balances performance and cost with 2x lower latency than Pro models while maintaining strong capabilities in text generation, code completion, and logical reasoning. Excellent for interactive applications, chatbots, and services requiring quick responses with good quality.',
-            pricing: {
-                prompt: pricing(`$0.35 / 1M tokens`),
-                output: pricing(`$1.05 / 1M tokens`),
-            },
-        },
-        {
-            modelVariant: 'CHAT',
-            modelTitle: 'Gemini 2.0 Flash Lite',
-            modelName: 'gemini-2.0-flash-lite',
-            modelDescription: 'Streamlined version of Gemini 2.0 Flash with 64K context window, designed for extremely low-latency applications. Features 40% smaller model size and 3x faster inference while retaining core capabilities for text and simple reasoning tasks. Perfect for mobile applications, edge deployments, and high-volume services with strict latency requirements.',
-            pricing: {
-                prompt: pricing(`$0.20 / 1M tokens`),
-                output: pricing(`$0.60 / 1M tokens`),
-            },
-        },
         {
             modelVariant: 'CHAT',
             modelTitle: 'Gemini 2.0 Flash Thinking',
@@ -6801,7 +6783,7 @@ class OpenAiExecutionTools extends OpenAiCompatibleExecutionTools {
  *
  * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
  *
- * Note: [🦖] There are several different things in Promptbook:
+ * !!! Note: [🦖] There are several different things in Promptbook:
  * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
  * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
  * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
@@ -6907,17 +6889,21 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 console.info('connect', stream.currentEvent);
             }
         });
+        /*
         stream.on('messageDelta', (messageDelta) => {
-            var _a;
-            if (this.options.isVerbose &&
+            if (
+                this.options.isVerbose &&
                 messageDelta &&
                 messageDelta.content &&
                 messageDelta.content[0] &&
-                messageDelta.content[0].type === 'text') {
-                console.info('messageDelta', (_a = messageDelta.content[0].text) === null || _a === void 0 ? void 0 : _a.value);
+                messageDelta.content[0].type === 'text'
+            ) {
+                console.info('messageDelta', messageDelta.content[0].text?.value);
             }
+
             // <- TODO: [🐚] Make streaming and running tasks working
         });
+        */
         stream.on('messageCreated', (message) => {
             if (this.options.isVerbose) {
                 console.info('messageCreated', message);
@@ -6972,15 +6958,19 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             },
         });
     }
-    async playground() {
+    /*
+    public async playground() {
         const client = await this.getClient();
+
         // List all assistants
         const assistants = await client.beta.assistants.list();
         console.log('!!! Assistants:', assistants);
+
         // Get details of a specific assistant
         const assistantId = 'asst_MO8fhZf4dGloCfXSHeLcIik0';
         const assistant = await client.beta.assistants.retrieve(assistantId);
         console.log('!!! Assistant Details:', assistant);
+
         // Update an assistant
         const updatedAssistant = await client.beta.assistants.update(assistantId, {
             name: assistant.name + '(M)',
@@ -6990,71 +6980,103 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             },
         });
         console.log('!!! Updated Assistant:', updatedAssistant);
+
         await forEver();
     }
+    */
+    /**
+     * Get an existing assistant tool wrapper
+     */
+    getAssistant(assistantId) {
+        return new OpenAiAssistantExecutionTools({
+            ...this.options,
+            assistantId,
+        });
+    }
     async createNewAssistant(options) {
         if (!this.isCreatingNewAssistantsAllowed) {
             throw new NotAllowed(`Creating new assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
         }
         // await this.playground();
-        const { name, instructions } = options;
+        const { name, instructions, knowledgeSources } = options;
         const client = await this.getClient();
-        /*/
-        //TODO: !!!
-        async function downloadFile(url: string, folder = './tmp'): Promise<string> {
-            const filename = path.basename(url.split('?')[0]);
-            const filepath = path.join(folder, filename);
-
-            if (!fs.existsSync(folder)) fs.mkdirSync(folder);
-
-            const res = await fetch(url);
-            if (!res.ok) throw new Error(`Download error: ${url}`);
-            const buffer = await res.arrayBuffer();
-            fs.writeFileSync(filepath, Buffer.from(buffer));
-            console.log(`📥 File downloaded: ${filename}`);
-
-            return filepath;
-        }
-
-        async function uploadFileToOpenAI(filepath: string) {
-            const file = await client.files.create({
-                file: fs.createReadStream(filepath),
-                purpose: 'assistants',
+        let vectorStoreId;
+        // If knowledge sources are provided, create a vector store with them
+        if (knowledgeSources && knowledgeSources.length > 0) {
+            if (this.options.isVerbose) {
+                console.info(`📚 Creating vector store with ${knowledgeSources.length} knowledge sources...`);
+            }
+            // Create a vector store
+            const vectorStore = await client.beta.vectorStores.create({
+                name: `${name} Knowledge Base`,
             });
-            console.log(`⬆️  File uploaded to OpenAI: ${file.filename} (${file.id})`);
-            return file;
-        }
-
-        // 🌐 URL addresses of files to upload
-        const fileUrls = [
-            'https://raw.githubusercontent.com/vercel/next.js/canary/packages/next/README.md',
-            'https://raw.githubusercontent.com/openai/openai-cookbook/main/examples/How_to_call_the_Assistants_API_with_Node.js.ipynb',
-        ];
-
-        // 1️⃣ Download files from URL
-        const localFiles = [];
-        for (const url of fileUrls) {
-            const filepath = await downloadFile(url);
-            localFiles.push(filepath);
-        }
-
-        // 2️⃣ Upload files to OpenAI
-        const uploadedFiles = [];
-        for (const filepath of localFiles) {
-            const file = await uploadFileToOpenAI(filepath);
-            uploadedFiles.push(file.id);
+            vectorStoreId = vectorStore.id;
+            if (this.options.isVerbose) {
+                console.info(`✅ Vector store created: ${vectorStoreId}`);
+            }
+            // Upload files from knowledge sources to the vector store
+            const fileStreams = [];
+            for (const source of knowledgeSources) {
+                try {
+                    // Check if it's a URL
+                    if (source.startsWith('http://') || source.startsWith('https://')) {
+                        // Download the file
+                        const response = await fetch(source);
+                        if (!response.ok) {
+                            console.error(`Failed to download ${source}: ${response.statusText}`);
+                            continue;
+                        }
+                        const buffer = await response.arrayBuffer();
+                        const filename = source.split('/').pop() || 'downloaded-file';
+                        const blob = new Blob([buffer]);
+                        const file = new File([blob], filename);
+                        fileStreams.push(file);
+                    }
+                    else {
+                        // Assume it's a local file path
+                        // Note: This will work in Node.js environment
+                        // For browser environments, this would need different handling
+                        const fs = await import('fs');
+                        const fileStream = fs.createReadStream(source);
+                        fileStreams.push(fileStream);
+                    }
+                }
+                catch (error) {
+                    console.error(`Error processing knowledge source ${source}:`, error);
+                }
+            }
+            // Batch upload files to the vector store
+            if (fileStreams.length > 0) {
+                try {
+                    await client.beta.vectorStores.fileBatches.uploadAndPoll(vectorStoreId, {
+                        files: fileStreams,
+                    });
+                    if (this.options.isVerbose) {
+                        console.info(`✅ Uploaded ${fileStreams.length} files to vector store`);
+                    }
+                }
+                catch (error) {
+                    console.error('Error uploading files to vector store:', error);
+                }
+            }
         }
-        /**/
-        // alert('!!!! Creating new OpenAI assistant');
-        // 3️⃣ Create assistant with uploaded files
-        const assistant = await client.beta.assistants.create({
+        // Create assistant with vector store attached
+        const assistantConfig = {
             name,
             description: 'Assistant created via Promptbook',
             model: 'gpt-4o',
             instructions,
             tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
-            // !!!! file_ids: uploadedFiles,
-        });
+        };
+        // Attach vector store if created
+        if (vectorStoreId) {
+            assistantConfig.tool_resources = {
+                file_search: {
+                    vector_store_ids: [vectorStoreId],
+                },
+            };
+        }
+        const assistant = await client.beta.assistants.create(assistantConfig);
         console.log(`✅ Assistant created: ${assistant.id}`);
         // TODO: !!!! Try listing existing assistants
         // TODO: !!!! Try marking existing assistants by DISCRIMINANT
@@ -7065,6 +7087,95 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             assistantId: assistant.id,
         });
     }
+    async updateAssistant(options) {
+        if (!this.isCreatingNewAssistantsAllowed) {
+            throw new NotAllowed(`Updating assistants is not allowed. Set \`isCreatingNewAssistantsAllowed: true\` in options to enable this feature.`);
+        }
+        const { assistantId, name, instructions, knowledgeSources } = options;
+        const client = await this.getClient();
+        let vectorStoreId;
+        // If knowledge sources are provided, create a vector store with them
+        // TODO: [🧠] Reuse vector store creation logic from createNewAssistant
+        if (knowledgeSources && knowledgeSources.length > 0) {
+            if (this.options.isVerbose) {
+                console.info(`📚 Creating vector store for update with ${knowledgeSources.length} knowledge sources...`);
+            }
+            // Create a vector store
+            const vectorStore = await client.beta.vectorStores.create({
+                name: `${name} Knowledge Base`,
+            });
+            vectorStoreId = vectorStore.id;
+            if (this.options.isVerbose) {
+                console.info(`✅ Vector store created: ${vectorStoreId}`);
+            }
+            // Upload files from knowledge sources to the vector store
+            const fileStreams = [];
+            for (const source of knowledgeSources) {
+                try {
+                    // Check if it's a URL
+                    if (source.startsWith('http://') || source.startsWith('https://')) {
+                        // Download the file
+                        const response = await fetch(source);
+                        if (!response.ok) {
+                            console.error(`Failed to download ${source}: ${response.statusText}`);
+                            continue;
+                        }
+                        const buffer = await response.arrayBuffer();
+                        const filename = source.split('/').pop() || 'downloaded-file';
+                        const blob = new Blob([buffer]);
+                        const file = new File([blob], filename);
+                        fileStreams.push(file);
+                    }
+                    else {
+                        // Assume it's a local file path
+                        // Note: This will work in Node.js environment
+                        // For browser environments, this would need different handling
+                        const fs = await import('fs');
+                        const fileStream = fs.createReadStream(source);
+                        fileStreams.push(fileStream);
+                    }
+                }
+                catch (error) {
+                    console.error(`Error processing knowledge source ${source}:`, error);
+                }
+            }
+            // Batch upload files to the vector store
+            if (fileStreams.length > 0) {
+                try {
+                    await client.beta.vectorStores.fileBatches.uploadAndPoll(vectorStoreId, {
+                        files: fileStreams,
+                    });
+                    if (this.options.isVerbose) {
+                        console.info(`✅ Uploaded ${fileStreams.length} files to vector store`);
+                    }
+                }
+                catch (error) {
+                    console.error('Error uploading files to vector store:', error);
+                }
+            }
+        }
+        const assistantUpdate = {
+            name,
+            instructions,
+            tools: [/* TODO: [🧠] Maybe add { type: 'code_interpreter' }, */ { type: 'file_search' }],
+        };
+        if (vectorStoreId) {
+            assistantUpdate.tool_resources = {
+                file_search: {
+                    vector_store_ids: [vectorStoreId],
+                },
+            };
+        }
+        const assistant = await client.beta.assistants.update(assistantId, assistantUpdate);
+        if (this.options.isVerbose) {
+            console.log(`✅ Assistant updated: ${assistant.id}`);
+        }
+        return new OpenAiAssistantExecutionTools({
+            ...this.options,
+            isCreatingNewAssistantsAllowed: false,
+            assistantId: assistant.id,
+        });
+    }
     /**
      * Discriminant for type guards
      */
@@ -7522,6 +7633,8 @@ function nameToSubfolderPath(name) {
 /**
  * Converts a given text to kebab-case format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text to be converted.
  * @returns The kebab-case formatted string.
  * @example 'hello-world'
@@ -7647,6 +7760,8 @@ function removeEmojis(text) {
 /**
  * Converts a title string into a normalized name.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param value The title string to be converted to a name.
  * @returns A normalized name derived from the input title.
  * @example 'Hello World!' -> 'hello-world'
@@ -13266,40 +13381,6 @@ const _FormattedBookInMarkdownTranspilerRegistration = $bookTranspilersRegister.
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-/**
- * Creates an empty/basic agent model requirements object
- * This serves as the starting point for the reduce-like pattern
- * where each commitment applies its changes to build the final requirements
- *
- * @public exported from `@promptbook/core`
- */
-function createEmptyAgentModelRequirements() {
-    return {
-        systemMessage: '',
-        // modelName: 'gpt-5',
-        modelName: 'gemini-2.5-flash-lite',
-        temperature: 0.7,
-        topP: 0.9,
-        topK: 50,
-    };
-}
-/**
- * Creates a basic agent model requirements with just the agent name
- * This is used when we have an agent name but no commitments
- *
- * @public exported from `@promptbook/core`
- */
-function createBasicAgentModelRequirements(agentName) {
-    const empty = createEmptyAgentModelRequirements();
-    return {
-        ...empty,
-        systemMessage: `You are ${agentName || 'AI Agent'}`,
-    };
-}
-/**
- * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
- */
-
 /**
  * Generates a regex pattern to match a specific commitment
  *
@@ -13833,23 +13914,19 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        var _a;
         const trimmedContent = content.trim();
         if (!trimmedContent) {
             return requirements;
         }
         // Check if content is a URL (external knowledge source)
-        if (this.isUrl(trimmedContent)) {
+        if (isValidUrl(trimmedContent)) {
             // Store the URL for later async processing
             const updatedRequirements = {
                 ...requirements,
-                metadata: {
-                    ...requirements.metadata,
-                    knowledgeSources: [
-                        ...(((_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.knowledgeSources) || []),
-                        trimmedContent,
-                    ],
-                },
+                knowledgeSources: [
+                    ...(requirements.knowledgeSources || []),
+                    trimmedContent,
+                ],
             };
             // Add placeholder information about knowledge sources to system message
             const knowledgeInfo = `Knowledge Source URL: ${trimmedContent} (will be processed for retrieval during chat)`;
@@ -13861,18 +13938,6 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             return this.appendToSystemMessage(requirements, knowledgeSection, '\n\n');
         }
     }
-    /**
-     * Check if content is a URL
-     */
-    isUrl(content) {
-        try {
-            new URL(content);
-            return true;
-        }
-        catch (_a) {
-            return false;
-        }
-    }
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -14683,6 +14748,7 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
             // Keep everything after the PERSONA section
             cleanedMessage = lines.slice(personaEndIndex).join('\n').trim();
         }
+        // TODO: [🕛] There should be `agentFullname` not `agentName`
         // Create new system message with persona at the beginning
         // Format: "You are {agentName}\n{personaContent}"
         // The # PERSONA comment will be removed later by removeCommentsFromSystemMessage
@@ -15170,6 +15236,40 @@ function getCommitmentDefinition(type) {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Creates an empty/basic agent model requirements object
+ * This serves as the starting point for the reduce-like pattern
+ * where each commitment applies its changes to build the final requirements
+ *
+ * @public exported from `@promptbook/core`
+ */
+function createEmptyAgentModelRequirements() {
+    return {
+        systemMessage: '',
+        // modelName: 'gpt-5',
+        modelName: 'gemini-2.5-flash-lite',
+        temperature: 0.7,
+        topP: 0.9,
+        topK: 50,
+    };
+}
+/**
+ * Creates a basic agent model requirements with just the agent name
+ * This is used when we have an agent name but no commitments
+ *
+ * @public exported from `@promptbook/core`
+ */
+function createBasicAgentModelRequirements(agentName) {
+    const empty = createEmptyAgentModelRequirements();
+    return {
+        ...empty,
+        systemMessage: `You are ${agentName || 'AI Agent'}`,
+    };
+}
+/**
+ * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
+ */
+
 /**
  * Parses agent source using the new commitment system with multiline support
  * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -15260,29 +15360,6 @@ function parseAgentSourceWithCommitments(agentSource) {
     };
 }
 
-/**
- * Removes comment lines (lines starting with #) from a system message
- * This is used to clean up the final system message before sending it to the AI model
- * while preserving the original content with comments in metadata
- *
- * @param systemMessage The system message that may contain comment lines
- * @returns The system message with comment lines removed
- *
- * @private - TODO: [🧠] Maybe should be public?
- */
-function removeCommentsFromSystemMessage(systemMessage) {
-    if (!systemMessage) {
-        return systemMessage;
-    }
-    const lines = systemMessage.split('\n');
-    const filteredLines = lines.filter((line) => {
-        const trimmedLine = line.trim();
-        // Remove lines that start with # (comments)
-        return !trimmedLine.startsWith('#');
-    });
-    return filteredLines.join('\n').trim();
-}
-
 /**
  * Parses parameters from text using both supported notations:
  * 1. @Parameter - single word parameter starting with @
@@ -15342,17 +15419,40 @@ function parseParameters(text) {
 }
 
 /**
- * Creates agent model requirements using the new commitment system
- * This function uses a reduce-like pattern where each commitment applies its changes
- * to build the final requirements starting from a basic empty model
+ * Removes comment lines (lines starting with #) from a system message
+ * This is used to clean up the final system message before sending it to the AI model
+ * while preserving the original content with comments in metadata
  *
- * @public exported from `@promptbook/core`
+ * @param systemMessage The system message that may contain comment lines
+ * @returns The system message with comment lines removed
+ *
+ * @private - TODO: [🧠] Maybe should be public?
  */
-async function createAgentModelRequirementsWithCommitments(agentSource, modelName) {
-    // Parse the agent source to extract commitments
-    const parseResult = parseAgentSourceWithCommitments(agentSource);
-    // Apply DELETE filtering: remove prior commitments tagged by parameters targeted by DELETE/CANCEL/DISCARD/REMOVE
-    const filteredCommitments = [];
+function removeCommentsFromSystemMessage(systemMessage) {
+    if (!systemMessage) {
+        return systemMessage;
+    }
+    const lines = systemMessage.split('\n');
+    const filteredLines = lines.filter((line) => {
+        const trimmedLine = line.trim();
+        // Remove lines that start with # (comments)
+        return !trimmedLine.startsWith('#');
+    });
+    return filteredLines.join('\n').trim();
+}
+
+/**
+ * Creates agent model requirements using the new commitment system
+ * This function uses a reduce-like pattern where each commitment applies its changes
+ * to build the final requirements starting from a basic empty model
+ *
+ * @public exported from `@promptbook/core`
+ */
+async function createAgentModelRequirementsWithCommitments(agentSource, modelName) {
+    // Parse the agent source to extract commitments
+    const parseResult = parseAgentSourceWithCommitments(agentSource);
+    // Apply DELETE filtering: remove prior commitments tagged by parameters targeted by DELETE/CANCEL/DISCARD/REMOVE
+    const filteredCommitments = [];
     for (const commitment of parseResult.commitments) {
         // Handle DELETE-like commitments by invalidating prior tagged commitments
         if (commitment.type === 'DELETE' ||
@@ -15442,6 +15542,8 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
 /**
  * Normalizes a given text to camelCase format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text to be normalized.
  * @param _isFirstLetterCapital Whether the first letter should be capitalized.
  * @returns The camelCase formatted string.
@@ -15530,154 +15632,501 @@ function generatePlaceholderAgentProfileImageUrl(agentName) {
  */
 
 /**
- * Parses basic information from agent source
- *
- * There are 2 similar functions:
- * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
- * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ * Computes SHA-256 hash of the agent source
  *
  * @public exported from `@promptbook/core`
  */
-function parseAgentSource(agentSource) {
-    const parseResult = parseAgentSourceWithCommitments(agentSource);
-    // Find PERSONA and META commitments
-    let personaDescription = null;
-    for (const commitment of parseResult.commitments) {
-        if (commitment.type !== 'PERSONA') {
-            continue;
-        }
-        if (personaDescription === null) {
-            personaDescription = '';
-        }
-        else {
-            personaDescription += `\n\n${personaDescription}`;
+function computeAgentHash(agentSource) {
+    return SHA256(hexEncoder.parse(agentSource /* <- TODO: !!!!! spaceTrim */)).toString( /* hex */);
+}
+
+/**
+ * Function parseNumber will parse number from string
+ *
+ * Note: [🔂] This function is idempotent.
+ * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
+ * Note: it also works only with decimal numbers
+ *
+ * @returns parsed number
+ * @throws {ParseError} if the value is not a number
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function parseNumber(value) {
+    const originalValue = value;
+    if (typeof value === 'number') {
+        value = value.toString(); // <- TODO: Maybe more efficient way to do this
+    }
+    if (typeof value !== 'string') {
+        return 0;
+    }
+    value = value.trim();
+    if (value.startsWith('+')) {
+        return parseNumber(value.substring(1));
+    }
+    if (value.startsWith('-')) {
+        const number = parseNumber(value.substring(1));
+        if (number === 0) {
+            return 0; // <- Note: To prevent -0
         }
-        personaDescription += commitment.content;
+        return -number;
     }
-    const meta = {};
-    for (const commitment of parseResult.commitments) {
-        if (commitment.type !== 'META') {
-            continue;
+    value = value.replace(/,/g, '.');
+    value = value.toUpperCase();
+    if (value === '') {
+        return 0;
+    }
+    if (value === '♾' || value.startsWith('INF')) {
+        return Infinity;
+    }
+    if (value.includes('/')) {
+        const [numerator_, denominator_] = value.split('/');
+        const numerator = parseNumber(numerator_);
+        const denominator = parseNumber(denominator_);
+        if (denominator === 0) {
+            throw new ParseError(`Unable to parse number from "${originalValue}" because denominator is zero`);
         }
-        // Parse META commitments - format is "META TYPE content"
-        const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
-        const metaType = normalizeTo_camelCase(metaTypeRaw);
-        meta[metaType] = spaceTrim(commitment.content.substring(metaTypeRaw.length));
+        return numerator / denominator;
     }
-    // Generate gravatar fallback if no meta image specified
-    if (!meta.image) {
-        meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
+    if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
+        return 0;
     }
-    // Parse parameters using unified approach - both @Parameter and {parameter} notations
-    // are treated as the same syntax feature with unified representation
-    const parameters = parseParameters(agentSource);
-    return {
-        agentName: parseResult.agentName,
-        personaDescription,
-        meta,
-        parameters,
-    };
+    if (value.includes('E')) {
+        const [significand, exponent] = value.split('E');
+        return parseNumber(significand) * 10 ** parseNumber(exponent);
+    }
+    if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
+        throw new ParseError(`Unable to parse number from "${originalValue}"`);
+    }
+    const num = parseFloat(value);
+    if (isNaN(num)) {
+        throw new ParseError(`Unexpected NaN when parsing number from "${originalValue}"`);
+    }
+    return num;
 }
 /**
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+ * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
  */
 
 /**
- * Creates model requirements for an agent based on its source
+ * Makes first letter of a string lowercase
  *
- * There are 2 similar functions:
- * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
- * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
+ * Note: [🔂] This function is idempotent.
  *
- * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/utils`
  */
-async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools) {
-    // If availableModels are provided and no specific modelName is given,
-    // use preparePersona to select the best model
-    if (availableModels && !modelName && llmTools) {
-        const selectedModelName = await selectBestModelUsingPersona(agentSource, llmTools);
-        return createAgentModelRequirementsWithCommitments(agentSource, selectedModelName);
-    }
-    // Use the new commitment-based system with provided or default model
-    return createAgentModelRequirementsWithCommitments(agentSource, modelName);
+function decapitalize(word) {
+    return word.substring(0, 1).toLowerCase() + word.substring(1);
 }
+
 /**
- * Selects the best model using the preparePersona function
- * This directly uses preparePersona to ensure DRY principle
+ * Parses keywords from a string
  *
- * @param agentSource The agent source to derive persona description from
- * @param llmTools LLM tools for preparing persona
- * @returns The name of the best selected model
- * @private function of `createAgentModelRequirements`
+ * @param {string} input
+ * @returns {Set} of keywords without diacritics in lowercase
+ * @public exported from `@promptbook/utils`
  */
-async function selectBestModelUsingPersona(agentSource, llmTools) {
-    var _a;
-    // Parse agent source to get persona description
-    const { agentName, personaDescription } = parseAgentSource(agentSource);
-    // Use agent name as fallback if no persona description is available
-    const description = personaDescription || agentName || 'AI Agent';
-    try {
-        // Use preparePersona directly
-        const { modelsRequirements } = await preparePersona(description, { llm: llmTools }, { isVerbose: false });
-        // Extract the first model name from the requirements
-        if (modelsRequirements.length > 0 && ((_a = modelsRequirements[0]) === null || _a === void 0 ? void 0 : _a.modelName)) {
-            return modelsRequirements[0].modelName;
-        }
-        // Fallback: get available models and return the first CHAT model
-        const availableModels = await llmTools.listModels();
-        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
-        if (chatModels.length === 0) {
-            throw new Error('No CHAT models available for agent model selection');
-        }
-        return chatModels[0].modelName;
-    }
-    catch (error) {
-        console.warn('Failed to use preparePersona for model selection, falling back to first available model:', error);
-        // Fallback: get available models and return the first CHAT model
-        const availableModels = await llmTools.listModels();
-        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
-        if (chatModels.length === 0) {
-            throw new Error('No CHAT models available for agent model selection');
-        }
-        return chatModels[0].modelName;
-    }
+function parseKeywordsFromString(input) {
+    const keywords = normalizeTo_SCREAMING_CASE(removeDiacritics(input))
+        .toLowerCase()
+        .split(/[^a-z0-9]+/gs)
+        .filter((value) => value);
+    return new Set(keywords);
 }
+
 /**
- * Extracts MCP servers from agent source
+ * Converts a name string into a URI-compatible format.
  *
- * @param agentSource The agent source string that may contain MCP lines
- * @returns Array of MCP server identifiers
+ * @param name The string to be converted to a URI-compatible format.
+ * @returns A URI-compatible string derived from the input name.
+ * @example 'Hello World' -> 'hello-world'
+ * @public exported from `@promptbook/utils`
+ */
+function nameToUriPart(name) {
+    let uriPart = name;
+    uriPart = uriPart.toLowerCase();
+    uriPart = removeDiacritics(uriPart);
+    uriPart = uriPart.replace(/[^a-zA-Z0-9]+/g, '-');
+    uriPart = uriPart.replace(/^-+/, '');
+    uriPart = uriPart.replace(/-+$/, '');
+    return uriPart;
+}
+
+/**
+ * Converts a given name into URI-compatible parts.
  *
- * @private TODO: [🧠] Maybe should be public
+ * @param name The name to be converted into URI parts.
+ * @returns An array of URI-compatible parts derived from the name.
+ * @example 'Example Name' -> ['example', 'name']
+ * @public exported from `@promptbook/utils`
  */
-function extractMcpServers(agentSource) {
-    if (!agentSource) {
-        return [];
-    }
-    const lines = agentSource.split('\n');
-    const mcpRegex = /^\s*MCP\s+(.+)$/i;
-    const mcpServers = [];
-    // Look for MCP lines
-    for (const line of lines) {
-        const match = line.match(mcpRegex);
-        if (match && match[1]) {
-            mcpServers.push(match[1].trim());
-        }
-    }
-    return mcpServers;
+function nameToUriParts(name) {
+    return nameToUriPart(name)
+        .split('-')
+        .filter((value) => value !== '');
 }
 
 /**
- * Transpiler to Javascript code using OpenAI SDK.
+ * Normalizes a given text to PascalCase format.
  *
- * @public exported from `@promptbook/core`
+ * Note: [🔂] This function is idempotent.
+ *
+ * @param text @public exported from `@promptbook/utils`
+ * @returns
+ * @example 'HelloWorld'
+ * @example 'ILovePromptbook'
+ * @public exported from `@promptbook/utils`
  */
-const OpenAiSdkTranspiler = {
-    name: 'openai-sdk',
-    title: 'OpenAI SDK',
-    packageName: '@promptbook/core',
-    className: 'OpenAiSdkTranspiler',
-    async transpileBook(book, tools, options) {
+function normalizeTo_PascalCase(text) {
+    return normalizeTo_camelCase(text, true);
+}
+
+/**
+ * Take every whitespace (space, new line, tab) and replace it with a single space
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeWhitespaces(sentence) {
+    return sentence.replace(/\s+/gs, ' ').trim();
+}
+
+/**
+ * Removes quotes from a string
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: This is very useful for post-processing of the result of the LLM model
+ * Note: This function removes only the same quotes from the beginning and the end of the string
+ * Note: There are two similar functions:
+ * - `removeQuotes` which removes only bounding quotes
+ * - `unwrapResult` which removes whole introduce sentence
+ *
+ * @param text optionally quoted text
+ * @returns text without quotes
+ * @public exported from `@promptbook/utils`
+ */
+function removeQuotes(text) {
+    if (text.startsWith('"') && text.endsWith('"')) {
+        return text.slice(1, -1);
+    }
+    if (text.startsWith("'") && text.endsWith("'")) {
+        return text.slice(1, -1);
+    }
+    return text;
+}
+
+/**
+ * Removes quotes and optional introduce text from a string
+ *
+ * Tip: This is very useful for post-processing of the result of the LLM model
+ * Note: This function trims the text and removes whole introduce sentence if it is present
+ * Note: There are two similar functions:
+ * - `removeQuotes` which removes only bounding quotes
+ * - `unwrapResult` which removes whole introduce sentence
+ *
+ * @param text optionally quoted text
+ * @returns text without quotes
+ * @public exported from `@promptbook/utils`
+ */
+function unwrapResult(text, options) {
+    const { isTrimmed = true, isIntroduceSentenceRemoved = true } = options || {};
+    let trimmedText = text;
+    // Remove leading and trailing spaces and newlines
+    if (isTrimmed) {
+        trimmedText = spaceTrim$1(trimmedText);
+    }
+    let processedText = trimmedText;
+    if (isIntroduceSentenceRemoved) {
+        const introduceSentenceRegex = /^[a-zěščřžýáíéúů:\s]*:\s*/i;
+        if (introduceSentenceRegex.test(text)) {
+            // Remove the introduce sentence and quotes by replacing it with an empty string
+            processedText = processedText.replace(introduceSentenceRegex, '');
+        }
+        processedText = spaceTrim$1(processedText);
+    }
+    if (processedText.length < 3) {
+        return trimmedText;
+    }
+    if (processedText.includes('\n')) {
+        return trimmedText;
+    }
+    // Remove the quotes by extracting the substring without the first and last characters
+    const unquotedText = processedText.slice(1, -1);
+    // Check if the text starts and ends with quotes
+    if ([
+        ['"', '"'],
+        ["'", "'"],
+        ['`', '`'],
+        ['*', '*'],
+        ['_', '_'],
+        ['„', '“'],
+        ['«', '»'] /* <- QUOTES to config */,
+    ].some(([startQuote, endQuote]) => {
+        if (!processedText.startsWith(startQuote)) {
+            return false;
+        }
+        if (!processedText.endsWith(endQuote)) {
+            return false;
+        }
+        if (unquotedText.includes(startQuote) && !unquotedText.includes(endQuote)) {
+            return false;
+        }
+        if (!unquotedText.includes(startQuote) && unquotedText.includes(endQuote)) {
+            return false;
+        }
+        return true;
+    })) {
+        return unwrapResult(unquotedText, { isTrimmed: false, isIntroduceSentenceRemoved: false });
+    }
+    else {
+        return processedText;
+    }
+}
+/**
+ * TODO: [🧠] Should this also unwrap the (parenthesis)
+ */
+
+// <- TODO: Auto convert to type `import { ... } from 'type-fest';`
+/**
+ * Tests if the value is [🚉] serializable as JSON
+ *
+ * - Almost all primitives are serializable BUT:
+ * - `undefined` is not serializable
+ * - `NaN` is not serializable
+ * - Objects and arrays are serializable if all their properties are serializable
+ * - Functions are not serializable
+ * - Circular references are not serializable
+ * - `Date` objects are not serializable
+ * - `Map` and `Set` objects are not serializable
+ * - `RegExp` objects are not serializable
+ * - `Error` objects are not serializable
+ * - `Symbol` objects are not serializable
+ * - And much more...
+ *
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function isSerializableAsJson(value) {
+    try {
+        checkSerializableAsJson({ value });
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
+ * TODO: [🧠][💺] Can be done this on type-level?
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * Checks if the given value is a valid JavaScript identifier name.
+ *
+ * @param javascriptName The value to check for JavaScript identifier validity.
+ * @returns `true` if the value is a valid JavaScript name, false otherwise.
+ * @public exported from `@promptbook/utils`
+ */
+function isValidJavascriptName(javascriptName) {
+    if (typeof javascriptName !== 'string') {
+        return false;
+    }
+    return /^[a-zA-Z_$][0-9a-zA-Z_$]*$/i.test(javascriptName);
+}
+
+/**
+ * Normalizes agent name from arbitrary string to valid agent name
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/core`
+ */
+function normalizeAgentName(rawAgentName) {
+    return titleToName(spaceTrim(rawAgentName));
+}
+
+/**
+ * Creates temporary default agent name based on agent source hash
+ *
+ * @public exported from `@promptbook/core`
+ */
+function createDefaultAgentName(agentSource) {
+    const agentHash = computeAgentHash(agentSource);
+    return normalizeAgentName(`Agent ${agentHash.substring(0, 6)}`);
+}
+
+/**
+ * Parses basic information from agent source
+ *
+ * There are 2 similar functions:
+ * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ *
+ * @public exported from `@promptbook/core`
+ */
+function parseAgentSource(agentSource) {
+    const parseResult = parseAgentSourceWithCommitments(agentSource);
+    // Find PERSONA and META commitments
+    let personaDescription = null;
+    for (const commitment of parseResult.commitments) {
+        if (commitment.type !== 'PERSONA') {
+            continue;
+        }
+        if (personaDescription === null) {
+            personaDescription = '';
+        }
+        else {
+            personaDescription += `\n\n${personaDescription}`;
+        }
+        personaDescription += commitment.content;
+    }
+    const meta = {};
+    for (const commitment of parseResult.commitments) {
+        if (commitment.type !== 'META') {
+            continue;
+        }
+        // Parse META commitments - format is "META TYPE content"
+        const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
+        const metaType = normalizeTo_camelCase(metaTypeRaw);
+        meta[metaType] = spaceTrim(commitment.content.substring(metaTypeRaw.length));
+    }
+    // Generate gravatar fallback if no meta image specified
+    if (!meta.image) {
+        meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
+    }
+    // Parse parameters using unified approach - both @Parameter and {parameter} notations
+    // are treated as the same syntax feature with unified representation
+    const parameters = parseParameters(agentSource);
+    const agentHash = computeAgentHash(agentSource);
+    return {
+        agentName: normalizeAgentName(parseResult.agentName || createDefaultAgentName(agentSource)),
+        agentHash,
+        personaDescription,
+        meta,
+        parameters,
+    };
+}
+/**
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ */
+
+/**
+ * Creates model requirements for an agent based on its source
+ *
+ * There are 2 similar functions:
+ * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
+ *
+ * @public exported from `@promptbook/core`
+ */
+async function createAgentModelRequirements(agentSource, modelName, availableModels, llmTools) {
+    // If availableModels are provided and no specific modelName is given,
+    // use preparePersona to select the best model
+    if (availableModels && !modelName && llmTools) {
+        const selectedModelName = await selectBestModelUsingPersona(agentSource, llmTools);
+        return createAgentModelRequirementsWithCommitments(agentSource, selectedModelName);
+    }
+    // Use the new commitment-based system with provided or default model
+    return createAgentModelRequirementsWithCommitments(agentSource, modelName);
+}
+/**
+ * Selects the best model using the preparePersona function
+ * This directly uses preparePersona to ensure DRY principle
+ *
+ * @param agentSource The agent source to derive persona description from
+ * @param llmTools LLM tools for preparing persona
+ * @returns The name of the best selected model
+ * @private function of `createAgentModelRequirements`
+ */
+async function selectBestModelUsingPersona(agentSource, llmTools) {
+    var _a;
+    // Parse agent source to get persona description
+    const { agentName, personaDescription } = parseAgentSource(agentSource);
+    // Use agent name as fallback if no persona description is available
+    const description = personaDescription || agentName || 'AI Agent';
+    try {
+        // Use preparePersona directly
+        const { modelsRequirements } = await preparePersona(description, { llm: llmTools }, { isVerbose: false });
+        // Extract the first model name from the requirements
+        if (modelsRequirements.length > 0 && ((_a = modelsRequirements[0]) === null || _a === void 0 ? void 0 : _a.modelName)) {
+            return modelsRequirements[0].modelName;
+        }
+        // Fallback: get available models and return the first CHAT model
+        const availableModels = await llmTools.listModels();
+        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
+        if (chatModels.length === 0) {
+            throw new Error('No CHAT models available for agent model selection');
+        }
+        return chatModels[0].modelName;
+    }
+    catch (error) {
+        console.warn('Failed to use preparePersona for model selection, falling back to first available model:', error);
+        // Fallback: get available models and return the first CHAT model
+        const availableModels = await llmTools.listModels();
+        const chatModels = availableModels.filter(({ modelVariant }) => modelVariant === 'CHAT');
+        if (chatModels.length === 0) {
+            throw new Error('No CHAT models available for agent model selection');
+        }
+        return chatModels[0].modelName;
+    }
+}
+/**
+ * Extracts MCP servers from agent source
+ *
+ * @param agentSource The agent source string that may contain MCP lines
+ * @returns Array of MCP server identifiers
+ *
+ * @private TODO: [🧠] Maybe should be public
+ */
+function extractMcpServers(agentSource) {
+    if (!agentSource) {
+        return [];
+    }
+    const lines = agentSource.split('\n');
+    const mcpRegex = /^\s*MCP\s+(.+)$/i;
+    const mcpServers = [];
+    // Look for MCP lines
+    for (const line of lines) {
+        const match = line.match(mcpRegex);
+        if (match && match[1]) {
+            mcpServers.push(match[1].trim());
+        }
+    }
+    return mcpServers;
+}
+
+/**
+ * Transpiler to Javascript code using OpenAI SDK.
+ *
+ * @public exported from `@promptbook/core`
+ */
+const OpenAiSdkTranspiler = {
+    name: 'openai-sdk',
+    title: 'OpenAI SDK',
+    packageName: '@promptbook/core',
+    className: 'OpenAiSdkTranspiler',
+    async transpileBook(book, tools, options) {
         const { agentName } = await parseAgentSource(book);
         const modelRequirements = await createAgentModelRequirements(book);
         const { commitments } = parseAgentSourceWithCommitments(book);
@@ -15792,7 +16241,7 @@ const OpenAiSdkTranspiler = {
                         });
 
                         const answer = response.choices[0].message.content;
-                        console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                        console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                         chatHistory.push({ role: 'assistant', content: answer });
                         promptUser();
@@ -15811,7 +16260,7 @@ const OpenAiSdkTranspiler = {
 
                     (async () => {
                         await setupKnowledge();
-                        console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                        console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                         promptUser();
                     })();
                 `);
@@ -15858,7 +16307,7 @@ const OpenAiSdkTranspiler = {
                     });
 
                     const answer = response.choices[0].message.content;
-                    console.log('\\n🧠 ${agentName}:', answer, '\\n');
+                    console.log('\\n🧠 ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */}:', answer, '\\n');
 
                     chatHistory.push({ role: 'assistant', content: answer });
                     promptUser();
@@ -15875,7 +16324,7 @@ const OpenAiSdkTranspiler = {
                     });
                 }
 
-                console.log("🤖 Chat with ${agentName} (type 'exit' to quit)\\n");
+                console.log("🤖 Chat with ${agentName /* <- TODO: [🕛] There should be `agentFullname` not `agentName` */} (type 'exit' to quit)\\n");
                 promptUser();
 
             `);
@@ -15891,7 +16340,7 @@ const OpenAiSdkTranspiler = {
  * @public exported from `@promptbook/wizard`
  * @public exported from `@promptbook/cli`
  *
- * TODO: !!!! Which package should export this?
+ * TODO: [🧠] Which package should export this?
  */
 const _OpenAiSdkTranspilerRegistration = $bookTranspilersRegister.register(OpenAiSdkTranspiler);
 /**
@@ -16164,25 +16613,6 @@ function promptbookTokenToIdentification(promptbookToken) {
     return identification;
 }
 
-/**
- * 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
- */
-
 /**
  * Path to the `.env` file which was used to configure LLM tools
  *
@@ -16448,41 +16878,7 @@ class $EnvStorage {
     }
 }
 /**
- * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
- */
-
-// <- TODO: Auto convert to type `import { ... } from 'type-fest';`
-/**
- * Tests if the value is [🚉] serializable as JSON
- *
- * - Almost all primitives are serializable BUT:
- * - `undefined` is not serializable
- * - `NaN` is not serializable
- * - Objects and arrays are serializable if all their properties are serializable
- * - Functions are not serializable
- * - Circular references are not serializable
- * - `Date` objects are not serializable
- * - `Map` and `Set` objects are not serializable
- * - `RegExp` objects are not serializable
- * - `Error` objects are not serializable
- * - `Symbol` objects are not serializable
- * - And much more...
- *
- *
- * @public exported from `@promptbook/utils`
- */
-function isSerializableAsJson(value) {
-    try {
-        checkSerializableAsJson({ value });
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-/**
- * TODO: [🧠][main] !!3 In-memory cache of same values to prevent multiple checks
- * TODO: [🧠][💺] Can be done this on type-level?
+ * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
  */
 
 /**
@@ -16760,582 +17156,323 @@ function cacheLlmTools(llmTools, options = {}) {
                 });
                 shouldCache = validationResult.isValid;
                 if (!shouldCache && isVerbose) {
-                    console.info('Not caching result that fails expectations/format validation for key:', key, {
-                        content: promptResult.content,
-                        expectations: prompt.expectations,
-                        format: prompt.format,
-                        validationError: (_a = validationResult.error) === null || _a === void 0 ? void 0 : _a.message,
-                    });
-                }
-            }
-            catch (error) {
-                // If validation throws an unexpected error, don't cache
-                shouldCache = false;
-                if (isVerbose) {
-                    console.info('Not caching result due to validation error for key:', key, {
-                        content: promptResult.content,
-                        validationError: error instanceof Error ? error.message : String(error),
-                    });
-                }
-            }
-        }
-        if (shouldCache) {
-            await storage.setItem(key, {
-                date: $getCurrentDate(),
-                promptbookVersion: PROMPTBOOK_ENGINE_VERSION,
-                bookVersion: BOOK_LANGUAGE_VERSION,
-                prompt: {
-                    ...prompt,
-                    parameters: Object.entries(parameters).length === Object.entries(relevantParameters).length
-                        ? parameters
-                        : {
-                            ...relevantParameters,
-                            note: `<- Note: Only relevant parameters are stored in the cache`,
-                        },
-                },
-                promptResult,
-            });
-        }
-        else if (isVerbose && isBasicFailedResult) {
-            console.info('Not caching failed result for key:', key, {
-                content: promptResult.content,
-                error: promptResult.error,
-                success: promptResult.success,
-            });
-        }
-        return promptResult;
-    };
-    if (llmTools.callChatModel !== undefined) {
-        proxyTools.callChatModel = async (prompt) => {
-            return /* not await */ callCommonModel(prompt);
-        };
-    }
-    if (llmTools.callCompletionModel !== undefined) {
-        proxyTools.callCompletionModel = async (prompt) => {
-            return /* not await */ callCommonModel(prompt);
-        };
-    }
-    if (llmTools.callEmbeddingModel !== undefined) {
-        proxyTools.callEmbeddingModel = async (prompt) => {
-            return /* not await */ callCommonModel(prompt);
-        };
-    }
-    // <- 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: [👷‍♂️] Comprehensive manual about construction of llmTools
- *            Detailed explanation about caching strategies and appropriate storage selection for different use cases
- *            Examples of how to combine multiple interceptors for advanced caching, logging, and usage tracking
- */
-
-/**
- * Provides LLM tools configuration by reading environment variables.
- *
- * 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`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
- * - ...
- *
- * @see Environment variables documentation or .env file for required variables.
- * @returns A promise that resolves to the LLM tools configuration, or null if configuration is incomplete or missing.
- * @public exported from `@promptbook/node`
- */
-async function $provideLlmToolsConfigurationFromEnv() {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
-    }
-    const envFilepath = await $provideEnvFilename();
-    if (envFilepath !== null) {
-        dotenv.config({ path: envFilepath });
-    }
-    const llmToolsConfiguration = $llmToolsMetadataRegister
-        .list()
-        .map((metadata) => metadata.createConfigurationFromEnv(process.env))
-        .filter((configuration) => configuration !== null);
-    return llmToolsConfiguration;
-}
-/**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */
-
-/**
- * Creates LLM execution tools from provided configuration objects
- *
- * Instantiates and configures LLM tool instances for each configuration entry,
- * combining them into a unified interface via MultipleLlmExecutionTools.
- *
- * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
- *
- * @param configuration Array of LLM tool configurations to instantiate
- * @param options Additional options for configuring the LLM tools
- * @returns A unified interface combining all successfully instantiated LLM tools
- * @public exported from `@promptbook/core`
- */
-function createLlmToolsFromConfiguration(configuration, options = {}) {
-    const { title = 'LLM Tools from Configuration', isVerbose = DEFAULT_IS_VERBOSE, userId } = options;
-    const llmTools = configuration.map((llmConfiguration) => {
-        const registeredItem = $llmToolsRegister
-            .list()
-            .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
-        if (registeredItem === undefined) {
-            // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
-            throw new Error(spaceTrim((block) => `
-                        There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
-                        Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
-
-                        You have probably forgotten install and import the provider package.
-                        To fix this issue, you can:
-
-                        Install:
-
-                        > npm install ${llmConfiguration.packageName}
-
-                        And import:
-
-                        > import '${llmConfiguration.packageName}';
-
-
-                        ${block($registeredLlmToolsMessage())}
-                    `));
-        }
-        return registeredItem({
-            isVerbose,
-            userId,
-            ...llmConfiguration.options,
-        });
-    });
-    return joinLlmExecutionTools(title, ...llmTools);
-}
-/**
- * TODO: [🎌] Together with `createLlmToolsFromConfiguration` + 'EXECUTION_TOOLS_CLASSES' gets to `@promptbook/core` ALL model providers, make this more efficient
- * TODO: [🧠][🎌] Dynamically install required providers
- * TODO: We should implement an interactive configuration wizard that would:
- *       1. Detect which LLM providers are available in the environment
- *       2. Guide users through required configuration settings for each provider
- *       3. Allow testing connections before completing setup
- *       4. Generate appropriate configuration code for application integration
- * TODO: [🧠][🍛] Which name is better `createLlmToolsFromConfig` or `createLlmToolsFromConfiguration`?
- * TODO: [🧠] Is there some meaningfull way how to test this util
- * TODO: This should be maybe not under `_common` but under `utils`
- * TODO: [®] DRY Register logic
- */
-
-/**
- * Automatically configures LLM tools from environment variables in Node.js
- *
- * This utility function detects available LLM providers based on environment variables
- * and creates properly configured LLM execution tools for each detected provider.
- *
- * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
- *
- * Supports environment variables from .env files when dotenv is configured
- * 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`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
- * - ...
- *
- * @param options Configuration options for the LLM tools
- * @returns A unified interface containing all detected and configured LLM tools
- * @public exported from `@promptbook/node`
- */
-async function $provideLlmToolsFromEnv(options = {}) {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
-    }
-    const configuration = await $provideLlmToolsConfigurationFromEnv();
-    if (configuration.length === 0) {
-        if ($llmToolsMetadataRegister.list().length === 0) {
-            throw new UnexpectedError(spaceTrim((block) => `
-                        No LLM tools registered, this is probably a bug in the Promptbook library
-
-                        ${block($registeredLlmToolsMessage())}}
-                    `));
-        }
-        // TODO: [🥃]
-        throw new Error(spaceTrim((block) => `
-                    No LLM tools found in the environment
-
-                    ${block($registeredLlmToolsMessage())}}
-                `));
-    }
-    return createLlmToolsFromConfiguration(configuration, options);
-}
-/**
- * TODO: The architecture for LLM tools configuration consists of three key functions:
- * 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
- * 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
- * 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
- *
- * This layered approach allows flexibility in how tools are configured:
- * - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
- * - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
- * - Use createLlmToolsFromConfiguration for explicit control over tool configurations
- *
- * TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
- * TODO: [🧠] Is there some meaningfull way how to test this util
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [🥃] Allow `ptbk make` without llm tools
- * TODO: This should be maybe not under `_common` but under `utils`
- * TODO: [®] DRY Register logic
- */
-
-/**
- * Returns LLM tools for CLI
- *
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file and also writes this .env file
- *
- * @private within the repository - for CLI utils
- */
-async function $provideLlmToolsForWizardOrCli(options) {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizardOrCli` works only in Node.js environment');
-    }
-    options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
-    const { isLoginloaded, strategy, isCacheReloaded } = options;
-    let llmExecutionTools;
-    if (strategy === 'REMOTE_SERVER') {
-        const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
-        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();
-            // 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);
+                    console.info('Not caching result that fails expectations/format validation for key:', key, {
+                        content: promptResult.content,
+                        expectations: prompt.expectations,
+                        format: prompt.format,
+                        validationError: (_a = validationResult.error) === null || _a === void 0 ? void 0 : _a.message,
+                    });
+                }
+            }
+            catch (error) {
+                // If validation throws an unexpected error, don't cache
+                shouldCache = false;
+                if (isVerbose) {
+                    console.info('Not caching result due to validation error for key:', key, {
+                        content: promptResult.content,
+                        validationError: error instanceof Error ? error.message : String(error),
+                    });
+                }
             }
         }
-        else {
-            identification = promptbookTokenToIdentification(promptbookToken);
+        if (shouldCache) {
+            await storage.setItem(key, {
+                date: $getCurrentDate(),
+                promptbookVersion: PROMPTBOOK_ENGINE_VERSION,
+                bookVersion: BOOK_LANGUAGE_VERSION,
+                prompt: {
+                    ...prompt,
+                    parameters: Object.entries(parameters).length === Object.entries(relevantParameters).length
+                        ? parameters
+                        : {
+                            ...relevantParameters,
+                            note: `<- Note: Only relevant parameters are stored in the cache`,
+                        },
+                },
+                promptResult,
+            });
         }
-        llmExecutionTools = new RemoteLlmExecutionTools({
-            remoteServerUrl,
-            identification,
-        });
+        else if (isVerbose && isBasicFailedResult) {
+            console.info('Not caching failed result for key:', key, {
+                content: promptResult.content,
+                error: promptResult.error,
+                success: promptResult.success,
+            });
+        }
+        return promptResult;
+    };
+    if (llmTools.callChatModel !== undefined) {
+        proxyTools.callChatModel = async (prompt) => {
+            return /* not await */ callCommonModel(prompt);
+        };
     }
-    else if (strategy === 'BRING_YOUR_OWN_KEYS') {
-        llmExecutionTools = await $provideLlmToolsFromEnv({
-            title: 'LLM Tools for wizard or CLI with BYOK strategy',
-        });
+    if (llmTools.callCompletionModel !== undefined) {
+        proxyTools.callCompletionModel = async (prompt) => {
+            return /* not await */ callCommonModel(prompt);
+        };
     }
-    else {
-        throw new UnexpectedError(`\`$provideLlmToolsForWizardOrCli\` wrong strategy "${strategy}"`);
+    if (llmTools.callEmbeddingModel !== undefined) {
+        proxyTools.callEmbeddingModel = async (prompt) => {
+            return /* not await */ callCommonModel(prompt);
+        };
     }
-    return cacheLlmTools(countUsage(
-    //        <- TODO: [🌯] We dont use countUsage at all, maybe just unwrap it
-    //        <- Note: for example here we don`t want the [🌯]
-    llmExecutionTools), {
-        storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
-            rootFolderPath: join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
-        }),
-        isCacheReloaded,
-    });
+    // <- Note: [🤖]
+    return proxyTools;
 }
 /**
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
- * TODO: [🥃] Allow `ptbk make` without llm tools
- * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
- * TODO: [®] DRY Register logic
+ * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [👷‍♂️] Comprehensive manual about construction of llmTools
+ *            Detailed explanation about caching strategies and appropriate storage selection for different use cases
+ *            Examples of how to combine multiple interceptors for advanced caching, logging, and usage tracking
  */
 
 /**
- * Provides a collection of scrapers optimized for Node.js environment.
- * 1) `provideScrapersForNode` use as default
- * 2) `provideScrapersForBrowser` use in limited browser environment *
+ * Provides LLM tools configuration by reading environment variables.
+ *
+ * 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`
+ * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
+ *
+ * @see Environment variables documentation or .env file for required variables.
+ * @returns A promise that resolves to the LLM tools configuration, or null if configuration is incomplete or missing.
  * @public exported from `@promptbook/node`
  */
-async function $provideScrapersForNode(tools, options) {
+async function $provideLlmToolsConfigurationFromEnv() {
     if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$getScrapersForNode` works only in Node.js environment');
+        throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
     }
-    // TODO: [🔱] Do here auto-installation + auto-include of missing scrapers - use all from $scrapersMetadataRegister.list()
-    // TODO: [🔱][🧠] What is the best strategy for auto-install - install them all?
-    const scrapers = [];
-    for (const scraperFactory of $scrapersRegister.list()) {
-        const scraper = await scraperFactory(tools, options || {});
-        if (scraper.metadata.packageName === '@promptbook/boilerplate' ||
-            scraper.metadata.mimeTypes.some((mimeType) => mimeType.includes('DISABLED'))) {
-            continue;
-        }
-        scrapers.push(scraper);
+    const envFilepath = await $provideEnvFilename();
+    if (envFilepath !== null) {
+        dotenv.config({ path: envFilepath });
     }
-    return scrapers;
+    const llmToolsConfiguration = $llmToolsMetadataRegister
+        .list()
+        .map((metadata) => metadata.createConfigurationFromEnv(process.env))
+        .filter((configuration) => configuration !== null);
+    return llmToolsConfiguration;
 }
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */
 
 /**
- * Function parseNumber will parse number from string
+ * Creates LLM execution tools from provided configuration objects
  *
- * Note: [🔂] This function is idempotent.
- * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
- * Note: it also works only with decimal numbers
+ * Instantiates and configures LLM tool instances for each configuration entry,
+ * combining them into a unified interface via MultipleLlmExecutionTools.
  *
- * @returns parsed number
- * @throws {ParseError} if the value is not a number
+ * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
  *
- * @public exported from `@promptbook/utils`
- */
-function parseNumber(value) {
-    const originalValue = value;
-    if (typeof value === 'number') {
-        value = value.toString(); // <- TODO: Maybe more efficient way to do this
-    }
-    if (typeof value !== 'string') {
-        return 0;
-    }
-    value = value.trim();
-    if (value.startsWith('+')) {
-        return parseNumber(value.substring(1));
-    }
-    if (value.startsWith('-')) {
-        const number = parseNumber(value.substring(1));
-        if (number === 0) {
-            return 0; // <- Note: To prevent -0
-        }
-        return -number;
-    }
-    value = value.replace(/,/g, '.');
-    value = value.toUpperCase();
-    if (value === '') {
-        return 0;
-    }
-    if (value === '♾' || value.startsWith('INF')) {
-        return Infinity;
-    }
-    if (value.includes('/')) {
-        const [numerator_, denominator_] = value.split('/');
-        const numerator = parseNumber(numerator_);
-        const denominator = parseNumber(denominator_);
-        if (denominator === 0) {
-            throw new ParseError(`Unable to parse number from "${originalValue}" because denominator is zero`);
-        }
-        return numerator / denominator;
-    }
-    if (/^(NAN|NULL|NONE|UNDEFINED|ZERO|NO.*)$/.test(value)) {
-        return 0;
-    }
-    if (value.includes('E')) {
-        const [significand, exponent] = value.split('E');
-        return parseNumber(significand) * 10 ** parseNumber(exponent);
-    }
-    if (!/^[0-9.]+$/.test(value) || value.split('.').length > 2) {
-        throw new ParseError(`Unable to parse number from "${originalValue}"`);
-    }
-    const num = parseFloat(value);
-    if (isNaN(num)) {
-        throw new ParseError(`Unexpected NaN when parsing number from "${originalValue}"`);
-    }
-    return num;
-}
-/**
- * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
- * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
+ * @param configuration Array of LLM tool configurations to instantiate
+ * @param options Additional options for configuring the LLM tools
+ * @returns A unified interface combining all successfully instantiated LLM tools
+ * @public exported from `@promptbook/core`
  */
+function createLlmToolsFromConfiguration(configuration, options = {}) {
+    const { title = 'LLM Tools from Configuration', isVerbose = DEFAULT_IS_VERBOSE, userId } = options;
+    const llmTools = configuration.map((llmConfiguration) => {
+        const registeredItem = $llmToolsRegister
+            .list()
+            .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
+        if (registeredItem === undefined) {
+            // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
+            throw new Error(spaceTrim((block) => `
+                        There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
+                        Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
 
-/**
- * Makes first letter of a string lowercase
- *
- * Note: [🔂] This function is idempotent.
- *
- * @public exported from `@promptbook/utils`
- */
-function decapitalize(word) {
-    return word.substring(0, 1).toLowerCase() + word.substring(1);
-}
+                        You have probably forgotten install and import the provider package.
+                        To fix this issue, you can:
 
-/**
- * Parses keywords from a string
- *
- * @param {string} input
- * @returns {Set} of keywords without diacritics in lowercase
- * @public exported from `@promptbook/utils`
- */
-function parseKeywordsFromString(input) {
-    const keywords = normalizeTo_SCREAMING_CASE(removeDiacritics(input))
-        .toLowerCase()
-        .split(/[^a-z0-9]+/gs)
-        .filter((value) => value);
-    return new Set(keywords);
-}
+                        Install:
+
+                        > npm install ${llmConfiguration.packageName}
+
+                        And import:
+
+                        > import '${llmConfiguration.packageName}';
 
-/**
- * Converts a name string into a URI-compatible format.
- *
- * @param name The string to be converted to a URI-compatible format.
- * @returns A URI-compatible string derived from the input name.
- * @example 'Hello World' -> 'hello-world'
- * @public exported from `@promptbook/utils`
- */
-function nameToUriPart(name) {
-    let uriPart = name;
-    uriPart = uriPart.toLowerCase();
-    uriPart = removeDiacritics(uriPart);
-    uriPart = uriPart.replace(/[^a-zA-Z0-9]+/g, '-');
-    uriPart = uriPart.replace(/^-+/, '');
-    uriPart = uriPart.replace(/-+$/, '');
-    return uriPart;
-}
 
-/**
- * Converts a given name into URI-compatible parts.
- *
- * @param name The name to be converted into URI parts.
- * @returns An array of URI-compatible parts derived from the name.
- * @example 'Example Name' -> ['example', 'name']
- * @public exported from `@promptbook/utils`
- */
-function nameToUriParts(name) {
-    return nameToUriPart(name)
-        .split('-')
-        .filter((value) => value !== '');
+                        ${block($registeredLlmToolsMessage())}
+                    `));
+        }
+        return registeredItem({
+            isVerbose,
+            userId,
+            ...llmConfiguration.options,
+        });
+    });
+    return joinLlmExecutionTools(title, ...llmTools);
 }
-
 /**
- *
- * @param text @public exported from `@promptbook/utils`
- * @returns
- * @example 'HelloWorld'
- * @example 'ILovePromptbook'
- * @public exported from `@promptbook/utils`
+ * TODO: [🎌] Together with `createLlmToolsFromConfiguration` + 'EXECUTION_TOOLS_CLASSES' gets to `@promptbook/core` ALL model providers, make this more efficient
+ * TODO: [🧠][🎌] Dynamically install required providers
+ * TODO: We should implement an interactive configuration wizard that would:
+ *       1. Detect which LLM providers are available in the environment
+ *       2. Guide users through required configuration settings for each provider
+ *       3. Allow testing connections before completing setup
+ *       4. Generate appropriate configuration code for application integration
+ * TODO: [🧠][🍛] Which name is better `createLlmToolsFromConfig` or `createLlmToolsFromConfiguration`?
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: This should be maybe not under `_common` but under `utils`
+ * TODO: [®] DRY Register logic
  */
-function normalizeTo_PascalCase(text) {
-    return normalizeTo_camelCase(text, true);
-}
 
 /**
- * Take every whitespace (space, new line, tab) and replace it with a single space
+ * Automatically configures LLM tools from environment variables in Node.js
  *
- * Note: [🔂] This function is idempotent.
+ * This utility function detects available LLM providers based on environment variables
+ * and creates properly configured LLM execution tools for each detected provider.
  *
- * @public exported from `@promptbook/utils`
- */
-function normalizeWhitespaces(sentence) {
-    return sentence.replace(/\s+/gs, ' ').trim();
-}
-
-/**
- * Removes quotes from a string
+ * Note: This function is not cached, every call creates new instance of `MultipleLlmExecutionTools`
  *
- * Note: [🔂] This function is idempotent.
- * Tip: This is very useful for post-processing of the result of the LLM model
- * Note: This function removes only the same quotes from the beginning and the end of the string
- * Note: There are two similar functions:
- * - `removeQuotes` which removes only bounding quotes
- * - `unwrapResult` which removes whole introduce sentence
+ * Supports environment variables from .env files when dotenv is configured
+ * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
  *
- * @param text optionally quoted text
- * @returns text without quotes
- * @public exported from `@promptbook/utils`
+ * It looks for environment variables:
+ * - `process.env.OPENAI_API_KEY`
+ * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - ...
+ *
+ * @param options Configuration options for the LLM tools
+ * @returns A unified interface containing all detected and configured LLM tools
+ * @public exported from `@promptbook/node`
  */
-function removeQuotes(text) {
-    if (text.startsWith('"') && text.endsWith('"')) {
-        return text.slice(1, -1);
+async function $provideLlmToolsFromEnv(options = {}) {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$provideLlmToolsFromEnv` works only in Node.js environment');
     }
-    if (text.startsWith("'") && text.endsWith("'")) {
-        return text.slice(1, -1);
+    const configuration = await $provideLlmToolsConfigurationFromEnv();
+    if (configuration.length === 0) {
+        if ($llmToolsMetadataRegister.list().length === 0) {
+            throw new UnexpectedError(spaceTrim((block) => `
+                        No LLM tools registered, this is probably a bug in the Promptbook library
+
+                        ${block($registeredLlmToolsMessage())}}
+                    `));
+        }
+        // TODO: [🥃]
+        throw new Error(spaceTrim((block) => `
+                    No LLM tools found in the environment
+
+                    ${block($registeredLlmToolsMessage())}}
+                `));
     }
-    return text;
+    return createLlmToolsFromConfiguration(configuration, options);
 }
+/**
+ * TODO: The architecture for LLM tools configuration consists of three key functions:
+ * 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
+ * 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
+ * 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
+ *
+ * This layered approach allows flexibility in how tools are configured:
+ * - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
+ * - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
+ * - Use createLlmToolsFromConfiguration for explicit control over tool configurations
+ *
+ * TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
+ * TODO: [🧠] Is there some meaningfull way how to test this util
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🥃] Allow `ptbk make` without llm tools
+ * TODO: This should be maybe not under `_common` but under `utils`
+ * TODO: [®] DRY Register logic
+ */
 
 /**
- * Removes quotes and optional introduce text from a string
+ * Returns LLM tools for CLI
  *
- * Tip: This is very useful for post-processing of the result of the LLM model
- * Note: This function trims the text and removes whole introduce sentence if it is present
- * Note: There are two similar functions:
- * - `removeQuotes` which removes only bounding quotes
- * - `unwrapResult` which removes whole introduce sentence
+ * 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
  *
- * @param text optionally quoted text
- * @returns text without quotes
- * @public exported from `@promptbook/utils`
+ * @private within the repository - for CLI utils
  */
-function unwrapResult(text, options) {
-    const { isTrimmed = true, isIntroduceSentenceRemoved = true } = options || {};
-    let trimmedText = text;
-    // Remove leading and trailing spaces and newlines
-    if (isTrimmed) {
-        trimmedText = spaceTrim$1(trimmedText);
-    }
-    let processedText = trimmedText;
-    if (isIntroduceSentenceRemoved) {
-        const introduceSentenceRegex = /^[a-zěščřžýáíéúů:\s]*:\s*/i;
-        if (introduceSentenceRegex.test(text)) {
-            // Remove the introduce sentence and quotes by replacing it with an empty string
-            processedText = processedText.replace(introduceSentenceRegex, '');
-        }
-        processedText = spaceTrim$1(processedText);
-    }
-    if (processedText.length < 3) {
-        return trimmedText;
-    }
-    if (processedText.includes('\n')) {
-        return trimmedText;
+async function $provideLlmToolsForWizardOrCli(options) {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizardOrCli` works only in Node.js environment');
     }
-    // Remove the quotes by extracting the substring without the first and last characters
-    const unquotedText = processedText.slice(1, -1);
-    // Check if the text starts and ends with quotes
-    if ([
-        ['"', '"'],
-        ["'", "'"],
-        ['`', '`'],
-        ['*', '*'],
-        ['_', '_'],
-        ['„', '“'],
-        ['«', '»'] /* <- QUOTES to config */,
-    ].some(([startQuote, endQuote]) => {
-        if (!processedText.startsWith(startQuote)) {
-            return false;
-        }
-        if (!processedText.endsWith(endQuote)) {
-            return false;
+    options = options !== null && options !== void 0 ? options : { strategy: 'BRING_YOUR_OWN_KEYS' };
+    const { isLoginloaded, strategy, isCacheReloaded } = options;
+    let llmExecutionTools;
+    if (strategy === 'REMOTE_SERVER') {
+        const { remoteServerUrl = DEFAULT_REMOTE_SERVER_URL, loginPrompt } = options;
+        const storage = new $EnvStorage();
+        let key = `PROMPTBOOK_TOKEN`;
+        if (remoteServerUrl !== DEFAULT_REMOTE_SERVER_URL) {
+            key = `${key}_${remoteServerUrl.replace(/^https?:\/\//i, '')}`;
         }
-        if (unquotedText.includes(startQuote) && !unquotedText.includes(endQuote)) {
-            return false;
+        let identification = null;
+        let promptbookToken = await storage.getItem(key);
+        if (promptbookToken === null || isLoginloaded) {
+            identification = await loginPrompt();
+            // 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);
+            }
         }
-        if (!unquotedText.includes(startQuote) && unquotedText.includes(endQuote)) {
-            return false;
+        else {
+            identification = promptbookTokenToIdentification(promptbookToken);
         }
-        return true;
-    })) {
-        return unwrapResult(unquotedText, { isTrimmed: false, isIntroduceSentenceRemoved: false });
+        llmExecutionTools = new RemoteLlmExecutionTools({
+            remoteServerUrl,
+            identification,
+        });
+    }
+    else if (strategy === 'BRING_YOUR_OWN_KEYS') {
+        llmExecutionTools = await $provideLlmToolsFromEnv({
+            title: 'LLM Tools for wizard or CLI with BYOK strategy',
+        });
     }
     else {
-        return processedText;
+        throw new UnexpectedError(`\`$provideLlmToolsForWizardOrCli\` 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 [🌯]
+    llmExecutionTools), {
+        storage: new FileCacheStorage({ fs: $provideFilesystemForNode() }, {
+            rootFolderPath: join(process.cwd(), DEFAULT_EXECUTION_CACHE_DIRNAME),
+        }),
+        isCacheReloaded,
+    });
 }
 /**
- * TODO: [🧠] Should this also unwrap the (parenthesis)
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ * TODO: [🥃] Allow `ptbk make` without llm tools
+ * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
+ * TODO: [®] DRY Register logic
  */
 
 /**
- * Checks if the given value is a valid JavaScript identifier name.
- *
- * @param javascriptName The value to check for JavaScript identifier validity.
- * @returns `true` if the value is a valid JavaScript name, false otherwise.
- * @public exported from `@promptbook/utils`
+ * Provides a collection of scrapers optimized for Node.js environment.
+ * 1) `provideScrapersForNode` use as default
+ * 2) `provideScrapersForBrowser` use in limited browser environment *
+ * @public exported from `@promptbook/node`
  */
-function isValidJavascriptName(javascriptName) {
-    if (typeof javascriptName !== 'string') {
-        return false;
+async function $provideScrapersForNode(tools, options) {
+    if (!$isRunningInNode()) {
+        throw new EnvironmentMismatchError('Function `$getScrapersForNode` works only in Node.js environment');
     }
-    return /^[a-zA-Z_$][0-9a-zA-Z_$]*$/i.test(javascriptName);
+    // TODO: [🔱] Do here auto-installation + auto-include of missing scrapers - use all from $scrapersMetadataRegister.list()
+    // TODO: [🔱][🧠] What is the best strategy for auto-install - install them all?
+    const scrapers = [];
+    for (const scraperFactory of $scrapersRegister.list()) {
+        const scraper = await scraperFactory(tools, options || {});
+        if (scraper.metadata.packageName === '@promptbook/boilerplate' ||
+            scraper.metadata.mimeTypes.some((mimeType) => mimeType.includes('DISABLED'))) {
+            continue;
+        }
+        scrapers.push(scraper);
+    }
+    return scrapers;
 }
+/**
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
 
 /**
  * Extracts exactly ONE code block from markdown.