@promptbook/utils 0.112.0-30 → 0.112.0-32

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-30';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-32';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -17,7 +17,10 @@ import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChat
 import { Chat } from '../book-components/Chat/Chat/Chat';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatVisualMode } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatFeedbackTranslations } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatUiTranslations } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatTimingTranslations } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -95,7 +98,10 @@ export type { AgentChatProps };
 export { Chat };
 export type { ChatFeedbackResponse };
 export type { ChatFeedbackMode };
+export type { ChatVisualMode };
 export type { ChatFeedbackTranslations };
+export type { ChatUiTranslations };
+export type { ChatTimingTranslations };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export { ChatSoundToggle };

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

@@ -18,7 +18,10 @@ import type { AgentChipData } from '../book-components/Chat/AgentChip/AgentChip'
 import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip';
 import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatFeedbackMode } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatVisualMode } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatFeedbackTranslations } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatUiTranslations } from '../book-components/Chat/Chat/ChatProps';
+import type { ChatTimingTranslations } from '../book-components/Chat/Chat/ChatProps';
 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';
@@ -443,7 +446,10 @@ export type { AgentChipData };
 export type { AgentChipProps };
 export type { ChatFeedbackResponse };
 export type { ChatFeedbackMode };
+export type { ChatVisualMode };
 export type { ChatFeedbackTranslations };
+export type { ChatUiTranslations };
+export type { ChatTimingTranslations };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export type { ChatSoundToggleProps };

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

@@ -1,4 +1,5 @@
 import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+import type { TeammateProfile } from './TeammateProfileResolver';
 /**
  * Resolves compact agent references that appear inside FROM, IMPORT, and TEAM commitments.
  *
@@ -15,4 +16,14 @@ export type AgentReferenceResolver = {
      * @param content - Original payload of the commitment
      */
     resolveCommitmentContent(commitmentType: BookCommitment, content: string): Promise<string>;
+    /**
+     * Optional: returns the actual human-readable name and description for a teammate agent URL.
+     *
+     * When implemented, this enriches TEAM tool definitions with the agent's real name and
+     * persona description instead of technical IDs derived from the URL path.
+     *
+     * @param url - Canonical teammate URL from the resolved TEAM commitment content.
+     * @returns Agent profile or `null` when the URL is not resolvable locally.
+     */
+    resolveTeammateProfile?: (url: string) => Promise<TeammateProfile | null>;
 };

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

@@ -1,5 +1,6 @@
 import type { AgentReferenceResolver } from './AgentReferenceResolver';
 import type { InlineKnowledgeSourceUploader } from '../../utils/knowledge/inlineKnowledgeSource';
+import type { TeammateProfileResolver } from './TeammateProfileResolver';
 /**
  * Options for `createAgentModelRequirements` and `createAgentModelRequirementsWithCommitments`.
  *
@@ -14,4 +15,11 @@ export type CreateAgentModelRequirementsOptions = {
      * Optional hook used to upload inline knowledge files before finalizing the requirements.
      */
     readonly inlineKnowledgeSourceUploader?: InlineKnowledgeSourceUploader;
+    /**
+     * Optional resolver that provides actual agent names and descriptions for teammate URLs.
+     *
+     * When provided, TEAM tools are created with the agent's real human-readable name and
+     * persona description rather than technical IDs derived from URL path segments.
+     */
+    readonly teammateProfileResolver?: TeammateProfileResolver;
 };

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

@@ -0,0 +1,33 @@
+/**
+ * Profile data for a teammate agent resolved from its source or backend.
+ *
+ * @private internal type for TEAM commitment profile enrichment
+ */
+export type TeammateProfile = {
+    /**
+     * The human-readable name of the agent.
+     */
+    readonly agentName: string;
+    /**
+     * Short description of what the agent does, from its PERSONA commitment.
+     */
+    readonly personaDescription: string | null;
+};
+/**
+ * Resolves profile data for teammate agents referenced in TEAM commitments.
+ *
+ * Implementations are expected to return the actual human-readable name and
+ * description of each teammate agent identified by URL, so TEAM tools can be
+ * created with meaningful labels and descriptions rather than technical IDs.
+ *
+ * @private internal type for TEAM commitment profile enrichment
+ */
+export type TeammateProfileResolver = {
+    /**
+     * Returns profile data for the given teammate agent URL.
+     *
+     * @param url - Canonical teammate URL from the resolved TEAM commitment content.
+     * @returns Teammate profile or `null` when the URL cannot be resolved locally.
+     */
+    resolveTeammateProfile(url: string): Promise<TeammateProfile | null>;
+};

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

@@ -1,12 +1,12 @@
 /**
- * Builds a deterministic TEAM tool name from teammate identity.
+ * Builds a deterministic TEAM tool name from the teammate label.
  *
- * The readable part is based on teammate label while the hash suffix
- * keeps uniqueness and stable mapping for the underlying teammate URL.
+ * The tool name is derived solely from the human-readable label so that it
+ * remains stable and predictable regardless of internal technical identifiers.
  *
- * @param teammateUrl - Canonical teammate URL used at runtime.
- * @param teammateLabel - Human-readable teammate label.
- * @returns Deterministic TEAM tool name.
+ * @param _teammateUrl - Canonical teammate URL (kept for API compatibility, not used).
+ * @param teammateLabel - Human-readable teammate label used as the basis for the name.
+ * @returns TEAM tool name derived from the label.
  * @private internal utility of TEAM commitments and chat UI mapping
  */
-export declare function createTeamToolName(teammateUrl: string, teammateLabel?: string): string;
+export declare function createTeamToolName(_teammateUrl: string, teammateLabel?: string): string;

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

@@ -3,6 +3,7 @@ import type { Promisable } from 'type-fest';
 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 { ChatUiTranslations } from './ChatProps';
 /**
  * Props for the Chat actions toolbar.
  *
@@ -25,6 +26,10 @@ export type ChatActionsBarProps = {
      * Disables action interactions while scroll is active.
      */
     shouldDisableActions: boolean;
+    /**
+     * Optional localized labels for Chat UI strings such as button labels.
+     */
+    chatUiTranslations?: ChatUiTranslations;
     onButtonClick: (handler?: (event: MouseEvent<HTMLButtonElement>) => void) => (event: MouseEvent<HTMLButtonElement>) => void;
 };
 /**

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

@@ -9,7 +9,7 @@ import type { ChatProps } from './ChatProps';
  *
  * @private props for internal subcomponent
  */
-type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'participants'> & {
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'onQuickMessageButton' | 'participants'> & {
     message: ChatMessage;
     participant: ChatParticipant | undefined;
     isLastMessage: boolean;
@@ -34,6 +34,14 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'pa
      * Optional localized labels used by feedback controls.
      */
     feedbackTranslations?: ChatProps['feedbackTranslations'];
+    /**
+     * Optional localized labels used by timestamp metadata.
+     */
+    timingTranslations?: ChatProps['timingTranslations'];
+    /**
+     * Optional moment locale used to format message timestamps.
+     */
+    chatLocale?: ChatProps['chatLocale'];
     /**
      * Called when the copy button is pressed.
      */
@@ -56,6 +64,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'pa
      * Optional cached metadata keyed by TEAM tool names to enrich tool call chips.
      */
     teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    /**
+     * Controls whether assistant replies render as bubbles or article blocks.
+     */
+    CHAT_VISUAL_MODE?: ChatProps['CHAT_VISUAL_MODE'];
     /**
      * Called when a tool call chiplet is clicked.
      */
@@ -73,6 +85,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'pa
      */
     isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
     readonly elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
+    /**
+     * Optional localized labels for Chat UI elements such as lifecycle badges.
+     */
+    chatUiTranslations?: ChatProps['chatUiTranslations'];
 };
 /**
  * Metadata for a teammate agent tool.

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

@@ -1,2 +1,2 @@
 /** @jest-environment jsdom */
-export {};
+import 'moment/locale/cs';

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

@@ -28,18 +28,32 @@ export type ChatMessageListProps = {
      * Optional localized labels used by feedback controls.
      */
     feedbackTranslations?: ChatProps['feedbackTranslations'];
+    /**
+     * Optional localized labels used by timestamp metadata.
+     */
+    timingTranslations?: ChatProps['timingTranslations'];
+    /**
+     * Optional moment locale used to format message timestamps.
+     */
+    chatLocale?: ChatProps['chatLocale'];
     onCopy?: () => void;
     onMessage?: (messageContent: string) => Promisable<void>;
     onActionButton?: ChatProps['onActionButton'];
+    onQuickMessageButton?: ChatProps['onQuickMessageButton'];
     onCreateAgent?: (bookContent: string) => void;
     toolTitles?: Record<string, string>;
     teammates?: ChatProps['teammates'];
     teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    CHAT_VISUAL_MODE?: ChatProps['CHAT_VISUAL_MODE'];
     onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
     onCitationClick?: (citation: ParsedCitation) => void;
     soundSystem?: ChatProps['soundSystem'];
     isSpeechPlaybackEnabled?: ChatProps['isSpeechPlaybackEnabled'];
     elevenLabsVoiceId?: ChatProps['elevenLabsVoiceId'];
+    /**
+     * Optional localized labels for Chat UI elements such as lifecycle badges.
+     */
+    chatUiTranslations?: ChatProps['chatUiTranslations'];
     setChatMessagesElement: (element: HTMLDivElement | null) => void;
     onScroll: (event: UIEvent<HTMLDivElement>) => void;
     chatMessagesClassName?: string;

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

@@ -24,6 +24,15 @@ export type ChatFeedbackResponse = {
  * @public exported from `@promptbook/components`
  */
 export type ChatFeedbackMode = 'off' | 'stars' | 'report_issue';
+/**
+ * Visual presentation mode used for chat messages.
+ *
+ * - `BUBBLE_MODE`: user and agent messages render as bubbles.
+ * - `ARTICLE_MODE`: user messages stay as bubbles; agent messages render as seamless article blocks.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatVisualMode = 'BUBBLE_MODE' | 'ARTICLE_MODE';
 /**
  * Optional text overrides for feedback UI copy.
  *
@@ -103,6 +112,257 @@ export type ChatFeedbackTranslations = {
      */
     readonly feedbackErrorMessage?: string;
 };
+/**
+ * Optional text overrides for general Chat UI strings such as button labels, lifecycle
+ * state badges, tool call modal controls, and the default input placeholder.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatUiTranslations = {
+    /**
+     * Default placeholder shown in the message input when no custom placeholder is provided.
+     * @default "Write a message..."
+     */
+    readonly inputPlaceholder?: string;
+    /**
+     * Label for the "Save" button in the chat actions bar.
+     * @default "Save"
+     */
+    readonly saveButtonLabel?: string;
+    /**
+     * Label for the "New chat" button in the chat actions bar.
+     * @default "New chat"
+     */
+    readonly newChatButtonLabel?: string;
+    /**
+     * Lifecycle badge label for messages being sent by the user.
+     * @default "Sending"
+     */
+    readonly lifecycleSending?: string;
+    /**
+     * Lifecycle badge label for queued messages.
+     * @default "Queued"
+     */
+    readonly lifecycleQueued?: string;
+    /**
+     * Lifecycle badge label for running messages.
+     * @default "Running"
+     */
+    readonly lifecycleRunning?: string;
+    /**
+     * Lifecycle badge label for failed messages.
+     * @default "Failed"
+     */
+    readonly lifecycleFailed?: string;
+    /**
+     * Lifecycle badge label for cancelled messages.
+     * @default "Cancelled"
+     */
+    readonly lifecycleCancelled?: string;
+    /**
+     * Lifecycle badge label for completed messages.
+     * @default "Completed"
+     */
+    readonly lifecycleCompleted?: string;
+    /**
+     * Accessible label for the tool call details modal dialog.
+     * @default "Tool call details"
+     */
+    readonly toolCallModalTitle?: string;
+    /**
+     * Accessible label for the close button in the tool call details modal.
+     * @default "Close tool call details"
+     */
+    readonly toolCallModalCloseLabel?: string;
+    /**
+     * Label for the "Copy" button in the tool call details modal footer.
+     * @default "Copy"
+     */
+    readonly toolCallModalCopyLabel?: string;
+    /**
+     * Label for the "Save" button in the tool call details modal footer.
+     * @default "Save"
+     */
+    readonly toolCallModalSaveLabel?: string;
+    /**
+     * Label for switching to the advanced view in the tool call details modal.
+     * @default "Advanced"
+     */
+    readonly toolCallModalAdvancedLabel?: string;
+    /**
+     * Label for switching back to the simple view in the tool call details modal.
+     * @default "Simple"
+     */
+    readonly toolCallModalSimpleLabel?: string;
+    /**
+     * Title shown when a timeout has been successfully scheduled.
+     * @default "Timeout scheduled"
+     */
+    readonly toolCallTimeoutTitle?: string;
+    /**
+     * Title shown when a timeout has been cancelled.
+     * @default "Timeout cancelled"
+     */
+    readonly toolCallTimeoutCancelledTitle?: string;
+    /**
+     * Title shown when a timeout status update is received.
+     * @default "Timeout update"
+     */
+    readonly toolCallTimeoutUpdateTitle?: string;
+    /**
+     * Label for the "Cancel" quick-action button inside the timeout modal.
+     * @default "Cancel"
+     */
+    readonly toolCallTimeoutCancelButton?: string;
+    /**
+     * Label for the "Snooze" quick-action button inside the timeout modal.
+     * @default "Snooze"
+     */
+    readonly toolCallTimeoutSnoozeButton?: string;
+    /**
+     * Label for the "View advanced" quick-action button inside the timeout modal.
+     * @default "View advanced"
+     */
+    readonly toolCallTimeoutViewAdvancedButton?: string;
+    /**
+     * Message shown in the timeout modal when presentation data is still loading.
+     * @default "Timeout details are still loading."
+     */
+    readonly toolCallTimeoutLoadingMessage?: string;
+    /**
+     * Message shown in the timeout modal when the scheduled time is unavailable.
+     * @default "Scheduled time is unavailable."
+     */
+    readonly toolCallTimeoutUnavailableMessage?: string;
+    /**
+     * Label prefix for the due date line in the timeout modal (e.g. "Date: 1/1/2025").
+     * @default "Date:"
+     */
+    readonly toolCallTimeoutDateLabel?: string;
+    /**
+     * Label prefix for the message line in the timeout modal.
+     * @default "Message:"
+     */
+    readonly toolCallTimeoutMessageLabel?: string;
+    /**
+     * Label prefix for the timezone line in the timeout modal.
+     * @default "Timezone:"
+     */
+    readonly toolCallTimeoutTimezoneLabel?: string;
+    /**
+     * Template used for timeout chips, for example `"Timeout: {time}"`.
+     * @default "Timeout: {time}"
+     */
+    readonly toolCallTimeoutChipLabel?: string;
+    /**
+     * Chip text used when a timeout has been cancelled.
+     * @default "Timeout cancelled"
+     */
+    readonly toolCallTimeoutChipCancelledLabel?: string;
+    /**
+     * Chip text used when a timeout is already inactive.
+     * @default "Timeout inactive"
+     */
+    readonly toolCallTimeoutChipInactiveLabel?: string;
+    /**
+     * Chip text used when a timeout status update is received.
+     * @default "Timeout update"
+     */
+    readonly toolCallTimeoutChipUpdatedLabel?: string;
+    /**
+     * Chip text used when no specific timeout time is available yet.
+     * @default "Timeout scheduled"
+     */
+    readonly toolCallTimeoutChipFallbackLabel?: string;
+    /**
+     * Primary timeout summary template shown in the modal, for example `"Scheduled for {time}."`.
+     * @default "Scheduled for {time}."
+     */
+    readonly toolCallTimeoutPrimaryScheduledLabel?: string;
+    /**
+     * Secondary timeout summary template shown in the modal, for example `"Will retry in {duration}."`.
+     * @default "Will retry in {duration}."
+     */
+    readonly toolCallTimeoutSecondaryDurationLabel?: string;
+    /**
+     * Primary timeout summary shown after cancellation.
+     * @default "The timeout has been cancelled."
+     */
+    readonly toolCallTimeoutPrimaryCancelledLabel?: string;
+    /**
+     * Primary timeout summary shown when the timeout is already inactive.
+     * @default "This timeout was already inactive."
+     */
+    readonly toolCallTimeoutPrimaryInactiveLabel?: string;
+    /**
+     * Primary timeout summary shown for generic timeout updates.
+     * @default "The timeout status has been updated."
+     */
+    readonly toolCallTimeoutPrimaryUpdatedLabel?: string;
+    /**
+     * Primary timeout summary shown when only limited data is available.
+     * @default "The timeout has been scheduled."
+     */
+    readonly toolCallTimeoutPrimaryFallbackLabel?: string;
+    /**
+     * Accessible label for the timeout quick-action button group.
+     * @default "Timeout quick actions"
+     */
+    readonly toolCallTimeoutActionGroupLabel?: string;
+    /**
+     * Accessible label for the "Cancel" timeout quick action.
+     * @default "Cancel timeout"
+     */
+    readonly toolCallTimeoutCancelAriaLabel?: string;
+    /**
+     * Accessible label for the "Snooze" timeout quick action.
+     * @default "Snooze timeout"
+     */
+    readonly toolCallTimeoutSnoozeAriaLabel?: string;
+    /**
+     * Accessible label for the "View advanced" timeout quick action.
+     * @default "View advanced timeout details"
+     */
+    readonly toolCallTimeoutViewAdvancedAriaLabel?: string;
+    /**
+     * Header title shown in the time-check modal.
+     * @default "Time at call"
+     */
+    readonly toolCallTimeTitle?: string;
+    /**
+     * Shown in the time modal when the time value is unknown.
+     * @default "Unknown time"
+     */
+    readonly toolCallTimeUnknown?: string;
+    /**
+     * Label prefix for the exact timestamp line in the time modal.
+     * @default "Timestamp of call:"
+     */
+    readonly toolCallTimeTimestampLabel?: string;
+    /**
+     * Template used for the time chip, for example `"Time: {time}"`.
+     * @default "{time}"
+     */
+    readonly toolCallTimeChipLabel?: string;
+    /**
+     * Template shown under the time clock panel for relative context.
+     * @default "Called {relative}"
+     */
+    readonly toolCallTimeRelativeLabel?: string;
+};
+/**
+ * Optional text overrides for localized timing metadata rendered next to message timestamps.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatTimingTranslations = {
+    /**
+     * Template used for assistant response duration metadata.
+     *
+     * The `{duration}` placeholder is replaced with the compact duration label.
+     */
+    readonly answerDurationLabel?: string;
+};
 /**
  * Interface for sound system that can be passed to Chat component
  * This allows the chat to trigger sounds without tight coupling
@@ -179,6 +439,12 @@ export type ChatProps = {
      * to keep the button available for another attempt.
      */
     onActionButton?(code: string): Promisable<void>;
+    /**
+     * Called when user clicks a quick message button parsed from message markdown.
+     *
+     * When not provided, quick message buttons fall back to `onMessage`.
+     */
+    onQuickMessageButton?(messageContent: string): Promisable<void>;
     /**
      * Optional callback
      *
@@ -388,6 +654,21 @@ export type ChatProps = {
      * Optional localized feedback labels for buttons, modal copy, and status toasts.
      */
     readonly feedbackTranslations?: ChatFeedbackTranslations;
+    /**
+     * Optional localized labels used by timestamp metadata shown under messages.
+     */
+    readonly timingTranslations?: ChatTimingTranslations;
+    /**
+     * Optional localized labels for general Chat UI elements such as button labels,
+     * lifecycle state badges, tool call modal strings, and the default input placeholder.
+     */
+    readonly chatUiTranslations?: ChatUiTranslations;
+    /**
+     * Optional moment locale used when formatting message timestamps.
+     *
+     * When omitted, the current global moment locale is used.
+     */
+    readonly chatLocale?: string;
     /**
      * Optional callback for handling file uploads
      * When provided, enables file upload functionality via drag-and-drop and file button
@@ -407,6 +688,15 @@ export type ChatProps = {
      * Called when a tool call chiplet is clicked.
      */
     onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
+    /**
+     * Visual presentation mode for chat messages.
+     *
+     * - `BUBBLE_MODE`: keeps the default bubble appearance for all messages.
+     * - `ARTICLE_MODE`: keeps user bubbles while rendering assistant replies as borderless article blocks.
+     *
+     * @default 'BUBBLE_MODE'
+     */
+    readonly CHAT_VISUAL_MODE?: ChatVisualMode;
     /**
      * Visual style of the chat component
      */

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

@@ -25,6 +25,22 @@ export type ChatToolCallModalProps = {
      * Optional cached team agent metadata keyed by TEAM tool name.
      */
     teamAgentProfiles?: Record<string, AgentChipData>;
+    /**
+     * Optional localized labels for the tool call modal UI elements.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
+    /**
+     * Optional BCP-47 locale string used to format time labels in the modal.
+     * When omitted the browser/OS default locale is used.
+     */
+    locale?: string;
+    /**
+     * Optional list of tools that were available to the model during the turn that produced this tool call.
+     *
+     * When provided, the advanced view includes an "Available tools" payload section so developers can
+     * inspect what capabilities the model had access to at the exact moment of the request.
+     */
+    availableTools?: ChatMessage['availableTools'];
 };
 /**
  * Modal that renders rich tool call details for chat chiplets.

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

@@ -14,6 +14,10 @@ type AdvancedToolCallDetailsOptions = {
      * Optional mapping of tool titles.
      */
     toolTitles?: Record<string, string>;
+    /**
+     * Optional list of tools that were available to the model during the turn that produced this tool call.
+     */
+    availableTools?: ChatMessage['availableTools'];
 };
 /**
  * Renders a technical view with raw tool input/output payloads.

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

@@ -29,6 +29,15 @@ type ToolCallDetailsOptions = {
      * Requests switching the modal into advanced technical mode.
      */
     onRequestAdvancedView?: () => void;
+    /**
+     * Optional BCP-47 locale string used to format time labels.
+     * When omitted the browser/OS default locale is used.
+     */
+    locale?: string;
+    /**
+     * Optional localized label overrides for the tool call modal UI.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
 };
 /**
  * Renders the detail view for a single tool call.

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import type { string_markdown } from '../../../types/typeAliases';
 type MarkdownContentProps = {
     content: string_markdown;
@@ -9,7 +10,7 @@ type MarkdownContentProps = {
  *
  * @public exported from `@promptbook/components`
  */
-export declare function MarkdownContent(props: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export declare const MarkdownContent: import("react").NamedExoticComponent<MarkdownContentProps>;
 export {};
 /**
  * TODO: !!! Split into multiple files

package/esm/src/book-components/Chat/MarkdownContent/MarkdownContent.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/hooks/useChatCompleteNotification.d.ts

@@ -0,0 +1,18 @@
+import type { ChatSoundSystem } from '../Chat/ChatProps';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Plays the "message received" sound + vibration exactly once when the last
+ * assistant message transitions to a completed / finalized state.
+ *
+ * Notifications are suppressed for:
+ * - Every streaming chunk / intermediate content update
+ * - `message_typing` lifecycle events before the message is finalized
+ * - Re-renders of an already-notified completed message (idempotent)
+ * - User-originated messages
+ *
+ * @param messages - Current list of chat messages
+ * @param soundSystem - Optional sound system instance; no-op when absent
+ *
+ * @private internal hook of `<Chat/>`
+ */
+export declare function useChatCompleteNotification(messages: ReadonlyArray<ChatMessage>, soundSystem: ChatSoundSystem | undefined): void;