@promptbook/remote-server 0.112.0-31 → 0.112.0-34

package/umd/index.umd.js

@@ -50,7 +50,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
@@ -1398,9 +1398,7 @@
             }
         });
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node command-execution helper [$execCommand](src/utils/execCommand/$execCommand.ts) should never be published into packages that could be imported into browser environment */
 
     /**
      * [🐱‍🚀]
@@ -1427,9 +1425,7 @@
             isVerbose: true,
         });
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node server bootstrap [startAgentServer](src/remote-server/startAgentServer.ts) should never be published into packages that could be imported into browser environment */
 
     /**
      * Make error report URL for the given error
@@ -1942,10 +1938,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locateAppOnLinux](src/executables/platforms/locateAppOnLinux.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` */
 
     /**
      * Provides filesystem access (for example for Node.js-based scrapers)
@@ -1968,10 +1962,8 @@
             watch: promises.watch,
         };
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    /** Note: [🟢] Code for Node scraper registration helper [$provideFilesystemForNode](src/scrapers/_common/register/$provideFilesystemForNode.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */
 
     /**
      * Checks if the file is executable
@@ -2024,10 +2016,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locateAppOnMacOs](src/executables/platforms/locateAppOnMacOs.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` */
 
     /**
      * Attempts to locate the specified application on a Windows system by searching common installation directories.
@@ -2056,10 +2046,8 @@
             return null;
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locateAppOnWindows](src/executables/platforms/locateAppOnWindows.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` */
 
     /**
      * Locates an application on the system
@@ -2096,10 +2084,8 @@
             }
         }
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locateApp](src/executables/locateApp.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` */
 
     /**
      * Locates the LibreOffice executable on the current system by searching platform-specific paths.
@@ -2115,10 +2101,8 @@
             macOsName: 'LibreOffice',
         });
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locateLibreoffice](src/executables/apps/locateLibreoffice.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/legacy-documents` */
 
     /**
      * Locates the Pandoc executable on the current system by searching platform-specific paths.
@@ -2134,10 +2118,8 @@
             macOsName: 'Pandoc',
         });
     }
-    /**
-     * TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents`
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node executable locator [locatePandoc](src/executables/apps/locatePandoc.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🧠][♿] Maybe export through `@promptbook/node` OR `@promptbook/documents` */
 
     /**
      * Provides paths to required executables (i.e. as Pandoc and LibreOffice) for Node.js environments.
@@ -2154,9 +2136,9 @@
             //                                              <- TODO: [🧠] `null` vs `undefined`
         };
     }
+    /** Note: [🟢] Code for Node executable locator [$provideExecutablesForNode](src/executables/$provideExecutablesForNode.ts) should never be published into packages that could be imported into browser environment */
     /**
      * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
      */
 
@@ -8089,10 +8071,8 @@
         }
         return scrapers;
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    /** Note: [🟢] Code for Node scraper registration helper [$provideScrapersForNode](src/scrapers/_common/register/$provideScrapersForNode.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */
 
     /**
      * Normalizes a given text to camelCase format.
@@ -10415,12 +10395,12 @@
         };
         return fileHandler;
     }
+    /** Note: [🟢] Code for Node scraper helper [getScraperIntermediateSource](src/scrapers/_common/utils/getScraperIntermediateSource.ts) should never be published into packages that could be imported into browser environment */
     /**
      * Note: Not using `FileCacheStorage` for two reasons:
      * 1) Need to store more than serialized JSONs
      * 2) Need to switch between a `rootDirname` and `cacheDirname` <- TODO: [😡]
      * TODO: [🐱‍🐉][🧠] Make some smart crop
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**
@@ -10752,11 +10732,11 @@
             return knowledge;
         }
     }
+    /** Note: [🟢] Code for Node scraper implementation [WebsiteScraper](src/scrapers/website/WebsiteScraper.ts) should never be published into packages that could be imported into browser environment */
     /**
      * TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
      * TODO: [🪂] Do it in parallel 11:11
      * Note: No need to aggregate usage here, it is done by intercepting the llmTools
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**
@@ -10879,9 +10859,7 @@
         `);
         }
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
+    /** Note: [🟢] Code for Node browser-fetch helper [fetchUrlContent](src/commitments/USE_BROWSER/fetchUrlContent.ts) should never be published into packages that could be imported into browser environment */
 
     /**
      * Cached implementation of `run_browser` when it can be resolved.
@@ -15472,10 +15450,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.
      */
@@ -15492,20 +15466,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;
@@ -15710,7 +15683,7 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a, _b;
+            var _a, _b, _c;
             const trimmedContent = content.trim();
             if (!trimmedContent) {
                 return requirements;
@@ -15722,14 +15695,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) {
@@ -15741,9 +15718,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: {
@@ -15772,8 +15752,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,
@@ -15810,25 +15789,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.
@@ -22652,10 +22630,8 @@
         // TODO: [🔱] Do here auto-installation
         return [new JavascriptExecutionTools({ ...options, functions: getAllCommitmentsToolFunctionsForNode() })];
     }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
-     */
+    /** Note: [🟢] Code for Node scraper registration helper [$provideScriptingForNode](src/scrapers/_common/register/$provideScriptingForNode.ts) should never be published into packages that could be imported into browser environment */
+    /** TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming */
 
     // TODO: [🥺] List running services from REMOTE_SERVER_URLS
     // TODO: [🥺] Import directly from YML
@@ -23861,8 +23837,8 @@
             },
         };
     }
+    /** Note: [🟢] Code for Node server bootstrap [startRemoteServer](src/remote-server/startRemoteServer.ts) should never be published into packages that could be imported into browser environment */
     /**
-
      * TODO: [🕋] Use here `aboutPromptbookInformation`
      * TODO: [🌡] Add CORS and security - probably via `helmet`
      * TODO: Split this file into multiple functions - handler for each request
@@ -23875,7 +23851,6 @@
      * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
      * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
      * TODO: Allow to constrain anonymous mode for specific models / providers
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**
@@ -24171,13 +24146,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) {
@@ -24289,6 +24274,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;
+    }
 
     /**
      * Computes SHA-256 hash of the agent source
@@ -25221,7 +25230,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);
@@ -25289,6 +25298,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 {
@@ -25384,7 +25423,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}`);
         }