@promptbook/javascript 0.103.0-9 → 0.103.0

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

@@ -1,29 +1,38 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
+import { createDefaultAgentName } from '../book-2.0/agent-source/createDefaultAgentName';
+import { normalizeAgentName } from '../book-2.0/agent-source/normalizeAgentName';
+import { PADDING_LINES } from '../book-2.0/agent-source/padBook';
+import { padBook } from '../book-2.0/agent-source/padBook';
 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';
-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 { 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';
-import { createCollectionFromUrl } from '../collection/constructors/createCollectionFromUrl';
-import { createSubcollection } from '../collection/constructors/createSubcollection';
+import { AgentCollectionInSupabase } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
+import { createPipelineCollectionFromJson } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromJson';
+import { createPipelineCollectionFromPromise } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromPromise';
+import { createPipelineCollectionFromUrl } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromUrl';
+import { createPipelineSubcollection } from '../collection/pipeline-collection/constructors/createPipelineSubcollection';
+import { pipelineCollectionToJson } from '../collection/pipeline-collection/pipelineCollectionToJson';
+import { createEmptyAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
+import { createBasicAgentModelRequirements } from '../commitments/_base/createEmptyAgentModelRequirements';
+import { NotYetImplementedCommitmentDefinition } from '../commitments/_base/NotYetImplementedCommitmentDefinition';
+import { getCommitmentDefinition } from '../commitments/index';
+import { getAllCommitmentDefinitions } from '../commitments/index';
+import { getAllCommitmentTypes } from '../commitments/index';
+import { isCommitmentSupported } from '../commitments/index';
+import type { GroupedCommitmentDefinition } from '../commitments/index';
+import { getGroupedCommitmentDefinitions } from '../commitments/index';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
 import { CLAIM } from '../config';
 import { PROMPTBOOK_COLOR } from '../config';
+import { PROMPTBOOK_SYNTAX_COLORS } from '../config';
 import { PROMPTBOOK_CHAT_COLOR } from '../config';
 import { USER_CHAT_COLOR } from '../config';
 import { DEFAULT_BOOK_TITLE } from '../config';
@@ -41,6 +50,7 @@ import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL } from '../config';
 import { DEFAULT_BOOKS_DIRNAME } from '../config';
+import { DEFAULT_AGENTS_DIRNAME } from '../config';
 import { DEFAULT_DOWNLOAD_CACHE_DIRNAME } from '../config';
 import { DEFAULT_EXECUTION_CACHE_DIRNAME } from '../config';
 import { DEFAULT_SCRAPE_CACHE_DIRNAME } from '../config';
@@ -74,11 +84,13 @@ import { PROMPTBOOK_ERRORS } from '../errors/0-index';
 import { AbstractFormatError } from '../errors/AbstractFormatError';
 import { AuthenticationError } from '../errors/AuthenticationError';
 import { CollectionError } from '../errors/CollectionError';
+import { DatabaseError } from '../errors/DatabaseError';
 import { EnvironmentMismatchError } from '../errors/EnvironmentMismatchError';
 import { ExpectError } from '../errors/ExpectError';
 import { KnowledgeScrapeError } from '../errors/KnowledgeScrapeError';
 import { LimitReachedError } from '../errors/LimitReachedError';
 import { MissingToolsError } from '../errors/MissingToolsError';
+import { NotAllowed } from '../errors/NotAllowed';
 import { NotFoundError } from '../errors/NotFoundError';
 import { NotYetImplementedError } from '../errors/NotYetImplementedError';
 import { ParseError } from '../errors/ParseError';
@@ -126,10 +138,12 @@ import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usag
 import { getSingleLlmExecutionTools } from '../llm-providers/_multiple/getSingleLlmExecutionTools';
 import { joinLlmExecutionTools } from '../llm-providers/_multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/_multiple/MultipleLlmExecutionTools';
+import { Agent } from '../llm-providers/agent/Agent';
 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 { RemoteAgent } from '../llm-providers/agent/RemoteAgent';
 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';
@@ -168,19 +182,37 @@ import { _WebsiteScraperMetadataRegistration } from '../scrapers/website/registe
 import { BlackholeStorage } from '../storage/blackhole/BlackholeStorage';
 import { MemoryStorage } from '../storage/memory/MemoryStorage';
 import { PrefixStorage } from '../storage/utils/PrefixStorage';
+import { $bookTranspilersRegister } from '../transpilers/_common/register/$bookTranspilersRegister';
+import { FormattedBookInMarkdownTranspiler } from '../transpilers/formatted-book-in-markdown/FormattedBookInMarkdownTranspiler';
+import { OpenAiSdkTranspiler } from '../transpilers/openai-sdk/OpenAiSdkTranspiler';
 import { MODEL_VARIANTS } from '../types/ModelVariant';
 import { NonTaskSectionTypes } from '../types/SectionType';
 import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
+import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInformation';
+import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
 import { REMOTE_SERVER_URLS } from '../../servers';
+import { AUTO_FEDERATED_AGENT_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { computeAgentHash };
 export { createAgentModelRequirements };
 export { createAgentModelRequirementsWithCommitments };
+export { createDefaultAgentName };
+export { normalizeAgentName };
+export { PADDING_LINES };
+export { padBook };
 export { parseAgentSource };
 export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };
+export { generatePlaceholderAgentProfileImageUrl };
+export { AgentCollectionInSupabase };
+export { createPipelineCollectionFromJson };
+export { createPipelineCollectionFromPromise };
+export { createPipelineCollectionFromUrl };
+export { createPipelineSubcollection };
+export { pipelineCollectionToJson };
 export { createEmptyAgentModelRequirements };
 export { createBasicAgentModelRequirements };
 export { NotYetImplementedCommitmentDefinition };
@@ -188,17 +220,14 @@ export { getCommitmentDefinition };
 export { getAllCommitmentDefinitions };
 export { getAllCommitmentTypes };
 export { isCommitmentSupported };
-export { generatePlaceholderAgentProfileImageUrl };
-export { collectionToJson };
-export { createCollectionFromJson };
-export { createCollectionFromPromise };
-export { createCollectionFromUrl };
-export { createSubcollection };
+export type { GroupedCommitmentDefinition };
+export { getGroupedCommitmentDefinitions };
 export { NAME };
 export { ADMIN_EMAIL };
 export { ADMIN_GITHUB_NAME };
 export { CLAIM };
 export { PROMPTBOOK_COLOR };
+export { PROMPTBOOK_SYNTAX_COLORS };
 export { PROMPTBOOK_CHAT_COLOR };
 export { USER_CHAT_COLOR };
 export { DEFAULT_BOOK_TITLE };
@@ -216,6 +245,7 @@ export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };
 export { DEFAULT_BOOKS_DIRNAME };
+export { DEFAULT_AGENTS_DIRNAME };
 export { DEFAULT_DOWNLOAD_CACHE_DIRNAME };
 export { DEFAULT_EXECUTION_CACHE_DIRNAME };
 export { DEFAULT_SCRAPE_CACHE_DIRNAME };
@@ -249,11 +279,13 @@ export { PROMPTBOOK_ERRORS };
 export { AbstractFormatError };
 export { AuthenticationError };
 export { CollectionError };
+export { DatabaseError };
 export { EnvironmentMismatchError };
 export { ExpectError };
 export { KnowledgeScrapeError };
 export { LimitReachedError };
 export { MissingToolsError };
+export { NotAllowed };
 export { NotFoundError };
 export { NotYetImplementedError };
 export { ParseError };
@@ -301,10 +333,12 @@ export { limitTotalUsage };
 export { getSingleLlmExecutionTools };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };
+export { Agent };
 export { AgentLlmExecutionTools };
 export { createAgentLlmExecutionTools };
 export { _AgentMetadata };
 export { _AgentRegistration };
+export { RemoteAgent };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _DeepseekMetadataRegistration };
@@ -343,8 +377,14 @@ export { _WebsiteScraperMetadataRegistration };
 export { BlackholeStorage };
 export { MemoryStorage };
 export { PrefixStorage };
+export { $bookTranspilersRegister };
+export { FormattedBookInMarkdownTranspiler };
+export { OpenAiSdkTranspiler };
 export { MODEL_VARIANTS };
 export { NonTaskSectionTypes };
 export { SectionTypes };
 export { TaskTypes };
+export { aboutPromptbookInformation };
+export { $generateBookBoilerplate };
 export { REMOTE_SERVER_URLS };
+export { AUTO_FEDERATED_AGENT_SERVER_URLS };

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

@@ -1,5 +1,5 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
-import { createCollectionFromDirectory } from '../collection/constructors/createCollectionFromDirectory';
+import { createPipelineCollectionFromDirectory } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromDirectory';
 import { $provideExecutablesForNode } from '../executables/$provideExecutablesForNode';
 import { $provideExecutionToolsForNode } from '../execution/utils/$provideExecutionToolsForNode';
 import { $provideLlmToolsConfigurationFromEnv } from '../llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv';
@@ -11,7 +11,7 @@ import { FileCacheStorage } from '../storage/file-cache-storage/FileCacheStorage
 import { $execCommand } from '../utils/execCommand/$execCommand';
 import { $execCommands } from '../utils/execCommand/$execCommands';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
-export { createCollectionFromDirectory };
+export { createPipelineCollectionFromDirectory };
 export { $provideExecutablesForNode };
 export { $provideExecutionToolsForNode };
 export { $provideLlmToolsConfigurationFromEnv };

package/esm/typings/src/_packages/remote-server.index.d.ts

@@ -2,11 +2,13 @@ import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import type { Identification } from '../remote-server/socket-types/_subtypes/Identification';
 import type { ApplicationModeIdentification } from '../remote-server/socket-types/_subtypes/Identification';
 import type { AnonymousModeIdentification } from '../remote-server/socket-types/_subtypes/Identification';
+import { startAgentServer } from '../remote-server/startAgentServer';
 import { startRemoteServer } from '../remote-server/startRemoteServer';
 import type { RemoteServerOptions } from '../remote-server/types/RemoteServerOptions';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export type { Identification };
 export type { ApplicationModeIdentification };
 export type { AnonymousModeIdentification };
+export { startAgentServer };
 export { startRemoteServer };
 export type { RemoteServerOptions };

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

@@ -2,14 +2,12 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 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 { 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';
 import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
+import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 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';
@@ -21,7 +19,17 @@ import type { string_chat_format_name } from '../book-components/Chat/save/_comm
 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 { QrCodeOptions } from '../book-components/Qr/useQrCode';
+import type { AgentCollection } from '../collection/agent-collection/AgentCollection';
+import type { AgentCollectionInSupabaseOptions } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabaseOptions';
+import type { Json } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { AgentsDatabaseSchema } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { Tables } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { TablesInsert } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { TablesUpdate } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { Enums } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { CompositeTypes } from '../collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import type { PipelineCollection } from '../collection/pipeline-collection/PipelineCollection';
 import type { Command } from '../commands/_common/types/Command';
 import type { CommandParser } from '../commands/_common/types/CommandParser';
 import type { PipelineBothCommandParser } from '../commands/_common/types/CommandParser';
@@ -46,6 +54,10 @@ import type { SectionCommand } from '../commands/SECTION/SectionCommand';
 import type { UrlCommand } from '../commands/URL/UrlCommand';
 import type { ActionCommand } from '../commands/X_ACTION/ActionCommand';
 import type { InstrumentCommand } from '../commands/X_INSTRUMENT/InstrumentCommand';
+import type { BookCommitment } from '../commitments/_base/BookCommitment';
+import type { CommitmentDefinition } from '../commitments/_base/CommitmentDefinition';
+import type { ParsedCommitment } from '../commitments/_base/ParsedCommitment';
+import type { GroupedCommitmentDefinition } from '../commitments/index';
 import type { PrettifyOptions } from '../conversion/prettify/PrettifyOptions';
 import type { renderPipelineMermaidOptions } from '../conversion/prettify/renderPipelineMermaidOptions';
 import type { CallbackInterfaceToolsOptions } from '../dialogs/callback/CallbackInterfaceToolsOptions';
@@ -76,6 +88,7 @@ import type { PromptbookFetch } from '../execution/PromptbookFetch';
 import type { PromptResult } from '../execution/PromptResult';
 import type { CompletionPromptResult } from '../execution/PromptResult';
 import type { ChatPromptResult } from '../execution/PromptResult';
+import type { ImagePromptResult } from '../execution/PromptResult';
 import type { EmbeddingPromptResult } from '../execution/PromptResult';
 import type { ScriptExecutionTools } from '../execution/ScriptExecutionTools';
 import type { ScriptExecutionToolsExecuteOptions } from '../execution/ScriptExecutionTools';
@@ -98,7 +111,9 @@ 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 { AgentOptions } from '../llm-providers/agent/AgentOptions';
+import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/CreateAgentLlmExecutionToolsOptions';
+import type { RemoteAgentOptions } from '../llm-providers/agent/RemoteAgentOptions';
 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';
@@ -166,10 +181,14 @@ import type { PostprocessingFunction } from '../scripting/javascript/JavascriptE
 import type { PromptbookStorage } from '../storage/_common/PromptbookStorage';
 import type { FileCacheStorageOptions } from '../storage/file-cache-storage/FileCacheStorageOptions';
 import type { IndexedDbStorageOptions } from '../storage/local-storage/utils/IndexedDbStorageOptions';
+import type { BookTranspiler } from '../transpilers/_common/BookTranspiler';
+import type { BookTranspilerOptions } from '../transpilers/_common/BookTranspilerOptions';
 import type { IntermediateFilesStrategy } from '../types/IntermediateFilesStrategy';
+import type { LlmCall } from '../types/LlmCall';
 import type { ModelRequirements } from '../types/ModelRequirements';
 import type { CompletionModelRequirements } from '../types/ModelRequirements';
 import type { ChatModelRequirements } from '../types/ModelRequirements';
+import type { ImageGenerationModelRequirements } from '../types/ModelRequirements';
 import type { EmbeddingModelRequirements } from '../types/ModelRequirements';
 import type { ModelVariant } from '../types/ModelVariant';
 import type { NonEmptyArray } from '../types/NonEmptyArray';
@@ -177,6 +196,7 @@ import type { NonEmptyReadonlyArray } from '../types/NonEmptyArray';
 import type { Prompt } from '../types/Prompt';
 import type { CompletionPrompt } from '../types/Prompt';
 import type { ChatPrompt } from '../types/Prompt';
+import type { ImagePrompt } from '../types/Prompt';
 import type { EmbeddingPrompt } from '../types/Prompt';
 import type { ScriptLanguage } from '../types/ScriptLanguage';
 import type { SectionType } from '../types/SectionType';
@@ -203,6 +223,8 @@ import type { string_reserved_parameter_name } from '../types/typeAliases';
 import type { ReservedParameters } from '../types/typeAliases';
 import type { string_title } from '../types/typeAliases';
 import type { string_agent_name } from '../types/typeAliases';
+import type { string_agent_name_in_book } from '../types/typeAliases';
+import type { string_agent_hash } from '../types/typeAliases';
 import type { string_persona_description } from '../types/typeAliases';
 import type { string_model_description } from '../types/typeAliases';
 import type { string_knowledge_source_content } from '../types/typeAliases';
@@ -226,12 +248,14 @@ import type { string_typescript } from '../types/typeAliases';
 import type { string_json } from '../types/typeAliases';
 import type { string_css_class } from '../types/typeAliases';
 import type { string_css_property } from '../types/typeAliases';
+import type { string_fonts } from '../types/typeAliases';
 import type { string_css_value } from '../types/typeAliases';
 import type { string_css_selector } from '../types/typeAliases';
 import type { string_url } from '../types/typeAliases';
 import type { string_promptbook_server_url } from '../types/typeAliases';
 import type { string_base_url } from '../types/typeAliases';
 import type { string_pipeline_root_url } from '../types/typeAliases';
+import type { string_agent_url } from '../types/typeAliases';
 import type { string_pipeline_url } from '../types/typeAliases';
 import type { string_pipeline_url_with_task_hash } from '../types/typeAliases';
 import type { string_data_url } from '../types/typeAliases';
@@ -261,6 +285,8 @@ import type { string_absolute_dirname } from '../types/typeAliases';
 import type { string_relative_dirname } from '../types/typeAliases';
 import type { string_dirname } from '../types/typeAliases';
 import type { string_person_fullname } from '../types/typeAliases';
+import type { string_person_firstname } from '../types/typeAliases';
+import type { string_person_lastname } from '../types/typeAliases';
 import type { string_person_profile } from '../types/typeAliases';
 import type { string_license } from '../types/typeAliases';
 import type { string_legal_entity } from '../types/typeAliases';
@@ -306,6 +332,7 @@ import type { number_kilobytes } from '../types/typeAliases';
 import type { number_megabytes } from '../types/typeAliases';
 import type { number_gigabytes } from '../types/typeAliases';
 import type { number_terabytes } from '../types/typeAliases';
+import type { Updatable } from '../types/Updatable';
 import type { ColorTransformer } from '../utils/color/operators/ColorTransformer';
 import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
 import type { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
@@ -314,6 +341,7 @@ import type { CodeBlock } from '../utils/markdown/extractAllBlocksFromMarkdown';
 import type { MarkdownSection } from '../utils/markdown/parseMarkdownSection';
 import type { Registered } from '../utils/misc/$Register';
 import type { Registration } from '../utils/misc/$Register';
+import type { AboutPromptbookInformationOptions } from '../utils/misc/aboutPromptbookInformation';
 import type { FromtoItems } from '../utils/misc/FromtoItems';
 import type { InjectCssModuleIntoShadowRootOptions } from '../utils/misc/injectCssModuleIntoShadowRoot';
 import type { string_keyword } from '../utils/normalization/IKeywords';
@@ -327,6 +355,9 @@ import type { OrderJsonOptions } from '../utils/normalization/orderJson';
 import type { empty_object } from '../utils/organization/empty_object';
 import type { really_any } from '../utils/organization/really_any';
 import type { TODO_any } from '../utils/organization/TODO_any';
+import type { RandomFullnameWithColorResult } from '../utils/random/$randomFullnameWithColor';
+import type { GenerateNameResult } from '../utils/random/NamePool';
+import type { NamePool } from '../utils/random/NamePool';
 import type { CheckSerializableAsJsonOptions } from '../utils/serialization/checkSerializableAsJson';
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
@@ -335,14 +366,12 @@ export type { BookParameter };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
 export type { string_book };
-export type { BookCommitment };
-export type { CommitmentDefinition };
-export type { ParsedCommitment };
 export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };
 export type { AvatarProfileProps };
 export type { AvatarProfileFromSourceProps };
 export type { BookEditorProps };
+export type { AgentChatProps };
 export type { ChatProps };
 export type { ChatAutoScrollConfig };
 export type { SendMessageToLlmChatFunction };
@@ -354,6 +383,16 @@ export type { string_chat_format_name };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
+export type { QrCodeOptions };
+export type { AgentCollection };
+export type { AgentCollectionInSupabaseOptions };
+export type { Json };
+export type { AgentsDatabaseSchema };
+export type { Tables };
+export type { TablesInsert };
+export type { TablesUpdate };
+export type { Enums };
+export type { CompositeTypes };
 export type { PipelineCollection };
 export type { Command };
 export type { CommandParser };
@@ -379,6 +418,10 @@ export type { SectionCommand };
 export type { UrlCommand };
 export type { ActionCommand };
 export type { InstrumentCommand };
+export type { BookCommitment };
+export type { CommitmentDefinition };
+export type { ParsedCommitment };
+export type { GroupedCommitmentDefinition };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
@@ -409,6 +452,7 @@ export type { PromptbookFetch };
 export type { PromptResult };
 export type { CompletionPromptResult };
 export type { ChatPromptResult };
+export type { ImagePromptResult };
 export type { EmbeddingPromptResult };
 export type { ScriptExecutionTools };
 export type { ScriptExecutionToolsExecuteOptions };
@@ -431,7 +475,9 @@ export type { LlmToolsOptions };
 export type { CacheItem };
 export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
+export type { AgentOptions };
 export type { CreateAgentLlmExecutionToolsOptions };
+export type { RemoteAgentOptions };
 export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };
@@ -499,10 +545,14 @@ export type { PostprocessingFunction };
 export type { PromptbookStorage };
 export type { FileCacheStorageOptions };
 export type { IndexedDbStorageOptions };
+export type { BookTranspiler };
+export type { BookTranspilerOptions };
 export type { IntermediateFilesStrategy };
+export type { LlmCall };
 export type { ModelRequirements };
 export type { CompletionModelRequirements };
 export type { ChatModelRequirements };
+export type { ImageGenerationModelRequirements };
 export type { EmbeddingModelRequirements };
 export type { ModelVariant };
 export type { NonEmptyArray };
@@ -510,6 +560,7 @@ export type { NonEmptyReadonlyArray };
 export type { Prompt };
 export type { CompletionPrompt };
 export type { ChatPrompt };
+export type { ImagePrompt };
 export type { EmbeddingPrompt };
 export type { ScriptLanguage };
 export type { SectionType };
@@ -536,6 +587,8 @@ export type { string_reserved_parameter_name };
 export type { ReservedParameters };
 export type { string_title };
 export type { string_agent_name };
+export type { string_agent_name_in_book };
+export type { string_agent_hash };
 export type { string_persona_description };
 export type { string_model_description };
 export type { string_knowledge_source_content };
@@ -559,12 +612,14 @@ export type { string_typescript };
 export type { string_json };
 export type { string_css_class };
 export type { string_css_property };
+export type { string_fonts };
 export type { string_css_value };
 export type { string_css_selector };
 export type { string_url };
 export type { string_promptbook_server_url };
 export type { string_base_url };
 export type { string_pipeline_root_url };
+export type { string_agent_url };
 export type { string_pipeline_url };
 export type { string_pipeline_url_with_task_hash };
 export type { string_data_url };
@@ -594,6 +649,8 @@ export type { string_absolute_dirname };
 export type { string_relative_dirname };
 export type { string_dirname };
 export type { string_person_fullname };
+export type { string_person_firstname };
+export type { string_person_lastname };
 export type { string_person_profile };
 export type { string_license };
 export type { string_legal_entity };
@@ -639,6 +696,7 @@ export type { number_kilobytes };
 export type { number_megabytes };
 export type { number_gigabytes };
 export type { number_terabytes };
+export type { Updatable };
 export type { ColorTransformer };
 export type { PipelineEditableSerialized };
 export type { ExecCommandOptions };
@@ -647,6 +705,7 @@ export type { CodeBlock };
 export type { MarkdownSection };
 export type { Registered };
 export type { Registration };
+export type { AboutPromptbookInformationOptions };
 export type { FromtoItems };
 export type { InjectCssModuleIntoShadowRootOptions };
 export type { string_keyword };
@@ -660,6 +719,9 @@ export type { OrderJsonOptions };
 export type { empty_object };
 export type { really_any };
 export type { TODO_any };
+export type { RandomFullnameWithColorResult };
+export type { GenerateNameResult };
+export type { NamePool };
 export type { CheckSerializableAsJsonOptions };
 export type { ExportJsonOptions };
 export type { ITakeChain };

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

@@ -11,6 +11,7 @@ import { jsonParse } from '../formats/json/utils/jsonParse';
 import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
+import { $detectRuntimeEnvironment } from '../utils/environment/$detectRuntimeEnvironment';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
@@ -26,6 +27,7 @@ import { countSentences } from '../utils/expectation-counters/countSentences';
 import { countWords } from '../utils/expectation-counters/countWords';
 import { CountUtils } from '../utils/expectation-counters/index';
 import { $getCurrentDate } from '../utils/misc/$getCurrentDate';
+import { computeHash } from '../utils/misc/computeHash';
 import { debounce } from '../utils/misc/debounce';
 import { parseNumber } from '../utils/misc/parseNumber';
 import { capitalize } from '../utils/normalization/capitalize';
@@ -38,6 +40,7 @@ import { nameToUriPart } from '../utils/normalization/nameToUriPart';
 import { nameToUriParts } from '../utils/normalization/nameToUriParts';
 import type { string_kebab_case } from '../utils/normalization/normalize-to-kebab-case';
 import { normalizeToKebabCase } from '../utils/normalization/normalize-to-kebab-case';
+import { normalizeMessageText } from '../utils/normalization/normalizeMessageText';
 import type { string_camelCase } from '../utils/normalization/normalizeTo_camelCase';
 import { normalizeTo_camelCase } from '../utils/normalization/normalizeTo_camelCase';
 import type { string_PascalCase } from '../utils/normalization/normalizeTo_PascalCase';
@@ -96,6 +99,7 @@ export { jsonParse };
 export { isValidXmlString };
 export { prompt };
 export { promptTemplate };
+export { $detectRuntimeEnvironment };
 export { $isRunningInBrowser };
 export { $isRunningInJest };
 export { $isRunningInNode };
@@ -111,6 +115,7 @@ export { countSentences };
 export { countWords };
 export { CountUtils };
 export { $getCurrentDate };
+export { computeHash };
 export { debounce };
 export { parseNumber };
 export { capitalize };
@@ -123,6 +128,7 @@ export { nameToUriPart };
 export { nameToUriParts };
 export type { string_kebab_case };
 export { normalizeToKebabCase };
+export { normalizeMessageText };
 export type { string_camelCase };
 export { normalizeTo_camelCase };
 export type { string_PascalCase };

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

@@ -29,6 +29,8 @@ import { _PdfScraperRegistration } from '../scrapers/pdf/register-constructor';
 import { _PdfScraperMetadataRegistration } from '../scrapers/pdf/register-metadata';
 import { _WebsiteScraperRegistration } from '../scrapers/website/register-constructor';
 import { _WebsiteScraperMetadataRegistration } from '../scrapers/website/register-metadata';
+import { _FormattedBookInMarkdownTranspilerRegistration } from '../transpilers/formatted-book-in-markdown/register';
+import { _OpenAiSdkTranspilerRegistration } from '../transpilers/openai-sdk/register';
 import { wizard } from '../wizard/wizard';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { _AnthropicClaudeMetadataRegistration };
@@ -61,4 +63,6 @@ export { _PdfScraperRegistration };
 export { _PdfScraperMetadataRegistration };
 export { _WebsiteScraperRegistration };
 export { _WebsiteScraperMetadataRegistration };
+export { _FormattedBookInMarkdownTranspilerRegistration };
+export { _OpenAiSdkTranspilerRegistration };
 export { wizard };

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

@@ -1,4 +1,4 @@
-import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+import type { string_agent_hash, string_agent_name, string_agent_url, string_color, string_fonts, string_url_image } from '../../types/typeAliases';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @
@@ -28,24 +28,38 @@ export type AgentBasicInformation = {
      * Name of the agent
      * This is the first line of the agent source
      */
-    agentName: string_agent_name | null;
+    agentName: string_agent_name;
+    /**
+     * Hash of the agent source for integrity verification
+     */
+    agentHash: string_agent_hash;
     /**
      * Optional description of the agent
      * This is the line starting with "PERSONA"
      */
     personaDescription: string | null;
+    /**
+     * The initial message shown to the user when the chat starts
+     * This is the line starting with "INITIAL MESSAGE"
+     */
+    initialMessage: string | null;
     /**
      * 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: {
+        fullname?: string;
         image?: string_url_image;
-        link?: string;
-        title?: string;
-        description?: string;
+        font?: string_fonts;
+        color?: string_color;
         [key: string]: string | undefined;
     };
+    /**
+     * Links found in the agent source
+     * This corresponds to META LINK commitments
+     */
+    links: Array<string_agent_url>;
     /**
      * Parameters found in the agent source
      * Supports two different notations for the same syntax feature:
@@ -55,5 +69,6 @@ export type AgentBasicInformation = {
     parameters: BookParameter[];
 };
 /**
+ * TODO: [🐱‍🚀] Make all properties of `AgentBasicInformation` readonly
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  */