@promptbook/legacy-documents 0.105.0-9 → 0.105.0

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

@@ -1,4 +1,5 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { getAllCommitmentsToolFunctionsForBrowser } from '../commitments/_common/getAllCommitmentsToolFunctionsForBrowser';
 import { SimplePromptInterfaceTools } from '../dialogs/simple-prompt/SimplePromptInterfaceTools';
 import { $provideScrapersForBrowser } from '../scrapers/_common/register/$provideScrapersForBrowser';
 import { BrowserSpeechRecognition } from '../speech-recognition/BrowserSpeechRecognition';
@@ -9,6 +10,7 @@ import { $induceBookDownload } from '../utils/files/$induceBookDownload';
 import { $induceFileDownload } from '../utils/files/$induceFileDownload';
 import { ObjectUrl } from '../utils/files/ObjectUrl';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { getAllCommitmentsToolFunctionsForBrowser };
 export { SimplePromptInterfaceTools };
 export { $provideScrapersForBrowser };
 export { BrowserSpeechRecognition };

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

@@ -13,7 +13,17 @@ import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
+import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
+import { ChatSoundToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
+import { ChatEffectsSystem } from '../book-components/Chat/effects/ChatEffectsSystem';
+import { ConfettiEffect } from '../book-components/Chat/effects/components/ConfettiEffect';
+import { HeartsEffect } from '../book-components/Chat/effects/components/HeartsEffect';
+import { defaultEffectConfigs } from '../book-components/Chat/effects/configs/defaultEffectConfigs';
+import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
+import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
+import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
+import type { ChatEffectType } from '../book-components/Chat/effects/types/ChatEffectType';
 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';
@@ -71,7 +81,17 @@ export { BookEditor };
 export { AgentChat };
 export type { AgentChatProps };
 export { Chat };
+export type { ChatSoundSystem };
 export type { ChatProps };
+export { ChatSoundToggle };
+export { ChatEffectsSystem };
+export { ConfettiEffect };
+export { HeartsEffect };
+export { defaultEffectConfigs };
+export type { ChatEffect };
+export type { ChatEffectConfig };
+export type { ChatEffectsSystemProps };
+export type { ChatEffectType };
 export { useChatAutoScroll };
 export type { SendMessageToLlmChatFunction };
 export { useSendMessageToLlmChat };

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

@@ -21,13 +21,12 @@ import { pipelineCollectionToJson } from '../collection/pipeline-collection/pipe
 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 { getAllCommitmentsToolFunctions } from '../commitments/index';
+import { getAllCommitmentDefinitions } from '../commitments/_common/getAllCommitmentDefinitions';
+import { getAllCommitmentsToolTitles } from '../commitments/_common/getAllCommitmentsToolTitles';
+import { getAllCommitmentTypes } from '../commitments/_common/getAllCommitmentTypes';
+import { getCommitmentDefinition } from '../commitments/_common/getCommitmentDefinition';
+import { getGroupedCommitmentDefinitions } from '../commitments/_common/getGroupedCommitmentDefinitions';
+import { isCommitmentSupported } from '../commitments/_common/isCommitmentSupported';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
 import { PROMPTBOOK_LEGAL_ENTITY } from '../config';
@@ -48,6 +47,7 @@ import { PENDING_VALUE_PLACEHOLDER } from '../config';
 import { MAX_FILENAME_LENGTH } from '../config';
 import { DEFAULT_INTERMEDIATE_FILES_STRATEGY } from '../config';
 import { DEFAULT_MAX_PARALLEL_COUNT } from '../config';
+import { DEFAULT_MAX_CONCURRENT_UPLOADS } from '../config';
 import { DEFAULT_MAX_RECURSION } from '../config';
 import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
@@ -74,6 +74,11 @@ import { MODEL_TRUST_LEVELS } from '../constants';
 import { MODEL_ORDERS } from '../constants';
 import { ORDER_OF_PIPELINE_JSON } from '../constants';
 import { RESERVED_PARAMETER_NAMES } from '../constants';
+import { LIMITS } from '../constants';
+import { TIME_INTERVALS } from '../constants';
+import { NETWORK_LIMITS } from '../constants';
+import { COLOR_CONSTANTS } from '../constants';
+import { HTTP_STATUS_CODES } from '../constants';
 import { compilePipeline } from '../conversion/compilePipeline';
 import { parsePipeline } from '../conversion/parsePipeline';
 import { pipelineJsonToString } from '../conversion/pipelineJsonToString';
@@ -220,13 +225,12 @@ export { pipelineCollectionToJson };
 export { createEmptyAgentModelRequirements };
 export { createBasicAgentModelRequirements };
 export { NotYetImplementedCommitmentDefinition };
-export { getCommitmentDefinition };
 export { getAllCommitmentDefinitions };
+export { getAllCommitmentsToolTitles };
 export { getAllCommitmentTypes };
-export { isCommitmentSupported };
-export type { GroupedCommitmentDefinition };
+export { getCommitmentDefinition };
 export { getGroupedCommitmentDefinitions };
-export { getAllCommitmentsToolFunctions };
+export { isCommitmentSupported };
 export { NAME };
 export { ADMIN_EMAIL };
 export { PROMPTBOOK_LEGAL_ENTITY };
@@ -247,6 +251,7 @@ export { PENDING_VALUE_PLACEHOLDER };
 export { MAX_FILENAME_LENGTH };
 export { DEFAULT_INTERMEDIATE_FILES_STRATEGY };
 export { DEFAULT_MAX_PARALLEL_COUNT };
+export { DEFAULT_MAX_CONCURRENT_UPLOADS };
 export { DEFAULT_MAX_RECURSION };
 export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
@@ -273,6 +278,11 @@ export { MODEL_TRUST_LEVELS };
 export { MODEL_ORDERS };
 export { ORDER_OF_PIPELINE_JSON };
 export { RESERVED_PARAMETER_NAMES };
+export { LIMITS };
+export { TIME_INTERVALS };
+export { NETWORK_LIMITS };
+export { COLOR_CONSTANTS };
+export { HTTP_STATUS_CODES };
 export { compilePipeline };
 export { parsePipeline };
 export { pipelineJsonToString };

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

@@ -1,5 +1,6 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createPipelineCollectionFromDirectory } from '../collection/pipeline-collection/constructors/createPipelineCollectionFromDirectory';
+import { getAllCommitmentsToolFunctionsForNode } from '../commitments/_common/getAllCommitmentsToolFunctionsForNode';
 import { $provideExecutablesForNode } from '../executables/$provideExecutablesForNode';
 import { $provideExecutionToolsForNode } from '../execution/utils/$provideExecutionToolsForNode';
 import { $provideLlmToolsConfigurationFromEnv } from '../llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv';
@@ -12,6 +13,7 @@ import { $execCommand } from '../utils/execCommand/$execCommand';
 import { $execCommands } from '../utils/execCommand/$execCommands';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createPipelineCollectionFromDirectory };
+export { getAllCommitmentsToolFunctionsForNode };
 export { $provideExecutablesForNode };
 export { $provideExecutionToolsForNode };
 export { $provideLlmToolsConfigurationFromEnv };

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

@@ -1,8 +1,10 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { createOpenAiAgentExecutionTools } from '../llm-providers/openai/createOpenAiAgentExecutionTools';
 import { createOpenAiAssistantExecutionTools } from '../llm-providers/openai/createOpenAiAssistantExecutionTools';
 import { createOpenAiCompatibleExecutionTools } from '../llm-providers/openai/createOpenAiCompatibleExecutionTools';
 import { createOpenAiExecutionTools } from '../llm-providers/openai/createOpenAiExecutionTools';
 import { OPENAI_MODELS } from '../llm-providers/openai/openai-models';
+import { OpenAiAgentExecutionTools } from '../llm-providers/openai/OpenAiAgentExecutionTools';
 import { OpenAiAssistantExecutionTools } from '../llm-providers/openai/OpenAiAssistantExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import { OpenAiCompatibleExecutionTools } from '../llm-providers/openai/OpenAiCompatibleExecutionTools';
@@ -15,10 +17,12 @@ import { _OpenAiRegistration } from '../llm-providers/openai/register-constructo
 import { _OpenAiAssistantRegistration } from '../llm-providers/openai/register-constructor';
 import { _OpenAiCompatibleRegistration } from '../llm-providers/openai/register-constructor';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { createOpenAiAgentExecutionTools };
 export { createOpenAiAssistantExecutionTools };
 export { createOpenAiCompatibleExecutionTools };
 export { createOpenAiExecutionTools };
 export { OPENAI_MODELS };
+export { OpenAiAgentExecutionTools };
 export { OpenAiAssistantExecutionTools };
 export type { OpenAiAssistantExecutionToolsOptions };
 export { OpenAiCompatibleExecutionTools };

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

@@ -9,17 +9,31 @@ import type { AvatarProfileProps } from '../book-components/AvatarProfile/Avatar
 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 { AgentChipData } from '../book-components/Chat/AgentChip/AgentChip';
+import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip';
+import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatSoundToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
+import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
+import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
+import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
+import type { ChatEffectType } from '../book-components/Chat/effects/types/ChatEffectType';
 import type { ChatAutoScrollConfig } from '../book-components/Chat/hooks/useChatAutoScroll';
 import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks/useSendMessageToLlmChat';
+import type { FriendlyErrorMessage } from '../book-components/Chat/LlmChat/FriendlyErrorMessage';
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/MockedChat';
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
 import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
 import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
+import type { SourceChipProps } from '../book-components/Chat/SourceChip/SourceChip';
+import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
+import type { ToolCallChipletInfo } from '../book-components/Chat/utils/getToolCallChipletText';
+import type { ParsedCitation } from '../book-components/Chat/utils/parseCitationsFromContent';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
+import type { TeamToolResult } from '../book-components/Chat/utils/toolCallParsing';
 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';
@@ -58,7 +72,6 @@ import type { InstrumentCommand } from '../commands/X_INSTRUMENT/InstrumentComma
 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';
@@ -123,6 +136,7 @@ import type { AzureOpenAiExecutionToolsOptions } from '../llm-providers/azure-op
 import type { DeepseekExecutionToolsOptions } from '../llm-providers/deepseek/DeepseekExecutionToolsOptions';
 import type { GoogleExecutionToolsOptions } from '../llm-providers/google/GoogleExecutionToolsOptions';
 import type { OllamaExecutionToolsOptions } from '../llm-providers/ollama/OllamaExecutionToolsOptions';
+import type { OpenAiAgentExecutionToolsOptions } from '../llm-providers/openai/OpenAiAgentExecutionTools';
 import type { OpenAiAssistantExecutionToolsOptions } from '../llm-providers/openai/OpenAiAssistantExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from '../llm-providers/openai/OpenAiCompatibleExecutionToolsOptions';
@@ -213,6 +227,7 @@ import type { SpeechRecognitionStartOptions } from '../types/SpeechRecognition';
 import type { SpeechRecognitionState } from '../types/SpeechRecognition';
 import type { SpeechRecognitionEvent } from '../types/SpeechRecognition';
 import type { TaskType } from '../types/TaskType';
+import type { ToolCall } from '../types/ToolCall';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
 import type { string_business_category_name } from '../types/typeAliases';
 import type { string_model_name } from '../types/typeAliases';
@@ -389,17 +404,31 @@ export type { AvatarProfileProps };
 export type { AvatarProfileFromSourceProps };
 export type { BookEditorProps };
 export type { AgentChatProps };
+export type { AgentChipData };
+export type { AgentChipProps };
+export type { ChatSoundSystem };
 export type { ChatProps };
+export type { ChatSoundToggleProps };
+export type { ChatEffect };
+export type { ChatEffectConfig };
+export type { ChatEffectsSystemProps };
+export type { ChatEffectType };
 export type { ChatAutoScrollConfig };
 export type { SendMessageToLlmChatFunction };
+export type { FriendlyErrorMessage };
 export type { LlmChatProps };
 export type { MockedChatDelayConfig };
 export type { MockedChatProps };
 export type { ChatSaveFormatDefinition };
 export type { string_chat_format_name };
+export type { SourceChipProps };
+export type { ChatToolCall };
 export type { ChatMessage };
 export type { ChatParticipant };
+export type { ToolCallChipletInfo };
+export type { ParsedCitation };
 export type { MessageButton };
+export type { TeamToolResult };
 export type { QrCodeOptions };
 export type { AgentCollection };
 export type { AgentCollectionInSupabaseOptions };
@@ -438,7 +467,6 @@ export type { InstrumentCommand };
 export type { BookCommitment };
 export type { CommitmentDefinition };
 export type { ParsedCommitment };
-export type { GroupedCommitmentDefinition };
 export type { PrettifyOptions };
 export type { renderPipelineMermaidOptions };
 export type { CallbackInterfaceToolsOptions };
@@ -503,6 +531,7 @@ export type { AzureOpenAiExecutionToolsOptions };
 export type { DeepseekExecutionToolsOptions };
 export type { GoogleExecutionToolsOptions };
 export type { OllamaExecutionToolsOptions };
+export type { OpenAiAgentExecutionToolsOptions };
 export type { OpenAiAssistantExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsOptions };
 export type { OpenAiCompatibleExecutionToolsNonProxiedOptions };
@@ -593,6 +622,7 @@ export type { SpeechRecognitionStartOptions };
 export type { SpeechRecognitionState };
 export type { SpeechRecognitionEvent };
 export type { TaskType };
+export type { ToolCall };
 export type { string_char_emoji };
 export type { string_business_category_name };
 export type { string_model_name };

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

@@ -9,6 +9,7 @@ import { isValidCsvString } from '../formats/csv/utils/isValidCsvString';
 import { isValidJsonString } from '../formats/json/utils/isValidJsonString';
 import { jsonParse } from '../formats/json/utils/jsonParse';
 import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
+import { PromptString } from '../pipeline/prompt-notation';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
 import { $detectRuntimeEnvironment } from '../utils/environment/$detectRuntimeEnvironment';
@@ -99,6 +100,7 @@ export { isValidCsvString };
 export { isValidJsonString };
 export { jsonParse };
 export { isValidXmlString };
+export { PromptString };
 export { prompt };
 export { promptTemplate };
 export { $detectRuntimeEnvironment };

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

@@ -31,7 +31,7 @@ export type AgentCapability = {
     /**
      * The type of the capability
      */
-    type: 'browser' | 'search-engine' | 'knowledge' | 'time' | 'inheritance' | 'import';
+    type: 'browser' | 'search-engine' | 'knowledge' | 'time' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email';
     /**
      * The label to display for this capability
      */
@@ -108,6 +108,15 @@ export type AgentBasicInformation = {
         question: string | null;
         answer: string;
     }>;
+    /**
+     * Knowledge sources (documents, URLs) used by the agent
+     * This is parsed from KNOWLEDGE commitments
+     * Used for resolving document citations when the agent references sources
+     */
+    knowledgeSources: Array<{
+        url: string;
+        filename: string;
+    }>;
 };
 /**
  * TODO: [🐱‍🚀] Make all properties of `AgentBasicInformation` readonly

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

@@ -0,0 +1,28 @@
+import type { string_agent_url } from '../../types/typeAliases';
+/**
+ * Parsed TEAM teammate entry.
+ *
+ * @private
+ */
+export type TeamTeammate = {
+    url: string_agent_url;
+    label: string;
+    instructions: string;
+};
+/**
+ * Options for parsing TEAM commitment content.
+ *
+ * @private
+ */
+export type ParseTeamCommitmentOptions = {
+    strict?: boolean;
+};
+/**
+ * Parses TEAM commitment content into teammates with instructions.
+ *
+ * @private
+ */
+export declare function parseTeamCommitmentContent(content: string, options?: ParseTeamCommitmentOptions): TeamTeammate[];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -55,7 +55,7 @@ export type BookEditorProps = {
     /**
      * returns the URL of the uploaded file on CDN or storage
      */
-    onFileUpload?(file: File): Promisable<string_knowledge_source_content>;
+    onFileUpload?(file: File, onProgress?: (progress: number_percent) => void): Promisable<string_knowledge_source_content>;
     /**
      * If true, logs verbose debug info to the console and shows additional visual cues
      */

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

@@ -10,4 +10,9 @@ export type AgentChatProps = Omit<LlmChatProps, 'thread' | 'llmTools' | 'initial
      * The agent to chat with
      */
     readonly agent: Agent;
+    /**
+     * Optional mapping of technical tool names to human-readable titles.
+     * e.g., { "web_search": "Searching the web..." }
+     */
+    readonly toolTitles?: Record<string, string>;
 };

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

@@ -0,0 +1,67 @@
+/// <reference types="react" />
+import type { string_url } from '../../../types/typeAliases';
+/**
+ * Agent profile information for chip display
+ */
+export type AgentChipData = {
+    /**
+     * Agent URL (required)
+     */
+    url: string_url;
+    /**
+     * Agent display name/label
+     */
+    label?: string;
+    /**
+     * Agent profile image URL
+     */
+    imageUrl?: string_url;
+    /**
+     * Public URL of the agents server (for generating placeholder images)
+     */
+    publicUrl?: string_url;
+};
+/**
+ * Props for AgentChip component
+ */
+export type AgentChipProps = {
+    /**
+     * Agent data to display
+     */
+    agent: AgentChipData;
+    /**
+     * Whether this is an ongoing interaction (shows spinner)
+     */
+    isOngoing?: boolean;
+    /**
+     * Whether this is clickable (completed state)
+     */
+    isClickable?: boolean;
+    /**
+     * Click handler
+     */
+    onClick?: (event?: React.MouseEvent) => void;
+    /**
+     * Additional CSS class name
+     */
+    className?: string;
+};
+/**
+ * AgentChip component - displays a chip with agent avatar and name
+ *
+ * This component is used to display agent interactions in chat messages.
+ * It fetches the agent profile if needed and displays the agent's avatar and name.
+ *
+ * @example
+ * ```tsx
+ * <AgentChip
+ *   agent={{ url: 'https://agents.example.com/joe', label: 'Joe' }}
+ *   isOngoing={false}
+ *   isClickable={true}
+ *   onClick={() => console.log('clicked')}
+ * />
+ * ```
+ *
+ * @private utility of `ChatMessageItem` component
+ */
+export declare function AgentChip({ agent, isOngoing, isClickable, onClick, className }: AgentChipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { AgentChip } from './AgentChip';
+export type { AgentChipData, AgentChipProps } from './AgentChip';

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

@@ -2,6 +2,7 @@
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
+import { type ParsedCitation } from '../utils/parseCitationsFromContent';
 import type { ChatProps } from './ChatProps';
 /**
  * Props for the `ChatMessageItem` component
@@ -33,11 +34,42 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
      * Called when the create agent button is pressed for book code blocks.
      */
     onCreateAgent?: (bookContent: string) => void;
+    /**
+     * Optional mapping of technical tool names to human-readable titles.
+     * e.g., { "web_search": "Searching the web..." }
+     */
+    toolTitles?: Record<string, string>;
+    /**
+     * Optional metadata about teammates for team tool calls
+     * Maps tool name to agent information
+     */
+    teammates?: TeammatesMap;
+    /**
+     * Called when a tool call chiplet is clicked.
+     */
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    /**
+     * Called when a source citation chip is clicked.
+     */
+    onCitationClick?: (citation: ParsedCitation) => void;
+};
+/**
+ * Metadata for a teammate agent tool.
+ */
+type TeammateMetadata = {
+    url: string;
+    label?: string;
+    instructions?: string;
+    toolName: string;
 };
+/**
+ * Lookup map of teammate metadata by tool name.
+ */
+type TeammatesMap = Record<string, TeammateMetadata>;
 /**
  * Renders a single chat message item with avatar, content, buttons, and rating.
  *
  * @private internal subcomponent of `<Chat>` component
  */
-export declare const ChatMessageItem: import("react").MemoExoticComponent<({ message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onCreateAgent, }: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const ChatMessageItem: import("react").MemoExoticComponent<(props: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

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

@@ -1,11 +1,26 @@
 import type { CSSProperties, ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
+import { Color } from '../../../_packages/color.index';
+import { SpeechRecognition } from '../../../types/SpeechRecognition';
+import { string_color } from '../../../types/typeAliases';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import { string_color } from '../../../types/typeAliases';
-import { Color } from '../../../_packages/color.index';
-import { SpeechRecognition } from '../../../types/SpeechRecognition';
+/**
+ * Interface for sound system that can be passed to Chat component
+ * This allows the chat to trigger sounds without tight coupling
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatSoundSystem = {
+    /**
+     * @@@
+     */
+    play(event: string): Promise<void>;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    toggle(): boolean;
+};
 /**
  * @public exported from `@promptbook/components`
  */
@@ -149,6 +164,26 @@ export type ChatProps = {
      * Keys should match ChatMessage.from values (e.g., 'USER', 'AGENT_{id}', etc.)
      */
     readonly participants?: ReadonlyArray<ChatParticipant>;
+    /**
+     * Optional mapping of technical tool names to human-readable titles.
+     * e.g., { "web_search": "Searching the web..." }
+     */
+    readonly toolTitles?: Record<string, string>;
+    /**
+     * Optional metadata about teammates for team tool calls
+     * Maps tool name to agent information
+     */
+    readonly teammates?: Record<string, {
+        url: string;
+        label?: string;
+        instructions?: string;
+        toolName: string;
+    }>;
+    /**
+     * Optional callback to create a new agent from the template.
+     * If provided, renders the [Create Agent] button for book code blocks.
+     */
+    onCreateAgent?: (bookContent: string) => void;
     /**
      * Optional callback for handling user feedback on messages
      * When provided, star rating buttons (1-5 stars) will be displayed next to each message
@@ -185,10 +220,56 @@ export type ChatProps = {
      */
     isCopyButtonEnabled?: boolean;
     /**
-     * Optional callback for creating an agent from a book code block.
-     * When provided, "Create Agent" buttons will be shown for book code blocks.
+     * Called when a tool call chiplet is clicked.
      */
-    onCreateAgent?: (bookContent: string) => void;
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    /**
+     * Visual style of the chat component
+     */
+    readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    /**
+     * Optional array of effect configurations for chat animations
+     * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages
+     *
+     * Example:
+     * ```typescript
+     * [
+     *   { trigger: '🎉', effectType: 'CONFETTI' },
+     *   { trigger: /❤️|💙|💚/, effectType: 'HEARTS' }
+     * ]
+     * ```
+     */
+    readonly effectConfigs?: ReadonlyArray<{
+        trigger: string | RegExp;
+        effectType: string;
+    }>;
+    /**
+     * Optional sound system for playing chat sounds
+     * When provided, enables sound effects for message events, button clicks, and visual effects
+     *
+     * The sound system should implement the ChatSoundSystem interface:
+     * - play(event: string): Plays a sound for the given event
+     * - isEnabled(): Returns whether sounds are enabled
+     * - setEnabled(enabled: boolean): Enables or disables sounds
+     * - toggle(): Toggles sound on/off and returns the new state
+     *
+     * Supported events:
+     * - 'message_send': When user sends a message
+     * - 'message_receive': When agent sends a message
+     * - 'message_typing': When agent is typing/thinking
+     * - 'button_click': When any button is clicked
+     * - 'effect_confetti': When confetti effect is triggered
+     * - 'effect_hearts': When hearts effect is triggered
+     *
+     * @example
+     * ```typescript
+     * import { createDefaultSoundSystem } from '@/utils/sound/createDefaultSoundSystem';
+     *
+     * const soundSystem = createDefaultSoundSystem();
+     * <Chat soundSystem={soundSystem} ... />
+     * ```
+     */
+    readonly soundSystem?: ChatSoundSystem;
 };
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)

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

@@ -0,0 +1,23 @@
+import type { ChatSoundSystem } from './ChatProps';
+/**
+ * Props for the ChatSoundToggle component
+ */
+export type ChatSoundToggleProps = {
+    /**
+     * The sound system instance
+     */
+    soundSystem: ChatSoundSystem;
+    /**
+     * Optional CSS class name
+     */
+    className?: string;
+};
+/**
+ * ChatSoundToggle component
+ *
+ * Renders a toggle button/checkbox to enable/disable chat sounds.
+ * The state is persisted in localStorage via the SoundSystem.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatSoundToggle(props: ChatSoundToggleProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+/**
+ * Renders a nice clock icon with a specific time.
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare function ClockIcon({ date, size }: {
+    date: Date;
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;