@promptbook/types 0.101.0-1 → 0.101.0-10

package/README.md

@@ -47,7 +47,7 @@ npm i ptbk
 npm i -D @promptbook/types
 ```
 
-The types package provides comprehensive TypeScript type definitions for all Promptbook entities. It enables type-safe development when working with Promptbook APIs, ensuring compile-time validation and excellent IDE support.
+Comprehensive TypeScript type definitions for all Promptbook entities, enabling type-safe development and excellent IDE support throughout the Promptbook ecosystem.
 
 ## 🎯 Purpose and Motivation
 
@@ -56,23 +56,24 @@ This package centralizes all TypeScript type definitions used throughout the Pro
 ## 🔧 High-Level Functionality
 
 The package provides type definitions for:
-- **Pipeline Structures**: Complete type definitions for promptbook JSON structures
-- **Execution Types**: Types for pipeline execution, results, and error handling
-- **LLM Provider Types**: Configuration and option types for all supported providers
-- **Command Types**: Type definitions for all promptbook commands
-- **Utility Types**: Helper types for common patterns and data structures
-- **Component Types**: React component prop types for UI components
+
+-   **Pipeline Structures**: Complete type definitions for promptbook JSON structures
+-   **Execution Types**: Types for pipeline execution, results, and error handling
+-   **LLM Provider Types**: Configuration and option types for all supported providers
+-   **Command Types**: Type definitions for all promptbook commands
+-   **Utility Types**: Helper types for common patterns and data structures
+-   **Component Types**: React component prop types for UI components
 
 ## ✨ Key Features
 
-- 📝 **Complete Type Coverage** - Types for all Promptbook entities and APIs
-- 🔒 **Type Safety** - Compile-time validation and error prevention
-- 💡 **Excellent IntelliSense** - Rich IDE support with autocomplete and documentation
-- 🏗️ **Structural Types** - Detailed types for promptbook JSON structures
-- 🔧 **Provider-Agnostic** - Generic types that work across all LLM providers
-- 📊 **Execution Types** - Comprehensive types for pipeline execution and results
-- 🎨 **Component Types** - React component prop types for UI development
-- 🔄 **Version Compatibility** - Types that evolve with the Promptbook ecosystem
+-   📝 **Complete Type Coverage** - Types for all Promptbook entities and APIs
+-   🔒 **Type Safety** - Compile-time validation and error prevention
+-   💡 **Excellent IntelliSense** - Rich IDE support with autocomplete and documentation
+-   🏗️ **Structural Types** - Detailed types for promptbook JSON structures
+-   🔧 **Provider-Agnostic** - Generic types that work across all LLM providers
+-   📊 **Execution Types** - Comprehensive types for pipeline execution and results
+-   🎨 **Component Types** - React component prop types for UI development
+-   🔄 **Version Compatibility** - Types that evolve with the Promptbook ecosystem
 
 ## Usage Example
 
@@ -103,106 +104,197 @@ const promptbook: PipelineJson = compilePipeline(
 ## 📦 Exported Type Categories
 
 ### Agent and Book Types
-- `AgentBasicInformation` - Basic agent information structure
-- `AgentModelRequirements` - Model requirements for agents
-- `string_book` - Book content string type
-- `BookCommitment` - Book commitment structure
-- `CommitmentDefinition` - Commitment definition interface
-- `ParsedCommitment` - Parsed commitment structure
+
+-   `AgentBasicInformation` - Basic agent information structure (type)
+-   `AgentModelRequirements` - Model requirements for agents (type)
+-   `string_book` - Book content string type (type)
+-   `BookCommitment` - Book commitment structure (type)
+-   `CommitmentDefinition` - Commitment definition interface (type)
+-   `ParsedCommitment` - Parsed commitment structure (type)
 
 ### Component Types
-- `AvatarChipProps` - Avatar chip component props
-- `AvatarChipFromSourceProps` - Avatar chip from source props
-- `AvatarProfileProps` - Avatar profile component props
-- `AvatarProfileFromSourceProps` - Avatar profile from source props
-- `BookEditorProps` - Book editor component props
-- `ChatProps` - Chat component props
-- `LlmChatProps` - LLM chat component props
-- `ChatMessage` - Chat message structure
-- `ChatParticipant` - Chat participant information
+
+-   `AvatarChipProps` - Avatar chip component props (type)
+-   `AvatarChipFromSourceProps` - Avatar chip from source props (type)
+-   `AvatarProfileProps` - Avatar profile component props (type)
+-   `AvatarProfileFromSourceProps` - Avatar profile from source props (type)
+-   `BookEditorProps` - Book editor component props (type)
+-   `ChatProps` - Chat component props (type)
+-   `LlmChatProps` - LLM chat component props (type)
+-   `ChatMessage` - Chat message structure (type)
+-   `ChatParticipant` - Chat participant information (type)
 
 ### Collection and Pipeline Types
-- `PipelineCollection` - Pipeline collection interface
-- `PipelineJson` - Complete pipeline JSON structure
-- `PipelineString` - Pipeline string format
-- `PipelineInterface` - Pipeline interface definition
-- `TaskJson` - Task JSON structure
-- `PromptTaskJson` - Prompt task structure
-- `ScriptTaskJson` - Script task structure
-- `SimpleTaskJson` - Simple task structure
-- `DialogTaskJson` - Dialog task structure
-- `CommonTaskJson` - Common task properties
+
+-   `PipelineCollection` - Pipeline collection interface (type)
+-   `PipelineJson` - Complete pipeline JSON structure (type)
+-   `PipelineString` - Pipeline string format (type)
+-   `PipelineInterface` - Pipeline interface definition (type)
+-   `TaskJson` - Task JSON structure (type)
+-   `PromptTaskJson` - Prompt task structure (type)
+-   `ScriptTaskJson` - Script task structure (type)
+-   `SimpleTaskJson` - Simple task structure (type)
+-   `DialogTaskJson` - Dialog task structure (type)
+-   `CommonTaskJson` - Common task properties (type)
 
 ### Command Types
-- `Command` - Base command interface
-- `CommandParser` - Command parser interface
-- `CommandType` - Command type enumeration
-- `CommandUsagePlace` - Command usage context
-- `BookVersionCommand` - Book version command
-- `ExpectCommand` - Expect command structure
-- `ForeachCommand` - Foreach command structure
-- `FormatCommand` - Format command structure
-- `FormfactorCommand` - Formfactor command structure
-- `KnowledgeCommand` - Knowledge command structure
-- `ModelCommand` - Model command structure
-- `ParameterCommand` - Parameter command structure
-- `PersonaCommand` - Persona command structure
-- `PostprocessCommand` - Postprocess command structure
+
+-   `Command` - Base command interface (type)
+-   `CommandParser` - Command parser interface (type)
+-   `PipelineBothCommandParser` - Pipeline both command parser (type)
+-   `PipelineHeadCommandParser` - Pipeline head command parser (type)
+-   `PipelineTaskCommandParser` - Pipeline task command parser (type)
+-   `CommandParserInput` - Command parser input (type)
+-   `CommandType` - Command type enumeration (type)
+-   `CommandUsagePlace` - Command usage context (type)
+-   `BookVersionCommand` - Book version command (type)
+-   `ExpectCommand` - Expect command structure (type)
+-   `ForeachCommand` - Foreach command structure (type)
+-   `ForeachJson` - Foreach JSON structure (type)
+-   `FormatCommand` - Format command structure (type)
+-   `FormfactorCommand` - Formfactor command structure (type)
+-   `JokerCommand` - Joker command structure (type)
+-   `KnowledgeCommand` - Knowledge command structure (type)
+-   `ModelCommand` - Model command structure (type)
+-   `ParameterCommand` - Parameter command structure (type)
+-   `PersonaCommand` - Persona command structure (type)
+-   `PostprocessCommand` - Postprocess command structure (type)
+-   `SectionCommand` - Section command structure (type)
+-   `UrlCommand` - URL command structure (type)
+-   `ActionCommand` - Action command structure (type)
+-   `InstrumentCommand` - Instrument command structure (type)
 
 ### Execution Types
-- `ExecutionTools` - Execution tools interface
-- `LlmExecutionTools` - LLM execution tools interface
-- `PipelineExecutor` - Pipeline executor interface
-- `PipelineExecutorResult` - Execution result structure
-- `ExecutionTask` - Execution task structure
-- `ExecutionReportJson` - Execution report structure
-- `PromptResult` - Prompt execution result
-- `Usage` - Usage tracking structure
-- `AvailableModel` - Available model information
+
+-   `ExecutionTools` - Execution tools interface (type)
+-   `LlmExecutionTools` - LLM execution tools interface (type)
+-   `LlmExecutionToolsConstructor` - LLM execution tools constructor (type)
+-   `PipelineExecutor` - Pipeline executor interface (type)
+-   `PipelineExecutorResult` - Execution result structure (type)
+-   `ExecutionTask` - Execution task structure (type)
+-   `PreparationTask` - Preparation task structure (type)
+-   `task_status` - Task status type (type)
+-   `AbstractTask` - Abstract task interface (type)
+-   `Task` - Task interface (type)
+-   `ExecutionReportJson` - Execution report structure (type)
+-   `ExecutionPromptReportJson` - Execution prompt report structure (type)
+-   `ExecutionReportString` - Execution report string (type)
+-   `ExecutionReportStringOptions` - Report formatting options (type)
+-   `PromptResult` - Prompt execution result (type)
+-   `CompletionPromptResult` - Completion prompt result (type)
+-   `ChatPromptResult` - Chat prompt result (type)
+-   `EmbeddingPromptResult` - Embedding prompt result (type)
+-   `Usage` - Usage tracking structure (type)
+-   `UsageCounts` - Usage counts structure (type)
+-   `UncertainNumber` - Uncertain number type (type)
+-   `AvailableModel` - Available model information (type)
+-   `AbstractTaskResult` - Abstract task result (type)
+-   `EmbeddingVector` - Embedding vector type (type)
 
 ### LLM Provider Configuration Types
-- `AnthropicClaudeExecutionToolsOptions` - Anthropic Claude configuration
-- `OpenAiExecutionToolsOptions` - OpenAI configuration
-- `AzureOpenAiExecutionToolsOptions` - Azure OpenAI configuration
-- `GoogleExecutionToolsOptions` - Google configuration
-- `DeepseekExecutionToolsOptions` - Deepseek configuration
-- `OllamaExecutionToolsOptions` - Ollama configuration
-- `VercelExecutionToolsOptions` - Vercel configuration
+
+-   `AnthropicClaudeExecutionToolsOptions` - Anthropic Claude configuration (type)
+-   `AnthropicClaudeExecutionToolsNonProxiedOptions` - Anthropic Claude non-proxied options (type)
+-   `AnthropicClaudeExecutionToolsProxiedOptions` - Anthropic Claude proxied options (type)
+-   `OpenAiExecutionToolsOptions` - OpenAI configuration (type)
+-   `OpenAiAssistantExecutionToolsOptions` - OpenAI Assistant configuration (type)
+-   `OpenAiCompatibleExecutionToolsOptions` - OpenAI Compatible configuration (type)
+-   `OpenAiCompatibleExecutionToolsNonProxiedOptions` - OpenAI Compatible non-proxied options (type)
+-   `OpenAiCompatibleExecutionToolsProxiedOptions` - OpenAI Compatible proxied options (type)
+-   `AzureOpenAiExecutionToolsOptions` - Azure OpenAI configuration (type)
+-   `GoogleExecutionToolsOptions` - Google configuration (type)
+-   `DeepseekExecutionToolsOptions` - Deepseek configuration (type)
+-   `OllamaExecutionToolsOptions` - Ollama configuration (type)
+-   `VercelExecutionToolsOptions` - Vercel configuration (type)
+-   `VercelProvider` - Vercel provider type (type)
 
 ### Parameter and Data Types
-- `ParameterJson` - Parameter definition structure
-- `InputParameterJson` - Input parameter structure
-- `OutputParameterJson` - Output parameter structure
-- `Parameters` - Parameter collection type
-- `Expectations` - Expectation validation structure
-- `PersonaJson` - Persona definition structure
-- `KnowledgeSourceJson` - Knowledge source structure
+
+-   `ParameterJson` - Parameter definition structure (type)
+-   `InputParameterJson` - Input parameter structure (type)
+-   `IntermediateParameterJson` - Intermediate parameter structure (type)
+-   `OutputParameterJson` - Output parameter structure (type)
+-   `CommonParameterJson` - Common parameter properties (type)
+-   `Parameters` - Parameter collection type (type)
+-   `InputParameters` - Input parameters type (type)
+-   `Expectations` - Expectation validation structure (type)
+-   `ExpectationUnit` - Expectation unit type (type)
+-   `ExpectationAmount` - Expectation amount type (type)
+-   `PersonaJson` - Persona definition structure (type)
+-   `PersonaPreparedJson` - Prepared persona structure (type)
+-   `KnowledgeSourceJson` - Knowledge source structure (type)
+-   `KnowledgeSourcePreparedJson` - Prepared knowledge source structure (type)
+-   `KnowledgePiecePreparedJson` - Prepared knowledge piece structure (type)
 
 ### Utility and Helper Types
-- `string_prompt` - Prompt string type
-- `string_template` - Template string type
-- `string_parameter_name` - Parameter name type
-- `string_model_name` - Model name type
-- `string_url` - URL string type
-- `string_filename` - Filename string type
-- `number_tokens` - Token count type
-- `number_usd` - USD amount type
-- `ModelVariant` - Model variant enumeration
-- `ScriptLanguage` - Script language enumeration
-- `TaskType` - Task type enumeration
+
+-   `string_prompt` - Prompt string type (type)
+-   `string_template` - Template string type (type)
+-   `string_text_prompt` - Text prompt string type (type)
+-   `string_chat_prompt` - Chat prompt string type (type)
+-   `string_system_message` - System message string type (type)
+-   `string_completion_prompt` - Completion prompt string type (type)
+-   `string_parameter_name` - Parameter name type (type)
+-   `string_parameter_value` - Parameter value type (type)
+-   `string_reserved_parameter_name` - Reserved parameter name type (type)
+-   `ReservedParameters` - Reserved parameters type (type)
+-   `string_model_name` - Model name type (type)
+-   `string_url` - URL string type (type)
+-   `string_filename` - Filename string type (type)
+-   `string_absolute_filename` - Absolute filename type (type)
+-   `string_relative_filename` - Relative filename type (type)
+-   `string_dirname` - Directory name type (type)
+-   `string_absolute_dirname` - Absolute directory name type (type)
+-   `string_relative_dirname` - Relative directory name type (type)
+-   `number_tokens` - Token count type (type)
+-   `number_usd` - USD amount type (type)
+-   `ModelVariant` - Model variant enumeration (type)
+-   `ScriptLanguage` - Script language enumeration (type)
+-   `TaskType` - Task type enumeration (type)
+-   `SectionType` - Section type enumeration (type)
+-   `ModelRequirements` - Model requirements type (type)
+-   `CompletionModelRequirements` - Completion model requirements (type)
+-   `ChatModelRequirements` - Chat model requirements (type)
+-   `EmbeddingModelRequirements` - Embedding model requirements (type)
 
 ### Remote Server Types
-- `RemoteServerOptions` - Remote server configuration
-- `RemoteClientOptions` - Remote client configuration
-- `Identification` - User identification structure
+
+-   `RemoteServerOptions` - Remote server configuration (type)
+-   `AnonymousRemoteServerOptions` - Anonymous remote server options (type)
+-   `ApplicationRemoteServerOptions` - Application remote server options (type)
+-   `ApplicationRemoteServerClientOptions` - Application remote server client options (type)
+-   `RemoteClientOptions` - Remote client configuration (type)
+-   `Identification` - User identification structure (type)
+-   `ApplicationModeIdentification` - Application mode identification (type)
+-   `AnonymousModeIdentification` - Anonymous mode identification (type)
+-   `LoginRequest` - Login request structure (type)
+-   `LoginResponse` - Login response structure (type)
+-   `RemoteServer` - Remote server interface (type)
 
 ### Storage and Scraper Types
-- `PromptbookStorage` - Storage interface
-- `Scraper` - Scraper interface
-- `ScraperConstructor` - Scraper constructor type
-- `Converter` - Content converter interface
 
-_Note: `@promptbook/types` does not export brand-specific types like `OpenAiExecutionToolsOptions`, `ClaudeExecutionToolsOptions`, `LangchainExecutionToolsOptions`,... etc._
+-   `PromptbookStorage` - Storage interface (type)
+-   `FileCacheStorageOptions` - File cache storage options (type)
+-   `IndexedDbStorageOptions` - IndexedDB storage options (type)
+-   `Scraper` - Scraper interface (type)
+-   `ScraperConstructor` - Scraper constructor type (type)
+-   `ScraperSourceHandler` - Scraper source handler (type)
+-   `ScraperIntermediateSource` - Scraper intermediate source (type)
+-   `ScraperAndConverterMetadata` - Scraper and converter metadata (type)
+-   `Converter` - Content converter interface (type)
+
+### Additional Types
+
+-   `Prompt` - Prompt interface (type)
+-   `CompletionPrompt` - Completion prompt interface (type)
+-   `ChatPrompt` - Chat prompt interface (type)
+-   `EmbeddingPrompt` - Embedding prompt interface (type)
+-   `NonEmptyArray` - Non-empty array type (type)
+-   `NonEmptyReadonlyArray` - Non-empty readonly array type (type)
+-   `IntermediateFilesStrategy` - Intermediate files strategy (type)
+-   `string_promptbook_version` - Promptbook version string type (type)
+
+> 💡 This package provides TypeScript types for promptbook applications. For runtime functionality, see [@promptbook/core](#-packages) or install all packages with `npm i ptbk`
 
 
 ---

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

@@ -7,6 +7,9 @@ import type { AvatarProfileProps } from '../book-components/AvatarProfile/Avatar
 import { AvatarProfile } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfile';
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
 import { AvatarProfileFromSource } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
+import type { MockedChatDelayConfig } from '../book-components/AvatarProfile/AvatarProfile/MockedChat';
+import type { MockedChatProps } from '../book-components/AvatarProfile/AvatarProfile/MockedChat';
+import { MockedChat } from '../book-components/AvatarProfile/AvatarProfile/MockedChat';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { DEFAULT_BOOK_FONT_CLASS } from '../book-components/BookEditor/config';
@@ -18,6 +21,10 @@ import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
 import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
+import { ArrowIcon } from '../book-components/icons/ArrowIcon';
+import { ResetIcon } from '../book-components/icons/ResetIcon';
+import { SendIcon } from '../book-components/icons/SendIcon';
+import { TemplateIcon } from '../book-components/icons/TemplateIcon';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export type { AvatarChipProps };
 export { AvatarChip };
@@ -27,6 +34,9 @@ export type { AvatarProfileProps };
 export { AvatarProfile };
 export type { AvatarProfileFromSourceProps };
 export { AvatarProfileFromSource };
+export type { MockedChatDelayConfig };
+export type { MockedChatProps };
+export { MockedChat };
 export type { BookEditorProps };
 export { BookEditor };
 export { DEFAULT_BOOK_FONT_CLASS };
@@ -38,3 +48,7 @@ export type { ChatMessage };
 export type { ChatParticipant };
 export { renderMarkdown };
 export { isMarkdownContent };
+export { ArrowIcon };
+export { ResetIcon };
+export { SendIcon };
+export { TemplateIcon };

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

@@ -1,6 +1,7 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
+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';
@@ -166,6 +167,7 @@ import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createAgentModelRequirements };
 export { parseAgentSource };
+export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };

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

@@ -1,3 +1,4 @@
+import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
 import type { string_book } from '../book-2.0/agent-source/string_book';
@@ -8,6 +9,8 @@ import type { AvatarChipProps } from '../book-components/AvatarProfile/AvatarChi
 import type { AvatarChipFromSourceProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChipFromSource';
 import type { AvatarProfileProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfile';
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
+import type { MockedChatDelayConfig } from '../book-components/AvatarProfile/AvatarProfile/MockedChat';
+import type { MockedChatProps } from '../book-components/AvatarProfile/AvatarProfile/MockedChat';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
@@ -320,6 +323,7 @@ import type { CheckSerializableAsJsonOptions } from '../utils/serialization/chec
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
 import type { string_promptbook_version } from '../version';
+export type { BookParameter };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
 export type { string_book };
@@ -330,6 +334,8 @@ export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };
 export type { AvatarProfileProps };
 export type { AvatarProfileFromSourceProps };
+export type { MockedChatDelayConfig };
+export type { MockedChatProps };
 export type { BookEditorProps };
 export type { ChatProps };
 export type { LlmChatProps };

package/esm/typings/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -1,4 +1,28 @@
 import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+/**
+ * Unified parameter representation that supports two different notations:
+ * 1. @Parameter - single word parameter starting with @
+ * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+ * Both notations represent the same syntax feature - parameters
+ */
+export type BookParameter = {
+    /**
+     * The raw text of the parameter as it appears in the source
+     */
+    text: string;
+    /**
+     * The notation used for this parameter
+     */
+    notation: 'at' | 'brace';
+    /**
+     * The parameter name (without @ or {})
+     */
+    name: string;
+    /**
+     * Optional description for {parameterName: description} notation
+     */
+    description?: string;
+};
 export type AgentBasicInformation = {
     /**
      * Name of the agent
@@ -11,10 +35,24 @@ export type AgentBasicInformation = {
      */
     personaDescription: string | null;
     /**
-     * Optional profile image URL
-     * This is the line starting with "META IMAGE"
+     * Metadata commitments parsed from META lines
+     * Each META commitment has the format "META TYPE content"
+     * When there are multiple meta commitments of the same type, later overrides earlier
+     */
+    meta: {
+        image?: string_url_image;
+        link?: string;
+        title?: string;
+        description?: string;
+        [key: string]: string | undefined;
+    };
+    /**
+     * Parameters found in the agent source
+     * Supports two different notations for the same syntax feature:
+     * - @Parameter (single word parameter starting with @)
+     * - {parameterName} or {parameter with multiple words} or {parameterName: description text}
      */
-    profileImageUrl: string_url_image;
+    parameters: BookParameter[];
 };
 /**
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`

package/esm/typings/src/book-2.0/agent-source/parseParameters.d.ts

@@ -0,0 +1,13 @@
+import type { BookParameter } from './AgentBasicInformation';
+/**
+ * Parses parameters from text using both supported notations:
+ * 1. @Parameter - single word parameter starting with @
+ * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+ *
+ * Both notations represent the same syntax feature - parameters
+ *
+ * @param text - Text to extract parameters from
+ * @returns Array of parsed parameters with unified representation
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseParameters(text: string): BookParameter[];

package/esm/typings/src/book-2.0/commitments/ACTION/ACTION.d.ts

@@ -15,8 +15,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION'> {
-    constructor();
+export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION' | 'ACTIONS'> {
+    constructor(type?: 'ACTION' | 'ACTIONS');
     /**
      * Short one-line description of ACTION.
      */
@@ -33,6 +33,12 @@ export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const ActionCommitment: ActionCommitmentDefinition;
+/**
+ * Singleton instance of the ACTIONS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ActionsCommitment: ActionCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/DELETE/DELETE.d.ts

@@ -0,0 +1,59 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * DELETE commitment definition
+ *
+ * The DELETE commitment (and its aliases CANCEL, DISCARD, REMOVE) is used to
+ * remove or disregard certain information or context. This can be useful for
+ * overriding previous commitments or removing unwanted behaviors.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * DELETE Previous formatting requirements
+ * CANCEL All emotional responses
+ * DISCARD Technical jargon explanations
+ * REMOVE Casual conversational style
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class DeleteCommitmentDefinition extends BaseCommitmentDefinition<'DELETE' | 'CANCEL' | 'DISCARD' | 'REMOVE'> {
+    constructor(type: 'DELETE' | 'CANCEL' | 'DISCARD' | 'REMOVE');
+    /**
+     * Short one-line description of DELETE/CANCEL/DISCARD/REMOVE.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for DELETE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instances of the DELETE commitment definitions with aliases
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const DeleteCommitment: DeleteCommitmentDefinition;
+/**
+ * Singleton instances of the DELETE commitment definitions with aliases
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const CancelCommitment: DeleteCommitmentDefinition;
+/**
+ * Singleton instances of the DELETE commitment definitions with aliases
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const DiscardCommitment: DeleteCommitmentDefinition;
+/**
+ * Singleton instances of the DELETE commitment definitions with aliases
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const RemoveCommitment: DeleteCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/FORMAT/FORMAT.d.ts

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition<'FORMAT'> {
-    constructor();
+export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition<'FORMAT' | 'FORMATS'> {
+    constructor(type?: 'FORMAT' | 'FORMATS');
     /**
      * Short one-line description of FORMAT.
      */
@@ -34,6 +34,12 @@ export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const FormatCommitment: FormatCommitmentDefinition;
+/**
+ * Singleton instance of the FORMATS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const FormatsCommitment: FormatCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/GOAL/GOAL.d.ts

@@ -0,0 +1,45 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * GOAL commitment definition
+ *
+ * The GOAL commitment defines the main goal which should be achieved by the AI assistant.
+ * There can be multiple goals. Later goals are more important than earlier goals.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * GOAL Help users understand complex technical concepts
+ * GOAL Provide accurate and up-to-date information
+ * GOAL Always prioritize user safety and ethical guidelines
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL' | 'GOALS'> {
+    constructor(type?: 'GOAL' | 'GOALS');
+    /**
+     * Short one-line description of GOAL.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for GOAL commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the GOAL commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const GoalCommitment: GoalCommitmentDefinition;
+/**
+ * Singleton instance of the GOALS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const GoalsCommitment: GoalCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -35,7 +35,7 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
     private isUrl;
 }
 /**
- * Singleton instance of the KNOWLEDGE commitment definition
+ * Singleton instance of the KNOWLEDGE commitment definition !!!!
  *
  * @private [🪔] Maybe export the commitments through some package
  */

package/esm/typings/src/book-2.0/commitments/MEMORY/MEMORY.d.ts

@@ -0,0 +1,46 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * MEMORY commitment definition
+ *
+ * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
+ * interactions and user preferences. It helps the agent maintain context about the
+ * user's history, preferences, and previous conversations.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * MEMORY User prefers detailed technical explanations
+ * MEMORY Previously worked on React projects
+ * MEMORY Timezone: UTC-5 (Eastern Time)
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
+    constructor(type?: 'MEMORY' | 'MEMORIES');
+    /**
+     * Short one-line description of MEMORY.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for MEMORY commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the MEMORY commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MemoryCommitment: MemoryCommitmentDefinition;
+/**
+ * Singleton instance of the MEMORIES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MemoriesCommitment: MemoryCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/MESSAGE/MESSAGE.d.ts

@@ -0,0 +1,47 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * MESSAGE commitment definition
+ *
+ * The MESSAGE commitment contains 1:1 text of the message which AI assistant already
+ * sent during the conversation. Later messages are later in the conversation.
+ * It is similar to EXAMPLE but it is not example, it is the real message which
+ * AI assistant already sent.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * MESSAGE Hello! How can I help you today?
+ * MESSAGE I understand you're looking for information about our services.
+ * MESSAGE Based on your requirements, I'd recommend our premium package.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MessageCommitmentDefinition extends BaseCommitmentDefinition<'MESSAGE' | 'MESSAGES'> {
+    constructor(type?: 'MESSAGE' | 'MESSAGES');
+    /**
+     * Short one-line description of MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the MESSAGE commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MessageCommitment: MessageCommitmentDefinition;
+/**
+ * Singleton instance of the MESSAGES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MessagesCommitment: MessageCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/META/META.d.ts

@@ -0,0 +1,62 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META commitment definition
+ *
+ * The META commitment handles all meta-information about the agent such as:
+ * - META IMAGE: Sets the agent's avatar/profile image URL
+ * - META LINK: Provides profile/source links for the person the agent models
+ * - META TITLE: Sets the agent's display title
+ * - META DESCRIPTION: Sets the agent's description
+ * - META [ANYTHING]: Any other meta information in uppercase format
+ *
+ * These commitments are special because they don't affect the system message,
+ * but are handled separately in the parsing logic for profile display.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META LINK https://twitter.com/username
+ * META TITLE Professional Assistant
+ * META DESCRIPTION An AI assistant specialized in business tasks
+ * META AUTHOR John Doe
+ * META VERSION 1.0
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaCommitmentDefinition extends BaseCommitmentDefinition<`META${string}`> {
+    constructor();
+    /**
+     * Short one-line description of META commitments.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for META commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts meta information from the content based on the meta type
+     * This is used by the parsing logic
+     */
+    extractMetaValue(metaType: string, content: string): string | null;
+    /**
+     * Validates if the provided content is a valid URL (for IMAGE and LINK types)
+     */
+    isValidUrl(content: string): boolean;
+    /**
+     * Checks if this is a known meta type
+     */
+    isKnownMetaType(metaType: string): boolean;
+}
+/**
+ * Singleton instance of the META commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MetaCommitment: MetaCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/MODEL/MODEL.d.ts

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL'> {
-    constructor();
+export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL' | 'MODELS'> {
+    constructor(type?: 'MODEL' | 'MODELS');
     /**
      * Short one-line description of MODEL.
      */
@@ -34,6 +34,12 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const ModelCommitment: ModelCommitmentDefinition;
+/**
+ * Singleton instance of the MODELS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ModelsCommitment: ModelCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/NOTE/NOTE.d.ts

@@ -26,8 +26,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE'> {
-    constructor();
+export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE' | 'NOTES'> {
+    constructor(type?: 'NOTE' | 'NOTES');
     /**
      * Short one-line description of NOTE.
      */
@@ -44,6 +44,12 @@ export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const NoteCommitment: NoteCommitmentDefinition;
+/**
+ * Singleton instance of the NOTES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const NotesCommitment: NoteCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/PERSONA/PERSONA.d.ts

@@ -23,8 +23,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA'> {
-    constructor();
+export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA' | 'PERSONAE'> {
+    constructor(type?: 'PERSONA' | 'PERSONAE');
     /**
      * Short one-line description of PERSONA.
      */
@@ -41,6 +41,12 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const PersonaCommitment: PersonaCommitmentDefinition;
+/**
+ * Singleton instance of the PERSONAE commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const PersonaeCommitment: PersonaCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/SCENARIO/SCENARIO.d.ts

@@ -0,0 +1,46 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * SCENARIO commitment definition
+ *
+ * The SCENARIO commitment defines a specific situation or context in which the AI
+ * assistant should operate. It helps to set the scene for the AI's responses.
+ * Later scenarios are more important than earlier scenarios.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * SCENARIO You are in a customer service call center during peak hours
+ * SCENARIO The customer is frustrated and has been on hold for 20 minutes
+ * SCENARIO This is the customer's third call about the same issue
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO' | 'SCENARIOS'> {
+    constructor(type?: 'SCENARIO' | 'SCENARIOS');
+    /**
+     * Short one-line description of SCENARIO.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for SCENARIO commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the SCENARIO commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ScenarioCommitment: ScenarioCommitmentDefinition;
+/**
+ * Singleton instance of the SCENARIOS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ScenariosCommitment: ScenarioCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/STYLE/STYLE.d.ts

@@ -15,8 +15,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE'> {
-    constructor();
+export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE' | 'STYLES'> {
+    constructor(type?: 'STYLE' | 'STYLES');
     /**
      * Short one-line description of STYLE.
      */
@@ -33,6 +33,12 @@ export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const StyleCommitment: StyleCommitmentDefinition;
+/**
+ * Singleton instance of the STYLES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const StylesCommitment: StyleCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/index.d.ts

@@ -1,15 +1,19 @@
 import type { BookCommitment } from './_base/BookCommitment';
 import type { CommitmentDefinition } from './_base/CommitmentDefinition';
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
+import { DeleteCommitmentDefinition } from './DELETE/DELETE';
 import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
+import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
-import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
-import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
+import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
+import { MetaCommitmentDefinition } from './META/META';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
 import { PersonaCommitmentDefinition } from './PERSONA/PERSONA';
 import { RuleCommitmentDefinition } from './RULE/RULE';
 import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
+import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
 /**
@@ -19,7 +23,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaLinkCommitmentDefinition, NoteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"SCENARIO">, NotYetImplementedCommitmentDefinition<"SCENARIOS">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"GOAL">, NotYetImplementedCommitmentDefinition<"GOALS">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/MockedChat.d.ts

@@ -0,0 +1,46 @@
+import type { ChatProps } from '../../Chat/Chat/ChatProps';
+/**
+ * Delay configuration for the MockedChat component
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MockedChatDelayConfig = {
+    /**
+     * Delay before showing the first message (in milliseconds)
+     * @default 1000
+     */
+    beforeFirstMessage?: number;
+    /**
+     * Emulated thinking time between messages (in milliseconds)
+     * @default 2000
+     */
+    thinkingBetweenMessages?: number;
+    /**
+     * Wait time after each written word (in milliseconds)
+     * @default 100
+     */
+    waitAfterWord?: number;
+    /**
+     * Extra delay on top of the word waiting (in milliseconds)
+     * @default 50
+     */
+    extraWordDelay?: number;
+};
+/**
+ * Props for MockedChat component
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MockedChatProps = ChatProps & {
+    /**
+     * Optional delays configuration for emulating typing behavior
+     */
+    delayConfig?: MockedChatDelayConfig;
+};
+/**
+ * MockedChat component that shows the same chat as Chat but emulates ongoing discussion
+ * with realistic typing delays and thinking pauses.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function MockedChat(props: MockedChatProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/index.d.ts

@@ -0,0 +1,3 @@
+export * from './AvatarProfile';
+export * from './AvatarProfileFromSource';
+export * from './MockedChat';

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -1,5 +1,7 @@
 import type { CSSProperties } from 'react';
+import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { string_knowledge_source_content } from '../../types/typeAliases';
 /**
  * Props of `BookEditor`
  *
@@ -27,10 +29,18 @@ export type BookEditorProps = {
      * Callback function to handle changes in the book content.
      */
     onChange?(value: string_book): void;
+    /**
+     * returns the URL of the uploaded file on CDN or storage
+     */
+    onFileUpload?(file: File): Promisable<string_knowledge_source_content>;
     /**
      * If true, logs verbose debug info to the console and shows additional visual cues
      */
     readonly isVerbose?: boolean;
+    /**
+     * If true, disables border radius making the editor have sharp corners
+     */
+    readonly isBorderRadiusDisabled?: boolean;
 };
 /**
  * Renders a book editor

package/esm/typings/src/book-components/BookEditor/BookEditorInner.d.ts

@@ -1,3 +1,4 @@
+import { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 /**
  * @private util of `<BookEditor />`
@@ -7,7 +8,9 @@ export type BookEditorInnerProps = {
     fontClassName?: string;
     value?: string_book;
     onChange?(value: string_book): void;
+    onFileUpload?(file: File): Promisable<string>;
     isVerbose?: boolean;
+    isBorderRadiusDisabled?: boolean;
 };
 /**
  * @private util of `<BookEditor />`

package/esm/typings/src/book-components/Chat/Chat/Chat.d.ts

@@ -1,9 +1,4 @@
 import type { ChatProps } from './ChatProps';
-/**
- * @deprecated use `isComplete` instead
- * @private util of `<Chat />`
- */
-export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
 /**
  * Renders a chat with messages and input for new messages
  *

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -23,10 +23,16 @@ export type ChatProps = {
      * Called when user sends a message
      *
      * Note: You must handle the message yourself and add it to the `messages` array
+     *
+     * - When set, the send textarea and button will be shown
+     * - When undefined, the chat has no input and is read-only showing only the messages
      */
-    onMessage(messageContent: string): Promisable<void>;
+    onMessage?(messageContent: string): Promisable<void>;
     /**
-     * Optional callback, when set, button for resetting chat will be shown
+     * Optional callback
+     *
+     * - When set, button for resetting chat will be shown
+     * - When undefined, no reset button will be shown
      */
     onReset?(): Promisable<void>;
     /**
@@ -113,4 +119,24 @@ export type ChatProps = {
      * Keys should match ChatMessage.from values (e.g., 'USER', 'AGENT_{id}', etc.)
      */
     readonly participants?: ReadonlyArray<ChatParticipant>;
+    /**
+     * Optional callback for handling user feedback on messages
+     * When provided, star rating buttons (1-5 stars) will be displayed next to each message
+     *
+     * @param feedback - Object containing the feedback data
+     * @param feedback.message - The message being rated
+     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.textRating - Optional text feedback/note from user
+     * @param feedback.chatThread - Complete chat thread as string
+     * @param feedback.expectedAnswer - Optional expected answer provided by user
+     * @param feedback.url - Current page URL where feedback was given
+     */
+    onFeedback?(feedback: {
+        message: ChatMessage;
+        rating: number;
+        textRating: string;
+        chatThread: string;
+        expectedAnswer: string | null;
+        url: string;
+    }): Promisable<void>;
 };

package/esm/typings/src/book-components/Chat/Chat/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @deprecated use `isComplete` instead
+ * @private util of `<Chat />`
+ */
+export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-components/icons/ArrowIcon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shows simple arrow icon pointing up or down
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ArrowIcon: ({ direction, size }: {
+    direction: string;
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/ResetIcon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shows simple reset icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ResetIcon: () => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/SendIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple send icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const SendIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/TemplateIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple template icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const TemplateIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/utils/markdown/humanizeAiText.d.ts

@@ -9,5 +9,6 @@ import { string_markdown } from '../../types/typeAliases';
  */
 export declare function humanizeAiText(aiText: string_markdown): string_markdown;
 /**
+ * TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
  * TODO: [🅾️] !!! Use this across the project where AI text is involved
  */

package/esm/typings/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.101.0-0`).
+ * It follows semantic versioning (e.g., `0.101.0-9`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.101.0-1",
+    "version": "0.101.0-10",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -92,6 +92,6 @@
     },
     "typings": "./esm/typings/src/_packages/types.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-1"
+        "@promptbook/core": "0.101.0-10"
     }
 }