@promptbook/cli 0.103.0-51 → 0.103.0-53

package/umd/index.umd.js

@@ -56,12 +56,23 @@
      * @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
      */
 
+    /**
+     * Core Promptbook server configuration.
+     *
+     * This server is also used for auto-federation in the Agents Server.
+     */
+    const CORE_SERVER = {
+        title: 'Promptbook Core',
+        description: `Core Promptbook server used for auto-federation`,
+        owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+        urls: ['https://core.ptbk.io/'],
+    };
     /**
      * Available remote servers for the Promptbook
      *
@@ -83,6 +94,7 @@
             owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
             urls: ['https://s6.ptbk.io/'],
         },
+        CORE_SERVER,
         /*
         Note: Working on older version of Promptbook and not supported anymore
         {
@@ -95,7 +107,6 @@
         */
     ];
     /**
-     * TODO: [🐱‍🚀] Auto-federated server from url in here
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
@@ -20690,12 +20701,15 @@
                             fileStreams.push(file);
                         }
                         else {
+                            /*
+                            TODO: [🐱‍🚀] Resolve problem with browser environment
                             // Assume it's a local file path
                             // Note: This will work in Node.js environment
                             // For browser environments, this would need different handling
                             const fs = await import('fs');
                             const fileStream = fs.createReadStream(source);
                             fileStreams.push(fileStream);
+                            */
                         }
                     }
                     catch (error) {
@@ -20784,12 +20798,15 @@
                             fileStreams.push(file);
                         }
                         else {
+                            /*
+                            TODO: [🐱‍🚀] Resolve problem with browser environment
                             // Assume it's a local file path
                             // Note: This will work in Node.js environment
                             // For browser environments, this would need different handling
                             const fs = await import('fs');
                             const fileStream = fs.createReadStream(source);
                             fileStreams.push(fileStream);
+                            */
                         }
                     }
                     catch (error) {
@@ -22404,9 +22421,13 @@
      *
      * @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;
     }
@@ -22419,9 +22440,13 @@
      *
      * @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;
     }
@@ -22433,22 +22458,23 @@
      * @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
@@ -23059,6 +23085,77 @@
      * 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.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
      *
@@ -23223,6 +23320,67 @@
      * 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.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
      *
@@ -23360,6 +23518,165 @@
      * 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.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.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
      *
@@ -24267,6 +24584,8 @@
         new ModelCommitmentDefinition('MODELS'),
         new ActionCommitmentDefinition('ACTION'),
         new ActionCommitmentDefinition('ACTIONS'),
+        new MetaImageCommitmentDefinition(),
+        new MetaColorCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new NoteCommitmentDefinition('NOTE'),
         new NoteCommitmentDefinition('NOTES'),
@@ -24275,6 +24594,8 @@
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),
@@ -24719,6 +25040,14 @@
                 links.push(spaceTrim__default["default"](commitment.content));
                 continue;
             }
+            if (commitment.type === 'META IMAGE') {
+                meta.image = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
+            if (commitment.type === 'META COLOR') {
+                meta.color = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
             if (commitment.type !== 'META') {
                 continue;
             }
@@ -24734,6 +25063,10 @@
         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);