@promptbook/utils 0.112.0-63 → 0.112.0-65

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-63';
+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

package/esm/src/_packages/components.index.d.ts

@@ -62,7 +62,6 @@ import { reactSaveFormatDefinition } from '../book-components/Chat/save/react/re
 import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
 import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressCard } from '../book-components/Chat/types/ChatMessage';
-import type { ChatMessageSource } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessageReplyingTo } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
@@ -146,7 +145,6 @@ export { reactSaveFormatDefinition };
 export { txtSaveFormatDefinition };
 export type { ChatProgressItem };
 export type { ChatProgressCard };
-export type { ChatMessageSource };
 export type { ChatMessageReplyingTo };
 export type { ChatMessage };
 export type { ChatParticipant };

package/esm/src/_packages/core.index.d.ts

@@ -11,6 +11,7 @@ import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
+import { createStandaloneBookLanguageMarkdown } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
 import { AgentCollectionInSupabase } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 import { createPipelineCollectionFromJson } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromJson';
@@ -28,7 +29,6 @@ import { getAllCommitmentTypes } from '../commitments/_common/getAllCommitmentTy
 import { getCommitmentDefinition } from '../commitments/_common/getCommitmentDefinition';
 import { getGroupedCommitmentDefinitions } from '../commitments/_common/getGroupedCommitmentDefinitions';
 import { isCommitmentSupported } from '../commitments/_common/isCommitmentSupported';
-import { KNOWLEDGE_SEARCH_TOOL_NAME } from '../commitments/KNOWLEDGE/KNOWLEDGE';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { PROMPTBOOK_LEGAL_ENTITY } from '../config';
@@ -236,6 +236,7 @@ export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };
+export { createStandaloneBookLanguageMarkdown };
 export { generatePlaceholderAgentProfileImageUrl };
 export { AgentCollectionInSupabase };
 export { createPipelineCollectionFromJson };
@@ -253,7 +254,6 @@ export { getAllCommitmentTypes };
 export { getCommitmentDefinition };
 export { getGroupedCommitmentDefinitions };
 export { isCommitmentSupported };
-export { KNOWLEDGE_SEARCH_TOOL_NAME };
 export { NAME };
 export { ADMIN_EMAIL };
 export { PROMPTBOOK_LEGAL_ENTITY };

package/esm/src/_packages/types.index.d.ts

@@ -44,7 +44,6 @@ import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceC
 import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressCard } from '../book-components/Chat/types/ChatMessage';
-import type { ChatMessageSource } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessageReplyingTo } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
@@ -478,7 +477,6 @@ export type { SourceChipProps };
 export type { ChatToolCall };
 export type { ChatProgressItem };
 export type { ChatProgressCard };
-export type { ChatMessageSource };
 export type { ChatMessageReplyingTo };
 export type { ChatMessage };
 export type { ChatParticipant };

package/esm/src/book-2.0/book-language-documentation/BookLanguageDocumentationExample.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One end-to-end Book language example used in standalone documentation.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageDocumentationExample = {
+    /**
+     * Stable identifier used for markdown anchors.
+     */
+    readonly id: string;
+    /**
+     * Human-readable example title.
+     */
+    readonly title: string;
+    /**
+     * Goal of the example in one short sentence.
+     */
+    readonly goal: string;
+    /**
+     * Full Book source shown to readers.
+     */
+    readonly source: string;
+    /**
+     * Step-by-step walkthrough of how the source works.
+     */
+    readonly walkthrough: ReadonlyArray<string>;
+};

package/esm/src/book-2.0/book-language-documentation/bookLanguageCommonPitfalls.d.ts

@@ -0,0 +1,25 @@
+/**
+ * One practical "don't vs do" pitfall item for Book language authoring.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageCommonPitfall = {
+    /**
+     * Short pitfall title.
+     */
+    readonly title: string;
+    /**
+     * Description of what to avoid.
+     */
+    readonly dont: string;
+    /**
+     * Practical corrective action.
+     */
+    readonly doInstead: string;
+};
+/**
+ * Common anti-patterns with practical fixes.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare const bookLanguageCommonPitfalls: ReadonlyArray<BookLanguageCommonPitfall>;

package/esm/src/book-2.0/book-language-documentation/bookLanguageDocumentationExamples.d.ts

@@ -0,0 +1,10 @@
+import type { BookLanguageDocumentationExample } from './BookLanguageDocumentationExample';
+/**
+ * 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`
+ */
+export declare const bookLanguageDocumentationExamples: ReadonlyArray<BookLanguageDocumentationExample>;

package/esm/src/book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown.d.ts

@@ -0,0 +1,14 @@
+import { string_markdown } from '../../types/string_markdown';
+/**
+ * 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`
+ */
+export declare function createStandaloneBookLanguageMarkdown(): string_markdown;

package/esm/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minimal commitment shape used by documentation renderers.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type CommitmentDocumentationSource = {
+    /**
+     * Canonical commitment keyword.
+     */
+    readonly type: string;
+    /**
+     * Full markdown documentation block, including the top-level heading.
+     */
+    readonly documentation: string;
+};
+/**
+ * Grouped commitment metadata consumed by the docs renderer.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type GroupedCommitmentDocumentationSource = {
+    /**
+     * Primary commitment shown in the docs entry.
+     */
+    readonly primary: CommitmentDocumentationSource;
+    /**
+     * Aliases grouped under the same docs entry.
+     */
+    readonly aliases: ReadonlyArray<string>;
+};
+/**
+ * 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`
+ */
+export declare function renderGroupedCommitmentDocumentationMarkdown(group: GroupedCommitmentDocumentationSource): string;
+export {};

package/esm/src/book-components/Chat/types/ChatMessage.d.ts

@@ -58,36 +58,6 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
-/**
- * Source used by an assistant message.
- *
- * This is used for knowledge-search results and other RAG systems that can
- * attach structured source metadata independently of inline citation markers.
- *
- * @public exported from `@promptbook/components`
- */
-export type ChatMessageSource = {
-    /**
-     * The unique identifier for the source citation (e.g., "0:0")
-     */
-    readonly id: string;
-    /**
-     * The source document name (e.g., "document.pdf")
-     */
-    readonly source: string;
-    /**
-     * Optional URL to the source document
-     */
-    readonly url?: string;
-    /**
-     * Optional preview/excerpt from the source
-     */
-    readonly excerpt?: string;
-    /**
-     * Optional retrieval score.
-     */
-    readonly score?: number;
-};
 /**
  * Serialized reference to an earlier chat message quoted by a reply bubble.
  *
@@ -285,10 +255,6 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
          */
         excerpt?: string;
     }>;
-    /**
-     * Optional structured sources used to produce this message.
-     */
-    readonly sources?: ReadonlyArray<ChatMessageSource>;
     /**
      * Optional structured progress-card payload shown while a response is still in progress.
      */

package/esm/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -1,12 +1,5 @@
-import type { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * Name of the tool used by agents to search configured `KNOWLEDGE` sources.
- *
- * @public exported from `@promptbook/core`
- */
-export declare const KNOWLEDGE_SEARCH_TOOL_NAME: string;
 /**
  * KNOWLEDGE commitment definition
  *
@@ -44,8 +37,4 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
 }

package/esm/src/commitments/_common/toolRuntimeContext.d.ts

@@ -98,12 +98,6 @@ export type ToolRuntimeContext = {
         localServerUrl?: string;
         teamInternalAccessToken?: string;
     };
-    knowledge?: {
-        /**
-         * Final materialized knowledge sources available to the current agent.
-         */
-        sources?: string[];
-    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

package/esm/src/formfactors/index.d.ts

@@ -52,7 +52,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{
@@ -89,7 +89,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/formfactors/matcher/MatcherFormfactorDefinition.d.ts

@@ -7,7 +7,7 @@
  */
 export declare const MatcherFormfactorDefinition: {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/formfactors/translator/TranslatorFormfactorDefinition.d.ts

@@ -6,7 +6,7 @@
  */
 export declare const TranslatorFormfactorDefinition: {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -178,10 +178,6 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
      * Returns AgentKit-specific options.
      */
     private get agentKitOptions();
-    /**
-     * Returns true when hosted OpenAI vector-store search should back `knowledgeSources`.
-     */
-    private get isNativeKnowledgeSearchEnabled();
     /**
      * Discriminant for type guards.
      */

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsOptions.d.ts

@@ -12,13 +12,4 @@ export type OpenAiAgentKitExecutionToolsOptions = OpenAiVectorStoreHandlerOption
      * @default gpt-5.2
      */
     readonly agentKitModelName?: string_model_name;
-    /**
-     * Enables OpenAI hosted vector-store file search for `knowledgeSources`.
-     *
-     * Agents Server sets this to `false` because it uses a DB-backed LlamaIndex
-     * implementation exposed through the `knowledge_search` tool instead.
-     *
-     * @default true
-     */
-    readonly isNativeKnowledgeSearchEnabled?: boolean;
 };

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-62`).
+ * It follows semantic versioning (e.g., `0.112.0-64`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.112.0-63",
+    "version": "0.112.0-65",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-63';
+    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

package/umd/src/_packages/components.index.d.ts

@@ -62,7 +62,6 @@ import { reactSaveFormatDefinition } from '../book-components/Chat/save/react/re
 import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
 import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressCard } from '../book-components/Chat/types/ChatMessage';
-import type { ChatMessageSource } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessageReplyingTo } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
@@ -146,7 +145,6 @@ export { reactSaveFormatDefinition };
 export { txtSaveFormatDefinition };
 export type { ChatProgressItem };
 export type { ChatProgressCard };
-export type { ChatMessageSource };
 export type { ChatMessageReplyingTo };
 export type { ChatMessage };
 export type { ChatParticipant };

package/umd/src/_packages/core.index.d.ts

@@ -11,6 +11,7 @@ import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
+import { createStandaloneBookLanguageMarkdown } from '../book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown';
 import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
 import { AgentCollectionInSupabase } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 import { createPipelineCollectionFromJson } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromJson';
@@ -28,7 +29,6 @@ import { getAllCommitmentTypes } from '../commitments/_common/getAllCommitmentTy
 import { getCommitmentDefinition } from '../commitments/_common/getCommitmentDefinition';
 import { getGroupedCommitmentDefinitions } from '../commitments/_common/getGroupedCommitmentDefinitions';
 import { isCommitmentSupported } from '../commitments/_common/isCommitmentSupported';
-import { KNOWLEDGE_SEARCH_TOOL_NAME } from '../commitments/KNOWLEDGE/KNOWLEDGE';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { PROMPTBOOK_LEGAL_ENTITY } from '../config';
@@ -236,6 +236,7 @@ export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };
+export { createStandaloneBookLanguageMarkdown };
 export { generatePlaceholderAgentProfileImageUrl };
 export { AgentCollectionInSupabase };
 export { createPipelineCollectionFromJson };
@@ -253,7 +254,6 @@ export { getAllCommitmentTypes };
 export { getCommitmentDefinition };
 export { getGroupedCommitmentDefinitions };
 export { isCommitmentSupported };
-export { KNOWLEDGE_SEARCH_TOOL_NAME };
 export { NAME };
 export { ADMIN_EMAIL };
 export { PROMPTBOOK_LEGAL_ENTITY };

package/umd/src/_packages/types.index.d.ts

@@ -44,7 +44,6 @@ import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceC
 import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressItem } from '../book-components/Chat/types/ChatMessage';
 import type { ChatProgressCard } from '../book-components/Chat/types/ChatMessage';
-import type { ChatMessageSource } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessageReplyingTo } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
@@ -478,7 +477,6 @@ export type { SourceChipProps };
 export type { ChatToolCall };
 export type { ChatProgressItem };
 export type { ChatProgressCard };
-export type { ChatMessageSource };
 export type { ChatMessageReplyingTo };
 export type { ChatMessage };
 export type { ChatParticipant };

package/umd/src/book-2.0/book-language-documentation/BookLanguageDocumentationExample.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One end-to-end Book language example used in standalone documentation.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageDocumentationExample = {
+    /**
+     * Stable identifier used for markdown anchors.
+     */
+    readonly id: string;
+    /**
+     * Human-readable example title.
+     */
+    readonly title: string;
+    /**
+     * Goal of the example in one short sentence.
+     */
+    readonly goal: string;
+    /**
+     * Full Book source shown to readers.
+     */
+    readonly source: string;
+    /**
+     * Step-by-step walkthrough of how the source works.
+     */
+    readonly walkthrough: ReadonlyArray<string>;
+};

package/umd/src/book-2.0/book-language-documentation/bookLanguageCommonPitfalls.d.ts

@@ -0,0 +1,25 @@
+/**
+ * One practical "don't vs do" pitfall item for Book language authoring.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export type BookLanguageCommonPitfall = {
+    /**
+     * Short pitfall title.
+     */
+    readonly title: string;
+    /**
+     * Description of what to avoid.
+     */
+    readonly dont: string;
+    /**
+     * Practical corrective action.
+     */
+    readonly doInstead: string;
+};
+/**
+ * Common anti-patterns with practical fixes.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare const bookLanguageCommonPitfalls: ReadonlyArray<BookLanguageCommonPitfall>;

package/umd/src/book-2.0/book-language-documentation/bookLanguageDocumentationExamples.d.ts

@@ -0,0 +1,10 @@
+import type { BookLanguageDocumentationExample } from './BookLanguageDocumentationExample';
+/**
+ * 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`
+ */
+export declare const bookLanguageDocumentationExamples: ReadonlyArray<BookLanguageDocumentationExample>;

package/umd/src/book-2.0/book-language-documentation/createStandaloneBookLanguageMarkdown.d.ts

@@ -0,0 +1,14 @@
+import { string_markdown } from '../../types/string_markdown';
+/**
+ * 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`
+ */
+export declare function createStandaloneBookLanguageMarkdown(): string_markdown;

package/umd/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minimal commitment shape used by documentation renderers.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type CommitmentDocumentationSource = {
+    /**
+     * Canonical commitment keyword.
+     */
+    readonly type: string;
+    /**
+     * Full markdown documentation block, including the top-level heading.
+     */
+    readonly documentation: string;
+};
+/**
+ * Grouped commitment metadata consumed by the docs renderer.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type GroupedCommitmentDocumentationSource = {
+    /**
+     * Primary commitment shown in the docs entry.
+     */
+    readonly primary: CommitmentDocumentationSource;
+    /**
+     * Aliases grouped under the same docs entry.
+     */
+    readonly aliases: ReadonlyArray<string>;
+};
+/**
+ * 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`
+ */
+export declare function renderGroupedCommitmentDocumentationMarkdown(group: GroupedCommitmentDocumentationSource): string;
+export {};

package/umd/src/book-components/Chat/types/ChatMessage.d.ts

@@ -58,36 +58,6 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
-/**
- * Source used by an assistant message.
- *
- * This is used for knowledge-search results and other RAG systems that can
- * attach structured source metadata independently of inline citation markers.
- *
- * @public exported from `@promptbook/components`
- */
-export type ChatMessageSource = {
-    /**
-     * The unique identifier for the source citation (e.g., "0:0")
-     */
-    readonly id: string;
-    /**
-     * The source document name (e.g., "document.pdf")
-     */
-    readonly source: string;
-    /**
-     * Optional URL to the source document
-     */
-    readonly url?: string;
-    /**
-     * Optional preview/excerpt from the source
-     */
-    readonly excerpt?: string;
-    /**
-     * Optional retrieval score.
-     */
-    readonly score?: number;
-};
 /**
  * Serialized reference to an earlier chat message quoted by a reply bubble.
  *
@@ -285,10 +255,6 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
          */
         excerpt?: string;
     }>;
-    /**
-     * Optional structured sources used to produce this message.
-     */
-    readonly sources?: ReadonlyArray<ChatMessageSource>;
     /**
      * Optional structured progress-card payload shown while a response is still in progress.
      */

package/umd/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -1,12 +1,5 @@
-import type { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * Name of the tool used by agents to search configured `KNOWLEDGE` sources.
- *
- * @public exported from `@promptbook/core`
- */
-export declare const KNOWLEDGE_SEARCH_TOOL_NAME: string;
 /**
  * KNOWLEDGE commitment definition
  *
@@ -44,8 +37,4 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
 }

package/umd/src/commitments/_common/toolRuntimeContext.d.ts

@@ -98,12 +98,6 @@ export type ToolRuntimeContext = {
         localServerUrl?: string;
         teamInternalAccessToken?: string;
     };
-    knowledge?: {
-        /**
-         * Final materialized knowledge sources available to the current agent.
-         */
-        sources?: string[];
-    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

package/umd/src/formfactors/index.d.ts

@@ -52,7 +52,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{
@@ -89,7 +89,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/umd/src/formfactors/matcher/MatcherFormfactorDefinition.d.ts

@@ -7,7 +7,7 @@
  */
 export declare const MatcherFormfactorDefinition: {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/umd/src/formfactors/translator/TranslatorFormfactorDefinition.d.ts

@@ -6,7 +6,7 @@
  */
 export declare const TranslatorFormfactorDefinition: {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -178,10 +178,6 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
      * Returns AgentKit-specific options.
      */
     private get agentKitOptions();
-    /**
-     * Returns true when hosted OpenAI vector-store search should back `knowledgeSources`.
-     */
-    private get isNativeKnowledgeSearchEnabled();
     /**
      * Discriminant for type guards.
      */

package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionToolsOptions.d.ts

@@ -12,13 +12,4 @@ export type OpenAiAgentKitExecutionToolsOptions = OpenAiVectorStoreHandlerOption
      * @default gpt-5.2
      */
     readonly agentKitModelName?: string_model_name;
-    /**
-     * Enables OpenAI hosted vector-store file search for `knowledgeSources`.
-     *
-     * Agents Server sets this to `false` because it uses a DB-backed LlamaIndex
-     * implementation exposed through the `knowledge_search` tool instead.
-     *
-     * @default true
-     */
-    readonly isNativeKnowledgeSearchEnabled?: boolean;
 };

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-62`).
+ * It follows semantic versioning (e.g., `0.112.0-64`).
  *
  * @generated
  */