@promptbook/wizard 0.112.0-64 → 0.112.0-65

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-64';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-65';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -9226,9 +9226,11 @@
          * Creates the retry-history error message shared by all OpenAI-compatible model variants.
          */
         createAttemptHistoryError(finalErrorMessage) {
-            return new PipelineExecutionError(`All attempts failed. Attempt history:\n` +
-                formatUnsupportedParameterAttemptHistory(this.attemptStack) +
-                `\nFinal error: ${finalErrorMessage}`);
+            return new PipelineExecutionError(_spaceTrim.spaceTrim((block) => `
+                    All attempts failed. Attempt history:
+                    ${block(formatUnsupportedParameterAttemptHistory(this.attemptStack))}
+                    Final error: ${finalErrorMessage}
+                `));
         }
     }
 
@@ -20745,18 +20747,6 @@
         return count;
     }
 
-    /**
-     * Name of the tool used by agents to search configured `KNOWLEDGE` sources.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    const KNOWLEDGE_SEARCH_TOOL_NAME = 'knowledge_search';
-    /**
-     * Title of the system-message section generated for `KNOWLEDGE` commitments.
-     *
-     * @private constant of `KnowledgeCommitmentDefinition`
-     */
-    const KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE = 'Knowledge Search';
     /**
      * KNOWLEDGE commitment definition
      *
@@ -20878,17 +20868,9 @@
                 knowledgeInfoEntries.push(`Knowledge Source Inline: ${inlineSource.filename} (derived from inline content and processed for retrieval during chat)`);
             }
             if (knowledgeInfoEntries.length === 0) {
-                return addKnowledgeSearchToolAndSystemSection(nextRequirements);
+                return nextRequirements;
             }
-            return addKnowledgeSearchToolAndSystemSection(nextRequirements);
-        }
-        /**
-         * Gets human-readable titles for tool functions provided by this commitment.
-         */
-        getToolTitles() {
-            return {
-                [KNOWLEDGE_SEARCH_TOOL_NAME]: 'Knowledge search',
-            };
+            return this.appendToSystemMessage(nextRequirements, knowledgeInfoEntries.join('\n'), '\n\n');
         }
     }
     /**
@@ -20902,128 +20884,6 @@
         const significantText = contentWithoutUrls.replace(/[\s.,!?;:'"`()[\]{}<>/-]+/g, '');
         return significantText.length > 0;
     }
-    /**
-     * Adds the shared `knowledge_search` tool definition and the consolidated system-message section.
-     *
-     * @param requirements - Requirements after one `KNOWLEDGE` commitment was applied.
-     * @returns Requirements with the knowledge search instructions and tool definition.
-     *
-     * @private internal utility of `KnowledgeCommitmentDefinition`
-     */
-    function addKnowledgeSearchToolAndSystemSection(requirements) {
-        const nextRequirements = addKnowledgeSearchTool(requirements);
-        const section = createKnowledgeSearchSystemSection(nextRequirements);
-        const sectionHeader = `## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE}`;
-        if (nextRequirements.systemMessage.includes(sectionHeader)) {
-            return {
-                ...nextRequirements,
-                systemMessage: nextRequirements.systemMessage.replace(new RegExp(`## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?(?=\\n\\n##|$)`), section),
-            };
-        }
-        return {
-            ...nextRequirements,
-            systemMessage: nextRequirements.systemMessage.trim()
-                ? `${nextRequirements.systemMessage}\n\n${section}`
-                : section,
-        };
-    }
-    /**
-     * Adds the `knowledge_search` model tool when it is not already present.
-     *
-     * @param requirements - Current model requirements.
-     * @returns Requirements with the tool definition available to the model.
-     *
-     * @private internal utility of `KnowledgeCommitmentDefinition`
-     */
-    function addKnowledgeSearchTool(requirements) {
-        const existingTools = requirements.tools || [];
-        if (existingTools.some((tool) => tool.name === KNOWLEDGE_SEARCH_TOOL_NAME)) {
-            return requirements;
-        }
-        return {
-            ...requirements,
-            tools: [
-                ...existingTools,
-                {
-                    name: KNOWLEDGE_SEARCH_TOOL_NAME,
-                    description: _spaceTrim.spaceTrim(`
-                    Search the agent's configured knowledge sources and return relevant excerpts with citation ids.
-                    Use this before answering questions that may depend on the agent's KNOWLEDGE commitments.
-                `),
-                    parameters: {
-                        type: 'object',
-                        properties: {
-                            query: {
-                                type: 'string',
-                                description: 'The natural-language search query for the knowledge base.',
-                            },
-                            limit: {
-                                type: 'integer',
-                                description: 'Maximum number of matching source excerpts to return.',
-                            },
-                        },
-                        required: ['query'],
-                    },
-                },
-            ],
-        };
-    }
-    /**
-     * Creates the model-facing system-message section for knowledge search.
-     *
-     * @param requirements - Current model requirements.
-     * @returns Markdown system-message section.
-     *
-     * @private internal utility of `KnowledgeCommitmentDefinition`
-     */
-    function createKnowledgeSearchSystemSection(requirements) {
-        const sourceEntries = createKnowledgeSourceSystemEntries(requirements);
-        const sourceList = sourceEntries.length > 0 ? sourceEntries.map((entry) => `-   ${entry}`).join('\n') : '-   None';
-        return _spaceTrim.spaceTrim(`
-        ## ${KNOWLEDGE_SEARCH_SYSTEM_SECTION_TITLE}
-
-        -   Use \`${KNOWLEDGE_SEARCH_TOOL_NAME}\` to search the configured knowledge sources before answering questions that depend on this agent's knowledge base.
-        -   Base source-backed factual answers on the returned excerpts.
-        -   When you use a returned excerpt, include its citation marker in the answer body, for example \`[0:0]\`.
-        -   If the search returns no relevant information, say that the knowledge base did not contain the answer instead of inventing it.
-
-        Configured knowledge sources:
-        ${sourceList}
-    `);
-    }
-    /**
-     * Builds a stable list of configured knowledge sources for system-message diagnostics.
-     *
-     * @param requirements - Current model requirements.
-     * @returns Human-readable source entries.
-     *
-     * @private internal utility of `KnowledgeCommitmentDefinition`
-     */
-    function createKnowledgeSourceSystemEntries(requirements) {
-        var _a;
-        const entries = [];
-        const seenEntries = new Set();
-        for (const source of requirements.knowledgeSources || []) {
-            const entry = `Source URL: ${source} (processed for retrieval during chat)`;
-            if (seenEntries.has(entry)) {
-                continue;
-            }
-            seenEntries.add(entry);
-            entries.push(entry);
-        }
-        const inlineSources = (((_a = requirements._metadata) === null || _a === void 0 ? void 0 : _a.inlineKnowledgeSources) || [])
-            .map((source) => source.filename)
-            .filter(Boolean);
-        for (const filename of inlineSources) {
-            const entry = `Knowledge Source Inline: ${filename} (Inline source: processed for retrieval during chat)`;
-            if (seenEntries.has(entry)) {
-                continue;
-            }
-            seenEntries.add(entry);
-            entries.push(entry);
-        }
-        return entries;
-    }
 
     /**
      * LANGUAGE commitment definition
@@ -26645,7 +26505,11 @@
             // Create new system message with persona at the beginning
             // Format: "You are {agentName}\n{personaContent}"
             // The # PERSONA comment will be removed later by removeCommentsFromSystemMessage
-            const personaSection = `# PERSONA\nYou are ${agentName}\n${mergedPersonaContent}`; // <- TODO: Use spaceTrim
+            const personaSection = _spaceTrim.spaceTrim((block) => `
+                # PERSONA
+                You are ${agentName}
+                ${block(mergedPersonaContent)}
+            `);
             const newSystemMessage = cleanedMessage ? `${personaSection}\n\n${cleanedMessage}` : personaSection;
             return {
                 ...requirements,
@@ -36246,7 +36110,7 @@
      */
     async function prepareSdkTranspilerContext(book, options) {
         const { agentName } = await parseAgentSource(book);
-        const rawModelRequirements = await createAgentModelRequirements(book, undefined, undefined, undefined, {
+        const modelRequirements = await createAgentModelRequirements(book, undefined, undefined, undefined, {
             agentReferenceResolver: options === null || options === void 0 ? void 0 : options.agentReferenceResolver,
             inlineKnowledgeSourceUploader: options === null || options === void 0 ? void 0 : options.inlineKnowledgeSourceUploader,
             teammateProfileResolver: options === null || options === void 0 ? void 0 : options.teammateProfileResolver,
@@ -36256,12 +36120,7 @@
         const knowledgeContent = knowledgeCommitments.map((commitment) => commitment.content.trim());
         const directKnowledge = knowledgeContent.filter((content) => !isKnowledgeSourceUrl(content));
         const knowledgeSources = knowledgeContent.filter((content) => isKnowledgeSourceUrl(content));
-        const isKnowledgeHandledWithRetrieval = directKnowledge.join('\n').length > SDK_TRANSPILER_KNOWLEDGE_THRESHOLD ||
-            knowledgeSources.length > 0 ||
-            knowledgeCommitments.length > 0;
-        const modelRequirements = normalizeSdkTranspilerModelRequirements(rawModelRequirements, {
-            isKnowledgeHandledWithRetrieval,
-        });
+        const isKnowledgeHandledWithRetrieval = directKnowledge.join('\n').length > SDK_TRANSPILER_KNOWLEDGE_THRESHOLD || knowledgeSources.length > 0;
         const transpiledTeam = createTranspiledTeamExportForContext({
             agentName,
             agentSource: book,
@@ -36279,36 +36138,6 @@
             transpiledTeam,
         };
     }
-    /**
-     * Removes the runtime-only knowledge-search tool from SDK harnesses that provide
-     * their own generated retrieval scaffold.
-     *
-     * @param modelRequirements - Raw compiled model requirements.
-     * @param options - Knowledge handling mode selected for the generated harness.
-     * @returns Model requirements safe to embed into a standalone SDK export.
-     */
-    function normalizeSdkTranspilerModelRequirements(modelRequirements, options) {
-        var _a;
-        if (!options.isKnowledgeHandledWithRetrieval) {
-            return modelRequirements;
-        }
-        const tools = (_a = modelRequirements.tools) === null || _a === void 0 ? void 0 : _a.filter((tool) => tool.name !== KNOWLEDGE_SEARCH_TOOL_NAME);
-        return {
-            ...modelRequirements,
-            systemMessage: removeKnowledgeSearchSystemSection(modelRequirements.systemMessage),
-            ...(tools ? { tools } : {}),
-        };
-    }
-    /**
-     * Removes the generated `## Knowledge Search` instructions from SDK exports
-     * that answer with the transpiler's native retrieval scaffold instead.
-     *
-     * @param systemMessage - Raw system message from compiled model requirements.
-     * @returns System message without the runtime-only knowledge-search section.
-     */
-    function removeKnowledgeSearchSystemSection(systemMessage) {
-        return systemMessage.replace(/(?:^|\n\n)## Knowledge Search[\s\S]*?(?=\n\n##|$)/, '').trim();
-    }
     /**
      * Detects whether one knowledge commitment points to a URL instead of inline text.
      *
@@ -41581,8 +41410,10 @@
      */
     const MatcherFormfactorDefinition = {
         name: 'EXPERIMENTAL_MATCHER',
-        description: `An evaluation system that determines whether content meets specific criteria or patterns.
-    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.`,
+        description: _spaceTrim.spaceTrim(`
+        An evaluation system that determines whether content meets specific criteria or patterns.
+        Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.
+    `),
         documentationUrl: `https://github.com/webgptorg/promptbook/discussions/177`,
         pipelineInterface: {
             inputParameters: [
@@ -41639,9 +41470,11 @@
      */
     const TranslatorFormfactorDefinition = {
         name: 'TRANSLATOR',
-        description: `A text transformation system that converts input content into different forms,
-    including language translations, paraphrasing, style conversions, and tone adjustments.
-    This form factor takes one input and produces one transformed output.`,
+        description: _spaceTrim.spaceTrim(`
+        A text transformation system that converts input content into different forms,
+        including language translations, paraphrasing, style conversions, and tone adjustments.
+        This form factor takes one input and produces one transformed output.
+    `),
         documentationUrl: `https://github.com/webgptorg/promptbook/discussions/175`,
         pipelineInterface: {
             inputParameters: [
@@ -43001,12 +42834,21 @@
                     // <- TODO: [🧠] Make this dynamic, async, prepare-phase HLAs
                 ],
             });
-            // TODO: Use spaceTrim in multiline strings
             $pipelineJson.tasks.push({
                 taskType: 'PROMPT_TASK',
                 name: 'create-an-answer',
                 title: 'Create an answer',
-                content: 'Write a response to the user message:\n\n**Question from user**\n\n> {userMessage}\n\n**Previous conversation**\n\n> {previousConversationSummary}',
+                content: _spaceTrim.spaceTrim(`
+                    Write a response to the user message:
+
+                    **Question from user**
+
+                    > {userMessage}
+
+                    **Previous conversation**
+
+                    > {previousConversationSummary}
+                `),
                 resultingParameterName: 'chatbotResponse',
                 personaName,
                 dependentParameterNames: [
@@ -43018,7 +42860,26 @@
                 taskType: 'PROMPT_TASK',
                 name: 'summarize-the-conversation',
                 title: 'Summarize the conversation',
-                content: 'Summarize the conversation in a few words:\n\n## Rules\n\n-   Summarise the text of the conversation in a few words\n-   Convert the text to its basic idea\n-   Imagine you are writing the headline or subject line of an email\n-   Respond with a few words of summary only\n\n## Conversation\n\n**User:**\n\n> {userMessage}\n\n**You:**\n\n> {chatbotResponse}',
+                content: _spaceTrim.spaceTrim(`
+                    Summarize the conversation in a few words:
+
+                    ## Rules
+
+                    -   Summarise the text of the conversation in a few words
+                    -   Convert the text to its basic idea
+                    -   Imagine you are writing the headline or subject line of an email
+                    -   Respond with a few words of summary only
+
+                    ## Conversation
+
+                    **User:**
+
+                    > {userMessage}
+
+                    **You:**
+
+                    > {chatbotResponse}
+                `),
                 resultingParameterName: 'conversationSummary',
                 personaName,
                 expectations: {
@@ -45401,11 +45262,11 @@
         if (attachments.length === 0) {
             return '';
         }
-        return [
-            CHAT_ATTACHMENTS_HEADING,
-            ...attachments.map((attachment) => formatChatAttachmentLine(attachment)),
-            CHAT_ATTACHMENTS_INSTRUCTION,
-        ].join('\n');
+        return _spaceTrim.spaceTrim((block) => `
+            ${CHAT_ATTACHMENTS_HEADING}
+            ${block(attachments.map((attachment) => formatChatAttachmentLine(attachment)).join('\n'))}
+            ${CHAT_ATTACHMENTS_INSTRUCTION}
+        `);
     }
 
     /**
@@ -45646,24 +45507,24 @@
             : ''}`
             : null;
         const warningsLine = contentResolution.warnings.length > 0 ? `Warnings: ${contentResolution.warnings.join(' | ')}` : null;
-        if (!contentResolution.content) {
+        const metadataLines = [decodingLine, warningsLine].filter((line) => Boolean(line)).join('\n');
+        const resolvedContent = contentResolution.content;
+        if (!resolvedContent) {
             const reason = contentResolution.reason || 'content unavailable';
-            return [`- ${attachmentLabel}: ${reason}. URL: ${contentResolution.attachment.url}`, decodingLine, warningsLine]
-                .filter(Boolean)
-                .join('\n');
+            return _spaceTrim.spaceTrim((block) => `
+                - ${attachmentLabel}: ${reason}. URL: ${contentResolution.attachment.url}
+                ${block(metadataLines)}
+            `);
         }
         const truncatedLabel = contentResolution.isTruncated ? ' [truncated]' : '';
-        return [
-            `File: ${attachmentLabel}${truncatedLabel}`,
-            `URL: ${contentResolution.attachment.url}`,
-            decodingLine,
-            warningsLine,
-            '```text',
-            contentResolution.content,
-            '```',
-        ]
-            .filter(Boolean)
-            .join('\n');
+        return _spaceTrim.spaceTrim((block) => `
+            File: ${attachmentLabel}${truncatedLabel}
+            URL: ${contentResolution.attachment.url}
+            ${block(metadataLines)}
+            \`\`\`text
+            ${block(resolvedContent)}
+            \`\`\`
+        `);
     }
     /**
      * Formats inline attachment-content context section for the model.
@@ -45677,11 +45538,14 @@
         if (resolvedContents.length === 0) {
             return '';
         }
-        return [
-            CHAT_ATTACHMENT_CONTENT_HEADING,
-            CHAT_ATTACHMENT_CONTENT_INSTRUCTION,
-            ...resolvedContents.map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent)),
-        ].join('\n\n');
+        return _spaceTrim.spaceTrim((block) => `
+            ${CHAT_ATTACHMENT_CONTENT_HEADING}
+            ${CHAT_ATTACHMENT_CONTENT_INSTRUCTION}
+
+            ${block(resolvedContents
+        .map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent))
+        .join('\n\n'))}
+        `);
     }
 
     /**
@@ -46299,7 +46163,7 @@
                 });
             }
             let vectorStoreId = cachedVectorStoreId;
-            if (this.isNativeKnowledgeSearchEnabled && !vectorStoreId && knowledgeSources && knowledgeSources.length > 0) {
+            if (!vectorStoreId && knowledgeSources && knowledgeSources.length > 0) {
                 const vectorStoreResult = await this.createVectorStoreWithKnowledgeSources({
                     client: await this.getClient(),
                     name,
@@ -46308,19 +46172,13 @@
                 });
                 vectorStoreId = vectorStoreResult.vectorStoreId;
             }
-            else if (this.isNativeKnowledgeSearchEnabled && vectorStoreId && this.options.isVerbose) {
+            else if (vectorStoreId && this.options.isVerbose) {
                 console.info('[🤰]', 'Using cached vector store for AgentKit agent', {
                     name,
                     vectorStoreId,
                 });
             }
-            if (!this.isNativeKnowledgeSearchEnabled) {
-                vectorStoreId = undefined;
-            }
-            const agentKitTools = this.buildAgentKitTools({
-                tools,
-                vectorStoreId,
-            });
+            const agentKitTools = this.buildAgentKitTools({ tools, vectorStoreId });
             const openAiAgentKitAgent = new agents.Agent({
                 name,
                 model: this.agentKitModelName,
@@ -46339,7 +46197,7 @@
                     name,
                     model: this.agentKitModelName,
                     toolCount: agentKitTools.length,
-                    hasVectorStore: this.isNativeKnowledgeSearchEnabled && Boolean(vectorStoreId),
+                    hasVectorStore: Boolean(vectorStoreId),
                 });
             }
             return preparedAgent;
@@ -46838,12 +46696,6 @@
         get agentKitOptions() {
             return this.options;
         }
-        /**
-         * Returns true when hosted OpenAI vector-store search should back `knowledgeSources`.
-         */
-        get isNativeKnowledgeSearchEnabled() {
-            return this.agentKitOptions.isNativeKnowledgeSearchEnabled !== false;
-        }
         /**
          * Discriminant for type guards.
          */