@promptbook/browser 0.112.0-31 → 0.112.0-34

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-31';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-34';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -9898,10 +9898,6 @@
      * 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.
      */
@@ -9918,20 +9914,19 @@
         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;
@@ -10136,7 +10131,7 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a, _b;
+            var _a, _b, _c;
             const trimmedContent = content.trim();
             if (!trimmedContent) {
                 return requirements;
@@ -10148,14 +10143,18 @@
             }
             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) {
@@ -10167,9 +10166,12 @@
                 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: {
@@ -10198,8 +10200,7 @@
                     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,
@@ -10236,25 +10237,24 @@
             };
         });
     }
-    /**
-     * 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.spaceTrim(`
+            ${toolLine}
+               ${entry.description}
+        `);
+        });
+        return lines.join('\n');
     }
     /**
      * Registers tool function and title for a teammate tool.
@@ -16754,9 +16754,7 @@
             return answer;
         }
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Safely retrieves the global scope object (window in browser, global in Node.js)
@@ -16955,10 +16953,8 @@
             }
         }
     }
-    /**
-     * TODO: !!!! Search ACRY for `window` and put -> [🔵]
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser speech-recognition adapter [BrowserSpeechRecognition](src/speech-recognition/BrowserSpeechRecognition.ts) should never be published outside of `@promptbook/browser` */
+    /** TODO: !!!! Search ACRY for `window` and put -> [🔵] */
 
     /**
      * Creates a PromptbookStorage backed by IndexedDB.
@@ -17035,9 +17031,7 @@
         indexedDbStorageCache.set(cacheKey, storage);
         return storage;
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser storage helper [getIndexedDbStorage](src/storage/local-storage/getIndexedDbStorage.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Stringify the PipelineJson with proper formatting
@@ -17127,9 +17121,7 @@
         promptbookLocalStorage = makePromptbookStorageFromWebStorage(localStorage);
         return promptbookLocalStorage;
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser storage helper [getLocalStorage](src/storage/local-storage/getLocalStorage.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Cache storage
@@ -17152,9 +17144,7 @@
         promptbookSessionStorage = makePromptbookStorageFromWebStorage(sessionStorage);
         return promptbookSessionStorage;
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser storage helper [getSessionStorage](src/storage/local-storage/getSessionStorage.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Normalizes a domain-like string into a comparable hostname form.
@@ -17909,9 +17899,7 @@
             return new URL(this.src);
         }
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser file helper [ObjectUrl](src/utils/files/ObjectUrl.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Download a File in a browser
@@ -17931,9 +17919,7 @@
         link.click();
         await objectUrl.destroy();
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser file helper [$induceFileDownload](src/utils/files/$induceFileDownload.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Download a Book in a browser
@@ -17952,9 +17938,7 @@
         });
         return /* not await */ $induceFileDownload(bookFile);
     }
-    /**
-     * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
-     */
+    /** Note: [🔵] Code for browser file helper [$induceBookDownload](src/utils/files/$induceBookDownload.ts) should never be published outside of `@promptbook/browser` */
 
     /**
      * Keep-alive helpers used for streaming chat responses.
@@ -18280,13 +18264,23 @@
      */
     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) {
@@ -18398,6 +18392,30 @@
             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;
+    }
 
     /**
      * Gets all tool titles provided by all commitments
@@ -22653,7 +22671,7 @@
      * @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);
@@ -22721,6 +22739,36 @@
             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 {
@@ -22816,7 +22864,7 @@
         // 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}`);
         }