@promptbook/node 0.101.0-2 → 0.101.0-20

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

@@ -7,18 +7,28 @@ 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';
 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';
@@ -31,18 +41,28 @@ 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 };
 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,6 +1,8 @@
 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';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
@@ -118,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';
@@ -165,7 +172,9 @@ 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 };
 export { validateBook };
 export { DEFAULT_BOOK };
@@ -283,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

@@ -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,11 +9,16 @@ 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 { 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';
@@ -90,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';
@@ -320,6 +327,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,11 +338,16 @@ 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 { 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 };
@@ -412,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

@@ -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/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/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
+ */