@promptbook/wizard 0.103.0-52 → 0.103.0-54

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "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,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.103.0-52"
+        "@promptbook/core": "0.103.0-54"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.17",
@@ -104,7 +104,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",
         "crypto": "1.0.1",
         "crypto-js": "4.2.0",
         "dotenv": "16.3.2",

package/umd/index.umd.js

@@ -48,12 +48,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
      *
@@ -75,6 +86,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
         {
@@ -87,7 +99,6 @@
         */
     ];
     /**
-     * TODO: [🐱‍🚀] Auto-federated server from url in here
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
@@ -7074,12 +7085,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) {
@@ -7168,12 +7182,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) {
@@ -13553,6 +13570,12 @@
         get description() {
             return 'Define agent capabilities and actions it can perform.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '⚡';
+        }
         /**
          * Markdown documentation for ACTION commitment.
          */
@@ -13632,6 +13655,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.
          */
@@ -13748,6 +13777,12 @@
         get description() {
             return 'Specify output structure or formatting requirements.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '📜';
+        }
         /**
          * Markdown documentation for FORMAT commitment.
          */
@@ -13823,6 +13858,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.
          */
@@ -13919,6 +13960,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.
          */
@@ -14020,6 +14067,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.
          */
@@ -14094,6 +14147,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
      *
@@ -14118,6 +14248,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.
          */
@@ -14176,6 +14312,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.
          */
@@ -14258,6 +14400,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
      *
@@ -14294,6 +14503,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.
          */
@@ -14421,6 +14636,12 @@
         get description() {
             return "Set the agent's accent color.";
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🎨';
+        }
         /**
          * Markdown documentation for META COLOR commitment.
          */
@@ -14499,6 +14720,12 @@
         get description() {
             return "Set the agent's profile image URL.";
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖼️';
+        }
         /**
          * Markdown documentation for META IMAGE commitment.
          */
@@ -14589,6 +14816,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.
          */
@@ -14824,6 +15057,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.
          */
@@ -14926,6 +15165,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.
          */
@@ -15053,6 +15298,12 @@
         get description() {
             return 'Add behavioral rules the agent must follow.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '⚖️';
+        }
         /**
          * Markdown documentation for RULE/RULES commitment.
          */
@@ -15129,6 +15380,12 @@
         get description() {
             return 'Provide example responses to guide behavior.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔍';
+        }
         /**
          * Markdown documentation for SAMPLE/EXAMPLE commitment.
          */
@@ -15206,6 +15463,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.
          */
@@ -15322,6 +15585,12 @@
         get description() {
             return 'Control the tone and writing style of responses.';
         }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🖋️';
+        }
         /**
          * Markdown documentation for STYLE commitment.
          */
@@ -15391,6 +15660,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.
          */
@@ -15471,6 +15746,8 @@
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),