@promptbook/components 0.112.0-42 → 0.112.0-44

package/umd/index.umd.js

@@ -30,7 +30,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-42';
+    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
@@ -7244,7 +7244,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.
@@ -7259,12 +7259,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.
 
@@ -7277,9 +7279,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
             \`\`\`
@@ -7287,9 +7287,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
             \`\`\`
@@ -7297,9 +7295,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
             \`\`\`
@@ -10058,7 +10054,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.
@@ -10073,16 +10078,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
@@ -10790,6 +10803,15 @@
      * Map of team tool titles.
      */
     const teamToolTitles = {};
+    /**
+     * Shared TEAM usage rules appended ahead of teammate listings.
+     *
+     * @private
+     */
+    const TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES = [
+        '- If a teammate is relevant to the request, consult that teammate using the matching tool.',
+        '- Do not ask the user for information that a listed teammate can provide directly.',
+    ];
     /**
      * Constant for remote agents by Url.
      */
@@ -10838,7 +10860,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.
             \`\`\`
         `);
@@ -10879,12 +10901,9 @@
                 if (updatedTools.some((tool) => tool.name === entry.toolName)) {
                     continue;
                 }
-                const toolDescription = entry.description
-                    ? `Consult teammate ${entry.teammate.label}\n${entry.description}`
-                    : `Consult teammate ${entry.teammate.label}`;
                 updatedTools.push({
                     name: entry.toolName,
-                    description: toolDescription,
+                    description: buildTeamToolDescription(entry),
                     parameters: {
                         type: 'object',
                         properties: {
@@ -10953,22 +10972,72 @@
     /**
      * Builds the textual TEAM section body for the final system message.
      *
-     * Each teammate is listed with its tool name and, when available, a one-line description.
-     * Uses `spaceTrim` to ensure consistent whitespace and indentation.
+     * Each teammate is listed with its tool name, TEAM instructions, and optional profile hints.
      */
     function buildTeamSystemMessageBody(teamEntries) {
-        const lines = teamEntries.map((entry, index) => {
-            const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
-            if (!entry.description) {
-                return toolLine;
-            }
-            return spacetrim.spaceTrim(`
-            ${toolLine}
-               ${entry.description}
-        `);
-        });
+        const lines = [
+            ...TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES,
+            '',
+            ...teamEntries.map((entry, index) => {
+                const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
+                const detailLines = collectTeamEntryDetails(entry).map(formatTeamEntryDetailLine);
+                return [toolLine, ...detailLines].join('\n');
+            }),
+        ];
         return lines.join('\n');
     }
+    /**
+     * Builds the model-visible description for one teammate tool.
+     *
+     * @private
+     */
+    function buildTeamToolDescription(entry) {
+        const detailLines = collectTeamEntryDetails(entry).map(({ label, content }) => `${label}: ${content}`);
+        return [`Consult teammate ${entry.teammate.label}`, ...detailLines].join('\n');
+    }
+    /**
+     * Collects structured teammate details that should stay visible to the model.
+     *
+     * @private
+     */
+    function collectTeamEntryDetails(entry) {
+        var _a;
+        const details = [];
+        const instructions = entry.teammate.instructions.trim();
+        const description = ((_a = entry.description) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        if (instructions) {
+            details.push({
+                label: 'TEAM instructions',
+                content: instructions,
+            });
+        }
+        if (description) {
+            details.push({
+                label: 'Profile',
+                content: description,
+            });
+        }
+        return details;
+    }
+    /**
+     * Formats one teammate detail line for the TEAM system-message section.
+     *
+     * @private
+     */
+    function formatTeamEntryDetailLine(detail) {
+        return indentMultilineText(`${detail.label}: ${detail.content}`, '   ');
+    }
+    /**
+     * Indents all lines of one potentially multi-line text block.
+     *
+     * @private
+     */
+    function indentMultilineText(text, prefix) {
+        return text
+            .split('\n')
+            .map((line) => `${prefix}${line}`)
+            .join('\n');
+    }
     /**
      * Registers tool function and title for a teammate tool.
      */
@@ -17380,7 +17449,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);
@@ -17484,25 +17553,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.
@@ -30906,7 +30983,7 @@
             systemMessage: '',
             promptSuffix: '',
             // modelName: 'gpt-5',
-            modelName: 'gemini-2.5-flash-lite',
+            modelName: 'gpt-5.4-mini',
             temperature: 0.7,
             topP: 0.9,
             topK: 50,
@@ -31055,6 +31132,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.
      *
@@ -31105,7 +31191,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);
@@ -31116,6 +31202,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.
      *
@@ -31707,7 +31822,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
      *
@@ -31715,9 +31830,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
@@ -35777,7 +35892,7 @@
     /**
      * Constant for default agent kit model name.
      */
-    const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-nano';
+    const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-mini';
     /**
      * Creates one structured log entry for streamed tool-call updates.
      *
@@ -37843,6 +37958,7 @@
          * @param agentSource The agent source string that defines the agent's behavior
          */
         constructor(options) {
+            var _a;
             this.options = options;
             /**
              * Cached model requirements to avoid re-parsing the agent source
@@ -37852,6 +37968,7 @@
              * Cached parsed agent information
              */
             this._cachedAgentInfo = null;
+            this.precomputedModelRequirements = (_a = options.precomputedModelRequirements) !== null && _a !== void 0 ? _a : null;
         }
         /**
          * Updates the agent source and clears the cache
@@ -37859,9 +37976,13 @@
          * @param agentSource The new agent source string
          */
         updateAgentSource(agentSource) {
+            if (this.options.agentSource === agentSource) {
+                return;
+            }
             this.options.agentSource = agentSource;
             this._cachedAgentInfo = null;
             this._cachedModelRequirements = null;
+            this.precomputedModelRequirements = null;
         }
         /**
          * Get cached or parse agent information
@@ -37878,6 +37999,16 @@
          * Note: [🐤] This is names `getModelRequirements` *(not `getAgentModelRequirements`)* because in future these two will be united
          */
         async getModelRequirements() {
+            var _a, _b;
+            if (this.precomputedModelRequirements !== null) {
+                if (this.options.isVerbose) {
+                    console.info('[🤰]', 'Using precomputed agent model requirements', {
+                        agent: this.title,
+                        toolCount: (_b = (_a = this.precomputedModelRequirements.tools) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0,
+                    });
+                }
+                return this.precomputedModelRequirements;
+            }
             if (this._cachedModelRequirements === null) {
                 const preparationStartedAtMs = Date.now();
                 if (this.options.isVerbose) {
@@ -37987,6 +38118,7 @@
          * Resolves agent requirements, attachments, and runtime overrides into one forwarded chat prompt.
          */
         async prepareChatPrompt(prompt) {
+            var _a;
             const chatPrompt = this.requireChatPrompt(prompt);
             const { sanitizedRequirements, promptSuffix } = await this.getSanitizedAgentModelRequirements();
             const attachments = normalizeChatAttachments(chatPrompt.attachments);
@@ -38004,7 +38136,16 @@
                 mergedTools,
                 knowledgeSourcesForAgent,
             });
-            console.log('!!!! promptWithAgentModelRequirements:', forwardedPrompt);
+            if (this.options.isVerbose) {
+                console.info('[🤰]', 'Prepared agent chat prompt', {
+                    agent: this.title,
+                    usedPrecomputedModelRequirements: this.precomputedModelRequirements !== null,
+                    toolNames: mergedTools.map((tool) => tool.name),
+                    knowledgeSourcesCount: (_a = knowledgeSourcesForAgent === null || knowledgeSourcesForAgent === void 0 ? void 0 : knowledgeSourcesForAgent.length) !== null && _a !== void 0 ? _a : 0,
+                    promptSuffixLength: promptSuffix.length,
+                    systemMessageLength: sanitizedRequirements.systemMessage.length,
+                });
+            }
             return {
                 forwardedPrompt,
                 sanitizedRequirements,
@@ -38191,6 +38332,7 @@
          * Runs one prepared prompt through the deprecated OpenAI Assistant backend.
          */
         async callOpenAiAssistantChatModelStream(options) {
+            var _a, _b, _c, _d;
             const assistant = await this.getOrPrepareOpenAiAssistant({
                 llmTools: options.llmTools,
                 originalPrompt: options.originalPrompt,
@@ -38198,7 +38340,14 @@
                 onProgress: options.onProgress,
             });
             const promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools = createOpenAiAssistantPrompt(options.preparedChatPrompt.forwardedPrompt);
-            console.log('!!!! promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools:', promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools);
+            if (this.options.isVerbose) {
+                console.info('[🤰]', 'Prepared OpenAI Assistant prompt', {
+                    agent: this.title,
+                    toolNames: (_b = (_a = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements.tools) === null || _a === void 0 ? void 0 : _a.map((tool) => tool.name)) !== null && _b !== void 0 ? _b : [],
+                    knowledgeSourcesCount: (_d = (_c = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements
+                        .knowledgeSources) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0,
+                });
+            }
             return assistant.callChatModelStream(promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools, options.onProgress, options.streamOptions);
         }
         /**
@@ -38889,7 +39038,8 @@
                 isVerbose: options.isVerbose,
                 llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
                 assistantPreparationMode: options.assistantPreparationMode,
-                agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+                agentSource: agentSource.value,
+                precomputedModelRequirements: options.precomputedModelRequirements,
             });
             this._agentName = undefined;
             /**
@@ -43152,7 +43302,7 @@
     //                           <- TODO: [🧠] Should we wrap more components in `React.memo`
     //                                          Or make normal function from this?
     (props) => {
-        const { message, participant, participants, isLastMessage, onMessage, onActionButton, onQuickMessageButton, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, feedbackMode = 'stars', feedbackTranslations, timingTranslations, chatLocale, onCopy, onCreateAgent, toolTitles, teammates, onReplyToMessage, canReplyToMessage, teamAgentProfiles, CHAT_VISUAL_MODE = 'BUBBLE_MODE', onToolCallClick, onCitationClick, soundSystem, isSpeechPlaybackEnabled, elevenLabsVoiceId, chatUiTranslations, } = props;
+        const { message, participant, participants, isLastMessage, onMessage, onActionButton, onQuickMessageButton, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, feedbackMode = 'stars', feedbackTranslations, timingTranslations, chatLocale, onCopy, onCreateAgent, toolTitles, teammates, onReplyToMessage, canReplyToMessage, teamAgentProfiles, CHAT_VISUAL_MODE = 'ARTICLE_MODE', onToolCallClick, onCitationClick, soundSystem, isSpeechPlaybackEnabled, elevenLabsVoiceId, chatUiTranslations, } = props;
         const { isComplete = true,
         // <- TODO: Destruct all `messages` properties like `isComplete`
          } = message;
@@ -46952,7 +47102,7 @@
      * @public exported from `@promptbook/components`
      */
     function Chat(props) {
-        const { title = 'Chat', messages, onChange, onMessage, onActionButton, onQuickMessageButton, onReplyToMessage, onCancelReply, onReset, resetRequiresConfirmation = true, newChatButtonHref, onFeedback, feedbackMode = 'stars', feedbackTranslations, timingTranslations, onFileUpload, chatLocale, speechRecognition, placeholderMessageContent, defaultMessage, enterBehavior, resolveEnterBehavior, children, className, style, isAiTextHumanizedAndPromptbookified = true, isVoiceCalling = false, isFocusedOnLoad, participants = [], canReplyToMessage, replyingToMessage, extraActions, actionsContainer, saveFormats, isSaveButtonEnabled = true, isCopyButtonEnabled = true, buttonColor: buttonColorRaw, onUseTemplate, onCreateAgent, toolTitles, teammates, teamAgentProfiles, visual, CHAT_VISUAL_MODE = 'BUBBLE_MODE', effectConfigs, soundSystem, speechRecognitionLanguage, isSpeechPlaybackEnabled = true, elevenLabsVoiceId, chatUiTranslations, } = props;
+        const { title = 'Chat', messages, onChange, onMessage, onActionButton, onQuickMessageButton, onReplyToMessage, onCancelReply, onReset, resetRequiresConfirmation = true, newChatButtonHref, onFeedback, feedbackMode = 'stars', feedbackTranslations, timingTranslations, onFileUpload, chatLocale, speechRecognition, placeholderMessageContent, defaultMessage, enterBehavior, resolveEnterBehavior, children, className, style, isAiTextHumanizedAndPromptbookified = true, isVoiceCalling = false, isFocusedOnLoad, participants = [], canReplyToMessage, replyingToMessage, extraActions, actionsContainer, saveFormats, isSaveButtonEnabled = true, isCopyButtonEnabled = true, buttonColor: buttonColorRaw, onUseTemplate, onCreateAgent, toolTitles, teammates, teamAgentProfiles, visual, CHAT_VISUAL_MODE = 'ARTICLE_MODE', effectConfigs, soundSystem, speechRecognitionLanguage, isSpeechPlaybackEnabled = true, elevenLabsVoiceId, chatUiTranslations, } = props;
         const buttonColor = react.useMemo(() => Color.from(buttonColorRaw || '#0066cc'), [buttonColorRaw]);
         const agentParticipant = react.useMemo(() => participants.find((participant) => participant.name === 'AGENT'), [participants]);
         const postprocessedMessages = useChatPostprocessedMessages({