@promptbook/core 0.112.0-64 → 0.112.0-65

package/esm/index.es.js

@@ -28,7 +28,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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
@@ -12088,18 +12088,6 @@ function parseDataUrlKnowledgeSource(source) {
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
-/**
- * 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
  *
@@ -12221,17 +12209,9 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
             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');
     }
 }
 /**
@@ -12245,128 +12225,6 @@ function hasMeaningfulNonUrlText(content, urls) {
     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$1(`
-                    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$1(`
-        ## ${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
@@ -18092,7 +17950,11 @@ class PersonaCommitmentDefinition extends BaseCommitmentDefinition {
         // 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$1((block) => `
+                # PERSONA
+                You are ${agentName}
+                ${block(mergedPersonaContent)}
+            `);
         const newSystemMessage = cleanedMessage ? `${personaSection}\n\n${cleanedMessage}` : personaSection;
         return {
             ...requirements,
@@ -27699,6 +27561,791 @@ const DEFAULT_BOOK = padBook(validateBook(spaceTrim$1(`
 //                  <- [🐱‍🚀] Buttons into genesis book
 // <- TODO: [🐱‍🚀] generateBookBoilerplate and deprecate `DEFAULT_BOOK`
 
+/**
+ * Warning message used for unfinished commitments.
+ */
+const UNFINISHED_COMMITMENT_MESSAGE = 'This commitment is unfinished and not ready to use. Be careful when using it.';
+/**
+ * Low-level warning message used for low-level commitments.
+ */
+const LOW_LEVEL_COMMITMENT_MESSAGE = 'This commitment is low-level and not used by most of the users. Be careful when using it.';
+/**
+ * Short badge text used for deprecated commitments.
+ */
+const DEPRECATED_COMMITMENT_BADGE_LABEL = 'Deprecated';
+/**
+ * Short badge text used for unfinished and low-level commitments.
+ */
+const LOW_LEVEL_COMMITMENT_BADGE_LABEL = 'Low-level';
+/**
+ * Longer label used for deprecated commitments.
+ */
+const DEPRECATED_COMMITMENT_DETAIL_LABEL = 'Deprecated commitment';
+/**
+ * Longer label used for unfinished and low-level commitments.
+ */
+const LOW_LEVEL_COMMITMENT_DETAIL_LABEL = 'Low-level commitment';
+/**
+ * Prefix used when formatting replacement guidance.
+ */
+const PREFERRED_REPLACEMENT_LABEL = 'Preferred replacement';
+/**
+ * Formats preferred replacement guidance for deprecated commitments.
+ *
+ * @param replacedBy - Preferred replacement commitment keywords.
+ * @returns Optional replacement guidance sentence with leading space.
+ *
+ * @private internal utility of commitment catalog notices
+ */
+function formatCommitmentReplacementText(replacedBy) {
+    if (!replacedBy || replacedBy.length === 0) {
+        return '';
+    }
+    return ` ${PREFERRED_REPLACEMENT_LABEL}: ${replacedBy.map((type) => `\`${type}\``).join(', ')}.`;
+}
+/**
+ * Resolves the notice metadata for deprecated, unfinished, or low-level commitments.
+ *
+ * @param definition - Commitment definition to inspect.
+ * @returns Notice metadata when the commitment should be surfaced with caution.
+ *
+ * @private internal utility of commitment catalog notices
+ */
+function getCommitmentNoticeMetadata(definition) {
+    if (definition.isUnfinished) {
+        return {
+            kind: 'unfinished',
+            badgeLabel: LOW_LEVEL_COMMITMENT_BADGE_LABEL,
+            detailLabel: LOW_LEVEL_COMMITMENT_DETAIL_LABEL,
+            message: UNFINISHED_COMMITMENT_MESSAGE,
+        };
+    }
+    if (definition.isLowLevel) {
+        return {
+            kind: 'lowLevel',
+            badgeLabel: LOW_LEVEL_COMMITMENT_BADGE_LABEL,
+            detailLabel: LOW_LEVEL_COMMITMENT_DETAIL_LABEL,
+            message: LOW_LEVEL_COMMITMENT_MESSAGE,
+        };
+    }
+    if (definition.deprecation) {
+        return {
+            kind: 'deprecated',
+            badgeLabel: DEPRECATED_COMMITMENT_BADGE_LABEL,
+            detailLabel: DEPRECATED_COMMITMENT_DETAIL_LABEL,
+            message: definition.deprecation.message,
+        };
+    }
+    return null;
+}
+
+/**
+ * Common anti-patterns with practical fixes.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const bookLanguageCommonPitfalls = [
+    {
+        title: 'Too broad agent scope',
+        dont: 'One agent tries to be a lawyer, developer, marketer, and researcher at once.',
+        doInstead: 'Split into focused agents and orchestrate with TEAM or IMPORT.',
+    },
+    {
+        title: 'Unverifiable claims',
+        dont: 'The agent answers internet-dependent questions without tools or without citing sources.',
+        doInstead: 'Add `USE SEARCH ENGINE` / `USE BROWSER` and a citation-oriented `RULE`.',
+    },
+    {
+        title: 'Missing guardrails',
+        dont: 'Only persona is defined, with no behavioral constraints.',
+        doInstead: 'Add concrete `RULE` commitments for safety, scope, and tone.',
+    },
+    {
+        title: 'Overloaded inheritance',
+        dont: 'Using deep `FROM` chains without documenting why each parent is needed.',
+        doInstead: 'Keep inheritance shallow and use focused IMPORT/TEAM composition for reuse.',
+    },
+    {
+        title: 'Unsafe memory usage',
+        dont: 'Storing every detail in memory without boundaries.',
+        doInstead: 'Pair `MEMORY` with explicit rules about what is allowed to persist.',
+    },
+];
+
+/**
+ * End-to-end examples used by the standalone Book language documentation.
+ *
+ * These are intentionally compact but complete, so they can be copy-pasted and
+ * used as practical starting points.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const bookLanguageDocumentationExamples = [
+    {
+        id: 'minimal-hello-world-agent',
+        title: 'Minimal hello-world agent',
+        goal: 'Create the smallest useful agent with identity and greeting.',
+        source: spaceTrim$1(`
+            Hello World Agent
+
+            GOAL Be a concise and friendly assistant.
+            INITIAL MESSAGE Hello! I am ready to help.
+            CLOSED
+        `),
+        walkthrough: [
+            'The first line (`Hello World Agent`) is the agent name.',
+            '`GOAL` defines the effective role and profile text.',
+            '`INITIAL MESSAGE` sets a deterministic first message for a new chat.',
+            '`CLOSED` prevents conversational self-modification.',
+        ],
+    },
+    {
+        id: 'tool-using-browser-search-agent',
+        title: 'Tool-using agent (Browser + Search engine)',
+        goal: 'Enable internet research with clear sourcing behavior.',
+        source: spaceTrim$1(`
+            Web Research Assistant
+
+            GOAL Research topics using fresh and verifiable information.
+            USE SEARCH ENGINE Prefer official sources and recent publications.
+            USE BROWSER
+            RULE Verify important claims across multiple sources when possible.
+            RULE Include source links in your final answer.
+            INITIAL MESSAGE Ask me what topic you want to research and how deep the report should be.
+        `),
+        walkthrough: [
+            '`USE SEARCH ENGINE` provides web search tooling and optional search instructions.',
+            '`USE BROWSER` enables URL fetching and interactive browsing tools.',
+            '`RULE` commitments make reliability behavior explicit and repeatable.',
+            'This pattern is ideal for current-events and fact-checking agents.',
+        ],
+    },
+    {
+        id: 'rule-and-knowledge-agent',
+        title: 'Agent with RULE and KNOWLEDGE',
+        goal: 'Ground responses in explicit constraints and curated sources.',
+        source: spaceTrim$1(`
+            Support Policy Assistant
+
+            GOAL Answer questions about support policy.
+            KNOWLEDGE Refunds are available within 30 days with proof of purchase.
+            KNOWLEDGE https://example.com/support-policy
+            RULE If a policy item is missing in available knowledge, say it explicitly.
+            RULE Never invent legal or policy statements.
+            INITIAL MESSAGE I can explain refund and support rules from provided knowledge.
+        `),
+        walkthrough: [
+            '`KNOWLEDGE` may be inline text or an external URL/document.',
+            '`RULE` commitments define non-negotiable behavior constraints.',
+            'Combining both creates predictable, grounded policy responses.',
+            'Use this pattern for compliance, support, and internal procedures.',
+        ],
+    },
+    {
+        id: 'memory-agent-with-long-term-memory',
+        title: 'MEMORY agent with long-term memory',
+        goal: 'Persist user preferences across conversations.',
+        source: spaceTrim$1(`
+            Customer Success Memory Agent
+
+            GOAL Support SaaS customers while remembering relevant setup and preference context.
+            MEMORY Remember product setup, user goals, and communication preferences.
+            RULE Store only user-approved preferences and project context.
+            RULE Never store secrets or sensitive data unless explicitly requested and allowed.
+            INITIAL MESSAGE I can remember your setup and preferences for future sessions.
+        `),
+        walkthrough: [
+            '`MEMORY` adds runtime memory tools and memory-specific system guidance.',
+            '`RULE` commitments narrow what should be remembered to reduce privacy risks.',
+            'In Agents Server, memory is runtime-backed and user-scoped.',
+            'Use this for assistants that must preserve context over time.',
+        ],
+    },
+    {
+        id: 'use-project-and-wallet-integration-agent',
+        title: 'USE PROJECT and WALLET external integration',
+        goal: 'Work with GitHub repositories and wallet-backed credentials.',
+        source: spaceTrim$1(`
+            Repository Maintainer
+
+            GOAL Maintain a GitHub repository and prepare safe pull requests.
+            USE PROJECT https://github.com/acme/website
+            WALLET Store credentials for repository operations.
+            RULE Before editing files, explain the planned change and impacted paths.
+            RULE Never reveal raw credentials in chat output.
+            INITIAL MESSAGE I can inspect the repository and help you prepare PR-ready changes.
+        `),
+        walkthrough: [
+            '`USE PROJECT` enables repository tools for listing, reading, editing files, and creating PRs.',
+            'Credentials are resolved from wallet records at runtime in Agents Server.',
+            '`WALLET` is kept here as a compatibility marker, but current Book 2.0 parsing treats it as deprecated/ignored.',
+            'In current runtime behavior, wallet-backed integrations are driven by commitments such as `USE PROJECT` and `USE EMAIL`.',
+        ],
+    },
+    {
+        id: 'use-calendar-integration-agent',
+        title: 'USE CALENDAR integration',
+        goal: 'Coordinate meetings and schedules through a connected Google Calendar.',
+        source: spaceTrim$1(`
+            Calendar Assistant
+
+            GOAL Schedule meetings and keep the calendar conflict-free.
+            USE CALENDAR https://calendar.google.com/calendar/u/0/r
+            SCOPES https://www.googleapis.com/auth/calendar
+            RULE Confirm destructive actions before deleting an event.
+            INITIAL MESSAGE Tell me the meeting details and I will schedule it in your calendar.
+        `),
+        walkthrough: [
+            '`USE CALENDAR` enables calendar tools for listing, reading, creating, updating, and deleting events.',
+            'The first calendar URL identifies which calendar integration should be used.',
+            '`SCOPES` can explicitly request required Google Calendar OAuth permissions.',
+            'Credentials are resolved from wallet-backed Google Calendar OAuth records at runtime in Agents Server.',
+        ],
+    },
+    {
+        id: 'agents-team-example',
+        title: 'Agents TEAM (with in-book teammates)',
+        goal: 'Delegate sub-tasks to specialized teammates.',
+        source: spaceTrim$1(`
+            Team Manager
+
+            GOAL Coordinate specialists and deliver one consolidated answer.
+            TEAM Ask {Legal Reviewer} for legal constraints and {Implementation Reviewer} for technical feasibility.
+            RULE Always summarize teammate outputs into one action plan.
+
+            ---
+
+            Legal Reviewer
+
+            FROM VOID
+            GOAL Review legal and compliance risk.
+            RULE Flag legal/compliance risk and uncertainty clearly.
+            CLOSED
+
+            ---
+
+            Implementation Reviewer
+
+            FROM VOID
+            GOAL Review implementation effort and delivery risk.
+            RULE Estimate complexity and identify blockers.
+            CLOSED
+        `),
+        walkthrough: [
+            'The main agent delegates via `TEAM` commitment.',
+            'References in `{...}` are resolved against embedded agents inside the same book (split by `---`).',
+            'Each teammate can be isolated with `FROM VOID` for deterministic specialization.',
+            'This pattern works well for multi-role review and decision support.',
+        ],
+    },
+];
+
+/**
+ * Canonical commitment keyword for the open/closed family.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const OPEN_COMMITMENT_TYPE = 'OPEN';
+/**
+ * Canonical commitment keyword for the open/closed family.
+ */
+const CLOSED_COMMITMENT_TYPE = 'CLOSED';
+/**
+ * Removes the top-level heading from one commitment documentation block.
+ *
+ * @param markdown - Original markdown source.
+ * @returns Markdown without the first `#` heading.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function removeLeadingTopLevelHeading(markdown) {
+    return markdown.replace(/^\s*#\s+[^\n]+\n*/u, '').trim();
+}
+/**
+ * Renders one subsection for the combined open/closed documentation family.
+ *
+ * @param title - Heading label for the subsection.
+ * @param documentation - Raw commitment documentation markdown.
+ * @returns Markdown subsection with a `####` heading.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function renderDocumentationSection(title, documentation) {
+    return `#### ${title}\n\n${removeLeadingTopLevelHeading(documentation)}`;
+}
+/**
+ * Renders the documentation body for one grouped commitment entry.
+ *
+ * `OPEN` and `CLOSED` are intentionally rendered together so the documentation
+ * surfaces present them as one conceptual switch instead of two isolated pages.
+ *
+ * @param group - Grouped commitment metadata.
+ * @returns Markdown body for the docs page/catalog entry.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function renderGroupedCommitmentDocumentationMarkdown(group) {
+    const commitmentTypes = new Set([group.primary.type, ...group.aliases]);
+    if (commitmentTypes.has(OPEN_COMMITMENT_TYPE) && commitmentTypes.has(CLOSED_COMMITMENT_TYPE)) {
+        const openCommitmentDefinition = getCommitmentDefinition(OPEN_COMMITMENT_TYPE);
+        const closedCommitmentDefinition = getCommitmentDefinition(CLOSED_COMMITMENT_TYPE);
+        if (openCommitmentDefinition && closedCommitmentDefinition) {
+            return spaceTrim$1((block) => `
+                    ${block(renderDocumentationSection(OPEN_COMMITMENT_TYPE, openCommitmentDefinition.documentation))}
+
+                    ${block(renderDocumentationSection(CLOSED_COMMITMENT_TYPE, closedCommitmentDefinition.documentation))}
+                `);
+        }
+    }
+    return removeLeadingTopLevelHeading(group.primary.documentation);
+}
+
+/**
+ * Commitment types that primarily model composition of multiple agents.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const COMPOSITION_COMMITMENT_TYPES = new Set(['FROM', 'IMPORT', 'IMPORTS', 'TEAM']);
+/**
+ * Commitment types that expose tools/runtime capabilities.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const TOOLING_COMMITMENT_TYPES = new Set([
+    'USE BROWSER',
+    'USE DEEPSEARCH',
+    'USE SEARCH ENGINE',
+    'USE SEARCH',
+    'USE SPAWN',
+    'USE EMAIL',
+    'USE POPUP',
+    'USE TIME',
+    'USE USER LOCATION',
+    'USE PROJECT',
+    'USE CALENDAR',
+    'USE IMAGE GENERATOR',
+    'USE MCP',
+    'USE PRIVACY',
+    'MEMORY',
+    'MEMORIES',
+]);
+/**
+ * Commitment types that primarily define agent profile metadata.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const PROFILE_COMMITMENT_TYPES = new Set([
+    'GOAL',
+    'GOALS',
+    'PERSONA',
+    'PERSONAE',
+    'META',
+    'META AVATAR',
+    'META IMAGE',
+    'META LINK',
+    'META DOMAIN',
+    'META DESCRIPTION',
+    'META DISCLAIMER',
+    'META INPUT PLACEHOLDER',
+    'META COLOR',
+    'META FONT',
+    'META VOICE',
+    'INITIAL MESSAGE',
+    'MODEL',
+    'MODELS',
+]);
+/**
+ * Commitment types that primarily define behavioral constraints or prompt shaping.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+const BEHAVIOR_COMMITMENT_TYPES = new Set([
+    'RULE',
+    'RULES',
+    'KNOWLEDGE',
+    'GOAL',
+    'GOALS',
+    'STYLE',
+    'STYLES',
+    'LANGUAGE',
+    'LANGUAGES',
+    'FORMAT',
+    'FORMATS',
+    'TEMPLATE',
+    'TEMPLATES',
+    'WRITING SAMPLE',
+    'WRITING RULES',
+    'SAMPLE',
+    'EXAMPLE',
+    'SCENARIO',
+    'SCENARIOS',
+    'MESSAGE',
+    'MESSAGES',
+    'MESSAGE SUFFIX',
+    'USER MESSAGE',
+    'AGENT MESSAGE',
+    'INTERNAL MESSAGE',
+    'OPEN',
+    'CLOSED',
+]);
+/**
+ * Creates one standalone markdown guide for Book language (Book 2.0 / agent language).
+ *
+ * The output intentionally combines:
+ * - static conceptual building blocks maintained in this repository
+ * - dynamically generated commitment catalog from runtime commitment definitions
+ * so docs stay up-to-date by design.
+ *
+ * @returns Full standalone markdown document.
+ *
+ * @public exported from `@promptbook/core`
+ */
+function createStandaloneBookLanguageMarkdown() {
+    const groupedCommitments = getGroupedCommitmentDefinitions();
+    const generatedAtIso = new Date().toISOString();
+    const placeholderCommitmentCount = groupedCommitments.filter(({ primary }) => primary instanceof NotYetImplementedCommitmentDefinition).length;
+    const implementedCommitmentCount = groupedCommitments.length - placeholderCommitmentCount;
+    const allCommitmentKeywords = groupedCommitments.flatMap(({ primary, aliases }) => [primary.type, ...aliases]);
+    const toolingCommitments = groupedCommitments.filter(({ primary }) => TOOLING_COMMITMENT_TYPES.has(primary.type));
+    const profileCommitments = groupedCommitments.filter(({ primary }) => PROFILE_COMMITMENT_TYPES.has(primary.type));
+    const compositionCommitments = groupedCommitments.filter(({ primary }) => COMPOSITION_COMMITMENT_TYPES.has(primary.type));
+    const behaviorCommitments = groupedCommitments.filter(({ primary }) => BEHAVIOR_COMMITMENT_TYPES.has(primary.type));
+    return spaceTrim$1(
+    // [✨]
+    (block) => `
+            # Book Language blueprint
+
+            > Canonical standalone guide for Promptbook Book Agent language.  
+            > Generated from repository https://github.com/webgptorg/promptbook
+
+            - Book language version: \`${BOOK_LANGUAGE_VERSION}\`
+            - Generated at: \`${generatedAtIso}\`
+            - Commitment groups: \`${groupedCommitments.length}\`
+            - Implemented commitments: \`${implementedCommitmentCount}\`
+            - Placeholder commitments: \`${placeholderCommitmentCount}\`
+
+            ## <a id="table-of-contents"></a>Table of Contents
+
+            - [What Book language is](#what-book-language-is)
+            - [Execution and compilation model](#execution-and-compilation-model)
+            - [Mental model of an agent](#mental-model-of-an-agent)
+            - [How to structure good agents](#how-to-structure-good-agents)
+            - [Primitives and constructs reference](#primitives-and-constructs-reference)
+            - [Commitment catalog (all commitments)](#commitment-catalog-all-commitments)
+            - [End-to-end examples](#end-to-end-examples)
+            - [Do nots and common pitfalls](#do-nots-and-common-pitfalls)
+            - [Build an agent from scratch (offline tutorial)](#build-an-agent-from-scratch-offline-tutorial)
+
+            ## <a id="what-book-language-is"></a>What Book language is
+
+            Book language is a domain-specific language for defining **AI agents** as plain-text source.
+            It solves these problems:
+
+            - **One editable source of truth** for agent behavior, tools, memory, and profile metadata.
+            - **Composable agent architecture** through commitments like \`FROM\`, \`IMPORT\`, and \`TEAM\`.
+            - **Deterministic runtime preparation** where source is parsed and compiled into model requirements.
+            - **Portable agent definitions** that can be copied, versioned, and reviewed as text.
+
+            In this repository, "Book language" means **Book 2.0 agent language**.
+
+            ## <a id="execution-and-compilation-model"></a>Execution and compilation model
+
+            Promptbook and Agents Server use two core passes:
+
+            1. **Fast parse pass** (\`parseAgentSource\`):
+            It synchronously extracts agent profile/basic info (name, last goal/profile text, meta, capabilities, samples, references).
+            2. **Compilation pass** (\`createAgentModelRequirements\`):
+            It applies commitments in sequence and builds executable model requirements (system message, tools, memory/tool metadata, imports, etc.).
+
+            In Agents Server, the runtime flow typically includes:
+
+            1. Resolve scoped references (including in-book references like \`{Some Agent}\`).
+            2. Resolve inheritance/import chains into effective source.
+            3. Compile effective source into model requirements.
+            4. Execute chat turns with resolved tools and runtime adapters.
+
+            ## <a id="mental-model-of-an-agent"></a>Mental model of an agent
+
+            Think of one agent source as four layers:
+
+            1. **Identity/Profile layer**:
+            Agent name (first non-commitment line), the last \`GOAL\` (preferred) or deprecated \`PERSONA\`, and \`META*\` commitments.
+            2. **Behavior layer**:
+            \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, deprecated \`STYLE\`, \`FORMAT\`, \`TEMPLATE\`, \`LANGUAGE\`, \`GOAL\`, and related commitments.
+            3. **Capability layer**:
+            \`USE*\`, \`MEMORY\`, and other tooling commitments exposing runtime abilities.
+            4. **Composition layer**:
+            \`FROM\` inheritance, \`IMPORT\` reuse, and \`TEAM\` delegation.
+
+            Agent composition commitments in current runtime:
+
+            - Profile-centric commitments detected: ${profileCommitments
+        .map(({ primary }) => `\`${primary.type}\``)
+        .join(', ')}
+            - Behavior-centric commitments detected: ${behaviorCommitments
+        .map(({ primary }) => `\`${primary.type}\``)
+        .join(', ')}
+            - Tool/runtime commitments detected: ${toolingCommitments
+        .map(({ primary }) => `\`${primary.type}\``)
+        .join(', ')}
+            - Composition commitments detected: ${compositionCommitments
+        .map(({ primary }) => `\`${primary.type}\``)
+        .join(', ')}
+
+            ### META commitments and agent profile
+
+            \`META*\` commitments control profile data shown in UI (for example avatar visual, image, description, disclaimers, domain, input placeholder).
+            They generally shape presentation/metadata rather than tool behavior.
+
+            ### FROM inheritance
+
+            \`FROM\` points to a parent agent source. During inheritance resolution:
+
+            - Parent corpus is merged into effective source.
+            - \`FROM {Void}\` / \`FROM VOID\` means explicit "no parent".
+            - Missing references are surfaced as notes in resolved source.
+
+            ### TEAM and IMPORT
+
+            - \`TEAM\` registers teammate agents as callable tools.
+            - \`IMPORT\` injects imported agent/file content into current agent context.
+            - In Agents Server, compact references like \`{Legal Reviewer}\` can resolve to embedded in-book agents.
+
+            ### USE commitments
+
+            \`USE*\` commitments enable capabilities (search, browser, project integration, email, image generation, etc.).
+            They expose runtime tools and system-message guidance used during execution.
+
+            ## <a id="how-to-structure-good-agents"></a>How to structure good agents
+
+            Recommended patterns and tradeoffs:
+
+            1. **Single clear role first**:
+            Start with one narrow \`GOAL\`; use \`PERSONA\` only for backward-compatible legacy books.
+            Tradeoff: less initial flexibility, much higher reliability.
+            2. **Guardrails early**:
+            Add concrete \`RULE\` commitments before adding many tools.
+            Tradeoff: more upfront design, fewer runtime surprises.
+            3. **Grounding over improvisation**:
+            Prefer \`KNOWLEDGE\` + explicit citation rule for high-stakes answers.
+            Tradeoff: extra maintenance for sources, better factual control.
+            4. **Composition over monoliths**:
+            Use \`TEAM\`/\`IMPORT\` for specialized responsibilities.
+            Tradeoff: orchestration overhead, stronger modularity and reuse.
+            5. **Controlled memory**:
+            If using \`MEMORY\`, define what must and must not be remembered.
+            Tradeoff: stricter policy design, better privacy and signal quality.
+
+            ## <a id="primitives-and-constructs-reference"></a>Primitives and constructs reference
+
+            ### Core syntax primitives
+
+            1. **Agent title**:
+            First non-empty line that is not a commitment keyword.
+            2. **Commitment block**:
+            Starts with a commitment keyword and continues until the next commitment block or separator.
+            3. **Horizontal separator**:
+            Lines like \`---\` split sections; in Agents Server they can delimit embedded in-book agents.
+            4. **Code fences**:
+            Preserved inside commitment content; useful for examples/instructions.
+            5. **Parameters**:
+            Both \`@parameter\` and \`{parameter}\` notations are supported and parsed.
+
+            ### Reference tokens and pseudo-agents
+
+            - Compact references like \`{Agent Name}\` are resolved by Agents Server reference resolver.
+            - Pseudo-agent forms (for example \`{User}\`, \`{Void}\`) are supported in relevant commitments.
+            - \`{User}\` is intended for \`TEAM\`; \`{Void}\` is useful for explicit no-parent inheritance.
+
+            ### Commitment keywords currently recognized
+
+            ${block(getSafeCodeBlock(allCommitmentKeywords.join(', '), 'text'))}
+
+            ## <a id="commitment-catalog-all-commitments"></a>Commitment catalog (all commitments)
+
+            This section is generated from commitment definitions in \`src/commitments\`.
+            For each commitment group you get:
+
+            - semantics summary (description/icon/status)
+            - parsing schema (\`createTypeRegex\` and \`createRegex\`)
+            - canonical documentation block
+
+            ${block(groupedCommitments.map(renderCommitmentCatalogSection).join('\n\n'))}
+
+            ## <a id="end-to-end-examples"></a>End-to-end examples
+
+            ${block(bookLanguageDocumentationExamples.map(renderExampleSection).join('\n\n'))}
+
+            ## <a id="do-nots-and-common-pitfalls"></a>Do nots and common pitfalls
+
+            ${block(bookLanguageCommonPitfalls
+        .map((pitfall, index) => spaceTrim$1(`
+                            ${index + 1}. **${pitfall.title}**
+                            - Don't: ${pitfall.dont}
+                            - Do instead: ${pitfall.doInstead}
+                        `))
+        .join('\n'))}
+
+            ## <a id="build-an-agent-from-scratch-offline-tutorial"></a>Build an agent from scratch (offline tutorial)
+
+            This tutorial is sufficient without internet access.
+
+            1. **Define role and goal**
+            Create a short name line and one clear \`GOAL\`.
+            2. **Add behavioral constraints**
+            Add 3-6 specific \`RULE\` commitments covering scope, tone, and safety boundaries.
+            3. **Add grounding**
+            Add \`KNOWLEDGE\` commitments (inline text or local/importable sources).
+            4. **Add capabilities**
+            Add only necessary \`USE*\` and/or \`MEMORY\` commitments.
+            5. **Set profile metadata**
+            Add \`META DESCRIPTION\`, \`META AVATAR\` or \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, and disclaimers if needed.
+            6. **Add first interaction**
+            Add \`INITIAL MESSAGE\` and optionally sample \`USER MESSAGE\` / \`AGENT MESSAGE\` pairs.
+            7. **Close for deterministic behavior (optional)**
+            Add \`CLOSED\` when you want stable non-self-modifying behavior.
+
+            Copy-paste template:
+
+            ${block(getSafeCodeBlock(spaceTrim$1(`
+                        Project Assistant
+
+                        GOAL Help the user turn project ideas into concrete deliverables with focused planning support.
+
+                        RULE Ask clarifying questions when requirements are ambiguous.
+                        RULE Provide concise, structured outputs with actionable steps.
+                        RULE If information is missing, state assumptions explicitly.
+                        RULE Do not invent facts.
+
+                        KNOWLEDGE Team works in two-week sprints and tracks tasks in Kanban.
+                        KNOWLEDGE Preferred output format: summary, plan, risks, next action.
+
+                        META DESCRIPTION Practical project-planning assistant.
+                        META INPUT PLACEHOLDER Describe your project goal or blocker...
+
+                        INITIAL MESSAGE Share your project goal and current blocker, and I will propose a concrete next-step plan.
+                        CLOSED
+                    `), 'book'))}
+
+            Validation checklist:
+
+            - Does each commitment have a clear purpose?
+            - Are there explicit constraints against hallucination and unsafe behavior?
+            - Are tools only enabled when genuinely needed?
+            - Is memory usage bounded by clear rules?
+            - Is composition (\`FROM\`/\`TEAM\`/\`IMPORT\`) justified and understandable?
+
+            ---
+
+            Generated from:
+
+            - Commitments registry and runtime docs in \`src/commitments\`
+            - Parser/compiler behavior in \`src/book-2.0/agent-source\`
+            - Agents Server reference/inheritance resolution in \`apps/agents-server/src/utils\`
+            - Standalone docs source blocks in \`apps/agents-server/src/utils/bookLanguageDocumentation\`
+        `);
+}
+/**
+ * Renders one commitment section in the generated catalog.
+ *
+ * @param groupedCommitment - Grouped commitment definition with aliases.
+ * @returns Markdown section for a single commitment.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function renderCommitmentCatalogSection(groupedCommitment) {
+    var _a;
+    const { primary, aliases } = groupedCommitment;
+    const notice = getCommitmentNoticeMetadata(primary);
+    const status = primary instanceof NotYetImplementedCommitmentDefinition
+        ? 'Placeholder (not fully implemented)'
+        : notice
+            ? `Implemented (${notice.detailLabel})`
+            : 'Implemented';
+    const aliasText = aliases.length === 0 ? 'None' : aliases.map((alias) => `\`${alias}\``).join(', ');
+    const noticeText = notice
+        ? notice.kind === 'deprecated'
+            ? `- **Deprecation:** ${notice.message}${formatCommitmentReplacementText((_a = primary.deprecation) === null || _a === void 0 ? void 0 : _a.replacedBy)}`
+            : `- **Low-level commitment:** ${notice.message}`
+        : '';
+    const documentationMarkdown = renderGroupedCommitmentDocumentationMarkdown(groupedCommitment);
+    return spaceTrim$1((block) => `
+            ### <a id="commitment-${toStableAnchorId(primary.type)}"></a>${primary.icon} ${primary.type}
+
+            - **Status:** ${status}
+            - **Aliases:** ${aliasText}
+            - **Semantics:** ${primary.description}
+            - **Type schema (\`createTypeRegex\`):** \`${stringifyRegex(primary.createTypeRegex())}\`
+            - **Block schema (\`createRegex\`):** \`${stringifyRegex(primary.createRegex())}\`
+            ${noticeText}
+
+            ${block(documentationMarkdown)}
+        `);
+}
+/**
+ * Renders one end-to-end example section.
+ *
+ * @param example - Example definition.
+ * @returns Markdown section for one example.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function renderExampleSection(example) {
+    return spaceTrim$1((block) => `
+            ### <a id="example-${toStableAnchorId(example.id)}"></a>${example.title}
+
+            **Goal:** ${example.goal}
+
+            **Full source**
+
+            ${block(getSafeCodeBlock(example.source, 'book'))}
+
+            **Walkthrough**
+
+            ${block(example.walkthrough.map((step, index) => `${index + 1}. ${step}`).join('\n'))}
+        `);
+}
+/**
+ * Converts a heading label into a stable markdown anchor id.
+ *
+ * @param value - Raw heading/identifier text.
+ * @returns Stable lowercase anchor id.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function toStableAnchorId(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Converts a regular expression into a concise literal-like string.
+ *
+ * @param regex - Regex instance.
+ * @returns Printable regex pattern and flags.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function stringifyRegex(regex) {
+    return `/${regex.source}/${regex.flags}`;
+}
+/**
+ * Creates a safe markdown fenced code block even when content contains backticks.
+ *
+ * @param content - Raw code content.
+ * @param language - Optional info-string language label.
+ * @returns Fenced code block.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+function getSafeCodeBlock(content, language = 'markdown') {
+    const maxBacktickCount = Math.max(0, ...(content.match(/`+/g) || []).map((match) => match.length));
+    const fence = '`'.repeat(Math.max(3, maxBacktickCount + 1));
+    return `${fence}${language}\n${content}\n${fence}`;
+}
+
 /**
  * Generates an image for the agent to use as profile image
  *
@@ -29706,8 +30353,10 @@ const ImageGeneratorFormfactorDefinition = {
  */
 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$1(`
+        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: [
@@ -29764,9 +30413,11 @@ const SheetsFormfactorDefinition = {
  */
 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$1(`
+        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: [
@@ -31126,12 +31777,21 @@ const QuickChatbotHla = {
                 // <- 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$1(`
+                    Write a response to the user message:
+
+                    **Question from user**
+
+                    > {userMessage}
+
+                    **Previous conversation**
+
+                    > {previousConversationSummary}
+                `),
             resultingParameterName: 'chatbotResponse',
             personaName,
             dependentParameterNames: [
@@ -31143,7 +31803,26 @@ const QuickChatbotHla = {
             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$1(`
+                    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: {
@@ -33547,11 +34226,11 @@ function formatChatAttachmentContext(attachments) {
     if (attachments.length === 0) {
         return '';
     }
-    return [
-        CHAT_ATTACHMENTS_HEADING,
-        ...attachments.map((attachment) => formatChatAttachmentLine(attachment)),
-        CHAT_ATTACHMENTS_INSTRUCTION,
-    ].join('\n');
+    return spaceTrim$1((block) => `
+            ${CHAT_ATTACHMENTS_HEADING}
+            ${block(attachments.map((attachment) => formatChatAttachmentLine(attachment)).join('\n'))}
+            ${CHAT_ATTACHMENTS_INSTRUCTION}
+        `);
 }
 
 /**
@@ -33792,24 +34471,24 @@ function formatResolvedChatAttachmentContent(contentResolution) {
             : ''}`
         : 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$1((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$1((block) => `
+            File: ${attachmentLabel}${truncatedLabel}
+            URL: ${contentResolution.attachment.url}
+            ${block(metadataLines)}
+            \`\`\`text
+            ${block(resolvedContent)}
+            \`\`\`
+        `);
 }
 /**
  * Formats inline attachment-content context section for the model.
@@ -33823,11 +34502,14 @@ function formatChatAttachmentContentContext(resolvedContents) {
     if (resolvedContents.length === 0) {
         return '';
     }
-    return [
-        CHAT_ATTACHMENT_CONTENT_HEADING,
-        CHAT_ATTACHMENT_CONTENT_INSTRUCTION,
-        ...resolvedContents.map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent)),
-    ].join('\n\n');
+    return spaceTrim$1((block) => `
+            ${CHAT_ATTACHMENT_CONTENT_HEADING}
+            ${CHAT_ATTACHMENT_CONTENT_INSTRUCTION}
+
+            ${block(resolvedContents
+        .map((resolvedContent) => formatResolvedChatAttachmentContent(resolvedContent))
+        .join('\n\n'))}
+        `);
 }
 
 /**
@@ -34986,9 +35668,11 @@ class OpenAiCompatibleUnsupportedParameterRetrier {
      * 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$1((block) => `
+                    All attempts failed. Attempt history:
+                    ${block(formatUnsupportedParameterAttemptHistory(this.attemptStack))}
+                    Final error: ${finalErrorMessage}
+                `));
     }
 }
 
@@ -37582,7 +38266,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
             });
         }
         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,
@@ -37591,19 +38275,13 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
             });
             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 Agent$1({
             name,
             model: this.agentKitModelName,
@@ -37622,7 +38300,7 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
                 name,
                 model: this.agentKitModelName,
                 toolCount: agentKitTools.length,
-                hasVectorStore: this.isNativeKnowledgeSearchEnabled && Boolean(vectorStoreId),
+                hasVectorStore: Boolean(vectorStoreId),
             });
         }
         return preparedAgent;
@@ -38121,12 +38799,6 @@ class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler {
     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.
      */
@@ -42650,7 +43322,7 @@ const SDK_TRANSPILER_KNOWLEDGE_THRESHOLD = 1000;
  */
 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,
@@ -42660,12 +43332,7 @@ async function prepareSdkTranspilerContext(book, options) {
     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,
@@ -42683,36 +43350,6 @@ async function prepareSdkTranspilerContext(book, options) {
         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.
  *
@@ -45383,5 +46020,5 @@ function $generateBookBoilerplate(options) {
 }
 // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
 
-export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AgentOsTranspiler, AnthropicClaudeManagedTranspiler, AnthropicClaudeSdkTranspiler, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, COLOR_CONSTANTS, CORE_AGENTS_SERVER, CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, ConflictError, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_CONCURRENT_UPLOADS, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_RECURSION, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, E2BTranspiler, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, HTTP_STATUS_CODES, ImageGeneratorFormfactorDefinition, KNOWLEDGE_SEARCH_TOOL_NAME, KnowledgeScrapeError, LIMITS, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NETWORK_LIMITS, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiAgentsTranspiler, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LEGAL_ENTITY, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, PROMPT_PARAMETER_SELF_LEARNING_ENABLED, PUBLIC_AGENTS_SERVERS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TIME_INTERVALS, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, VirusTotalFileSecurityChecker, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, appendChatAttachmentContext, appendChatAttachmentContextWithContent, book, cacheLlmTools, compilePipeline, computeAgentHash, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createBasicAgentModelRequirements, createDefaultAgentName, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, formatChatAttachmentContentContext, formatChatAttachmentContext, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getAllCommitmentsToolTitles, getCommitmentDefinition, getGroupedCommitmentDefinitions, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, normalizeAgentName, normalizeChatAttachments, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, resolveChatAttachmentContents, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
+export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AgentOsTranspiler, AnthropicClaudeManagedTranspiler, AnthropicClaudeSdkTranspiler, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, COLOR_CONSTANTS, CORE_AGENTS_SERVER, CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, ConflictError, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_CONCURRENT_UPLOADS, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_RECURSION, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, E2BTranspiler, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, HTTP_STATUS_CODES, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LIMITS, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NETWORK_LIMITS, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiAgentsTranspiler, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LEGAL_ENTITY, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, PROMPT_PARAMETER_SELF_LEARNING_ENABLED, PUBLIC_AGENTS_SERVERS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TIME_INTERVALS, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, VirusTotalFileSecurityChecker, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, appendChatAttachmentContext, appendChatAttachmentContextWithContent, book, cacheLlmTools, compilePipeline, computeAgentHash, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createBasicAgentModelRequirements, createDefaultAgentName, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, createStandaloneBookLanguageMarkdown, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, formatChatAttachmentContentContext, formatChatAttachmentContext, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getAllCommitmentsToolTitles, getCommitmentDefinition, getGroupedCommitmentDefinitions, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, normalizeAgentName, normalizeChatAttachments, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, resolveChatAttachmentContents, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map