@promptbook/components 0.103.0-55 → 0.103.0-56

package/esm/index.es.js

@@ -1,6 +1,6 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { useMemo, useEffect, useState, useRef, useCallback, forwardRef, memo } from 'react';
-import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { SHA256 } from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import { basename, join, dirname, isAbsolute } from 'path';
@@ -35,7 +35,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -247,6 +247,17 @@ CORE_SERVER.urls;
  * 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;
+
 /**
  * @private util of `@promptbook/color`
  * @de
@@ -295,6 +306,7 @@ function take(initialValue) {
  * @public exported from `@promptbook/color`
  */
 const CSS_COLORS = {
+    promptbook: '#79EAFD',
     transparent: 'rgba(0,0,0,0)',
     aliceblue: '#f0f8ff',
     antiquewhite: '#faebd7',
@@ -510,6 +522,28 @@ class Color {
             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
      *
@@ -1127,7 +1161,7 @@ const CLAIM = `Turn your company's scattered knowledge into AI ready books`;
  *
  * @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/>`
@@ -1359,7 +1393,7 @@ false);
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim((block) => `
+        body: spaceTrim$2((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1554,7 +1588,7 @@ function valueToString(value) {
  * @public exported from `@promptbook/utils`
  */
 function computeHash(value) {
-    return SHA256(hexEncoder.parse(spaceTrim(valueToString(value)))).toString( /* hex */);
+    return SHA256(hexEncoder.parse(spaceTrim$2(valueToString(value)))).toString( /* hex */);
 }
 /**
  * TODO: [🥬][🥬] Use this ACRY
@@ -1661,7 +1695,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1680,7 +1714,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1703,7 +1737,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1735,7 +1769,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -2688,7 +2722,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim((block) => `
+        message = spaceTrim$2((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -2709,7 +2743,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim((block) => `
+        console.error(spaceTrim$2((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -2815,7 +2849,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$2(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -2829,7 +2863,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -2948,7 +2982,7 @@ function templateParameters(template, parameters) {
  */
 function prompt(strings, ...values) {
     if (values.length === 0) {
-        return spaceTrim(strings.join(''));
+        return spaceTrim$2(strings.join(''));
     }
     const stringsWithHiddenParameters = strings.map((stringsItem) => 
     // TODO: [0] DRY
@@ -2959,7 +2993,7 @@ function prompt(strings, ...values) {
     let pipelineString = stringsWithHiddenParameters.reduce((result, stringsItem, i) => placeholderParameterNames[i] === undefined
         ? `${result}${stringsItem}`
         : `${result}${stringsItem}{${placeholderParameterNames[i]}}`, '');
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     try {
         pipelineString = templateParameters(pipelineString, parameters);
     }
@@ -2968,7 +3002,7 @@ function prompt(strings, ...values) {
             throw error;
         }
         console.error({ pipelineString, parameters, placeholderParameterNames, error });
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     Internal error in prompt template literal
                   
                     ${block(JSON.stringify({ strings, values }, null, 4))}}
@@ -3418,7 +3452,7 @@ function serializeToPromptbookJavascript(value) {
         imports.push(`import { Color } from '@promptbook/color';`);
     }
     else if (typeof value === 'string') {
-        const trimmed = spaceTrim(value);
+        const trimmed = spaceTrim$2(value);
         if (trimmed.includes('\n')) {
             // Multiline string -> use `spaceTrim`
             serializedValue = `spaceTrim(\`\n${value.replace(/`/g, '\\`')}\n\`)`;
@@ -3588,7 +3622,7 @@ function isValidPipelineUrl(url) {
  * @public exported from `@promptbook/core`
  */
 function normalizeAgentName(rawAgentName) {
-    return titleToName(spaceTrim(rawAgentName));
+    return titleToName(spaceTrim$2(rawAgentName));
 }
 
 /**
@@ -4311,227 +4345,6 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
  * 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$1(`
-            # ${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$1(`
-            # 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
  *
@@ -5295,6 +5108,12 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
  * 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 {
@@ -5305,7 +5124,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
      * 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.
@@ -5320,7 +5139,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # META COLOR
 
-            Sets the agent's accent color.
+            Sets the agent's accent color or gradient.
 
             ## Key aspects
 
@@ -5328,6 +5147,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
             - 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
 
@@ -5344,6 +5164,13 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
             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) {
@@ -5365,6 +5192,91 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
  * 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(`
+            # 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
  *
@@ -6190,13 +6102,515 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     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(`
+            # ${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(`
+            # ${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(`
+            # ${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(`
+            # 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(`
+            # 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,
+            },
+        };
     }
 }
 /**
@@ -6204,80 +6618,76 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * 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$1(`
-            # ${this.type}
+            # 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],
+        };
     }
 }
 /**
@@ -6285,123 +6695,90 @@ class SampleCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * 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$1(`
-            # ${this.type}
+            # 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,
+            },
+        };
     }
 }
 /**
@@ -6409,70 +6786,58 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * 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$1(`
             # ${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
             \`\`\`
         `);
     }
@@ -6481,70 +6846,108 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
         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
@@ -6607,6 +7010,24 @@ function parseAgentSourceWithCommitments(agentSource) {
                 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(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
@@ -6732,17 +7153,21 @@ function parseAgentSource(agentSource) {
     const links = [];
     for (const commitment of parseResult.commitments) {
         if (commitment.type === 'META LINK') {
-            const linkValue = spaceTrim(commitment.content);
+            const linkValue = spaceTrim$2(commitment.content);
             links.push(linkValue);
             meta.link = linkValue;
             continue;
         }
         if (commitment.type === 'META IMAGE') {
-            meta.image = spaceTrim(commitment.content);
+            meta.image = spaceTrim$2(commitment.content);
             continue;
         }
         if (commitment.type === 'META COLOR') {
-            meta.color = spaceTrim(commitment.content);
+            meta.color = spaceTrim$2(commitment.content);
+            continue;
+        }
+        if (commitment.type === 'META FONT') {
+            meta.font = spaceTrim$2(commitment.content);
             continue;
         }
         if (commitment.type !== 'META') {
@@ -6751,10 +7176,10 @@ function parseAgentSource(agentSource) {
         // Parse META commitments - format is "META TYPE content"
         const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
         if (metaTypeRaw === 'LINK') {
-            links.push(spaceTrim(commitment.content.substring(metaTypeRaw.length)));
+            links.push(spaceTrim$2(commitment.content.substring(metaTypeRaw.length)));
         }
         const metaType = normalizeTo_camelCase(metaTypeRaw);
-        meta[metaType] = spaceTrim(commitment.content.substring(metaTypeRaw.length));
+        meta[metaType] = spaceTrim$2(commitment.content.substring(metaTypeRaw.length));
     }
     // Generate gravatar fallback if no meta image specified
     if (!meta.image) {
@@ -6892,7 +7317,7 @@ function validateBook(source) {
  * @deprecated Use `$generateBookBoilerplate` instead
  * @public exported from `@promptbook/core`
  */
-const DEFAULT_BOOK = padBook(validateBook(spaceTrim(`
+const DEFAULT_BOOK = padBook(validateBook(spaceTrim$2(`
             AI Avatar
 
             PERSONA A friendly AI assistant that helps you with your tasks
@@ -7241,7 +7666,7 @@ function MarkdownContent(props) {
 function aboutPromptbookInformation(options) {
     const { isServersInfoIncluded = true, isRuntimeEnvironmentInfoIncluded = true } = options || {};
     const fullInfoPieces = [];
-    const basicInfo = spaceTrim(`
+    const basicInfo = spaceTrim$2(`
 
             # ${NAME}
 
@@ -7253,7 +7678,7 @@ function aboutPromptbookInformation(options) {
         `);
     fullInfoPieces.push(basicInfo);
     if (isServersInfoIncluded) {
-        const serversInfo = spaceTrim((block) => `
+        const serversInfo = spaceTrim$2((block) => `
 
                 ## Servers
 
@@ -7268,7 +7693,7 @@ function aboutPromptbookInformation(options) {
             ...runtimeEnvironment,
             isCostPrevented: IS_COST_PREVENTED,
         };
-        const environmentInfo = spaceTrim((block) => `
+        const environmentInfo = spaceTrim$2((block) => `
 
                 ## Environment
 
@@ -7278,7 +7703,7 @@ function aboutPromptbookInformation(options) {
             `);
         fullInfoPieces.push(environmentInfo);
     }
-    const fullInfo = spaceTrim(fullInfoPieces.join('\n\n'));
+    const fullInfo = spaceTrim$2(fullInfoPieces.join('\n\n'));
     return fullInfo;
 }
 /**
@@ -8400,7 +8825,7 @@ function getTextColor(bgColor) {
 const htmlSaveFormatDefinition = {
     formatName: 'html',
     label: 'Html',
-    getContent: ({ messages }) => spaceTrim(`
+    getContent: ({ messages }) => spaceTrim$2(`
             <!DOCTYPE html>
             <html lang="en">
             <head>
@@ -8488,7 +8913,7 @@ const htmlSaveFormatDefinition = {
         };
         const bgColor = participantColors[String(message.from)] || '#2b7cff';
         const textColor = getTextColor(bgColor);
-        return spaceTrim(`
+        return spaceTrim$2(`
                             <div class="chat-message">
                                 <div class="avatar" style="background:${bgColor};color:${getTextColor(bgColor)};">
                                     ${String(message.from)[0] || '?'}
@@ -8591,7 +9016,7 @@ const reactSaveFormatDefinition = {
         const { imports: participantsImports, value: participantsValue } = serializeToPromptbookJavascript(participants);
         const { imports: messagesImports, value: messagesValue } = serializeToPromptbookJavascript(messages);
         const uniqueImports = Array.from(new Set([`import { Chat } from '@promptbook/components';`, ...participantsImports, ...messagesImports])).filter((imp) => !!imp && imp.trim().length > 0);
-        return spaceTrim((block) => `
+        return spaceTrim$2((block) => `
                 "use client";
 
                 ${block(uniqueImports.join('\n'))}
@@ -8800,7 +9225,7 @@ const ChatMessageItem = memo(({ message, participant, participants, isLastMessag
         // 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;
@@ -9081,7 +9506,7 @@ function Chat(props) {
                 const fileContents = uploadedFiles.map((f) => f.content).join(' ');
                 messageContent = messageContent ? `${messageContent} ${fileContents}` : fileContents;
             }
-            if (spaceTrim(messageContent) === '') {
+            if (spaceTrim$2(messageContent) === '') {
                 throw new Error(`You need to write some text or upload a file`);
             }
             await onMessage(messageContent);
@@ -9437,7 +9862,7 @@ ChatPersistence.STORAGE_PREFIX = 'promptbook_chat_';
  * @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 = useCallback(() => (initialMessages ? [...initialMessages] : []), [initialMessages]);
@@ -9771,6 +10196,14 @@ function LlmChat(props) {
             sendMessage._attach(handleMessage);
         }
     }, [sendMessage, handleMessage]);
+    // Handle autoExecuteMessage
+    const hasAutoExecutedRef = useRef(false);
+    useEffect(() => {
+        if (autoExecuteMessage && !hasAutoExecutedRef.current) {
+            hasAutoExecutedRef.current = true;
+            handleMessage(autoExecuteMessage);
+        }
+    }, [autoExecuteMessage, handleMessage]);
     return (jsx(Chat, { ...restProps, messages, onReset, tasksProgress, participants, onMessage: handleMessage, onReset: handleReset, onVoiceInput: llmTools.callVoiceChatModel ? handleVoiceInput : undefined, isVoiceCalling: isVoiceCalling }));
 }
 
@@ -9793,7 +10226,7 @@ function AgentChat(props) {
             {
                 from: 'AGENT',
                 content: agent.initialMessage ||
-                    spaceTrim(`
+                    spaceTrim$2(`
                                 
                         Hello! I am ${agent.meta.fullname || agent.agentName || 'an AI Agent'}.
                         
@@ -10261,7 +10694,7 @@ function book(strings, ...values) {
     const bookString = prompt(strings, ...values);
     if (!isValidPipelineString(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$2(`
                 The string is not a valid pipeline string
 
                 book\`
@@ -10271,7 +10704,7 @@ function book(strings, ...values) {
     }
     if (!isValidBook(bookString)) {
         // TODO: Make the CustomError for this
-        throw new Error(spaceTrim(`
+        throw new Error(spaceTrim$2(`
                 The string is not a valid book
 
                 book\`
@@ -10334,14 +10767,14 @@ class MultipleLlmExecutionTools {
             if (description === undefined) {
                 return headLine;
             }
-            return spaceTrim((block) => `
+            return spaceTrim$2((block) => `
                         ${headLine}
 
                           ${ /* <- Note: Indenting the description: */block(description)}
                     `);
         })
             .join('\n\n');
-        return spaceTrim((block) => `
+        return spaceTrim$2((block) => `
                 Multiple LLM Providers:
 
                 ${block(innerModelsTitlesAndDescriptions)}
@@ -10432,7 +10865,7 @@ class MultipleLlmExecutionTools {
             //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     3) ...
-            spaceTrim((block) => `
+            spaceTrim$2((block) => `
                           All execution tools of ${this.title} failed:
 
                           ${block(errors
@@ -10445,7 +10878,7 @@ class MultipleLlmExecutionTools {
             throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$2((block) => `
                           You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}" into ${this.title}
 
                           Available \`LlmExecutionTools\`:
@@ -10478,7 +10911,7 @@ class MultipleLlmExecutionTools {
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
     if (llmExecutionTools.length === 0) {
-        const warningMessage = spaceTrim(`
+        const warningMessage = spaceTrim$2(`
             You have not provided any \`LlmExecutionTools\`
             This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.
 
@@ -10657,7 +11090,7 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += '```' + contentLanguage;
         pipelineString += '\n';
-        pipelineString += spaceTrim(content);
+        pipelineString += spaceTrim$2(content);
         //                   <- TODO: [main] !!3 Escape
         //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         pipelineString += '\n';
@@ -11718,14 +12151,14 @@ function $registeredScrapersMessage(availableScrapers) {
         return { ...metadata, isMetadataAviailable, isInstalled, isAvailableInTools };
     });
     if (metadata.length === 0) {
-        return spaceTrim(`
+        return spaceTrim$2(`
             **No scrapers are available**
 
             This is a unexpected behavior, you are probably using some broken version of Promptbook
             At least there should be available the metadata of the scrapers
         `);
     }
-    return spaceTrim((block) => `
+    return spaceTrim$2((block) => `
             Available scrapers are:
             ${block(metadata
         .map(({ packageName, className, isMetadataAviailable, isInstalled, mimeTypes, isAvailableInBrowser, isAvailableInTools, }, i) => {
@@ -11871,7 +12304,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         else if (urlOrRequest instanceof Request) {
             url = urlOrRequest.url;
         }
-        throw new PromptbookFetchError(spaceTrim((block) => `
+        throw new PromptbookFetchError(spaceTrim$2((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -12032,7 +12465,7 @@ async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         const fileExtension = getFileExtension(filename);
         const mimeType = extensionToMimeType(fileExtension || '');
         if (!(await isFileExisting(filename, tools.fs))) {
-            throw new NotFoundError(spaceTrim((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                           Can not make source handler for file which does not exist:
 
                           File:
@@ -12125,7 +12558,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                     // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                     break;
                 }
-                console.warn(spaceTrim((block) => `
+                console.warn(spaceTrim$2((block) => `
                             Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
 
                             The source:
@@ -12141,7 +12574,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             if (partialPieces === null) {
-                throw new KnowledgeScrapeError(spaceTrim((block) => `
+                throw new KnowledgeScrapeError(spaceTrim$2((block) => `
                             Cannot scrape knowledge
 
                             The source:
@@ -12578,7 +13011,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -12623,7 +13056,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -12809,7 +13242,7 @@ function mapAvailableToExpectedParameters(options) {
     }
     // Phase 2️⃣: Non-matching mapping
     if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim((block) => `
+        throw new PipelineExecutionError(spaceTrim$2((block) => `
                     Can not map available parameters to expected parameters
 
                     Mapped parameters:
@@ -13381,7 +13814,7 @@ async function executeFormatSubvalues(options) {
         return /* not await */ executeAttempts({ ...options, logLlmCall });
     }
     if (jokerParameterNames.length !== 0) {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     JOKER parameters are not supported together with FOREACH command
 
                     [🧞‍♀️] This should be prevented in \`validatePipeline\`
@@ -13394,7 +13827,7 @@ async function executeFormatSubvalues(options) {
     if (formatDefinition === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim((block) => `
+        spaceTrim$2((block) => `
                     Unsupported format "${task.foreach.formatName}"
 
                     Available formats:
@@ -13411,7 +13844,7 @@ async function executeFormatSubvalues(options) {
     if (subvalueParser === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim((block) => `
+        spaceTrim$2((block) => `
                     Unsupported subformat name "${task.foreach.subformatName}" for format "${task.foreach.formatName}"
 
                     Available subformat names for format "${formatDefinition.formatName}":
@@ -13451,7 +13884,7 @@ async function executeFormatSubvalues(options) {
                 if (!(error instanceof PipelineExecutionError)) {
                     throw error;
                 }
-                const highLevelError = new PipelineExecutionError(spaceTrim((block) => `
+                const highLevelError = new PipelineExecutionError(spaceTrim$2((block) => `
                             ${error.message}
 
                             This is error in FOREACH command when mapping ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -13475,7 +13908,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim((block) => `
+                    pipelineIdentification: spaceTrim$2((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -13484,7 +13917,7 @@ async function executeFormatSubvalues(options) {
             }
             catch (error) {
                 if (length > BIG_DATASET_TRESHOLD) {
-                    console.error(spaceTrim((block) => `
+                    console.error(spaceTrim$2((block) => `
                               ${error.message}
 
                               This is error in FOREACH command when processing ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -15842,7 +16275,7 @@ class OpenAiCompatibleExecutionTools {
         // Note: Match exact or prefix for model families
         const model = this.HARDCODED_MODELS.find(({ modelName }) => modelName === defaultModelName || modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new PipelineExecutionError(spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$2((block) => `
                             Cannot find model in ${this.title} models with name "${defaultModelName}" which should be used as default.
 
                             Available models:
@@ -16097,18 +16530,26 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             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,
         };
@@ -16128,7 +16569,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 console.info('textDelta', textDelta.value);
             }
             const chunk = {
-                content: textDelta.value || '',
+                content: snapshot.value,
                 modelName: 'assistant',
                 timing: {
                     start,
@@ -16802,7 +17243,7 @@ class Agent extends AgentLlmExecutionTools {
         }
         // TODO: !!! Extract learning to separate method
         // Learning: Append the conversation sample to the agent source
-        const learningExample = spaceTrim((block) => `
+        const learningExample = spaceTrim$2((block) => `
 
                 ---
 
@@ -16815,7 +17256,7 @@ class Agent extends AgentLlmExecutionTools {
             `);
         // Append to the current source
         const currentSource = this.agentSource.value;
-        const newSource = padBook(validateBook(spaceTrim(currentSource) + '\n\n' + learningExample));
+        const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n' + learningExample));
         // Update the source (which will trigger the subscription and update the underlying tools)
         this.agentSource.next(newSource);
         return result;