@promptbook/components 0.112.0-64 → 0.112.0-66

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/avatars/types/AvatarVisualDefinition.d.ts

@@ -6,7 +6,7 @@ import type { AvatarDefinition } from './AvatarDefinition';
  *
  * @private shared contract for the avatar rendering system
  */
-export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'fractal' | 'orb';
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'minecraft2' | 'fractal' | 'orb';
 /**
  * Derived color palette used by avatar visuals.
  *

package/esm/src/avatars/visuals/minecraft2AvatarVisual.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Minecraft 3D 2 avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+export declare const minecraft2AvatarVisual: AvatarVisualDefinition;

package/esm/src/avatars/visuals/minecraftAvatarVisualShared.d.ts

@@ -0,0 +1,48 @@
+import type { AvatarPalette } from '../types/AvatarVisualDefinition';
+/**
+ * One Minecraft-style pixel texture sampled on a cuboid face.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftTexture = ReadonlyArray<ReadonlyArray<string>>;
+/**
+ * Full six-face texture pack for one rendered cuboid.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftCuboidTextures = {
+    readonly front: MinecraftTexture;
+    readonly back: MinecraftTexture;
+    readonly left: MinecraftTexture;
+    readonly right: MinecraftTexture;
+    readonly top: MinecraftTexture;
+    readonly bottom: MinecraftTexture;
+};
+/**
+ * Shared subset of avatar colors used by the Minecraft avatar helpers.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+type MinecraftTexturePalette = Pick<AvatarPalette, 'primary' | 'secondary' | 'accent' | 'highlight' | 'ink' | 'shadow'>;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style head cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the generated avatar should include a colored headband.
+ * @returns Head cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftHeadTextures(random: () => number, palette: MinecraftTexturePalette, hasHeadband: boolean): MinecraftCuboidTextures;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style torso cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns Torso cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftTorsoTextures(random: () => number, palette: MinecraftTexturePalette): MinecraftCuboidTextures;
+export {};

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/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
+ * Ensures `.gitignore` contains the shared Promptbook working-directory entry.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

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/config.d.ts

@@ -270,7 +270,7 @@ export declare const DEFAULT_AGENTS_DIRNAME = "./agents";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME: string;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -278,7 +278,7 @@ export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-ca
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME: string;
 /**
  * Where to store the scrape cache
  *
@@ -286,7 +286,7 @@ export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME: string;
 /**
  * Id of application for the CLI when using remote server
  *

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/utils/files/getPromptbookTempPath.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one absolute filesystem path inside the shared Promptbook working directory for a project root.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function resolvePromptbookTempPath(projectPath: string, ...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPosixPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one rooted `.gitignore` rule targeting a path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempGitignoreRule(...pathSegments: ReadonlyArray<string>): string;

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-63`).
+ * It follows semantic versioning (e.g., `0.112.0-65`).
  *
  * @generated
  */

package/package.json

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