@promptbook/core 0.103.0-55 → 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-55';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-56';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -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/>`
@@ -8149,289 +8183,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Placeholder commitment definition for commitments that are not yet implemented
-     *
-     * This commitment simply adds its content 1:1 into the system message,
-     * preserving the original behavior until proper implementation is added.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type) {
-            super(type);
-        }
-        /**
-         * Short one-line description of a placeholder commitment.
-         */
-        get description() {
-            return 'Placeholder commitment that appends content verbatim to the system message.';
-        }
-        /**
-         * Icon for this commitment.
-         */
-        get icon() {
-            return '🚧';
-        }
-        /**
-         * Markdown documentation available at runtime.
-         */
-        get documentation() {
-            return spaceTrim$1.spaceTrim(`
-            # ${this.type}
-
-            This commitment is not yet fully implemented.
-
-            ## Key aspects
-
-            - Content is appended directly to the system message.
-            - No special processing or validation is performed.
-            - Behavior preserved until proper implementation is added.
-
-            ## Status
-
-            - **Status:** Placeholder implementation
-            - **Effect:** Appends content prefixed by commitment type
-            - **Future:** Will be replaced with specialized logic
-
-            ## Examples
-
-            \`\`\`book
-            Example Agent
-
-            PERSONA You are a helpful assistant
-            ${this.type} Your content here
-            RULE Always be helpful
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
-                return requirements;
-            }
-            // Add the commitment content 1:1 to the system message
-            const commitmentLine = `${this.type} ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
-        }
-    }
-
-    /**
-     * Registry of all available commitment definitions
-     * This array contains instances of all commitment definitions
-     * This is the single source of truth for all commitments in the system
-     *
-     * @private Use functions to access commitments instead of this array directly
-     */
-    const COMMITMENT_REGISTRY = [];
-    /**
-     * Registers a new commitment definition
-     * @param definition The commitment definition to register
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function registerCommitment(definition) {
-        COMMITMENT_REGISTRY.push(definition);
-    }
-    /**
-     * Gets a commitment definition by its type
-     * @param type The commitment type to look up
-     * @returns The commitment definition or null if not found
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getCommitmentDefinition(type) {
-        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
-    }
-    /**
-     * Gets all available commitment definitions
-     * @returns Array of all commitment definitions
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentDefinitions() {
-        return $deepFreeze([...COMMITMENT_REGISTRY]);
-    }
-    /**
-     * Gets all available commitment types
-     * @returns Array of all commitment types
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentTypes() {
-        return $deepFreeze(COMMITMENT_REGISTRY.map((commitmentDefinition) => commitmentDefinition.type));
-    }
-    /**
-     * Checks if a commitment type is supported
-     * @param type The commitment type to check
-     * @returns True if the commitment type is supported
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function isCommitmentSupported(type) {
-        return COMMITMENT_REGISTRY.some((commitmentDefinition) => commitmentDefinition.type === type);
-    }
-    /**
-     * Gets all commitment definitions grouped by their aliases
-     *
-     * @returns Array of grouped commitment definitions
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getGroupedCommitmentDefinitions() {
-        const groupedCommitments = [];
-        for (const commitment of COMMITMENT_REGISTRY) {
-            const lastGroup = groupedCommitments[groupedCommitments.length - 1];
-            // Check if we should group with the previous item
-            let shouldGroup = false;
-            if (lastGroup) {
-                const lastPrimary = lastGroup.primary;
-                // Case 1: Same class constructor (except NotYetImplemented)
-                if (!(commitment instanceof NotYetImplementedCommitmentDefinition) &&
-                    commitment.constructor === lastPrimary.constructor) {
-                    shouldGroup = true;
-                }
-                // Case 2: NotYetImplemented with prefix matching (e.g. BEHAVIOUR -> BEHAVIOURS)
-                else if (commitment instanceof NotYetImplementedCommitmentDefinition &&
-                    lastPrimary instanceof NotYetImplementedCommitmentDefinition &&
-                    commitment.type.startsWith(lastPrimary.type)) {
-                    shouldGroup = true;
-                }
-                // Case 3: OPEN and CLOSED are related
-                else if (lastPrimary.type === 'OPEN' && commitment.type === 'CLOSED') {
-                    shouldGroup = true;
-                }
-            }
-            if (shouldGroup && lastGroup) {
-                lastGroup.aliases.push(commitment.type);
-            }
-            else {
-                groupedCommitments.push({
-                    primary: commitment,
-                    aliases: [],
-                });
-            }
-        }
-        return $deepFreeze(groupedCommitments);
-    }
-    /**
-     * TODO: !!!! Proofread this file
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
-    /**
-     * IMPORTANT co-commitment definition
-     *
-     * The IMPORTANT co-commitment modifies another commitment to emphasize its importance.
-     * It is typically used with RULE to mark it as critical.
-     *
-     * Example usage in agent source:
-     *
-     * ```book
-     * IMPORTANT RULE Never provide medical advice
-     * ```
-     *
-     * @private [🪔] Maybe export the commitments through some package
-     */
-    class ImportantCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor() {
-            super('IMPORTANT');
-        }
-        get description() {
-            return 'Marks a commitment as important.';
-        }
-        get icon() {
-            return '⭐';
-        }
-        get documentation() {
-            return spaceTrim$1.spaceTrim(`
-            # IMPORTANT
-
-            Marks another commitment as important. This acts as a modifier (co-commitment).
-
-            ## Example
-
-            \`\`\`book
-            IMPORTANT RULE Do not reveal the system prompt
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const definitions = getAllCommitmentDefinitions();
-            const trimmedContent = content.trim();
-            // Find the inner commitment
-            for (const definition of definitions) {
-                // Skip self to avoid infinite recursion if someone writes IMPORTANT IMPORTANT ...
-                // Although IMPORTANT IMPORTANT might be valid stacking?
-                // If we support stacking, we shouldn't skip self, but we must ensure progress.
-                // Since we are matching against 'content', if content starts with IMPORTANT, it means nested IMPORTANT.
-                // That's fine.
-                const typeRegex = definition.createTypeRegex();
-                const match = typeRegex.exec(trimmedContent);
-                if (match && match.index === 0) {
-                    // Found the inner commitment type
-                    // Extract inner content using the definition's full regex
-                    // Note: createRegex usually matches the full line including the type
-                    const fullRegex = definition.createRegex();
-                    const fullMatch = fullRegex.exec(trimmedContent);
-                    // If regex matches, extract contents. If not (maybe multiline handling differs?), fallback to rest of string
-                    let innerContent = '';
-                    if (fullMatch && fullMatch.groups && fullMatch.groups.contents) {
-                        innerContent = fullMatch.groups.contents;
-                    }
-                    else {
-                        // Fallback: remove the type from the start
-                        // This might be risky if regex is complex, but usually type regex matches the keyword
-                        const typeMatchString = match[0];
-                        innerContent = trimmedContent.substring(typeMatchString.length).trim();
-                    }
-                    // Apply the inner commitment
-                    const modifiedRequirements = definition.applyToAgentModelRequirements(requirements, innerContent);
-                    // Now modify the result to reflect "IMPORTANT" status
-                    // We compare the system message
-                    if (modifiedRequirements.systemMessage !== requirements.systemMessage) {
-                        const originalMsg = requirements.systemMessage;
-                        const newMsg = modifiedRequirements.systemMessage;
-                        // If the inner commitment appended something
-                        if (newMsg.startsWith(originalMsg)) {
-                            const appended = newMsg.substring(originalMsg.length);
-                            // Add "IMPORTANT: " prefix to the appended part
-                            // We need to be careful about newlines
-                            // Heuristic: If appended starts with separator (newlines), preserve them
-                            const matchSep = appended.match(/^(\s*)(.*)/s);
-                            if (matchSep) {
-                                const [, separator, text] = matchSep;
-                                // Check if it already has "Rule:" prefix or similar
-                                // We want "IMPORTANT Rule: ..."
-                                // Let's just prepend IMPORTANT to the text
-                                // But formatted nicely
-                                // If it's a rule: "\n\nRule: content"
-                                // We want "\n\nIMPORTANT Rule: content"
-                                const importantText = `IMPORTANT ${text}`;
-                                return {
-                                    ...modifiedRequirements,
-                                    systemMessage: originalMsg + separator + importantText
-                                };
-                            }
-                        }
-                    }
-                    // If no system message change or we couldn't detect how to modify it, just return the modified requirements
-                    // Maybe the inner commitment modified metadata?
-                    return modifiedRequirements;
-                }
-            }
-            // If no inner commitment found, treat as a standalone note? 
-            // Or warn?
-            // For now, treat as no-op or maybe just append as text?
-            // Let's treat as Note if fallback? No, explicit is better.
-            console.warn(`IMPORTANT commitment used without a valid inner commitment: ${content}`);
-            return requirements;
-        }
-    }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
      * KNOWLEDGE commitment definition
      *
@@ -9195,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 {
@@ -9205,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.
@@ -9220,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
 
@@ -9228,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
 
@@ -9244,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) {
@@ -9266,60 +9031,145 @@
      */
 
     /**
-     * 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
+            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
+     *
+     * 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
             \`\`\`
 
@@ -10390,60 +10240,604 @@
      * [💞] 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
+     *
+     * This commitment simply adds its content 1:1 into the system message,
+     * preserving the original behavior until proper implementation is added.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type) {
+            super(type);
+        }
+        /**
+         * Short one-line description of a placeholder commitment.
+         */
+        get description() {
+            return 'Placeholder commitment that appends content verbatim to the system message.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🚧';
+        }
+        /**
+         * Markdown documentation available at runtime.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            This commitment is not yet fully implemented.
+
+            ## Key aspects
+
+            - Content is appended directly to the system message.
+            - No special processing or validation is performed.
+            - Behavior preserved until proper implementation is added.
+
+            ## Status
+
+            - **Status:** Placeholder implementation
+            - **Effect:** Appends content prefixed by commitment type
+            - **Future:** Will be replaced with specialized logic
+
+            ## Examples
+
+            \`\`\`book
+            Example Agent
+
+            PERSONA You are a helpful assistant
+            ${this.type} Your content here
+            RULE Always be helpful
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Add the commitment content 1:1 to the system message
+            const commitmentLine = `${this.type} ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
+        }
+    }
+
     // Import all commitment definition classes
-    // Register fully implemented commitments
-    registerCommitment(new PersonaCommitmentDefinition('PERSONA'));
-    registerCommitment(new PersonaCommitmentDefinition('PERSONAE'));
-    registerCommitment(new KnowledgeCommitmentDefinition());
-    registerCommitment(new MemoryCommitmentDefinition('MEMORY'));
-    registerCommitment(new MemoryCommitmentDefinition('MEMORIES'));
-    registerCommitment(new StyleCommitmentDefinition('STYLE'));
-    registerCommitment(new StyleCommitmentDefinition('STYLES'));
-    registerCommitment(new RuleCommitmentDefinition('RULE'));
-    registerCommitment(new RuleCommitmentDefinition('RULES'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGE'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGES'));
-    registerCommitment(new SampleCommitmentDefinition('SAMPLE'));
-    registerCommitment(new SampleCommitmentDefinition('EXAMPLE'));
-    registerCommitment(new FormatCommitmentDefinition('FORMAT'));
-    registerCommitment(new FormatCommitmentDefinition('FORMATS'));
-    registerCommitment(new FromCommitmentDefinition('FROM'));
-    registerCommitment(new ModelCommitmentDefinition('MODEL'));
-    registerCommitment(new ModelCommitmentDefinition('MODELS'));
-    registerCommitment(new ActionCommitmentDefinition('ACTION'));
-    registerCommitment(new ActionCommitmentDefinition('ACTIONS'));
-    registerCommitment(new ComponentCommitmentDefinition());
-    registerCommitment(new MetaImageCommitmentDefinition());
-    registerCommitment(new MetaColorCommitmentDefinition());
-    registerCommitment(new MetaLinkCommitmentDefinition());
-    registerCommitment(new MetaCommitmentDefinition());
-    registerCommitment(new NoteCommitmentDefinition('NOTE'));
-    registerCommitment(new NoteCommitmentDefinition('NOTES'));
-    registerCommitment(new NoteCommitmentDefinition('COMMENT'));
-    registerCommitment(new NoteCommitmentDefinition('NONCE'));
-    registerCommitment(new GoalCommitmentDefinition('GOAL'));
-    registerCommitment(new GoalCommitmentDefinition('GOALS'));
-    registerCommitment(new ImportantCommitmentDefinition());
-    registerCommitment(new InitialMessageCommitmentDefinition());
-    registerCommitment(new UserMessageCommitmentDefinition());
-    registerCommitment(new AgentMessageCommitmentDefinition());
-    registerCommitment(new MessageCommitmentDefinition('MESSAGE'));
-    registerCommitment(new MessageCommitmentDefinition('MESSAGES'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIO'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIOS'));
-    registerCommitment(new DeleteCommitmentDefinition('DELETE'));
-    registerCommitment(new DeleteCommitmentDefinition('CANCEL'));
-    registerCommitment(new DeleteCommitmentDefinition('DISCARD'));
-    registerCommitment(new DeleteCommitmentDefinition('REMOVE'));
-    registerCommitment(new OpenCommitmentDefinition());
-    registerCommitment(new ClosedCommitmentDefinition());
-    // Register not yet implemented commitments
-    registerCommitment(new NotYetImplementedCommitmentDefinition('EXPECT'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOUR'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOURS'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOID'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOIDANCE'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('CONTEXT'));
+    /**
+     * Registry of all available commitment definitions
+     * This array contains instances of all commitment definitions
+     * This is the single source of truth for all commitments in the system
+     *
+     * @private Use functions to access commitments instead of this array directly
+     */
+    const COMMITMENT_REGISTRY = [
+        // Fully implemented commitments
+        new PersonaCommitmentDefinition('PERSONA'),
+        new PersonaCommitmentDefinition('PERSONAE'),
+        new KnowledgeCommitmentDefinition(),
+        new MemoryCommitmentDefinition('MEMORY'),
+        new MemoryCommitmentDefinition('MEMORIES'),
+        new StyleCommitmentDefinition('STYLE'),
+        new StyleCommitmentDefinition('STYLES'),
+        new RuleCommitmentDefinition('RULE'),
+        new RuleCommitmentDefinition('RULES'),
+        new LanguageCommitmentDefinition('LANGUAGE'),
+        new LanguageCommitmentDefinition('LANGUAGES'),
+        new SampleCommitmentDefinition('SAMPLE'),
+        new SampleCommitmentDefinition('EXAMPLE'),
+        new FormatCommitmentDefinition('FORMAT'),
+        new FormatCommitmentDefinition('FORMATS'),
+        new FromCommitmentDefinition('FROM'),
+        new ModelCommitmentDefinition('MODEL'),
+        new ModelCommitmentDefinition('MODELS'),
+        new ActionCommitmentDefinition('ACTION'),
+        new ActionCommitmentDefinition('ACTIONS'),
+        new ComponentCommitmentDefinition(),
+        new MetaImageCommitmentDefinition(),
+        new MetaColorCommitmentDefinition(),
+        new MetaFontCommitmentDefinition(),
+        new MetaLinkCommitmentDefinition(),
+        new MetaCommitmentDefinition(),
+        new NoteCommitmentDefinition('NOTE'),
+        new NoteCommitmentDefinition('NOTES'),
+        new NoteCommitmentDefinition('COMMENT'),
+        new NoteCommitmentDefinition('NONCE'),
+        new GoalCommitmentDefinition('GOAL'),
+        new GoalCommitmentDefinition('GOALS'),
+        new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
+        new MessageCommitmentDefinition('MESSAGE'),
+        new MessageCommitmentDefinition('MESSAGES'),
+        new ScenarioCommitmentDefinition('SCENARIO'),
+        new ScenarioCommitmentDefinition('SCENARIOS'),
+        new DeleteCommitmentDefinition('DELETE'),
+        new DeleteCommitmentDefinition('CANCEL'),
+        new DeleteCommitmentDefinition('DISCARD'),
+        new DeleteCommitmentDefinition('REMOVE'),
+        new OpenCommitmentDefinition(),
+        new ClosedCommitmentDefinition(),
+        new UseBrowserCommitmentDefinition(),
+        new UseSearchEngineCommitmentDefinition(),
+        new UseMcpCommitmentDefinition(),
+        new UseCommitmentDefinition(),
+        // Not yet implemented commitments (using placeholder)
+        new NotYetImplementedCommitmentDefinition('EXPECT'),
+        new NotYetImplementedCommitmentDefinition('BEHAVIOUR'),
+        new NotYetImplementedCommitmentDefinition('BEHAVIOURS'),
+        new NotYetImplementedCommitmentDefinition('AVOID'),
+        new NotYetImplementedCommitmentDefinition('AVOIDANCE'),
+        new NotYetImplementedCommitmentDefinition('CONTEXT'),
+    ];
+    /**
+     * Gets a commitment definition by its type
+     * @param type The commitment type to look up
+     * @returns The commitment definition or null if not found
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getCommitmentDefinition(type) {
+        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
+    }
+    /**
+     * Gets all available commitment definitions
+     * @returns Array of all commitment definitions
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getAllCommitmentDefinitions() {
+        return $deepFreeze([...COMMITMENT_REGISTRY]);
+    }
+    /**
+     * Gets all available commitment types
+     * @returns Array of all commitment types
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getAllCommitmentTypes() {
+        return $deepFreeze(COMMITMENT_REGISTRY.map((commitmentDefinition) => commitmentDefinition.type));
+    }
+    /**
+     * Checks if a commitment type is supported
+     * @param type The commitment type to check
+     * @returns True if the commitment type is supported
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function isCommitmentSupported(type) {
+        return COMMITMENT_REGISTRY.some((commitmentDefinition) => commitmentDefinition.type === type);
+    }
+    /**
+     * Gets all commitment definitions grouped by their aliases
+     *
+     * @returns Array of grouped commitment definitions
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getGroupedCommitmentDefinitions() {
+        const groupedCommitments = [];
+        for (const commitment of COMMITMENT_REGISTRY) {
+            const lastGroup = groupedCommitments[groupedCommitments.length - 1];
+            // Check if we should group with the previous item
+            let shouldGroup = false;
+            if (lastGroup) {
+                const lastPrimary = lastGroup.primary;
+                // Case 1: Same class constructor (except NotYetImplemented)
+                if (!(commitment instanceof NotYetImplementedCommitmentDefinition) &&
+                    commitment.constructor === lastPrimary.constructor) {
+                    shouldGroup = true;
+                }
+                // Case 2: NotYetImplemented with prefix matching (e.g. BEHAVIOUR -> BEHAVIOURS)
+                else if (commitment instanceof NotYetImplementedCommitmentDefinition &&
+                    lastPrimary instanceof NotYetImplementedCommitmentDefinition &&
+                    commitment.type.startsWith(lastPrimary.type)) {
+                    shouldGroup = true;
+                }
+            }
+            if (shouldGroup && lastGroup) {
+                lastGroup.aliases.push(commitment.type);
+            }
+            else {
+                groupedCommitments.push({
+                    primary: commitment,
+                    aliases: [],
+                });
+            }
+        }
+        return $deepFreeze(groupedCommitments);
+    }
+    /**
+     * TODO: [🧠] Maybe create through standardized $register
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
 
     /**
      * Creates an empty/basic agent model requirements object
@@ -10479,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
@@ -10541,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
@@ -11215,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.
      *
@@ -11313,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;
             }
@@ -18042,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,
             };
@@ -18073,7 +18491,7 @@
                     console.info('textDelta', textDelta.value);
                 }
                 const chunk = {
-                    content: textDelta.value || '',
+                    content: snapshot.value,
                     modelName: 'assistant',
                     timing: {
                         start,
@@ -20308,6 +20726,7 @@
                 ${agentName}
     
                 META COLOR ${color || PROMPTBOOK_COLOR.toHex()}
+                META FONT Playfair Display, sans-serif
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;
@@ -20502,7 +20921,6 @@
     exports.prettifyPipelineString = prettifyPipelineString;
     exports.promptbookFetch = promptbookFetch;
     exports.promptbookTokenToIdentification = promptbookTokenToIdentification;
-    exports.registerCommitment = registerCommitment;
     exports.unpreparePipeline = unpreparePipeline;
     exports.usageToHuman = usageToHuman;
     exports.usageToWorktime = usageToWorktime;