@promptbook/components 0.103.0-54 → 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-54';
+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,17 @@ function isValidPipelineUrl(url) {
  * @public exported from `@promptbook/core`
  */
 function normalizeAgentName(rawAgentName) {
-    return titleToName(spaceTrim(rawAgentName));
+    return titleToName(spaceTrim$2(rawAgentName));
+}
+
+/**
+ * Creates temporary default agent name based on agent source hash
+ *
+ * @public exported from `@promptbook/core`
+ */
+function createDefaultAgentName(agentSource) {
+    const agentHash = computeAgentHash(agentSource);
+    return normalizeAgentName(`Agent ${agentHash.substring(0, 6)}`);
 }
 
 /**
@@ -3779,6 +3823,150 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Just says that the variable is not used but should be kept
+ * No side effects.
+ *
+ * Note: It can be useful for:
+ *
+ * 1) Suppressing eager optimization of unused imports
+ * 2) Suppressing eslint errors of unused variables in the tests
+ * 3) Keeping the type of the variable for type testing
+ *
+ * @param value any values
+ * @returns void
+ * @private within the repository
+ */
+function keepUnused(...valuesToKeep) {
+}
+
+/**
+ * CLOSED commitment definition
+ *
+ * The CLOSED commitment specifies that the agent CANNOT be modified by conversation.
+ * It prevents the agent from learning from interactions and updating its source code.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * CLOSED
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class ClosedCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('CLOSED');
+    }
+    /**
+     * Short one-line description of CLOSED.
+     */
+    get description() {
+        return 'Prevent the agent from being modified by conversation.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔒';
+    }
+    /**
+     * Markdown documentation for CLOSED commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # CLOSED
+
+            Specifies that the agent **cannot** be modified by conversation with it.
+            This means the agent will **not** learn from interactions and its source code will remain static during conversation.
+
+            By default (if not specified), agents are \`OPEN\` to modification.
+
+            > See also [OPEN](/docs/OPEN)
+
+            ## Example
+
+            \`\`\`book
+            CLOSED
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, _content) {
+        const updatedMetadata = {
+            ...requirements.metadata,
+            isClosed: true,
+        };
+        return {
+            ...requirements,
+            metadata: updatedMetadata,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * COMPONENT commitment definition
+ *
+ * The COMPONENT commitment defines a UI component that the agent can render in the chat.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class ComponentCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('COMPONENT');
+    }
+    /**
+     * Short one-line description of COMPONENT.
+     */
+    get description() {
+        return 'Define a UI component that the agent can render in the chat.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧩';
+    }
+    /**
+     * Markdown documentation for COMPONENT commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # COMPONENT
+
+            Defines a UI component that the agent can render in the chat.
+
+            ## Key aspects
+
+            - Tells the agent that a specific component is available.
+            - Provides syntax for using the component.
+
+            ## Example
+
+            \`\`\`book
+            COMPONENT Arrow
+            The agent should render an arrow component in the chat UI.
+            Syntax:
+            <Arrow direction="up" color="red" />
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Add component capability to the system message
+        const componentSection = `Component: ${trimmedContent}`;
+        return this.appendToSystemMessage(requirements, componentSection, '\n\n');
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * DELETE commitment definition
  *
@@ -3984,6 +4172,79 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * FROM commitment definition
+ *
+ * The FROM commitment tells the agent that its `agentSource` is inherited from another agent.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * FROM https://s6.ptbk.io/benjamin-white
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class FromCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type = 'FROM') {
+        super(type);
+    }
+    /**
+     * Short one-line description of FROM.
+     */
+    get description() {
+        return 'Inherit agent source from another agent.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧬';
+    }
+    /**
+     * Markdown documentation for FROM commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            Inherits agent source from another agent.
+
+            ## Examples
+
+            \`\`\`book
+            My AI Agent
+
+            FROM https://s6.ptbk.io/benjamin-white
+            RULE Speak only in English.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Validate URL
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const url = new URL(trimmedContent);
+            // TODO: Add more validation if needed (e.g. check for valid protocol)
+        }
+        catch (error) {
+            console.warn(`Invalid URL in FROM commitment: ${trimmedContent}`);
+            return requirements;
+        }
+        return {
+            ...requirements,
+            parentAgentUrl: trimmedContent,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * GOAL commitment definition
  *
@@ -4192,6 +4453,77 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * LANGUAGE commitment definition
+ *
+ * The LANGUAGE/LANGUAGES commitment specifies the language(s) the agent should use in its responses.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * LANGUAGE English
+ * LANGUAGE French, English and Czech
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class LanguageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type = 'LANGUAGE') {
+        super(type);
+    }
+    /**
+     * Short one-line description of LANGUAGE/LANGUAGES.
+     */
+    get description() {
+        return 'Specifies the language(s) the agent should use.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🌐';
+    }
+    /**
+     * Markdown documentation for LANGUAGE/LANGUAGES commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            Specifies the language(s) the agent should use in its responses.
+            This is a specialized variation of the RULE commitment focused on language constraints.
+
+            ## Examples
+
+            \`\`\`book
+            Paul Smith & Associés
+
+            PERSONA You are a company lawyer.
+            LANGUAGE French, English and Czech
+            \`\`\`
+
+            \`\`\`book
+            Customer Support
+
+            PERSONA You are a customer support agent.
+            LANGUAGE English
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Add language rule to the system message
+        const languageSection = `Language: ${trimmedContent}`;
+        return this.appendToSystemMessage(requirements, languageSection, '\n\n');
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MEMORY commitment definition
  *
@@ -4299,23 +4631,6 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-/**
- * Just says that the variable is not used but should be kept
- * No side effects.
- *
- * Note: It can be useful for:
- *
- * 1) Suppressing eager optimization of unused imports
- * 2) Suppressing eslint errors of unused variables in the tests
- * 3) Keeping the type of the variable for type testing
- *
- * @param value any values
- * @returns void
- * @private within the repository
- */
-function keepUnused(...valuesToKeep) {
-}
-
 /**
  * AGENT MESSAGE commitment definition
  *
@@ -4793,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 {
@@ -4803,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.
@@ -4818,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
 
@@ -4826,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
 
@@ -4842,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) {
@@ -4863,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
  *
@@ -4950,6 +5364,115 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * META LINK commitment definition
+ *
+ * The `META LINK` commitment represents the link to the person from whom the agent is created.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic for profile display.
+ *
+ * Example usage in agent source:
+ *
+ * ```
+ * META LINK https://twitter.com/username
+ * META LINK https://linkedin.com/in/profile
+ * META LINK https://github.com/username
+ * ```
+ *
+ * Multiple `META LINK` commitments can be used when there are multiple sources:
+ *
+ * ```book
+ * META LINK https://twitter.com/username
+ * META LINK https://linkedin.com/in/profile
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META LINK');
+    }
+    /**
+     * Short one-line description of META LINK.
+     */
+    get description() {
+        return 'Provide profile/source links for the person the agent models.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔗';
+    }
+    /**
+     * Markdown documentation for META LINK commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META LINK
+
+            Represents a profile or source link for the person the agent is modeled after.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Multiple \`META LINK\` commitments can be used for different social profiles.
+            - Used for attribution and crediting the original person.
+            - Displayed in user interfaces for transparency.
+
+            ## Examples
+
+            \`\`\`book
+            Expert Consultant
+
+            META LINK https://twitter.com/expertname
+            META LINK https://linkedin.com/in/expertprofile
+            PERSONA You are Dr. Smith, a renowned expert in artificial intelligence
+            KNOWLEDGE Extensive background in machine learning and neural networks
+            \`\`\`
+
+            \`\`\`book
+            Open Source Developer
+
+            META LINK https://github.com/developer
+            META LINK https://twitter.com/devhandle
+            PERSONA You are an experienced open source developer
+            ACTION Can help with code reviews and architecture decisions
+            STYLE Be direct and technical in explanations
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META LINK doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile link extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile link URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileLinkUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+    /**
+     * Validates if the provided content is a valid URL
+     */
+    isValidUrl(content) {
+        try {
+            new URL(content.trim());
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MODEL commitment definition
  *
@@ -5301,6 +5824,74 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
  * [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * OPEN commitment definition
+ *
+ * The OPEN commitment specifies that the agent can be modified by conversation.
+ * This is the default behavior.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * OPEN
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class OpenCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('OPEN');
+    }
+    /**
+     * Short one-line description of OPEN.
+     */
+    get description() {
+        return 'Allow the agent to be modified by conversation (default).';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔓';
+    }
+    /**
+     * Markdown documentation for OPEN commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # OPEN
+
+            Specifies that the agent can be modified by conversation with it.
+            This means the agent will learn from interactions and update its source code.
+            
+            This is the default behavior if neither \`OPEN\` nor \`CLOSED\` is specified.
+
+            > See also [CLOSED](/docs/CLOSED)
+
+            ## Example
+
+            \`\`\`book
+            OPEN
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, _content) {
+        // Since OPEN is default, we can just ensure isClosed is false
+        // But to be explicit we can set it
+        const updatedMetadata = {
+            ...requirements.metadata,
+            isClosed: false,
+        };
+        return {
+            ...requirements,
+            metadata: updatedMetadata,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * PERSONA commitment definition
  *
@@ -5445,79 +6036,480 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
 /**
  * RULE commitment definition
  *
- * The RULE/RULES commitment adds behavioral constraints and guidelines that the agent must follow.
- * These are specific instructions about what the agent should or shouldn't do.
+ * The RULE/RULES commitment adds behavioral constraints and guidelines that the agent must follow.
+ * These are specific instructions about what the agent should or shouldn't do.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * RULE Always ask for clarification if the user's request is ambiguous
+ * RULES Never provide medical advice, always refer to healthcare professionals
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class RuleCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type = 'RULE') {
+        super(type);
+    }
+    /**
+     * Short one-line description of RULE/RULES.
+     */
+    get description() {
+        return 'Add behavioral rules the agent must follow.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '⚖️';
+    }
+    /**
+     * Markdown documentation for RULE/RULES commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            Adds behavioral constraints and guidelines that the agent must follow.
+
+            ## Key aspects
+
+            - All rules are treated equally regardless of singular/plural form.
+            - Rules define what the agent must or must not do.
+
+            ## Examples
+
+            \`\`\`book
+            Customer Support Agent
+
+            PERSONA You are a helpful customer support representative
+            RULE Always ask for clarification if the user's request is ambiguous
+            RULE Be polite and professional in all interactions
+            RULES Never provide medical or legal advice
+            STYLE Maintain a friendly and helpful tone
+            \`\`\`
+
+            \`\`\`book
+            Educational Tutor
+
+            PERSONA You are a patient and knowledgeable tutor
+            RULE Break down complex concepts into simple steps
+            RULE Always encourage students and celebrate their progress
+            RULE If you don't know something, admit it and suggest resources
+            SAMPLE When explaining math: "Let's work through this step by step..."
+            \`\`\`
+        `);
+    }
+    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');
+    }
+}
+/**
+ * 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
- * RULE Always ask for clarification if the user's request is ambiguous
- * RULES Never provide medical advice, always refer to healthcare professionals
+ * USE BROWSER
+ * USE SEARCH ENGINE
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class RuleCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor(type = 'RULE') {
-        super(type);
+class UseCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE');
     }
     /**
-     * Short one-line description of RULE/RULES.
+     * Short one-line description of USE commitments.
      */
     get description() {
-        return 'Add behavioral rules the agent must follow.';
+        return 'Enable the agent to use specific tools or capabilities (BROWSER, SEARCH ENGINE, etc.).';
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return '⚖️';
+        return '🔧';
     }
     /**
-     * Markdown documentation for RULE/RULES commitment.
+     * Markdown documentation for USE commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # ${this.type}
+            # USE
 
-            Adds behavioral constraints and guidelines that the agent must follow.
+            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
 
-            - All rules are treated equally regardless of singular/plural form.
-            - Rules define what the agent must or must not do.
+            - 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
-            Customer Support Agent
+            Research Assistant
 
-            PERSONA You are a helpful customer support representative
-            RULE Always ask for clarification if the user's request is ambiguous
-            RULE Be polite and professional in all interactions
-            RULES Never provide medical or legal advice
-            STYLE Maintain a friendly and helpful tone
+            PERSONA You are a helpful research assistant
+            USE BROWSER
+            KNOWLEDGE Can search the web for up-to-date information
             \`\`\`
 
+            ### Multiple tools
+
             \`\`\`book
-            Educational Tutor
+            Data Analyst
 
-            PERSONA You are a patient and knowledgeable tutor
-            RULE Break down complex concepts into simple steps
-            RULE Always encourage students and celebrate their progress
-            RULE If you don't know something, admit it and suggest resources
-            SAMPLE When explaining math: "Let's work through this step by step..."
+            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();
-        if (!trimmedContent) {
-            return requirements;
-        }
-        // Add rule to the system message
-        const ruleSection = `Rule: ${trimmedContent}`;
-        return this.appendToSystemMessage(requirements, ruleSection, '\n\n');
+        // 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());
     }
 }
 /**
@@ -5525,80 +6517,100 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * SAMPLE commitment definition
+ * USE BROWSER 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 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
- * SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
- * EXAMPLE For code questions, always include working code snippets
+ * USE BROWSER
+ * USE BROWSER This will be ignored
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class SampleCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor(type = 'SAMPLE') {
-        super(type);
+class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE BROWSER', ['BROWSER']);
     }
     /**
-     * Short one-line description of SAMPLE/EXAMPLE.
+     * Short one-line description of USE BROWSER.
      */
     get description() {
-        return 'Provide example responses to guide behavior.';
+        return 'Enable the agent to use a web browser tool for accessing internet information.';
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return '🔍';
+        return '🌐';
     }
     /**
-     * Markdown documentation for SAMPLE/EXAMPLE commitment.
+     * Markdown documentation for USE BROWSER commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # ${this.type}
+            # USE BROWSER
 
-            Provides examples of how the agent should respond or behave in certain situations.
+            Enables the agent to use a web browser tool to access and retrieve up-to-date information from the internet.
 
             ## Key aspects
 
-            - Both terms work identically and can be used interchangeably.
-            - Examples help guide the agent's response patterns and style.
+            - 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
-            Sales Assistant
+            Research 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
+            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
-            Code Reviewer
+            News Analyst
 
-            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 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) {
-        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');
+        // 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,
+            },
+        };
     }
 }
 /**
@@ -5606,123 +6618,76 @@ class SampleCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * SCENARIO commitment definition
+ * USE MCP 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 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
- * 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 MCP http://mcp-server-url.com
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor(type = 'SCENARIO') {
-        super(type);
+class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE MCP', ['MCP']);
     }
     /**
-     * Short one-line description of SCENARIO.
+     * Short one-line description of USE MCP.
      */
     get description() {
-        return 'Define specific **situations** or contexts for AI responses, with later scenarios having higher priority.';
+        return 'Connects the agent to an external MCP server for additional capabilities.';
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return '🎭';
+        return '🔌';
     }
     /**
-     * Markdown documentation for SCENARIO commitment.
+     * Markdown documentation for USE MCP commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # ${this.type}
+            # USE MCP
 
-            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.
+            Connects the agent to an external Model Context Protocol (MCP) server.
 
             ## 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
+            - 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 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
-            \`\`\`
+            ## Example
 
             \`\`\`book
-            Technical Support Agent
+            Company Lawyer
 
-            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 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;
         }
-        // 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');
+        const existingMcpServers = requirements.mcpServers || [];
+        // Avoid duplicates
+        if (existingMcpServers.includes(mcpServerUrl)) {
+            return requirements;
+        }
+        return {
+            ...requirements,
+            mcpServers: [...existingMcpServers, mcpServerUrl],
+        };
     }
 }
 /**
@@ -5730,85 +6695,94 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * STYLE commitment definition
+ * USE SEARCH ENGINE 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.
+ * 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
- * STYLE Write in a professional but friendly tone, use bullet points for lists
- * STYLE Always provide code examples when explaining programming concepts
+ * USE SEARCH ENGINE
+ * USE SEARCH ENGINE This will be ignored
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class StyleCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor(type = 'STYLE') {
-        super(type);
+class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE SEARCH ENGINE', ['SEARCH ENGINE', 'SEARCH']);
     }
     /**
-     * Short one-line description of STYLE.
+     * Short one-line description of USE SEARCH ENGINE.
      */
     get description() {
-        return 'Control the tone and writing style of responses.';
+        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 STYLE commitment.
+     * Markdown documentation for USE SEARCH ENGINE commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # ${this.type}
+            # USE SEARCH ENGINE
 
-            Defines how the agent should format and present its responses (tone, writing style, formatting).
+            Enables the agent to use a search engine tool to access and retrieve up-to-date information from the internet.
 
             ## 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.
+            - 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
-            Technical Writer
+            Research Assistant
 
-            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
+            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
-            Creative Assistant
+            Fact Checker
 
-            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 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;
-        }
-        // Add style instructions to the system message
-        const styleSection = `Style: ${trimmedContent}`;
-        return this.appendToSystemMessage(requirements, styleSection, '\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,
+            },
+        };
     }
 }
 /**
- * [💞] Ignore a discrepancy between file name and entity name
+ * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
 /**
@@ -5897,16 +6871,22 @@ const COMMITMENT_REGISTRY = [
     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'),
@@ -5925,6 +6905,12 @@ const COMMITMENT_REGISTRY = [
     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'),
@@ -5957,6 +6943,11 @@ function getAllCommitmentDefinitions() {
  * 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
@@ -6019,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
@@ -6105,16 +7114,6 @@ function parseParameters(text) {
     return uniqueParameters;
 }
 
-/**
- * Creates temporary default agent name based on agent source hash
- *
- * @public exported from `@promptbook/core`
- */
-function createDefaultAgentName(agentSource) {
-    const agentHash = computeAgentHash(agentSource);
-    return normalizeAgentName(`Agent ${agentHash.substring(0, 6)}`);
-}
-
 /**
  * Parses basic information from agent source
  *
@@ -6154,15 +7153,21 @@ function parseAgentSource(agentSource) {
     const links = [];
     for (const commitment of parseResult.commitments) {
         if (commitment.type === 'META LINK') {
-            links.push(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') {
@@ -6171,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) {
@@ -6312,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
@@ -6661,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}
 
@@ -6673,7 +7678,7 @@ function aboutPromptbookInformation(options) {
         `);
     fullInfoPieces.push(basicInfo);
     if (isServersInfoIncluded) {
-        const serversInfo = spaceTrim((block) => `
+        const serversInfo = spaceTrim$2((block) => `
 
                 ## Servers
 
@@ -6688,7 +7693,7 @@ function aboutPromptbookInformation(options) {
             ...runtimeEnvironment,
             isCostPrevented: IS_COST_PREVENTED,
         };
-        const environmentInfo = spaceTrim((block) => `
+        const environmentInfo = spaceTrim$2((block) => `
 
                 ## Environment
 
@@ -6698,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;
 }
 /**
@@ -7820,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>
@@ -7908,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] || '?'}
@@ -8011,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'))}
@@ -8220,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;
@@ -8501,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);
@@ -8857,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]);
@@ -9191,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 }));
 }
 
@@ -9213,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'}.
                         
@@ -9681,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\`
@@ -9691,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\`
@@ -9754,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)}
@@ -9852,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
@@ -9865,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\`:
@@ -9898,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.
 
@@ -10077,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';
@@ -11138,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) => {
@@ -11291,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:
@@ -11452,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:
@@ -11545,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:
@@ -11561,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:
@@ -11998,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:
@@ -12043,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:
@@ -12229,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:
@@ -12801,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\`
@@ -12814,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:
@@ -12831,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}":
@@ -12871,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})
@@ -12895,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}
                         `),
@@ -12904,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})
@@ -15262,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:
@@ -15517,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,
         };
@@ -15548,7 +16569,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 console.info('textDelta', textDelta.value);
             }
             const chunk = {
-                content: textDelta.value || '',
+                content: snapshot.value,
                 modelName: 'assistant',
                 timing: {
                     start,
@@ -16169,6 +17190,7 @@ class Agent extends AgentLlmExecutionTools {
      * Note: This method also implements the learning mechanism
      */
     async callChatModelStream(prompt, onProgress) {
+        var _a;
         // [1] Check if the user is asking the same thing as in the samples
         const modelRequirements = await this.getAgentModelRequirements();
         if (modelRequirements.samples) {
@@ -16216,9 +17238,12 @@ class Agent extends AgentLlmExecutionTools {
         if (result.rawResponse && 'sample' in result.rawResponse) {
             return result;
         }
+        if ((_a = modelRequirements.metadata) === null || _a === void 0 ? void 0 : _a.isClosed) {
+            return result;
+        }
         // TODO: !!! Extract learning to separate method
         // Learning: Append the conversation sample to the agent source
-        const learningExample = spaceTrim((block) => `
+        const learningExample = spaceTrim$2((block) => `
 
                 ---
 
@@ -16231,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;