@promptbook/node 0.101.0-8 → 0.101.0

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

@@ -15,13 +15,20 @@ import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { DEFAULT_BOOK_FONT_CLASS } from '../book-components/BookEditor/config';
 import { Chat } from '../book-components/Chat/Chat/Chat';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
+import { useChatAutoScroll } from '../book-components/Chat/hooks/useChatAutoScroll';
+import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
+import { useSendMessageToLlmChat } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
 import { LlmChat } from '../book-components/Chat/LlmChat/LlmChat';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
+import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
+import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageButtons';
 import { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
 import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
+import { PauseIcon } from '../book-components/icons/PauseIcon';
+import { PlayIcon } from '../book-components/icons/PlayIcon';
 import { ResetIcon } from '../book-components/icons/ResetIcon';
 import { SendIcon } from '../book-components/icons/SendIcon';
 import { TemplateIcon } from '../book-components/icons/TemplateIcon';
@@ -42,13 +49,20 @@ export { BookEditor };
 export { DEFAULT_BOOK_FONT_CLASS };
 export { Chat };
 export type { ChatProps };
+export { useChatAutoScroll };
+export type { SendMessageToLlmChatFunction };
+export { useSendMessageToLlmChat };
 export { LlmChat };
 export type { LlmChatProps };
 export type { ChatMessage };
 export type { ChatParticipant };
+export type { MessageButton };
+export { parseMessageButtons };
 export { renderMarkdown };
 export { isMarkdownContent };
 export { ArrowIcon };
+export { PauseIcon };
+export { PlayIcon };
 export { ResetIcon };
 export { SendIcon };
 export { TemplateIcon };

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

@@ -1,5 +1,6 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
+import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
 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';
@@ -119,8 +120,13 @@ import { createLlmToolsFromConfiguration } from '../llm-providers/_common/regist
 import { cacheLlmTools } from '../llm-providers/_common/utils/cache/cacheLlmTools';
 import { countUsage } from '../llm-providers/_common/utils/count-total-usage/countUsage';
 import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usage/limitTotalUsage';
+import { getSingleLlmExecutionTools } from '../llm-providers/_multiple/getSingleLlmExecutionTools';
 import { joinLlmExecutionTools } from '../llm-providers/_multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/_multiple/MultipleLlmExecutionTools';
+import { AgentLlmExecutionTools } from '../llm-providers/agent/AgentLlmExecutionTools';
+import { createAgentLlmExecutionTools } from '../llm-providers/agent/createAgentLlmExecutionTools';
+import { _AgentMetadata } from '../llm-providers/agent/register-configuration';
+import { _AgentRegistration } from '../llm-providers/agent/register-constructor';
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
@@ -166,6 +172,7 @@ import { TaskTypes } from '../types/TaskType';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createAgentModelRequirements };
+export { createAgentModelRequirementsWithCommitments };
 export { parseAgentSource };
 export { parseParameters };
 export { isValidBook };
@@ -285,8 +292,13 @@ export { createLlmToolsFromConfiguration };
 export { cacheLlmTools };
 export { countUsage };
 export { limitTotalUsage };
+export { getSingleLlmExecutionTools };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };
+export { AgentLlmExecutionTools };
+export { createAgentLlmExecutionTools };
+export { _AgentMetadata };
+export { _AgentRegistration };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _DeepseekMetadataRegistration };

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

@@ -13,9 +13,12 @@ import type { MockedChatDelayConfig } from '../book-components/AvatarProfile/Ava
 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 { ChatAutoScrollConfig } from '../book-components/Chat/hooks/useChatAutoScroll';
+import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
+import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
 import type { PipelineCollection } from '../collection/PipelineCollection';
 import type { Command } from '../commands/_common/types/Command';
 import type { CommandParser } from '../commands/_common/types/CommandParser';
@@ -93,6 +96,7 @@ import type { LlmToolsOptions } from '../llm-providers/_common/register/LlmTools
 import type { CacheItem } from '../llm-providers/_common/utils/cache/CacheItem';
 import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
+import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/createAgentLlmExecutionTools';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
@@ -338,9 +342,12 @@ export type { MockedChatDelayConfig };
 export type { MockedChatProps };
 export type { BookEditorProps };
 export type { ChatProps };
+export type { ChatAutoScrollConfig };
+export type { SendMessageToLlmChatFunction };
 export type { LlmChatProps };
 export type { ChatMessage };
 export type { ChatParticipant };
+export type { MessageButton };
 export type { PipelineCollection };
 export type { Command };
 export type { CommandParser };
@@ -418,6 +425,7 @@ export type { LlmToolsOptions };
 export type { CacheItem };
 export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
+export type { CreateAgentLlmExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };

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

@@ -35,10 +35,17 @@ export type AgentBasicInformation = {
      */
     personaDescription: string | null;
     /**
-     * Optional profile image URL
-     * This is the line starting with "META IMAGE"
-     */
-    profileImageUrl: string_url_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:

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

@@ -35,3 +35,6 @@ export type AgentModelRequirements = {
      */
     readonly metadata?: Record<string, TODO_any>;
 };
+/**
+ * TODO: [🐤] DRY `AgentModelRequirements` and `ModelRequirements`
+ */

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

@@ -1,36 +1,18 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
+import { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { string_book } from './string_book';
 /**
  * Creates model requirements for an agent based on its source
- * Results are cached to improve performance for repeated calls with the same agentSource and modelName
  *
  * There are 2 similar functions:
  * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
- * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
  *
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Clears the cache for createAgentModelRequirements
- * Useful when agent sources are updated and cached results should be invalidated
- *
- * @private
- */
-export declare function clearAgentModelRequirementsCache(): void;
-/**
- * Removes cache entries for a specific agent source (all model variants)
- * @param agentSource The agent source to remove from cache
- * @private
- */
-export declare function invalidateAgentModelRequirementsCache(agentSource: string_book): void;
-/**
- * Gets the current cache size (for debugging/monitoring)
- *
- * @private
- */
-export declare function getAgentModelRequirementsCacheSize(): number;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools): Promise<AgentModelRequirements>;
 /**
  * Extracts MCP servers from agent source
  *

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

@@ -6,31 +6,6 @@ import type { string_book } from './string_book';
  * This function uses a reduce-like pattern where each commitment applies its changes
  * to build the final requirements starting from a basic empty model
  *
- * @private - TODO: [🧠] Maybe should be public?
+ * @public exported from `@promptbook/core`
  */
 export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Cached version of createAgentModelRequirementsWithCommitments
- * This maintains the same caching behavior as the original function
- *
- * @private
- */
-export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
-/**
- * Clears the cache for createAgentModelRequirementsWithCommitments
- *
- * @private
- */
-export declare function clearAgentModelRequirementsWithCommitmentsCache(): void;
-/**
- * Removes cache entries for a specific agent source
- *
- * @private
- */
-export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_book): void;
-/**
- * Gets the current cache size
- *
- * @private
- */
-export declare function getAgentModelRequirementsWithCommitmentsCacheSize(): number;

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.
      */
@@ -27,12 +27,6 @@ export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the ACTION commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ActionCommitment: ActionCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -30,30 +30,6 @@ export declare class DeleteCommitmentDefinition extends BaseCommitmentDefinition
     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.
      */
@@ -28,12 +28,6 @@ export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the FORMAT commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const FormatCommitment: FormatCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL'> {
-    constructor();
+export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL' | 'GOALS'> {
+    constructor(type?: 'GOAL' | 'GOALS');
     /**
      * Short one-line description of GOAL.
      */
@@ -28,12 +28,6 @@ export declare class GoalCommitmentDefinition extends BaseCommitmentDefinition<'
     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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -34,12 +34,6 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     private isUrl;
 }
-/**
- * Singleton instance of the KNOWLEDGE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const KnowledgeCommitment: KnowledgeCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -17,8 +17,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY'> {
-    constructor();
+export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
+    constructor(type?: 'MEMORY' | 'MEMORIES');
     /**
      * Short one-line description of MEMORY.
      */
@@ -29,12 +29,6 @@ export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition
     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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -18,8 +18,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class MessageCommitmentDefinition extends BaseCommitmentDefinition<'MESSAGE'> {
-    constructor();
+export declare class MessageCommitmentDefinition extends BaseCommitmentDefinition<'MESSAGE' | 'MESSAGES'> {
+    constructor(type?: 'MESSAGE' | 'MESSAGES');
     /**
      * Short one-line description of MESSAGE.
      */
@@ -30,12 +30,6 @@ export declare class MessageCommitmentDefinition extends BaseCommitmentDefinitio
     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;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -51,12 +51,6 @@ export declare class MetaCommitmentDefinition extends BaseCommitmentDefinition<`
      */
     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/META_IMAGE/META_IMAGE.d.ts

@@ -33,12 +33,6 @@ export declare class MetaImageCommitmentDefinition extends BaseCommitmentDefinit
      */
     extractProfileImageUrl(content: string): string | null;
 }
-/**
- * Singleton instance of the META IMAGE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MetaImageCommitment: MetaImageCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -45,12 +45,6 @@ export declare class MetaLinkCommitmentDefinition extends BaseCommitmentDefiniti
      */
     isValidUrl(content: string): boolean;
 }
-/**
- * Singleton instance of the META LINK commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const MetaLinkCommitment: MetaLinkCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -4,20 +4,29 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * MODEL commitment definition
  *
  * The MODEL commitment specifies which AI model to use and can also set
- * model-specific parameters like temperature, topP, and topK.
+ * model-specific parameters like temperature, topP, topK, and maxTokens.
  *
- * Example usage in agent source:
+ * Supports multiple syntax variations:
  *
+ * Single-line format:
  * ```book
  * MODEL gpt-4
  * MODEL claude-3-opus temperature=0.3
  * MODEL gpt-3.5-turbo temperature=0.8 topP=0.9
  * ```
  *
+ * Multi-line named parameter format:
+ * ```book
+ * MODEL NAME gpt-4
+ * MODEL TEMPERATURE 0.7
+ * MODEL TOP_P 0.9
+ * MODEL MAX_TOKENS 2048
+ * ```
+ *
  * @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.
      */
@@ -27,13 +36,19 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Check if the first part is a known named parameter
+     */
+    private isNamedParameter;
+    /**
+     * Parse the new named parameter format: "MODEL TEMPERATURE 0.7"
+     */
+    private parseNamedParameter;
+    /**
+     * Parse the legacy format: "MODEL gpt-4 temperature=0.3 topP=0.9"
+     */
+    private parseLegacyFormat;
 }
-/**
- * Singleton instance of the MODEL commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ModelCommitment: 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' | 'COMMENT' | 'NONCE'> {
+    constructor(type?: 'NOTE' | 'NOTES' | 'COMMENT' | 'NONCE');
     /**
      * Short one-line description of NOTE.
      */
@@ -38,12 +38,6 @@ export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the NOTE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const NoteCommitment: 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.
      */
@@ -35,12 +35,6 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the PERSONA commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const PersonaCommitment: PersonaCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -27,18 +27,6 @@ export declare class RuleCommitmentDefinition extends BaseCommitmentDefinition<'
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instances of the RULE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const RuleCommitment: RuleCommitmentDefinition;
-/**
- * Singleton instances of the RULE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const RulesCommitment: RuleCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -27,18 +27,6 @@ export declare class SampleCommitmentDefinition extends BaseCommitmentDefinition
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instances of the SAMPLE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const SampleCommitment: SampleCommitmentDefinition;
-/**
- * Singleton instances of the SAMPLE commitment definitions
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const ExampleCommitment: SampleCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -17,8 +17,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO'> {
-    constructor();
+export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO' | 'SCENARIOS'> {
+    constructor(type?: 'SCENARIO' | 'SCENARIOS');
     /**
      * Short one-line description of SCENARIO.
      */
@@ -29,12 +29,6 @@ export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefiniti
     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;
 /**
  * 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.
      */
@@ -27,12 +27,6 @@ export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Singleton instance of the STYLE commitment definition
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare const StyleCommitment: StyleCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

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

@@ -15,5 +15,5 @@ export declare function createEmptyAgentModelRequirements(): AgentModelRequireme
  */
 export declare function createBasicAgentModelRequirements(agentName: string | null): AgentModelRequirements;
 /**
- * TODO: !!! Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
+ * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
  */