@promptbook/components 0.112.0-43 → 0.112.0-45

package/README.md

@@ -130,7 +130,7 @@ interface BookEditorProps {
     onChange?: (value: string) => void;
 
     // Explicit list of commitment keywords to highlight (case-insensitive).
-    // If omitted, a default set (PERSONA, KNOWLEDGE, MEMORY, STYLE, RULE, RULES, SAMPLE, EXAMPLE, FORMAT, MODEL, ACTION, META IMAGE, META LINK, NOTE, GOAL, MESSAGE, SCENARIO, DELETE, CANCEL, DISCARD, REMOVE, EXPECT, SCENARIOS, BEHAVIOUR, BEHAVIOURS, AVOID, AVOIDANCE, GOALS, CONTEXT) is used.
+    // If omitted, a default set (PERSONA, KNOWLEDGE, MEMORY, STYLE, RULE, RULES, WRITING SAMPLE, WRITING RULES, SAMPLE, EXAMPLE, FORMAT, MODEL, ACTION, META IMAGE, META LINK, NOTE, GOAL, MESSAGE, SCENARIO, DELETE, CANCEL, DISCARD, REMOVE, EXPECT, SCENARIOS, BEHAVIOUR, BEHAVIOURS, AVOID, AVOIDANCE, GOALS, CONTEXT) is used.
     commitmentTypes?: string[];
 }
 ```

package/esm/index.es.js

@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-45';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -6678,7 +6678,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             DELETE Casual conversational style
             REMOVE All emoji usage
             GOAL Provide professional business communications
-            STYLE Use formal language and proper business etiquette
+            WRITING RULES Use formal language and proper business etiquette
             \`\`\`
 
             \`\`\`book
@@ -6689,7 +6689,7 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             DISCARD Technical jargon explanations
             CANCEL Advanced troubleshooting procedures
             GOAL Help users with simple, easy-to-follow solutions
-            STYLE Use plain language that anyone can understand
+            WRITING RULES Use plain language that anyone can understand
             \`\`\`
 
             \`\`\`book
@@ -6706,11 +6706,11 @@ class DeleteCommitmentDefinition extends BaseCommitmentDefinition {
             Concise Information Provider
 
             PERSONA You are a helpful assistant who provides detailed explanations
-            STYLE Include examples, analogies, and comprehensive context
+            WRITING RULES Include examples, analogies, and comprehensive context
             CANCEL Detailed explanation style
             DISCARD Examples and analogies
             GOAL Provide brief, direct answers without unnecessary elaboration
-            STYLE Be concise and to the point
+            WRITING RULES Be concise and to the point
             \`\`\`
         `);
     }
@@ -6894,7 +6894,7 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
             PERSONA You are a data analysis expert
             FORMAT Present results in structured tables
             FORMAT Include confidence scores for all predictions
-            STYLE Be concise and precise in explanations
+            WRITING RULES Be concise and precise in explanations
             \`\`\`
         `);
     }
@@ -7254,7 +7254,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of GOAL.
      */
     get description() {
-        return 'Define main **goals** the AI assistant should achieve, with later goals having higher priority.';
+        return 'Define the effective agent **goal**; when multiple goals exist, only the last one stays effective.';
     }
     /**
      * Icon for this commitment.
@@ -7269,12 +7269,14 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
+            Defines the main goal which should be achieved by the AI assistant.
+            There can be multiple goals in source, but after inheritance/source rewriting only the last \`GOAL\` /\`GOALS\` remains effective.
 
             ## Key aspects
 
             - Both terms work identically and can be used interchangeably.
-            - Later goals have higher priority and can override earlier goals.
+            - Later goals overwrite earlier goals.
+            - The public agent profile text is derived from the last goal.
             - Goals provide clear direction and purpose for the agent's responses.
             - Goals influence decision-making and response prioritization.
 
@@ -7287,9 +7289,7 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Customer Support Agent
 
-            PERSONA You are a helpful customer support representative
             GOAL Resolve customer issues quickly and efficiently
-            GOAL Maintain high customer satisfaction scores
             GOAL Always follow company policies and procedures
             RULE Be polite and professional at all times
             \`\`\`
@@ -7297,19 +7297,15 @@ class GoalCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Educational Assistant
 
-            PERSONA You are an educational assistant specializing in mathematics
             GOAL Help students understand mathematical concepts clearly
-            GOAL Encourage critical thinking and problem-solving skills
             GOAL Ensure all explanations are age-appropriate and accessible
-            STYLE Use simple language and provide step-by-step explanations
+            WRITING RULES Use simple language and provide step-by-step explanations
             \`\`\`
 
             \`\`\`book
             Safety-First Assistant
 
-            PERSONA You are a general-purpose AI assistant
             GOAL Be helpful and informative in all interactions
-            GOAL Provide accurate and reliable information
             GOAL Always prioritize user safety and ethical guidelines
             RULE Never provide harmful or dangerous advice
             \`\`\`
@@ -7617,7 +7613,7 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             KNOWLEDGE Academic research requires careful citation and verification
             KNOWLEDGE https://example.com/research-guidelines.pdf
             ACTION Can help with literature reviews and data analysis
-            STYLE Present information in clear, academic format
+            WRITING RULES Present information in clear, academic format
             \`\`\`
         `);
     }
@@ -9368,7 +9364,7 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
 
             META IMAGE https://example.com/professional-avatar.jpg
             PERSONA You are a professional business assistant
-            STYLE Maintain a formal and courteous tone
+            WRITING RULES Maintain a formal and courteous tone
             \`\`\`
 
             \`\`\`book
@@ -9376,7 +9372,7 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
 
             META IMAGE /assets/creative-bot-avatar.png
             PERSONA You are a creative and inspiring assistant
-            STYLE Be enthusiastic and encouraging
+            WRITING RULES Be enthusiastic and encouraging
             ACTION Can help with brainstorming and ideation
             \`\`\`
         `);
@@ -9535,7 +9531,7 @@ class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
             META LINK https://twitter.com/devhandle
             PERSONA You are an experienced open source developer
             ACTION Can help with code reviews and architecture decisions
-            STYLE Be direct and technical in explanations
+            WRITING RULES Be direct and technical in explanations
             \`\`\`
         `);
     }
@@ -9741,7 +9737,7 @@ class ModelCommitmentDefinition extends BaseCommitmentDefinition {
             MODEL TEMPERATURE 0.8
             MODEL TOP_P 0.9
             MODEL MAX_TOKENS 2048
-            STYLE Be imaginative and expressive
+            WRITING RULES Be imaginative and expressive
             ACTION Can help with storytelling and character development
             \`\`\`
 
@@ -9953,7 +9949,7 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
             NOTE Uses RAG for accessing latest research papers
             PERSONA You are a knowledgeable research assistant
             ACTION Can help with literature reviews and citations
-            STYLE Present information in academic format
+            WRITING RULES Present information in academic format
             \`\`\`
         `);
     }
@@ -10068,7 +10064,16 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of PERSONA.
      */
     get description() {
-        return 'Define who the agent is: background, expertise, and personality.';
+        return 'Deprecated legacy profile commitment. Prefer `GOAL` for agent profile text and inheritance-safe rewrites.';
+    }
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation() {
+        return {
+            message: 'Use `GOAL` for agent profile text and inheritance-safe rewrites.',
+            replacedBy: ['GOAL'],
+        };
     }
     /**
      * Icon for this commitment.
@@ -10083,16 +10088,24 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines who the agent is, their background, expertise, and personality traits.
+            Deprecated legacy commitment that defines who the agent is, their background, expertise, and personality traits.
 
-            ## Key aspects
+            ## Migration
 
-            - Multiple \`PERSONA\` and \`PERSONAE\` commitments are merged together.
-            - Both terms work identically and can be used interchangeably.
-            - If they are in conflict, the last one takes precedence.
-            - You can write persona content in multiple lines.
+            - Existing \`${this.type}\` books still parse and compile.
+            - New books should prefer \`GOAL\`.
+            - Agent profile rendering now prefers the last \`GOAL\` and only falls back to \`${this.type}\` when no goal exists.
+            - Runtime compilation keeps the legacy multi-\`PERSONA\` merge behavior for backward compatibility.
 
-            ## Examples
+            ## Preferred replacement
+
+            \`\`\`book
+            Programming Assistant
+
+            GOAL Help the user solve programming problems with practical TypeScript and React guidance.
+            \`\`\`
+
+            ## Legacy compatibility example
 
             \`\`\`book
             Programming Assistant
@@ -10230,7 +10243,7 @@ class RuleCommitmentDefinition extends BaseCommitmentDefinition {
             RULE Always ask for clarification if the user's request is ambiguous
             RULE Be polite and professional in all interactions
             RULES Never provide medical or legal advice
-            STYLE Maintain a friendly and helpful tone
+            WRITING RULES Maintain a friendly and helpful tone
             \`\`\`
 
             \`\`\`book
@@ -10499,8 +10512,8 @@ class ScenarioCommitmentDefinition extends BaseCommitmentDefinition {
 /**
  * STYLE commitment definition
  *
- * The STYLE commitment defines how the agent should format and present its responses.
- * This includes tone, writing style, formatting preferences, and communication patterns.
+ * Deprecated legacy writing-style commitment kept for backward compatibility.
+ * New books should prefer `WRITING RULES` for writing-only constraints.
  *
  * Example usage in agent source:
  *
@@ -10519,7 +10532,16 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of STYLE.
      */
     get description() {
-        return 'Control the tone and writing style of responses.';
+        return 'Deprecated legacy writing-style commitment. Prefer `WRITING RULES` for new books.';
+    }
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation() {
+        return {
+            message: 'Use `WRITING RULES` for writing-only constraints such as tone, length, formatting, or emoji usage.',
+            replacedBy: ['WRITING RULES'],
+        };
     }
     /**
      * Icon for this commitment.
@@ -10534,15 +10556,34 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # ${this.type}
 
-            Defines how the agent should format and present its responses (tone, writing style, formatting).
+            Deprecated legacy commitment for writing and presentation instructions.
+
+            ## Migration
+
+            - Existing \`${this.type}\` books still parse and compile.
+            - New books should prefer \`WRITING RULES\`.
+            - Use \`WRITING SAMPLE\` when you want to anchor voice by example instead of stating constraints directly.
+            - The plural alias \`STYLES\` is the same legacy commitment family.
 
             ## Key aspects
 
-            - Both terms work identically and can be used interchangeably.
+            - \`${this.type}\` remains functional for backward compatibility only.
             - Later style instructions can override earlier ones.
             - Style affects both tone and presentation format.
 
-            ## Examples
+            ## Preferred replacement
+
+            \`\`\`book
+            Technical Writer
+
+            GOAL Help the user understand technical topics with practical, accurate guidance.
+            WRITING RULES Write in a professional but friendly tone.
+            WRITING RULES Use bullet points for lists.
+            WRITING RULES Always provide code examples when explaining programming concepts.
+            FORMAT Use markdown formatting with clear headings
+            \`\`\`
+
+            ## Legacy compatibility examples
 
             \`\`\`book
             Technical Writer
@@ -10857,7 +10898,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
             \`\`\`book
             Legal Assistant
 
-            PERSONA An expert software developer
+            GOAL Get expert software-development advice from the teammate when legal discussion needs technical context.
             TEAM You can talk with http://localhost:4440/agents/GMw67JN8TXxN7y to discuss the legal aspects.
             \`\`\`
         `);
@@ -11283,7 +11324,7 @@ class TemplateCommitmentDefinition extends BaseCommitmentDefinition {
 
             PERSONA You are a helpful customer support representative
             TEMPLATE Always structure your response with: 1) Acknowledgment, 2) Solution, 3) Follow-up question
-            STYLE Be professional and empathetic
+            WRITING RULES Be professional and empathetic
             \`\`\`
 
             \`\`\`book
@@ -11727,7 +11768,7 @@ class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
 
             PERSONA You are a news analyst who stays up-to-date with current events
             USE BROWSER
-            STYLE Present news in a balanced and objective manner
+            WRITING RULES Present news in a balanced and objective manner
             ACTION Can search for and summarize news articles
             \`\`\`
 
@@ -17446,7 +17487,7 @@ function parseParameters(text) {
 function parseAgentSource(agentSource) {
     const parseResult = parseAgentSourceWithCommitments(agentSource);
     const resolvedAgentName = parseResult.agentName || createDefaultAgentName(agentSource);
-    const personaDescription = extractPersonaDescription(parseResult.commitments);
+    const personaDescription = extractAgentProfileText(parseResult.commitments);
     const initialMessage = extractInitialMessage(parseResult.commitments);
     const parsedProfile = extractParsedAgentProfile(parseResult.commitments);
     ensureMetaFullname(parsedProfile.meta, resolvedAgentName);
@@ -17550,25 +17591,33 @@ const META_COMMITMENT_APPLIERS = {
  */
 const LOCAL_AGENT_REFERENCE_PREFIXES = ['./', '../', '/'];
 /**
- * Builds the combined persona description from PERSONA commitments.
+ * Resolves the public agent profile text from the last GOAL/GOALS commitment,
+ * falling back to the deprecated PERSONA/PERSONAE commitments when no goal exists.
  *
  * @private internal utility of `parseAgentSource`
  */
-function extractPersonaDescription(commitments) {
-    let personaDescription = null;
+function extractAgentProfileText(commitments) {
+    let goalDescription = '';
+    let hasGoalDescription = false;
+    let personaDescription = '';
+    let hasPersonaDescription = false;
     for (const commitment of commitments) {
-        if (commitment.type !== 'PERSONA') {
-            continue;
+        if (commitment.type === 'GOAL' || commitment.type === 'GOALS') {
+            goalDescription = commitment.content;
+            hasGoalDescription = true;
         }
-        if (personaDescription === null) {
-            personaDescription = '';
-        }
-        else {
-            personaDescription += `\n\n${personaDescription}`;
+        if (commitment.type === 'PERSONA' || commitment.type === 'PERSONAE') {
+            personaDescription = commitment.content;
+            hasPersonaDescription = true;
         }
-        personaDescription += commitment.content;
     }
-    return personaDescription;
+    if (hasGoalDescription) {
+        return goalDescription;
+    }
+    if (hasPersonaDescription) {
+        return personaDescription;
+    }
+    return null;
 }
 /**
  * Resolves the last INITIAL MESSAGE commitment, which is the public initial-message value.
@@ -31121,6 +31170,15 @@ const COMMITMENTS_WITH_AGENT_REFERENCES = new Set(['FROM', 'IMPORT', 'IMPORTS',
  * @private internal constant of `createAgentModelRequirementsWithCommitments`
  */
 const DELETE_COMMITMENT_TYPES = new Set(['DELETE', 'CANCEL', 'DISCARD', 'REMOVE']);
+/**
+ * Commitments whose earlier occurrences are overwritten by the last occurrence in source order.
+ *
+ * @private internal constant of `createAgentModelRequirementsWithCommitments`
+ */
+const OVERWRITTEN_COMMITMENT_GROUP_BY_TYPE = new Map([
+    ['GOAL', 'GOAL'],
+    ['GOALS', 'GOAL'],
+]);
 /**
  * Regex pattern matching markdown horizontal lines that should not be copied into the final system message.
  *
@@ -31171,7 +31229,7 @@ function getSafeReferenceCommitmentFallback(commitmentType, originalContent) {
  */
 async function createAgentModelRequirementsWithCommitments(agentSource, modelName, options) {
     const parseResult = parseAgentSourceWithCommitments(agentSource);
-    const filteredCommitments = filterDeletedCommitments(parseResult.commitments);
+    const filteredCommitments = filterOverwrittenCommitments(filterDeletedCommitments(parseResult.commitments));
     let requirements = createInitialAgentModelRequirements(parseResult.agentName, modelName);
     requirements = await applyCommitmentsToRequirements(requirements, filteredCommitments, options);
     requirements = aggregateUseCommitmentSystemMessages(requirements, filteredCommitments);
@@ -31182,6 +31240,35 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     requirements = await applyPendingInlineKnowledgeSources(requirements, options === null || options === void 0 ? void 0 : options.inlineKnowledgeSourceUploader);
     return finalizeRequirements(requirements);
 }
+/**
+ * Removes earlier commitments that are overwritten by later commitments of the same semantic group.
+ *
+ * This currently keeps only the last `GOAL` / `GOALS` commitment so inheritance rewrites
+ * and multi-goal sources expose one effective goal to the runtime.
+ *
+ * @param commitments - Parsed commitments after DELETE-like filtering.
+ * @returns Commitments with overwritten entries removed while preserving source order.
+ *
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+function filterOverwrittenCommitments(commitments) {
+    const seenOverwriteGroups = new Set();
+    const keptCommitments = [];
+    for (let index = commitments.length - 1; index >= 0; index--) {
+        const commitment = commitments[index];
+        const overwriteGroup = OVERWRITTEN_COMMITMENT_GROUP_BY_TYPE.get(commitment.type);
+        if (!overwriteGroup) {
+            keptCommitments.push(commitment);
+            continue;
+        }
+        if (seenOverwriteGroups.has(overwriteGroup)) {
+            continue;
+        }
+        seenOverwriteGroups.add(overwriteGroup);
+        keptCommitments.push(commitment);
+    }
+    return keptCommitments.reverse();
+}
 /**
  * Creates the initial requirements object with the parsed agent name stored in metadata and an optional model override.
  *
@@ -31773,7 +31860,7 @@ async function createAgentModelRequirements(agentSource, modelName, availableMod
  * Selects the best model using the preparePersona function
  * This directly uses preparePersona to ensure DRY principle
  *
- * @param agentSource The agent source to derive persona description from
+ * @param agentSource The agent source to derive effective profile text from
  * @param llmTools LLM tools for preparing persona
  * @returns The name of the best selected model
  *
@@ -31781,9 +31868,9 @@ async function createAgentModelRequirements(agentSource, modelName, availableMod
  */
 async function selectBestModelUsingPersona(agentSource, llmTools) {
     var _a;
-    // Parse agent source to get persona description
+    // Parse agent source to get the effective profile description
     const { agentName, personaDescription } = parseAgentSource(agentSource);
-    // Use agent name as fallback if no persona description is available
+    // Use agent name as fallback if no profile description is available
     const description = personaDescription || agentName || 'AI Agent';
     try {
         // Use preparePersona directly