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

package/esm/index.es.js

@@ -40,7 +40,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -1388,9 +1388,7 @@ function $execCommand(options) {
         }
     });
 }
-/**
- * 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 */
 
 /**
  * [🐱‍🚀]
@@ -1417,9 +1415,7 @@ async function startAgentServer(options) {
         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
@@ -1932,10 +1928,8 @@ async function locateAppOnLinux({ linuxWhich, }) {
         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)
@@ -1958,10 +1952,8 @@ function $provideFilesystemForNode(options) {
         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
@@ -2014,10 +2006,8 @@ async function locateAppOnMacOs({ macOsName, }) {
         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.
@@ -2046,10 +2036,8 @@ async function locateAppOnWindows({ appName, windowsSuffix, }) {
         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
@@ -2086,10 +2074,8 @@ function locateApp(options) {
         }
     }
 }
-/**
- * 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.
@@ -2105,10 +2091,8 @@ function locateLibreoffice() {
         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.
@@ -2124,10 +2108,8 @@ function locatePandoc() {
         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.
@@ -2144,9 +2126,9 @@ async function $provideExecutablesForNode(options) {
         //                                              <- 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
  */
 
@@ -8079,10 +8061,8 @@ async function $provideScrapersForNode(tools, options) {
     }
     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.
@@ -10405,12 +10385,12 @@ async function getScraperIntermediateSource(source, options) {
     };
     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
  */
 
 /**
@@ -10742,11 +10722,11 @@ class WebsiteScraper {
         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
  */
 
 /**
@@ -10869,9 +10849,7 @@ async function fetchUrlContent(url) {
         `);
     }
 }
-/**
- * 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.
@@ -15462,10 +15440,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.
  */
@@ -15482,20 +15456,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;
@@ -15700,7 +15673,7 @@ class TeamCommitmentDefinition extends BaseCommitmentDefinition {
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        var _a, _b;
+        var _a, _b, _c;
         const trimmedContent = content.trim();
         if (!trimmedContent) {
             return requirements;
@@ -15712,14 +15685,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) {
@@ -15731,9 +15708,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: {
@@ -15762,8 +15742,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,
@@ -15800,25 +15779,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.
@@ -22642,10 +22620,8 @@ async function $provideScriptingForNode(options) {
     // 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
@@ -23851,8 +23827,8 @@ function startRemoteServer(options) {
         },
     };
 }
+/** 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
@@ -23865,7 +23841,6 @@ function startRemoteServer(options) {
  * 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
  */
 
 /**
@@ -24161,13 +24136,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) {
@@ -24279,6 +24264,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
@@ -25211,7 +25220,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);
@@ -25279,6 +25288,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 {
@@ -25374,7 +25413,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}`);
     }