@promptbook/types 0.100.4-0 → 0.101.0-1

package/README.md

@@ -47,7 +47,34 @@ npm i ptbk
 npm i -D @promptbook/types
 ```
 
-This package is useful when you want to explicitly define types in your code.
+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.
+
+## 🎯 Purpose and Motivation
+
+This package centralizes all TypeScript type definitions used throughout the Promptbook ecosystem. It enables developers to write type-safe code when working with promptbooks, pipelines, LLM providers, and other Promptbook components, providing excellent IntelliSense and compile-time error checking.
+
+## 🔧 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
+
+## ✨ 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
+
+## Usage Example
 
 ```typescript
 import type { PipelineJson } from '@promptbook/types';
@@ -73,6 +100,108 @@ 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
+
+### 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
+
+### 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
+
+### 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
+
+### 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
+
+### 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
+
+### 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
+
+### 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
+
+### Remote Server Types
+- `RemoteServerOptions` - Remote server configuration
+- `RemoteClientOptions` - Remote client configuration
+- `Identification` - User identification structure
+
+### 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._
 
 

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

@@ -16,6 +16,8 @@ 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 { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
+import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export type { AvatarChipProps };
 export { AvatarChip };
@@ -34,3 +36,5 @@ export { LlmChat };
 export type { LlmChatProps };
 export type { ChatMessage };
 export type { ChatParticipant };
+export { renderMarkdown };
+export { isMarkdownContent };

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

@@ -1,4 +1,5 @@
 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 { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
@@ -6,11 +7,11 @@ import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
 import { createEmptyAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
 import { createBasicAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
 import { NotYetImplementedCommitmentDefinition } from '../book-2.0/commitments/_base/NotYetImplementedCommitmentDefinition';
-import { createAgentModelRequirements } from '../book-2.0/commitments/_misc/createAgentModelRequirements';
 import { getCommitmentDefinition } from '../book-2.0/commitments/index';
 import { getAllCommitmentDefinitions } from '../book-2.0/commitments/index';
 import { getAllCommitmentTypes } from '../book-2.0/commitments/index';
 import { isCommitmentSupported } from '../book-2.0/commitments/index';
+import { generatePlaceholderAgentProfileImageUrl } from '../book-2.0/utils/generatePlaceholderAgentProfileImageUrl';
 import { collectionToJson } from '../collection/collectionToJson';
 import { createCollectionFromJson } from '../collection/constructors/createCollectionFromJson';
 import { createCollectionFromPromise } from '../collection/constructors/createCollectionFromPromise';
@@ -163,6 +164,7 @@ import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { createAgentModelRequirements };
 export { parseAgentSource };
 export { isValidBook };
 export { validateBook };
@@ -170,11 +172,11 @@ export { DEFAULT_BOOK };
 export { createEmptyAgentModelRequirements };
 export { createBasicAgentModelRequirements };
 export { NotYetImplementedCommitmentDefinition };
-export { createAgentModelRequirements };
 export { getCommitmentDefinition };
 export { getAllCommitmentDefinitions };
 export { getAllCommitmentTypes };
 export { isCommitmentSupported };
+export { generatePlaceholderAgentProfileImageUrl };
 export { collectionToJson };
 export { createCollectionFromJson };
 export { createCollectionFromPromise };

package/esm/typings/src/_packages/markdown-utils.index.d.ts

@@ -17,10 +17,17 @@ import { extractAllBlocksFromMarkdown } from '../utils/markdown/extractAllBlocks
 import { extractAllListItemsFromMarkdown } from '../utils/markdown/extractAllListItemsFromMarkdown';
 import { extractOneBlockFromMarkdown } from '../utils/markdown/extractOneBlockFromMarkdown';
 import { flattenMarkdown } from '../utils/markdown/flattenMarkdown';
+import { humanizeAiText } from '../utils/markdown/humanizeAiText';
+import { humanizeAiTextEllipsis } from '../utils/markdown/humanizeAiTextEllipsis';
+import { humanizeAiTextEmdashed } from '../utils/markdown/humanizeAiTextEmdashed';
+import { humanizeAiTextQuotes } from '../utils/markdown/humanizeAiTextQuotes';
+import { humanizeAiTextWhitespace } from '../utils/markdown/humanizeAiTextWhitespace';
 import type { MarkdownSection } from '../utils/markdown/parseMarkdownSection';
 import { parseMarkdownSection } from '../utils/markdown/parseMarkdownSection';
+import { promptbookifyAiText } from '../utils/markdown/promptbookifyAiText';
 import { removeMarkdownComments } from '../utils/markdown/removeMarkdownComments';
 import { removeMarkdownFormatting } from '../utils/markdown/removeMarkdownFormatting';
+import { removeMarkdownLinks } from '../utils/markdown/removeMarkdownLinks';
 import { splitMarkdownIntoSections } from '../utils/markdown/splitMarkdownIntoSections';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { extractBlock };
@@ -41,8 +48,15 @@ export { extractAllBlocksFromMarkdown };
 export { extractAllListItemsFromMarkdown };
 export { extractOneBlockFromMarkdown };
 export { flattenMarkdown };
+export { humanizeAiText };
+export { humanizeAiTextEllipsis };
+export { humanizeAiTextEmdashed };
+export { humanizeAiTextQuotes };
+export { humanizeAiTextWhitespace };
 export type { MarkdownSection };
 export { parseMarkdownSection };
+export { promptbookifyAiText };
 export { removeMarkdownComments };
 export { removeMarkdownFormatting };
+export { removeMarkdownLinks };
 export { splitMarkdownIntoSections };

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

@@ -1,10 +1,9 @@
-import type { AgentBasicInformation } from '../book-2.0/agent-source/parseAgentSource';
+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';
 import type { BookCommitment } from '../book-2.0/commitments/_base/BookCommitment';
 import type { CommitmentDefinition } from '../book-2.0/commitments/_base/CommitmentDefinition';
-import type { AgentModelRequirements } from '../book-2.0/commitments/_misc/AgentModelRequirements';
-import type { AgentSourceParseResult } from '../book-2.0/commitments/_misc/AgentSourceParseResult';
-import type { ParsedCommitment } from '../book-2.0/commitments/_misc/ParsedCommitment';
+import type { ParsedCommitment } from '../book-2.0/commitments/_base/ParsedCommitment';
 import type { AvatarChipProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChip';
 import type { AvatarChipFromSourceProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChipFromSource';
 import type { AvatarProfileProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfile';
@@ -322,11 +321,10 @@ import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
 import type { string_promptbook_version } from '../version';
 export type { AgentBasicInformation };
+export type { AgentModelRequirements };
 export type { string_book };
 export type { BookCommitment };
 export type { CommitmentDefinition };
-export type { AgentModelRequirements };
-export type { AgentSourceParseResult };
 export type { ParsedCommitment };
 export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };

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

@@ -0,0 +1,21 @@
+import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+export type AgentBasicInformation = {
+    /**
+     * Name of the agent
+     * This is the first line of the agent source
+     */
+    agentName: string_agent_name | null;
+    /**
+     * Optional description of the agent
+     * This is the line starting with "PERSONA"
+     */
+    personaDescription: string | null;
+    /**
+     * Optional profile image URL
+     * This is the line starting with "META IMAGE"
+     */
+    profileImageUrl: string_url_image;
+};
+/**
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ */

package/esm/typings/src/book-2.0/{commitments/_misc → agent-source}/AgentModelRequirements.d.ts

@@ -1,4 +1,4 @@
-import type { TODO_any } from '../../../utils/organization/TODO_any';
+import type { TODO_any } from '../../utils/organization/TODO_any';
 /**
  * Model requirements for an agent
  *

package/esm/typings/src/book-2.0/{commitments/_misc → agent-source}/AgentSourceParseResult.d.ts

@@ -1,6 +1,8 @@
-import type { ParsedCommitment } from './ParsedCommitment';
+import type { ParsedCommitment } from '../commitments/_base/ParsedCommitment';
 /**
  * Result of parsing agent source for commitments
+ *
+ * @private internal utility of `parseAgentSource` and `parseAgentSourceWithCommitments`
  */
 export type AgentSourceParseResult = {
     /**

package/esm/typings/src/book-2.0/{commitments/_misc → agent-source}/createAgentModelRequirements.d.ts

@@ -1,6 +1,6 @@
-import type { string_model_name } from '../../../types/typeAliases';
-import type { string_book } from '../../agent-source/string_book';
+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

package/esm/typings/src/book-2.0/{commitments/_misc → agent-source}/createAgentModelRequirementsWithCommitments.d.ts

@@ -1,12 +1,12 @@
-import type { string_model_name } from '../../../types/typeAliases';
-import type { string_book } from '../../agent-source/string_book';
+import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { string_book } from './string_book';
 /**
  * Creates agent model requirements using the new commitment system
  * 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
+ * @private - TODO: [🧠] Maybe should be public?
  */
 export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
 /**

package/esm/typings/src/book-2.0/{commitments/_misc → agent-source}/createCommitmentRegex.d.ts

@@ -1,11 +1,11 @@
-import type { BookCommitment } from '../_base/BookCommitment';
+import type { BookCommitment } from '../commitments/_base/BookCommitment';
 /**
  * Generates a regex pattern to match a specific commitment
  *
  * Note: It always creates new Regex object
  * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
  *
- * @private
+ * @private - TODO: [🧠] Maybe should be public?
  */
 export declare function createCommitmentRegex(commitment: BookCommitment): RegExp;
 /**

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

@@ -0,0 +1,8 @@
+import type { string_book } from './string_book';
+/**
+ * Extracts META LINK commitments from agent source
+ * Returns an array of all META LINK URLs found in the agent source
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractMetaLinks(agentSource: string_book): string[];

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

@@ -1,23 +1,5 @@
-import type { string_agent_name } from '../../types/typeAliases';
-import type { string_url_image } from '../../types/typeAliases';
+import type { AgentBasicInformation } from './AgentBasicInformation';
 import type { string_book } from './string_book';
-export type AgentBasicInformation = {
-    /**
-     * Name of the agent
-     * This is the first line of the agent source
-     */
-    agentName: string_agent_name | null;
-    /**
-     * Optional description of the agent
-     * This is the line starting with "PERSONA"
-     */
-    personaDescription: string | null;
-    /**
-     * Optional profile image URL
-     * This is the line starting with "META IMAGE"
-     */
-    profileImageUrl: string_url_image;
-};
 /**
  * Parses basic information from agent source
  *
@@ -28,3 +10,6 @@ export type AgentBasicInformation = {
  * @public exported from `@promptbook/core`
  */
 export declare function parseAgentSource(agentSource: string_book): AgentBasicInformation;
+/**
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ */

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

@@ -0,0 +1,9 @@
+import type { AgentSourceParseResult } from './AgentSourceParseResult';
+import type { string_book } from './string_book';
+/**
+ * Parses agent source using the new commitment system with multiline support
+ * This function replaces the hardcoded commitment parsing in the original parseAgentSource
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * ACTION commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * FORMAT commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * KNOWLEDGE commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * META IMAGE commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * META LINK commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * MODEL commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * NOTE commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * PERSONA commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * RULE commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * SAMPLE commitment definition
  *

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

@@ -1,5 +1,5 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
 /**
  * STYLE commitment definition
  *

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

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import type { CommitmentDefinition } from './CommitmentDefinition';
 /**
  * Base implementation of CommitmentDefinition that provides common functionality

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

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 /**
  * Definition of a commitment that can be applied to agent model requirements
  *

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

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from './BaseCommitmentDefinition';
 /**
  * Placeholder commitment definition for commitments that are not yet implemented

package/esm/typings/src/book-2.0/commitments/{_misc → _base}/ParsedCommitment.d.ts

@@ -1,4 +1,4 @@
-import type { BookCommitment } from '../_base/BookCommitment';
+import type { BookCommitment } from './BookCommitment';
 /**
  * Parsed commitment line from agent source
  */

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

@@ -1,4 +1,4 @@
-import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
 /**
  * Creates an empty/basic agent model requirements object
  * This serves as the starting point for the reduce-like pattern

package/esm/typings/src/book-2.0/utils/extractAgentMetadata.d.ts

@@ -0,0 +1,17 @@
+import type { string_url_image } from '../../types/typeAliases';
+/**
+ * Extracts persona, examples, and profile image from agent definition text
+ * @param systemMessage The original system message that may contain PERSONA, EXAMPLE, and META IMAGE lines
+ * @returns Object with extracted information and cleaned system message
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractAgentMetadata(systemMessage: string): {
+    persona?: {
+        name: string;
+        description?: string;
+    };
+    examples: string[];
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};

package/esm/typings/src/book-2.0/utils/extractProfileImageFromSystemMessage.d.ts

@@ -0,0 +1,12 @@
+import type { string_url_image } from '../../types/typeAliases';
+/**
+ * Extracts profile image URL from agent definition text and returns cleaned system message
+ * @param systemMessage The original system message that may contain META IMAGE line
+ * @returns Object with profileImageUrl (if found) and cleanedSystemMessage (without META IMAGE line)
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractProfileImageFromSystemMessage(systemMessage: string): {
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};

package/esm/typings/src/book-2.0/utils/generateGravatarUrl.d.ts

@@ -0,0 +1,10 @@
+import { string_agent_name } from '../../types/typeAliases';
+/**
+ * Generates a gravatar URL based on agent name for fallback avatar
+ *
+ * @param agentName The agent name to generate avatar for
+ * @returns Gravatar URL
+ *
+ * @private - [🤹] The fact that profile image is Gravatar is just implementation detail which should be hidden for consumer
+ */
+export declare function generateGravatarUrl(agentName?: string_agent_name): string;

package/esm/typings/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -0,0 +1,10 @@
+import { string_agent_name, string_url_image } from '../../types/typeAliases';
+/**
+ * Generates an image for the agent to use as profile image
+ *
+ * @param agentName The agent name to generate avatar for
+ * @returns The placeholder profile image URL for the agent
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function generatePlaceholderAgentProfileImageUrl(agentName?: string_agent_name): string_url_image;

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

@@ -1,4 +1,4 @@
-import type { AgentBasicInformation } from '../../../book-2.0/agent-source/parseAgentSource';
+import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_css_class } from '../../../types/typeAliases';
 /**
  * Props of `AvatarChip`

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

@@ -1,4 +1,4 @@
-import type { AgentBasicInformation } from '../../../book-2.0/agent-source/parseAgentSource';
+import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_css_class } from '../../../types/typeAliases';
 /**
  * Props of `AvatarProfile`
@@ -9,10 +9,7 @@ export type AvatarProfileProps = {
     /**
      * Agent to be shown
      */
-    readonly agent: AgentBasicInformation & {
-        agentTitle?: string;
-        agentDescription?: string;
-    };
+    readonly agent: AgentBasicInformation;
     /**
      * Optional CSS class name which will be added to root <div> element
      */
@@ -24,6 +21,3 @@ export type AvatarProfileProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function AvatarProfile(props: AvatarProfileProps): import("react/jsx-runtime").JSX.Element;
-/**
- * TODO: [🕛] Unite `AvatarProfileProps`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */

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

@@ -79,6 +79,12 @@ export type ChatProps = {
         onAssistantVoiceResponse?: (content: string, isVoiceCall: boolean) => void;
         onVoiceCallStateChange?: (isVoiceCalling: boolean) => void;
     };
+    /**
+     * Indicates whether a the text is AI-generated and should be humanized
+     *
+     * @default true
+     */
+    readonly isAiTextHumanized?: boolean;
     /**
      * Indicates whether a voice call is currently active
      */

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

@@ -0,0 +1,16 @@
+/**
+ * Demo component showing Chat with markdown rendering capabilities
+ *
+ * This example demonstrates various markdown features supported by the Chat component:
+ * - Headers
+ * - Bold and italic text
+ * - Code blocks and inline code
+ * - Lists (ordered and unordered)
+ * - Links
+ * - Blockquotes
+ * - Tables
+ * - Strikethrough text
+ *
+ * @private temporary for testing purposes
+ */
+export declare function ChatMarkdownDemo(): import("react/jsx-runtime").JSX.Element;

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

@@ -28,5 +28,5 @@ export type ChatParticipant = {
     color: string_color | Color;
 };
 /**
- * TODO: [🕛] Unite `AvatarProfileProps`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  */

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

@@ -0,0 +1,21 @@
+import type { string_html, string_markdown } from '../../../types/typeAliases';
+/**
+ * Convert markdown content to HTML for display in chat messages
+ *
+ * @param markdown - The markdown content to convert
+ * @returns HTML string ready for rendering
+ *
+ * @public exported from `@promptbook/components`
+ *         <- TODO: [🧠] Maybe export from `@promptbook/markdown-utils`
+ */
+export declare function renderMarkdown(markdown: string_markdown): string_html;
+/**
+ * Check if content appears to be markdown (contains markdown syntax)
+ *
+ * @param content - Content to check
+ * @returns true if content appears to contain markdown syntax
+ *
+ * @public exported from `@promptbook/components`
+ *         <- TODO: [🧠] Maybe export from `@promptbook/markdown-utils`
+ */
+export declare function isMarkdownContent(content: string): boolean;

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

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/llm-providers/_common/profiles/llmProviderProfiles.d.ts

@@ -76,6 +76,6 @@ export declare function getLlmProviderProfile(providerKey: keyof typeof LLM_PROV
 export declare function createCustomLlmProfile(baseProfile: ChatParticipant, overrides: Partial<ChatParticipant>): ChatParticipant;
 /**
  * TODO: Refactor this - each profile must be alongside the provider definition
- * TODO: [🕛] Unite `AvatarProfileProps`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/utils/expectation-counters/countCharacters.d.ts

@@ -7,4 +7,5 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
 export declare function countCharacters(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */ 
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */

package/esm/typings/src/utils/expectation-counters/countLines.d.ts

@@ -9,4 +9,5 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
 export declare function countLines(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */ 
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */

package/esm/typings/src/utils/expectation-counters/countPages.d.ts

@@ -9,4 +9,5 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
 export declare function countPages(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */ 
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */

package/esm/typings/src/utils/expectation-counters/countParagraphs.d.ts

@@ -7,4 +7,5 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
 export declare function countParagraphs(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */ 
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */

package/esm/typings/src/utils/expectation-counters/countSentences.d.ts

@@ -13,4 +13,5 @@ export declare function splitIntoSentences(text: string): ReadonlyArray<string>;
 export declare function countSentences(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
  */

package/esm/typings/src/utils/expectation-counters/countWords.d.ts

@@ -7,4 +7,6 @@ import type { ExpectationAmount } from '../../pipeline/PipelineJson/Expectations
 export declare function countWords(text: string): ExpectationAmount;
 /**
  * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
- */ 
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ * TODO: [✌️] `countWords` should be just `splitWords(...).length`, and all other counters should use this pattern as well
+ */

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

@@ -3,6 +3,8 @@ import type { string_markdown_text } from '../../types/typeAliases';
  * Function escapeMarkdownBlock will escape markdown block if needed
  * It is useful when you want have block in block
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/markdown-utils`
  */
 export declare function escapeMarkdownBlock(value: string_markdown_text): string_markdown_text;

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

@@ -0,0 +1,13 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Function `humanizeAiText` will remove traces of AI text generation artifacts
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: If you want more control, look for other functions for example `humanizeAiTextEmdashed` exported `@promptbook/markdown-utils`
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function humanizeAiText(aiText: string_markdown): string_markdown;
+/**
+ * TODO: [🅾️] !!! Use this across the project where AI text is involved
+ */

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,13 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Change ellipsis character to three dots `…` -> `...`
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function humanizeAiTextEllipsis(aiText: string_markdown): string_markdown;
+/**
+ * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
+ */

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

@@ -0,0 +1,13 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Change em-dashes to regular dashes `—` -> `-`
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function humanizeAiTextEmdashed(aiText: string_markdown): string_markdown;
+/**
+ * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
+ */

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

@@ -0,0 +1,13 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Change smart quotes to regular quotes
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function humanizeAiTextQuotes(aiText: string_markdown): string_markdown;
+/**
+ * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
+ */

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

@@ -0,0 +1,13 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Change unprintable hard spaces to regular spaces
+ *
+ * Note: [🔂] This function is idempotent.
+ * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function humanizeAiTextWhitespace(aiText: string_markdown): string_markdown;
+/**
+ * Note: [🏂] This function is not tested by itself but together with other cleanup functions with `humanizeAiText`
+ */

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

@@ -7,3 +7,11 @@ import type { string_html } from '../../types/typeAliases';
  * @private withing the package because of HUGE size of prettier dependency
  */
 export declare function prettifyMarkdown<TContent extends string_html>(content: TContent): TContent;
+/**
+ * Async version of prettifyMarkdown using dynamic imports
+ *
+ * @param content raw html code
+ * @returns formatted html code
+ * @private withing the package because of HUGE size of prettier dependency
+ */
+export declare function prettifyMarkdownAsync<TContent extends string_html>(content: TContent): Promise<TContent>;

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

@@ -0,0 +1,12 @@
+import { string_markdown } from '../../types/typeAliases';
+/**
+ * Function `promptbookifyAiText` will slightly modify the text so we know it was processed by Promptbook
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function promptbookifyAiText(text: string_markdown): string_markdown;
+/**
+ * TODO: !!!!! Make the function idempotent and add "Note: [🔂] This function is idempotent."
+ * TODO: [🅾️]!!! Use this across the project where AI text is involved
+ * TODO: [🧠][✌️] Make some Promptbook-native token system
+ */

package/esm/typings/src/utils/markdown/promptbookifyAiText.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,11 @@
+/**
+ * Removes Markdown link tags from a string.
+ *
+ * @param {string} str - The string to remove Markdown tags from.
+ * @returns {string} The input string with all Markdown tags removed.
+ * @public exported from `@promptbook/markdown-utils`
+ */
+export declare function removeMarkdownLinks(str: string): string;
+/**
+ * @see https://chat.openai.com/chat/bb7c3a5b-fe9c-4ccc-9057-f47e0fd66489
+ */

package/esm/typings/src/utils/markdown/removeMarkdownLinks.test.d.ts

@@ -0,0 +1,4 @@
+export {};
+/**
+ * @see https://chat.openai.com/chat/bb7c3a5b-fe9c-4ccc-9057-f47e0fd66489
+ */

package/esm/typings/src/utils/normalization/capitalize.d.ts

@@ -1,6 +1,8 @@
 /**
  * Makes first letter of a string uppercase
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function capitalize(word: string): string;

package/esm/typings/src/utils/normalization/decapitalize.d.ts

@@ -1,5 +1,7 @@
 /**
- * Makes first letter of a string uppercase
+ * Makes first letter of a string lowercase
+ *
+ * Note: [🔂] This function is idempotent.
  *
  * @public exported from `@promptbook/utils`
  */

package/esm/typings/src/utils/normalization/normalizeTo_SCREAMING_CASE.d.ts

@@ -9,6 +9,8 @@ export type string_SCREAMING_CASE = string;
 /**
  * Normalizes a text string to SCREAMING_CASE (all uppercase with underscores).
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text string to be converted to SCREAMING_CASE format.
  * @returns The normalized text in SCREAMING_CASE format.
  * @example 'HELLO_WORLD'

package/esm/typings/src/utils/normalization/normalizeTo_snake_case.d.ts

@@ -8,6 +8,8 @@ export type string_snake_case = string;
 /**
  * Normalizes a text string to snake_case format.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text The text string to be converted to snake_case format.
  * @returns The normalized text in snake_case format.
  * @example 'hello_world'

package/esm/typings/src/utils/normalization/normalizeWhitespaces.d.ts

@@ -1,6 +1,8 @@
 /**
  * Take every whitespace (space, new line, tab) and replace it with a single space
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function normalizeWhitespaces(sentence: string): string;

package/esm/typings/src/utils/normalization/removeDiacritics.d.ts

@@ -1,6 +1,8 @@
 /**
  * Removes diacritic marks (accents) from characters in a string.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param input The string containing diacritics to be normalized.
  * @returns The string with diacritics removed or normalized.
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/parseNumber.d.ts

@@ -1,6 +1,7 @@
 /**
  * Function parseNumber will parse number from string
  *
+ * Note: [🔂] This function is idempotent.
  * Unlike Number.parseInt, Number.parseFloat it will never ever result in NaN
  * Note: it also works only with decimal numbers
  *

package/esm/typings/src/utils/removeEmojis.d.ts

@@ -1,6 +1,8 @@
 /**
  * Removes emojis from a string and fix whitespaces
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param text with emojis
  * @returns text without emojis
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/removeQuotes.d.ts

@@ -1,6 +1,7 @@
 /**
  * Removes quotes from a string
  *
+ * Note: [🔂] This function is idempotent.
  * Tip: This is very useful for post-processing of the result of the LLM model
  * Note: This function removes only the same quotes from the beginning and the end of the string
  * Note: There are two similar functions:

package/esm/typings/src/utils/serialization/deepClone.d.ts

@@ -2,6 +2,7 @@ import type { WritableDeep } from 'type-fest';
 /**
  * Creates a deep clone of the given object
  *
+ * Note: [🔂] This function is idempotent.
  * Note: This method only works for objects that are fully serializable to JSON and do not contain functions, Dates, or special types.
  *
  * @param objectValue The object to clone.

package/esm/typings/src/utils/trimCodeBlock.d.ts

@@ -1,6 +1,7 @@
 /**
  * Function trimCodeBlock will trim starting and ending code block from the string if it is present.
  *
+ * Note: [🔂] This function is idempotent.
  * Note: This is useful for post-processing of the result of the chat LLM model
  *       when the model wraps the result in the (markdown) code block.
  *

package/esm/typings/src/utils/validators/url/isValidUrl.d.ts

@@ -3,6 +3,7 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Tests if given string is valid URL.
  *
+ * Note: [🔂] This function is idempotent.
  * Note: Dataurl are considered perfectly valid.
  * Note: There are two similar functions:
  * - `isValidUrl` which tests any URL

package/esm/typings/src/utils/validators/uuid/isValidUuid.d.ts

@@ -3,6 +3,8 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Checks if value is valid uuid
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/utils`
  */
 export declare function isValidUuid(value: really_unknown): value is string_uuid;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.100.4-0",
+    "version": "0.101.0-1",
     "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.100.4-0"
+        "@promptbook/core": "0.101.0-1"
     }
 }

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

@@ -1,24 +0,0 @@
-import type { AgentBasicInformation } from '../../agent-source/parseAgentSource';
-import type { string_book } from '../../agent-source/string_book';
-import type { AgentSourceParseResult } from './AgentSourceParseResult';
-/**
- * Parses agent source using the new commitment system with multiline support
- * This function replaces the hardcoded commitment parsing in the original parseAgentSource
- *
- * @private
- */
-export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;
-/**
- * Extracts basic information from agent source using the new commitment system
- * This maintains compatibility with the original parseAgentSource interface
- *
- * @private
- */
-export declare function parseAgentSourceBasicInfo(agentSource: string_book): AgentBasicInformation;
-/**
- * Extracts META LINK commitments from agent source
- * Returns an array of all META LINK URLs found in the agent source
- *
- * @private
- */
-export declare function extractMetaLinks(agentSource: string_book): string[];

package/esm/typings/src/book-2.0/utils/profileImageUtils.d.ts

@@ -1,39 +0,0 @@
-import type { string_url_image } from '../../types/typeAliases';
-/**
- * Extracts profile image URL from agent definition text and returns cleaned system message
- * @param systemMessage The original system message that may contain META IMAGE line
- * @returns Object with profileImageUrl (if found) and cleanedSystemMessage (without META IMAGE line)
- *
- * @private - TODO: [🧠] Maybe should be public?
- */
-export declare function extractProfileImageFromSystemMessage(systemMessage: string): {
-    profileImageUrl?: string_url_image;
-    cleanedSystemMessage: string;
-};
-/**
- * Extracts persona, examples, and profile image from agent definition text
- * @param systemMessage The original system message that may contain PERSONA, EXAMPLE, and META IMAGE lines
- * @returns Object with extracted information and cleaned system message
- *
- * @private - TODO: [🧠] Maybe should be public?
- */
-export declare function extractAgentMetadata(systemMessage: string): {
-    persona?: {
-        name: string;
-        description?: string;
-    };
-    examples: string[];
-    profileImageUrl?: string_url_image;
-    cleanedSystemMessage: string;
-};
-/**
- * Generates a gravatar URL based on agent name for fallback avatar
- * @param name The agent name to generate avatar for
- * @returns Gravatar URL
- *
- * @private - TODO: [🧠] Maybe should be public?
- */
-export declare function generateGravatarUrl(name?: string | null): string;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */