@promptbook/node 0.112.0-30 → 0.112.0-32

package/esm/index.es.js

@@ -35,7 +35,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-30';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -18397,10 +18397,6 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
  * Prefix used for TEAM tool names.
  */
 const TEAM_TOOL_PREFIX = 'team_chat_';
-/**
- * Length of URL hash suffix appended to TEAM tool names.
- */
-const TEAM_TOOL_HASH_LENGTH = 10;
 /**
  * Fallback normalized name when teammate label is empty.
  */
@@ -18417,20 +18413,19 @@ function normalizeTeammateToolNamePart(teammateLabel) {
     return normalized || TEAM_TOOL_FALLBACK_NAME;
 }
 /**
- * Builds a deterministic TEAM tool name from teammate identity.
+ * Builds a deterministic TEAM tool name from the teammate label.
  *
- * The readable part is based on teammate label while the hash suffix
- * keeps uniqueness and stable mapping for the underlying teammate URL.
+ * The tool name is derived solely from the human-readable label so that it
+ * remains stable and predictable regardless of internal technical identifiers.
  *
- * @param teammateUrl - Canonical teammate URL used at runtime.
- * @param teammateLabel - Human-readable teammate label.
- * @returns Deterministic TEAM tool name.
+ * @param _teammateUrl - Canonical teammate URL (kept for API compatibility, not used).
+ * @param teammateLabel - Human-readable teammate label used as the basis for the name.
+ * @returns TEAM tool name derived from the label.
  * @private internal utility of TEAM commitments and chat UI mapping
  */
-function createTeamToolName(teammateUrl, teammateLabel) {
+function createTeamToolName(_teammateUrl, teammateLabel) {
     const normalizedLabel = normalizeTeammateToolNamePart(teammateLabel);
-    const hash = computeHash(teammateUrl).substring(0, TEAM_TOOL_HASH_LENGTH);
-    return `${TEAM_TOOL_PREFIX}${normalizedLabel}_${hash}`;
+    return `${TEAM_TOOL_PREFIX}${normalizedLabel}`;
 }
 
 const urlRegex = /https?:\/\/[^\s]+/gi;
@@ -18635,7 +18630,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        var _a, _b;
+        var _a, _b, _c;
         const trimmedContent = content.trim();
         if (!trimmedContent) {
             return requirements;
@@ -18647,14 +18642,18 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
         }
         const agentName = ((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.agentName) || 'Agent';
         const existingTeammates = ((_b = requirements._metadata) === null || _b === void 0 ? void 0 : _b.teammates) || [];
+        const preResolvedProfiles = (((_c = requirements._metadata) === null || _c === void 0 ? void 0 : _c.preResolvedTeammateProfiles) || {});
         const resolvedTeammates = resolveTeamTeammateLabels(trimmedContent, teammates);
         const teamEntries = resolvedTeammates.map((teammate) => {
+            const profile = preResolvedProfiles[teammate.url];
+            const resolvedLabel = (profile === null || profile === void 0 ? void 0 : profile.agentName) || teammate.label;
             const existingTeammate = existingTeammates.find((entry) => entry.url === teammate.url);
             return {
                 toolName: ((existingTeammate === null || existingTeammate === void 0 ? void 0 : existingTeammate.toolName) ||
-                    createTeamToolName(teammate.url, teammate.label)),
-                teammate,
+                    createTeamToolName(teammate.url, resolvedLabel)),
+                teammate: { ...teammate, label: resolvedLabel },
                 agentName,
+                description: (profile === null || profile === void 0 ? void 0 : profile.personaDescription) || null,
             };
         });
         for (const entry of teamEntries) {
@@ -18666,9 +18665,12 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
             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: `Consult teammate ${entry.teammate.label}`,
+                description: toolDescription,
                 parameters: {
                     type: 'object',
                     properties: {
@@ -18697,8 +18699,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
                 toolName: entry.toolName,
             });
         }
-        const teamOverviewText = createTeamOverviewText(trimmedContent, teamEntries);
-        const teamSystemMessage = this.createSystemMessageSection('Teammates:', buildTeamSystemMessageBody(teamOverviewText, teamEntries));
+        const teamSystemMessage = this.createSystemMessageSection('Teammates:', buildTeamSystemMessageBody(teamEntries));
         return this.appendToSystemMessage({
             ...requirements,
             tools: updatedTools,
@@ -18735,25 +18736,24 @@ function resolveTeamTeammateLabels(teamContent, teammates) {
         };
     });
 }
-/**
- * Rewrites TEAM commitment content into a URL-free teammate overview text.
- */
-function createTeamOverviewText(teamContent, teamEntries) {
-    let overviewText = teamContent;
-    for (const entry of teamEntries) {
-        overviewText = overviewText.split(entry.teammate.url).join(entry.teammate.label);
-    }
-    return overviewText.trim();
-}
 /**
  * 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.
  */
-function buildTeamSystemMessageBody(teamOverviewText, teamEntries) {
-    const teammateLines = teamEntries.map((entry, index) => `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``);
-    if (!teamOverviewText) {
-        return teammateLines.join('\n');
-    }
-    return `${teamOverviewText}\n\n${teammateLines.join('\n')}`;
+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$1(`
+            ${toolLine}
+               ${entry.description}
+        `);
+    });
+    return lines.join('\n');
 }
 /**
  * Registers tool function and title for a teammate tool.
@@ -27057,13 +27057,23 @@ function getToolCallIdentity(toolCall) {
  */
 function mergeToolCalls(existingToolCalls, incomingToolCalls) {
     if (!existingToolCalls || existingToolCalls.length === 0) {
-        return incomingToolCalls ? [...incomingToolCalls] : [];
+        return incomingToolCalls ? deduplicatePreparationToolCalls([...incomingToolCalls]) : [];
     }
     if (!incomingToolCalls || incomingToolCalls.length === 0) {
         return [...existingToolCalls];
     }
     const mergedToolCalls = [...existingToolCalls];
     for (const incomingToolCall of incomingToolCalls) {
+        if (isAssistantPreparationToolCall(incomingToolCall)) {
+            // A new preparation phase always replaces any previous assistant_preparation tool
+            // call, regardless of phase argument, so only one chip is ever shown at a time.
+            const existingPreparationIndex = mergedToolCalls.findIndex(isAssistantPreparationToolCall);
+            if (existingPreparationIndex !== -1) {
+                mergedToolCalls.splice(existingPreparationIndex, 1);
+            }
+            mergedToolCalls.push(incomingToolCall);
+            continue;
+        }
         const incomingIdentity = getToolCallIdentity(incomingToolCall);
         const existingIndex = mergedToolCalls.findIndex((existingToolCall) => getToolCallIdentity(existingToolCall) === incomingIdentity);
         if (existingIndex === -1) {
@@ -27175,6 +27185,30 @@ function serializeValueForMerge(value) {
         return String(value);
     }
 }
+/**
+ * Ensures at most one `assistant_preparation` tool call survives in the list,
+ * keeping the last occurrence so the most recent preparation phase is shown.
+ *
+ * @param toolCalls - Mutable list to deduplicate in-place.
+ * @returns The same array after removing redundant preparation entries.
+ * @private helper of `mergeToolCalls`
+ */
+function deduplicatePreparationToolCalls(toolCalls) {
+    let lastPreparationIndex = -1;
+    for (let index = toolCalls.length - 1; index >= 0; index--) {
+        if (!isAssistantPreparationToolCall(toolCalls[index])) {
+            continue;
+        }
+        if (lastPreparationIndex === -1) {
+            lastPreparationIndex = index;
+        }
+        else {
+            // Remove earlier duplicate — keep only the last (most recent) one.
+            toolCalls.splice(index, 1);
+        }
+    }
+    return toolCalls;
+}
 
 /**
  * Computes SHA-256 hash of the agent source
@@ -28107,7 +28141,7 @@ function getSafeReferenceCommitmentFallback(commitmentType, originalContent) {
  * @private @@@
  */
 async function createAgentModelRequirementsWithCommitments(agentSource, modelName, options) {
-    var _a;
+    var _a, _b, _c;
     const agentReferenceResolver = options === null || options === void 0 ? void 0 : options.agentReferenceResolver;
     // Parse the agent source to extract commitments
     const parseResult = parseAgentSourceWithCommitments(agentSource);
@@ -28175,6 +28209,36 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
         if (commitment.type === 'CLOSED' && i !== filteredCommitments.length - 1) {
             continue;
         }
+        // For TEAM commitments, pre-resolve teammate profiles if a resolver is provided
+        // and store them in metadata before the commitment is applied.
+        const profileResolver = (_a = options === null || options === void 0 ? void 0 : options.teammateProfileResolver) !== null && _a !== void 0 ? _a : options === null || options === void 0 ? void 0 : options.agentReferenceResolver;
+        if (commitment.type === 'TEAM' && (profileResolver === null || profileResolver === void 0 ? void 0 : profileResolver.resolveTeammateProfile)) {
+            try {
+                const parsedTeammates = parseTeamCommitmentContent(commitmentContent, { strict: false });
+                const preResolved = {
+                    ...(_b = requirements._metadata) === null || _b === void 0 ? void 0 : _b.preResolvedTeammateProfiles,
+                };
+                for (const teammate of parsedTeammates) {
+                    if (preResolved[teammate.url]) {
+                        continue;
+                    }
+                    const profile = await profileResolver.resolveTeammateProfile(teammate.url);
+                    if (profile) {
+                        preResolved[teammate.url] = profile;
+                    }
+                }
+                requirements = {
+                    ...requirements,
+                    _metadata: {
+                        ...requirements._metadata,
+                        preResolvedTeammateProfiles: preResolved,
+                    },
+                };
+            }
+            catch (error) {
+                console.warn('Failed to pre-resolve teammate profiles for TEAM commitment:', error);
+            }
+        }
         const definition = getCommitmentDefinition(commitment.type);
         if (definition) {
             try {
@@ -28270,7 +28334,7 @@ async function createAgentModelRequirementsWithCommitments(agentSource, modelNam
     // Add example interactions to the system message
     const examples = [];
     // 1. Initial message as an example agent response
-    const initialMessage = (_a = parseResult.commitments.find((c) => c.type === 'INITIAL MESSAGE')) === null || _a === void 0 ? void 0 : _a.content;
+    const initialMessage = (_c = parseResult.commitments.find((c) => c.type === 'INITIAL MESSAGE')) === null || _c === void 0 ? void 0 : _c.content;
     if (initialMessage) {
         examples.push(`Agent: ${initialMessage}`);
     }
@@ -34115,6 +34179,7 @@ class SelfLearningManager {
 
                 - Decide what the agent should learn from this interaction.
                 - Append new commitments at the end of the agent source.
+                - Return only newly learned commitments, never repeat commitments that are already present.
                 - Do not modify the current agent source, just return new commitments (KNOWLEDGE, RULE, etc.).
                 - If there is nothing new to learn, return empty book code block
                 - Wrap the commitments in a book code block.
@@ -34167,10 +34232,42 @@ class SelfLearningManager {
      */
     appendToAgentSource(section) {
         const currentSource = this.options.getAgentSource();
-        const newSource = padBook(validateBook(spaceTrim$1(currentSource) + section));
+        const normalizedSection = normalizeBookSection(section);
+        if (!normalizedSection) {
+            return;
+        }
+        if (containsNormalizedBookSection(currentSource, normalizedSection)) {
+            return;
+        }
+        const newSource = padBook(validateBook(`${normalizeBookSection(currentSource)}\n\n${normalizedSection}`));
         this.options.updateAgentSource(newSource);
     }
 }
+/**
+ * Normalizes one book fragment for deduplication and append composition.
+ *
+ * @param section Raw fragment from self-learning workflow.
+ * @returns Trimmed fragment, or empty string when nothing remains.
+ * @private function of Agent
+ */
+function normalizeBookSection(section) {
+    return spaceTrim$1(section).replace(/\r\n/g, '\n');
+}
+/**
+ * Checks whether one normalized fragment already exists inside the current source.
+ *
+ * @param agentSource Current source.
+ * @param normalizedSection Candidate fragment expected to be normalized first.
+ * @returns True when appending would duplicate an existing fragment.
+ * @private function of Agent
+ */
+function containsNormalizedBookSection(agentSource, normalizedSection) {
+    if (!normalizedSection) {
+        return true;
+    }
+    const normalizedSource = normalizeBookSection(agentSource);
+    return normalizedSource.includes(normalizedSection);
+}
 /**
  * Determines whether the interaction runs in OpenAI-compatible JSON schema mode.
  *