@promptbook/core 0.112.0-43 → 0.112.0-44

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

@@ -66,7 +66,8 @@ export type AgentBasicInformation = {
     permanentId?: string_agent_permanent_id;
     /**
      * Optional description of the agent
-     * This is the line starting with "PERSONA"
+     * This is derived from the last `GOAL` / `GOALS` commitment,
+     * falling back to deprecated `PERSONA` / `PERSONAE` for backward compatibility.
      */
     personaDescription: string | null;
     /**

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

@@ -9,7 +9,8 @@ export type TeammateProfile = {
      */
     readonly agentName: string;
     /**
-     * Short description of what the agent does, from its PERSONA commitment.
+     * Short profile text for what the agent does, from the last GOAL commitment
+     * or deprecated PERSONA fallback.
      */
     readonly personaDescription: string | null;
 };

package/esm/src/commitments/PERSONA/PERSONA.d.ts

@@ -29,6 +29,13 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
      * Short one-line description of PERSONA.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `GOAL` for agent profile text and inheritance-safe rewrites.";
+        readonly replacedBy: readonly ["GOAL"];
+    };
     /**
      * Icon for this commitment.
      */

package/esm/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.112.0-42`).
+ * It follows semantic versioning (e.g., `0.112.0-43`).
  *
  * @generated
  */

package/package.json

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

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-44';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -11409,7 +11409,7 @@
          * 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.
@@ -11424,12 +11424,14 @@
             return spacetrim.spaceTrim(`
             # ${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.
 
@@ -11442,9 +11444,7 @@
             \`\`\`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
             \`\`\`
@@ -11452,9 +11452,7 @@
             \`\`\`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
             \`\`\`
@@ -11462,9 +11460,7 @@
             \`\`\`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
             \`\`\`
@@ -14323,7 +14319,16 @@
          * 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.
@@ -14338,16 +14343,24 @@
             return spacetrim.spaceTrim(`
             # ${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
@@ -15112,7 +15125,7 @@
             \`\`\`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.
             \`\`\`
         `);
@@ -21983,6 +21996,15 @@
      * @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.
      *
@@ -22033,7 +22055,7 @@
      */
     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);
@@ -22044,6 +22066,35 @@
         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.
      *
@@ -22677,7 +22728,7 @@
     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);
@@ -22781,25 +22832,33 @@
      */
     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 = '';
+            if (commitment.type === 'PERSONA' || commitment.type === 'PERSONAE') {
+                personaDescription = commitment.content;
+                hasPersonaDescription = true;
             }
-            else {
-                personaDescription += `\n\n${personaDescription}`;
-            }
-            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.
@@ -23286,7 +23345,7 @@
      * 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
      *
@@ -23294,9 +23353,9 @@
      */
     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