@promptbook/cli 0.103.0-52 → 0.103.0-54

package/esm/index.es.js

@@ -47,12 +47,23 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-52';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-54';
 /**
  * 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
  *
@@ -74,6 +85,7 @@ const REMOTE_SERVER_URLS = [
         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
     {
@@ -86,7 +98,6 @@ const REMOTE_SERVER_URLS = [
     */
 ];
 /**
- * TODO: [🐱‍🚀] Auto-federated server from url in here
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
@@ -20681,12 +20692,15 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                         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) {
@@ -20775,12 +20789,15 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                         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) {
@@ -22518,6 +22535,12 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Define agent capabilities and actions it can perform.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '⚡';
+    }
     /**
      * Markdown documentation for ACTION commitment.
      */
@@ -22597,6 +22620,12 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Remove or **disregard** certain information, context, or previous commitments.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🗑️';
+    }
     /**
      * Markdown documentation for DELETE commitment.
      */
@@ -22713,6 +22742,12 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Specify output structure or formatting requirements.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '📜';
+    }
     /**
      * Markdown documentation for FORMAT commitment.
      */
@@ -22788,6 +22823,12 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Define main **goals** the AI assistant should achieve, with later goals having higher priority.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🎯';
+    }
     /**
      * Markdown documentation for GOAL commitment.
      */
@@ -22884,6 +22925,12 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Add domain **knowledge** via direct text or external sources (RAG).';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧠';
+    }
     /**
      * Markdown documentation for KNOWLEDGE commitment.
      */
@@ -22985,6 +23032,12 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Remember past interactions and user **preferences** for personalized responses.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧠';
+    }
     /**
      * Markdown documentation for MEMORY commitment.
      */
@@ -23059,6 +23112,83 @@ 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.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🤖';
+    }
+    /**
+     * Markdown documentation for AGENT MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${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
  *
@@ -23083,6 +23213,12 @@ class InitialMessageCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Defines the **initial message** shown to the user when the chat starts.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '👋';
+    }
     /**
      * Markdown documentation for INITIAL MESSAGE commitment.
      */
@@ -23141,6 +23277,12 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Include actual **messages** the AI assistant has sent during conversation history.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '💬';
+    }
     /**
      * Markdown documentation for MESSAGE commitment.
      */
@@ -23223,6 +23365,73 @@ 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.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧑';
+    }
+    /**
+     * Markdown documentation for USER MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${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
  *
@@ -23259,6 +23468,12 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Set meta-information about the agent (IMAGE, LINK, TITLE, DESCRIPTION, etc.).';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return 'ℹ️';
+    }
     /**
      * Markdown documentation for META commitment.
      */
@@ -23386,6 +23601,12 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return "Set the agent's accent color.";
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🎨';
+    }
     /**
      * Markdown documentation for META COLOR commitment.
      */
@@ -23464,6 +23685,12 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return "Set the agent's profile image URL.";
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🖼️';
+    }
     /**
      * Markdown documentation for META IMAGE commitment.
      */
@@ -23554,6 +23781,12 @@ class ModelCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Enforce AI model requirements including name and technical parameters.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '⚙️';
+    }
     /**
      * Markdown documentation for MODEL commitment.
      */
@@ -23789,6 +24022,12 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Add developer-facing notes without changing behavior or output.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '📝';
+    }
     /**
      * Markdown documentation for NOTE commitment.
      */
@@ -23891,6 +24130,12 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Define who the agent is: background, expertise, and personality.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '👤';
+    }
     /**
      * Markdown documentation for PERSONA commitment.
      */
@@ -24018,6 +24263,12 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Add behavioral rules the agent must follow.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '⚖️';
+    }
     /**
      * Markdown documentation for RULE/RULES commitment.
      */
@@ -24094,6 +24345,12 @@ class SampleCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Provide example responses to guide behavior.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔍';
+    }
     /**
      * Markdown documentation for SAMPLE/EXAMPLE commitment.
      */
@@ -24171,6 +24428,12 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Define specific **situations** or contexts for AI responses, with later scenarios having higher priority.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🎭';
+    }
     /**
      * Markdown documentation for SCENARIO commitment.
      */
@@ -24287,6 +24550,12 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
     get description() {
         return 'Control the tone and writing style of responses.';
     }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🖋️';
+    }
     /**
      * Markdown documentation for STYLE commitment.
      */
@@ -24356,6 +24625,12 @@ class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
     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.
      */
@@ -24436,6 +24711,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'),