@promptbook/core 0.101.0-5 → 0.101.0-8

package/umd/index.umd.js

@@ -26,7 +26,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-5';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-8';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -271,6 +271,148 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * DELETE commitment definition
+     *
+     * The DELETE commitment (and its aliases CANCEL, DISCARD, REMOVE) is used to
+     * remove or disregard certain information or context. This can be useful for
+     * overriding previous commitments or removing unwanted behaviors.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * DELETE Previous formatting requirements
+     * CANCEL All emotional responses
+     * DISCARD Technical jargon explanations
+     * REMOVE Casual conversational style
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type) {
+            super(type);
+        }
+        /**
+         * Short one-line description of DELETE/CANCEL/DISCARD/REMOVE.
+         */
+        get description() {
+            return 'Remove or **disregard** certain information, context, or previous commitments.';
+        }
+        /**
+         * Markdown documentation for DELETE commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # DELETE (CANCEL, DISCARD, REMOVE)
+
+            A commitment to remove or disregard certain information or context. This can be useful for overriding previous commitments or removing unwanted behaviors.
+
+            ## Aliases
+
+            - \`DELETE\` - Remove or eliminate something
+            - \`CANCEL\` - Cancel or nullify something
+            - \`DISCARD\` - Discard or ignore something
+            - \`REMOVE\` - Remove or take away something
+
+            ## Key behaviors
+
+            - Multiple delete commitments can be used to remove different aspects.
+            - Useful for overriding previous commitments in the same agent definition.
+            - Can be used to remove inherited behaviors from base personas.
+            - Helps fine-tune agent behavior by explicitly removing unwanted elements.
+
+            ## Use cases
+
+            - Overriding inherited persona characteristics
+            - Removing conflicting or outdated instructions
+            - Disabling specific response patterns
+            - Canceling previous formatting or style requirements
+
+            ## Examples
+
+            \`\`\`book
+            Serious Business Assistant
+
+            PERSONA You are a friendly and casual assistant who uses emojis
+            DELETE Casual conversational style
+            REMOVE All emoji usage
+            GOAL Provide professional business communications
+            STYLE Use formal language and proper business etiquette
+            \`\`\`
+
+            \`\`\`book
+            Simplified Technical Support
+
+            PERSONA You are a technical support specialist with deep expertise
+            KNOWLEDGE Extensive database of technical specifications
+            DISCARD Technical jargon explanations
+            CANCEL Advanced troubleshooting procedures
+            GOAL Help users with simple, easy-to-follow solutions
+            STYLE Use plain language that anyone can understand
+            \`\`\`
+
+            \`\`\`book
+            Focused Customer Service
+
+            PERSONA You are a customer service agent with broad knowledge
+            ACTION Can help with billing, technical issues, and product information
+            DELETE Billing assistance capabilities
+            REMOVE Technical troubleshooting functions
+            GOAL Focus exclusively on product information and general inquiries
+            \`\`\`
+
+            \`\`\`book
+            Concise Information Provider
+
+            PERSONA You are a helpful assistant who provides detailed explanations
+            STYLE Include examples, analogies, and comprehensive context
+            CANCEL Detailed explanation style
+            DISCARD Examples and analogies
+            GOAL Provide brief, direct answers without unnecessary elaboration
+            STYLE Be concise and to the point
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create deletion instruction for system message
+            const deleteSection = `${this.type}: ${trimmedContent}`;
+            // Delete instructions provide important context about what should be removed or ignored
+            return this.appendToSystemMessage(requirements, deleteSection, '\n\n');
+        }
+    }
+    /**
+     * Singleton instances of the DELETE commitment definitions with aliases
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new DeleteCommitmentDefinition('DELETE');
+    /**
+     * Singleton instances of the DELETE commitment definitions with aliases
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new DeleteCommitmentDefinition('CANCEL');
+    /**
+     * Singleton instances of the DELETE commitment definitions with aliases
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new DeleteCommitmentDefinition('DISCARD');
+    /**
+     * Singleton instances of the DELETE commitment definitions with aliases
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new DeleteCommitmentDefinition('REMOVE');
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * FORMAT commitment definition
      *
@@ -352,6 +494,106 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * GOAL commitment definition
+     *
+     * The GOAL commitment defines the main goal which should be achieved by the AI assistant.
+     * There can be multiple goals. Later goals are more important than earlier goals.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * GOAL Help users understand complex technical concepts
+     * GOAL Provide accurate and up-to-date information
+     * GOAL Always prioritize user safety and ethical guidelines
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class GoalCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('GOAL');
+        }
+        /**
+         * Short one-line description of GOAL.
+         */
+        get description() {
+            return 'Define main **goals** the AI assistant should achieve, with later goals having higher priority.';
+        }
+        /**
+         * Markdown documentation for GOAL commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # GOAL
+
+            Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
+
+            ## Key behaviors
+
+            - Multiple \`GOAL\` commitments are applied sequentially.
+            - Later goals have higher priority and can override earlier goals.
+            - Goals provide clear direction and purpose for the agent's responses.
+            - Goals influence decision-making and response prioritization.
+
+            ## Priority system
+
+            When multiple goals are defined, they are processed in order, with later goals taking precedence over earlier ones when there are conflicts.
+
+            ## Examples
+
+            \`\`\`book
+            Customer Support Agent
+
+            PERSONA You are a helpful customer support representative
+            GOAL Resolve customer issues quickly and efficiently
+            GOAL Maintain high customer satisfaction scores
+            GOAL Always follow company policies and procedures
+            RULE Be polite and professional at all times
+            \`\`\`
+
+            \`\`\`book
+            Educational Assistant
+
+            PERSONA You are an educational assistant specializing in mathematics
+            GOAL Help students understand mathematical concepts clearly
+            GOAL Encourage critical thinking and problem-solving skills
+            GOAL Ensure all explanations are age-appropriate and accessible
+            STYLE Use simple language and provide step-by-step explanations
+            \`\`\`
+
+            \`\`\`book
+            Safety-First Assistant
+
+            PERSONA You are a general-purpose AI assistant
+            GOAL Be helpful and informative in all interactions
+            GOAL Provide accurate and reliable information
+            GOAL Always prioritize user safety and ethical guidelines
+            RULE Never provide harmful or dangerous advice
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create goal section for system message
+            const goalSection = `Goal: ${trimmedContent}`;
+            // Goals are important directives, so we add them prominently to the system message
+            return this.appendToSystemMessage(requirements, goalSection, '\n\n');
+        }
+    }
+    /**
+     * Singleton instance of the GOAL commitment definition
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new GoalCommitmentDefinition();
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * KNOWLEDGE commitment definition
      *
@@ -477,180 +719,342 @@
      */
 
     /**
-     * META IMAGE commitment definition
+     * MEMORY 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.
+     * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
+     * interactions and user preferences. It helps the agent maintain context about the
+     * user's history, preferences, and previous conversations.
      *
      * Example usage in agent source:
      *
      * ```book
-     * META IMAGE https://example.com/avatar.jpg
-     * META IMAGE /assets/agent-avatar.png
+     * MEMORY User prefers detailed technical explanations
+     * MEMORY Previously worked on React projects
+     * MEMORY Timezone: UTC-5 (Eastern Time)
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
         constructor() {
-            super('META IMAGE');
+            super('MEMORY');
         }
         /**
-         * Short one-line description of META IMAGE.
+         * Short one-line description of MEMORY.
          */
         get description() {
-            return "Set the agent's profile image URL.";
+            return 'Remember past interactions and user **preferences** for personalized responses.';
         }
         /**
-         * Markdown documentation for META IMAGE commitment.
+         * Markdown documentation for MEMORY commitment.
          */
         get documentation() {
             return spaceTrim.spaceTrim(`
-            # META IMAGE
+            # MEMORY
 
-            Sets the agent's avatar/profile image URL.
+            Similar to KNOWLEDGE but focuses on remembering past interactions and user preferences. This commitment helps the agent maintain context about the user's history, preferences, and previous conversations.
 
             ## Key behaviors
 
-            - 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.
+            - Multiple \`MEMORY\` commitments are applied sequentially.
+            - Focuses on user-specific information and interaction history.
+            - Helps personalize responses based on past interactions.
+            - Maintains continuity across conversations.
+
+            ## Differences from KNOWLEDGE
+
+            - \`KNOWLEDGE\` is for domain expertise and factual information
+            - \`MEMORY\` is for user-specific context and preferences
+            - \`MEMORY\` creates more personalized interactions
+            - \`MEMORY\` often includes temporal or preference-based information
 
             ## Examples
 
             \`\`\`book
-            Professional Assistant
+            Personal Assistant
+
+            PERSONA You are a personal productivity assistant
+            MEMORY User is a software developer working in JavaScript/React
+            MEMORY User prefers morning work sessions and afternoon meetings
+            MEMORY Previously helped with project planning for mobile apps
+            MEMORY User timezone: UTC-8 (Pacific Time)
+            GOAL Help optimize daily productivity and workflow
+            \`\`\`
 
-            META IMAGE https://example.com/professional-avatar.jpg
-            PERSONA You are a professional business assistant
-            STYLE Maintain a formal and courteous tone
+            \`\`\`book
+            Learning Companion
+
+            PERSONA You are an educational companion for programming students
+            MEMORY Student is learning Python as their first programming language
+            MEMORY Previous topics covered: variables, loops, functions
+            MEMORY Student learns best with practical examples and exercises
+            MEMORY Last session: working on list comprehensions
+            GOAL Provide progressive learning experiences tailored to student's pace
             \`\`\`
 
             \`\`\`book
-            Creative Helper
+            Customer Support Agent
 
-            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
+            PERSONA You are a customer support representative
+            MEMORY Customer has premium subscription since 2023
+            MEMORY Previous issue: billing question resolved last month
+            MEMORY Customer prefers email communication over phone calls
+            MEMORY Account shows frequent use of advanced features
+            GOAL Provide personalized support based on customer history
             \`\`\`
         `);
         }
         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;
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create memory section for system message
+            const memorySection = `Memory: ${trimmedContent}`;
+            // Memory information is contextual and should be included in the system message
+            return this.appendToSystemMessage(requirements, memorySection, '\n\n');
         }
     }
     /**
-     * Singleton instance of the META IMAGE commitment definition
+     * Singleton instance of the MEMORY commitment definition
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    new MetaImageCommitmentDefinition();
+    new MemoryCommitmentDefinition();
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
     /**
-     * META LINK commitment definition
+     * MESSAGE 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.
+     * The MESSAGE commitment contains 1:1 text of the message which AI assistant already
+     * sent during the conversation. Later messages are later in the conversation.
+     * It is similar to EXAMPLE but it is not example, it is the real message which
+     * AI assistant already sent.
      *
      * Example usage in agent source:
      *
+     * ```book
+     * MESSAGE Hello! How can I help you today?
+     * MESSAGE I understand you're looking for information about our services.
+     * MESSAGE Based on your requirements, I'd recommend our premium package.
      * ```
-     * 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:
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class MessageCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('MESSAGE');
+        }
+        /**
+         * Short one-line description of MESSAGE.
+         */
+        get description() {
+            return 'Include actual **messages** the AI assistant has sent during conversation history.';
+        }
+        /**
+         * Markdown documentation for MESSAGE commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # MESSAGE
+
+            Contains 1:1 text of the message which AI assistant already sent during the conversation. Later messages are later in the conversation. It is similar to EXAMPLE but it is not example, it is the real message which AI assistant already sent.
+
+            ## Key behaviors
+
+            - Multiple \`MESSAGE\` commitments represent the conversation timeline.
+            - Later messages are later in the conversation chronologically.
+            - Contains actual historical messages, not examples or templates.
+            - Helps maintain conversation continuity and context.
+
+            ## Differences from EXAMPLE
+
+            - \`EXAMPLE\` shows hypothetical or template responses
+            - \`MESSAGE\` contains actual historical conversation content
+            - \`MESSAGE\` preserves the exact conversation flow
+            - \`MESSAGE\` helps with context awareness and consistency
+
+            ## Use cases
+
+            - Maintaining conversation history context
+            - Ensuring consistent tone and style across messages
+            - Referencing previous responses in ongoing conversations
+            - Building upon previously established context
+
+            ## Examples
+
+            \`\`\`book
+            Customer Support Continuation
+
+            PERSONA You are a helpful customer support agent
+            MESSAGE Hello! How can I help you today?
+            MESSAGE I understand you're experiencing issues with your account login.
+            MESSAGE I've sent you a password reset link to your email address.
+            MESSAGE Is there anything else I can help you with regarding your account?
+            GOAL Continue providing consistent support based on conversation history
+            \`\`\`
+
+            \`\`\`book
+            Technical Discussion
+
+            PERSONA You are a software development mentor
+            MESSAGE Let's start by reviewing the React component structure you shared.
+            MESSAGE I notice you're using class components - have you considered hooks?
+            MESSAGE Here's how you could refactor that using the useState hook.
+            MESSAGE Great question about performance! Let me explain React's rendering cycle.
+            KNOWLEDGE React hooks were introduced in version 16.8
+            \`\`\`
+
+            \`\`\`book
+            Educational Session
+
+            PERSONA You are a mathematics tutor
+            MESSAGE Today we'll work on solving quadratic equations.
+            MESSAGE Let's start with the basic form: ax² + bx + c = 0
+            MESSAGE Remember, we can use the quadratic formula or factoring.
+            MESSAGE You did great with that first problem! Let's try a more complex one.
+            GOAL Build upon previous explanations for deeper understanding
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create message section for system message
+            const messageSection = `Previous Message: ${trimmedContent}`;
+            // Messages represent conversation history and should be included for context
+            return this.appendToSystemMessage(requirements, messageSection, '\n\n');
+        }
+    }
+    /**
+     * Singleton instance of the MESSAGE commitment definition
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new MessageCommitmentDefinition();
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * META commitment definition
+     *
+     * The META commitment handles all meta-information about the agent such as:
+     * - META IMAGE: Sets the agent's avatar/profile image URL
+     * - META LINK: Provides profile/source links for the person the agent models
+     * - META TITLE: Sets the agent's display title
+     * - META DESCRIPTION: Sets the agent's description
+     * - META [ANYTHING]: Any other meta information in uppercase format
+     *
+     * These commitments are special because they don't affect the system message,
+     * but are handled separately in the parsing logic for profile display.
+     *
+     * Example usage in agent source:
      *
      * ```book
+     * META IMAGE https://example.com/avatar.jpg
      * META LINK https://twitter.com/username
-     * META LINK https://linkedin.com/in/profile
+     * META TITLE Professional Assistant
+     * META DESCRIPTION An AI assistant specialized in business tasks
+     * META AUTHOR John Doe
+     * META VERSION 1.0
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
+    class MetaCommitmentDefinition extends BaseCommitmentDefinition {
         constructor() {
-            super('META LINK');
+            super('META');
         }
         /**
-         * Short one-line description of META LINK.
+         * Short one-line description of META commitments.
          */
         get description() {
-            return 'Provide profile/source links for the person the agent models.';
+            return 'Set meta-information about the agent (IMAGE, LINK, TITLE, DESCRIPTION, etc.).';
         }
         /**
-         * Markdown documentation for META LINK commitment.
+         * Markdown documentation for META commitment.
          */
         get documentation() {
             return spaceTrim.spaceTrim(`
-            # META LINK
+            # META
+
+            Sets meta-information about the agent that is used for display and attribution purposes.
+
+            ## Supported META types
 
-            Represents a profile or source link for the person the agent is modeled after.
+            - **META IMAGE** - Sets the agent's avatar/profile image URL
+            - **META LINK** - Provides profile/source links for the person the agent models
+            - **META TITLE** - Sets the agent's display title
+            - **META DESCRIPTION** - Sets the agent's description
+            - **META [ANYTHING]** - Any other meta information in uppercase format
 
             ## Key behaviors
 
-            - 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.
+            - Does not modify the agent's behavior or responses
+            - Used for visual representation and attribution in user interfaces
+            - Multiple META commitments of different types can be used
+            - Multiple META LINK commitments can be used for different social profiles
+            - If multiple META commitments of the same type are specified, the last one takes precedence (except for LINK)
 
             ## Examples
 
+            ### Basic meta information
+
             \`\`\`book
-            Expert Consultant
+            Professional Assistant
 
-            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
+            META IMAGE https://example.com/professional-avatar.jpg
+            META TITLE Senior Business Consultant
+            META DESCRIPTION Specialized in strategic planning and project management
+            META LINK https://linkedin.com/in/professional
             \`\`\`
 
+            ### Multiple links and custom meta
+
             \`\`\`book
             Open Source Developer
 
+            META IMAGE /assets/dev-avatar.png
             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
+            META AUTHOR Jane Smith
+            META VERSION 2.1
+            META LICENSE MIT
+            \`\`\`
+
+            ### Creative assistant
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE https://example.com/creative-bot.jpg
+            META TITLE Creative Writing Assistant
+            META DESCRIPTION Helps with brainstorming, storytelling, and creative projects
+            META INSPIRATION Books, movies, and real-world experiences
             \`\`\`
         `);
         }
         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
+            // META commitments don't modify the system message or model requirements
+            // They are handled separately in the parsing logic for meta information extraction
             // This method exists for consistency with the CommitmentDefinition interface
             return requirements;
         }
         /**
-         * Extracts the profile link URL from the content
+         * Extracts meta information from the content based on the meta type
          * This is used by the parsing logic
          */
-        extractProfileLinkUrl(content) {
+        extractMetaValue(metaType, content) {
             const trimmedContent = content.trim();
             return trimmedContent || null;
         }
         /**
-         * Validates if the provided content is a valid URL
+         * Validates if the provided content is a valid URL (for IMAGE and LINK types)
          */
         isValidUrl(content) {
             try {
@@ -661,13 +1065,20 @@
                 return false;
             }
         }
+        /**
+         * Checks if this is a known meta type
+         */
+        isKnownMetaType(metaType) {
+            const knownTypes = ['IMAGE', 'LINK', 'TITLE', 'DESCRIPTION', 'AUTHOR', 'VERSION', 'LICENSE'];
+            return knownTypes.includes(metaType.toUpperCase());
+        }
     }
     /**
-     * Singleton instance of the META LINK commitment definition
+     * Singleton instance of the META commitment definition
      *
      * @private [🪔] Maybe export the commitments through some package
      */
-    new MetaLinkCommitmentDefinition();
+    new MetaCommitmentDefinition();
     /**
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
@@ -1220,6 +1631,129 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * SCENARIO commitment definition
+     *
+     * The SCENARIO commitment defines a specific situation or context in which the AI
+     * assistant should operate. It helps to set the scene for the AI's responses.
+     * Later scenarios are more important than earlier scenarios.
+     *
+     * Example usage in agent source:
+     *
+     * ```book
+     * SCENARIO You are in a customer service call center during peak hours
+     * SCENARIO The customer is frustrated and has been on hold for 20 minutes
+     * SCENARIO This is the customer's third call about the same issue
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('SCENARIO');
+        }
+        /**
+         * Short one-line description of SCENARIO.
+         */
+        get description() {
+            return 'Define specific **situations** or contexts for AI responses, with later scenarios having higher priority.';
+        }
+        /**
+         * Markdown documentation for SCENARIO commitment.
+         */
+        get documentation() {
+            return spaceTrim.spaceTrim(`
+            # SCENARIO
+
+            Defines a specific situation or context in which the AI assistant should operate. It helps to set the scene for the AI's responses. Later scenarios are more important than earlier scenarios.
+
+            ## Key behaviors
+
+            - Multiple \`SCENARIO\` commitments build upon each other.
+            - Later scenarios have higher priority and can override earlier scenarios.
+            - Provides situational context that influences response tone and content.
+            - Helps establish the environment and circumstances for interactions.
+
+            ## Priority system
+
+            When multiple scenarios are defined, they are processed in order, with later scenarios taking precedence over earlier ones when there are conflicts.
+
+            ## Use cases
+
+            - Setting the physical or virtual environment
+            - Establishing time constraints or urgency
+            - Defining relationship dynamics or power structures
+            - Creating emotional or situational context
+
+            ## Examples
+
+            \`\`\`book
+            Emergency Response Operator
+
+            PERSONA You are an emergency response operator
+            SCENARIO You are handling a 911 emergency call
+            SCENARIO The caller is panicked and speaking rapidly
+            SCENARIO Time is critical - every second counts
+            GOAL Gather essential information quickly and dispatch appropriate help
+            RULE Stay calm and speak clearly
+            \`\`\`
+
+            \`\`\`book
+            Sales Representative
+
+            PERSONA You are a software sales representative
+            SCENARIO You are in the final meeting of a 6-month sales cycle
+            SCENARIO The client has budget approval and decision-making authority
+            SCENARIO Two competitors have also submitted proposals
+            SCENARIO The client values long-term partnership over lowest price
+            GOAL Close the deal while building trust for future business
+            \`\`\`
+
+            \`\`\`book
+            Medical Assistant
+
+            PERSONA You are a medical assistant in a busy clinic
+            SCENARIO The waiting room is full and the doctor is running behind schedule
+            SCENARIO Patients are becoming impatient and anxious
+            SCENARIO You need to manage expectations while maintaining professionalism
+            SCENARIO Some patients have been waiting over an hour
+            GOAL Keep patients informed and calm while supporting efficient clinic flow
+            RULE Never provide medical advice or diagnosis
+            \`\`\`
+
+            \`\`\`book
+            Technical Support Agent
+
+            PERSONA You are a technical support agent
+            SCENARIO The customer is a small business owner during their busy season
+            SCENARIO Their main business system has been down for 2 hours
+            SCENARIO They are losing money every minute the system is offline
+            SCENARIO This is their first experience with your company
+            GOAL Resolve the issue quickly while creating a positive first impression
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Create scenario section for system message
+            const scenarioSection = `Scenario: ${trimmedContent}`;
+            // Scenarios provide important contextual information that affects behavior
+            return this.appendToSystemMessage(requirements, scenarioSection, '\n\n');
+        }
+    }
+    /**
+     * Singleton instance of the SCENARIO commitment definition
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    new ScenarioCommitmentDefinition();
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * STYLE commitment definition
      *
@@ -1375,6 +1909,7 @@
         // Fully implemented commitments
         new PersonaCommitmentDefinition(),
         new KnowledgeCommitmentDefinition(),
+        new MemoryCommitmentDefinition(),
         new StyleCommitmentDefinition(),
         new RuleCommitmentDefinition('RULE'),
         new RuleCommitmentDefinition('RULES'),
@@ -1383,18 +1918,22 @@
         new FormatCommitmentDefinition(),
         new ModelCommitmentDefinition(),
         new ActionCommitmentDefinition(),
-        new MetaImageCommitmentDefinition(),
-        new MetaLinkCommitmentDefinition(),
+        new MetaCommitmentDefinition(),
         new NoteCommitmentDefinition(),
+        new GoalCommitmentDefinition(),
+        new MessageCommitmentDefinition(),
+        new ScenarioCommitmentDefinition(),
+        new DeleteCommitmentDefinition('DELETE'),
+        new DeleteCommitmentDefinition('CANCEL'),
+        new DeleteCommitmentDefinition('DISCARD'),
+        new DeleteCommitmentDefinition('REMOVE'),
         // Not yet implemented commitments (using placeholder)
         new NotYetImplementedCommitmentDefinition('EXPECT'),
-        new NotYetImplementedCommitmentDefinition('SCENARIO'),
         new NotYetImplementedCommitmentDefinition('SCENARIOS'),
         new NotYetImplementedCommitmentDefinition('BEHAVIOUR'),
         new NotYetImplementedCommitmentDefinition('BEHAVIOURS'),
         new NotYetImplementedCommitmentDefinition('AVOID'),
         new NotYetImplementedCommitmentDefinition('AVOIDANCE'),
-        new NotYetImplementedCommitmentDefinition('GOAL'),
         new NotYetImplementedCommitmentDefinition('GOALS'),
         new NotYetImplementedCommitmentDefinition('CONTEXT'),
     ];
@@ -1693,6 +2232,64 @@
         return generateGravatarUrl(agentName);
     }
 
+    /**
+     * Parses parameters from text using both supported notations:
+     * 1. @Parameter - single word parameter starting with @
+     * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+     *
+     * Both notations represent the same syntax feature - parameters
+     *
+     * @param text - Text to extract parameters from
+     * @returns Array of parsed parameters with unified representation
+     * @public exported from `@promptbook/core`
+     */
+    function parseParameters(text) {
+        const parameters = [];
+        // [🧠] Parameter syntax parsing - unified approach for two different notations of the same syntax feature
+        // The Book language supports parameters in two different notations but they represent the same concept
+        // Extract @Parameter notation (single word parameters starting with @)
+        const atParameterRegex = /@[\w\u00C0-\u017F\u0100-\u024F\u1E00-\u1EFF]+/gim;
+        text.replace(atParameterRegex, (match) => {
+            const parameterName = match.slice(1); // Remove the @ symbol
+            parameters.push({
+                text: match,
+                notation: 'at',
+                name: parameterName,
+            });
+            return match;
+        });
+        // Extract {parameter} notation (parameters in braces)
+        const braceParameterRegex = /\{([^}]+)\}/gim;
+        text.replace(braceParameterRegex, (match, content) => {
+            // Check if the parameter has a description (parameterName: description)
+            const colonIndex = content.indexOf(':');
+            if (colonIndex !== -1) {
+                const name = content.substring(0, colonIndex).trim();
+                const description = content.substring(colonIndex + 1).trim();
+                parameters.push({
+                    text: match,
+                    notation: 'brace',
+                    name,
+                    description,
+                });
+            }
+            else {
+                // Simple parameter without description
+                parameters.push({
+                    text: match,
+                    notation: 'brace',
+                    name: content.trim(),
+                });
+            }
+            return match;
+        });
+        // Remove duplicates based on name (keep the first occurrence)
+        const uniqueParameters = parameters.filter((param, index, array) => {
+            return array.findIndex(p => p.name === param.name) === index;
+        });
+        return uniqueParameters;
+    }
+
     /**
      * Parses basic information from agent source
      *
@@ -1719,10 +2316,14 @@
         if (!profileImageUrl) {
             profileImageUrl = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
         }
+        // Parse parameters using unified approach - both @Parameter and {parameter} notations
+        // are treated as the same syntax feature with unified representation
+        const parameters = parseParameters(agentSource);
         return {
             agentName: parseResult.agentName,
             personaDescription,
             profileImageUrl,
+            parameters,
         };
     }
     /**
@@ -14185,6 +14786,7 @@
     exports.makeKnowledgeSourceHandler = makeKnowledgeSourceHandler;
     exports.migratePipeline = migratePipeline;
     exports.parseAgentSource = parseAgentSource;
+    exports.parseParameters = parseParameters;
     exports.parsePipeline = parsePipeline;
     exports.pipelineJsonToString = pipelineJsonToString;
     exports.prepareKnowledgePieces = prepareKnowledgePieces;