@promptbook/javascript 0.112.0-31 → 0.112.0-34

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

@@ -0,0 +1,38 @@
+import { type ReactElement } from 'react';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Rendering options for time tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderTimeToolCallDetailsOptions = {
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+    /**
+     * Timestamp of the tool call itself.
+     */
+    toolCallDate: Date | null;
+    /**
+     * Optional locale override used for date formatting.
+     */
+    locale?: string;
+    /**
+     * Optional translation overrides.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
+};
+/**
+ * Renders the time-specific tool call detail view.
+ *
+ * @param options - Time tool call data.
+ * @returns Time visualization UI.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderTimeToolCallDetails(options: RenderTimeToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,46 @@
+import { type ReactElement } from 'react';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Rendering options for timeout tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderTimeoutToolCallDetailsOptions = {
+    /**
+     * Tool name used to resolve timeout presentation details.
+     */
+    toolCallName: string;
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+    /**
+     * Timestamp of the tool call itself.
+     */
+    toolCallDate: Date | null;
+    /**
+     * Optional callback for switching to advanced mode.
+     */
+    onRequestAdvancedView?: () => void;
+    /**
+     * Optional locale override used for date formatting.
+     */
+    locale?: string;
+    /**
+     * Optional translation overrides.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
+};
+/**
+ * Renders the timeout-specific tool call detail view.
+ *
+ * @param options - Timeout tool call data.
+ * @returns Timeout visualization UI.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderTimeoutToolCallDetails(options: RenderTimeoutToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,33 @@
+import { type ReactElement } from 'react';
+/**
+ * Configuration for the shared clock panel used by time and timeout popups.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderToolCallClockPanelOptions = {
+    /**
+     * Date rendered by the analog clock and local labels.
+     */
+    date: Date;
+    /**
+     * Optional relative label.
+     */
+    relativeLabel?: string | null;
+    /**
+     * Optional timezone label shown below the date.
+     */
+    timezoneLabel?: string | null;
+    /**
+     * Optional BCP-47 locale string used to format the local time display.
+     */
+    locale?: string;
+};
+/**
+ * Renders a shared analog-clock panel used by time and timeout tool views.
+ *
+ * @param options - Clock panel rendering options.
+ * @returns Clock section with local date/time labels.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallClockPanel(options: RenderToolCallClockPanelOptions): ReactElement;
+export {};

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

@@ -1,8 +1,8 @@
 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';
+import { Color } from '../../../utils/color/Color';
 /**
  * Options for rendering a tool call detail view.
  *
@@ -29,11 +29,20 @@ type ToolCallDetailsOptions = {
      * Requests switching the modal into advanced technical mode.
      */
     onRequestAdvancedView?: () => void;
+    /**
+     * Optional BCP-47 locale string used to format time labels.
+     */
+    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.
  *
  * @param options - Rendering options for the tool call.
+ * @returns Simple tool-call detail JSX.
  * @private function of ChatToolCallModal
  */
 export declare function renderToolCallDetails(options: ToolCallDetailsOptions): ReactElement;

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

@@ -0,0 +1,29 @@
+import { type ReactElement } from 'react';
+/**
+ * Rendering options for the shared pending-state placeholder card.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderToolCallProgressPlaceholderOptions = {
+    /**
+     * Title displayed at the top of the placeholder.
+     */
+    title: string;
+    /**
+     * Supporting message explaining the current state.
+     */
+    message: string;
+    /**
+     * Optional badge label shown in the header.
+     */
+    badgeLabel?: string;
+};
+/**
+ * Renders a shared placeholder card for pending and partial tool-call details.
+ *
+ * @param options - Placeholder copy and optional badge label.
+ * @returns Placeholder JSX.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallProgressPlaceholder(options: RenderToolCallProgressPlaceholderOptions): ReactElement;
+export {};

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

@@ -0,0 +1,26 @@
+import { type ReactElement } from 'react';
+import type { WalletCredentialToolCallResult } from '../utils/walletCredentialToolCall';
+/**
+ * Rendering options for wallet credential tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderWalletCredentialToolCallDetailsOptions = {
+    /**
+     * Safe credential usage metadata.
+     */
+    credential: WalletCredentialToolCallResult;
+    /**
+     * Optional timestamp of the action.
+     */
+    toolCallDate: Date | null;
+};
+/**
+ * Renders a friendly wallet-credential usage summary for non-technical users.
+ *
+ * @param options - Credential payload and optional timestamp.
+ * @returns Credential details section for the tool modal.
+ * @private function of ChatToolCallModal
+ */
+export declare function renderWalletCredentialToolCallDetails(options: RenderWalletCredentialToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,9 @@
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Maps tool-call state into friendly running copy used by simple modal sections.
+ *
+ * @param toolCall - Tool call currently rendered in the modal.
+ * @returns Friendly progress message for the current tool state.
+ * @private function of ChatToolCallModal
+ */
+export declare function resolveToolCallProgressMessage(toolCall: NonNullable<ChatMessage['toolCalls']>[number]): string;

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

@@ -0,0 +1,32 @@
+import { type ChangeEvent, type ClipboardEvent, type DragEvent } from 'react';
+import type { ChatInputUploadedFile } from './ChatInputArea';
+import type { ChatProps } from './ChatProps';
+/**
+ * Props for `useChatInputAreaAttachments`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaAttachmentsProps = {
+    onFileUpload?: ChatProps['onFileUpload'];
+};
+/**
+ * Handles file-upload state and drag/drop events for the chat composer.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaAttachments({ onFileUpload }: UseChatInputAreaAttachmentsProps): {
+    fileInputRef: import("react").RefObject<HTMLInputElement | null>;
+    uploadedFiles: ChatInputUploadedFile[];
+    uploadedFilesRef: import("react").RefObject<ChatInputUploadedFile[]>;
+    isDragOver: boolean;
+    isUploading: boolean;
+    handleDrop: (event: DragEvent) => void;
+    handleDragOver: (event: DragEvent) => void;
+    handleDragLeave: (event: DragEvent) => void;
+    handlePaste: (event: ClipboardEvent) => void;
+    handleFileInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    removeUploadedFile: (fileId: string) => void;
+    clearUploadedFiles: () => void;
+    openFilePicker: () => void;
+};
+export {};

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

@@ -0,0 +1,76 @@
+import { type MutableRefObject } from 'react';
+import type { SpeechRecognitionErrorCode } from '../../../types/SpeechRecognition';
+import type { ChatProps } from './ChatProps';
+/**
+ * Voice settings available for lightweight transcript refinement.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type DictationRefinementSettings = {
+    readonly autoPunctuation: boolean;
+    readonly autoCapitalization: boolean;
+    readonly removeFillerWords: boolean;
+    readonly formatLists: boolean;
+    readonly whisperMode: boolean;
+};
+/**
+ * Visual tone used by the floating speech-status bubble.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type SpeechStatusBubbleTone = 'neutral' | 'recording' | 'processing' | 'error';
+/**
+ * UI metadata derived from the current speech-recognition state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type SpeechRecognitionUiDescriptor = {
+    readonly buttonTitle: string;
+    readonly bubbleText?: string;
+    readonly bubbleTone?: SpeechStatusBubbleTone;
+    readonly isButtonActive: boolean;
+    readonly isButtonDisabled: boolean;
+};
+/**
+ * Props for `useChatInputAreaDictation`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaDictationProps = {
+    speechRecognition?: ChatProps['speechRecognition'];
+    speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
+    textareaRef: MutableRefObject<HTMLTextAreaElement | null>;
+    messageContentRef: MutableRefObject<string>;
+    applyMessageContent: (nextContent: string) => void;
+};
+/**
+ * Manages speech-recognition state, transcript refinement, and correction UI.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaDictation({ speechRecognition, speechRecognitionLanguage, textareaRef, messageContentRef, applyMessageContent, }: UseChatInputAreaDictationProps): {
+    speechRecognitionUiDescriptor: SpeechRecognitionUiDescriptor;
+    shouldShowDictationPanel: boolean;
+    isDictationPanelExpanded: boolean;
+    toggleDictationPanel: () => void;
+    expandDictationPanel: () => void;
+    dictationInterimText: string;
+    dictationError: {
+        code?: SpeechRecognitionErrorCode | undefined;
+        message: string;
+    } | null;
+    dictationLastFinalChunk: string;
+    dictationEditableChunk: string;
+    setDictationEditableChunk: import("react").Dispatch<import("react").SetStateAction<string>>;
+    canBacktrack: boolean;
+    dictationSettings: DictationRefinementSettings;
+    handleDictationSettingChange: (settingName: keyof DictationRefinementSettings, checked: boolean) => void;
+    handleToggleVoiceInput: () => void;
+    handleBacktrackLastChunk: () => void;
+    handleApplyCorrection: () => void;
+    handleRetryPermissionRequest: () => void;
+    handleOpenBrowserSettings: () => void;
+    canOpenBrowserSettings: boolean;
+    isBrowserSpeechFallbackSupported: boolean;
+};
+export {};

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

@@ -0,0 +1,31 @@
+import { type RefObject } from 'react';
+/**
+ * Absolute screen position used for the avatar profile tooltip.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+type AvatarTooltipPosition = {
+    readonly top: number;
+    readonly left: number;
+};
+/**
+ * State and handlers used by the avatar profile tooltip behavior.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageAvatarTooltipResult = {
+    readonly avatarRef: RefObject<HTMLDivElement | null>;
+    readonly tooltipRef: RefObject<HTMLDivElement | null>;
+    readonly isAvatarTooltipVisible: boolean;
+    readonly avatarTooltipPosition: AvatarTooltipPosition | null;
+    readonly showTooltip: () => void;
+    readonly handleMouseEnter: () => void;
+    readonly handleMouseLeave: () => void;
+};
+/**
+ * Manages delayed avatar tooltip display and outside-dismiss behavior.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export declare function useChatMessageAvatarTooltip(): UseChatMessageAvatarTooltipResult;
+export {};

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

@@ -0,0 +1,29 @@
+import { type RefObject } from 'react';
+/**
+ * Inputs needed to manage speech playback for one chat message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackOptions = {
+    readonly trimmedMessageContent: string;
+    readonly contentRef: RefObject<HTMLElement | null>;
+    readonly shouldShowPlayButton: boolean;
+    readonly elevenLabsVoiceId?: string;
+};
+/**
+ * Speech playback state and actions returned to `<ChatMessageItem/>`.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackResult = {
+    readonly audioError: string | null;
+    readonly isAudioLoading: boolean;
+    readonly isAudioPlaying: boolean;
+    readonly handlePlayMessage: () => Promise<void>;
+};
+/**
+ * Handles ElevenLabs speech playback, caching, and audio element lifecycle for one message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export declare function useChatMessageSpeechPlayback(options: UseChatMessageSpeechPlaybackOptions): UseChatMessageSpeechPlaybackResult;

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;

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

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

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

@@ -1,6 +1,9 @@
 import { Message } from '../../../types/Message';
+import type { LlmToolDefinition } from '../../../types/LlmToolDefinition';
+import type { ChatModelRequirements } from '../../../types/ModelRequirements';
 import type { ToolCall } from '../../../types/ToolCall';
-import type { id, string_date_iso8601, string_markdown } from '../../../types/typeAliases';
+import type { TODO_object } from '../../../utils/organization/TODO_object';
+import type { id, Parameters, string_date_iso8601, string_markdown, string_prompt, string_title } from '../../../types/typeAliases';
 export type ChatToolCall = ToolCall;
 /**
  * One item in a user-facing progress card shown while assistant response is still running.
@@ -52,6 +55,63 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
+/**
+ * Serializable prompt snapshot stored alongside one assistant message for debugging and inspection.
+ */
+type ChatMessagePrompt = {
+    /**
+     * Human-readable label used for the prompt execution.
+     */
+    readonly title: string_title;
+    /**
+     * User-facing chat content submitted into the prompt pipeline.
+     */
+    readonly content: string_prompt;
+    /**
+     * Resolved prompt parameters passed into the agent turn.
+     */
+    readonly parameters: Parameters;
+    /**
+     * Chat-model requirements used when the turn was executed.
+     */
+    readonly modelRequirements: ChatModelRequirements;
+    /**
+     * Prior thread history provided to the prompt.
+     */
+    readonly thread?: ReadonlyArray<ChatMessage>;
+    /**
+     * Attachments submitted with the user turn.
+     */
+    readonly attachments?: ReadonlyArray<{
+        name: string;
+        type: string;
+        url: string;
+    }>;
+    /**
+     * Runtime tools explicitly passed on the chat prompt object.
+     */
+    readonly tools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Full list of tools available to the model for this turn.
+     */
+    readonly availableTools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Tool calls associated with the generated message, duplicated here for raw prompt inspection.
+     */
+    readonly toolCalls?: ReadonlyArray<ChatToolCall>;
+    /**
+     * Completed tool calls associated with the generated message, duplicated here for raw prompt inspection.
+     */
+    readonly completedToolCalls?: ReadonlyArray<ChatToolCall>;
+    /**
+     * Provider-facing prompt text after agent/runtime preparation, when available.
+     */
+    readonly rawPromptContent?: string_prompt;
+    /**
+     * Provider-facing raw request payload, when available.
+     */
+    readonly rawRequest?: TODO_object | null;
+};
 /**
  * Represents a single message within a chat interface.
  *
@@ -165,7 +225,23 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      * Optional structured progress-card payload shown while a response is still in progress.
      */
     readonly progressCard?: ChatProgressCard;
+    /**
+     * Optional list of tools that were available to the model when generating this message.
+     *
+     * This field is populated by the server from the exact tool definitions passed to the LLM
+     * request so developers can inspect what capabilities the model had access to during
+     * each conversation turn.
+     */
+    readonly availableTools?: ReadonlyArray<LlmToolDefinition>;
+    /**
+     * Optional prompt snapshot from which this message was generated.
+     *
+     * Intended for advanced/raw inspection so developers can see the exact chat prompt,
+     * resolved parameters, tool availability, and provider payload associated with one turn.
+     */
+    readonly prompt?: ChatMessagePrompt;
 };
+export {};
 /**
  * TODO: Make all fields readonly
  * TODO: Delete `expectedAnswer` from ChatMessage

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

@@ -0,0 +1,37 @@
+/**
+ * Locale-aware date/time labels derived from one tool-call timestamp.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallDateTimeLabels = {
+    /**
+     * Primary local time label shown in chips and clock panels.
+     */
+    readonly localTimeLabel: string;
+    /**
+     * Local calendar date label shown under the primary time.
+     */
+    readonly localDateLabel: string;
+    /**
+     * Exact local timestamp label used in detail sections.
+     */
+    readonly localDateTimeLabel: string;
+    /**
+     * Relative label such as `in 5 minutes` or `2 minutes ago`.
+     */
+    readonly relativeTimeLabel: string | null;
+};
+/**
+ * Formats one tool-call timestamp into shared locale-aware labels.
+ *
+ * @param date - Timestamp to format.
+ * @param options - Optional locale and relative-time reference point.
+ * @returns Shared labels consumed by tool-call chips and modals.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallDateTime(date: Date, options?: {
+    locale?: string;
+    currentDate?: Date;
+}): ToolCallDateTimeLabels;
+export {};

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

@@ -0,0 +1,11 @@
+/**
+ * Formats a Date as a locale-aware short time string (e.g. "5:30 PM" or "17:30").
+ *
+ * @param date - Date to format.
+ * @param locale - Optional BCP-47 locale string (e.g. `"en"`, `"cs"`).
+ *                 When omitted the browser/OS default locale is used.
+ * @returns Formatted time string such as `"5:30 PM"` or `"17:30"`.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallLocalTime(date: Date, locale?: string): string;

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

@@ -0,0 +1,10 @@
+/**
+ * Applies `{placeholder}` values to one tool-call translation template.
+ *
+ * @param template - Template from the host application or fallback copy.
+ * @param variables - Placeholder values keyed by variable name.
+ * @returns Formatted string ready for rendering.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function formatToolCallTranslationTemplate(template: string, variables: Record<string, string | number>): string;

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

@@ -1,3 +1,4 @@
+import 'moment/locale/cs';
 import type { ChatMessage } from '../types/ChatMessage';
 /**
  * Display-ready timestamp values for a chat message.
@@ -21,6 +22,9 @@ export type ChatMessageTimingDisplay = {
 /**
  * Builds display-ready timestamp and duration labels for a chat message.
  *
+ * @param message - Message with optional timestamp metadata.
+ * @param locale - Optional moment locale used for formatting.
+ *
  * @private utility of `<Chat/>` component
  */
-export declare function getChatMessageTimingDisplay(message: ChatMessage): ChatMessageTimingDisplay | null;
+export declare function getChatMessageTimingDisplay(message: ChatMessage, locale?: string): ChatMessageTimingDisplay | null;

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

@@ -15,6 +15,25 @@ export type ToolCallChipletInfo = {
      */
     agentData?: AgentChipData;
 };
+/**
+ * Optional user-facing title overrides for technical tool names.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallTitleOverrides = Readonly<Record<string, string>>;
+/**
+ * Optional localized labels used for user-facing chip text.
+ *
+ * @private utility of `<Chat/>`
+ */
+type ToolCallChipTranslations = {
+    readonly toolCallTimeChipLabel?: string;
+    readonly toolCallTimeoutChipLabel?: string;
+    readonly toolCallTimeoutChipCancelledLabel?: string;
+    readonly toolCallTimeoutChipInactiveLabel?: string;
+    readonly toolCallTimeoutChipUpdatedLabel?: string;
+    readonly toolCallTimeoutChipFallbackLabel?: string;
+};
 /**
  * Builds display text for a tool call chiplet.
  *
@@ -35,6 +54,12 @@ export declare const TOOL_TITLES: Record<string, {
 /**
  * Gets the chiplet information including text and agent data (for team tools).
  *
+ * @param toolCall - Tool call to build chiplet info for.
+ * @param locale - Optional BCP-47 locale string used to format time labels.
+ * @param titleOverrides - Optional localized titles keyed by tool name.
+ * @param chipTranslations - Optional localized chip templates for time-related tools.
+ *
  * @private [🧠] Maybe public?
  */
-export declare function getToolCallChipletInfo(toolCall: ToolCall): ToolCallChipletInfo;
+export declare function getToolCallChipletInfo(toolCall: ToolCall, locale?: string, titleOverrides?: ToolCallTitleOverrides, chipTranslations?: ToolCallChipTranslations): ToolCallChipletInfo;
+export {};