@promptbook/browser 0.103.0-51 → 0.103.0-53

package/esm/index.es.js

@@ -19,7 +19,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-51';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-53';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2660,9 +2660,13 @@ function normalizeAgentName(rawAgentName) {
  *
  * @private - TODO: [🧠] Maybe should be public?
  */
-function createCommitmentRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
     return regex;
 }
@@ -2675,9 +2679,13 @@ function createCommitmentRegex(commitment) {
  *
  * @private
  */
-function createCommitmentTypeRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentTypeRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b`, 'gim');
     return regex;
 }
@@ -2689,22 +2697,23 @@ function createCommitmentTypeRegex(commitment) {
  * @private
  */
 class BaseCommitmentDefinition {
-    constructor(type) {
+    constructor(type, aliases = []) {
         this.type = type;
+        this.aliases = aliases;
     }
     /**
      * Creates a regex pattern to match this commitment in agent source
      * Uses the existing createCommitmentRegex function as internal helper
      */
     createRegex() {
-        return createCommitmentRegex(this.type);
+        return createCommitmentRegex(this.type, this.aliases);
     }
     /**
      * Creates a regex pattern to match just the commitment type
      * Uses the existing createCommitmentTypeRegex function as internal helper
      */
     createTypeRegex() {
-        return createCommitmentTypeRegex(this.type);
+        return createCommitmentTypeRegex(this.type, this.aliases);
     }
     /**
      * Helper method to create a new requirements object with updated system message
@@ -3315,6 +3324,77 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * AGENT MESSAGE commitment definition
+ *
+ * The AGENT MESSAGE commitment defines a message from the agent in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * AGENT MESSAGE What seems to be the issue?
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class AgentMessageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('AGENT MESSAGE');
+    }
+    /**
+     * Short one-line description of AGENT MESSAGE.
+     */
+    get description() {
+        return 'Defines a **message from the agent** in the conversation history.';
+    }
+    /**
+     * Markdown documentation for AGENT MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim(`
+            # ${this.type}
+
+            Defines a message from the agent in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+
+            ## Key aspects
+
+            - Represents a message sent by the agent.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with USER MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // AGENT MESSAGE is for UI display purposes / conversation history construction
+        // and typically doesn't need to be added to the system prompt or model requirements directly.
+        // It is extracted separately for the chat interface.
+        var _a;
+        const pendingUserMessage = (_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.pendingUserMessage;
+        if (pendingUserMessage) {
+            const newSample = { question: pendingUserMessage, answer: content };
+            const newSamples = [...(requirements.samples || []), newSample];
+            const newMetadata = { ...requirements.metadata };
+            delete newMetadata.pendingUserMessage;
+            return {
+                ...requirements,
+                samples: newSamples,
+                metadata: newMetadata,
+            };
+        }
+        return requirements;
+    }
+}
+
 /**
  * INITIAL MESSAGE commitment definition
  *
@@ -3479,6 +3559,67 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * USER MESSAGE commitment definition
+ *
+ * The USER MESSAGE commitment defines a message from the user in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USER MESSAGE Hello, I have a problem.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UserMessageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USER MESSAGE');
+    }
+    /**
+     * Short one-line description of USER MESSAGE.
+     */
+    get description() {
+        return 'Defines a **message from the user** in the conversation history.';
+    }
+    /**
+     * Markdown documentation for USER MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim(`
+            # ${this.type}
+
+            Defines a message from the user in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+
+            ## Key aspects
+
+            - Represents a message sent by the user.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with AGENT MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        return {
+            ...requirements,
+            metadata: {
+                ...requirements.metadata,
+                pendingUserMessage: content,
+            },
+        };
+    }
+}
+
 /**
  * META commitment definition
  *
@@ -3616,6 +3757,165 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * META COLOR commitment definition
+ *
+ * The META COLOR commitment sets the agent's accent color.
+ * 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 COLOR #ff0000
+ * META COLOR #00ff00
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META COLOR', ['COLOR']);
+    }
+    /**
+     * Short one-line description of META COLOR.
+     */
+    get description() {
+        return "Set the agent's accent color.";
+    }
+    /**
+     * Markdown documentation for META COLOR commitment.
+     */
+    get documentation() {
+        return spaceTrim(`
+            # META COLOR
+
+            Sets the agent's accent color.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - 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.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META COLOR #3498db
+            PERSONA You are a professional business assistant
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META COLOR #e74c3c
+            PERSONA You are a creative and inspiring assistant
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META COLOR doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile color extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile color from the content
+     * This is used by the parsing logic
+     */
+    extractProfileColor(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.";
+    }
+    /**
+     * Markdown documentation for META IMAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim(`
+            # META IMAGE
+
+            Sets the agent's avatar/profile image URL.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META IMAGE\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META IMAGE https://example.com/professional-avatar.jpg
+            PERSONA You are a professional business assistant
+            STYLE Maintain a formal and courteous tone
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE /assets/creative-bot-avatar.png
+            PERSONA You are a creative and inspiring assistant
+            STYLE Be enthusiastic and encouraging
+            ACTION Can help with brainstorming and ideation
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META IMAGE doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile image extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile image URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileImageUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MODEL commitment definition
  *
@@ -4523,6 +4823,8 @@ const COMMITMENT_REGISTRY = [
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),
     new ActionCommitmentDefinition('ACTIONS'),
+    new MetaImageCommitmentDefinition(),
+    new MetaColorCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -4531,6 +4833,8 @@ const COMMITMENT_REGISTRY = [
     new GoalCommitmentDefinition('GOAL'),
     new GoalCommitmentDefinition('GOALS'),
     new InitialMessageCommitmentDefinition(),
+    new UserMessageCommitmentDefinition(),
+    new AgentMessageCommitmentDefinition(),
     new MessageCommitmentDefinition('MESSAGE'),
     new MessageCommitmentDefinition('MESSAGES'),
     new ScenarioCommitmentDefinition('SCENARIO'),
@@ -4752,6 +5056,14 @@ function parseAgentSource(agentSource) {
             links.push(spaceTrim$1(commitment.content));
             continue;
         }
+        if (commitment.type === 'META IMAGE') {
+            meta.image = spaceTrim$1(commitment.content);
+            continue;
+        }
+        if (commitment.type === 'META COLOR') {
+            meta.color = spaceTrim$1(commitment.content);
+            continue;
+        }
         if (commitment.type !== 'META') {
             continue;
         }
@@ -4767,6 +5079,10 @@ function parseAgentSource(agentSource) {
     if (!meta.image) {
         meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
     }
+    // Generate fullname fallback if no meta fullname specified
+    if (!meta.fullname) {
+        meta.fullname = parseResult.agentName || createDefaultAgentName(agentSource);
+    }
     // Parse parameters using unified approach - both @Parameter and {parameter} notations
     // are treated as the same syntax feature with unified representation
     const parameters = parseParameters(agentSource);