@promptbook/cli 0.103.0-52 → 0.103.0-54

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.103.0-52",
+    "version": "0.103.0-54",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -99,7 +99,7 @@
         "@azure/openai": "1.0.0-beta.13",
         "@mozilla/readability": "0.6.0",
         "bottleneck": "2.19.5",
-        "colors": "^1.4.0",
+        "colors": "1.4.0",
         "commander": "12.0.0",
         "crypto": "1.0.1",
         "crypto-js": "4.2.0",

package/umd/index.umd.js

@@ -56,12 +56,23 @@
      * @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
      *
@@ -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) {
@@ -22527,6 +22544,12 @@
         get description() {
             return 'Define agent capabilities and actions it can perform.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '⚡';
+        }
         /**
          * Markdown documentation for ACTION commitment.
          */
@@ -22606,6 +22629,12 @@
         get description() {
             return 'Remove or **disregard** certain information, context, or previous commitments.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🗑️';
+        }
         /**
          * Markdown documentation for DELETE commitment.
          */
@@ -22722,6 +22751,12 @@
         get description() {
             return 'Specify output structure or formatting requirements.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '📜';
+        }
         /**
          * Markdown documentation for FORMAT commitment.
          */
@@ -22797,6 +22832,12 @@
         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.
          */
@@ -22893,6 +22934,12 @@
         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.
          */
@@ -22994,6 +23041,12 @@
         get description() {
             return 'Remember past interactions and user **preferences** for personalized responses.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🧠';
+        }
         /**
          * Markdown documentation for MEMORY commitment.
          */
@@ -23068,6 +23121,83 @@
      * 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.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
      *
@@ -23092,6 +23222,12 @@
         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.
          */
@@ -23150,6 +23286,12 @@
         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.
          */
@@ -23232,6 +23374,73 @@
      * 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.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
      *
@@ -23268,6 +23477,12 @@
         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.
          */
@@ -23395,6 +23610,12 @@
         get description() {
             return "Set the agent's accent color.";
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🎨';
+        }
         /**
          * Markdown documentation for META COLOR commitment.
          */
@@ -23473,6 +23694,12 @@
         get description() {
             return "Set the agent's profile image URL.";
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖼️';
+        }
         /**
          * Markdown documentation for META IMAGE commitment.
          */
@@ -23563,6 +23790,12 @@
         get description() {
             return 'Enforce AI model requirements including name and technical parameters.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '⚙️';
+        }
         /**
          * Markdown documentation for MODEL commitment.
          */
@@ -23798,6 +24031,12 @@
         get description() {
             return 'Add developer-facing notes without changing behavior or output.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '📝';
+        }
         /**
          * Markdown documentation for NOTE commitment.
          */
@@ -23900,6 +24139,12 @@
         get description() {
             return 'Define who the agent is: background, expertise, and personality.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '👤';
+        }
         /**
          * Markdown documentation for PERSONA commitment.
          */
@@ -24027,6 +24272,12 @@
         get description() {
             return 'Add behavioral rules the agent must follow.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '⚖️';
+        }
         /**
          * Markdown documentation for RULE/RULES commitment.
          */
@@ -24103,6 +24354,12 @@
         get description() {
             return 'Provide example responses to guide behavior.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔍';
+        }
         /**
          * Markdown documentation for SAMPLE/EXAMPLE commitment.
          */
@@ -24180,6 +24437,12 @@
         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.
          */
@@ -24296,6 +24559,12 @@
         get description() {
             return 'Control the tone and writing style of responses.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖋️';
+        }
         /**
          * Markdown documentation for STYLE commitment.
          */
@@ -24365,6 +24634,12 @@
         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.
          */
@@ -24445,6 +24720,8 @@
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),