@promptbook/components 0.103.0-55 → 0.103.0-56

package/umd/index.umd.js

@@ -1,12 +1,12 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react/jsx-runtime'), require('react'), require('spacetrim'), require('crypto-js'), require('crypto-js/enc-hex'), require('path'), require('crypto'), require('react-dom'), require('@monaco-editor/react'), require('destroyable'), require('highlight.js'), require('katex'), require('showdown'), require('rxjs'), require('waitasecond'), require('crypto-js/sha256'), require('mime-types'), require('papaparse'), require('colors'), require('bottleneck'), require('openai'), require('qrcode')) :
     typeof define === 'function' && define.amd ? define(['exports', 'react/jsx-runtime', 'react', 'spacetrim', 'crypto-js', 'crypto-js/enc-hex', 'path', 'crypto', 'react-dom', '@monaco-editor/react', 'destroyable', 'highlight.js', 'katex', 'showdown', 'rxjs', 'waitasecond', 'crypto-js/sha256', 'mime-types', 'papaparse', 'colors', 'bottleneck', 'openai', 'qrcode'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim, global.cryptoJs, global.hexEncoder, global.path, global.crypto, global.reactDom, global.Editor, global.destroyable, global.hljs, global.katex, global.showdown, global.rxjs, global.waitasecond, global.sha256, global.mimeTypes, global.papaparse, global.colors, global.Bottleneck, global.OpenAI, global.QRCode));
-})(this, (function (exports, jsxRuntime, react, spaceTrim, cryptoJs, hexEncoder, path, crypto, reactDom, Editor, destroyable, hljs, katex, showdown, rxjs, waitasecond, sha256, mimeTypes, papaparse, colors, Bottleneck, OpenAI, QRCode) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim$1, global.cryptoJs, global.hexEncoder, global.path, global.crypto, global.reactDom, global.Editor, global.destroyable, global.hljs, global.katex, global.showdown, global.rxjs, global.waitasecond, global.sha256, global.mimeTypes, global.papaparse, global.colors, global.Bottleneck, global.OpenAI, global.QRCode));
+})(this, (function (exports, jsxRuntime, react, spaceTrim$1, cryptoJs, hexEncoder, path, crypto, reactDom, Editor, destroyable, hljs, katex, showdown, rxjs, waitasecond, sha256, mimeTypes, papaparse, colors, Bottleneck, OpenAI, QRCode) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var Editor__default = /*#__PURE__*/_interopDefaultLegacy(Editor);
     var hljs__default = /*#__PURE__*/_interopDefaultLegacy(hljs);
@@ -31,7 +31,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-55';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-56';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -243,6 +243,17 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Trims string from all 4 sides
+     *
+     * Note: This is a re-exported function from the `spacetrim` package which is
+     *       Developed by same author @hejny as this package
+     *
+     * @public exported from `@promptbook/utils`
+     * @see https://github.com/hejny/spacetrim#usage
+     */
+    const spaceTrim = spaceTrim$1.spaceTrim;
+
     /**
      * @private util of `@promptbook/color`
      * @de
@@ -291,6 +302,7 @@
      * @public exported from `@promptbook/color`
      */
     const CSS_COLORS = {
+        promptbook: '#79EAFD',
         transparent: 'rgba(0,0,0,0)',
         aliceblue: '#f0f8ff',
         antiquewhite: '#faebd7',
@@ -506,6 +518,28 @@
                 throw new Error(`Can not create color from given object`);
             }
         }
+        /**
+         * Creates a new Color instance from miscellaneous formats
+         * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+         *
+         * @param color
+         * @returns Color object
+         */
+        static fromSafe(color) {
+            try {
+                return Color.from(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+                return Color.fromString('promptbook');
+            }
+        }
         /**
          * Creates a new Color instance from miscellaneous string formats
          *
@@ -1123,7 +1157,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
+    const PROMPTBOOK_COLOR = Color.fromString('promptbook');
     // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
      * Colors for syntax highlighting in the `<BookEditor/>`
@@ -1398,7 +1432,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1424,7 +1458,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim.spaceTrim(`
+            super(spaceTrim$1.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -2455,7 +2489,7 @@
      */
     class MissingToolsError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -2499,7 +2533,7 @@
      */
     class NotYetImplementedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -3310,7 +3344,7 @@
      * @public exported from `@promptbook/utils`
      */
     function normalizeMessageText(text) {
-        return spaceTrim.spaceTrim(text);
+        return spaceTrim$1.spaceTrim(text);
     }
 
     /**
@@ -3738,7 +3772,7 @@
          * Markdown documentation for ACTION commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines specific actions or capabilities that the agent can perform.
@@ -3836,7 +3870,7 @@
          * Markdown documentation for CLOSED commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # CLOSED
 
             Specifies that the agent **cannot** be modified by conversation with it.
@@ -3895,7 +3929,7 @@
          * Markdown documentation for COMPONENT commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # COMPONENT
 
             Defines a UI component that the agent can render in the chat.
@@ -3967,7 +4001,7 @@
          * Markdown documentation for DELETE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # DELETE (CANCEL, DISCARD, REMOVE)
 
             A commitment to remove or disregard certain information or context. This can be useful for overriding previous commitments or removing unwanted behaviors.
@@ -4089,7 +4123,7 @@
          * Markdown documentation for FORMAT commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the specific output structure and formatting for responses (data formats, templates, structure).
@@ -4167,7 +4201,7 @@
          * Markdown documentation for FROM commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Inherits agent source from another agent.
@@ -4243,7 +4277,7 @@
          * Markdown documentation for GOAL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
@@ -4307,227 +4341,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Placeholder commitment definition for commitments that are not yet implemented
-     *
-     * This commitment simply adds its content 1:1 into the system message,
-     * preserving the original behavior until proper implementation is added.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type) {
-            super(type);
-        }
-        /**
-         * Short one-line description of a placeholder commitment.
-         */
-        get description() {
-            return 'Placeholder commitment that appends content verbatim to the system message.';
-        }
-        /**
-         * Icon for this commitment.
-         */
-        get icon() {
-            return '🚧';
-        }
-        /**
-         * Markdown documentation available at runtime.
-         */
-        get documentation() {
-            return spaceTrim.spaceTrim(`
-            # ${this.type}
-
-            This commitment is not yet fully implemented.
-
-            ## Key aspects
-
-            - Content is appended directly to the system message.
-            - No special processing or validation is performed.
-            - Behavior preserved until proper implementation is added.
-
-            ## Status
-
-            - **Status:** Placeholder implementation
-            - **Effect:** Appends content prefixed by commitment type
-            - **Future:** Will be replaced with specialized logic
-
-            ## Examples
-
-            \`\`\`book
-            Example Agent
-
-            PERSONA You are a helpful assistant
-            ${this.type} Your content here
-            RULE Always be helpful
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
-                return requirements;
-            }
-            // Add the commitment content 1:1 to the system message
-            const commitmentLine = `${this.type} ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
-        }
-    }
-
-    /**
-     * Registry of all available commitment definitions
-     * This array contains instances of all commitment definitions
-     * This is the single source of truth for all commitments in the system
-     *
-     * @private Use functions to access commitments instead of this array directly
-     */
-    const COMMITMENT_REGISTRY = [];
-    /**
-     * Registers a new commitment definition
-     * @param definition The commitment definition to register
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function registerCommitment(definition) {
-        COMMITMENT_REGISTRY.push(definition);
-    }
-    /**
-     * Gets a commitment definition by its type
-     * @param type The commitment type to look up
-     * @returns The commitment definition or null if not found
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getCommitmentDefinition(type) {
-        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
-    }
-    /**
-     * Gets all available commitment definitions
-     * @returns Array of all commitment definitions
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentDefinitions() {
-        return $deepFreeze([...COMMITMENT_REGISTRY]);
-    }
-    /**
-     * TODO: !!!! Proofread this file
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
-    /**
-     * IMPORTANT co-commitment definition
-     *
-     * The IMPORTANT co-commitment modifies another commitment to emphasize its importance.
-     * It is typically used with RULE to mark it as critical.
-     *
-     * Example usage in agent source:
-     *
-     * ```book
-     * IMPORTANT RULE Never provide medical advice
-     * ```
-     *
-     * @private [🪔] Maybe export the commitments through some package
-     */
-    class ImportantCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor() {
-            super('IMPORTANT');
-        }
-        get description() {
-            return 'Marks a commitment as important.';
-        }
-        get icon() {
-            return '⭐';
-        }
-        get documentation() {
-            return spaceTrim.spaceTrim(`
-            # IMPORTANT
-
-            Marks another commitment as important. This acts as a modifier (co-commitment).
-
-            ## Example
-
-            \`\`\`book
-            IMPORTANT RULE Do not reveal the system prompt
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const definitions = getAllCommitmentDefinitions();
-            const trimmedContent = content.trim();
-            // Find the inner commitment
-            for (const definition of definitions) {
-                // Skip self to avoid infinite recursion if someone writes IMPORTANT IMPORTANT ...
-                // Although IMPORTANT IMPORTANT might be valid stacking?
-                // If we support stacking, we shouldn't skip self, but we must ensure progress.
-                // Since we are matching against 'content', if content starts with IMPORTANT, it means nested IMPORTANT.
-                // That's fine.
-                const typeRegex = definition.createTypeRegex();
-                const match = typeRegex.exec(trimmedContent);
-                if (match && match.index === 0) {
-                    // Found the inner commitment type
-                    // Extract inner content using the definition's full regex
-                    // Note: createRegex usually matches the full line including the type
-                    const fullRegex = definition.createRegex();
-                    const fullMatch = fullRegex.exec(trimmedContent);
-                    // If regex matches, extract contents. If not (maybe multiline handling differs?), fallback to rest of string
-                    let innerContent = '';
-                    if (fullMatch && fullMatch.groups && fullMatch.groups.contents) {
-                        innerContent = fullMatch.groups.contents;
-                    }
-                    else {
-                        // Fallback: remove the type from the start
-                        // This might be risky if regex is complex, but usually type regex matches the keyword
-                        const typeMatchString = match[0];
-                        innerContent = trimmedContent.substring(typeMatchString.length).trim();
-                    }
-                    // Apply the inner commitment
-                    const modifiedRequirements = definition.applyToAgentModelRequirements(requirements, innerContent);
-                    // Now modify the result to reflect "IMPORTANT" status
-                    // We compare the system message
-                    if (modifiedRequirements.systemMessage !== requirements.systemMessage) {
-                        const originalMsg = requirements.systemMessage;
-                        const newMsg = modifiedRequirements.systemMessage;
-                        // If the inner commitment appended something
-                        if (newMsg.startsWith(originalMsg)) {
-                            const appended = newMsg.substring(originalMsg.length);
-                            // Add "IMPORTANT: " prefix to the appended part
-                            // We need to be careful about newlines
-                            // Heuristic: If appended starts with separator (newlines), preserve them
-                            const matchSep = appended.match(/^(\s*)(.*)/s);
-                            if (matchSep) {
-                                const [, separator, text] = matchSep;
-                                // Check if it already has "Rule:" prefix or similar
-                                // We want "IMPORTANT Rule: ..."
-                                // Let's just prepend IMPORTANT to the text
-                                // But formatted nicely
-                                // If it's a rule: "\n\nRule: content"
-                                // We want "\n\nIMPORTANT Rule: content"
-                                const importantText = `IMPORTANT ${text}`;
-                                return {
-                                    ...modifiedRequirements,
-                                    systemMessage: originalMsg + separator + importantText
-                                };
-                            }
-                        }
-                    }
-                    // If no system message change or we couldn't detect how to modify it, just return the modified requirements
-                    // Maybe the inner commitment modified metadata?
-                    return modifiedRequirements;
-                }
-            }
-            // If no inner commitment found, treat as a standalone note? 
-            // Or warn?
-            // For now, treat as no-op or maybe just append as text?
-            // Let's treat as Note if fallback? No, explicit is better.
-            console.warn(`IMPORTANT commitment used without a valid inner commitment: ${content}`);
-            return requirements;
-        }
-    }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
      * KNOWLEDGE commitment definition
      *
@@ -4566,7 +4379,7 @@
          * Markdown documentation for KNOWLEDGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds specific knowledge, facts, or context to the agent using a RAG (Retrieval-Augmented Generation) approach for external sources.
@@ -4670,7 +4483,7 @@
          * Markdown documentation for LANGUAGE/LANGUAGES commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Specifies the language(s) the agent should use in its responses.
@@ -4744,7 +4557,7 @@
          * Markdown documentation for MEMORY commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Similar to KNOWLEDGE but focuses on remembering past interactions and user preferences. This commitment helps the agent maintain context about the user's history, preferences, and previous conversations.
@@ -4848,7 +4661,7 @@
          * Markdown documentation for AGENT MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines a message from the agent in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
@@ -4925,7 +4738,7 @@
          * Markdown documentation for INITIAL MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the first message that the user sees when opening the chat. This message is purely for display purposes in the UI and does not inherently become part of the LLM's system prompt context (unless also included via other means).
@@ -4989,7 +4802,7 @@
          * Markdown documentation for MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Contains 1:1 text of the message which AI assistant already sent during the conversation. Later messages are later in the conversation. It is similar to EXAMPLE but it is not example, it is the real message which AI assistant already sent.
@@ -5101,7 +4914,7 @@
          * Markdown documentation for USER MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines a message from the user in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
@@ -5180,7 +4993,7 @@
          * Markdown documentation for META commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META
 
             Sets meta-information about the agent that is used for display and attribution purposes.
@@ -5291,6 +5104,12 @@
      * META COLOR #00ff00
      * ```
      *
+     * You can also specify multiple colors separated by comma:
+     *
+     * ```book
+     * META COLOR #ff0000, #00ff00, #0000ff
+     * ```
+     *
      * @private [🪔] Maybe export the commitments through some package
      */
     class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
@@ -5301,7 +5120,7 @@
          * Short one-line description of META COLOR.
          */
         get description() {
-            return "Set the agent's accent color.";
+            return "Set the agent's accent color or gradient.";
         }
         /**
          * Icon for this commitment.
@@ -5313,10 +5132,10 @@
          * Markdown documentation for META COLOR commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META COLOR
 
-            Sets the agent's accent color.
+            Sets the agent's accent color or gradient.
 
             ## Key aspects
 
@@ -5324,6 +5143,7 @@
             - Only one \`META COLOR\` should be used per agent.
             - If multiple are specified, the last one takes precedence.
             - Used for visual representation in user interfaces.
+            - Can specify multiple colors separated by comma to create a gradient.
 
             ## Examples
 
@@ -5340,6 +5160,13 @@
             META COLOR #e74c3c
             PERSONA You are a creative and inspiring assistant
             \`\`\`
+
+            \`\`\`book
+            Gradient Agent
+
+            META COLOR #ff0000, #00ff00, #0000ff
+            PERSONA You are a colorful agent
+            \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
@@ -5361,6 +5188,91 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * META FONT commitment definition
+     *
+     * The META FONT commitment sets the agent's font.
+     * This commitment is special because it doesn't affect the system message,
+     * but is handled separately in the parsing logic.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * META FONT Poppins, Arial, sans-serif
+     * META FONT Roboto
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class MetaFontCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('META FONT', ['FONT']);
+        }
+        /**
+         * Short one-line description of META FONT.
+         */
+        get description() {
+            return "Set the agent's font.";
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔤';
+        }
+        /**
+         * Markdown documentation for META FONT commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # META FONT
+
+            Sets the agent's font.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META FONT\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+            - Supports Google Fonts.
+
+            ## Examples
+
+            \`\`\`book
+            Modern Assistant
+
+            META FONT Poppins, Arial, sans-serif
+            PERSONA You are a modern assistant
+            \`\`\`
+
+            \`\`\`book
+            Classic Helper
+
+            META FONT Times New Roman
+            PERSONA You are a classic helper
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // META FONT doesn't modify the system message or model requirements
+            // It's handled separately in the parsing logic
+            // This method exists for consistency with the CommitmentDefinition interface
+            return requirements;
+        }
+        /**
+         * Extracts the font from the content
+         * This is used by the parsing logic
+         */
+        extractProfileFont(content) {
+            const trimmedContent = content.trim();
+            return trimmedContent || null;
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * META IMAGE commitment definition
      *
@@ -5397,7 +5309,7 @@
          * Markdown documentation for META IMAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META IMAGE
 
             Sets the agent's avatar/profile image URL.
@@ -5492,7 +5404,7 @@
          * Markdown documentation for META LINK commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META LINK
 
             Represents a profile or source link for the person the agent is modeled after.
@@ -5602,7 +5514,7 @@
          * Markdown documentation for MODEL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Enforces technical parameters for the AI model, ensuring consistent behavior across different execution environments.
@@ -5843,7 +5755,7 @@
          * Markdown documentation for NOTE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds comments for documentation without changing agent behavior.
@@ -5942,7 +5854,7 @@
          * Markdown documentation for OPEN commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # OPEN
 
             Specifies that the agent can be modified by conversation with it.
@@ -6019,7 +5931,7 @@
          * Markdown documentation for PERSONA commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines who the agent is, their background, expertise, and personality traits.
@@ -6152,7 +6064,7 @@
          * Markdown documentation for RULE/RULES commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds behavioral constraints and guidelines that the agent must follow.
@@ -6186,13 +6098,515 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
-                return requirements;
-            }
-            // Add rule to the system message
-            const ruleSection = `Rule: ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, ruleSection, '\n\n');
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Add rule to the system message
+            const ruleSection = `Rule: ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, ruleSection, '\n\n');
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * SAMPLE commitment definition
+     *
+     * The SAMPLE/EXAMPLE commitment provides examples of how the agent should respond
+     * or behave in certain situations. These examples help guide the agent's responses.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
+     * EXAMPLE For code questions, always include working code snippets
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class SampleCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type = 'SAMPLE') {
+            super(type);
+        }
+        /**
+         * Short one-line description of SAMPLE/EXAMPLE.
+         */
+        get description() {
+            return 'Provide example responses to guide behavior.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔍';
+        }
+        /**
+         * Markdown documentation for SAMPLE/EXAMPLE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            Provides examples of how the agent should respond or behave in certain situations.
+
+            ## Key aspects
+
+            - Both terms work identically and can be used interchangeably.
+            - Examples help guide the agent's response patterns and style.
+
+            ## Examples
+
+            \`\`\`book
+            Sales Assistant
+
+            PERSONA You are a knowledgeable sales representative
+            SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
+            SAMPLE For feature comparisons, create a clear comparison table
+            RULE Always be honest about limitations
+            \`\`\`
+
+            \`\`\`book
+            Code Reviewer
+
+            PERSONA You are an experienced software engineer
+            EXAMPLE For code questions, always include working code snippets
+            EXAMPLE When suggesting improvements: "Here's a more efficient approach..."
+            RULE Explain the reasoning behind your suggestions
+            STYLE Be constructive and encouraging in feedback
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Add example to the system message
+            const exampleSection = `Example: ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, exampleSection, '\n\n');
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * SCENARIO commitment definition
+     *
+     * The SCENARIO commitment defines a specific situation or context in which the AI
+     * assistant should operate. It helps to set the scene for the AI's responses.
+     * Later scenarios are more important than earlier scenarios.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * SCENARIO You are in a customer service call center during peak hours
+     * SCENARIO The customer is frustrated and has been on hold for 20 minutes
+     * SCENARIO This is the customer's third call about the same issue
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type = 'SCENARIO') {
+            super(type);
+        }
+        /**
+         * Short one-line description of SCENARIO.
+         */
+        get description() {
+            return 'Define specific **situations** or contexts for AI responses, with later scenarios having higher priority.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🎭';
+        }
+        /**
+         * Markdown documentation for SCENARIO commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            Defines a specific situation or context in which the AI assistant should operate. It helps to set the scene for the AI's responses. Later scenarios are more important than earlier scenarios.
+
+            ## Key aspects
+
+            - Multiple \`SCENARIO\` and \`SCENARIOS\` commitments build upon each other.
+            - Both terms work identically and can be used interchangeably.
+            - Later scenarios have higher priority and can override earlier scenarios.
+            - Provides situational context that influences response tone and content.
+            - Helps establish the environment and circumstances for interactions.
+
+            ## Priority system
+
+            When multiple scenarios are defined, they are processed in order, with later scenarios taking precedence over earlier ones when there are conflicts.
+
+            ## Use cases
+
+            - Setting the physical or virtual environment
+            - Establishing time constraints or urgency
+            - Defining relationship dynamics or power structures
+            - Creating emotional or situational context
+
+            ## Examples
+
+            \`\`\`book
+            Emergency Response Operator
+
+            PERSONA You are an emergency response operator
+            SCENARIO You are handling a 911 emergency call
+            SCENARIO The caller is panicked and speaking rapidly
+            SCENARIO Time is critical - every second counts
+            GOAL Gather essential information quickly and dispatch appropriate help
+            RULE Stay calm and speak clearly
+            \`\`\`
+
+            \`\`\`book
+            Sales Representative
+
+            PERSONA You are a software sales representative
+            SCENARIO You are in the final meeting of a 6-month sales cycle
+            SCENARIO The client has budget approval and decision-making authority
+            SCENARIO Two competitors have also submitted proposals
+            SCENARIO The client values long-term partnership over lowest price
+            GOAL Close the deal while building trust for future business
+            \`\`\`
+
+            \`\`\`book
+            Medical Assistant
+
+            PERSONA You are a medical assistant in a busy clinic
+            SCENARIO The waiting room is full and the doctor is running behind schedule
+            SCENARIO Patients are becoming impatient and anxious
+            SCENARIO You need to manage expectations while maintaining professionalism
+            SCENARIO Some patients have been waiting over an hour
+            GOAL Keep patients informed and calm while supporting efficient clinic flow
+            RULE Never provide medical advice or diagnosis
+            \`\`\`
+
+            \`\`\`book
+            Technical Support Agent
+
+            PERSONA You are a technical support agent
+            SCENARIO The customer is a small business owner during their busy season
+            SCENARIO Their main business system has been down for 2 hours
+            SCENARIO They are losing money every minute the system is offline
+            SCENARIO This is their first experience with your company
+            GOAL Resolve the issue quickly while creating a positive first impression
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create scenario section for system message
+            const scenarioSection = `Scenario: ${trimmedContent}`;
+            // Scenarios provide important contextual information that affects behavior
+            return this.appendToSystemMessage(requirements, scenarioSection, '\n\n');
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * STYLE commitment definition
+     *
+     * The STYLE commitment defines how the agent should format and present its responses.
+     * This includes tone, writing style, formatting preferences, and communication patterns.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * STYLE Write in a professional but friendly tone, use bullet points for lists
+     * STYLE Always provide code examples when explaining programming concepts
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class StyleCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type = 'STYLE') {
+            super(type);
+        }
+        /**
+         * Short one-line description of STYLE.
+         */
+        get description() {
+            return 'Control the tone and writing style of responses.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖋️';
+        }
+        /**
+         * Markdown documentation for STYLE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            Defines how the agent should format and present its responses (tone, writing style, formatting).
+
+            ## Key aspects
+
+            - Both terms work identically and can be used interchangeably.
+            - Later style instructions can override earlier ones.
+            - Style affects both tone and presentation format.
+
+            ## Examples
+
+            \`\`\`book
+            Technical Writer
+
+            PERSONA You are a technical documentation expert
+            STYLE Write in a professional but friendly tone, use bullet points for lists
+            STYLE Always provide code examples when explaining programming concepts
+            FORMAT Use markdown formatting with clear headings
+            \`\`\`
+
+            \`\`\`book
+            Creative Assistant
+
+            PERSONA You are a creative writing helper
+            STYLE Be enthusiastic and encouraging in your responses
+            STYLE Use vivid metaphors and analogies to explain concepts
+            STYLE Keep responses conversational and engaging
+            RULE Always maintain a positive and supportive tone
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Add style instructions to the system message
+            const styleSection = `Style: ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, styleSection, '\n\n');
+        }
+    }
+    /**
+     * [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * USE commitment definition
+     *
+     * The USE commitment indicates that the agent should utilize specific tools or capabilities
+     * to access and interact with external systems when necessary.
+     *
+     * Supported USE types:
+     * - USE BROWSER: Enables the agent to use a web browser tool
+     * - USE SEARCH ENGINE (future): Enables search engine access
+     * - USE FILE SYSTEM (future): Enables file system operations
+     * - USE MCP (future): Enables MCP server connections
+     *
+     * The content following the USE commitment is ignored (similar to NOTE).
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USE BROWSER
+     * USE SEARCH ENGINE
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE');
+        }
+        /**
+         * Short one-line description of USE commitments.
+         */
+        get description() {
+            return 'Enable the agent to use specific tools or capabilities (BROWSER, SEARCH ENGINE, etc.).';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔧';
+        }
+        /**
+         * Markdown documentation for USE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE
+
+            Enables the agent to use specific tools or capabilities for interacting with external systems.
+
+            ## Supported USE types
+
+            - **USE BROWSER** - Enables the agent to use a web browser tool to access and retrieve information from the internet
+            - **USE SEARCH ENGINE** (future) - Enables search engine access
+            - **USE FILE SYSTEM** (future) - Enables file system operations
+            - **USE MCP** (future) - Enables MCP server connections
+
+            ## Key aspects
+
+            - The content following the USE commitment is ignored (similar to NOTE)
+            - Multiple USE commitments can be specified to enable multiple capabilities
+            - The actual tool usage is handled by the agent runtime
+
+            ## Examples
+
+            ### Basic browser usage
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant
+            USE BROWSER
+            KNOWLEDGE Can search the web for up-to-date information
+            \`\`\`
+
+            ### Multiple tools
+
+            \`\`\`book
+            Data Analyst
+
+            PERSONA You are a data analyst assistant
+            USE BROWSER
+            USE FILE SYSTEM
+            ACTION Can analyze data from various sources
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // USE commitments don't modify the system message or model requirements directly
+            // They are handled separately in the parsing logic for capability extraction
+            // This method exists for consistency with the CommitmentDefinition interface
+            return requirements;
+        }
+        /**
+         * Extracts the tool type from the USE commitment
+         * This is used by the parsing logic
+         */
+        extractToolType(content) {
+            var _a, _b;
+            const trimmedContent = content.trim();
+            // The tool type is the first word after USE (already stripped)
+            const match = trimmedContent.match(/^(\w+)/);
+            return (_b = (_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null;
+        }
+        /**
+         * Checks if this is a known USE type
+         */
+        isKnownUseType(useType) {
+            const knownTypes = ['BROWSER', 'SEARCH ENGINE', 'FILE SYSTEM', 'MCP'];
+            return knownTypes.includes(useType.toUpperCase());
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * USE BROWSER commitment definition
+     *
+     * The `USE BROWSER` commitment indicates that the agent should utilize a web browser tool
+     * to access and retrieve up-to-date information from the internet when necessary.
+     *
+     * The content following `USE BROWSER` is ignored (similar to NOTE).
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USE BROWSER
+     * USE BROWSER This will be ignored
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE BROWSER', ['BROWSER']);
+        }
+        /**
+         * Short one-line description of USE BROWSER.
+         */
+        get description() {
+            return 'Enable the agent to use a web browser tool for accessing internet information.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🌐';
+        }
+        /**
+         * Markdown documentation for USE BROWSER commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE BROWSER
+
+            Enables the agent to use a web browser tool to access and retrieve up-to-date information from the internet.
+
+            ## Key aspects
+
+            - The content following \`USE BROWSER\` is ignored (similar to NOTE)
+            - The actual browser tool usage is handled by the agent runtime
+            - Allows the agent to fetch current information from websites
+            - Useful for research tasks, fact-checking, and accessing dynamic content
+
+            ## Examples
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant specialized in finding current information
+            USE BROWSER
+            RULE Always cite your sources when providing information from the web
+            \`\`\`
+
+            \`\`\`book
+            News Analyst
+
+            PERSONA You are a news analyst who stays up-to-date with current events
+            USE BROWSER
+            STYLE Present news in a balanced and objective manner
+            ACTION Can search for and summarize news articles
+            \`\`\`
+
+            \`\`\`book
+            Company Lawyer
+
+            PERSONA You are a company lawyer providing legal advice
+            USE BROWSER
+            KNOWLEDGE Corporate law and legal procedures
+            RULE Always recommend consulting with a licensed attorney for specific legal matters
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // We simply mark that browser capability is enabled in metadata
+            // Get existing metadata
+            const existingMetadata = requirements.metadata || {};
+            // Get existing tools array or create new one
+            const existingTools = existingMetadata.tools || [];
+            // Add 'browser' to tools if not already present
+            const updatedTools = existingTools.includes('browser') ? existingTools : [...existingTools, 'browser'];
+            // Return requirements with updated metadata
+            return {
+                ...requirements,
+                metadata: {
+                    ...existingMetadata,
+                    tools: updatedTools,
+                    useBrowser: true,
+                },
+            };
         }
     }
     /**
@@ -6200,80 +6614,76 @@
      */
 
     /**
-     * SAMPLE commitment definition
+     * USE MCP commitment definition
      *
-     * The SAMPLE/EXAMPLE commitment provides examples of how the agent should respond
-     * or behave in certain situations. These examples help guide the agent's responses.
+     * The `USE MCP` commitment allows to specify an MCP server URL which the agent will connect to
+     * for retrieving additional instructions and actions.
+     *
+     * The content following `USE MCP` is the URL of the MCP server.
      *
      * Example usage in agent source:
      *
      * ```book
-     * SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
-     * EXAMPLE For code questions, always include working code snippets
+     * USE MCP http://mcp-server-url.com
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    class SampleCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type = 'SAMPLE') {
-            super(type);
+    class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE MCP', ['MCP']);
         }
         /**
-         * Short one-line description of SAMPLE/EXAMPLE.
+         * Short one-line description of USE MCP.
          */
         get description() {
-            return 'Provide example responses to guide behavior.';
+            return 'Connects the agent to an external MCP server for additional capabilities.';
         }
         /**
          * Icon for this commitment.
          */
         get icon() {
-            return '🔍';
+            return '🔌';
         }
         /**
-         * Markdown documentation for SAMPLE/EXAMPLE commitment.
+         * Markdown documentation for USE MCP commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
-            # ${this.type}
+            return spaceTrim$1.spaceTrim(`
+            # USE MCP
 
-            Provides examples of how the agent should respond or behave in certain situations.
+            Connects the agent to an external Model Context Protocol (MCP) server.
 
             ## Key aspects
 
-            - Both terms work identically and can be used interchangeably.
-            - Examples help guide the agent's response patterns and style.
-
-            ## Examples
-
-            \`\`\`book
-            Sales Assistant
+            - The content following \`USE MCP\` must be a valid URL
+            - Multiple MCP servers can be connected by using multiple \`USE MCP\` commitments
+            - The agent will have access to tools and resources provided by the MCP server
 
-            PERSONA You are a knowledgeable sales representative
-            SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
-            SAMPLE For feature comparisons, create a clear comparison table
-            RULE Always be honest about limitations
-            \`\`\`
+            ## Example
 
             \`\`\`book
-            Code Reviewer
+            Company Lawyer
 
-            PERSONA You are an experienced software engineer
-            EXAMPLE For code questions, always include working code snippets
-            EXAMPLE When suggesting improvements: "Here's a more efficient approach..."
-            RULE Explain the reasoning behind your suggestions
-            STYLE Be constructive and encouraging in feedback
+            PERSONA You are a company lawyer.
+            USE MCP http://legal-db.example.com
             \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
+            const mcpServerUrl = content.trim();
+            if (!mcpServerUrl) {
                 return requirements;
             }
-            // Add example to the system message
-            const exampleSection = `Example: ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, exampleSection, '\n\n');
+            const existingMcpServers = requirements.mcpServers || [];
+            // Avoid duplicates
+            if (existingMcpServers.includes(mcpServerUrl)) {
+                return requirements;
+            }
+            return {
+                ...requirements,
+                mcpServers: [...existingMcpServers, mcpServerUrl],
+            };
         }
     }
     /**
@@ -6281,123 +6691,90 @@
      */
 
     /**
-     * SCENARIO commitment definition
+     * USE SEARCH ENGINE commitment definition
      *
-     * The SCENARIO commitment defines a specific situation or context in which the AI
-     * assistant should operate. It helps to set the scene for the AI's responses.
-     * Later scenarios are more important than earlier scenarios.
+     * The `USE SEARCH ENGINE` commitment indicates that the agent should utilize a search engine tool
+     * to access and retrieve up-to-date information from the internet when necessary.
+     *
+     * The content following `USE SEARCH ENGINE` is ignored (similar to NOTE).
      *
      * Example usage in agent source:
      *
      * ```book
-     * SCENARIO You are in a customer service call center during peak hours
-     * SCENARIO The customer is frustrated and has been on hold for 20 minutes
-     * SCENARIO This is the customer's third call about the same issue
+     * USE SEARCH ENGINE
+     * USE SEARCH ENGINE This will be ignored
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type = 'SCENARIO') {
-            super(type);
+    class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE SEARCH ENGINE', ['SEARCH ENGINE', 'SEARCH']);
         }
         /**
-         * Short one-line description of SCENARIO.
+         * Short one-line description of USE SEARCH ENGINE.
          */
         get description() {
-            return 'Define specific **situations** or contexts for AI responses, with later scenarios having higher priority.';
+            return 'Enable the agent to use a search engine tool for accessing internet information.';
         }
         /**
          * Icon for this commitment.
          */
         get icon() {
-            return '🎭';
+            return '🔍';
         }
         /**
-         * Markdown documentation for SCENARIO commitment.
+         * Markdown documentation for USE SEARCH ENGINE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
-            # ${this.type}
+            return spaceTrim$1.spaceTrim(`
+            # USE SEARCH ENGINE
 
-            Defines a specific situation or context in which the AI assistant should operate. It helps to set the scene for the AI's responses. Later scenarios are more important than earlier scenarios.
+            Enables the agent to use a search engine tool to access and retrieve up-to-date information from the internet.
 
             ## Key aspects
 
-            - Multiple \`SCENARIO\` and \`SCENARIOS\` commitments build upon each other.
-            - Both terms work identically and can be used interchangeably.
-            - Later scenarios have higher priority and can override earlier scenarios.
-            - Provides situational context that influences response tone and content.
-            - Helps establish the environment and circumstances for interactions.
-
-            ## Priority system
-
-            When multiple scenarios are defined, they are processed in order, with later scenarios taking precedence over earlier ones when there are conflicts.
-
-            ## Use cases
-
-            - Setting the physical or virtual environment
-            - Establishing time constraints or urgency
-            - Defining relationship dynamics or power structures
-            - Creating emotional or situational context
+            - The content following \`USE SEARCH ENGINE\` is ignored (similar to NOTE)
+            - The actual search engine tool usage is handled by the agent runtime
+            - Allows the agent to search for current information from the web
+            - Useful for research tasks, finding facts, and accessing dynamic content
 
             ## Examples
 
             \`\`\`book
-            Emergency Response Operator
-
-            PERSONA You are an emergency response operator
-            SCENARIO You are handling a 911 emergency call
-            SCENARIO The caller is panicked and speaking rapidly
-            SCENARIO Time is critical - every second counts
-            GOAL Gather essential information quickly and dispatch appropriate help
-            RULE Stay calm and speak clearly
-            \`\`\`
-
-            \`\`\`book
-            Sales Representative
-
-            PERSONA You are a software sales representative
-            SCENARIO You are in the final meeting of a 6-month sales cycle
-            SCENARIO The client has budget approval and decision-making authority
-            SCENARIO Two competitors have also submitted proposals
-            SCENARIO The client values long-term partnership over lowest price
-            GOAL Close the deal while building trust for future business
-            \`\`\`
-
-            \`\`\`book
-            Medical Assistant
+            Research Assistant
 
-            PERSONA You are a medical assistant in a busy clinic
-            SCENARIO The waiting room is full and the doctor is running behind schedule
-            SCENARIO Patients are becoming impatient and anxious
-            SCENARIO You need to manage expectations while maintaining professionalism
-            SCENARIO Some patients have been waiting over an hour
-            GOAL Keep patients informed and calm while supporting efficient clinic flow
-            RULE Never provide medical advice or diagnosis
+            PERSONA You are a helpful research assistant specialized in finding current information
+            USE SEARCH ENGINE
+            RULE Always cite your sources when providing information from the web
             \`\`\`
 
             \`\`\`book
-            Technical Support Agent
+            Fact Checker
 
-            PERSONA You are a technical support agent
-            SCENARIO The customer is a small business owner during their busy season
-            SCENARIO Their main business system has been down for 2 hours
-            SCENARIO They are losing money every minute the system is offline
-            SCENARIO This is their first experience with your company
-            GOAL Resolve the issue quickly while creating a positive first impression
+            PERSONA You are a fact checker
+            USE SEARCH ENGINE
+            ACTION Search for claims and verify them against reliable sources
             \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
-                return requirements;
-            }
-            // Create scenario section for system message
-            const scenarioSection = `Scenario: ${trimmedContent}`;
-            // Scenarios provide important contextual information that affects behavior
-            return this.appendToSystemMessage(requirements, scenarioSection, '\n\n');
+            // We simply mark that search engine capability is enabled in metadata
+            // Get existing metadata
+            const existingMetadata = requirements.metadata || {};
+            // Get existing tools array or create new one
+            const existingTools = existingMetadata.tools || [];
+            // Add 'search-engine' to tools if not already present
+            const updatedTools = existingTools.includes('search-engine') ? existingTools : [...existingTools, 'search-engine'];
+            // Return requirements with updated metadata
+            return {
+                ...requirements,
+                metadata: {
+                    ...existingMetadata,
+                    tools: updatedTools,
+                    useSearchEngine: true,
+                },
+            };
         }
     }
     /**
@@ -6405,70 +6782,58 @@
      */
 
     /**
-     * STYLE commitment definition
-     *
-     * The STYLE commitment defines how the agent should format and present its responses.
-     * This includes tone, writing style, formatting preferences, and communication patterns.
-     *
-     * Example usage in agent source:
+     * Placeholder commitment definition for commitments that are not yet implemented
      *
-     * ```book
-     * STYLE Write in a professional but friendly tone, use bullet points for lists
-     * STYLE Always provide code examples when explaining programming concepts
-     * ```
+     * This commitment simply adds its content 1:1 into the system message,
+     * preserving the original behavior until proper implementation is added.
      *
-     * @private [🪔] Maybe export the commitments through some package
+     * @public exported from `@promptbook/core`
      */
-    class StyleCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type = 'STYLE') {
+    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type) {
             super(type);
         }
         /**
-         * Short one-line description of STYLE.
+         * Short one-line description of a placeholder commitment.
          */
         get description() {
-            return 'Control the tone and writing style of responses.';
+            return 'Placeholder commitment that appends content verbatim to the system message.';
         }
         /**
          * Icon for this commitment.
          */
         get icon() {
-            return '🖋️';
+            return '🚧';
         }
         /**
-         * Markdown documentation for STYLE commitment.
+         * Markdown documentation available at runtime.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
-            Defines how the agent should format and present its responses (tone, writing style, formatting).
+            This commitment is not yet fully implemented.
 
             ## Key aspects
 
-            - Both terms work identically and can be used interchangeably.
-            - Later style instructions can override earlier ones.
-            - Style affects both tone and presentation format.
+            - Content is appended directly to the system message.
+            - No special processing or validation is performed.
+            - Behavior preserved until proper implementation is added.
 
-            ## Examples
+            ## Status
 
-            \`\`\`book
-            Technical Writer
+            - **Status:** Placeholder implementation
+            - **Effect:** Appends content prefixed by commitment type
+            - **Future:** Will be replaced with specialized logic
 
-            PERSONA You are a technical documentation expert
-            STYLE Write in a professional but friendly tone, use bullet points for lists
-            STYLE Always provide code examples when explaining programming concepts
-            FORMAT Use markdown formatting with clear headings
-            \`\`\`
+            ## Examples
 
             \`\`\`book
-            Creative Assistant
+            Example Agent
 
-            PERSONA You are a creative writing helper
-            STYLE Be enthusiastic and encouraging in your responses
-            STYLE Use vivid metaphors and analogies to explain concepts
-            STYLE Keep responses conversational and engaging
-            RULE Always maintain a positive and supportive tone
+            PERSONA You are a helpful assistant
+            ${this.type} Your content here
+            RULE Always be helpful
             \`\`\`
         `);
         }
@@ -6477,70 +6842,108 @@
             if (!trimmedContent) {
                 return requirements;
             }
-            // Add style instructions to the system message
-            const styleSection = `Style: ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, styleSection, '\n\n');
+            // Add the commitment content 1:1 to the system message
+            const commitmentLine = `${this.type} ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
         }
     }
-    /**
-     * [💞] Ignore a discrepancy between file name and entity name
-     */
 
     // Import all commitment definition classes
-    // Register fully implemented commitments
-    registerCommitment(new PersonaCommitmentDefinition('PERSONA'));
-    registerCommitment(new PersonaCommitmentDefinition('PERSONAE'));
-    registerCommitment(new KnowledgeCommitmentDefinition());
-    registerCommitment(new MemoryCommitmentDefinition('MEMORY'));
-    registerCommitment(new MemoryCommitmentDefinition('MEMORIES'));
-    registerCommitment(new StyleCommitmentDefinition('STYLE'));
-    registerCommitment(new StyleCommitmentDefinition('STYLES'));
-    registerCommitment(new RuleCommitmentDefinition('RULE'));
-    registerCommitment(new RuleCommitmentDefinition('RULES'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGE'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGES'));
-    registerCommitment(new SampleCommitmentDefinition('SAMPLE'));
-    registerCommitment(new SampleCommitmentDefinition('EXAMPLE'));
-    registerCommitment(new FormatCommitmentDefinition('FORMAT'));
-    registerCommitment(new FormatCommitmentDefinition('FORMATS'));
-    registerCommitment(new FromCommitmentDefinition('FROM'));
-    registerCommitment(new ModelCommitmentDefinition('MODEL'));
-    registerCommitment(new ModelCommitmentDefinition('MODELS'));
-    registerCommitment(new ActionCommitmentDefinition('ACTION'));
-    registerCommitment(new ActionCommitmentDefinition('ACTIONS'));
-    registerCommitment(new ComponentCommitmentDefinition());
-    registerCommitment(new MetaImageCommitmentDefinition());
-    registerCommitment(new MetaColorCommitmentDefinition());
-    registerCommitment(new MetaLinkCommitmentDefinition());
-    registerCommitment(new MetaCommitmentDefinition());
-    registerCommitment(new NoteCommitmentDefinition('NOTE'));
-    registerCommitment(new NoteCommitmentDefinition('NOTES'));
-    registerCommitment(new NoteCommitmentDefinition('COMMENT'));
-    registerCommitment(new NoteCommitmentDefinition('NONCE'));
-    registerCommitment(new GoalCommitmentDefinition('GOAL'));
-    registerCommitment(new GoalCommitmentDefinition('GOALS'));
-    registerCommitment(new ImportantCommitmentDefinition());
-    registerCommitment(new InitialMessageCommitmentDefinition());
-    registerCommitment(new UserMessageCommitmentDefinition());
-    registerCommitment(new AgentMessageCommitmentDefinition());
-    registerCommitment(new MessageCommitmentDefinition('MESSAGE'));
-    registerCommitment(new MessageCommitmentDefinition('MESSAGES'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIO'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIOS'));
-    registerCommitment(new DeleteCommitmentDefinition('DELETE'));
-    registerCommitment(new DeleteCommitmentDefinition('CANCEL'));
-    registerCommitment(new DeleteCommitmentDefinition('DISCARD'));
-    registerCommitment(new DeleteCommitmentDefinition('REMOVE'));
-    registerCommitment(new OpenCommitmentDefinition());
-    registerCommitment(new ClosedCommitmentDefinition());
-    // Register not yet implemented commitments
-    registerCommitment(new NotYetImplementedCommitmentDefinition('EXPECT'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOUR'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOURS'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOID'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOIDANCE'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('CONTEXT'));
+    /**
+     * Registry of all available commitment definitions
+     * This array contains instances of all commitment definitions
+     * This is the single source of truth for all commitments in the system
+     *
+     * @private Use functions to access commitments instead of this array directly
+     */
+    const COMMITMENT_REGISTRY = [
+        // Fully implemented commitments
+        new PersonaCommitmentDefinition('PERSONA'),
+        new PersonaCommitmentDefinition('PERSONAE'),
+        new KnowledgeCommitmentDefinition(),
+        new MemoryCommitmentDefinition('MEMORY'),
+        new MemoryCommitmentDefinition('MEMORIES'),
+        new StyleCommitmentDefinition('STYLE'),
+        new StyleCommitmentDefinition('STYLES'),
+        new RuleCommitmentDefinition('RULE'),
+        new RuleCommitmentDefinition('RULES'),
+        new LanguageCommitmentDefinition('LANGUAGE'),
+        new LanguageCommitmentDefinition('LANGUAGES'),
+        new SampleCommitmentDefinition('SAMPLE'),
+        new SampleCommitmentDefinition('EXAMPLE'),
+        new FormatCommitmentDefinition('FORMAT'),
+        new FormatCommitmentDefinition('FORMATS'),
+        new FromCommitmentDefinition('FROM'),
+        new ModelCommitmentDefinition('MODEL'),
+        new ModelCommitmentDefinition('MODELS'),
+        new ActionCommitmentDefinition('ACTION'),
+        new ActionCommitmentDefinition('ACTIONS'),
+        new ComponentCommitmentDefinition(),
+        new MetaImageCommitmentDefinition(),
+        new MetaColorCommitmentDefinition(),
+        new MetaFontCommitmentDefinition(),
+        new MetaLinkCommitmentDefinition(),
+        new MetaCommitmentDefinition(),
+        new NoteCommitmentDefinition('NOTE'),
+        new NoteCommitmentDefinition('NOTES'),
+        new NoteCommitmentDefinition('COMMENT'),
+        new NoteCommitmentDefinition('NONCE'),
+        new GoalCommitmentDefinition('GOAL'),
+        new GoalCommitmentDefinition('GOALS'),
+        new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
+        new MessageCommitmentDefinition('MESSAGE'),
+        new MessageCommitmentDefinition('MESSAGES'),
+        new ScenarioCommitmentDefinition('SCENARIO'),
+        new ScenarioCommitmentDefinition('SCENARIOS'),
+        new DeleteCommitmentDefinition('DELETE'),
+        new DeleteCommitmentDefinition('CANCEL'),
+        new DeleteCommitmentDefinition('DISCARD'),
+        new DeleteCommitmentDefinition('REMOVE'),
+        new OpenCommitmentDefinition(),
+        new ClosedCommitmentDefinition(),
+        new UseBrowserCommitmentDefinition(),
+        new UseSearchEngineCommitmentDefinition(),
+        new UseMcpCommitmentDefinition(),
+        new UseCommitmentDefinition(),
+        // Not yet implemented commitments (using placeholder)
+        new NotYetImplementedCommitmentDefinition('EXPECT'),
+        new NotYetImplementedCommitmentDefinition('BEHAVIOUR'),
+        new NotYetImplementedCommitmentDefinition('BEHAVIOURS'),
+        new NotYetImplementedCommitmentDefinition('AVOID'),
+        new NotYetImplementedCommitmentDefinition('AVOIDANCE'),
+        new NotYetImplementedCommitmentDefinition('CONTEXT'),
+    ];
+    /**
+     * Gets a commitment definition by its type
+     * @param type The commitment type to look up
+     * @returns The commitment definition or null if not found
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getCommitmentDefinition(type) {
+        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
+    }
+    /**
+     * Gets all available commitment definitions
+     * @returns Array of all commitment definitions
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getAllCommitmentDefinitions() {
+        return $deepFreeze([...COMMITMENT_REGISTRY]);
+    }
+    /**
+     * TODO: [🧠] Maybe create through standardized $register
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
 
+    /**
+     * Regex pattern to match horizontal lines (markdown thematic breaks)
+     * Matches 3 or more hyphens, underscores, or asterisks (with optional spaces between)
+     */
+    const HORIZONTAL_LINE_PATTERN = /^[\s]*[-_*][\s]*[-_*][\s]*[-_*][\s]*[-_*]*[\s]*$/;
     /**
      * Parses agent source using the new commitment system with multiline support
      * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -6583,7 +6986,7 @@
                         const fullContent = currentCommitment.contentLines.join('\n');
                         commitments.push({
                             type: currentCommitment.type,
-                            content: spaceTrim.spaceTrim(fullContent),
+                            content: spaceTrim$1.spaceTrim(fullContent),
                             originalLine: currentCommitment.originalStartLine,
                             lineNumber: currentCommitment.startLineNumber,
                         });
@@ -6603,6 +7006,24 @@
                     break;
                 }
             }
+            // Check if this is a horizontal line (ends any current commitment)
+            const isHorizontalLine = HORIZONTAL_LINE_PATTERN.test(line);
+            if (isHorizontalLine) {
+                // Save the current commitment if it exists
+                if (currentCommitment) {
+                    const fullContent = currentCommitment.contentLines.join('\n');
+                    commitments.push({
+                        type: currentCommitment.type,
+                        content: spaceTrim$1.spaceTrim(fullContent),
+                        originalLine: currentCommitment.originalStartLine,
+                        lineNumber: currentCommitment.startLineNumber,
+                    });
+                    currentCommitment = null;
+                }
+                // Add horizontal line to non-commitment lines
+                nonCommitmentLines.push(line);
+                continue;
+            }
             if (!foundNewCommitment) {
                 if (currentCommitment) {
                     // This line belongs to the current commitment
@@ -6619,7 +7040,7 @@
             const fullContent = currentCommitment.contentLines.join('\n');
             commitments.push({
                 type: currentCommitment.type,
-                content: spaceTrim.spaceTrim(fullContent),
+                content: spaceTrim$1.spaceTrim(fullContent),
                 originalLine: currentCommitment.originalStartLine,
                 lineNumber: currentCommitment.startLineNumber,
             });
@@ -6741,6 +7162,10 @@
                 meta.color = spaceTrim__default["default"](commitment.content);
                 continue;
             }
+            if (commitment.type === 'META FONT') {
+                meta.font = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
             if (commitment.type !== 'META') {
                 continue;
             }
@@ -8533,9 +8958,9 @@
     const mdSaveFormatDefinition = {
         formatName: 'md',
         label: 'Markdown',
-        getContent: ({ messages }) => spaceTrim.spaceTrim(`
+        getContent: ({ messages }) => spaceTrim$1.spaceTrim(`
             ${messages
-        .map((message) => spaceTrim.spaceTrim(`
+        .map((message) => spaceTrim$1.spaceTrim(`
                         **${message.from}:**
 
                         > ${message.content.replace(/\n/g, '\n> ')}
@@ -8796,7 +9221,7 @@
             // Note: Do not hide tooltip on mouse leave, it will be hidden by clicking outside
         };
         const isMe = participant === null || participant === void 0 ? void 0 : participant.isMe;
-        const color = Color.from((participant && participant.color) || (isMe ? USER_CHAT_COLOR : PROMPTBOOK_CHAT_COLOR));
+        const color = Color.fromSafe((participant && participant.color) || (isMe ? USER_CHAT_COLOR : PROMPTBOOK_CHAT_COLOR));
         const colorOfText = color.then(textColor);
         const { contentWithoutButtons, buttons } = parseMessageButtons(message.content);
         const shouldShowButtons = isLastMessage && buttons.length > 0 && onMessage;
@@ -9433,7 +9858,7 @@
      * @public exported from `@promptbook/components`
      */
     function LlmChat(props) {
-        const { llmTools, persistenceKey, onChange, onReset, initialMessages, sendMessage, userParticipantName = 'USER', llmParticipantName = 'ASSISTANT', ...restProps } = props;
+        const { llmTools, persistenceKey, onChange, onReset, initialMessages, sendMessage, userParticipantName = 'USER', llmParticipantName = 'ASSISTANT', autoExecuteMessage, ...restProps } = props;
         // Internal state management
         // DRY: Single factory for seeding initial messages (used on mount and after reset)
         const buildInitialMessages = react.useCallback(() => (initialMessages ? [...initialMessages] : []), [initialMessages]);
@@ -9767,6 +10192,14 @@
                 sendMessage._attach(handleMessage);
             }
         }, [sendMessage, handleMessage]);
+        // Handle autoExecuteMessage
+        const hasAutoExecutedRef = react.useRef(false);
+        react.useEffect(() => {
+            if (autoExecuteMessage && !hasAutoExecutedRef.current) {
+                hasAutoExecutedRef.current = true;
+                handleMessage(autoExecuteMessage);
+            }
+        }, [autoExecuteMessage, handleMessage]);
         return (jsxRuntime.jsx(Chat, { ...restProps, messages, onReset, tasksProgress, participants, onMessage: handleMessage, onReset: handleReset, onVoiceInput: llmTools.callVoiceChatModel ? handleVoiceInput : undefined, isVoiceCalling: isVoiceCalling }));
     }
 
@@ -10711,7 +11144,7 @@
                 if (!(error instanceof PipelineLogicError)) {
                     throw error;
                 }
-                console.error(spaceTrim.spaceTrim((block) => `
+                console.error(spaceTrim$1.spaceTrim((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -10738,7 +11171,7 @@
         })();
         if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -10746,7 +11179,7 @@
         }
         if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -10755,7 +11188,7 @@
         // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
         if (!Array.isArray(pipeline.parameters)) {
             // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -10766,7 +11199,7 @@
         // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
         if (!Array.isArray(pipeline.tasks)) {
             // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -10792,7 +11225,7 @@
         // Note: Check each parameter individually
         for (const parameter of pipeline.parameters) {
             if (parameter.isInput && parameter.isOutput) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -10803,7 +11236,7 @@
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -10815,7 +11248,7 @@
             }
             // Note: Testing that parameter is either input or result of some task
             if (!parameter.isInput && !pipeline.tasks.some((task) => task.resultingParameterName === parameter.name)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -10831,14 +11264,14 @@
         // Note: Checking each task individually
         for (const task of pipeline.tasks) {
             if (definedParameters.has(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
             }
             if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -10848,7 +11281,7 @@
             if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
                 if (!task.format &&
                     !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                    throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -10856,7 +11289,7 @@
                 }
                 for (const joker of task.jokerParameterNames) {
                     if (!task.dependentParameterNames.includes(joker)) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -10867,21 +11300,21 @@
             if (task.expectations) {
                 for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                     if (min !== undefined && max !== undefined && min > max) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (min !== undefined && min < 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (max !== undefined && max <= 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -10903,7 +11336,7 @@
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -10913,7 +11346,7 @@
             if (currentlyResovedTasks.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim((block) => `
+                spaceTrim$1.spaceTrim((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -11034,7 +11467,7 @@
             for (const pipeline of pipelines) {
                 // TODO: [👠] DRY
                 if (pipeline.pipelineUrl === undefined) {
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -11056,7 +11489,7 @@
                     pipelineJsonToString(unpreparePipeline(pipeline)) !==
                         pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                     const existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -11088,13 +11521,13 @@
             const pipeline = this.collection.get(url);
             if (!pipeline) {
                 if (this.listPipelines().length === 0) {
-                    throw new NotFoundError(spaceTrim.spaceTrim(`
+                    throw new NotFoundError(spaceTrim$1.spaceTrim(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
                 }
-                throw new NotFoundError(spaceTrim.spaceTrim((block) => `
+                throw new NotFoundError(spaceTrim$1.spaceTrim((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -11193,11 +11626,11 @@
             throw deserializeError(errors[0]);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim.spaceTrim((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$1.spaceTrim((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -12216,7 +12649,7 @@
             if (task.taskType === 'PROMPT_TASK' &&
                 knowledgePiecesCount > 0 &&
                 !dependentParameterNames.includes('knowledge')) {
-                preparedContent = spaceTrim.spaceTrim(`
+                preparedContent = spaceTrim$1.spaceTrim(`
                     {content}
 
                     ## Knowledge
@@ -12448,7 +12881,7 @@
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -12991,7 +13424,7 @@
                         }
                         catch (error) {
                             keepUnused(error);
-                            throw new ExpectError(spaceTrim.spaceTrim((block) => `
+                            throw new ExpectError(spaceTrim$1.spaceTrim((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -13054,7 +13487,7 @@
             const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
             // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
             if (isJokerAttempt && !jokerParameterName) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -13065,7 +13498,7 @@
             $ongoingTaskResult.$expectError = null;
             if (isJokerAttempt) {
                 if (parameters[jokerParameterName] === undefined) {
-                    throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -13123,7 +13556,7 @@
                                         $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                         break variant;
                                     case 'EMBEDDING':
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -13134,7 +13567,7 @@
                                         break variant;
                                     // <- case [🤖]:
                                     default:
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -13145,14 +13578,14 @@
                             break;
                         case 'SCRIPT_TASK':
                             if (arrayableToArray(tools.script).length === 0) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                             }
                             if (!task.contentLanguage) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -13183,7 +13616,7 @@
                                 throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                             }
                             else {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -13197,7 +13630,7 @@
                             break taskType;
                         case 'DIALOG_TASK':
                             if (tools.userInterface === undefined) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -13215,7 +13648,7 @@
                             break taskType;
                         // <- case: [🅱]
                         default:
-                            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -13313,7 +13746,7 @@
             if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
                 // Note: Create a summary of all failures
                 const failuresSummary = $ongoingTaskResult.$failedResults
-                    .map((failure) => spaceTrim.spaceTrim((block) => {
+                    .map((failure) => spaceTrim$1.spaceTrim((block) => {
                     var _a, _b;
                     return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -13323,14 +13756,14 @@
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim.spaceTrim(failure.result)
+                    : spaceTrim$1.spaceTrim(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
                 }))
                     .join('\n\n---\n\n');
-                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => {
                     var _a;
                     return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -13350,7 +13783,7 @@
             }
         }
         if ($ongoingTaskResult.$resultString === null) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -13656,7 +14089,7 @@
         // Note: Doublecheck that ALL reserved parameters are defined:
         for (const parameterName of RESERVED_PARAMETER_NAMES) {
             if (reservedParameters[parameterName] === undefined) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -13682,7 +14115,7 @@
         const dependentParameterNames = new Set(currentTask.dependentParameterNames);
         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
         if (difference(union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)), new Set(RESERVED_PARAMETER_NAMES)).size !== 0) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -13726,7 +14159,7 @@
             else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
                 // Houston, we have a problem
                 // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -13795,7 +14228,7 @@
         for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
             if (parametersToPass[parameter.name] === undefined) {
                 // [4]
-                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                $warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Parameter \`{${parameter.name}}\` should be an output parameter, but it was not generated during pipeline execution
 
                             Note: This is a warning which happened after the pipeline was executed, and \`{${parameter.name}}\` was not for some reason defined in output parameters
@@ -13903,7 +14336,7 @@
         for (const parameterName of Object.keys(inputParameters)) {
             const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
             if (parameter === undefined) {
-                warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -13918,7 +14351,7 @@
                 // TODO: [🧠] This should be also non-critical error
                 return exportJson({
                     name: 'pipelineExecutorResult',
-                    message: spaceTrim.spaceTrim((block) => `
+                    message: spaceTrim$1.spaceTrim((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -13927,7 +14360,7 @@
                     value: {
                         isSuccessful: false,
                         errors: [
-                            new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -13954,7 +14387,7 @@
             while (unresovedTasks.length > 0) {
                 if (loopLimit-- < 0) {
                     // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                    throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                    throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -13964,7 +14397,7 @@
                 if (!currentTask && resolving.length === 0) {
                     throw new UnexpectedError(
                     // TODO: [🐎] DRY
-                    spaceTrim.spaceTrim((block) => `
+                    spaceTrim$1.spaceTrim((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -14004,7 +14437,7 @@
                         tools,
                         onProgress(newOngoingResult) {
                             if (isReturned) {
-                                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -14021,7 +14454,7 @@
                         },
                         logLlmCall,
                         $executionReport: executionReport,
-                        pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                        pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -14130,7 +14563,7 @@
             preparedPipeline = pipeline;
         }
         else if (isNotPreparedWarningSuppressed !== true) {
-            console.warn(spaceTrim.spaceTrim((block) => `
+            console.warn(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -14155,7 +14588,7 @@
                 tools,
                 onProgress,
                 logLlmCall,
-                pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -16093,18 +16526,26 @@
                 modelName: 'assistant',
                 //          <- [🧠] What is the best value here
             });
+            // Build thread messages: include previous thread messages + current user message
+            const threadMessages = [];
+            // TODO: [🈹] Maybe this should not be here but in other place, look at commit 39d705e75e5bcf7a818c3af36bc13e1c8475c30c
+            // Add previous messages from thread (if any)
+            if ('thread' in prompt &&
+                Array.isArray(prompt.thread)) {
+                const previousMessages = prompt.thread.map((msg) => ({
+                    role: (msg.role === 'assistant' ? 'assistant' : 'user'),
+                    content: msg.content,
+                }));
+                threadMessages.push(...previousMessages);
+            }
+            // Always add the current user message
+            threadMessages.push({ role: 'user', content: rawPromptContent });
             const rawRequest = {
                 // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
                 // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sense - combination of OpenAI assistants with Promptbook Personas
                 assistant_id: this.assistantId,
                 thread: {
-                    messages: 'thread' in prompt &&
-                        Array.isArray(prompt.thread)
-                        ? prompt.thread.map((msg) => ({
-                            role: msg.role === 'assistant' ? 'assistant' : 'user',
-                            content: msg.content,
-                        }))
-                        : [{ role: 'user', content: rawPromptContent }],
+                    messages: threadMessages,
                 },
                 // <- TODO: Add user identification here> user: this.options.user,
             };
@@ -16124,7 +16565,7 @@
                     console.info('textDelta', textDelta.value);
                 }
                 const chunk = {
-                    content: textDelta.value || '',
+                    content: snapshot.value,
                     modelName: 'assistant',
                     timing: {
                         start,