@promptbook/javascript 0.111.0-4 → 0.112.0-11

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

@@ -0,0 +1,88 @@
+/// <reference types="react" />
+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
+ *
+ * @private props for internal subcomponent
+ */
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'participants'> & {
+    message: ChatMessage;
+    participant: ChatParticipant | undefined;
+    isLastMessage: boolean;
+    setExpandedMessageId: (value: id | null) => void;
+    isExpanded: boolean;
+    currentRating: number;
+    handleRating: (message: ChatMessage, rating: number) => void;
+    mode: 'LIGHT' | 'DARK';
+    /**
+     * Enables the copy button for this message bubble.
+     */
+    isCopyButtonEnabled?: boolean;
+    /**
+     * Enables the feedback (rating) UI for this message bubble.
+     */
+    isFeedbackEnabled?: boolean;
+    /**
+     * Called when the copy button is pressed.
+     */
+    onCopy?: () => void;
+    /**
+     * 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;
+    /**
+     * Optional cached metadata keyed by TEAM tool names to enrich tool call chips.
+     */
+    teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    /**
+     * 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;
+    /**
+     * Optional sound system for triggering tool chip events.
+     */
+    soundSystem?: ChatProps['soundSystem'];
+    /**
+     * Controls whether the play button below the message is shown.
+     */
+    isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+    readonly elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
+};
+/**
+ * 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<(props: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

package/esm/src/book-components/Chat/Chat/ChatMessageList.d.ts

@@ -0,0 +1,45 @@
+import type { UIEvent } from 'react';
+import type { Promisable } from 'type-fest';
+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 Chat message list container.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatMessageListProps = {
+    messages: ReadonlyArray<ChatMessage>;
+    participants: ReadonlyArray<ChatParticipant>;
+    expandedMessageId: id | null;
+    messageRatings: Map<id, number>;
+    setExpandedMessageId: (value: id | null) => void;
+    handleRating: (message: ChatMessage, rating: number) => void;
+    mode: 'LIGHT' | 'DARK';
+    isCopyButtonEnabled?: boolean;
+    isFeedbackEnabled?: boolean;
+    onCopy?: () => void;
+    onMessage?: (messageContent: string) => Promisable<void>;
+    onActionButton?: ChatProps['onActionButton'];
+    onCreateAgent?: (bookContent: string) => void;
+    toolTitles?: Record<string, string>;
+    teammates?: ChatProps['teammates'];
+    teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    onCitationClick?: (citation: ParsedCitation) => void;
+    soundSystem?: ChatProps['soundSystem'];
+    isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
+    elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
+    setChatMessagesElement: (element: HTMLDivElement | null) => void;
+    onScroll: (event: UIEvent<HTMLDivElement>) => void;
+    chatMessagesClassName?: string;
+    hasActions: boolean;
+};
+/**
+ * Renders the list of chat messages.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatMessageList(props: ChatMessageListProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,366 @@
+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 type { AgentChipData } from '../AgentChip/AgentChip';
+/**
+ * Response data returned by the optional `onFeedback` handler.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatFeedbackResponse = {
+    /**
+     * Optional text that should be shown to the user after the feedback is saved.
+     */
+    readonly message?: string;
+};
+/**
+ * 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;
+    /**
+     * Optional helpers for haptic vibration state.
+     */
+    isVibrationEnabled?(): boolean;
+    setVibrationEnabled?(enabled: boolean): void;
+    toggleVibration?(): boolean;
+    /**
+     * Optional vibration helper to stay in sync with sound events.
+     */
+    vibrate?(event: string): void;
+};
+/**
+ * Supported primary Enter-key behaviors for the chat composer.
+ *
+ * @private internal helper of `<Chat/>`
+ */
+type ChatEnterBehavior = 'SEND' | 'NEWLINE';
+/**
+ * Async resolver used when the host app wants to decide Enter behavior lazily.
+ *
+ * Returning `null` / `undefined` keeps the current composer text unchanged.
+ *
+ * @private internal helper of `<Chat/>`
+ */
+type ChatEnterBehaviorResolver = () => Promisable<ChatEnterBehavior | null | undefined>;
+/**
+ * @public exported from `@promptbook/components`
+ */
+export type ChatProps = {
+    /**
+     * Optional callback to create a new agent from the template.
+     * If provided, renders the [Use this template] button.
+     */
+    onUseTemplate?(): void;
+    /**
+     * The title of the chat
+     */
+    readonly title?: string;
+    /**
+     * Messages to render - they are rendered as they are
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * Called every time the user types or dictated a message
+     */
+    onChange?(messageContent: string): void;
+    /**
+     * Called when user sends a message
+     *
+     * Note: You must handle the message yourself and add it to the `messages` array
+     *
+     * - When set, the send textarea and button will be shown
+     * - When undefined, the chat has no input and is read-only showing only the messages
+     */
+    onMessage?(messageContent: string): Promisable<void>;
+    /**
+     * Called when user clicks a quick action button parsed from message markdown.
+     *
+     * The callback is responsible for running the browser-side action and may reject
+     * to keep the button available for another attempt.
+     */
+    onActionButton?(code: string): Promisable<void>;
+    /**
+     * Optional callback
+     *
+     * - When set, button for resetting chat will be shown
+     * - When undefined, no reset button will be shown
+     */
+    onReset?(): Promisable<void>;
+    /**
+     * Controls whether the reset button asks for native browser confirmation before calling `onReset`.
+     *
+     * @default true
+     */
+    readonly resetRequiresConfirmation?: boolean;
+    /**
+     * Determines whether the voice recognition button is rendered
+     */
+    readonly isVoiceRecognitionButtonShown?: boolean;
+    /**
+     * Speech recognition provider
+     */
+    readonly speechRecognition?: SpeechRecognition;
+    /**
+     * Optional language tag (BCP 47) to force speech recognition to use a specific language.
+     * When not provided, the browser preferences are used with a fallback to `en-US`.
+     */
+    readonly speechRecognitionLanguage?: string;
+    /**
+     * Controls whether message audio playback is available.
+     *
+     * When `false`, the ElevenLabs play/pause controls are hidden and no TTS requests are initiated.
+     *
+     * @default true
+     */
+    readonly isSpeechPlaybackEnabled?: boolean;
+    /**
+     * Optional ElevenLabs voice ID that should be used when reading messages aloud.
+     * When not provided, the server uses the default configured voice.
+     */
+    readonly elevenLabsVoiceId?: string;
+    /**
+     * Optional placeholder message for the textarea
+     *
+     * @default "Write a message"
+     */
+    readonly placeholderMessageContent?: string;
+    /**
+     * Optional preset message in chat
+     */
+    readonly defaultMessage?: string;
+    /**
+     * Determines which action the plain `Enter` key triggers in the composer.
+     *
+     * `Ctrl+Enter` automatically performs the inverse action.
+     * `Shift+Enter` always inserts a new line.
+     *
+     * @default 'SEND'
+     */
+    readonly enterBehavior?: ChatEnterBehavior;
+    /**
+     * Optional async hook used when `enterBehavior` is not known yet.
+     *
+     * It is invoked after the user presses plain `Enter` and can resolve to the
+     * preferred behavior without coupling `<Chat/>` to any specific persistence UI.
+     *
+     * Returning `null` / `undefined` leaves the text unchanged.
+     */
+    readonly resolveEnterBehavior?: ChatEnterBehaviorResolver;
+    /**
+     * List of tasks that are currently in progress that should be displayed
+     */
+    readonly tasksProgress?: Array<{
+        id: string;
+        name: string;
+        progress?: number;
+    }>;
+    /**
+     * Content to be shown inside the chat bar in head
+     * If not provided, the chat bar will not be rendered
+     */
+    readonly children?: ReactNode;
+    /**
+     * Extra action buttons/elements rendered in the actions toolbar
+     * (next to reset / template buttons). Keeps consumers DRY when
+     * adding feature–specific controls (e.g. Pause / Resume in MockedChat).
+     */
+    readonly extraActions?: ReactNode;
+    /**
+     * Optional container to render the actions into (using React Portal).
+     * If provided, the actions toolbar will be rendered inside this element
+     * instead of its default position within the chat.
+     */
+    readonly actionsContainer?: HTMLElement | null;
+    /**
+     * Color of the action buttons (send, reset, voice, etc.)
+     */
+    readonly buttonColor?: string_color | Color;
+    /**
+     * Optional CSS class name which will be added to root <div/> element
+     */
+    readonly className?: string;
+    /**
+     * Optional CSS style which will be added to root <div/> element
+     */
+    readonly style?: CSSProperties;
+    /**
+     * Voice call props - when provided, voice call button will be shown
+     */
+    readonly voiceCallProps?: {
+        selectedModel: string;
+        providerClients: Map<string, unknown>;
+        currentPersonaContent?: string;
+        onVoiceMessage?: (content: string, isVoiceCall: boolean) => void;
+        onAssistantVoiceResponse?: (content: string, isVoiceCall: boolean) => void;
+        onVoiceCallStateChange?: (isVoiceCalling: boolean) => void;
+    };
+    /**
+     * Indicates whether a voice call is currently active
+     */
+    readonly isVoiceCalling?: boolean;
+    /**
+     * Whether experimental features are enabled (required for voice calling)
+     */
+    readonly isExperimental?: boolean;
+    /**
+     * Whether the save button is enabled and shown
+     */
+    readonly isSaveButtonEnabled?: boolean;
+    /**
+     * List of formats in which the chat can be saved/exported
+     *
+     * @default * All supported formats (see `string_chat_format_name` type)
+     */
+    readonly saveFormats?: Array<string_chat_format_name>;
+    /**
+     * Is the writing textarea automatically focused?
+     *
+     * @default true on Desktop false on mobile (to prevent mobile keyboard from popping up)
+     */
+    readonly isFocusedOnLoad?: boolean;
+    /**
+     * Indicates whether the text shown in chat should be post-processed by removing AI artifacts and making it more "human-like" and "promptbook-like"
+     *
+     * @default true
+     */
+    readonly isAiTextHumanizedAndPromptbookified?: boolean;
+    /**
+     * Optional markdown header to include at the top of exported files.
+     * Example: "## Discussion Topic\n\nSome topic here"
+     */
+    readonly exportHeaderMarkdown?: string;
+    /**
+     * Optional mapping of participant IDs (message.from) to display metadata for exports.
+     * 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 cached agent metadata keyed by TEAM tool names to improve chip rendering.
+     */
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
+    /**
+     * 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
+     *
+     * @param feedback - Object containing the feedback data
+     * @param feedback.message - The message being rated
+     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.textRating - Optional text feedback/note from user
+     * @param feedback.chatThread - Complete chat thread as string
+     * @param feedback.expectedAnswer - Optional expected answer provided by user
+     * @param feedback.url - Current page URL where feedback was given
+     */
+    onFeedback?(feedback: {
+        message: ChatMessage;
+        rating: number;
+        textRating: string;
+        chatThread: string;
+        expectedAnswer: string | null;
+        url: string;
+    }): Promisable<void>;
+    /**
+     * Optional callback for handling file uploads
+     * When provided, enables file upload functionality via drag-and-drop and file button
+     * The callback should process the file and return text content to be inserted into the message
+     *
+     * @param file - The uploaded file
+     * @returns Promise or string with the text content to insert into the chat message
+     */
+    onFileUpload?(file: File): Promisable<string>;
+    /**
+     * Enables the copy button for each message bubble.
+     * When true, a copy button appears in the top-right of each message.
+     * @default true
+     */
+    isCopyButtonEnabled?: boolean;
+    /**
+     * Called when a tool call chiplet is clicked.
+     */
+    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;
+};
+export {};
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/esm/src/book-components/Chat/Chat/ChatToolCallModal.d.ts

@@ -0,0 +1,34 @@
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { AgentChipData } from '../AgentChip/AgentChip';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Props for the tool call details modal.
+ *
+ * @private component of `<Chat/>`
+ */
+export type ChatToolCallModalProps = {
+    isOpen: boolean;
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number] | null;
+    /**
+     * Stable identity of the selected tool call.
+     *
+     * Used so live streamed snapshots do not reset the current modal view.
+     */
+    toolCallIdentity?: string | null;
+    onClose: () => void;
+    toolTitles?: Record<string, string>;
+    agentParticipant?: ChatParticipant;
+    buttonColor: WithTake<Color>;
+    /**
+     * Optional cached team agent metadata keyed by TEAM tool name.
+     */
+    teamAgentProfiles?: Record<string, AgentChipData>;
+};
+/**
+ * Modal that renders rich tool call details for chat chiplets.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatToolCallModal(props: ChatToolCallModalProps): import("react/jsx-runtime").JSX.Element | null;

package/esm/src/book-components/Chat/Chat/TeamToolCallModalContent.d.ts

@@ -0,0 +1,32 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import { type TeamToolCallSummary, type TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { AgentProfileData } from '../utils/loadAgentProfile';
+import type { TeamToolResult } from '../utils/toolCallParsing';
+/**
+ * Rendering options for TEAM tool-call modal content.
+ *
+ * @private function of ChatToolCallModal
+ */
+type TeamToolCallModalContentOptions = {
+    teamResult: TeamToolResult;
+    toolCallDate: Date | null;
+    teamToolCallSummary: TeamToolCallSummary;
+    selectedTeamToolCall: TransitiveToolCall | null;
+    onSelectTeamToolCall: (toolCall: TransitiveToolCall) => void;
+    onClearSelectedTeamToolCall: () => void;
+    teamProfiles: Record<string, AgentProfileData>;
+    toolTitles?: Record<string, string>;
+    agentParticipant?: ChatParticipant;
+    buttonColor: WithTake<Color>;
+};
+/**
+ * Renders TEAM conversation details, nested actions, and citations.
+ *
+ * @param options - TEAM modal rendering options.
+ * @private function of ChatToolCallModal
+ */
+export declare function TeamToolCallModalContent(options: TeamToolCallModalContentOptions): ReactElement;
+export {};

package/esm/src/book-components/Chat/Chat/chatCssClassNames.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Stable global CSS class names exposed by chat components for host-level styling.
+ *
+ * These names are intentionally centralized so both rendering code and
+ * host-application tooling (for example Agents Server custom CSS editor) can stay DRY.
+ *
+ * @private Internal chat styling contract for Promptbook-host applications.
+ */
+export declare const chatCssClassNames: {
+    readonly chat: "agent-chat";
+    readonly chatMainFlow: "agent-chat-main-flow";
+    readonly chatMessages: "chat-messages";
+    readonly chatMessage: "chat-message";
+    readonly userMessage: "user-message";
+    readonly agentResponse: "agent-response";
+    readonly messageStack: "chat-message-stack";
+    readonly messageContent: "chat-message-content";
+    readonly messageAvatar: "chat-message-avatar";
+    readonly userAvatar: "user-avatar";
+    readonly agentAvatar: "agent-avatar";
+    readonly chatInput: "chat-input";
+    readonly inputContainer: "chat-input-container";
+    readonly inputTextarea: "chat-input-textarea";
+    readonly inputAttachmentButton: "chat-input-attachment-button";
+    readonly inputVoiceButton: "chat-input-voice-button";
+    readonly inputSendButton: "chat-input-send-button";
+};
+/**
+ * Human-readable descriptions for globally available chat CSS hooks.
+ *
+ * @private Internal chat styling contract for Promptbook-host applications.
+ */
+export declare const chatCssClassDescriptions: Record<keyof typeof chatCssClassNames, string>;
+/**
+ * Resolves legacy global chat classes that already existed in rendered markup.
+ *
+ * @param suffix - Legacy chat class suffix.
+ * @returns Legacy global class name prefixed with `chat-`.
+ * @private Internal helper for backward-compatible chat selectors.
+ */
+export declare function getChatCssClassName(suffix: string): string;

package/esm/src/book-components/Chat/Chat/renderAdvancedToolCallDetails.d.ts

@@ -0,0 +1,44 @@
+import { type ReactElement } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Rendering options for advanced raw payload details.
+ *
+ * @private function of ChatToolCallModal
+ */
+type AdvancedToolCallDetailsOptions = {
+    /**
+     * Tool call currently selected in the modal.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Optional mapping of tool titles.
+     */
+    toolTitles?: Record<string, string>;
+};
+/**
+ * Renders a technical view with raw tool input/output payloads.
+ *
+ * @param options - Rendering options for advanced mode.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderAdvancedToolCallDetails(options: AdvancedToolCallDetailsOptions): ReactElement;
+/**
+ * Builds a markdown advanced report for one tool call.
+ *
+ * The report includes the same payload sections rendered in the advanced modal,
+ * so copied/saved output always mirrors the visible technical details.
+ *
+ * @param options - Rendering options for advanced mode.
+ * @returns Markdown report content.
+ * @private function of ChatToolCallModal
+ */
+export declare function createAdvancedToolCallReportMarkdown(options: AdvancedToolCallDetailsOptions): string;
+/**
+ * Creates a stable filename for downloaded advanced tool-call reports.
+ *
+ * @param toolCall - Tool call currently selected in the modal.
+ * @returns Safe markdown filename.
+ * @private function of ChatToolCallModal
+ */
+export declare function createAdvancedToolCallReportFilename(toolCall: NonNullable<ChatMessage['toolCalls']>[number]): string;
+export {};

package/esm/src/book-components/Chat/Chat/renderToolCallDetails.d.ts

@@ -0,0 +1,36 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Options for rendering a tool call detail view.
+ *
+ * @private utility of `<ChatToolCallModal/>`
+ */
+type ToolCallDetailsOptions = {
+    /**
+     * Tool call to render.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Optional mapping of tool titles.
+     */
+    toolTitles?: Record<string, string>;
+    /**
+     * Agent participant metadata for avatar details.
+     */
+    agentParticipant?: ChatParticipant;
+    /**
+     * Chat button color for fallback styling.
+     */
+    buttonColor: WithTake<Color>;
+};
+/**
+ * Renders the detail view for a single tool call.
+ *
+ * @param options - Rendering options for the tool call.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallDetails(options: ToolCallDetailsOptions): ReactElement;
+export {};