@promptbook/core 0.103.0-51 → 0.103.0-52

package/esm/typings/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -49,6 +49,7 @@ export type AgentBasicInformation = {
      * When there are multiple meta commitments of the same type, later overrides earlier
      */
     meta: {
+        fullname?: string;
         image?: string_url_image;
         color?: string_color;
         [key: string]: string | undefined;

package/esm/typings/src/book-2.0/agent-source/createCommitmentRegex.d.ts

@@ -7,7 +7,7 @@ import type { BookCommitment } from '../../commitments/_base/BookCommitment';
  *
  * @private - TODO: [🧠] Maybe should be public?
  */
-export declare function createCommitmentRegex(commitment: BookCommitment): RegExp;
+export declare function createCommitmentRegex(commitment: BookCommitment, aliases?: BookCommitment[]): RegExp;
 /**
  * Generates a regex pattern to match a specific commitment type
  *
@@ -17,4 +17,4 @@ export declare function createCommitmentRegex(commitment: BookCommitment): RegEx
  *
  * @private
  */
-export declare function createCommitmentTypeRegex(commitment: BookCommitment): RegExp;
+export declare function createCommitmentTypeRegex(commitment: BookCommitment, aliases?: BookCommitment[]): RegExp;

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -77,6 +77,12 @@ export type ChatProps = {
      * adding feature–specific controls (e.g. Pause / Resume in MockedChat).
      */
     readonly extraActions?: ReactNode;
+    /**
+     * Optional container to render the actions into (using React Portal).
+     * If provided, the actions toolbar will be rendered inside this element
+     * instead of its default position within the chat.
+     */
+    readonly actionsContainer?: HTMLElement | null;
     /**
      * Optional CSS class name which will be added to root <div/> element
      */

package/esm/typings/src/book-components/PromptbookAgent/PromptbookAgent.d.ts

@@ -1,3 +1,4 @@
+import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
 type PromptbookAgentProps = {
     /**
      * URL of the agent to connect to
@@ -5,6 +6,11 @@ type PromptbookAgentProps = {
      * @example "http://s6.ptbk.io/benjamin-white"
      */
     agentUrl: string;
+    /**
+     * Optional metadata to show before the agent is connected
+     * Or to override the agent metadata if the agent does not provide it
+     */
+    meta?: Partial<AgentBasicInformation['meta']>;
     /**
      * Callback when the window is opened or closed
      */

package/esm/typings/src/commitments/META_COLOR/META_COLOR.d.ts

@@ -0,0 +1,38 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * 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
+ */
+export declare class MetaColorCommitmentDefinition extends BaseCommitmentDefinition<'META COLOR'> {
+    constructor();
+    /**
+     * Short one-line description of META COLOR.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for META COLOR commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts the profile color from the content
+     * This is used by the parsing logic
+     */
+    extractProfileColor(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/_base/BaseCommitmentDefinition.d.ts

@@ -8,7 +8,8 @@ import type { CommitmentDefinition } from './CommitmentDefinition';
  */
 export declare abstract class BaseCommitmentDefinition<TBookCommitment extends string> implements CommitmentDefinition {
     readonly type: TBookCommitment;
-    constructor(type: TBookCommitment);
+    readonly aliases: string[];
+    constructor(type: TBookCommitment, aliases?: string[]);
     /**
      * Short one-line markdown description; concise, may use inline **markdown**.
      * Must be implemented by each concrete commitment.

package/esm/typings/src/commitments/index.d.ts

@@ -9,6 +9,8 @@ import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
 import { InitialMessageCommitmentDefinition } from './MESSAGE/InitialMessageCommitmentDefinition';
 import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
 import { MetaCommitmentDefinition } from './META/META';
+import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
+import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
 import { PersonaCommitmentDefinition } from './PERSONA/PERSONA';
@@ -24,7 +26,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

package/esm/typings/src/llm-providers/agent/Agent.d.ts

@@ -45,6 +45,7 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
      * Metadata like image or color
      */
     meta: {
+        fullname?: string;
         image?: string_url_image;
         link?: string;
         title?: string;

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.103.0-50`).
+ * It follows semantic versioning (e.g., `0.103.0-51`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.103.0-51",
+    "version": "0.103.0-52",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-51';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-52';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -7445,9 +7445,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;
     }
@@ -7460,9 +7464,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;
     }
@@ -7474,22 +7482,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
@@ -8401,6 +8410,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$1.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$1.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
      *
@@ -9308,6 +9476,8 @@
         new ModelCommitmentDefinition('MODELS'),
         new ActionCommitmentDefinition('ACTION'),
         new ActionCommitmentDefinition('ACTIONS'),
+        new MetaImageCommitmentDefinition(),
+        new MetaColorCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new NoteCommitmentDefinition('NOTE'),
         new NoteCommitmentDefinition('NOTES'),
@@ -10221,6 +10391,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;
             }
@@ -10236,6 +10414,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);
@@ -17265,7 +17447,7 @@
         }
         get title() {
             const agentInfo = this.getAgentInfo();
-            return (agentInfo.agentName || 'Agent');
+            return (agentInfo.meta.fullname || agentInfo.agentName || 'Agent');
         }
         get description() {
             const agentInfo = this.getAgentInfo();
@@ -17278,7 +17460,7 @@
             }
             return {
                 name: agentInfo.agentName.toUpperCase().replace(/\s+/g, '_'),
-                fullname: agentInfo.agentName,
+                fullname: agentInfo.meta.fullname || agentInfo.agentName,
                 color: agentInfo.meta.color || '#6366f1',
                 avatarSrc: agentInfo.meta.image,
             };
@@ -17510,12 +17692,10 @@
 
                 ---
 
-                SAMPLE
-
-                User:
+                USER MESSAGE
                 ${block(prompt.content)}
 
-                ${this.title} (Me, the Agent):
+                AGENT MESSAGE
                 ${block(result.content)}
 
             `);