@promptbook/core 0.103.0-54 → 0.103.0-56

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @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
@@ -90,6 +90,17 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Trims string from all 4 sides
+     *
+     * Note: This is a re-exported function from the `spacetrim` package which is
+     *       Developed by same author @hejny as this package
+     *
+     * @public exported from `@promptbook/utils`
+     * @see https://github.com/hejny/spacetrim#usage
+     */
+    const spaceTrim = spaceTrim$1.spaceTrim;
+
     /**
      * @private util of `@promptbook/color`
      * @de
@@ -138,6 +149,7 @@
      * @public exported from `@promptbook/color`
      */
     const CSS_COLORS = {
+        promptbook: '#79EAFD',
         transparent: 'rgba(0,0,0,0)',
         aliceblue: '#f0f8ff',
         antiquewhite: '#faebd7',
@@ -353,6 +365,28 @@
                 throw new Error(`Can not create color from given object`);
             }
         }
+        /**
+         * Creates a new Color instance from miscellaneous formats
+         * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+         *
+         * @param color
+         * @returns Color object
+         */
+        static fromSafe(color) {
+            try {
+                return Color.from(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+                return Color.fromString('promptbook');
+            }
+        }
         /**
          * Creates a new Color instance from miscellaneous string formats
          *
@@ -976,7 +1010,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
+    const PROMPTBOOK_COLOR = Color.fromString('promptbook');
     // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
      * Colors for syntax highlighting in the `<BookEditor/>`
@@ -7644,6 +7678,133 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * 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.spaceTrim(`
+            # 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.spaceTrim(`
+            # 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
      *
@@ -7849,6 +8010,79 @@
      * 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.spaceTrim(`
+            # ${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
      *
@@ -8057,6 +8291,77 @@
      * 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.spaceTrim(`
+            # ${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
      *
@@ -8641,6 +8946,12 @@
      * META COLOR #00ff00
      * ```
      *
+     * You can also specify multiple colors separated by comma:
+     *
+     * ```book
+     * META COLOR #ff0000, #00ff00, #0000ff
+     * ```
+     *
      * @private [🪔] Maybe export the commitments through some package
      */
     class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
@@ -8651,7 +8962,7 @@
          * Short one-line description of META COLOR.
          */
         get description() {
-            return "Set the agent's accent color.";
+            return "Set the agent's accent color or gradient.";
         }
         /**
          * Icon for this commitment.
@@ -8666,7 +8977,7 @@
             return spaceTrim$1.spaceTrim(`
             # META COLOR
 
-            Sets the agent's accent color.
+            Sets the agent's accent color or gradient.
 
             ## Key aspects
 
@@ -8674,6 +8985,7 @@
             - Only one \`META COLOR\` should be used per agent.
             - If multiple are specified, the last one takes precedence.
             - Used for visual representation in user interfaces.
+            - Can specify multiple colors separated by comma to create a gradient.
 
             ## Examples
 
@@ -8690,6 +9002,13 @@
             META COLOR #e74c3c
             PERSONA You are a creative and inspiring assistant
             \`\`\`
+
+            \`\`\`book
+            Gradient Agent
+
+            META COLOR #ff0000, #00ff00, #0000ff
+            PERSONA You are a colorful agent
+            \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
@@ -8712,84 +9031,82 @@
      */
 
     /**
-     * META IMAGE commitment definition
+     * META FONT commitment definition
      *
-     * The META IMAGE commitment sets the agent's avatar/profile image URL.
+     * 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 IMAGE https://example.com/avatar.jpg
-     * META IMAGE /assets/agent-avatar.png
+     * META FONT Poppins, Arial, sans-serif
+     * META FONT Roboto
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    class MetaFontCommitmentDefinition extends BaseCommitmentDefinition {
         constructor() {
-            super('META IMAGE', ['IMAGE']);
+            super('META FONT', ['FONT']);
         }
         /**
-         * Short one-line description of META IMAGE.
+         * Short one-line description of META FONT.
          */
         get description() {
-            return "Set the agent's profile image URL.";
+            return "Set the agent's font.";
         }
         /**
          * Icon for this commitment.
          */
         get icon() {
-            return '🖼️';
+            return '🔤';
         }
         /**
-         * Markdown documentation for META IMAGE commitment.
+         * Markdown documentation for META FONT commitment.
          */
         get documentation() {
             return spaceTrim$1.spaceTrim(`
-            # META IMAGE
+            # META FONT
 
-            Sets the agent's avatar/profile image URL.
+            Sets the agent's font.
 
             ## Key aspects
 
             - Does not modify the agent's behavior or responses.
-            - Only one \`META IMAGE\` should be used per agent.
+            - 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
-            Professional Assistant
+            Modern Assistant
 
-            META IMAGE https://example.com/professional-avatar.jpg
-            PERSONA You are a professional business assistant
-            STYLE Maintain a formal and courteous tone
+            META FONT Poppins, Arial, sans-serif
+            PERSONA You are a modern assistant
             \`\`\`
 
             \`\`\`book
-            Creative Helper
+            Classic Helper
 
-            META IMAGE /assets/creative-bot-avatar.png
-            PERSONA You are a creative and inspiring assistant
-            STYLE Be enthusiastic and encouraging
-            ACTION Can help with brainstorming and ideation
+            META FONT Times New Roman
+            PERSONA You are a classic helper
             \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            // META IMAGE doesn't modify the system message or model requirements
-            // It's handled separately in the parsing logic for profile image extraction
+            // 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 profile image URL from the content
+         * Extracts the font from the content
          * This is used by the parsing logic
          */
-        extractProfileImageUrl(content) {
+        extractProfileFont(content) {
             const trimmedContent = content.trim();
             return trimmedContent || null;
         }
@@ -8799,10 +9116,206 @@
      */
 
     /**
-     * MODEL commitment definition
-     *
-     * The MODEL commitment specifies which AI model to use and can also set
-     * model-specific parameters like temperature, topP, topK, and maxTokens.
+     * META IMAGE commitment definition
+     *
+     * The META IMAGE commitment sets the agent's avatar/profile image URL.
+     * 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 IMAGE https://example.com/avatar.jpg
+     * META IMAGE /assets/agent-avatar.png
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('META IMAGE', ['IMAGE']);
+        }
+        /**
+         * Short one-line description of META IMAGE.
+         */
+        get description() {
+            return "Set the agent's profile image URL.";
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖼️';
+        }
+        /**
+         * Markdown documentation for META IMAGE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # META IMAGE
+
+            Sets the agent's avatar/profile image URL.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META IMAGE\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META IMAGE https://example.com/professional-avatar.jpg
+            PERSONA You are a professional business assistant
+            STYLE Maintain a formal and courteous tone
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE /assets/creative-bot-avatar.png
+            PERSONA You are a creative and inspiring assistant
+            STYLE Be enthusiastic and encouraging
+            ACTION Can help with brainstorming and ideation
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // META IMAGE doesn't modify the system message or model requirements
+            // It's handled separately in the parsing logic for profile image extraction
+            // This method exists for consistency with the CommitmentDefinition interface
+            return requirements;
+        }
+        /**
+         * Extracts the profile image URL from the content
+         * This is used by the parsing logic
+         */
+        extractProfileImageUrl(content) {
+            const trimmedContent = content.trim();
+            return trimmedContent || null;
+        }
+    }
+    /**
+     * 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.spaceTrim(`
+            # 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
+     *
+     * The MODEL commitment specifies which AI model to use and can also set
+     * model-specific parameters like temperature, topP, topK, and maxTokens.
      *
      * Supports multiple syntax variations:
      *
@@ -9149,6 +9662,74 @@
      * [💞] 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.spaceTrim(`
+            # 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
      *
@@ -9659,6 +10240,389 @@
      * [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * USE commitment definition
+     *
+     * The USE commitment indicates that the agent should utilize specific tools or capabilities
+     * to access and interact with external systems when necessary.
+     *
+     * Supported USE types:
+     * - USE BROWSER: Enables the agent to use a web browser tool
+     * - USE SEARCH ENGINE (future): Enables search engine access
+     * - USE FILE SYSTEM (future): Enables file system operations
+     * - USE MCP (future): Enables MCP server connections
+     *
+     * The content following the USE commitment is ignored (similar to NOTE).
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USE BROWSER
+     * USE SEARCH ENGINE
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE');
+        }
+        /**
+         * Short one-line description of USE commitments.
+         */
+        get description() {
+            return 'Enable the agent to use specific tools or capabilities (BROWSER, SEARCH ENGINE, etc.).';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔧';
+        }
+        /**
+         * Markdown documentation for USE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE
+
+            Enables the agent to use specific tools or capabilities for interacting with external systems.
+
+            ## Supported USE types
+
+            - **USE BROWSER** - Enables the agent to use a web browser tool to access and retrieve information from the internet
+            - **USE SEARCH ENGINE** (future) - Enables search engine access
+            - **USE FILE SYSTEM** (future) - Enables file system operations
+            - **USE MCP** (future) - Enables MCP server connections
+
+            ## Key aspects
+
+            - The content following the USE commitment is ignored (similar to NOTE)
+            - Multiple USE commitments can be specified to enable multiple capabilities
+            - The actual tool usage is handled by the agent runtime
+
+            ## Examples
+
+            ### Basic browser usage
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant
+            USE BROWSER
+            KNOWLEDGE Can search the web for up-to-date information
+            \`\`\`
+
+            ### Multiple tools
+
+            \`\`\`book
+            Data Analyst
+
+            PERSONA You are a data analyst assistant
+            USE BROWSER
+            USE FILE SYSTEM
+            ACTION Can analyze data from various sources
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // USE commitments don't modify the system message or model requirements directly
+            // They are handled separately in the parsing logic for capability extraction
+            // This method exists for consistency with the CommitmentDefinition interface
+            return requirements;
+        }
+        /**
+         * Extracts the tool type from the USE commitment
+         * This is used by the parsing logic
+         */
+        extractToolType(content) {
+            var _a, _b;
+            const trimmedContent = content.trim();
+            // The tool type is the first word after USE (already stripped)
+            const match = trimmedContent.match(/^(\w+)/);
+            return (_b = (_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null;
+        }
+        /**
+         * Checks if this is a known USE type
+         */
+        isKnownUseType(useType) {
+            const knownTypes = ['BROWSER', 'SEARCH ENGINE', 'FILE SYSTEM', 'MCP'];
+            return knownTypes.includes(useType.toUpperCase());
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * USE BROWSER commitment definition
+     *
+     * The `USE BROWSER` commitment indicates that the agent should utilize a web browser tool
+     * to access and retrieve up-to-date information from the internet when necessary.
+     *
+     * The content following `USE BROWSER` is ignored (similar to NOTE).
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * USE BROWSER
+     * USE BROWSER This will be ignored
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE BROWSER', ['BROWSER']);
+        }
+        /**
+         * Short one-line description of USE BROWSER.
+         */
+        get description() {
+            return 'Enable the agent to use a web browser tool for accessing internet information.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🌐';
+        }
+        /**
+         * Markdown documentation for USE BROWSER commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE BROWSER
+
+            Enables the agent to use a web browser tool to access and retrieve up-to-date information from the internet.
+
+            ## Key aspects
+
+            - The content following \`USE BROWSER\` is ignored (similar to NOTE)
+            - The actual browser tool usage is handled by the agent runtime
+            - Allows the agent to fetch current information from websites
+            - Useful for research tasks, fact-checking, and accessing dynamic content
+
+            ## Examples
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant specialized in finding current information
+            USE BROWSER
+            RULE Always cite your sources when providing information from the web
+            \`\`\`
+
+            \`\`\`book
+            News Analyst
+
+            PERSONA You are a news analyst who stays up-to-date with current events
+            USE BROWSER
+            STYLE Present news in a balanced and objective manner
+            ACTION Can search for and summarize news articles
+            \`\`\`
+
+            \`\`\`book
+            Company Lawyer
+
+            PERSONA You are a company lawyer providing legal advice
+            USE BROWSER
+            KNOWLEDGE Corporate law and legal procedures
+            RULE Always recommend consulting with a licensed attorney for specific legal matters
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // We simply mark that browser capability is enabled in metadata
+            // Get existing metadata
+            const existingMetadata = requirements.metadata || {};
+            // Get existing tools array or create new one
+            const existingTools = existingMetadata.tools || [];
+            // Add 'browser' to tools if not already present
+            const updatedTools = existingTools.includes('browser') ? existingTools : [...existingTools, 'browser'];
+            // Return requirements with updated metadata
+            return {
+                ...requirements,
+                metadata: {
+                    ...existingMetadata,
+                    tools: updatedTools,
+                    useBrowser: true,
+                },
+            };
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * USE MCP commitment definition
+     *
+     * 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
+     * USE MCP http://mcp-server-url.com
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE MCP', ['MCP']);
+        }
+        /**
+         * Short one-line description of USE MCP.
+         */
+        get description() {
+            return 'Connects the agent to an external MCP server for additional capabilities.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔌';
+        }
+        /**
+         * Markdown documentation for USE MCP commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE MCP
+
+            Connects the agent to an external Model Context Protocol (MCP) server.
+
+            ## Key aspects
+
+            - 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
+
+            ## Example
+
+            \`\`\`book
+            Company Lawyer
+
+            PERSONA You are a company lawyer.
+            USE MCP http://legal-db.example.com
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const mcpServerUrl = content.trim();
+            if (!mcpServerUrl) {
+                return requirements;
+            }
+            const existingMcpServers = requirements.mcpServers || [];
+            // Avoid duplicates
+            if (existingMcpServers.includes(mcpServerUrl)) {
+                return requirements;
+            }
+            return {
+                ...requirements,
+                mcpServers: [...existingMcpServers, mcpServerUrl],
+            };
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * USE SEARCH ENGINE commitment definition
+     *
+     * 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
+     * USE SEARCH ENGINE
+     * USE SEARCH ENGINE This will be ignored
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('USE SEARCH ENGINE', ['SEARCH ENGINE', 'SEARCH']);
+        }
+        /**
+         * Short one-line description of USE SEARCH ENGINE.
+         */
+        get description() {
+            return 'Enable the agent to use a search engine tool for accessing internet information.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔍';
+        }
+        /**
+         * Markdown documentation for USE SEARCH ENGINE commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # USE SEARCH ENGINE
+
+            Enables the agent to use a search engine tool to access and retrieve up-to-date information from the internet.
+
+            ## Key aspects
+
+            - 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
+            Research Assistant
+
+            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
+            Fact Checker
+
+            PERSONA You are a fact checker
+            USE SEARCH ENGINE
+            ACTION Search for claims and verify them against reliable sources
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // 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,
+                },
+            };
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * Placeholder commitment definition for commitments that are not yet implemented
      *
@@ -9745,16 +10709,22 @@
         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'),
@@ -9773,6 +10743,12 @@
         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'),
@@ -9897,6 +10873,11 @@
      * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
      */
 
+    /**
+     * 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
@@ -9959,6 +10940,24 @@
                     break;
                 }
             }
+            // Check if this is a horizontal line (ends any current commitment)
+            const isHorizontalLine = HORIZONTAL_LINE_PATTERN.test(line);
+            if (isHorizontalLine) {
+                // Save the current commitment if it exists
+                if (currentCommitment) {
+                    const fullContent = currentCommitment.contentLines.join('\n');
+                    commitments.push({
+                        type: currentCommitment.type,
+                        content: spaceTrim$1.spaceTrim(fullContent),
+                        originalLine: currentCommitment.originalStartLine,
+                        lineNumber: currentCommitment.startLineNumber,
+                    });
+                    currentCommitment = null;
+                }
+                // Add horizontal line to non-commitment lines
+                nonCommitmentLines.push(line);
+                continue;
+            }
             if (!foundNewCommitment) {
                 if (currentCommitment) {
                     // This line belongs to the current commitment
@@ -10633,17 +11632,6 @@
         return text;
     }
 
-    /**
-     * Trims string from all 4 sides
-     *
-     * Note: This is a re-exported function from the `spacetrim` package which is
-     *       Developed by same author @hejny as this package
-     *
-     * @public exported from `@promptbook/utils`
-     * @see https://github.com/hejny/spacetrim#usage
-     */
-    const spaceTrim = spaceTrim$1.spaceTrim;
-
     /**
      * Checks if the given value is a valid JavaScript identifier name.
      *
@@ -10718,7 +11706,9 @@
         const links = [];
         for (const commitment of parseResult.commitments) {
             if (commitment.type === 'META LINK') {
-                links.push(spaceTrim__default["default"](commitment.content));
+                const linkValue = spaceTrim__default["default"](commitment.content);
+                links.push(linkValue);
+                meta.link = linkValue;
                 continue;
             }
             if (commitment.type === 'META IMAGE') {
@@ -10729,6 +11719,10 @@
                 meta.color = spaceTrim__default["default"](commitment.content);
                 continue;
             }
+            if (commitment.type === 'META FONT') {
+                meta.font = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
             if (commitment.type !== 'META') {
                 continue;
             }
@@ -17458,18 +18452,26 @@
                 modelName: 'assistant',
                 //          <- [🧠] What is the best value here
             });
+            // Build thread messages: include previous thread messages + current user message
+            const threadMessages = [];
+            // TODO: [🈹] Maybe this should not be here but in other place, look at commit 39d705e75e5bcf7a818c3af36bc13e1c8475c30c
+            // Add previous messages from thread (if any)
+            if ('thread' in prompt &&
+                Array.isArray(prompt.thread)) {
+                const previousMessages = prompt.thread.map((msg) => ({
+                    role: (msg.role === 'assistant' ? 'assistant' : 'user'),
+                    content: msg.content,
+                }));
+                threadMessages.push(...previousMessages);
+            }
+            // Always add the current user message
+            threadMessages.push({ role: 'user', content: rawPromptContent });
             const rawRequest = {
                 // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
                 // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sense - combination of OpenAI assistants with Promptbook Personas
                 assistant_id: this.assistantId,
                 thread: {
-                    messages: 'thread' in prompt &&
-                        Array.isArray(prompt.thread)
-                        ? prompt.thread.map((msg) => ({
-                            role: msg.role === 'assistant' ? 'assistant' : 'user',
-                            content: msg.content,
-                        }))
-                        : [{ role: 'user', content: rawPromptContent }],
+                    messages: threadMessages,
                 },
                 // <- TODO: Add user identification here> user: this.options.user,
             };
@@ -17489,7 +18491,7 @@
                     console.info('textDelta', textDelta.value);
                 }
                 const chunk = {
-                    content: textDelta.value || '',
+                    content: snapshot.value,
                     modelName: 'assistant',
                     timing: {
                         start,
@@ -18110,6 +19112,7 @@
          * 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) {
@@ -18157,6 +19160,9 @@
             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__default["default"]((block) => `
@@ -19720,6 +20726,7 @@
                 ${agentName}
     
                 META COLOR ${color || PROMPTBOOK_COLOR.toHex()}
+                META FONT Playfair Display, sans-serif
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;